.\" Traduction 14/12/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" mj 15/12/1998 - LDP man-pages 1.22
.\" mj 05/06/1999 - LDP man-pages 1.23
.\" mj 30/05/2001 - LDP man-pages 1.36
.TH CP 1 "30 Mai 2001" FSF "Manuel de l'utilisateur Linux"
.SH NOM
cp \- Copier des fichiers.
.SH SYNOPSIS
.BI "cp [" "options" "] " "fichier chemin"
.br
.BI "cp [" "options" "] " "fichier... rpertoire"
.sp
Options POSIX :
.B "[\-fipRr] [\-\-]"
.sp
Options GNU (forme courte) :
.B [\-abdfilprsuvxPR]
.BI "[\-S " SUFFIXE ]
.B "[\-V {numbered,existing,simple}]"
.BI [\-\-sparse= WHEN ]
.B "[\-\-help] [\-\-version] [\-\-]"

.SH DESCRIPTION
.B cp
sert  copier des fichiers (et eventuellement des rpertoires).
On peut aussi bien copier un fichier donn vers une destination prcise
que copier un ensemble de fichiers dans un rpertoire.

Si le dernier argument correspond  un nom de rpertoire,
.B cp
copie dans ce rpertoire chaque fichier indiqu en conservant le mme nom.

Sinon, s'il n'y a que deux fichiers indiqus, il copie le premier sur
le second. 

