rdiff-backup - Online na nuvem

PROGRAMA:

NOME

rdiff-backup - espelho local / remoto e backup incremental

SINOPSE

rdiff-backup [opções] [[[do utilizador@]host1.foo] ::diretório_fonte]
[[[do utilizador@]host2.foo] ::diretório de destino]

rdiff-backup {{ -l | --list-incrementos } | --remove-mais velho do que intervalo de tempo | --lista-em-
tempo tempo | --list-changed-desde tempo | --list-incremento-tamanhos | --verificar | --verificar-em-
tempo tempo} [[[do utilizador@]host2.foo] ::diretório de destino]

rdiff-backup --calcular-média arquivostat1 arquivostat2 ...

rdiff-backup --servidor de teste [user1]@ host1.net1::caminho [[user2]@ host2.net2::caminho] ...

DESCRIÇÃO

rdiff-backup é um script, escrito em python(1) que faz backup de um diretório para outro.
O diretório de destino acaba sendo uma cópia (espelho) do diretório de origem, mas reverso extra
diffs são armazenados em um subdiretório especial desse diretório de destino, então você ainda pode
recuperar arquivos perdidos há algum tempo. A ideia é combinar as melhores características de um espelho
e um backup incremental. rdiff-backup também preserva links simbólicos, arquivos especiais,
hardlinks, permissões, propriedade de uid / gid e horários de modificação.

rdiff-backup também pode operar de maneira eficiente em largura de banda em um tubo, como rsync(1).
Assim, você pode usar ssh e rdiff-backup para fazer backup com segurança de um disco rígido para um remoto
localização, e apenas as diferenças serão transmitidas. Usando as configurações padrão,
rdiff-backup requer que o sistema remoto aceite conexões ssh, e que rdiff-backup
é instalado no PATH do usuário no sistema remoto. Para obter informações sobre outras opções,
veja a seção sobre REMOTO OPERAÇÃO.

Note que você rede de apoio social não escrever para da espelho anuário exceto com rdiff-backup. Muitos
os incrementos são armazenados como diferenças reversas, portanto, se você excluir ou modificar um arquivo, poderá
perder a capacidade de restaurar versões anteriores desse arquivo.

Por fim, esta página do manual pretende ser mais uma descrição precisa do comportamento e
sintaxe de rdiff-backup. Novos usuários podem querer verificar o arquivo examples.html incluído
na distribuição rdiff-backup.

OPÇÕES

-b, --modo de backup
Força o modo de backup mesmo se o primeiro argumento parecer um incremento ou arquivo espelho.

--calcular-média
Entre no modo de cálculo da média. Os argumentos devem ser uma série de estatísticas
arquivos. rdiff-backup irá imprimir a média dos arquivos de estatísticas listados e
Saída.

--carbonfile
Ative o backup das informações do arquivo de carbono do MacOS X.

--check-destino-dir
Se uma sessão de rdiff-backup falhar, execute rdiff-backup com esta opção no
O diretório de destino desfará o diretório com falha. Isso acontece automaticamente se você
tentativa de fazer backup em um diretório e o último backup falhou.

--comparar
Isso é equivalente a '--compare-at-time agora'

--compare-at-time tempo
Compare um diretório com o conjunto de backup em um determinado momento. Isso pode ser útil para
veja como os dados arquivados diferem dos dados atuais, ou para verificar se um backup é
atual. Isso apenas compara metadados, da mesma forma que rdiff-backup decide se
um arquivo foi alterado.

--compare-completo
Isso é equivalente a '--compare-full-at-time agora'

--compare-completo-em-tempo tempo
Compare um diretório com o conjunto de backup em um determinado momento. Para comparar regular
arquivos, os dados do repositório serão copiados em sua totalidade para o lado da fonte e
comparados byte por byte. Esta é a opção de comparação mais lenta, porém mais completa.

--compare-hash
Isso é equivalente a '--compare-hash-at-time agora'

--compare-hash-at-time tempo
Compare um diretório com o conjunto de backup em um determinado momento. Arquivos normais serão
comparados calculando seu resumo SHA1 no lado da fonte e comparando-o com o
resumo gravado nos metadados.

--criar-caminho-completo
Normalmente, apenas o diretório final do caminho de destino será criado se
não existe. Com esta opção, todos os diretórios ausentes no caminho de destino
Será criado. Use esta opção com cuidado: se houver um erro de digitação no caminho remoto,
o sistema de arquivos remoto pode encher muito rapidamente (criando um backup duplicado
árvore). Por este motivo, esta opção é principalmente voltada para scripts que automatizam
cópias de segurança.

--hora atual segundo
Esta opção é útil principalmente para testes. Se definido, rdiff-backup irá usá-lo para o
hora atual em vez de consultar o relógio. O argumento é o número de
segundos desde a época.

