JMÉNO¶

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

SYNTAXE¶

#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Á HODNOTA¶

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

SOUBORY¶

/etc/services

databáze služeb

SPLŇUJE STANDARDY¶

4.3BSD, POSIX.1-2001

DALŠÍ INFORMACE¶

getprotoent(3), getnetent(3), getservent_r(3), services(5)

TIRÁŽ¶

Tato stránka je součástí projektu Linux man-pages. Popis projektu a informace o hlášení chyb najdete na http://www.kernel.org/doc/man-pages/.