bup-get - copiar itens do repositório (CUIDADO: EXPERIMENTAL)
bup get [-s source-path] [-r host:path] OPTIONS <(METHOD ref [dest])>...
bup get copia as refs indicadas do repositório de origem para o repositório de destino (respeitando --bup-dir e BUP_DIR), de acordo com o MÉTODO especificado, que pode ser um dos --ff, -- ff:, --append, --append:, --pick, --pick:, --force-pick, --force-pick:, --new-tag, --new-tag:, --replace , --replace: ou --unnamed. Veja os EXEMPLOS abaixo para uma introdução rápida.
O ref é a referência do repositório de origem do objeto a ser buscado e o dest é a referência de destino opcional. Um dest só pode ser especificado para um MÉTODO cujo nome termine em dois pontos. Por exemplo:
bup get -s /source/repo --ff foo
bup get -s /source/repo --ff: foo/latest bar
bup get -s /source/repo --pick: foo/2010-10-10-101010 .tag/barComo um caso especial, se ref nomear o link simbólico de salvamento "mais recente", então bup agirá exatamente como se o salvamento para o qual "mais recente" aponta tivesse sido especificado, em vez do próprio link simbólico "mais recente", então bup get foo/latest será realmente interpretado como algo como bup get foo/2013-01-01-030405.
Em algumas situações, o bup get avaliará uma operação de ramificação de acordo com se será ou não um “avanço rápido” (o que requer que qualquer ramificação de destino existente seja um ancestral da fonte).
Uma tag de destino existente só pode ser substituída por --replace ou --force-pick.
Quando um novo commit é criado (ou seja, via --append, --pick, etc.), ele terá o mesmo autor, data do autor e mensagem do original, mas um committer e uma data do committer correspondentes ao usuário e hora atuais .
Se solicitado pelas opções apropriadas, o bup imprimirá o commit, tree ou tag hash para cada referência de destino atualizada. Quando relevante, o hash da árvore será impresso antes do hash do commit.
As ref locais podem ser enviadas para um repositório remoto com a opção --remote, e as ref remotas podem ser enviadas para um repositório local via “bup on HOST get .. . ”. Consulte bup-on(1) e os EXEMPLOS abaixo para obter mais informações.
AVISO: Este é um dos poucos comandos bup que podem modificar seus arquivos de forma intencionalmente destrutiva. No entanto, se uma tentativa de unir ou restaurar os dados com os quais você ainda se importa for bem-sucedida depois de executar este comando, esse é um sinal bastante encorajador de que funcionou corretamente. (O comando dev/compare-trees na árvore de origem pode ser usado para ajudar a testar os resultados antes/depois.)
avanço rápido dest para corresponder a ref. Se dest não for especificado e ref nomear um salvamento, defina dest para a ramificação do salvamento. Se dest não for especificado e ref nomear uma ramificação ou tag, use o mesmo nome para dest.
anexe todos os commits representados por ref a dest como novos commits. Se ref nomear um diretório/árvore, adicione um novo commit para essa árvore. Se dest não for especificado e ref nomear um salvamento ou ramificação, defina dest para o nome da ramificação ref. Se dest não for especificado e ref nomear uma tag, use o mesmo nome para dest.
anexe o único commit nomeado por ref a dest como um novo commit. Se dest não for especificado e ref nomear um salvamento, defina dest para o nome da ramificação ref. Se dest não for especificado e ref nomear uma tag, use o mesmo nome para dest.
faça o mesmo que --pick, mas não se recuse a sobrescrever uma tag existente.
crie uma tag dest para ref, mas recuse-se a substituir uma tag existente. Se dest não for especificado e ref nomear uma tag, use o mesmo nome para dest.
clobber dest com ref, sobrescrevendo qualquer tag existente ou substituindo qualquer ramificação existente. Se dest não for especificado e ref nomear uma ramificação ou tag, use o mesmo nome para dest.
copie ref para o repositório de destino, sem nenhum nome, deixando uma referência potencialmente pendente até/a menos que o objeto nomeado por ref seja referenciado de alguma outra forma (cf. tag bup) .
use path como o repositório de origem, em vez do padrão.
armazene os itens indicados no servidor remoto fornecido. Se caminho for omitido, usa o caminho padrão no servidor remoto (você ainda precisa incluir o `:'). A conexão com o servidor remoto é feita com SSH. Se você quiser especificar qual porta, usuário ou chave privada usar para a conexão SSH, recomendamos que você use o arquivo ~/.ssh/config.
para cada ramificação atualizada, imprima o novo git commit id.
para cada ramificação atualizada, imprima o novo ID da árvore git da raiz do sistema de arquivos.
para cada tag atualizada, imprima o novo git id.
aumentar verbosidade (pode ser usado mais de uma vez). Com -v, imprima o nome de cada item buscado, com -vv adicione nomes de diretório e com -vvv adicione todos os nomes de arquivo.
não transmita mais de bytes/sec bytes por segundo para o servidor. Isso pode ajudar a evitar sugar toda a largura de banda da sua rede. Use um sufixo como k, M ou G para especificar múltiplos de 1024, 1024*1024, 1024*1024*1024, respectivamente.
defina o nível de compactação como # (um valor de 0 a 9, onde 9 é o mais alto e 0 é sem compactação). O padrão é 1 (compressão rápida e solta)
Atualize ou copie a ramificação de arquivos em src-repo para o repositório local:
bup get -s src-repo --ff archivesAnexe um salvamento de arquivos específico à ramificação de arquivos podados:
bup get -s src-repo --pick: archives/2013-01-01-030405 pruned-archivesAtualize ou copie a ramificação de arquivos no host remoto para o repositório local:
bup on remotehost get --ff archivesAtualize ou copie os arquivos da filial local para o host remoto:
bup get -r remotehost: --ff archivesAtualize ou copie a ramificação de arquivos em src-repo para remotehost:
bup get -s src-repo -r remotehost: --ff archivesAtualize a ramificação archives-2 no host remoto para corresponder aos arquivos. Se archives-2 existir e não for um ancestral de archives, bup recusará:
bup get -r remotehost: --ff: archives archives-2Substitua o conteúdo do ramo y pelo de x:
bup get --replace: x yCopie o último salvamento local da ramificação de arquivos para a tag remota foo:
bup get -r remotehost: --pick: archives/latest .tag/fooOu se foo já existe:
bup get -r remotehost: --force-pick: archives/latest .tag/fooAnexe foo (de cima) à ramificação local de outros arquivos:
bup on remotehost get --append: .tag/foo other-archivesAnexe apenas o diretório /home de archives/latest para only-home:
bup get -s "$BUP_DIR" --append: archives/latest/home only-homebup-on(1), bup-tag(1), ssh_config(5)
Parte do pacote bup(1).
Rob Browning rlb@defaultvalue.org.