FTOK(3)            Manuel du programmeur Linux            FTOK(3)


NOM
       ftok - Convertir un nom de fichier et un identificateur de
       projet en clé IPC système V.

SYNOPSIS
       # include <sys/types.h>
       # include <sys/ipc.h>

       key_t ftok (char *pathname, char proj )

DESCRIPTION
       Cette fonction convertit le nom et le chemin d'accès  d'un
       fichier  existant, ainsi qu'un identificateur de projet en
       une clé IPC Système V de type key_t.

VALEUR RENVOYÉE
       Si elle réussit, la fonction ftok renvoie  une  valeur  de
       type  key_t,  sinon  elle renvoie -1, et errno contient un
       code d'erreur parmi ceux de l'appel système stat(2).

BUGS
       La valeur de type key_t est obtenue en effectuant un  stat
       sur  le  fichier  disque  correspondant  à  pathname, afin
       d'obtenir son numéro d'i-noeud, et  le  numéro  mineur  du
       périphérique  sur  lequel  réside  le système de fichiers.
       Ensuite, les 8 bits de la valeur proj sont  associés  avec
       les  16 bits de poids faibles du numéro d'i-noeud, et avec
       les 8 bits du numéro mineur du périphérique.  L'algorithme
       ne garantit pas l'unicité de la clé.  En fait :

       ·      Deux  noms  différents pointant sur le même fichier
              produisent la même clé.

       ·      L'utilisation des  16  bits  de  poids  faibles  du
              numéro    d'i-noeud   laissent   quelques   chances
              (faibles) pour que 2 i-noeuds différents produisent
              la même clé.

       ·      On   n'utilise   pas   les   numéros   majeurs   de
              périphériques, laissant encore  quelques  (faibles)
              possibilités  de  collision  sur  un  système  avec
              plusieurs contrôleurs de disques.

VOIR AUSSI
       ipc(5), msgget(2), semget(2), shmget(2), stat(2).


TRADUCTION
       Christophe Blaess, 1997.








Linux 0.99.13            26 Octobre 1996                        1