.\" 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.
.\"
.\" Traduction 24/11/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" mj 30/05/2001 LDP-man-pages-1.36
.\" MJ 25/07/2003 LDP-1.56
.TH LN 1 "25 juillet 2003" LDP "Manuel de l'utilisateur Linux"
.SH NOM
ln \- Crer des liens entre fichiers.
.SH SYNOPSIS
.B ln [options]
.IB source " [" dest ]
.br
.B ln [options]
.I source... rpertoire
.sp
Options POSIX :
.B "[\-f] [\-\-]"
.sp
Options GNU (forme abrge):
.B [\-bdfinsvF]
.BI "[\-S " suffixe ]
.B "[\-V {numbered,existing,simple}]"
.B "[\-\-help] [\-\-version] [\-\-]"
.SH DESCRIPTION
Sous Unix, il existe deux types de `liens' entre fichiers, que l'on
nomme gnralement liens matriels (ou physiques) et liens symboliques
(ou logiques).

Un lien matriel est simplement une manire de nommer
un fichier. Un fichier peut avoir plusieurs noms. Un fichier n'est effac
rellement que lorsque son dernier nom est supprim. Le nombre de noms
d'un fichier est indiqu par la commande
.BR ls (1).
Il n'y a pas de notion de nom `original' : tous les noms d'un fichier ont
exactement la mme importance. Tous les noms d'un fichier se trouvent
gnralement - mais ce n'est pas obligatoire - dans le systme de fichiers
contenant les donnes du fichier.
.PP
Un lien symbolique est d'un tout autre genre. Il s'agit d'un petit fichier
spcial, qui contient un chemin d'accs. Ainsi un lien symbolique peut
pointer vers un systme de fichier diffrent de celui qui l'accueille.
Il peut galement pointer, grce  NFS, vers un systme de fichiers
appartenant  une autre machine. Enfin, un lien symbolique ne pointe
pas ncessairement vers un fichier existant.
Lorsque l'on accde  un lien symbolique (avec les appels systmes
.BR open (2)
ou
.BR stat (2)),
le nom du lien symbolique est remplac, par le noyau Unix, par une
rfrence au fichier vers lequel le lien pointe.
Toutefois, avec les appels
.BR rm (1)
et
.BR unlink (2)
le lien lui-mme est supprim, et non pas le fichier vis.
Il existe des appels systmes spciaux
.BR lstat (2)
et
.BR readlink (2)
qui renvoient le statut du lien symbolique, et le nom du fichier vers
lequel il pointe. Pour de nombreux autres appels-systmes, il existe
une frange d'incertitudes et de variations entre les diffrents systmes
pour savoir si la fonction s'applique au lien symbolique lui-mme, ou au
fichier cible.
.PP
.B ln
cre des liens entre fichiers. Par dfaut il s'agit de liens matriels.
Si l'on utilise l'option 
.BR "\-s" ,
les liens seront symboliques (logiques).
.PP
Si l'on n'indique qu'un seul nom de fichier, un lien vers ce fichier
est cr dans le rpertoire courant. Le nom de ce lien sera le mme
que celui du fichier vis (il s'agit l d'une extension GNU).
Sinon, si le dernier argument indique un rpertoire existant,
.B ln
crera des liens sur chacun des fichiers
.I source
indiqus dans ce rpertoire. Les noms seront gaux  ceux des fichiers
.I source
viss. (Consultez toutefois l'option
.B "\-\-no\-dereference"
plus bas).
Si l'on indique seulement deux noms de fichiers, un lien sera cr avec
le nom
.I dest
pointant vers le fichier
.IR source .
Il est interdit d'indiquer plus de deux arguments si le dernier nom n'est
pas un rpertoire.
.PP
Par dfaut,
.B ln
ne supprime pas les fichiers ni les liens symboliques existants.
(Ainsi on peut l'utiliser  des fins de verrouillage, il chouera
si 
.I dest
existe dj).
On peut toutefois forcer l'crasement avec l'option \-f.
.PP
Avec les implmentations existant actuellement, seul le Super-User peut
crer un lien matriel sur un rpertoire, et encore, c'est souvent totalement
impossible. POSIX interdit aux appels systme
.BR link (2)
et  l'utilitaire
.B ln
de crer des liens physique sur un rpertoire (mais n'interdit pas les liens
matriels entre diffrents systmes de fichiers).
.SH "OPTIONS POSIX"
.TP
.B "\-f"
Forcer l'crasement du fichier destination s'il existe.
.TP
.B "\-\-"
Fin explicite de la liste des options.
.SH "OPTIONS GNU"
.TP
.B "\-d, \-F, \-\-directory"
Autoriser le Super-User  crer un lien physique sur un rpertoire.
.TP
.B "\-f, \-\-force"
Forcer l'crasement du fichier destination s'il existe.
.TP
.B "\-i, \-\-interactive"
Demander confirmation avant de supprimer les fichiers destination.
.TP
.B "\-n, \-\-no\-dereference"
Lorsque l'on fournit une destination explicite qui se trouve tre
un rpertoire, la considrer comme un fichier normal.
.br
Lorsque la destination est un rpertoire rel (et non pas un
lien symbolique sur un rpertoire), il n'y a pas d'ambigut. Le lien
est cr dans ce rpertoire. Mais lorsque la destination est un lien
symbolique vers un rpertoire, il y a deux possibilits pour traiter
la demande.
.B ln
peut considrer la destination comme un rpertoire normal,
et crer le lien dans celui-ci. D'un autre ct, la destination peut
galement tre considre comme le lien symbolique lui-mme  crer.
Dans ce cas,
.B ln
doit dtruire, ou archiver, le lien existant avant de crer le nouveau lien.
Le comportement par dfaut est de considrer la destination comme un
rpertoire  part entire.
.TP
.B "\-s, \-\-symbolic"
Crer des liens symboliques  la place des liens physiques. Cette option
produit souvent des messages d'erreurs sur les systmes qui ne supportent
pas les liens symboliques.
.TP
.B "\-v, \-\-verbose"
Afficher le nom de chaque fichier avant de le lier.
.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 " MTHODE ", \-\-version\-control=" MTHODE
.RS
Prciser la nomenclature des fichiers de sauvegarde
La
.I MTHODE
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 MTHODES
valides (les abrviations non-ambigus 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 se terminer correctement.
.TP
.B "\-\-version"
Afficher un numro de version sur la sortie standard, et se terminer correctement.
.TP
.B "\-\-"
Fin de la liste d'options.
.SH ENVIRONNEMENT
Les variables LANG, LC_ALL, LC_CTYPE et LC_MESSAGES
ont leurs significations habituelles.
.SH "CONFORMIT"
POSIX 1003.2. Toutefois, POSIX 1003.2 (1996) ne parle pas des liens symboliques.
Ceux-ci ont t introduits par BSD, et n'existent pas dans System V release 3
et antrieurs.
.SH "VOIR AUSSI"
.BR ls (1),
.BR rm (1),
.BR link (2),
.BR lstat (2),
.BR open (2),
.BR readlink (2),
.BR stat (2),
.BR unlink (2)
.SH NOTES
Cette page dcrit la version de
.B ln
se trouvant dans le paquetage fileutils-4.0.
D'autres versions peuvent diffrer lgrement.

.SH TRADUCTION
Christophe Blaess, 1998-2003.