名称

gethostname, sethostname − 現ホストの名前を取り出す／セットする

形式

gethostname(name, namelen)
char ∗name;
int namelen;

sethostname(name, namelen)
char ∗name;
int namelen;

解説

gethostname は、 以前に sethostname によってセットされた、 現プロセッサの標準的なホスト名を 返します。 パラメータ namelen は、 name 配列のサイズを 指定します。 返される名前は、 与えられたスペースが不十分でない限り、 ナルで終了します。

sethostname は、 ホスト名が、 長さ namelen の name になるようにセットします。 このコールはスーパーユーザだけに許されていて、 通常は、 システムがブートストラップされるときにだけ使用されます。

リターン値

コールが成功した場合には、 値 0 が返されます。 コールが失敗した場合には、 値 −1 が返され、 エラーコードがグローバル変数 errno に入れられます。

エラー

これらのコールでは、 次のエラーが返されることがあります。

[EFAULT] name または namelen パラメタが無効なアドレスを 与えている。

[EPERM] 呼び出しユーザは、 ホスト名を セットしようとしたが、 スーパーユーザではなかった。

関連事項

gethostid(2)

バグ

ホスト名は、( <sys/param.h> 内の) MAXHOSTNAMELEN 文字 (現在のところ、64 バイト) までに制限されています。

NEWS-OSRelease 4.2.1R