getservent(3)

JMÉNO
getservent, getservbyname, getservbyport, setservent, endservent - funkce pro práci s databází služeb

KNIHOVNA
Standardní knihovna C (libc, -lc)

POUŽITÍ
#include <netdb.h>

struct servent *getservent(void);

struct servent *getservbyname(const char *name, const char *proto);
struct servent *getservbyport(int port, const char *proto);

void setservent(int stayopen);
void endservent(void);

POPIS
Funkce getservent() čte další řádek z databáze (vis services(5)) a vrací strukturu servent obsahující pole tohoto záznamu. Spojení s databází je otevřeno, je-li třeba.

Funkce getservbyname() vrací strukturu serventz databáze, která vyhovuje službě name používající protokol proto. Pokud je proto NULL, lze přířadit libovolný protokol. Spojení s databází je otevřeno, je-li třeba.

Funkce getservbyport() vrací ukazatel na strukturu servent pro záznam, který vyhovuje portu port zadanému v síťovém pořadí bajtů a protokolu proto. Pokud je proto NULL, lze přířadit libovolný protokol. Spojení s databází je otevřeno, je-li třeba.

Funkce setservent() otevře databázi a nastaví ukazovátko na jeho začátek. Je-li stayopen nenulové (1), potom soubor nebude mezi voláními getservbyname() a getservbyport() uzavřen.

Funkce endservent() uzavře databázi.

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

    struct servent {
        char  *s_name;       /* official service name */
        char **s_aliases;    /* alias list */
        int    s_port;       /* port number */
        char  *s_proto;      /* protocol to use */
    }

Prvky struktury servent jsou:

s_name
    Oficiální jméno služby.

s_aliases
    Nulou ukončený seznam aliasů pro službu.

s_port
    Číslo portu pro tuto službu. Je reprezentováno v síťovém pořadí bajtů.

s_proto
    Jméno protokolu spojeného s touto službou.

NÁVRATOVÉ HODNOTY
Funkce getservent(), getservbyname() a getservbyport() vrací strukturu servent, nebo NULL, nastala-li chyba nebo konec souboru.

SOUBORY

/etc/services
    databáze služeb

ATRIBUTY
Vysvětlení pojmů použitých v této části viz attributes(7).
Rozhraní | Atribut | Hodnota
getservent() | Zabezpečení vláken | MT-Unsafe race:servent race:serventbuf locale
getservbyname() | Zabezpečení vláken | MT-Unsafe race:servbyname locale
getservbyport() | Zabezpečení vláken | MT-Unsafe race:servbyport locale
setservent(), endservent() | Zabezpečení vláken | MT-Unsafe race:servent locale

In the above table, servent in race:servent signifies that if any of the functions setservent(), getservent(), or endservent() 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(3), getservent_r(3), services(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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.