getdomainname(2) | System Calls Manual | getdomainname(2) |
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.
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
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.
2 mai 2024 | Pagini de manual de Linux 6.8 |