GETSERVENT(3)

名前
getservent, getservbyname, getservbyport, setservent, endservent - サービスのエントリを取得する

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

説明
getservent() 関数はファイル /etc/services の次の行を一行 読み込み、フィールドに分割した内容を収めた構造体 servent を返す。 ファイル /etc/services は必要に応じてオープンされる。

getservbyname() 関数は、プロトコル proto を用いるサービス の名前 name にマッチする行を /etc/services から探し、その 行の内容を収めた servent 構造体を返す。

getservbyport() 関数は、プロトコル proto を用いるサービス のポート番号 port (ネットワークバイトオーダーで与える) にマッ チする行を /etc/services から探し、その行の内容を収めた protoent 構造体を返す。

setservent() 関数は /etc/services ファイルをオープンして、 ファイルポインタを先頭に移動する。 stayopen が真 (1) の場合には、 getservbyname() や getservbyport() 関数の呼び出しの間に ファイルはクローズされない。

endservent() 関数は /etc/services ファイルをクローズする。

servent 構造体は <netdb.h> で以下のように定義されている。

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

servent 構造体のメンバーは以下の通り。

s_name
    サービスの正式名 (official name)。

s_aliases
    サービスの別名のリスト。 0 で終端する。

s_port
    サービスのポート番号。ネットワークバイトオーダーで与えられる。

s_proto
    このサービスと共に用いるプロトコルの名前。

返り値
The getservent()、 getservbyname()、 getservbyport() 関数は servent 構造体を返す。エラーが起こったり、ファイルの最後 に達した場合は NULL ポインタを返す。

ファイル

/etc/services
    サービスのデータベースファイル

準拠
BSD 4.3

関連項目
getprotoent(3), getnetent(3), services(5)