名称

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

ライブラリ

Standard C Library (libc, -lc)

書式

#include < unistd.h>

int
getdomainname( char *name, int namelen);

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

解説

getdomainname() 関数は、以前に setdomainname() によって設定された、現在のホストのための標準 NIS ドメイン名を返します。 namelen 引数は、 name 配列のサイズを指定します。十分でない空間が提供されない限り、返された名前は、ヌル文字で終了します。

setdomainname() 関数は、ホストマシンの NIS ドメイン名を 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]

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

関連項目

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

歴史

getdomainname() 関数は、 4.2BSD で登場しました。

バグ

ドメイン名は、 ( < sys/param.h> の) MAXHOSTNAMELEN 文字に、現在 256、に制限されています。