Provided by: manpages-pl-dev_4.13-4_all 
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(uint32_t net, int type);
void setnetent(int stayopen);
void endnetent(void);
OPIS
Funkcja getnetent() odczytuje następny wpis z bazy danych sieci i zwraca strukturę netent
zawierającą pola powstałe z rozłożenia pól wpisu. Połączenie do bazy danych jest
otwierane, jeśli jest to potrzebne.
Funkcja getnetbyname() zwraca strukturę netent zawierającą ten wpis z bazy danych, który
odpowiada sieci name.
Funkcja getnetbyaddr() zwraca strukturę netent zawierającą ten wpis z bazy danych, który
odpowiada sieci o numerze net rodzaju type. Argument net musi być w porządku bajtów
lokalnego komputera (host byte order).
Funkcja setnetent() otwiera połączenie do bazy danych i ustawia wskaźnik kolejnego wpisu
na pierwszy wpis. Jeśli stayopen jest niezerowy, to połączenie do bazy danych nie będzie
zamykane pomiędzy wywołaniami funkcji getnet*().
Funkcja endnetent() zamyka połączenie do bazy danych.
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 */
uint32_t n_net; /* numer sieci */
}
Polami struktury netent są:
n_name Oficjalna nazwa sieci.
n_aliases
Zakończona NULL-em 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
The getnetent(), getnetbyname(), and getnetbyaddr() functions return a pointer to a
statically allocated netent structure, or a null pointer if an error occurs or the end of
the file is reached.
PLIKI
/etc/networks
plik bazy danych z sieciami
ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku
attributes(7).
┌───────────────┬────────────────────────┬───────────────────────────┐
│Interfejs │ Atrybut │ Wartość │
├───────────────┼────────────────────────┼───────────────────────────┤
│getnetent() │ Bezpieczeństwo wątkowe │ MT-Unsafe race:netent │
│ │ │ race:netentbuf env locale │
├───────────────┼────────────────────────┼───────────────────────────┤
│getnetbyname() │ Bezpieczeństwo wątkowe │ MT-Unsafe race:netbyname │
│ │ │ env locale │
├───────────────┼────────────────────────┼───────────────────────────┤
│getnetbyaddr() │ Bezpieczeństwo wątkowe │ MT-Unsafe race:netbyaddr │
│ │ │ locale │
├───────────────┼────────────────────────┼───────────────────────────┤
│setnetent(), │ Bezpieczeństwo wątkowe │ MT-Unsafe race:netent env │
│endnetent() │ │ locale │
└───────────────┴────────────────────────┴───────────────────────────┘
W powyższej tabeli, netent w race:netent oznacza, że jeśli któraś z funkcji setnetent(),
getnetent() lub endnetent() jest używana równolegle w różnych wątkach programu, może
nastąpić sytuacja wyścigu danych.
ZGODNE Z
POSIX.1-2001, POSIX.1-2008, 4.3BSD.
UWAGI
W glibc aż do wersji 2.2 argument net funkcji getnetbyaddr() był typu long.
ZOBACZ TAKŻE
getnetent_r(3), getprotoent(3), getservent(3)
RFC 1101
O STRONIE
Angielska wersja tej strony pochodzi z wydania 5.10 projektu Linux man-pages. Opis
projektu, informacje dotyczące zgłaszania błędów oraz najnowszą wersję oryginału można
znaleźć pod adresem https://www.kernel.org/doc/man-pages/.
T◈UMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz
<ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach
<michal.kulach@gmail.com>
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji
można uzyskać zapoznając się z GNU General Public License w wersji 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ lub nowszej. Nie przyjmuje się ŻADNEJ
ODPOWIEDZIALNOŚCI.
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej
⟨manpages-pl-list@lists.sourceforge.net⟩.