.\" -*- coding: UTF-8 -*-
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH CP 1 "April 2026" "GNU coreutils 9.11" "Comandos de usuário"
.SH NOME
cp \- copia arquivos e diretórios
.SH SINOPSE
\fBcp\fP [\fI\,OPÇÃO\/\fP]... [\fI\,\-T\/\fP] \fI\,ORIGEM DESTINO\/\fP
.br
\fBcp\fP [\fI\,OPÇÃO\/\fP]... \fI\,ORIGEM\/\fP... \fI\,DIRETÓRIO\/\fP
.br
\fBcp\fP [\fI\,OPÇÃO\/\fP]... \fI\,\-t DIRETÓRIO ORIGEM\/\fP...
.SH DESCRIÇÃO
.\" Add any additional description here
.PP
Copia ORIGEM para DESTINO, ou múltiplas ORIGENs para DIRETÓRIO.
.PP
Argumentos obrigatórios para opções longas também o são para opções curtas.
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-a'\fB\-a, \-\-archive\fP\X'tty: link'
o mesmo que \fB\-dR\fP \fB\-\-preserve\fP=\fI\,all\/\fP
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-attributes\-only'\fB\-\-attributes\-only\fP\X'tty: link'
não copia os dados do arquivo, só seus atributos
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-backup'\fB\-\-backup[=CONTROLE]\fP\X'tty: link'
faz uma cópia de segurança de cada arquivo de destino já existente
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-b'\fB\-b\fP\X'tty: link'
como \fB\-\-backup\fP, mas não aceita argumentos
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-copy\-contents'\fB\-\-copy\-contents\fP\X'tty: link'
copia o conteúdo de arquivos especiais quando recursivo
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-d'\fB\-d\fP\X'tty: link'
o mesmo que \fB\-\-no\-dereference\fP \fB\-\-preserve\fP=\fI\,links\/\fP
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-debug'\fB\-\-debug\fP\X'tty: link'
explica como um arquivo é copiado. Implica em \fB\-v\fP
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-f'\fB\-f, \-\-force\fP\X'tty: link'
se um arquivo de destino já existente não puder ser aberto, remove\-o e tenta
novamente (essa opção é ignorada quando a opção \fB\-n\fP também é usada)
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-i'\fB\-i, \-\-interactive\fP\X'tty: link'
pergunta antes de sobrescrever (sobrepõe uma opção \fB\-n\fP usada
anteriormente)
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-H'\fB\-H\fP\X'tty: link'
segue os links simbólicos da linha de comando em ORIGEM
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-L'\fB\-L, \-\-dereference\fP\X'tty: link'
sempre segue links simbólicos em ORIGEM
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-P'\fB\-P, \-\-no\-dereference\fP\X'tty: link'
nunca segue um link simbólico em ORIGEM
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-keep\-directory\-symlink'\fB\-\-keep\-directory\-symlink\fP\X'tty: link'
segue links simbólicos existentes para diretórios
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-l'\fB\-l, \-\-link\fP\X'tty: link'
faz um link físico dos arquivos em vez de copiá\-los
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-n'\fB\-n, \-\-no\-clobber\fP\X'tty: link'
(descontinuado) silenciosamente ignora arquivos existentes. Veja também
\fB\-\-update\fP
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-p'\fB\-p\fP\X'tty: link'
same as \fB\-\-preserve\fP=\fI\,mode,ownership,timestamps\/\fP
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-preserve'\fB\-\-preserve[=LISTA_ATR]\fP\X'tty: link'
preserva os atributos especificados
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-no\-preserve'\fB\-\-no\-preserve=LISTA_ATR\fP\X'tty: link'
não preserva os atributos especificados
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-parents'\fB\-\-parents\fP\X'tty: link'
usa o nome completo do arquivo fonte sob DIRETÓRIO
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-R'\fB\-R, \-r, \-\-recursive\fP\X'tty: link'
copia os diretórios recursivamente
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-reflink'\fB\-\-reflink[=QUANDO]\fP\X'tty: link'
controla cópias clone/CoW. Veja abaixo
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-remove\-destination'\fB\-\-remove\-destination\fP\X'tty: link'
remove cada arquivo de destino existente antes de tentar abri\-lo (contrasta
com \fB\-\-force\fP)
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-sparse'\fB\-\-sparse=QUANDO\fP\X'tty: link'
controla a criação de arquivos esparsos. Veja abaixo
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-strip\-trailing\-slashes'\fB\-\-strip\-trailing\-slashes\fP\X'tty: link'
remove quaisquer barras ao final de cada argumento ORIGEM
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-s'\fB\-s, \-\-symbolic\-link\fP\X'tty: link'
cria links simbólicos em vez de copiar
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-S'\fB\-S, \-\-suffix=\,SUFIXO\fP\X'tty: link'\/
sobrescreve o sufixo comum de cópia de segurança
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-t'\fB\-t, \-\-target\-directory=\,DIRETÓRIO\fP\X'tty: link'\/
copia todos os argumentos da ORIGEM para o DIRETÓRIO
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-T'\fB\-T, \-\-no\-target\-directory\fP\X'tty: link'
trata DESTINO como um arquivo normal
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-update'\fB\-\-update[=ATUALIZAÇÃO]\fP\X'tty: link'
controla quais arquivos existentes são atualizados;
UPDATE={all,none,none\-fail,older(default)}
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-u'\fB\-u\fP\X'tty: link'
Equivalente a \fB\-\-update\fP[=\fI\,older\/\fP]. Veja abaixo
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-v'\fB\-v, \-\-verbose\fP\X'tty: link'
explica o que está sendo feito
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-x'\fB\-x, \-\-one\-file\-system\fP\X'tty: link'
permanece neste sistema de arquivos
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-Z'\fB\-Z\fP\X'tty: link'
define o contexto de segurança SELinux do arquivo de destino para o tipo
padrão
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp\-\-context'\fB\-\-context[=CTX]\fP\X'tty: link'
como \fB\-Z\fP ou, se CTX for especificado, define o contexto de segurança
SELinux ou SMACK como CTX
.TP
\X'tty: link https://www.gnu.org/software/coreutils/cp#cp\-\-help'\fB\-\-help\fP\X'tty: link'
mostra esta ajuda e sai
.TP
\X'tty: link https://www.gnu.org/software/coreutils/cp#cp\-\-version'\fB\-\-version\fP\X'tty: link'
informa a versão e sai
.PP
LST_ATRIB é uma lista de atributos separados por vírgulas. Os atributos são
\&'mode' para permissões (incluindo quaisquer permissões ACL e xattr),
\&'ownership' para usuário e grupo, 'timestamps' para registro de data e hora
de arquivo, 'links' para links físicos, 'context' para contexto de
segurança, 'xattr' para atributos estendidos e 'all' para todos os
atributos.
.PP
Por padrão, arquivos esparsos da ORIGEM são detectados por uma heurística
básica e os respectivos arquivos de DESTINO são também feitos esparsos. Este
é o comportamento escolhido por \fB\-\-sparse\fP=\fI\,auto\/\fP. Especifique
\fB\-\-sparse\fP=\fI\,always\/\fP para criar um arquivo esparso em DESTINO sempre
que o arquivo ORIGEM tiver uma sequência de bytes zero suficientemente
grande. Use \fB\-\-sparse\fP=\fI\,never\/\fP para inibir a criação de arquivos
esparsos.
.PP
ATUALIZAÇÃO controla quais arquivos existentes no destino são
substituídos. \&'all' é a operação padrão quando uma opção \fB\-\-update\fP não é
especificada e resulta na substituição de todos os arquivos existentes no
destino. \&'none' é como a opção \fB\-\-no\-clobber\fP, pois nenhum arquivo no
destino é substituído e arquivos ignorados não induzem uma
falha. \&'none\-fail' também garante que nenhum arquivo seja substituído no
destino, mas quaisquer arquivos ignorados são diagnosticados e induzem uma
falha. \&'older' é a operação padrão quando \fB\-\-update\fP é especificado e
resulta na substituição de arquivos se eles forem mais antigos que o arquivo
de origem correspondente.
.PP
Por padrão ou com \fB\-\-reflink\fP[=\fI\,auto\/\fP], cp vai fazer uma cópia leve em
que os blocos de dados são copiados somente quando modificados, retrocedendo
para uma cópia padrão se isso não for possível. Com
\fB\-\-reflink\fP=\fI\,always\/\fP, cp vai falhar se CoW não for suportado, enquanto
\fB\-\-reflink\fP=\fI\,never\/\fP garante que uma cópia padrão seja efetuada.
.PP
O sufixo de cópia de segurança é "~", a não ser que esteja definido
\fB\-\-suffix\fP ou SIMPLE_BACKUP_SUFFIX. O método de controle de versão pode ser
definido com \fB\-\-backup\fP ou a variável de ambiente VERSION_CONTROL. Os
valores possíveis são:
.TP
none, off
nunca faz cópias de segurança (mesmo se \fB\-\-backup\fP for especificado)
.TP
numbered, t
faz cópias de segurança numeradas
.TP
existing, nil
numeradas se já existirem cópias de segurança numeradas, simples em caso
contrário
.TP
simple, never
sempre faz cópias de segurança simples
.PP
Como caso especial, cp faz uma cópia de segurança da ORIGEM quando as opções
force e backup são fornecidas e ORIGEM e DESTINO são iguais ao nome de um
arquivo comum já existente.
.SH AUTOR
Escrito por Torbjorn Granlund, David MacKenzie e Jim Meyering.
.SH "RELATANDO PROBLEMAS"
Relate erros para: bug\-coreutils@gnu.org
.br
Página do GNU coreutils:
.br
Ajuda em geral no uso de software GNU:
.br
Relate erros de tradução para
.SH "DIREITOS AUTORAIS"
Copyright \(co 2026 Free Software Foundation, Inc. Licença GPLv3+: GNU GPL
versão 3 ou posterior .
.br
Este é um software livre: você é livre para alterá\-lo e redistribuí\-lo. NÃO
HÁ QUALQUER GARANTIA, na máxima extensão permitida em lei.
.SH "VEJA TAMBÉM"
\fBinstall\fP(1)
.PP
.br
Documentação completa
.br
ou disponível localmente via: info \(aq(coreutils) cp invocation\(aq
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
André Luiz Fassone ,
Ricardo C.O.Freitas
e
Rafael Fontenelle .
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .