Man page - setdomainname(2)

Packages contains this manual

Available languages:

en fr pt_BR es pl ja ru ro de

Manual

GETDOMAINNAME

名 前
書 式
説 明
返 り 値
エ ラ ー
準 拠
注 意
関 連 項 目
こ の 文 書 に つ い て

名 前

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

書 式

#include <unistd.h>

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)

説 明

These functions are used to access or to change the NIS domain name of the host system. More precisely, they operate on the NIS domain name associated with the calling process’s UTS namespace.

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

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

返 り 値

成 功 し た 場 合 は 0 が 返 さ れ る 。 エ ラ ー の 場 合 は -1 が 返 さ れ 、 errno が 適 切 に 設 定 さ れ る 。

エ ラ ー

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

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 バ イ ト よ り 長 い 。

準 拠

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

注 意

Linux 1.0 以 降 で は 、 ド メ イ ン 名 の 長 さ の 上 限 は 終 端 の ヌ ル バ イ ト を 含 め て 64 バ イ ト で あ る 。 も っ と 古 い カ ー ネ ル で は 8 バ イ ト で あ っ た 。

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

関 連 項 目

gethostname (2), sethostname (2), uname (2), uts_namespaces (7)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。