summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGlen Barber <gjb@FreeBSD.org>2012-05-20 16:43:47 +0000
committerGlen Barber <gjb@FreeBSD.org>2012-05-20 16:43:47 +0000
commit73bbeaa52983176108b99fe246560723b55e5cf4 (patch)
tree2d2b6ffdd22892425efddd4706b859d4be51bfc3
parentf22377a8c7377ab1e4b5410db09f92dda9c62016 (diff)
Notes
-rw-r--r--share/man/man9/BUF_ISLOCKED.92
-rw-r--r--share/man/man9/DB_COMMAND.92
-rw-r--r--share/man/man9/VOP_GETEXTATTR.94
-rw-r--r--share/man/man9/VOP_GETPAGES.92
-rw-r--r--share/man/man9/VOP_GETVOBJECT.92
-rw-r--r--share/man/man9/VOP_SETEXTATTR.92
-rw-r--r--share/man/man9/acl.92
-rw-r--r--share/man/man9/bus_generic_print_child.92
-rw-r--r--share/man/man9/bus_release_resource.92
-rw-r--r--share/man/man9/bus_space.93
-rw-r--r--share/man/man9/byteorder.92
-rw-r--r--share/man/man9/devclass_get_maxunit.92
-rw-r--r--share/man/man9/device_find_child.92
-rw-r--r--share/man/man9/firmware.98
-rw-r--r--share/man/man9/hashinit.92
-rw-r--r--share/man/man9/ieee80211_proto.92
-rw-r--r--share/man/man9/ifnet.92
-rw-r--r--share/man/man9/kqueue.93
-rw-r--r--share/man/man9/lock.92
-rw-r--r--share/man/man9/locking.95
-rw-r--r--share/man/man9/mbuf.96
-rw-r--r--share/man/man9/mod_cc.92
-rw-r--r--share/man/man9/netisr.92
-rw-r--r--share/man/man9/pci.910
-rw-r--r--share/man/man9/spl.93
-rw-r--r--share/man/man9/sysctl.92
-rw-r--r--share/man/man9/taskqueue.94
-rw-r--r--share/man/man9/usbdi.92
-rw-r--r--share/man/man9/vm_page_aflag.92
29 files changed, 46 insertions, 40 deletions
diff --git a/share/man/man9/BUF_ISLOCKED.9 b/share/man/man9/BUF_ISLOCKED.9
index d55f2f5d0056..597038881fc3 100644
--- a/share/man/man9/BUF_ISLOCKED.9
+++ b/share/man/man9/BUF_ISLOCKED.9
@@ -52,7 +52,7 @@ It can return:
.It Dv LK_EXCLUSIVE
An exclusive lock is held by curthread.
.It Dv LK_EXCLOTHER
-An exclusive lock is held by someone other than curthread
+An exclusive lock is held by someone other than curthread.
.It Dv LK_SHARED
A shared lock is held.
.It Li 0
diff --git a/share/man/man9/DB_COMMAND.9 b/share/man/man9/DB_COMMAND.9
index bcb550c25e5e..179f3f3181a4 100644
--- a/share/man/man9/DB_COMMAND.9
+++ b/share/man/man9/DB_COMMAND.9
@@ -32,7 +32,7 @@
.Nm DB_COMMAND ,
.Nm DB_SHOW_COMMAND ,
.Nm DB_SHOW_ALL_COMMAND
-.Nd Extends the ddb command set.
+.Nd Extends the ddb command set
.Sh SYNOPSIS
.In ddb/ddb.h
.Fo DB_COMMAND
diff --git a/share/man/man9/VOP_GETEXTATTR.9 b/share/man/man9/VOP_GETEXTATTR.9
index e3abcb9275d9..998ed2c4651a 100644
--- a/share/man/man9/VOP_GETEXTATTR.9
+++ b/share/man/man9/VOP_GETEXTATTR.9
@@ -71,7 +71,7 @@ will be
.Dv NULL
when
.Fa size
-is not, and vise versa.
+is not, and vice versa.
.It Fa cred
The user credentials to use in authorizing the request.
.It Fa td
@@ -113,7 +113,7 @@ The uio structure refers to an invalid userspace address.
.It Bq Er EINVAL
The
.Fa name ,
-.Fa namespace,
+.Fa namespace ,
or
.Fa uio
argument is invalid.
diff --git a/share/man/man9/VOP_GETPAGES.9 b/share/man/man9/VOP_GETPAGES.9
index e490862045f6..b165162f3946 100644
--- a/share/man/man9/VOP_GETPAGES.9
+++ b/share/man/man9/VOP_GETPAGES.9
@@ -115,7 +115,7 @@ The page could not be written because of an error on the underlying storage
medium or protocol.
.It Dv VM_PAGER_FAIL
Treated identically to
-.Dv VM_PAGER_ERROR
+.Dv VM_PAGER_ERROR .
.It Dv VM_PAGER_AGAIN
The page was not handled by this request.
.El
diff --git a/share/man/man9/VOP_GETVOBJECT.9 b/share/man/man9/VOP_GETVOBJECT.9
index 2490da710b57..47741d1225be 100644
--- a/share/man/man9/VOP_GETVOBJECT.9
+++ b/share/man/man9/VOP_GETVOBJECT.9
@@ -53,7 +53,7 @@ The vnode of the file.
The VM object being returned, or
.Dv NULL
if the caller wants to test for the existence
-of the VM object).
+of the VM object.
.El
.Pp
.Xr VFS 9
diff --git a/share/man/man9/VOP_SETEXTATTR.9 b/share/man/man9/VOP_SETEXTATTR.9
index 29f8cc27650a..edae937b5af7 100644
--- a/share/man/man9/VOP_SETEXTATTR.9
+++ b/share/man/man9/VOP_SETEXTATTR.9
@@ -96,7 +96,7 @@ The caller does not have the appropriate privilege.
The request was not valid in this file system for the specified vnode and
attribute name.
.It Bq Er ENOMEM
-Insufficient memory available to fulfill request
+Insufficient memory available to fulfill the request.
.It Bq Er EFAULT
The uio structure refers to an invalid userspace address.
.It Bq Er EINVAL
diff --git a/share/man/man9/acl.9 b/share/man/man9/acl.9
index 21640bd7b86f..c6c715918011 100644
--- a/share/man/man9/acl.9
+++ b/share/man/man9/acl.9
@@ -210,7 +210,7 @@ The following values are valid:
.Xr vaccess_acl_nfs4 9 ,
.Xr vaccess_acl_posix1e 9 ,
.Xr VFS 9 ,
-.Xr vnaccess 9 ,
+.Xr vaccess 9 ,
.Xr VOP_ACLCHECK 9 ,
.Xr VOP_GETACL 9 ,
.Xr VOP_SETACL 9
diff --git a/share/man/man9/bus_generic_print_child.9 b/share/man/man9/bus_generic_print_child.9
index 80a04ff3d506..388c0a0fb357 100644
--- a/share/man/man9/bus_generic_print_child.9
+++ b/share/man/man9/bus_generic_print_child.9
@@ -51,7 +51,7 @@ foo0: <FooCard 1234> on bar0
bus_generic_print_child itself calls two functions
.Fn bus_print_child_header
and
-.Fn bus_print_child_footer
+.Fn bus_print_child_footer .
The former prints "foo0: <FooCard 1234>" and the latter "on bar0".
These routines should be used if possible in your own code if
.Fn bus_generic_print_child
diff --git a/share/man/man9/bus_release_resource.9 b/share/man/man9/bus_release_resource.9
index 68187ccc7872..35e70d994a10 100644
--- a/share/man/man9/bus_release_resource.9
+++ b/share/man/man9/bus_release_resource.9
@@ -71,7 +71,7 @@ value must be the same as the one returned by
.It
.Fa r
is the pointer to
-.Va struct res ,
+.Va struct resource ,
i.e., the resource itself,
returned by
.Xr bus_alloc_resource 9 .
diff --git a/share/man/man9/bus_space.9 b/share/man/man9/bus_space.9
index 0f0425a61464..6bf03b45209c 100644
--- a/share/man/man9/bus_space.9
+++ b/share/man/man9/bus_space.9
@@ -1380,7 +1380,8 @@ functions may be executed in any order.
They may also be executed out
of order with respect to other pending read and write operations unless
order is enforced by use of the
-.Fn bus_space_barrier function .
+.Fn bus_space_barrier
+function.
There is no way to insert barriers between reads or writes of
individual bus space locations executed by the
.Fn bus_space_copy_region_N
diff --git a/share/man/man9/byteorder.9 b/share/man/man9/byteorder.9
index 20e31362a36c..e5737f6afe79 100644
--- a/share/man/man9/byteorder.9
+++ b/share/man/man9/byteorder.9
@@ -158,7 +158,7 @@ in big/little endian format.
The
.Fn hto*
and
-.Fn toh*
+.Fn *toh
functions first appeared in
.Fx 5.0 ,
and were originally developed by the
diff --git a/share/man/man9/devclass_get_maxunit.9 b/share/man/man9/devclass_get_maxunit.9
index c3be62785c29..40a2d7929815 100644
--- a/share/man/man9/devclass_get_maxunit.9
+++ b/share/man/man9/devclass_get_maxunit.9
@@ -49,7 +49,7 @@ The
function returns -1 if
.Fa dc
is
-.Dv NULL;
+.Dv NULL ,
otherwise it returns the next unit
number in
.Fa dc's
diff --git a/share/man/man9/device_find_child.9 b/share/man/man9/device_find_child.9
index a23b2b2a145a..391f44b7bb9f 100644
--- a/share/man/man9/device_find_child.9
+++ b/share/man/man9/device_find_child.9
@@ -41,7 +41,7 @@
.Fn device_find_child "device_t dev" "const char *classname" "int unit"
.Sh DESCRIPTION
This function looks for a specific child of
-.Dv dev .
+.Dv dev
with the given
.Fa classname
and
diff --git a/share/man/man9/firmware.9 b/share/man/man9/firmware.9
index 9987e09c2ac1..0f4fa9af67e9 100644
--- a/share/man/man9/firmware.9
+++ b/share/man/man9/firmware.9
@@ -101,11 +101,13 @@ they want as an argument. If a matching image is not already registered,
the firmware subsystem will try to load it using the
mechanisms specified below (typically, a kernel module
with
-.Nm the same name
+.Nm
+the same name
as the image).
.Sh API DESCRIPTION
The kernel
-.Nm firmware API
+.Nm
+firmware API
is made of the following functions:
.Pp
.Fn firmware_register
@@ -225,7 +227,7 @@ in the module, the imagename and version of each firmware image.
If you need to embed firmware images into a system, you should write
appropriate entries in the <files.arch> file, e.g. this example is
from
-.Nm sys/arm/xscale/ixp425/files.ixp425:
+.Nm sys/arm/xscale/ixp425/files.ixp425 :
.Bd -literal
ixp425_npe_fw.c optional npe_fw \\
compile-with "${AWK} -f $S/tools/fw_stub.awk \\
diff --git a/share/man/man9/hashinit.9 b/share/man/man9/hashinit.9
index d186dcfe18e2..b72cd7551195 100644
--- a/share/man/man9/hashinit.9
+++ b/share/man/man9/hashinit.9
@@ -29,7 +29,7 @@
.Dt HASHINIT 9
.Os
.Sh NAME
-.Nm hashinit , hashinit_flags, hashdestroy , phashinit
+.Nm hashinit , hashinit_flags , hashdestroy , phashinit
.Nd manage kernel hash tables
.Sh SYNOPSIS
.In sys/malloc.h
diff --git a/share/man/man9/ieee80211_proto.9 b/share/man/man9/ieee80211_proto.9
index 88412eb35333..6b0da064d811 100644
--- a/share/man/man9/ieee80211_proto.9
+++ b/share/man/man9/ieee80211_proto.9
@@ -238,4 +238,4 @@ work will be initiated outside the driver.
The state machine concept was part of the original
.Nm ieee80211
code base that first appeared in
-.Nx 1.5 ,
+.Nx 1.5 .
diff --git a/share/man/man9/ifnet.9 b/share/man/man9/ifnet.9
index dd4fdf53e66c..1059c889c620 100644
--- a/share/man/man9/ifnet.9
+++ b/share/man/man9/ifnet.9
@@ -637,7 +637,7 @@ interfaces registered at the interface list.
.Aq D
This interface blocks transmission of packets and discards incoming
packets after BPF processing.
-Used to monitor network trafic but not interact
+Used to monitor network traffic but not interact
with the network in question.
.It Dv IFF_STATICARP
.Aq D
diff --git a/share/man/man9/kqueue.9 b/share/man/man9/kqueue.9
index 555fe545e611..29ae5f7a76ae 100644
--- a/share/man/man9/kqueue.9
+++ b/share/man/man9/kqueue.9
@@ -260,8 +260,7 @@ is not required, but is commonly used.
If used, the
.Vt knlist
must be initialized with either
-.Fn knlist_init
-,
+.Fn knlist_init ,
.Fn knlist_init_mtx
or
.Fn knlist_init_rw_reader .
diff --git a/share/man/man9/lock.9 b/share/man/man9/lock.9
index 0e5cfb153731..bbcf5e810825 100644
--- a/share/man/man9/lock.9
+++ b/share/man/man9/lock.9
@@ -230,7 +230,7 @@ and
The
.Fn lockmgr_disown
function switches the owner from the current thread to be
-.Dv LK_KERNPROC,
+.Dv LK_KERNPROC ,
if the lock is already held.
.Pp
The
diff --git a/share/man/man9/locking.9 b/share/man/man9/locking.9
index 871dffe934fb..6a0107f2e426 100644
--- a/share/man/man9/locking.9
+++ b/share/man/man9/locking.9
@@ -315,8 +315,7 @@ and reacquire it on wakeup (e.g.
.Fn mtx_sleep ,
.Fn rw_sleep
and
-.Fn msleep_spin
-).
+.Fn msleep_spin ) .
.Pp
.Em *4
Though one can sleep holding an sx lock, one can also use
@@ -358,6 +357,6 @@ These
functions appeared in
.Bsx 4.1
through
-.Fx 7.0
+.Fx 7.0 .
.Sh BUGS
There are too many locking primitives to choose from.
diff --git a/share/man/man9/mbuf.9 b/share/man/man9/mbuf.9
index b029c5219ce9..5c940290886d 100644
--- a/share/man/man9/mbuf.9
+++ b/share/man/man9/mbuf.9
@@ -403,7 +403,8 @@ for details.
Associate externally managed data with
.Fa mbuf .
Any internal data contained in the mbuf will be discarded, and the
-.Dv M_EXT flag will be set.
+.Dv M_EXT
+flag will be set.
The
.Fa buf
and
@@ -722,7 +723,8 @@ are contiguous and lay in the data area of
.Fa mbuf ,
so they are accessible with
.Fn mtod mbuf type .
-.Fa len must be smaller than, or equal to, the size of an
+.Fa len
+must be smaller than, or equal to, the size of an
.Vt mbuf cluster .
Return a pointer to an intermediate
.Vt mbuf
diff --git a/share/man/man9/mod_cc.9 b/share/man/man9/mod_cc.9
index 75e2db039b56..d753a3c125d8 100644
--- a/share/man/man9/mod_cc.9
+++ b/share/man/man9/mod_cc.9
@@ -287,7 +287,7 @@ The CCF_CWND_LIMITED flag is relevant in
.Va ack_received
and is set when the connection's ability to send data is currently constrained
by the value of the congestion window.
-Algorithms should use the abscence of this flag being set to avoid accumulating
+Algorithms should use the absence of this flag being set to avoid accumulating
a large difference between the congestion window and send window.
.Sh SEE ALSO
.Xr cc_chd 4 ,
diff --git a/share/man/man9/netisr.9 b/share/man/man9/netisr.9
index bb64b0eb2c85..4377e02d03cf 100644
--- a/share/man/man9/netisr.9
+++ b/share/man/man9/netisr.9
@@ -78,7 +78,7 @@ and may also manage queue limits and statistics using the
.Fn netisr_getqdrops ,
.Fn netisr_getqlimit ,
and
-.Fn netisr_setqlimit.
+.Fn netisr_setqlimit .
.Pp
.Nm
supports multi-processor execution of handlers, and relies on a combination
diff --git a/share/man/man9/pci.9 b/share/man/man9/pci.9
index 4089ee8430ed..adc78b53f09f 100644
--- a/share/man/man9/pci.9
+++ b/share/man/man9/pci.9
@@ -488,7 +488,7 @@ The
.Fn pci_count_msi
function returns the maximum number of MSI messages supported by the
device
-.Fa dev.
+.Fa dev .
If the device does not support MSI,
then
.Fn pci_count_msi
@@ -567,7 +567,8 @@ is set to the number of messages allocated and
returns zero.
For MSI-X messages,
the resource ID for each
-.Dv SYS_RES_IRQ resource identifies the index in the MSI-X table of the
+.Dv SYS_RES_IRQ
+resource identifies the index in the MSI-X table of the
corresponding message.
A resource ID of one maps to the first index of the MSI-X table;
a resource ID two identifies the second index in the table, etc.
@@ -608,7 +609,7 @@ A driver may use a different distribution of available messages to
table entries via the
.Fn pci_remap_msix
function.
-Note that this function must be called after a succesful call to
+Note that this function must be called after a successful call to
.Fn pci_alloc_msix
but before any of the
.Dv SYS_RES_IRQ
@@ -649,7 +650,8 @@ above for
.Fn pci_alloc_msix .
MSI-X table entries that with a vector of zero will not have an
associated
-.Dv SYS_RES_IRQ resource.
+.Dv SYS_RES_IRQ
+resource.
Additionally,
if any of the original messages allocated by
.Fn pci_alloc_msix
diff --git a/share/man/man9/spl.9 b/share/man/man9/spl.9
index a71918c88a56..3bfa556d4b78 100644
--- a/share/man/man9/spl.9
+++ b/share/man/man9/spl.9
@@ -220,7 +220,8 @@ the system.
The historical number scheme can be considered as a
simple linearly ordered set of interrupt priority groups.
.Pp
-.Fx 5.0 eliminated spl entirely in favor of locking primitives which scale
+.Fx 5.0
+eliminated spl entirely in favor of locking primitives which scale
to more than one processor.
.Sh AUTHORS
This manual page was written by
diff --git a/share/man/man9/sysctl.9 b/share/man/man9/sysctl.9
index d58573b247a2..5399b5681d05 100644
--- a/share/man/man9/sysctl.9
+++ b/share/man/man9/sysctl.9
@@ -107,7 +107,7 @@ This is a 64-bit signed integer.
This is an opaque data structure.
.It Dv CTLTYPE_STRUCT
Alias for
-.Dv CTLTYPE_OPAQUE.
+.Dv CTLTYPE_OPAQUE .
.It Dv CTLTYPE_UINT
This is an unsigned integer.
.It Dv CTLTYPE_LONG
diff --git a/share/man/man9/taskqueue.9 b/share/man/man9/taskqueue.9
index 319aa2f23bfe..f1a43b609cfb 100644
--- a/share/man/man9/taskqueue.9
+++ b/share/man/man9/taskqueue.9
@@ -189,8 +189,8 @@ The
count is cleared, and the old value returned in the reference
parameter
.Fa pendp ,
-if it is non-
-.Dv NULL .
+if it is
+.Pf non- Dv NULL .
If the task is currently running,
.Dv EBUSY
is returned, otherwise 0.
diff --git a/share/man/man9/usbdi.9 b/share/man/man9/usbdi.9
index 72fec96f04e0..03cc3057b821 100644
--- a/share/man/man9/usbdi.9
+++ b/share/man/man9/usbdi.9
@@ -524,7 +524,7 @@ executed on the USB control endpoint.
.
This flag can be changed during operation.
.Pp
-"BOF" is short for "Block On Failure"
+"BOF" is short for "Block On Failure".
.Pp
NOTE: This flag should be set on all BULK and INTERRUPT USB transfers
which use an endpoint that can be shared between userland and kernel.
diff --git a/share/man/man9/vm_page_aflag.9 b/share/man/man9/vm_page_aflag.9
index 8ef5d8703c9f..4500bd2d69cc 100644
--- a/share/man/man9/vm_page_aflag.9
+++ b/share/man/man9/vm_page_aflag.9
@@ -27,7 +27,7 @@
.\" $FreeBSD$
.\"
.Dd August 31, 2011
-.Dt VM_PAGE_FLAG 9
+.Dt VM_PAGE_AFLAG 9
.Os
.Sh NAME
.Nm vm_page_aflag_clear , vm_page_aflag_set , vm_page_reference