borgbackup - Интернет в облаке

ПРОГРАММА:

ИМЯ

borg - BorgBackup - это программа резервного копирования с дедупликацией с дополнительным сжатием и
аутентифицированное шифрование.

Борг состоит из ряда команд. Каждая команда принимает ряд аргументов и
параметры. В следующих разделах подробно описывается каждая команда.

ОБЩАЯ ИНФОРМАЦИЯ

Тип of журнал выходной
Уровень журнала встроенной конфигурации ведения журнала по умолчанию ПРЕДУПРЕЖДЕНИЕ. Это потому что
мы хотим, чтобы Борг в основном молчал и выводил только предупреждения, ошибки и критические сообщения.

Уровни журнала: DEBUG <INFO <WARNING <ERROR <CRITICAL

Используйте --отлаживать установить уровень журнала DEBUG - получить отладку, информацию, предупреждение, ошибку и критический уровень
вывод.

Используйте --Информация (или -v or --подробный) для установки уровня журнала INFO - для получения информации, предупреждений, ошибок и
выход критического уровня.

Используйте --предупреждение (по умолчанию) для установки уровня журнала WARNING - для получения предупреждений, ошибок и критических
выходной уровень.

Используйте --ошибка установить уровень журнала ERROR - получить вывод ошибки и критического уровня.

Используйте - критический to set CRITICAL log level - получить критический уровень вывода.

Пока можно установить разное. уровни журнала, не ожидайте, что каждая команда будет давать разные
вывод на разные уровни логов - это просто возможность.

ПРЕДУПРЕЖДЕНИЕ:
Параметры --critical и --error предусмотрены для полноты, их использование не предусмотрено.
рекомендуется, так как вы можете пропустить важную информацию.

ПРЕДУПРЕЖДЕНИЕ:
Хотя некоторые варианты (вроде --статистика or --список) будет выдавать более информационные сообщения, вы
должны использовать уровень журнала INFO (или более низкий), чтобы они отображались в выводе журнала. Использовать -v или
конфигурация журналирования.

ВОЗВРАТ Коды
Борг может выйти со следующими кодами возврата (rc):

0 = успех (регистрируется как ИНФОРМАЦИЯ)
1 = предупреждение (работа дошла до нормального завершения, но были предупреждения -
вы должны проверить журнал, зарегистрированный как ПРЕДУПРЕЖДЕНИЕ)
2 = ошибка (например, фатальная ошибка, локальное или удаленное исключение, операция
не достиг своего нормального конца, регистрируется как ОШИБКА)
128 + N = уничтожено сигналом N (например, 137 == kill -9)

Если вы используете --show-rc, код возврата также регистрируется на указанном уровне как последний
запись в журнале.

Окружающая среда Переменные
Borg использует некоторые переменные среды для автоматизации:

Генеральная:

БОРГ_РЕПО
Если установлено, используйте значение, чтобы указать местоположение репозитория по умолчанию. Если
команде требуется параметр архива, вы можете сокращать как ::архив, Если
команде нужен параметр репозитория, вы можете либо оставить его, либо
сокращенно ::, если требуется позиционный параметр.

BORG_PASSPHRASE
Если установлено, используйте значение, чтобы ответить на вопрос о парольной фразе для зашифрованных
Хранилища.

BORG_DISPLAY_PASSPHRASE
Если установлено, используйте значение, чтобы ответить на "отобразить кодовую фразу для
проверка "вопрос при определении новой парольной фразы для зашифрованного
Хранилища.

BORG_LOGGING_CONF
Когда установлено, используйте данное имя файла как ЭТО-стиль настройки ведения журнала.

БОРГ_РСХ
Если установлено, используйте эту команду вместо SSH. Это можно использовать для указания ssh
параметры, такие как настраиваемый файл удостоверений SSH -i / путь / к / частному / ключу. Посмотреть человек
SSH для других вариантов.

TMPDIR где хранятся временные файлы (может потребоваться много временного места для
некоторые операции)

Некоторые автоматически отвечающими (если задавать, они автоматически ответ подтверждение вопросов):

BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK = нет (или = да)
Для "Предупреждение: попытка доступа к ранее неизвестному незашифрованному
хранилище "

BORG_RELOCATED_REPO_ACCESS_IS_OK = нет (или = да)
Для "Предупреждение: репозиторий в местоположении ... ранее находился в ..."

BORG_CHECK_I_KNOW_WHAT_I_AM_DOING = НЕТ (или = ДА)
Для "Предупреждение: 'check --repair' - экспериментальная функция, которая может привести к
в потере данных ".

BORG_DELETE_I_KNOW_WHAT_I_AM_DOING = НЕТ (или = ДА)
Для "Вы запросили полностью УДАЛИТЬ репозиторий. включая Найти
архивы, которые он содержит: "

Примечание: ответы чувствительны к регистру. установка неверного значения ответа может дать
ответ по умолчанию или интерактивный запрос, в зависимости от того, есть ли повторные попытки
разрешены (они по умолчанию разрешены). Поэтому, пожалуйста, протестируйте свои скрипты в интерактивном режиме
прежде чем сделать их неинтерактивным сценарием.

Справочники:

BORG_KEYS_DIR
По умолчанию '~ / .config / borg / ключи'. Этот каталог содержит ключи для зашифрованных
Хранилища.

BORG_CACHE_DIR
По умолчанию '~ / .cache / borg'. Этот каталог содержит локальный кеш и
может потребоваться много места для работы с большими репозиториями).

Здание:

BORG_OPENSSL_PREFIX
Добавляет указанный каталог файла заголовка OpenSSL в расположение по умолчанию
(настройка.py).

Borg_lz4_prefix
Добавляет указанный каталог файла заголовка LZ4 в расположение по умолчанию (setup.py).

Пожалуйста, обратите внимание:

· Будьте очень осторожны при использовании ответчиков «да», предупреждения с подсказкой существуют для вашего /
безопасность / сохранность ваших данных

· Также будьте очень осторожны при вводе ключевой фразы в скрипт, убедитесь, что в ней есть
соответствующие права доступа к файлам (например, режим 600, root: root).

Ресурс Применение
Борг может использовать много ресурсов в зависимости от размера обрабатываемого набора данных.
с.

ЦПУ: Он не выйдет за пределы 100% одного ядра, поскольку код в настоящее время однопоточный.
Особенно более высокие уровни сжатия zlib и lzma используют значительное количество ЦП.
циклы.

Память (БАРАН):
Индекс фрагментов и индекс файлов считываются в память по соображениям производительности.
Компрессия, особенно lzma сжатие с высокими уровнями может потребовать значительных объемов
памяти.

Временная файлов:
Чтение данных и метаданных из смонтированного репозитория FUSE потребует примерно
то же пространство, что и дедуплицированные блоки, используемые для их представления в репозитории.

Кэш файлов:
Содержит индекс фрагментов и индекс файлов (плюс сжатую коллекцию
индексы фрагментов одного архива).

Куски индекс:
Пропорционально количеству блоков данных в вашем репо. В вашем репо много кусков
подразумевают большой индекс кусков. Можно настроить параметры чанкера (см. Создание
параметры).

