スポンサーリンク

GETDOMAINNAME(3) FreeBSD ライブラリ関数マニュアル GETDOMAINNAME(3)

名称

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

ライブラリ

標準 C ライブラリ (libc, −lc)

書式

#include <unistd.h>

int

getdomainname(char *name, int namelen);

int

setdomainname(const char *name, int namelen);

解説

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

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

戻り値

成功して終了したときには値 0 を返します。そうでない場合、値 -1 が返され、 グローバル変数 errno が設定されてエラーを示します。

エラー

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

       [EFAULT]

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

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

関連項目

gethostid(3), gethostname(3), sysctl(3)

バグ

ドメイン名は、( ⟨

                        sys/param.h⟩ より) MAXHOSTNAMELEN に制限されており、これは現在 256 文字です。

歴史

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

FreeBSD 10.0 May 6, 1994 FreeBSD 10.0

スポンサーリンク