getprotoent(3) Library Functions Manual getprotoent(3)

getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent - funkce pro práci s databází protokolů

Standardní knihovna C (libc, -lc)

#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);

Funkce getprotoent() přečte další záznam z databáze protokolů (viz protocols(5)) a vrátí strukturu protoent, která obsahuje jednotlivá pole. Připojení k databázi je otevřeno, je-li potřeba.

Funkce getprotobyname() vrací strukturu protoent ze databáze pro řádek, který vyhovuje jménu name. Připojení k databázi je otevřeno, je-li potřeba.

Funkce getprotobynumber() vrací strukturu protoent z databáze pro řádek, který vyhovuje protokolovému číslu number. Připojení k databázi je otevřeno, je-li potřeba.

The setprotoent() function opens a connection to the database, and sets the next entry to the first entry. If stayopen is nonzero, then the connection to the database will not be closed between calls to one of the getproto*() functions.

Funkce endprotoent() uzavírá spojení s databází.

Struktura protoent je definována v <netdb.h> následovně:


struct protoent {
    char  *p_name;       /* official protocol name */
    char **p_aliases;    /* alias list */
    int    p_proto;      /* protocol number */
}

Prvky struktury protoent jsou:

Oficiální jméno protokolu.
Nulovým ukazatelem ukončený seznam přezdívek protokolu.
Číslo protokolu.

Funkce getprotoent(), getprotobyname() a getprotobynumber() vrací strukturu protoent structure, nebo NULL, jestliže došlo k chybě nebo byl dosažen konec souboru.

/etc/protocols
databáze protokolů

Vysvětlení pojmů použitých v této části viz attributes(7).

Rozhraní Atribut Hodnota
getprotoent() Thread safety MT-Unsafe race:protoent race:protoentbuf locale
getprotobyname() Thread safety MT-Unsafe race:protobyname locale
getprotobynumber() Thread safety MT-Unsafe race:protobynumber locale
setprotoent(), endprotoent() Thread safety MT-Unsafe race:protoent locale

In the above table, protoent in race:protoent signifies that if any of the functions setprotoent(), getprotoent(), or endprotoent() are used in parallel in different threads of a program, then data races could occur.

POSIX.1-2008.

POSIX.1-2001, 4.3BSD.

getnetent(3), getprotoent_r(3), getservent(3), protocols(5)

Překlad této příručky do španělštiny vytvořili Pavel Heimlich <tropikhajma@gmail.com>

Tento překlad je bezplatná dokumentace; Přečtěte si GNU General Public License Version 3 nebo novější ohledně podmínek autorských práv. Neexistuje ŽÁDNÁ ODPOVĚDNOST.

Pokud narazíte na nějaké chyby v překladu této příručky, pošlete e-mail na adresu translation-team-cs@lists.sourceforge.net.

31. října 2023 Linux man-pages 6.06