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 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 (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.