Ubuntu Manpage: symlink - Fonctionnement des liens symboliques

NOM

       symlink - Fonctionnement des liens symboliques

DESCRIPTION

Les liens symboliques sont des fichiers qui agissent comme des pointeurs vers d'autres
fichiers. Pour comprendre leur fonctionnement, vous devez d'abord comprendre comment
fonctionnent les liens physiques.

Un lien physique (hard link) vers un fichier est indistinguable du fichier original car
c'est une référence directe vers l'objet sous-jacent pointé par le nom original. (Pour
être précis, chaque lien physique sur un fichier fait référence au même numéro d'inœud, ce
numéro étant un indice dans une table d'inœud qui contient des métadonnées sur tout le
contenu du système de fichiers. Consultez stat(2)). Les changements dans un fichier sont
indépendants du nom utilisé pour faire référence au fichier. Les liens physiques ne
peuvent pas faire référence aux répertoires (pour éviter le risque de boucles dans le
système de fichiers, ce qui planterait de nombreux programmes) et ne peuvent pas
référencer des fichiers sur un autre système de fichiers (car les numéros d'inœud ne sont
uniques que sur un même système de fichiers).

Un lien symbolique est un fichier d'un type spécial, dont le contenu est une chaîne
représentant le chemin d'accès vers un autre fichier, celui vers lequel le lien pointe.
(Le contenu d'un lien symbolique peut être lu en utilisant readlink(2).) En d'autres
termes, un lien symbolique est un pointeur vers un autre nom, pas vers le contenu
sous-jacent. Pour cette raison, les liens symboliques peuvent faire référence aux
répertoires et peuvent franchir les frontières des systèmes de fichiers.

Il n'y a pas d'obligation pour que le fichier dont le nom est référencé par un lien
symbolique existe. Un lien symbolique qui fait référence à un nom de fichier inexistant
est dit dangling link (pendouillant).

Comme un lien symbolique et l'objet qu'il référence coexistent sur le système de fichiers,
une confusion peut survenir pour distinguer le lien lui-même et l'objet référencé. Sur des
systèmes historiques, les commandes et les appels système adoptaient leur propres
conventions pour le suivi des liens symboliques de manière arbitraire. Des règles pour une
approche plus uniforme, comme elles sont implémentées sur Linux et d'autres systèmes, sont
présentées ici. Il est important que les applications locales se conforment aussi à ces
règles pour que l'interface avec l'utilisateur soit la plus cohérente possible.

Propriétés, permissions, et horodatage des liens symboliques
Le propriétaire et le groupe d'un lien symbolique existant peut être modifié en utilisant
lchown(2). Le seul moment où l'appartenance d'un lien symbolique est importante est lors
de sa suppression ou de son renommage dans un répertoire dont le bit « Sticky » est
positionné (consultez stat(2)).

Les horodatages du dernier accès et de la dernière modification d'un lien symbolique
peuvent être modifiés en utilisant utimensat(2) ou lutimes(3).

Sur Linux, les permissions associées au lien symbolique ne sont utilisées dans aucune
opération ; ces permissions sont toujours 0777 (lecture, écriture et exécution pour toutes
les catégories d'utilisateurs) et ne peuvent pas être modifiées.

Obtient un descripteur de fichier qui fait référence à un lien symbolique.
L'utilisation des attributs O_PATH and O_NOFOLLOW en association pour un appel open(2)
délivre un descripteur de fichier qui peut être transmis comme l'argument dirfd à des
appels systèmes tels que fstatat(2), fchownat(2), fchmodat(2), linkat(2), et
readlinkat(2), afin d'agir sur des liens symboliques (et non sur les fichiers vers
lesquels ils pointent).

Par défaut (c'est à dire si l'attribut AT_SYMLINK_FOLLOW n'est pas précisé), lorsque
name_to_handle_at(2) est utilisé sur un lien symbolique, il délivre un indicateur pour le
lien symbolique (et non pour le fichier vers lequel il pointe). On peut alors obtenir un
descripteur de fichier du lien symbolique (et non du fichier vers lequel il pointe) en
précisant l'attribut O_PATH lors d'un appel ultérieur à open_by_handle_at(2). De nouveau,
ce descripteur de fichier peut être utilisé dans des appels système cités précédemment
pour agir sur le lien symbolique en lui-même.

Traitement des liens symboliques par les appels système et les commandes
Les liens symboliques sont traités en agissant soit sur le lien lui-même, soit sur l'objet
pointé par le lien. Dans ce dernier cas, on dit que l'application ou l'appel système suit
le lien. Les liens symboliques peuvent faire référence à d'autres liens symboliques,
auquel cas les liens sont suivis jusqu'à ce qu'un objet qui ne soit pas un lien symbolique
soit rencontré, qu'un lien symbolique pointant sur un fichier inexistant soit trouvé, ou
qu'une boucle soit détectée. (La détection des boucles est faite en définissant une limite
maximale sur le nombre de liens qui peuvent être suivis, et une erreur se produit si cette
limite est atteinte).

Il faut considérer trois domaines d'utilisation différents des liens symboliques. Ce
sont :

1. Les liens symboliques fournis en argument des appels système sous forme de noms de
fichiers.

2. Les liens symboliques indiqués comme arguments de la ligne de commande pour les
utilitaires qui ne parcourent pas l'arborescence des fichiers.

3. Les liens symboliques rencontrés par les utilitaires qui traversent l'arborescence
(soit indiqués sur la ligne de commande, soit rencontrés comme partie de la hiérarchie
des fichiers).

Appels système
Le premier domaine est celui des liens symboliques utilisés en noms de fichiers comme
argument pour les appels système.

Sauf exception mentionnée ci-dessous, tous les appels système suivent les liens
symboliques. Par exemple s'il existe un lien slink qui pointe vers le fichier afile,
l'appel système open("slink" ...) renverra un descripteur de fichier faisant référence à
afile.

Certains appels système ne suivent pas les liens, et agissent sur le lien symbolique
lui-même. Ce sont : lchown(2), lgetxattr(2), llistxattr(2), lremovexattr(2), lsetxattr(2),
lstat(2), readlink(2), rename(2), rmdir(2) et unlink(2).

Certains autres appels système suivent éventuellement les liens symboliques. Il s'agit
de : faccessat(2), fchownat(2), fstatat(2), linkat(2), name_to_handle_at(2), open(2),
openat(2), open_by_handle_at(2) et utimensat(2) ; Reportez-vous à leur pages de manuel.
Comme remove(3) est un alias pour unlink(2), cette fonction de bibliothèque ne suit pas
non plus les liens symboliques. Quand rmdir(2) est utilisé sur un lien symbolique, il
échoue avec l'erreur ENOTDIR.

L'appel link(2) réclame une discussion particulière. POSIX.1-2001 précise que link(2) doit
déréférencer oldpath si c'est un lien symbolique. Néanmoins, Linux ne le fait pas. (Par
défaut, Solaris non plus, mais une option de compilation permet d'obtenir le comportement
POSIX.1-2001). La révision à venir de POSIX.1 changera de description pour permettre les
deux comportements.