Файлы индекс:
Пропорционально количеству файлов в вашей последней резервной копии. Можно выключить (см.
create options), но следующее резервное копирование будет намного медленнее, если вы это сделаете.

Сети:
Если ваш репозиторий удален, все дедуплицированные (и, возможно, сжатые /
зашифрованные) данные, конечно, должны проходить через соединение (ssh: repo url). если ты
использовать локально смонтированную сетевую файловую систему, дополнительно используются некоторые операции копирования
для поддержки транзакций также переходите через соединение. Если вы создаете резервную копию нескольких источников
к одному целевому репозиторию дополнительный трафик происходит для ресинхронизации кеша.

Если вас интересует более подробная информация, пожалуйста, прочтите внутреннюю документацию.

Единицы
Чтобы отображать количества, Борг заботится о соблюдении обычных соглашений о масштабе. Диск
размеры отображаются в десятичная дробь, используя степень десяти (так kB означает 1000 байт). На память
использование, двоичный префиксы используются и обозначаются с помощью IEC двоичный префиксы, С помощью
степени двойки (так КБ означает 1024 байта).

Время и Время
Мы форматируем дату и время в соответствии с ISO-8601, то есть: ГГГГ-ММ-ДД и ЧЧ: ММ: СС (24ч
Часы).

Для получения дополнительной информации об этом см .: https://xkcd.com/1179/

Если не указано иное, мы отображаем местное время и дату. Внутри мы храним и обрабатываем
дата и время в формате UTC.

БОРГ INIT

использование: borg init [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ] [-e {none, keyfile, repokey}]
[ХРАНИЛИЩЕ]

Инициализировать пустой репозиторий

позиционные аргументы:
РЕПОЗИТОРИЙ репозиторий для создания

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")
-e {none, keyfile, repokey}, --encryption {none, keyfile, repokey}
выберите режим ключа шифрования (по умолчанию: «repokey»)

Описание
Эта команда инициализирует пустой репозиторий. Репозиторий - это каталог файловой системы
содержащие дедуплицированные данные из нуля или более архивов. Шифрование можно включить на
время инициализации репозитория.

Примеры
# Локальный репозиторий (по умолчанию используется шифрование в режиме репозитория)
$ borg init / путь / к / репо

# Локальный репозиторий (без шифрования)
$ borg init --encryption = нет / путь / к / репо

# Удаленный репозиторий (доступ к удаленному боргу через ssh)
Пользователь $ borg init @ имя хоста: резервное копирование

# Удаленный репозиторий (храните ключ в своем домашнем каталоге)
$ borg init --encryption = keyfile user @ hostname: backup

Важные примечания о шифровании:

Не рекомендуется отключать шифрование. Шифрование репозитория защищает вас, например,
в случае, если злоумышленник имеет доступ к вашему хранилищу резервных копий.

Но будьте осторожны с ключом / парольной фразой:

Если вам нужна защита "только парольная фраза", используйте репоключ режим. Ключ будет храниться
внутри репозитория (в его "конфигурационном" файле). В вышеупомянутом сценарии атаки
у злоумышленника будет ключ (но не кодовая фраза).

Если вам нужна защита с использованием кодовой фразы и ключа, используйте ключевой файл режим. Ключ будет
храниться в вашем домашнем каталоге (в .config / borg / ключи). В сценарии атаки
злоумышленник, имеющий только доступ к вашему репо, не будет иметь ключа (а также
кодовая фраза).

Сделайте резервную копию ключевого файла (ключевой файл режим) или файл конфигурации репо (репоключ режим) и
храните его в надежном месте, чтобы у вас все еще был ключ на случай, если он будет поврежден или утерян. Также
храните кодовую фразу в надежном месте. Резервная копия, зашифрованная этим ключом, не будет
помочь вам с этим, конечно.

Убедитесь, что вы используете правильную парольную фразу. Не слишком коротко, не слишком просто. Настоящее шифрование /
ключ дешифрования зашифрован / заблокирован вашей парольной фразой. Если злоумышленник получит ваш
ключ, он не может разблокировать и использовать его, не зная парольной фразы.

Будьте осторожны со специальными символами или символами, отличными от ascii, в вашей кодовой фразе:

· Borg обрабатывает кодовую фразу как unicode (и кодирует ее как utf-8), поэтому у нее нет
проблемы даже с самыми странными персонажами.

· НО: это не обязательно относится к вашей конфигурации ОС / ВМ / клавиатуры.

Так что лучше использовать длинную парольную фразу, состоящую из простых символов ascii, чем ту, которая включает
файлы, отличные от ascii, или символы, которые трудно / невозможно ввести на другой клавиатуре
раскладка.

Вы можете изменить свою парольную фразу для существующих репозиториев в любое время, это не повлияет на
ключ шифрования / дешифрования или другие секреты.

БОРГ СОЗДАТЬ

использование: borg create [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ] [-s] [-p] [--list]
[--filter STATUSCHARS] [-e ШАБЛОН]
[--exclude-from EXCLUDEFILE] [--exclude-caches]
[--exclude-if-present ИМЯ ФАЙЛА] [--keep-tag-files]
[-c СЕКУНДЫ] [-x] [--numeric-owner]
[--timestamp гггг-мм-ддТчч: мм: сс]
[--chunker-params CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE]
[--ignore-inode] [-C СЖАТИЕ] [--read-special] [-n]
АРХИВНЫЙ ПУТЬ [ПУТЬ ...]

Создать новый архив

