getdomainname(2) System Calls Manual getdomainname(2) NAZWA getdomainname, setdomainname - pobiera/ustawia nazwe domeny NIS BIBLIOTEKA Standardowa biblioteka C (libc, -lc) SKLADNIA #include int getdomainname(char *name, size_t len); int setdomainname(const char *name, size_t len); 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 wlacznie: _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500) OPIS Funkcje te sluza do uzyskania dostepu lub zmiany nazwy domeny NIS systemu. Mowiac precyzyjniej, dzialaja na nazwie domeny NIS, zwiazanej z przestrzenia nazw UTS procesu wywolujacego. setdomainname() ustawia nazwe domeny na wartosc okreslona w tablicy znakowej name. Argument len okresla liczbe bajtow w name (dlatego name nie wymaga koncowego bajtu null). getdomainname() zwraca nazwe domeny, zakonczona znakiem null, w tablicy znakowej name o dlugosci len bajtow. Jesli zakonczona znakiem null nazwa domeny wymaga wiecej niz len bajtow, getdomainname() zwraca pierwsze len bajtow (glibc) lub zwraca blad (libc). WARTOSC ZWRACANA Po pomyslnym zakonczeniu zwracane jest zero. Po bledzie zwracane jest -1 i ustawiane jest errno wskazujac blad. BLEDY setdomainname() moze zawiesc z powodu nastepujacych bledow: EFAULT name wskazywalo poza przestrzen adresowa uzytkownika. EINVAL len bylo ujemne lub zbyt duze. EPERM Wywolujacy nie posiadal przywileju (ang. capability) CAP_SYS_ADMIN w przestrzeni nazw uzytkownika zwiazanej z jego przestrzenia nazw UTS (zob. namespaces(7)). getdomainname() moze zawiesc z powodu nastepujacych bledow: EINVAL Dla getdomainname() pod libc: name jest rowne NULL lub name jest dluzsze niz len bajtow. WERSJE W wiekszosci architektur linuksowych (w tym x86), nie wystepuje wywolanie systemowe getdomainname(), zamiast tego glibc implementuje getdomainname() jako funkcje biblioteczna, zwracajaca kopie pola domainname zwrocona przez wywolanie do uname(2). STANDARDY Brak. HISTORIA Od Linuksa 1.0, limitem dlugosci nazwy domeny, w tym konczacego bajtu null, jest 64 bajtow. W starszych jadrach bylo to 8 bajtow. ZOBACZ TAKZE gethostname(2), sethostname(2), uname(2), uts_namespaces(7) TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Przemek Borys , Andrzej Krzysztofowicz i Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . Linux man-pages 6.06 31 pazdziernika 2023 r. getdomainname(2)