setdomainname サブルーチン

目的

現行ドメインの名前を設定します。

ライブラリー

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

構文

説明

setdomainname サブルーチンは、ホスト・マシンのドメインの名前を設定します。 これは通常、システムがブートストラップされるときに使用されます。 このサブルーチンを実行するには、root ユーザー権限が必要です。

ドメインの目的は、共通のホスト名を持つ 2 つの異なるネットワークをマージできるようにすることです。 各ネットワークは、異なるドメイン・ネームを持つことによって区別されます。 現時点では、Network Information Service (NIS) のみが、このサブルーチンによって設定されたドメインを使用します。

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

パラメーター

戻り値

呼び出しが成功すると、値 0 が戻されます。 呼び出しに失敗した場合、値-1が返され、エラーコードがerrnoグローバル変数に格納される。

エラー・コード

このサブルーチンによって次のエラーが戻されることがあります。