Provided by: manpages-pt-dev_20040726-5_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)

Linux 0.99.13                                 1 de novembro de 1993                                      FTOK(3)