.\" -*- coding: UTF-8 -*- .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified 1995-07-22 by Michael Chastain : .\" 'gethostname' is real system call on Linux/Alpha. .\" Modified 1997-01-31 by Eric S. Raymond .\" Modified 2000-06-04, 2001-12-15 by aeb .\" Modified 2004-06-17 by mtk .\" Modified 2008-11-27 by mtk .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH gethostname 2 "30 martie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME gethostname, sethostname \- obține/stabilește numele gazdei .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP .PP \fBint gethostname(char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP \fBint sethostname(const char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP .fi .PP .RS -4 Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați \fBfeature_test_macros\fP(7)): .RE .PP \fBgethostname\fP(): .nf .\" The above is something of a simplification .\" also before glibc 2.3 there was a bit churn _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L || /* glibc 2.19 și versiunile anterioare */ _BSD_SOURCE .fi .PP \fBsethostname\fP(): .nf .\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 Î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) .fi .SH DESCRIERE Aceste apeluri de sistem sunt utilizate pentru a accesa sau pentru a modifica numele de gazdă al sistemului. Mai exact, ele operează asupra numelui de gazdă asociat cu spațiul de nume UTS al procesului apelant. .PP \fBsethostname\fP() stabilește numele de gazdă la valoarea dată în matricea de caractere \fIname\fP. Argumentul \fIlen\fP specifică numărul de octeți din \fIname\fP. (Prin urmare, \fIname\fP nu necesită un octet de terminare nul). .PP \fBgethostname\fP() returnează numele de gazdă cu un octet de terminare nul în matricea de caractere \fIname\fP, care are o lungime de \fIlen\fP octeți. În cazul în care numele de gazdă cu un octet de terminare nul este prea mare pentru a încăpea, numele este trunchiat și nu se returnează nicio eroare (a se vedea însă rubrica NOTE de mai jos). POSIX.1 precizează că, dacă are loc o astfel de trunchiere, nu se specifică dacă memoria tampon returnată include sau nu un octet de terminare nul. .SH "VALOAREA RETURNATĂ" În caz de succes, se returnează zero. În caz de eroare, se returnează \-1, iar \fIerrno\fP este configurată pentru a indica eroarea. .SH ERORI\-IEȘIRE .TP \fBEFAULT\fP \fIname\fP este o adresă nevalidă. .TP \fBEINVAL\fP .\" Can't occur for gethostbyname() wrapper, since 'len' has an .\" unsigned type; can occur for the underlying system call. argumentul \fIlen\fP este negativ sau, pentru \fBsethostname\fP(), \fIlen\fP este mai mare decât dimensiunea maximă permisă. .TP \fBENAMETOOLONG\fP (glibc \fBgethostname\fP()) argumentul \fIlen\fP este mai mic decât dimensiunea reală; (înainte de glibc 2.1, glibc utiliza \fBEINVAL\fP pentru acest caz). .TP \fBEPERM\fP Pentru \fBsethostname\fP(), apelantul nu avea capacitatea \fBCAP_SYS_ADMIN\fP în spațiul de nume de utilizator asociat cu spațiul său de nume UTS (a se vedea \fBnamespaces\fP(7)). .SH VERSIUNI SUSv2 garantează că „Numele de gazdă sunt limitate la 255 de octeți”. POSIX.1 garantează că „Numele gazdelor (fără a include octetul nul de terminare) sunt limitate la \fBHOST_NAME_MAX\fP octeți”. În Linux, \fBHOST_NAME_MAX\fP este definit cu valoarea 64, care a fost limita de la Linux 1.0 (nucleele anterioare au impus o limită de 8 octeți). .SS "Diferențe între biblioteca C și nucleu" Biblioteca GNU C nu utilizează apelul de sistem \fBgethostname\fP(); în schimb, implementează \fBgethostname\fP() ca o funcție de bibliotecă care apelează \fBuname\fP(2) și copiază până la \fIlen\fP octeți din câmpul \fInodename\fP returnat în \fIname\fP. După ce a efectuat copia, funcția verifică dacă lungimea câmpului \fInodename\fP a fost mai mare sau egală cu \fIlen\fP, iar dacă este așa, funcția returnează \-1 cu \fIerrno\fP stabilită la \fBENAMETOOLONG\fP; în acest caz, un octet de terminare nul nu este inclus în câmpul \fInodename\fP returnat. .SH STANDARDE .TP \fBgethostname\fP() POSIX.1\-2008. .TP \fBsethostname\fP() Niciunul. .SH ISTORIC SVr4, 4.4BSD (aceste interfețe au apărut pentru prima dată în 4.2BSD). POSIX.1\-2001 și POSIX.1\-2008 specifică \fBgethostname\fP(), dar nu și \fBsethostname\fP(). .PP .\" At least glibc 2.0 and glibc 2.1, older versions not checked Versiunile de glibc anterioare lui glibc 2.2 tratează diferit cazul în care lungimea lui \fInodename\fP a fost mai mare sau egală cu \fIlen\fP: nu se copiază nimic în \fIname\fP și funcția returnează \-1 cu \fIerrno\fP stabilită la \fBENAMETOOLONG\fP. .SH "CONSULTAȚI ȘI" \fBhostname\fP(1), \fBgetdomainname\fP(2), \fBsetdomainname\fP(2), \fBuname\fP(2), \fButs_namespaces\fP(7) .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .