Manpages

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 [AT] usa.net> (tradução) XXXXXX XX XXXXX XXXXXXXX <xxxxxxxxxx [AT] xxx.xxx> (revisão)