summaryrefslogtreecommitdiffstats
path: root/share/man/man9
diff options
context:
space:
mode:
authorsheldonh <sheldonh@FreeBSD.org>2000-03-03 14:05:08 +0000
committersheldonh <sheldonh@FreeBSD.org>2000-03-03 14:05:08 +0000
commit88dd9b4faa11f5f0aa21cbd43fb72503a67b4229 (patch)
tree69062af71195d869d2c940c1869ddf1621cbabfb /share/man/man9
parent1b7dce690e9fb2a298fb1e3bedc8186e71b877a3 (diff)
downloadFreeBSD-src-88dd9b4faa11f5f0aa21cbd43fb72503a67b4229.zip
FreeBSD-src-88dd9b4faa11f5f0aa21cbd43fb72503a67b4229.tar.gz
Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
Diffstat (limited to 'share/man/man9')
-rw-r--r--share/man/man9/VFS_MOUNT.93
-rw-r--r--share/man/man9/device.93
-rw-r--r--share/man/man9/device_set_desc.96
-rw-r--r--share/man/man9/kernacc.96
-rw-r--r--share/man/man9/malloc.93
-rw-r--r--share/man/man9/mi_switch.918
-rw-r--r--share/man/man9/microtime.96
-rw-r--r--share/man/man9/microuptime.96
-rw-r--r--share/man/man9/physio.918
-rw-r--r--share/man/man9/psignal.915
10 files changed, 56 insertions, 28 deletions
diff --git a/share/man/man9/VFS_MOUNT.9 b/share/man/man9/VFS_MOUNT.9
index a202935..5756228 100644
--- a/share/man/man9/VFS_MOUNT.9
+++ b/share/man/man9/VFS_MOUNT.9
@@ -68,7 +68,8 @@ flag is set in
then the filesystem should update its internal state from the value of
.Fa mp->mnt_flag .
This can be used, for instance, to convert a read-only filesystem to
-read-write. It is also used by
+read-write.
+It is also used by
.Xr mountd 8
to update the NFS export information for the filesystem.
.Pp
diff --git a/share/man/man9/device.9 b/share/man/man9/device.9
index 0251016e..6de5e9e 100644
--- a/share/man/man9/device.9
+++ b/share/man/man9/device.9
@@ -49,7 +49,8 @@ the system (ISA, PCI etc.) will be attached directly to
.Dv root_bus
and other devices will be added as children of their relevant bus.
.Pp
-The devices in a system form a tree. All devices except
+The devices in a system form a tree.
+All devices except
.Dv root_bus
have a parent (see
.Xr device_get_parent 9 ).
diff --git a/share/man/man9/device_set_desc.9 b/share/man/man9/device_set_desc.9
index 9ca746e..fae5839 100644
--- a/share/man/man9/device_set_desc.9
+++ b/share/man/man9/device_set_desc.9
@@ -49,10 +49,12 @@
.Pp
Manipulate the verbose description of a device. This description (if
present) is printed as part of the message when it is attached during
-autoconfiguration. The variation
+autoconfiguration.
+The variation
.Xr device_set_desc_copy 9
is used to set the description if the string passed is a temporary
-buffer which will be overwritten. In this case, the system will copy
+buffer which will be overwritten.
+In this case, the system will copy
the string, otherwise the pointer passed will be used directly.
.Sh SEE ALSO
.Xr device 9
diff --git a/share/man/man9/kernacc.9 b/share/man/man9/kernacc.9
index 06d412b..ab83a94 100644
--- a/share/man/man9/kernacc.9
+++ b/share/man/man9/kernacc.9
@@ -74,7 +74,8 @@ checks addresses in the kernel address space, while
.Fn useracc
considers
.Fa addr
-to represent an user space address. The process context to use for this
+to represent an user space address.
+The process context to use for this
operation is taken from the global variable
.Va curproc .
.Pp
@@ -82,7 +83,8 @@ operation is taken from the global variable
Both functions return boolean true if the type of access specified
by
.Fa rw
-is permitted. Otherwise boolean false is returned.
+is permitted.
+Otherwise boolean false is returned.
.Pp
.Sh BUGS
The process pointer should be passed in as an argument to
diff --git a/share/man/man9/malloc.9 b/share/man/man9/malloc.9
index e3ff35e..15b1b56 100644
--- a/share/man/man9/malloc.9
+++ b/share/man/man9/malloc.9
@@ -199,7 +199,8 @@ such things as writing outside the allocated area and imbalanced calls to the
.Fn malloc
and
.Fn free
-functions. Failing consistency checks will cause a panic or a system console
+functions.
+Failing consistency checks will cause a panic or a system console
message:
.Bl -bullet -offset indent -compact
.Pp
diff --git a/share/man/man9/mi_switch.9 b/share/man/man9/mi_switch.9
index d4af1f3..638d3a3 100644
--- a/share/man/man9/mi_switch.9
+++ b/share/man/man9/mi_switch.9
@@ -54,7 +54,8 @@
The
.Fn mi_switch
function implements the machine independent prelude to a process context
-switch. It is called from only a few distinguished places in the kernel
+switch.
+It is called from only a few distinguished places in the kernel
code as a result of the principle of non-preemtable kernel mode execution.
The three major uses of
.Nm
@@ -70,10 +71,12 @@ available.
.It
after handling a trap
.Pq e.g. a system call, device interrupt
-when the kernel prepares a return to user-mode execution. This case is
+when the kernel prepares a return to user-mode execution.
+This case is
typically handled by machine dependent trap-handling code after detection
of a change in the signal disposition of the current process, or when a
-higher priority process might be available to run. The latter event is
+higher priority process might be available to run.
+The latter event is
communicated by the machine independent scheduling routines by calling
the machine defined
.Fn need_resched .
@@ -101,7 +104,8 @@ which will perform the actual process context switch.
.Pp
.Fn cpu_switch
will make a choice amongst the processes which are ready to run from a
-priority queue data-structure. The priority queue consists of an array
+priority queue data-structure.
+The priority queue consists of an array
.Va qs[NQS]
of queue header structures each of which identifies a list of runnable
processes of equal priority
@@ -122,8 +126,10 @@ If no processes are available on the run queues,
.Fn cpu_switch
shall go into an
.Dq idle
-loop. The idle loop must allow interrupts to be taken that will eventually
-cause processes to appear again on the run queues. The variable
+loop.
+The idle loop must allow interrupts to be taken that will eventually
+cause processes to appear again on the run queues.
+The variable
.Va curproc
should be
.Dv NULL
diff --git a/share/man/man9/microtime.9 b/share/man/man9/microtime.9
index c5ebfc5..0e2ff38 100644
--- a/share/man/man9/microtime.9
+++ b/share/man/man9/microtime.9
@@ -64,12 +64,14 @@ instead.
and
.Fn nanotime
always query the timecounter to return the current time as precisely as
-possible. Whereas
+possible.
+Whereas
.Fn getmicrotime
and
.Fn getnanotime
functions are abstractions which can alternately return a less precise, but
-faster to obtain, time. This behaviour can be toggled via the
+faster to obtain, time.
+This behaviour can be toggled via the
kern.timecounter.method sysctl variable:
.Bl -tag -width ABC
.It Dv 0
diff --git a/share/man/man9/microuptime.9 b/share/man/man9/microuptime.9
index 39fc7ac..69a2487 100644
--- a/share/man/man9/microuptime.9
+++ b/share/man/man9/microuptime.9
@@ -64,12 +64,14 @@ instead.
and
.Fn nanouptime
always query the timecounter to return the current time as precisely as
-possible. Whereas
+possible.
+Whereas
.Fn getmicrouptime
and
.Fn getnanouptime
functions are abstractions which can alternately return a less precise, but
-faster to obtain, time. This behaviour can be toggled via the
+faster to obtain, time.
+This behaviour can be toggled via the
kern.timecounter.method sysctl variable:
.Bl -tag -width ABC
.It Dv 0
diff --git a/share/man/man9/physio.9 b/share/man/man9/physio.9
index 02114fa..27eb6d3 100644
--- a/share/man/man9/physio.9
+++ b/share/man/man9/physio.9
@@ -53,7 +53,8 @@
The
.Fn physio
is a helper function typically called from character device read and write
-routines to start I/O on a user process buffer. It calls back on the
+routines to start I/O on a user process buffer.
+It calls back on the
provided
.Fa strategy
routine one or more times to complete the transfer described by
@@ -62,7 +63,8 @@ The maximum amount of data to transfer with each call to
.Fa strategy
is determined by the
.Fa minphys
-routine. Since
+routine.
+Since
.Fa uio
normally describes user space addresses,
.Fn physio
@@ -71,7 +73,8 @@ needs to lock the process into memory. This is done by setting the
flag on the process.
.Fn physio
always awaits the completion of the entire requested transfer before
-returning, unless an error condition is detected earlier. In all cases,
+returning, unless an error condition is detected earlier.
+In all cases,
the buffer passed in
.Fa bp
is locked (marked as
@@ -84,11 +87,13 @@ A break-down of the arguments follows:
The device strategy routine to call for each chunk of data to initiate
device I/O.
.It Fa bp
-The buffer to use with the strategy routine. The buffer flags will have
+The buffer to use with the strategy routine.
+The buffer flags will have
.Dv B_BUSY ,
and
.Dv B_PHYS
-set when passed to the strategy routine. If
+set when passed to the strategy routine.
+If
.Dv NULL ,
a buffer is allocated from a system pool.
.It Fa dev
@@ -126,7 +131,8 @@ by examining the
.Dv B_ERROR
buffer flag and the
.Va b_error
-field. Note that the actual transfer size may be less than requested by
+field.
+Note that the actual transfer size may be less than requested by
.Fa uio
if the device signals an
.Dq end of file
diff --git a/share/man/man9/psignal.9 b/share/man/man9/psignal.9
index 42b0f4a..c628bc1 100644
--- a/share/man/man9/psignal.9
+++ b/share/man/man9/psignal.9
@@ -53,7 +53,8 @@
.Ft void
.Fn gsignal "int pgid" "int signum"
.Sh DESCRIPTION
-These functions post a signal to one or more processes. The argument
+These functions post a signal to one or more processes.
+The argument
.Fa signum
common to all three functions should be in the range
.Bq 1- Ns Dv NSIG .
@@ -66,14 +67,16 @@ to the process represented by the process structure
.Fa p .
With a few exceptions noted below, the target process signal disposition is
updated and is marked as runnable, so further handling of the signal is done
-in the context of the target process after a context switch. Note that
+in the context of the target process after a context switch.
+Note that
.Fn psignal
does not by itself cause a context switch to happen.
.Pp
The target process is not marked as runnable in the following cases:
.Bl -bullet -offset indent
.It
-The target process is sleeping uninterruptibly. The signal will be
+The target process is sleeping uninterruptibly.
+The signal will be
noticed when the process returns from the system call or trap.
.It
The target process is currently ignoring the signal.
@@ -114,7 +117,8 @@ pointed at by
.Fa pgrp
and calling
.Fn psignal
-as appropriate. If
+as appropriate.
+If
.Fa pgrp
is
.Dv NULL
@@ -133,7 +137,8 @@ then invokes
.Fn pgsignal
with the argument
.Fa checkctty
-set to zero. If
+set to zero.
+If
.Fa pgid
is zero no action is taken.
.Sh SEE ALSO
OpenPOWER on IntegriCloud