summaryrefslogtreecommitdiff
path: root/lib/libc
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@cvs.openbsd.org>2015-09-14 13:08:02 +0000
committerIngo Schwarze <schwarze@cvs.openbsd.org>2015-09-14 13:08:02 +0000
commitfc767d18f4cc7c85b269bbd4ee4fe8de80f48cbc (patch)
treeacadc0d21a9f45e42fed7288538a83ed53d8dab5 /lib/libc
parent8c45e964a6cac4aacc0bf676e780b37023c631b3 (diff)
use .Va for global variables, and .Vt where the type is included
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/rpc/rpc.381
-rw-r--r--lib/libc/stdlib/malloc.37
-rw-r--r--lib/libc/time/ctime.313
3 files changed, 46 insertions, 55 deletions
diff --git a/lib/libc/rpc/rpc.3 b/lib/libc/rpc/rpc.3
index 10f899bb99f..bdaf2882483 100644
--- a/lib/libc/rpc/rpc.3
+++ b/lib/libc/rpc/rpc.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: rpc.3,v 1.46 2013/06/05 03:39:23 tedu Exp $
+.\" $OpenBSD: rpc.3,v 1.47 2015/09/14 13:08:01 schwarze Exp $
.\"
.\" Copyright (c) 1998 Theo de Raadt
.\" All rights reserved.
@@ -52,7 +52,7 @@
.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
.\" OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 5 2013 $
+.Dd $Mdocdate: September 14 2015 $
.Dt RPC 3
.Os
.Sh NAME
@@ -175,22 +175,15 @@
.Fn pmap_unset "u_long prognum" "u_long versnum"
.Ft int
.Fn registerrpc "u_long prognum" "u_long versnum" "u_long procnum" "char *(*procname)() " "xdrproc_t inproc" "xdrproc_t outproc"
-.Ft struct rpc_createerr
-.Fa rpc_createerr ;
+.Vt struct rpc_createerr rpc_createerr ;
.Ft int
.Fn svc_destroy "SVCXPRT *xprt"
-.Ft struct pollfd *
-.Fa svc_pollfd ;
-.Ft int
-.Fa svc_max_pollfd ;
-.Ft fd_set
-.Fa svc_fdset ;
-.Ft fd_set
-.Fa *__svc_fdset ;
-.Ft int
-.Fa __svc_fdsetsize ;
-.Ft int
-.Fa svc_fds ;
+.Vt struct pollfd *svc_pollfd ;
+.Vt int svc_max_pollfd ;
+.Vt fd_set svc_fdset ;
+.Vt fd_set *__svc_fdset ;
+.Vt int __svc_fdsetsize ;
+.Vt int svc_fds ;
.Ft int
.Fn svc_freeargs "SVCXPRT *xprt" "xdrproc_t inproc" "char *in"
.Ft int
@@ -661,7 +654,7 @@ the RPC system failured to contact the remote
.Xr portmap 8
service.
In the latter case, the global variable
-.Fn rpc_createerr
+.Va rpc_createerr
contains the RPC status.
.Pp
.Fn pmap_rmtcall
@@ -746,7 +739,7 @@ are accessed using the UDP/IP transport; see
.Fn svcudp_create
for restrictions.
.Pp
-.Fa rpc_createerr
+.Va rpc_createerr
is a global variable whose value is set by any RPC client creation routine
that does not succeed.
Use the routine
@@ -764,7 +757,7 @@ Use of
.Fa xprt
is undefined after calling this routine.
.Pp
-.Fa svc_pollfd
+.Va svc_pollfd
is a global variable reflecting the RPC service side's
read file descriptor array.
This variable is only of interest if service implementors do not call
@@ -777,30 +770,30 @@ Do not pass it directly to
.Xr poll 2 !
Instead, make a copy and pass that instead.
.Pp
-.Fa svc_max_pollfd
+.Va svc_max_pollfd
is a global variable containing the maximum length of the
-.Fa svc_pollfd
+.Va svc_pollfd
array.
-.Fa svc_max_pollfd
+.Va svc_max_pollfd
is not a hard limit; it will grow automatically as needed.
This variable is read-only, and it may change after calls to
.Fn svc_getreq_poll
or any creation routines.
The purpose of
-.Fa svc_max_pollfd
+.Va svc_max_pollfd
is to allow a service implementor to make a copy of
-.Fa svc_pollfd
+.Va svc_pollfd
that may in turn be passed to
.Xr poll 2 .
.Pp
-.Fa __svc_fdset
+.Va __svc_fdset
and
-.Fa __svc_fdsetsize
+.Va __svc_fdsetsize
are global variables reflecting the RPC service side's
read file descriptor bit mask.
-.Fa __svc_fdsetsize
+.Va __svc_fdsetsize
is a count of the number of checkable bits in
-.Fa __svc_fdset ,
+.Va __svc_fdset ,
and can expand to the full size that
.Xr select 2
supports, hence exceeding
@@ -817,14 +810,14 @@ Do not pass its address to
.Xr select 2 !
Instead, pass the address of a copy.
These variables are considered obsolete; new programs should use
-.Fa svc_pollfd
+.Va svc_pollfd
and
-.Fa svc_max_pollfd
+.Va svc_max_pollfd
instead.
.Pp
-.Fa svc_fdset
+.Va svc_fdset
is similar to
-.Fa __svc_fdset
+.Va __svc_fdset
but limited to
.Fa FD_SETSIZE
descriptors.
@@ -846,15 +839,15 @@ this variable will only be usable for the first
.Fa FD_SETSIZE
descriptors.
This variable is considered obsolete; new programs should use
-.Fa svc_pollfd
+.Va svc_pollfd
which does not have this limit.
.Pp
-.Fa svc_fds
+.Va svc_fds
is similar to
-.Fa svc_fedset ,
+.Va svc_fdset ,
but limited to 32 descriptors.
This interface is obsoleted by
-.Fa svc_fdset
+.Va svc_fdset
and is included for source compatibility only.
.Pp
.Fn svc_freeargs
@@ -1187,13 +1180,13 @@ is used to register transport handles.
After RPC service transport handles are created,
they should register themselves with the RPC service package.
This routine modifies the global variables
-.Fa svc_pollfd ,
-.Fa svc_fdset ,
-.Fa __svc_fdset
+.Va svc_pollfd ,
+.Va svc_fdset ,
+.Va __svc_fdset
and may modify
-.Fa svc_max_pollfd
+.Va svc_max_pollfd
and
-.Fa __svc_fdsetsize .
+.Va __svc_fdsetsize .
Service implementors usually do not need this routine.
.Pp
.Fn xprt_unregister
@@ -1201,10 +1194,10 @@ is used to unregister a transport handle.
Before an RPC service transport handle is destroyed,
it should unregister itself with the RPC service package.
This routine modifies the global variable
-.Fa svc_pollfd ,
-.Fa svc_fdset ,
+.Va svc_pollfd ,
+.Va svc_fdset ,
and
-.Fa __svc_fdset .
+.Va __svc_fdset .
Service implementors usually do not need this routine.
.Sh SEE ALSO
.\"Xr rpc_secure 3 ,
diff --git a/lib/libc/stdlib/malloc.3 b/lib/libc/stdlib/malloc.3
index 32f36bd6496..27645b5a805 100644
--- a/lib/libc/stdlib/malloc.3
+++ b/lib/libc/stdlib/malloc.3
@@ -30,9 +30,9 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: malloc.3,v 1.90 2015/03/14 08:07:17 tedu Exp $
+.\" $OpenBSD: malloc.3,v 1.91 2015/09/14 13:08:01 schwarze Exp $
.\"
-.Dd $Mdocdate: March 14 2015 $
+.Dd $Mdocdate: September 14 2015 $
.Dt MALLOC 3
.Os
.Sh NAME
@@ -54,8 +54,7 @@
.Fn realloc "void *ptr" "size_t size"
.Ft void
.Fn free "void *ptr"
-.Ft char * Ns
-.Va malloc_options ;
+.Vt char *malloc_options ;
.Sh DESCRIPTION
The
.Fn malloc
diff --git a/lib/libc/time/ctime.3 b/lib/libc/time/ctime.3
index fc02e5de668..284f5f0d3b2 100644
--- a/lib/libc/time/ctime.3
+++ b/lib/libc/time/ctime.3
@@ -1,7 +1,7 @@
-.\" $OpenBSD: ctime.3,v 1.43 2014/01/23 08:15:13 otto Exp $
+.\" $OpenBSD: ctime.3,v 1.44 2015/09/14 13:08:01 schwarze Exp $
.\"
.\"
-.Dd $Mdocdate: January 23 2014 $
+.Dd $Mdocdate: September 14 2015 $
.Dt CTIME 3
.Os
.Sh NAME
@@ -21,8 +21,7 @@
.Sh SYNOPSIS
.In sys/types.h
.In time.h
-.Pp
-.Fd extern char *tzname[2];
+.Vt extern char *tzname[2] ;
.Ft "char *"
.Fn ctime "const time_t *clock"
.Ft "char *"
@@ -86,7 +85,7 @@ Unlike
the thread-safe version
.Fn ctime_r
is not required to set
-.Fa tzname .
+.Va tzname .
.Pp
The
.Fn localtime
@@ -105,7 +104,7 @@ structure,
sets the
.Fa tm_isdst Ns 'th
element of
-.Fa tzname
+.Va tzname
to a pointer to an
ASCII string that's the time zone abbreviation to be used with
the return value of
@@ -130,7 +129,7 @@ but instead store the result directly into the structure pointed to by
Unlike
.Fn localtime ,
the reentrant version is not required to set
-.Fa tzname .
+.Va tzname .
.Pp
.Fn asctime
converts a time value contained in a