borgbackup - Online na nuvem

PROGRAMA:

NOME

borg - BorgBackup é um programa de backup de desduplicação com compressão opcional e
criptografia autenticada.

O borg consiste em vários comandos. Cada comando aceita uma série de argumentos e
opções. As seções a seguir descreverão cada comando em detalhes.

SUPORTE

Formato of log saída
O nível de registro dos padrões de configuração de registro integrado é AVISO. Isto é porque
Queremos que o Borg seja silencioso e apenas emita avisos, erros e mensagens críticas.

Níveis de registro: DEBUG <INFO <WARNING <ERROR <CRITICAL

Use --depurar para definir o nível de registro DEBUG - para obter depuração, informação, aviso, erro e nível crítico
saída.

Use --informações (ou -v or --verbose) para definir o nível de registro INFO - para obter informações, avisos, erros e
saída de nível crítico.

Use --aviso (padrão) para definir o nível de registro de AVISO - para obter aviso, erro e crítico
saída de nível.

Use --erro para definir o nível de log de ERRO - para obter saída de erro e nível crítico.

Use --crítico para definir o nível de log CRÍTICO - para obter saída de nível crítico.

Embora você possa definir diversos. níveis de log, não espere que cada comando forneça
saída em diferentes níveis de registro - é apenas uma possibilidade.

AVISO:
As opções --critical e --error são fornecidas para integridade, seu uso não é
recomendado, pois você pode perder informações importantes.

AVISO:
Embora algumas opções (como --Estatísticas or --Lista) irá emitir mensagens mais informativas, você
tem que usar o nível de log INFO (ou inferior) para fazê-los aparecer na saída do log. Usar -v ou um
configuração de registro.

Devolução códigos
Borg pode sair com os seguintes códigos de retorno (rc):

0 = sucesso (registrado como INFO)
1 = aviso (a operação atingiu o fim normal, mas houve avisos -
você deve verificar o log, registrado como AVISO)
2 = erro (como um erro fatal, uma exceção local ou remota, a operação
não atingiu o fim normal, registrado como ERROR)
128 + N = morto pelo sinal N (por exemplo, 137 == matar -9)

Se você usar --show-rc, o código de retorno também é registrado no nível indicado como o último
entrada de registro.

Meio Ambiente Variáveis
Borg usa algumas variáveis ​​de ambiente para automação:

Geral:

BORG_REPO
Quando definido, use o valor para fornecer o local do repositório padrão. Se um
comando precisa de um parâmetro de arquivo, você pode abreviar como ::arquivo. Se um
comando precisa de um parâmetro de repositório, você pode deixá-lo fora ou
abreviar como ::, se um parâmetro posicional for necessário.

BORG_PASSPHRASE
Quando definido, use o valor para responder à pergunta da frase secreta para criptografado
repositórios.

BORG_DISPLAY_PASSPHRASE
Quando definido, use o valor para responder a "exibir a senha longa para
verificação "questão ao definir uma nova senha para criptografado
repositórios.

BORG_LOGGING_CONF
Quando definido, use o nome de arquivo fornecido como INIconfiguração de log de estilo.

BORG_RSH
Quando definido, use este comando em vez de ssh. Isso pode ser usado para especificar ssh
opções, como um arquivo de identidade personalizado ssh -i / caminho / para / privado / chave. Ver homem
ssh para outras opções.

TMPDIR onde os arquivos temporários são armazenados (pode precisar de muito espaço temporário para
algumas operações)

Alguns automático atendentes (E se conjunto, deles automaticamente responder confirmação perguntas):

BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK = não (ou = sim)
Para "Aviso: Tentativa de acessar um não criptografado anteriormente desconhecido
repositório"

BORG_RELOCATED_REPO_ACCESS_IS_OK = não (ou = sim)
Para "Aviso: O repositório no local ... estava localizado anteriormente em ..."

BORG_CHECK_I_KNOW_WHAT_I_AM_DOING = NÃO (ou = SIM)
Pois "Aviso: 'check --repair' é um recurso experimental que pode resultar
na perda de dados. "

BORG_DELETE_I_KNOW_WHAT_I_AM_DOING = NÃO (ou = SIM)
Para "Você solicitou EXCLUIR completamente o repositório incluam todos os
arquivos que contém: "

Nota: as respostas diferenciam maiúsculas de minúsculas. definir um valor de resposta inválido pode dar
a resposta padrão ou pergunte interativamente, dependendo se as novas tentativas são
permitido (eles são permitidos por padrão). Portanto, teste seus scripts interativamente
antes de torná-los um script não interativo.

Diretórios:

BORG_KEYS_DIR
Padrão para '~ / .config / borg / keys'. Este diretório contém chaves para criptografar
repositórios.

BORG_CACHE_DIR
Padrão para '~ / .cache / borg'. Este diretório contém o cache local e
pode precisar de muito espaço para lidar com grandes repositórios).

Construção:

BORG_OPENSSL_PREFIX
Adiciona determinado diretório de arquivo de cabeçalho OpenSSL aos locais padrão
(setup.py).

BORG_LZ4_PREFIX
Adiciona determinado diretório de arquivo de cabeçalho LZ4 aos locais padrão (setup.py).

Observe:

· Tenha muito cuidado ao usar os dizeres "sim", os avisos com prompt existem para o seu /
a segurança / proteção de seus dados

· Também tenha muito cuidado ao colocar sua senha longa em um script, certifique-se de que
permissões de arquivo apropriadas (por exemplo, modo 600, root: root).

Recursos Uso
O Borg pode usar muitos recursos, dependendo do tamanho do conjunto de dados que está lidando
com.

CPU: Não vai além de 100% de 1 núcleo, pois o código é atualmente de thread único.
Especialmente os níveis de compressão zlib e lzma mais altos usam quantidades significativas de CPU
ciclos.

Memória (BATER):
O índice de pedaços e o índice de arquivos são lidos na memória por motivos de desempenho.
Compressão, esp. A compressão lzma com níveis altos pode precisar de quantidades substanciais
de memória.

temporário arquivos:
Ler dados e metadados de um repositório montado FUSE consumirá cerca de
mesmo espaço que os pedaços desduplicados usados ​​para representá-los no repositório.

Esconderijo arquivos:
Contém o índice de pedaços e o índice de arquivos (além de uma coleção compactada de
índices de bloco de arquivo único).

Chunks índice:
Proporcional à quantidade de blocos de dados em seu repo. Muitos pedaços em seu repo
implicar em um índice de grandes pedaços. É possível ajustar os parâmetros do chunker (ver criar
opções).

Arquivos índice:
Proporcional à quantidade de arquivos em seu último backup. Pode ser desligado (ver
criar opções), mas o próximo backup será muito mais lento se você fizer isso.

