summaryrefslogtreecommitdiffstats
path: root/share/man
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2004-07-03 18:29:24 +0000
committerru <ru@FreeBSD.org>2004-07-03 18:29:24 +0000
commit1cf159866714352fd8d7789b97068220cbb5a1a4 (patch)
tree5526e5113f4e9589bb734483867453b89a7ca4e6 /share/man
parentbf15efbfc56854d6fb20bb4ff7801d7549fe2bfd (diff)
downloadFreeBSD-src-1cf159866714352fd8d7789b97068220cbb5a1a4.zip
FreeBSD-src-1cf159866714352fd8d7789b97068220cbb5a1a4.tar.gz
Mechanically kill hard sentence breaks and double whitespaces.
Diffstat (limited to 'share/man')
-rw-r--r--share/man/man3/fpgetround.311
-rw-r--r--share/man/man3/intro.33
-rw-r--r--share/man/man3/pthread_cancel.32
-rw-r--r--share/man/man3/pthread_create.32
-rw-r--r--share/man/man3/pthread_detach.32
-rw-r--r--share/man/man3/pthread_exit.33
-rw-r--r--share/man/man3/pthread_join.32
-rw-r--r--share/man/man3/pthread_once.32
-rw-r--r--share/man/man3/pthread_rwlock_destroy.33
-rw-r--r--share/man/man3/pthread_rwlock_init.33
-rw-r--r--share/man/man3/pthread_rwlock_rdlock.311
-rw-r--r--share/man/man3/pthread_rwlock_unlock.33
-rw-r--r--share/man/man3/pthread_rwlock_wrlock.33
-rw-r--r--share/man/man3/pthread_rwlockattr_destroy.33
-rw-r--r--share/man/man3/pthread_rwlockattr_getpshared.39
-rw-r--r--share/man/man3/pthread_rwlockattr_init.33
-rw-r--r--share/man/man3/pthread_rwlockattr_setpshared.36
-rw-r--r--share/man/man3/stdarg.32
-rw-r--r--share/man/man3/sysexits.333
-rw-r--r--share/man/man4/atkbd.48
-rw-r--r--share/man/man4/bktr.42
-rw-r--r--share/man/man4/bpf.4173
-rw-r--r--share/man/man4/ccd.42
-rw-r--r--share/man/man4/cd.418
-rw-r--r--share/man/man4/ch.42
-rw-r--r--share/man/man4/ciss.411
-rw-r--r--share/man/man4/cy.418
-rw-r--r--share/man/man4/da.47
-rw-r--r--share/man/man4/dc.45
-rw-r--r--share/man/man4/divert.43
-rw-r--r--share/man/man4/en.42
-rw-r--r--share/man/man4/fatm.421
-rw-r--r--share/man/man4/geom.434
-rw-r--r--share/man/man4/gre.46
-rw-r--r--share/man/man4/gusc.43
-rw-r--r--share/man/man4/hatm.4114
-rw-r--r--share/man/man4/ifmib.42
-rw-r--r--share/man/man4/iic.44
-rw-r--r--share/man/man4/inet.42
-rw-r--r--share/man/man4/intro.42
-rw-r--r--share/man/man4/ip6.42
-rw-r--r--share/man/man4/ispfw.46
-rw-r--r--share/man/man4/joy.48
-rw-r--r--share/man/man4/keyboard.417
-rw-r--r--share/man/man4/lp.42
-rw-r--r--share/man/man4/mac.43
-rw-r--r--share/man/man4/mac_biba.43
-rw-r--r--share/man/man4/mac_bsdextended.42
-rw-r--r--share/man/man4/mac_ifoff.43
-rw-r--r--share/man/man4/mac_lomac.43
-rw-r--r--share/man/man4/mac_mls.44
-rw-r--r--share/man/man4/mac_none.43
-rw-r--r--share/man/man4/mac_partition.43
-rw-r--r--share/man/man4/mac_portacl.42
-rw-r--r--share/man/man4/mac_seeotheruids.43
-rw-r--r--share/man/man4/mac_stub.43
-rw-r--r--share/man/man4/mac_test.43
-rw-r--r--share/man/man4/man4.alpha/osf1.42
-rw-r--r--share/man/man4/man4.i386/acpi_asus.43
-rw-r--r--share/man/man4/man4.i386/amdpm.44
-rw-r--r--share/man/man4/man4.i386/apm.433
-rw-r--r--share/man/man4/man4.i386/ar.48
-rw-r--r--share/man/man4/man4.i386/cs.424
-rw-r--r--share/man/man4/man4.i386/ct.49
-rw-r--r--share/man/man4/man4.i386/ex.46
-rw-r--r--share/man/man4/man4.i386/fe.46
-rw-r--r--share/man/man4/man4.i386/io.43
-rw-r--r--share/man/man4/man4.i386/mse.46
-rw-r--r--share/man/man4/man4.i386/ndis.436
-rw-r--r--share/man/man4/man4.i386/perfmon.427
-rw-r--r--share/man/man4/man4.i386/ray.48
-rw-r--r--share/man/man4/man4.i386/scd.43
-rw-r--r--share/man/man4/man4.i386/spkr.439
-rw-r--r--share/man/man4/man4.i386/streams.42
-rw-r--r--share/man/man4/man4.i386/vx.46
-rw-r--r--share/man/man4/man4.i386/wl.490
-rw-r--r--share/man/man4/matcd.491
-rw-r--r--share/man/man4/mem.47
-rw-r--r--share/man/man4/meteor.44
-rw-r--r--share/man/man4/mly.42
-rw-r--r--share/man/man4/mouse.49
-rw-r--r--share/man/man4/mtio.43
-rw-r--r--share/man/man4/multicast.435
-rw-r--r--share/man/man4/natmip.418
-rw-r--r--share/man/man4/ng_UI.49
-rw-r--r--share/man/man4/ng_async.412
-rw-r--r--share/man/man4/ng_atm.480
-rw-r--r--share/man/man4/ng_atmllc.412
-rw-r--r--share/man/man4/ng_atmpif.49
-rw-r--r--share/man/man4/ng_bluetooth.42
-rw-r--r--share/man/man4/ng_bpf.412
-rw-r--r--share/man/man4/ng_btsocket.44
-rw-r--r--share/man/man4/ng_cisco.430
-rw-r--r--share/man/man4/ng_frame_relay.46
-rw-r--r--share/man/man4/ng_hci.46
-rw-r--r--share/man/man4/ng_iface.46
-rw-r--r--share/man/man4/ng_ksocket.423
-rw-r--r--share/man/man4/ng_l2cap.42
-rw-r--r--share/man/man4/ng_lmi.49
-rw-r--r--share/man/man4/ng_one2many.43
-rw-r--r--share/man/man4/ng_ppp.418
-rw-r--r--share/man/man4/ng_pppoe.42
-rw-r--r--share/man/man4/ng_socket.414
-rw-r--r--share/man/man4/ng_sppp.49
-rw-r--r--share/man/man4/ng_sscfu.411
-rw-r--r--share/man/man4/ng_sscop.415
-rw-r--r--share/man/man4/ng_tty.46
-rw-r--r--share/man/man4/ng_uni.43
-rw-r--r--share/man/man4/ng_vjc.49
-rw-r--r--share/man/man4/patm.49
-rw-r--r--share/man/man4/pci.421
-rw-r--r--share/man/man4/pcn.42
-rw-r--r--share/man/man4/pcvt.412
-rw-r--r--share/man/man4/ppbus.46
-rw-r--r--share/man/man4/ppi.42
-rw-r--r--share/man/man4/psm.42
-rw-r--r--share/man/man4/pt.43
-rw-r--r--share/man/man4/pty.45
-rw-r--r--share/man/man4/random.44
-rw-r--r--share/man/man4/re.432
-rw-r--r--share/man/man4/rl.42
-rw-r--r--share/man/man4/route.42
-rw-r--r--share/man/man4/sa.43
-rw-r--r--share/man/man4/safe.43
-rw-r--r--share/man/man4/sbc.43
-rw-r--r--share/man/man4/scsi.435
-rw-r--r--share/man/man4/si.411
-rw-r--r--share/man/man4/sio.42
-rw-r--r--share/man/man4/sis.42
-rw-r--r--share/man/man4/snd_gusc.43
-rw-r--r--share/man/man4/snd_sbc.43
-rw-r--r--share/man/man4/snd_uaudio.46
-rw-r--r--share/man/man4/spkr.439
-rw-r--r--share/man/man4/sppp.457
-rw-r--r--share/man/man4/sym.46
-rw-r--r--share/man/man4/sysmouse.46
-rw-r--r--share/man/man4/termios.459
-rw-r--r--share/man/man4/ti.49
-rw-r--r--share/man/man4/tl.43
-rw-r--r--share/man/man4/ttcp.43
-rw-r--r--share/man/man4/tty.48
-rw-r--r--share/man/man4/uaudio.46
-rw-r--r--share/man/man4/udp.42
-rw-r--r--share/man/man4/ukbd.43
-rw-r--r--share/man/man4/umass.42
-rw-r--r--share/man/man4/umct.46
-rw-r--r--share/man/man4/ums.43
-rw-r--r--share/man/man4/utopia.458
-rw-r--r--share/man/man4/vga.49
-rw-r--r--share/man/man4/vpo.43
-rw-r--r--share/man/man4/vr.42
-rw-r--r--share/man/man4/wi.42
-rw-r--r--share/man/man4/xl.43
-rw-r--r--share/man/man4/xpt.415
-rw-r--r--share/man/man5/a.out.52
-rw-r--r--share/man/man5/devfs.53
-rw-r--r--share/man/man5/disktab.59
-rw-r--r--share/man/man5/elf.56
-rw-r--r--share/man/man5/forward.59
-rw-r--r--share/man/man5/fs.518
-rw-r--r--share/man/man5/fstab.511
-rw-r--r--share/man/man5/hosts.56
-rw-r--r--share/man/man5/hosts.equiv.56
-rw-r--r--share/man/man5/link.53
-rw-r--r--share/man/man5/mailer.conf.511
-rw-r--r--share/man/man5/networks.52
-rw-r--r--share/man/man5/passwd.521
-rw-r--r--share/man/man5/pbm.53
-rw-r--r--share/man/man5/phones.515
-rw-r--r--share/man/man5/procfs.59
-rw-r--r--share/man/man5/protocols.56
-rw-r--r--share/man/man5/rc.conf.54
-rw-r--r--share/man/man5/remote.53
-rw-r--r--share/man/man5/services.52
-rw-r--r--share/man/man5/stab.52
-rw-r--r--share/man/man5/sysctl.conf.56
-rw-r--r--share/man/man7/development.741
-rw-r--r--share/man/man7/environ.750
-rw-r--r--share/man/man7/firewall.7110
-rw-r--r--share/man/man7/hier.723
-rw-r--r--share/man/man7/hostname.76
-rw-r--r--share/man/man7/maclabel.72
-rw-r--r--share/man/man7/mailaddr.730
-rw-r--r--share/man/man7/sdoc.72
-rw-r--r--share/man/man7/security.72
-rw-r--r--share/man/man7/tuning.74
-rw-r--r--share/man/man8/adding_user.82
-rw-r--r--share/man/man8/picobsd.88
-rw-r--r--share/man/man8/rc.subr.821
-rw-r--r--share/man/man8/yp.82
-rw-r--r--share/man/man9/BUS_CONFIG_INTR.92
-rw-r--r--share/man/man9/DEVICE_DETACH.94
-rw-r--r--share/man/man9/DEVICE_IDENTIFY.92
-rw-r--r--share/man/man9/DEVICE_PROBE.95
-rw-r--r--share/man/man9/MD5.95
-rw-r--r--share/man/man9/boot.92
-rw-r--r--share/man/man9/buf.97
-rw-r--r--share/man/man9/bus_dma.914
-rw-r--r--share/man/man9/bus_release_resource.94
-rw-r--r--share/man/man9/device_add_child.94
-rw-r--r--share/man/man9/devstat.913
-rw-r--r--share/man/man9/g_access.92
-rw-r--r--share/man/man9/g_event.92
-rw-r--r--share/man/man9/ithread.92
-rw-r--r--share/man/man9/kobj.92
-rw-r--r--share/man/man9/mac.92
-rw-r--r--share/man/man9/mbpool.984
-rw-r--r--share/man/man9/mbuf.92
-rw-r--r--share/man/man9/mi_switch.92
-rw-r--r--share/man/man9/microseq.96
-rw-r--r--share/man/man9/mutex.94
-rw-r--r--share/man/man9/pci.96
-rw-r--r--share/man/man9/pseudofs.92
-rw-r--r--share/man/man9/random.96
-rw-r--r--share/man/man9/spl.92
-rw-r--r--share/man/man9/style.94
-rw-r--r--share/man/man9/sysctl_add_oid.94
-rw-r--r--share/man/man9/sysctl_ctx_init.94
-rw-r--r--share/man/man9/utopia.977
-rw-r--r--share/man/man9/vref.92
220 files changed, 1638 insertions, 987 deletions
diff --git a/share/man/man3/fpgetround.3 b/share/man/man3/fpgetround.3
index 384cb9a..5d608f0 100644
--- a/share/man/man3/fpgetround.3
+++ b/share/man/man3/fpgetround.3
@@ -100,9 +100,11 @@ New code should use the functionality provided by
When a floating point exception is detected, the exception sticky flag is
set and the exception mask is tested.
If the mask is set, then a trap
-occurs. These routines allow both setting the floating point exception
-masks, and resetting the exception sticky flags after an exception is
-detected. In addition, they allow setting the floating point rounding mode
+occurs.
+These routines allow both setting the floating point exception
+masks, and resetting the exception sticky flags after an exception is
+detected.
+In addition, they allow setting the floating point rounding mode
and precision.
.Pp
The
@@ -170,7 +172,8 @@ At present, they are implemented only on the i386 and amd64 platforms.
.Xr isnan 3
.Sh CAVEAT
After a floating point exception and before a mask is set, the sticky
-flags must be reset. If another exception occurs before the sticky
+flags must be reset.
+If another exception occurs before the sticky
flags are reset, then a wrong exception type may be signaled.
.Sh HISTORY
These routines are based on SysV/386 routines of the same name.
diff --git a/share/man/man3/intro.3 b/share/man/man3/intro.3
index b7c5bff..5645ad9 100644
--- a/share/man/man3/intro.3
+++ b/share/man/man3/intro.3
@@ -97,7 +97,8 @@ Use of these routines should, for the most part, be avoided.
The manual page entry for each compatibility routine
indicates the proper interface to use.
.It Xr libkvm Pq Fl l Ns Ar kvm
-Functions used to access kernel memory are in this library. They can be used
+Functions used to access kernel memory are in this library.
+They can be used
against both a running system and a crash dump.
(See
.Xr kvm 3 . )
diff --git a/share/man/man3/pthread_cancel.3 b/share/man/man3/pthread_cancel.3
index f327316..fea6c47 100644
--- a/share/man/man3/pthread_cancel.3
+++ b/share/man/man3/pthread_cancel.3
@@ -47,7 +47,7 @@ expands to a constant expression of type
whose value matches no pointer to an object in memory nor the value
.Dv NULL .
.Sh RETURN VALUES
-If successful, the
+If successful, the
.Fn pthread_cancel
functions will return zero.
Otherwise an error number will be returned to
diff --git a/share/man/man3/pthread_create.3 b/share/man/man3/pthread_create.3
index a006b68..9c331ee 100644
--- a/share/man/man3/pthread_create.3
+++ b/share/man/man3/pthread_create.3
@@ -95,7 +95,7 @@ The signal mask is inherited from the creating thread.
The set of signals pending for the new thread is empty.
.El
.Sh RETURN VALUES
-If successful, the
+If successful, the
.Fn pthread_create
function will return zero.
Otherwise an error number will be returned to
diff --git a/share/man/man3/pthread_detach.3 b/share/man/man3/pthread_detach.3
index 2891632..5893934 100644
--- a/share/man/man3/pthread_detach.3
+++ b/share/man/man3/pthread_detach.3
@@ -60,7 +60,7 @@ The effect of multiple
.Fn pthread_detach
calls on the same target thread is unspecified.
.Sh RETURN VALUES
-If successful, the
+If successful, the
.Fn pthread_detach
function will return zero.
Otherwise an error number will be returned to
diff --git a/share/man/man3/pthread_exit.3 b/share/man/man3/pthread_exit.3
index 95da02b..dbc451e 100644
--- a/share/man/man3/pthread_exit.3
+++ b/share/man/man3/pthread_exit.3
@@ -68,7 +68,8 @@ An implicit call to
is made when a thread other than the thread in which
.Fn main
was first invoked returns from the start routine that was used to create
-it. The function's return value serves as the thread's exit status.
+it.
+The function's return value serves as the thread's exit status.
.Pp
The behavior of
.Fn pthread_exit
diff --git a/share/man/man3/pthread_join.3 b/share/man/man3/pthread_join.3
index 55bcd59..dfeffb9 100644
--- a/share/man/man3/pthread_join.3
+++ b/share/man/man3/pthread_join.3
@@ -75,7 +75,7 @@ is cancelled, then the target thread is not detached.
A thread that has exited but remains unjoined counts against
[_POSIX_THREAD_THREADS_MAX].
.Sh RETURN VALUES
-If successful, the
+If successful, the
.Fn pthread_join
function will return zero.
Otherwise an error number will be returned to
diff --git a/share/man/man3/pthread_once.3 b/share/man/man3/pthread_once.3
index bb5ebcf..00c5bdb 100644
--- a/share/man/man3/pthread_once.3
+++ b/share/man/man3/pthread_once.3
@@ -94,7 +94,7 @@ is undefined if
has automatic storage duration or is not initialized by
.Fa PTHREAD_ONCE_INIT .
.Sh RETURN VALUES
-If successful, the
+If successful, the
.Fn pthread_once
function will return zero.
Otherwise an error number will be returned to
diff --git a/share/man/man3/pthread_rwlock_destroy.3 b/share/man/man3/pthread_rwlock_destroy.3
index da284b6..f44aea6 100644
--- a/share/man/man3/pthread_rwlock_destroy.3
+++ b/share/man/man3/pthread_rwlock_destroy.3
@@ -46,7 +46,8 @@ function is used to destroy a read/write lock previously created with
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlock_destroy
-function will return zero. Otherwise an error number will be returned
+function will return zero.
+Otherwise an error number will be returned
to indicate the error.
.Sh SEE ALSO
.Xr pthread_rwlock_init 3
diff --git a/share/man/man3/pthread_rwlock_init.3 b/share/man/man3/pthread_rwlock_init.3
index 45ac47f..baee444 100644
--- a/share/man/man3/pthread_rwlock_init.3
+++ b/share/man/man3/pthread_rwlock_init.3
@@ -54,7 +54,8 @@ with an already initialized lock are undefined.
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlock_init
-function will return zero. Otherwise an error number will be returned
+function will return zero.
+Otherwise an error number will be returned
to indicate the error.
.Sh SEE ALSO
.Xr pthread_rwlockattr_init 3 ,
diff --git a/share/man/man3/pthread_rwlock_rdlock.3 b/share/man/man3/pthread_rwlock_rdlock.3
index 6c35a7d..6b8affd 100644
--- a/share/man/man3/pthread_rwlock_rdlock.3
+++ b/share/man/man3/pthread_rwlock_rdlock.3
@@ -49,17 +49,19 @@ function acquires a read lock on
provided that
.Fa lock
is not presently held for writing and no writer threads are
-presently blocked on the lock. If the read lock cannot be
+presently blocked on the lock.
+If the read lock cannot be
immediately acquired, the calling thread blocks until it can
acquire the lock.
.Pp
The
.Fn pthread_rwlock_tryrdlock
function performs the same action, but does not block if the lock
-cannot be immediately obtained (i.e. the lock is held for writing
+cannot be immediately obtained (i.e., the lock is held for writing
or there are waiting writers).
.Pp
-A thread may hold multiple concurrent read locks. If so,
+A thread may hold multiple concurrent read locks.
+If so,
.Fn pthread_rwlock_unlock
must be called once for each lock obtained.
.Pp
@@ -72,7 +74,8 @@ If successful, the
.Fn pthread_rwlock_rdlock
and
.Fn pthread_rwlock_tryrdlock
-functions will return zero. Otherwise an error number will be returned
+functions will return zero.
+Otherwise an error number will be returned
to indicate the error.
.Sh SEE ALSO
.Xr pthread_rwlock_init 3 ,
diff --git a/share/man/man3/pthread_rwlock_unlock.3 b/share/man/man3/pthread_rwlock_unlock.3
index ebc8ba3..91ba9f0 100644
--- a/share/man/man3/pthread_rwlock_unlock.3
+++ b/share/man/man3/pthread_rwlock_unlock.3
@@ -50,7 +50,8 @@ or
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlock_unlock
-function will return zero. Otherwise an error number will be returned
+function will return zero.
+Otherwise an error number will be returned
to indicate the error.
.Pp
The results are undefined if
diff --git a/share/man/man3/pthread_rwlock_wrlock.3 b/share/man/man3/pthread_rwlock_wrlock.3
index 2108d14..5349504 100644
--- a/share/man/man3/pthread_rwlock_wrlock.3
+++ b/share/man/man3/pthread_rwlock_wrlock.3
@@ -60,7 +60,8 @@ If successful, the
.Fn pthread_rwlock_wrlock
and
.Fn pthread_rwlock_trywrlock
-functions will return zero. Otherwise an error number will be returned
+functions will return zero.
+Otherwise an error number will be returned
to indicate the error.
.Sh SEE ALSO
.Xr pthread_rwlock_init 3 ,
diff --git a/share/man/man3/pthread_rwlockattr_destroy.3 b/share/man/man3/pthread_rwlockattr_destroy.3
index 42bcb80..8ccc219 100644
--- a/share/man/man3/pthread_rwlockattr_destroy.3
+++ b/share/man/man3/pthread_rwlockattr_destroy.3
@@ -47,7 +47,8 @@ previously created with
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlockattr_destroy
-function will return zero. Otherwise an error number will be returned
+function will return zero.
+Otherwise an error number will be returned
to indicate the error.
.Sh SEE ALSO
.Xr pthread_rwlockattr_init 3
diff --git a/share/man/man3/pthread_rwlockattr_getpshared.3 b/share/man/man3/pthread_rwlockattr_getpshared.3
index a7bbbe0..acda6e9 100644
--- a/share/man/man3/pthread_rwlockattr_getpshared.3
+++ b/share/man/man3/pthread_rwlockattr_getpshared.3
@@ -42,7 +42,8 @@
The
.Fn pthread_rwlockattr_getpshared
function is used to get the process shared setting of a read/write
-lock attribute object. The setting is returned via
+lock attribute object.
+The setting is returned via
.Fa pshared ,
and may be one of two values:
.Bl -tag -width PTHREAD_PROCESS_PRIVATE
@@ -51,13 +52,15 @@ Any thread of any process that has access to the memory where the
read/write lock resides can manipulate the lock.
.It Dv PTHREAD_PROCESS_PRIVATE
Only threads created within the same process as the thread that
-initialized the read/write lock can manipulate the lock. This is
+initialized the read/write lock can manipulate the lock.
+This is
the default value.
.El
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlockattr_getpshared
-function will return zero. Otherwise an error number will be returned
+function will return zero.
+Otherwise an error number will be returned
to indicate the error.
.Sh SEE ALSO
.Xr pthread_rwlockattr_init 3 ,
diff --git a/share/man/man3/pthread_rwlockattr_init.3 b/share/man/man3/pthread_rwlockattr_init.3
index cc78d54..0020386 100644
--- a/share/man/man3/pthread_rwlockattr_init.3
+++ b/share/man/man3/pthread_rwlockattr_init.3
@@ -45,7 +45,8 @@ function is used to initialize a read/write lock attributes object.
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlockattr_init
-function will return zero. Otherwise an error number will be returned
+function will return zero.
+Otherwise an error number will be returned
to indicate the error.
.Sh SEE ALSO
.Xr pthread_rwlockattr_destroy 3 ,
diff --git a/share/man/man3/pthread_rwlockattr_setpshared.3 b/share/man/man3/pthread_rwlockattr_setpshared.3
index 074794f..b4d2ecb 100644
--- a/share/man/man3/pthread_rwlockattr_setpshared.3
+++ b/share/man/man3/pthread_rwlockattr_setpshared.3
@@ -54,13 +54,15 @@ Any thread of any process that has access to the memory where the
read/write lock resides can manipulate the lock.
.It Dv PTHREAD_PROCESS_PRIVATE
Only threads created within the same process as the thread that
-initialized the read/write lock can manipulate the lock. This is
+initialized the read/write lock can manipulate the lock.
+This is
the default value.
.El
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlockattr_setpshared
-function will return zero. Otherwise an error number will be returned
+function will return zero.
+Otherwise an error number will be returned
to indicate the error.
.Sh SEE ALSO
.Xr pthread_rwlockattr_getpshared 3 ,
diff --git a/share/man/man3/stdarg.3 b/share/man/man3/stdarg.3
index 8dcd180..7f29f2a 100644
--- a/share/man/man3/stdarg.3
+++ b/share/man/man3/stdarg.3
@@ -85,7 +85,7 @@ and must be called first.
The parameter
.Fa last
is the name of the last parameter before the variable argument list,
-i.e. the last parameter of which the calling function knows the type.
+i.e., the last parameter of which the calling function knows the type.
.Pp
Because the address of this parameter is used in the
.Fn va_start
diff --git a/share/man/man3/sysexits.3 b/share/man/man3/sysexits.3
index 648fb06..b1ba47a 100644
--- a/share/man/man3/sysexits.3
+++ b/share/man/man3/sysexits.3
@@ -40,7 +40,8 @@ According to
it is not a good practice to call
.Xr exit 3
with arbitrary values to indicate a failure condition when ending
-a program. Instead, the pre-defined exit codes from
+a program.
+Instead, the pre-defined exit codes from
.Nm
should be used, so the caller of the process can get a rough
estimation about the failure class without looking up the source code.
@@ -50,14 +51,16 @@ The successful exit is always indicated by a status of 0, or
Error numbers begin at
.Sy EX__BASE
to reduce the possibility of clashing with other exit statuses that
-random programs may already return. The meaning of the codes is
+random programs may already return.
+The meaning of the codes is
approximately as follows:
.Bl -tag -width "EX_UNAVAILABLEXX(XX)"
.It Sy EX_USAGE Pq 64
The command was used incorrectly, e.g., with the wrong number of
arguments, a bad flag, a bad syntax in a parameter, or whatever.
.It Sy EX_DATAERR Pq 65
-The input data was incorrect in some way. This should only be used
+The input data was incorrect in some way.
+This should only be used
for user's data and not system files.
.It Sy EX_NOINPUT Pq 66
An input file (not a system file) did not exist or was not readable.
@@ -65,24 +68,31 @@ This could also include errors like
.Dq \&No message
to a mailer (if it cared to catch it).
.It Sy EX_NOUSER Pq 67
-The user specified did not exist. This might be used for mail
+The user specified did not exist.
+This might be used for mail
addresses or remote logins.
.It Sy EX_NOHOST Pq 68
-The host specified did not exist. This is used in mail addresses or
+The host specified did not exist.
+This is used in mail addresses or
network requests.
.It Sy EX_UNAVAILABLE Pq 69
-A service is unavailable. This can occur if a support program or file
-does not exist. This can also be used as a catchall message when
+A service is unavailable.
+This can occur if a support program or file
+does not exist.
+This can also be used as a catchall message when
something you wanted to do doesn't work, but you don't know why.
.It Sy EX_SOFTWARE Pq 70
-An internal software error has been detected. This should be limited
+An internal software error has been detected.
+This should be limited
to non-operating system related errors as possible.
.It Sy EX_OSERR Pq 71
-An operating system error has been detected. This is intended to be
+An operating system error has been detected.
+This is intended to be
used for such things as
.Dq cannot fork ,
.Dq cannot create pipe ,
-or the like. It includes things like getuid returning a user that
+or the like.
+It includes things like getuid returning a user that
does not exist in the passwd file.
.It Sy EX_OSFILE Pq 72
Some system file (e.g.,
@@ -103,7 +113,8 @@ The remote system returned something that was
.Dq not possible
during a protocol exchange.
.It Sy EX_NOPERM Pq 77
-You did not have sufficient permission to perform the operation. This
+You did not have sufficient permission to perform the operation.
+This
is not intended for file system problems, which should use
.Sy EX_NOINPUT
or
diff --git a/share/man/man4/atkbd.4 b/share/man/man4/atkbd.4
index 487afd6..f40b1ab 100644
--- a/share/man/man4/atkbd.4
+++ b/share/man/man4/atkbd.4
@@ -75,13 +75,13 @@ command.
.It "Function Key number"
Function Key
.It "1, 2,...12"
-F1, F2,... F12
+F1, F2,...\& F12
.It "13, 14,...24"
-Shift+F1, Shift+F2,... Shift+F12
+Shift+F1, Shift+F2,...\& Shift+F12
.It "25, 26,...36"
-Ctl+F1, Ctl+F2,... Ctl+F12
+Ctl+F1, Ctl+F2,...\& Ctl+F12
.It "37, 38,...48"
-Shift+Ctl+F1, Shift+Ctl+F2,... Shift+Ctl+F12
+Shift+Ctl+F1, Shift+Ctl+F2,...\& Shift+Ctl+F12
.It 49
Home and Numpad 7 (without NumLock)
.It 50
diff --git a/share/man/man4/bktr.4 b/share/man/man4/bktr.4
index 1478322..d90a7b4 100644
--- a/share/man/man4/bktr.4
+++ b/share/man/man4/bktr.4
@@ -169,7 +169,7 @@ and
.Em The Ports Collection
also be installed.
.It Pa /usr/ports/audio/xmradio
-An FM Radio Tuner for cards which have an FM Radio tuner fitted. - requires that
+An FM Radio Tuner for cards which have an FM Radio tuner fitted - requires that
.Em The X Window System
and
.Em The Ports Collection
diff --git a/share/man/man4/bpf.4 b/share/man/man4/bpf.4
index b9a3d33..c36bbfb 100644
--- a/share/man/man4/bpf.4
+++ b/share/man/man4/bpf.4
@@ -175,7 +175,8 @@ structure.
All other fields are undefined.
.It Dv BIOCSETIF
.Pq Li "struct ifreq"
-Sets the hardware interface associate with the file. This
+Sets the hardware interface associate with the file.
+This
command must be performed before any packets can be read.
The device is indicated by name using the
.Li ifr_name
@@ -477,26 +478,17 @@ The semantics of all the recognized
.Dv BPF_LD
instructions follow.
.Pp
-.Bl -tag -width "BPF_LD+BPF_W+BPF_IND" -compact
-.It Li BPF_LD+BPF_W+BPF_ABS
-A <- P[k:4]
-.It Li BPF_LD+BPF_H+BPF_ABS
-A <- P[k:2]
-.It Li BPF_LD+BPF_B+BPF_ABS
-A <- P[k:1]
-.It Li BPF_LD+BPF_W+BPF_IND
-A <- P[X+k:4]
-.It Li BPF_LD+BPF_H+BPF_IND
-A <- P[X+k:2]
-.It Li BPF_LD+BPF_B+BPF_IND
-A <- P[X+k:1]
-.It Li BPF_LD+BPF_W+BPF_LEN
-A <- len
-.It Li BPF_LD+BPF_IMM
-A <- k
-.It Li BPF_LD+BPF_MEM
-A <- M[k]
-.El
+.Bd -literal
+BPF_LD+BPF_W+BPF_ABS A <- P[k:4]
+BPF_LD+BPF_H+BPF_ABS A <- P[k:2]
+BPF_LD+BPF_B+BPF_ABS A <- P[k:1]
+BPF_LD+BPF_W+BPF_IND A <- P[X+k:4]
+BPF_LD+BPF_H+BPF_IND A <- P[X+k:2]
+BPF_LD+BPF_B+BPF_IND A <- P[X+k:1]
+BPF_LD+BPF_W+BPF_LEN A <- len
+BPF_LD+BPF_IMM A <- k
+BPF_LD+BPF_MEM A <- M[k]
+.Ed
.It Dv BPF_LDX
These instructions load a value into the index register.
Note that
@@ -505,32 +497,26 @@ but they include
.Dv BPF_MSH ,
a hack for efficiently loading the IP header length.
.Pp
-.Bl -tag -width "BPF_LDX+BPF_W+BPF_MEM" -compact
-.It Li BPF_LDX+BPF_W+BPF_IMM
-X <- k
-.It Li BPF_LDX+BPF_W+BPF_MEM
-X <- M[k]
-.It Li BPF_LDX+BPF_W+BPF_LEN
-X <- len
-.It Li BPF_LDX+BPF_B+BPF_MSH
-X <- 4*(P[k:1]&0xf)
-.El
+.Bd -literal
+BPF_LDX+BPF_W+BPF_IMM X <- k
+BPF_LDX+BPF_W+BPF_MEM X <- M[k]
+BPF_LDX+BPF_W+BPF_LEN X <- len
+BPF_LDX+BPF_B+BPF_MSH X <- 4*(P[k:1]&0xf)
+.Ed
.It Dv BPF_ST
This instruction stores the accumulator into the scratch memory.
We do not need an addressing mode since there is only one possibility
for the destination.
.Pp
-.Bl -tag -width "BPF_ST" -compact
-.It Li BPF_ST
-M[k] <- A
-.El
+.Bd -literal
+BPF_ST M[k] <- A
+.Ed
.It Dv BPF_STX
This instruction stores the index register in the scratch memory store.
.Pp
-.Bl -tag -width "BPF_STX" -compact
-.It Li BPF_STX
-M[k] <- X
-.El
+.Bd -literal
+BPF_STX M[k] <- X
+.Ed
.It Dv BPF_ALU
The alu instructions perform operations between the accumulator and
index register or constant, and store the result back in the accumulator.
@@ -539,42 +525,25 @@ For binary operations, a source mode is required
or
.Dv BPF_X ) .
.Pp
-.Bl -tag -width "BPF_ALU+BPF_MUL+BPF_K" -compact
-.It Li BPF_ALU+BPF_ADD+BPF_K
-A <- A + k
-.It Li BPF_ALU+BPF_SUB+BPF_K
-A <- A - k
-.It Li BPF_ALU+BPF_MUL+BPF_K
-A <- A * k
-.It Li BPF_ALU+BPF_DIV+BPF_K
-A <- A / k
-.It Li BPF_ALU+BPF_AND+BPF_K
-A <- A & k
-.It Li BPF_ALU+BPF_OR+BPF_K
-A <- A | k
-.It Li BPF_ALU+BPF_LSH+BPF_K
-A <- A << k
-.It Li BPF_ALU+BPF_RSH+BPF_K
-A <- A >> k
-.It Li BPF_ALU+BPF_ADD+BPF_X
-A <- A + X
-.It Li BPF_ALU+BPF_SUB+BPF_X
-A <- A - X
-.It Li BPF_ALU+BPF_MUL+BPF_X
-A <- A * X
-.It Li BPF_ALU+BPF_DIV+BPF_X
-A <- A / X
-.It Li BPF_ALU+BPF_AND+BPF_X
-A <- A & X
-.It Li BPF_ALU+BPF_OR+BPF_X
-A <- A | X
-.It Li BPF_ALU+BPF_LSH+BPF_X
-A <- A << X
-.It Li BPF_ALU+BPF_RSH+BPF_X
-A <- A >> X
-.It Li BPF_ALU+BPF_NEG
-A <- -A
-.El
+.Bd -literal
+BPF_ALU+BPF_ADD+BPF_K A <- A + k
+BPF_ALU+BPF_SUB+BPF_K A <- A - k
+BPF_ALU+BPF_MUL+BPF_K A <- A * k
+BPF_ALU+BPF_DIV+BPF_K A <- A / k
+BPF_ALU+BPF_AND+BPF_K A <- A & k
+BPF_ALU+BPF_OR+BPF_K A <- A | k
+BPF_ALU+BPF_LSH+BPF_K A <- A << k
+BPF_ALU+BPF_RSH+BPF_K A <- A >> k
+BPF_ALU+BPF_ADD+BPF_X A <- A + X
+BPF_ALU+BPF_SUB+BPF_X A <- A - X
+BPF_ALU+BPF_MUL+BPF_X A <- A * X
+BPF_ALU+BPF_DIV+BPF_X A <- A / X
+BPF_ALU+BPF_AND+BPF_X A <- A & X
+BPF_ALU+BPF_OR+BPF_X A <- A | X
+BPF_ALU+BPF_LSH+BPF_X A <- A << X
+BPF_ALU+BPF_RSH+BPF_X A <- A >> X
+BPF_ALU+BPF_NEG A <- -A
+.Ed
.It Dv BPF_JMP
The jump instructions alter flow of control.
Conditional jumps
@@ -592,26 +561,17 @@ opcode uses the 32 bit
field as the offset, allowing arbitrarily distant destinations.
All conditionals use unsigned comparison conventions.
.Pp
-.Bl -tag -width "BPF_JMP+BPF_KSET+BPF_X" -compact
-.It Li BPF_JMP+BPF_JA
-pc += k
-.It Li BPF_JMP+BPF_JGT+BPF_K
-pc += (A > k) ? jt : jf
-.It Li BPF_JMP+BPF_JGE+BPF_K
-pc += (A >= k) ? jt : jf
-.It Li BPF_JMP+BPF_JEQ+BPF_K
-pc += (A == k) ? jt : jf
-.It Li BPF_JMP+BPF_JSET+BPF_K
-pc += (A & k) ? jt : jf
-.It Li BPF_JMP+BPF_JGT+BPF_X
-pc += (A > X) ? jt : jf
-.It Li BPF_JMP+BPF_JGE+BPF_X
-pc += (A >= X) ? jt : jf
-.It Li BPF_JMP+BPF_JEQ+BPF_X
-pc += (A == X) ? jt : jf
-.It Li BPF_JMP+BPF_JSET+BPF_X
-pc += (A & X) ? jt : jf
-.El
+.Bd -literal
+BPF_JMP+BPF_JA pc += k
+BPF_JMP+BPF_JGT+BPF_K pc += (A > k) ? jt : jf
+BPF_JMP+BPF_JGE+BPF_K pc += (A >= k) ? jt : jf
+BPF_JMP+BPF_JEQ+BPF_K pc += (A == k) ? jt : jf
+BPF_JMP+BPF_JSET+BPF_K pc += (A & k) ? jt : jf
+BPF_JMP+BPF_JGT+BPF_X pc += (A > X) ? jt : jf
+BPF_JMP+BPF_JGE+BPF_X pc += (A >= X) ? jt : jf
+BPF_JMP+BPF_JEQ+BPF_X pc += (A == X) ? jt : jf
+BPF_JMP+BPF_JSET+BPF_X pc += (A & X) ? jt : jf
+.Ed
.It Dv BPF_RET
The return instructions terminate the filter program and specify the amount
of packet to accept (i.e., they return the truncation amount).
@@ -621,12 +581,10 @@ The return value is either a constant
or the accumulator
.Pq Dv BPF_A .
.Pp
-.Bl -tag -width "BPF_RET+BPF_K" -compact
-.It Li BPF_RET+BPF_A
-accept A bytes
-.It Li BPF_RET+BPF_K
-accept k bytes
-.El
+.Bd -literal
+BPF_RET+BPF_A accept A bytes
+BPF_RET+BPF_K accept k bytes
+.Ed
.It Dv BPF_MISC
The miscellaneous category was created for anything that doesn't
fit into the above classes, and for any new instructions that might need to
@@ -634,12 +592,10 @@ be added.
Currently, these are the register transfer instructions
that copy the index register to the accumulator or vice versa.
.Pp
-.Bl -tag -width "BPF_MISC+BPF_TAX" -compact
-.It Li BPF_MISC+BPF_TAX
-X <- A
-.It Li BPF_MISC+BPF_TXA
-A <- X
-.El
+.Bd -literal
+BPF_MISC+BPF_TAX X <- A
+BPF_MISC+BPF_TXA A <- X
+.Ed
.El
.Pp
The
@@ -765,5 +721,6 @@ and
.An -nosplit
.An Steven McCanne ,
of Lawrence Berkeley Laboratory, implemented BPF in
-Summer 1990. Much of the design is due to
+Summer 1990.
+Much of the design is due to
.An Van Jacobson .
diff --git a/share/man/man4/ccd.4 b/share/man/man4/ccd.4
index 7d98b63..0f65ea6 100644
--- a/share/man/man4/ccd.4
+++ b/share/man/man4/ccd.4
@@ -108,7 +108,7 @@ you do this, but sequential performance is not usually an issue with a
multitasking load.
.Pp
An interleave factor must be specified when using a mirroring configuration,
-even when you have only two disks (i.e. the layout winds up being the same
+even when you have only two disks (i.e., the layout winds up being the same
no matter what the interleave factor).
The interleave factor will determine
how I/O is broken up, however, and a value 128 or greater is recommended.
diff --git a/share/man/man4/cd.4 b/share/man/man4/cd.4
index 4bb9b0d..7898e71 100644
--- a/share/man/man4/cd.4
+++ b/share/man/man4/cd.4
@@ -374,7 +374,8 @@ drives; however, this is not yet under way.
The
.Nm
driver attempts to automatically determine whether the drive it is talking
-to supports 6 byte or 10 byte MODE SENSE/MODE SELECT operations. Many
+to supports 6 byte or 10 byte MODE SENSE/MODE SELECT operations.
+Many
.Tn SCSI
drives only support 6 byte commands, and
.Tn ATAPI
@@ -389,17 +390,22 @@ After that, the
driver defaults to using 6 byte commands (assuming the protocol the drive
speaks claims to support 6 byte commands), until one fails with a
.Tn SCSI
-ILLEGAL REQUEST error. Then it tries the 10 byte version of the command to
-see if that works instead. Users can change the default via per-drive
-sysctl variables and loader tunables. The variable names are the same in
+ILLEGAL REQUEST error.
+Then it tries the 10 byte version of the command to
+see if that works instead.
+Users can change the default via per-drive
+sysctl variables and loader tunables.
+The variable names are the same in
both instances:
.Pp
.Va kern.cam.cd.%d.minimum_cmd_size
.Pp
Where
.Dq %d
-is the unit number of the drive in question. Valid minimum command sizes
-are 6 and 10. Any value above 6 will be rounded to 10, and any value below
+is the unit number of the drive in question.
+Valid minimum command sizes
+are 6 and 10.
+Any value above 6 will be rounded to 10, and any value below
6 will be rounded to 6.
.Sh CHANGER OPERATION
This driver has built-in support for LUN-based CD changers.
diff --git a/share/man/man4/ch.4 b/share/man/man4/ch.4
index d82b625..48db43c 100644
--- a/share/man/man4/ch.4
+++ b/share/man/man4/ch.4
@@ -292,7 +292,7 @@ A medium is present.
.It Dv CESTATUS_IMPEXP
The medium has been deposited by the operator (and not by a picker).
.It Dv CESTATUS_EXCEPT
-The element is in an exceptional state (e.g. invalid barcode label,
+The element is in an exceptional state (e.g.\& invalid barcode label,
barcode not yet scanned).
.It Dv CESTATUS_ACCESS
The element is accessible by the picker.
diff --git a/share/man/man4/ciss.4 b/share/man/man4/ciss.4
index 1f55fff..0e49094 100644
--- a/share/man/man4/ciss.4
+++ b/share/man/man4/ciss.4
@@ -33,7 +33,7 @@ offloading most of the queueing and being-a-disk chores onto CAM.
Entry to the driver is via the PCI bus attachment
.Fn ciss_probe ,
.Fn ciss_attach ,
-etc. and via the CAM interface
+etc.\& and via the CAM interface
.Fn ciss_cam_action ,
and
.Fn ciss_cam_poll .
@@ -62,12 +62,15 @@ except under extreme load.
Non-disk devices (such as internal DATs and devices
attached to the external SCSI bus) are supported as normal CAM devices
provided that they are exported by the controller firmware and are not
-marked as being masked. Masked devices can be exposed by setting the
+marked as being masked.
+Masked devices can be exposed by setting the
.Va hw.ciss.expose_hidden_physical
-tunable to non-zero at boot time. Direct Access devices (such as disk
+tunable to non-zero at boot time.
+Direct Access devices (such as disk
drives) are only exposed as
.Xr pass 4
-devices. Hot-insertion and removal of devices is supported but a bus
+devices.
+Hot-insertion and removal of devices is supported but a bus
rescan might be necessary.
.Pp
Supported controllers include:
diff --git a/share/man/man4/cy.4 b/share/man/man4/cy.4
index 253cfb6..3cd45df 100644
--- a/share/man/man4/cy.4
+++ b/share/man/man4/cy.4
@@ -154,10 +154,12 @@ in the normal way on the initial-state devices to program
initial termios states suitable for your setup.
.Pp
The lock termios state acts as flags to disable changing
-the termios state. E.g., to lock a flag variable such as
+the termios state.
+E.g., to lock a flag variable such as
CRTSCTS, use
.Em "stty crtscts"
-on the lock-state device. Speeds and special characters
+on the lock-state device.
+Speeds and special characters
may be locked by setting the corresponding value in the lock-state
device to any nonzero value.
.Pp
@@ -170,11 +172,15 @@ should be set to suit the devices attached and may need to be
locked to prevent buggy programs from changing them.
E.g., CRTSCTS should be locked on for devices that support
RTS/CTS handshaking at all times and off for devices that don't
-support it at all. CLOCAL should be locked on for devices
-that don't support carrier. HUPCL may be locked off if you don't
-want to hang up for some reason. In general, very bad things happen
+support it at all.
+CLOCAL should be locked on for devices
+that don't support carrier.
+HUPCL may be locked off if you don't
+want to hang up for some reason.
+In general, very bad things happen
if something is locked to the wrong state, and things should not
-be locked for devices that support more than one setting. The
+be locked for devices that support more than one setting.
+The
CLOCAL flag on callin ports should be locked off for logins
to avoid certain security holes, but this needs to be done by
getty if the callin port is used for anything else.
diff --git a/share/man/man4/da.4 b/share/man/man4/da.4
index 0900852..4a6068a 100644
--- a/share/man/man4/da.4
+++ b/share/man/man4/da.4
@@ -96,7 +96,8 @@ utility.
The read cache is used to store data from device-initiated read ahead
operations as well as frequently used data.
The read cache is transparent
-to the user and can be enabled without any adverse effect. Most devices
+to the user and can be enabled without any adverse effect.
+Most devices
with a read cache come from the factory with it enabled.
The read cache can be disabled by setting the
.Tn RCD
@@ -228,14 +229,14 @@ given
unit.
(The %d above denotes the unit number of the
.Nm
-driver instance, e.g. 1, 2, 4, 8, etc.)
+driver instance, e.g.\& 1, 2, 4, 8, etc.)
Valid minimum command size values are 6, 10, 12 and 16 bytes.
The default is 6 bytes.
.Pp
The
.Nm
driver issues a CAM Path Inquiry CCB at probe time to determine whether the
-protocol the device in question speaks (e.g. ATAPI) typically doesn't allow
+protocol the device in question speaks (e.g.\& ATAPI) typically doesn't allow
6 byte commands.
If it doesn't, the
.Nm
diff --git a/share/man/man4/dc.4 b/share/man/man4/dc.4
index 34874c4..acedfdf 100644
--- a/share/man/man4/dc.4
+++ b/share/man/man4/dc.4
@@ -88,7 +88,8 @@ Others use different receiver filter programming
mechanisms.
At least one supports only chained DMA descriptors
(most support both chained descriptors and contiguously allocated
-fixed size rings). Some chips (especially the PNIC) also have
+fixed size rings).
+Some chips (especially the PNIC) also have
peculiar bugs.
The
.Nm
@@ -165,7 +166,7 @@ NDC SOHOware SFA110A (98713A)
.It
NDC SOHOware SFA110A Rev B4 (98715AEC-C)
.It
-NetGear FA310-TX Rev. D1, D2 or D3 (PNIC 82c169)
+NetGear FA310-TX Rev.\& D1, D2 or D3 (PNIC 82c169)
.It
Netgear FA511
.It
diff --git a/share/man/man4/divert.4 b/share/man/man4/divert.4
index 73a6cb1..56c5529 100644
--- a/share/man/man4/divert.4
+++ b/share/man/man4/divert.4
@@ -108,7 +108,8 @@ Packets written into a divert socket
re-enter the packet filter at the rule number
following the tag given in the port part of the socket address, which
is usually already set at the rule number that caused the diversion
-(not the next rule if there are several at the same number). If the 'tag'
+(not the next rule if there are several at the same number).
+If the 'tag'
is altered to indicate an alternative re-entry point, care should be taken
to avoid loops, where the same packet is diverted more than once at the
same rule.
diff --git a/share/man/man4/en.4 b/share/man/man4/en.4
index 4632719..fd435cc 100644
--- a/share/man/man4/en.4
+++ b/share/man/man4/en.4
@@ -14,7 +14,7 @@
The
.Nm
device driver supports Midway-based ATM interfaces including the
-Efficient Networks, Inc. ENI-155 and Adaptec ANA-59x0.
+Efficient Networks, Inc.\& ENI-155 and Adaptec ANA-59x0.
Midway is an AAL5 SAR (Segmentation and Reassembly) chip.
.Pp
For configuring the card for IP see
diff --git a/share/man/man4/fatm.4 b/share/man/man4/fatm.4
index 6fcb6c1..b74e63f 100644
--- a/share/man/man4/fatm.4
+++ b/share/man/man4/fatm.4
@@ -50,7 +50,8 @@ The driver interfaces with the
framework,
.Xr netgraph 4
and HARP.
-It provides only PVC services. Signalling, ATMARP, ILMI and other
+It provides only PVC services.
+Signalling, ATMARP, ILMI and other
higher layer protocols are implemented using
.Xr netgraph 4
or HARP.
@@ -71,12 +72,15 @@ Returns a list of
with internal driver statistics.
.It Cm hw.atm.fatmN.retry_tx
If this is set packets are stuffed back into the interface's send queue when
-the cards transmit queue is found to be full. They are transmitted later.
-If this is not set the packets are dropped. It may be useful to set this
+the cards transmit queue is found to be full.
+They are transmitted later.
+If this is not set the packets are dropped.
+It may be useful to set this
if only UBR traffic is sent.
.It Cm hw.atm.fatmN.debug
.Em (only if debugging enabled)
-These are debugging flags. See
+These are debugging flags.
+See
.Fn if_fatmvar.h
for the possible flags.
.El
@@ -97,9 +101,12 @@ fatm0: <FORE PCA200E> mem 0xd5800000-0xd59fffff irq 9 at device 9.0 on pci0
.Xr natmip 4 ,
.Xr utopia 4
.Sh BUGS
-These cards can CBR shape a single VCC only. It is currently possible to
-request more than one CBR connection. In this case all the timing will be
-wrong. See
+These cards can CBR shape a single VCC only.
+It is currently possible to
+request more than one CBR connection.
+In this case all the timing will be
+wrong.
+See
.Xr hatm 4
for a better card.
.Sh AUTHORS
diff --git a/share/man/man4/geom.4 b/share/man/man4/geom.4
index 6592910..1ba1ec6 100644
--- a/share/man/man4/geom.4
+++ b/share/man/man4/geom.4
@@ -54,15 +54,18 @@ Compared to traditional "volume management", GEOM differs from most
and in some cases all previous implementations in the following ways:
.Bl -bullet
.It
-GEOM is extensible. It is trivially simple to write a new class
-of transformation and it will not be given stepchild treatment. If
+GEOM is extensible.
+It is trivially simple to write a new class
+of transformation and it will not be given stepchild treatment.
+If
someone for some reason wanted to mount IBM MVS diskpacks, a class
recognizing and configuring their VTOC information would be a trivial
matter.
.It
-GEOM is topologically agnostic. Most volume management implementations
+GEOM is topologically agnostic.
+Most volume management implementations
have very strict notions of how classes can fit together, very often
-one fixed hierarchy is provided for instance subdisk - plex -
+one fixed hierarchy is provided for instance subdisk - plex -
volume.
.El
.Pp
@@ -83,11 +86,13 @@ GEOM is quite object oriented and consequently the terminology
borrows a lot of context and semantics from the OO vocabulary:
.Pp
A "class", represented by the data structure g_class implements one
-particular kind of transformation. Typical examples are MBR disk
+particular kind of transformation.
+Typical examples are MBR disk
partition, BSD disklabel, and RAID5 classes.
.Pp
An instance of a class is called a "geom" and represented by the
-data structure "g_geom". In a typical i386 FreeBSD system, there
+data structure "g_geom".
+In a typical i386 FreeBSD system, there
will be one geom of class MBR for each disk.
.Pp
A "provider", represented by the data structure "g_provider", is
@@ -116,7 +121,8 @@ A provider can have zero or more consumers attached.
.El
.Pp
All geoms have a rank-number assigned, which is used to detect and
-prevent loops in the acyclic directed graph. This rank number is
+prevent loops in the acyclic directed graph.
+This rank number is
assigned as follows:
.Bl -enum
.It
@@ -161,7 +167,8 @@ is the process by which a provider is removed while
it potentially is still being used.
.Pp
When a geom orphans a provider, all future I/O requests will
-"bounce" on the provider with an error code set by the geom. Any
+"bounce" on the provider with an error code set by the geom.
+Any
consumers attached to the provider will receive notification about
the orphanization when the eventloop gets around to it, and they
can take appropriate action at that time.
@@ -226,7 +233,7 @@ Imagine a disk, "da0" on top of which a MBR geom provides
"da0s1a" through "da0s1e", both the MBR and BSD geoms have
autoconfigured based on data structures on the disk media.
Now imagine the case where "da0" is opened for writing and those
-data structures are modified or overwritten: Now the geoms would
+data structures are modified or overwritten: Now the geoms would
be operating on stale metadata unless some notification system
can inform them otherwise.
.Pp
@@ -273,7 +280,8 @@ again, it has served its purpose.
.Pp
.Em CONFIGURE
is the process where the administrator issues instructions
-for a particular class to instantiate itself. There are multiple
+for a particular class to instantiate itself.
+There are multiple
ways to express intent in this case, a particular provider can be
specified with a level of override forcing for instance a BSD
disklabel module to attach to a provider which was not found palatable
@@ -311,7 +319,8 @@ range to reduce the amount of data available for attack.
It is important to recognize that a delete indication is not a
request and consequently there is no guarantee that the data actually
will be erased or made unavailable unless guaranteed by specific
-geoms in the graph. If "secure delete" semantics are required, a
+geoms in the graph.
+If "secure delete" semantics are required, a
geom should be pushed which converts delete indications into (a
sequence of) write requests.
.Pp
@@ -328,7 +337,8 @@ under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the
DARPA CHATS research program.
.Pp
The first precursor for GEOM was a gruesome hack to Minix 1.2 and was
-never distributed. An earlier attempt to implement a less general scheme
+never distributed.
+An earlier attempt to implement a less general scheme
in FreeBSD never succeeded.
.Sh AUTHORS
.An "Poul-Henning Kamp" Aq phk@FreeBSD.org
diff --git a/share/man/man4/gre.4 b/share/man/man4/gre.4
index d45b903..88064c7 100644
--- a/share/man/man4/gre.4
+++ b/share/man/man4/gre.4
@@ -70,7 +70,7 @@ Encapsulated datagrams are
prepended an outer datagram and a GRE header.
The GRE header specifies
the type of the encapsulated datagram and thus allows for tunneling other
-protocols than IP like e.g. AppleTalk.
+protocols than IP like e.g.\& AppleTalk.
GRE mode is also the default tunnel mode on Cisco routers.
This is also the default mode of operation of the
.Nm
@@ -158,7 +158,7 @@ Query operation mode.
Note that the IP addresses of the tunnel endpoints may be the same as the
ones defined with
.Xr ifconfig 8
-for the interface (as if IP is encapsulated), but need not be, as e.g. when
+for the interface (as if IP is encapsulated), but need not be, as e.g.\& when
encapsulating AppleTalk.
.Sh EXAMPLES
Configuration example:
@@ -204,7 +204,7 @@ ifconfig tunnel greN D A
If all goes well, you should see packets flowing ;-)
.Pp
If you want to reach Host A over the tunnel (from Host D (Cisco)), then
-you have to have an alias on Host A for e.g. the Ethernet interface like:
+you have to have an alias on Host A for e.g.\& the Ethernet interface like:
.Pp
.Dl "ifconfig <etherif> alias Y"
.Pp
diff --git a/share/man/man4/gusc.4 b/share/man/man4/gusc.4
index 705c53d..05b71c8 100644
--- a/share/man/man4/gusc.4
+++ b/share/man/man4/gusc.4
@@ -57,7 +57,8 @@ Gravis UltraSound MAX
.Pp
The value of flags specifies the secondary DMA channel.
If the secondary
-DMA channel is C, set the flags to (C | 0x10). For a sound card without the
+DMA channel is C, set the flags to (C | 0x10).
+For a sound card without the
secondary DMA channel, the flags should be set to zero.
.Sh DIAGNOSTICS
.Bl -diag
diff --git a/share/man/man4/hatm.4 b/share/man/man4/hatm.4
index 26ffebd..59ac3096 100644
--- a/share/man/man4/hatm.4
+++ b/share/man/man4/hatm.4
@@ -51,7 +51,8 @@ The driver interfaces with the
framework,
.Xr netgraph 4
and the HARP ATM stack.
-It provides only PVC services. Signalling, ATMARP, ILMI and other
+It provides only PVC services.
+Signalling, ATMARP, ILMI and other
higher layer protocols are implemented using
.Xr netgraph 4
or HARP.
@@ -64,7 +65,8 @@ handled by
.Xr utopia 4 :
.Bl -tag -width XXX
.It Cm hw.atm.hatm.natm_traffic
-This is the traffic type to be used for NATM pvc connections. The type of
+This is the traffic type to be used for NATM pvc connections.
+The type of
this variable is integer and it must have one of the values 0 (UBR) or 1 (CBR).
.It Cm hw.atm.hatm.natm_pcr
This is the peak cell rate to be used for NATM CBR connections.
@@ -78,12 +80,14 @@ Contains an array of
with internal driver statistics.
.It Cm hw.atm.hatmN.debug
.Em (only if debugging enabled)
-These are the debugging flags. See
+These are the debugging flags.
+See
.Fn if_hatmvar.h
for the possible flags.
.It Cm hw.atm.hatmN.tsr
.Em (only if debugging enabled)
-This is an array containing all transmission status registers. For each of the
+This is an array containing all transmission status registers.
+For each of the
4096 possible VCCs there are 15 32-bit registers.
.It Cm hw.atm.hatmN.tpd
.Em (only if debugging enabled)
@@ -120,86 +124,120 @@ hatm0: ForeRunnerHE 622, Rev. D, S/N 2949834, MAC=00:20:48:2d:02:ca
When attaching to a device the driver checks the kernel environment
(see
.Xr kenv 4 )
-to see if the default queues sizes should be overwritten or not. The
+to see if the default queues sizes should be overwritten or not.
+The
following variables are checked and interpreted as unsigned integer
values (in either radix):
.Bl -tag -width XXX
.It Cm hw.hatmN.rbps0_size
-Size of the small receive buffer pool 0. This pool is used for all
-except raw AAL connections. The pool size must be a power of two between
-4 and 8192 inclusive. When attaching the driver allocates this number
+Size of the small receive buffer pool 0.
+This pool is used for all
+except raw AAL connections.
+The pool size must be a power of two between
+4 and 8192 inclusive.
+When attaching the driver allocates this number
of mbufs.
.It Cm hw.hatmN.rbps0_thresh
-Interrupt threshold for small receive buffer pool 0. When the number of free
+Interrupt threshold for small receive buffer pool 0.
+When the number of free
buffers in the pool falls below this threshold it generates an interrupt
so that the driver can refill the pool.
.It Cm hw.hatmN.rbpl0_thresh
-Size of the large receive buffer pool 0. This pool is used for all
-except raw AAL connections. The pool size must be a power of two between
-4 and 8192 inclusive. When attaching the driver allocates this number
+Size of the large receive buffer pool 0.
+This pool is used for all
+except raw AAL connections.
+The pool size must be a power of two between
+4 and 8192 inclusive.
+When attaching the driver allocates this number
of mbufs with clusters.
.It Cm hw.hatmN.rbpl0_thresh
-Interrupt threshold for large receive buffer pool 0. When the number of free
+Interrupt threshold for large receive buffer pool 0.
+When the number of free
buffers in the pool falls below this threshold it generates an interrupt
so that the driver can refill the pool.
.It Cm hw.hatmN.rbrq0_size
-Size of receive buffer return queue 0. This queue is used to return buffers
-filled with received frames to the driver. The size must be a power of 2
+Size of receive buffer return queue 0.
+This queue is used to return buffers
+filled with received frames to the driver.
+The size must be a power of 2
between 1 and 16384 inclusive.
.It Cm hw.hatmN.rbrq0_thresh
-Interrupt threshold for receive buffer return queue 0. This threshold
+Interrupt threshold for receive buffer return queue 0.
+This threshold
should only be triggered in exceptional cases.
.It Cm hw.hatmN.rbrq0_tout
-Interrupt timeout for receive buffer return queue 0. An interrupt is generated
-after this time if the queue is not empty. The number is in internal card
+Interrupt timeout for receive buffer return queue 0.
+An interrupt is generated
+after this time if the queue is not empty.
+The number is in internal card
ticks.
.It Cm hw.hatmN.rbrq0_pcnt
-Packet count threshold for receive buffer return queue 0. An interrupt
+Packet count threshold for receive buffer return queue 0.
+An interrupt
is generated if this number of packets is in the queue.
.It Cm hw.hatmN.rbps1_size
-Size of the small receive buffer pool 1. This pool is used for all
-raw AAL connections. The pool size must be a power of two between
-4 and 8192 inclusive. When attaching the driver allocates this number
+Size of the small receive buffer pool 1.
+This pool is used for all
+raw AAL connections.
+The pool size must be a power of two between
+4 and 8192 inclusive.
+When attaching the driver allocates this number
of mbufs.
.It Cm hw.hatmN.rbps1_thresh
-Interrupt threshold for small receive buffer pool 1. When the number of free
+Interrupt threshold for small receive buffer pool 1.
+When the number of free
buffers in the pool falls below this threshold it generates an interrupt
so that the driver can refill the pool.
.It Cm hw.hatmN.rbrq1_size
-Size of receive buffer return queue 1. This queue is used to return buffers
-filled with received cells to the driver. The size must be a power of 2
+Size of receive buffer return queue 1.
+This queue is used to return buffers
+filled with received cells to the driver.
+The size must be a power of 2
between 1 and 16384 inclusive.
.It Cm hw.hatmN.rbrq1_thresh
-Interrupt threshold for receive buffer return queue 1. This threshold
+Interrupt threshold for receive buffer return queue 1.
+This threshold
should only be triggered in exceptional cases.
.It Cm hw.hatmN.rbrq1_tout
-Interrupt timeout for receive buffer return queue 1. An interrupt is generated
-after this time if the queue is not empty. The number is in internal card
+Interrupt timeout for receive buffer return queue 1.
+An interrupt is generated
+after this time if the queue is not empty.
+The number is in internal card
ticks.
.It Cm hw.hatmN.rbrq1_pcnt
-Packet count threshold for receive buffer return queue 0. An interrupt
+Packet count threshold for receive buffer return queue 0.
+An interrupt
is generated if this number of cells is in the queue.
.It Cm hw.hatmN.irq0_size
-Size of interrupt queue 0. This must be a number between 1 and 1023 inclusive.
+Size of interrupt queue 0.
+This must be a number between 1 and 1023 inclusive.
.It Cm hw.hatmN.irq0_thresh
-Interrupt retrigger threshold of interrupt queue 0. A new interrupt is trigger
+Interrupt retrigger threshold of interrupt queue 0.
+A new interrupt is trigger
if the queue fill state reaches this threshold and the interrupt was no
served.
.It Cm hw.hatmN.tbrq0_size
-Transmit buffer return queue 0 size. This queue is used to feed back empty
-buffers of transmitted frames back to the driver. It must be a power of 2
+Transmit buffer return queue 0 size.
+This queue is used to feed back empty
+buffers of transmitted frames back to the driver.
+It must be a power of 2
between 1 and 4096 inclusive.
.It Cm hw.hatmN.tbrq0_thresh
-Transmit buffer return queue 0 threshold. An interrupt is generated if the
+Transmit buffer return queue 0 threshold.
+An interrupt is generated if the
queue fill state reaches this point.
.It Cm hw.hatmN.tpdrq_size
-Transmit descriptor ready queue size. This queue is used by the driver
-to feed transmit descriptors into the card. The size must be a power of 2
+Transmit descriptor ready queue size.
+This queue is used by the driver
+to feed transmit descriptors into the card.
+The size must be a power of 2
between 1 and 16384 inclusive.
.It Cm hw.hatmN.tpdmax
-Maximum number of active TPDs per connection. This controls the maximum
+Maximum number of active TPDs per connection.
+This controls the maximum
number of outstanding packet chunks per connection and thus the maximum
-delay packets can have because of queueing on the adapter. If set to 0,
+delay packets can have because of queueing on the adapter.
+If set to 0,
a connection can eat up all available TPDs.
.It Cm hw.hatmN.mbuf_max_pages
Maximum number of memory pages allocated to small external mbufs.
diff --git a/share/man/man4/ifmib.4 b/share/man/man4/ifmib.4
index 6c0a027..e1c69b6 100644
--- a/share/man/man4/ifmib.4
+++ b/share/man/man4/ifmib.4
@@ -90,7 +90,7 @@ The index of the last row in the table is given by
A management application searching for a particular interface should
start with row 1 and continue through the table row-by-row until the
desired interface is found, or the interface count is reached.
-Note that the table may be sparse, i.e. a given row may not exist,
+Note that the table may be sparse, i.e., a given row may not exist,
indicated by an
.Va errno
of
diff --git a/share/man/man4/iic.4 b/share/man/man4/iic.4
index 02b7dd7..45d669c 100644
--- a/share/man/man4/iic.4
+++ b/share/man/man4/iic.4
@@ -38,7 +38,9 @@ The
character device driver provides generic i/o to any
.Xr iicbus 4
instance.
-In order to control I2C devices, use /dev/iic? with the
+In order to control I2C devices, use
+.Pa /dev/iic?
+with the
following ioctls:
.Pp
.Bl -column "I2CRSTCARD" -compact
diff --git a/share/man/man4/inet.4 b/share/man/man4/inet.4
index 1ee544b..cc5881e 100644
--- a/share/man/man4/inet.4
+++ b/share/man/man4/inet.4
@@ -44,7 +44,7 @@
.Sh DESCRIPTION
The Internet protocol family is a collection of protocols
layered atop the
-.Em Internet Protocol
+.Em Internet Protocol
.Pq Tn IP
transport layer, and utilizing the Internet address format.
The Internet family provides protocol support for the
diff --git a/share/man/man4/intro.4 b/share/man/man4/intro.4
index 1bd6641..93a9ab5 100644
--- a/share/man/man4/intro.4
+++ b/share/man/man4/intro.4
@@ -127,7 +127,7 @@ This includes making backups of entire disk partitions, or
to
.Em raw
floppy disks
-(i.e. those used like tapes).
+(i.e., those used like tapes).
.Pp
Access restrictions to device nodes are usually subject to the regular
file permissions of the device node entry, instead of being enforced
diff --git a/share/man/man4/ip6.4 b/share/man/man4/ip6.4
index 52c7774..a3e38de 100644
--- a/share/man/man4/ip6.4
+++ b/share/man/man4/ip6.4
@@ -104,7 +104,7 @@ The basic API looks very similar to the API presented in
Advanced API uses ancillary data and can handle more complex cases.
.Pp
To specify some of socket options, certain privilege
-(i.e. root privilege) is required.
+(i.e., root privilege) is required.
.\"
.Ss Basic IPv6 sockets API
.Dv IPV6_UNICAST_HOPS
diff --git a/share/man/man4/ispfw.4 b/share/man/man4/ispfw.4
index 3e38197..c5376d7 100644
--- a/share/man/man4/ispfw.4
+++ b/share/man/man4/ispfw.4
@@ -33,8 +33,10 @@
.Cd "device ispfw"
.Sh DESCRIPTION
This trivial driver provides access to firmware sets for the Qlogic
-based SCSI and FibreChannel SCSI Host Adapters. It may either be
-statically linked into the kernel, or loaded as a module. In either
+based SCSI and FibreChannel SCSI Host Adapters.
+It may either be
+statically linked into the kernel, or loaded as a module.
+In either
case, the
.Xr isp 4
driver will notice that firmware is available to be downloaded onto
diff --git a/share/man/man4/joy.4 b/share/man/man4/joy.4
index 1bf327a..d645593 100644
--- a/share/man/man4/joy.4
+++ b/share/man/man4/joy.4
@@ -61,16 +61,16 @@ only interested by the buttons status.
Get the time limit (in microseconds) used for reading the joystick
status.
.It Dv JOY_SET_X_OFFSET Fa int *offset
-Set the value to be added to the X position when reading the joystick
+Set the value to be added to the X position when reading the joystick
status.
.It Dv JOY_SET_Y_OFFSET Fa int *offset
-Set the value to be added to the Y position when reading the joystick
+Set the value to be added to the Y position when reading the joystick
status.
.It Dv JOY_GET_X_OFFSET Fa int *offset
-Get the value which is added to the X position when reading the joystick
+Get the value which is added to the X position when reading the joystick
status.
.It Dv JOY_GET_Y_OFFSET Fa int *offset
-Get the value which is added to the Y position when reading the joystick
+Get the value which is added to the Y position when reading the joystick
status.
.El
.Sh TECHNICAL SPECIFICATIONS
diff --git a/share/man/man4/keyboard.4 b/share/man/man4/keyboard.4
index b19b0de..e68c6a1 100644
--- a/share/man/man4/keyboard.4
+++ b/share/man/man4/keyboard.4
@@ -50,7 +50,8 @@ Switch virtual console.
Change the meaning of another key.
.El
.Pp
-The keyboard is seen as a number of keys numbered from 1 to n. This
+The keyboard is seen as a number of keys numbered from 1 to n.
+This
number is often referred to as the "scancode" for a given key.
The number
of the key is transmitted as an 8 bit char with bit 7 as 0 when a key is
@@ -92,17 +93,21 @@ represented by the map array, as shown below:
.Ed
.Pp
This is the default mapping for the key labelled 'A' which normally has
-scancode 0x1E. The eight states are as shown, giving the 'A' key its
+scancode 0x1E.
+The eight states are as shown, giving the 'A' key its
normal behavior.
The spcl field is used to give the key "special" treatment, and is
interpreted as follows.
Each bit corresponds to one of the states above.
If the bit is 0 the
key emits the number defined in the corresponding map[] entry.
-If the bit is 1 the key is "special". This means it does not emit
-anything; instead it changes the "state". That means it is a shift,
+If the bit is 1 the key is "special".
+This means it does not emit
+anything; instead it changes the "state".
+That means it is a shift,
control, alt, lock, switch-screen, function-key or no-op key.
-The bitmap is backwards ie. 7 for base, 6 for shift etc.
+The bitmap is backwards i.e.,
+7 for base, 6 for shift etc.
.Pp
The flgs field defines if the key should react on caps-lock (1),
num-lock (2), both (3) or ignore both (0).
@@ -113,7 +118,7 @@ utility is used to load such a description into/outof
the kernel at runtime.
This makes it possible to change the key
assignments at runtime, or more important to get (GIO_KEYMAP ioctl)
-the exact key meanings from the kernel (fx. used by the X server).
+the exact key meanings from the kernel (e.g.\& used by the X server).
.Pp
The function keys can be programmed using the SETFKEY ioctl call.
.Pp
diff --git a/share/man/man4/lp.4 b/share/man/man4/lp.4
index 4d0ff79..7efff98 100644
--- a/share/man/man4/lp.4
+++ b/share/man/man4/lp.4
@@ -153,7 +153,7 @@ The packet format has a two-byte header, comprising the fixed values 0x08,
The start of a packet is indicated by simply signalling the first byte
of the header.
The end of the packet is indicated by inverting
-the data lines (ie. writing the ones-complement of the previous nibble
+the data lines (i.e., writing the ones-complement of the previous nibble
to be transmitted) without changing the state of the handshake.
.Pp
Note that the end-of-packet marker assumes that the handshake signal and
diff --git a/share/man/man4/mac.4 b/share/man/man4/mac.4
index 43b5e1b..38b060d 100644
--- a/share/man/man4/mac.4
+++ b/share/man/man4/mac.4
@@ -273,7 +273,8 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.
+under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
.Sh BUGS
diff --git a/share/man/man4/mac_biba.4 b/share/man/man4/mac_biba.4
index 3306e86..1086d19 100644
--- a/share/man/man4/mac_biba.4
+++ b/share/man/man4/mac_biba.4
@@ -232,6 +232,7 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.
+under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
diff --git a/share/man/man4/mac_bsdextended.4 b/share/man/man4/mac_bsdextended.4
index 012c31f..8b087a2 100644
--- a/share/man/man4/mac_bsdextended.4
+++ b/share/man/man4/mac_bsdextended.4
@@ -105,6 +105,6 @@ Project.
This software was contributed to the
.Fx
Project by NAI Labs, the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.\& under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
diff --git a/share/man/man4/mac_ifoff.4 b/share/man/man4/mac_ifoff.4
index 331ea79..425b9a2 100644
--- a/share/man/man4/mac_ifoff.4
+++ b/share/man/man4/mac_ifoff.4
@@ -114,7 +114,8 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.
+under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
.Sh BUGS
diff --git a/share/man/man4/mac_lomac.4 b/share/man/man4/mac_lomac.4
index e76b7db..8133ad8 100644
--- a/share/man/man4/mac_lomac.4
+++ b/share/man/man4/mac_lomac.4
@@ -216,6 +216,7 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.
+under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
diff --git a/share/man/man4/mac_mls.4 b/share/man/man4/mac_mls.4
index 9659ebe..ccbf009 100644
--- a/share/man/man4/mac_mls.4
+++ b/share/man/man4/mac_mls.4
@@ -112,7 +112,7 @@ clearance level is lower than the clearance level of the object it is
attempting to observe.
.It
Subjects may not read, write, or otherwise observe objects without proper
-clearance (e.g. subjects may not observe objects whose classification label
+clearance (e.g.\& subjects may not observe objects whose classification label
dominates its own clearance label)
.It
Subjects may not write to objects with a lower classification level than
@@ -233,7 +233,7 @@ This software was contributed to the
.Fx
Project by Network Associates Laboratories,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.\& under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
.Sh BUGS
diff --git a/share/man/man4/mac_none.4 b/share/man/man4/mac_none.4
index 12caab6..50a34af 100644
--- a/share/man/man4/mac_none.4
+++ b/share/man/man4/mac_none.4
@@ -93,7 +93,8 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.
+under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
.Sh BUGS
diff --git a/share/man/man4/mac_partition.4 b/share/man/man4/mac_partition.4
index 11c70dc..b1224dd 100644
--- a/share/man/man4/mac_partition.4
+++ b/share/man/man4/mac_partition.4
@@ -114,7 +114,8 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.
+under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
.Sh BUGS
diff --git a/share/man/man4/mac_portacl.4 b/share/man/man4/mac_portacl.4
index 250eb2d..39b819f 100644
--- a/share/man/man4/mac_portacl.4
+++ b/share/man/man4/mac_portacl.4
@@ -227,6 +227,6 @@ first appeared in
This software was contributed to the
.Fx
Project by NAI Labs, the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.\& under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
diff --git a/share/man/man4/mac_seeotheruids.4 b/share/man/man4/mac_seeotheruids.4
index d328d7b..0c0bb70 100644
--- a/share/man/man4/mac_seeotheruids.4
+++ b/share/man/man4/mac_seeotheruids.4
@@ -107,7 +107,8 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.
+under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
.Sh BUGS
diff --git a/share/man/man4/mac_stub.4 b/share/man/man4/mac_stub.4
index e78f487..ded95e2 100644
--- a/share/man/man4/mac_stub.4
+++ b/share/man/man4/mac_stub.4
@@ -96,7 +96,8 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.
+under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
.Sh BUGS
diff --git a/share/man/man4/mac_test.4 b/share/man/man4/mac_test.4
index 0a2e430..dde7445 100644
--- a/share/man/man4/mac_test.4
+++ b/share/man/man4/mac_test.4
@@ -97,7 +97,8 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.
+under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
.Sh BUGS
diff --git a/share/man/man4/man4.alpha/osf1.4 b/share/man/man4/man4.alpha/osf1.4
index d4a1743..f41937f 100644
--- a/share/man/man4/man4.alpha/osf1.4
+++ b/share/man/man4/man4.alpha/osf1.4
@@ -32,7 +32,7 @@
.Nd OSF/1 ABI support
.Sh SYNOPSIS
To link OSF/1 ABI support into the kernel:
-.Cd options COMPAT_OSF1
+.Cd "options COMPAT_OSF1"
.Pp
To load the OSF/1 ABI support kernel module:
.Dl kldload osf1
diff --git a/share/man/man4/man4.i386/acpi_asus.4 b/share/man/man4/man4.i386/acpi_asus.4
index 2d5314d..0e2cbfd 100644
--- a/share/man/man4/man4.i386/acpi_asus.4
+++ b/share/man/man4/man4.i386/acpi_asus.4
@@ -81,7 +81,8 @@ TV-Out
.Pp
Some models also support video switching via the generic
.Xr acpi_video 4
-driver. Most models don't, however.
+driver.
+Most models don't, however.
.El
.Pp
Defaults for these variables can be set in
diff --git a/share/man/man4/man4.i386/amdpm.4 b/share/man/man4/man4.i386/amdpm.4
index 400f79b..df513f0 100644
--- a/share/man/man4/man4.i386/amdpm.4
+++ b/share/man/man4/man4.i386/amdpm.4
@@ -55,7 +55,9 @@ The
driver first appeared in
.Fx 4.5 .
.Sh AUTHORS
-This driver was written by Matthew C. Forman.
+.An -nosplit
+This driver was written by
+.An "Matthew C. Forman" .
Based heavily on the
.Nm alpm
driver by
diff --git a/share/man/man4/man4.i386/apm.4 b/share/man/man4/man4.i386/apm.4
index ec44015..e9c78b3 100644
--- a/share/man/man4/man4.i386/apm.4
+++ b/share/man/man4/man4.i386/apm.4
@@ -40,14 +40,17 @@ comprising of system wakeup time and elapsed time during suspended mode.
.It
.Nm
slows CPU clock when there are no system activities (runnable processes,
-interrupts, etc.). This function is available only on systems whose APM
+interrupts, etc.).
+This function is available only on systems whose APM
supports CPU idling.
.It
.Nm
-exports an application interface as a character device. Applications
+exports an application interface as a character device.
+Applications
can control APM, or retrieve APM status information via this interface.
.Nm
-exports the following interfaces. These symbols are defined in
+exports the following interfaces.
+These symbols are defined in
.In machine/apm_bios.h .
.Bl -tag -width 4n -offset indent
.It Sy APMIO_SUSPEND
@@ -67,11 +70,13 @@ Some APM implementations execute the HLT
(Halt CPU until an interrupt occurs)
instruction in the
.Dq Em Idle CPU
-call, while others do not. Thus enabling this may result in
+call, while others do not.
+Thus enabling this may result in
redundant HLT executions because
.Dq Em Idle CPU
is called from the kernel context switch routine that inherently executes
-HLT. This may reduce peak system performance.
+HLT.
+This may reduce peak system performance.
.Pp
Also the system hangs up if HLT instruction is disabled in the kernel
context switch routine, and if the APM implementation of the machine
@@ -89,7 +94,8 @@ The current version of
does not call
.Dq Em Idle CPU
from the kernel context switch routine if clock slowdown is not supported,
-and it executes HLT instruction by default. Therefore, there is
+and it executes HLT instruction by default.
+Therefore, there is
no need to use these two operations in most cases.
.El
.Pp
@@ -112,10 +118,14 @@ polls APM events and handles the following events.
.El
.El
.Sh BUGS
-WARNING! Many, if not most, of the implementations of APM-bios in laptops
-today are buggy. You may be putting your LCD-display and batteries at
-a risk by using this interface. (The reason this isn't a problem for
-MS-windows is that they use the real-mode interface.) If you see any
+WARNING!
+Many, if not most, of the implementations of APM-bios in laptops
+today are buggy.
+You may be putting your LCD-display and batteries at
+a risk by using this interface.
+(The reason this isn't a problem for
+MS-windows is that they use the real-mode interface.)
+If you see any
weird behavior from your system with this code in use, unplug the
power and batteries ASAP, if not immediately, and disable this code.
.Pp
@@ -129,7 +139,8 @@ may cause serious trouble when resuming the system.
BIOS setup programs should be called during bootstrap, or from DOS.
.Pp
Some APM implementations cannot handle events such as pushing the
-power button or closing the cover. On such implementations, the system
+power button or closing the cover.
+On such implementations, the system
.Ar must
be suspended
.Ar only
diff --git a/share/man/man4/man4.i386/ar.4 b/share/man/man4/man4.i386/ar.4
index f2e9c38..114bbc7 100644
--- a/share/man/man4/man4.i386/ar.4
+++ b/share/man/man4/man4.i386/ar.4
@@ -61,9 +61,11 @@ Alternately, the driver can be compiled to support
(see below).
.Sh NUMBERING
Only one line for each card is needed in the kernel configuration file.
-The first card's ports will be installed from ar0. The numbering of the
-next card will continue where the first stopped, eg. if the first card
-is a two port card it will use ar0 and ar1. The next card will then
+The first card's ports will be installed from ar0.
+The numbering of the
+next card will continue where the first stopped, e.g.\& if the first card
+is a two port card it will use ar0 and ar1.
+The next card will then
start at ar2.
.Pp
The card only supports IRQ 3, 5, 7, 10, 11, 12 and 15.
diff --git a/share/man/man4/man4.i386/cs.4 b/share/man/man4/man4.i386/cs.4
index 9e1efc5..1687a32 100644
--- a/share/man/man4/man4.i386/cs.4
+++ b/share/man/man4/man4.i386/cs.4
@@ -47,7 +47,8 @@ driver provides support for ISA ethernet adapters based on the
.Tn Crystal Semiconductor CS8900
and
.Tn CS8920
-NICs. These devices are used on the
+NICs.
+These devices are used on the
.Tn IBM EtherJet ISA
adapters and in many embedded applications where the high integration, small
size and low cost of the CS89x0 family compensate for their drawbacks.
@@ -62,7 +63,8 @@ Other parameters specified in
.Pa /boot/device.hints
will be used if present;
the card may be soft-configured so these may be any valid
-value. Adapters based on the CS8920 normally offer PnP configuration and the driver
+value.
+Adapters based on the CS8920 normally offer PnP configuration and the driver
will detect the
.Tn IBM EtherJet
and the
@@ -70,25 +72,29 @@ and the
adapters automatically.
.Pp
Note that the CS8900 is limited to 4 IRQ values; these are normally implemented
-as 5, 10, 11 and 12. The CS8920 has no such limitation.
+as 5, 10, 11 and 12.
+The CS8920 has no such limitation.
.Pp
Memory-mapped and DMA operation are not supported at this time.
.Sh DIAGNOSTICS
.Bl -diag
.It "cs%d: full/half duplex negotiation timeout"
-The attempt to negotiate duplex settings with the hub timed out. This may
+The attempt to negotiate duplex settings with the hub timed out.
+This may
indicate a cabling problem or a faulty or incompatible hub.
.It "cs%d: failed to enable <media>"
The CS89x0 failed to select the nominated media, either because it is not
present or not operating correctly.
.It "cs%d: No EEPROM, assuming defaults"
-The CS89x0 does not have an EEPROM, or the EEPROM is hopelessly damaged. Operation
+The CS89x0 does not have an EEPROM, or the EEPROM is hopelessly damaged.
+Operation
will only be successful if the configuration entry lists suitable values for
the adapter.
.It "cs%d: Invalid irq"
The IRQ specified in the configuration entry is not valid for the adapter.
.It "cs%d: Could not allocate memory for NIC"
-There is a critical memory shortage. The adapter will not function.
+There is a critical memory shortage.
+The adapter will not function.
.It "cs%d: Adapter has no media"
The adapter is not configured for a specific media type.
The media type will have
@@ -98,11 +104,13 @@ The PnP probe code found a recognised adapter, but the adapter is disabled.
.It "failed to read pnp parms"
A PnP adapter was found, but configuration parameters for it could not be read.
.It "failed to pnp card parameters"
-The parameters obtained via PnP were not accepted by the driver. The adapter
+The parameters obtained via PnP were not accepted by the driver.
+The adapter
may not function.
.El
.Sh CAVEATS
-The CS89x0 family of adapters have a very small RAM buffer (4K). This may
+The CS89x0 family of adapters have a very small RAM buffer (4K).
+This may
cause problems with extremely high network loads or bursty network traffic.
In particular, NFS operations should be limited to 1k read/write transactions
in order to avoid overruns.
diff --git a/share/man/man4/man4.i386/ct.4 b/share/man/man4/man4.i386/ct.4
index 85ee11b..c31877c 100644
--- a/share/man/man4/man4.i386/ct.4
+++ b/share/man/man4/man4.i386/ct.4
@@ -123,9 +123,12 @@ host adapters.
.Xr scsi 4
.Sh NOTES
Historically, the driver for the Cronyx Tau WAN adapters was
-ct. This device name was changed to ctau to avoid conflicts
-with this pc98 ct driver. The network device name for ctau
-is 'ct'. Please see
+ct.
+This device name was changed to ctau to avoid conflicts
+with this pc98 ct driver.
+The network device name for ctau
+is 'ct'.
+Please see
.Xr ctau 4
for the details for that device.
.Sh HISTORY
diff --git a/share/man/man4/man4.i386/ex.4 b/share/man/man4/man4.i386/ex.4
index 5ece8b3..038213b 100644
--- a/share/man/man4/man4.i386/ex.4
+++ b/share/man/man4/man4.i386/ex.4
@@ -41,8 +41,10 @@ and Pro/10+ Ethernet cards based on the Intel i82595 chip.
The Olicom OC2220 is also supported.
.Pp
The card will be searched for in the
-I/O address range 0x200 - 0x3a0. If the IRQ will be
-read from the EEPROM on the card. For correct operation on newer
+I/O address range 0x200 - 0x3a0.
+If the IRQ will be
+read from the EEPROM on the card.
+For correct operation on newer
cards the Plug-N-Play support should be disabled.
.Sh DIAGNOSTICS
.Bl -diag
diff --git a/share/man/man4/man4.i386/fe.4 b/share/man/man4/man4.i386/fe.4
index 5133d91..51f04ec 100644
--- a/share/man/man4/man4.i386/fe.4
+++ b/share/man/man4/man4.i386/fe.4
@@ -326,7 +326,8 @@ This manual page was written by
This document and the associated software may be used, modified,
copied, distributed, and sold, in both source and binary form provided
that the above copyright, these terms and the following disclaimer are
-retained. The name of the author and/or the contributor may not be
+retained.
+The name of the author and/or the contributor may not be
used to endorse or promote products derived from this document and the
associated software without specific prior written permission.
.Pp
@@ -335,7 +336,8 @@ AND THE CONTRIBUTOR
.Dq AS IS
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR THE
+PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR OR THE
CONTRIBUTOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
diff --git a/share/man/man4/man4.i386/io.4 b/share/man/man4/man4.i386/io.4
index b1110d9..a3cb912 100644
--- a/share/man/man4/man4.i386/io.4
+++ b/share/man/man4/man4.i386/io.4
@@ -44,7 +44,8 @@ Any process that holds a file descriptor on
open will get its
.Em IOPL
bits in the flag register set, thus allowing it to perform direct
-I/O operations. This can be useful in order to write userland
+I/O operations.
+This can be useful in order to write userland
programs that handle some hardware directly.
Note that even read-only access will grant the full I/O privileges.
.Pp
diff --git a/share/man/man4/man4.i386/mse.4 b/share/man/man4/man4.i386/mse.4
index a6dfa69..c3b07c8 100644
--- a/share/man/man4/man4.i386/mse.4
+++ b/share/man/man4/man4.i386/mse.4
@@ -45,7 +45,8 @@ is usually 0x23c.
Some cards may also be set to use the secondary port
address at 0x238.
The interface cards require a single IRQ, which may be
-2, 3, 4 or 5. Some cards may offer additional IRQs.
+2, 3, 4 or 5.
+Some cards may offer additional IRQs.
The port number and the IRQ number are configured by jumpers on the cards
or by software provided with the card.
.Pp
@@ -55,7 +56,8 @@ some interface cards.
It may be 15, 30, 60 or 120Hz.
.Pp
The difference between the two types of the mice is not in mouse devices
-(in fact they are exactly the same). But in the circuit on the interface
+(in fact they are exactly the same).
+But in the circuit on the interface
cards.
This means that the device from a bus mouse package can be
connected to the interface card from an InPort mouse package, or vice
diff --git a/share/man/man4/man4.i386/ndis.4 b/share/man/man4/man4.i386/ndis.4
index 76b9c21..18e55be 100644
--- a/share/man/man4/man4.i386/ndis.4
+++ b/share/man/man4/man4.i386/ndis.4
@@ -49,33 +49,41 @@ network drivers to be used with
The
.Nm
driver is provided in source code form and must be combined with
-the Windows(r) driver supplied with your network adapter. The
+the Windows(r) driver supplied with your network adapter.
+The
.Nm
driver uses the
.Xr ndisapi 9
kernel subsystem to relocate and link the Windows(r) binary so
-that it can be used in conjunction with native code. The
+that it can be used in conjunction with native code.
+The
.Xr ndisapi 9
subsystem provides an interface between the NDIS API and the
.Fx
-networking infrastructure. The Windows(r) driver is essentially
-fooled into thinking it's running on Windows(r). Note that this
+networking infrastructure.
+The Windows(r) driver is essentially
+fooled into thinking it's running on Windows(r).
+Note that this
means the
.Nm
driver is only useful on x86 machines.
.Pp
To build a functional driver, the user must have a copy of the
-driver distribution media for his or her card. From this distribution,
+driver distribution media for his or her card.
+From this distribution,
the user must extract two files: the .SYS file containing the driver
binary code, and its companion .INF file, which contains the
definitions for driver-specific registry keys and other installation
-data such as device identifiers. These two files can be converted
+data such as device identifiers.
+These two files can be converted
into a
.Pa ndis_driver_data.h
file using the
.Xr ndiscvt 8
-utility. This file contains a binary image of the driver plus
-registry key data. When the
+utility.
+This file contains a binary image of the driver plus
+registry key data.
+When the
.Nm
driver loads, it will create
.Xr sysctl 9
@@ -84,13 +92,17 @@ nodes for each registry key extracted from the .INF file.
The
.Nm
driver is designed to support mainly ethernet and wireless
-network devices with PCI and PCMCIA bus attachments. (Cardbus
-devices are also supported as a subset of PCI.) It there can
-support many different media types and speeds. One limitation
+network devices with PCI and PCMCIA bus attachments.
+(Cardbus
+devices are also supported as a subset of PCI.)
+It there can
+support many different media types and speeds.
+One limitation
however, is that there is no consistent way to learn if an
ethernet device is operating in full or half duplex mode.
The NDIS API allows for a generic means for determining link
-state and speed, but not the duplex setting. There may be
+state and speed, but not the duplex setting.
+There may be
driver-specific registry keys to control the media setting
which can be configured via the
.Xr sysctl 8
diff --git a/share/man/man4/man4.i386/perfmon.4 b/share/man/man4/man4.i386/perfmon.4
index 2791382..f39ed07 100644
--- a/share/man/man4/man4.i386/perfmon.4
+++ b/share/man/man4/man4.i386/perfmon.4
@@ -46,7 +46,8 @@ capabilities of the
.Tn Pentium
and
.Tn "Pentium Pro"
-CPUs. These processors implement two internal counters which can be
+CPUs.
+These processors implement two internal counters which can be
configured to measure a variety of events for either count or duration
(in CPU cycles), as well as a cycle counter which counts clock cycles.
The
@@ -67,7 +68,8 @@ and
processors.
.Pp
.Sy NOTA BENE :
-The set of available events differs from processor to processor. It
+The set of available events differs from processor to processor.
+It
is the responsibility of the programmer to ensure that the event
numbers used are the correct ones for the CPU type being measured.
.Pp
@@ -119,22 +121,27 @@ returns the current configuration of the specified counter.
.It Dv PMIOSTART
.It Dv PMIOSTOP
.Pq Li int
-starts (stops) the specified counter. Due to hardware deficiencies,
-counters must be started and stopped in numerical order. (That is to
+starts (stops) the specified counter.
+Due to hardware deficiencies,
+counters must be started and stopped in numerical order.
+(That is to
say, counter 0 can never be stopped without first stopping counter 1.)
The driver will
.Em not
enforce this restriction (since it may not be present in future CPUs).
.It Dv PMIORESET
.Pq Li int
-reset the specified counter to zero. The counter should be stopped
+reset the specified counter to zero.
+The counter should be stopped
with
.Dv PMIOSTOP
-before it is reset. All counters are automatically reset by
+before it is reset.
+All counters are automatically reset by
.Dv PMIOSETUP .
.It Dv PMIOREAD
.Pq Li "struct pmc_data"
-get the current value of the counter. The
+get the current value of the counter.
+The
.Li pmc_data
structure defines two fields:
.Pp
@@ -152,7 +159,8 @@ instruction on
processors to read the counters directly.
.It Dv PMIOTSTAMP
.Pq Li "struct pmc_tstamp"
-read the time stamp counter. The
+read the time stamp counter.
+The
.Li pmc_tstamp
structure defines two fields:
.Pp
@@ -166,7 +174,8 @@ the current value of the counter as a 64-bit integer
It is important to note that the counter rate, as provided in the
.Li pmct_rate
field, is often incorrect because of calibration difficulties and
-non-integral clock rates. This field should be considered more of a
+non-integral clock rates.
+This field should be considered more of a
hint or sanity-check than an actual representation of the rate of
clock ticks.
.El
diff --git a/share/man/man4/man4.i386/ray.4 b/share/man/man4/man4.i386/ray.4
index 8553d93..397dde4 100644
--- a/share/man/man4/man4.i386/ray.4
+++ b/share/man/man4/man4.i386/ray.4
@@ -253,7 +253,7 @@ Represents link corruption or non standard nodes in the network.
The received
.Tn IEEE
802.11
-data packet has a reserved (i.e. not allowed) subtype.
+data packet has a reserved (i.e., not allowed) subtype.
Represents link corruption or non standard nodes in the network.
.It "ray?: MGT TODS/FROMDS wrong fc1 0x??"
The received
@@ -272,7 +272,7 @@ Benign, but might represent buggy firmware.
The received
.Tn IEEE
802.11
-management packet has a reserved (i.e. not allowed)
+management packet has a reserved (i.e., not allowed)
subtype.
Represents link corruption or non standard nodes in the network.
.It "ray?: open system authentication request"
@@ -287,7 +287,7 @@ Self explanatory and for testing
.Tn "Aviator Pro"
interworking.
.It "ray?: reserved authentication subtype 0x??"
-An authentication request has been received for a reserved (i.e. not allowed)
+An authentication request has been received for a reserved (i.e., not allowed)
subtype.
Represents link corruption or non standard nodes in the network.
.It "ray?: CTL TODS/FROMDS wrong fc1 0x??"
@@ -307,7 +307,7 @@ Benign, but might represent buggy firmware.
The received
.Tn IEEE
802.11
-control packet has a reserved (i.e. not allowed)
+control packet has a reserved (i.e., not allowed)
subtype.
Represents link corruption or non standard nodes in the network.
.It "ray?: bad ccs index 0x??"
diff --git a/share/man/man4/man4.i386/scd.4 b/share/man/man4/man4.i386/scd.4
index ad8456d..bca2be9 100644
--- a/share/man/man4/man4.i386/scd.4
+++ b/share/man/man4/man4.i386/scd.4
@@ -43,7 +43,8 @@ In
The
.Nm
driver provides a data interface to the Sony CDU31 and CDU33A CD-ROM
-drives. The drive must be hooked to a Sony proprietary interface
+drives.
+The drive must be hooked to a Sony proprietary interface
card or a compatible clone.
.Sh FILES
.Bl -tag -width /dev/[r]scd0a -compact
diff --git a/share/man/man4/man4.i386/spkr.4 b/share/man/man4/man4.i386/spkr.4
index 199a131..e29ad6c 100644
--- a/share/man/man4/man4.i386/spkr.4
+++ b/share/man/man4/man4.i386/spkr.4
@@ -68,7 +68,8 @@ a zero duration.
.Pp
The play-string language is modeled on the PLAY statement conventions of
.Tn IBM
-Advanced BASIC 2.0. The
+Advanced BASIC 2.0.
+The
.Li MB ,
.Li MF ,
and
@@ -80,7 +81,8 @@ feature and the slur mark are new.
.Pp
There are 84 accessible notes numbered 1-84 in 7 octaves, each running from
C to B, numbered 0-6; the scale is equal-tempered A440 and octave 3 starts
-with middle C. By default, the play function emits half-second notes with the
+with middle C.
+By default, the play function emits half-second notes with the
last 1/16th second being `rest time'.
.Pp
Play strings are interpreted left to right as a series of play command groups;
@@ -89,12 +91,15 @@ Play command groups are as follows:
.Bl -tag -width CDEFGABxx
.It Li CDEFGAB
Letters A through G cause the corresponding note to be played in the
-current octave. A note letter may optionally be followed by an
+current octave.
+A note letter may optionally be followed by an
.Dq Em "accidental sign" ,
one of # + or -; the first two of these cause it to be sharped one
-half-tone, the last causes it to be flatted one half-tone. It may
+half-tone, the last causes it to be flatted one half-tone.
+It may
also be followed by a time value number and by sustain dots (see
-below). Time values are interpreted as for the L command below.
+below).
+Time values are interpreted as for the L command below.
.It Ns Li O Sy n
If
.Sy n
@@ -109,8 +114,10 @@ When octave-tracking is on, interpretation of a pair of letter notes
will change octaves if necessary in order to make the smallest
possible jump between notes.
Thus ``olbc'' will be played as
-``olb>c'', and ``olcb'' as ``olc<b''. Octave locking is disabled for
-one letter note following >, < and O[0123456]. (The octave-locking
+``olb>c'', and ``olcb'' as ``olc<b''.
+Octave locking is disabled for
+one letter note following >, < and O[0123456].
+(The octave-locking
feature is not supported in
.Tn IBM
BASIC.)
@@ -125,7 +132,8 @@ Play note
being 1 to 84 or 0 for a rest of current time value.
May be followed by sustain dots.
.It Ns Li L Sy n
-Sets the current time value for notes. The default is
+Sets the current time value for notes.
+The default is
.Li L4 ,
quarter or crotchet notes.
The lowest possible value is 1; values up
@@ -142,10 +150,12 @@ Pause (rest), with
interpreted as for
.Li L Sy n .
May be followed by
-sustain dots. May also be written
+sustain dots.
+May also be written
.Li ~ .
.It Ns Li T Sy n
-Sets the number of quarter notes per minute; default is 120. Musical
+Sets the number of quarter notes per minute; default is 120.
+Musical
names for common tempi are:
.Bd -literal -offset indent
Tempo Beats Per Minute
@@ -192,7 +202,8 @@ dotted twice, it is held 9/4, and three times would give 27/8.
.Pp
A note and its sustain dots may also be followed by a slur mark (underscore).
This causes the normal micro-rest after the note to be filled in, slurring it
-to the next one. (The slur feature is not supported in
+to the next one.
+(The slur feature is not supported in
.Tn IBM
BASIC.)
.Pp
@@ -206,9 +217,11 @@ There is no volume control.
.Pp
The action of two or more sustain dots does not reflect standard musical
notation, in which each dot adds half the value of the previous dot
-modifier, not half the value of the note as modified. Thus, a note dotted
+modifier, not half the value of the note as modified.
+Thus, a note dotted
once is held for 3/2 of its undotted value; dotted twice, it is held 7/4,
-and three times would give 15/8. The multiply-by-3/2 interpretation,
+and three times would give 15/8.
+The multiply-by-3/2 interpretation,
however, is specified in the
.Tn IBM
BASIC manual and has been retained for
diff --git a/share/man/man4/man4.i386/streams.4 b/share/man/man4/man4.i386/streams.4
index d872f93..84a572c 100644
--- a/share/man/man4/man4.i386/streams.4
+++ b/share/man/man4/man4.i386/streams.4
@@ -55,7 +55,7 @@ Hence, opening a stream device produces a result similar to what would be
obtained by calling
.Xr socket 2 .
.Pp
-Applications should never use this interface directly: STREAMS
+Applications should never use this interface directly: STREAMS
emulation is only provided as a service to support ABI requirements in
the SVR4 environment which
.Xr svr4 4
diff --git a/share/man/man4/man4.i386/vx.4 b/share/man/man4/man4.i386/vx.4
index ec43086..4943026 100644
--- a/share/man/man4/man4.i386/vx.4
+++ b/share/man/man4/man4.i386/vx.4
@@ -74,7 +74,8 @@ Use the UTP port.
.Bl -diag
.It "vx%d: not configured; kernel is built for only %d devices."
There are not enough devices in the kernel configuration file for the number
-of adapters present in the system. Add devices to the configuration file,
+of adapters present in the system.
+Add devices to the configuration file,
rebuild the kernel, and reboot.
.El
.Pp
@@ -82,7 +83,8 @@ All other diagnostics indicate either a hardware problem or a bug in the
driver.
.Sh CAVEATS
Some early-revision 3c590 cards are defective and suffer from many receive
-overruns, which cause lost packets. The author has attempted to implement
+overruns, which cause lost packets.
+The author has attempted to implement
a test for it based on the information supplied by 3Com, but the test resulted
mostly in spurious warnings.
.Pp
diff --git a/share/man/man4/man4.i386/wl.4 b/share/man/man4/man4.i386/wl.4
index 6dc31f4..b6b7860 100644
--- a/share/man/man4/man4.i386/wl.4
+++ b/share/man/man4/man4.i386/wl.4
@@ -41,28 +41,38 @@
The
.Nm
driver controls a radio lan card system made originally by
-NCR, then ATT, now Lucent. The system is spread-spectrum radio
-at around 915 MHz (or 2.4 GHz). With the supplied omni-directional antennae,
+NCR, then ATT, now Lucent.
+The system is spread-spectrum radio
+at around 915 MHz (or 2.4 GHz).
+With the supplied omni-directional antennae,
about 400 feet (indoors, more outdoors) can be covered in circumference.
-This card can talk to the companion (wlp0) pccard. Speeds vary
+This card can talk to the companion (wlp0) pccard.
+Speeds vary
from 1 megabit to theoretically 2 megabits (roughly T1 in speed).
.Pp
The card has three fundamental hardware
units, a so-called PSA or programmable storage area, a radio modem,
-and a ethernet lan controller. The latter component is the
+and a ethernet lan controller.
+The latter component is the
ancient (and not very honorable) Intel 82586 ethernet chip.
Fundamentally it appears to the operating system as an ethernet system,
-and speaks IEEE MAC addresses. The radio modem simply translates
+and speaks IEEE MAC addresses.
+The radio modem simply translates
ethernet packets to/from radio packets, that are either at 2.4 GHz
-or 915 MHz depending on the radio modem. It supports a collision
-avoidance scheme. The lan controller
+or 915 MHz depending on the radio modem.
+It supports a collision
+avoidance scheme.
+The lan controller
supports promiscuous mode, broadcast, and multicasting
(although there is a glitch
-in the latter). "It thinks it is ethernet".
+in the latter).
+"It thinks it is ethernet".
.Pp
How it is used
-depends on the kind of antennae deployed with it. Point to point
-applications are possible as are ethernet-like lan use. The vendor
+depends on the kind of antennae deployed with it.
+Point to point
+applications are possible as are ethernet-like lan use.
+The vendor
ships an omni-directional antennae that works in the
vicinity of 400 feet (indoors).
Point to point antennae can be purchased that will go miles.
@@ -72,7 +82,8 @@ Typically minimally an IRQ, port, and Network ID must be supplied.
Michael Smith's
.Xr wlconfig 8
utility can now be used to do this work from
-the UNIX side. The card is "not" plug and play.
+the UNIX side.
+The card is "not" plug and play.
The network id controls whether one set of cards can hear another.
If different, cards will read physical packets, but they will be discarded
by the radio modem.
@@ -85,13 +96,17 @@ variables are as follows:
.Bl -diag
.It "machdep.wl_xmit_delay <useconds>"
This variable will cause the driver to insert a delay on transmit.
-250 is the default. The delay should probably be a bit longer
-on faster cpus and less on slower cpus. It exists because the 82586
+250 is the default.
+The delay should probably be a bit longer
+on faster cpus and less on slower cpus.
+It exists because the 82586
was not designed to work with Pentium-speed cpu systems and if overdriven
will have copious xmit side errors.
.It machdep.wl_ignore_nwid <0 | 1>
-This switch defaults to 0; i.e., the nwid is not ignored. It can
-be set to 1 to cause the nwid to not be used. This may be useful
+This switch defaults to 0; i.e., the nwid is not ignored.
+It can
+be set to 1 to cause the nwid to not be used.
+This may be useful
when the device is in promiscuous mode as one can watch for all
packets and ignore nwid differences.
.It machdep.wl_xmit_watch <milliseconds>
@@ -99,33 +114,42 @@ This switch is not currently useful.
.It machdep.wl_gather_snr <milliseconds>
This switch is not currently useful.
.Pp
-There is also a signal strength cache in the driver. It may be interrogated
+There is also a signal strength cache in the driver.
+It may be interrogated
with
.Xr wlconfig 8 .
Incoming packets
are checked for certain hardware radio-modem values including signal
strength, silence, and quality, which range fro 0..63, 0..63, and 0..15
-respectively. Thus one can read out signal strenth values to see
-how close/far peer nodes are. The signal strength cache is indexed by
+respectively.
+Thus one can read out signal strenth values to see
+how close/far peer nodes are.
+The signal strength cache is indexed by
sender MAC address.
-There are two sysctls that change how it filters packets. Both are on
+There are two sysctls that change how it filters packets.
+Both are on
by default.
.It machdep.wl_wlcache_mcastonly <0 | 1>
By default this switch is on.
It forces the cache to filter out
-unicast packets. Only broadcast or multicast packets are accepted.
+unicast packets.
+Only broadcast or multicast packets are accepted.
.It machdep.wl_wlcache_iponly <0 | 1>
-By default this switch is on. It forces the driver to discard non-IP
-packets and also stores the IP src address. ARP packets are ignored,
+By default this switch is on.
+It forces the driver to discard non-IP
+packets and also stores the IP src address.
+ARP packets are ignored,
as are any other network protocol barring IPv4 packets.
.El
.Sh CAVEATS
-The 82586 has numerous defects. It may experience transmit-side
+The 82586 has numerous defects.
+It may experience transmit-side
errors when modern faster cpus send packets at it faster than it can handle.
The driver (and probably the chip) does not support an all multicast mode.
As a result, it can be used with applications like
.Xr mrouted 8 ,
-but it must go into promiscuous mode for that to work. The driver
+but it must go into promiscuous mode for that to work.
+The driver
is slow to change modes from "normal" to promiscuous mode, presumably
due to delays in the configuration code.
.Sh SEE ALSO
@@ -139,9 +163,11 @@ The
driver was written by
.An Anders Klemets
(thousands of years ago?) and
-appears to be based on an even older Intel 82586 driver. The 82586
+appears to be based on an even older Intel 82586 driver.
+The 82586
controller was one of the first (if not the first?) integrated lan
-controller on the block. That does not mean it was the best either.
+controller on the block.
+That does not mean it was the best either.
Anders ported and or created a driver for the ISA wavelan and PCCARD
wavelan system too (wlp).
.An Robert T. Morris, Jr.
@@ -150,12 +176,16 @@ ported the Mach drivers to BSDI.
ported them to
.Fx 2.1 .
.An Michael Smith
-ported the wl driver only to 2.2.2. Jim and Michael have been
-maintaining them. The current state of the driver is NOT ANYONE'S
-FAULT. Thanks to
+ported the wl driver only to 2.2.2.
+Jim and Michael have been
+maintaining them.
+The current state of the driver is NOT ANYONE'S
+FAULT.
+Thanks to
.An Bernie Doehner
and
.An Robert Buaas
for contributions.
.Sh AUTHORS
-Too numerous to mention. See above.
+Too numerous to mention.
+See above.
diff --git a/share/man/man4/matcd.4 b/share/man/man4/matcd.4
index 1cbab48..cd4d2c0 100644
--- a/share/man/man4/matcd.4
+++ b/share/man/man4/matcd.4
@@ -75,16 +75,19 @@ Packard Bell and many other brands.
The drives are compatible with the major the Compact Disc standards,
including CD-DA (Red Book - Digital Audio on pressed media), CD-WO (Orange
Book Part II - Write-Once media), CD-ROM (Yellow Book - Data Storage), and
-the Kodak Photo-CD system. The drives have some support related to
+the Kodak Photo-CD system.
+The drives have some support related to
CD-ROM XA and CD-I (Green Book) audio and data requirements.
.Pp
These drives connect to the PC ISA bus through a simple (but proprietary) host
-interface. The host interface has been manufactured as a stand-alone adapter
+interface.
+The host interface has been manufactured as a stand-alone adapter
card, or included on a sound card or other multi-function adapter card.
The
.Nm
driver supports up to four host interfaces with up to four drives on each
-interface. CD-DA (digital audio) activity may occur on all drives
+interface.
+CD-DA (digital audio) activity may occur on all drives
simultaneously.
.Pp
The drive hardware supports a "bus disconnect" system similar to that found
@@ -102,13 +105,15 @@ driver can be directly linked into the
kernel, or exist
as a loadable
.Fx
-kernel module. The kernel module can be loaded or unloaded at any time
+kernel module.
+The kernel module can be loaded or unloaded at any time
using the \fBkldload\fR(8)/\fBkldunload\fR(8) commands.
.Pp
For most configurations, the
.Nm
driver should be used as a loadable kernel module and need not be linked into
-the kernel. However, if you are attempting to do an install from a
+the kernel.
+However, if you are attempting to do an install from a
CD-ROM/CD-WO disc that is initiated from a non-FreeBSD operating system or
you have a BIOS boot capability for this type of Compact Disc drive, having
the driver already in the kernel can simplify the installation process.
@@ -116,27 +121,31 @@ the driver already in the kernel can simplify the installation process.
if you determine that you need to have the
.Nm
driver linked into the kernel, it is necessary to add an entry to the kernel
-configuration file and generate a new kernel. The
+configuration file and generate a new kernel.
+The
.Fx
kernel source tree comes
with the file \fI/usr/src/sys/i386/conf/GENERIC\fR.
You should make a copy of this file and give the copy the name of your system,
-such as "MYSYSTEM". You can then edit the new file to include devices you
+such as "MYSYSTEM".
+You can then edit the new file to include devices you
want the system to include in the basic kernel and delete the device entries
-for drivers that you don't want included. Eliminating drivers for hardware
+for drivers that you don't want included.
+Eliminating drivers for hardware
that you don't have can reduce the size of the finished kernel.
.Pp
To include the
.Nm
driver to the configuration file, you will need to add this entry:
.Bd -literal -offset indent
-device matcd
+device matcd
.Ed
.Pp
and after making any other adjustments, save the file.
.Pp
Then generate a new kernel by using the \fBconfig\fR(8) command and follow
-all of the instructions that are displayed. If the kernel completely
+all of the instructions that are displayed.
+If the kernel completely
builds, use the "make install" command and then reboot the system for that
new kernel to become operational.
.Sh DRIVER CONFIGURATION
@@ -145,7 +154,8 @@ Regardless of whether the
driver is linked into the kernel or is used as a loadable kernel module,
the number of host interfaces that the driver will expect (or search for)
is dictated by the number of entries present in the file
-\fI/boot/device\.hints\fR. For example, in order to support two host
+\fI/boot/device\.hints\fR.
+For example, in order to support two host
interfaces, you would include entries like:
.Bd -literal -offset indent
hint.matcd.0.at="isa"
@@ -183,7 +193,8 @@ using this mechanism has the potential to cause problems when your system has
other devices that are located at the I/O ports that the driver will
check for potential
.Nm
-host interfaces. The automatic search also significantly increases the
+host interfaces.
+The automatic search also significantly increases the
amount of time it takes to boot or to load the kernel module.
.Pp
If you are having problems with the
@@ -220,7 +231,8 @@ Matsushita CR-563-x
Most resellers leave these original markings on the drives since the label
also has the FCC, VDE, CSA and RU certification marks.
.Pp
-Both of these drive models have motorized trays. There is also a custom
+Both of these drive models have motorized trays.
+There is also a custom
version of these drives that does not have the volume control or headphone
jack (seen on some Tandy computers), but this drive also works with
.Nm .
@@ -238,12 +250,14 @@ as \fBata\fR(4).
.Pp
The TEAC CD-55 4X Compact Disc drive also uses the same Creative/Panasonic
electrical interface, but the TEAC drive is not command set compatible with
-the Matsushita CR-56x drives. The TEAC drive cannot be used with
+the Matsushita CR-56x drives.
+The TEAC drive cannot be used with
.Nm .
.Pp
The most common source of host interface adapters for the Panasonic drives
was found in products from Creative Labs, including SoundBlaster sound
-cards. There are numerous models of SoundBlaster sound cards, and most
+cards.
+There are numerous models of SoundBlaster sound cards, and most
of the newer cards provide the appropriate interface, sometimes labeled as
the "Creative/Panasonic" interface.
.Pp
@@ -260,7 +274,7 @@ Sound Blaster 16 - cost-reduced (CT1740)
.It Creative
OmniCD upgrade kit adapter card - stand-alone CD (CT1810)
.It Creative
-Sound Blaster 16 - 2-layer, cost-reduced (CT2230)
+Sound Blaster 16 - 2-layer, cost-reduced (CT2230)
.It Creative
Sound Blaster 16 (Vibra16) - 2-layer, single-chip (CT2260)
.It Creative
@@ -281,16 +295,20 @@ that produce sound cards with an identical Creative/Panasonic drive
interface released many versions of compatible adapters.
.Pp
In addition to Creative Labs adapters, adapters that are compatible with
-Media Vision, IBM and Lasermate adapters are also supported. However,
+Media Vision, IBM and Lasermate adapters are also supported.
+However,
these adapters use a wide range of I/O port addresses, so the driver
must be reconfigured to locate these adapters, at least initially.
.Pp
.Sh SUPPORTED OPERATIONS
The
.Nm
-driver supports block and character access. Partition "a" returns
-2048-byte User Data blocks from data CDs. Partition "c" returns the full
-2352-byte Frames from any type of CD, including audio CDs. (Partition
+driver supports block and character access.
+Partition "a" returns
+2048-byte User Data blocks from data CDs.
+Partition "c" returns the full
+2352-byte Frames from any type of CD, including audio CDs.
+(Partition
"c" cannot be "mounted" with cd9660 or other standard file system emulators.)
No other partitions are supported.
.Pp
@@ -305,7 +323,8 @@ remain locked until all of the devs on that drive are closed.
accepts numerous
.Fn ioctl
commands, including functions related to Compact Disc audio and
-drive tray control features. The commands are:
+drive tray control features.
+The commands are:
.Pp
.Bl -tag -width CDIOCREADSUBCHANNELXXX -compact -offset indent
.It DIOCGDINFO
@@ -325,7 +344,8 @@ plays audio starting at a particular time offset.
.It CDIOCPAUSE
pauses a playing disc.
.It CDIOCRESUME
-resumes playing a previously paused disc. Ignored if the drive is
+resumes playing a previously paused disc.
+Ignored if the drive is
already playing.
.It CDIOCSTOP
stops playing a disc.
@@ -337,7 +357,8 @@ closes the disc tray.
blocks further attempts to open the drive door until all devices close
or a CDIOCALLOW ioctl is issued.
.It CDIOCALLOW
-unlocks the drive door if it was locked. This ioctl is rejected if
+unlocks the drive door if it was locked.
+This ioctl is rejected if
any locking devices are open, so it must be issued via a non-locking
device.
.It CDIOCGETVOL
@@ -346,13 +367,15 @@ returns the current volume settings of the drive.
sets the volume settings of the drive.
.It CDIOCSETSTEREO
the left channel audio is sent to the left channel output and the
-right channel audio is sent to the right channel output. This is the
+right channel audio is sent to the right channel output.
+This is the
default state.
(Note that the drive does not have a documented "Mono" mode,
where L combined with R audio from the disc is sent to both the left and right
output channels.)
.It CDIOCSETMUTE
-the audio output is to be turned off. The drive continues to read
+the audio output is to be turned off.
+The drive continues to read
the audio on the disc and that audio is discarded until the audio routing is
turned back on.
.It CDIOCSETLEFT
@@ -366,9 +389,11 @@ The left channel audio signal is discarded.
the audio is to be routed as specified in the provided bit maps.
.It CDIOCSETPITCH
the playback speed of the audio is increased or decreased
-(for Karaoke "off-key" applications). Speed can be adjusted +/-13%.
+(for Karaoke "off-key" applications).
+Speed can be adjusted +/-13%.
.It CDIOCCAPABILITY
-report the capabilities of the drive and driver. Results are returned
+report the capabilities of the drive and driver.
+Results are returned
as shown in \fI/usr/include/sys/cdio.h\fR.
.El
.Pp
@@ -410,11 +435,13 @@ or DMA although the drives themselves are equipped to allow both to be used.
.Pp
If the disc tray is opened while one or more partitions are open, further
I/O to all partitions on the drive will be rejected until all partitions
-are closed. This prevents a disc change from going undetected by higher
+are closed.
+This prevents a disc change from going undetected by higher
levels of the operating system.
.Pp
There must be a drive on each host interface that is addressed as
-physical drive 0. (Jumpers on the back of the drive control this setting.)
+physical drive 0.
+(Jumpers on the back of the drive control this setting.)
If there is no physical drive 0, the
.Nm
driver will be unable to detect that host interface or any of the drives
@@ -427,7 +454,8 @@ drive 0.
.Pp
Drives on a second host interface are considered logical
drive numbers 4 through 7, drives 8 through 11 are on the third interface
-and 12 through 15 are on the fourth. The first drive on the second host
+and 12 through 15 are on the fourth.
+The first drive on the second host
interface is always logical drive 4 regardless of how many drives are
present on the first host interface.
.Pp
@@ -447,7 +475,8 @@ All rights reserved.
The
.Nm
driver originally appeared in
-.Fx 2.0.5 . The
+.Fx 2.0.5 .
+The
.Fx
5.1.x compatible implementation described here appeared in
.Fx
diff --git a/share/man/man4/mem.4 b/share/man/man4/mem.4
index 61540fe..dc3514d 100644
--- a/share/man/man4/mem.4
+++ b/share/man/man4/mem.4
@@ -148,7 +148,8 @@ or the maximum, whichever is less.
.Pp
The
.Dv MEMRANGE_SET
-ioctl is used to add, alter and remove memory range attributes. A range
+ioctl is used to add, alter and remove memory range attributes.
+A range
with the
.Dv MDF_FIXACTIVE
flag may not be removed; a range with the
@@ -166,7 +167,7 @@ to remove a range.
.It Bq Er EOPNOTSUPP
Memory range operations are not supported on this architecture.
.It Bq Er ENXIO
-No memory range descriptors are available (eg. firmware has not enabled
+No memory range descriptors are available (e.g.\& firmware has not enabled
any).
.It Bq Er EINVAL
The memory range supplied as an argument is invalid or overlaps another
@@ -175,7 +176,7 @@ range in a fashion not supported by this architecture.
An attempt to remove or update a range failed because the range is busy.
.It Bq Er ENOSPC
An attempt to create a new range failed due to a shortage of hardware
-resources (eg. descriptor slots).
+resources (e.g.\& descriptor slots).
.It Bq Er ENOENT
An attempt to remove a range failed because no range matches the descriptor
base/length supplied.
diff --git a/share/man/man4/meteor.4 b/share/man/man4/meteor.4
index 6e890ea..86f9102 100644
--- a/share/man/man4/meteor.4
+++ b/share/man/man4/meteor.4
@@ -505,8 +505,8 @@ u0 y0 v0 y1 u1 y2 v1 y3 ...)
rows * columns bytes of y
rows * column / 4 bytes of even u
rows * column / 4 bytes of even v
-rows * column / 4 bytes of odd u
-rows * column / 4 bytes of odd v)
+rows * column / 4 bytes of odd u
+rows * column / 4 bytes of odd v)
.El
.El
.Pp
diff --git a/share/man/man4/mly.4 b/share/man/man4/mly.4
index 2e0ed39..53348e9 100644
--- a/share/man/man4/mly.4
+++ b/share/man/man4/mly.4
@@ -74,7 +74,7 @@ The controller firmware has started initialisation.
Normally this process is performed by the controller BIOS,
but the driver may need
to do this in cases where the BIOS has failed, or is not compatible
-(e.g. on non-x86 systems).
+(e.g.\& on non-x86 systems).
.It "mly%d: drive spinup in progress"
.Pp
Drive startup is in progress; this may take several minutes.
diff --git a/share/man/man4/mouse.4 b/share/man/man4/mouse.4
index c42eed2..8a75fb8 100644
--- a/share/man/man4/mouse.4
+++ b/share/man/man4/mouse.4
@@ -98,11 +98,13 @@ The first half of vertical movement count in two's complement;
-128 through 127.
.It Byte 4
The second half of the horizontal movement count in two's complement;
--128 through 127. To obtain the full horizontal movement count, add
+-128 through 127.
+To obtain the full horizontal movement count, add
the byte 2 and 4.
.It Byte 5
The second half of the vertical movement count in two's complement;
--128 through 127. To obtain the full vertical movement count, add
+-128 through 127.
+To obtain the full vertical movement count, add
the byte 3 and 5.
.It Byte 6
The bit 7 is always zero.
@@ -234,7 +236,8 @@ constants.
The
.Dv rate
field is the status report rate (reports/sec) at which the device will send
-movement reports to the host computer. -1 if unknown or not applicable.
+movement reports to the host computer.
+-1 if unknown or not applicable.
.Pp
The
.Dv resolution
diff --git a/share/man/man4/mtio.4 b/share/man/man4/mtio.4
index 504e8cd..735da63 100644
--- a/share/man/man4/mtio.4
+++ b/share/man/man4/mtio.4
@@ -62,7 +62,8 @@ is usually prepended to
the name of the no-rewind devices.
.Pp
Tapes can be written with either fixed length records or variable length
-records. See
+records.
+See
.Xr sa 4
for more information.
Two end-of-file markers mark the end of a tape, and
diff --git a/share/man/man4/multicast.4 b/share/man/man4/multicast.4
index 914013a..1c69bec 100644
--- a/share/man/man4/multicast.4
+++ b/share/man/man4/multicast.4
@@ -661,7 +661,8 @@ If the bandwidth of a data flow satisfies some pre-defined filter,
the kernel delivers an upcall on the multicast routing socket
to the multicast routing process that has installed that filter.
.It
-The bandwidth-upcall filters are installed per (S,G). There can be
+The bandwidth-upcall filters are installed per (S,G).
+There can be
more than one filter per (S,G).
.It
Instead of supporting all possible comparison operations
@@ -903,15 +904,31 @@ after the previous upcall.
.\"
.Pp
.Sh AUTHORS
-The original multicast code was written by David Waitzman (BBN Labs),
+.An -nosplit
+The original multicast code was written by
+.An David Waitzman
+(BBN Labs),
and later modified by the following individuals:
-Steve Deering (Stanford), Mark J. Steiglitz (Stanford),
-Van Jacobson (LBL), Ajit Thyagarajan (PARC),
-Bill Fenner (PARC).
+.An Steve Deering
+(Stanford),
+.An Mark J. Steiglitz
+(Stanford),
+.An Van Jacobson
+(LBL),
+.An Ajit Thyagarajan
+(PARC),
+.An Bill Fenner
+(PARC).
The IPv6 multicast support was implemented by the KAME project
(http://www.kame.net), and was based on the IPv4 multicast code.
The advanced multicast API and the multicast bandwidth
-monitoring were implemented by Pavlin Radoslavov (ICSI)
-in collaboration with Chris Brown (NextHop).
-.Pp
-This manual page was written by Pavlin Radoslavov (ICSI).
+monitoring were implemented by
+.An Pavlin Radoslavov
+(ICSI)
+in collaboration with
+.An Chris Brown
+(NextHop).
+.Pp
+This manual page was written by
+.An Pavlin Radoslavov
+(ICSI).
diff --git a/share/man/man4/natmip.4 b/share/man/man4/natmip.4
index 2ef1b2c..82b2e74 100644
--- a/share/man/man4/natmip.4
+++ b/share/man/man4/natmip.4
@@ -10,7 +10,8 @@
.Cd "device atm"
.Cd "options NATM"
.Sh DESCRIPTION
-The NATM protocol stack includes support for IP over ATM. Without any
+The NATM protocol stack includes support for IP over ATM.
+Without any
additional signalling stacks or other modules it is possible to build
a CLIP (classical IP over ATM) network based on PVCs.
.Pp
@@ -27,12 +28,14 @@ destination and the ATM characteristics of this channel.
The address part of the link layer address (see
.Xr link_addr 3 )
consists of a fixed part (the first 5 bytes) and a part that
-depends on the kind of the PVC (UBR, CBR, VBR, ABR). Multi-byte values
+depends on the kind of the PVC (UBR, CBR, VBR, ABR).
+Multi-byte values
are big-endian encoded: the bytes with the lower numbers contain the
higher order bits.
.Bl -tag -width "bytes 12...12" -offset indent
.It byte 0
-Is a flag byte. Currently only flag 0x20 is used.
+Is a flag byte.
+Currently only flag 0x20 is used.
When set, all IP frames are LLC/SNAP encapsulated before putting them into
an AAL5 frame.
Setting this flag is recommended and allows interoperability with other
@@ -41,9 +44,11 @@ Note that BPF works only with LLC/SNAP encapsulation.
.It byte 1
This is the VPI of the channel.
.It bytes 2...3
-VCI of the channel. Must not be zero.
+VCI of the channel.
+Must not be zero.
.It byte 4
-Traffic type. One of 0 (UBR), 1 (CBR), 2 (ABR), 3 (VBR).
+Traffic type.
+One of 0 (UBR), 1 (CBR), 2 (ABR), 3 (VBR).
.El
.Pp
The variable part for UBR connections may be either empty or three bytes:
@@ -111,7 +116,8 @@ can be reached and
.Ar <lladdr>
is the link layer address as a string of dot-separated, hexadecimal bytes.
.Pp
-NATM also supports the old, original format. This consists of 4 byte
+NATM also supports the old, original format.
+This consists of 4 byte
link layer addresses (and the channels are implicit UBR):
.Bl -tag -width "bytes 12...12" -offset indent
.It byte 0
diff --git a/share/man/man4/ng_UI.4 b/share/man/man4/ng_UI.4
index 8fbf93f..0f48d4b 100644
--- a/share/man/man4/ng_UI.4
+++ b/share/man/man4/ng_UI.4
@@ -53,7 +53,8 @@ and
Packets received on
.Dv downstream
must have 0x03 (indicating unnumbered information) as their first byte;
-if not the packet is dropped. This byte is then stripped and the
+if not the packet is dropped.
+This byte is then stripped and the
remainder of the packet sent out on
.Dv upstream .
.Pp
@@ -67,10 +68,12 @@ This node type supports the following hooks:
.Pp
.Bl -tag -width foobar
.It Dv downstream
-Downstream connection. Packets on this side of the node have a 0x03 as
+Downstream connection.
+Packets on this side of the node have a 0x03 as
their first byte.
.It Dv upstream
-Upstream connection. Packets on this side of the node have the
+Upstream connection.
+Packets on this side of the node have the
initial 0x03 byte stripped off.
.El
.Sh CONTROL MESSAGES
diff --git a/share/man/man4/ng_async.4 b/share/man/man4/ng_async.4
index 22c67b9..01d3c6d 100644
--- a/share/man/man4/ng_async.4
+++ b/share/man/man4/ng_async.4
@@ -54,7 +54,8 @@ asynchronous serial line.
.Pp
The node transmits and receives asynchronous data on the
.Dv async
-hook. Mbuf boundaries of incoming data are ignored.
+hook.
+Mbuf boundaries of incoming data are ignored.
Once a complete packet has been received, it is decoded and
stripped of all framing bytes, and transmitted out the
.Dv sync
@@ -68,7 +69,8 @@ and sent out on
.Dv async .
Received packets should start with the address and control fields,
or the PPP protocol field if address and control field compression
-is employed, and contain no checksum field. If the first four bytes are
+is employed, and contain no checksum field.
+If the first four bytes are
.Dv "0xff 0x03 0xc0 0x21"
(an LCP protocol frame) then complete control character escaping
is enabled for that frame (in PPP, LCP packets are always sent with
@@ -93,7 +95,8 @@ Typically this hook would be connected to a
.Xr ng_tty 4
node, which handles transmission of serial data over a tty device.
.It Dv sync
-Synchronous connection. This hook sends and receives synchronous frames.
+Synchronous connection.
+This hook sends and receives synchronous frames.
For PPP, these frames should contain address, control, and protocol fields,
but no checksum field.
Typically this hook would be connected to an individual link hook of a
@@ -132,7 +135,8 @@ The
and
.Dv smru
fields are the asynchronous and synchronous MRU (maximum receive unit) values,
-respectively. These both default to 1600; note that the async MRU
+respectively.
+These both default to 1600; note that the async MRU
applies to the incoming frame length after asynchronous decoding.
The
.Dv accm
diff --git a/share/man/man4/ng_atm.4 b/share/man/man4/ng_atm.4
index 8b7668f..8dbb90e 100644
--- a/share/man/man4/ng_atm.4
+++ b/share/man/man4/ng_atm.4
@@ -44,28 +44,33 @@ The
.Nm
netgraph node type allows
.Xr natm 4
-ATM drivers to be connected to the
+ATM drivers to be connected to the
.Xr netgraph 4
networking subsystem.
When the
.Nm
module is loaded a node is automatically create for each
.Xr natm 4
-ATM interface. The nodes are named with the same name as the
-interface. Nodes are also created, if a driver for an ATM
+ATM interface.
+The nodes are named with the same name as the
+interface.
+Nodes are also created, if a driver for an ATM
card is loaded after
.Nm
was loaded.
.Pp
.Nm
-nodes are persistent. They are removed when the interface is removed.
+nodes are persistent.
+They are removed when the interface is removed.
SHUTDOWN messages are ignored by the node.
.Sh HOOKS
Four special hooks with fixed names and an unlimited number of hooks with user
-defined names are supported. Three of the fixed hooks are attached to
+defined names are supported.
+Three of the fixed hooks are attached to
strategic points in the information flow in the
.Xr natm 4
-system and support only reading. The fourth fixed hook behaves like the other
+system and support only reading.
+The fourth fixed hook behaves like the other
user hooks, but a number of management messages are sent along the hook.
The other hooks can be attached to VCIs dynamically by means of
control messages to the
@@ -77,7 +82,9 @@ The four fixed hooks are:
.It Dv input
This is a connection to the raw input stream from the network.
If this hook is connected, all incoming packets are delivered out to
-this hook. Note, that this redirects ALL input. Neither
+this hook.
+Note, that this redirects ALL input.
+Neither
.Xr natm 4
nor the user hooks will see any input if
.Dv input
@@ -98,7 +105,7 @@ An
.Xr natm 4 )
is prepended to the actual data.
.It Dv orphans
-This hook receives all packets that are unrecognized, i.e. do not belong to
+This hook receives all packets that are unrecognized, i.e., do not belong to
either a
.Xr natm 4
socket, a
@@ -107,7 +114,8 @@ VCI or
.Xr natm 4
IP.
Because ATM is connection oriented and packets are received on a given VCI only
-when someone initiates this VCI, packets should never be orphaned. There is
+when someone initiates this VCI, packets should never be orphaned.
+There is
however one exception: if you use
.Xr natm 4
IP with LLC/SNAP encapsulation packets with don't have the IP protocol
@@ -123,16 +131,17 @@ the node at the other hand will receive management messages.
.El
.Pp
Hooks for dynamically initiated VCIs can have whatever name is allowed by
-.Xr netgraph 4
+.Xr netgraph 4
as long as the name does not collide with one of the three predefined names.
.Pp
To initiate packet sending an receiving on a dynamic hook one has to issue
a
.Dv NGM_ATM_CPCS_INIT
-control message. To terminate sending and receiving one must send a
+control message.
+To terminate sending and receiving one must send a
.Dv NGM_ATM_CPCS_TERM
message (see
-.Sx CONTROL MESSAGES ) .
+.Sx CONTROL MESSAGES ) .
The data send and received on these hooks has no additional
headers.
.Sh CONTROL MESSAGES
@@ -153,7 +162,8 @@ struct ng_atm_config {
};
.Ed
.It Dv NGM_ATM_GET_VCCS
-Returns the table of open VCCs from the driver. This table consists of
+Returns the table of open VCCs from the driver.
+This table consists of
a header and a variable sized array of entries, one for each open vcc:
.Bd -literal
struct atmio_vcctable {
@@ -188,8 +198,10 @@ struct atmio_tparam {
.Pp
Note, that this is the driver's table, so all VCCs opened via
.Xr natm 4
-sockets and IP are also shown. They can, however, be distinguished by
-their flags. The
+sockets and IP are also shown.
+They can, however, be distinguished by
+their flags.
+The
.Dv flags
field contains the following flags:
.Bl -column ATM_PH_LLCSNAP -offset indent
@@ -229,7 +241,8 @@ all traffic types however):
.It Dv ATMIO_TRAFFIC_VBR
.El
.It Dv NGM_ATM_CPCS_INIT
-Initialize a VCC for sending and receiving. The argument is a structure:
+Initialize a VCC for sending and receiving.
+The argument is a structure:
.Bd -literal
struct ng_atm_cpcs_init {
char name[NG_HOOKSIZ];
@@ -261,8 +274,9 @@ This hook must already be connected.
.Dv vpi
and
.Dv vci
-are the respective VPI and VCI values to use for the ATM cells. They must be
-within the range, given by the
+are the respective VPI and VCI values to use for the ATM cells.
+They must be
+within the range, given by the
.Dv maxvpi
and
.Dv maxvci
@@ -273,7 +287,8 @@ structure.
contains the flags (see above) and the other fields describe the
type of traffic.
.It Dv NGM_ATM_CPCS_TERM
-Stop sending and receiving on the indicated hook. The argument is a
+Stop sending and receiving on the indicated hook.
+The argument is a
.Bd -literal
struct ng_atm_cpcs_term {
char name[NG_HOOKSIZ];
@@ -283,7 +298,8 @@ struct ng_atm_cpcs_term {
.Sh MANAGEMENT MESSAGES
If the
.Dv manage
-hook is connected certain messages are sent along the hook. They are
+hook is connected certain messages are sent along the hook.
+They are
received by the peer node with a cookie of
.Dv NG_ATM_COOKIE .
.Bl -tag -width xxx
@@ -298,15 +314,18 @@ struct ng_atm_carrier_change {
.Ed
.Pp
.Dv node
-is the node Id of the ATM node. This can be used by the managing entity
+is the node Id of the ATM node.
+This can be used by the managing entity
(for example
.Xr ilmid 8 )
to manage several interfaces at the same time through the same node.
.Dv state is 1 if the carrier was detected and 0 if it was lost.
.It Dv NGM_ATM_VCC_CHANGE
-A permanent VCC has been added, deleted or changed. This is used by
+A permanent VCC has been added, deleted or changed.
+This is used by
.Xr ilmid
-to generate the appropriate ILMI traps. The structure of the message is:
+to generate the appropriate ILMI traps.
+The structure of the message is:
.Bd -literal
struct ng_atm_vcc_change {
uint32_t node;
@@ -321,22 +340,27 @@ is 0 if the PVC was deleted and 1 if it was added or modified.
.El
.Sh FLOW CONTROL
If the hardware driver supports it the node can emit flow control messages
-along a user hook. The format of these messages is described in
+along a user hook.
+The format of these messages is described in
.Pa netgraph/ng_message.h .
The
.Nm
node may generate
.Dv NGM_HIGH_WATER_PASSED and NGM_LOW_WATER_PASSED
-messages. The first one indicates that the hardware driver has stopped output
+messages.
+The first one indicates that the hardware driver has stopped output
on the channel and drops new packets, the second one reports that
-output was reenabled. Currently the structures are not filled with
+output was reenabled.
+Currently the structures are not filled with
information.
.Sh SHUTDOWN
The nodes are persistent as long as the corresponding interface exists.
Upon receipt of a
.Dv NGM_SHUTDOWN
-messages all hooks are disconnected and the node is reinitialized. All
-VCCs opened via netgraph are closed. When the ATM interface is unloaded
+messages all hooks are disconnected and the node is reinitialized.
+All
+VCCs opened via netgraph are closed.
+When the ATM interface is unloaded
the node disappears.
If the node is compiled with
.Dv NGATM_DEBUG
diff --git a/share/man/man4/ng_atmllc.4 b/share/man/man4/ng_atmllc.4
index 4f7513e..8dc67d5 100644
--- a/share/man/man4/ng_atmllc.4
+++ b/share/man/man4/ng_atmllc.4
@@ -44,11 +44,13 @@ This node currently handles the Ethernet and FDDI protocols.
.Pp
The node transmits and receives ATM PDUs on the
.Dv atm
-hook. Received PDUs are decoded and forwarded to the
+hook.
+Received PDUs are decoded and forwarded to the
.Dv ether
or
.Dv fddi
-hooks as appropriate. Data received on the
+hooks as appropriate.
+Data received on the
.Dv ether
or
.Dv fddi
@@ -66,12 +68,14 @@ Typically this hook would be connected to a
.Xr ng_atm 4
node, which handles transmission of ATM PDUs over an ATM device.
.It Dv ether
-Ethernet connection. This hook sends and receives ethernet frames.
+Ethernet connection.
+This hook sends and receives ethernet frames.
This would normally be connected to an
.Xr ng_eiface 4
node if in use.
.It Dv fddi
-FDDI connection. This hook sends and receives FDDI frames.
+FDDI connection.
+This hook sends and receives FDDI frames.
.El
.Sh CONTROL MESSAGES
This node type supports the generic control messages.
diff --git a/share/man/man4/ng_atmpif.4 b/share/man/man4/ng_atmpif.4
index f76aea3..4e7cf42 100644
--- a/share/man/man4/ng_atmpif.4
+++ b/share/man/man4/ng_atmpif.4
@@ -51,7 +51,8 @@ netgraph node type allows the emulation of
networking subsystem.
Moreover it includes protection of the PDU against duplication and
desequencement.
-It supports up to 65535 VCs and up to 255 VPs. AAL0, AAL3/4 and AAL5
+It supports up to 65535 VCs and up to 255 VPs.
+AAL0, AAL3/4 and AAL5
emulation are provided.
In order to optimize CPU, this node does not emulate the SAR layer.
.Pp
@@ -66,8 +67,10 @@ It is named hvaX.
It has the same features as any other HARP devices.
The PIF is removed when the node is removed.
.Sh HOOKS
-There is only one hook: link. This hook can be connected to any other
-Netgraph node. For example, in order
+There is only one hook: link.
+This hook can be connected to any other
+Netgraph node.
+For example, in order
to test the HARP stack over UDP, it can be connected on a
.Xr ksocket 4
node.
diff --git a/share/man/man4/ng_bluetooth.4 b/share/man/man4/ng_bluetooth.4
index a9afcfd..2214172 100644
--- a/share/man/man4/ng_bluetooth.4
+++ b/share/man/man4/ng_bluetooth.4
@@ -49,7 +49,7 @@ A read-only integer variable that shows the current version of the
Bluetooth stack.
.It Va net.bluetooth.hci.command_timeout
A read-write integer variable that controls the Host Controller Interface
-(HCI) command timeout (in seconds), i.e. how long the HCI layer will wait
+(HCI) command timeout (in seconds), i.e., how long the HCI layer will wait
for the
.Dv Command_Complete
or
diff --git a/share/man/man4/ng_bpf.4 b/share/man/man4/ng_bpf.4
index 1c24b07..c63c89c 100644
--- a/share/man/man4/ng_bpf.4
+++ b/share/man/man4/ng_bpf.4
@@ -51,7 +51,8 @@ node type allows Berkeley Packet Filter (see
.Xr bpf 4 )
filters to be applied to data travelling through a Netgraph network.
Each node allows an arbitrary number of connections to arbitrarily
-named hooks. With each hook is associated a
+named hooks.
+With each hook is associated a
.Xr bpf 4
filter program which is applied to incoming data only, a destination hook
for matching packets, a destination hook for non-matching packets,
@@ -60,7 +61,8 @@ and various statistics counters.
A
.Xr bpf 4
program returns an unsigned integer, which is normally interpreted as
-the length of the prefix of the packet to return. In the context of this
+the length of the prefix of the packet to return.
+In the context of this
node type, returning zero is considered a non-match, in which case the
entire packet is delivered out the non-match destination hook.
Returning a value greater than zero causes the packet to be truncated
@@ -79,7 +81,8 @@ This node type supports the generic control messages, plus the following:
.Bl -tag -width foo
.It Dv NGM_BPF_SET_PROGRAM
This command sets the filter program that will be applied to incoming
-data on a hook. The following structure must be supplied as an argument:
+data on a hook.
+The following structure must be supplied as an argument:
.Bd -literal -offset 4n
struct ng_bpf_hookprog {
char thisHook[NG_HOOKSIZ]; /* name of hook */
@@ -101,7 +104,8 @@ Matching and non-matching incoming packets are delivered out the hooks named
.Dv ifMatch
and
.Dv ifNotMatch ,
-respectively. The program must be a valid
+respectively.
+The program must be a valid
.Xr bpf 4
program or else
.Er EINVAL
diff --git a/share/man/man4/ng_btsocket.4 b/share/man/man4/ng_btsocket.4
index d3dfd56..c84d712 100644
--- a/share/man/man4/ng_btsocket.4
+++ b/share/man/man4/ng_btsocket.4
@@ -98,7 +98,7 @@ Remove all neighbor cache entries for the HCI node.
.It Dv SIOC_HCI_RAW_NODE_GET_NEIGHBOR_CACHE
Returns content of the neighbor cache for the HCI node.
.It Dv SIOC_HCI_RAW_NODE_GET_CON_LIST
-Returns list of active baseband connections (i.e. ACL and SCO links) for
+Returns list of active baseband connections (i.e., ACL and SCO links) for
the HCI node.
.It SIOC_HCI_RAW_NODE_GET_LINK_POLICY_MASK
Returns current link policy settings mask for the HCI node.
@@ -182,7 +182,7 @@ Returns current debug level for the L2CAP node.
.It Dv SIOC_L2CAP_NODE_SET_DEBUG
Sets current debug level for the L2CAP node.
.It Dv SIOC_L2CAP_NODE_GET_CON_LIST
-Returns list of active baseband connections (i.e. ACL links) for the L2CAP
+Returns list of active baseband connections (i.e., ACL links) for the L2CAP
node.
.It Dv SIOC_L2CAP_NODE_GET_CHAN_LIST
Returns list of active channels for the L2CAP node.
diff --git a/share/man/man4/ng_cisco.4 b/share/man/man4/ng_cisco.4
index 3a9d616..491437e 100644
--- a/share/man/man4/ng_cisco.4
+++ b/share/man/man4/ng_cisco.4
@@ -48,10 +48,13 @@
The
.Nm cisco
node type performs encapsulation and de-encapsulation of packets
-using the Cisco HDLC protocol. This is a fairly simple
+using the Cisco HDLC protocol.
+This is a fairly simple
protocol for the transmission of packets across
-high speed synchronous lines. Each packet is prepended with
-an Ethertype, indicating the protocol. There is also a
+high speed synchronous lines.
+Each packet is prepended with
+an Ethertype, indicating the protocol.
+There is also a
.Dq keep alive
and an
.Dq inquire
@@ -59,7 +62,8 @@ capability.
.Pp
The
.Dv downstream
-hook should connect to the synchronous line. On the other side
+hook should connect to the synchronous line.
+On the other side
of the node are the
.Dv inet ,
.Dv inet6 ,
@@ -67,13 +71,15 @@ of the node are the
and
.Dv ipx
hooks, which transmit and receive raw IP, IPv6, AppleTalk, and IPX packets,
-respectively. Typically these hooks would connect to the corresponding
+respectively.
+Typically these hooks would connect to the corresponding
hooks on an
.Xr ng_iface 4
type node.
.Sh IP Configuration
In order to function properly for IP traffic, the node must be informed
-of the local IP address and netmask setting. This is because the protocol
+of the local IP address and netmask setting.
+This is because the protocol
includes an
.Dq inquire
packet which we must be prepared to answer.
@@ -84,10 +90,12 @@ Whenever such an inquire packet is received, the node sends a
control message to the peer node connected to the
.Dv inet
hook (if any).
-If the peer responds, then that response is used. This is the automatic method.
+If the peer responds, then that response is used.
+This is the automatic method.
.Pp
If the peer does not respond, the node falls back on its cached value
-for the IP address and netmask. This cached value can be set at any time
+for the IP address and netmask.
+This cached value can be set at any time
with a
.Dv NGM_CISCO_SET_IPADDR
message, and this is the manual method.
@@ -124,7 +132,8 @@ This node type supports the generic control messages, plus the following:
.It Dv NGM_CISCO_SET_IPADDR
This command takes an array of two
.Dv "struct in_addr"
-arguments. The first is the IP address of the corresponding interface
+arguments.
+The first is the IP address of the corresponding interface
and the second is the netmask.
.It Dv NGM_CISCO_GET_IPADDR
This command returns the IP configuration in the same format used by
@@ -149,7 +158,8 @@ This node shuts down upon receipt of a
.Dv NGM_SHUTDOWN
control message, or when all hooks have been disconnected.
.Sh BUGS
-Not all of the functionality has been implemented. For example,
+Not all of the functionality has been implemented.
+For example,
the node does not support querying the remote end for its IP address
and netmask.
.Sh SEE ALSO
diff --git a/share/man/man4/ng_frame_relay.4 b/share/man/man4/ng_frame_relay.4
index 1acef8b..83a6489 100644
--- a/share/man/man4/ng_frame_relay.4
+++ b/share/man/man4/ng_frame_relay.4
@@ -47,7 +47,8 @@
The
.Nm frame_relay
node type performs encapsulation, de-encapsulation, and multiplexing
-of packets using the frame relay protocol. It supports up to 1024 DLCI's.
+of packets using the frame relay protocol.
+It supports up to 1024 DLCI's.
The LMI protocol is handled by a separate node type (see
.Xr ng_lmi 4 ) .
.Pp
@@ -67,7 +68,8 @@ This node type supports the following hooks:
.It Dv downstream
The connection to the synchronous line.
.It Dv dlciX
-Here X is a decimal number from 0 to 1023. This hook corresponds
+Here X is a decimal number from 0 to 1023.
+This hook corresponds
to the DLCI X frame relay virtual channel.
.El
.Sh CONTROL MESSAGES
diff --git a/share/man/man4/ng_hci.4 b/share/man/man4/ng_hci.4
index be6fc06..97548a4 100644
--- a/share/man/man4/ng_hci.4
+++ b/share/man/man4/ng_hci.4
@@ -117,7 +117,7 @@ provides a uniform method of accessing the Bluetooth baseband capabilities.
.Pp
The HCI layer on the Host exchanges data and commands with the HCI firmware
on the Bluetooth hardware.
-The Host Controller Transport Layer (i.e. physical
+The Host Controller Transport Layer (i.e., physical
bus) driver provides both HCI layers with the ability to exchange information
with each other.
.Pp
@@ -223,7 +223,7 @@ typedef struct {
} ng_hci_node_up_ep;
.Ed
.Sh HCI FLOW CONTROL
-HCI layer performs flow control on baseband connection basis (i.e. ACL and
+HCI layer performs flow control on baseband connection basis (i.e., ACL and
SCO link).
Each baseband connection has
.Dq "connection handle"
@@ -334,7 +334,7 @@ Returns content of the neighbor cache.
.It Dv NGM_HCI_NODE_FLUSH_NEIGHBOR_CACHE
Remove all neighbor cache entries.
.It Dv NGM_HCI_NODE_GET_CON_LIST
-Returns list of active baseband connections (i.e. ACL and SCO links).
+Returns list of active baseband connections (i.e., ACL and SCO links).
.It Dv NGM_HCI_NODE_GET_STAT
Returns various statistic counters.
.It Dv NGM_HCI_NODE_RESET_STAT
diff --git a/share/man/man4/ng_iface.4 b/share/man/man4/ng_iface.4
index 046e97d..abc5243 100644
--- a/share/man/man4/ng_iface.4
+++ b/share/man/man4/ng_iface.4
@@ -46,7 +46,8 @@
.Sh DESCRIPTION
An
.Nm iface
-node is both a netgraph node and a system networking interface. When an
+node is both a netgraph node and a system networking interface.
+When an
.Nm iface
node is created, a new interface appears which is accessible via
.Xr ifconfig 8 .
@@ -126,7 +127,8 @@ for a description.
.Sh SHUTDOWN
This node shuts down upon receipt of a
.Dv NGM_SHUTDOWN
-control message. The associated interface is removed and becomes available
+control message.
+The associated interface is removed and becomes available
for use by future
.Nm iface
nodes.
diff --git a/share/man/man4/ng_ksocket.4 b/share/man/man4/ng_ksocket.4
index 373a25e..11d9e4e 100644
--- a/share/man/man4/ng_ksocket.4
+++ b/share/man/man4/ng_ksocket.4
@@ -84,7 +84,8 @@ and
are the decimal equivalent of the same arguments to
.Xr socket 2 .
Alternately, aliases for the commonly used values are accepted as
-well. For example
+well.
+For example
.Dv inet/dgram/udp
is a more readable but equivalent version of
.Dv 2/2/17 .
@@ -95,7 +96,7 @@ connected (an
.Dv NGM_KSOCKET_CONNECT
was sent to node before).
If socket is not connected, destination
-.Dv "struct sockaddr"
+.Vt "struct sockaddr"
must be supplied in an mbuf tag with cookie
.Dv NGM_KSOCKET_COOKIE
and type
@@ -104,7 +105,7 @@ attached to data.
Otherwise
.Nm
will return
-.Dv ENOTCONN
+.Er ENOTCONN
to sender.
.Sh CONTROL MESSAGES
This node type supports the generic control messages, plus the following:
@@ -114,7 +115,7 @@ This functions exactly like the
.Xr bind 2
system call.
The
-.Dv "struct sockaddr"
+.Vt "struct sockaddr"
socket address parameter should be supplied as an argument.
.It Dv NGM_KSOCKET_LISTEN
This functions exactly like the
@@ -128,7 +129,7 @@ This functions exactly like the
.Xr connect 2
system call.
The
-.Dv "struct sockaddr"
+.Vt "struct sockaddr"
destination address parameter should be supplied as an argument.
.It Dv NGM_KSOCKET_ACCEPT
Currently unimplemented.
@@ -137,25 +138,25 @@ Equivalent to the
.Xr getsockname 2
system call.
The name is returned as a
-.Dv "struct sockaddr"
+.Vt "struct sockaddr"
in the arguments field of the reply.
.It Dv NGM_KSOCKET_GETPEERNAME
Equivalent to the
.Xr getpeername 2
system call.
The name is returned as a
-.Dv "struct sockaddr"
+.Vt "struct sockaddr"
in the arguments field of the reply.
.It Dv NGM_KSOCKET_SETOPT
Equivalent to the
.Xr setsockopt 2
system call, except that the option name, level, and value are passed in a
-.Dv "struct ng_ksocket_sockopt" .
+.Vt "struct ng_ksocket_sockopt" .
.It Dv NGM_KSOCKET_GETOPT
Equivalent to the
.Xr getsockopt 2
system call, except that the option is passed in a
-.Dv "struct ng_ksocket_sockopt" .
+.Vt "struct ng_ksocket_sockopt" .
When sending this command, the
.Dv value
field should be empty; upon return, it will contain the
@@ -163,7 +164,7 @@ retrieved value.
.El
.Sh ASCII FORM CONTROL MESSAGES
For control messages that pass a
-.Dv "struct sockaddr"
+.Vt "struct sockaddr"
in the argument field, the normal
.Tn ASCII
equivalent of the C structure
@@ -193,7 +194,7 @@ inet/192.168.1.1:1234
.El
.Pp
For control messages that pass a
-.Dv "struct ng_ksocket_sockopt" ,
+.Vt "struct ng_ksocket_sockopt" ,
the normal
.Tn ASCII
form for that structure is used.
diff --git a/share/man/man4/ng_l2cap.4 b/share/man/man4/ng_l2cap.4
index 7cea8ea..b2abe51 100644
--- a/share/man/man4/ng_l2cap.4
+++ b/share/man/man4/ng_l2cap.4
@@ -390,7 +390,7 @@ Returns an integer containing the current debug level for the node.
This command takes an integer argument and sets current debug level
for the node.
.It Dv NGM_L2CAP_NODE_GET_CON_LIST
-Returns list of active baseband connections (i.e. ACL links).
+Returns list of active baseband connections (i.e., ACL links).
.It Dv NGM_L2CAP_NODE_GET_CHAN_LIST
Returns list of active L2CAP channels.
.It Dv NGM_L2CAP_NODE_GET_AUTO_DISCON_TIMO
diff --git a/share/man/man4/ng_lmi.4 b/share/man/man4/ng_lmi.4
index 0125dee..15d1617 100644
--- a/share/man/man4/ng_lmi.4
+++ b/share/man/man4/ng_lmi.4
@@ -46,7 +46,8 @@
.Sh DESCRIPTION
The
.Nm lmi
-node type performs the frame relay LMI protocol. It supports
+node type performs the frame relay LMI protocol.
+It supports
the ITU Annex A, ANSI Annex D, and Group-of-four LMI types.
It also supports auto-detection of the LMI type.
.Pp
@@ -65,7 +66,8 @@ To enable LMI type auto-detection, connect the
.Dv auto0
hook to DLCI 0 and the
.Dv auto1023
-hook to DLCI 1023. The node will attempt to automatically determine
+hook to DLCI 1023.
+The node will attempt to automatically determine
which LMI type is running at the switch, and go into that mode.
.Pp
Only one fixed LMI type, or auto-detection, can be active at any given time.
@@ -73,7 +75,8 @@ Only one fixed LMI type, or auto-detection, can be active at any given time.
The
.Dv NGM_LMI_GET_STATUS
control message can be used at any time to query the current status
-of the LMI protocol and each DLCI channel. This node also supports the
+of the LMI protocol and each DLCI channel.
+This node also supports the
.Dv NGM_TEXT_STATUS
control message.
.Sh HOOKS
diff --git a/share/man/man4/ng_one2many.4 b/share/man/man4/ng_one2many.4
index 2bdcd56..48f1cea 100644
--- a/share/man/man4/ng_one2many.4
+++ b/share/man/man4/ng_one2many.4
@@ -92,7 +92,8 @@ hook.
.It NG_ONE2MANY_XMIT_ALL
Packets are delivered out all the
.Dv many
-hooks. Each packet goes out each
+hooks.
+Each packet goes out each
.Dv many
hook.
.El
diff --git a/share/man/man4/ng_ppp.4 b/share/man/man4/ng_ppp.4
index 1f04571..127ee3f1 100644
--- a/share/man/man4/ng_ppp.4
+++ b/share/man/man4/ng_ppp.4
@@ -88,7 +88,8 @@ hook (see below).
During normal operation, the individual PPP links are connected to hooks
.Dv link0 ,
.Dv link1 ,
-etc. Up to
+etc.
+Up to
.Dv NG_PPP_MAX_LINKS
links are supported.
These device-independent hooks transmit and receive full PPP
@@ -162,7 +163,8 @@ hooks are connected, and the corresponding configuration flag is
enabled, Van Jacobson compression and/or decompression will become active.
Normally these hooks connect to the corresponding hooks of a single
.Xr ng_vjc 4
-node. The PPP node is compatible with the
+node.
+The PPP node is compatible with the
.Dq pass through
modes of the
.Xr ng_vjc 4
@@ -179,7 +181,8 @@ the prefix indicate the link number on which the frame was received
For such frames received over the bundle (i.e., encapsulated in the
multi-link protocol), the special link number
.Dv NG_PPP_BUNDLE_LINKNUM
-is used. After the two byte link number is the two byte PPP protocol number
+is used.
+After the two byte link number is the two byte PPP protocol number
(also in network order).
The PPP protocol number is two bytes long even if the original frame
was protocol compressed.
@@ -347,7 +350,8 @@ Returns the current configuration as a
.It Dv NGM_PPP_GET_LINK_STATS
This command takes a two byte link number as an argument and returns a
.Dv "struct ng_ppp_link_stat"
-containing statistics for the corresponding link. Here
+containing statistics for the corresponding link.
+Here
.Dv NG_PPP_BUNDLE_LINKNUM
is a valid link number corresponding to the multi-link bundle.
.It Dv NGM_PPP_CLR_LINK_STATS
@@ -361,10 +365,12 @@ but also atomically clears the statistics as well.
.Pp
This node type also accepts the control messages accepted by the
.Xr ng_vjc 4
-node type. When received, these messages are simply forwarded to
+node type.
+When received, these messages are simply forwarded to
the adjacent
.Xr ng_vjc 4
-node, if any. This is particularly useful when the individual
+node, if any.
+This is particularly useful when the individual
PPP links are able to generate
.Dv NGM_VJC_RECV_ERROR
messages (see
diff --git a/share/man/man4/ng_pppoe.4 b/share/man/man4/ng_pppoe.4
index 924e3f3..b4f3694 100644
--- a/share/man/man4/ng_pppoe.4
+++ b/share/man/man4/ng_pppoe.4
@@ -122,7 +122,7 @@ The argument given is the name of the service to offer.
A zero length service
is legal.
The State machine will progress to a state where it will await
-a request packet to be forwarded to it from the startup server,
+a request packet to be forwarded to it from the startup server,
which in turn probably received it from a LISTEN mode hook ( see above).
This is so
that information that is required for the session that is embedded in
diff --git a/share/man/man4/ng_socket.4 b/share/man/man4/ng_socket.4
index 04788dd..1b237d6 100644
--- a/share/man/man4/ng_socket.4
+++ b/share/man/man4/ng_socket.4
@@ -49,7 +49,8 @@ A
.Nm socket
node is both a
.Bx
-socket and a netgraph node. The
+socket and a netgraph node.
+The
.Nm
node type allows user-mode processes to participate in the kernel
.Xr netgraph 4
@@ -72,7 +73,7 @@ system call.
Any control messages received by the node
and not having a cookie value of
.Dv NGM_SOCKET_COOKIE
-are received by the process, using
+are received by the process, using
.Xr recvfrom 2 ;
the socket address argument is a
.Dv "struct sockaddr_ng"
@@ -112,12 +113,12 @@ on which the data was received or should be sent.
.Pp
As a special case, to allow netgraph data sockets to be used as stdin or stdout
on naive programs, a
-.Xr sendto 2
+.Xr sendto 2
with a NULL sockaddr pointer, a
.Xr send 2
or a
.Xr write 2
-will succeed in the case where there is exactly ONE hook attached to
+will succeed in the case where there is exactly ONE hook attached to
the socket node, (and thus the path is unambiguous).
.Pp
There is a user library that simplifies using netgraph sockets; see
@@ -132,7 +133,8 @@ This node type supports the generic control messages, plus the following:
When the last hook is removed from this node, it will shut down as
if it had received a
.Dv NGM_SHUTDOWN
-message. Attempts to access the sockets associated will return
+message.
+Attempts to access the sockets associated will return
.Er ENOTCONN .
.It Dv NGM_SOCK_CMD_LINGER
This is the default mode.
@@ -169,7 +171,7 @@ It is not possible to reject the connection of a hook, though any
data received on that hook can certainly be ignored.
.Pp
The controlling process is not notified of all events that an in-kernel node
-would be notified of, e.g. a new hook, or hook removal.
+would be notified of, e.g.\& a new hook, or hook removal.
Some node-initiated messages should be defined for this purpose (to be
sent up the control socket).
.Sh SEE ALSO
diff --git a/share/man/man4/ng_sppp.4 b/share/man/man4/ng_sppp.4
index 39b3336..12512ff 100644
--- a/share/man/man4/ng_sppp.4
+++ b/share/man/man4/ng_sppp.4
@@ -27,7 +27,8 @@ node is a
.Xr netgraph 4
interface to the original
.Xr sppp 4
-network module for synchronous lines. Currently
+network module for synchronous lines.
+Currently
.Xr sppp 4
supports PPP and Cisco HDLC protocol.
An
@@ -74,7 +75,8 @@ network modules.
.Pp
An
.Nm ng_sppp
-node has a single hook named downstream. Usually it is connected directly to
+node has a single hook named downstream.
+Usually it is connected directly to
a device driver hook.
.Pp
.Nm ng_sppp
@@ -101,7 +103,8 @@ struct ng_iface_ifname {
.Sh SHUTDOWN
This node shuts down upon receipt of a
.Dv NGM_SHUTDOWN
-control message. The associated interface is removed and becomes available
+control message.
+The associated interface is removed and becomes available
for use by future
.Nm ng_sppp
nodes.
diff --git a/share/man/man4/ng_sscfu.4 b/share/man/man4/ng_sscfu.4
index 9a2b5be..1267321 100644
--- a/share/man/man4/ng_sscfu.4
+++ b/share/man/man4/ng_sscfu.4
@@ -74,7 +74,8 @@ that which is exported by the
.Xr ng_sscop 4
node type.
.It Dv upper
-This is the interface to the UNI. It uses the following message format:
+This is the interface to the UNI.
+It uses the following message format:
.Bd -literal
struct sscfu_arg {
uint32_t sig;
@@ -112,14 +113,14 @@ field of the message structure.
.Pp
If the
.Dv lower
-hook is disconnected and the node is enabled, the protocol state is
+hook is disconnected and the node is enabled, the protocol state is
reset.
.Sh CONTROL MESSAGES
The
.Nm
node understands the generic messages plus the following:
.Bl -tag -width xxx
-.It Dv NGM_SSCFU_GETDEFPARAM
+.It Dv NGM_SSCFU_GETDEFPARAM
This message returns a
.Fa sscop_param
structure, which contains the default parameters for the SSCOP at the
@@ -127,11 +128,11 @@ UNI.
This structure should be used for a
.Dv NGM_SSCOP_SETPARAM
message to the SSCOP node below the SSCF.
-.It Dv NGM_SSCFU_ENABLE
+.It Dv NGM_SSCFU_ENABLE
This message creates the actual SSCF instance and initializes it.
Until this is done, parameters may not be retrieved not set and all message
received on any hook are discarded.
-.It Dv NGM_SSCFU_DISABLE
+.It Dv NGM_SSCFU_DISABLE
Destroy the SSCF instance.
After this all messages on any hooks are discarded.
.It Dv NGM_SSCFU_GETDEBUG
diff --git a/share/man/man4/ng_sscop.4 b/share/man/man4/ng_sscop.4
index aa3d6ae..0fe2746 100644
--- a/share/man/man4/ng_sscop.4
+++ b/share/man/man4/ng_sscop.4
@@ -42,7 +42,8 @@
.Sh DESCIPTION
The
.Nm
-netgraph node implements the ITU-T standard Q.2110. This standard describes
+netgraph node implements the ITU-T standard Q.2110.
+This standard describes
the so called Service Specific Connection Oriented Protocol (SSCOP) that
is used to carry signalling messages over the private and public UNIs and
the public NNI.
@@ -65,7 +66,8 @@ node has three hooks with fixed names:
.Bl -tag -width manage
.It Dv lower
This hook is the hook that must be connected to a node that ensures
-transport of packets to and from the remote peer node. Normally this is a
+transport of packets to and from the remote peer node.
+Normally this is a
.Xr ng_atm 4
node with an AAL5 hook, but the
.Nm
@@ -278,10 +280,12 @@ This message creates the actual SSCOP instance and initializes it.
Until this is done, parameters may neither be retrieved not set and all
message received on any hook are discarded.
.It Dv NGM_SSCOP_DISABLE
-Destroy the SSCOP instance. After this all messages on any hooks are
+Destroy the SSCOP instance.
+After this all messages on any hooks are
discarded.
.It Dv NGM_SSCOP_SETDEBUG
-Set debugging flags. The argument is an
+Set debugging flags.
+The argument is an
.Vt uint32_t .
.It Dv NGM_SSCOP_GETDEBUG
Retrieve the actual debugging flags.
@@ -293,7 +297,8 @@ Responds with the current state of the SSCOP instance in an
If the node is not enabled the retrieved state is 0.
.El
.Sh FLOW CONTROL
-Flow control works on the upper and on the lower layer interface. At the lower
+Flow control works on the upper and on the lower layer interface.
+At the lower
layer interface the two messages
.Dv NGM_HIGH_WATER_PASSED
and
diff --git a/share/man/man4/ng_tty.4 b/share/man/man4/ng_tty.4
index e0a1bc2..e5485d5 100644
--- a/share/man/man4/ng_tty.4
+++ b/share/man/man4/ng_tty.4
@@ -75,7 +75,8 @@ The default hot character is 0x7e, consistent with
.Dv hook
being connected to a
.Xr ng_async 4
-type node. The hot character has no effect on the transmission of data.
+type node.
+The hot character has no effect on the transmission of data.
.Pp
The node will attempt to give itself the same netgraph name as the name
of the tty device.
@@ -103,7 +104,8 @@ This node type supports the generic control messages, plus the following:
.Bl -tag -width foo
.It Dv NGM_TTY_SET_HOTCHAR
This command takes an integer argument and sets the hot character
-from the lower 8 bits. A hot character of zero disables queueing,
+from the lower 8 bits.
+A hot character of zero disables queueing,
so that all received data is forwarded immediately.
.It Dv NGM_TTY_GET_HOTCHAR
Returns an integer containing the current hot character in the lower
diff --git a/share/man/man4/ng_uni.4 b/share/man/man4/ng_uni.4
index a28543e..2fdfff9 100644
--- a/share/man/man4/ng_uni.4
+++ b/share/man/man4/ng_uni.4
@@ -349,7 +349,8 @@ field,
.Fa popt_mask
selects which of the protocol options to change and
.Fa option_mask
-specifies which options should be changed. The following bits are defined:
+specifies which options should be changed.
+The following bits are defined:
.Bd -literal
enum uni_config_mask {
UNICFG_PROTO,
diff --git a/share/man/man4/ng_vjc.4 b/share/man/man4/ng_vjc.4
index a32f97b..8db5b4c 100644
--- a/share/man/man4/ng_vjc.4
+++ b/share/man/man4/ng_vjc.4
@@ -49,7 +49,8 @@ The
.Nm vjc
node type performs Van Jacobson compression, which is used
over PPP, SLIP, and other point-to-point IP connections to
-compress TCP packet headers. The
+compress TCP packet headers.
+The
.Dv ip
hook represents the uncompressed side of the node, while the
.Dv vjcomp ,
@@ -116,7 +117,8 @@ This node type supports the generic control messages, plus the following:
This command resets the compression state and configures it according
to the supplied
.Dv "struct ngm_vjc_config"
-argument. This structure contains the following fields:
+argument.
+This structure contains the following fields:
.Bd -literal -offset 4n
struct ngm_vjc_config {
u_char enableComp; /* Enable compression */
@@ -132,7 +134,8 @@ is set to zero, all packets received on the
.Dv ip
hook are forwarded unchanged out the
.Dv vjip
-hook. Similarly, when
+hook.
+Similarly, when
.Dv enableDecomp
is set to zero, all packets received on the
.Dv vjip
diff --git a/share/man/man4/patm.4 b/share/man/man4/patm.4
index a82929c..5e7786e 100644
--- a/share/man/man4/patm.4
+++ b/share/man/man4/patm.4
@@ -53,7 +53,8 @@ The driver interfaces with the
framework,
.Xr netgraph 4
and HARP.
-It provides only PVC services. Signalling, ATMARP, ILMI and other
+It provides only PVC services.
+Signalling, ATMARP, ILMI and other
higher layer protocols are implemented using
.Xr netgraph 4
or HARP.
@@ -61,7 +62,8 @@ or HARP.
For configuring the card for IP see
.Xr natmip 4 .
.Pp
-The driver supports UBR, CBR, VBR and ABR traffic. Supported AALs are:
+The driver supports UBR, CBR, VBR and ABR traffic.
+Supported AALs are:
AAL0 (cell payloads), AAL5 and raw AAL.
The driver supports opening of VCI/VPI 0/0 in RX, raw AAL-mode.
This VC will receive all incoming cells (even those with non-zero GFC
@@ -89,7 +91,8 @@ This is the upper limit of transmission DMA maps the driver will allocate.
This is read-only but may be set via a loader tunable.
.It Cm hw.atm.patmN.debug
.Em (only if debugging enabled)
-These are debugging flags. See
+These are debugging flags.
+See
.Fn if_patmvar.h
for the possible flags.
This may be initialized via a loader tunable.
diff --git a/share/man/man4/pci.4 b/share/man/man4/pci.4
index 34759c0..07bdc96 100644
--- a/share/man/man4/pci.4
+++ b/share/man/man4/pci.4
@@ -81,7 +81,8 @@ It allows the user to retrieve information on all
.Tn PCI
devices in the system, or on
.Tn PCI
-devices matching patterns supplied by the user. The call may set
+devices matching patterns supplied by the user.
+The call may set
.Va errno
to any value specified in either
.Xr copyin 9
@@ -101,7 +102,8 @@ Pointer to a buffer filled with user-supplied patterns.
is a pointer to
.Va num_patterns
.Va pci_match_conf
-structures. The
+structures.
+The
.Va pci_match_conf
structure consists of the following elements:
.Bl -tag -width pd_vendor
@@ -247,7 +249,8 @@ reads the
.Tn PCI
configuration registers specified by the passed-in
.Va pci_io
-structure. The
+structure.
+The
.Va pci_io
structure consists of the following fields:
.Bl -tag -width pi_width
@@ -255,7 +258,8 @@ structure consists of the following fields:
A
.Va pcisel
structure which specifies the bus, slot and function the user would like to
-query. If the specific bus is not found, errno will be set to ENODEV and -1 returned from the ioctl.
+query.
+If the specific bus is not found, errno will be set to ENODEV and -1 returned from the ioctl.
.It pi_reg
The
.Tn PCI
@@ -263,8 +267,10 @@ configuration register the user would like to access.
.It pi_width
The width, in bytes, of the data the user would like to read.
This value
-may be either 1, 2, or 4. 3-byte reads and reads larger than 4 bytes are
-not supported. If an invalid width is passed, errno will be set to EINVAL.
+may be either 1, 2, or 4.
+3-byte reads and reads larger than 4 bytes are
+not supported.
+If an invalid width is passed, errno will be set to EINVAL.
.It pi_data
The data returned by the kernel.
.El
@@ -275,7 +281,8 @@ allows users to write to the
.Tn PCI
specified in the passed-in
.Va pci_io
-structure. The
+structure.
+The
.Va pci_io
structure is described above.
The limitations on data width described for
diff --git a/share/man/man4/pcn.4 b/share/man/man4/pcn.4
index 52eea1e..fdc583e 100644
--- a/share/man/man4/pcn.4
+++ b/share/man/man4/pcn.4
@@ -108,7 +108,7 @@ A fatal initialization error has occurred.
A fatal initialization error has occurred.
.It "pcn%d: watchdog timeout"
The device has stopped responding to the network, or there is a problem with
-the network connection (e.g. a cable fault).
+the network connection (e.g.\& a cable fault).
.It "pcn%d: no memory for rx list"
The driver failed to allocate an mbuf for the receiver ring.
.It "pcn%d: no memory for tx list"
diff --git a/share/man/man4/pcvt.4 b/share/man/man4/pcvt.4
index 5d2a85f..9d8ae66 100644
--- a/share/man/man4/pcvt.4
+++ b/share/man/man4/pcvt.4
@@ -207,7 +207,8 @@ Default: on
If enabled, the 25-line modi
(VT emulation with 25 lines, and HP emulation with 28 lines)
default to 24 lines only to provide a better compatibility to the
-original DEV VT220 (TM). Thus it should be possible to use the
+original DEV VT220 (TM).
+Thus it should be possible to use the
terminal information for those terminals without further changes.
Note that this is a startup option; it is possible to toggle between
the 24- and 25-lines' display by the
@@ -458,7 +459,8 @@ struct vgaloadchar {
The field
.Em character_set
takes the values
-CH_SET0, CH_SET1, CH_SET2, CH_SET3 on EGA's or VGA's. Since VGA's
+CH_SET0, CH_SET1, CH_SET2, CH_SET3 on EGA's or VGA's.
+Since VGA's
might have up to eight simultaneously loaded fonts, they can take
CH_SET4, CH_SET5, CH_SET6, or CH_SET7, too.
.Pp
@@ -597,7 +599,8 @@ struct vgapel {
.Bl -tag -width 20n -offset indent -compact
.It VGAPCVTID
returns information if the current compiled in driver is pcvt and it's
-major and minor revision numbers. the call is taking a pointer to the
+major and minor revision numbers.
+the call is taking a pointer to the
following structure as argument:
.El
.Bd -literal
@@ -615,7 +618,8 @@ struct pcvtid {
.Bl -tag -width 20n -offset indent -compact
.It VGAPCVTINFO
returns information if the current compiled in driver is pcvt and it's
-compile time options. the call is taking a pointer to the following
+compile time options.
+the call is taking a pointer to the following
structure as argument:
.El
.Bd -literal
diff --git a/share/man/man4/ppbus.4 b/share/man/man4/ppbus.4
index 4626a10..2481205 100644
--- a/share/man/man4/ppbus.4
+++ b/share/man/man4/ppbus.4
@@ -196,7 +196,8 @@ accessing the extended control register.
.Sh IEEE1284-1994 Standard
.Ss Background
This standard is also named "IEEE Standard Signaling Method for a
-Bidirectional Parallel Peripheral Interface for Personal Computers". It
+Bidirectional Parallel Peripheral Interface for Personal Computers".
+It
defines a signaling method for asynchronous, fully interlocked, bidirectional
parallel communications between hosts and printers or other peripherals.
It
@@ -319,7 +320,8 @@ functions.
But, in order to attach a handler, drivers must
own the bus.
Consequently, a ppbus request is mandatory in order to call the above
-functions (see existing drivers for more info). Note that the interrupt handler
+functions (see existing drivers for more info).
+Note that the interrupt handler
is automatically released when the ppbus is released.
.Ss Microsequences
.Em Microsequences
diff --git a/share/man/man4/ppi.4 b/share/man/man4/ppi.4
index 940e991..a6041d2 100644
--- a/share/man/man4/ppi.4
+++ b/share/man/man4/ppi.4
@@ -34,7 +34,7 @@
.Sh SYNOPSIS
.Cd "device ppi"
.Pp
-Minor numbering: Unit numbers correspond directly to ppbus numbers.
+Minor numbering: unit numbers correspond directly to ppbus numbers.
.Pp
.In dev/ppbus/ppi.h
.In dev/ppbus/ppbconf.h
diff --git a/share/man/man4/psm.4 b/share/man/man4/psm.4
index 7294d33..166be7a 100644
--- a/share/man/man4/psm.4
+++ b/share/man/man4/psm.4
@@ -767,7 +767,7 @@ At debug level 2, much more detailed information is logged.
.Sh CAVEATS
Many pad devices behave as if the first (left) button were pressed if
the user `taps' the surface of the pad.
-In contrast, some pad products, e.g. some versions of ALPS GlidePoint
+In contrast, some pad products, e.g.\& some versions of ALPS GlidePoint
and Interlink VersaPad, treat the tapping action
as fourth button events.
.Pp
diff --git a/share/man/man4/pt.4 b/share/man/man4/pt.4
index 1589f58..170956e 100644
--- a/share/man/man4/pt.4
+++ b/share/man/man4/pt.4
@@ -62,7 +62,8 @@ The following
.Xr ioctl 2
calls are supported by the
.Nm
-driver. They are defined in the header file
+driver.
+They are defined in the header file
.In sys/ptio.h .
.Pp
.It PTIOCGETTIMEOUT
diff --git a/share/man/man4/pty.4 b/share/man/man4/pty.4
index 0234ee2..5c6ef10 100644
--- a/share/man/man4/pty.4
+++ b/share/man/man4/pty.4
@@ -69,7 +69,7 @@ The following
calls apply only to pseudo terminals:
.Bl -tag -width TIOCREMOTE
.It Dv TIOCSTOP
-Stops output to a terminal (e.g. like typing
+Stops output to a terminal (e.g.\& like typing
.Ql ^S ) .
Takes
no parameter.
@@ -93,7 +93,8 @@ the pseudo terminal preceded by a zero byte (symbolically
defined as
.Dv TIOCPKT_DATA ) ,
or a single byte reflecting control
-status information. In the latter case, the byte is an inclusive-or
+status information.
+In the latter case, the byte is an inclusive-or
of zero or more of the bits:
.Bl -tag -width TIOCPKT_FLUSHWRITE
.It Dv TIOCPKT_FLUSHREAD
diff --git a/share/man/man4/random.4 b/share/man/man4/random.4
index f483b5b..22940f9 100644
--- a/share/man/man4/random.4
+++ b/share/man/man4/random.4
@@ -224,8 +224,8 @@ Another issue in simulation is
the size of the state associated with the random number generator, and
how frequently it repeats itself.
For example,
-a program which shuffles a pack of cards should have 52! possible outputs,
-which requires the random number generator to have 52! starting states.
+a program which shuffles a pack of cards should have 52!\& possible outputs,
+which requires the random number generator to have 52!\& starting states.
This means the seed should have at least log_2(52!) ~ 226 bits of state
if the program is to stand a chance of outputting all possible sequences,
and the program needs some unbiased way of generating these bits.
diff --git a/share/man/man4/re.4 b/share/man/man4/re.4
index 2aab010c..f163273 100644
--- a/share/man/man4/re.4
+++ b/share/man/man4/re.4
@@ -54,26 +54,30 @@ Compaq Evo N1015v Integrated Ethernet (8139C+)
.It
Gigabyte 7N400 Pro2 Integrated Gigabit Ethernet (8110S)
.It
-PLANEX COMMUNICATIONS Inc. GN-1200TC (8169S)
+PLANEX COMMUNICATIONS Inc.\& GN-1200TC (8169S)
.It
Xterasys XN-152 10/100/1000 NIC (8169)
.El
.Pp
NICs based on the 8139C+ are capable of 10 and 100Mbps speeds over CAT5
-cable. NICs based on the 8169, 8169S and 8110S are capable of 10, 100 and
+cable.
+NICs based on the 8169, 8169S and 8110S are capable of 10, 100 and
1000Mbps operation.
.Pp
All NICs supported by the
.Nm
driver have TCP/IP checksum offload and hardware VLAN tagging/insertion
-features, and use a descriptor-based DMA mechanism. They are also
+features, and use a descriptor-based DMA mechanism.
+They are also
capable of TCP large send (TCP segmentation offload).
.Pp
The 8139C+ is a single-chip solution combining both a 10/100 MAC and PHY.
The 8169 is a 10/100/1000 MAC only, requiring a GMII or TBI external PHY.
The 8169S and 8110S are single-chip devices containing both a 10/100/1000
-MAC and 10/100/1000 copper PHY. Standalone 10/100/1000 cards are available
-in both 32-bit PCI and 64-bit PCI models. The 8110S is designed for
+MAC and 10/100/1000 copper PHY.
+Standalone 10/100/1000 cards are available
+in both 32-bit PCI and 64-bit PCI models.
+The 8110S is designed for
embedded LAN-on-motherboard applications.
.Pp
The 8169, 8169S and 8110S also support jumbo frames, which can be configured
@@ -183,21 +187,27 @@ driver was written by
.Sh BUGS
The Xterasys XN-152 32-bit PCI NIC, which uses the RTL8169 MAC and
Marvell 88E1000 PHY, has a defect that causes DMA corruption
-if the board is plugged into a 64-bit PCI slot. The defect
+if the board is plugged into a 64-bit PCI slot.
+The defect
lies in the board design, not the chip itself: the PCI REQ64# and ACK64#
-lines should be pulled high, but they are not. The result is that the
+lines should be pulled high, but they are not.
+The result is that the
8169 chip is tricked into performing 64-bit DMA transfers even though
a 64-bit data path between the NIC and the bus does not actually exist.
.Pp
Unfortunately, it is not possible to correct this problem in software,
-however it is possible to detect it. When the
+however it is possible to detect it.
+When the
.Nm
driver is loaded, it will run a diagnostic routine designed to
validate DMA operation by placing the chip in digital loopback mode
-and initiating a packet transmission. If the card functions properly,
+and initiating a packet transmission.
+If the card functions properly,
the transmitted data will
-be echoed back unmodified. If the echoed data is corrupt, the driver
-will print an error message on the console and abort the device attach. The
+be echoed back unmodified.
+If the echoed data is corrupt, the driver
+will print an error message on the console and abort the device attach.
+The
user should insure the NIC is installed in a 32-bit PCI slot to
avoid this problem.
.Pp
diff --git a/share/man/man4/rl.4 b/share/man/man4/rl.4
index 342111a..9de1b9c 100644
--- a/share/man/man4/rl.4
+++ b/share/man/man4/rl.4
@@ -90,7 +90,7 @@ Longshine LCS-8038TX-R
.It
NDC Communications NE100TX-E
.It
-Netronix Inc. EA-1210 NetEther 10/100
+Netronix Inc.\& EA-1210 NetEther 10/100
.It
Nortel Networks 10/100BaseTX
.It
diff --git a/share/man/man4/route.4 b/share/man/man4/route.4
index 9ccdb9d..96f3a5b 100644
--- a/share/man/man4/route.4
+++ b/share/man/man4/route.4
@@ -85,7 +85,7 @@ a protocol family usually requests the packet be sent to the
same host specified in the packet.
Otherwise, the interface
is requested to address the packet to the gateway listed in the routing entry
-(i.e. the packet is forwarded).
+(i.e., the packet is forwarded).
.Pp
When routing a packet,
the kernel will attempt to find
diff --git a/share/man/man4/sa.4 b/share/man/man4/sa.4
index 529bb46..9ffcca9 100644
--- a/share/man/man4/sa.4
+++ b/share/man/man4/sa.4
@@ -111,7 +111,8 @@ tapes may run in either
.Sq Em variable
or
.Sq Em fixed
-block-size modes. Most
+block-size modes.
+Most
.Tn QIC Ns -type
devices run in fixed block-size mode, where most nine-track tapes and
many new cartridge formats allow variable block-size.
diff --git a/share/man/man4/safe.4 b/share/man/man4/safe.4
index 35ee566..a6a4d02 100644
--- a/share/man/man4/safe.4
+++ b/share/man/man4/safe.4
@@ -45,7 +45,8 @@ The
driver supports cards containing any of the following chips:
.Bl -tag -width "SafeNet 1141" -offset indent
.It SafeNet 1141
-The original chipset. Supports DES, Triple-DES, AES, MD5, and SHA-1
+The original chipset.
+Supports DES, Triple-DES, AES, MD5, and SHA-1
symmetric crypto operations, RNG, public key operations, and full IPsec
packet processing.
.It SafeNet 1741
diff --git a/share/man/man4/sbc.4 b/share/man/man4/sbc.4
index 95bb542..5f724b0 100644
--- a/share/man/man4/sbc.4
+++ b/share/man/man4/sbc.4
@@ -58,7 +58,8 @@ ESS ES1868, ES1869, ES1879 and ES1888
.Pp
The value of flags specifies the secondary DMA channel.
If the secondary
-DMA channel is C, set the flags to (C | 0x10). For a sound card without the
+DMA channel is C, set the flags to (C | 0x10).
+For a sound card without the
secondary DMA channel, the flags should be set to zero.
.Sh DIAGNOSTICS
.Bl -diag
diff --git a/share/man/man4/scsi.4 b/share/man/man4/scsi.4
index c274bb4..743a036 100644
--- a/share/man/man4/scsi.4
+++ b/share/man/man4/scsi.4
@@ -104,7 +104,8 @@ low disk space or low memory space environments.
In most cases, though,
this should be enabled, since it speeds the interpretation of
.Tn SCSI
-error messages. Don't let the "kernel bloat" zealots get to you -- leave
+error messages.
+Don't let the "kernel bloat" zealots get to you -- leave
the sense descriptions in your kernel!
.It Dv SCSI_NO_OP_STRINGS
This disables text descriptions of each
@@ -160,20 +161,27 @@ so they appear as a particular device unit or
so that they appear as the next available unused unit.
.Pp
Units are wired down by setting kernel environment hints.
-This is usually done either interactively from the loader, or automatically via the
+This is usually done either interactively from the
+.Xr loader 8 ,
+or automatically via the
.Pa /boot/device.hints
-file. The basic syntax is:
+file.
+The basic syntax is:
.Bd -literal -offset indent
hint.device.unit.property="value"
.Ed
.Pp
-Individual scsi bus numbers can be wired down to specific controllers with
+Individual
+.Nm
+bus numbers can be wired down to specific controllers with
a config line similar to the following:
.Bd -literal -offset indent
hint.scbus.0.at="ahd1"
.Ed
.Pp
-This assigns scsi bus number 0 to the
+This assigns
+.Nm
+bus number 0 to the
.Em ahd1
driver instance.
For controllers supporting more than one bus, a particular bus can be assigned
@@ -183,7 +191,9 @@ hint.scbus.0.at="ahc1"
hint.scbus.0.bus="1"
.Ed
.Pp
-This assigns scsi bus 0 to the bus 1 instance on
+This assigns
+.Nm
+bus 0 to the bus 1 instance on
.Em ahc0 .
Peripheral drivers can be wired to a specific bus, target, and lun as so:
.Bd -literal -offset indent
@@ -228,7 +238,9 @@ some adapters, but is not yet complete for this version of the CAM
.Tn SCSI
subsystem.
.Sh FILES
-see other scsi device entries.
+see other
+.Nm
+device entries.
.Sh DIAGNOSTICS
When the kernel is compiled with options CAMDEBUG, an XPT_DEBUG CCB can be
used to enable various amounts of tracing information on any
@@ -240,7 +252,8 @@ There are currently four debugging flags that may be turned on:
This debugging flag enables general informational printfs for the device
or devices in question.
.It Dv CAM_DEBUG_TRACE
-This debugging flag enables function-level command flow tracing. i.e.\&
+This debugging flag enables function-level command flow tracing.
+i.e.\&
kernel printfs will happen at the entrance and exit of various functions.
.It Dv CAM_DEBUG_SUBTRACE
This debugging flag enables debugging output internal to various functions.
@@ -261,7 +274,8 @@ There aren't many things logged at the
level, so it isn't especially useful.
The most useful debugging flag is the
.Dv CAM_DEBUG_CDB
-flag. Users can enable debugging from their kernel config file, by using
+flag.
+Users can enable debugging from their kernel config file, by using
the following kernel config options:
.Bl -tag -width CAM_DEBUG_TARGET
.It Dv CAMDEBUG
@@ -295,7 +309,8 @@ Users may also enable debugging printfs on the fly, if the
.Dv CAMDEBUG
option is their config file, by using the
.Xr camcontrol 8
-utility. See
+utility.
+See
.Xr camcontrol 8
for details.
.Sh SEE ALSO
diff --git a/share/man/man4/si.4 b/share/man/man4/si.4
index 8b6c357..65176bd 100644
--- a/share/man/man4/si.4
+++ b/share/man/man4/si.4
@@ -17,7 +17,7 @@ For ISA host cards put the following lines in
The Specialix SI/XIO and SX hardware makes up an 8 to 32 port RS-232 serial
multiplexor.
.Pp
-The system uses two components: A "Host adapter", which is plugged into
+The system uses two components: a "Host adapter", which is plugged into
an ISA, EISA or PCI slot and provides intelligence and buffering/processing
capabilities, as well as an external bus in the form of a 37 pin cable.
.Pp
@@ -65,7 +65,8 @@ utility for configuring drain-on-close timeouts.
The driver also defines 3 sysctl variables that can be manipulated:
machdep.si_debug sets the debug level for the whole driver.
It depends
-on the driver being compiled with SI_DEBUG. machdep.si_pollrate
+on the driver being compiled with SI_DEBUG.
+machdep.si_pollrate
sets how often per second the driver polls for lost interrupts.
machdep.si_realpoll sets whether or not the card will treat the
poll intervals as if they were interrupts.
@@ -78,7 +79,8 @@ It fully supports the usual semantics of the cua ports, and the
"initial termios" and "locked termios" settings.
In summary, an open on a
tty port will block until DCD is raised, unless O_NONBLOCK is specified.
-CLOCAL is honored. An open on a cua port will always succeed, but DCD
+CLOCAL is honored.
+An open on a cua port will always succeed, but DCD
transitions will be honored after DCD rises for the first time.
.Pp
Up to four SI/XIO host cards may be controlled by the si driver.
@@ -88,7 +90,8 @@ used at once.
The lowest 5 bits of the minor device number are used to select the port
number on the module cluster.
The next 2 bits select which of 4 host adapter
-cards. This allows a maximum of 128 ports on this driver.
+cards.
+This allows a maximum of 128 ports on this driver.
.Pp
Bit 7 is used to differentiate a tty/dialin port (bit 7=0) and a
cua/callout port (bit 7=1).
diff --git a/share/man/man4/sio.4 b/share/man/man4/sio.4
index 864714c..8f4201c 100644
--- a/share/man/man4/sio.4
+++ b/share/man/man4/sio.4
@@ -169,7 +169,7 @@ device is potential system console
.It 0x00020
device is forced to become system console
.It 0x00040
-device is reserved for low-level IO (e. g. for remote kernel debugging)
+device is reserved for low-level IO (e.g.\& for remote kernel debugging)
.It 0x00080
use this port for remote kernel debugging
.It 0x0 Ns Em ?? Ns 00
diff --git a/share/man/man4/sis.4 b/share/man/man4/sis.4
index 3d8074f..ab6b679 100644
--- a/share/man/man4/sis.4
+++ b/share/man/man4/sis.4
@@ -134,7 +134,7 @@ A fatal initialization error has occurred.
A fatal initialization error has occurred.
.It "sis%d: watchdog timeout"
The device has stopped responding to the network, or there is a problem with
-the network connection (e.g. a cable fault).
+the network connection (e.g.\& a cable fault).
.It "sis%d: no memory for rx list"
The driver failed to allocate an mbuf for the receiver ring.
.It "sis%d: no memory for tx list"
diff --git a/share/man/man4/snd_gusc.4 b/share/man/man4/snd_gusc.4
index 705c53d..05b71c8 100644
--- a/share/man/man4/snd_gusc.4
+++ b/share/man/man4/snd_gusc.4
@@ -57,7 +57,8 @@ Gravis UltraSound MAX
.Pp
The value of flags specifies the secondary DMA channel.
If the secondary
-DMA channel is C, set the flags to (C | 0x10). For a sound card without the
+DMA channel is C, set the flags to (C | 0x10).
+For a sound card without the
secondary DMA channel, the flags should be set to zero.
.Sh DIAGNOSTICS
.Bl -diag
diff --git a/share/man/man4/snd_sbc.4 b/share/man/man4/snd_sbc.4
index 95bb542..5f724b0 100644
--- a/share/man/man4/snd_sbc.4
+++ b/share/man/man4/snd_sbc.4
@@ -58,7 +58,8 @@ ESS ES1868, ES1869, ES1879 and ES1888
.Pp
The value of flags specifies the secondary DMA channel.
If the secondary
-DMA channel is C, set the flags to (C | 0x10). For a sound card without the
+DMA channel is C, set the flags to (C | 0x10).
+For a sound card without the
secondary DMA channel, the flags should be set to zero.
.Sh DIAGNOSTICS
.Bl -diag
diff --git a/share/man/man4/snd_uaudio.4 b/share/man/man4/snd_uaudio.4
index 781e4d9..96e46d2 100644
--- a/share/man/man4/snd_uaudio.4
+++ b/share/man/man4/snd_uaudio.4
@@ -54,8 +54,8 @@ audio class devices.
A
.Tn USB
audio device consists of a number of components:
-input terminals (e.g. USB digital input), output terminals (e.g.
-speakers), and a number of units in between (e.g. volume control).
+input terminals (e.g.\& USB digital input), output terminals (e.g.
+speakers), and a number of units in between (e.g.\& volume control).
.Pp
Refer to the
.Ql USB Audio Class Specification
@@ -86,7 +86,7 @@ The
framework in
.Fx ,
as of this writing, does not handle device un-registrations in a properly
-abstracted manner, i.e. a detach request is refused by the
+abstracted manner, i.e., a detach request is refused by the
.Tn PCM
framework if the device is in use.
For
diff --git a/share/man/man4/spkr.4 b/share/man/man4/spkr.4
index 199a131..e29ad6c 100644
--- a/share/man/man4/spkr.4
+++ b/share/man/man4/spkr.4
@@ -68,7 +68,8 @@ a zero duration.
.Pp
The play-string language is modeled on the PLAY statement conventions of
.Tn IBM
-Advanced BASIC 2.0. The
+Advanced BASIC 2.0.
+The
.Li MB ,
.Li MF ,
and
@@ -80,7 +81,8 @@ feature and the slur mark are new.
.Pp
There are 84 accessible notes numbered 1-84 in 7 octaves, each running from
C to B, numbered 0-6; the scale is equal-tempered A440 and octave 3 starts
-with middle C. By default, the play function emits half-second notes with the
+with middle C.
+By default, the play function emits half-second notes with the
last 1/16th second being `rest time'.
.Pp
Play strings are interpreted left to right as a series of play command groups;
@@ -89,12 +91,15 @@ Play command groups are as follows:
.Bl -tag -width CDEFGABxx
.It Li CDEFGAB
Letters A through G cause the corresponding note to be played in the
-current octave. A note letter may optionally be followed by an
+current octave.
+A note letter may optionally be followed by an
.Dq Em "accidental sign" ,
one of # + or -; the first two of these cause it to be sharped one
-half-tone, the last causes it to be flatted one half-tone. It may
+half-tone, the last causes it to be flatted one half-tone.
+It may
also be followed by a time value number and by sustain dots (see
-below). Time values are interpreted as for the L command below.
+below).
+Time values are interpreted as for the L command below.
.It Ns Li O Sy n
If
.Sy n
@@ -109,8 +114,10 @@ When octave-tracking is on, interpretation of a pair of letter notes
will change octaves if necessary in order to make the smallest
possible jump between notes.
Thus ``olbc'' will be played as
-``olb>c'', and ``olcb'' as ``olc<b''. Octave locking is disabled for
-one letter note following >, < and O[0123456]. (The octave-locking
+``olb>c'', and ``olcb'' as ``olc<b''.
+Octave locking is disabled for
+one letter note following >, < and O[0123456].
+(The octave-locking
feature is not supported in
.Tn IBM
BASIC.)
@@ -125,7 +132,8 @@ Play note
being 1 to 84 or 0 for a rest of current time value.
May be followed by sustain dots.
.It Ns Li L Sy n
-Sets the current time value for notes. The default is
+Sets the current time value for notes.
+The default is
.Li L4 ,
quarter or crotchet notes.
The lowest possible value is 1; values up
@@ -142,10 +150,12 @@ Pause (rest), with
interpreted as for
.Li L Sy n .
May be followed by
-sustain dots. May also be written
+sustain dots.
+May also be written
.Li ~ .
.It Ns Li T Sy n
-Sets the number of quarter notes per minute; default is 120. Musical
+Sets the number of quarter notes per minute; default is 120.
+Musical
names for common tempi are:
.Bd -literal -offset indent
Tempo Beats Per Minute
@@ -192,7 +202,8 @@ dotted twice, it is held 9/4, and three times would give 27/8.
.Pp
A note and its sustain dots may also be followed by a slur mark (underscore).
This causes the normal micro-rest after the note to be filled in, slurring it
-to the next one. (The slur feature is not supported in
+to the next one.
+(The slur feature is not supported in
.Tn IBM
BASIC.)
.Pp
@@ -206,9 +217,11 @@ There is no volume control.
.Pp
The action of two or more sustain dots does not reflect standard musical
notation, in which each dot adds half the value of the previous dot
-modifier, not half the value of the note as modified. Thus, a note dotted
+modifier, not half the value of the note as modified.
+Thus, a note dotted
once is held for 3/2 of its undotted value; dotted twice, it is held 7/4,
-and three times would give 15/8. The multiply-by-3/2 interpretation,
+and three times would give 15/8.
+The multiply-by-3/2 interpretation,
however, is specified in the
.Tn IBM
BASIC manual and has been retained for
diff --git a/share/man/man4/sppp.4 b/share/man/man4/sppp.4
index 64a993e..32acec1 100644
--- a/share/man/man4/sppp.4
+++ b/share/man/man4/sppp.4
@@ -39,22 +39,27 @@ The
network layer implements the state machine and the Link Control
Protocol (LCP) of the
.Em point to point protocol (PPP)
-as described in RFC 1661. Note that this layer does not provide
+as described in RFC 1661.
+Note that this layer does not provide
network interfaces of its own, it is rather intended to be layered on
top of drivers providing a synchronous point-to-point connection that
-wish to run a PPP stack over it. The corresponding network interfaces
+wish to run a PPP stack over it.
+The corresponding network interfaces
have to be provided by these hardware drivers.
.Pp
The
.Nm
-layer provides three basic modes of operation. The default mode,
+layer provides three basic modes of operation.
+The default mode,
with no special flags to be set, is to create the PPP connection
(administrative
.Em Open
event to the LCP layer) as soon as the interface is taken up with the
.Xr ifconfig 8
-command. Taking the interface down again will terminate the LCP layer
-and thus all other layers on top. The link will also terminate itself as
+command.
+Taking the interface down again will terminate the LCP layer
+and thus all other layers on top.
+The link will also terminate itself as
soon as no Network Control Protocol (NCP) is open anymore, indicating
that the lower layers are no longer needed.
.Pp
@@ -64,7 +69,8 @@ with
.Xr ifconfig 8
will cause the respective network interface to go into
.Em passive
-mode. This means, the administrative
+mode.
+This means, the administrative
.Em Open
event to the LCP layer will be delayed until after the lower layers
signals an
@@ -83,14 +89,17 @@ Finally, setting the flag
.Em link1
will cause the interface to operate in
.Em dial-on-demand
-mode. This is also only useful if the lower layer supports the notion
-of a carrier (like with an ISDN line). Upon configuring the
+mode.
+This is also only useful if the lower layer supports the notion
+of a carrier (like with an ISDN line).
+Upon configuring the
respective interface, it will delay the administrative
.Em Open
event to the LCP layer until either an outbound network packet
arrives, or until the lower layer signals an
.Em Up
-event, indicating an inbound connection. As with passive mode, receipt
+event, indicating an inbound connection.
+As with passive mode, receipt
of a
.Em Down
event (loss of carrier) will not automatically take the interface down,
@@ -107,14 +116,17 @@ exchanged as well as the option negotiation between both ends of the
link will be logged at level
.Dv LOG_DEBUG .
This can be helpful to examine configuration problems during the first
-attempts to set up a new configuration. Without this flag being set,
+attempts to set up a new configuration.
+Without this flag being set,
only the major phase transitions will be logged at level
.Dv LOG_INFO .
.Pp
It is possible to leave the local interface IP address open for
-negotiation by setting it to 0.0.0.0. This requires that the remote
+negotiation by setting it to 0.0.0.0.
+This requires that the remote
peer can correctly supply a value for it based on the identity of the
-caller, or on the remote address supplied by this side. Due to the
+caller, or on the remote address supplied by this side.
+Due to the
way the IPCP option negotiation works, this address is being supplied
late during the negotiation, which might cause the remote peer to make
wrong assumptions.
@@ -125,28 +137,33 @@ value
which means that we don't care what address the remote
side will use, as long as it is not 0.0.0.0.
This is useful if your ISP has several dial-in
-servers. You can of course
+servers.
+You can of course
.Nm route Cm add Ar something_or_other 0.0.0. Ns Em *
and it will do exactly what you would want it to.
.Pp
The PAP and CHAP authentication protocols as described in RFC 1334,
-and RFC 1994 resp., are also implemented. Their parameters are being
+and RFC 1994 resp., are also implemented.
+Their parameters are being
controlled by the
.Xr spppcontrol 8
utility.
.Pp
-VJ header compression is implemented, and enabled by default. It can be
+VJ header compression is implemented, and enabled by default.
+It can be
disabled using
.Xr spppcontrol 8 .
.Sh DIAGNOSTICS
.Bl -diag
.It <ifname><ifnum>: <proto> illegal <event> in state <statename>
An event happened that should not happen for the current state
-the respective control protocol is in. See RFC 1661 for a description
+the respective control protocol is in.
+See RFC 1661 for a description
of the state automaton.
.It <ifname><ifnum>: loopback
The state automaton detected a line loopback (that is, it was talking
-with itself). The interface will be temporarily disabled.
+with itself).
+The interface will be temporarily disabled.
.It <ifname><ifnum>: up
The LCP layer is running again, after a line loopback had previously
been detected.
@@ -192,7 +209,8 @@ was written in 1994 at Cronyx Ltd., Moscow by
.Aq joerg_wunsch@uriah.heep.sax.de
rewrote a large part in 1997 in order
to fully implement the state machine as described in RFC 1661, so it
-could also be used for dialup lines. He also wrote this man page.
+could also be used for dialup lines.
+He also wrote this man page.
Serge later on wrote a basic implementation for PAP and CHAP, which
served as the base for the current implementation, done again by
.An J\(:org Wunsch .
@@ -207,7 +225,8 @@ network protocol is supported.
More NCPs should be implemented, as well as other control protocols
for authentication and link quality reporting.
.Pp
-Negotiation loop avoidance is not fully implemented. If the negotiation
+Negotiation loop avoidance is not fully implemented.
+If the negotiation
doesn't converge, this can cause an endless loop.
.Pp
The various parameters that should be adjustable per RFC 1661 are
diff --git a/share/man/man4/sym.4 b/share/man/man4/sym.4
index b7c4e8b..29a4f77 100644
--- a/share/man/man4/sym.4
+++ b/share/man/man4/sym.4
@@ -287,12 +287,12 @@ following settings are taken into account and reported to CAM:
.Bl -column "Synchronous period" "Symbios"
.It Em "Device settings Symbios Tekram"
.It "Synchronous period Y Y"
-.It "SCSI bus width Y Y"
+.It "SCSI bus width Y Y"
.It "Queue tag enable Y Y"
-.It "Number of tags NA Y"
+.It "Number of tags NA Y"
.It "Disconnect enable Y Y"
.It "Scan at boot time Y N"
-.It "Scan LUN Y N"
+.It "Scan LUN Y N"
.El
.Pp
Devices that are configured as disabled for 'scan' in the NVRAM are not
diff --git a/share/man/man4/sysmouse.4 b/share/man/man4/sysmouse.4
index 9b81aa0..db5b724 100644
--- a/share/man/man4/sysmouse.4
+++ b/share/man/man4/sysmouse.4
@@ -100,11 +100,13 @@ The first half of vertical movement count in two's complement;
-128 through 127.
.It Byte 4
The second half of the horizontal movement count in two's complement;
--128 through 127. To obtain the full horizontal movement count, add
+-128 through 127.
+To obtain the full horizontal movement count, add
the byte 2 and 4.
.It Byte 5
The second half of the vertical movement count in two's complement;
--128 through 127. To obtain the full vertical movement count, add
+-128 through 127.
+To obtain the full vertical movement count, add
the byte 3 and 5.
.El
.Pp
diff --git a/share/man/man4/termios.4 b/share/man/man4/termios.4
index 5c9de56..1a9d846 100644
--- a/share/man/man4/termios.4
+++ b/share/man/man4/termios.4
@@ -153,7 +153,8 @@ most one session.
The controlling terminal for a session is allocated by
the session leader by issuing the
.Dv TIOCSCTTY
-ioctl. A controlling terminal
+ioctl.
+A controlling terminal
is never acquired by merely opening a terminal device file.
When a controlling terminal becomes
associated with a session, its foreground process group is set to
@@ -189,7 +190,7 @@ causes a
signal to be sent to
the process's group
unless one of the
-following special cases apply: If the reading process is ignoring or
+following special cases apply: if the reading process is ignoring or
blocking the
.Dv SIGTTIN
signal, or if the process group of the reading
@@ -199,7 +200,8 @@ returns -1 with
.Va errno set to
.Er EIO
and no
-signal is sent. The default action of the
+signal is sent.
+The default action of the
.Dv SIGTTIN
signal is to stop the
process to which it is sent.
@@ -209,7 +211,7 @@ terminal, write operations are allowed.
Attempts by a process in a background process group to write to its
controlling terminal will cause the process group to be sent a
.Dv SIGTTOU
-signal unless one of the following special cases apply: If
+signal unless one of the following special cases apply: if
.Dv TOSTOP
is not
set, or if
@@ -244,7 +246,8 @@ A terminal device associated with a terminal device file may operate in
full-duplex mode, so that data may arrive even while output is occurring.
Each terminal device file has associated with it an input queue, into
which incoming data is stored by the system before being read by a
-process. The system imposes a limit,
+process.
+The system imposes a limit,
.Pf \&{ Dv MAX_INPUT Ns \&} ,
on the number of
bytes that may be stored in the input queue.
@@ -269,7 +272,8 @@ input characters are processed according to the
.Fa c_iflag
and
.Fa c_lflag
-fields. Such processing can include echoing, which
+fields.
+Such processing can include echoing, which
in general means transmitting input characters immediately back to the
terminal when they are received from the terminal.
This is useful for terminals that can operate in full-duplex mode.
@@ -311,13 +315,15 @@ When data is available depends on whether the input processing mode is
canonical or noncanonical.
.Ss Canonical Mode Input Processing
In canonical mode input processing, terminal input is processed in units
-of lines. A line is delimited by a newline
+of lines.
+A line is delimited by a newline
.Ql \&\en
character, an end-of-file
.Pq Dv EOF
character, or an end-of-line
.Pq Dv EOL
-character. See the
+character.
+See the
.Sx "Special Characters"
section for
more information on
@@ -355,7 +361,8 @@ delimited by a newline
.Dv EOF ,
or
.Dv EOL
-character. This un-delimited
+character.
+This un-delimited
data makes up the current line.
The
.Dv ERASE
@@ -396,7 +403,8 @@ function successfully returns.
.Dv TIME
is a timer of 0.1 second
granularity that is used to time out bursty and short term data
-transmissions. If
+transmissions.
+If
.Dv MIN
is greater than
.Dv \&{ Dv MAX_INPUT Ns \&} ,
@@ -420,8 +428,9 @@ The interaction between
and
.Dv TIME
is as
-follows: as soon as one byte is received, the inter-byte timer is
-started. If
+follows: as soon as one byte is received, the inter-byte timer is
+started.
+If
.Dv MIN
bytes are received before the inter-byte timer expires
(remember that the timer is reset upon receipt of each byte), the read is
@@ -500,7 +509,8 @@ are processed according to the
.Fa c_oflag
field (see the
.Sx "Output Modes
-section). The
+section).
+The
implementation may provide a buffering mechanism; as such, when a call to
.Fn write
completes, all of the bytes written have been scheduled for
@@ -523,7 +533,8 @@ Generates a
.Dv SIGINT
signal which is sent to all processes in the foreground
process group for which the terminal is the controlling
-terminal. If
+terminal.
+If
.Dv ISIG
is set, the
.Dv INTR
@@ -653,7 +664,8 @@ recognized if the
control) flag is set.
Can be used to resume output that has been suspended by a
.Dv STOP
-character. If
+character.
+If
.Dv IXON
is set, the
.Dv START
@@ -688,7 +700,8 @@ termios.
.It Dv EOL2
Secondary
.Dv EOL
-character. Same function as
+character.
+Same function as
.Dv EOL .
.It Dv WERASE
Special character on input and is recognized if the
@@ -928,7 +941,8 @@ X, where
.Ql \&\e0
is a two-character
flag preceding each sequence and X is the data of the character received
-in error. To avoid ambiguity in this case, if
+in error.
+To avoid ambiguity in this case, if
.Dv ISTRIP
is not set, a valid
character of
@@ -973,12 +987,14 @@ is set, a received
.Dv NL
character is translated into a
.Dv CR
-character. If
+character.
+If
.Dv IGNCR
is set, a received
.Dv CR
character is ignored (not
-read). If
+read).
+If
.Dv IGNCR
is not set and
.Dv ICRNL
@@ -1402,7 +1418,8 @@ received or the timeout value
.Dv TIME
expired between bytes.
The time value
-represents tenths of seconds. See
+represents tenths of seconds.
+See
.Sx "Noncanonical Mode Input Processing"
for more details.
.Pp
@@ -1502,7 +1519,7 @@ the system defaults, consult the header file
.It Dv VEOL Ta EOL Ta _POSIX_VDISABLE
.It Dv VEOL2 Ta EOL2 Ta _POSIX_VDISABLE
.It Dv VERASE Ta ERASE Ta \&^? Ql \&\e177
-.It Dv VWERASE Ta WERASE Ta \&^W
+.It Dv VWERASE Ta WERASE Ta \&^W
.It Dv VKILL Ta KILL Ta \&^U
.It Dv VREPRINT Ta REPRINT Ta \&^R
.It Dv VINTR Ta INTR Ta \&^C
diff --git a/share/man/man4/ti.4 b/share/man/man4/ti.4
index 8fab9b6..f89a904 100644
--- a/share/man/man4/ti.4
+++ b/share/man/man4/ti.4
@@ -208,9 +208,11 @@ header file.
.Bl -tag -width ".Dv ALT_WRITE_TG_MEM"
.It Dv TIIOCGETSTATS
Return card statistics DMAed from the card into kernel memory approximately
-every 2 seconds. (That time interval can be changed via the
+every 2 seconds.
+(That time interval can be changed via the
.Dv TIIOCSETPARAMS
-ioctl.) The argument is
+ioctl.)
+The argument is
.Vt "struct ti_stats" .
.It Dv TIIOCGETPARAMS
Get various performance-related firmware parameters that largely affect how
@@ -219,7 +221,8 @@ The argument is
.Vt "struct ti_params" .
.It Dv TIIOCSETPARAMS
Set various performance-related firmware parameters that largely affect how
-interrupts are coalesced. The argument is
+interrupts are coalesced.
+The argument is
.Vt "struct ti_params" .
.It Dv TIIOCSETTRACE
Tell the NIC to trace the requested types of information.
diff --git a/share/man/man4/tl.4 b/share/man/man4/tl.4
index ceb97e3..30b076f 100644
--- a/share/man/man4/tl.4
+++ b/share/man/man4/tl.4
@@ -56,7 +56,8 @@ and the Racore 8165 10/100baseTX and 8148 10baseT/100baseTX/100baseFX
multi-personality cards.
.Pp
The ThunderLAN controller has a standard MII interface that supports
-up to 32 physical interface devices (PHYs). It also has a built-in
+up to 32 physical interface devices (PHYs).
+It also has a built-in
10baseT PHY hardwired at MII address 31, which may be used in some
10Mbps-only hardware configurations.
In 100Mbps configurations, a
diff --git a/share/man/man4/ttcp.4 b/share/man/man4/ttcp.4
index 3a53969..454b208 100644
--- a/share/man/man4/ttcp.4
+++ b/share/man/man4/ttcp.4
@@ -211,7 +211,8 @@ extensions require the
.Dq Li net.inet.tcp.rfc1644
MIB variable to be true in order for the appropriate
.Tn TCP
-options to be sent. See
+options to be sent.
+See
.Xr tcp 4
for more information.
.Sh SEE ALSO
diff --git a/share/man/man4/tty.4 b/share/man/man4/tty.4
index a7029a4..cade15a 100644
--- a/share/man/man4/tty.4
+++ b/share/man/man4/tty.4
@@ -95,7 +95,8 @@ calls.
For each existing terminal file, there is a software processing module
called a
.Em "line discipline"
-is associated with it. The
+is associated with it.
+The
.Em "line discipline"
essentially glues the low level device driver code with the high
level generic interface routines (such as
@@ -150,7 +151,8 @@ The following section lists the available ioctl requests.
The name of the request, a description of its purpose, and the typed
.Em argp
parameter (if any)
-are listed. For example, the first entry says
+are listed.
+For example, the first entry says
.Pp
.D1 Em "TIOCSETD int *ldisc"
.Pp
@@ -322,7 +324,7 @@ If the value of the integer is zero, then it behaves as if both the
.Dv FREAD
and
.Dv FWRITE
-bits were set (i.e. clears both queues).
+bits were set (i.e., clears both queues).
.It Dv TIOCGWINSZ Fa struct winsize *ws
Put the window size information associated with the terminal in the
.Va winsize
diff --git a/share/man/man4/uaudio.4 b/share/man/man4/uaudio.4
index 781e4d9..96e46d2 100644
--- a/share/man/man4/uaudio.4
+++ b/share/man/man4/uaudio.4
@@ -54,8 +54,8 @@ audio class devices.
A
.Tn USB
audio device consists of a number of components:
-input terminals (e.g. USB digital input), output terminals (e.g.
-speakers), and a number of units in between (e.g. volume control).
+input terminals (e.g.\& USB digital input), output terminals (e.g.
+speakers), and a number of units in between (e.g.\& volume control).
.Pp
Refer to the
.Ql USB Audio Class Specification
@@ -86,7 +86,7 @@ The
framework in
.Fx ,
as of this writing, does not handle device un-registrations in a properly
-abstracted manner, i.e. a detach request is refused by the
+abstracted manner, i.e., a detach request is refused by the
.Tn PCM
framework if the device is in use.
For
diff --git a/share/man/man4/udp.4 b/share/man/man4/udp.4
index 0673ece..4ae65ed 100644
--- a/share/man/man4/udp.4
+++ b/share/man/man4/udp.4
@@ -82,7 +82,7 @@ Note that the
port
space is separate from the
.Tn TCP
-port space (i.e. a
+port space (i.e., a
.Tn UDP
port
may not be
diff --git a/share/man/man4/ukbd.4 b/share/man/man4/ukbd.4
index 2751829..6eb2b6e 100644
--- a/share/man/man4/ukbd.4
+++ b/share/man/man4/ukbd.4
@@ -88,7 +88,8 @@ the USB keyboard will be detected
.Em after
the console driver
initializes itself and you have to explicitly tell the console
-driver to use the existence of the USB keyboard. This can be done in
+driver to use the existence of the USB keyboard.
+This can be done in
one of the following two ways.
.Pp
Run the following command as a part of system initialization:
diff --git a/share/man/man4/umass.4 b/share/man/man4/umass.4
index a49ee5b..cb8fcec 100644
--- a/share/man/man4/umass.4
+++ b/share/man/man4/umass.4
@@ -52,7 +52,7 @@ Iomega USB Zip 250 drive
.It
Logitec LDR-H443U2 DVD-RAM/-R/+R/-RW/+RW Drive
.It
-Microtech International, Inc. USB-SCSI-HD 50 USB to SCSI cable
+Microtech International, Inc.\& USB-SCSI-HD 50 USB to SCSI cable
.It
Panasonic ("Matshita FDD CF-VFDU03")
.It
diff --git a/share/man/man4/umct.4 b/share/man/man4/umct.4
index 072d2d5..41b1d41 100644
--- a/share/man/man4/umct.4
+++ b/share/man/man4/umct.4
@@ -54,9 +54,11 @@ Belkin F5U109
The
.Nm
driver provides support for USB to RS-232 converters based on the Magic
-Control Technology USB-232 design. These devices support most of the
+Control Technology USB-232 design.
+These devices support most of the
standard RS-232 features including baud rates ranging from 300 to 115200
-bits per second. However, neither hardware nor software flow control
+bits per second.
+However, neither hardware nor software flow control
seems to be supported.
.Pp
Access to devices under this driver is via the
diff --git a/share/man/man4/ums.4 b/share/man/man4/ums.4
index 341399a..1fea37e 100644
--- a/share/man/man4/ums.4
+++ b/share/man/man4/ums.4
@@ -81,7 +81,8 @@ to the following
.Dl Device "/dev/ums0"
.Dl Protocol "Auto"
.Pp
-to be able to use the USB mouse under X. When using the XiG accelerated X
+to be able to use the USB mouse under X.
+When using the XiG accelerated X
server, change the mouse device to /dev/ums0 and the mouse type to
"MouseSystems".
.Pp
diff --git a/share/man/man4/utopia.4 b/share/man/man4/utopia.4
index d165921..7e75878 100644
--- a/share/man/man4/utopia.4
+++ b/share/man/man4/utopia.4
@@ -65,31 +65,45 @@ The possible modes are:
.It Dv UTP_LOOP_NONE (0x00)
No loopback, normal operation.
.It Dv UTP_LOOP_TIME (0x01)
-Timing source loopback. When this is set the transmitter's clock is
+Timing source loopback.
+When this is set the transmitter's clock is
derived from the receiver's clock.
.It Dv UTP_LOOP_DIAG (0x02)
-Diagnostic loopback. In this mode the receiver's input is connected to the
-transmitter's output. The receiver gets back everything that is sent. The
+Diagnostic loopback.
+In this mode the receiver's input is connected to the
+transmitter's output.
+The receiver gets back everything that is sent.
+The
transmitter operates normally.
.It Dv UTP_LOOP_LINE (0x04)
-Serial line loopback. This connects the line receiver to the line transmitter.
-The chip transmits all cells back that it receives. The receiver operates
+Serial line loopback.
+This connects the line receiver to the line transmitter.
+The chip transmits all cells back that it receives.
+The receiver operates
normally.
.It Dv UTP_LOOP_PARAL (0x08)
-Parallel diagnostic loopback. This feeds back all transmitted cells into the
-receiver between the parallel/serial converters. The transmitter
+Parallel diagnostic loopback.
+This feeds back all transmitted cells into the
+receiver between the parallel/serial converters.
+The transmitter
operates normally.
.It Dv UTP_LOOP_TWIST (0x10)
-Twisted pair diagnostic loopback. Connects the high speed receive data to the
-high speed transmit data. All received data is sent back. The receiver
+Twisted pair diagnostic loopback.
+Connects the high speed receive data to the
+high speed transmit data.
+All received data is sent back.
+The receiver
operates normally.
.It Dv UTP_LOOP_PATH (0x20)
-Diagnostic path loopback. This connects the receiver input to the transmitter
-output just between the path overhead processor and the byte mux. The
+Diagnostic path loopback.
+This connects the receiver input to the transmitter
+output just between the path overhead processor and the byte mux.
+The
transmitter operates normally.
.El
.It Cm phy_type
-This is the detected type of the phy chip. Currently the following chips are
+This is the detected type of the phy chip.
+Currently the following chips are
supported:
.Bl -tag -width XXX
.It Dv UTP_TYPE_UNKNOWN (0)
@@ -108,8 +122,10 @@ IDT77155 (155MBit interface)
.It Cm phy_name
This is a string describing the type of the PHY chip.
.It Cm phy_stats
-Physical and some ATM layer statistics. These are the statistics usually
-provided by the chip. The data is a returned in the following structure:
+Physical and some ATM layer statistics.
+These are the statistics usually
+provided by the chip.
+The data is a returned in the following structure:
.Bd -literal
struct utopia_stats1 {
uint32_t version; /* version of this struct */
@@ -127,9 +143,13 @@ struct utopia_stats1 {
};
.Ed
.Pp
-The current version is 1. The statistics are updated from the chip once
-a second. On overflow the counters wrap to zero. Note that not all counters
-are meaningful for all PHY chips. The statistics are cleared by writing an
+The current version is 1.
+The statistics are updated from the chip once
+a second.
+On overflow the counters wrap to zero.
+Note that not all counters
+are meaningful for all PHY chips.
+The statistics are cleared by writing an
arbitrary new value (the value is ignored).
.El
.Pp
@@ -148,7 +168,9 @@ If the PHY is a Sonet/SDH chip disable scrambling.
This may be useful for debugging purposes.
.It Cm unassigned
Normally the interface emits idle cells when there are no other cells to
-transmit. This changes the default cell type to unassigned cells. This
+transmit.
+This changes the default cell type to unassigned cells.
+This
may be needed for interworking with public networks.
.El
.Sh SEE ALSO
diff --git a/share/man/man4/vga.4 b/share/man/man4/vga.4
index 6634496..ce7d66c 100644
--- a/share/man/man4/vga.4
+++ b/share/man/man4/vga.4
@@ -49,7 +49,8 @@ In
The
.Nm
driver is a generic video card driver which provides access to
-video cards. This driver is required for the console driver
+video cards.
+This driver is required for the console driver
.Xr syscons 4 .
The console driver will call the
.Nm
@@ -121,7 +122,8 @@ This option removes this feature.
Note that if you use this option and
still wish to use the mouse on the console then you must also use the
.Dv SC_ALT_MOUSE_IMAGE
-option. See
+option.
+See
.Xr syscons 4 .
.It Dv VGA_NO_MODE_CHANGE
This option prevents the driver from changing video modes.
@@ -146,7 +148,8 @@ in order to enable the VESA BIOS Extension support.
If you do not want VESA support included in the kernel, but
want to use occasionally, do not add the
.Dv VESA
-option. And load the
+option.
+And load the
.Nm vesa
module as desired:
.Pp
diff --git a/share/man/man4/vpo.4 b/share/man/man4/vpo.4
index 08326aa..6c5bc01 100644
--- a/share/man/man4/vpo.4
+++ b/share/man/man4/vpo.4
@@ -72,7 +72,8 @@ and use
.Xr bsdlabel 8 .
.Pp
If you have trouble with your driver, your parallel chipset may not run
-properly at the detected mode (NIBBLE, PS2 or EPP). Tune the
+properly at the detected mode (NIBBLE, PS2 or EPP).
+Tune the
.Xr ppc 4
bootflags to force other modes.
.Sh SEE ALSO
diff --git a/share/man/man4/vr.4 b/share/man/man4/vr.4
index d8b394d..83347ac 100644
--- a/share/man/man4/vr.4
+++ b/share/man/man4/vr.4
@@ -177,5 +177,5 @@ If buffers are not aligned correctly, the chip will round the
supplied buffer address and begin DMAing from the wrong location.
This buffer copying impairs transmit performance on slower systems but can't
be avoided.
-On faster machines (e.g. a Pentium II), the performance
+On faster machines (e.g.\& a Pentium II), the performance
impact is much less noticeable.
diff --git a/share/man/man4/wi.4 b/share/man/man4/wi.4
index b9a4ecd..df144c0 100644
--- a/share/man/man4/wi.4
+++ b/share/man/man4/wi.4
@@ -226,7 +226,7 @@ Symbol Spectrum24 Spectrum24 PCMCIA
Symbol LA-4100 Spectrum24 CF
TDK LAK-CD011WL Prism-II PCMCIA
Toshiba Wireless LAN Card Prism-II PCMCIA
-U.S. Robotics Wireless Card 2410 Prism-II PCMCIA
+U.S.\& Robotics Wireless Card 2410 Prism-II PCMCIA
YIS YWL-11B Prism-II PCMCIA
.El
.Pp
diff --git a/share/man/man4/xl.4 b/share/man/man4/xl.4
index 06144ec..ef9f155 100644
--- a/share/man/man4/xl.4
+++ b/share/man/man4/xl.4
@@ -191,7 +191,8 @@ docking stations with built-in 3c905-TX adapters.
For whatever the
reason, the 'MII available' bit in the media options register on
this particular equipment is not set, even though it should be (the
-3c905-TX always uses an external PHY transceiver). The driver will
+3c905-TX always uses an external PHY transceiver).
+The driver will
attempt to guess the proper media type based on the PCI device ID
word.
The driver makes a lot of noise about this condition because
diff --git a/share/man/man4/xpt.4 b/share/man/man4/xpt.4
index adf1fef..e670acb 100644
--- a/share/man/man4/xpt.4
+++ b/share/man/man4/xpt.4
@@ -44,22 +44,27 @@ to the kernel.
Since the
.Nm
driver allows direct access to the CAM subsystem, system administrators
-should exercise caution when granting access to this driver. If used
+should exercise caution when granting access to this driver.
+If used
improperly, this driver can allow userland applications to crash a machine
or cause data loss.
.Sh KERNEL CONFIGURATION
There is no kernel configuration required for the
.Nm
-driver. It is enabled when
+driver.
+It is enabled when
.Tn SCSI
-support is enabled in the kernel. There is one instance of the xpt driver
-per CAM transport layer instance. Since there is currently only one CAM
+support is enabled in the kernel.
+There is one instance of the xpt driver
+per CAM transport layer instance.
+Since there is currently only one CAM
transport layer, there will only be one instance of this driver.
.Sh IOCTLS
.Bl -tag -width 01234567890123
.It CAMIOCOMMAND
This ioctl takes certain kinds of CAM CCBs and passes them through to the
-CAM transport layer for action. Only the following CCB types are
+CAM transport layer for action.
+Only the following CCB types are
supported:
.Pp
.Bl -tag -width XPT_DEV_MATCH -compact
diff --git a/share/man/man5/a.out.5 b/share/man/man5/a.out.5
index ac186d5..e816a57 100644
--- a/share/man/man5/a.out.5
+++ b/share/man/man5/a.out.5
@@ -129,7 +129,7 @@ if necessary.
.El
.Pp
If both EX_DYNAMIC and EX_PIC are set, the object file is a position independent
-executable image (eg. a shared library), which is to be loaded into the
+executable image (e.g.\& a shared library), which is to be loaded into the
process address space by the run-time link editor.
.Pp
The macro
diff --git a/share/man/man5/devfs.5 b/share/man/man5/devfs.5
index 2d88204..173ab19 100644
--- a/share/man/man5/devfs.5
+++ b/share/man/man5/devfs.5
@@ -57,7 +57,8 @@ The conventional mount point is
.Pa /dev .
.Pp
The file system includes several directories, links, symbolic links
-and devices, some of which can also be written. In a chroot'ed
+and devices, some of which can also be written.
+In a chroot'ed
environment,
.Nm
can be used to create a new
diff --git a/share/man/man5/disktab.5 b/share/man/man5/disktab.5
index ab9bef8..cf33790 100644
--- a/share/man/man5/disktab.5
+++ b/share/man/man5/disktab.5
@@ -52,11 +52,14 @@ to initialize the disk label on the disk.
The format is patterned
after the
.Xr termcap 5
-terminal data base. Entries in
+terminal data base.
+Entries in
.Nm
-consist of a number of `:'-separated fields. The
+consist of a number of `:'-separated fields.
+The
first field for each entry gives the names by which a
-disk's entry may be selected, separated by `|' characters. The
+disk's entry may be selected, separated by `|' characters.
+The
last name given should be a long name fully identifying
the disk.
.Pp
diff --git a/share/man/man5/elf.5 b/share/man/man5/elf.5
index 01792c4..5f52875 100644
--- a/share/man/man5/elf.5
+++ b/share/man/man5/elf.5
@@ -351,7 +351,8 @@ file has no section header table this member holds zero.
.It Dv e_flags
This member holds processor-specific flags associated with the file.
Flag
-names take the form EF_`machine_flag'. Currently no flags have been defined.
+names take the form EF_`machine_flag'.
+Currently no flags have been defined.
.It Dv e_ehsize
This member holds the ELF header's size in bytes.
.It Dv e_phentsize
@@ -475,7 +476,8 @@ The array element specifies dynamic linking information.
The array element specifies the location and size of a null-terminated
path name to invoke as an interpreter.
This segment type is meaningful
-only for executable files (though it may occur for shared objects). However
+only for executable files (though it may occur for shared objects).
+However
it may not occur more than once in a file.
If it is present it must precede
any loadable segment entry.
diff --git a/share/man/man5/forward.5 b/share/man/man5/forward.5
index b6d0e46..2234ff3 100644
--- a/share/man/man5/forward.5
+++ b/share/man/man5/forward.5
@@ -41,13 +41,16 @@
The
.Nm .forward
file contains a list of mail addresses or programs
-that the user's mail should be redirected to. If the
+that the user's mail should be redirected to.
+If the
file is not present, then no mail forwarding will be done.
Mail may also be forwarded as the standard input to a program
by prefixing the line
-with the normal shell pipe symbol (|). If arguments
+with the normal shell pipe symbol (|).
+If arguments
are to be passed to the command, then the entire line
-should be enclosed in quotes. For security reasons, the
+should be enclosed in quotes.
+For security reasons, the
.Nm .forward
file must be owned by the user the mail is being sent to,
or by root, and the user's shell must be listed in
diff --git a/share/man/man5/fs.5 b/share/man/man5/fs.5
index 48b4c1b..368f11c 100644
--- a/share/man/man5/fs.5
+++ b/share/man/man5/fs.5
@@ -203,15 +203,18 @@ A file system consists of a number of cylinder groups.
Each cylinder group has inodes and data.
.Pp
A file system is described by its super-block, which in turn
-describes the cylinder groups. The super-block is critical
+describes the cylinder groups.
+The super-block is critical
data and is replicated in each cylinder group to protect against
-catastrophic loss. This is done at file system creation
+catastrophic loss.
+This is done at file system creation
time and the critical
super-block data does not change, so the copies need not be
referenced further unless disaster strikes.
.Pp
Addresses stored in inodes are capable of addressing fragments
-of `blocks'. File system blocks of at most size
+of `blocks'.
+File system blocks of at most size
.Dv MAXBSIZE
can
be optionally broken into 2, 4, or 8 pieces, each of which is
@@ -222,12 +225,15 @@ a
.Dv DEV_BSIZE
unit.
.Pp
-Large files consist of exclusively large data blocks. To avoid
+Large files consist of exclusively large data blocks.
+To avoid
undue wasted disk space, the last data block of a small file is
allocated as only as many fragments of a large block as are
-necessary. The file system format retains only a single pointer
+necessary.
+The file system format retains only a single pointer
to such a fragment, which is a piece of a single large block that
-has been divided. The size of such a fragment is determinable from
+has been divided.
+The size of such a fragment is determinable from
information in the inode, using the
.Fn blksize fs ip lbn
macro.
diff --git a/share/man/man5/fstab.5 b/share/man/man5/fstab.5
index e2a90ad..7e8f10c 100644
--- a/share/man/man5/fstab.5
+++ b/share/man/man5/fstab.5
@@ -86,8 +86,10 @@ The system can support various file system types.
Only the root, /usr, and /tmp file systems need be statically
compiled into the kernel;
everything else will be automatically loaded at mount
-time. (Exception: the UFS family - FFS and LFS cannot
-currently be demand-loaded.) Some people still prefer to statically
+time.
+(Exception: the UFS family - FFS and LFS cannot
+currently be demand-loaded.)
+Some people still prefer to statically
compile other file systems as well.
.Pp
The fourth field,
@@ -97,7 +99,8 @@ It is formatted as a comma separated list of options.
It contains at least the type of mount (see
.Fa fs_type
below) plus any additional options
-appropriate to the file system type. See the options flag
+appropriate to the file system type.
+See the options flag
.Pq Fl o
in the
.Xr mount 8
@@ -131,7 +134,7 @@ If the option ``noauto'' is specified, the file system will not be automatically
mounted at system startup.
Note that, for network file systems
of third party types
-(i.e. types supported by additional software
+(i.e., types supported by additional software
not included in the base system)
to be automatically mounted at system startup,
the
diff --git a/share/man/man5/hosts.5 b/share/man/man5/hosts.5
index 79b20c3..218a4df 100644
--- a/share/man/man5/hosts.5
+++ b/share/man/man5/hosts.5
@@ -55,7 +55,8 @@ aliases
.Ed
.Pp
Items are separated by any number of blanks and/or
-tab characters. A ``#'' indicates the beginning of
+tab characters.
+A ``#'' indicates the beginning of
a comment; characters up to the end of the line are
not interpreted by routines which search the file.
.Pp
@@ -75,7 +76,8 @@ Center
.Pq Tn NIC ,
though local changes may be required
to bring it up to date regarding unofficial aliases
-and/or unknown hosts. As the data base maintained at
+and/or unknown hosts.
+As the data base maintained at
.Tn NIC
is incomplete, use of the name server is recommended for
sites on the
diff --git a/share/man/man5/hosts.equiv.5 b/share/man/man5/hosts.equiv.5
index e824e51..c180d2a 100644
--- a/share/man/man5/hosts.equiv.5
+++ b/share/man/man5/hosts.equiv.5
@@ -63,7 +63,8 @@ A
indicates a host by netgroup or user by netgroup.
A single
.Dq +
-matches all hosts or users. A host name with a leading
+matches all hosts or users.
+A host name with a leading
.Dq -
will reject
all matching hosts and all their users.
@@ -72,7 +73,8 @@ A user name with leading
will reject all matching users from matching hosts.
.Pp
Items are separated by any number of blanks and/or
-tab characters. A
+tab characters.
+A
.Dq #
indicates the beginning of
a comment; characters up to the end of the line are
diff --git a/share/man/man5/link.5 b/share/man/man5/link.5
index 8d443d8..73f0a45 100644
--- a/share/man/man5/link.5
+++ b/share/man/man5/link.5
@@ -180,7 +180,8 @@ struct section_dispatch_table {
.Pp
.Bl -tag -width sdt_filler1
.It Fa sdt_loaded
-A pointer to the first link map loaded (see below). This field is set by
+A pointer to the first link map loaded (see below).
+This field is set by
.Nm ld.so
.It Fa sdt_sods
The start of a (linked) list of shared object descriptors needed by
diff --git a/share/man/man5/mailer.conf.5 b/share/man/man5/mailer.conf.5
index b6971da..87c1249 100644
--- a/share/man/man5/mailer.conf.5
+++ b/share/man/man5/mailer.conf.5
@@ -41,7 +41,8 @@
.Sh DESCRIPTION
The file
.Pa /etc/mail/mailer.conf
-contains a series of pairs. The first member of each pair is the name
+contains a series of pairs.
+The first member of each pair is the name
of a program invoking
.Xr mailwrapper 8
which is typically a symbolic link to
@@ -52,7 +53,8 @@ and
.Xr mailq 1
would be set up this way.)
The second member of each pair is the name of the program to
-actually execute when the first name is invoked. The file may also
+actually execute when the first name is invoked.
+The file may also
contain comments, denoted by a # mark in the first column of any line.
.Sh EXAMPLES
The following is an example of how to set up an
@@ -88,9 +90,10 @@ newaliases /usr/local/sbin/sendmail
appeared in
.Nx 1.4 .
.Sh AUTHORS
-Perry E. Metzger <perry@piermont.com>
+.An Perry E. Metzger Aq perry@piermont.com
.Sh BUGS
-The entire reason this program exists is a crock. Instead, a command
+The entire reason this program exists is a crock.
+Instead, a command
for how to submit mail should be standardized, and all the "behave
differently if invoked with a different name" behavior of things like
.Xr mailq 1
diff --git a/share/man/man5/networks.5 b/share/man/man5/networks.5
index 04ec15b..ff62267 100644
--- a/share/man/man5/networks.5
+++ b/share/man/man5/networks.5
@@ -63,7 +63,7 @@ changes may be required to bring it up to date regarding unofficial aliases
and/or unknown networks.
.Pp
Network numbers may be specified in the conventional
-``.'' (dot) notation using the
+``.'' (dot) notation using the
.Xr inet_network 3
routine
from the Internet address manipulation library,
diff --git a/share/man/man5/passwd.5 b/share/man/man5/passwd.5
index e1a4ac3..9476ec0 100644
--- a/share/man/man5/passwd.5
+++ b/share/man/man5/passwd.5
@@ -65,7 +65,8 @@ The
.Nm master.passwd
file is readable only by root, and consists of newline separated
records, one per user, containing ten colon (``:'') separated
-fields. These fields are as follows:
+fields.
+These fields are as follows:
.Pp
.Bl -tag -width password -offset indent
.It name
@@ -105,18 +106,21 @@ The
.Ar name
field is the login used to access the computer account, and the
.Ar uid
-field is the number associated with it. They should both be unique
+field is the number associated with it.
+They should both be unique
across the system (and often across a group of systems) since they
control file access.
.Pp
While it is possible to have multiple entries with identical login names
-and/or identical user id's, it is usually a mistake to do so. Routines
+and/or identical user id's, it is usually a mistake to do so.
+Routines
that manipulate these files will often return only one of the multiple
entries, and that one by random selection.
.Pp
The login name must never begin with a hyphen (``-''); also, it is strongly
suggested that neither upper-case characters or dots (``.'') be part
-of the name, as this tends to confuse mailers. No field may contain a
+of the name, as this tends to confuse mailers.
+No field may contain a
colon (``:'') as this has been used historically to separate the fields
in the user database.
.Pp
@@ -126,7 +130,8 @@ form of the password.
If the
.Ar password
field is empty, no password will be required to gain access to the
-machine. This is almost invariably a mistake.
+machine.
+This is almost invariably a mistake.
Because these files contain the encrypted user passwords, they should
not be readable by anyone without appropriate privileges.
.Pp
@@ -137,7 +142,8 @@ this field currently has little special meaning.
.Pp
The
.Ar class
-field is a key for a user's login class. Login classes
+field is a key for a user's login class.
+Login classes
are defined in
.Xr login.conf 5 ,
which is a
@@ -280,7 +286,8 @@ or
fields, the specified numbers will override the information retrieved
from the Hesiod domain or the
.Tn NIS
-maps. As well, if the
+maps.
+As well, if the
.Ar gecos ,
.Ar dir
or
diff --git a/share/man/man5/pbm.5 b/share/man/man5/pbm.5
index 228315b..55d2c5c 100644
--- a/share/man/man5/pbm.5
+++ b/share/man/man5/pbm.5
@@ -62,7 +62,8 @@ Programs that read this format should be as lenient as possible,
accepting anything that looks remotely like a bitmap.
.Pp
There is also a variant on the format, available
-by setting the RAWBITS option at compile time. This variant is
+by setting the RAWBITS option at compile time.
+This variant is
different in the following ways:
.Pp
.Bl -bullet -compact
diff --git a/share/man/man5/phones.5 b/share/man/man5/phones.5
index f3360c3..59b491b 100644
--- a/share/man/man5/phones.5
+++ b/share/man/man5/phones.5
@@ -44,22 +44,27 @@ The file
contains the system-wide
private phone numbers for the
.Xr tip 1
-program. This file is normally unreadable, and so may contain
-privileged information. The format of the file is a series of lines
-of the form: <system-name>[\ \et]*<phone-number>. The system name is
+program.
+This file is normally unreadable, and so may contain
+privileged information.
+The format of the file is a series of lines
+of the form: <system-name>[\ \et]*<phone-number>.
+The system name is
one of those defined in the
.Xr remote 5
file and the phone number is constructed from any sequence of
characters terminated only by ``,'' or the end of the line.
The ``='' and ``*'' characters are
indicators to the auto call units to pause and wait for a second dial
-tone (when going through an exchange). The ``='' is required by the
+tone (when going through an exchange).
+The ``='' is required by the
.Tn DF02-AC
and the ``*'' is required by the
.Tn BIZCOMP
1030.
.Pp
-Only one phone number per line is permitted. However, if more than
+Only one phone number per line is permitted.
+However, if more than
one line in the file contains the same system name
.Xr tip 1
will attempt to dial each one in turn, until it establishes a connection.
diff --git a/share/man/man5/procfs.5 b/share/man/man5/procfs.5
index 169421e..47f5f9a 100644
--- a/share/man/man5/procfs.5
+++ b/share/man/man5/procfs.5
@@ -30,7 +30,8 @@ provides a two-level view of process space, unlike the previous
.Nm
implementation.
At the highest level, processes themselves are named, according to
-their process ids in decimal, with no leading zeros. There is also a
+their process ids in decimal, with no leading zeros.
+There is also a
special node called
.Pa curproc
which always refers to the process making the lookup request.
@@ -107,9 +108,11 @@ Only those address which exist in the process can be accessed.
Reads and writes to this file modify the process.
Writes to the text segment remain private to the process.
.It Pa note
-Used for sending signals to the process. Not implemented.
+Used for sending signals to the process.
+Not implemented.
.It Pa notepg
-Used for sending signal to the process group. Not implemented.
+Used for sending signal to the process group.
+Not implemented.
.It Pa regs
Allows read and write access to the process' register set.
This file contains a binary data structure
diff --git a/share/man/man5/protocols.5 b/share/man/man5/protocols.5
index a8ad7a4..fb9577e 100644
--- a/share/man/man5/protocols.5
+++ b/share/man/man5/protocols.5
@@ -43,7 +43,8 @@ The
.Nm
file contains information regarding the known protocols used in the
.Tn DARPA
-Internet. For each protocol a single line should be present
+Internet.
+For each protocol a single line should be present
with the following information:
.Bd -unfilled -offset indent
official protocol name
@@ -52,7 +53,8 @@ aliases
.Ed
.Pp
Items are separated by any number of blanks and/or
-tab characters. A ``#'' indicates the beginning of
+tab characters.
+A ``#'' indicates the beginning of
a comment; characters up to the end of the line are
not interpreted by routines which search the file.
.Pp
diff --git a/share/man/man5/rc.conf.5 b/share/man/man5/rc.conf.5
index eb999e9..6aa9820 100644
--- a/share/man/man5/rc.conf.5
+++ b/share/man/man5/rc.conf.5
@@ -1728,7 +1728,7 @@ operation.
.Pq Vt bool
If set to
.Dq Li YES ,
-configure host to act as an IP router, e.g. to forward packets
+configure host to act as an IP router, e.g.\& to forward packets
between interfaces.
.It Va ipv6_gateway_enable
.Pq Vt bool
@@ -2227,7 +2227,7 @@ Microsoft mouse (serial)
.It Li intellimouse
Microsoft IntelliMouse (serial)
.It Li mousesystems
-Mouse systems Corp. mouse (serial)
+Mouse systems Corp.\& mouse (serial)
.It Li mmseries
MM Series mouse (serial)
.It Li logitech
diff --git a/share/man/man5/remote.5 b/share/man/man5/remote.5
index e50f1f3..edc3e17 100644
--- a/share/man/man5/remote.5
+++ b/share/man/man5/remote.5
@@ -77,7 +77,8 @@ When the
interface is used, entries of the form ``cu300'' are used.
.Sh CAPABILITIES
Capabilities are either strings (str), numbers (num), or boolean
-flags (bool). A string capability is specified by
+flags (bool).
+A string capability is specified by
.Em capability Ns Ar = Ns Em value ;
for example, ``dv=/dev/harris''.
A numeric capability is specified by
diff --git a/share/man/man5/services.5 b/share/man/man5/services.5
index 18e3ed8..738573dd5 100644
--- a/share/man/man5/services.5
+++ b/share/man/man5/services.5
@@ -57,7 +57,7 @@ Items are separated by any number of blanks and/or tab characters.
The port number and protocol name are considered a single
.Em item ;
a ``/'' is used to
-separate the port and protocol (e.g. ``512/tcp'').
+separate the port and protocol (e.g.\& ``512/tcp'').
A ``#'' indicates the beginning of
a comment; subsequent characters up to the end of the line are
not interpreted by the routines which search the file.
diff --git a/share/man/man5/stab.5 b/share/man/man5/stab.5
index 14eeef5..397a58b 100644
--- a/share/man/man5/stab.5
+++ b/share/man/man5/stab.5
@@ -46,7 +46,7 @@ The file
defines some of the symbol table
.Fa n_type
field values for a.out files.
-These are the types for permanent symbols (i.e. not local labels, etc.)
+These are the types for permanent symbols (i.e., not local labels, etc.)
used by the old debugger
.Em sdb
and the Berkeley Pascal compiler
diff --git a/share/man/man5/sysctl.conf.5 b/share/man/man5/sysctl.conf.5
index d302d6b..0e69bcc 100644
--- a/share/man/man5/sysctl.conf.5
+++ b/share/man/man5/sysctl.conf.5
@@ -34,7 +34,8 @@
The
.Pa /etc/sysctl.conf
file is read in when the system goes into multi-user mode to set default
-settings for the kernel. The
+settings for the kernel.
+The
.Pa /etc/sysctl.conf
is in the format of the
.Xr sysctl 8
@@ -45,7 +46,8 @@ sysctl_mib=value
.Pp
Comments are denoted by a
.Dq #
-at the beginning of a line. Comments can also exist at the end of a line,
+at the beginning of a line.
+Comments can also exist at the end of a line,
as seen in the
.Sx EXAMPLES
section, below.
diff --git a/share/man/man7/development.7 b/share/man/man7/development.7
index 4f03342..9986d09 100644
--- a/share/man/man7/development.7
+++ b/share/man/man7/development.7
@@ -30,8 +30,10 @@ conveniently.
.Sh SETTING UP THE ENVIRONMENT ON THE MASTER SERVER
Your master server should always run a stable, production version of the
.Fx
-operating system. This does not prevent you from doing -CURRENT
-builds or development. The last thing you want to do is to run an
+operating system.
+This does not prevent you from doing -CURRENT
+builds or development.
+The last thing you want to do is to run an
unstable environment on your master server which could lead to a situation
where you lose the environment and/or cannot recover from a mistake.
.Pp
@@ -52,7 +54,8 @@ in
or you can make
.Pa /usr/obj
its own partition.
-I recommend making it a separate partition for several reasons. First,
+I recommend making it a separate partition for several reasons.
+First,
as a safety measure since this partition is written to a great deal.
Second, because you typically do not have to back it up.
Third, because it makes it far easier to mix and match the development
@@ -64,7 +67,8 @@ partition of at least 5GB.
On the master server, use cvsup to automatically pull down and maintain
the
.Fx
-CVS archive once a day. The first pull will take a long time,
+CVS archive once a day.
+The first pull will take a long time,
it is several gigabytes, but once you have it the daily syncs will be quite
small.
.Bd -literal -offset 4n
@@ -82,7 +86,8 @@ to cvsup.
33 6 * * * /usr/local/bin/cvsup -g -r 20 -L 2 -h cvsup.freebsd.org /usr/share/examples/cvsup/cvs-supfile
.Ed
.Pp
-Run the cvsup manually the first time to pull down the archive. It could take
+Run the cvsup manually the first time to pull down the archive.
+It could take
all day depending on how fast your connection is!
You will run all cvsup and cvs operations as root and you need to set
up a ~/.cvsrc (/root/.cvsrc) file, as shown below, for proper cvs operation.
@@ -116,7 +121,8 @@ cvs -d /home/ncvs checkout doc
.Pp
Now create a softlink for /usr/src and /usr/src2.
On the main server I always point /usr/src at -STABLE and /usr/src2 at
--CURRENT. On client machines I usually do not have a /usr/src2 and I make
+-CURRENT.
+On client machines I usually do not have a /usr/src2 and I make
/usr/src point at whatever version of FreeBSD the client box is intended to
run.
.Bd -literal -offset 4n
@@ -127,7 +133,8 @@ ln -s /FreeBSD/FreeBSD-current/src src2 (MASTER SERVER ONLY)
.Ed
.Pp
Now you have to make a choice for /usr/obj.
-Well, hopefully you made it already and chose the partition method. If you
+Well, hopefully you made it already and chose the partition method.
+If you
chose poorly you probably intend to put it in /FreeBSD and, if so, this is
what you want to do:
.Bd -literal -offset 4n
@@ -138,7 +145,8 @@ rm -rf obj
ln -s /FreeBSD/obj obj
.Ed
.Pp
-Alternatively you may chose simply to leave /usr/obj in /usr. If your
+Alternatively you may chose simply to leave /usr/obj in /usr.
+If your
/usr is large enough this will work, but I do not recommend it for
safety reasons (/usr/obj is constantly being modified, /usr is not).
.Pp
@@ -157,7 +165,8 @@ to check it out (see above).
With some fancy softlinks you can make the ports tree available both on your
master server and on all of your other machines.
Note that the ports tree exists only on the HEAD cvs branch, so its always
--CURRENT even on a -STABLE box. This is what you do:
+-CURRENT even on a -STABLE box.
+This is what you do:
.Bd -literal -offset 4n
(THESE COMMANDS ON THE MASTER SERVER AND ON ALL CLIENTS)
cd /usr
@@ -228,7 +237,8 @@ into the NFS-mounted environment.
If a particular client is running -CURRENT, /usr/src
should be a softlink to /FreeBSD/FreeBSD-current/src.
If it is running -STABLE, /usr/src should be a softlink to
-/FreeBSD/FreeBSD-4.x/src. I do not usually create a /usr/src2 softlink on
+/FreeBSD/FreeBSD-4.x/src.
+I do not usually create a /usr/src2 softlink on
clients, that is used as a convenient shortcut when working on the source
code on the master server only and could create massive confusion (of the
human variety) on a client.
@@ -305,7 +315,8 @@ make buildworld
.Pp
If you are on the master server you are running in a -STABLE environment, but
that does not prevent you from building the -CURRENT world.
-Just cd into the appropriate source directory and you are set. Do not
+Just cd into the appropriate source directory and you are set.
+Do not
accidentally install it on your master server though!
.Bd -literal -offset 4n
cd /usr/src2
@@ -393,7 +404,8 @@ version of CVS examines a custom environmental variable,
CVS_LOCAL_BRANCH_NUM, which specifies an integer to use when doing a cvs
tag/rtag.
Set this number to something high (say 1000) to avoid colliding
-with potential future branches of the main repository. For example,
+with potential future branches of the main repository.
+For example,
branching a file with version 1.4 produces 1.4.1000.
Future commits to this branch will produce revisions 1.4.1000.1,
1.4.1000.2, etc.
@@ -448,7 +460,8 @@ This is a good time to also remind you that most of the cvs operations
you do will be done as root, and that certain options are
required for CVS to operate properly on the
.Fx
-repository. For example,
+repository.
+For example,
.Fl Pd
is necessary when running "cvs update".
These options are typically placed in your ~/.cvsrc (as already described)
@@ -462,7 +475,7 @@ If you can make it 15GB I would do it.
I generally do not cvs update via a cron job.
This is because I generally want the source to not change out from under me
when I am developing code.
-Instead I manually update the source every so often... when I feel it is
+Instead I manually update the source every so often...\& when I feel it is
a good time.
My recommendation is to only keep the cvs repository synchronized via cron.
.Sh SEE ALSO
diff --git a/share/man/man7/environ.7 b/share/man/man7/environ.7
index 4fc29b6..d4987a6 100644
--- a/share/man/man7/environ.7
+++ b/share/man/man7/environ.7
@@ -44,8 +44,9 @@
An array of strings called the
.Ar environment
is made available by
-.Xr execve 2
-when a process begins. By convention these strings have the form
+.Xr execve 2
+when a process begins.
+By convention these strings have the form
.Dq Ar name=value .
The following names are used by various commands:
.Bl -tag -width LC_MONETARY
@@ -76,14 +77,14 @@ call to ask the terminal driver for the width.
Default editor name.
.It Ev EXINIT
A startup list of commands read by
-.Xr ex 1
+.Xr ex 1
and
-.Xr vi 1 .
+.Xr vi 1 .
.It Ev HOME
A user's login directory, set by
-.Xr login 1
+.Xr login 1
from the password file
-.Xr passwd 5 .
+.Xr passwd 5 .
.It Ev LANG
This variable configures all programs which use
.Xr setlocale 3
@@ -121,7 +122,7 @@ for formatting output.
The location of the user's
mailbox instead of the default in /var/mail,
used by
-.Xr mail 1 ,
+.Xr mail 1 ,
.Xr sh 1 ,
and many other mailclients.
.It Ev NLSPATH
@@ -130,27 +131,28 @@ List of directories to be searched for the message catalog referred to by
See
.Xr catopen 3 .
.It Ev PAGER
-Default paginator program. The program specified by this variable is used by
+Default paginator program.
+The program specified by this variable is used by
.Xr mail 1 ,
.Xr man 1 ,
.Xr ftp 1 ,
etc, to display information which is longer than the current display.
.It Ev PATH
The sequence of directories, separated by colons, searched by
-.Xr csh 1 ,
-.Xr sh 1 ,
-.Xr system 3 ,
-.Xr execvp 3 ,
+.Xr csh 1 ,
+.Xr sh 1 ,
+.Xr system 3 ,
+.Xr execvp 3 ,
etc, when looking for an executable file.
.Ev PATH
is set to ``/usr/bin:/bin'' initially by
-.Xr login 1 .
+.Xr login 1 .
.It Ev PRINTER
The name of the default printer to be used by
-.Xr lpr 1 ,
-.Xr lpq 1 ,
+.Xr lpr 1 ,
+.Xr lpq 1 ,
and
-.Xr lprm 1 .
+.Xr lprm 1 .
.It Ev PWD
The current directory pathname.
.It Ev SHELL
@@ -158,10 +160,11 @@ The full pathname of the user's login shell.
.It Ev TERM
The kind of terminal for which output is to be prepared.
This information is used by commands, such as
-.Xr nroff 1
+.Xr nroff 1
or
.Xr plot 1
-which may exploit special terminal capabilities. See
+which may exploit special terminal capabilities.
+See
.Pa /usr/share/misc/termcap
.Pq Xr termcap 5
for a list of terminal types.
@@ -173,10 +176,11 @@ it begins with a '/', the name of the termcap file.
See
.Ev TERMPATH
below, and
-.Xr termcap 5 .
+.Xr termcap 5 .
.It Ev TERMPATH
A sequence of pathnames of termcap files, separated by colons or spaces,
-which are searched for terminal descriptions in the order listed. Having
+which are searched for terminal descriptions in the order listed.
+Having
no
.Ev TERMPATH
is equivalent to a
@@ -213,13 +217,13 @@ Further names may be placed in the environment by the
command and
.Ar name=value
arguments in
-.Xr sh 1 ,
+.Xr sh 1 ,
or by the
.Ic setenv
command if you use
-.Xr csh 1 .
+.Xr csh 1 .
It is unwise to change certain
-.Xr sh 1
+.Xr sh 1
variables that are frequently exported by
.Pa .profile
files, such as
diff --git a/share/man/man7/firewall.7 b/share/man/man7/firewall.7
index ecb38b7..c78b699 100644
--- a/share/man/man7/firewall.7
+++ b/share/man/man7/firewall.7
@@ -13,7 +13,8 @@
.Sh FIREWALL BASICS
A Firewall is most commonly used to protect an internal network
from an outside network by preventing the outside network from
-making arbitrary connections into the internal network. Firewalls
+making arbitrary connections into the internal network.
+Firewalls
are also used to prevent outside entities from spoofing internal
IP addresses and to isolate services such as NFS or SMBFS (Windows
file sharing) within LAN segments.
@@ -23,11 +24,13 @@ The
firewalling system also has the capability to limit bandwidth using
.Xr dummynet 4 .
This feature can be useful when you need to guarantee a certain
-amount of bandwidth for a critical purpose. For example, if you
+amount of bandwidth for a critical purpose.
+For example, if you
are doing video conferencing over the Internet via your
office T1 (1.5 MBits/s), you may wish to bandwidth-limit all other
T1 traffic to 1 MBit/s in order to reserve at least 0.5 MBits
-for your video conferencing connections. Similarly if you are
+for your video conferencing connections.
+Similarly if you are
running a popular web or ftp site from a colocation facility
you might want to limit bandwidth to prevent excessive bandwidth
charges from your provider.
@@ -42,22 +45,29 @@ a private IP space to make connections to the outside for browsing
or other purposes.
.Pp
Constructing a firewall may appear to be trivial, but most people
-get them wrong. The most common mistake is to create an exclusive
-firewall rather than an inclusive firewall. An exclusive firewall
+get them wrong.
+The most common mistake is to create an exclusive
+firewall rather than an inclusive firewall.
+An exclusive firewall
allows all packets through except for those matching a set of rules.
An inclusive firewall allows only packets matching the ruleset
-through. Inclusive firewalls are much, much safer than exclusive
-firewalls but a tad more difficult to build properly. The
+through.
+Inclusive firewalls are much, much safer than exclusive
+firewalls but a tad more difficult to build properly.
+The
second most common mistake is to blackhole everything except the
-particular port you want to let through. TCP/IP needs to be able
+particular port you want to let through.
+TCP/IP needs to be able
to get certain types of ICMP errors to function properly - for
-example, to implement MTU discovery. Also, a number of common
+example, to implement MTU discovery.
+Also, a number of common
system daemons make reverse connections to the
.Sy auth
service in an attempt to authenticate the user making a connection.
Auth is rather dangerous but the proper implementation is to return
a TCP reset for the connection attempt rather than simply blackholing
-the packet. We cover these and other quirks involved with constructing
+the packet.
+We cover these and other quirks involved with constructing
a firewall in the sample firewall section below.
.Sh IPFW KERNEL CONFIGURATION
You do not need to create a custom kernel to use the IP firewalling features.
@@ -70,15 +80,18 @@ if you are paranoid you can compile IPFW directly into the
.Fx
kernel by using the
.Sy IPFIREWALL
-option set. If compiled in the kernel, ipfw denies all
+option set.
+If compiled in the kernel, ipfw denies all
packets by default, which means that, if you do not load in
a permissive ruleset via
.Em /etc/rc.conf ,
rebooting into your new kernel will take the network offline.
This can prevent you from being able to access your system if you
-are not sitting at the console. It is also quite common to
+are not sitting at the console.
+It is also quite common to
update a kernel to a new release and reboot before updating
-the binaries. This can result in an incompatibility between
+the binaries.
+This can result in an incompatibility between
the
.Xr ipfw 8
program and the kernel which prevents it from running in the
@@ -86,13 +99,17 @@ boot sequence, also resulting in an inaccessible machine.
Because of these problems the
.Sy IPFIREWALL_DEFAULT_TO_ACCEPT
kernel option is also available which changes the default firewall
-to pass through all packets. Note, however, that using this option
+to pass through all packets.
+Note, however, that using this option
may open a small window of opportunity during booting where your
-firewall passes all packets. Still, it's a good option to use
+firewall passes all packets.
+Still, it's a good option to use
while getting up to speed with
.Fx
-firewalling. Get rid of it once you understand how it all works
-to close the loophole, though. There is a third option called
+firewalling.
+Get rid of it once you understand how it all works
+to close the loophole, though.
+There is a third option called
.Sy IPDIVERT
which allows you to use the firewall to divert packets to a user program
and is necessary if you wish to use
@@ -106,42 +123,54 @@ option must be used to enable
rules.
.Sh SAMPLE IPFW-BASED FIREWALL
Here is an example ipfw-based firewall taken from a machine with three
-interface cards. fxp0 is connected to the 'exposed' LAN. Machines
-on this LAN are dual-homed with both internal 10. IP addresses and
-Internet-routed IP addresses. In our example, 192.100.5.x represents
+interface cards.
+fxp0 is connected to the 'exposed' LAN.
+Machines
+on this LAN are dual-homed with both internal 10.\& IP addresses and
+Internet-routed IP addresses.
+In our example, 192.100.5.x represents
the Internet-routed IP block while 10.x.x.x represents the internal
-networks. While it isn't relevant to the example, 10.0.1.x is
+networks.
+While it isn't relevant to the example, 10.0.1.x is
assigned as the internal address block for the LAN on fxp0, 10.0.2.x
for the LAN on fxp1, and 10.0.3.x for the LAN on fxp2.
.Pp
In this example we want to isolate all three LANs from the Internet
as well as isolate them from each other, and we want to give all
internal addresses access to the Internet through a NAT gateway running
-on this machine. To make the NAT gateway work, the firewall machine
+on this machine.
+To make the NAT gateway work, the firewall machine
is given two Internet-exposed addresses on fxp0 in addition to an
-internal 10. address on fxp0: one exposed address (not shown)
+internal 10.\& address on fxp0: one exposed address (not shown)
represents the machine's official address, and the second exposed
address (192.100.5.5 in our example) represents the NAT gateway
-rendezvous IP. We make the example more complex by giving the machines
+rendezvous IP.
+We make the example more complex by giving the machines
on the exposed LAN internal 10.0.0.x addresses as well as exposed
-addresses. The idea here is that you can bind internal services
+addresses.
+The idea here is that you can bind internal services
to internal addresses even on exposed machines and still protect
-those services from the Internet. The only services you run on
+those services from the Internet.
+The only services you run on
exposed IP addresses would be the ones you wish to expose to the
Internet.
.Pp
It is important to note that the 10.0.0.x network in our example
-is not protected by our firewall. You must make sure that your
+is not protected by our firewall.
+You must make sure that your
Internet router protects this network from outside spoofing.
Also, in our example, we pretty much give the exposed hosts free
reign on our internal network when operating services through
-internal IP addresses (10.0.0.x). This is somewhat of security
-risk... what if an exposed host is compromised? To remove the
+internal IP addresses (10.0.0.x).
+This is somewhat of security
+risk: what if an exposed host is compromised?
+To remove the
risk and force everything coming in via LAN0 to go through
the firewall, remove rules 01010 and 01011.
.Pp
Finally, note that the use of internal addresses represents a
-big piece of our firewall protection mechanism. With proper
+big piece of our firewall protection mechanism.
+With proper
spoofing safeguards in place, nothing outside can directly
access an internal (LAN1 or LAN2) host.
.Bd -literal
@@ -337,19 +366,26 @@ add 06000 deny all from any to any
.Ed
.Sh PORT BINDING INTERNAL AND EXTERNAL SERVICES
We've mentioned multi-homing hosts and binding services to internal or
-external addresses but we haven't really explained it. When you have a
+external addresses but we haven't really explained it.
+When you have a
host with multiple IP addresses assigned to it, you can bind services run
-on that host to specific IPs or interfaces rather than all IPs. Take
-the firewall machine for example: With three interfaces
+on that host to specific IPs or interfaces rather than all IPs.
+Take
+the firewall machine for example: with three interfaces
and two exposed IP addresses
on one of those interfaces, the firewall machine is known by 5 different
IP addresses (10.0.0.1, 10.0.1.1, 10.0.2.1, 192.100.5.5, and say
-192.100.5.1). If the firewall is providing file sharing services to the
+192.100.5.1).
+If the firewall is providing file sharing services to the
windows LAN segment (say it is LAN1), you can use samba's 'bind interfaces'
-directive to specifically bind it to just the LAN1 IP address. That
+directive to specifically bind it to just the LAN1 IP address.
+That
way the file sharing services will not be made available to other LAN
-segments. The same goes for NFS. If LAN2 has your UNIX engineering
-workstations, you can tell nfsd to bind specifically to 10.0.2.1. You
+segments.
+The same goes for NFS.
+If LAN2 has your UNIX engineering
+workstations, you can tell nfsd to bind specifically to 10.0.2.1.
+You
can specify how to bind virtually every service on the machine and you
can use a light
.Xr jail 8
diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7
index 5b5da5a..cd4a931 100644
--- a/share/man/man7/hier.7
+++ b/share/man/man7/hier.7
@@ -285,7 +285,7 @@ mail filter API
.It Pa machine/
machine-specific C include files
.It Pa net/
-misc network C include files
+miscellaneous network C include files
.It Pa netatalk/
Appletalk protocol
.It Pa netatm/
@@ -378,7 +378,7 @@ a.out backward compatibility libraries
.El
.Pp
.It Pa libdata/
-misc. utility data files
+miscellaneous utility data files
.Bl -tag -width Fl -compact
.It Pa gcc/
.Xr gcc 1
@@ -425,7 +425,8 @@ ports framework.
Within local/, the general layout sketched out by
.Nm
for /usr
-should be used. Exceptions are the man directory (directly under local/
+should be used.
+Exceptions are the man directory (directly under local/
rather than under local/share/), ports documentation (in share/doc/<port>/),
and /usr/local/etc (mimics /etc).
.It Pa obj/
@@ -529,7 +530,7 @@ macros for use with the me macro package;
see
.Xr me 7
.It Pa misc/
-misc system-wide ASCII text files
+miscellaneous system-wide ASCII text files
.Bl -tag -width Fl -compact
.It Pa fonts/
???
@@ -561,7 +562,9 @@ data files for security policies such as
.Xr sendmail 8
configuration files
.It Pa skel/
-example . (dot) files for new accounts
+example
+.Pa .\&
+(dot) files for new accounts
.It Pa snmp/
MIBs, example files and tree definitions for the SNMP daemon.
.Bl -tag -width Fl -compact
@@ -699,7 +702,7 @@ directory containing output spool files
.El
.Pp
.It Pa backups/
-misc. backup files
+miscellaneous backup files
.It Pa crash/
default directory to store kernel crash dumps; see
.Xr crash 8
@@ -717,19 +720,19 @@ see
.El
.Pp
.It Pa db/
-misc. automatically generated system-specific database files
+miscellaneous automatically generated system-specific database files
.It Pa empty/
empty directory for use by programs that need a specifically empty directory.
Used for instance by
.Xr sshd 8
for privilege separation.
.It Pa games/
-misc. game status and score files
+miscellaneous game status and score files
.It Pa heimdal/
kerberos server databases; see
.Xr kdc 8
.It Pa log/
-misc. system log files
+miscellaneous system log files
.Pp
.Bl -tag -width Fl -compact
.It Pa wtmp
@@ -780,7 +783,7 @@ see
and
.Xr ruptime 1
.It Pa spool/
-misc. printer and mail system spooling directories
+miscellaneous printer and mail system spooling directories
.Pp
.Bl -tag -width Fl -compact
.It Pa clientmqueue/
diff --git a/share/man/man7/hostname.7 b/share/man/man7/hostname.7
index 7722922..713a8b1 100644
--- a/share/man/man7/hostname.7
+++ b/share/man/man7/hostname.7
@@ -50,11 +50,11 @@ subdomain of the EDU subdomain of the Internet would be represented as
Hostnames are often used with network client and server programs,
which must generally translate the name to an address for use.
(This function is generally performed by the library routine
-.Xr gethostbyname 3 . )
+.Xr gethostbyname 3 . )
Hostnames are resolved by the Internet name resolver in the following
fashion.
.Pp
-If the name consists of a single component, i.e. contains no dot,
+If the name consists of a single component, i.e., contains no dot,
and if the environment variable
.Dq Ev HOSTALIASES
is set to the name of a file,
@@ -82,7 +82,7 @@ Lithium.CChem.EDU will not be tried, as there is only one component
remaining from the local domain.
The search path can be changed from the default
by a system-wide configuration file (see
-.Xr resolver 5 ) .
+.Xr resolver 5 ) .
.Sh SEE ALSO
.Xr gethostbyname 3 ,
.Xr resolver 5 ,
diff --git a/share/man/man7/maclabel.7 b/share/man/man7/maclabel.7
index 9f8cada..05c3654 100644
--- a/share/man/man7/maclabel.7
+++ b/share/man/man7/maclabel.7
@@ -93,6 +93,6 @@ MAC first appeared in
This software was contributed to the
.Fx
Project by NAI Labs, the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+Inc.\& under DARPA/SPAWAR contract N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
diff --git a/share/man/man7/mailaddr.7 b/share/man/man7/mailaddr.7
index 2f5b240..07370fb 100644
--- a/share/man/man7/mailaddr.7
+++ b/share/man/man7/mailaddr.7
@@ -40,11 +40,13 @@
.Nd mail addressing description
.Sh DESCRIPTION
Mail addresses are based on the Internet protocol listed at the end of this
-manual page. These addresses are in the general format
+manual page.
+These addresses are in the general format
.Pp
.Dl user@domain
.Pp
-where a domain is a hierarchical dot separated list of subdomains. For
+where a domain is a hierarchical dot separated list of subdomains.
+For
example, a valid address is:
.Pp
.Dl eric@CS.Berkeley.EDU
@@ -57,7 +59,8 @@ to CS over the Ethernet rather than going via the Berkeley Internet
gateway.
.Ss Abbreviation.
Under certain circumstances it may not be necessary to type the entire
-domain name. In general, anything following the first dot may be omitted
+domain name.
+In general, anything following the first dot may be omitted
if it is the same as the domain from which you are sending the message.
For example, a user on ``calder.berkeley.edu'' could send to ``eric@CS''
without adding the ``berkeley.edu'' since it is the same on both sending
@@ -65,7 +68,8 @@ and receiving hosts.
.Ss Compatibility.
.Pp
Certain old address formats are converted to the new format to provide
-compatibility with the previous mail system. In particular,
+compatibility with the previous mail system.
+In particular,
.Pp
.Dl user@host
.Pp
@@ -94,25 +98,30 @@ on for compatibility with older UUCP hosts.
.Ss Case Distinctions.
.Pp
Domain names (i.e., anything after the ``@'' sign) may be given in any mixture
-of upper and lower case with the exception of UUCP hostnames. Most hosts
+of upper and lower case with the exception of UUCP hostnames.
+Most hosts
accept any combination of case in user names, with the notable exception of
MULTICS sites.
.Ss Route-addrs.
.Pp
Under some circumstances it may be necessary to route a message through
-several hosts to get it to the final destination. Normally this routing
+several hosts to get it to the final destination.
+Normally this routing
is done automatically, but sometimes it is desirable to route the message
-manually. Addresses which show these relays are termed ``route-addrs.''
+manually.
+Addresses which show these relays are termed ``route-addrs.''
These use the syntax:
.Pp
.Dl <@hosta,@hostb:user@hostc>
.Pp
This specifies that the message should be sent to hosta, from there to hostb,
-and finally to hostc. This path is forced even if there is a more efficient
+and finally to hostc.
+This path is forced even if there is a more efficient
path to hostc.
.Pp
Route-addrs occur frequently on return addresses, since these are generally
-augmented by the software at each host. It is generally possible to ignore
+augmented by the software at each host.
+It is generally possible to ignore
all but the ``user@hostc'' part of the address to determine the actual
sender.
.Pp
@@ -134,7 +143,8 @@ Some other networks can be reached by giving the name of the network as the
last component of the domain.
.Em This is not a standard feature
and may
-not be supported at all sites. For example, messages to CSNET or BITNET sites
+not be supported at all sites.
+For example, messages to CSNET or BITNET sites
can often be sent to ``user@host.CSNET'' or ``user@host.BITNET'' respectively.
.Sh SEE ALSO
.Xr mail 1 ,
diff --git a/share/man/man7/sdoc.7 b/share/man/man7/sdoc.7
index 28dc628..bbbc84b 100644
--- a/share/man/man7/sdoc.7
+++ b/share/man/man7/sdoc.7
@@ -268,7 +268,7 @@ to link in shared libraries of unknown pedigree.
.Xr security 7 ,
.Xr sprog 7
.Rs
-.%T "The FreeBSD Security Architecture"
+.%T "The FreeBSD Security Architecture"
.%J file:///usr/share/doc/{to be determined}
.Re
.Rs
diff --git a/share/man/man7/security.7 b/share/man/man7/security.7
index 97434e8..c483361 100644
--- a/share/man/man7/security.7
+++ b/share/man/man7/security.7
@@ -606,7 +606,7 @@ lot harder to deal with.
A good security script will also check for changes to user and staff members
access configuration files:
.Pa .rhosts , .shosts , .ssh/authorized_keys
-and so forth... files that might fall outside the purview of the MD5 check.
+and so forth, files that might fall outside the purview of the MD5 check.
.Pp
If you have a huge amount of user disk space it may take too long to run
through every file on those partitions.
diff --git a/share/man/man7/tuning.7 b/share/man/man7/tuning.7
index f8ef784..dfe5ac6 100644
--- a/share/man/man7/tuning.7
+++ b/share/man/man7/tuning.7
@@ -168,7 +168,7 @@ partitioning your system fragmentation introduced in the smaller more
heavily write-loaded partitions will not bleed over into the mostly-read
partitions.
Additionally, keeping the write-loaded partitions closer to
-the edge of the disk (i.e. before the really big partitions instead of after
+the edge of the disk (i.e., before the really big partitions instead of after
in the partition table) will increase I/O performance in the partitions
where you need it the most.
Now it is true that you might also need I/O
@@ -538,7 +538,7 @@ With delayed acks turned off,
the acknowledgement may be sent in its own packet, before the remote service
has a chance to echo the data it just received.
This same concept also
-applies to any interactive protocol (e.g. SMTP, WWW, POP3), and can cut the
+applies to any interactive protocol (e.g.\& SMTP, WWW, POP3), and can cut the
number of tiny packets flowing across the network in half.
The
.Fx
diff --git a/share/man/man8/adding_user.8 b/share/man/man8/adding_user.8
index 6a06eb6..007c3bf 100644
--- a/share/man/man8/adding_user.8
+++ b/share/man/man8/adding_user.8
@@ -51,7 +51,7 @@ the dot
.Ql .\&
character, as that tends to confuse mailers.
An account can be added by editing a line into the passwd file; this
-must be done with the password file locked e.g. by using
+must be done with the password file locked e.g.\& by using
.Xr chpass 1
or
.Xr vipw 8 .
diff --git a/share/man/man8/picobsd.8 b/share/man/man8/picobsd.8
index ab1b281..9207b82 100644
--- a/share/man/man8/picobsd.8
+++ b/share/man/man8/picobsd.8
@@ -270,7 +270,7 @@ The string
.Dq Li @__CWD__@
is replaced with the full pathname of the directory where the
.Nm
-configuration resides (i.e. the one where we find
+configuration resides (i.e., the one where we find
.Pa PICOBSD , crunch.conf ,
and so on).
This can be useful to refer source code that resides within a
@@ -303,7 +303,7 @@ By default,
is set to 1440
which produces an image suitable for a standard floppy.
.Pp
-If you plan to store the image on a CDROM (e.g. using
+If you plan to store the image on a CDROM (e.g.\& using
the
.Dq "El Torito"
floppy emulation), you can set
@@ -380,7 +380,7 @@ a new image can be produced by simply running
.Dl "picobsd --src FOO/src -n -v bridge"
.Pp
whereas if the change affects include files or libraries
-you first need to update them, e.g. by running first
+you first need to update them, e.g.\& by running first
.Pp
.Dl "picobsd --src FOO/src --init # this is needed only once"
.Pp
@@ -648,7 +648,7 @@ If one of the arguments is
(the directory name alone),
then the command saves to disk (without editing)
all the files in the directory for which a copy
-already exists on disk (e.g. as a result of a previous update).
+already exists on disk (e.g.\& as a result of a previous update).
.Sh SEE ALSO
.Xr crunchgen 1 ,
.Xr mdconfig 8 ,
diff --git a/share/man/man8/rc.subr.8 b/share/man/man8/rc.subr.8
index 958bd0e..10fb533 100644
--- a/share/man/man8/rc.subr.8
+++ b/share/man/man8/rc.subr.8
@@ -95,8 +95,10 @@ The
functions were mostly imported from
.Nx
and it is intended that they remain synced between the
-two projects. With that in mind there are several variable
-definitions that can help in this regard. They are:
+two projects.
+With that in mind there are several variable
+definitions that can help in this regard.
+They are:
.Bl -tag -width 4n
.It Ic OSTYPE
Its value will be either
@@ -251,7 +253,8 @@ followed by
and then
.Ar message .
This function is intended to be used by developers
-as an aid to debugging scripts. It can be turned on or off
+as an aid to debugging scripts.
+It can be turned on or off
by the
.Xr rc.conf 5
variable
@@ -276,14 +279,16 @@ and then
.It Ic force_depend name
Output an advisory message and force the
.Ar name
-service to start. The
+service to start.
+The
.Ar name
argument is the
.Xr basename 1 ,
component of the path to the script, usually
.Em /etc/rc.d/name .
If the script fails for any reason it will output a warning
-and return with a return value of 1. If it was successful
+and return with a return value of 1.
+If it was successful
it will return 0.
.It Ic info Ar message
Display an informational message to
@@ -727,7 +732,8 @@ otherwise source
into the current shell.
.El
.It Ic set_rcvar Op Ar base
-Set the variable name required to start a service. In
+Set the variable name required to start a service.
+In
.Fx
a daemon is usually controlled by an
.Xr rc.conf 5
@@ -743,7 +749,8 @@ This function will use the value of the
.Sy $name
variable, which should be defined by the calling script, to construct the appropriate
.Xr rc.conf 5
-knob. If the
+knob.
+If the
.Ar base
argument is set it will use
.Ar base
diff --git a/share/man/man8/yp.8 b/share/man/man8/yp.8
index e82d9ae..2903c89 100644
--- a/share/man/man8/yp.8
+++ b/share/man/man8/yp.8
@@ -288,7 +288,7 @@ retrieve the entire contents of a map
.Pp
There are a few other requests which
.Xr ypserv 8
-is capable of handling (i.e. acknowledge whether or not you can handle
+is capable of handling (i.e., acknowledge whether or not you can handle
a particular domain
.Pq Dv YPPROC_DOMAIN ,
or acknowledge only if you can handle the domain and be silent otherwise
diff --git a/share/man/man9/BUS_CONFIG_INTR.9 b/share/man/man9/BUS_CONFIG_INTR.9
index b5b0207..ccd90a0 100644
--- a/share/man/man9/BUS_CONFIG_INTR.9
+++ b/share/man/man9/BUS_CONFIG_INTR.9
@@ -44,7 +44,7 @@ The
.Nm
method allows bus or device drivers to provide interrupt polarity and trigger
mode to parent busses.
-This typically bubbles all the way up to the root bus (e.g. nexus) where the
+This typically bubbles all the way up to the root bus (e.g.\& nexus) where the
necessary actions are taken to actually program the hardware.
Since the
.Nm
diff --git a/share/man/man9/DEVICE_DETACH.9 b/share/man/man9/DEVICE_DETACH.9
index 7ff379a..ae88a28 100644
--- a/share/man/man9/DEVICE_DETACH.9
+++ b/share/man/man9/DEVICE_DETACH.9
@@ -43,11 +43,11 @@
Detach a device.
This can be called if the user is replacing the
driver software or if a device is about to be physically removed from
-the system (e.g. for pccard devices).
+the system (e.g.\& for pccard devices).
.Pp
The method should deallocate any system resources allocated during the
.Xr DEVICE_ATTACH 9
-method and reset the hardware to a sane state (i.e. disable interrupts
+method and reset the hardware to a sane state (i.e., disable interrupts
etc.)
.Sh RETURN VALUES
Zero is returned on success, otherwise an appropriate error is returned.
diff --git a/share/man/man9/DEVICE_IDENTIFY.9 b/share/man/man9/DEVICE_IDENTIFY.9
index 1794c4c..bdea57b 100644
--- a/share/man/man9/DEVICE_IDENTIFY.9
+++ b/share/man/man9/DEVICE_IDENTIFY.9
@@ -41,7 +41,7 @@
.Fn DEVICE_IDENTIFY "driver_t *driver" "device_t parent"
.Sh DESCRIPTION
The identify function for a device is only needed for devices on busses
-that cannot identify their children independently, e.g. the ISA bus.
+that cannot identify their children independently, e.g.\& the ISA bus.
It is used to recognize the device (usually done by accessing non-ambiguous
registers in the hardware) and to tell the kernel about it and thus
creating a new device instance.
diff --git a/share/man/man9/DEVICE_PROBE.9 b/share/man/man9/DEVICE_PROBE.9
index 5c4b00f..e809975 100644
--- a/share/man/man9/DEVICE_PROBE.9
+++ b/share/man/man9/DEVICE_PROBE.9
@@ -74,10 +74,11 @@ returned, the driver can assume that it will be the one attached, but
must not hold any resources when the probe routine returns.
.Sh RETURN VALUES
A value equal to or less than zero indicates success, greater than
-zero indicates an error (errno). For values equal to or less than
+zero indicates an error (errno).
+For values equal to or less than
zero: zero indicates highest priority, no further probing is done;
for a value less than zero, the lower the value the lower the
-priority, e.g. -100 indicates a lower priority than -50.
+priority, e.g.\& -100 indicates a lower priority than -50.
.Sh SEE ALSO
.Xr device 9 ,
.Xr DEVICE_ATTACH 9 ,
diff --git a/share/man/man9/MD5.9 b/share/man/man9/MD5.9
index 4a85e14..d51a9fc 100644
--- a/share/man/man9/MD5.9
+++ b/share/man/man9/MD5.9
@@ -48,8 +48,9 @@
.Sh DESCRIPTION
The
.Nm
-module implements the RSA Data Security, Inc. MD5 Message-Digest Algorithm
-(MD5). It produces 128-bit MD5 Digest of data.
+module implements the RSA Data Security, Inc.\& MD5 Message-Digest Algorithm
+(MD5).
+It produces 128-bit MD5 Digest of data.
.Pp
.Bl -hang -width MD5Transformxxx
.It Pa MD5Init
diff --git a/share/man/man9/boot.9 b/share/man/man9/boot.9
index 4318038..cbd0099 100644
--- a/share/man/man9/boot.9
+++ b/share/man/man9/boot.9
@@ -71,7 +71,7 @@ syncs and unmounts the system disks by calling
.It
Disables interrupts.
.It
-If rebooting after a crash (i.e. if
+If rebooting after a crash (i.e., if
.Dv RB_DUMP
is set in
.Fa howto ,
diff --git a/share/man/man9/buf.9 b/share/man/man9/buf.9
index b809b82..2343e27 100644
--- a/share/man/man9/buf.9
+++ b/share/man/man9/buf.9
@@ -68,7 +68,7 @@ bits.
These bits are generally set and cleared in groups based on the device
block size of the device backing the page.
Complete page's worth are often
-referred to using the VM_PAGE_BITS_ALL bitmask (i.e. 0xFF if the hardware page
+referred to using the VM_PAGE_BITS_ALL bitmask (i.e., 0xFF if the hardware page
size is 4096).
.Pp
VM buffers also keep track of a byte-granular dirty range and valid range.
@@ -111,9 +111,10 @@ This
can create confusion within file system devices that use delayed-writes because
you wind up with pages marked clean that are actually still dirty.
If not
-treated carefully, these pages could be thrown away! Indeed, a number of
+treated carefully, these pages could be thrown away!
+Indeed, a number of
serious bugs related to this hack were not fixed until the 2.2.8/3.0 release.
-The kernel uses an instantiated VM buffer (i.e. struct buf) to place-mark pages
+The kernel uses an instantiated VM buffer (i.e., struct buf) to place-mark pages
in this special state.
The buffer is typically flagged B_DELWRI.
When a
diff --git a/share/man/man9/bus_dma.9 b/share/man/man9/bus_dma.9
index 92fd687..2221368 100644
--- a/share/man/man9/bus_dma.9
+++ b/share/man/man9/bus_dma.9
@@ -176,7 +176,7 @@ field contains the device visible address of the DMA segment, and
contains the length of the DMA segment.
Although the DMA segments returned by a mapping call will adhere to
all restrictions necessary for a successful DMA operation, some conversion
-(e.g. a conversion from host byte order to the device's byte order) is
+(e.g.\& a conversion from host byte order to the device's byte order) is
almost always required when presenting segment information to the device.
.It Vt bus_dmamap_t
A machine-dependent opaque type describing an individual mapping.
@@ -197,7 +197,7 @@ Callbacks are of the format:
The
.Fa callback_arg
is the callback argument passed to dmamap load functions.
-The
+The
.Fa segs
and
.Fa nseg
@@ -216,7 +216,7 @@ the load of a
.Vt bus_dmamap_t
via
.Fn bus_dmamap_load_uio
-or
+or
.Fn bus_dmamap_load_mbuf .
.sp
Callback2s are of the format:
@@ -372,7 +372,7 @@ DMA mapping associated with this tag.
.It Fa nsegments
Number of discontinuities (scatter/gather segments) allowed
in a DMA mapped region.
-If there is no restriction,
+If there is no restriction,
.Dv BUS_SPACE_UNRESTRICTED
may be specified.
.It Fa maxsegsz
@@ -399,7 +399,7 @@ is used.
Optional argument to be passed to the function specified by
.Fa lockfunc .
.It Fa dmat
-Pointer to a bus_dma_tag_t where the resulting DMA tag will
+Pointer to a bus_dma_tag_t where the resulting DMA tag will
be stored.
.El
.Pp
@@ -634,7 +634,7 @@ returned via
.Fa mapp .
Arguments are as follows:
.Bl -tag -width alignment -compact
-.It Fa dmat
+.It Fa dmat
DMA tag describing the constraints of the DMA mapping.
.It Fa vaddr
Pointer to a pointer that will hold the returned KVA mapping of
@@ -646,7 +646,7 @@ Flags are defined as follows:
The routine can safely wait (sleep) for resources.
.It Dv BUS_DMA_NOWAIT
The routine is not allowed to wait for resources.
-If resources are not available,
+If resources are not available,
.Dv ENOMEM
is returned.
.It Dv BUS_DMA_COHERENT
diff --git a/share/man/man9/bus_release_resource.9 b/share/man/man9/bus_release_resource.9
index cf0afa0..e4322af 100644
--- a/share/man/man9/bus_release_resource.9
+++ b/share/man/man9/bus_release_resource.9
@@ -46,7 +46,7 @@
.Sh DESCRIPTION
Free a resource allocated by
.Xr bus_alloc_resource 9 .
-The resource must not be in use on release, i.e. call an appropriate function
+The resource must not be in use on release, i.e., call an appropriate function
before (e.g.\&
.Xr bus_teardown_intr 9
for IRQs).
@@ -72,7 +72,7 @@ value must be the same as the one returned by
.Fa r
is the pointer to
.Va struct res ,
-i.e. the resource itself,
+i.e., the resource itself,
returned by
.Xr bus_alloc_resource 9 .
.El
diff --git a/share/man/man9/device_add_child.9 b/share/man/man9/device_add_child.9
index 68877ad..eedc8cc 100644
--- a/share/man/man9/device_add_child.9
+++ b/share/man/man9/device_add_child.9
@@ -74,14 +74,14 @@ Normally unit numbers will be chosen automatically by the system and a
unit number of
.Dv -1
should be given.
-When a specific unit number is desired (e.g. for wiring a particular
+When a specific unit number is desired (e.g.\& for wiring a particular
piece of hardware to a pre-configured unit number), that unit should
be passed.
If the specified unit number is already allocated, a new
unit will be allocated and a diagnostic message printed.
.Pp
If the devices attached to a bus must be probed in a specific order
-(e.g. for the ISA bus some devices are sensitive to failed probe attempts
+(e.g.\& for the ISA bus some devices are sensitive to failed probe attempts
of unrelated drivers and therefore must be probed first),
the
.Fa order
diff --git a/share/man/man9/devstat.9 b/share/man/man9/devstat.9
index adf6c71..ceaec6e 100644
--- a/share/man/man9/devstat.9
+++ b/share/man/man9/devstat.9
@@ -74,7 +74,8 @@ statistics while utilizing a minimum amount of CPU time to record them.
Thus, no statistical calculations are actually performed in the kernel
portion of the
.Nm
-code. Instead, that is left for user programs to handle.
+code.
+Instead, that is left for user programs to handle.
.Pp
.Fn devstat_add_entry
registers a device with the
@@ -90,7 +91,7 @@ The
.Va devstat
structure, allocated and zeroed by the client.
.It dev_name
-The device name. e.g. da, cd, sa.
+The device name, e.g.\& da, cd, sa.
.It unit_number
Device unit number.
.It block_size
@@ -105,8 +106,8 @@ Flags indicating operations supported or not supported by the device.
See below for details.
.It device_type
The device type.
-This is broken into three sections: base device type
-(e.g. direct access, CDROM, sequential access), interface type (IDE, SCSI
+This is broken into three sections: base device type
+(e.g.\& direct access, CDROM, sequential access), interface type (IDE, SCSI
or other) and a pass-through flag to indicate pas-through devices.
See below for a complete list of types.
.It priority
@@ -269,8 +270,8 @@ These flags are primarily intended to serve as an aid
to userland programs that decipher the statistics.
.It device_type
This is the device type.
-It consists of three parts: the device type
-(e.g. direct access, CDROM, sequential access, etc.), the interface (IDE,
+It consists of three parts: the device type
+(e.g.\& direct access, CDROM, sequential access, etc.), the interface (IDE,
SCSI or other) and whether or not the device in question is a pass-through
driver.
See below for a complete list of device types.
diff --git a/share/man/man9/g_access.9 b/share/man/man9/g_access.9
index 1b4bf61..40d175c 100644
--- a/share/man/man9/g_access.9
+++ b/share/man/man9/g_access.9
@@ -70,7 +70,7 @@ No\-operation is not permitted
=
.Va 0 ) .
.Pp
-The provider's geom must have an access method defined (eg. gp->access).
+The provider's geom must have an access method defined (e.g.\& gp->access).
.Pp
The topology lock has to be held.
.Sh RETURN VALUES
diff --git a/share/man/man9/g_event.9 b/share/man/man9/g_event.9
index f0a512c..5f2b636 100644
--- a/share/man/man9/g_event.9
+++ b/share/man/man9/g_event.9
@@ -45,7 +45,7 @@ The GEOM framework has its own event queue to inform classes about important
events.
The event queue can be also used by GEOM classes themselves, for example
to work around some restrictions in the I/O path, where sleeping, heavy weight
-tasks, etc. are not permitted.
+tasks, etc.\& are not permitted.
.Pp
The
.Fn g_post_event
diff --git a/share/man/man9/ithread.9 b/share/man/man9/ithread.9
index 3388453..2a8c272 100644
--- a/share/man/man9/ithread.9
+++ b/share/man/man9/ithread.9
@@ -350,5 +350,5 @@ Currently
represents both an interrupt source and an interrupt thread.
There should be a separate
.Vt struct isrc
-that contains a vector number, enable and disable functions, etc. that
+that contains a vector number, enable and disable functions, etc.\& that
an ithread holds a reference to.
diff --git a/share/man/man9/kobj.9 b/share/man/man9/kobj.9
index 6c5de34..ee013d1 100644
--- a/share/man/man9/kobj.9
+++ b/share/man/man9/kobj.9
@@ -68,7 +68,7 @@ and is only slightly more expensive than a direct function call,
making kernel objects suitable for performance-critical algorithms.
.Pp
Suitable uses for kernel objects are any algorithms which need some
-kind of polymorphism (i.e. many different objects which can be treated
+kind of polymorphism (i.e., many different objects which can be treated
in a uniform way).
The common behaviour of the objects is described by a suitable
interface and each different type of object is implemented by a
diff --git a/share/man/man9/mac.9 b/share/man/man9/mac.9
index a6b3410..5218fa9 100644
--- a/share/man/man9/mac.9
+++ b/share/man/man9/mac.9
@@ -182,7 +182,7 @@ This man page was written by
This software was contributed to the
.Fx
Project by Network Associates Laboratories, the Security Research
-Division of Network Associates Inc. under DARPA/SPAWAR contract
+Division of Network Associates Inc.\& under DARPA/SPAWAR contract
N66001-01-C-8035
.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
diff --git a/share/man/man9/mbpool.9 b/share/man/man9/mbpool.9
index f7c0286..cda3ba8 100644
--- a/share/man/man9/mbpool.9
+++ b/share/man/man9/mbpool.9
@@ -66,30 +66,41 @@ Mbuf pools are intended to help drivers for interface cards that need huge
amounts of receive buffers and additionally provides a mapping between these
buffers and 32-bit handles.
.Pp
-An example of these cards are the Fore/Marconi ForeRunnerHE cards. These
+An example of these cards are the Fore/Marconi ForeRunnerHE cards.
+These
employ up to 8 receive groups, each with two buffer pools, each of which
-can contain up to 8192. This gives a total maximum number of more than
-100000 buffers. Even with a more moderate configuration the card eats several
-thousand buffers. Each of these buffers must be mapped for DMA. While for
+can contain up to 8192.
+This gives a total maximum number of more than
+100000 buffers.
+Even with a more moderate configuration the card eats several
+thousand buffers.
+Each of these buffers must be mapped for DMA.
+While for
machines without an IOMMU and with lesser than 4GByte memory this is not
a problem, for other machines this may quickly eat up all available IOMMU
-address space and/or bounce buffers. On the sparc64 the default IO page size
+address space and/or bounce buffers.
+On the sparc64 the default IO page size
is 16k, so mapping a simple mbuf wastes 31/32 of the address space.
.Pp
Another problem with most of these cards is that they support putting a 32-bit
handle into the buffer descriptor together with the physical address.
This handle is reflected back to the driver when the buffer is filled and
-assists the driver in finding the buffer in host memory. For 32-bit machines
-usually the virtual address of the buffer is used as the handle. This does not
+assists the driver in finding the buffer in host memory.
+For 32-bit machines
+usually the virtual address of the buffer is used as the handle.
+This does not
work for 64-machines for obvious reasons so a mapping is needed between
-these handles and the buffers. This mapping should be possible without
+these handles and the buffers.
+This mapping should be possible without
searching lists and the like.
.Pp
An mbuf pool overcomes both problems by allocating DMA-able memory page wise
-with a per-pool configurable page size. Each page is divided into a number
+with a per-pool configurable page size.
+Each page is divided into a number
equally-sized chunks the last
.Dv MBPOOL_TRAILER_SIZE
-of which are used by the pool code (4 bytes). The rest of each chunk is
+of which are used by the pool code (4 bytes).
+The rest of each chunk is
usable as buffer.
There is a per-pool limit on pages that will be allocated.
.Pp
@@ -99,7 +110,8 @@ A buffer may be in one of three states:
.It free
none of the flags is set.
.It on-card
-both flags are set. The buffer is assumed to be handed over to the card and
+both flags are set.
+The buffer is assumed to be handed over to the card and
waiting to be filled.
.It used
The buffer was returned by the card and is now travelling through the system.
@@ -113,14 +125,16 @@ to be used to create and map the memory pages via
.Fn bus_dmamem_alloc .
The
.Fa chunk_size
-includes the pool overhead. That means to get buffers for 5 ATM cells
-(240 bytes) a chunk size of 256 should be specified. This results in 12 unused
-bytes between the buffer and the pool overhead of four byte. The total
+includes the pool overhead.
+That means to get buffers for 5 ATM cells
+(240 bytes) a chunk size of 256 should be specified.
+This results in 12 unused
+bytes between the buffer and the pool overhead of four byte.
+The total
maximum number of buffers in a pool is
.Fa max_pages *
-(
-.Fa page_size /
-.Fa chunk_size ).
+.Fa ( page_size /
+.Fa chunk_size ) .
The maximum value for
.Fa max_pages
is 2^14-1 (16383) and the maximum of
@@ -134,9 +148,11 @@ is set into the variable pointed to by
.Pp
A pool is destroyed with
.Fn mbp_destroy .
-This frees all pages and the pool structure itself. If compiled with
+This frees all pages and the pool structure itself.
+If compiled with
.Dv DIAGNOSTICS
-the code checks that all buffers are free. If not a warning message is issued
+the code checks that all buffers are free.
+If not a warning message is issued
to the console.
.Pp
A buffer is allocate with
@@ -147,47 +163,57 @@ address into the variable pointed to by
The handle is stored into the variable pointed to by
.Fa hp .
The two most significant bits and the 7 least significant bits of the handle
-are unused by the pool code and may be used by the caller. These are
+are unused by the pool code and may be used by the caller.
+These are
automatically stripped when passing a handle to one of the other functions.
If a buffer cannot be allocated (either because the maximum number of pages
is reached, no memory is available or the memory cannot be mapped) NULL is
-returned. If a buffer could be allocated it is in the on-card state.
+returned.
+If a buffer could be allocated it is in the on-card state.
.Pp
When the buffer is returned by the card the driver calls
.Fn mbp_get
-with the handle. This function returns the virtual address of the buffer
-and clears the on-card bit. The buffer is now in the used state.
+with the handle.
+This function returns the virtual address of the buffer
+and clears the on-card bit.
+The buffer is now in the used state.
The function
.Fn mbp_get_keep
differs from
.Fn mbp_get
-in that it does not clear the on-card bit. This can be used for buffers
+in that it does not clear the on-card bit.
+This can be used for buffers
that are returned
.Sq partially
by the card.
.Pp
A buffer is freed by calling
.Fn mbp_free
-with the virtual address of the buffer. This clears the used bit, and
-puts the buffer on the free list of the pool. Note, that free buffers
+with the virtual address of the buffer.
+This clears the used bit, and
+puts the buffer on the free list of the pool.
+Note, that free buffers
are NOT returned to the system.
The function
.Fn mbp_ext_free can be given to
.Fn m_extadd
-as the free function. The user argument must be the pointer to
+as the free function.
+The user argument must be the pointer to
the pool.
.Pp
Before using the contents of a buffer returned by the card the driver
must call
.Fn mbp_sync
-with the appropriate parameters. This results in a call to
+with the appropriate parameters.
+This results in a call to
.Fn bus_dmamap_sync
for the buffer.
.Pp
All buffers in the pool that are currently in the on-card state can be freed
with a call to
.Fn mbp_card_free .
-This may be called by the driver when it stops the interface. Buffers in
+This may be called by the driver when it stops the interface.
+Buffers in
the used state are not freed by this call.
.Pp
For debugging it is possible to call
diff --git a/share/man/man9/mbuf.9 b/share/man/man9/mbuf.9
index 02c174b..5f564fd 100644
--- a/share/man/man9/mbuf.9
+++ b/share/man/man9/mbuf.9
@@ -449,7 +449,7 @@ This macro operates on an
It is an optimized wrapper for
.Fn m_prepend
that can make use of possible empty space before data
-(e.g. left after trimming of a link-layer header).
+(e.g.\& left after trimming of a link-layer header).
The new
.Vt mbuf chain
pointer or
diff --git a/share/man/man9/mi_switch.9 b/share/man/man9/mi_switch.9
index f6e5d73..bfc2fbe 100644
--- a/share/man/man9/mi_switch.9
+++ b/share/man/man9/mi_switch.9
@@ -75,7 +75,7 @@ voluntarily relinquishes the CPU to wait for some resource to become
available.
.It
after handling a trap
-(e.g. a system call, device interrupt)
+(e.g.\& a system call, device interrupt)
when the kernel prepares a return to user-mode execution.
This case is
typically handled by machine dependent trap-handling code after detection
diff --git a/share/man/man9/microseq.9 b/share/man/man9/microseq.9
index e7748df..c4197d9 100644
--- a/share/man/man9/microseq.9
+++ b/share/man/man9/microseq.9
@@ -59,7 +59,8 @@ Thus, any register described later has the same semantic than its counterpart
in a PC parallel port.
For more info about ISA/ECP programming, get the
Microsoft standard referenced as "Extended Capabilities Port Protocol and
-ISA interface Standard". Registers described later are standard parallel port
+ISA interface Standard".
+Registers described later are standard parallel port
registers.
.Pp
Mask macros are defined in the standard ppbus include files for each valid
@@ -467,7 +468,8 @@ and then execute the microsequence.
.Ss The microsequencer
The microsequencer is executed either at ppbus or adapter level (see
.Xr ppbus 4
-for info about ppbus system layers). Most of the microsequencer is executed
+for info about ppbus system layers).
+Most of the microsequencer is executed
at ppc level to avoid ppbus to adapter function call overhead.
But some
actions like deciding whereas the transfer is IEEE1284-1994 compliant are
diff --git a/share/man/man9/mutex.9 b/share/man/man9/mutex.9
index 2f8ec7d..107458b 100644
--- a/share/man/man9/mutex.9
+++ b/share/man/man9/mutex.9
@@ -192,7 +192,7 @@ on behalf of the currently running kernel thread.
If another kernel thread is holding the mutex,
the caller will be disconnected from the CPU
until the mutex is available
-(i.e. it will sleep).
+(i.e., it will sleep).
.Pp
The
.Fn mtx_lock_spin
@@ -402,7 +402,7 @@ for this reason spin locks will disable all interrupts
Spin locks are fairly specialized locks
that are intended to be held for very short periods of time;
their primary purpose is to protect portions of the code
-that implement default (i.e. sleep) locks.
+that implement default (i.e., sleep) locks.
.Ss Initialization Options
The options passed in the
.Fa opts
diff --git a/share/man/man9/pci.9 b/share/man/man9/pci.9
index 76d35ea..55ed70a 100644
--- a/share/man/man9/pci.9
+++ b/share/man/man9/pci.9
@@ -119,7 +119,8 @@ or
.Dv PCIM_CMD_PORTEN
bit in the
.Dv PCIR_COMMAND
-register appropriately. The
+register appropriately.
+The
.Fn pci_disable_io
function clears the appropriate bit.
The
@@ -202,7 +203,8 @@ of a PCI device, given its
.Fa vendor
and
.Fa device
-IDs. Note that there can be multiple matches for this search; this function
+IDs.
+Note that there can be multiple matches for this search; this function
only returns the first matching device.
.Sh IMPLEMENTATION NOTES
The
diff --git a/share/man/man9/pseudofs.9 b/share/man/man9/pseudofs.9
index 4e5cc8b..6230b14 100644
--- a/share/man/man9/pseudofs.9
+++ b/share/man/man9/pseudofs.9
@@ -44,7 +44,7 @@ and
It takes care of all the hairy bits like interfacing with the VFS
system, enforcing access control, keeping track of file numbers, and
cloning files and directories that are process-specific.
-The consumer module, i.e. the module that implements the actual guts
+The consumer module, i.e., the module that implements the actual guts
of the file system, needs only provide the directory structure
(represented by a collection of structures declared and initialized by
macros provided by
diff --git a/share/man/man9/random.9 b/share/man/man9/random.9
index de41aa5..426774e 100644
--- a/share/man/man9/random.9
+++ b/share/man/man9/random.9
@@ -86,7 +86,8 @@ argument.
The
.Fn read_random
function is used to return entropy directly from the entropy device
-if it has been loaded. If the entropy device is not loaded, then
+if it has been loaded.
+If the entropy device is not loaded, then
the
.Fa buffer
is filled with output generated by
@@ -95,7 +96,8 @@ The
.Fa buffer
is filled with no more than
.Fa count
-bytes. It is advised that
+bytes.
+It is advised that
.Fn read_random
is not used; instead use
.Fn arc4rand
diff --git a/share/man/man9/spl.9 b/share/man/man9/spl.9
index f819af7..fd9e3bc 100644
--- a/share/man/man9/spl.9
+++ b/share/man/man9/spl.9
@@ -191,7 +191,7 @@ Note that the interrupt handler should
.Em never
reduce the priority level.
It is automatically called as it had
-raised the interrupt priority to its own level, i.e. further interrupts
+raised the interrupt priority to its own level, i.e., further interrupts
of the same group are being blocked.
.Sh HISTORY
The interrupt priority levels appeared in a very early version of
diff --git a/share/man/man9/style.9 b/share/man/man9/style.9
index ace7cf2..5038c18 100644
--- a/share/man/man9/style.9
+++ b/share/man/man9/style.9
@@ -354,7 +354,7 @@ typedef const long baz; /* This is baz. */
.Pp
All functions are prototyped somewhere.
.Pp
-Function prototypes for private functions (i.e. functions not used
+Function prototypes for private functions (i.e., functions not used
elsewhere) go at the top of the first source module.
Functions
local to one source module should be declared
@@ -665,7 +665,7 @@ not:
.Pp
Do not use
.Ic \&!
-for tests unless it is a boolean, e.g. use
+for tests unless it is a boolean, e.g.\& use
.Bd -literal
if (*p == '\e0')
.Ed
diff --git a/share/man/man9/sysctl_add_oid.9 b/share/man/man9/sysctl_add_oid.9
index 68d40a1..cb16d26 100644
--- a/share/man/man9/sysctl_add_oid.9
+++ b/share/man/man9/sysctl_add_oid.9
@@ -185,7 +185,7 @@
.Sh DESCRIPTION
These functions and macros provide an interface
for creating and deleting sysctl oids at runtime
-(e.g. during lifetime of a module).
+(e.g.\& during lifetime of a module).
The alternative method,
based on linker sets (see
.In sys/linker_set.h
@@ -223,7 +223,7 @@ macro, where the
.Fa OID_NAME
argument is name of the parent oid of type
.Dv CTLTYPE_NODE
-(i.e. the name displayed by
+(i.e., the name displayed by
.Xr sysctl 8 ,
preceded by underscore, and with all dots replaced with underscores).
.Pp
diff --git a/share/man/man9/sysctl_ctx_init.9 b/share/man/man9/sysctl_ctx_init.9
index 4c7dc73..44d34ae 100644
--- a/share/man/man9/sysctl_ctx_init.9
+++ b/share/man/man9/sysctl_ctx_init.9
@@ -69,7 +69,7 @@ for managing dynamically created oids.
The sysctl context is responsible for keeping track of created oids,
as well as their proper removal when needed.
It adds a simple transactional aspect to oid removal operations;
-i.e. if a removal operation fails part way,
+i.e., if a removal operation fails part way,
it is possible to roll back the sysctl tree
to its previous state.
.Pp
@@ -145,7 +145,7 @@ maintain their original positions in the tree.
The second step actually performs the deletion of the dynamic oids.
.Xr sysctl_remove_oid 9
iterates through the context list,
-starting from beginning (i.e. the newest entries).
+starting from beginning (i.e., the newest entries).
.Em Important :
this time, the function not only deletes the oids from the tree,
but also frees their memory (provided that oid_refcnt == 0),
diff --git a/share/man/man9/utopia.9 b/share/man/man9/utopia.9
index 6ed0663..f35fca6 100644
--- a/share/man/man9/utopia.9
+++ b/share/man/man9/utopia.9
@@ -57,7 +57,7 @@
.Ft int
.Fn utopia_update_carrier "struct utopia *utp"
.Ft int
-.Fn utopia_set_loopback "struct utopia *utp" "u_int mode"
+.Fn utopia_set_loopback "struct utopia *utp" "u_int mode"
.Ft void
.Fn utopia_intr "struct utopia *utp"
.Ft void
@@ -128,8 +128,10 @@ Pointer to the driver's private data (softc).
.It Va media
Pointer to the driver's media structure.
.Ir Va lock
-Pointer to a mutex provided by the driver. This mutex is used to synchronize
-with the kernel thread that handles device polling. It is locked in several
+Pointer to a mutex provided by the driver.
+This mutex is used to synchronize
+with the kernel thread that handles device polling.
+It is locked in several
places:
.Bl -enum -offset indent
.It
@@ -146,7 +148,7 @@ kernel thread the mutex is locked and the
.Fn utopia_carrier_update
function is called with this mutex locked.
This will result in the driver's
-.Fn readregs
+.Fn readregs
function being called with the mutex locked.
.It
In the sysctl handlers the mutex will be locked before calling into the driver's
@@ -156,18 +158,22 @@ or
functions.
.El
.It Va flags
-Flags set by either the driver or the utopia module. The following flags are
+Flags set by either the driver or the utopia module.
+The following flags are
defined:
.Bl -tag -width XXX
.It Dv UTP_FL_NORESET
If this flag is set the module will not try to write the
-SUNI master reset register. (set by the driver)
+SUNI master reset register.
+(set by the driver)
.It Dv UTP_FL_POLL_CARRIER
If this flag is set the module will periodically poll the carrier state
-(as opposed to interrupt driven carrier state changes). (set by the driver)
+(as opposed to interrupt driven carrier state changes).
+(set by the driver)
.El
.It Va state
-Flags describing the current state of the phy chip. These are managed
+Flags describing the current state of the phy chip.
+These are managed
by the module:
.Bl -tag -width XXX
.It Dv UTP_ST_ACTIVE
@@ -189,7 +195,8 @@ Cell scrambling is switched off.
The attach routine has been run successfully.
.El
.It Va carrier
-The carrier state of the interface. This field can have one of three values:
+The carrier state of the interface.
+This field can have one of three values:
.Bl -tag -width XXX
.It Dv UTP_CARR_UNKNOWN
Carrier state is still unknown.
@@ -199,14 +206,18 @@ Carrier has been detected.
Carrier has been lost.
.El
.It Va loopback
-This is the current loopback mode of the interface. Note, that not all
-chips support all loopback modes. Refer to the chip documentation. The
+This is the current loopback mode of the interface.
+Note, that not all
+chips support all loopback modes.
+Refer to the chip documentation.
+The
following modes may be supported:
.Bl -tag -width XXX
.It Dv UTP_LOOP_NONE
No loopback, normal operation.
.It Dv UTP_LOOP_TIME
-Timing source loopback. The transmitter clock is driven by the receive clock.
+Timing source loopback.
+The transmitter clock is driven by the receive clock.
.It Dv UTP_LOOP_DIAG
Diagnostic loopback.
.It Dv UTP_LOOP_LINE
@@ -219,8 +230,14 @@ Twisted pair diagnostic loopback.
Diagnostic path loopback.
.El
.It Va chip
+<<<<<<< utopia.9
+This points the a function vector for chip specific functions.
+Two fields
+in this vector a publically available:
+=======
This points the a function vector for chip specific functions. Two fields
in this vector are publicly available:
+>>>>>>> 1.3
.Bl -tag -width XXX
.It Va type
This is the type of the detected PHY chip.
@@ -241,7 +258,8 @@ The following functions are used by the driver during attach/detach and/or
initialisation/stopping the interface:
.Bl -tag -width XXX
.It Fn utopia_attach
-Attach the PHY chip. This is called with a preallocated
+Attach the PHY chip.
+This is called with a preallocated
.Vt "struct utopia"
(which may be part of the driver's softc).
The module initializes all fields of the utopia state and the media field.
@@ -253,17 +271,22 @@ On success 0 is returned and the
.Dv UTP_ST_ATTACHED
flag is set.
.It Fn utopia_detach
-Remove the utopia attachment from the system. This cancels all outstanding polling
+Remove the utopia attachment from the system.
+This cancels all outstanding polling
timeouts.
.It Fn utopia_start
-Start operation of that PHY. This should be called at a time
-when the PHY registers are known to be accessible. This may be either in
+Start operation of that PHY.
+This should be called at a time
+when the PHY registers are known to be accessible.
+This may be either in
the driver's attach function or when the interface is set running.
.It Fn utopia_stop
-Stop operation of the PHY attachment. This may be called either in the detach
+Stop operation of the PHY attachment.
+This may be called either in the detach
function of the driver or when the interface is brought down.
.It Fn utopia_init_media
-This must be called if the media field in the ATM MIB was changed. The function
+This must be called if the media field in the ATM MIB was changed.
+The function
makes sure, that the ifmedia fields contain the same information as the
ATM MIB.
.It Fn utopia_reset_media
@@ -275,19 +298,23 @@ is running:
.Bl -tag -width XXX
.It Fn utopia_reset
Reset the operational parameters to the default state (SONET, idle cells,
-scrambling enabled). Returns 0 on success, an error code otherwise leaving
+scrambling enabled).
+Returns 0 on success, an error code otherwise leaving
the state undefined.
.It Fn utopia_set_sdh
If the argument is zero the chip is switched to Sonet mode, if it is non-zero
-the chip is switched to SDH mode. Returns 0 on success, an error code otherwise
+the chip is switched to SDH mode.
+Returns 0 on success, an error code otherwise
leaving the previous state.
.It Fn utopia_set_unass
If the argument is zero the chip is switched to produce idle cells, if it is
-non-zero the chip is switched to produce unassigned cells. Returns 0 on success,
+non-zero the chip is switched to produce unassigned cells.
+Returns 0 on success,
an error code otherwise leaving the previous state.
.It Fn utopia_set_noscramb
If the argument is zero enables scrambling, if it is
-non-zero disables scrambling. Returns 0 on success,
+non-zero disables scrambling.
+Returns 0 on success,
an error code otherwise leaving the previous state.
.It Fn utopia_update_carrier
Check the carrier state and update the carrier field in the state structure.
@@ -295,10 +322,12 @@ This will generate a message to the netgraph stack if the carrier state changes.
For chips that are polled this is called automatically, for interrupt
driven attachments this must be called on interrupts from the PHY chip.
.It Fn utopia_set_loopback
-Set the loopback mode of the chip. Returns 0 on success, an error code
+Set the loopback mode of the chip.
+Returns 0 on success, an error code
otherwise leaving the previous state.
.It Fn utopia_intr
-Called when an interrupt from the PHY chip is detected. This resets the
+Called when an interrupt from the PHY chip is detected.
+This resets the
interrupt state by reading all registers and, if the interrupt was from the
RSOP, checks the carrier state.
.It Fn utopia_update_stats
diff --git a/share/man/man9/vref.9 b/share/man/man9/vref.9
index 819fe20..6fffb8b 100644
--- a/share/man/man9/vref.9
+++ b/share/man/man9/vref.9
@@ -53,7 +53,7 @@ are using the vnode.
This allows the system to detect when a vnode is
no longer being used and can be safely recycled for a different file.
.Pp
-Any code in the system which is using a vnode (e.g. during the
+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
.Fn vref .
OpenPOWER on IntegriCloud