.\" Copyright (C) 2000, 2001, 2004, 2005, 2007, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")

.\" 

.\" This Source Code Form is subject to the terms of the Mozilla Public

.\" License, v. 2.0. If a copy of the MPL was not distributed with this

.\" file, You can obtain one at http://mozilla.org/MPL/2.0/.

.\"

.hy 0

.ad l

'\" t

.\"     Title: lwres_inetntop

.\"    Author: 

.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>

.\"      Date: 2007-06-18

.\"    Manual: BIND9

.\"    Source: ISC

.\"  Language: English

.\"

.TH "LWRES_INETNTOP" "3" "2007\-06\-18" "ISC" "BIND9"

.\" -----------------------------------------------------------------

.\" * Define some portability stuff

.\" -----------------------------------------------------------------

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.\" http://bugs.debian.org/507673

.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.ie \n(.g .ds Aq \(aq

.el       .ds Aq '

.\" -----------------------------------------------------------------

.\" * set default formatting

.\" -----------------------------------------------------------------

.\" disable hyphenation

.nh

.\" disable justification (adjust text to left margin only)

.ad l

.\" -----------------------------------------------------------------

.\" * MAIN CONTENT STARTS HERE *

.\" -----------------------------------------------------------------

.SH "NAME"

lwres_net_ntop \- lightweight resolver IP address presentation

.SH "SYNOPSIS"

.sp

.ft B

.nf

#include <lwres/net\&.h>

.fi

.ft

.HP \w'const\ char\ *\ lwres_net_ntop('u

.BI "const char * lwres_net_ntop(int\ " "af" ", const\ void\ *" "src" ", char\ *" "dst" ", size_t\ " "size" ");"

.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

\fBerrno\fR

to

\fBEAFNOSUPPORT\fR

if the protocol family given in

\fIaf\fR

is not supported\&.

.SH "SEE ALSO"

.PP

\fBRFC1884\fR(),

\fBinet_ntop\fR(3),

\fBerrno\fR(3)\&.

.SH "AUTHOR"

.PP

\fBInternet Systems Consortium, Inc\&.\fR

.SH "COPYRIGHT"

.br

Copyright \(co 2000, 2001, 2004, 2005, 2007, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")

.br