.\" -*- 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 <nick@debian.org>
.\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
.\" Modified 2008-11-27 by mtk
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getdomainname 2 "2 maja 2024 r." "Linux man\-pages 6.9.1" 
.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 <unistd.h>\fP
.P
\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
.P
.RS -4
Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)):
.RE
.P
\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.
.P
\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).
.P
\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 \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)).
.P
\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
Tłumaczenie niniejszej strony podręcznika:
Przemek Borys <pborys@dione.ids.pl>,
Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>
i
Michał Kułach <michal.kulach@gmail.com>
.
.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 .