--excluir padrão_shell
Exclua o arquivo ou arquivos correspondidos por padrão_shell. Se um diretório for correspondido,
então os arquivos nesse diretório também serão combinados. Veja o ARQUIVO SELEÇÃO
seção para mais informações.

--excluir-device-files
Exclua todos os arquivos do dispositivo. Isso pode ser útil por razões de segurança / permissões ou
se o rdiff-backup não estiver manipulando os arquivos do dispositivo corretamente.

--excluir-fifos
Exclua todos os arquivos fifo.

--excluir lista de arquivos nome do arquivo
Exclui os arquivos listados em nome do arquivo. Se nome do arquivo é manuscrito você provavelmente
queremos --exclude-globbing-lista de arquivos em vez de. Veja o ARQUIVO SELEÇÃO seção para mais
informações.

--exclude-filelist-stdin
Como --exclude-lista de arquivos, mas a lista de arquivos será lida da entrada padrão.
veja a ARQUIVO SELEÇÃO seção para mais informações.

--exclude-globbing-lista de arquivos nome do arquivo
Como --excluir lista de arquivos mas cada linha da lista de arquivos será interpretada de acordo
com as mesmas regras que --incluir e --excluir.

--exclude-globbing-filelist-stdin
Como --exclude-globbing-lista de arquivos, mas a lista de arquivos será lida do padrão
entrada.

--exclude-outros sistemas de arquivos
Exclua arquivos em sistemas de arquivos (identificados pelo número do dispositivo) diferentes do arquivo
sistema onde a raiz do diretório de origem está.

--excluir-regexp regexp
Exclua os arquivos que correspondem ao regexp fornecido. Ao contrário do --excluir opção, esta opção
não corresponde a arquivos em um diretório que corresponda. Veja o ARQUIVO SELEÇÃO seção para
Mais Informações.

--excluir-arquivos especiais
Exclua todos os arquivos de dispositivo, arquivos fifo, arquivos de soquete e links simbólicos.

--excluir soquetes
Exclua todos os arquivos de soquete.

--excluir-links-simbólicos
Exclua todos os links simbólicos. Esta opção é ativada automaticamente se o backup
source está sendo executado no Windows nativo para evitar o backup de pontos de nova análise do NTFS.

--excluir-se-presente nome do arquivo
Excluir diretórios se nome do arquivo é presente. Esta opção precisa vir antes de qualquer
outras opções de inclusão ou exclusão.

--força
Autoriza uma modificação mais drástica de um diretório do que o normal (por exemplo, quando
sobrescrever um caminho de destino ou ao remover várias sessões com
--remove-mais velho do que) O rdiff-backup geralmente diz se é necessário.
AVISO: Você pode causar perda de dados se usar essa opção incorretamente. Além disso, NÃO
use esta opção ao fazer uma restauração, pois irá EXCLUIR ARQUIVOS, a menos que você
sei absolutamente o que você está fazendo.

--grupo-mapeamento-arquivo nome do arquivo
Mapeie os nomes e ids dos grupos de acordo com o arquivo de mapeamento do grupo nome do arquivo. Veja o
USUÁRIOS E GRUPOS seção para mais informações.

--incluir padrão_shell
Semelhante a --excluir mas inclua os arquivos correspondentes. diferente --excluir, Este
opção também irá corresponder aos diretórios pais dos arquivos correspondentes (embora não
necessariamente seu conteúdo). Veja o ARQUIVO SELEÇÃO seção para mais informações.

--include-lista de arquivos nome do arquivo
Como --excluir lista de arquivos, mas inclua os arquivos listados. Se nome do arquivo is
manuscrito, você provavelmente quer --include-globbing-lista de arquivos em vez de. Veja o ARQUIVO
SELEÇÃO seção para mais informações.

--include-filelist-stdin
Como --include-lista de arquivos, mas leia a lista de arquivos incluídos na entrada padrão.

--include-globbing-lista de arquivos nome do arquivo
Como --include-lista de arquivos mas cada linha da lista de arquivos será interpretada de acordo
com as mesmas regras que --incluir e --excluir.

--include-globbing-filelist-stdin
Como --include-globbing-lista de arquivos, mas a lista de arquivos será lida do padrão
entrada.

--include-regexp regexp
Inclui arquivos que correspondem à expressão regular regexp. Apenas arquivos explicitamente
combinado por regexp será incluído por esta opção. Veja o ARQUIVO SELEÇÃO seção
para entender melhor.

--include-arquivos especiais
Inclui todos os arquivos de dispositivo, arquivos fifo, arquivos de soquete e links simbólicos.

--include-links-simbólicos
Inclui todos os links simbólicos.

--list-at-time tempo
Liste os arquivos no arquivo que estavam presentes naquele momento. Se um diretório
no arquivo for especificado, liste apenas os arquivos nesse diretório.

