OSDN Git Service

Update release for LDP 3.67
[linuxjm/LDP_man-pages.git] / release / man3 / gethostbyname.3
index df32163..0483e32 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH GETHOSTBYNAME 3 2010\-10\-04 "" "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 1998-2000 NAKANO Takeo all rights reserved.
+.\" Translated 1998-04-30, NAKANO Takeo <nakano@apm.seikei.ac.jp>
+.\" Modified 1998-12-06, NAKANO Takeo
+.\" Updated & Modified 1999-10-12, NAKANO Takeo
+.\" Updated & Modified 2001-07-01, Yuichi SATO <ysato@h4.dion.ne.jp>
+.\" Updated & Modified 2002-01-03, Yuichi SATO
+.\" Updated & Modified 2003-11-27, Yuichi SATO <ysato444@yahoo.co.jp>
+.\" Updated & Modified 2005-01-10, Yuichi SATO
+.\" Updated 2006-01-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated 2007-06-11, Akihiro MOTOKI, LDP v2.54
+.\" Updated 2008-08-08, Akihiro MOTOKI, LDP v3.05
+.\"
+.TH GETHOSTBYNAME 3 2014\-03\-11 "" "Linux Programmer's Manual"
 .SH 名前
 gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent, h_errno,
 herror, hstrerror, gethostbyaddr_r, gethostbyname2, gethostbyname2_r,
@@ -103,16 +118,28 @@ _BSD_SOURCE || _SVID_SOURCE
 .RS 4
 .TP  4
 glibc 2.8 以降:
-_BSD_SOURCE || _SVID_SOURCE || _GNU_SOURCE
+_BSD_SOURCE || _SVID_SOURCE
 .TP 
 glibc 2.8 より前:
 なし
 .RE
+
+\fBh_errno\fP:
+.RS 4
+.TP  4
+glibc 2.12 以降:
+_BSD_SOURCE || _SVID_SOURCE ||
+    (_POSIX_C_SOURCE < 200809L && _XOPEN_SOURCE < 700)
+.TP 
+glibc 2.12 より前:
+なし
+.RE
 .ad b
 .PD
 .SH 説明
-\fBgethostbyname*\fP()  と \fBgethostbyaddr*\fP()  は過去のものである。 アプリケーションでは、代わりに
-\fBgetaddrinfo\fP(3)  と \fBgetnameinfo\fP(3)  を使用すること。
+関数 \fBgethostbyname*\fP(), \fBgethostbyaddr*\fP(), \fBherror\fP(), \fBhstrerror\fP
+は過去のものである。 アプリケーションは、代わりに \fBgetaddrinfo\fP(3), \fBgetnameinfo\fP(3),
+\fBgai_strerror\fP(3) を使用すること。
 
 \fBgethostbyname\fP()  関数は与えられたホスト名 \fIname\fP に対応する構造体 \fIhostent\fP を返す。 \fIname\fP
 にはホスト名、ドット区切りの IPv4 アドレス (\fBinet_addr\fP(3)  参照)、コロン区切りの IPv6 アドレス
@@ -170,7 +197,7 @@ struct hostent {
 ホストの正式名 (official name)。
 .TP 
 \fIh_aliases\fP
-ホストの別名の配列。配列は NULL ポインタで終端される。
+ホストの別名の配列。配列はヌルポインタで終端される。
 .TP 
 \fIh_addrtype\fP
 アドレスのタイプ。現在はすべて \fBAF_INET\fP または \fBAF_INET6\fP である。
@@ -179,13 +206,13 @@ struct hostent {
 バイト単位で表したアドレスの長さ。
 .TP 
 \fIh_addr_list\fP
-ホストのネットワークアドレスへのポインタの配列。 配列は NULL ポインタで終端される。 ネットワークアドレスはネットワークバイトオーダ形式である。
+ホストのネットワークアドレスへのポインタの配列。 配列はヌルポインタで終端される。 ネットワークアドレスはネットワークバイトオーダ形式である。
 .TP 
 \fIh_addr\fP
 \fIh_addr_list\fP の最初のアドレス。過去との互換性を保つためのものである。
 .SH 返り値
-\fBgethostbyname\fP()  および \fBgethostbyaddr\fP()  関数は \fIhostent\fP 構造体を返す。エラーが起こったら
-NULL ポインタを返す。エラーの際には \fIh_errno\fP 変数がエラーの番号を保持する。 返り値が NULL
+\fBgethostbyname\fP()  および \fBgethostbyaddr\fP()  関数は \fIhostent\fP
+構造体を返す。エラーが起こったらヌルポインタを返す。エラーの際には \fIh_errno\fP 変数がエラーの番号を保持する。 返り値が NULL
 でない場合、静的データをポインタで指していることもある。 以下の「注意」を参照すること。
 .SH エラー
 \fIh_errno\fP 変数は以下の値を取りうる。
@@ -227,7 +254,7 @@ POSIX.1\-2001 では、 \fBgethostbyname\fP(), \fBgethostbyaddr\fP(), \fBsethost
 \fIsize_t\fP 型ではなく \fIint\fP 型でなければならない。 POSIX.1\-2001 ではこれを \fIsocklen_t\fP
 としているが、これは OK。)  \fBaccept\fP(2)  も参照。
 .LP
-\fBgethostbyaddr\fP()  の BSD のプロトタイプは、最初の引き数として \fIconst char *\fP を使う。
+\fBgethostbyaddr\fP()  の BSD のプロトタイプは、最初の引き数として \fIconst char\ *\fP を使う。
 .SS "System V/POSIX 拡張"
 .\" e.g., Linux, FreeBSD, UnixWare, HP-UX
 .\" e.g., FreeBSD, AIX
@@ -259,6 +286,6 @@ NULL になる。 これらの関数は、成功した場合 0 を返し、失
 \fBinet_pton\fP(3), \fBresolver\fP(3), \fBhosts\fP(5), \fBnsswitch.conf\fP(5),
 \fBhostname\fP(7), \fBnamed\fP(8)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。