← Back to branch summary

~ubuntu-branches/ubuntu/maverick/bind9/maverick

« back to all changes in this revision

Viewing changes to lib/lwres/man/lwres_getnameinfo.3

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones, LaMont Jones, Internet Software Consortium, Inc, localization folks
  • Date: 2008-08-02 14:20:20 UTC
  • mfrom: (1.2.1 upstream) (6.1.24 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080802142020-l1hon9jy8lbbjxmg
http://bugs.debian.org/149259
http://bugs.debian.org/492418
http://bugs.debian.org/493392
http://bugs.debian.org/492564
http://bugs.debian.org/490027
http://bugs.debian.org/492949
http://bugs.debian.org/492425
http://bugs.debian.org/491369
http://bugs.debian.org/492048
http://bugs.debian.org/490630
http://bugs.debian.org/492587
[LaMont Jones]

* default to using resolvconf if it is installed
* fix sonames and dependencies.  Closes: #149259, #492418
* Do not build-depend libcap2-dev on non-linux.  Closes: #493392
* drop unused query-loc manpage.  Closes: #492564
* lwresd: Deliver /etc/bind directory.  Closes: #490027
* fix query-source comment in default install

[Internet Software Consortium, Inc]

* 9.5.0-P2.  Closes: #492949

[localization folks]

* l10n: Spanish debconf translation.  Closes: #492425 (Ignacio Mondino)
* l10n: Swedish debconf templates.  Closes: #491369 (Martin Ågren)
* l10n: Japanese debconf translations.  Closes: #492048 (Hideki Yamane
  (Debian-JP))
* l10n: Finnish translation.  Closes: #490630 (Esko Arajärvi)
* l10n: Italian debconf translations.  Closes: #492587 (Alessandro Vietta)

Show diffs side-by-side

added added

removed removed

Lines of Context:
lib/lwres/man/lwres_getnameinfo.3
1
 
.\" Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
 
1
.\" Copyright (C) 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
2
2
.\" Copyright (C) 2000, 2001 Internet Software Consortium.
3
3
.\" 
4
4
.\" Permission to use, copy, modify, and distribute this software for any
13
13
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
14
14
.\" PERFORMANCE OF THIS SOFTWARE.
15
15
.\"
16
 
.\" $Id: lwres_getnameinfo.3,v 1.15.2.1.8.5 2005/10/13 02:33:53 marka Exp $
 
16
.\" $Id: lwres_getnameinfo.3,v 1.29 2007/01/30 00:24:59 marka Exp $
17
17
.\"
18
18
.hy 0
19
19
.ad l
20
 
.\" ** You probably do not want to edit this file directly **
21
 
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
22
 
.\" Instead of manually editing it, you probably should edit the DocBook XML
23
 
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
 
20
.\"     Title: lwres_getnameinfo
 
21
.\"    Author: 
 
22
.\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/>
 
23
.\"      Date: Jun 30, 2000
 
24
.\"    Manual: BIND9
 
25
.\"    Source: BIND9
 
26
.\"
24
27
.TH "LWRES_GETNAMEINFO" "3" "Jun 30, 2000" "BIND9" "BIND9"
25
28
.\" disable hyphenation
26
29
.nh
33
36
#include <lwres/netdb.h>
34
37
.fi
35
38
.HP 22
36
 
\fBint\ \fBlwres_getnameinfo\fR\fR\fB(\fR\fBconst\ struct\ sockaddr\ *sa\fR\fB, \fR\fBsize_t\ salen\fR\fB, \fR\fBchar\ *host\fR\fB, \fR\fBsize_t\ hostlen\fR\fB, \fR\fBchar\ *serv\fR\fB, \fR\fBsize_t\ servlen\fR\fB, \fR\fBint\ flags\fR\fB);\fR
 
39
.BI "int lwres_getnameinfo(const\ struct\ sockaddr\ *" "sa" ", size_t\ " "salen" ", char\ *" "host" ", size_t\ " "hostlen" ", char\ *" "serv" ", size_t\ " "servlen" ", int\ " "flags" ");"
37
40
.SH "DESCRIPTION"
38
41
.PP
39
42
This function is equivalent to the
41
44
function defined in RFC2133.
42
45
\fBlwres_getnameinfo()\fR
43
46
returns the hostname for the
44
 
\fBstruct sockaddr\fR\fIsa\fR
 
47
\fBstruct sockaddr\fR
 
48
\fIsa\fR
45
49
which is
46
50
\fIsalen\fR
47
51
bytes long. The hostname is of length
64
68
The
65
69
\fIflags\fR
66
70
argument sets the following bits:
67
 
.TP
 
71
.PP
68
72
\fBNI_NOFQDN\fR
 
73
.RS 4
69
74
A fully qualified domain name is not required for local hosts. The local part of the fully qualified domain name is returned instead.
70
 
.TP
 
75
.RE
 
76
.PP
71
77
\fBNI_NUMERICHOST\fR
 
78
.RS 4
72
79
Return the address in numeric form, as if calling inet_ntop(), instead of a host name.
73
 
.TP
 
80
.RE
 
81
.PP
74
82
\fBNI_NAMEREQD\fR
 
83
.RS 4
75
84
A name is required. If the hostname cannot be found in the DNS and this flag is set, a non\-zero error code is returned. If the hostname is not found and the flag is not set, the address is returned in numeric form.
76
 
.TP
 
85
.RE
 
86
.PP
77
87
\fBNI_NUMERICSERV\fR
 
88
.RS 4
78
89
The service name is returned as a digit string representing the port number.
79
 
.TP
 
90
.RE
 
91
.PP
80
92
\fBNI_DGRAM\fR
 
93
.RS 4
81
94
Specifies that the service being looked up is a datagram service, and causes getservbyport() to be called with a second argument of "udp" instead of its default of "tcp". This is required for the few ports (512\-514) that have different services for UDP and TCP.
 
95
.RE
82
96
.SH "RETURN VALUES"
83
97
.PP
84
98
\fBlwres_getnameinfo()\fR
96
110
RFC2133 fails to define what the nonzero return values of
97
111
\fBgetnameinfo\fR(3)
98
112
are.
 
113
.SH "COPYRIGHT"
 
114
Copyright \(co 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
 
115
.br
 
116
Copyright \(co 2000, 2001 Internet Software Consortium.
 
117
.br