--list-changed-desde tempo
Liste os arquivos que foram alterados no diretório de destino desde o momento determinado.
See HORÁRIO FORMATOS para o formato de tempo. Se um diretório no arquivo é
especificado, lista apenas os arquivos nesse diretório. Esta opção não lê o
diretório de origem; é usado para comparar o conteúdo de dois rdiff-backups diferentes
sessões.

-eu, --list-incrementos
Lista o número e a data dos backups incrementais parciais contidos no especificado
diretório de destino. Nenhum backup ou restauração ocorrerá se esta opção for
dado.

--list-incremento-tamanhos
Liste o tamanho total de todos os arquivos de incremento e espelho por tempo. Isso pode ser
útil para decidir quantos incrementos manter e quando --remove-mais antigo-que.
Especificar um subdiretório é permitido; então apenas os tamanhos do espelho e
incrementos pertencentes a esse subdiretório serão listados.

--max-tamanho do arquivo tamanho
Exclua arquivos maiores do que o tamanho fornecido em bytes

--min-tamanho do arquivo tamanho
Exclua arquivos menores do que o tamanho fornecido em bytes

--nunca-drop-acls
Saia com erro em vez de eliminar acls ou entradas acl. Normalmente isso pode acontecer
(com um aviso) porque o destino não os suporta ou porque o
nomes de usuário / grupo relevantes não existem no lado de destino.

--sem acls
Sem listas de controle de acesso - desabilitar backup de ACLs

--no-carbonfile
Desativar backup de informações do arquivo de carbono do MacOS X

--no-compare-inode
Esta opção evita que o rdiff-backup marque um arquivo com link físico como alterado quando
seu número de dispositivo e / ou mudanças de inode. Esta opção é útil em situações onde
o sistema de arquivos de origem carece de dispositivo persistente e / ou numeração de inode. Por exemplo,
sistemas de arquivos de rede podem ter diferenças de montagem para montagem em seu número de dispositivo (mas
números de inode possivelmente estáveis); Dispositivos USB / 1394 podem aparecer em dispositivos diferentes
numera cada remontagem (mas geralmente teria o mesmo número de inode); e há
sistemas de arquivos que nem mesmo têm os mesmos números de inode de uso para uso. Sem
a opção rdiff-backup pode gerar números desnecessários de pequenos arquivos diff.

- sem compressão
Desative a compactação gzip padrão da maioria dos incrementos .snapshot e .diff
arquivos armazenados no diretório rdiff-backup-data. Um volume de backup pode conter
incrementos compactados e descompactados, portanto, usar esta opção de forma inconsistente é
bem.

--no-compression-regexp regexp
Não comprima incrementos com base em arquivos cujos nomes de arquivo correspondam a regexp. o
padrão inclui muitos arquivos audiovisuais e de arquivo comuns, e pode ser encontrado em
Globals.py.

- no-eas
Sem suporte para Atributos Estendidos - desabilite o backup de EAs.

--no-file-statistics
Isso irá desativar a gravação no arquivo file_statistics no rdiff-backup-data
diretório. O rdiff-backup será executado um pouco mais rápido e ocupará um pouco menos de espaço.

--sem links físicos
Não replique links físicos no destino. Se muitos arquivos com link físico forem
presente, esta opção pode diminuir drasticamente o uso de memória. Esta opção está habilitada
por padrão, se a origem do backup ou destino da restauração estiver sendo executado no nativo
Janelas.

--separador nulo
Use nulos (\ 0) em vez de novas linhas (\ n) como separadores de linha, o que pode ajudar quando
lidar com nomes de arquivos contendo novas linhas. Isso afeta o formato esperado de
os arquivos especificados pelas opções - {include | exclude} -filelist [-stdin], bem como
o formato do arquivo de estatísticas do diretório.

--saída analisável
Se definido, a saída de rdiff-backup será adaptada para fácil análise por computadores,
em vez de conveniência para os humanos. Atualmente, isso só se aplica ao listar
incrementos usando o -l or --list-incrementos interruptores, onde o tempo será dado
em segundos desde a época.

--override-chars-to-quote
Se o sistema de arquivos para o qual estamos fazendo backup não diferencia maiúsculas de minúsculas, automaticamente
ocorre 'citação' de personagens. Por exemplo, um arquivo 'Developer.doc' será
convertido em '; 068eveloper.doc'. Para substituir este comportamento, você precisa especificar
esta opção.

--preserve-ids numéricos
Se definido, o rdiff-backup preservará uids / gids em vez de tentar preservar os unames
e gnames. Veja o USUÁRIOS E GRUPOS seção para mais informações.

--print-estatísticas
Se definido, as estatísticas de resumo serão impressas após um backup bem-sucedido. Se não for definido,
essas informações ainda estarão disponíveis no arquivo de estatísticas da sessão. Veja o
ESTATÍSTICAS seção para mais informações.

-r, --restaurar como de tempo_restauração
Restaura o diretório especificado como estava em tempo_restauração. Veja o HORÁRIO FORMATOS
seção para obter mais informações sobre o formato de tempo_restauração, e veja o RESTAURANDO
seção para obter mais informações sobre restauração.