позиционные аргументы:
АРХИВ имя создаваемого архива (также должно быть действительным
имя каталога)
Пути к архиву PATH

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")
-s, --stats вывести статистику созданного архива
-p, --progress показать отображение прогресса при создании архива,
показаны размеры "Исходный", "Сжатый" и "Без дубликатов",
за которым следует количество просмотренных файлов и путь
обрабатывается, по умолчанию: False
--list выводит подробный список элементов (файлов, каталогов, ...)
--filter STATUSCHARS отображать только элементы с заданными символами состояния
-e ШАБЛОН, --exclude ШАБЛОН
исключить пути, соответствующие ШАБЛОНУ
--exclude-из EXCLUDEFILE
читать шаблоны исключения из EXCLUDEFILE, по одному в строке
--exclude-caches исключать каталоги, содержащие файл CACHEDIR.TAG
(http://www.brynosaurus.com/cachedir/spec.html)
--exclude-if-present ИМЯ ФАЙЛА
исключить каталоги, содержащие указанный файл
--keep-tag-files сохранять файлы тегов исключенных кешей / каталогов
-c СЕКУНДЫ, --checkpoint-interval СЕКУНДЫ
записывать контрольную точку каждые СЕКУНДЫ секунд (по умолчанию: 300)
-x, --one-файловая-система
оставаться в той же файловой системе, не пересекать точки монтирования
--numeric-owner хранить только числовые идентификаторы пользователя и группы
--timestamp гггг-мм-ддThh: мм: сс
вручную указать дату / время создания архива (UTC).
в качестве альтернативы укажите справочный файл / каталог.
--chunker-params CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE
укажите параметры чанкера. по умолчанию: 19,23,21,4095
--ignore-inode игнорировать данные inode в кэше метаданных файлов, используемых для
обнаруживать неизмененные файлы.
-C СЖАТИЕ, - сжатие СЖАТИЕ
выберите алгоритм сжатия (и уровень): нет == нет
сжатие (по умолчанию), lz4 == lz4, zlib == zlib
(уровень по умолчанию 6), zlib, 0 .. zlib, 9 == zlib (с
уровень 0..9), lzma == lzma (уровень по умолчанию 6), lzma, 0 ..
lzma, 9 == lzma (с уровнем 0..9).
--read-special открывать и читать специальные файлы, как если бы они были обычными
файлов
-n, --dry-run не создавать резервный архив

Описание
Эта команда создает резервный архив, содержащий все файлы, найденные рекурсивно.
прохождение всех указанных путей. Архив почти не занимает места на диске для файлов или файлов.
части файлов, которые уже были сохранены в других архивах.

Чтобы ускорить получение резервных копий через sshfs и аналогичные сетевые файловые системы, которые не
предоставить правильную информацию об индексном дескрипторе, можно использовать флаг --ignore-inode. Это потенциально
снижает надежность обнаружения изменений, избегая при этом постоянного чтения всех файлов на
эти файловые системы.

См. Вывод команды «borg help patterns» для получения дополнительной справки по шаблонам исключения.

Примеры
# Резервное копирование ~ / Документы в архив с именем "мои-документы"
$ borg создать / путь / к / репо :: мои-документы ~ / Документы

# то же самое, но подробный список всех файлов по мере их обработки
$ borg create -v --list / путь / к / репо :: мои-документы ~ / Документы

# Резервное копирование ~ / Документы и ~ / src но исключить файлы pyc
$ borg создать / путь / к / репо :: мои-файлы \
~ / Документы \
~ / src \
- исключить '* .pyc'

# Резервное копирование домашних каталогов, исключая эскизы изображений (т.е. только
# /Главная/* /. эскизы исключены, а не /Главная/* / * /. эскизы)
$ borg создать / путь / к / репо :: мои-файлы / Главная \
--exclude 're: ^/Главная/[^ /] + / \. эскизы / '

# Сделайте то же самое, используя шаблон в стиле оболочки
$ borg создать / путь / к / репо :: мои-файлы / Главная \
- исключить 'sh:/Главная/* /. эскизы '

# Сделайте резервную копию корневой файловой системы в архив с именем "root-YYYY-MM-DD"
# использовать сжатие zlib (хорошо, но медленно) - по умолчанию сжатие отсутствует
$ borg create -C zlib, 6 / path / to / repo :: root- {сейчас:% Y-% m-% d} / --one-file-system

# Приложите большие усилия к мелкой гранулярной дедупликации (управление большими блоками
# накладные расходы, требуется много оперативной памяти и дискового пространства, см. формулу во внутреннем устройстве
# документы - те же параметры, что и у borg <1.0 или на чердаке):
$ borg create --chunker-params 10,23,16,4095 / путь / к / репо :: small / smallstuff

# Резервное копирование необработанного устройства (в это время не должно быть активным / используемым / смонтированным)
$ dd if = / dev / sdx bs = 10M | borg создать / путь / к / репо :: my-sdx -

# Без сжатия (по умолчанию)
$ borg создать / путь / к / репо :: арка ~

# Супер быстрое, низкое сжатие
$ borg create --compression lz4 / путь / к / репо :: арка ~

# Менее быстрое, более высокое сжатие (N = 0..9)
$ borg create --compression zlib, N / path / to / repo :: arch ~

# Еще медленнее, еще сильнее сжатие (N = 0..9)
$ borg create --compression lzma, N / path / to / repo :: arch ~

# Доступны теги формата для имени архива:
# {сейчас}, {utcnow}, {fqdn}, {hostname}, {user}, {pid}
# добавить короткое имя хоста, резервное имя пользователя и текущее время unixtime (секунды от эпохи)
$ borg create / path / to / repo :: {hostname} - {user} - {now:% s} ~

БОРГ ВЫПИСКА

использование: извлечение borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ] [--list] [-n] [-e ШАБЛОН]
[--exclude-from EXCLUDEFILE] [--numeric-owner]
[--strip-components НОМЕР] [--stdout] [--sparse]
АРХИВ [ПУТЬ [ПУТЬ ...]]

Извлечь содержимое архива

позиционные аргументы:
АРХИВ архив для извлечения
Пути PATH для извлечения; шаблоны поддерживаются

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")
--list выводит подробный список элементов (файлов, каталогов, ...)
-n, --dry-run фактически не изменять файлы
-e ШАБЛОН, --exclude ШАБЛОН
исключить пути, соответствующие ШАБЛОНУ
--exclude-из EXCLUDEFILE
читать шаблоны исключения из EXCLUDEFILE, по одному в строке
--numeric-owner подчиняться только числовым идентификаторам пользователя и группы
--strip-components НОМЕР
Удалите указанное количество элементов ведущего пути.
Пути с меньшим количеством элементов будут молча
пропущено.
--stdout записать все извлеченные данные в стандартный вывод
--sparse создавать дыры в выходном разреженном файле из нуля
ломти

Описание
Эта команда извлекает содержимое архива. По умолчанию весь архив
извлечены, но можно выбрать подмножество файлов и каталогов, передав список ПУТИ
в качестве аргументов. Выбор файла может быть дополнительно ограничен с помощью --исключать опцию.

См. Вывод команды «borg help patterns» для получения дополнительной справки по шаблонам исключения.

Примеры
# Извлечь весь архив
$ borg extract / путь / к / репо :: мои-файлы

# Извлечь весь архив и файлы списка во время обработки
$ borg extract -v --list / путь / к / репо :: мои-файлы

# Извлечь каталог "src"
$ borg extract / path / to / repo :: my-files home / ИМЯ ПОЛЬЗОВАТЕЛЯ / src

# Извлечь каталог "src", но исключить объектные файлы
$ borg extract / path / to / repo :: my-files home / ИМЯ ПОЛЬЗОВАТЕЛЯ / src --exclude '* .o'

# Восстановить необработанное устройство (в это время не должно быть активным / используемым / смонтированным)
$ borg extract --stdout / path / to / repo :: my-sdx | dd of = / dev / sdx bs = 10M

Примечание: В настоящее время, извлечение всегда пишет в домен текущий работает каталог ("."),
так что убедитесь, что вы cd в нужное место перед звонком борг извлечение.

БОРГ ПРОВЕРИТЬ

использование: проверка borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ] [--repository-only] [--archives-only]
[--repair] [--save-space] [--последний N] [-P ПРЕФИКС]
[РЕПОЗИТОРИЙ_ИЛИ_АРХИВ]

Проверить целостность репозитория

позиционные аргументы:
РЕПОЗИТОРИЙ_ИЛИ_АРХИВ
репозиторий или архив для проверки согласованности

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")
--repository-only выполнять только проверки репозитория
--archives-only выполнять только проверку архивов
--repair попытка исправить любые обнаруженные несоответствия
--save-space работают медленнее, но занимают меньше места
--last N проверять только последние N архивов (по умолчанию: все)
-P ПРЕФИКС, --prefix ПРЕФИКС
рассматривать только имена архивов, начинающиеся с этого префикса

