setnetent サブルーチン

オンライン編集

目的

/etc/networks ファイルをオープンし、ファイル・マーカーを設定します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

#include <netdb.h>
void setnetent (StayOpen)
int StayOpen;

説明

setnetent サブルーチンはスレッド・セーフです。 ただし、戻り値は、後続の呼び出しによって上書きされる静的データを指します。 このデータは、後続の呼び出しで使用するために保管するためにコピーする必要があります。

setnetent サブルーチンは、 /etc/networks ファイルをオープンし、ファイルの先頭にファイル・マーカーを設定します。

setnetent サブルーチンを含むすべてのアプリケーションは、特定の値に設定された _BSD マクロを使用してコンパイルする必要があります。 許容値は 43 および 44 です。 さらに、すべてのソケット・アプリケーションに BSD libbsd.a ライブラリーを組み込む必要があります。

パラメーター

項目 説明
StayOpen /etc/networks ファイルをいつクローズするかを示すために使用される値が入っています。

値 0 を指定すると、 getnetent サブルーチンを呼び出すたびに、 /etc/networks ファイルがクローズされます。

ゼロ以外の値を指定すると、 /etc/networks ファイルは呼び出しのたびにオープンしたままになります。

戻り値

エラーが発生するか、ファイルの終わりに達すると、 setnetent サブルーチンは NULL ポインターを戻します。

ファイル

項目 説明
/etc/networks 正式なネットワーク名が入っています。