SYMLINKAT

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
NOTES
CONFORMITÉ
HISTORIQUE
VOIR AUSSI
TRADUCTION

NOM

symlinkat - Créer un lien symbolique relativement à un descripteur de répertoire

SYNOPSIS

#include <stdio.h>

int symlinkat(const char *oldpath, int newdirfd, const char *newpath);

DESCRIPTION

L'appel système symlinkat() fonctionne exactement comme symlink(2), les seules différences étant décrites dans cette page.
Si le chemin donné dans newpath est relatif, il est interprété relativement au répertoire référencé par le descripteur newdirfd (plutôt que par rapport au répertoire courant, comme c'est le cas avec symlink(2)).
Si le chemin donné dans newpath est relatif et si newdirfd a la valeur spéciale AT_FDCWD, alors newpath est interprété relativement au répertoire de travail du processus appelant, comme pour symlink(2).
Si le chemin donné dans newpath est absolu, newdirfd est ignoré.

VALEUR RENVOYÉE

symlinkat() renvoie zéro s'il réussit et -1 s'il échoue et écrit la cause de l'erreur dans errno.

ERREURS

Les erreurs renvoyées par symlink(2) peuvent aussi l'être par symlinkat(). Les erreurs supplémentaires suivantes peuvent également se produire :

EBADF: newdirfd n'est pas un descripteur valide.
ENOTDIR: newpath est un chemin relatif, et le descripteur newdirfd est associé à un fichier, pas à un répertoire.

NOTES

Voir openat(2) pour une explication de l'utilité de symlinkat().

CONFORMITÉ

Cet appel système n'est pas standard, mais il est proposé pour inclusion dans une prochaine version de POSIX.1.

HISTORIQUE

symlinkat() est apparu dans Linux 2.6.16.

VOIR AUSSI

openat(2), path_resolution(2), symlink(2)

TRADUCTION

Cette page de manuel a été traduite par Julien Cristau <julien.cristau@ens-lyon.org>.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction 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> ».

Création : octobre 2007