.\" Copyright 2000 Sam Varshavchik <mrsam@courier-mta.com>
.\"
.\" 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.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" References: RFC 2553
.\"
.\" Japanese Version Copyright (c) 2001 NAKANO Takeo all rights reserved.
.\" Translated Sun Jan 14 2001 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated Tue Nov 26 2002 by Kentaro Shirakata <argrath@ub32.org>
.\"
.\"WORD:	null pointer	̥롦ݥ󥿡
.\"
.TH GETIPNODEBYNAME 3 2007-11-15 "Linux" "Linux Programmer's Manual"
.SH ̾
getipnodebyname, getipnodebyaddr, freehostent \- ͥåȥۥȤ̾ȥɥ쥹μ
.SH 
.nf
.B #include <sys/types.h>
.B #include <sys/socket.h>
.B #include <netdb.h>
.sp
.BI "struct hostent *getipnodebyname(const char *" name ", int " af ,
.BI "                                int " flags ", int *" error_num );
.sp
.BI "struct hostent *getipnodebyaddr(const void *" addr ", size_t " len ,
.BI "                                int " af ", int *" "error_num" );
.sp
.BI "void freehostent(struct hostent *" "ip" );
.fi
.SH 
δؿ侩Ǥ (glibc ǤѤǤʤ)

.BR getaddrinfo (3)

.BR getnameinfo (3)
Ȥȡ
.LP
.BR getipnodebyname ()

.BR getipnodebyaddr ()
ϡͥåȥۥȤ̾ȥɥ쥹֤
δؿϡʲι¤ΤؤΥݥ󥿤֤
.sp
.in +4n
.nf
struct  hostent {
    char  *h_name;
    char **h_aliases;
    int    h_addrtype;
    int    h_length;
    char **h_addr_list;
};
.fi
.in
.PP
δؿϡ IPv4 ͥåȥɥ쥹եߥˤǤʤ
.BR gethostbyname (3)

.BR gethostbyaddr (3)
֤ΤǤ롣
.BR getipnodebyname ()
ؿ
.BR getipnodebyaddr ()
ؿʣΥͥåȥɥ쥹եߥ꡼˥ǽˤʤäƤ롣
.PP
δؿϡ
.B gethostby
δؿȰۤʤꡢưŪ˳Ƥ줿ؤΥݥ󥿤֤
ƤӽФ
.I hostent
¤ΤɬפȤʤʤäϡ
.BR freehostent ()
ؿѤưŪʳƥǤ롣
.SS getipnodebyname() ΰ
.BR getipnodebyname ()
ؿ
.I name
ǻꤵ줿ۥȤΥͥåȥɥ쥹
.I af
ˤϰʲͤΤ줫ꤹ롣
.TP
.B AF_INET
.I name
ϡɥåȤ 4 Ĥ˶ڤ줿 IPv4 ɥ쥹
IPv4 ͥåȥۥȤ̾ؤΥݥ󥿤Ǥ롣
.TP
.B AF_INET6
.I name
ϡ16 ʤ IPv6 ɥ쥹
IPv6 ͥåȥۥȤ̾ؤΥݥ󥿤Ǥ롣
.PP
.I flags
ѥ᡼ˤɲäΥץꤹ롣
ʣΥե饰ꤹˤϡ OR ȤäƻꤹФ褤
ץҤȤĤꤷʤȤˤϡ
.I flags
 0 ꤹɬפ롣
