getnetent(3) Library Functions Manual getnetent(3) NAZWA getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - odczytanie wpisu dotyczacego 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-Unsafe race:netent | | | | race:netentbuf env locale | +---------------+--------------------------+---------------------------+ |getnetbyname() | Bezpieczenstwo watkowe | MT-Unsafe race:netbyname | | | | env locale | +---------------+--------------------------+---------------------------+ |getnetbyaddr() | Bezpieczenstwo watkowe | MT-Unsafe race:netbyaddr | | | | locale | +---------------+--------------------------+---------------------------+ |setnetent(), | Bezpieczenstwo watkowe | MT-Unsafe race:netent env | |endnetent() | | 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. Before glibc 2.2, the net argument of getnetbyaddr() was of type 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.06 31 pazdziernika 2023 r. getnetent(3)