diff options
author | sheldonh <sheldonh@FreeBSD.org> | 2000-03-03 14:05:08 +0000 |
---|---|---|
committer | sheldonh <sheldonh@FreeBSD.org> | 2000-03-03 14:05:08 +0000 |
commit | 88dd9b4faa11f5f0aa21cbd43fb72503a67b4229 (patch) | |
tree | 69062af71195d869d2c940c1869ddf1621cbabfb /share/man/man9 | |
parent | 1b7dce690e9fb2a298fb1e3bedc8186e71b877a3 (diff) | |
download | FreeBSD-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.9 | 3 | ||||
-rw-r--r-- | share/man/man9/device.9 | 3 | ||||
-rw-r--r-- | share/man/man9/device_set_desc.9 | 6 | ||||
-rw-r--r-- | share/man/man9/kernacc.9 | 6 | ||||
-rw-r--r-- | share/man/man9/malloc.9 | 3 | ||||
-rw-r--r-- | share/man/man9/mi_switch.9 | 18 | ||||
-rw-r--r-- | share/man/man9/microtime.9 | 6 | ||||
-rw-r--r-- | share/man/man9/microuptime.9 | 6 | ||||
-rw-r--r-- | share/man/man9/physio.9 | 18 | ||||
-rw-r--r-- | share/man/man9/psignal.9 | 15 |
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 |