Fix mdoc .Xr reference for syntax or correctness (e.g. exec(2) versus exec(3)).
Make other mdoc corrections as inspection dictated.
This commit is contained in:
fair
parent
861c7a7e2d
commit
095ab11cb7
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: exec.3,v 1.9 1998/02/05 18:46:15 perry Exp $
|
||||
.\" $NetBSD: exec.3,v 1.10 1998/04/28 20:11:33 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -69,7 +69,7 @@ new process image.
|
||||
The functions described in this manual page are front-ends for the function
|
||||
.Xr execve 2 .
|
||||
(See the manual page for
|
||||
.Xr execve
|
||||
.Xr execve 2
|
||||
for detailed information about the replacement of the current process.)
|
||||
.Pp
|
||||
The initial argument for these functions is the pathname of a file which
|
||||
@ -152,7 +152,7 @@ used.
|
||||
In addition, certain errors are treated specially.
|
||||
.Pp
|
||||
If permission is denied for a file (the attempted
|
||||
.Xr execve
|
||||
.Xr execve 2
|
||||
returned
|
||||
.Er EACCES ) ,
|
||||
these functions will continue searching the rest of
|
||||
@ -163,7 +163,7 @@ set to
|
||||
.Er EACCES .
|
||||
.Pp
|
||||
If the header of a file isn't recognized (the attempted
|
||||
.Xr execve
|
||||
.Xr execve 2
|
||||
returned
|
||||
.Er ENOEXEC ) ,
|
||||
these functions will execute the shell with the path of
|
||||
@ -171,7 +171,7 @@ the file as its first argument.
|
||||
(If this attempt fails, no further searching is done.)
|
||||
.Pp
|
||||
If the file is currently busy (the attempted
|
||||
.Xr execve
|
||||
.Xr execve 2
|
||||
returned
|
||||
.Er ETXTBUSY ) ,
|
||||
these functions will sleep for several seconds,
|
||||
@ -183,7 +183,7 @@ executes a file with the program tracing facilities enabled (see
|
||||
.Xr ptrace 2 ) .
|
||||
.Sh RETURN VALUES
|
||||
If any of the
|
||||
.Xr exec
|
||||
.Xr exec 3
|
||||
functions returns, an error will have occurred.
|
||||
The return value is \-1, and the global variable
|
||||
.Va errno
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: getcap.3,v 1.8 1998/02/05 18:46:27 perry Exp $
|
||||
.\" $NetBSD: getcap.3,v 1.9 1998/04/28 20:11:34 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1992, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -84,14 +84,14 @@ from the database specified by the
|
||||
terminated file array
|
||||
.Fa db_array
|
||||
and returns a pointer to a
|
||||
.Xr malloc Ns \&'d
|
||||
.Xr malloc 3 Ns \&'d
|
||||
copy of it in
|
||||
.Fa buf .
|
||||
.Nm Cgetent
|
||||
will first look for files ending in
|
||||
.Nm .db
|
||||
(see
|
||||
.Xr cap_mkdb 1)
|
||||
.Xr cap_mkdb 1 )
|
||||
before accessing the ASCII file.
|
||||
.Fa Buf
|
||||
must be retained through all subsequent calls to
|
||||
@ -102,7 +102,7 @@ must be retained through all subsequent calls to
|
||||
and
|
||||
.Fn cgetustr ,
|
||||
but may then be
|
||||
.Xr free Ns \&'d.
|
||||
.Xr free 3 Ns \&'d.
|
||||
On success 0 is returned, 1 if the returned
|
||||
record contains an unresolved
|
||||
.Nm tc
|
||||
@ -193,7 +193,7 @@ from the capability record pointed to by
|
||||
A pointer to a decoded,
|
||||
.Dv NUL
|
||||
terminated,
|
||||
.Xr malloc Ns \&'d
|
||||
.Xr malloc 3 Ns \&'d
|
||||
copy of the string is returned in the
|
||||
.Ft char *
|
||||
pointed to by
|
||||
@ -229,7 +229,7 @@ or
|
||||
call. If there is no such previous call, the first record in the database is
|
||||
returned.
|
||||
Each record is returned in a
|
||||
.Xr malloc Ns \&'d
|
||||
.Xr malloc 3 Ns \&'d
|
||||
copy pointed to by
|
||||
.Fa buf .
|
||||
.Ic Tc
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: getmntinfo.3,v 1.7 1998/02/05 18:46:47 perry Exp $
|
||||
.\" $NetBSD: getmntinfo.3,v 1.8 1998/04/28 20:11:34 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1989, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -50,9 +50,8 @@
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Fn getmntinfo
|
||||
function
|
||||
returns an array of
|
||||
.Xr statfs
|
||||
function returns an array of
|
||||
.Em statfs
|
||||
structures describing each currently mounted file system (see
|
||||
.Xr statfs 2 ) .
|
||||
.Pp
|
||||
@ -73,20 +72,20 @@ The pointer to the array is stored into
|
||||
If an error occurs, zero is returned and the external variable
|
||||
.Va errno
|
||||
is set to indicate the error.
|
||||
Although the pointer
|
||||
Although the pointer
|
||||
.Fa mntbufp
|
||||
will be unmodified, any information previously returned by
|
||||
will be unmodified, any information previously returned by
|
||||
.Fn getmntinfo
|
||||
will be lost.
|
||||
.Sh ERRORS
|
||||
The
|
||||
.Fn getmntinfo
|
||||
function
|
||||
may fail and set
|
||||
.Va errno
|
||||
may fail and set
|
||||
.Va errno
|
||||
for any of the errors specified for the library routines
|
||||
.Xr getfsstat 2
|
||||
or
|
||||
or
|
||||
.Xr malloc 3 .
|
||||
.Sh SEE ALSO
|
||||
.Xr getfsstat 2 ,
|
||||
@ -103,7 +102,8 @@ The
|
||||
.Fn getmntinfo
|
||||
function writes the array of structures to an internal static object
|
||||
and returns
|
||||
a pointer to that object. Subsequent calls to
|
||||
a pointer to that object.
|
||||
Subsequent calls to
|
||||
.Fn getmntinfo
|
||||
will modify the same object.
|
||||
.Pp
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: getpagesize.3,v 1.3 1998/02/05 18:46:50 perry Exp $
|
||||
.\" $NetBSD: getpagesize.3,v 1.4 1998/04/28 20:11:34 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1983, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -48,11 +48,10 @@
|
||||
.Sh DESCRIPTION
|
||||
.Fn Getpagesize
|
||||
returns the number of bytes in a page.
|
||||
Page granularity is the granularity of many of the memory
|
||||
management calls.
|
||||
Page granularity is the granularity of many of the memory management calls.
|
||||
.Pp
|
||||
The page size is a
|
||||
.Xr system
|
||||
.Em system
|
||||
page size and may not be the same as the underlying
|
||||
hardware page size.
|
||||
.Sh SEE ALSO
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: getpwent.3,v 1.12 1998/02/05 18:46:53 perry Exp $
|
||||
.\" $NetBSD: getpwent.3,v 1.13 1998/04/28 20:11:34 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1988, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -213,6 +213,6 @@ are fairly useless in a networked environment and should be
|
||||
avoided, if possible.
|
||||
.Sh COMPATIBILITY
|
||||
The historic function
|
||||
.Xr setpwfile 3 ,
|
||||
.Fn setpwfile
|
||||
which allowed the specification of alternative password databases,
|
||||
has been deprecated and is no longer available.
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: glob.3,v 1.13 1998/03/31 20:37:20 kleink Exp $
|
||||
.\" $NetBSD: glob.3,v 1.14 1998/04/28 20:11:34 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1989, 1991, 1993, 1994
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -48,7 +48,7 @@
|
||||
.Fd #include <glob.h>
|
||||
.Ft int
|
||||
.Fn glob "const char *pattern" "int flags" "const int (*errfunc)(const char *, int)" "glob_t *pglob"
|
||||
.Ft void
|
||||
.Ft void
|
||||
.Fn globfree "glob_t *pglob"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
@ -100,7 +100,7 @@ field, and a pointer to a list of pointers to pathnames into the
|
||||
.Fa gl_pathv
|
||||
field.
|
||||
The first pointer after the last pathname is
|
||||
.Dv NULL .
|
||||
.Dv NULL .
|
||||
If the pattern does not match any pathnames, the returned number of
|
||||
matched paths is set to zero.
|
||||
.Pp
|
||||
@ -221,33 +221,33 @@ This extension is provided to allow programs such as
|
||||
.Xr restore 8
|
||||
to provide globbing from directories stored on tape.
|
||||
.It Dv GLOB_BRACE
|
||||
Pre-process the pattern string to expand
|
||||
.Ql {pat,pat,...}
|
||||
strings like
|
||||
Pre-process the pattern string to expand
|
||||
.Ql {pat,pat,...}
|
||||
strings like
|
||||
.Xr csh 1 .
|
||||
The pattern
|
||||
The pattern
|
||||
.Ql {}
|
||||
is left unexpanded for historical reasons.
|
||||
.Xr (Csh 1
|
||||
does the same thing to
|
||||
ease typing
|
||||
of
|
||||
.Xr find 1
|
||||
patterns.)
|
||||
is left unexpanded for historical reasons
|
||||
.Po
|
||||
.Xr csh 1
|
||||
does the same thing to ease typing of
|
||||
.Xr find 1
|
||||
patterns
|
||||
.Pc .
|
||||
.It Dv GLOB_MAGCHAR
|
||||
Set by the
|
||||
.Fn glob
|
||||
function if the pattern included globbing characters.
|
||||
See the description of the usage of the
|
||||
See the description of the usage of the
|
||||
.Fa gl_matchc
|
||||
structure member for more details.
|
||||
.It Dv GLOB_NOMAGIC
|
||||
Is the same as
|
||||
.Dv GLOB_NOCHECK
|
||||
Is the same as
|
||||
.Dv GLOB_NOCHECK
|
||||
but it only appends the
|
||||
.Fa pattern
|
||||
if it does not contain any of the special characters ``*'', ``?'' or ``[''.
|
||||
.Dv GLOB_NOMAGIC
|
||||
.Dv GLOB_NOMAGIC
|
||||
is provided to simplify implementing the historic
|
||||
.Xr csh 1
|
||||
globbing behavior and should probably not be used anywhere else.
|
||||
@ -267,7 +267,7 @@ If, during the search, a directory is encountered that cannot be opened
|
||||
or read and
|
||||
.Fa errfunc
|
||||
is
|
||||
.Pf non- Dv NULL ,
|
||||
.Pf non- Dv NULL ,
|
||||
.Fn glob
|
||||
calls
|
||||
.Fa (*errfunc)(path, errno) .
|
||||
@ -284,7 +284,7 @@ call to
|
||||
The error routine can suppress this action by testing for
|
||||
.Dv ENOENT
|
||||
and
|
||||
.Dv ENOTDIR ;
|
||||
.Dv ENOTDIR ;
|
||||
however, the
|
||||
.Dv GLOB_ERR
|
||||
flag will still cause an immediate
|
||||
@ -334,16 +334,16 @@ contain the values described below:
|
||||
.Bl -tag -width GLOB_NOCHECK
|
||||
.It Fa gl_pathc
|
||||
contains the total number of matched pathnames so far.
|
||||
This includes other matches from previous invocations of
|
||||
This includes other matches from previous invocations of
|
||||
.Fn glob
|
||||
if
|
||||
if
|
||||
.Dv GLOB_APPEND
|
||||
was specified.
|
||||
.It Fa gl_matchc
|
||||
contains the number of matched pathnames in the current invocation of
|
||||
.Fn glob .
|
||||
.It Fa gl_flags
|
||||
contains a copy of the
|
||||
contains a copy of the
|
||||
.Fa flags
|
||||
parameter with the bit
|
||||
.Dv GLOB_MAGCHAR
|
||||
@ -353,7 +353,7 @@ contained any of the special characters ``*'', ``?'' or ``['', cleared
|
||||
if not.
|
||||
.It Fa gl_pathv
|
||||
contains a pointer to a
|
||||
.Dv NULL Ns -terminated
|
||||
.Dv NULL Ns -terminated
|
||||
list of matched pathnames.
|
||||
However, if
|
||||
.Fa gl_pathc
|
||||
@ -364,9 +364,9 @@ are undefined.
|
||||
.Pp
|
||||
If
|
||||
.Fn glob
|
||||
terminates due to an error, it sets
|
||||
.Va errno
|
||||
and returns one of the following non-zero constants, which are defined
|
||||
terminates due to an error, it sets
|
||||
.Va errno
|
||||
and returns one of the following non-zero constants, which are defined
|
||||
in the include file
|
||||
.Aq Pa glob.h :
|
||||
.Bl -tag -width GLOB_NOCHECK
|
||||
@ -430,9 +430,9 @@ that the flags
|
||||
.Dv GLOB_QUOTE,
|
||||
and
|
||||
.Dv GLOB_TILDE,
|
||||
and the fields
|
||||
and the fields
|
||||
.Fa gl_matchc
|
||||
and
|
||||
and
|
||||
.Fa gl_flags
|
||||
should not be used by applications striving for strict
|
||||
.Tn POSIX
|
||||
@ -442,7 +442,7 @@ The
|
||||
.Fn glob
|
||||
and
|
||||
.Fn globfree
|
||||
functions first appeared in
|
||||
functions first appeared in
|
||||
.Bx 4.4 .
|
||||
.Sh BUGS
|
||||
Patterns longer than
|
||||
@ -451,8 +451,8 @@ may cause unchecked errors.
|
||||
.Pp
|
||||
The
|
||||
.Fn glob
|
||||
function may fail and set
|
||||
.Va errno
|
||||
function may fail and set
|
||||
.Va errno
|
||||
for any of the errors specified for the library routines
|
||||
.Xr stat 2 ,
|
||||
.Xr closedir 3 ,
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: isupper.3,v 1.6 1998/02/05 18:47:24 perry Exp $
|
||||
.\" $NetBSD: isupper.3,v 1.7 1998/04/28 20:11:34 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1991 The Regents of the University of California.
|
||||
.\" All rights reserved.
|
||||
@ -60,7 +60,7 @@ implementation-defined set of characters for which none of
|
||||
or
|
||||
.Xr isspace 3
|
||||
is true.
|
||||
In the
|
||||
In the
|
||||
.Em ``C''
|
||||
locale,
|
||||
.Fn isupper
|
||||
@ -83,13 +83,13 @@ returns non-zero if the character tests true.
|
||||
.Xr ispunct 3 ,
|
||||
.Xr isspace 3 ,
|
||||
.Xr isxdigit 3 ,
|
||||
.Xr stdio 3 ,
|
||||
.Xr toascii 3 ,
|
||||
.Xr tolower 3 ,
|
||||
.Xr toupper 3 ,
|
||||
.Xr stdio 3 ,
|
||||
.Xr ascii 7
|
||||
.Sh STANDARDS
|
||||
The
|
||||
.Xr isupper
|
||||
.Fn isupper
|
||||
function conforms to
|
||||
.St -ansiC .
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: popen.3,v 1.7 1998/02/05 18:47:36 perry Exp $
|
||||
.\" $NetBSD: popen.3,v 1.8 1998/04/28 20:11:35 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -146,7 +146,7 @@ command, if
|
||||
already
|
||||
.Dq pclosed ,
|
||||
or if
|
||||
.Xr wait4
|
||||
.Xr wait4 2
|
||||
returns an error.
|
||||
.Sh ERRORS
|
||||
The
|
||||
@ -186,9 +186,9 @@ The
|
||||
.Fn popen
|
||||
argument
|
||||
always calls
|
||||
.Xr sh ,
|
||||
.Xr sh 1 ,
|
||||
never calls
|
||||
.Xr csh .
|
||||
.Xr csh 1 .
|
||||
.Sh HISTORY
|
||||
A
|
||||
.Fn popen
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: setjmp.3,v 1.6 1998/02/05 18:47:47 perry Exp $
|
||||
.\" $NetBSD: setjmp.3,v 1.7 1998/04/28 20:11:35 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1990, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -149,7 +149,7 @@ routine calls the routine
|
||||
If
|
||||
.Fn longjmperror
|
||||
returns the program is aborted (see
|
||||
.Xr abort 2 ) .
|
||||
.Xr abort 3 ) .
|
||||
The default version of
|
||||
.Fn longjmperror
|
||||
prints the message
|
||||
@ -169,7 +169,7 @@ and
|
||||
.Fn longjmp
|
||||
functions conform to
|
||||
.St -ansiC .
|
||||
The
|
||||
The
|
||||
.Fn sigsetjmp
|
||||
and
|
||||
.Fn siglongjmp
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: signal.3,v 1.7 1998/02/05 18:47:53 perry Exp $
|
||||
.\" $NetBSD: signal.3,v 1.8 1998/04/28 20:11:35 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1980, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -93,7 +93,7 @@ These signals are defined in the file
|
||||
.It Dv SIGQUIT No " create core image" " quit program"
|
||||
.It Dv SIGILL No " create core image" " illegal instruction"
|
||||
.It Dv SIGTRAP No " create core image" " trace trap"
|
||||
.It Dv SIGABRT No " create core image" Xr abort 2
|
||||
.It Dv SIGABRT No " create core image" Xr abort 3
|
||||
call (formerly
|
||||
.Dv SIGIOT )
|
||||
.It Dv SIGEMT No " create core image" " emulate instruction executed"
|
||||
@ -166,7 +166,7 @@ the call is automatically restarted.
|
||||
(The handler is installed using the
|
||||
.Dv SA_RESTART
|
||||
flag with
|
||||
.Xr sigaction 2 . )
|
||||
.Xr sigaction 2 ) .
|
||||
The affected system calls include
|
||||
.Xr read 2 ,
|
||||
.Xr write 2 ,
|
||||
@ -196,9 +196,8 @@ Otherwise, \-1 is returned and the global variable
|
||||
.Va errno
|
||||
is set to indicate the error.
|
||||
.Sh ERRORS
|
||||
.Xr Signal
|
||||
will fail and no action will take place if one of the
|
||||
following occur:
|
||||
.Fn signal
|
||||
will fail and no action will take place if one of the following occur:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EINVAL
|
||||
.Em Sig
|
||||
@ -207,7 +206,7 @@ is not a valid signal number.
|
||||
An attempt is made to ignore or supply a handler for
|
||||
.Dv SIGKILL
|
||||
or
|
||||
.Ev SIGSTOP .
|
||||
.Dv SIGSTOP .
|
||||
.Sh SEE ALSO
|
||||
.Xr kill 1 ,
|
||||
.Xr ptrace 2 ,
|
||||
@ -220,6 +219,6 @@ or
|
||||
.Xr tty 4
|
||||
.Sh HISTORY
|
||||
This
|
||||
.Nm signal
|
||||
.Fn signal
|
||||
facility appeared in
|
||||
.Bx 4.0 .
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: sysconf.3,v 1.6 1998/02/05 18:47:59 perry Exp $
|
||||
.\" $NetBSD: sysconf.3,v 1.7 1998/04/28 20:11:35 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -68,7 +68,7 @@ The available values are as follows:
|
||||
.Pp
|
||||
.It Li _SC_ARG_MAX
|
||||
The maximum bytes of argument to
|
||||
.Xr exec 2 .
|
||||
.Xr execve 2 .
|
||||
.It Li _SC_CHILD_MAX
|
||||
The maximum number of simultaneous processes per user id.
|
||||
.It Li _SC_CLK_TCK
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: sysctl.3,v 1.24 1998/04/13 21:24:49 kml Exp $
|
||||
.\" $NetBSD: sysctl.3,v 1.25 1998/04/28 20:11:35 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -48,24 +48,24 @@
|
||||
.Fn sysctl "int *name" "u_int namelen" "void *oldp" "size_t *oldlenp" "void *newp" "size_t newlen"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm sysctl
|
||||
.Nm
|
||||
function retrieves system information and allows processes with
|
||||
appropriate privileges to set system information.
|
||||
The information available from
|
||||
.Nm sysctl
|
||||
.Nm
|
||||
consists of integers, strings, and tables.
|
||||
Information may be retrieved and set from the command interface
|
||||
using the
|
||||
using the
|
||||
.Xr sysctl 8
|
||||
utility.
|
||||
.Pp
|
||||
Unless explicitly noted below,
|
||||
.Nm sysctl
|
||||
.Nm
|
||||
returns a consistent snapshot of the data requested.
|
||||
Consistency is obtained by locking the destination
|
||||
buffer into memory so that the data may be copied out without blocking.
|
||||
Calls to
|
||||
.Nm sysctl
|
||||
.Nm
|
||||
are serialized to avoid deadlock.
|
||||
.Pp
|
||||
The state is described using a ``Management Information Base'' (MIB)
|
||||
@ -91,8 +91,8 @@ and
|
||||
.Fa oldlenp
|
||||
should be set to NULL.
|
||||
.Pp
|
||||
The size of the available data can be determined by calling
|
||||
.Nm sysctl
|
||||
The size of the available data can be determined by calling
|
||||
.Nm
|
||||
with a NULL parameter for
|
||||
.Fa oldp .
|
||||
The size of the available data will be returned in the location pointed to by
|
||||
@ -158,24 +158,24 @@ sysctl(mib, 2, p, &len, NULL, 0);
|
||||
.Sh CTL_DEBUG
|
||||
The debugging variables vary from system to system.
|
||||
A debugging variable may be added or deleted without need to recompile
|
||||
.Nm sysctl
|
||||
.Nm
|
||||
to know about it.
|
||||
Each time it runs,
|
||||
.Nm sysctl
|
||||
.Nm
|
||||
gets the list of debugging variables from the kernel and
|
||||
displays their current values.
|
||||
The system defines twenty
|
||||
The system defines twenty
|
||||
.Ns ( Va struct ctldebug )
|
||||
variables named
|
||||
.Nm debug0
|
||||
variables named
|
||||
.Dv debug0
|
||||
through
|
||||
.Nm debug19 .
|
||||
.Dv debug19 .
|
||||
They are declared as separate variables so that they can be
|
||||
individually initialized at the location of their associated variable.
|
||||
The loader prevents multiple use of the same variable by issuing errors
|
||||
if a variable is initialized in more than one place.
|
||||
For example, to export the variable
|
||||
.Nm dospecialcheck
|
||||
.Dv dospecialcheck
|
||||
as a debugging variable, the following declaration would be used:
|
||||
.Bd -literal -offset indent -compact
|
||||
int dospecialcheck = 1;
|
||||
@ -291,7 +291,7 @@ information.
|
||||
.Bl -tag -width "123456"
|
||||
.It Li KERN_ARGMAX
|
||||
The maximum bytes of argument to
|
||||
.Xr exec 2 .
|
||||
.Xr execve 2 .
|
||||
.It Li KERN_AUTONICETIME
|
||||
The number of seconds of cpu-time a non-root process may accumulate before
|
||||
having its priority lowered from the default to the value of KERN_AUTONICEVAL.
|
||||
@ -387,7 +387,7 @@ Return profiling information about the kernel.
|
||||
If the kernel is not compiled for profiling,
|
||||
attempts to retrieve any of the KERN_PROF values will
|
||||
fail with EOPNOTSUPP.
|
||||
The third level names for the string and integer profiling information
|
||||
The third level names for the string and integer profiling information
|
||||
is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
@ -719,7 +719,7 @@ DDB. See
|
||||
for more details.
|
||||
.Sh RETURN VALUES
|
||||
If the call to
|
||||
.Nm sysctl
|
||||
.Nm
|
||||
is successful, the number of bytes copied out is returned.
|
||||
Otherwise \-1 is returned and
|
||||
.Va errno
|
||||
@ -790,6 +790,6 @@ definitions for fourth level UDP identifiers
|
||||
.Xr sysctl 8
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Nm sysctl
|
||||
.Nm
|
||||
function first appeared in
|
||||
.Bx 4.4 .
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: syslog.3,v 1.7 1998/02/05 18:48:03 perry Exp $
|
||||
.\" $NetBSD: syslog.3,v 1.8 1998/04/28 20:11:35 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1985, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -66,8 +66,8 @@ writes
|
||||
.Fa message
|
||||
to the system message logger.
|
||||
The message is then written to the system console, log files,
|
||||
logged-in users, or forwarded to other machines as appropriate. (See
|
||||
.Xr syslogd 8 . )
|
||||
logged-in users, or forwarded to other machines as appropriate (See
|
||||
.Xr syslogd 8 ) .
|
||||
.Pp
|
||||
The message is identical to a
|
||||
.Xr printf 3
|
||||
@ -143,12 +143,12 @@ one or more of the following values:
|
||||
If
|
||||
.Fn syslog
|
||||
cannot pass the message to
|
||||
.Xr syslogd
|
||||
.Xr syslogd 8
|
||||
it will attempt to write the message to the console
|
||||
.Pq Dq Pa /dev/console.
|
||||
.It Dv LOG_NDELAY
|
||||
.It Dv LOG_NDELAY
|
||||
Open the connection to
|
||||
.Xr syslogd
|
||||
.Xr syslogd 8
|
||||
immediately.
|
||||
Normally the open is delayed until the first message is logged.
|
||||
Useful for programs that need to manage the order in which file
|
||||
@ -213,7 +213,7 @@ Similarly for
|
||||
.Dv LOG_LOCAL1
|
||||
through
|
||||
.Dv LOG_LOCAL7 .
|
||||
.El
|
||||
.El
|
||||
.Pp
|
||||
The
|
||||
.Fn closelog
|
||||
@ -269,5 +269,5 @@ syslog(LOG_INFO|LOG_LOCAL2, "foobar error: %m");
|
||||
.Xr syslogd 8
|
||||
.Sh HISTORY
|
||||
These
|
||||
functions appeared in
|
||||
functions appeared in
|
||||
.Bx 4.2 .
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: times.3,v 1.7 1998/04/28 04:07:06 fair Exp $
|
||||
.\" $NetBSD: times.3,v 1.8 1998/04/28 20:11:35 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1990, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -50,7 +50,7 @@
|
||||
This interface is obsoleted by
|
||||
.Xr getrusage 2
|
||||
and
|
||||
.Xr gettimeofday 3 .
|
||||
.Xr gettimeofday 2 .
|
||||
.Ef
|
||||
.Pp
|
||||
The
|
||||
@ -59,7 +59,7 @@ function returns the value of time in
|
||||
.Dv CLK_TCK Ns 's
|
||||
of a second since
|
||||
0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated Universal
|
||||
Time.
|
||||
Time (UTC).
|
||||
.Pp
|
||||
It also fills in the structure pointed to by
|
||||
.Fa tp
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: unvis.3,v 1.8 1998/02/05 18:48:20 perry Exp $
|
||||
.\" $NetBSD: unvis.3,v 1.9 1998/04/28 20:11:36 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1989, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -44,9 +44,9 @@
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <vis.h>
|
||||
.Ft int
|
||||
.Ft int
|
||||
.Fn unvis "char *cp" "char c" "int *astate" "int flag"
|
||||
.Ft int
|
||||
.Ft int
|
||||
.Fn strunvis "char *dst" "char *src"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
@ -58,22 +58,25 @@ are used to decode a visual representation of characters, as produced
|
||||
by the
|
||||
.Xr vis 3
|
||||
function, back into
|
||||
the original form. Unvis is called with successive characters in
|
||||
.Ar c
|
||||
until a valid
|
||||
sequence is recognized, at which time the decoded character is
|
||||
available at the character pointed to by
|
||||
the original form.
|
||||
.Pp
|
||||
The
|
||||
.Fn unvis
|
||||
function is called with successive characters in
|
||||
.Ar c
|
||||
until a valid sequence is recognized, at which time the decoded
|
||||
character is available at the character pointed to by
|
||||
.Ar cp .
|
||||
Strunvis decodes the
|
||||
characters pointed to by
|
||||
.Ar src
|
||||
into the buffer pointed to by
|
||||
.Ar dst .
|
||||
.Pp
|
||||
The
|
||||
.Fn strunvis
|
||||
function
|
||||
simply copies
|
||||
function decodes the characters pointed to by
|
||||
.Ar src
|
||||
into the buffer pointed to by
|
||||
.Ar dst .
|
||||
The
|
||||
.Fn strunvis
|
||||
function simply copies
|
||||
.Ar src
|
||||
to
|
||||
.Ar dst ,
|
||||
@ -81,48 +84,46 @@ decoding any escape sequences along the way,
|
||||
and returns the number of characters placed into
|
||||
.Ar dst ,
|
||||
or \-1 if an
|
||||
invalid escape sequence was detected. The size of
|
||||
invalid escape sequence was detected.
|
||||
The size of
|
||||
.Ar dst
|
||||
should be
|
||||
equal to the size of
|
||||
should be equal to the size of
|
||||
.Ar src
|
||||
(that is, no expansion takes place during
|
||||
decoding).
|
||||
(that is, no expansion takes place during decoding).
|
||||
.Pp
|
||||
The
|
||||
.Fn unvis
|
||||
function
|
||||
implements a state machine that can be used to decode an arbitrary
|
||||
stream of bytes. All state associated with the bytes being decoded
|
||||
is stored outside the
|
||||
function implements a state machine that can be used to decode an
|
||||
arbitrary stream of bytes.
|
||||
All state associated with the bytes being decoded is stored outside the
|
||||
.Fn unvis
|
||||
function (that is, a pointer to the state is passed in), so
|
||||
calls decoding different streams can be freely intermixed. To
|
||||
start decoding a stream of bytes, first initialize an integer
|
||||
to zero. Call
|
||||
calls decoding different streams can be freely intermixed.
|
||||
To start decoding a stream of bytes, first initialize an integer to zero.
|
||||
Call
|
||||
.Fn unvis
|
||||
with each successive byte, along with a pointer
|
||||
to this integer, and a pointer to a destination character.
|
||||
The
|
||||
.Xr unvis
|
||||
function
|
||||
has several return codes that must be handled properly. They are:
|
||||
.Fn unvis
|
||||
function has several return codes that must be handled properly.
|
||||
They are:
|
||||
.Bl -tag -width UNVIS_VALIDPUSH
|
||||
.It Li \&0 (zero)
|
||||
Another character is necessary; nothing has been recognized yet.
|
||||
.It Dv UNVIS_VALID
|
||||
.It Dv UNVIS_VALID
|
||||
A valid character has been recognized and is available at the location
|
||||
pointed to by cp.
|
||||
.It Dv UNVIS_VALIDPUSH
|
||||
.It Dv UNVIS_VALIDPUSH
|
||||
A valid character has been recognized and is available at the location
|
||||
pointed to by cp; however, the character currently passed in should
|
||||
be passed in again.
|
||||
.It Dv UNVIS_NOCHAR
|
||||
A valid sequence was detected, but no character was produced. This
|
||||
return code is necessary to indicate a logical break between characters.
|
||||
.It Dv UNVIS_SYNBAD
|
||||
An invalid escape sequence was detected, or the decoder is in an
|
||||
unknown state. The decoder is placed into the starting state.
|
||||
.It Dv UNVIS_NOCHAR
|
||||
A valid sequence was detected, but no character was produced.
|
||||
This return code is necessary to indicate a logical break between characters.
|
||||
.It Dv UNVIS_SYNBAD
|
||||
An invalid escape sequence was detected, or the decoder is in an unknown state.
|
||||
The decoder is placed into the starting state.
|
||||
.El
|
||||
.Pp
|
||||
When all bytes in the stream have been processed, call
|
||||
@ -163,7 +164,7 @@ if (unvis(&out, (char)0, &state, UNVIS_END) == UNVIS_VALID)
|
||||
.Xr vis 3
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Nm unvis
|
||||
.Fn unvis
|
||||
function
|
||||
first appeared in
|
||||
.Bx 4.4 .
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: utime.3,v 1.11 1998/04/28 04:07:06 fair Exp $
|
||||
.\" $NetBSD: utime.3,v 1.12 1998/04/28 20:11:36 fair Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1980, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
@ -61,30 +61,30 @@ If
|
||||
is
|
||||
.Dv NULL ,
|
||||
the access and modification times are set to the current time.
|
||||
The calling process must be the owner of the file or have permission to
|
||||
The calling process must be the owner of the file or have permission to
|
||||
write the file.
|
||||
.Pp
|
||||
If
|
||||
If
|
||||
.Fa timep
|
||||
is
|
||||
is
|
||||
.Pf non- Dv NULL ,
|
||||
.Fa time
|
||||
is assumed to be a pointer to a utimbuf structure, as defined in
|
||||
.Fa time
|
||||
is assumed to be a pointer to a utimbuf structure, as defined in
|
||||
.Aq Pa utime.h :
|
||||
.Bd -literal -offset indent
|
||||
struct utimbuf {
|
||||
time_t actime; /* Access time */
|
||||
time_t modtime; /* Modification time */
|
||||
} ;
|
||||
};
|
||||
.Ed
|
||||
.Pp
|
||||
The access time is set to the value of the actime member, and the modification
|
||||
time is set to the value of the modtime member. The times are measured in
|
||||
seconds since 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated
|
||||
Universal Time.
|
||||
The access time is set to the value of the actime member, and the
|
||||
modification time is set to the value of the modtime member.
|
||||
The times are measured in seconds since 0 hours, 0 minutes, 0
|
||||
seconds, January 1, 1970 Coordinated Universal Time (UTC).
|
||||
The calling process must be the owner of the file or be the super-user.
|
||||
.Pp
|
||||
In either case, the inode-change-time of the file is set to the current
|
||||
In either case, the inode-change-time of the file is set to the current
|
||||
time.
|
||||
.Sh RETURN VALUES
|
||||
Upon successful completion, a value of 0 is returned.
|
||||
@ -105,7 +105,7 @@ and the effective user ID of the process does not
|
||||
match the owner of the file, and is not the super-user, and write
|
||||
access is denied.
|
||||
.It Bq Er EFAULT
|
||||
.Xr File
|
||||
.Fa file
|
||||
or
|
||||
.Fa times
|
||||
points outside the process's allocated address space.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user