CP(1) Comandos de usuario CP(1)
NOME
cp - copia arquivos e diretorios
SINOPSE
cp [OPCAO]... [-T] ORIGEM DESTINO
cp [OPCAO]... ORIGEM... DIRETORIO
cp [OPCAO]... -t DIRETORIO ORIGEM...
DESCRICAO
Copia ORIGEM para DESTINO, ou multiplas ORIGENs para DIRETORIO.
Argumentos obrigatorios para opcoes longas tambem o sao para opcoes
curtas.
-a, --archive
o mesmo que -dR --preserve=all
--attributes-only
nao copia os dados do arquivo, so seus atributos
--backup[=CONTROLE]
faz uma copia de seguranca de cada arquivo de destino ja
existente
-b como --backup, mas nao aceita argumentos
--copy-contents
copia o conteudo de arquivos especiais quando recursivo
-d o mesmo que --no-dereference --preserve=links
--debug
explica como um arquivo e copiado. Implica em -v
-f, --force
se um arquivo de destino ja existente nao puder ser aberto,
remove-o e tenta novamente (essa opcao e ignorada quando a opcao
-n tambem e usada)
-i, --interactive
pergunta antes de sobrescrever (sobrepoe uma opcao -n usada
anteriormente)
-H segue os links simbolicos da linha de comando em ORIGEM
-L, --dereference
sempre segue links simbolicos em ORIGEM
-P, --no-dereference
nunca segue um link simbolico em ORIGEM
--keep-directory-symlink
segue links simbolicos existentes para diretorios
-l, --link
faz um link fisico dos arquivos em vez de copia-los
-n, --no-clobber
(descontinuado) silenciosamente ignora arquivos existentes. Veja
tambem --update
-p same as --preserve=mode,ownership,timestamps
--preserve[=LISTA_ATR]
preserva os atributos especificados
--no-preserve=LISTA_ATR
nao preserva os atributos especificados
--parents
usa o nome completo do arquivo fonte sob DIRETORIO
-R, -r, --recursive
copia os diretorios recursivamente
--reflink[=QUANDO]
controla copias clone/CoW. Veja abaixo
--remove-destination
remove cada arquivo de destino existente antes de tentar abri-lo
(contrasta com --force)
--sparse=QUANDO
controla a criacao de arquivos esparsos. Veja abaixo
--strip-trailing-slashes
remove quaisquer barras ao final de cada argumento ORIGEM
-s, --symbolic-link
cria links simbolicos em vez de copiar
-S, --suffix=SUFIXO
sobrescreve o sufixo comum de copia de seguranca
-t, --target-directory=DIRETORIO
copia todos os argumentos da ORIGEM para o DIRETORIO
-T, --no-target-directory
trata DESTINO como um arquivo normal
--update[=ATUALIZACAO]
controla quais arquivos existentes sao atualizados;
UPDATE={all,none,none-fail,older(default)}
-u Equivalente a --update[=older]. Veja abaixo
-v, --verbose
explica o que esta sendo feito
-x, --one-file-system
permanece neste sistema de arquivos
-Z define o contexto de seguranca SELinux do arquivo de destino
para o tipo padrao
--context[=CTX]
como -Z ou, se CTX for especificado, define o contexto de
seguranca SELinux ou SMACK como CTX
--help mostra esta ajuda e sai
--version
informa a versao e sai
LST_ATRIB e uma lista de atributos separados por virgulas. Os atributos
sao 'mode' para permissoes (incluindo quaisquer permissoes ACL e
xattr), 'ownership' para usuario e grupo, 'timestamps' para registro de
data e hora de arquivo, 'links' para links fisicos, 'context' para
contexto de seguranca, 'xattr' para atributos estendidos e 'all' para
todos os atributos.
Por padrao, arquivos esparsos da ORIGEM sao detectados por uma
heuristica basica e os respectivos arquivos de DESTINO sao tambem
feitos esparsos. Este e o comportamento escolhido por --sparse=auto.
Especifique --sparse=always para criar um arquivo esparso em DESTINO
sempre que o arquivo ORIGEM tiver uma sequencia de bytes zero
suficientemente grande. Use --sparse=never para inibir a criacao de
arquivos esparsos.
ATUALIZACAO controla quais arquivos existentes no destino sao
substituidos. 'all' e a operacao padrao quando uma opcao --update nao e
especificada e resulta na substituicao de todos os arquivos existentes
no destino. 'none' e como a opcao --no-clobber, pois nenhum arquivo no
destino e substituido e arquivos ignorados nao induzem uma falha.
'none-fail' tambem garante que nenhum arquivo seja substituido no
destino, mas quaisquer arquivos ignorados sao diagnosticados e induzem
uma falha. 'older' e a operacao padrao quando --update e especificado e
resulta na substituicao de arquivos se eles forem mais antigos que o
arquivo de origem correspondente.
Por padrao ou com --reflink[=auto], cp vai fazer uma copia leve em que
os blocos de dados sao copiados somente quando modificados,
retrocedendo para uma copia padrao se isso nao for possivel. Com
--reflink=always, cp vai falhar se CoW nao for suportado, enquanto
--reflink=never garante que uma copia padrao seja efetuada.
O sufixo de copia de seguranca e "~", a nao ser que esteja definido
--suffix ou SIMPLE_BACKUP_SUFFIX. O metodo de controle de versao pode
ser definido com --backup ou a variavel de ambiente VERSION_CONTROL. Os
valores possiveis sao:
none, off
nunca faz copias de seguranca (mesmo se --backup for
especificado)
numbered, t
faz copias de seguranca numeradas
existing, nil
numeradas se ja existirem copias de seguranca numeradas, simples
em caso contrario
simple, never
sempre faz copias de seguranca simples
Como caso especial, cp faz uma copia de seguranca da ORIGEM quando as
opcoes force e backup sao fornecidas e ORIGEM e DESTINO sao iguais ao
nome de um arquivo comum ja existente.
AUTOR
Escrito por Torbjorn Granlund, David MacKenzie e Jim Meyering.
RELATANDO PROBLEMAS
Relate erros para: bug-coreutils@gnu.org
Pagina do GNU coreutils:
Ajuda em geral no uso de software GNU:
Relate erros de traducao para
DIREITOS AUTORAIS
Copyright (C) 2026 Free Software Foundation, Inc. Licenca GPLv3+: GNU
GPL versao 3 ou posterior .
Este e um software livre: voce e livre para altera-lo e redistribui-lo.
NAO HA QUALQUER GARANTIA, na maxima extensao permitida em lei.
VEJA TAMBEM
install(1)
Documentacao completa
ou disponivel localmente via: info '(coreutils) cp invocation'
TRADUCAO
A traducao para portugues brasileiro desta pagina man foi criada por
Andre Luiz Fassone , Ricardo C.O.Freitas
e Rafael Fontenelle
.
Esta traducao e uma documentacao livre; leia a Licenca Publica Geral
GNU Versao 3 ou posterior
para as condicoes de direitos autorais. Nenhuma responsabilidade e
aceita.
Se voce encontrar algum erro na traducao desta pagina de manual, envie
um e-mail para a lista de discussao de tradutores
.
GNU coreutils 9.10 Fevereiro de 2026 CP(1)