--remote-cmd cmd
Descontinuada. Em vez disso, use --remote-schema

--esquema-remote esquema
Especifique um método alternativo de conexão a um computador remoto. Isso é necessário
para obter rdiff-backup para não usar ssh para backups remotos, ou se, por exemplo, rdiff-
o backup não está no PATH no lado remoto. Veja o REMOTO OPERAÇÃO seção para
Mais Informações.

--remote-tempdir caminho
Adiciona a opção --tempdir com argumento caminho ao invocar instâncias remotas de
rdiff-backup.

--remove-mais velho do que especificação_tempo
Remova as informações de backup incremental no diretório de destino que possui
existe há mais tempo do que o tempo determinado. especificação_tempo pode ser um tempo absoluto,
como "2002-01-04" ou um intervalo de tempo. O intervalo de tempo é um número inteiro seguido por
o caractere s, m, h, D, W, M ou Y, indicando segundos, minutos, horas, dias,
semanas, meses ou anos, respectivamente, ou vários desses concatenados. Para
exemplo, 32m significa 32 minutos e 3W2D10h7s significa 3 semanas, 2 dias, 10 horas e 7
segundos. Neste contexto, um mês significa 30 dias, um ano é 365 dias e um dia é
sempre 86400 segundos.

O rdiff-backup não pode remover-mais antigo-que e fazer backup ou restaurar em uma única sessão.
Para fazer backup de um diretório e remover arquivos antigos nele, você deve executar rdiff-
backup duas vezes.

Por padrão, o rdiff-backup excluirá apenas as informações de uma sessão por vez.
Para remover duas ou mais sessões ao mesmo tempo, forneça o --força opção (rdiff-
o backup dirá a você se --força É necessário).

Observe que os instantâneos de arquivos excluídos são cobertos por esta operação. Portanto, se você
excluiu um arquivo há duas semanas, fez o backup imediatamente depois e executou rdiff-
backup com --remove-mais antigo-que 10D hoje, nenhum vestígio desse arquivo permaneceria.
Finalmente, as opções de seleção de arquivo como --include e --exclude não afetam
--remove-mais velho que.

--restringir caminho
Exigir que todo o acesso ao arquivo esteja dentro do caminho fornecido. Este switch, e o
os dois seguintes, devem ser usados ​​com a opção --server para fornecer um pouco
mais proteção ao fazer backups remotos automatizados. Eles são não Pretendido as sua
só linha of defesa então, por favor, não faça algo bobo como permitir o acesso público a
um servidor de backup rdiff executado com --restrict-read-only.

--restringir-somente leitura caminho
Como --restringir, mas também rejeita todas as solicitações de gravação.

--restrict-update-only caminho
Como --restringir, mas só permite gravações como parte de um backup incremental. solicitações de
para outros tipos de gravações (por exemplo, exclusão caminho) será rejeitado.

--servidor
Entre no modo de servidor (não para ser chamado diretamente, mas em vez disso usado por outro rdiff-
processo de backup em um computador remoto).

--ssh-sem compressão
Ao executar o ssh, não use a opção -C para habilitar a compactação. --ssh-não-
no mundo é ignorado se você especificar um novo esquema usando --remote-esquema.

--tempdir caminho
Define o diretório que rdiff-backup usa para arquivos temporários para o caminho fornecido.
As variáveis ​​de ambiente TMPDIR, TEMP e TMP também podem ser usadas para definir o
diretório de arquivos temporários. Consulte a documentação do módulo Python tempfile para
Mais Informações.

--terminal-verbosidade [0-9]
Selecione quais mensagens serão exibidas no terminal. Se faltar o nível
o padrão é o nível de detalhamento.

--servidor de teste
Teste a presença de um servidor de backup rdiff compatível, conforme especificado no
seguinte host :: argumento (s) de nome de arquivo. A seção do nome do arquivo será ignorada.

- arquivo de mapeamento de usuário nome do arquivo
Mapeie nomes e ids de usuário de acordo com o arquivo de mapeamento de usuário nome do arquivo. Veja o USUÁRIOS
E GRUPOS seção para mais informações.

-v[0-9], --verbosidade [0-9]
Especifique o nível de verbosidade (0 é totalmente silencioso, 3 é o padrão e 9 é o mais barulhento).
Isso determina o quanto é gravado no arquivo de log.

--verificar
Esta é a abreviação de --verifique-at-time agora

--verifique-at-time agora
Verifique todos os dados no repositório no momento determinado, calculando o hash SHA1
de todos os arquivos regulares e comparando-os com os hashes armazenados nos metadados
arquivo.

-V, --versão
Imprima a versão atual e saia

RESTAURANDO

