Provided by: manpages-pt_20040726-4_all bug

NOME

       cp - copia arquivos e diretórios

SINOPSE

       cp [opes] arquivo caminho
       cp [opes] arquivo... diretrio

       Opções POSIX: [-fipRr]

       Opções   GNU   (forma  reduzida):  [-abdfilprsuvxPR]  [-S  SUFFIX]  [-V
       {numbered,existing,simple}] [--sparse=WHEN] [--help] [--version] [--]

DESCRIÇÃO

       cp copia arquivos (ou, opcionalmente diretórios).  Você pode copiar uma
       arquivo  para  um  destino  fornecido, ou copiar arbitrariamente muitos
       arquivos para um diretório destino.

       Se o último argumento de nome é um diretório existente, cp  copia  cada
       arquivo  origem  para  aquele  diretório  (com  o mesmo nome). De outra
       forma, se somente dois arquivos são fornecidos, ele  copia  o  primeiro
       para  o segundo. É um erro se o último argumento não for um diretório e
       mais que dois argumentos serem fornecidos.

       (Assim, ’cp -r /a /b’ irá copiar /a to /b/a e /a/x para /b/a/x no  caso
       de /b já existir, mas ele irá copiar /a para /b e /a/x para /b/x se não
       havia /b antecipadamente.)

       O modo de criação dos arquivos e diretórios será igual ao dos  arquivos
       originais,  por 0777, e modificado pela umask do usuário (a menos que a
       opção -p especificada).  (Mas durante  cópia  de  diretórios  de  forma
       recursiva,   diretórios   recentemente  criados  terão  temporariamente
       recebido o modo final deles ORed com S_IRWXU  (0700),  para  que  possa
       permitir   processos  de  leitura,  escrita  e  procura  nos  diretório
       recentemente criados.)

       Coisa alguma é feita quando tenta  copiar  um  arquivo  para  si  mesmo
       (exceto  possivelmente  de uma mensagem de erro).  Quando copiando para
       um arquivo existente diferente  este  é  aberto  usando  ’open(caminho,
       O_WRONLY  |  O_TRUNC)’.   Quando  copiando  para um novo arquivo este é
       criado usando ’open(caminho,  O_WRONLY  |  O_CREAT,  modo)’.   Se  isto
       falha, o arquivo existe, e a opção -f deve ser dada, cp tentará deletar
       (unlink) o arquivo existente, e então substituir pelo novo arquivo.

OPÇÕES POSIX

       POSIX reconhece 4 opções e meia:

       -f     Remove arquivos destinos existentes se requerido. (Veja  acima.)

       -i     Pergunta  se  deve  ser;a  sobrescrito  um  arquivo  de  destino
              regular.  (Escreve a questão no erro padrão, e lê a resposta  na
              entrada  padrão.   Somente  copia  sobre  em  caso  de  resposta
              afirmativa..)

       -p     Preserva o original proprietário, grupo,  permissões  (incluindo
              os  bits setuid e setgid), tempo da última modificação e o tempo
              do último acesso.  No caso da de duplicação do  proprietário  ou
              grupo  falhar, os bits setuid e setgid serão zerados.  (Note que
              mais tarde a origem e a cópia deverão ter  diferentes  tempo  de
              último  acesso,  desde  que  a  operação de cópia é um acesso no
              arquivo origem.)

       -R     Copia diretórios de forma recursiva, e faz algo  incerto  quando
              outros  objetos  a não ser arquivos ordinários ou diretóriso são
              encontrados.  (Assim, a cópia de um FIFO ou arquivo  especial  é
              um FIFO ou um arquivo especial.)

       -r     Copia   diretórios  de  forma  recursiva,  e  faz  alguma  coisa
              inespecífica com outros objetos que não são arquivos normais  ou
              diretórios.   (Assim,  ele é permitido, na realidade encorajado,
              para ter a opção -r um sinônimo para -R. De  qualquer  forma,  o
              comportamento  bobo,  desse  jeito  da presente versão GNU de cp
              (veja abaixo) não é proibida.)