Описание
Команда check проверяет целостность репозитория и соответствующих архивов.

Сначала проверяются файлы данных базового репозитория:

· Для всех сегментов проверяется магия сегмента (заголовок)

· Для всех объектов, хранящихся в сегментах, все метаданные (например, crc и размер) и все данные
читать. Считанные данные проверяются по размеру и CRC. Битовая гниль и другие виды случайных
Таким образом можно обнаружить повреждения.

· Если мы находимся в режиме восстановления и для сегмента обнаружена ошибка целостности, мы пытаемся
восстановить как можно больше объектов из сегмента.

· В режиме восстановления он проверяет соответствие индекса данным, хранящимся в
сегменты.

· Если вы используете удаленный сервер репо через ssh :, проверка репо выполняется на сервере репо.
без значительного сетевого трафика.

· Проверку репозитория можно пропустить с помощью параметра --archives-only.

Во-вторых, проверяется непротиворечивость и правильность метаданных архива:

· Присутствует ли манифест репо? В противном случае он перестраивается из блоков метаданных архива (это
требует чтения и расшифровки всех метаданных и данных).

· Проверить наличие блока метаданных архива. в противном случае удалите архив из манифеста.

· Для всех файлов (элементов) в архиве, для всех фрагментов, на которые ссылаются эти файлы, проверьте,
кусок присутствует (если нет, и мы находимся в режиме ремонта, замените его фрагментом такого же размера
нули). Для этого требуется чтение метаданных архива и файла, но не данных.

· Если мы находимся в режиме восстановления и проверили все архивы: удалите потерянные куски из
репо.

· Если вы используете удаленный сервер репо через ssh :, проверка архива выполняется на клиенте
машина (потому что, если шифрование включено, проверки потребуют дешифрования, и это
всегда выполняется на стороне клиента, потому что потребуется доступ по ключу).

· Проверка архива может занять много времени, ее можно пропустить с помощью
- параметр только для репозитория.

БОРГ ПЕРЕИМЕНОВАТЬ

использование: borg rename [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ]
АРХИВ NEWNAME

Переименовать существующий архив

позиционные аргументы:
АРХИВ архив для переименования
NEWNAME новое имя архива для использования

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")

Описание
Эта команда переименовывает архив в репозитории.

Примеры
$ borg создать / путь / к / репо :: имя архива ~
Список $ borg / путь / к / репо
имя архива Пн, 2016 02:15:19

$ borg переименовать / путь / к / репо :: имя архива новое имя
Список $ borg / путь / к / репо
newname Пн, 2016-02-15 19:50:19

БОРГ СПИСОК

использование: список borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ] [--short] [--list-format LISTFORMAT]
[-P ПРЕФИКС]
[РЕПОЗИТОРИЙ_ИЛИ_АРХИВ]

Список содержимого архива или репозитория

