68 lines
2.0 KiB
Groff
68 lines
2.0 KiB
Groff
.\" Copyright (C) 2000, 2001 Internet Software Consortium.
|
|
.\"
|
|
.\" Permission to use, copy, modify, and distribute this software for any
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
|
.\" copyright notice and this permission notice appear in all copies.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
|
|
.\" DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
|
|
.\" INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
|
|
.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
|
|
.\" FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
|
|
.\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
|
|
.\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
.\"
|
|
.\" $Id: lwres_inetntop.3,v 1.10 2001/06/08 19:32:51 gson Exp $
|
|
.\"
|
|
.TH "LWRES_INETNTOP" "3" "Jun 30, 2000" "BIND9" ""
|
|
.SH NAME
|
|
lwres_net_ntop \- lightweight resolver IP address presentation
|
|
.SH SYNOPSIS
|
|
\fB#include <lwres/net.h>
|
|
.sp
|
|
.na
|
|
const char *
|
|
lwres_net_ntop(int af, const void *src, char *dst, size_t size);
|
|
.ad
|
|
\fR.SH "DESCRIPTION"
|
|
.PP
|
|
\fBlwres_net_ntop()\fR
|
|
converts an IP address of protocol family
|
|
\fIaf\fR
|
|
\(em IPv4 or IPv6 \(em
|
|
at location
|
|
\fIsrc\fR
|
|
from network format to its conventional representation as a string.
|
|
For IPv4 addresses, that string would be a dotted-decimal.
|
|
An IPv6 address would be represented in colon notation as described in
|
|
RFC1884.
|
|
.PP
|
|
The generated string is copied to
|
|
\fIdst\fR
|
|
provided
|
|
\fIsize\fR
|
|
indicates it is long enough to store the ASCII representation
|
|
of the address.
|
|
.SH "RETURN VALUES"
|
|
.PP
|
|
If successful, the function returns
|
|
\fIdst\fR:
|
|
a pointer to a string containing
|
|
the presentation format of the address.
|
|
\fBlwres_net_ntop()\fR
|
|
returns
|
|
\fBNULL\fR
|
|
and sets the global variable
|
|
errno
|
|
to
|
|
EAFNOSUPPORT
|
|
if the protocol family given in
|
|
\fIaf\fR
|
|
is not supported.
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
\fBRFC1884\fR,
|
|
\fBinet_ntop\fR(3),
|
|
\fBerrno\fR(3).
|