NAZWA

       gethostid, sethostid - pobranie lub ustawienie unikatowego identyfikatora obecnej maszyny

SKŁADNIA

       #include <unistd.h>

       long gethostid(void);
       int sethostid(long hostid);

   Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

       gethostid():
           _BSD_SOURCE || _XOPEN_SOURCE >= 500
       sethostid():
           Od glibc 2.21:
               _DEFAULT_SOURCE
           W glibc 2.19 i 2.20:
               _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
           Do glibc 2.19 włącznie:
               _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

OPIS

       gethostid()  oraz  sethostid  odpowiednio  pobiera  lub ustawia unikatowy 32-bitowy identyfikator obecnej
       maszyny. 32-bitowy identyfikator powinien  być  niepowtarzalny  wśród  wszystkich  istniejących  systemów
       uniksowych.  Normalnie  jest  to  podobne  do  adresu  internetowego  lokalnej  maszyny, zwracanego przez
       gethostbyname(3) i dlatego zwykle nie musi być ustawiane.

       Wywołanie sethostid() jest zastrzeżone dla superużytkownika.

WARTOŚĆ ZWRACANA

       gethostid() zwraca 32-bitowy identyfikator obecnej maszyny, jaki został ustawiony przez sethostid().

       W przypadku powodzenia sethostid() zwraca zero. W razie wystąpienia błędu zwracane jest  -1  i  ustawiana
       jest odpowiednia wartość zmiennej errno.

BŁĘDY

       sethostid() może zawieść z powodu następujących błędów:

       EACCES Proces wywołujący nie ma prawa zapisu do pliku używanego do przechowywania identyfikatora bieżącej
              maszyny.

       EPERM  Efektywny identyfikator  użytkownika  lub  grupy  procesu  wywołującego  nie  jest  taki  sam  jak
              odpowiadający mu identyfikator rzeczywisty.

ATRYBUTY

       Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

       ┌────────────┬────────────────────────┬───────────────────────────┐
       │Interfejs   │ Atrybut                │ Wartość                   │
       ├────────────┼────────────────────────┼───────────────────────────┤
       │gethostid() │ Bezpieczeństwo wątkowe │ MT-Safe hostid env locale │
       ├────────────┼────────────────────────┼───────────────────────────┤
       │sethostid() │ Bezpieczeństwo wątkowe │ MT-Unsafe const:hostid    │
       └────────────┴────────────────────────┴───────────────────────────┘

ZGODNE Z

       4.2BSD. Funkcje te porzucono w 4.4BSD. SVr4 zawiera gethostid(), lecz brak tam sethostid().

       POSIX.1-2001 i POSIX.1-2008 zawiera gethostid(), ale nie sethostid().

UWAGI

       W  implementacji  biblioteki  glibc  hostid  jest  przechowywane  w  pliku /etc/hostid. (W wersjach glibc
       wcześniejszych niż 2.2 był używany plik /var/adm/hostid).

       W implementacji glibc, jeśli gethostid() nie może otworzyć pliku zawierającego ID maszyny, to pobiera jej
       nazwę,  używając  gethostname(2),  następnie  przekazuje  ją do gethostbyname_r(3), aby dostać adres IPv4
       komputera, by w końcu zwrócić wartość utworzoną przez pomieszanie bitów adresu IPv4. (Taka  wartość  może
       nie być unikatowa).

BŁĘDY

       Nie da się zapewnić, że ten identyfikator jest globalnie niepowtarzalny.

ZOBACZ TAKŻE

       hostid(1), gethostbyname(3)

O STRONIE

       Angielska  wersja  tej strony pochodzi z wydania 4.07 projektu Linux man-pages. Opis projektu, informacje
       dotyczące  zgłaszania  błędów  można  oraz  najnowszą  wersję  oryginału   można  znaleźć   pod   adresem
       https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami   polskiego   tłumaczenia   niniejszej   strony   podręcznika   man   są:  Przemek  Borys  (PTM)
       <pborys@dione.ids.pl>, Andrzej  M.  Krzysztofowicz  (PTM)  <ankry@green.mf.pg.gda.pl>  i  Robert  Luberda
       <robert@debian.org>.

       Polskie  tłumaczenie  jest  częścią  projektu  manpages-pl;  uwagi,  pomoc,  zgłaszanie błędów na stronie
       http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją  4.07 oryginału.