GETDOMAINNAME(3)

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

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

解説
Getdomainname() は前に setdomainname() によって設定された、現在のプロセッサの標準ドメイン名を返します。パラメー タ namelen は name 配列のサイズを指定します。空間が十分にない場合を除いて、返される値は null で終わります。

Setdomainname() は name するホストマシンの、長さ namelen のドメイン名を設定します。この呼び出しはスーパユーザに限定されます。通 常はシステムを、ブートストラップする場合にだけ使用されます。

戻り値
呼び出しに成功した場合は値 0が返ります。呼び出しに失敗した場合は値 -1 が返り、グローバルな位置 errno にエラーコードが置かれます。

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

[EFAULT]
    name または namelen パラメータに与えたアドレスが無効です。

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

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

バグ
ドメイン名は、( <sys/param.h> による) MAXHOSTNAMELEN 長さのキャラクタ、現在 256 文字に限られています。

歴史
getdomainname() 関数の呼び出しは、 4.2BSD で最初に登場しました。