manページ  — GETDOMAINNAME

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

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

Standard C Library (libc, -lc)

#include <unistd.h>

int
getdomainname(char *name, int namelen);

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

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

setdomainname() は、 ホストマシンのドメイン名を長さ 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]
	呼び出し元がホスト名を設定しようとしましたが、 スーパユーザではありませんでした。

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

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