Rede:
Se o seu repositório for remoto, todos desduplicados (e opcionalmente compactados /
criptografados) os dados obviamente precisam passar pela conexão (ssh: repo url). Se você
usar um sistema de arquivos de rede montado localmente, além de algumas operações de cópia usadas
para suporte de transação também vá pela conexão. Se você fizer backup de várias fontes
para um repositório de destino, ocorre tráfego adicional para a ressincronização do cache.

Caso esteja interessado em mais detalhes, leia a documentação interna.

Unidades
Para exibir as quantidades, o Borg se preocupa em respeitar as convenções usuais de escala. Disco
os tamanhos são exibidos em decimal, usando potências de dez (então kB significa 1000 bytes). Para memória
uso, binário prefixos são usados ​​e são indicados usando o IEC binário prefixos, Utilizando
poderes de dois (então KB significa 1024 bytes).

Data e Horário
Formatamos a data e a hora em conformidade com a ISO-8601, ou seja: AAAA-MM-DD e HH: MM: SS (24h
relógio).

Para obter mais informações sobre isso, consulte: https://xkcd.com/1179/

Salvo indicação em contrário, exibimos a data e a hora locais. Internamente, armazenamos e processamos
data e hora como UTC.

BORG INIT

uso: borg init [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- PATH de caminho remoto] [-e {nenhum, arquivo de chave, repokey}]
[REPOSITÓRIO]

Inicialize um repositório vazio

argumentos posicionais:
Repositório REPOSITÓRIO para criar

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")
-e {none, keyfile, repokey}, --encryption {none, keyfile, repokey}
selecione o modo de chave de criptografia (padrão: "repokey")

Descrição
Este comando inicializa um repositório vazio. Um repositório é um diretório de sistema de arquivos
contendo os dados desduplicados de zero ou mais arquivos. A criptografia pode ser habilitada em
tempo de inicialização do repositório.

Exemplos
# Repositório local (o padrão é usar criptografia no modo repokey)
$ borg init / path / to / repo

# Repositório local (sem criptografia)
$ borg init --encryption = none / path / to / repo

# Repositório remoto (acessa um borg remoto via ssh)
$ borg init usuário @ hostname: backup

# Repositório remoto (armazene a chave em seu diretório inicial)
$ borg init --encryption = usuário do arquivo de chaves @ nome do host: backup

Observações importantes sobre criptografia:

Não é recomendado desativar a criptografia. A criptografia do repositório protege você, por exemplo
contra o caso de um invasor ter acesso ao seu repositório de backup.

Mas tome cuidado com a chave / senha:

Se você quiser segurança "somente com senha", use o replay modo. A chave será armazenada
dentro do repositório (em seu arquivo "config"). No cenário de ataque mencionado acima, o
o invasor terá a chave (mas não a senha).

Se você deseja segurança de "senha longa e chave", use o arquivo-chave modo. A chave vai
ser armazenado em seu diretório pessoal (em .config / borg / keys) No cenário de ataque, o
atacante que tem apenas acesso ao seu repo não terá a chave (e também não o
senha longa).

Faça uma cópia de backup do arquivo de chave (arquivo-chave modo) ou arquivo de configuração repo (replay modo) e
mantenha-o em um local seguro, para que você ainda tenha a chave caso ela seja corrompida ou perdida. Também
mantenha a senha em um local seguro. O backup criptografado com essa chave não
te ajudar com isso, é claro.

Certifique-se de usar uma boa senha. Não muito curto, não muito simples. A criptografia real /
A chave de descriptografia é criptografada / bloqueada por sua frase-senha. Se um invasor conseguir seu
chave, ele não pode desbloquear e usar sem saber a senha longa.

Tenha cuidado com caracteres especiais ou não ASCII em sua senha:

· Borg processa a frase secreta como unicode (e a codifica como utf-8), por isso não tem
problemas em lidar até com os personagens mais estranhos.

· MAS: isso não se aplica necessariamente à configuração do seu sistema operacional / VM / teclado.

Portanto, é melhor usar uma frase-senha longa feita de caracteres ASCII simples do que uma que inclua
coisas não ascii ou caracteres que são difíceis / impossíveis de inserir em um teclado diferente
layout.

Você pode alterar sua senha para repositórios existentes a qualquer momento, isso não afetará o
chave de criptografia / descriptografia ou outros segredos.

BORG CRIAR

uso: borg create [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- PATH do caminho remoto] [-s] [-p] [--list]
[- filtro STATUSCHARS] [-e PADRÃO]
[--exclude-from EXCLUDEFILE] [--exclude-caches]
[--excluir-se-presente FILENAME] [--keep-tag-files]
[-c SEGUNDOS] [-x] [- numérico-proprietário]
[--timestamp aaaa-mm-ddThh: mm: ss]
[--chunker-params CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE]
[--ignore-inode] [-C COMPRESSION] [--read-special] [-n]
CAMINHO DE ARQUIVO [PATH ...]

Criar novo arquivo

