bup-meta - manual de referência, opções, exemplos de comandos


NOME

bup-meta - criar ou extrair um arquivo de metadados

SINOPSE

bup meta --create

[-R] [-v] [-q] [--no-symlinks] [--no-paths] [-f file] <paths...>

bup meta --list

[-v] [-q] [-f file]

bup meta --extract

[-v] [-q] [--numeric-ids] [--no-symlinks] [-f file]

bup meta --start-extract

[-v] [-q] [--numeric-ids] [--no-symlinks] [-f file]

bup meta --finish-extract

[-v] [-q] [--numeric-ids] [-f file]

bup meta --edit

[--set-uid uid | --set-gid gid | --set-user user | --set-group group | ...] <paths...>

DESCRIÇÃO

bup meta cria, extrai ou manipula arquivos de metadados. Um arquivo de metadados contém as informações de metadados (carimbos de data/hora, propriedade, permissões de acesso, etc.) para um conjunto de caminhos de sistema de arquivos.

Consulte bup-restore(1) para obter uma descrição de como os metadados de propriedade são restaurados.

OPÇÕES

-c, --create

Crie um arquivo de metadados para os caminhoss especificados. Grave o arquivo na saída padrão, a menos que --file seja especificado.

-t, --list

Exibir informações sobre os metadados em um arquivo. Leia o arquivo da entrada padrão, a menos que --file seja especificado.

-x, --extract

Extraia um arquivo de metadados. Conceitualmente, execute --start-extract seguido por --finish-extract. Leia o arquivo da entrada padrão, a menos que --file seja especificado.

--start-extract

Crie uma árvore do sistema de arquivos correspondente aos caminhos armazenados em um arquivo de metadados. Por si só, este comando não produz uma restauração completa dos metadados. Para uma restauração completa, este comando deve ser seguido por uma chamada para --finish-extract. Depois que esse comando terminar, todos os arquivos normais descritos pelos metadados existirão e estarão vazios. Restaurar os dados nesses arquivos e, em seguida, chamar --finish-extract deve restaurar a árvore original. O arquivo será lido a partir da entrada padrão, a menos que --file seja especificado.

--finish-extract

Termine de aplicar os metadados armazenados em um arquivo ao sistema de arquivos. Normalmente, esse comando deve seguir uma chamada para --start-extract. O arquivo será lido a partir da entrada padrão, a menos que --file seja especificado.

--edit

Editar arquivos de metadados. O resultado será gravado na saída padrão, a menos que --file seja especificado.

-f, --file=filename

Leia o arquivo de metadados de filename ou grave-o em filename conforme apropriado. Se filename for “-”, então leia da entrada padrão ou grave na saída padrão.

-R, --recurse

Desce recursivamente em subdiretórios durante --create.

--xdev, --one-file-system

não cruze os limites do sistema de arquivos - embora, como com tar e rsync, os próprios pontos de montagem ainda sejam tratados.

--numeric-ids

Aplique IDs numéricos (usuário, grupo etc.) em vez de nomes durante --extract ou --finish-extract.

--symlinks

Grave destinos de link simbólico ao criar um arquivo ou restaure links simbólicos ao extrair um arquivo (durante --extract ou --start-extract). Essa opção é ativada por padrão. Especifique --no-symlinks para desativá-lo.

--paths

Registre nomes de caminhos ao criar um arquivo. Essa opção é ativada por padrão. Especifique --no-paths para desativá-lo.

--set-uid=uid

Defina o uid de metadados para o inteiro uid durante --edit.

--set-gid=gid

Defina o gid de metadados para o inteiro gid durante --edit.

--set-user=user

Defina o usuário de metadados como usuário durante --edit.

--unset-user

Remova o usuário de metadados durante --edit.

--set-group=group

Defina o usuário de metadados para grupo durante --edit.

--unset-group

Remova o grupo de metadados durante --edit.

-v, --verbose

Seja mais detalhado (pode ser usado mais de uma vez).

-q, --quiet

Fique quieto.

EXEMPLOS

Crie um arquivo de metadados para /etc:

bup meta -cRf etc.meta /etc
bup: removing leading "/" from "/etc"

Extraia o arquivo etc.meta (os arquivos estarão vazios):

mkdir tmp && cd tmp
bup meta -xf ../etc.meta
ls
etc

Restaurar /etc completamente:

mkdir tmp && cd tmp
bup meta --start-extract -f ../etc.meta
...fill in all regular file contents using some other tool...
bup meta --finish-extract -f ../etc.meta

Altere o usuário/uid para root:

bup meta --edit --set-uid 0 --set-user root src.meta > dest.meta

INSETOS

Hard links ainda não são tratados.

BUP

Parte do pacote bup(1).

AUTORES

Rob Browning rlb@defaultvalue.org.