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(size_t size; char name[size], size_t size); int setdomainname(size_t size; const char name[size], 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 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 size okresla liczbe bajtow w name (dlatego name nie wymaga koncowego bajtu null). getdomainname() zwraca nazwe domeny, zakonczona znakiem null, w tablicy znakowej name o rozmiarze size 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 errno, wskazujac blad. BLEDY setdomainname() moze zawiesc z powodu nastepujacych bledow: EFAULT name wskazywalo poza przestrzen adresowa uzytkownika. EINVAL size byl ujemny lub zbyt duzy. 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 albo name jest rowne lub dluzsze niz size 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 rozmiaru 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 Tlumaczenie niniejszej strony podrecznika: 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.15 28 czerwca 2025 r. getdomainname(2)