Une erreur se produit si le dernier argument n'est pas un rpertoire,
et si plus de deux fichiers sont indiqus. Par dfaut, on n'effectue pas la
copie de rpertoires.
.PP
Ainsi, si /a est un rpertoire, alors `cp \-r /a /b' copiera /a dans /b/a et
/a/x dans /b/a/x au cas
o /b existe dj, mais il copiera /a sur /b et /a/x dans /b/x si /b
n'existait pas encore. Enfin si /b tait un fichier ordinaire la copie
chouera.
.PP
Les autorisations d'accs des fichiers et des rpertoires crs seront
les mmes que celles des fichiers d'origine masques avec un ET binaire
avec 0777, et modifies par le umask de l'utilisateur (sauf si l'on invoque
l'option \-p).

Pendant la copie rcursive de rpertoires, les nouveaux rpertoires verront
leur masque temporairement tendu par un OU binaire avec S_IRWXU (0700), afin
d'autoriser le processus d'y lire, crire et vrifier le contenu.
.PP
.B cp
ne fait rien lorsque l'on tente de copier un fichier sur lui-mme (sauf
ventuellement afficher un message d'erreur).

Lorsque la copie se fait sur un fichier existant, celui-ci est ouvert
en utilisant `open(chemin, O_WRONLY | O_TRUNC)'.
Lorsque la copie a lieu dans un nouveau fichier, 
on invoque `open(chemin, O_WRONLY | O_CREAT, mode)'.
Si l'ouverture d'un fichier existant choue, et si l'option \-f a t
invoque, 
.B cp
essaye de supprimer, avec
.BR unlink (2),
le fichier existant, puis de recrer un nouveau fichier.

.SH OPTIONS POSIX
Posix dfini quatre options et demi :
.TP
.B "\-f"
Effacer les fichiers cibles existants (voir ci-dessus).
.TP
.B "\-i"
Interroger l'utilisateur avant d'craser des fichiers rguliers existants.
La question est affiche sur stderr, et la rponse lue depuis stdin.
.TP
.B "\-p"
Conserver le propritaire, le groupe, les permissions d'accs et les
horodatages du fichier original. Si la conservation du propritaire ou
du groupe est impossible, les bits Set-UID et Set-GID sont effacs.
L'horodatage sera quand mme lgrement diffrent entre l'original et
la copie car l'opration de copie ncessite un accs en lecture
au fichier source.
.TP
.B "\-R"
Copier rcursivement les rpertoires, et grer correctement les copies
des fichiers spciaux ou des FIFOs.
.TP
.B \-r
Copier rcursivement les rpertoires mais la gestion des fichiers spciaux
n'est pas dfinie. En fait l'option \-r est autorise, et mme encourage
 se comporter comme l'option \-R, toutefois le comportement (stupide) de
la version GNU n'est pas interdit.
.TP
.B "\-\-"
Indique la fin explicite de la liste des options.
.SH Spcificit GNU
En gnral les fichiers sont crits immdiatement aprs lecture de l'original,
sauf si l'on utilise l'option
.B \-\-sparse
dcrite plus bas.

Par dfaut,
.B cp
ne copie pas les rpertoires (voir l'option
.BR \-r ).

.B cp
refuse gnralement de copier un fichier sur lui-mme, avec l'exception
suivante :
si les options
.BR \-\-force " et " \-\-backup
sont indiques, et si les fichiers
.IR origine " et " copie
sont identiques et se rapportent  un fichier rgulier,
.B cp
effectuera une copie de sauvegarde (voir plus bas).
Ceci peut servir  faire une sauvegarde d'un fichier avant de le modifier.

.SH OPTIONS GNU
.TP
.B "\-a, \-\-archive"
Prserver autant que possible la structure et les attributs du fichier
original lors de la copie. Cette option est quivalente 
.IR \-dpR .
.TP
.B "\-b, \-\-backup"
Effectuer une copie de sauvegarde des fichiers crass ou supprims.
.TP
.B "\-d, \-\-no-dereference"
Copier les liens symboliques en tant que tels plutt que de copier les
fichiers vers lesquels ils pointent. Prserver galement les liens matriels
entre les fichiers sources durant la copie.
.TP
.B "\-f, \-\-force"
Effacer les fichiers cibles existants.
.TP
.B "\-i, \-\-interactive"
Interroger l'utilisateur avant d'craser des fichiers rguliers existants.
.TP
.B "\-l, \-\-link"
Effectuer des liens matriels plutt que des copies des fichiers rguliers.
.TP
.B "\-P, \-\-parents"
Construire le nom de chaque fichier destination en ajoutant au rpertoire
cible un slash et le nom du fichier source indiqu. Le dernier argument
de
.B cp
doit tre un rpertoire existant. Par exemple, la commande
`cp \-\-parents a/b/c rep_existant' copie le fichier
.I a/b/c
en
.I rep_existant/a/b/c,
tout en crant les sous-rpertoires intermdiaires manquants.
.TP
.B "\-p, \-\-preserve"
Conserver le propritaire, le groupe, les permissions d'accs et les
horodatages du fichier original.
.TP
.B \-r
Copier rcursivement les rpertoires, les sous-rpertoires, 
et les fichiers rguliers qu'ils contiennent. Les fichiers spciaux
et les FIFOs sont considrs comme des fichiers normaux, desquels ont
essayera de lire des donnes pour les crire dans le fichier destination.
Ainsi `cp' risque de bloquer indfiniment durant la lecture d'une FIFO
ou d'un fichier spcial /dev/tty. Il faut considrer ceci comme un bug.
Cela signifie qu'il faut viter l'option -r, et la remplacer par -R.
N'oublions pas que l'ouverture d'un fichier spcial inconnu, par exemple
un scanner peut avoir des effets indsirables sur le matriel.
.TP
.B \-r
Copier rcursivement les rpertoires, les sous-rpertoires, 
en prservant tous les types de fichiers rencontrs (voir option
\-r ci-dessus).
.TP
.BI "\-\-sparse=" "QUAND"
[NDT : sparse = clairsem] Un fichier  trous (sparse file) contient des
squences d'octets nuls n'occupant pas de place sur le disque. L'appel
systme `read' lit ces donnes comme des zros. Non seulement cela permet
d'conomiser de la place sur le disque, mais on gagne galement de la
vitesse de lecture. De nombreux fichiers binaires (excutables par exemple)
contiennent des squences importantes de zros. Par dfaut,
.B cp
dtecte les trous dans les fichiers en utilisant une heuristique grossire et
restituera les trous dans les fichiers de sortie.
.RS
.PP
L'argument \fIQUAND\fP peut prendre l'une des valeurs suivantes :
.TP
.B auto
Le comportement par dfaut, le fichier de sortie est trou si des trous sont
dtects dans le fichier d'entre.
.TP
.B always
Toujours trouer les fichiers de sortie. Cette option sert lorsque les
fichiers d'entre se trouvent sur un systme de fichiers n'acceptant
pas les trous, et que les fichiers de sortie se trouveront sur
un systme les acceptant.
.TP
.B never
Ne jamais essayer de faire de trous dans les fichiers de sortie. Si vous
trouvez une utilit  cette option, faites nous le savoir...
.RE
.TP
.B "\-s, \-\-symbolic-link"
Crer des liens symboliques plutt que des copies des fichiers rguliers.
Tous les noms de fichiers sources doivent tre absolus (commenant par '/')
 moins que les fichiers destinations rsident dans le rpertoire en cours.