argumentos posicionais:
ARCHIVE nome do arquivo a ser criado (deve ser também um válido
nome do diretório)
Caminhos PATH para arquivar

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")
-s, --stats imprime estatísticas para o arquivo criado
-p, --progress mostra a exibição do progresso ao criar o arquivo,
mostrando os tamanhos original, compactado e desduplicado,
seguido pelo número de arquivos vistos e o caminho
sendo processado, padrão: False
--list output lista detalhada de itens (arquivos, dirs, ...)
--filter STATUSCHARS exibe apenas itens com os caracteres de status fornecidos
-e PATTERN, --excluir PATTERN
excluir caminhos correspondentes a PATTERN
--exclude-de EXCLUDEFILE
ler padrões de exclusão de EXCLUDEFILE, um por linha
--exclude-caches exclui diretórios que contêm um arquivo CACHEDIR.TAG
(http://www.brynosaurus.com/cachedir/spec.html)
--excluir-se-presente FILENAME
excluir diretórios que contêm o arquivo especificado
--keep-tag-files mantém os arquivos de tag de caches / diretórios excluídos
-c SEGUNDOS, --checkpoint-interval SEGUNDOS
escrever ponto de verificação a cada SEGUNDOS segundos (Padrão: 300)
-x, --one-sistema de arquivos
permaneça no mesmo sistema de arquivos, não cruze os pontos de montagem
--numeric-owner armazena apenas identificadores numéricos de usuários e grupos
--timestamp aaaa-mm-ddThh: mm: ss
especificar manualmente a data / hora de criação do arquivo (UTC).
como alternativa, forneça um arquivo / diretório de referência.
--chunker-params CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE
especificar os parâmetros do chunker. padrão: 19,23,21,4095
--ignore-inode ignora os dados do inode no cache de metadados do arquivo usado para
detectar arquivos inalterados.
-C COMPRESSÃO, --compressão COMPRESSÃO
selecionar algoritmo de compressão (e nível): nenhum == não
compressão (padrão), lz4 == lz4, zlib == zlib
(nível padrão 6), zlib, 0 .. zlib, 9 == zlib (com
nível 0..9), lzma == lzma (nível padrão 6), lzma, 0 ..
lzma, 9 == lzma (com nível 0..9).
--read-special abre e lê arquivos especiais como se fossem normais
arquivos
-n, --dry-run não cria um arquivo de backup

Descrição
Este comando cria um arquivo de backup contendo todos os arquivos encontrados enquanto recursivamente
atravessando todos os caminhos especificados. O arquivo vai consumir quase nenhum espaço em disco para arquivos ou
partes de arquivos que já foram armazenados em outros arquivos.

Para acelerar a extração de backups sobre sshfs e sistemas de arquivos de rede semelhantes que não
fornecer informações de inode corretas o sinalizador --ignore-inode pode ser usado. Este potencialmente
diminui a confiabilidade da detecção de alterações, evitando sempre ler todos os arquivos no
esses sistemas de arquivos.

Consulte a saída do comando "padrões de ajuda borg" para obter mais ajuda sobre padrões de exclusão.

Exemplos
# Cópia de segurança ~ / Documentos em um arquivo chamado "meus-documentos"
$ borg criar / caminho / para / repo :: meus-documentos ~ / Documentos

# mesmo, mas liste detalhadamente todos os arquivos à medida que os processamos
$ borg create -v --list / path / to / repo :: my-documents ~ / Documentos

# Cópia de segurança ~ / Documentos e ~ / src mas exclui os arquivos pyc
$ borg criar / caminho / para / repo :: meus-arquivos \
~ / Documentos \
~ / src \
--excluir '* .pyc'

# Faça backup dos diretórios pessoais, excluindo miniaturas de imagens (ou seja, apenas
# /casa/* /. miniaturas são excluídas, não /casa/*/*/.miniaturas)
$ borg criar / caminho / para / repo :: meus-arquivos / Home \
--excluir re: ^/casa/[^ /] + / \. miniaturas / '

# Faça o mesmo usando um padrão de estilo shell
$ borg criar / caminho / para / repo :: meus-arquivos / Home \
--excluir 'sh:/casa/*/.miniaturas'

# Faça backup do sistema de arquivos raiz em um arquivo chamado "root-YYYY-MM-DD"
# use compactação zlib (boa, mas lenta) - o padrão é sem compactação
$ borg create -C zlib, 6 / path / to / repo :: root- {now:% Y-% m-% d} / --one-file-system

# Faça um grande esforço na desduplicação granular fina (gerenciamento de grande parte
# sobrecarga, precisa de muita RAM e espaço em disco, consulte a fórmula em detalhes internos
# docs - mesmos parâmetros que borg <1.0 ou sótão):
$ borg create --chunker-params 10,23,16,4095 / path / to / repo :: small / smallstuff

# Faça backup de um dispositivo bruto (não deve estar ativo / em uso / montado naquele momento)
$ dd if = / dev / sdx bs = 10M | borg create / path / to / repo :: my-sdx -

# Sem compressão (padrão)
$ borg criar / caminho / para / repo :: arch ~

# Super rápido, baixa compressão
$ borg create --compression lz4 / path / to / repo :: arch ~

# Menos rápido, compressão mais alta (N = 0..9)
$ borg create --compression zlib, N / path / to / repo :: arch ~

# Ainda mais lento, compressão ainda maior (N = 0..9)
$ borg create --compression lzma, N / path / to / repo :: arch ~

# Tags de formato disponíveis para o nome do arquivo:
# {agora}, {utcnow}, {fqdn}, {nome do host}, {usuário}, {pid}
# adicionar nome de host curto, nome de usuário de backup e unixtime atual (segundos da época)
$ borg criar / caminho / para / repo :: {nome do host} - {usuário} - {agora:% s} ~

BORG EXTRAIR

uso: extrato borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- PATH de caminho remoto] [--list] [-n] [-e PATTERN]
[--excluir-de EXCLUDEFILE] [--numeric-owner]
[--strip-components NUMBER] [--stdout] [--sparse]
ARQUIVO [PATH [PATH ...]]

Extraia o conteúdo do arquivo

argumentos posicionais:
Arquivo ARCHIVE para extrair
Caminhos PATH a serem extraídos; padrões são suportados

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")
--list output lista detalhada de itens (arquivos, dirs, ...)
-n, --dry-run não altera nenhum arquivo
-e PATTERN, --excluir PATTERN
excluir caminhos correspondentes a PATTERN
--exclude-de EXCLUDEFILE
ler padrões de exclusão de EXCLUDEFILE, um por linha
--numeric-owner obedece apenas a identificadores numéricos de usuário e grupo
--strip-componentes NÚMERO
Remova o número especificado de elementos de caminho à esquerda.
Os nomes de caminho com menos elementos serão silenciosos
pulado.
--stdout grava todos os dados extraídos em stdout
--sparse cria buracos na saída de arquivo esparso de zero
pedaços

Descrição
Este comando extrai o conteúdo de um arquivo. Por padrão, todo o arquivo é
extraído, mas um subconjunto de arquivos e diretórios pode ser selecionado passando uma lista de CAMINHOS
como argumentos. A seleção do arquivo pode ser ainda mais restrita usando o --excluir opção.

Consulte a saída do comando "padrões de ajuda borg" para obter mais ajuda sobre padrões de exclusão.

Exemplos
# Extraia o arquivo inteiro
$ borg extrair / caminho / para / repo :: meus-arquivos

# Extraia arquivo inteiro e arquivos de lista durante o processamento
$ borg extract -v --list / path / to / repo :: my-files

# Extraia o diretório "src"
$ borg extrair / caminho / para / repo :: meus-arquivos home / NOME DE USUÁRIO / src

# Extraia o diretório "src", mas exclua os arquivos de objeto
$ borg extrair / caminho / para / repo :: meus-arquivos home / NOME DE USUÁRIO / src --excluir '* .o'

# Restaurar um dispositivo bruto (não deve estar ativo / em uso / montado naquele momento)
$ borg extract --stdout / path / to / repo :: my-sdx | dd de = / dev / sdx bs = 10M

Observação: atualmente, extrato sempre escreve para dentro que o atual trabalhar anuário ("."),
então certifique-se de você cd para o lugar certo antes de ligar borg extrato.

BORG VERIFICAÇÃO

uso: borg check [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- caminho remoto PATH] [--repository-only] [--archives-only]
[--reparar] [--economizar espaço] [--último N] [-P PREFIX]
[REPOSITÓRIO_OU_ARQUIVO]

Verifique a consistência do repositório

argumentos posicionais:
REPOSITÓRIO_OR_ARCHIVE
repositório ou arquivo para verificar a consistência de

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")
- apenas repositório executa verificações de repositório
- somente arquivos executam verificações de arquivos
--repair tentativa de reparar quaisquer inconsistências encontradas
- poupar espaço trabalhar mais devagar, mas usando menos espaço
--last N verifica apenas os últimos N arquivos (Padrão: todos)
-P PREFIXO, --prefix PREFIXO
considere apenas nomes de arquivo começando com este prefixo

