NUME¶

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

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

SINOPSIS¶

#include <unistd.h>

int getdomainname(char *name, size_t len);
int setdomainname(const char *name, size_t len);

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-IEȘIRE¶

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.

STANDARDE¶

POSIX nu specifică aceste apeluri.

NOTE¶

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

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

CONSULTAȚI ȘI¶

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

TRADUCERE¶

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.