Cette option affiche un message d'erreur pour les systmes de fichiers ne
supportant pas les liens symboliques.
.TP
.B "\-u, \-\-update"
Ne pas effectuer la copie si le fichier destination 
existant (autre qu'un rpertoire) a une date de modification gale ou
plus rcente que celle du fichier source.
.TP
.B "\-v, \-\-verbose"
Afficher le nom de chaque fichier avant de le copier. 
.TP
.B "\-x, \-\-one-file-system"
Ignorer les sous-rpertoires se trouvant sur un systme de fichiers
diffrent de celui du dpart de la copie.
.SH "OPTIONS DE SAUVEGARDE GNU"
Les versions GNU des programmes comme
.BR cp ,
.BR mv ,
.BR ln ,
.B install
et
.B patch
creront au besoin une copie de sauvegarde des fichiers  craser,
 modifier ou  dtruire.
On demande une copie de sauvegarde  l'aide de l'option \-b,
on indique la nomenclature  adopter avec l'option \-V, et si
la sauvegarde se fait avec un suffixe, celui-ci est prcis avec l'option \-S.
.TP
.B "\-b, \-\-backup"
Crer une copie de sauvegarde des fichiers  craser ou  dtruire.
.TP
.BI "\-S " SUFFIXE ", \-\-suffix=" SUFFIXE
Ajouter le
.I SUFFIXE
indiqu  chaque fichier de sauvegarde cr.
Si cette option n'est pas indique, on utilisera la valeur de la variable
d'environnement
.BR SIMPLE_BACKUP_SUFFIX .
Si la variable
.B SIMPLE_BACKUP_SUFFIX
n'existe pas, la valeur par dfaut est `~'.
.TP
.BI "\-V " METHODE ", \-\-version\-control=" METHODE
.RS
Prciser la nomenclature des fichiers de sauvegarde
La
.I METHODE
indique peut tre `numbered' (`t'), `existing' (`nil'), ou `never' (`simple').
Si cette option n'est pas indique, la valeur de la variable
d'environnement
.B VERSION_CONTROL
est utilise, et si la variable
.B VERSION_CONTROL
n'existe pas, la valeur par dfaut est `existing'.
.PP
Cette option correspond  la variable `version-control' sous Emacs.
Les
.IR METHODES
valides (les abbrviations non-ambiges sont acceptes) sont :
.TP
.BR t ", " numbered
Toujours faire une sauvegarde numrote.
.TP
.BR nil ", " existing
Faire une sauvegarde numrote des fichiers en ayant dj une prcdente, et
une sauvegarde simple pour les autres.
.TP
.BR never ", " simple
Faire toujours une sauvegarde simple.
.RE
.SH "OPTIONS STANDARDS GNU"
.TP
.B "\-\-help"
Afficher un message d'aide sur la sortie standard, et terminer correctement.
.TP
.B "\-\-version"
Afficher un numro de version sur la sortie standard, et terminer correctement.
.TP
.B "\-\-"
Fin de la liste d'options.
.SH ENVIRONMENT
Les variables LANG, LC_ALL, LC_CTYPE et LC_MESSAGES
ont leurs significations habituelles.
Pour la version GNU, les variables SIMPLE_BACKUP_SUFFIX et VERSION_CONTROL
configurent la nomenclature adopte pour les sauvegardes de fichiers.
.SH "CONFORMIT"
POSIX 1003.2.

.SH TRADUCTION
Christophe Blaess, 1997.