gethostname(2)

NAZWA
gethostname, sethostname - pobiera/ustawia nazwę stacji

BIBLIOTEKA
Standardowa biblioteka C (libc, -lc)

SKŁADNIA
#include <unistd.h>

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

    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 size 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 rozmiarze size 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. WERSJE 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
    size jest ujemny lub, przy sethostname(), size jest większy niż maksymalny dopuszczalny rozmiar.

ENAMETOOLONG
    (glibc gethostname()) size jest mniejszy 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 size bajtów ze zwracanego pola nodename do name. Po przeprowadzeniu kopiowania, funkcja sprawdza, czy długość nodename była większa lub równa size 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-2024.

sethostname()
    Brak.

HISTORIA

gethostname()
    4.2BSD, SVr4, POSIX.1-2001.

sethostname()
    4.2BSD, SVr4.

Wersje glibc przed glibc 2.2 obsługują przypadek, w którym długość nodename była większa lub równa size 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
Tłumaczenie niniejszej strony podręcznika: 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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.