JMÉNO

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

KNIHOVNA

       Standardní knihovna C (libc, -lc)

POUŽITÍ

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

POPIS

       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:

       p_name Oficiální jméno protokolu.

       p_aliases
              Nulovým ukazatelem ukončený seznam přezdívek protokolu.

       p_proto
              Číslo protokolu.

NÁVRATOVÉ HODNOTY

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

SOUBORY

       /etc/protocols
              databáze protokolů

ATRIBUTY

       Vysvětlení pojmů použitých v této části viz attributes(7).
       ┌──────────────────────────────┬────────────────────┬───────────────────────────────────────────────────┐
       │ Rozhraní                     │ Atribut            │ Hodnota                                           │
       ├──────────────────────────────┼────────────────────┼───────────────────────────────────────────────────┤
       │ getprotoent()                │ Zabezpečení vláken │ MT-Unsafe race:protoent race:protoentbuf locale   │
       ├──────────────────────────────┼────────────────────┼───────────────────────────────────────────────────┤
       │ getprotobyname()             │ Zabezpečení vláken │ MT-Unsafe race:protobyname locale                 │
       ├──────────────────────────────┼────────────────────┼───────────────────────────────────────────────────┤
       │ getprotobynumber()           │ Zabezpečení vláken │ MT-Unsafe race:protobynumber locale               │
       ├──────────────────────────────┼────────────────────┼───────────────────────────────────────────────────┤
       │ setprotoent(), endprotoent() │ Zabezpečení vláken │ 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.

STANDARDY

       POSIX.1-2008.

HISTORIE

       POSIX.1-2001, 4.3BSD.

DALŠÍ INFORMACE

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

PŘEKLAD

       Překlad této příručky do češ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.

Linux man-pages 6.9.1                            2. května 2024                                   getprotoent(3)