GETDOMAINNAME

名前

書式

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

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

getdomainname(), setdomainname():

    glibc 2.21 以降:
        _DEFAULT_SOURCE
    glibc 2.19 と 2.20:
        _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
    glibc 2.19 以前:
        _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

説明

setdomainname() は、ドメイン名を、文字配列 name で指定された値に設定する。 引数 len には、 name のバイト数を指定する (そのため、 name では文字列終端のヌルバイトは必要ない)。

getdomainname() は、NULL 終端されたドメイン名を、 len バイトの長さの文字配列 name に格納して返す。ヌル終端されたドメイン名が len バイトより長い場合、 getdomainname() は、(glibc では) 始めの len バイトを返し、(libc では) エラーとなる。  

返り値

エラー

EFAULT

name がユーザーアドレス空間の外を指した。

EINVAL

len が負であるか、長すぎる。

EPERM

The caller did not have the CAP_SYS_ADMIN capability in the user namespace associated with its UTS namespace (see namespaces(7)).

getdomainname() は以下のエラーで失敗する可能性がある。

EINVAL

libc での getdomainname() において、 name が NULL であるか、 len バイトより長い。

準拠

注意

(x86 を含む) Linux のほとんどのアーキテクチャーでは、 getdomainname() というシステムコールは存在しない。 その代わり、glibc で getdomainname() がライブラリ関数として実装されており、この関数は uname(2) の呼び出しで返された domainname フィールドのコピーを返す。  

関連項目

この文書について

関連キーワード

Linux マニュアル 一覧

[man1] [man2] [man3] [man4] [man5] [man6] [man7] [man8]
[a] [b] [c] [d] [e] [f] [g] [h] [i] [j] [k] [l] [m] [n] [o] [p] [q] [r] [s] [t] [u] [v] [w] [x] [y] [z]

Index

名前

書式

説明

返り値

エラー

準拠

注意

関連項目

この文書について