Man Access en français
ACCESS(2)                 Manuel du programmeur Linux                ACCESS(2)



 

NOM


       access - Verifier les permissions d'acces a un fichier.

 

SYNOPSIS


       #include 

       int access(const char *pathname, int mode);

 

DESCRIPTION






       access()  verifie  si le processus serait autorise a lire, ecrire, exe-
       cuter, ou tester l'existence d'un fichier (ou d'un autre  objet  appar-
       tenant  au systeme de fichiers), dont le nom est pathname.  Si pathname
       est un lien symbolique, ce sont les permissions du fichier  pointe  par
       celui-ci qui sont testees.

       mode  est  un masque constitue des arguments lies par un OU binaire  |
       R_OK, W_OK, X_OK et  F_OK.  Les requetes R_OK,  W_OK  et  X_OK  servent
       respectivement  a  tester  la  lecture,  l'ecriture,  et l'execution du
       fichier. La requete F_OK teste l'existence du fichier.

       Les tests dependent des permissions des repertoires  apparaissant  dans
       le  chemin  pathname et eventuellement des liens symboliques rencontres
       sur ce chemin.

       Le test est effectue avec les UID et GID  reels  du  processus,  plutot
       qu'avec les IDs effectifs qui sont utilises lorsque l'on tente l'opera-
       tion. Ceci permet aux programmes Set-UID de  determiner  les  autorisa-
       tions de l'utilisateur ayant invoque le programme.

       Seuls les bits d'acces sont verifies, et non pas le contenu du fichier.
       Ainsi, l'autorisation d'ecriture dans un repertoire indique  la  possi-
       bilite  d'y creer des fichiers et non d'y ecrire comme dans un fichier.
       De meme, un fichier DOS peut etre considere comme executable, alors que
       l'appel execve(2) echouera evidemment.

       Si  le  processus  a les privileges suffisants, une implementation peut
       indiquer un succes pour X_OK meme si le fichier n'a aucun bit  d'execu-
       tion positionne.

 

VALEUR RENVOYEE


       L'appel  renvoie  0 s'il reussit (toutes les requetes sont autorisees),
       ou -1 s'il echoue (au moins une requete du mode est interdite),  auquel
       cas errno contient le code d'erreur.

 

ERREURS


       access() doit echouer si :

       EACCES L'acces  serait refuse au fichier lui-meme, ou il n'est pas per-
              mis de parcourir l'un des repertoires du prefixe  du  chemin  de
              pathname.  (Voir aussi path_resolution(2).)

       ELOOP  Trop de liens symboliques ont ete rencontres en parcourant path-
              name.

 

       ENAMETOOLONG


              pathname est trop long.

       ENOENT Un repertoire contenu dans le  pathname  aurait  ete  accessible
              mais  n'existe  pas,  ou est un lien symbolique pointant dans le
              vide.

 

       ENOTDIR


              Un element contenu dans le chemin pathname n'est pas  un  reper-
              toire.

       EROFS  On  demande  une ecriture sur un systeme de fichiers en lecture-
              seule.

       access() peut echouer si :

       EFAULT pathname pointe en dehors de l'espace d'adressage accessible.

       EINVAL mode etait mal specifie.

       EIO    Une erreur d'entree-sortie s'est produite.

       ENOMEM Le noyau n'a pas assez de memoire.

 

       ETXTBSY


              On a demande l'ecriture dans un fichier executable qui en  cours
              d'utilisation.

 

RESTRICTIONS


       access()  renvoie une erreur si l'un des types d'acces est refuse, meme
       si les autres sont acceptes.

       access() peut fonctionner incorrectement sur un serveur NFS si les cor-
       respondances  d'UID  sont activees, car ces correspondances sont gerees
       par le serveur, et masquees au client qui  effectue  les  verifications
       d'autorisation.

       Utiliser access() pour verifier si un utilisateur a le droit, par exem-
       ple, d'ouvrir un fichier avant d'effectuer reellement l'ouverture  avec
       open(2),  risque  de creer un trou de securite. En effet, l'utilisateur
       peut exploiter le petit intervalle de temps entre  la  verification  et
       l'acces pour modifier le fichier (via un lien symbolique en general).

 

CONFORMITE


       SVr4, POSIX.1-2001, BSD 4.3

 

VOIR AUSSI


       chmod(2),  chown(2),  faccessat(2),  open(2),  path_resolution(2), set-
       gid(2), setuid(2), stat(2)

 

TRADUCTION


       Ce  document  est  une  traduction  realisee  par   Christophe   Blaess
         le  9 octobre 1996  et  revisee  le
       14 aot 2006.

       L'equipe de traduction a fait le maximum pour realiser  une  adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est  toujours  consultable  via  la  commande :   LANG=C man 2 access .
       N'hesitez  pas  a  signaler  a l'auteur ou au traducteur, selon le cas,
       toute erreur dans cette page de manuel.



LDP                              23 juin 2004                        ACCESS(2)