позиционные аргументы:
РЕПОЗИТОРИЙ_ИЛИ_АРХИВ
репозиторий / архив для отображения содержимого

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")
--short печатать только имена файлов / каталогов, больше ничего
--list-format СПИСОКФОРМАТ
укажите формат для вывода списка файлов архива (по умолчанию:
"{mode} {user: 6} {group: 6} {size: 8d} {isomtime}
{path} {extra} {NEWLINE} ") Существует специальный" {formatkeys} "
чтобы перечислить доступные ключи
-P ПРЕФИКС, --prefix ПРЕФИКС
рассматривать только имена архивов, начинающиеся с этого префикса

Описание
Эта команда выводит список содержимого репозитория или архива.

Примеры
Список $ borg / путь / к / репо
Понедельник Пн, 2016-02-15 19:15:11
репо Пн, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
newname Пн, 2016-02-15 19:50:19
...

Список $ borg / путь / к / репо :: root-2016-02-15
drwxr-xr-x root root 0 Пн, 2016 02:15:17.
drwxrwxr-x root root 0 Пн, 2016 02:15:19 bin
-rwxr-xr-x root root 1029624 Чт, 2014 11:13:00 bin / bash
lrwxrwxrwx root root 0 Пт, 2015 03:27:20 bin / bzcmp -> bzdiff
-rwxr-xr-x root root 2140 Пт, 2015 03:27:20 bin / bzdiff
...

$ borg list / path / to / repo :: archiveA --list-format = "{mode} {user: 6} {group: 6} {size: 8d} {isomtime} {path} {extra} {NEWLINE}"
drwxrwxr-x user user 0 вс, 2015, 02:01:11.
drwxrwxr-x пользователь пользователь 0 вс, 2015-02-01 11:00:00 код
drwxrwxr-x user user 0 вс, 2015 02:01:11 code / myproject
-rw-rw-r-- пользователь пользователь 1416192 вс, 2015 02:01:11 код / ​​myproject / file.ext
...

# посмотреть, что меняется между архивами, в зависимости от времени модификации файла, его размера и пути к файлу
$ borg list / path / to / repo :: archiveA --list-format = "{mtime:% s} {TAB} {size} {TAB} {path} {LF}" | sort -n> / tmp / list .archiveA
$ borg list / path / to / repo :: archiveB --list-format = "{mtime:% s} {TAB} {size} {TAB} {path} {LF}" | sort -n> / tmp / list .archiveB
$ diff -y /tmp/list.archiveA /tmp/list.archiveB
1422781200 0. 1422781200 0.
1422781200 0 код 1422781200 0 код
1422781200 0 код / ​​myproject 1422781200 0 код / ​​myproject
1422781200 1416192 код / ​​myproject / file.ext | 1454664653 1416192 код / ​​myproject / file.ext
...

БОРГ УДАЛИТЬ

использование: borg delete [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ] [-p] [-s] [-c] [--save-space]
[ЦЕЛЬ]

Удалить существующий репозиторий или архив

позиционные аргументы:
ЦЕЛЕВОЙ архив или репозиторий для удаления

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")
-p, --progress показать отображение прогресса при удалении одного архива
-s, --stats вывести статистику удаленного архива
-c, --cache-only удалить только локальный кеш для данного репозитория
--save-space работают медленнее, но занимают меньше места

Описание
Эта команда удаляет архив из репозитория или всего репозитория. Диск
соответственно освобождается пространство. Если вы удалите весь репозиторий, локальный кеш для
он (если есть) также удаляется.

Примеры
# удалить один резервный архив:
$ borg delete / path / to / repo :: понедельник

# удалить весь репозиторий и связанный с ним локальный кеш:
$ borg удалить / путь / к / репо
Вы просили полностью УДАЛИТЬ репозиторий * включая * все архивы, которые он содержит:
репо Пн, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
newname Пн, 2016-02-15 19:50:19
Введите «ДА», если вы понимаете это и хотите продолжить: ДА

БОРГ ЧЕРНОСЛИВ

использование: borg prune [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ] [-n] [-s] [--list]
[--keep-within WITHIN] [-H ЧАСОВО] [-d ЕЖЕДНЕВНО] [-w ЕЖЕНЕДЕЛЬНО]
[-m ЕЖЕМЕСЯЧНО] [-y ГОД] [-P ПРЕФИКС] [--save-space]
[ХРАНИЛИЩЕ]

Очистить архивы репозитория в соответствии с указанными правилами

позиционные аргументы:
REPOSITORY репозиторий для обрезки

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")
-n, --dry-run не изменять репозиторий
-s, --stats вывести статистику удаленного архива
--list выводит подробный список архивов, которые он хранит / сокращает
--keep-within ВНУТРИ сохранить все архивы в пределах этого временного интервала
-H ПОЧАСОВО, --Eep-ежечасно ПОЧАСОВО
количество почасовых архивов для хранения
-d ЕЖЕДНЕВНО, --keep-daily ЕЖЕДНЕВНО
количество ежедневных архивов для хранения
-w ЕЖЕНЕДЕЛЬНО, --keep-еженедельно ЕЖЕНЕДЕЛЬНО
количество еженедельных архивов для хранения
-m ЕЖЕМЕСЯЧНО, --keep-ежемесячно ЕЖЕМЕСЯЧНО
количество ежемесячных архивов для хранения
-y ЕЖЕГОДНО, -keep-Annual YEARLY
количество ежегодных архивов для хранения
-P ПРЕФИКС, --prefix ПРЕФИКС
рассматривать только имена архивов, начинающиеся с этого префикса
--save-space работают медленнее, но занимают меньше места

Описание
Команда prune сокращает репозиторий, удаляя архивы, не соответствующие ни одному из
указанные варианты хранения. Эта команда обычно используется сценариями автоматического резервного копирования.
желая сохранить определенное количество исторических резервных копий.

Например, «-d 7» означает хранить последнюю резервную копию каждый день, до 7 самых последних.
дни с резервными копиями (дни без резервных копий не считаются). Правила применяются с почасовой оплатой.
к годовому, а резервные копии, выбранные предыдущими правилами, не засчитываются в счет более поздних
правила. Время завершения каждой резервной копии используется в целях сокращения. Даты и время
интерпретируются в местном часовом поясе, а недели идут с понедельника по воскресенье. Указание
отрицательное количество хранимых архивов означает, что ограничений нет.

Параметр "--keep-within" принимает аргумент в форме " ", где char -" H ",
«д», «ш», «м», «у». Например, «--keep-within 2d» означает хранить все архивы, которые были
создано за последние 48 часов. «1м» означает «31d». Архивы хранятся в
эта опция не учитывается при подсчете итогов, указанных в других параметрах.

Если префикс установлен с -P, то рассматриваются только архивы, начинающиеся с префикса.
для удаления, и только эти архивы учитываются в общих суммах, указанных в правилах.
В противном случае Найти архивы в репозитории являются кандидатами на удаление!

Примеры
Будьте осторожны, prune - потенциально опасная команда, она удалит архивы резервных копий.

По умолчанию обрезка применяется к Найти архивам in домен хранилище если вы не ограничите его
операция с подмножеством архивов с использованием --приставка, Когда используешь --приставка, будь осторожен
выберите хороший префикс - например, не используйте префикс «foo», если вы также не хотите совпадать
"фубар".

Настоятельно рекомендуется всегда запускать чернослив --прогон, репетиция ... сначала вы увидите, что это
обошлось бы без того, чтобы на самом деле ничего делать.

# Хранить 7 архивов на конец дня и 4 дополнительных архива на конец недели.
# Выполните пробный прогон, фактически ничего не удаляя.
$ borg prune --dry-run --keep-daily = 7 --keep-weekly = 4 / путь / к / репо

# То же, что и выше, но применяется только к именам архивов, начинающимся с "foo":
$ borg prune --keep-daily = 7 --keep-weekly = 4 --prefix = foo / путь / к / репо

# Хранить 7 архивов на конец дня, 4 дополнительных архива на конец недели,
# и архив на конец месяца для каждого месяца:
$ borg prune --keep-daily = 7 --keep-weekly = 4 --keep-month = -1 / путь / к / репо

# Хранить все резервные копии за последние 10 дней, 4 дополнительных архива на конец недели,
# и архив на конец месяца для каждого месяца:
$ borg prune --keep-within = 10d --keep-weekly = 4 --keep-month = -1 / путь / к / репо

БОРГ ИНФОРМАЦИЯ

использование: borg info [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ]
АРХИВ

Показать сведения об архиве, например, используемое дисковое пространство

позиционные аргументы:
АРХИВ архив для отображения информации о

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")

Описание
Эта команда отображает подробную информацию об указанном архиве.

Примеры
$ borg info / путь / к / репо :: root-2016-02-15
Имя: root-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
Имя хоста: myhostname
Имя пользователя: root
Время (начало): Пн, 2016-02-15 19:36:29
Время (конец): Пн, 2016-02-15 19:39:26
Командная строка: / usr / local / bin / borg create -v --list -C zlib, 6 / path / to / repo :: root-2016-02-15 / --one-file-system
Количество файлов: 38100

Исходный размер Сжатый размер Дублированный размер
В этом архиве: 1.33 ГБ 613.25 МБ 571.64 МБ
Все архивы: 1.63 ГБ 853.66 МБ 584.12 МБ

Уникальные блоки Всего блоков
Индекс чанка: 36858 48844

БОРГ ГОРУ

использование: borg mount [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ] [-f] [-o ОПЦИИ]
РЕПОЗИТОРИЙ_ИЛИ_АРХИВ МОНТАЖА

Смонтировать архив или весь репозиторий как файловую систему FUSE

позиционные аргументы:
РЕПОЗИТОРИЙ_ИЛИ_АРХИВ
репозиторий / архив для монтирования
MOUNTPOINT где смонтировать файловую систему

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")
-f, --foreground оставаться на переднем плане, не демонизировать
-o ОПЦИИ Дополнительные варианты крепления

Описание
Эта команда монтирует архив как файловую систему FUSE. Это может быть полезно для просмотра
архивировать или восстанавливать отдельные файлы. Если только --передний план option дается команда
будет работать в фоновом режиме, пока файловая система размонтированный.

Примеры
$ borg mount / путь / к / репо :: root-2016-02-15 / tmp / mymountpoint
$ ls / tmp / mymountpoint
bin boot etc home lib lib64 потерян + найден носитель mnt opt ​​root sbin srv tmp usr var
$ fusermount -u / tmp / mymountpoint

БОРГ ЗАМЕНА-ПАССФРАЗА

использование: borg change-passphrase [-h] [--critical] [--error] [--warning] [--info]
[--debug] [--lock-wait N] [--show-rc]
[--no-files-cache] [-umask M]
[--remote-path ПУТЬ]
[ХРАНИЛИЩЕ]

Изменить парольную фразу файла ключа репозитория

позиционные аргументы:
РЕПОЗИТОРИЙ

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")

Описание
Ключевые файлы, используемые для шифрования репозитория, могут быть защищены парольной фразой. Этот
можно использовать команду, чтобы изменить эту парольную фразу.

Примеры
# Создать репозиторий, защищенный ключевыми файлами
$ borg init --encryption = ключевой файл -v / путь / к / репо
Инициализация репозитория в "/ путь / к / репо"
Введите новую кодовую фразу:
Введите ту же парольную фразу еще раз:
Запомните свой пароль. Без него ваши данные будут недоступны.
Ключ в "/root/.config/borg/keys/mnt_backup" создан.
Храните этот ключ в безопасности. Без него ваши данные будут недоступны.
Синхронизация кеша фрагментов ...
Архивы: 0, с кешированным идентификатором: 0, с устаревшим идентификатором: 0, без кешированного идентификатора: 0.
Готово.

# Изменить ключевую фразу файла
$ borg изменить-парольную фразу -v / путь / к / репо
Введите кодовую фразу для ключа /root/.config/borg/keys/mnt_backup:
Введите новую кодовую фразу:
Введите ту же парольную фразу еще раз:
Запомните свой пароль. Без него ваши данные будут недоступны.
Ключ обновлен

БОРГ ОБСЛУЖИВАТЬ

использование: borg serve [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ] [--restrict-to-path ПУТЬ]

Запускаем в серверном режиме. Эта команда обычно не используется вручную.

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")
--restrict-to-path ПУТЬ
ограничить доступ к репозиторию PATH

Описание
Эта команда запускает процесс сервера репозитория. Эта команда обычно не используется
вручную.

Примеры
borg serve имеет специальную поддержку принудительных команд ssh (см. авторизованные_ключи пример
ниже): он обнаружит, что вы используете такую ​​принудительную команду, и извлечет значение
--ограничить путь параметры). Затем он проанализирует исходную команду, пришедшую из
клиент, убедитесь, что он также борг служить и обеспечить соблюдение ограничений пути, как указано
принудительная команда. Таким образом, другие параметры, предоставленные клиентом (например, --Информация or --умаска)
сохраняются (и не фиксируются принудительной командой).

