getnetent(3) Library Functions Manual getnetent(3) NAZWA getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - odczytuje wpis dotyczacy sieci BIBLIOTEKA Standardowa biblioteka C (libc, -lc) SKLADNIA #include 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 nastepny wpis z bazy danych sieci i zwraca strukture netent zawierajaca pola powstale z rozlozenia pol wpisu. Polaczenie do bazy danych jest otwierane, jesli jest to potrzebne. Funkcja getnetbyname() zwraca strukture netent zawierajaca ten wpis z bazy danych, ktory odpowiada sieci name. Funkcja getnetbyaddr() zwraca strukture netent zawierajaca ten wpis z bazy danych, ktory odpowiada sieci o numerze net rodzaju type. Argument net musi byc w porzadku bajtow lokalnego komputera (host byte order). Funkcja setnetent() otwiera polaczenie do bazy danych i ustawia wskaznik kolejnego wpisu na pierwszy wpis. Jesli stayopen jest niezerowy, to polaczenie do bazy danych nie bedzie zamykane pomiedzy wywolaniami funkcji getnet*(). Funkcja endnetent() zamyka polaczenie do bazy danych. Struktura netent jest zdefiniowana w nastepujaco: struct netent { char *n_name; /* oficjalna nazwa sieci */ char **n_aliases; /* lista aliasow */ int n_addrtype; /* rodzaj adresu sieci */ uint32_t n_net; /* numer sieci */ } Polami struktury netent sa: n_name Oficjalna nazwa sieci. n_aliases Zakonczona NULL-em lista alternatywnych nazw tej sieci. n_addrtype Rodzaj numeru sieci; zawsze AF_INET. n_net Numer sieci w porzadku bajtow hosta. WARTOSC ZWRACANA Funkcje getnetent(), getnetbyname() i getnetbyaddr() zwracaja wskaznik do statycznej struktury netent lub wskaznik null, gdy wystapi blad lub napotkany zostanie koniec pliku. PLIKI /etc/networks plik bazy danych z sieciami ATRYBUTY Informacje o pojeciach uzywanych w tym rozdziale mozna znalezc w podreczniku attributes(7). +---------------+--------------------------+---------------------------+ |Interfejs | Atrybut | Wartosc | +---------------+--------------------------+---------------------------+ |getnetent() | Bezpieczenstwo watkowe | MT-niebezpieczne | | | | race:netent | | | | race:netentbuf env locale | +---------------+--------------------------+---------------------------+ |getnetbyname() | Bezpieczenstwo watkowe | MT-niebezpieczne | | | | race:netbyname env locale | +---------------+--------------------------+---------------------------+ |getnetbyaddr() | Bezpieczenstwo watkowe | MT-niebezpieczne | | | | race:netbyaddr locale | +---------------+--------------------------+---------------------------+ |setnetent(), | Bezpieczenstwo watkowe | MT-niebezpieczne | |endnetent() | | race:netent env locale | +---------------+--------------------------+---------------------------+ W powyzszej tabeli, netent w race:netent oznacza, ze jesli ktoras z funkcji setnetent(), getnetent() lub endnetent() jest uzywana rownolegle w roznych watkach programu, moze nastapic sytuacja wyscigu danych. STANDARDY POSIX.1-2008. HISTORIA POSIX.1-2001, 4.3BSD. Przed glibc 2.2, argument net funkcji getnetbyaddr() byl typu long. ZOBACZ TAKZE getnetent_r(3), getprotoent(3), getservent(3) RFC 1101 TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Andrzej Krzysztofowicz , Robert Luberda i Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . Linux man-pages 6.12 23 lipca 2024 r. getnetent(3)