d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Assorted markup fixes and minor wordsmithing.

Browse Source 
Approved by:	re
This commit is contained in:
Ruslan Ermilov 2005-06-15 13:31:23 +00:00
parent c1ef2d47b1
commit 4f06896130
30 changed files with 141 additions and 101 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
share/man/man4/acpi.4
View File

@ -237,7 +237,11 @@ Supports system cooling and heat management.
Implements a timecounter using the ACPI fixed-frequency timer.
.It Li video
.Pq Vt device
Supports acpi_video which may conflict with agp device.
Supports
.Xr acpi_video 4
which may conflict with
.Xr agp 4
device.
.El
.Pp
It is also possible to avoid portions of the ACPI namespace which

4
share/man/man4/cpufreq.4
View File

@ -62,7 +62,7 @@ interface of all possible levels.
Users can access this interface directly via
.Xr sysctl 8
or by indicating to
.Pa power_profile
.Pa /etc/rc.d/power_profile
that it should switch settings when the AC line state changes via
.Xr rc.conf 5 .
.Sh SYSCTLS
@ -106,7 +106,7 @@ Intel Enhanced SpeedStep
.It Pa ichss
Intel SpeedStep for ICH
.It Pa powernow
AMD PowerNow! for K7 and K8
AMD PowerNow!\& for K7 and K8
.It Pa smist
Intel SMI-based SpeedStep for PIIX4
.El

2
share/man/man4/ed.4
View File

@ -30,7 +30,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd February 9, 2005
.Dd February 23, 2005
.Dt ED 4
.Os
.Sh NAME

18
share/man/man4/geom.4
View File

@ -338,28 +338,28 @@ sysctl.
All of these flags are off by default, and great care should be taken in
turning them on.
.Bl -tag -width FAIL
.It 0x01 (G_T_TOPOLOGY)
.It 0x01 Pq Dv G_T_TOPOLOGY
Provide tracing of topology change events.
.It 0x02 (G_T_BIO)
.It 0x02 Pq Dv G_T_BIO
Provide tracing of buffer I/O requests.
.It 0x04 (G_T_ACCESS)
.It 0x04 Pq Dv G_T_ACCESS
Provide tracing of access check controls.
.It 0x08 (unused)
.It 0x10 (allow foot shooting)
Allow writing to Rank 1 providers.
This would, for example, allow the super-user to overwrite the MBR on the root
disk or write random sectors elsewhere to a mounted disk. The implications
are obvious.
.It 0x20 (G_T_DETAILS)
disk or write random sectors elsewhere to a mounted disk.
The implications are obvious.
.It 0x20 Pq Dv G_T_DETAILS
This appears to be unused at this time.
.It 0x40 (G_F_DISKIOCTL)
.It 0x40 Pq Dv G_F_DISKIOCTL
This appears to be unused at this time.
.It 0x80 (G_F_CTLDUMP)
.It 0x80 Pq Dv G_F_CTLDUMP
Dump contents of gctl requests.
.El
.Sh HISTORY
This software was developed for the FreeBSD Project by Poul-Henning Kamp
and NAI Labs, the Security Research Division of Network Associates, Inc.
and NAI Labs, the Security Research Division of Network Associates, Inc.\&
under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the
DARPA CHATS research program.
.Pp

24
share/man/man4/icmp6.4
View File

@ -196,24 +196,32 @@ is modified to allow all message types.
Ignore all incoming messages.
.Va filterp
is modified to ignore all message types.
.It Fn "void ICMP6_FILTER_SETPASS" "int type" \
"struct icmp6_filter *filterp"
.It Xo
.Ft void
.Fn ICMP6_FILTER_SETPASS "int type" "struct icmp6_filter *filterp"
.Xc
Allow ICMPv6 messages with the given
.Fa type .
.Va filterp
is modified to allow such messages.
.It Fn "void ICMP6_FILTER_SETBLOCK" "int type" \
"struct icmp6_filter *filterp"
.It Xo
.Ft void
.Fn ICMP6_FILTER_SETBLOCK" "int type" "struct icmp6_filter *filterp"
.Xc
Ignore ICMPv6 messages with the given
.Fa type .
.Va filterp
is modified to ignore such messages.
.It Fn "int ICMP6_FILTER_WILLPASS" "int type" \
"const struct icmp6_filter *filterp"
.It Xo
.Ft int
.Fn ICMP6_FILTER_WILLPASS" "int type" "const struct icmp6_filter *filterp"
.Xc
Determine if the given filter will allow an ICMPv6 message of the given
type.
.It Fn "int ICMP6_FILTER_WILLBLOCK" "int type" \
"const struct icmp6_filter *filterp"
.It Xo
.Ft int
.Fn ICMP6_FILTER_WILLBLOCK" "int type" "const struct icmp6_filter *filterp"
.Xc
Determine if the given filter will ignore an ICMPv6 message of the given
type.
.El

