Provided by: manpages-pl-dev_0.7-1_all 
NAZWA
getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent - odczytanie wpisu
dotyczącego protokołu
SKŁADNIA
#include <netdb.h>
struct protoent *getprotoent(void);
struct protoent *getprotobyname(const char *name);
struct protoent *getprotobynumber(int proto);
void setprotoent(int stayopen);
void endprotoent(void);
OPIS
Funkcja getprotoent() odczytuje następny wpis z bazy danych protokołów (patrz
protocols(5)) i zwraca strukturę protoent 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 getprotobyname() zwraca strukturę protoent zawierającą ten wpis z bazy danych,
który odpowiada protokołowi name. Połączenie do bazy danych jest otwierane, jeśli jest to
potrzebne.
Funkcja getprotobynumber() zwraca strukturę protoent zawierającą ten wpis z bazy danych,
który odpowiada protokołowi number. Połączenie do bazy danych jest otwierane, jeśli jest
to potrzebne.
Funkcja setprotoent() 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 getproto*().
Funkcja endprotoent() zamyka połączenie do bazy danych.
Struktura protoent jest zdefiniowana w <netdb.h> następująco:
struct protoent {
char *p_name; /* oficjalna nazwa protokołu */
char **p_aliases; /* lista aliasów */
int p_proto; /* numer protokołu */
}
Polami struktury protoent są:
p_name Oficjalna nazwa protokołu.
p_aliases
Zakończona NULL-em lista alternatywnych nazw tego protokołu.
p_proto
Numer protokołu.
WARTOŚĆ ZWRACANA
Funkcje getprotoent(), getprotobyname() i getprotobynumber() zwracają wskaźnik do
statycznej struktury servent lub wskaźnik NULL, gdy wystąpi błąd lub napotkany zostanie
koniec pliku.
PLIKI
/etc/protocols
plik bazy danych dla protokołów
ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku
attributes(7).
┌───────────────────┬────────────────────────┬──────────────────────────────┐
│Interfejs │ Atrybut │ Wartość │
├───────────────────┼────────────────────────┼──────────────────────────────┤
│getprotoent() │ Bezpieczeństwo wątkowe │ MT-Unsafe race:protoent │
│ │ │ race:protoentbuf locale │
├───────────────────┼────────────────────────┼──────────────────────────────┤
│getprotobyname() │ Bezpieczeństwo wątkowe │ MT-Unsafe race:protobyname │
│ │ │ locale │
├───────────────────┼────────────────────────┼──────────────────────────────┤
│getprotobynumber() │ Bezpieczeństwo wątkowe │ MT-Unsafe race:protobynumber │
│ │ │ locale │
├───────────────────┼────────────────────────┼──────────────────────────────┤
│setprotoent(), │ Bezpieczeństwo wątkowe │ MT-Unsafe race:protoent │
│endprotoent() │ │ locale │
└───────────────────┴────────────────────────┴──────────────────────────────┘
W powyższej tabeli, protoent w race:protoent oznacza, że jeśli któraś z funkcji
setprotoent(3), getprotoent(3) lub endprotoent(3) 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.
ZOBACZ TAKŻE
getnetent(3), getprotoent_r(3), getservent(3), protocols(5)
O STRONIE
Angielska wersja tej strony pochodzi z wydania 4.07 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 man są: Andrzej
Krzysztofowicz (PTM) <ankry@mif.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał
Kułach <michal.kulach@gmail.com>.
Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na
stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją 4.07
oryginału.