table of contents
GETNETENT(3) | Podręcznik programisty Linuksa | GETNETENT(3) |
NAZWA¶
getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - odczytanie wpisu dotyczącego sieci
SKŁADNIA¶
#include <netdb.h> struct netent *getnetent(void); struct netent *getnetbyname(const char *name); struct netent *getnetbyaddr(long net, int type); void setnetent(int stayopen); void endnetent(void);
OPIS¶
Funkcja getnetent() odczytuje następną linię z pliku /etc/networks i zwraca strukturę netent zawierającą pola otrzymane w wyniku rozłożenia linii. Plik /etc/networks jest otwierany, jeśli jest to potrzebne.
Funkcja getnetbyname() zwraca strukturę netent zawierającą wartości z tej linii pliku /etc/networks, która odpowiada sieci name.
Funkcja getnetbyaddr() zwraca strukturę netent zawierającą wartości z linii odpowiadającej sieci typu type o numerze net.
Funkcja setnetent() otwiera plik /etc/networks i ustawia wskaźnik pliku na jego początku. Jeśli stayopen będzie prawdziwe (1), to plik nie będzie zamykany pomiędzy wywołaniami getnetbyname() i getnetbyaddr().
Funkcja endservent() zamyka /etc/networks.
Struktura netent jest zdefiniowana w <netdb.h> następująco:
struct netent { char *n_name; /* oficjalna nazwa sieci */ char **n_aliases; /* lista aliasów */ int n_addrtype; /* rodzaj adresu sieci */ unsigned long int n_net; /* numer sieci */ }
Polami struktury netent są:
- n_name
- Oficjalna nazwa sieci.
- n_aliases
- Zakończona zerem lista alternatywnych nazw tej sieci.
- n_addrtype
- Rodzaj numeru sieci; zawsze AF_INET.
- n_net
- Numer sieci w porządku bajtów hosta.
WARTOŚĆ ZWRACANA¶
Funkcje getnetent(), getnetbyname() i getnetbyaddr() zwracają strukturę netent, lub wskaźnik NULL gdy wystąpi błąd lub napotkany zostanie koniec pliku.
PLIKI¶
- /etc/networks
- plik bazy danych z sieciami
ZGODNE Z¶
BSD 4.3
ZOBACZ TAKŻE¶
getprotoent(3), getservent(3), networks(5)
RFC 1101
1993-05-15 | BSD |