2
share/man/man4/ng_netflow.4
View File

@ -243,10 +243,10 @@ we do not use tee, but send packets back to ether node.
SEQ
.Ed
.Sh SEE ALSO
.Xr flowctl 8 ,
.Xr netgraph 4 ,
.Xr ng_ksocket 4 ,
.Xr ng_tee 4 ,
.Xr flowctl 8 ,
.Xr ngctl 8
.Pp
.Pa http://www.cisco.com/warp/public/cc/pd/iosw/ioft/neflct/tech/napps_wp.htm

58
share/man/man4/ng_source.4
View File

@ -64,32 +64,34 @@ The operation of the node is as follows.
Packets received on the
.Va input
hook are queued internally.
When
When
.Va output
hook is connected,
.Nm
node assumes that its neighbour node is of
.Xr ng_ether
.Xr ng_ether 4
node type.
The neighbor is queried for its interface name.
The neighbour is queried for its interface name.
The
.Nm
node then uses queue of the interface for its evil purposes.
The
.Nm
node also disables
.Va autosrc
option on neighbour
.Xr ng_ether
.Xr ng_ether 4
node.
If interface name can't be obtained automatically, it should
be configured explicitly with help of
.Dv NGM_SOURCE_SETIFACE
If interface name cannot be obtained automatically, it should
be configured explicitly with the
.Dv NGM_SOURCE_SETIFACE
control message, and
.Va autosrc
should be turned off on
.Xr ng_ether
.Xr ng_ether 4
node manually.
.Pp
Once interface is configured, upon receival of
Once interface is configured, upon receipt of a
.Dv NGM_SOURCE_START
control message the node starts sending
the previously queued packets out the
@ -100,8 +102,10 @@ While active, on every clock tick the node checks the available space
in the interface queue and sends that many packets out its
.Va output
hook.
Once the number of packets indicated in the start message have been
sent, or upon reception of a stop message, the node stops sending data.
Once the number of packets indicated in the start message has been
sent, or upon receipt of a
.Dv NGM_SOURCE_STOP
message, the node stops sending data.
.Sh CONTROL MESSAGES
This node type supports the generic control messages as well as the following,
which must be sent with the
@ -113,19 +117,19 @@ Returns a structure containing the following fields:
.Bl -tag -width indent
.It Va outOctets
The number of octets/bytes sent out the
.Dv output
.Va output
hook.
.It Va outFrames
The number of frames/packets sent out the
.Dv output
.Va output
hook.
.It Va queueOctets
The number of octets queued from the
.Dv input
.Va input
hook.
.It Va queueFrames
The number of frames queued from the
.Dv input
.Va input
hook.
.It Va startTime
The time the last start message was received.
@ -155,23 +159,27 @@ This message requires a single
.Vt uint64_t
parameter which is the number of packets to
send before stopping.
Node starts sending the queued packets out the output hook.
The output hook must be connected and node must have
Node starts sending the queued packets out the
.Va output
hook.
The
.Va output
hook must be connected and node must have
interface configured.
.It Dv NGM_SOURCE_STOP Pq Ic stop
Stops the node if it is active.
.It Dv NGM_SOURCE_CLR_DATA Pq Ic clrdata
Clears the packets queued from the
.Dv input
.Va input
hook.
.It Dv NGM_SOURCE_SETIFACE Pq Ic setiface
This message requires a string argument - name of the interface
to be configured.
This message requires the name of the interface
to be configured as an argument.
.El
.Sh SHUTDOWN
This node shuts down upon receipt of a
.Dv NGM_SHUTDOWN
control message, when all hooks has been disconnected, or when the
control message, when all hooks have been disconnected, or when the
.Va output
hook has been disconnected.
.Sh EXAMPLES
@ -186,11 +194,11 @@ For example, these commands
load the
.Nm ng_ether
module and attach the
.Dv output
.Va output
hook of a new
.Nm source
node to
.Dv orphans
.Va orphans
hook of the
.Li bge0:
.Nm ng_ether
@ -218,7 +226,7 @@ can be used to generate these packets:
To feed the output of the above TCL script to the
.Nm source
node's
.Dv input
.Va input
hook via
.Xr nghook 8 :
.Pp
@ -232,7 +240,7 @@ Args: { queueOctets=64 queueFrames=1 }
.Ed
.Pp
Send as many packets as required out the
.Dv output
.Va output
hook:
.Pp
.Dl "ngctl msg bge0:orphans start 16"

