Print this page
11622 clean up rarer mandoc lint warnings
*** 9,19 ****
.SH NAME
netdir, netdir_getbyname, netdir_getbyaddr, netdir_free, netdir_options,
taddr2uaddr, uaddr2taddr, netdir_perror, netdir_sperror, netdir_mergeaddr \-
generic transport name-to-address translation
.SH SYNOPSIS
- .LP
.nf
\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lnsl\fR [ \fIlibrary\fR...]
#include <netdir.h>
\fBint\fR \fBnetdir_getbyname\fR(\fBstruct netconfig *\fR\fIconfig\fR,
--- 9,18 ----
*** 56,66 ****
.nf
\fBchar *\fR\fBnetdir_sperror\fR(\fBvoid\fR);
.fi
.SH DESCRIPTION
- .LP
The \fBnetdir\fR functions provide a generic interface for name-to-address
mapping that will work with all transport protocols. This interface provides a
generic way for programs to convert transport specific addresses into common
structures and back again. The \fBnetconfig\fR structure, described on the
\fBnetconfig\fR(4) manual page, identifies the transport.
--- 55,64 ----
*** 183,193 ****
The \fBnetdir_options()\fR function is used to do all transport-specific setups
and option management. \fIfildes\fR is the associated file descriptor.
\fIoption\fR, \fIfildes\fR, and \fIpointer_to_args\fR are passed to the
\fBnetdir_options()\fR function for the transport specified in \fIconfig\fR.
Currently four values are defined for \fIoption\fR:
- .br
.in +2
\fBND_SET_BROADCAST\fR
.in -2
.br
--- 181,190 ----
*** 301,321 ****
.LP
The \fBnetdir_sperror()\fR function returns a string with an error message that
states the cause of a name-to-address mapping failure.
.SH RETURN VALUES
- .LP
The \fBnetdir_sperror()\fR function returns a pointer to a buffer which
contains the error message string. The buffer is overwritten on each call. In
multithreaded applications, this buffer is implemented as thread-specific
data.
.sp
.LP
The \fBnetdir_getbyname()\fR, \fBnetdir_getbyaddr()\fR, and \fBnetdir_options()\fR
functions return \fB0\fR on success and a non-zero value on failure.
.SH ATTRIBUTES
- .LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
--- 298,316 ----
*** 326,333 ****
_
MT-Level Safe
.TE
.SH SEE ALSO
- .LP
\fBgethostname\fR(3C), \fBgetnetconfig\fR(3NSL), \fBgetnetpath\fR(3NSL),
\fBnetconfig\fR(4), \fBattributes\fR(5)
--- 321,327 ----