bionic (3) ftok.3.gz

NAZWA

       ftok  - przekształca ścieżkę i identyfikator projektu na klucz komunikacji międzyprocesowej (IPC) Systemu
       V

SKŁADNIA

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

       key_t ftok(const char *pathname, int proj_id);

OPIS

        Uwaga! To tłumaczenie może być nieaktualne!

       Funkcja ftok wykorzystuje tożsamość pliku o  nazwie  podanej  w  pathname  (która  musi  odnosić  się  do
       istniejącego,  dostępnego  pliku)  oraz  8  najmniej znaczących bitów proj_id (które muszą stanowić oktet
       niezerowy) do wygenerowania klucza komunikacji międzyprocesowej Systemu V, typu key_t,  odpowiedniego  do
       używania w msgget(2), semget(2), lub shmget(2).

       Wartość  wynikowa jest taka sama dla wszystkich ścieżek stanowiących nazwy tego samego pliku, o ile użyje
       się tej samej wartości proj_id.  Zwracane wartości powinny się różnić gdy (istniejące jednocześnie) pliki
       lub identyfikatory projektu różnią się.

WARTOŚĆ ZWRACANA

       W  przypadku  powodzenia zwracana jest wygenerowana wartość key_t.  W przypadku błędu zwracane jest -1, a
       errno wskazuje błąd tak samo, jak dla funkcji systemowej stat(2).

ZGODNE Z

       XPG4

UWAGI

       Pod libc4 i libc5 (oraz pod SunOS 4.x) prototyp miał postać
              key_t ftok(char *pathname, char proj_id);
       Obecnie proj_id jest typu int, ale nadal tylko 8 bitów jest  używanych.  Typowe  zastosowanie  polega  na
       umieszczeniu  znaku  ASCII w proj_id i dlatego mówi się, że zachowanie jest nieokreślone gdy proj_id jest
       zerem.

       Oczywiście, nie można dać gwarancji, że otrzymany key_t jest unikalny. Typowo, dla uzyskania  najlepszego
       wyniku,  łączone  są: podany bajt proj_id, 16 mniej znaczących bitów numeru i-węzła oraz 8 niższych bitów
       numeru urządzenia w 32-bitowy wynik. kolizje  mogą  łatwo  wystąpić,  na  przykład  pomiędzy  plikami  na
       /dev/hda1 a plikami na /dev/sda1.

ZOBACZ TAKŻE

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

INFORMACJE O TŁUMACZENIU

       Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może nie być aktualne.
       W razie zauważenia różnic między powyższym opisem a rzeczywistym  zachowaniem  opisywanego  programu  lub
       funkcji, prosimy o zapoznanie się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:

              man --locale=C 3 ftok

       Prosimy   o   pomoc   w   aktualizacji   stron   man  -  więcej  informacji  można  znaleźć  pod  adresem
       http://sourceforge.net/projects/manpages-pl/.