getdomainname(2) System Calls Manual getdomainname(2)

getdomainname, setdomainname - obține/stabilește numele de domeniu NIS

Biblioteca C standard (libc, -lc)

#include <unistd.h>
int getdomainname(char *name, size_t len);
int setdomainname(const char *name, size_t len);
Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați feature_test_macros(7)):

getdomainname(), setdomainname():

    Începând cu glibc 2.21:
        _DEFAULT_SOURCE
    În glibc 2.19 și 2.20:
        _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
    Până la și inclusiv glibc 2.19:
        _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

Aceste funcții sunt utilizate pentru a accesa sau pentru a modifica numele de domeniu NIS al sistemului gazdă. Mai exact, acestea operează asupra numelui de domeniu NIS asociat cu spațiul de nume UTS al procesului apelant.

setdomainname() stabilește numele de domeniu la valoarea dată în matricea de caractere name. Argumentul len specifică numărul de octeți din name (prin urmare, name nu necesită un octet de sfârșit nul).

getdomainname() returnează numele de domeniu cu terminație nulă în matricea de caractere name, care are o lungime de len octeți. În cazul în care numele de domeniu cu terminație nulă necesită mai mult de len octeți, getdomainname() returnează primii len octeți (glibc) sau dă o eroare (libc).

În caz de succes, se returnează zero. În caz de eroare, se returnează -1, iar errno este configurată pentru a indica eroarea.

setdomainname() poate eșua cu următoarele erori:

name indică în afara spațiului de adrese al utilizatorului.
len a fost negativă sau prea mare.
Apelantul nu avea capacitatea CAP_SYS_ADMIN în spațiul de nume de utilizator asociat cu spațiul său de nume UTS (a se vedea namespaces(7)).

getdomainname() poate eșua cu următoarele erori:

Pentru getdomainname() sub libc: name este NULL sau name este mai lung decât len octeți.

Pe majoritatea arhitecturilor Linux (inclusiv x86), nu există un apel de sistem getdomainname(); în schimb, glibc implementează getdomainname() ca o funcție de bibliotecă care returnează o copie a câmpului domainname returnat de la un apel la uname(2).

Niciunul.

Începând cu Linux 1.0, limita de lungime a unui nume de domeniu, inclusiv octetul de terminare nul, este de 64 de octeți. În nucleele mai vechi, aceasta era de 8 octeți.

gethostname(2), sethostname(2), uname(2), uts_namespaces(7)

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.

2 mai 2024 Pagini de manual de Linux 6.8