.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
-.\" Modified 1997-08-25 by Nicolas Lichtmaier <nick@debian.org>
+.\" Modified 1997-08-25 by Nicolás Lichtmaier <nick@debian.org>
.\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
.\" Modified 2008-11-27 by mtk
.\"
-.\" Japanese Version Copyright (c) 1997 SUTO, Mitsuaki
-.\" all rights reserved.
-.\" Translated 1997-06-27, SUTO, Mitsuaki <suto@av.crl.sony.co.jp>
-.\" Updated 2000-10-03, Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
-.\" Updated & Modified 2004-12-29, Yuichi SATO <ysato444@yahoo.co.jp>
-.\" Updated 2008-12-26, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.15
+.\"*******************************************************************
.\"
-.TH GETDOMAINNAME 2 2009-09-27 "Linux" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH GETDOMAINNAME 2 2009\-09\-27 Linux "Linux Programmer's Manual"
.SH 名前
getdomainname, setdomainname \- ドメイン名の取得・設定をする
.SH 書式
-.B #include <unistd.h>
+\fB#include <unistd.h>\fP
.sp
-.BI "int getdomainname(char *" name ", size_t " len );
+\fBint getdomainname(char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP
.br
-.BI "int setdomainname(const char *" name ", size_t " len );
+\fBint setdomainname(const char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
.ad l
-.BR getdomainname (),
-.BR setdomainname ():
+\fBgetdomainname\fP(), \fBsetdomainname\fP():
.RS 4
_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500)
.RE
.SH 説明
これらの関数は、ホストシステムのドメイン名を取得・変更するために使われる。
-.BR setdomainname ()
-は、ドメイン名を、文字配列
-.I name
-で指定された値に設定する。
-引き数
-.I len
-には、
-.I name
-のバイト数を指定する
-(そのため、
-.I name
-では文字列終端の NULL バイトは必要ない)。
+\fBsetdomainname\fP() は、ドメイン名を、文字配列 \fIname\fP で指定された値に設定する。 引き数 \fIlen\fP には、
+\fIname\fP のバイト数を指定する (そのため、 \fIname\fP では文字列終端の NULL バイトは必要ない)。
-.BR getdomainname ()
-は、NULL 終端されたドメイン名を、
-.I len
-バイトの長さの文字配列
-.I name
-に格納して返す。
-NULL 終端されたドメイン名が \fIlen\fP バイトより長い場合、
-.BR getdomainname ()
-は、(glibc では) 始めの \fIlen\fP バイトを返し、(libc では) エラーとなる。
+\fBgetdomainname\fP() は、NULL 終端されたドメイン名を、 \fIlen\fP バイトの長さの文字配列 \fIname\fP に格納して返す。
+NULL 終端されたドメイン名が \fIlen\fP バイトより長い場合、 \fBgetdomainname\fP() は、(glibc では) 始めの
+\fIlen\fP バイトを返し、(libc では) エラーとなる。
.SH 返り値
-成功した場合 0 が返る。失敗した場合 \-1 が返り、
-.I errno
-がエラーの内容に従って設定される。
+成功した場合は 0 が返される。エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。
.SH エラー
-.BR setdomainname ()
-は以下のエラーで失敗する可能性がある。
-.TP
-.B EFAULT
-.I name
-がユーザアドレス空間の外を指した。
-.TP
-.B EINVAL
-.I len
-が負であるか、長すぎる。
-.TP
-.B EPERM
-.BR setdomainname ()
-において、呼び出した人に特権がない
-(Linux では
-.B CAP_SYS_ADMIN
-ケーパビリティ (capability) がない)。
+\fBsetdomainname\fP() は以下のエラーで失敗する可能性がある。
+.TP
+\fBEFAULT\fP
+\fIname\fP がユーザアドレス空間の外を指した。
+.TP
+\fBEINVAL\fP
+\fIlen\fP が負であるか、長すぎる。
+.TP
+\fBEPERM\fP
+\fBsetdomainname\fP() において、呼び出した人に特権がない (Linux では \fBCAP_SYS_ADMIN\fP ケーパビリティ
+(capability) がない)。
.PP
-.BR getdomainname ()
-は以下のエラーで失敗する可能性がある。
-.TP
-.B EINVAL
-libc での
-.BR getdomainname ()
-において、
-.I name
-が NULL ポインタであるか、
-.I len
-バイトより長い。
+\fBgetdomainname\fP() は以下のエラーで失敗する可能性がある。
+.TP
+\fBEINVAL\fP
+libc での \fBgetdomainname\fP() において、 \fIname\fP が NULL ポインタであるか、 \fIlen\fP バイトより長い。
.SH 準拠
+.\" But they appear on most systems...
POSIX では、これら関数は定義されていない。
-.\" しかし、ほとんどのシステムにある...
.SH 注意
-Linux 1.0 以降では、ドメイン名の長さの上限は
-終端の NULL バイトを含めて 64 バイトである。
-もっと古いカーネルでは 8 バイトであった。
+Linux 1.0 以降では、ドメイン名の長さの上限は 終端の NULL バイトを含めて 64 バイトである。 もっと古いカーネルでは 8
+バイトであった。
-(x86 を含む) Linux のほとんどのアーキテクチャでは、
-.BR getdomainname ()
-というシステムコールは存在しない。
-その代わり、glibc で
-.BR getdomainname ()
-がライブラリ関数として実装されており、この関数は
-.BR uname (2)
-の呼び出しで返された
-.I domainname
-フィールドのコピーを返す。
+(x86 を含む) Linux のほとんどのアーキテクチャでは、 \fBgetdomainname\fP() というシステムコールは存在しない。
+その代わり、glibc で \fBgetdomainname\fP() がライブラリ関数として実装されており、この関数は \fBuname\fP(2)
+の呼び出しで返された \fIdomainname\fP フィールドのコピーを返す。
.SH 関連項目
-.BR gethostname (2),
-.BR sethostname (2),
-.BR uname (2)
+\fBgethostname\fP(2), \fBsethostname\fP(2), \fBuname\fP(2)
OSDN Git Service
