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)