.\" -*- coding: UTF-8 -*- .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified 1997-08-25 by Nicolás Lichtmaier .\" Modified 2004-06-17 by Michael Kerrisk .\" Modified 2008-11-27 by mtk .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getdomainname 2 "30 marca 2023 r." "Linux man\-pages 6.05.01" .SH NAZWA getdomainname, setdomainname \- pobiera/ustawia nazwę domeny NIS .SH BIBLIOTEKA Standardowa biblioteka C (\fIlibc\fP, \fI\-lc\fP) .SH SKŁADNIA .nf \fB#include \fP .PP \fBint getdomainname(char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP \fBint setdomainname(const char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP .fi .PP .RS -4 Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)): .RE .PP \fBgetdomainname\fP(), \fBsetdomainname\fP(): .nf .\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 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) .fi .SH 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. .PP \fBsetdomainname\fP() ustawia nazwę domeny na wartość określoną w tablicy znakowej \fIname\fP. Argument \fIlen\fP określa liczbę bajtów w \fIname\fP (dlatego \fIname\fP nie wymaga końcowego bajtu null). .PP \fBgetdomainname\fP() zwraca nazwę domeny, zakończoną znakiem null, w tablicy znakowej \fIname\fP o długości \fIlen\fP bajtów. Jeśli zakończona znakiem null nazwa domeny wymaga więcej niż \fIlen\fP bajtów, \fBgetdomainname\fP() zwraca pierwsze \fIlen\fP bajtów (glibc) lub zwraca błąd (libc). .SH "WARTOŚĆ ZWRACANA" Po pomyślnym zakończeniu zwracane jest zero. Po błędzie zwracane jest \-1 i ustawiane jest \fIerrno\fP wskazując błąd. .SH BŁĘDY \fBsetdomainname\fP() może zawieść z powodu następujących błędów: .TP \fBEFAULT\fP \fIname\fP wskazywało poza przestrzeń adresową użytkownika. .TP \fBEINVAL\fP \fIlen\fP było ujemne lub zbyt duże. .TP \fBEPERM\fP Wywołujący nie posiadał przywileju (ang. capability) \fBCAP_SYS_ADMIN\fP w przestrzeni nazw użytkownika związanej z jego przestrzenią nazw UTS (zob. \fBnamespaces\fP(7)). .PP \fBgetdomainname\fP() może zawieść z powodu następujących błędów: .TP \fBEINVAL\fP Dla \fBgetdomainname\fP() pod libc: \fIname\fP jest równe \fBNULL\fP lub \fIname\fP jest dłuższe niż \fIlen\fP bajtów. .SH WERSJE W większości architektur linuksowych (w tym x86), nie występuje wywołanie systemowe \fBgetdomainname\fP(), zamiast tego glibc implementuje \fBgetdomainname\fP() jako funkcję biblioteczną, zwracającą kopię pola \fIdomainname\fP zwróconą przez wywołanie do \fBuname\fP(2). .SH STANDARDY .\" But they appear on most systems... Brak. .SH HISTORIA Od Linuksa 1.0, limitem długości nazwy domeny, w tym kończącego bajtu null, jest 64 bajtów. W starszych jądrach było to 8 bajtów. .SH "ZOBACZ TAKŻE" \fBgethostname\fP(2), \fBsethostname\fP(2), \fBuname\fP(2), \fButs_namespaces\fP(7) .PP .SH TŁUMACZENIE Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys , Andrzej Krzysztofowicz i Michał Kułach . .PP Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License w wersji 3 .UE lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. .PP Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej .MT manpages-pl-list@lists.sourceforge.net .ME .