# Разрешить паре ключей SSH запускать только borg и иметь доступ только к / path / to / repo.
# Используйте ключевые параметры, чтобы отключить ненужные и потенциально опасные функции SSH.
# Это поможет защитить автоматизированную систему удаленного резервного копирования.
$ кошка ~ / .ssh / authorized_keys
command = "borg serve --restrict-to-path / path / to / repo", no-pty, no-agent-forwarding, no-port-forwarding, no-X11-forwarding, no-user-rc ssh-rsa AAAAB3 [...]

БОРГ ОБНОВЛЕНИЕ

использование: borg upgrade [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path ПУТЬ] [-p] [-n] [-i]
[ХРАНИЛИЩЕ]

обновить репозиторий с предыдущей версии

позиционные аргументы:
REPOSITORY путь к обновляемому репозиторию

необязательные аргументы:
-h, --help показать это справочное сообщение и выйти
- критическая работа на уровне журнала CRITICAL
--error работать на уровне журнала ERROR
--warning работать на уровне журнала WARNING (по умолчанию)
--информация, -v, --verbose
работать на уровне журнала INFO
--debug работать на уровне журнала DEBUG
--lock-wait N ждать блокировки, но макс. N секунд (по умолчанию: 1).
--show-rc показать / записать код возврата (rc)
--no-files-cache не загружать / обновлять кеш метаданных файлов, используемый для
обнаруживать неизмененные файлы
--umask M установить umask в M (локальный и удаленный, по умолчанию: 0077)
--remote-path ПУТЬ установить удаленный путь к исполняемому файлу (по умолчанию: "borg")
-p, --progress показать отображение прогресса при обновлении репозитория
-n, --dry-run не изменять репозиторий
-i, --inplace перезаписать репозиторий на месте, без шансов
вернуться к более старым версиям репозитория.

Описание
Обновите существующий репозиторий Borg. В настоящее время поддерживается преобразование чердака.
репозиторий в Borg, а также помогает конвертировать Borg 0.xx в 1.0.

В настоящее время обновлять можно только ЛОКАЛЬНЫЕ репозитории (проблема № 465).

Он изменит магические строки в сегментах репозитория, чтобы они соответствовали новой магии Борга.
струны. Ключевые файлы, найденные в $ ATTIC_KEYS_DIR или ~ / .attic / keys / также будет преобразован
и скопирован в $ BORG_KEYS_DIR или ~ / .config / borg / keys.

Файлы кеша преобразуются из $ ATTIC_CACHE_DIR или ~ / .cache / чердак в $ BORG_CACHE_DIR
or ~ / .cache / borg, но расположение кеша между Боргом и Чердаком изменилось, поэтому возможно
первая резервная копия после преобразования занимает больше времени, чем ожидалось, из-за повторной синхронизации кеша.

Обновление должно иметь возможность возобновить, если оно прервано, хотя оно все равно будет повторяться по всем
сегменты. Если вы хотите начать с нуля, используйте борг удалять над скопированным репозиторием в
убедитесь, что файлы кеша также удалены:
борг удалить борг

Если не --на месте указан, процесс обновления сначала создает резервную копию
репозиторий в REPOSITORY.upgrade-DATETIME, используя жесткие ссылки. Это занимает больше времени, чем в
размещать обновления, но намного безопаснее и дает информацию о прогрессе (в отличие от cp -al).
Если вас устраивает преобразование, вы можете безопасно уничтожить резервную копию.

ВНИМАНИЕ! Запуск обновления на месте сделает текущую копию непригодной для использования с более ранними версиями.
версия, без возможности вернуться к предыдущим версиям. Это может НЕОБХОДИМО ПОВРЕДИТЬ ВАШУ
ХРАНИЛИЩЕ! Чердак НЕ МОЖЕТ ПРОЧИТАТЬ КОРПОРАТИВНЫЕ ХРАНИЛИЩА, так как волшебные струны изменились. Ты
были предупреждены.

Примеры
# Обновите репозиторий borg до самой последней версии.
$ borg upgrade -v / путь / к / репо
создание жесткой копии в /path/to/repo.upgrade-2016-02-15-20:51:55
открытие репозитория на чердаке с помощью borg и конвертация
ключевой файл для репозитория не найден
преобразование индекса репо /path/to/repo/index.0
преобразование 1 сегмента ...
преобразование borg 0.xx в ток borg
ключевой файл для репозитория не найден

РАЗНОЕ ПОМОГИТЕ

борг помощь паттеранами
Шаблоны исключения поддерживают четыре отдельных стиля: fnmatch, shell, регулярные выражения и
префиксы пути. Если за ним следует двоеточие (':'), используются первые два символа шаблона.
как селектор стилей. Если выбран стиль, отличный от стиля по умолчанию, необходим явный выбор стиля.
желаемого или когда желаемый образец начинается с двух буквенно-цифровых символов, за которыми следует
двоеточие (т.е. аа: что-то / *).

Фнматч, селектор фм:
Эти шаблоны используют вариант синтаксиса шаблона оболочки, где '*' соответствует любому количеству
символы, '?' соответствует любому одиночному символу, '[...]' соответствует любому одиночному символу
указан, включая диапазоны, и '[! ...]' соответствует любому не указанному символу. Для
назначение этих шаблонов, разделитель путей ('' для Windows и '/' в других системах)
особо не лечится. Заключите мета-символы в скобки для буквального совпадения (т. Е.
[?] соответствовать буквальному символу ?). Чтобы путь соответствовал шаблону, он должен
полностью совпадают от начала до конца или должны совпадать от начала до момента, предшествующего пути
разделитель. За исключением корневого пути, пути никогда не заканчиваются разделителем пути, когда
выполняется попытка сопоставления. Таким образом, если данный шаблон заканчивается разделителем пути, '*' будет
добавляется перед попыткой сопоставления.

