summaryrefslogtreecommitdiff
path: root/share/man
diff options
context:
space:
mode:
Diffstat (limited to 'share/man')
-rw-r--r--share/man/man9/VOP_LOOKUP.95
-rw-r--r--share/man/man9/audio.94
-rw-r--r--share/man/man9/autoconf.95
-rw-r--r--share/man/man9/bus_dma.913
-rw-r--r--share/man/man9/bus_space.918
-rw-r--r--share/man/man9/crypto.97
-rw-r--r--share/man/man9/disk.915
-rw-r--r--share/man/man9/extent.915
-rw-r--r--share/man/man9/fork1.918
-rw-r--r--share/man/man9/kern.93
-rw-r--r--share/man/man9/malloc.98
-rw-r--r--share/man/man9/mbuf_tags.95
-rw-r--r--share/man/man9/pmap.912
-rw-r--r--share/man/man9/pool.95
-rw-r--r--share/man/man9/radio.912
-rw-r--r--share/man/man9/ratecheck.96
-rw-r--r--share/man/man9/shutdownhook_establish.928
-rw-r--r--share/man/man9/uiomove.94
-rw-r--r--share/man/man9/uvm.922
-rw-r--r--share/man/man9/vclean.95
-rw-r--r--share/man/man9/vcount.95
-rw-r--r--share/man/man9/vdevgone.95
-rw-r--r--share/man/man9/vfinddev.95
-rw-r--r--share/man/man9/vflush.95
-rw-r--r--share/man/man9/vget.94
-rw-r--r--share/man/man9/vgone.95
-rw-r--r--share/man/man9/vinvalbuf.95
-rw-r--r--share/man/man9/vnode.97
-rw-r--r--share/man/man9/vput.95
-rw-r--r--share/man/man9/vrecycle.95
-rw-r--r--share/man/man9/vref.94
-rw-r--r--share/man/man9/vrele.94
-rw-r--r--share/man/man9/vwaitforio.96
33 files changed, 143 insertions, 132 deletions
diff --git a/share/man/man9/VOP_LOOKUP.9 b/share/man/man9/VOP_LOOKUP.9
index a7a0c8d0c55..28c1c5a4cab 100644
--- a/share/man/man9/VOP_LOOKUP.9
+++ b/share/man/man9/VOP_LOOKUP.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: VOP_LOOKUP.9,v 1.8 2003/04/30 04:53:18 tedu Exp $
+.\" $OpenBSD: VOP_LOOKUP.9,v 1.9 2003/06/06 20:56:32 jmc Exp $
.\"
.\" Copyright (c) 2003 Ted Unangst
.\" All rights reserved.
@@ -427,7 +427,8 @@ stub call
.Xr vn_lock 9 ,
.Xr vnode 9
.Sh AUTHORS
-This man page was written by Ted Unangst for OpenBSD.
+This man page was written by Ted Unangst for
+.Ox .
.Sh BUGS
The locking discipline is too complex.
Refer to
diff --git a/share/man/man9/audio.9 b/share/man/man9/audio.9
index d07d456813f..e05c264ff98 100644
--- a/share/man/man9/audio.9
+++ b/share/man/man9/audio.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: audio.9,v 1.13 2003/04/15 04:14:29 jmc Exp $
+.\" $OpenBSD: audio.9,v 1.14 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: audio.9,v 1.14 2000/02/11 22:56:15 kleink Exp $
.\"
.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
@@ -306,7 +306,7 @@ should be called with the argument
Calling
.Va intr
will normally initiate another call to
-.Va start_input.
+.Va start_input .
Return 0 on success, otherwise an error code.
.It Dv int halt_output(void *hdl)
is called to abort the output transfer (started by
diff --git a/share/man/man9/autoconf.9 b/share/man/man9/autoconf.9
index 8c78ebe323e..a393d3ec382 100644
--- a/share/man/man9/autoconf.9
+++ b/share/man/man9/autoconf.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: autoconf.9,v 1.3 2003/03/08 23:17:18 jmc Exp $
+.\" $OpenBSD: autoconf.9,v 1.4 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: autoconf.9,v 1.9 2002/02/13 08:18:35 ross Exp $
.\"
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
@@ -206,7 +206,6 @@ typedef int (*cfprint_t)(void *aux, const char *parentname);
#define UNSUPP 2 /* print " not supported" */
.Ed
.Pp
-.Pp
Two special strings,
.Do
not configured
@@ -340,7 +339,7 @@ The autoconfiguration framework itself is implemented within the file
Data structures and function prototypes for the framework are located in
.Pa sys/sys/device.h .
.Sh SEE ALSO
-.Xr config 8 .
+.Xr config 8
.Sh HISTORY
Autoconfiguration first appeared in
.Bx 4.1 .
diff --git a/share/man/man9/bus_dma.9 b/share/man/man9/bus_dma.9
index 546550d9627..1747c3daec6 100644
--- a/share/man/man9/bus_dma.9
+++ b/share/man/man9/bus_dma.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bus_dma.9,v 1.17 2003/04/25 14:31:54 jmc Exp $
+.\" $OpenBSD: bus_dma.9,v 1.18 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: bus_dma.9,v 1.14 2000/06/14 06:49:19 cgd Exp $
.\"
.\" Copyright (c) 1996, 1997, 1998 The NetBSD Foundation, Inc.
@@ -410,7 +410,6 @@ This is to ensure that
.Fn bus_dmamap_load
will never block on resources if the handle was created with
.Dv BUS_DMA_ALLOCNOW .
-.Pp
.Sh SYNCHRONIZATION
.nr nS 1
.Ft void
@@ -779,6 +778,11 @@ above for a description of this flag.
.El
.Sh SEE ALSO
.Xr bus_space 9
+.Sh HISTORY
+The
+.Nm
+interface appeared in
+.Nx 1.3 .
.Sh AUTHORS
The
.Nm
@@ -788,8 +792,3 @@ Additional input on the
.Nm
design was provided by Chris Demetriou, Charles Hannum, Ross Harvey,
Matthew Jacob, Jonathan Stone, and Matt Thomas.
-.Sh HISTORY
-The
-.Nm
-interface appeared in
-.Nx 1.3 .
diff --git a/share/man/man9/bus_space.9 b/share/man/man9/bus_space.9
index 48b92a1b701..fe5c9e94435 100644
--- a/share/man/man9/bus_space.9
+++ b/share/man/man9/bus_space.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bus_space.9,v 1.9 2003/04/16 07:34:57 mickey Exp $
+.\" $OpenBSD: bus_space.9,v 1.10 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: bus_space.9,v 1.15 2000/08/09 03:11:00 tv Exp $
.\"
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
@@ -569,12 +569,13 @@ or delayed.
.It Dv BUS_SPACE_MAP_LINEAR
Try to map the space so that its contents can be accessed linearly via
normal memory access methods (e.g. pointer dereferencing and structure
-accesses). The
+accesses).
+The
.Fn bus_space_vaddr
method can be used to obtain the kernel virtual address of the mapped range.
This is useful when software wants to do direct access to a memory
-device, e.g. a frame buffer. If this flag is specified and linear
-mapping is not possible, the
+device, e.g. a frame buffer.
+If this flag is specified and linear mapping is not possible, the
.Fn bus_space_map
call should fail.
If this
@@ -684,7 +685,8 @@ is called on a handle, all subregions of that handle become invalid.
This method returns the kernel virtual address of a mapped bus space if and
only if it was mapped with the
.Dv BUS_SPACE_MAP_LINEAR
-flag. The range can be accessed by normal (volatile) pointer dereferences.
+flag.
+The range can be accessed by normal (volatile) pointer dereferences.
If mapped with the
.Dv BUS_SPACE_MAP_PREFETCHABLE
flag, the
@@ -1456,7 +1458,9 @@ would also ease translation of the
functions into user space (since mapping in user space would look like
it just used a different bus-specific mapping function).
.El
-.\".Sh COMPATIBILITY
+.Sh SEE ALSO
+.Xr bus_dma 9
+.\".Sh STANDARDS
.\".Pp
.\"The current version of the
.\".Nm
@@ -1505,5 +1509,3 @@ Chris Demetriou wrote this manual page.
.Pp
Niklas Hallqvist did the *_raw_* API for
.Ox .
-.Sh SEE ALSO
-.Xr bus_dma 9
diff --git a/share/man/man9/crypto.9 b/share/man/man9/crypto.9
index c39dadf80e5..681a4e7aaa6 100644
--- a/share/man/man9/crypto.9
+++ b/share/man/man9/crypto.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: crypto.9,v 1.22 2003/04/15 04:14:29 jmc Exp $
+.\" $OpenBSD: crypto.9,v 1.23 2003/06/06 20:56:32 jmc Exp $
.\"
.\" The author of this man page is Angelos D. Keromytis (angelos@cis.upenn.edu)
.\"
@@ -438,7 +438,7 @@ Drivers must first use the
function to acquire a driver identifier, specifying the
.Fa cc_flags
as an argument (normally 0, but software-only drivers should specify
-.Dv CRYPTOCAP_F_SOFTWARE Ns ).
+.Dv CRYPTOCAP_F_SOFTWARE ) .
For each algorithm the driver supports, it must then call
.Fn crypto_register .
The first argument is the driver identifier.
@@ -560,7 +560,8 @@ most of the framework code
.Sh HISTORY
The cryptographic framework first appeared in
.Ox 2.7
-and was written by Angelos D. Keromytis <angelos@openbsd.org>.
+and was written by
+.An Angelos D. Keromytis Aq angelos@openbsd.org .
.Sh BUGS
The framework currently assumes that all the algorithms in a
.Fn crypto_newsession
diff --git a/share/man/man9/disk.9 b/share/man/man9/disk.9
index 175f1dce94b..901dd00d117 100644
--- a/share/man/man9/disk.9
+++ b/share/man/man9/disk.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: disk.9,v 1.20 2003/04/15 04:14:29 jmc Exp $
+.\" $OpenBSD: disk.9,v 1.21 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: disk.9,v 1.2 1996/04/08 20:41:25 jtc Exp $
.\"
.\" Copyright (c) 1995, 1996 Jason R. Thorpe.
@@ -365,12 +365,6 @@ They are located in
.Pa sys/dev/raidframe/ ,
and
.Pa sys/dev/vnd.c .
-.Sh AUTHORS
-The
-.Ox
-generic disk framework was architected and implemented within
-.Nx
-by Jason R. Thorpe <thorpej@NetBSD.ORG>.
.Sh SEE ALSO
.Xr ccd 4 ,
.Xr raid 4 ,
@@ -381,3 +375,10 @@ The
.Ox
generic disk framework first appeared in
.Nx 1.2 .
+.Sh AUTHORS
+The
+.Ox
+generic disk framework was architected and implemented within
+.Nx
+by
+.An Jason R. Thorpe Aq thorpej@NetBSD.ORG .
diff --git a/share/man/man9/extent.9 b/share/man/man9/extent.9
index a9596294bff..add3301c72e 100644
--- a/share/man/man9/extent.9
+++ b/share/man/man9/extent.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: extent.9,v 1.7 2002/08/09 22:42:18 jason Exp $
+.\" $OpenBSD: extent.9,v 1.8 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: extent.9,v 1.15 1999/03/16 00:40:47 garbled Exp $
.\"
.\" Copyright (c) 1996, 1998 The NetBSD Foundation, Inc.
@@ -359,15 +359,16 @@ The i386 bus management code uses the extent manager for managing I/O
ports and I/O memory.
See
.Pa sys/arch/i386/i386/machdep.c .
-.Sh AUTHORS
-The extent manager was designed and implemented by Jason
-R. Thorpe <thorpej@NetBSD.ORG>.
-Matthias Drochner <drochner@zelux6.zel.kfa-juelich.de> contributed to the
-initial testing and optimization of the implementation.
-Chris Demetriou <cgd@NetBSD.ORG> contributed many architectural suggestions.
.Sh SEE ALSO
.Xr ddb 4 ,
.Xr malloc 9
.Sh HISTORY
The extent manager appeared in
.Nx 1.3 .
+.Sh AUTHORS
+The extent manager was designed and implemented by
+.An Jason R. Thorpe Aq thorpej@NetBSD.ORG .
+.An Matthias Drochner Aq drochner@zelux6.zel.kfa-juelich.de
+contributed to the initial testing and optimization of the implementation.
+.An Chris Demetriou Aq cgd@NetBSD.ORG
+contributed many architectural suggestions.
diff --git a/share/man/man9/fork1.9 b/share/man/man9/fork1.9
index 72d1d2d7e72..441f3429278 100644
--- a/share/man/man9/fork1.9
+++ b/share/man/man9/fork1.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: fork1.9,v 1.6 2001/08/03 15:21:17 mpech Exp $
+.\" $OpenBSD: fork1.9,v 1.7 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: fork1.9,v 1.3 1999/03/16 00:40:47 garbled Exp $
.\"
.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
@@ -142,6 +142,14 @@ The limit
on the total number of processes under execution by this
user id would be exceeded.
.El
+.Sh SEE ALSO
+.Xr execve 2 ,
+.Xr fork 2 ,
+.Xr rfork 2 ,
+.Xr vfork 2 ,
+.Xr kthread_create 9 ,
+.Xr pfind 9 ,
+.Xr psignal 9
.Sh CAVEATS
The
.Nm
@@ -154,11 +162,3 @@ The system never uses
with a non-null
.Fa stack ,
so that feature is not even tested.
-.Sh SEE ALSO
-.Xr execve 2 ,
-.Xr fork 2 ,
-.Xr rfork 2 ,
-.Xr vfork 2 ,
-.Xr kthread_create 9 ,
-.Xr pfind 9 ,
-.Xr psignal 9
diff --git a/share/man/man9/kern.9 b/share/man/man9/kern.9
index b3b7ad9cf7c..5bcb0744483 100644
--- a/share/man/man9/kern.9
+++ b/share/man/man9/kern.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: kern.9,v 1.5 2003/06/03 02:08:12 wcobb Exp $
+.\" $OpenBSD: kern.9,v 1.6 2003/06/06 20:56:32 jmc Exp $
.\"
.\" Copyright (c) 2002, 2003 CubeSoft Communications, Inc.
.\" <http://www.csoft.org>
@@ -183,7 +183,6 @@ and
.Fn strncasecmp "const char *s1" "const char *s2" "size_tlen"
.nr nS 0
.Pp
-.Pp
Those functions have the same semantics as their libc counterparts,
.Xr strlen 3 ,
.Xr strcat 3 ,
diff --git a/share/man/man9/malloc.9 b/share/man/man9/malloc.9
index 39c98f9b225..a01e7989bd6 100644
--- a/share/man/man9/malloc.9
+++ b/share/man/man9/malloc.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: malloc.9,v 1.25 2003/04/17 05:08:39 jmc Exp $
+.\" $OpenBSD: malloc.9,v 1.26 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: malloc.9,v 1.2 1996/10/30 05:29:54 lukem Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -126,7 +126,7 @@ Mbuf memory.
.It Dv M_DEVBUF
Device driver memory.
.It Dv M_DEBUG
-.Xr malloc 9
+.Nm malloc
debug structures.
.It Dv M_PCB
Protocol control block.
@@ -290,8 +290,6 @@ and can be examined by using
.Fn malloc
returns a kernel virtual address that is suitably aligned for storage of
any type of object.
-.Sh SEE ALSO
-.Xr vmstat 8
.Sh DIAGNOSTICS
A kernel compiled with the
.Dv DIAGNOSTIC
@@ -397,3 +395,5 @@ Care needs to be taken when using the
option: the memory consumption can run away pretty quickly and there is
a severe performance degradation when allocating and freeing debugged memory
types.
+.Sh SEE ALSO
+.Xr vmstat 8
diff --git a/share/man/man9/mbuf_tags.9 b/share/man/man9/mbuf_tags.9
index 3258dc6d875..9a598ec858d 100644
--- a/share/man/man9/mbuf_tags.9
+++ b/share/man/man9/mbuf_tags.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: mbuf_tags.9,v 1.16 2003/05/13 21:32:26 henning Exp $
+.\" $OpenBSD: mbuf_tags.9,v 1.17 2003/06/06 20:56:32 jmc Exp $
.\"
.\" The author of this man page is Angelos D. Keromytis (angelos@cis.upenn.edu)
.\"
@@ -297,4 +297,5 @@ The tag-manipulating code is contained in the file
.Sh HISTORY
The packet tags first appeared in
.Ox 2.9
-and were written by Angelos D. Keromytis <angelos@openbsd.org>.
+and were written by
+.An Angelos D. Keromytis Aq angelos@openbsd.org .
diff --git a/share/man/man9/pmap.9 b/share/man/man9/pmap.9
index 0465e0729a1..9b3dafd09a0 100644
--- a/share/man/man9/pmap.9
+++ b/share/man/man9/pmap.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: pmap.9,v 1.5 2003/06/02 19:19:49 wcobb Exp $
+.\" $OpenBSD: pmap.9,v 1.6 2003/06/06 20:56:32 jmc Exp $
.\"
.\" Copyright (c) 2001, 2002, 2003 CubeSoft Communications, Inc.
.\" <http://www.csoft.org>
@@ -400,11 +400,6 @@ mappings.
.Sh SEE ALSO
.Xr fork 2 ,
.Xr uvm 9
-.Sh BUGS
-Ifdefs must be documented.
-.Pp
-.Fn pmap_update
-should be mandatory.
.Sh HISTORY
The
.Bx 4.4
@@ -415,3 +410,8 @@ The introduction of
left the
.Nm
interface unchanged for the most part.
+.Sh BUGS
+Ifdefs must be documented.
+.Pp
+.Fn pmap_update
+should be mandatory.
diff --git a/share/man/man9/pool.9 b/share/man/man9/pool.9
index 3dc9d3c0c3a..ebcc6ea7461 100644
--- a/share/man/man9/pool.9
+++ b/share/man/man9/pool.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: pool.9,v 1.23 2003/04/20 20:00:25 jmc Exp $
+.\" $OpenBSD: pool.9,v 1.24 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: pool.9,v 1.18 2001/06/21 11:59:01 wiz Exp $
.\"
.\" Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
@@ -361,4 +361,5 @@ The pool manager first appeared in
.Nx 1.4
and was ported to
.Ox
-by Artur Grabowski <art@openbsd.org>.
+by
+.An Artur Grabowski Aq art@openbsd.org .
diff --git a/share/man/man9/radio.9 b/share/man/man9/radio.9
index 96ed393fa36..3361e223850 100644
--- a/share/man/man9/radio.9
+++ b/share/man/man9/radio.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: radio.9,v 1.6 2003/03/08 23:17:18 jmc Exp $
+.\" $OpenBSD: radio.9,v 1.7 2003/06/06 20:56:32 jmc Exp $
.\" $RuOBSD: radio.9,v 1.3 2001/10/26 05:38:44 form Exp $
.\"
.\" Copyright (c) Maxim Tsyplakov <tm@oganer.net>
@@ -107,6 +107,11 @@ are described in some more detail below.
.Xr rtii 4 ,
.Xr sf2r 4 ,
.Xr sfr 4
+.Sh HISTORY
+The
+.Nm
+device driver appeared in
+.Ox 3.0 .
.Sh AUTHORS
The
.Nm
@@ -116,8 +121,3 @@ and
.An Maxim Tsyplakov Aq tm@oganer.net .
The man page was written by
.An Maxim Tsyplakov Aq tm@oganer.net .
-.Sh HISTORY
-The
-.Nm
-device driver appeared in
-.Ox 3.0 .
diff --git a/share/man/man9/ratecheck.9 b/share/man/man9/ratecheck.9
index da072f5c43f..cb7655c4c66 100644
--- a/share/man/man9/ratecheck.9
+++ b/share/man/man9/ratecheck.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ratecheck.9,v 1.5 2001/08/03 15:21:17 mpech Exp $
+.\" $OpenBSD: ratecheck.9,v 1.6 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: ratecheck.9,v 1.1.2.1 2000/02/18 20:26:43 he Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
@@ -115,7 +115,7 @@ drv_errhandler(int err1, int err2)
drv_err1count++;
if (ratecheck(&drv_lasterr1notice,
&drv_errinterval)) {
- printf("drv: %ld err1 errors occurred",
+ printf("drv: %ld err1 errors occurred",
drv_err1count);
drv_err1count = 0;
}
@@ -127,7 +127,7 @@ drv_errhandler(int err1, int err2)
drv_err2count++;
if (ratecheck(&drv_lasterr2notice,
&drv_errinterval)) {
- printf("drv: %ld err2 errors occurred",
+ printf("drv: %ld err2 errors occurred",
drv_err2count);
drv_err2count = 0;
}
diff --git a/share/man/man9/shutdownhook_establish.9 b/share/man/man9/shutdownhook_establish.9
index 7ebbd3f4a20..a23ce8bbd34 100644
--- a/share/man/man9/shutdownhook_establish.9
+++ b/share/man/man9/shutdownhook_establish.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: shutdownhook_establish.9,v 1.12 2003/03/10 19:56:29 tedu Exp $
+.\" $OpenBSD: shutdownhook_establish.9,v 1.13 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: shutdownhook_establish.9,v 1.1 1995/11/25 21:24:52 perry Exp $
.\"
.\" Copyright (c) 1994 Christopher G. Demetriou
@@ -77,19 +77,6 @@ integrity (because the system could be rebooting after a crash).
Shutdown hooks are, like startup hooks, implemented via the more general
.Xr dohooks 9
API.
-.Sh CAVEATS
-Shutdown hooks should only be used to do what's strictly necessary
-to do to ensure a correct reboot.
-Since shutdown hooks are run even after a panic, a panic caused by a
-shutdown hook will automatically cause the shutdown hook to be run again
-causing an endless loop.
-An example of things that need to be done in a shutdown hook could be
-stopping DMA engines that might corrupt memory when rebooting.
-An example of things that shouldn't be done in a shutdown hook is syncing
-the file systems.
-Once again, since the system could be rebooting because of an internal
-inconsistency, writing down anything to permanent storage or trusting
-the internal state of the system is a very bad idea.
.Sh RETURN VALUES
If successful,
.Fn shutdownhook_establish
@@ -110,5 +97,18 @@ is no longer running.
.Xr dohooks 9 ,
.Xr doshutdownhooks 9 ,
.Xr dostartuphooks 9
+.Sh CAVEATS
+Shutdown hooks should only be used to do what's strictly necessary
+to do to ensure a correct reboot.
+Since shutdown hooks are run even after a panic, a panic caused by a
+shutdown hook will automatically cause the shutdown hook to be run again
+causing an endless loop.
+An example of things that need to be done in a shutdown hook could be
+stopping DMA engines that might corrupt memory when rebooting.
+An example of things that shouldn't be done in a shutdown hook is syncing
+the file systems.
+Once again, since the system could be rebooting because of an internal
+inconsistency, writing down anything to permanent storage or trusting
+the internal state of the system is a very bad idea.
.Sh BUGS
The names are clumsy, at best.
diff --git a/share/man/man9/uiomove.9 b/share/man/man9/uiomove.9
index b3e154d0bdf..994c35d69af 100644
--- a/share/man/man9/uiomove.9
+++ b/share/man/man9/uiomove.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: uiomove.9,v 1.5 2003/03/07 06:21:37 david Exp $
+.\" $OpenBSD: uiomove.9,v 1.6 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: uiomove.9,v 1.6 2001/12/26 00:16:30 wiz Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -67,7 +67,7 @@ struct uio {
off_t uio_offset; /* offset into file this uio corresponds to */
size_t uio_resid; /* residual i/o count */
enum uio_seg uio_segflg;
- enum uio_rw uio_rw;
+ enum uio_rw uio_rw;
struct proc *uio_procp;/* process if UIO_USERSPACE */
};
.Ed
diff --git a/share/man/man9/uvm.9 b/share/man/man9/uvm.9
index 159b4089016..f780d1f22b4 100644
--- a/share/man/man9/uvm.9
+++ b/share/man/man9/uvm.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: uvm.9,v 1.22 2003/05/10 21:57:25 jmc Exp $
+.\" $OpenBSD: uvm.9,v 1.23 2003/06/06 20:56:32 jmc Exp $
.\" $NetBSD: uvm.9,v 1.14 2000/06/29 06:08:44 mrg Exp $
.\"
.\" Copyright (c) 1998 Matthew R. Green
@@ -360,7 +360,7 @@ function allocates and returns a new address space, with ranges from
to
.Fa max ,
setting the pageability of the address space to
-.Fa pageable.
+.Fa pageable .
.Pp
The
.Fn uvmspace_exec
@@ -580,9 +580,7 @@ The
.Fn uvm_km_suballoc
function allocates submap (with the specified
.Fa flags ,
-as described in
-.Xr uvm 9 )
-from
+as described above) from
.Fa map ,
creating a new map if
.Fa submap
@@ -1030,6 +1028,13 @@ were named so UVM could coexist with BSD VM during the early
development stages.
They will be renamed to
.Dq uvm_ .
+.Sh SEE ALSO
+.Xr getloadavg 3 ,
+.Xr kvm 3 ,
+.Xr sysctl 3 ,
+.Xr ddb 4 ,
+.Xr options 4 ,
+.Xr pmap 9
.Sh HISTORY
UVM is a new VM system developed at Washington University in St. Louis
(Missouri).
@@ -1073,10 +1078,3 @@ source tree.
The
.Fn uvm_fork
function should be able to fail in low memory conditions.
-.Sh SEE ALSO
-.Xr getloadavg 3 ,
-.Xr kvm 3 ,
-.Xr sysctl 3 ,
-.Xr ddb 4 ,
-.Xr options 4 ,
-.Xr pmap 9
diff --git a/share/man/man9/vclean.9 b/share/man/man9/vclean.9
index e05ff88e2b9..c528a61d275 100644
--- a/share/man/man9/vclean.9
+++ b/share/man/man9/vclean.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vclean.9,v 1.4 2003/04/20 20:46:14 jmc Exp $
+.\" $OpenBSD: vclean.9,v 1.5 2003/06/06 20:56:32 jmc Exp $
.\"-
.\" Copyright (c) 2002 Peter Werner
.\" All rights reserved.
@@ -74,4 +74,5 @@ and if the vnode was active, it will be placed on the vnode free list.
.Xr vinvalbuf 9 ,
.Xr vnode 9
.Sh HISTORY
-This man page was originally written for OpenBSD.
+This man page was originally written for
+.Ox .
diff --git a/share/man/man9/vcount.9 b/share/man/man9/vcount.9
index af16b0ff08a..20e049efdbe 100644
--- a/share/man/man9/vcount.9
+++ b/share/man/man9/vcount.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vcount.9,v 1.1 2002/02/28 19:22:05 csapuntz Exp $
+.\" $OpenBSD: vcount.9,v 1.2 2003/06/06 20:56:32 jmc Exp $
.\" -*- nroff -*-
.\"
.\" Copyright (c) 2000 Andrew Stevenson
@@ -58,4 +58,5 @@ returns the number of references to the device.
.Sh AUTHORS
This man page was originally written by
.An Andrew Stevenson
-for FreeBSD.
+for
+.Fx .
diff --git a/share/man/man9/vdevgone.9 b/share/man/man9/vdevgone.9
index c9b13e06e0e..18a2932c860 100644
--- a/share/man/man9/vdevgone.9
+++ b/share/man/man9/vdevgone.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vdevgone.9,v 1.2 2003/04/20 20:38:28 jmc Exp $
+.\" $OpenBSD: vdevgone.9,v 1.3 2003/06/06 20:56:32 jmc Exp $
.\"-
.\" Copyright (c) 2002 Peter Werner
.\" All rights reserved.
@@ -75,4 +75,5 @@ are inclusive.
.Sh SEE ALSO
.Xr vfinddev 9
.Sh HISTORY
-This man page was originally written for OpenBSD.
+This man page was originally written for
+.Ox .
diff --git a/share/man/man9/vfinddev.9 b/share/man/man9/vfinddev.9
index a33e99372e1..c108be42d4f 100644
--- a/share/man/man9/vfinddev.9
+++ b/share/man/man9/vfinddev.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vfinddev.9,v 1.2 2003/04/20 20:38:28 jmc Exp $
+.\" $OpenBSD: vfinddev.9,v 1.3 2003/06/06 20:56:32 jmc Exp $
.\"-
.\" Copyright (c) 2002 Peter Werner
.\" All rights reserved.
@@ -56,4 +56,5 @@ will return 1 if a corresponding vnode was found, 0 if otherwise.
.Sh SEE ALSO
.Xr vnode 9
.Sh HISTORY
-This man page was originally written for OpenBSD.
+This man page was originally written for
+.Ox .
diff --git a/share/man/man9/vflush.9 b/share/man/man9/vflush.9
index eb837a501e2..234c9d265a5 100644
--- a/share/man/man9/vflush.9
+++ b/share/man/man9/vflush.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vflush.9,v 1.1 2002/02/28 19:22:05 csapuntz Exp $
+.\" $OpenBSD: vflush.9,v 1.2 2003/06/06 20:56:32 jmc Exp $
.\"
.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
.\"
@@ -75,4 +75,5 @@ will be returned.
.Sh AUTHORS
This man page was originally written by
.An Chad David Aq davidc@acns.ab.ca
-for FreeBSD.
+for
+.Fx .
diff --git a/share/man/man9/vget.9 b/share/man/man9/vget.9
index 4714e21e452..193e9339924 100644
--- a/share/man/man9/vget.9
+++ b/share/man/man9/vget.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vget.9,v 1.4 2003/04/20 20:38:28 jmc Exp $
+.\" $OpenBSD: vget.9,v 1.5 2003/06/06 20:56:32 jmc Exp $
.\" -*- nroff -*-
.\"
.\" Copyright (c) 1996 Doug Rabson
@@ -60,7 +60,7 @@ When a vnode which is on the free list is used again, for instance if
the vnode was found in the name cache as a result of a call to
.Xr VOP_LOOKUP 9 ,
then the new user must call
-.Xr vget 9
+.Fn vget
to increment the reference count and remove it from the free list.
.Sh ERRORS
.Bl -tag -width Er
diff --git a/share/man/man9/vgone.9 b/share/man/man9/vgone.9
index 101c6ec1b3a..ce8a9a279ff 100644
--- a/share/man/man9/vgone.9
+++ b/share/man/man9/vgone.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vgone.9,v 1.3 2003/03/10 19:56:29 tedu Exp $
+.\" $OpenBSD: vgone.9,v 1.4 2003/06/06 20:56:32 jmc Exp $
.\"
.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
.\"
@@ -66,4 +66,5 @@ expects the interlock to already be locked.
.Sh AUTHORS
This man page was originally written by
.An Chad David Aq davidc@acns.ab.ca
-for FreeBSD.
+for
+.Fx .
diff --git a/share/man/man9/vinvalbuf.9 b/share/man/man9/vinvalbuf.9
index 91863f9fa29..140056fe74f 100644
--- a/share/man/man9/vinvalbuf.9
+++ b/share/man/man9/vinvalbuf.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vinvalbuf.9,v 1.4 2003/04/20 20:38:28 jmc Exp $
+.\" $OpenBSD: vinvalbuf.9,v 1.5 2003/06/06 20:56:32 jmc Exp $
.\"
.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
.\"
@@ -122,4 +122,5 @@ set in
.Sh AUTHORS
This man page was originally written by
.An Chad David Aq davidc@acns.ab.ca
-for FreeBSD.
+for
+.Fx .
diff --git a/share/man/man9/vnode.9 b/share/man/man9/vnode.9
index 75c6c3775f4..06d5b15237f 100644
--- a/share/man/man9/vnode.9
+++ b/share/man/man9/vnode.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vnode.9,v 1.17 2003/04/20 20:46:14 jmc Exp $
+.\" $OpenBSD: vnode.9,v 1.18 2003/06/06 20:56:32 jmc Exp $
.\"
.\" Copyright (c) 2001 Constantine Sapuntzakis
.\" All rights reserved.
@@ -24,8 +24,8 @@
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd February 22, 2001
-.Dt vnode 9
-.Os OpenBSD 2.9
+.Dt VNODE 9
+.Os
.Sh NAME
.Nm vnode
.Nd an overview of vnodes
@@ -244,4 +244,3 @@ Any access to these fields should be protected by splbio.
.Sh HISTORY
This document first appeared in
.Ox 2.9 .
-
diff --git a/share/man/man9/vput.9 b/share/man/man9/vput.9
index 1a11487fc5d..583d1c33e64 100644
--- a/share/man/man9/vput.9
+++ b/share/man/man9/vput.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vput.9,v 1.2 2003/03/12 20:41:30 tedu Exp $
+.\" $OpenBSD: vput.9,v 1.3 2003/06/06 20:56:32 jmc Exp $
.\" -*- nroff -*-
.\"
.\" Copyright (c) 1996 Doug Rabson
@@ -60,4 +60,5 @@ followed by
.Sh AUTHORS
This man page was originally written by
.An Doug Rabson
-for FreeBSD.
+for
+.Fx .
diff --git a/share/man/man9/vrecycle.9 b/share/man/man9/vrecycle.9
index 6fb45e6e06d..98d02013ce4 100644
--- a/share/man/man9/vrecycle.9
+++ b/share/man/man9/vrecycle.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vrecycle.9,v 1.4 2003/04/20 20:38:28 jmc Exp $
+.\" $OpenBSD: vrecycle.9,v 1.5 2003/06/06 20:56:32 jmc Exp $
.\"-
.\" Copyright (c) 2002 Peter Werner
.\" All rights reserved.
@@ -63,4 +63,5 @@ will still be locked.
.Xr vgonel 9 ,
.Xr vnode 9
.Sh HISTORY
-This man page was originally written for OpenBSD.
+This man page was originally written for
+.Ox .
diff --git a/share/man/man9/vref.9 b/share/man/man9/vref.9
index 7d180ce3350..f8496128d96 100644
--- a/share/man/man9/vref.9
+++ b/share/man/man9/vref.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vref.9,v 1.2 2002/05/28 09:07:07 mpech Exp $
+.\" $OpenBSD: vref.9,v 1.3 2003/06/06 20:56:32 jmc Exp $
.\" -*- nroff -*-
.\"
.\" Copyright (c) 1996 Doug Rabson
@@ -57,7 +57,7 @@ no longer being used and can be safely recycled for a different file.
Any code in the system which is using a vnode (e.g. during the
operation of some algorithm or to store in a data structure) should
call
-.Xr vref 9 .
+.Fn vref .
.Sh SEE ALSO
.Xr vget 9 ,
.Xr vnode 9 ,
diff --git a/share/man/man9/vrele.9 b/share/man/man9/vrele.9
index 2a4d7c74501..4d843d88f53 100644
--- a/share/man/man9/vrele.9
+++ b/share/man/man9/vrele.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vrele.9,v 1.2 2002/05/28 09:07:07 mpech Exp $
+.\" $OpenBSD: vrele.9,v 1.3 2003/06/06 20:56:32 jmc Exp $
.\" -*- nroff -*-
.\"
.\" Copyright (c) 1996 Doug Rabson
@@ -50,7 +50,7 @@ the vnode to decrement
.El
.Pp
Any code in the system which is using a vnode should call
-.Xr vrele 9
+.Fn vrele
when it is finished with the vnode.
If the
.Dv v_usecount
diff --git a/share/man/man9/vwaitforio.9 b/share/man/man9/vwaitforio.9
index bdd266d131d..f0c7f06c883 100644
--- a/share/man/man9/vwaitforio.9
+++ b/share/man/man9/vwaitforio.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vwaitforio.9,v 1.8 2003/04/20 20:38:28 jmc Exp $
+.\" $OpenBSD: vwaitforio.9,v 1.9 2003/06/06 20:56:32 jmc Exp $
.\"
.\" Copyright (c) 2001 Constantine Sapuntzakis
.\" All rights reserved.
@@ -24,8 +24,8 @@
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd February 26, 2001
-.Dt vwaitforio 9
-.Os OpenBSD 2.9
+.Dt VWAITFORIO 9
+.Os
.Sh NAME
.Nm vwaitforio
.Nd wait for all outstanding asynchronous writes