4
share/man/man4/snd_emu10k1.4
View File

@ -38,7 +38,7 @@ The
.Nm
bridge driver allows the generic audio driver
.Xr sound 4
to attach to the SoundBlaster Live! and Audigy audio cards.
to attach to the SoundBlaster Live!\& and Audigy audio cards.
.Pp
Digital output is supported by default.
.Sh HARDWARE
@ -48,7 +48,7 @@ driver supports the following sound cards:
.Pp
.Bl -bullet -compact
.It
Creative SoundBlaster Live! (EMU10K1 Chipset)
Creative SoundBlaster Live!\& (EMU10K1 Chipset)
.It
Creative SoundBlaster Audigy (EMU10K2 Chipset)
.El

2
share/man/man4/snd_maestro3.4
View File

@ -65,7 +65,7 @@ ESS Technology Maestro3
.El
.Sh DIAGNOSTICS
The hardware volume control buttons can be connected to two different pin
sets(GPIO or GD) on the chip, depending on the manufacturer.
sets (GPIO or GD) on the chip, depending on the manufacturer.
The driver has no way of determining this configuration, so a hint may be
used to override the default guess.
The default setting for hardware volume control assumes that GD pins

40
share/man/man4/unix.4
View File

@ -94,10 +94,14 @@ can be calculated by the macro
defined in
.In sys/un.h .
The
.Ar sun_path
field must be terminated by a NUL character to be used with
.Va sun_path
field must be terminated by a
.Dv NUL
character to be used with
.Fn SUN_LEN ,
but the terminating NUL is
but the terminating
.Dv NUL
is
.Em not
part of the address.
.Pp
@ -195,7 +199,6 @@ or
.Xr listen 2 )
under different effective credentials.
.Pp
.Tn UNIX
domain sockets support a number of socket options which can be set with
.Xr setsockopt 2
@ -207,13 +210,21 @@ This option may be enabled on a
.Dv SOCK_DGRAM
or a
.Dv SOCK_STREAM
socket. This option provides a mechanism for the receiver to
socket.
This option provides a mechanism for the receiver to
receive the credentials of the process as a
.Xr recvmsg 2
control message. The msg_control field in the msghdr structure points
to a buffer that contains a cmsghdr structure followed by a variable
length sockcred structure, defined in
.Pa \*[Lt]sys/socket.h\*[Gt]
control message.
The
.Va msg_control
field in the
.Vt msghdr
structure points to a buffer that contains a
.Vt cmsghdr
structure followed by a variable length
.Vt sockcred
structure, defined in
.In sys/socket.h
as follows:
.Bd -literal
struct sockcred {
@ -228,22 +239,27 @@ struct sockcred {
.Pp
The
.Fn SOCKCREDSIZE
macro computes the size of the sockcred structure for a specified number
macro computes the size of the
.Vt sockcred
structure for a specified number
of groups.
The cmsghdr fields have the following values:
The
.Vt cmsghdr
fields have the following values:
.Bd -literal
cmsg_len = sizeof(struct cmsghdr) + SOCKCREDSIZE(ngroups)
cmsg_level = SOL_SOCKET
cmsg_type = SCM_CREDS
.Ed
.It Dv LOCAL_CONNWAIT
Used with
Used with
.Dv SOCK_STREAM
sockets, this option causes the
.Xr connect 2
function to block until
.Xr accept 2
has been called on the listening socket.
.El
.Sh SEE ALSO
.Xr socket 2 ,
.Xr intro 4

7
share/man/man4/witness.4
View File

@ -93,9 +93,10 @@ set via the read-only sysctl
.Pp
The sysctl
.Va debug.witness.watch
specifies the level of witness involvment in the system. A value of
1 specifies that witness is enabled. A value of 0 specifies that
witness is disabled. This sysctl can be written to in order to
specifies the level of witness involvment in the system.
A value of 1 specifies that witness is enabled.
A value of 0 specifies that witness is disabled.
This sysctl can be written to in order to
disable witness, however it may not be used to enable witness.
.Va debug.witness.watch
can be set via

2
share/man/man5/autofs.5
View File

@ -40,8 +40,8 @@ The auto file system, or
provides a method to dynamically graft mountpoints into the file system
namespace.
.Sh SEE ALSO
.Xr libautofs 3 ,
.Xr mount_autofs 8
.Xr libautofs 3
.Sh HISTORY
The
.Nm

2
share/man/man5/elf.5
View File

@ -832,7 +832,7 @@ fixed-size entries.
Various sections hold program and control information:
.Bl -tag -width ".shstrtab" -compact
.It .bss
Block Started by Symbol -
(Block Started by Symbol)
This section holds uninitialized data that contributes to the program's
memory image.
By definition, the system initializes the data with zeros

8
share/man/man7/release.7
View File

@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd September 6, 2004
.Dd May 17, 2005
.Dt RELEASE 7
.Os
.Sh NAME
@ -166,12 +166,12 @@ staging directory.
Sets up a suitable area for FTP installations in
.Pa ${CHROOTDIR}/R/ftp .
.It Cm cdrom.1
Create the layout for the live filesystem CD-ROM image in
Create the layout for the live file system CD-ROM image in
.Pa ${CHROOTDIR}/R/cdrom .
.It Cm cdrom.2
Create the layout for the first and second CD-ROM images.
.It Cm cdrom.3
Create the layout for the boot only CD-ROM image and the boot only UFS
Create the layout for the boot-only CD-ROM image and the boot-only UFS
miniroot image.
.It Cm iso.1
Builds ISO images (installation and
@ -373,7 +373,7 @@ of the CVS tree
(a
.Dq "-CURRENT snapshot" ) .
.It Va SEPARATE_LIVEFS
Store the live filesystem on its own CD-ROM image rather than placing it on
Store the live file system on its own CD-ROM image rather than placing it on
the first disc.
.It Va TARGET_ARCH
The target machine processor architecture.

1
share/man/man9/MUTEX_PROFILING.9
View File

@ -186,5 +186,4 @@ due to extra locking that occurs when
.Dv INVARIANTS
is present; likewise, using it in combination with
.Dv WITNESS
with
will lead to much higher lock hold times and contention in profiling output.

2
share/man/man9/VFS_SYNC.9
View File

@ -71,7 +71,7 @@ The
.Fn VFS_SYNC
macro calls the
.Va vfs_sync
method of the filesystem, which normally calls
method of the file system, which normally calls
.Xr VOP_FSYNC 9
for all the vnodes in the file system.
.Sh SEE ALSO

14
share/man/man9/VFS_VGET.9
View File

@ -48,20 +48,20 @@ looks up or creates a vnode from a (mount, inode#) tupple.
Its arguments are:
.Bl -tag -width ".Fa flags"
.It Fa mp
The mountpoint.
The mount point.
.It Fa ino
The inode representing the file.
This is a unique number assigned by the filesystem when vnodes are first
This is a unique number assigned by the file system when vnodes are first
created.
.It Fa flags
Additional locking flags to pass through to
.Xr vget 9
.Xr vget 9 .
.It Fa vpp
Return parameter for the vnode.
.El
.Pp
This is an optional file system entry-point for file systems mainly
intended for NFS server use, but many filesystems
intended for NFS server use, but many file systems
use it internally in
.Xr VOP_LOOKUP 9
and similar.
@ -69,7 +69,11 @@ and similar.
If the file system does not support this call, then it should return
.Er EOPNOTSUPP .
.Pp
Please see sys/ufs/ffs/ffs_vfsops.c::ffs_vget() for the canonical example.
Please see
.Fn ffs_vget
in
.Pa sys/ufs/ffs/ffs_vfsops.c
for the canonical example.
.Sh SEE ALSO
.Xr VFS 9 ,
.Xr vget 9 ,

2
share/man/man9/VOP_GETPAGES.9
View File

@ -108,7 +108,7 @@ in addition to calling
.Xr vm_page_undirty 9 .
.It Dv VM_PAGER_BAD
The page was entirely beyond the end of the backing file.
This condition should not be possible if the vnode's filesystem
This condition should not be possible if the vnode's file system
is correctly implemented.
.It Dv VM_PAGER_ERROR
The page could not be written because of an error on the underlying storage

4
share/man/man9/bus_dma.9
View File

@ -563,8 +563,8 @@ DMA tag.
.It Fn bus_dmamap_load_mbuf_sg "dmat" "map" "mbuf" "segs" "nsegs" "flags"
This is just like
.Fn bus_dmamap_load_mbuf
except that it returns immediately without calling a callback function. It is
provided for efficiency.
except that it returns immediately without calling a callback function.
It is provided for efficiency.
The scatter/gather segment array
.Va segs
is provided by the caller and filled in directly by the function.

6
share/man/man9/device_find_child.9
View File

@ -48,11 +48,11 @@ and
.Fa unit .
If
.Fa unit
is -1, it returns the first child of
.Dv dev
is \-1, it returns the first child of
.Fa dev
with a matching
.Fa classname
(that is, the one with the lowest unit.)
(that is, the one with the lowest unit).
.Sh RETURN VALUES
If it exists, the child device is returned, otherwise NULL.
.Sh SEE ALSO

8
share/man/man9/ifnet.9
View File

@ -28,7 +28,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd June 8, 2004
.Dd June 10, 2005
.Os
.Dt IFNET 9
.Sh NAME
@ -1004,8 +1004,8 @@ A reference count of requests for this particular membership.
.Ss Interface Manipulation Functions
.Bl -ohang -offset indent
.It Fn if_alloc
Allocate and initialize an
.Fa ifp .
Allocate and initialize
.Vt "struct ifnet" .
Initalization includes the allocation of an interface index and may
include the allocation of a
.Fa type
@ -1040,7 +1040,7 @@ Identical to
.Fn if_free
except that the given
.Fa type
is used to free
is used to free
.Va if_l2com
instead of the type in
.Va if_type .

2
share/man/man9/kthread.9
View File

@ -263,8 +263,8 @@ flag was specified in the
parameter.
.El
.Sh SEE ALSO
.Xr exit1 9 ,
.Xr rfork 2 ,
.Xr exit1 9 ,
.Xr SYSINIT 9 ,
.Xr wakeup 9
.Sh HISTORY

2
share/man/man9/ktr.9
View File

@ -110,7 +110,7 @@ the console in addition to the event buffer.
This example demonstrates the use of tracepoints at the
.Dv KTR_PROC
logging level.
.Bd -literal -compact
.Bd -literal
void
mi_switch()
{

2
share/man/man9/mbuf.9
View File

@ -627,7 +627,7 @@ bytes into the mbuf.
The
.Fa dstoff
argument aligns the data and leaves room for a link layer header.
Return the new
Returns the new
.Vt mbuf chain
on success,
and frees the

2
share/man/man9/pci.9
View File

@ -244,7 +244,7 @@ space on the target architecture.
This man page was written by
.An Bruce M Simpson Aq bms@FreeBSD.org .
.Sh BUGS
The kernel PCI code has a number of references to
The kernel PCI code has a number of references to
.Dq "slot numbers" .
These do not refer to the geographic location of PCI devices,
but to the device number assigned by the combination of the PCI IDSEL

8
share/man/man9/rman.9
View File

@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd May 12, 2003
.Dd March 15, 2005
.Dt RMAN 9
.Os
.Sh NAME
@ -187,15 +187,15 @@ and
.Fa end
of an acceptable range, as well as
alignment, and the code will attempt to find a free segment which fits.
The
The
.Fa start
argument is the lowest acceptable starting value of the resource.
The
.Fa end
argument is the highest acceptable ending value of the resource.
Therefore,
.Fa start + count - 1
must be <=
.Fa start No + Fa count No \- 1
must be \[<=]
.Fa end
for any allocation to happen.
The default behavior is to allocate an exclusive segment, unless the

2
share/man/man9/taskqueue.9
View File

@ -161,7 +161,7 @@ and the value of
.Va ta_pending
as its second argument.
.Pp
The
The
.Fn taskqueue_drain
function is used to wait for the task to finish.
There is no guarantee that the task will not be

4
share/man/man9/time.9
View File

@ -88,14 +88,14 @@ variable may be read and written without special precautions.
.Xr clock_settime 2 ,
.Xr ntp_adjtime 2 ,
.Xr settimeofday 2 ,
.Xr bintime 9 ,
.Xr binuptime 9 ,
.Xr getbintime 9 ,
.Xr getbinuptime 9 ,
.Xr getmicrotime 9 ,
.Xr getmicrouptime 9 ,
.Xr getnanotime 9 ,
.Xr getnanouptime 9 ,
.Xr bintime 9 ,
.Xr binuptime 9 ,
.Xr microtime 9 ,
.Xr microuptime 9 ,
.Xr nanotime 9 ,

2
share/man/man9/timeout.9
View File

@ -218,7 +218,7 @@ function returns.
The following
.Fa flags
may be specified:
.Bl -tag -width CALLOUT_RETURNUNLOCKED
.Bl -tag -width ".Dv CALLOUT_RETURNUNLOCKED"
.It Dv CALLOUT_RETURNUNLOCKED
The callout function will release
.Fa mtx

2
share/man/man9/vfs_suser.9
View File

@ -41,7 +41,7 @@
The
.Fn vfs_suser
function checks if the credentials given include superuser powers
for the given mountpoint.
for the given mount point.
It will check to see if the thread
passed in has the same credentials as the user that mounted the
file system.