Шаблоны в стиле оболочки, селектор ш:
Как и шаблоны fnmatch, они похожи на шаблоны оболочки. Разница в том, что
шаблон может включать ** / для соответствия нулевому или большему количеству уровней каталогов, * для соответствия нулю
или более произвольных символов, за исключением разделителей пути.

Регулярные выражения, селектор повторно:
Поддерживаются регулярные выражения, аналогичные тем, которые встречаются в Perl. В отличие от паттернов оболочки
регулярные выражения не требуются для соответствия полному пути и любой подстроке
достаточно. Настоятельно рекомендуется привязать паттерны к началу ('^'), к
конец ('$') или оба. Разделители путей ('' для Windows и '/' в других системах) в путях
всегда нормализуются до косой черты ('/') перед применением шаблона. Регулярный
синтаксис выражения описан в Питон документации для домен re модуль.

Путь префикса, селектор пп:
Этот стиль шаблона полезен для сопоставления целых подкаталогов. Шаблон pp: / data / bar
спички / data / bar и все в нем.

Исключения можно передать с помощью параметра командной строки. --исключать. При использовании изнутри
shell шаблоны должны быть заключены в кавычки, чтобы защитить их от расширения.

Ассоциация - исключить из опция позволяет загружать шаблоны исключения из текстового файла с одним
узор в строке. Строки пустые или начинаются со знака числа ('#') после удаления
пробелы на обоих концах игнорируются. Также поддерживается необязательный префикс селектора стиля.
для шаблонов, загруженных из файла. Из-за того, что пути удаления пробелов с пробелами в
начало или конец можно исключить только с помощью регулярных выражений.

Примеры:

# Исключить '/home/user/file.o', но не '/home/user/file.odt': $ borg create -e '
*
.o 'резервная копия /

# Исключить '/ home / user / junk' и '/ home / user / subdir / junk', но # не
'/ home / user / importantjunk' или '/ etc / junk': $ borg create -e '/Главная/
*
/ junk 'резервное копирование /

# Исключить содержимое '/ home / user / cache', но не сам каталог: $ borg create
-e / главная / пользователь / кеш / резервное копирование /

# Файл '/ home / user / cache / important' не зарезервировано: $ borg create -e
/ home / user / cache / backup / / home / user / cache / important

# Содержимое каталогов в '/ Главная'не копируются, когда их имя # заканчивается на
'.tmp' $ borg create --exclude 're: ^/Главная/[^ /] +. tmp / 'резервная копия /

# Загрузить исключения из файла $ cat> exclude.txt < /Главная//хлам * .tmp
fm: aa: something / re: ^/Главная/[^ /]. tmp / sh:/Главная/
*
/.thumbnails EOF $ borg create --exclude-from exclude.txt backup/

ОТЛАЖИВАТЬ КОМАНДЫ

Есть еще несколько команд (все начинаются с "debug-"), которые все не предназначенных для
"обычные" использование и потенциально очень "опасны" при неправильном использовании.

Они существуют для улучшения возможностей отладки без прямого доступа к системе, например, в случае
вы когда-нибудь сталкивались с серьезной неисправностью. Используйте их только в том случае, если знаете, что делаете или
если доверенный разработчик Borg скажет вам, что делать.

ДОПОЛНИТЕЛЬНЫЕ ПРИМЕЧАНИЯ

Вот разное. примечания по темам, которые могут быть недостаточно подробно освещены в использовании
.

Товар Флаги
борг Создайте -v --список выводит подробный список всех файлов, каталогов и других файлов
системные элементы, которые он рассматривал (независимо от того, было ли у них изменение содержимого или нет). Для каждого
элемент, он предшествует однобуквенному флагу, который указывает тип и / или статус элемента.

Если вас интересует только подмножество этого вывода, вы можете указать, например, --filter = AME и
он будет отображать только обычные файлы со статусом A, M или E (см. ниже).

Символ верхнего регистра представляет статус обычного файла относительно "файлов".
кеш (не относительно репо - это проблема, если кеш файлов не используется).
Метаданные сохраняются в любом случае, и для «A» и «M» также сохраняются новые блоки данных. Для
«U» все блоки данных относятся к уже существующим блокам.

· 'A' = обычный файл, добавлен (см. Также a_status_oddity в FAQ)

· 'M' = обычный файл, измененный

· 'U' = обычный файл, без изменений

· 'E' = обычный файл, произошла ошибка при доступе / чтении этой файл

Символ в нижнем регистре означает тип файла, отличный от обычного файла, borg обычно просто
хранит свои метаданные:

· 'D' = каталог

· 'B' = блочное устройство

· 'C' = символьное устройство

· 'H' = обычный файл, жесткая ссылка (на уже просмотренные inodes)

· 'S' = символическая ссылка

· 'F' = fifo

Другие используемые флаги включают:

· 'I' = данные резервной копии были прочитаны со стандартного ввода (stdin)

· '-' = пробный прогон, элемент был не резервное копирование

· '?' = отсутствует код статуса (если вы видите это, отправьте отчет об ошибке!)

--chunker-параметры
Параметры chunker влияют на то, как входные файлы разрезаются на части (куски), которые затем
рассматривается для дедупликации. Они также сильно влияют на использование ресурсов (RAM и диск
пространство), поскольку количество необходимых ресурсов (также) определяется общим количеством
чанки в репозитории (см. Индексы / Тайники Память пользования для более подробной информации).

--chunker-params = 10,23,16,4095 приводит к детальной дедупликации и создает большой
количество чанков и, таким образом, использует много ресурсов для управления ими. Это хорошо для
относительно небольшие объемы данных и если на машине достаточно свободной оперативной памяти и диска
пространстве.

--chunker-params = 19,23,21,4095 (по умолчанию) приводит к грубой дедупликации и
создает гораздо меньшее количество фрагментов и, следовательно, использует меньше ресурсов. Это хорошо для
относительно большие объемы данных и если на машине относительно небольшой объем свободной оперативной памяти и
дисковое пространство.

Если вы уже создали несколько архивов в репозитории, а затем измените параметры чункера,
это, конечно, влияет на дедупликацию, поскольку фрагменты будут разрезаться по-разному.

В худшем случае (все файлы большие и были затронуты между резервными копиями), это сохранит
все содержимое снова в репозиторий.

Но обычно все не так уж плохо:

· Обычно большинство файлов не затрагиваются, поэтому он просто повторно использует старые куски, которые у него уже есть
в репо

· Файлы, размер которых меньше минимального (как старого, так и нового) минимального размера фрагментов, приводят к получению только одного фрагмента
в любом случае, поэтому результирующие фрагменты будут такими же, и будет применяться дедупликация