Existem duas maneiras de dizer ao rdiff-backup para restaurar um arquivo ou diretório. Em primeiro lugar, você pode
execute rdiff-backup em um arquivo espelho e use o -r or --restaurar como de opções. Em segundo lugar,
você pode executá-lo em um arquivo de incremento.

Por exemplo, suponha que no passado você tenha executado:

rdiff-backup / usr /usr.backup

para fazer backup do / usr diretório para o diretório /usr.backup, e agora deseja uma cópia do
/ usr / local diretório da forma que estava há 3 dias, localizado em /usr/local.old.

Uma maneira de fazer isso é executar:

rdiff-backup -r 3D /usr.backup/local /usr/local.old

onde acima "3D" significa 3 dias (para outras formas de especificar o tempo, consulte o HORÁRIO
FORMATOS seção). O diretório /usr.backup/local foi selecionado, porque esse é o
diretório contendo a versão atual de / usr / local.

Observe que a opção de --restaurar como de sempre especifica uma hora exata. (Portanto, "3D" se refere
até o instante 72 horas antes do presente.) Se não houve backup feito naquele momento,
rdiff-backup restaura o estado registrado para o backup anterior. Por exemplo, no
caso acima, se "3D" for usado e houver apenas backups de 2 e 4 dias atrás,
/ usr / local como era há 4 dias será restaurado.

A segunda maneira de restaurar arquivos envolve encontrar o arquivo de incremento correspondente. Isto
estaria no diretório / backup / rdiff-backup-data / increments / usr, e seu nome seria
algo como "local.2002-11-09T12: 43: 53-04: 00.dir" onde a hora indica que é de 3
dias atrás. Observe que todos os arquivos de incremento terminam em ".diff", ".snapshot", ".dir" ou
".missing", onde ".missing" significa apenas que o arquivo não existia naquele momento (finalmente,
alguns deles podem ser compactados com gzip e ter um ".gz" extra para indicar isso). Então
corrida:

rdiff-backup / backup / rdiff-backup-data / incrementos / usr / local. .dir
/usr/local.old

também restauraria o arquivo conforme desejado.

Se você não tiver certeza de qual versão de um arquivo precisa, provavelmente é mais fácil
restaurar a partir dos arquivos de incrementos, conforme descrito imediatamente acima, ou para ver quais
incrementos estão disponíveis com -l / - list-incrementos e, a seguir, especifique os tempos exatos em
-r / - restaurar as-of.

HORÁRIO FORMATOS

O rdiff-backup usa cadeias de tempo em dois lugares. Em primeiro lugar, todos os arquivos de incremento rdiff-
backups criados terão a hora em seus nomes de arquivo no formato w3 datetime como
descrito em uma nota w3 em http://www.w3.org/TR/NOTE-datetime. Basicamente, eles parecem
"2001-07-15T04: 09: 38-07: 00", que significa o que parece. A seção "-07: 00" significa
o fuso horário está 7 horas atrás do UTC.

Em segundo lugar, a -r, --restaurar como de, e --remove-mais velho do que opções levam uma sequência de tempo,
que pode ser fornecido em qualquer um dos vários formatos:

1. a string "agora" (refere-se à hora atual)

2. uma sequência de dígitos, como "123456890" (indicando o tempo em segundos após o
época)

3. Uma string como "2002-01-25T07: 00: 00 + 02: 00" no formato data e hora

4. Um intervalo, que é um número seguido por um dos caracteres s, m, h, D, W, M,
ou Y (indicando segundos, minutos, horas, dias, semanas, meses ou anos
respectivamente), ou uma série de pares. Neste caso, a string se refere ao
hora que precedeu a hora atual pela duração do intervalo. Por exemplo,
"1h78m" indica a hora que foi uma hora e 78 minutos atrás. O calendário aqui
não é sofisticado: um mês é sempre 30 dias, um ano é sempre 365 dias e um dia
é sempre 86400 segundos.

5. Um formato de data no formato AAAA / MM / DD, AAAA-MM-DD, MM / DD / AAAA ou MM-DD-AAAA, que
indica meia-noite no dia em questão, em relação ao fuso horário atual
definições. Por exemplo, "2002/3/5", "03-05-2002" e "2002-3-05" significam março
5th, 2002.

6. Uma especificação de sessão de backup que é um número inteiro não negativo seguido por 'B'.
Por exemplo, '0B' especifica a hora do espelho atual, e '3B' especifica o
hora do 3º incremento mais recente.

REMOTO OPERAÇÃO

Para acessar arquivos remotos, o rdiff-backup abre um canal para uma cópia do rdiff-backup
rodando na máquina remota. Portanto, o rdiff-backup deve ser instalado em ambas as extremidades. Abrir
este pipe, rdiff-backup primeiro divide o nome do arquivo em host_info :: pathname. Isso então
substitui host_info no esquema remoto e executa o comando resultante, lendo seu
entrada e saída.