.TP
.B AI_V4MAPPED
Υե饰
.B AF_INET6
ȶѤ졢IPv6 ɥ쥹 IPv4 ɥ쥹䤤碌롣
䤤碌 IPv4 ɥ쥹 IPv6 ɥ쥹˥ޥåפ롣
.TP
.B AI_ALL
Υե饰
.B AI_V4MAPPED
ȶѤ졢IPv4 ɥ쥹 IPv6 ɥ쥹ξ䤤碌롣
Ĥä IPv4 ɥ쥹ϡ٤ IPv6 ɥ쥹˥ޥåפ롣
.TP
.B AI_ADDRCONFIG
Υե饰
.B AF_INET6
ȶѤ졢
IPv6 Ƥ줿ͥåȥ󥿡ե
ƥˤҤȤĤʤ IPv6 ɥ쥹䤤碌Ԥ鷺
IPv4 Ƥ줿ͥåȥ󥿡ե
ƥˤҤȤĤʤ IPv4 ɥ쥹䤤碌Ԥʤ褦׵᤹롣
Υե饰ñȤǤ⡢뤤
.B AI_V4MAPPED
ե饰ȶˤǤѤ뤳ȤǤ롣
.TP
.B AI_DEFAULT
Υե饰
.BR (AI_ADDRCONFIG | AI_V4MAPPED)
Ǥ롣
.SS "getipnodebyaddr() ΰ"
.BR getipnodebyaddr ()
ؿϡͥåȥɥ쥹
.I addr
ǻꤵ줿ۥȤ̾
.I af
ˤϰʲͤΤ줫ꤹ롣
.TP
.B AF_INET
.I addr

.I struct in_addr
ؤΥݥ󥿡Ǥꡢ
.I len

.I sizeof(struct in_addr)
ꤷʤФʤʤ
.TP
.B AF_INET6
.I addr

.I struct in6_addr
ؤΥݥ󥿡Ǥꡢ
.I len

.I sizeof(struct in6_addr)
ꤷʤФʤʤ
.SH ֤
顼ȥ̥롦ݥ󥿡֤졢
.I error_num
˰ʲ˥ꥹȤ줿顼ɤΤ줫ꤵ롣
.TP
.B HOST_NOT_FOUND
ۥ̾ޤϥͥåȥɥ쥹Ĥʤä
.TP
.B NO_ADDRESS
ɥᥤ͡ॵС
Υͥåȥɥ쥹ޤϥͥåȥ̾ǧ
ֻ֤äƤʤäȤƤϡ
㤨 IPv4 ɥ쥹ʤͥåȥۥȤФ
IPv6 ξ䤤碌Ԥ줿 (Ӥε) ʤɤͤ롣
.TP
.B NO_RECOVERY
ɥᥤ͡ॵС鹱Ūʼ (permanent failure)
ֻ̣֤줿
.TP
.B TRY_AGAIN
͡ॵСŪʼ (temporary failure)
ֻ̣֤줿ˤϤ⤦äȱɬפ⡣
.PP
䤤碌ȡ
.I hostent
¤ΤؤΥݥ󥿤֤롣
ι¤ΤϰʲΥեɤʤ롣
.TP
.I h_name
ϤΥͥåȥۥȤΥե̾Ǥ롣
.TP
.I h_aliases
ϡΥۥȤΥեǤʤ̾ؤΥݥ󥿡Ǥ롣
ϥ̥롦ݥ󥿡ǽü롣
.TP
.I h_addrtype

.BR getipnodebyname ()
ޤ
.BR getipnodebyaddr ()
Ϳ줿
.I af
ΥԡǤ롣
.I af

.B AF_INET
ʤ
.I h_addrtype
Ͼ
.B AF_INET
ˤʤꡢ
.I af

.B AF_INET6
ʤ
.I h_addrtype

.B AF_INET6
ˤʤ롣
.TP
.I h_length
Υեɤϡ
.I h_addrtype

.B AF_INET
ʤ
.I sizeof(struct in_addr)
ˡ
.I h_addrtype

.B AF_INET6
ʤ
.I sizeof(struct in6_addr)
ꤵ롣
.TP
.I h_addr_list
ϤҤȤİʾΥݥ󥿡ǡ
줾Υݥ󥿡ϡ
ΥͥåȥۥȤбͥåȥɥ쥹¤Τؤ
ϥ̥롦ݥ󥿡ǽü롣
.SH 
RFC\ 2553.
.\" POSIX.1-2001 ˤϤʤ
.SH 
δؿ glibc 2.1.91-95 ¸ߤƤӺ줿
Ĥ Unix ƥϤδؿбƤ뤬
δؿƿ侩ʤ
.SH Ϣ
.BR getaddrinfo (3),
.BR getnameinfo (3),
.BR inet_ntop (3),
.BR inet_pton (3)