getdomainname(2)

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

BIBLIOTECA
Biblioteca C standard (libc, -lc)

REZUMAT
#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)

DESCRIERE
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).

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

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

EFAULT
    name indică în afara spațiului de adrese al utilizatorului.

EINVAL
    len a fost negativă sau prea mare.

EPERM
    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:

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

VERSIUNI
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).

STANDARDE
Niciunul.

ISTORIC
Î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.

CONSULTAȚI ȘI
gethostname(2), sethostname(2), uname(2), uts_namespaces(7)

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

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 (https://www.gnu.org/licenses/gpl-3.0.html) 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.