LINKAT

Index

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

NOM

linkat - Créer un lien vers un fichier relatif à un répertoire

SYNOPSIS

#include <unistd.h>

int linkat(int olddirfd, const char *oldpath,
 int newdirfd, const char *newpath, int flags);

DESCRIPTION

L'appel système linkat() fonctionne exactement comme link(2), les seules différences étant celles décrites dans cette page.
Si le chemin donné dans oldpath est relatif, il est interprété par rapport au répertoire référencé par le descripteur de fichier olddirfd (plutôt que par rapport au répertoire courant du processus appelant, comme dans link(2)).
Si le chemin donné dans oldpath est relatif et olddirfd a la valeur spéciale AT_FDCWD, oldpath est interprété relativement au répertoire courant du processus appelant, comme link(2).
Si le chemin donné dans oldpath est absolu, olddirfd est ignoré.
L'interprétation de newpath est identique à celle de oldpath, excepté qu'un chemin relatif est interprété par rapport au répertoire correspondant à newdirfd.
L'argument flags est actuellement inutilisé, et doit être égal à 0.

VALEUR RENVOYÉE

Si elle réussit, la fonction linkat() renvoie zéro. En cas d'erreur, elle renvoie -1 et remplit errno avec la valeur d'erreur.

ERREURS

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

EBADF: olddirfd ou newdirfd n'est pas un descripteur de fichier valide.
ENOTDIR: oldpath est un chemin relatif et olddirfd est un descripteur de fichier ne référençant pas un répertoire, ou bien la même chose avec newpath et newdirfd.

NOTES

Voir openat(2) pour une explication de la nécessité de linkat().

CONFORMITÉ

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

HISTORIQUE

linkat() a été ajouté au noyau Linux dans sa version 2.6.16.

VOIR AUSSI

link(2), openat(2), path_resolution(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