Print this page
11622 clean up rarer mandoc lint warnings
@@ -9,11 +9,10 @@
.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,
@@ -56,11 +55,10 @@
.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.
@@ -183,11 +181,10 @@
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
@@ -301,21 +298,19 @@
.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
@@ -326,8 +321,7 @@
_
MT-Level Safe
.TE
.SH SEE ALSO
-.LP
\fBgethostname\fR(3C), \fBgetnetconfig\fR(3NSL), \fBgetnetpath\fR(3NSL),
\fBnetconfig\fR(4), \fBattributes\fR(5)