Descrição
O comando check verifica a consistência de um repositório e dos arquivos correspondentes.

Primeiro, os arquivos de dados do repositório subjacente são verificados:

· Para todos os segmentos, a mágica do segmento (cabeçalho) é verificada

· Para todos os objetos armazenados nos segmentos, todos os metadados (por exemplo, crc e tamanho) e todos os dados são
leitura. Os dados lidos são verificados por tamanho e CRC. Apodrecimento de bits e outros tipos de acidentes
os danos podem ser detectados desta forma.

· Se estivermos em modo de reparo e um erro de integridade for detectado para um segmento, tentamos
recuperar tantos objetos do segmento quanto possível.

· No modo de reparo, ele garante que o índice seja consistente com os dados armazenados no
segmentos.

· Se você usar um servidor repo remoto via ssh :, a verificação repo é executada no servidor repo
sem causar tráfego de rede significativo.

· A verificação do repositório pode ser ignorada usando a opção --archives-only.

Em segundo lugar, a consistência e exatidão dos metadados do arquivo são verificadas:

· O manifesto do repo está presente? Se não, ele é reconstruído a partir de pedaços de metadados de arquivo (este
requer leitura e descriptografia de todos os metadados e dados).

· Verifique se o fragmento de metadados do arquivo está presente. se não, remova o arquivo do manifesto.

· Para todos os arquivos (itens) no arquivo, para todos os pedaços referenciados por esses arquivos, verifique se
pedaço está presente (se não e estivermos em modo de reparo, substitua-o por um pedaço do mesmo tamanho de
zeros). Isso requer a leitura do arquivo e dos metadados do arquivo, mas não dos dados.

· Se estivermos em modo de reparo e verificamos todos os arquivos: exclua os pedaços órfãos de
o repo.

· Se você usar um servidor repo remoto via ssh :, a verificação do arquivo é executada no cliente
máquina (porque se a criptografia estiver ativada, as verificações exigirão a descriptografia e esta
sempre é feito do lado do cliente, porque o acesso à chave será necessário).

· As verificações de arquivo podem ser demoradas, podem ser ignoradas usando o
opção --repository-only.

BORG RENOMEAR

uso: renomear borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- PATH de caminho remoto]
ARQUIVAR NOVONOME

Renomear um arquivo existente

argumentos posicionais:
ARCHIVE arquivo para renomear
NEWNAME o novo nome de arquivo a ser usado

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")

Descrição
Este comando renomeia um arquivo no repositório.

Exemplos
$ borg create / path / to / repo :: archivename ~
lista $ borg / caminho / para / repo
archivename seg, 2016-02-15 19:50:19

$ borg rename / path / to / repo :: archivename newname
lista $ borg / caminho / para / repo
newname Seg, 2016-02-15 19:50:19

BORG LISTA

uso: lista borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- caminho remoto PATH] [--short] [--list-format LISTFORMAT]
[-P PREFIXO]
[REPOSITÓRIO_OU_ARQUIVO]

Listar conteúdo do arquivo ou repositório