O esquema remoto padrão é 'ssh -C% s rdiff-backup --server' onde host_info é
substituído por '% s'. Portanto, se o host_info for [email protected], então rdiff-backup executa 'ssh
[email protected] rdiff-backup --server '. Usando --remote-schema, rdiff-backup pode invocar um
comando arbitrário para abrir um tubo remoto. Por exemplo,
cd do rdiff-backup --remote-schema ' / usr; % s 'foo' rdiff-backup --server ':: bar
é basicamente equivalente a (mas mais lento que)
rdiff-backup foo / usr / bar

Em relação à citação, se por algum motivo você precisar colocar dois dois pontos consecutivos no
seção host_info de um argumento host_info :: pathname, ou no nome do caminho de um arquivo local,
você pode citar um deles colocando uma barra invertida no início. Portanto, em 'a \ :: b :: c', host_info é
'a :: b' e o nome do caminho é 'c'. Da mesma forma, se você quiser se referir a um arquivo local cujo
nome do arquivo contém dois dois pontos consecutivos, como 'estranho :: arquivo', você terá que citar um
dos dois pontos como em 'estranho \ :: arquivo'. Porque a barra invertida é um caractere de aspas nestes
circunstâncias, ele também deve ser citado para obter uma barra invertida literal, então 'foo \ :: \\ bar'
avalia como 'foo :: \ bar'. Para tornar as coisas mais complicadas, porque a barra invertida também é
um caractere comum de citação do shell, você pode precisar digitar '\\\\' no prompt do shell para
obter uma barra invertida literal (se isso faz você se sentir melhor, eu tive que digitar 8 barras invertidas para
pegue isso nesta página de manual ...). E, finalmente, para incluir um% literal na string
especificado por --remote-schema, cite-o com outro%, como em %%.

Embora o próprio ssh possa ser seguro, usar o rdiff-backup da maneira padrão apresenta alguns
riscos de segurança. Por exemplo, se o servidor é executado como root, então um invasor que
comprometido, o cliente pode então usar rdiff-backup para sobrescrever arquivos arbitrários do servidor por
"backup" sobre eles. Essa configuração pode ser mais segura usando o sshd
opção de configuração comando = "rdiff-backup --servidor" possivelmente junto com o --restringir*
opções para rdiff-backup. Para obter mais informações, consulte a página da web, o wiki e o
entradas para o --restringir* opções nesta página de manual.

ARQUIVO SELEÇÃO

rdiff-backup tem várias opções de seleção de arquivo. Quando o rdiff-backup é executado,
pesquisa através do diretório de origem fornecido e faz backup de todos os arquivos correspondentes ao
opções especificadas. Este sistema de seleção pode parecer complicado, mas deve ser
flexível e fácil de usar. Se você quer apenas aprender o básico, primeiro olhe para o
exemplos de seleção no arquivo examples.html incluído no pacote ou na web em
http://rdiff-backup.nongnu.org/examples.html

rdiff-backupO sistema de seleção de foi originalmente inspirado em rsync(1), mas existem muitos
diferenças. (Por exemplo, as barras invertidas finais não têm nenhum significado especial.)

O sistema de seleção de arquivos compreende uma série de condições de seleção de arquivos, que são definidas
usando uma das seguintes opções de linha de comando: --excluir, --excluir lista de arquivos, --excluir-
arquivos de dispositivo, --excluir-fifos, --excluir soquetes, --excluir-links-simbólicos, --excluir-
lista de arquivos globbing, --exclude-globbing-filelist-stdin, --exclude-filelist-stdin, --excluir-
regexp, --excluir-arquivos especiais, --incluir, --include-lista de arquivos, --incluir-globbing-
lista de arquivos, --include-globbing-filelist-stdin, --include-filelist-stdin e --incluir-
regexp. Cada condição de seleção de arquivo corresponde ou não a um determinado arquivo. UMA
determinado arquivo é excluído pelo sistema de seleção de arquivo exatamente quando o primeiro arquivo correspondente
condição de seleção especifica que o arquivo seja excluído; caso contrário, o arquivo é incluído.
Ao fazer backup, se um arquivo for excluído, rdiff-backup age como se esse arquivo não existisse
no diretório de origem. Ao restaurar, um arquivo excluído é considerado não existente em
os diretórios de origem ou de destino.

Por exemplo, a

rdiff-backup --incluir / usr --excluir / usr / usr /cópia de segurança

é exatamente o mesmo que

rdiff-backup / usr /cópia de segurança

porque as diretivas de inclusão e exclusão correspondem exatamente aos mesmos arquivos, e o --incluir
vem primeiro, dando-lhe precedência. De forma similar,

rdiff-backup --incluir / usr / local / bin --excluir / usr / local / usr /cópia de segurança

faria backup do / usr / local / bin diretório (e seu conteúdo), mas não / usr / local / doc.

