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

NOME

       ftok  -  converte um caminho de diretorio 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,C~AO

       A funcao converte o  caminho  de  diretorio  de  um  arquivo  acessivel
       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  sera  o  valor  de  key_t
       convertido,  caso contrario sera -1 com errno indicando o erro, como na
       chamada de sistema stat(2).

ERROS

       O valor de key_t gerado e obtido com o uso de stat no arquivo de  disco
       correspondente  ao  pathname  para obter seu numero de i-no, e o numero
       menor de dispositivo do sistema de arquivos no qual o arquivo de  disco
       reside,  combinando  entao com o valor de proj com 8 bits, junto com os
       16 bits mais baixos do numero do i-no, e junto com os 8 bits do  numero
       menor do dispositivo.  O algoritmo nao garante um valor de chave unico.
       De fato

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

       o      Usando  os  16  bits  mais  baixos  do numero do i-no, ha alguma
              chance (tambem pequena, geralmente) de ter os mesmos valores  de
              chave para nomes de arquivos se referindo a i-nos diferentes.

       o      Nao  discriminar  entre numeros maiores de dispositivo da alguma
              chance de colisao (tambem pequena, geralmente) para sistemas com
              multiplos controladores de disco.

VEJA TAMB'EM

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

TRADU,C~AO PARA A L'INGUA PORTUGUESA

       RUBENS  DE  JESUS  NOGUEIRA  <darkseid99@usa.net>  (traducao) XXXXXX XX
       XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (revisao)