Если вы переключите параметры chunker, чтобы сэкономить ресурсы для существующего репо, в котором уже есть
резервное копирование архивов, вы увидите возрастающий эффект со временем, когда все больше и больше файлов
были затронуты и сохранены снова, используя больший размер фрагмента и все ссылки на
более мелкие старые фрагменты были удалены (путем удаления / сокращения архивов).

Если вы хотите увидеть немедленный большой эффект на использование ресурсов, вам лучше начать новый
репозиторий при изменении параметров чанкера.

Для получения дополнительной информации см. Chunker_details.

- чит-специальный
Опция - чит-специальный не предназначен для нормального уровня файловой системы (полного или
частично рекурсивные) резервные копии. Вы даете эту возможность только в том случае, если хотите что-то сделать.
... специальные - и если вы вручную выбрали некоторые файлы, которые вы хотите обработать таким образом.

борг Создайте - чит-специальный откроет все файлы без какой-либо специальной обработки
в зависимости от типа файла (единственное исключение - каталоги: они будут рекурсивны
в). Только представьте, что произойдет, если вы это сделаете кошка имя файла --- контент, который вы там увидите
это то, что borg сделает резервную копию для этого файла.

Так, например, будут следовать символические ссылки, будет прочитано содержимое блочного устройства, именованные каналы
Сокеты домена / UNIX будут прочитаны.

Вам нужно быть осторожным с тем, что вы указываете в качестве имени файла при использовании - чит-специальный, например, если
вы даете / DEV / ноль, ваше резервное копирование никогда не прекратится.

Метаданные указанных файлов сохраняются, как если бы они были сохранены без - чит-специальный (например, его
имя, его размер [может быть 0], его режим и т. д.) - но, кроме того, также читаемый контент
от этого будут спасены для него.

Восстановление содержимого таких файлов в настоящее время поддерживается только по одному с помощью --stdout
вариант (и вам нужно перенаправить stdout туда, куда он должен идти, возможно, прямо в
существующий файл устройства по вашему выбору или косвенно через dd).

Пример
Представьте, что вы сделали несколько снимков логических томов (LV), для которых нужно создать резервную копию.

ПРИМЕЧАНИЕ:
Для некоторых сценариев это хороший способ добиться согласованности "как при сбое" (я называю это
похожий на сбой, потому что он такой же, как если бы вы просто нажали кнопку сброса или
ваша машина резко и полностью выйдет из строя). Это лучше, чем отсутствие последовательности
вообще и хороший метод для некоторых случаев использования, но, вероятно, недостаточно хорош, если у вас есть
базы данных запущены.

Затем вы создаете резервную копию всех этих снимков. В процессе резервного копирования появится
«замороженное» состояние логических томов, в то время как процессы работают в исходных томах
продолжайте изменять хранящиеся там данные.

Вы также добавляете вывод lvdisplay в резервную копию, чтобы вы могли видеть размеры LV в случае
вам когда-нибудь понадобится воссоздать и восстановить их.

После завершения резервного копирования вы снова удалите снимки.

$ # создать снимки здесь
$ lvdisplay> lvdisplay.txt
$ borg create --read-special / path / to / repo :: arch lvdisplay.txt / dev / vg0 / * - снимок
$ # удалить снимки здесь

Теперь посмотрим, как восстановить некоторые LV из такой резервной копии.

$ borg extract / путь / к / репо :: arch lvdisplay.txt
$ # создайте пустые LV с правильными размерами здесь (посмотрите lvdisplay.txt).
$ # мы предполагаем, что вы создали пустой корневой и домашний LV и перезаписали его сейчас:
$ borg extract --stdout / путь / к / репо :: arch dev / vg0 / root-snapshot> / dev / vg0 / root
$ borg extract --stdout / путь / к / репо :: arch dev / vg0 / home-snapshot> / dev / vg0 / home

Только добавление Режим
Репозиторий можно сделать "только для добавления", что означает, что Борг никогда не будет перезаписывать или
удалить зафиксированные данные. Это полезно для сценариев, когда несколько машин выполняют резервное копирование на
центральный сервер резервного копирования с использованием борг служить, поскольку взломанная машина не может удалять резервные копии
постоянно.

Чтобы активировать режим только добавления, отредактируйте репозиторий конфиг файл и добавьте строку append_only = 1
до [репозиторий] раздел (или отредактируйте строку, если она существует).

В режиме только добавления Borg создаст журнал транзакций в операции файл, где
каждая строка представляет собой транзакцию и метку времени в формате UTC.

Пример
Предположим, злоумышленник удаленно удалил все резервные копии, но ваш репозиторий был доступен только для добавления.
режим. Журнал транзакций в этой ситуации может выглядеть так:

транзакция 1, время UTC 2016-03-31T15: 53: 27.383532
транзакция 5, время UTC 2016-03-31T15: 53: 52.588922
транзакция 11, время UTC 2016-03-31T15: 54: 23.887256
транзакция 12, время UTC 2016-03-31T15: 55: 54.022540
транзакция 13, время UTC 2016-03-31T15: 55: 55.472564

Из ваших журналов безопасности вы делаете вывод, что злоумышленник получил доступ в 15:54:00 и все
резервные копии были удалены или заменены скомпрометированными резервными копиями. Из журнала вы знаете, что
транзакции 11 и более поздних версий скомпрометированы. Обратите внимание, что идентификатор транзакции - это имя
последний файл в транзакции. Например, транзакция 11 охватывает файлы с 6 по 11.

В реальной атаке вы, вероятно, захотите сохранить скомпрометированный репозиторий нетронутым для анализа.
чего пытался добиться злоумышленник. Также неплохо сделать эту копию на всякий случай.
что-то пошло не так во время восстановления. Поскольку восстановление осуществляется путем удаления некоторых файлов,
копия твердой ссылки (cp -al) достаточно.

Первый шаг для сброса репозитория до транзакции 5, последний бескомпромиссный
транзакция, состоит в том, чтобы удалить подсказки.N и индекс.N файлы в репозитории (эти два файла
всегда расходный). В этом примере N равно 13.

Затем удалите или переместите все файлы сегментов из каталогов сегментов в данные/ начиная с
файл 6:

rm data / ** / {6..13}

Вот и все.

Недостатками
Поскольку данные только добавляются и ничего не удаляются, такие команды, как чернослив or удалять не освободит
на диске, они просто помечают данные как удаленные в новой транзакции.

Обратите внимание, что вы можете переключаться между обычной операцией и операцией только с добавлением, редактируя
файл конфигурации, это не «поездка в один конец».

В дальнейшем соображения
Режим только добавления не поддерживается другими инструментами, кроме Borg. rm все еще работает над
репозиторий. Убедитесь, что клиентские машины резервного копирования получают доступ к репозиторию только через
борг служить.

Убедитесь, что удаленный доступ невозможен, если репозиторий временно настроен на нормальный
режим, например, для регулярной обрезки.

Могут быть реализованы дополнительные меры защиты, но они выходят за рамки возможностей Borgs. Например, файл
снимки системы или упаковка борг служить для установки специальных разрешений или ACL для новых данных
файлы.

Используйте borgbackup онлайн с помощью сервисов onworks.net