Les commandes qui ne parcourent pas les arborescences
Ce second domaine est celui des liens symboliques, indiqués en tant que noms de fichiers,
comme argument pour des commandes ne traversant pas les arborescences.

Sauf exception mentionnée ci-dessous, les commandes suivent les liens symboliques fournis
en argument de ligne de commande. Par exemple, si un lien symbolique slink pointe vers un
fichier nommé afile, la commande cat slink affichera le contenu du fichier afile.

Notez bien que cette règle s'applique à des commandes qui peuvent dans d'autres situations
parcourir l'arborescence, par exemple la commande chown file suit cette règle, alors que
chown -R file, qui descend l'arborescence, ne la suit pas. (Cette dernière est traitée
dans la troisième partie ci-dessous).

Si on désire qu'une commande agisse sur le lien symbolique lui-même plutôt qu'en le
suivant, — par exemple si on veut que chown slink change l'appartenance du fichier slink,
que ce soit un lien symbolique ou non, — l'option -h doit être utilisée. Dans cet exemple,
la commande chown root slink modifierait l'appartenance du fichier référencé par slink,
tandis que chown -h root slink modifierait l'appartenance de slink lui-même.

Il y a quelques exceptions à cette règle :

* Les commandes mv(1) et rm(1) ne suivent pas les liens symboliques fournis en argument,
mais essayent respectivement de les renommer ou de les détruire. (Notez que si lorsqu'un
lien symbolique fait référence à un fichier par un chemin relatif, il peut cesser de
fonctionner si on le déplace dans un autre répertoire où le chemin relatif ne serait
plus correct).

