Scroll to navigation

getnetent(3) Library Functions Manual getnetent(3)

NUME

getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - obține o intrare din baza de date de rețea

BIBLIOTECA

Biblioteca C standard (libc, -lc)

REZUMAT

#include <netdb.h>
struct netent *getnetent(void);
struct netent *getnetbyname(const char *name);
struct netent *getnetbyaddr(uint32_t net, int type);
void setnetent(int stayopen);
void endnetent(void);

DESCRIERE

Funcția getnetent() citește următoarea intrare din baza de date a rețelelor și returnează o structură netent care conține câmpurile defalcate din intrarea respectivă. Dacă este necesar, se deschide o conexiune la baza de date.

Funcția getnetbyname() returnează o structură netent pentru intrarea din baza de date care corespunde rețelei name.

Funcția getnetbyaddr() returnează o structură netent pentru intrarea din baza de date care corespunde numărului de rețea net de tipul type. Argumentul net trebuie să fie în ordinea octeților gazdă.

Funcția setnetent() deschide o conexiune la baza de date și stabilește următoarea intrare la prima intrare. Dacă argumentul stayopen este diferit de zero, atunci conexiunea la baza de date nu va fi închisă între apelurile la una dintre funcțiile getnet*().

Funcția endnetent() închide conexiunea la baza de date.

Structura netent este definită în <netdb.h> după cum urmează:


struct netent {

char *n_name; /* numele oficial al rețelei */
char **n_aliases; /* listă alias */
int n_addrtype; /* tipul de adresă de rețea */
uint32_t n_net; /* numărul rețelei */ }

Membrii structurii netent sunt:

Numele oficial al rețelei.
O listă cu terminație NULL de nume alternative pentru rețea.
Tipul numărului de rețea; întotdeauna AF_INET.
Numărul rețelei în ordinea octeților gazdă.

VALOAREA RETURNATĂ

Funcțiile getnetent(), getnetbyname() și getnetbyaddr() returnează un indicator la o structură netent alocată static sau un indicator null în cazul în care apare o eroare sau se ajunge la sfârșitul fișierului.

FIȘIERE

/etc/networks
fișierul bazei de date a rețelelor

ATRIBUTE

Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).

Interfață Atribut Valoare
getnetent() Siguranța firelor MT-Unsafe race:netent race:netentbuf env locale
getnetbyname() Siguranța firelor MT-Unsafe race:netbyname env locale
getnetbyaddr() Siguranța firelor MT-Unsafe race:netbyaddr locale
setnetent(), endnetent() Siguranța firelor MT-Unsafe race:netent env locale

În tabelul de mai sus, netent din race:netent semnifică faptul că, dacă oricare dintre funcțiile setnetent(), getnetent() sau endnetent() sunt utilizate în paralel în diferite fire de execuție ale unui program, pot apărea concurențe la accesarea de date.

STANDARDE

POSIX.1-2008.

ISTORIC

POSIX.1-2001, 4.3BSD.

Înainte de glibc 2.2, argumentul net din getnetbyaddr() era de tip long.

CONSULTAȚI ȘI

getnetent_r(3), getprotoent(3), getservent(3)
RFC 1101

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.

20 iulie 2023 Pagini de manual de Linux 6.05.01