oracular (3) ftok.3.gz

Provided by: manpages-es-dev_4.23.1-1_all bug

NOMBRE

       ftok - convierte un nombre de camino y un identificador de proyecto en una clave IPC de System V

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

SINOPSIS

       #include <sys/ipc.h>

       key_t ftok(const char *camino, int proy);

DESCRIPCIÓN

       La  función  ftok()  utiliza  la identidad del fichero que indica camino (que debe referirse a un fichero
       existente y accesible) y los 8 bits menos significativos de proy (que debe ser  distinto  de  cero)  para
       generar  una  clave  IPC  de  System  V  de  tipo  key_t, adecuada para el uso con msgget(2), semget(2) o
       shmget(2).

       El valor resultante es el mismo para todos los nombres de ruta que hacen  referencia  al  mismo  fichero,
       cuando  se  utiliza  el  mismo valor de proy. El valor devuelto debería ser diferente cuando los ficheros
       (que existen simultáneamente) o los identificadores de proyecto son distintos.

VALOR DEVUELTO

       En caso de éxito se devuelve la clave key_t generada. En caso de fallo se  devuelve  -1,  y  la  variable
       errno indica el error al igual que con la llamada al sistema stat(2).

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

       ┌───────────────────────────────────────────────────────────────┬────────────────────┬───────────────────┐
       │InterfazAtributoValor             │
       ├───────────────────────────────────────────────────────────────┼────────────────────┼───────────────────┤
       │ftok()                                                         │ Seguridad del hilo │ Multi-hilo seguro │
       └───────────────────────────────────────────────────────────────┴────────────────────┴───────────────────┘

ESTÁNDARES

       POSIX.1-2008.

HISTORIAL

       POSIX.1-2001.

NOTAS

       On some ancient systems, the prototype was:

           key_t ftok(char *camino, char proy);

       Today,  proj_id is an int, but still only 8 bits are used.  Typical usage has an ASCII character proj_id,
       that is why the behavior is said to be undefined when proj_id is zero.

       Of course, no guarantee can be given that the  resulting  key_t  is  unique.   Typically,  a  best-effort
       attempt  combines  the given proj_id byte, the lower 16 bits of the inode number, and the lower 8 bits of
       the device number into a 32-bit result.  Collisions may easily  happen,  for  example  between  files  on
       /dev/hda1 and files on /dev/sda1.

EJEMPLOS

       See semget(2).

VÉASE TAMBIÉN

       msgget(2), semget(2), shmget(2), stat(2), sysvipc(7)

TRADUCCIÓN

       La  traducción  al  español  de  esta  página  del  manual  fue  creada  por  Gerardo  Aburruzaga  García
       <gerardo.aburruzaga@uca.es> y Miguel Pérez Ibars <mpi79470@alu.um.es>

       Esta  traducción  es   documentación   libre;   lea   la   GNU   General   Public   License   Version   3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  o posterior con respecto a las condiciones de copyright.  No
       existe NINGUNA RESPONSABILIDAD.

       Si encuentra algún error en la traducción de esta página  del  manual,  envíe  un  correo  electrónico  a
       ⟨debian-l10n-spanish@lists.debian.org⟩.