NAZWA

       gethostid, sethostid - pobiera lub ustawia unikatowy identyfikator bieżącego komputera

BIBLIOTEKA

       Standardowa biblioteka C (libc, -lc)

SKŁADNIA

       #include <unistd.h>

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

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

       gethostid():
           Od glibc 2.20:
               _DEFAULT_SOURCE || _XOPEN_SOURCE >= 500
           Do glibc 2.19 włącznie:
               _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 bieżącego
       komputera. 32-bitowy  identyfikator  miał  być  niepowtarzalny  wśród  wszystkich  istniejących  systemów
       uniksowych.  Normalnie  jest  to  podobne  do  adresu internetowego lokalnego komputera, 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 bieżącego komputera, 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żącego komputera.

       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-bezpieczne hostid env locale                                │
       ├─────────────┼────────────────────────┼────────────────────────────────────────────────────────────────┤
       │ sethostid() │ Bezpieczeństwo wątkowe │ MT-niebezpieczne const:hostid                                  │
       └─────────────┴────────────────────────┴────────────────────────────────────────────────────────────────┘

WERSJE

       W  implementacji  biblioteki  glibc  hostid  jest  przechowywane w pliku /etc/hostid (przed glibc 2.2 był
       używany plik /var/adm/hostid).

       W implementacji glibc, jeśli gethostid() nie może otworzyć pliku zawierającego ID komputera,  to  pobiera
       jego 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).

STANDARDY

       gethostid()
              POSIX.1-2008.

       sethostid()
              Brak.

HISTORIA

       4.2BSD; porzucono w 4.4BSD. SVr4 i POSIX.1-2001 zawiera gethostid(), lecz brak tam sethostid().

USTERKI

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

ZOBACZ TAKŻE

       hostid(1), gethostbyname(3)

TŁUMACZENIE

       Tłumaczenie niniejszej strony podręcznika: Przemek Borys  <pborys@dione.ids.pl>,  Andrzej  Krzysztofowicz
       <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

       Niniejsze  tłumaczenie  jest  wolną  dokumentacją.  Bliższe informacje o warunkach licencji można uzyskać
       zapoznając  się  z  GNU General Public License w wersji 3  lub  nowszej.   Nie   przyjmuje   się   ŻADNEJ
       ODPOWIEDZIALNOŚCI.

       Błędy  w  tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej manpages-pl-
       list@lists.sourceforge.net.

Linux man-pages 6.9.1                            2 maja 2024 r.                                     gethostid(3)