gethostname(2)                System Calls Manual               gethostname(2)

NUME
       gethostname, sethostname - ob<?>ine/stabile<?>te numele gazdei

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <unistd.h>

       int gethostname(char *name, size_t len);
       int sethostname(const char *name, size_t len);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       gethostname():
           _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L
               || /* glibc 2.19 <?>i versiunile anterioare */ _BSD_SOURCE

       sethostname():
           Incepand cu glibc 2.21:
               _DEFAULT_SOURCE
           In glibc 2.19 <?>i 2.20:
               _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
           Pana la <?>i inclusiv glibc 2.19:
               _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

DESCRIERE
       Aceste apeluri de sistem sunt utilizate pentru a accesa sau pentru a
       modifica numele de gazda al sistemului. Mai exact, ele opereaza asupra
       numelui de gazda asociat cu spa<?>iul de nume UTS al procesului
       apelant.

       sethostname() stabile<?>te numele de gazda la valoarea data in matricea
       de caractere name.  Argumentul len specifica numarul de octe<?>i din
       name.  (Prin urmare, name nu necesita un octet de terminare nul).

       gethostname() returneaza numele de gazda cu un octet de terminare nul
       in matricea de caractere name, care are o lungime de len octe<?>i. In
       cazul in care numele de gazda cu un octet de terminare nul este prea
       mare pentru a incapea, numele este trunchiat <?>i nu se returneaza
       nicio eroare (a se vedea insa rubrica NOTE de mai jos). POSIX.1
       precizeaza ca, daca are loc o astfel de trunchiere, nu se specifica
       daca memoria tampon returnata include sau nu un octet de terminare nul.

VALOAREA RETURNATA
       In caz de succes, se returneaza zero. In caz de eroare, se returneaza
       -1, iar errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EFAULT name este o adresa nevalida.

       EINVAL argumentul len este negativ sau, pentru sethostname(), len este
              mai mare decat dimensiunea maxima permisa.

       ENAMETOOLONG
              (glibc gethostname()) argumentul len este mai mic decat
              dimensiunea reala; (inainte de glibc 2.1, glibc utiliza EINVAL
              pentru acest caz).

       EPERM  Pentru sethostname(), apelantul nu avea capacitatea
              CAP_SYS_ADMIN in spa<?>iul de nume de utilizator asociat cu
              spa<?>iul sau de nume UTS (a se vedea namespaces(7)).

VERSIUNI
       SUSv2 garanteaza ca ,,Numele de gazda sunt limitate la 255 de
       octe<?>i". POSIX.1 garanteaza ca ,,Numele gazdelor (fara a include
       octetul nul de terminare) sunt limitate la HOST_NAME_MAX octe<?>i". In
       Linux, HOST_NAME_MAX este definit cu valoarea 64, care a fost limita de
       la Linux 1.0 (nucleele anterioare au impus o limita de 8 octe<?>i).

   Diferen<?>e intre biblioteca C <?>i nucleu
       Biblioteca GNU C nu utilizeaza apelul de sistem gethostname(); in
       schimb, implementeaza gethostname() ca o func<?>ie de biblioteca care
       apeleaza uname(2) <?>i copiaza pana la len octe<?>i din campul nodename
       returnat in name. Dupa ce a efectuat copia, func<?>ia verifica daca
       lungimea campului nodename a fost mai mare sau egala cu len, iar daca
       este a<?>a, func<?>ia returneaza -1 cu errno stabilita la ENAMETOOLONG;
       in acest caz, un octet de terminare nul nu este inclus in campul
       nodename returnat.

STANDARDE
       gethostname()
              POSIX.1-2008.

       sethostname()
              Niciunul.

ISTORIC
       SVr4, 4.4BSD (aceste interfe<?>e au aparut pentru prima data in
       4.2BSD). POSIX.1-2001 <?>i POSIX.1-2008 specifica gethostname(), dar nu
       <?>i sethostname().

       Versiunile de glibc anterioare lui glibc 2.2 trateaza diferit cazul in
       care lungimea lui nodename a fost mai mare sau egala cu len: nu se
       copiaza nimic in name <?>i func<?>ia returneaza -1 cu errno stabilita
       la ENAMETOOLONG.

CONSULTA<?>I <?>I
       hostname(1), getdomainname(2), setdomainname(2), uname(2),
       uts_namespaces(7)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023                gethostname(2)