Provided by: manpages-pt-dev_20040726-4_all bug

NOME

       ftok  -  converte um caminho de diretório e um identificador de projeto para uma chave IPC
       System V

SINOPSE

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

       key_t ftok ( char *pathname, char proj )

DESCRIÇÃO

       A função converte  o  caminho  de  diretório  de  um  arquivo  acessível  existente  e  um
       identificador de projeto para uma chave IPC System V do tipo key_t.

VALOR DE RETORNO

       Em  caso  de  sucesso, o valor de retorno será o valor de key_t convertido, caso contrário
       será -1 com errno indicando o erro, como na chamada de sistema stat(2).

ERROS

       O valor de key_t gerado é obtido com o uso de stat no arquivo de disco  correspondente  ao
       pathname  para  obter  seu  número  de i-nó, e o número menor de dispositivo do sistema de
       arquivos no qual o arquivo de disco reside, combinando então com o valor  de  proj  com  8
       bits,  junto com os 16 bits mais baixos do número do i-nó, e junto com os 8 bits do número
       menor do dispositivo.  O algoritmo não garante um valor de chave único.  De fato

       •      Dois nomes diferentes ligando o mesmo arquivo produzem os mesmos valores de chave.

       •      Usando os 16 bits mais baixos do número do i-nó, há alguma chance (também  pequena,
              geralmente) de ter os mesmos valores de chave para nomes de arquivos se referindo a
              i-nós diferentes.

       •      Não discriminar entre números maiores de dispositivo dá alguma  chance  de  colisão
              (também pequena, geralmente) para sistemas com múltiplos controladores de disco.

VEJA TAMBÉM

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

TRADUÇÃO PARA A LÍNGUA PORTUGUESA

       RUBENS  DE  JESUS  NOGUEIRA  <darkseid99@usa.net>  (tradução)  XXXXXX  XX  XXXXX  XXXXXXXX
       <xxxxxxxxxx@xxx.xxx> (revisão)