DETALHES GNU

       Geralmente, arquivos são escritos da mesma forma que  são  lidos.  Para
       exceções, veja a opção --sparse abaixo.

       Por padrão, ’cp’ não irá copiar diretórios (veja -r abaixo).

       cp  geralmente  recusa a copia de uma rquivo em si mesmo, com a segunte
       exceção: se --force  --backup  é  especificado  com  origem  e  destino
       identicos, e referindo-se a um arquivo regular, cp irá fazer um arquivo
       de  cópia  de  segurança,  que  pode  ser  regular  ou  numerado,  como
       especificado  em  formas  usuais. Isto é útil quando se procura um modo
       simples para fazer cópias de segurança de um arquivo  existente  depois
       de alterá-lo.

OPÇÕES GNU

       -a, --archive
              Preserva  o máximo possível a estrutura e atributos dos arquivos
              originais na cópia (mas não preserva a estrutura do  diretório).
              Equivalente para -dpR.

       -d, --no-dereference
              Copia  ligações  simbólicas  com ligações simbólicas no lugar de
              copiar os arquivos para as quais apontam, e  preservam  ligações
              fortes entre arquivos de origrem nas cópias.

       -f, --force
              Remove os arquivos de destino existentes, e nunca pergunta antes
              de fazer isto.

       -i, --interactive
              Pergunta se será sobrescrito o arquivo regular de destino.

       -l, --link
              Cria ligações fortes ao inves de cópia de nào diretórios.

       -p, --preserve
              Preserva a original proprietário, grupo, permissões e rótulo  de
              tempo.

       -P, --parents
              Forma  o nome de cada arquivo destino pelo anexação no diretório
              destino de um barra e o nome especificado do arquivo  origem.  O
              último  argumento  fornecido  para  cp  deve  ser  o  nome de um
              diretório existente. Por exemplo, o comando:
                  cp --parents a/b/c diretório_existente
              copia o  arquivo  ’a/b/c’  para  o  ’diretório_existente/a/b/c’,
              criando qualquer diretório intermediário perdido.

       -r     Copia  diretórios  de  forma  recursiva,  copiando qualquer não-
              diretório e não-ligação simbólica  (isto  é,  FIFOs  e  arquivos
              especiais)  como  se  fossem  arquivos regulares. Isto significa
              tentar uma leitura em cada arquivo origem e uma escrita  para  o
              destino.  Assim,  com  esta opção, (Isto é uma falha. Ele pensar
              que você tem que evitar -r e usa -R se você não sabe o que  esta
              na  árvore  que  você  está  copiando.  Abrindo  um  arquivo  de
              dispositivo desconhecido, por exemplo  um  scanner,  tem  efeito
              desconhecido sobre o hardware.)

       -R, --recursive
              Copia   diretórios  de  forma  recursiva,  preservando  os  não-
              diretórios (veja -r acima).

       --sparse=WHEN
              Um ’arquivo espaçado’ contem  ’buracos’  -  seqüencias  de  zero
              bytes  que  não ocupam qualquer bloco de disco físico; a chamada
              de sistema ’read’ lê estes  como  zeros.  Isto  pode  economizar
              espaço  de  disco  e  aumentar  a  velocidade,  desde que muitos
              arquivos binários contenham lotes consecutivos  de  zero  bytes.
              Por  padrão,  cp  detecta  buracos no arquivo de entrada via uma
              heuristica bruta e cria a saída  correspondente  saída  espaçada
              também.

              O valor WHEN pode ser um dos seguintes:

              auto   O  comportamento padrão: o arquivo de saída e espaçado se
                     o arquivo de entrada é espaçado.

              always Sempre cria um arquivo de saída  espaçado.  Isto  é  útil
                     quando o arquivo de entrada reside num sistema de arquivo
                     que não suporta arquivos  espaçados,  mas  o  arquivo  de
                     saída está sobre o sistema de arquivos que suporta.

              never  Nunca   crie  um  arquivo  de  saída  espaçado.  Se  você
                     encontrar uma aplicação para esta opção, deixe-nos saber.

       -s, --symbolic-link
              Cria  um  ligação  simbólica  ao  invês  de  copiar  sobre  não-
              diretórios. Todo nome da origem deve ser absoluto (comecando com
              ’/’)  a  menos  que  o  arquivo  de  destino esteja no diretório
              corrente. Esta opção meramente resulta em uma mensagem  de  erro
              em sistemas que não suportam ligações simbólicas.

       -u, --update
              Não  copia  um  não-diretório que tem um destino existente com o
              igual ou maior tempo de modificação.

       -v, --verbose
              Imprime o nome de cada arquivo antes de copia-lo.

       -x, --one-file-system
              Pula sub-diretórios que são de diferentes sistemas  de  arquivos
              do qual a cópia tenha.

