.\" -*- nroff -*-
.\" Copyright Andries Brouwer, Ragnar Hojland Espinosa and A. Wik, 1998.
.\"
.\" This file may be copied under the conditions described
.\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
.\" that should have been distributed together with this file.
.\ 
.TH CP 1 "11/1998" "Utilitários de Arquivos GNU 4.0"
.SH NOME
cp \- copia arquivos e diretórios
.SH SINOPSE
.BI "cp [" "opções" "] " "arquivo caminho"
.br
.BI "cp [" "opções" "] " "arquivo... diretório"
.sp
Opções POSIX:
.B [\-fipRr]
.sp
Opções GNU (forma reduzida):
.B [\-abdfilprsuvxPR]
.BI "[\-S " SUFFIX ]
.B "[\-V {numbered,existing,simple}]"
.BI [\-\-sparse= WHEN ]
.B "[\-\-help] [\-\-version] [\-\-]"
.SH DESCRIÇÃO
.B 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.
.PP
Se o último argumento de nome é um diretório existente,
.B cp
copia cada
.I 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.
.PP
(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.)
.PP
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.)
.PP
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,
.B cp
tentará deletar (unlink) o arquivo existente, e então substituir
pelo novo arquivo.

.SH "OPÇÕES POSIX"
POSIX reconhece 4 opções e meia:
.TP
.B \-f
Remove arquivos destinos existentes se requerido. (Veja acima.)
.TP
.B \-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..)
.TP
.B \-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.)
.TP
.B \-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.)
.TP
.B \-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
.BR cp
(veja abaixo) não é proibida.)
.SH "DETALHES GNU"
.PP
Geralmente, arquivos são escritos da mesma forma que são lidos. Para exceções,
veja a opção
.B "\-\-sparse"
abaixo.
.PP
Por padrão, 'cp' não irá copiar diretórios (veja
.B "\-r"
abaixo).
.PP
.B cp
geralmente recusa a copia de uma rquivo em si mesmo, com a segunte
exceção: se
.B "\-\-force \-\-backup"
é especificado com
.I origem
e
.I destino
identicos, e referindo-se a um arquivo regular,
.B 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.
.SH "OPÇÕES GNU"
.TP
.B "\-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
.BR "\-dpR" .
.TP
.B "\-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.
.TP
.B "\-f, \-\-force"
Remove os arquivos de destino existentes, e nunca pergunta antes de fazer isto.
.TP
.B "\-i, \-\-interactive"
Pergunta se será sobrescrito o arquivo regular de destino.
.TP
.B "\-l, \-\-link"
Cria ligações fortes ao inves de cópia de nào diretórios.
.TP
.B "\-p, \-\-preserve"
Preserva a original proprietário, grupo, permissões e rótulo de tempo.
.TP
.B "\-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
.B cp
deve ser o nome de um diretório existente. Por exemplo, o comando:
.br
.nf
    cp \-\-parents a/b/c diretório_existente
.br
.fi
copia o arquivo 'a/b/c' para o 'diretório_existente/a/b/c', criando qualquer
diretório intermediário perdido.
.TP
.B "\-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,
'cp' pode muito bem travar indefinidamente lendo um FIFO ou /dev/tty.
(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.)
.TP
.B "\-R, \-\-recursive"
Copia diretórios de forma recursiva, preservando os não-diretórios (veja
.B "\-r"
acima).
.TP
.BI "\-\-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,
.B cp
detecta buracos no arquivo de entrada via uma heuristica bruta
e cria a saída correspondente saída espaçada também.
.RS
.PP
O valor
.I WHEN
pode ser um dos seguintes:
.TP
.B auto
O comportamento padrão: o arquivo de saída e espaçado se o arquivo de
entrada é espaçado.
.TP
.B 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.
.TP
.B never
Nunca crie um arquivo de saída espaçado. Se você encontrar uma aplicação para
esta opção, deixe-nos saber.
.RE
.TP
.B "\-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.
.TP
.B "\-u, \-\-update"
Não copia um não-diretório que tem um destino existente com
o igual ou maior tempo de modificação.
.TP
.B "\-v, \-\-verbose"
Imprime o nome de cada arquivo antes de copia-lo.
.TP
.B "\-x, \-\-one\-file\-system"
Pula sub-diretórios que são de diferentes sistemas de arquivos do qual
a cópia tenha.
.SH "OPÇÕES GNU DE CÓPIAS DE SEGURANÇA"
As versões GNU de programas como,
.BR cp ,
.BR mv ,
.BR ln ,
.B install
e
.B 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.
.TP
.B "\-b, \-\-backup"
Cria cópias de segurança dos arquivos que são sobrescritos ou removidos.
.TP
.BI "\-S " SUFIXO ", \-\-suffix=" SUFIXO
Anexa o
.I SUFIXO
para cada arquivo de segurança feito.
Se esta opção não é especificada, o valor da variável de ambiente
.B SIMPLE_BACKUP_SUFFIX
é usada. E se
.B SIMPLE_BACKUP_SUFFIX
não for selecionada, o padrão é '~'.
.TP
.BI "\-V " MÉTODO ", \-\-version\-control=" MÉTODO
.RS
Especifíca como as cópias de segurnaça serão nomeadas. O argumento
.I MÉTODO
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
.B VERSION_CONTROL
é usado. E se
.B VERSION_CONTROL
não é selecionado, o tipo padrão das cópias de segurança é 'existing'.
.PP
Esta opção correspnde a variável Emacs 'version-control'.
Os 
.IR MÉTODO s
são válidos (abreviações unicas são aceitas):
.TP
.BR t ", " numbered
Sempre fará cópias de segurança numeradas.
.TP
.BR nil ", " existing
Fará cópia de segurança numeradas de arquivos, e simples cópias de segurança
dos outros.
.TP
.BR never ", " simple
Sempre fará cópias de segurança simples.
.RE
.SH "OPÇÕES PADRÃO GNU"
.TP
.B "\-\-help"
Imprime a mensagem de uso na saída padrão e sai.
.TP
.B "\-\-version"
Imprime a versão na saída padrão e sai.
.TP
.B "\-\-"
Encerra a lista de opção.
.SH 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.
.SH "DE ACORDO COM"
POSIX 1003.2
.SH NOTAS
Esta página descreve
.B 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.
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWAndré L. Fassone Canova <lonelywolf@blv.com.br> (tradução)\fR
\&\fR\&\f(CWRicardo C.O. Freitas <english.quest@best-service.com> (revisão)\fR