SYMLINKAT
Section : Manuel du programmeur Linux (
2)
Mise à jour de la version anglaise : 10 avril 2006
Index
Menu principal
NOM
symlinkat - Créer un lien symbolique relativement à un descripteur de fichier de répertoire
SYNOPSIS
#define _ATFILE_SOURCE
#include <fcntl.h> /* Définition des constantes AT_* */
#include <stdio.h>
int symlinkat(const char *oldpath, int newdirfd, const char *newpath);
DESCRIPTION
L'appel système
symlinkat()
opère de la même manière que
symlink(2),
excepté les différences décrites dans cette page de manuel.
Si
newpath
est un chemin relatif, il est interprété par rapport au répertoire référencé
par le descripteur de fichier
newdirfd
(plutôt que par rapport au répertoire de travail
courant du processus appelant, comme cela est fait par
symlink(2)
pour un chemin relatif).
Si
newpath
est relatif et que
newdirfd
est la valeur spéciale
AT_FDCWD,
newpath
est interprété par rapport au répertoire de travail courant
du processus appelant (comme avec
symlink(2)).
Si
newpath
est absolu,
newdirfd
est ignoré.
VALEUR RENVOYÉE
S'il réussit,
symlinkat()
renvoie 0.
S'il échoue, il renvoie -1 auquel cas
errno
contient le code d'erreur.
ERREURS
Les mêmes erreurs qui apparaissent pour
symlink(2)
peuvent se produire pour
symlinkat().
Les erreurs supplémentaires suivantes peuvent également se produire pour
symlinkat() :
- EBADF
-
newdirfd
n'est pas un descripteur de fichier valide.
- ENOTDIR
-
newpath
est relatif et
newdirfd
est un descripteur de fichier se référant à un fichier
autre qu'un répertoire.
VERSIONS
symlinkat()
a été ajouté à Linux dans le noyau 2.6.16.
CONFORMITÉ
Cet appel système n'est pas standard mais est proposé pour une inclusion
dans une prochaine révision de POSIX.1.
NOTES
Voir
openat(2)
pour des explications sur la nécessité de
symlinkat().
VOIR AUSSI
openat(2),
symlink(2),
path_resolution(7),
symlink(7)
TRADUCTION
Ce document est une traduction réalisée par Alain Portal
<aportal AT univ-montp2 DOT fr> le 4 août 2006
et révisée le 2 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 2 symlinkat ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- VERSIONS
-
- CONFORMITÉ
-
- NOTES
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 2 juillet 2008