O incluir, excluir, incluir-globbing-lista de arquivos e lista de arquivos exclude-globbing opções
aceitar opção concha globulando padrões. Esses padrões podem conter os padrões especiais
*, **, ? e [...]. Como em uma concha normal, * pode ser expandido para qualquer sequência de caracteres
não contendo "/", ? se expande para qualquer caractere, exceto "/" e [...] se expande para um único
caractere dos caracteres especificados (intervalos são aceitáveis). O novo padrão especial,
**, se expande para qualquer sequência de caracteres, contenha ou não "/". Além disso, se
o padrão começa com "ignorecase:" (não faz distinção entre maiúsculas e minúsculas), então este prefixo será removido
e qualquer caractere na string pode ser substituído por uma versão em maiúsculas ou minúsculas de
si.

Se você precisar combinar nomes de arquivos que contenham os caracteres globais acima, eles podem ser
escapou usando uma barra invertida "\". A barra invertida só escapará ao caractere que o segue
então para ** você precisará usar "\ * \ *" para evitar escapar para o * personagem globbing.

Lembre-se de que você pode precisar citar esses caracteres ao digitá-los em um shell, então
o shell não interpreta os padrões de globbing antes que o rdiff-backup os veja.

O --excluir de cinto de segurança opção corresponde a um arquivo iff:

1. de cinto de segurança pode ser expandido para o nome do arquivo, ou

2. o arquivo está dentro de um diretório correspondente à opção.

Por outro lado, --incluir de cinto de segurança corresponde a um arquivo iff:

1. de cinto de segurança pode ser expandido para o nome do arquivo,

2. o arquivo está dentro de um diretório correspondido pela opção, ou

3. o arquivo é um diretório que contém um arquivo correspondente à opção.

Por exemplo, nos

--excluir / usr / local

fósforos / usr / local, / usr / local / libe / usr / local / lib / netscape. É o mesmo que
--excluir / usr / local --excluir '/ usr / local /** '.

--incluir / usr / local

especifica que / usr, / usr / local, / usr / local / libe / usr / local / lib / netscape (mas não
/ usr / doc) seja feito o backup de todos. Assim, você não precisa se preocupar em incluir os pais
diretórios para garantir que os subdiretórios incluídos tenham algum lugar para ir. Finalmente,

--incluir ignorar caso:'/ usr /[a-z0-9] foo / * / **. py '

corresponderia a um arquivo como /usR/5fOO/hello/there/world.py. Se corresponder a alguma coisa,
também corresponderia a / usr. Se não houver um arquivo existente, o padrão fornecido pode ser
expandido para, a opção não corresponderá a / usr.

O --include-lista de arquivos, --excluir lista de arquivos, --include-filelist-stdin e --excluir-
lista de arquivos-stdin as opções também introduzem as condições de seleção de arquivo. Eles direcionam o backup de rdiff
para ler em um arquivo, cada linha da qual é uma especificação de arquivo, e para incluir ou excluir
os arquivos correspondentes. As linhas são separadas por novas linhas ou nulos, dependendo se o
- chave separadora nula foi fornecida. Cada linha em uma lista de arquivos é interpretada de forma semelhante a
o Caminho opção concha padrões são, com algumas exceções:

1. Padrões globalizantes como *, **, ? e [...] não são expandidos.

2. Os padrões de inclusão não correspondem aos arquivos em um diretório incluído. Então / usr / local
em um arquivo de inclusão não corresponderá a / usr / local / doc.

3. As linhas que começam com "+" são interpretadas como diretivas de inclusão, mesmo se encontradas em um
lista de arquivos referenciada por --excluir lista de arquivos. Da mesma forma, as linhas que começam com "-"
excluir arquivos mesmo se eles forem encontrados em uma lista de arquivos de inclusão.

Por exemplo, se o arquivo "list.txt" contém as linhas:

/ usr / local
- / usr / local / doc
/ usr / local / bin
+ / var
- / var

então "--include-filelist list.txt" incluiria / usr, / usr / locale / usr / local / bin. Isto
excluiria / usr / local / doc, / usr / local / doc / python, etc. Não exclui nem
inclui / usr / local / man, deixando o destino deste diretório para a próxima especificação
doença. Finalmente, não está definido o que acontece com / var. Uma única lista de arquivos deve
não contém especificações de arquivo conflitantes.

O --include-globbing-lista de arquivos e --exclude-globbing-lista de arquivos opções também especificam
filelists, mas cada linha na filelist será interpretada como um padrão globbing da maneira
--incluir e --excluir as opções são interpretadas (embora o prefixo "+" e "-" ainda seja
permitido). Por exemplo, se o arquivo "globbing-list.txt" contém as linhas:

dir / foo
+ dir / bar
- **

Então "--include-globbing-filelist globbing-list.txt" seria exatamente o mesmo que
especificando "--include dir / foo --include dir / bar --exclude **" na linha de comando.