OPÇÕES GNU DE CÓPIAS DE SEGURANÇA

       As  versões  GNU  de  programas como, cp, mv, ln, install e patch podem
       criar  cópias  de  segurança  dos  arquivos  que  foram   sobrescritos,
       alterados  ou  destruídos,  se  isto  for desejado. Aqueles arquivos de
       seguranças são pedidos pela opção -b. E nomeados  como  é  especificado
       pela opção -V.  No caso de o nome do arquivo de segurança for fornecido
       pelo nome do arquivo mais um sufixo, o sufixo é especificado pela opção
       -S.

       -b, --backup
              Cria  cópias  de  segurança dos arquivos que são sobrescritos ou
              removidos.

       -S SUFIXO, --suffix=SUFIXO
              Anexa o SUFIXO para cada arquivo de segurança  feito.   Se  esta
              opção  não  é  especificada,  o  valor  da  variável de ambiente
              SIMPLE_BACKUP_SUFFIX é usada. E se SIMPLE_BACKUP_SUFFIX não  for
              selecionada, o padrão é ’~’.

       -V MTODO, --version-control=MTODO
              Especifíca  como  as  cópias  de  segurnaça  serão  nomeadas.  O
              argumento MTODO pode ser ’numeradas’ (ou ‘t’),  ’existing’  (ou
              ‘nil’),   or  ’never’  (or  ‘simple’).   Se  esta  opção  não  é
              especificada, o valor da variável de ambiente VERSION_CONTROL  é
              usado. E se VERSION_CONTROL não é selecionado, o tipo padrão das
              cópias de segurança é ’existing’.

              Esta opção correspnde a variável  Emacs  ’version-control’.   Os
              MTODOs são válidos (abreviações unicas são aceitas):

              t, numbered
                     Sempre fará cópias de segurança numeradas.

              nil, existing
                     Fará  cópia de segurança numeradas de arquivos, e simples
                     cópias de segurança dos outros.

              never, simple
                     Sempre fará cópias de segurança simples.

OPÇÕES PADRÃO GNU

       --help Imprime a mensagem de uso na saída padrão e sai.

       --version
              Imprime a versão na saída padrão e sai.

       --     Encerra a lista de opção.

AMBIENTE

       As variáveis LANG, LC_ALL, LC_CTYPE and LC_MESSAGES tem seu significado
       usual.   Para   versões   GNU,   as  variáveis  SIMPLE_BACKUP_SUFFIX  e
       VERSION_CONTROL controlam as cópias de segurança nomeando arquivo, como
       descritas acima.

DE ACORDO COM

       POSIX 1003.2

NOTAS

       Esta  página descreve cp é encontrada no pacote Utilitários de Arquivos
       4.0; outras versões podem ser um pouco diferente.   Envie  correções  e
       adições  para  aeb@cwi.nl.   Relatório  de  problemas  no programa para
       fileutils-bugs@gnu.ai.mit.edu.

TRADUZIDO POR LDP-BR em 21/08/2000.

       André L. Fassone Canova <lonelywolf@blv.com.br> (tradução) Ricardo C.O.
       Freitas <english.quest@best-service.com> (revisão)