sethostid サブルーチン

目的

現行ホストの固有 ID を設定します。

ライブラリー

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

構文

説明

sethostid サブルーチンにより、root ユーザー ID を持つ呼び出しプロセスは、現行ホストに新しい 32 ビット ID を設定することができます。 sethostid サブルーチンは、アプリケーション・プログラムがホスト ID をリセットできるようにします。

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

パラメーター

戻り値

正常終了すると、 sethostid サブルーチンは値 0 を戻します。

sethostid サブルーチンが失敗した場合、サブルーチン・ハンドラーは以下の機能を実行します。

• 呼び出したプログラムに-11を返す。
• 特定のエラーを示すエラー・コードを errno グローバル変数に移動します。 errno 変数の詳細については、「 Communications Programming Concepts」の「 Error Notification Object Class 」を参照してください。

エラー・コード

以下が真の場合、 sethostid サブルーチンは失敗します。