日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
GETNETCONFIG(3) FreeBSD ライブラリ関数マニュアル GETNETCONFIG(3)
名称
getnetconfig, setnetconfig, endnetconfig, getnetconfigent,
freenetconfigent, nc_perror, nc_sperror -- ネットワーク設定データベースエ
ントリを取得する
ライブラリ
標準 C ライブラリ (libc, -lc)
書式
#include <netconfig.h>
struct netconfig *
getnetconfig(void *handlep);
void *
setnetconfig(void);
int
endnetconfig(void *handlep);
struct netconfig *
getnetconfigent(const char *netid);
void
freenetconfigent(struct netconfig *netconfigp);
void
nc_perror(const char *msg);
char *
nc_sperror(void);
解説
このページで説明されるライブラリルーチンは、システムネットワーク設定デー
タベース、/etc/netconfig へのアクセスをアプリケーションに提供します。
getnetconfig() 関数は、struct netconfig として書式化された netconfig デー
タベースの現在のエントリへのポインタを返します。連続した呼び出しは、net
config データベースの連続した netconfig エントリを返します。
getnetconfig() 関数は、netconfig ファイル全体を検索するために使用すること
ができます。getnetconfig() 関数は、ファイルの終りで NULL を返します。
handlep 引数は、setnetconfig() を通して取得されたハンドルです。
setnetconfig() への呼び出しには、netconfig データベースを ``バインド'' す
るか、``巻き戻す'' という効果があります。setnetconfig() 関数は、
getnetconfig() への最初の呼び出しの前に呼び出されなければなりません、そし
て他の時ならいつでも呼び出されます。setnetconfig() 関数は、
getnetconfigent() への呼び出しの前に呼び出される必要はありません。
setnetconfig() 関数は、getnetconfig() によって使用されるユニークなハンド
ルを返します。
endnetconfig() 関数は、プロセスが完了するとき、再利用のためのリソースを解
放するために呼び出されるべきです。handlep 引数は、setnetconfig() を通して
取得されたハンドルです。しかしながら、プログラマは、struct netconfig デー
タ構造のために getnetconfig() によって割り付けてられたすべてのメモリを解
放する endnetconfig() への最後の呼び出しを承知しているべきです。
endnetconfig() 関数は、setnetconfig() の前に呼び出されないかもしれませ
ん。
getnetconfigent() 関数は、netid に対応する netconfig 構造体へのポインタを
返します。netid が無効であるなら (すなわち、netconfig データベースのエン
トリの名前がなければ)、NULL を返します。
freenetconfigent() 関数は、(以前に getnetconfigent() によって返された)
netconfigp によって指された netconfig 構造体を解放します。
nc_perror() 関数は、上記のルーチンのどれかがなぜ失敗したかを示すメッセー
ジを標準エラーに印刷 (表示) します。メッセージは、文字列 msg とコロンが先
頭に追加されます。メッセージの終わりに改行文字を追加します。
nc_sperror() 関数は、nc_perror() と同様ですが、メッセージを標準エラーに送
る代わりに、エラーメッセージを含む文字列へのポインタ返します。
また、nc_perror() と nc_sperror() 関数は、getnetpath(3) で定義される
NETPATH アクセスルーチンと共に使用することができます。
戻り値
setnetconfig() 関数は、getnetconfig() によって使用されるユニークなハンド
ルを返します。エラーの場合に setnetconfig() は、NULL を返し、nc_perror()
または nc_sperror() は、失敗の理由を印刷 (表示) するために使用することが
できます。
getnetconfig() 関数は、struct netconfig として書式化された netconfig デー
タベースの現在のエントリへのポインタを返します。getnetconfig() 関数は、
ファイルの終り、または、失敗の場合 NULL を返します。
endnetconfig() 関数は、成功すれば 0 を返し、失敗すれば (例えば、
setnetconfig() が以前に呼び出されなかったなら) -1 を返します。
成功すれば、getnetconfigent() は、netid に対応する struct netconfig 構造
体へのポインタを返します。そうでなければ、NULL を返します。
nc_sperror() 関数は、エラーメッセージ文字列を含むバッファへのポインタを返
します。このバッファは、それぞれの呼び出しのときに上書きされます。マルチ
スレッド化されたアプリケーションでは、このバッファは、スレッド特有のデー
タとして実装されます。
関連ファイル
/etc/netconfig
関連項目
getnetpath(3), netconfig(5)
FreeBSD 11.4 April 22, 2000 FreeBSD 11.4