SYMLINKAT

page by SiM07, un accro de l'informatique

Section: Manuel du programmeur Linux (2)
Updated: 10 avril 2006
Index Return to Main Contents

NOM

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

SYNOPSIS


#define _ATFILE_SOURCE

#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 newpath est un chemin 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 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 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 et est maintenue par Julien Cristau <julien.cristau@ens-lyon.org> et l'équipe francophone de traduction de Debian.

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> ».

This document was created by man2html, using the manual pages.
Time: 19:49:00 GMT, January 19, 2008