GETNETENT

Section: Linux Programmer's Manual (3)
Updated: 1993-05-15
Index JM Home Page roff page
 

名前

getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - ネットワークエントリを取得する  

書式

#include <netdb.h>

struct netent *getnetent(void);

struct netent *getnetbyname(const char *name);

struct netent *getnetbyaddr(long net, int type);

void setnetent(int stayopen);

void endnetent(void);
 

説明

getnetent() 関数はファイル /etc/networks から新しい行を読み込み、行をフィー ルドに分割した内容を収めた構造体 netent を返す。 /etc/networks は必要ならばオープンされる。

getnetbyname() 関数は ネットワーク名 name にマッチする行を /etc/networks から探し、その内容を収めた netent 構造体を返す。

getnetbyaddr() 関数はネットワーク番号 net (type 型) にマッチする行に対 応する netent 構造体を返す。

setnetent() 関数は /etc/networks ファイルをオープンして、ファイルポインタを 先頭に戻す。 stayopen が真 (1) ならば、 getnetbyname() や getnetbyaddr() などの呼び出しの間にファイルはクローズされない。

endnetent() 関数は /etc/networks をクローズする。

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

struct netent {
    char          *n_name;     /* official network name */
    char         **n_aliases;  /* alias list */
    int            n_addrtype; /* net address type */
    unsigned long  n_net;      /* network number */
}

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

n_name
ネットワークの正式名 (official name)。
n_aliases
ネットワークの別名からなる配列。 0 で終端する。
n_addrtype
ネットワーク番号の形式。現在は AF_INET のみ。
n_net
ホストのバイトオーダーで表したネットワーク番号。
 

返り値

getnetent(), getnetbyname(), getnetbyaddr() 関数は netent 構造体を返す。エラーが起こったり、ファイルの最後に達 した場合は NULL ポインタを返す。  

ファイル

/etc/networks
ネットワークデータベースファイル
 

準拠

4.3BSD, POSIX.1-2001.  

関連項目

getprotoent(3), getservent(3), networks(5)
RFC 1101


 

Index

名前
書式
説明
返り値
ファイル
準拠
関連項目

This document was created by man2html, using the manual pages.
Time: 04:31:43 GMT, November 19, 2007