getdomainname(2)

NAZWA
getdomainname, setdomainname - pobiera/ustawia nazwę domeny NIS

BIBLIOTEKA
Standardowa biblioteka C (libc, -lc)

SKŁADNIA
#include <unistd.h>

int getdomainname(char *name, size_t size);
int setdomainname(const char *name, size_t size);

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

getdomainname(), setdomainname():
    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
Funkcje te służą do uzyskania dostępu lub zmiany nazwy domeny NIS systemu. Mówiąc precyzyjniej, działają na nazwie domeny NIS, związanej z przestrzenią nazw UTS procesu wywołującego.

setdomainname() sets the domain name to the value given in the character array name. The size argument specifies the number of bytes in name. (Thus, name does not require a terminating null byte.)

getdomainname() returns the null-terminated domain name in the character array name, which has a size of size bytes. If the null-terminated domain name requires more than len bytes, getdomainname() returns the first len bytes (glibc) or gives an error (libc).

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
setdomainname() może zawieść z powodu następujących błędów:

EFAULT
    name wskazywało poza przestrzeń adresową użytkownika.

EINVAL
    size was negative or too large.

EPERM
    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)).

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

EINVAL
    For getdomainname() under libc: name is NULL or name is equal or longer than size bytes.

WERSJE
W większości architektur linuksowych (w tym x86), nie występuje wywołanie systemowe getdomainname(), zamiast tego glibc implementuje getdomainname() jako funkcję biblioteczną, zwracającą kopię pola domainname zwróconą przez wywołanie do uname(2).

STANDARDY
Brak.

HISTORIA
Since Linux 1.0, the limit on the size of a domain name, including the terminating null byte, is 64 bytes. In older kernels, it was 8 bytes.

ZOBACZ TAKŻE
gethostname(2), sethostname(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.