manページ  — GETHOSTNAME

gethostname, sethostname – 現在のホストの名前の取得 / 設定

ライブラリ 書式 解説 戻り値 エラー 関連項目 バグ 歴史

Standard C Library (libc, -lc)

#include <unistd.h>

int
gethostname(char *name, int namelen);

int
sethostname(const char *name, int namelen);

gethostname() は sethostname() によって前に設定された、現在のプロセッサの標準のホスト名を返します。パラメータ namelen は name 配列のサイズを指定します。 使用できる空間が不十分な場合を除いて、返される名前はヌルで終わります。

sethostname() は、長さ namelen の name という、ホストマシン名を設定します。 この呼び出しはスーパユーザに限定され、 通常はシステムのブートストラップ時にだけ実行されます。

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

これらの呼び出しによって、次のエラーが返る場合があります。

[EFAULT]
	name または namelen パラメータが、無効なアドレスを与えました。
[EPERM]
	呼び出し元がホスト名を設定しようとしましたが、 スーパユーザではありませんでした。

ホスト名の長さが MAXHOSTNAMELEN ( < sys/param.h > から取得) 文字に制限されてあり、 現在の設定は 256 文字です。 この文字には末尾の ヌル も含みます。

gethostname() 関数は、 BSD 4.2 ではじめて登場しました。