getnetent(3)

NAZWA
getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - odczytuje wpis dotyczący sieci

BIBLIOTEKA
Standardowa biblioteka C (libc, -lc)

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
Funkcje getnetent(), getnetbyname() i getnetbyaddr() zwracają wskaźnik do statycznej struktury netent lub wskaźnik null, gdy wystąpi błąd lub napotkany zostanie koniec pliku.

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-niebezpieczne race:netent race:netentbuf env locale
getnetbyname() | Bezpieczeństwo wątkowe | MT-niebezpieczne race:netbyname env locale
getnetbyaddr() | Bezpieczeństwo wątkowe | MT-niebezpieczne race:netbyaddr locale
setnetent(), endnetent() | Bezpieczeństwo wątkowe | MT-niebezpieczne race:netent env 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.

STANDARDY
POSIX.1-2008.

HISTORIA
POSIX.1-2001, 4.3BSD.

Przed glibc 2.2, argument net funkcji getnetbyaddr() był typu long.

ZOBACZ TAKŻE
getnetent_r(3), getprotoent(3), getservent(3)
RFC 1101

TŁUMACZENIE
Tłumaczenie niniejszej strony podręcznika: 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.