GETDOMAINNAME(3)

名称
getdomainname, setdomainname - 現在のホストのドメイン名を取得/設定する

ライブラリ
libc

書式
<unistd.h> int getdomainname(char *name, int namelen) int setdomainname(const char *name, int namelen)

解説
getdomainname() は、以前 setdomainname() によって設定された現在のプロセッサの標準ドメイン名を返します。 パラメータ namelen は name 配列のサイズを指定します。 不十分な空間が渡されない限り、返される値はヌル文字で終了します。

setdomainname() は、 ホストマシンのドメイン名を長さ namelen の name に設定します。 この呼び出しはスーパユーザに限定されており、 通常はシステムを起動する時にだけ使用されます。

戻り値

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

[EFAULT]
    name または namelen パラメータで示されたアドレスが無効です。

[EPERM]
    呼び出し元がホスト名を設定しようとしましたが、 スーパユーザではありませんでした。

関連項目
gethostid(3), gethostname(3), sysctl(3)

バグ
ドメイン名は、( <sys/param.h> より) MAXHOSTNAMELEN に制限されており、これは現在 256 文字です。

歴史
getdomainname() 関数呼び出しは、 4.2BSD ではじめて登場しました。