NAZWA

       gethostname, sethostname - pobiera/ustawia nazwę stacji

BIBLIOTEKA

       Standardowa biblioteka C (libc, -lc)

SKŁADNIA

       #include <unistd.h>

       int gethostname(char *name, size_t len);
       int sethostname(const char *name, size_t len);

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

       gethostname():
           _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L
               || /* glibc 2.19 i wcześniejsze */ _BSD_SOURCE

       sethostname():
           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

       Wywołania   systemowe   służą  do  uzyskania  dostępu  lub  zmiany  systemowej  nazwy  komputera.  Mówiąc
       precyzyjniej, działają na nazwie komputera, związanej z przestrzenią nazw UTS procesu wywołującego.

       sethostname() ustawia nazwę komputera na wartość określoną w tablicy znakowej name. Argument len argument
       określa liczbę bajtów w name (dlatego name nie wymaga końcowego bajtu null).

       gethostname() zwraca nazwę komputera, zakończoną znakiem null, w tablicy znakowej name,  o  długości  len
       bajtów.  Jeśli  zakończona  znakiem null nazwa komputera jest zbyt długa, aby się zmieścić, to nazwa jest
       obcinana i nie jest zwracany żaden błąd (ale  zob.  UWAGI  poniżej).  POSIX.1  określa,  że  jeśli  takie
       obcięcie występuje, to nie jest określone, czy zwracany bufor zawiera końcowy bajt null.

WARTOŚĆ ZWRACANA

       Po  pomyślnym  zakończeniu  zwracane  jest zero. Po błędzie zwracane jest -1 i ustawiane errno, wskazując
       błąd.

BŁĘDY

       EFAULT name jest nieprawidłowym adresem.

       EINVAL len jest ujemne lub, przy sethostname(), len jest większe niż maksymalny dopuszczalny rozmiar.

       ENAMETOOLONG
              (glibc gethostname())  len jest mniejsze niż rzeczywisty rozmiar. Przed glibc  2.1,  glibc  w  tym
              przypadku używało EINVAL.

       EPERM  W  przypadku  sethostname(),  wywołujący nie posiadał przywileju (ang. capability) CAP_SYS_ADMIN w
              przestrzeni nazw użytkownika związanej z jego przestrzenią nazw UTS (zob. namespaces(7)).

WERSJE

       SUSv2 gwarantuje, że „nazwy stacji są ograniczone do 255 bajtów”. POSIX 1003.1-2001 gwarantuje, że „nazwy
       stacji (bez kończącego NUL) są ograniczone  do  HOST_NAME_MAX  bajtów”.  W  Linuksie  HOST_NAME_MAX  jest
       zdefiniowane  z  wartością  64,  co  stanowiło limit od Linuksa 1.0 (wcześniejsze jądra narzucały limit 8
       bajtów).

   Różnice biblioteki C/jądra
       Biblioteka GNU C nie używa wywołania systemowego gethostname(); w zamian korzysta  z  gethostname()  jako
       funkcji  bibliotecznej  wywołującej uname(2) i kopiuje do len bajtów ze zwracanego pola nodename do name.
       Po przeprowadzeniu kopiowania, funkcja sprawdza, czy długość nodename była większa lub równa len i  jeśli
       tak  było,  funkcja zwraca -1 z errno ustawionym na ENAMETOOLONG; w takim przypadku końcowy bajt null nie
       jest umieszczany w zwracanym name.

STANDARDY

       gethostname()
              POSIX.1-2008.

       sethostname()
              Brak.

HISTORIA

       SVr4, 4.4BSD (interfejsy te pierwotnie pojawiły się w  4.2BSD).  POSIX.1-2001  i  POSIX.1-2008  definiuje
       gethostname() ale nie sethostname().

       Wersje  glibc przed glibc 2.2 obsługują przypadek, w którym długość nodename była większa lub równa len w
       odmienny sposób: nic nie jest kopiowane do name, a funkcja zwraca -1 z errno ustawionym na ENAMETOOLONG.

ZOBACZ TAKŻE

       hostname(1), getdomainname(2), setdomainname(2), uname(2), uts_namespaces(7)

TŁUMACZENIE

       Autorami polskiego tłumaczenia niniejszej strony podręcznika  są:  Przemek  Borys  <pborys@dione.ids.pl>,
       Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl> 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.8                              2 maja 2024 r.                                   gethostname(2)