argumentos posicionais:
REPOSITÓRIO_OR_ARCHIVE
repositório / arquivo para listar o conteúdo de

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")
--short imprime apenas nomes de arquivos / diretórios, nada mais
--list-format LISTFORMAT
especificar o formato para a lista de arquivos (padrão:
"{mode} {user: 6} {group: 6} {size: 8d} {isomtime}
{path} {extra} {NEWLINE} ") Existe um" {formatkeys} "especial
para listar as chaves disponíveis
-P PREFIXO, --prefix PREFIXO
considere apenas nomes de arquivo começando com este prefixo

Descrição
Este comando lista o conteúdo de um repositório ou arquivo.

Exemplos
lista $ borg / caminho / para / repo
Segunda-feira, 2016/02/15 19:15:11
repo seg, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
newname Seg, 2016-02-15 19:50:19
...

$ borg list / path / to / repo :: root-2016-02-15
drwxr-xr-x root root 0 Seg, 2016-02-15 17:44:27.
drwxrwxr-x root root 0 Seg, 2016-02-15 19:04:49 bin
-rwxr-xr-x root root 1029624 Qui, 2014-11-13 00:08:51 bin / bash
lrwxrwxrwx root root 0 Sex, 2015-03-27 20:24:26 bin / bzcmp -> bzdiff
-rwxr-xr-x root root 2140 Sex, 2015-03-27 20:24:22 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 Sun, 2015-02-01 11:00:00.
drwxrwxr-x usuário usuário 0 dom, 2015-02-01 11:00:00 código
drwxrwxr-x user user 0 Dom, 2015-02-01 11:00:00 code / myproject
-rw-rw-r-- usuário usuário 1416192 Sun, 2015-02-01 11:00:00 code / myproject / file.ext
...

# veja o que é alterado entre os arquivos, com base na hora de modificação do arquivo, tamanho e caminho do arquivo
$ 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 código 0 1422781200 código 0
1422781200 código 0 / meuprojeto 1422781200 código 0 / meuprojeto
1422781200 1416192 code / myproject / file.ext | 1454664653 1416192 code / myproject / file.ext
...

BORG EXCLUIR

uso: borg delete [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- PATH de caminho remoto] [-p] [-s] [-c] [--save-space]
[ALVO]

Exclua um repositório ou arquivo existente

argumentos posicionais:
Arquivo ou repositório TARGET para excluir

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")
-p, --progress mostra a exibição do progresso ao deletar um único arquivo
-s, --stats imprime estatísticas do arquivo apagado
-c, --cache-only exclui apenas o cache local para o repositório fornecido
- poupar espaço trabalhar mais devagar, mas usando menos espaço

Descrição
Este comando exclui um arquivo do repositório ou do repositório completo. Disco
o espaço é recuperado em conformidade. Se você excluir o repositório completo, o cache local para
ele (se houver) também é excluído.

Exemplos
# excluir um único arquivo de backup:
$ borg deletar / caminho / para / repo :: segunda-feira

# exclua todo o repositório e o cache local relacionado:
$ borg deletar / caminho / para / repo
Você solicitou EXCLUIR completamente o repositório * incluindo * todos os arquivos que ele contém:
repo seg, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
newname Seg, 2016-02-15 19:50:19
Digite 'SIM' se entender isso e quiser continuar: SIM

BORG AMEIXA SECA

uso: borg prune [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- PATH do caminho remoto] [-n] [-s] [--list]
[--manter dentro de DENTRO] [-H HORA] [-d DIARIAMENTE] [-sem. SEMANAL]
[-m MENSALMENTE] [-A ANO] [-P PREFIXO] [- salvar espaço]
[REPOSITÓRIO]

Remova os arquivos do repositório de acordo com as regras especificadas

argumentos posicionais:
Repositório REPOSITÓRIO para podar

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")
-n, --dry-run não muda o repositório
-s, --stats imprime estatísticas do arquivo apagado
--list output lista detalhada de arquivos que mantém / remove
--keep-within WITHIN mantém todos os arquivos dentro deste intervalo de tempo
-H HORA, --manter hora HORA
número de arquivos por hora para manter
-d DIARIAMENTE, --manter-diariamente DIARIAMENTE
número de arquivos diários para manter
-wEEKLY, --manter-semanais WEEKLY
número de arquivos semanais para manter
-m MENSALMENTE, --manter mensalmente MENSALMENTE
número de arquivos mensais para manter
-a ANO, --manter-anualmente ANO
número de arquivos anuais para manter
-P PREFIXO, --prefix PREFIXO
considere apenas nomes de arquivo começando com este prefixo
- poupar espaço trabalhar mais devagar, mas usando menos espaço

Descrição
O comando prune remove um repositório, excluindo arquivos que não correspondem a nenhum dos
opções de retenção especificadas. Este comando é normalmente usado por scripts de backup automatizados
querendo manter um certo número de backups históricos.

Por exemplo, "-d 7" significa manter o backup mais recente em cada dia, até 7 mais recentes
dias com backups (dias sem backups não contam). As regras são aplicadas de hora em hora
a anual, e os backups selecionados pelas regras anteriores não contam para os posteriores
as regras. O tempo que cada backup é concluído é usado para fins de remoção. Datas e horas
são interpretados no fuso horário local e as semanas vão de segunda a domingo. Especificando um
número negativo de arquivos a serem mantidos significa que não há limite.

A opção "--keep-within" leva um argumento da forma " ", onde char é" H ",
"d", "w", "m", "y". Por exemplo, "--keep-within 2d" significa manter todos os arquivos que foram
criado nas últimas 48 horas. "1m" significa "31d". Os arquivos mantidos com
esta opção não conta para os totais especificados por qualquer outra opção.

Se um prefixo for definido com -P, apenas os arquivos que começam com o prefixo são considerados
para exclusão e apenas esses arquivos contam para os totais especificados pelas regras.
Caso contrário, todos os arquivos no repositório são candidatos à exclusão!

Exemplos
Tenha cuidado, prune é um comando potencialmente perigoso, ele removerá arquivos de backup.

O padrão de poda é aplicar a todos os arquivo in que o repositório a menos que você restrinja seu
operação para um subconjunto dos arquivos usando --prefixo. Ao usar --prefixo, tome cuidado para
escolha um bom prefixo - por exemplo, não use um prefixo "foo" se você também não quiser corresponder
"foobar".

É altamente recomendável executar sempre ameixa seca --funcionamento a seco ... primeiro então você vai ver o que é
faria sem realmente fazer nada.

# Mantenha 7 arquivos de fim de dia e 4 arquivos adicionais de fim de semana.
# Faça um teste sem realmente excluir nada.
$ borg prune --dry-run --keep-daily = 7 --keep-Weekly = 4 / path / to / repo

# O mesmo que acima, mas se aplica apenas a nomes de arquivos começando com "foo":
$ borg prune --keep-daily = 7 --keep-Weekly = 4 --prefix = foo / path / to / repo

# Manter 7 arquivos de fim de dia, 4 arquivos adicionais de fim de semana,
# e um arquivo de final de mês para cada mês:
$ borg prune --manter-diário = 7 --manter-semanal = 4 --manter-mensal = -1 / caminho / para / repo

# Mantenha todos os backups nos últimos 10 dias, 4 arquivos adicionais de fim de semana,
# e um arquivo de final de mês para cada mês:
$ borg prune --manter dentro = 10d --manter-semanal = 4 --manter-mensal = -1 / caminho / para / repo

BORG INFORMACAO

uso: borg info [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- PATH de caminho remoto]
ARQUIVO

Mostrar detalhes do arquivo, como espaço em disco usado

argumentos posicionais:
Arquivo ARCHIVE para exibir informações sobre

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")

Descrição
Este comando exibe algumas informações detalhadas sobre o arquivo especificado.

Exemplos
$ borg info / path / to / repo :: root-2016-02-15
Nome: root-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
Nome do host: myhostname
Nome de usuário: root
Horário (início): Seg, 2016/02/15 19:36:29
Horário (fim): Seg, 2016/02/15 19:39:26
Linha de comando: / usr / local / bin / borg create -v --list -C zlib, 6 / path / to / repo :: root-2016-02-15 / --one-file-system
Número de arquivos: 38100

Tamanho original Tamanho comprimido Tamanho desduplicado
Este arquivo: 1.33 GB 613.25 MB 571.64 MB
Todos os arquivos: 1.63 GB 853.66 MB 584.12 MB

Pedaços únicos Pedaços totais
Índice de bloco: 36858 48844

BORG MONTE

uso: borg mount [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- PATH de caminho remoto] [-f] [-o OPÇÕES]
REPOSITORY_OR_ARCHIVE MOUNTPPOINT

Monte o arquivo ou um repositório inteiro como um sistema de arquivos FUSE

argumentos posicionais:
REPOSITÓRIO_OR_ARCHIVE
repositório / arquivo para montar
MOUNTPOINT onde montar o sistema de arquivos

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")
-f, --foreground fica em primeiro plano, não daemoniza
-o OPÇÕES Opções de montagem extra

Descrição
Este comando monta um arquivo como um sistema de arquivos FUSE. Isso pode ser útil para navegar em
arquivar ou restaurar arquivos individuais. A menos que --primeiro plano opção recebe o comando
será executado em segundo plano até que o sistema de arquivos seja montado.

Exemplos
$ borg mount / path / to / repo :: root-2016-02-15 / tmp / mymountpoint
$ ls / tmp / mymountpoint
bin boot etc home lib lib64 perdido + mídia encontrada mnt opt ​​root sbin srv tmp usr var
$ fusermount -u / tmp / mymountpoint

BORG ALTERAR-PASSPHRASE

uso: borg change-passphrase [-h] [--critical] [--error] [--warning] [--info]
[--debug] [--lock-wait N] [--show-rc]
[--no-files-cache] [--umask M]
[- PATH de caminho remoto]
[REPOSITÓRIO]

Alterar senha do arquivo de chave do repositório

argumentos posicionais:
REPOSITÓRIO

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")

Descrição
Os arquivos de chave usados ​​para criptografia do repositório são opcionalmente protegidos por senha. Esse
pode ser usado para alterar esta senha.

Exemplos
# Crie um repositório protegido por arquivo de chave
$ borg init --encryption = keyfile -v / path / to / repo
Inicializando o repositório em "/ path / to / repo"
Digite a nova senha longa:
Digite a mesma senha novamente:
Lembre-se de sua senha longa. Seus dados ficarão inacessíveis sem ele.
Digite "/root/.config/borg/keys/mnt_backup" criado.
Mantenha esta chave segura. Seus dados ficarão inacessíveis sem ele.
Sincronizando chunks de cache ...
Arquivos: 0, c / Idx em cache: 0, c / Idx desatualizado: 0, sem Idx em cache: 0.
Feito.

# Alterar senha do arquivo de chave
$ borg change-passphrase -v / path / to / repo
Digite a senha longa para a chave /root/.config/borg/keys/mnt_backup:
Digite a nova senha longa:
Digite a mesma senha novamente:
Lembre-se de sua senha longa. Seus dados ficarão inacessíveis sem ele.
Chave atualizada

BORG SERVIR

uso: borg serve [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- PATH do caminho remoto] [- PATH do caminho restrito]

Comece no modo de servidor. Este comando geralmente não é usado manualmente.

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")
- Restrict-to-path PATH
restringir o acesso ao repositório ao PATH

Descrição
Este comando inicia um processo de servidor de repositório. Este comando geralmente não é usado
manualmente.

Exemplos
borg serve tem suporte especial para comandos forçados ssh (ver autorizado_chaves exemplo
abaixo): ele detectará que você usa tal comando forçado e extrairá o valor do
--restringir ao caminho opção (ões). Em seguida, ele analisará o comando original que veio do
cliente, certifique-se de que também seja borg servir e aplicar restrição (ões) de caminho conforme fornecido por
o comando forçado. Dessa forma, outras opções fornecidas pelo cliente (como --informações or --umask)
são preservados (e não são corrigidos pelo comando forçado).

# Permite que um par de chaves SSH execute apenas o borg e tenha acesso apenas a / path / to / repo.
# Use as opções principais para desabilitar a funcionalidade SSH desnecessária e potencialmente perigosa.
# Isso ajudará a proteger um sistema de backup remoto automatizado.
$ gato ~ / .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

uso: atualização do borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[- PATH de caminho remoto] [-p] [-n] [-i]
[REPOSITÓRIO]

atualizar um repositório de uma versão anterior

argumentos posicionais:
Caminho do REPOSITÓRIO para o repositório a ser atualizado

argumentos opcionais:
-h, --help mostra esta mensagem de ajuda e sai
--trabalho crítico no nível de log CRÍTICO
--erro trabalhar no nível de log ERROR
- trabalho de advertência no nível de registro AVISO (padrão)
--info, -v, --verbose
trabalhar no nível de log INFO
--debug work no nível de log DEBUG
--lock-wait N espera pelo bloqueio, mas máx. N segundos (padrão: 1).
--show-rc mostra / registra o código de retorno (rc)
--no-files-cache não carrega / atualiza o cache de metadados de arquivo usado para
detectar arquivos inalterados
--umask M definir umask para M (local e remoto, padrão: 0077)
--remote-path PATH define o caminho remoto para executável (padrão: "borg")
-p, --progress mostra a exibição de progresso durante a atualização do repositório
-n, --dry-run não muda o repositório
-i, --inplace rewrite repositório no lugar, sem chance de ir
de volta às versões anteriores do repositório.

Descrição
Atualize um repositório Borg existente. Isso atualmente suporta a conversão de um sótão
repositório para Borg e também ajuda na conversão de Borg 0.xx em 1.0.

Atualmente, apenas os repositórios LOCAL podem ser atualizados (problema # 465).

Isso mudará as strings mágicas nos segmentos do repositório para corresponder à nova mágica Borg
cordas. Os arquivos-chave encontrados em $ ATTIC_KEYS_DIR ou ~ / .attic / keys / também será convertido
e copiado para $ BORG_KEYS_DIR ou ~ / .config / borg / keys.

Os arquivos de cache são convertidos, de $ ATTIC_CACHE_DIR ou ~ / .cache / sótão para $ BORG_CACHE_DIR
or ~ / .cache / borg, mas o layout do cache entre Borg e Attic mudou, então é possível
o primeiro backup após a conversão leva mais tempo do que o esperado devido à ressincronização do cache.

A atualização deve ser capaz de retomar se for interrompida, embora ainda vá iterar por completo
segmentos. Se você quiser começar do zero, use borg excluir sobre o repositório copiado para
certifique-se de que os arquivos de cache também sejam removidos:
borg deletar borg

A menos que --no lugar for especificado, o processo de atualização primeiro cria uma cópia de backup do
repositório, em REPOSITORY.upgrade-DATETIME, usando hardlinks. Isso leva mais tempo do que em
colocar atualizações, mas é muito mais seguro e fornece informações de progresso (ao contrário de cp -al).
Quando estiver satisfeito com a conversão, você pode destruir com segurança a cópia de backup.

AVISO: Executar a atualização no local tornará a cópia atual inutilizável com versões anteriores
versão, sem possibilidade de voltar às versões anteriores. Isso pode DANIFICAR PERMANENTEMENTE SEU
REPOSITÓRIO! O sótão NÃO PODE LER REPOSITÓRIOS BORG, pois as cordas mágicas mudaram. Vocês
foram avisados.

Exemplos
# Atualize o repositório borg para a versão mais recente.
$ borg upgrade -v / path / to / repo
fazendo uma cópia do hardlink em /path/to/repo.upgrade-2016-02-15-20:51:55
abrindo repositório no sótão com borg e convertendo
nenhum arquivo de chave encontrado para o repositório
convertendo índice repo /path/to/repo/index.0
convertendo 1 segmento ...
converter borg 0.xx em corrente borg
nenhum arquivo de chave encontrado para o repositório

DIVERSOS AJUDA

borg ajudar padrões
Os padrões de exclusão suportam quatro estilos separados, fnmatch, shell, expressões regulares e
prefixos de caminho. Se seguido por dois pontos (':'), os primeiros dois caracteres de um padrão são usados
como um seletor de estilo. A seleção de estilo explícito é necessária quando um estilo não padrão é
desejado ou quando o padrão desejado começa com dois caracteres alfanuméricos seguidos por um
dois pontos (ou seja aa: algo / *).

Fnmatch, seletor fm:
Esses padrões usam uma variante da sintaxe do padrão de shell, com '*' correspondendo a qualquer número de
personagens, '?' correspondendo a qualquer caractere único, '[...]' correspondendo a qualquer caractere único
especificado, incluindo intervalos, e '[! ...]' correspondendo a qualquer caractere não especificado. Para o
finalidade desses padrões, o separador de caminho ('' para Windows e '/' em outros sistemas)
não é tratado de maneira especial. Envolva os metacaracteres entre colchetes para uma correspondência literal (ou seja,
[?] para combinar com o caractere literal ?) Para que um caminho corresponda a um padrão, ele deve
corresponder completamente do início ao fim, ou deve corresponder do início até um pouco antes de um caminho
separador. Exceto para o caminho raiz, os caminhos nunca terminarão no separador de caminho quando
correspondência é tentada. Assim, se um determinado padrão termina em um separador de caminho, um '*' é
anexado antes de tentar a correspondência.

Padrões de estilo shell, seletor eh:
Assim como os padrões fnmatch, eles são semelhantes aos padrões de shell. A diferença é que o
padrão pode incluir ** / para combinar zero ou mais níveis de diretório, * para combinar zero
ou mais caracteres arbitrários, com exceção de qualquer separador de caminho.

Expressões regulares, seletor RE:
Expressões regulares semelhantes às encontradas em Perl são suportadas. Ao contrário dos padrões de concha
expressões regulares não são necessárias para corresponder ao caminho completo e qualquer correspondência de substring
é suficiente. É altamente recomendável ancorar os padrões no início ('^'), no
end ('$') ou ambos. Separadores de caminho ('' para Windows e '/' em outros sistemas) em caminhos
são sempre normalizados para uma barra ('/') antes de aplicar um padrão. O regular
a sintaxe da expressão é descrita no Python documentação para que o re módulo.

Caminho do prefixo, seletor pp:
Este estilo de padrão é útil para combinar subdiretórios inteiros. O padrão pp: / data / bar
fósforos / data / bar e tudo nele.

As exclusões podem ser passadas através da opção de linha de comando --excluir. Quando usado de dentro de um
shell, os padrões devem ser citados para protegê-los de expansão.

A --excluir-de opção permite carregar padrões de exclusão de um arquivo de texto com um
padrão por linha. Linhas vazias ou começando com o cardinal ('#') após a remoção
espaços em branco em ambas as extremidades são ignorados. O prefixo do seletor de estilo opcional também é compatível
para padrões carregados de um arquivo. Devido aos caminhos de remoção de espaço em branco com espaço em branco no
o início ou o fim só podem ser excluídos usando expressões regulares.

Exemplos:

# Exclua '/home/user/file.o' mas não '/home/user/file.odt': $ borg create -e '
*
.o 'backup /

# Exclua '/ home / user / junk' e '/ home / user / subdir / junk' mas # não
'/ home / user / importantjunk' ou '/ etc / junk': $ borg create -e '/casa/
*
/ junk 'backup /

# Exclua o conteúdo de '/ home / user / cache', mas não o diretório em si: $ borg create
-e / home / usuário / cache / backup /

# O arquivo '/ home / user / cache / important' é não backup: $ borg create -e
/ home / usuário / cache / backup / / home / usuário / cache / importante

# O conteúdo dos diretórios em '/ Home'não tem backup quando seu nome # termina em
'.tmp' $ borg create --exclude 're: ^/casa/[^ /] +. tmp / 'backup /

# Carregar exclusões do arquivo $ cat> exclude.txt < /casa//lixo * Tmp.
fm: aa: algo / re: ^/casa/[^ /]. tmp / sh:/casa/
*
/.thumbnails EOF $ borg create --exclude-from exclude.txt backup /

DEBUG COMANDOS

Existem mais alguns comandos (todos começando com "debug-") que são todos não Pretendido para
normal usar e potencialmente muito perigoso se usado incorretamente.

Eles existem para melhorar os recursos de depuração sem acesso direto ao sistema, por exemplo, no caso
você já se deparou com algum mau funcionamento grave. Use-os apenas se você souber o que está fazendo ou
se um desenvolvedor Borg confiável lhe disser o que fazer.

ADICIONAL NOTAS

Aqui estão diversos. notas sobre tópicos que talvez não sejam cobertos com detalhes suficientes no uso
seção.

item bandeiras
borg crio -v --Lista gera uma lista detalhada de todos os arquivos, diretórios e outros arquivos
itens de sistema considerados (independentemente de terem ou não alterações de conteúdo). Para cada
item, ele prefixa um sinalizador de uma única letra que indica o tipo e / ou status do item.

Se você está interessado apenas em um subconjunto dessa saída, você pode fornecer, por exemplo --filter = AME e
ele só mostrará arquivos regulares com status A, M ou E (veja abaixo).

Um caractere maiúsculo representa o status de um arquivo regular em relação aos "arquivos"
cache (não relativo ao repo - este é um problema se o cache de arquivos não for usado).
Os metadados são armazenados em qualquer caso e para 'A' e 'M' também novos blocos de dados são armazenados. Para
'U' todos os blocos de dados referem-se a blocos já existentes.

· 'A' = arquivo regular adicionado (veja também a_status_oddity no FAQ)

· 'M' = arquivo regular, modificado

· 'U' = arquivo regular, inalterado

· 'E' = arquivo normal, ocorreu um erro ao acessar / ler isto lima

Um caractere minúsculo significa um tipo de arquivo diferente de um arquivo normal, borg geralmente apenas
armazena seus metadados:

· 'D' = diretório

· 'B' = dispositivo de bloqueio

· 'C' = dispositivo char

· 'H' = arquivo regular, hardlink (para inodes já vistos)

· 'S' = link simbólico

· 'F' = fifo

Outros sinalizadores usados ​​incluem:

· 'I' = dados de backup lidos da entrada padrão (stdin)

· '-' = simulação, o item era não apoiado

· '?' = código de status ausente (se você vir isso, envie um relatório de bug!)

--chunker-params
Os parâmetros de chunker influenciam como os arquivos de entrada são cortados em pedaços (pedaços) que são então
considerado para desduplicação. Eles também têm um grande impacto no uso de recursos (RAM e disco
espaço), pois a quantidade de recursos necessários é (também) determinada pela quantidade total de
pedaços no repositório (veja Índices / Caches memória uso para mais detalhes).

--chunker-params = 10,23,16,4095 resulta em uma desduplicação refinada e cria um grande
quantidade de pedaços e, portanto, usa muitos recursos para gerenciá-los. Isso é bom para
volumes de dados relativamente pequenos e se a máquina tiver uma boa quantidade de RAM e disco livre
espaço.

--chunker-params = 19,23,21,4095 (padrão) resulta em uma desduplicação de baixa granularidade e
cria uma quantidade muito menor de blocos e, portanto, usa menos recursos. Isso é bom para
volumes de dados relativamente grandes e se a máquina tiver uma quantidade relativamente baixa de RAM livre e
espaço em disco.

Se você já fez alguns arquivos em um repositório e, em seguida, alterou os parâmetros do chunker,
isso, é claro, afeta a desduplicação, pois os pedaços serão cortados de maneira diferente.

Na pior das hipóteses (todos os arquivos são grandes e foram tocados entre os backups), isso armazenará
todo o conteúdo no repositório novamente.

Normalmente, não é tão ruim assim:

· Geralmente a maioria dos arquivos não são tocados, então ele irá apenas reutilizar os pedaços antigos que já possui
no repo

· Arquivos menores que o (antigo e novo) tamanho mínimo do bloco resultam em apenas um bloco
de qualquer maneira, os pedaços resultantes são os mesmos e a desduplicação será aplicada

Se você mudar os parâmetros do chunker para economizar recursos para um repo existente que já tem algum
arquivos de backup, você verá um efeito crescente ao longo do tempo, quando mais e mais arquivos
foram tocados e armazenados novamente usando o tamanho do bloco maior e todas as referências ao
pedaços menores e mais antigos foram removidos (excluindo / removendo arquivos).

Se você quiser ver um grande efeito imediato no uso de recursos, é melhor começar um novo
repositório ao alterar os parâmetros do chunker.

Para obter mais detalhes, consulte chunker_details.

--read-especial
A opção --read-especial não se destina a nível de sistema de arquivos normal (completo ou
backups parcialmente recursivos). Você só dá esta opção se quiser fazer algo ao invés
... especial - e se você selecionou alguns arquivos que deseja tratar dessa forma.

borg crio --read-especial irá abrir todos os arquivos sem fazer nenhum tratamento especial
de acordo com o tipo de arquivo (a única exceção aqui são os diretórios: eles serão recorrentes
em). Imagine o que acontece se você fizer gato nome do arquivo --- o conteúdo que você verá lá
é o que o borg fará backup para esse nome de arquivo.

Assim, por exemplo, links simbólicos serão seguidos, o conteúdo do dispositivo de bloco será lido, tubos nomeados
Os soquetes de domínio / UNIX serão lidos.

Você precisa ter cuidado com o que você dá como nome de arquivo ao usar --read-especial, por exemplo, se
você dá / dev / zero, seu backup nunca será encerrado.

Os metadados dos arquivos fornecidos são salvos como seriam salvos sem --read-especial (por exemplo, é
nome, seu tamanho [pode ser 0], seu modo, etc.) - mas, além disso, também o conteúdo lido
dele será salvo para ele.

Restaurar o conteúdo de tais arquivos é atualmente suportado apenas um de cada vez via --stdout
opção (e você tem que redirecionar o stdout para onde quer que ele vá, talvez diretamente para um
arquivo de dispositivo existente de sua escolha ou indiretamente via dd).

Exemplo
Imagine que você tenha feito alguns instantâneos de volumes lógicos (LVs) dos quais deseja fazer backup.

NOTA:
Para alguns cenários, este é um bom método para obter consistência semelhante a um travamento (eu o chamo
semelhante a um travamento porque é o mesmo que você obteria se apenas apertasse o botão de reinicialização ou
sua máquina travaria repentina e completamente). Isso é melhor do que nenhuma consistência
em tudo e um bom método para alguns casos de uso, mas provavelmente não é bom o suficiente se você tiver
bancos de dados em execução.

Em seguida, você cria um arquivo de backup de todos esses instantâneos. O processo de backup verá um
estado "congelado" dos volumes lógicos, enquanto os processos funcionam nos volumes originais
continue alterando os dados armazenados lá.

Você também adiciona a saída de lvdisplay ao seu backup, para que você possa ver os tamanhos de LV no caso
você sempre precisará recriá-los e restaurá-los.

Após a conclusão do backup, você remove os instantâneos novamente.

$ # crie instantâneos aqui
$ lvdisplay> lvdisplay.txt
$ borg create --read-special / path / to / repo :: arch lvdisplay.txt / dev / vg0 / * - instantâneo
$ # remova instantâneos aqui

Agora, vamos ver como restaurar alguns LVs desse backup.

$ borg extract / path / to / repo :: arch lvdisplay.txt
$ # crie LVs vazios com os tamanhos corretos aqui (veja lvdisplay.txt).
$ # presumimos que você criou uma raiz vazia e um LV inicial e os substituiu agora:
$ borg extract --stdout / path / to / repo :: arch dev / vg0 / root-snapshot> / dev / vg0 / root
$ borg extract --stdout / path / to / repo :: arch dev / vg0 / home-snapshot> / dev / vg0 / home

Somente anexo modo
Um repositório pode ser definido como "apenas anexado", o que significa que o Borg nunca sobrescreverá ou
exclua os dados confirmados. Isso é útil para cenários onde várias máquinas fazem backup para um
servidor de backup central usando borg servir, uma vez que uma máquina hackeada não pode excluir backups
permanentemente.

Para ativar o modo somente acréscimo, edite o repositório configuração arquivo e adicionar uma linha append_only = 1
ao [repositório] seção (ou edite a linha, se houver).

No modo apenas anexar, o Borg criará um log de transações no transações arquivo, onde
cada linha é uma transação e um carimbo de data / hora UTC.

Exemplo
Suponha que um invasor excluiu remotamente todos os backups, mas seu repositório estava apenas em anexo
modo. Um log de transações nesta situação pode ter a seguinte aparência:

transação 1, hora UTC 2016-03-31T15: 53: 27.383532
transação 5, hora UTC 2016-03-31T15: 53: 52.588922
transação 11, hora UTC 2016-03-31T15: 54: 23.887256
transação 12, hora UTC 2016-03-31T15: 55: 54.022540
transação 13, hora UTC 2016-03-31T15: 55: 55.472564

A partir de seus registros de segurança, você conclui que o invasor obteve acesso às 15:54:00 e todos os
os backups foram excluídos ou substituídos por backups comprometidos. Pelo registro você sabe disso
as transações 11 e posteriores estão comprometidas. Observe que o ID da transação é o nome do
último arquivo na transação. Por exemplo, a transação 11 abrange os arquivos 6 a 11.

Em um ataque real, você provavelmente desejará manter o repositório comprometido intacto para analisar
o que o invasor tentou alcançar. Também é uma boa ideia fazer esta cópia para o caso
algo deu errado durante a recuperação. Uma vez que a recuperação é feita excluindo alguns arquivos, um
cópia do link físico (cp -al) é suficiente.

A primeira etapa para redefinir o repositório para a transação 5, a última não comprometida
transação, é remover o dicas.N e índice.N arquivos no repositório (estes dois arquivos
são sempre dispensáveis). Neste exemplo, N é 13.

Em seguida, remova ou mova todos os arquivos de segmento dos diretórios de segmento em data / começando com
arquivo 6:

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

Isso é tudo.

desvantagens
Como os dados são apenas anexados, e nada excluído, comandos como ameixa seca or excluir não vai libertar
espaço em disco, eles simplesmente marcam os dados como excluídos em uma nova transação.

Observe que você pode ir e voltar entre a operação normal e apenas anexar editando
o arquivo de configuração, não é uma "viagem só de ida".

Mais Considerações
O modo somente anexo não é respeitado por outras ferramentas além do Borg. rm ainda funciona no
repositório. Certifique-se de que as máquinas clientes de backup só acessem o repositório via
borg servir.

Certifique-se de que nenhum acesso remoto seja possível se o repositório estiver temporariamente definido para normal
modo para, por exemplo, poda regular.

Outras proteções podem ser implementadas, mas estão fora do escopo do Borgs. Por exemplo, arquivo
instantâneos do sistema ou envolvimento borg servir para definir permissões especiais ou ACLs em novos dados
arquivos.

Use borgbackup online usando serviços onworks.net