GETDOMAINNAME

Section: Linux Programmer's Manual (2)
Updated: 2007-07-26
Index JM Home Page roff page
 

名前

getdomainname, setdomainname - ドメイン名の取得・設定をする  

書式

#include <unistd.h>

int getdomainname(char *name, size_t len);
int setdomainname(const char *name, size_t len);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

getdomainame(), setdomainame(): _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)  

説明

これらの関数は、現在のプロセッサのドメイン名を取得・変更するために使われる。 NULL 終端されたドメイン名が len バイトより長い場合、 getdomainname() は、(glibc では) 始めの len バイトを、(libc では) エラーを返す。  

返り値

成功した場合 0 が返る。失敗した場合 -1 が返り、 errno がエラーの内容に従って設定される。  

エラー

EFAULT
setdomainname() において、 name がユーザアドレス空間の外を指した。
EINVAL
libc での getdomainname() において、 name が NULL ポインタであるか、 len バイトより長い。
EINVAL
setdomainname() において、 len が負であるか、長過ぎる。
EPERM
setdomainname() において、呼び出した人に特権がない (Linux では CAP_SYS_ADMIN ケーパビリティ (capability) がない)。
 

準拠

POSIX では、これら関数は定義されていない。  

関連項目

gethostname(2), sethostname(2), uname(2)


 

Index

名前
書式
説明
返り値
エラー
準拠
関連項目

This document was created by man2html, using the manual pages.
Time: 04:31:42 GMT, November 19, 2007