* La commande ls(1) est aussi une exception à cette règle. Pour assurer la compatibilité
avec des systèmes historiques ( quand ls(1) ne descend pas une arborescence
— c'est-à-dire si l'option -R n'est pas présente), la commande ls(1) suit les liens
symboliques fournis en argument si les options -H ou -L sont indiquées, ou si les
options -F, -d et -l ne sont pas présentes. (La commande ls(1) est la seule dont les
options -H et -L modifient le comportement même lorsqu'elle ne fait pas un parcours
d'arborescence).

* La commande file(1) est aussi une exception à cette règle. Sauf mention contraire, la
commande file(1) ne suit pas les liens symboliques fournis en argument. La commande
file(1) ne suit les liens symboliques que si l'option -L est mentionnée.

Les commandes parcourant une arborescence
Les commandes suivantes parcourent, toujours ou sur option, l'arborescence des fichiers :
chgrp(1), chmod(1), chown(1), cp(1), du(1), find(1), ls(1), pax(1), rm(1) et tar(1).

Il est important de remarquer que les règles ci-dessous s'appliquent tant aux liens
symboliques rencontrés durant un parcours d'arborescence qu'aux liens fournis en argument
de ligne de commande.

La première règle s'applique aux liens qui référencent des fichiers autres que des
répertoires. Les opérations entreprises sur ces liens sont appliquées sur les liens
eux-mêmes, ou alors les liens sont ignorés.

La commande rm -r slink directory effacera slink, ainsi que tout lien symbolique rencontré
durant le parcours de directory, car les liens symboliques peuvent être effacés. En aucun
cas rm(1) ne touchera au fichier référencé par slink.

La seconde règle s'applique aux liens symboliques qui pointent vers des répertoires. Sauf
mention contraire, ces liens ne sont jamais suivis. On parle souvent d'un parcours
« physique » par opposition à un parcours « logique » (où les liens symboliques vers des
répertoires seraient suivis).

Certaines conventions sont (ou devraient être) respectées autant que possible par les
commandes parcourant des arborescences de fichiers :

* Une commande peut être forcée à suivre n'importe quel lien symbolique indiqué sur la
ligne de commande, quel que soit le type de fichier vers lequel il pointe, en utilisant
l'option -H (« half-logical »). Cette option permet d'avoir une représentation des noms
sur les lignes de commande conforme à l'espace logique des noms. (Notez que pour les
commandes qui ne parcourent pas toujours l'arborescence, l'option -H sera ignorée si
l'option -R n'est pas également présente.)

Par exemple, la commande chown -HR user slink parcourra la hiérarchie débutant par le
fichier pointé par slink. Remarquez que l'option -H n'est pas la même que l'option -h
traitée précédemment. L'option -H permet de suivre les liens symboliques indiqués sur la
ligne de commande aussi bien pour l'action à exécuter que pour le parcours de
l'arborescence ; tout se passe comme si l'utilisateur avait fourni le nom du fichier
référencé par le lien symbolique.

* Une commande peut être forcée à suivre les liens symboliques sur sa ligne de commande,
ainsi que tous les liens rencontrés durant le parcours, quel que soit le type des
fichiers qu'ils référencent, en utilisant l'option -L (« logical »). Cette option permet
de rendre l'espace réel des noms semblable à l'espace logique. (Notez que les commandes
qui ne font pas systématiquement de parcours d'arborescence ignoreront l'option -L si
l'option -R n'est pas présente).

Par exemple, la commande chown -LR user slink modifiera l'appartenance du fichier
référencé par slink. Si slink pointe vers un répertoire, chown(1) descendra
l'arborescence à partir de ce répertoire. En outre, si des liens symboliques sont
rencontrés pendant le parcours de chown(1), ils seront traités de la même façon que
slink.

* Une commande peut être forcée à employer le comportement par défaut en utilisant
l'option -P (pour « physique »). Cet attribut permet de rendre l'espace des noms
semblable à l'espace physique.

Pour les commandes qui ne parcourent pas d'arborescence par défaut, les options -H, -L et
-P sont ignorées si l'option -R n'est pas présente. De plus, vous pouvez indiquer -H, -L
et -P plusieurs fois ; c'est la dernière option qui déterminera le comportement de la
commande. Ceci permet de créer des alias sur des commandes afin d'avoir un comportement
choisi, et de surcharger ce comportement en ligne de commande.

Les commandes ls(1) et rm(1) présentent des exceptions pour ces règles :

* La commande rm(1) agit toujours sur le lien symbolique, et jamais sur le fichier qu'il
référence. Ainsi le lien n'est jamais suivi. La commande rm(1) ne prend pas en charge
les options -H, -L ou -P.

* Afin d'assurer une compatibilité avec systèmes historiques, la commande ls(1) agit
quelque peu différemment. Si on ne précise pas d'option -F, -d ou -l, alors ls(1) suivra
les liens indiqués sur la ligne de commande. Si l'option -L est mentionnée, ls(1) suivra
tous les liens symboliques, quels que soient leurs types, et qu'ils soient fournis sur
la ligne de commande ou rencontré en parcourant l'arborescence.

VOIR AUSSI

       chgrp(1), chmod(1), find(1), ln(1), ls(1), mv(1),  rm(1),  lchown(2),  link(2),  lstat(2),
       readlink(2),     rename(2),     symlink(2),     unlink(2),    utimensat(2),    lutimes(3),
       path_resolution(7)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Alain Portal <http://manpagesfr.free.fr/> (2008).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».