Finalmente, o --include-regexp e --excluir-regexp permitir que arquivos sejam incluídos e excluídos
se seus nomes de arquivo corresponderem a uma expressão regular python. A sintaxe da expressão regular também é
complicado de explicar aqui, mas é abordado na referência da biblioteca do Python. Ao contrário do
--incluir e --excluir opções, as opções de expressão regular não correspondem aos arquivos
contendo ou contido em arquivos correspondentes. Então por exemplo

--incluir '[0-9] {7} (?! foo)'

corresponde a quaisquer arquivos cujos nomes de caminho completos contenham 7 dígitos consecutivos que não são seguidos
por 'foo'. No entanto, não corresponderia / Home mesmo se / home / ben / 1234567 existisse.

USUÁRIOS E GRUPOS

Pode haver complicações na preservação da propriedade entre os sistemas. Por exemplo, o nome de usuário
que possui um arquivo no sistema de origem pode não existir no destino. Aqui está como
rdiff-backup mapeia a propriedade da origem para o destino (ou vice-versa, no caso
de restauração):

1. Se a opção --preserve-numerical-ids for fornecida, os arquivos remotos sempre terão
o mesmo uid e gid, para entradas de propriedade e ACL. Isso pode causar desvios de nome
e gnames para mudar.

2. Caso contrário, tente preservar os nomes de usuário e grupo para propriedade e em ACLs.
Isso pode resultar em arquivos com diferentes uids e gids entre os sistemas.

3. Se um nome não puder ser preservado (por exemplo, porque o nome de usuário não existe), preserve
o id original, mas apenas em casos de propriedade de usuário e grupo. Para ACLs, omita qualquer
entrada com um nome de usuário ou grupo inválido.

4. O - arquivo de mapeamento de usuário e --grupo-mapeamento-arquivo opções substituem este comportamento.
Se qualquer uma dessas opções for fornecida, a política descrita em 2 e 3 acima será
seguido, mas com o usuário e grupo mapeados em vez do original. Se você
especifique ambos --preserve-ids numéricos e uma das opções de mapeamento, o comportamento
é indefinido.

Os arquivos de mapeamento de usuário e grupo têm o mesmo formato:

old_name_or_id1: new_name_or_id1
old_name_or_id2: new_name_or_id2


Cada linha deve conter um nome ou id, seguido por dois pontos ":", seguido por outro nome
ou id. Se um nome ou id não estiver listado, eles serão tratados da maneira padrão descrita
acima.

Ao restaurar, o comportamento acima também é seguido, mas observe que a fonte original
as informações do usuário / grupo serão a entrada, não as informações já mapeadas do usuário / grupo
presente no repositório de backup. Por exemplo, suponha que você tenha mapeado todos os arquivos
possuído por alice na fonte para que sejam propriedade de ben no repositório, e agora você
deseja restaurar, certificando-se de que os arquivos pertencentes originalmente a alice ainda são propriedade de alice.
Nesse caso, não há necessidade de usar nenhuma das opções de mapeamento. No entanto, se você quisesse
para restaurar os arquivos para que os arquivos originalmente pertencentes a alice na fonte estão agora
possuído por ben, você teria que usar as opções de mapeamento, mesmo que só queira o
unames dos arquivos do repositório preservados nos arquivos restaurados.

ESTATÍSTICAS

Cada sessão rdiff-backup salva várias estatísticas em dois arquivos, as estatísticas da sessão
arquivo em rdiff-backup-data / session_statistics. .data e o arquivo de estatísticas do diretório
em rdiff-backup-data / directory_statistics. .dados. Ambos são arquivos de texto e
contêm informações semelhantes: quantos arquivos foram alterados, quantos foram excluídos, o tamanho total
de arquivos de incremento criados, etc. No entanto, o arquivo de estatísticas de sessão deve ser
muito legível e descreve apenas a sessão como um todo. O arquivo de estatísticas do diretório é
mais compacto (e um pouco menos legível), mas descreve todos os diretórios dos quais foi feito backup. Isto
também pode ser compactado para economizar espaço.

As opções relacionadas às estatísticas incluem --print-estatísticas e --separador nulo.

Além disso, rdiff-backup salvará várias mensagens no arquivo de log, que é rdiff-backup-
data / backup.log para sessões de backup e rdiff-backup-data / restore.log para restauração
sessões. Geralmente, o que é escrito neste arquivo coincidirá com as mensagens
exibido para stdout ou stderr, embora isso possa ser alterado com o --terminal-verbosidade
opção.

O arquivo de log não está compactado e pode se tornar muito grande se o rdiff-backup for executado com alta
verbosidade.

SAIR STATUS

Se o rdiff-backup terminar com sucesso, o status de saída será 0. Se houver um
erro irrecuperável (crítico), será diferente de zero (geralmente 1, mas não dependa disso
valor específico). Ao configurar o rdiff-backup para ser executado automaticamente (a partir de cron(8) ou
semelhante), é provavelmente uma boa ideia verificar o código de saída.

Use rdiff-backup online usando serviços onworks.net