summaryrefslogtreecommitdiff
path: root/share
diff options
context:
space:
mode:
Diffstat (limited to 'share')
-rw-r--r--share/man/man4/bridge.4216
-rw-r--r--share/man/man4/ccd.474
-rw-r--r--share/man/man4/cd.4191
-rw-r--r--share/man/man4/clnp.458
-rw-r--r--share/man/man4/cmpci.48
-rw-r--r--share/man/man4/cnw.429
-rw-r--r--share/man/man4/cy.434
-rw-r--r--share/man/man4/eap.411
8 files changed, 299 insertions, 322 deletions
diff --git a/share/man/man4/bridge.4 b/share/man/man4/bridge.4
index e3385ddce2d..6663a066749 100644
--- a/share/man/man4/bridge.4
+++ b/share/man/man4/bridge.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bridge.4,v 1.27 2000/11/10 20:02:16 todd Exp $
+.\" $OpenBSD: bridge.4,v 1.28 2000/12/21 05:32:52 aaron Exp $
.\"
.\" Copyright (c) 1999, 2000 Jason L. Wright (jason@thought.net)
.\" All rights reserved.
@@ -107,27 +107,29 @@ They are defined in
.Bl -tag -width SIOCBRDGGIFFLGS
.It Dv SIOCBRDGIFS
.Pq Li "struct ifbifconf"
-Retrieve member interface list from a bridge. This request takes an
-.Ar ifbifconf
+Retrieve member interface list from a bridge.
+This request takes an
+.Li ifbifconf
structure (see below) as a value-result parameter.
The
-.Ar ifbic_len
+.Fa ifbic_len
field should be initially set to the size of the buffer
pointed to by
-.Ar ifbic_buf .
+.Fa ifbic_buf .
On return it will contain the length, in bytes, of the configuration
list.
Alternatively, if the
-.Ar ifbic_len
+.Fa ifbic_len
passed in is set to 0,
-SIOCBRDGIFS will set
-.Ar ifbic_len
+.Dv SIOCBRDGIFS
+will set
+.Fa ifbic_len
to the size that
-.Ar ifbic_buf
+.Fa ifbic_buf
needs to be to fit the entire configuration list,
and will not fill in the other parameters.
This is useful for determining the exact size that
-.Ar ifbic_buf
+.Fa ifbic_buf
needs to be in advance.
.Pp
The argument structure is defined as follows:
@@ -155,33 +157,33 @@ struct ifbifconf {
.It Dv SIOCBRDGADD
.Pq Li "struct ifbreq"
Add the interface named in
-.Ar ifbr_ifsname
+.Fa ifbr_ifsname
to the bridge named in
-.Ar ifbr_name .
+.Fa ifbr_name .
.It Dv SIOCBRDGDEL
.Pq Li "struct ifbreq"
Delete the interface named in
-.Ar ifbr_ifsname
+.Fa ifbr_ifsname
from the bridge named in
-.Ar ifbr_name .
+.Fa ifbr_name .
.It Dv SIOCBRDGSIFFLGS
.Pq Li "struct ifbreq"
Set the bridge member interface flags for the interface named in
-.Ar ifbr_ifsname
+.Fa ifbr_ifsname
attached to the bridge
-.Ar ifbr_name .
+.Fa ifbr_name .
If the flag
-.Ar IFBIF_LEARNING
+.Dv IFBIF_LEARNING
is set on an interface, source addresses from frames received on the
interface are recorded in the address cache.
If the flag
-.Ar IFBIF_DISCOVER
+.Dv IFBIF_DISCOVER
is set, the interface will receive packets destined for unknown
destinations, otherwise a frame that has a destination not found
in the address cache is not forwarded to this interface.
The default for newly added interfaces has both flags set.
If the flag
-.Ar IFBIF_BLOCKNONIP
+.Dv IFBIF_BLOCKNONIP
is set, packets that are one of
.Xr ip 4 ,
.Xr ip6 4 ,
@@ -190,29 +192,33 @@ or
Reverse ARP, will not be bridged from and to the interface.
.It Dv SIOCBRDGGIFFLGS
Retrieve the bridge member interface flags for the interface named in
-.Ar ifbr_ifsname
+.Fa ifbr_ifsname
attached to the bridge
-.Ar ifbr_name .
+.Fa ifbr_name .
.It Dv SIOCBRDGRTS
.Pq Li "struct ifbaconf"
Retrieve the address cache of the bridge named in
-.Ar ifbac_name .
+.Fa ifbac_name .
This request takes an
-.Ar ifbaconf
+.Li ifbaconf
structure (see below) as a value result parameter.
The
-.Ar ifbac_len
+.Fa ifbac_len
field should be initially set to the size of the buffer pointed to by
-.Ar ifbac_buf .
+.Fa ifbac_buf .
On return, it will contain the length, in bytes, of the configuration list.
Alternatively, if the
-.Ar ifbac_len
-passed in is set to 0, SIOCBRDGRTS will set it to the size that
-.Ar ifbac_buf
+.Fa ifbac_len
+passed in is set to 0,
+.Dv SIOCBRDGRTS
+will set it to the size that
+.Fa ifbac_buf
needs to be to fit the entire configuration list and not fill in the other
parameters.
-As with SIOCBRDGIFS, this is useful for determining the exact size that
-.Ar ifbac_buf
+As with
+.Dv SIOCBRDGIFS ,
+this is useful for determining the exact size that
+.Fa ifbac_buf
needs to be in advance.
.Pp
The argument structure is defined as follows:
@@ -241,34 +247,35 @@ struct ifbaconf {
};
.Ed
Address cache entries with the type set to
-.Ar IFBAF_DYNAMIC
+.Dv IFBAF_DYNAMIC
in
-.Ar ifba_flags
+.Fa ifba_flags
are entries learned by the bridge.
Entries with the type set to
-.Ar IFBAF_STATIC
+.Dv IFBAF_STATIC
are manually added entries.
.It Dv SIOCBRDGSADDR
.Pq Li "struct ifbareq"
Add an entry, manually, to the address cache for the bridge named in
-.Ar ifba_name .
+.Fa ifba_name .
The address and its associated interface and flags are set in the
-.Ar ifba_dst ,
-.Ar ifba_ifsname ,
-.Ar ifba_flags
+.Fa ifba_dst ,
+.Fa ifba_ifsname ,
+and
+.Fa ifba_flags
fields, respectively.
.It Dv SIOCBRDGDADDR
.Pq Li "struct ifbareq"
Delete an entry from the address cache of the bridge named in
-.Ar ifba_name .
+.Fa ifba_name .
Entries are deleted strictly based on the address field
-.Ar ifba_dst .
+.Fa ifba_dst .
.It Dv SIOCBRDGSCACHE
.Pq Li "struct ifbcachereq"
Set the maximum address cache size for the bridge named in
-.Ar ifbc_name
+.Fa ifbc_name
to
-.Ar ifbc_size
+.Fa ifbc_size
entries.
.Pp
The argument structure is as follows:
@@ -281,13 +288,13 @@ struct ifbcachereq {
.It Dv SIOCBRDGGCACHE
.Pq Li "struct ifbcachereq"
Retrieve the maximum size of the address cache for the bridge
-.Ar ifbc_name .
+.Fa ifbc_name .
.It Dv SIOCBRDGSTO
.Pq Li "struct ifbcachetoreq"
Set the time, in seconds, that addresses which have not been
seen on the network (transmitted a packet) remain in the cache.
-If the time is set to zero, no aging is performed on the address
-cache. The argument structure is as follows:
+If the time is set to zero, no aging is performed on the address cache.
+The argument structure is as follows:
.Bd -literal -offset indent
struct ifbcachetoreq {
char ifbct_name[IFNAMSIZ]; /* bridge */
@@ -300,50 +307,53 @@ Retrieve the address cache expiration time (see above).
.It Dv SIOCBRDGFLUSH
.Pq Li "struct ifbreq"
Flush addresses from the cache.
-.Ar ifbr_name
+.Fa ifbr_name
contains the name of the bridge device, and
-.Ar ifbr_ifsflags
+.Fa ifbr_ifsflags
should be set to
-.Ar IFBF_FLUSHALL
+.Dv IFBF_FLUSHALL
to flush all addresses from the cache or
-.Ar IFBF_FLUSHDYN
+.Dv IFBF_FLUSHDYN
to flush only the dynamically learned addresses from the cache.
.It Dv SIOCBRDGARL
.Pq Li "struct ifbrlreq"
-Add a Ethernet address filtering rule to the bridge on a specific
-interface. The argument structure is as follows:
+Add a Ethernet address filtering rule to the bridge on a specific interface.
+The argument structure is as follows:
.Bd -literal -offset indent
.Ed
.It Dv SIOCBRDGFRL
.Pq Li "struct ifbrlreq"
Remove all filtering rules from a bridge interface member.
-.Ar ifbr_name
+.Fa ifbr_name
contains the name of the bridge device, and
-.Ar ifbr_ifsname
+.Fa ifbr_ifsname
contains the name of the bridge member interface.
.It Dv SIOCBRDGGRL
.Pq Li "struct ifbrlconf"
Retrieve all of the rules from the bridge,
-.Ar ifbrl_name ,
+.Fa ifbrl_name ,
for the member interface,
-.Ar ifbrl_ifsname .
-
+.Fa ifbrl_ifsname .
This request takes an
-.Ar ifbrlconf
+.Li ifbrlconf
structure (see below) as a value result parameter.
The
-.Ar ifbrl_len
+.Fa ifbrl_len
field should be initially set to the size of the buffer pointed to by
-.Ar ifbrl_buf .
+.Fa ifbrl_buf .
On return, it will contain the length, in bytes, of the configuration list.
Alternatively, if the
-.Ar ifbrl_len
-passed in is set to 0, SIOCBRDGGRL will set it to the size that
-.Ar ifbrl_buf
+.Fa ifbrl_len
+passed in is set to 0,
+.Dv SIOCBRDGGRL
+will set it to the size that
+.Fa ifbrl_buf
needs to be to fit the entire configuration list and not fill in the other
parameters.
-As with SIOCBRDGIFS, this is useful for determining the exact size that
-.Ar ifbrl_buf
+As with
+.Dv SIOCBRDGIFS ,
+this is useful for determining the exact size that
+.Fa ifbrl_buf
needs to be in advance.
.Pp
The argument structure is defined as follows:
@@ -363,9 +373,9 @@ struct ifbrlconf {
.It Dv SIOCBRDGARL
.Pq Li "struct ifbrlreq"
Add a filtering rule to the bridge named in
-.Ar ifbr_name
+.Fa ifbr_name
on the interface named in
-.Ar ifbr_ifsname .
+.Fa ifbr_ifsname .
The argument structure is as follows:
.Bd -literal -offset indent
struct ifbrlreq {
@@ -388,66 +398,66 @@ Rules are applied in the order in which they were added to the bridge,
and the first matching rule's action parameter determines the fate of
the packet.
The
-.Ar ifbr_action
+.Fa ifbr_action
parameter specifies whether a frame matching the rule is to
be blocked or passed.
.Pp
If the
-.Ar BRL_FLAG_IN
+.Dv BRL_FLAG_IN
bit is set in
-.Ar ifbr_flags ,
+.Fa ifbr_flags ,
then the rule applies to frames received by the interface.
If the
-.Ar BRL_FLAG_OUT
-bit is set,
-then the rule applies to frame transmitted by the interface.
+.Dv BRL_FLAG_OUT
+bit is set, then the rule applies to frame transmitted by the interface.
At least one of
-.Ar BRL_FLAG_IN
+.Dv BRL_FLAG_IN
or
-.Ar BRL_FLAG_OUT
+.Dv BRL_FLAG_OUT
must be set.
.Pp
The source Ethernet address in
-.Ar ifbr_src
+.Fa ifbr_src
is checked if the
-.Ar BRL_FLAG_SRCVALID
+.Dv BRL_FLAG_SRCVALID
bit is set in
-.Ar ifbr_flags .
+.Fa ifbr_flags .
The destination address in
-.Ar ifbr_dst
+.Fa ifbr_dst
is check if the
-.Ar BRL_FLAG_DSTVALID
+.Dv BRL_FLAG_DSTVALID
bit is set.
If neither bit is set, the rule is matches all frames.
.It Dv SIOCBRDGFRL
.Pq Li "struct ifbrlreq"
Flush rules from the bridge
-.Ar ifbr_name
+.Fa ifbr_name
on the interface
-.Ar ifbr_ifsname .
+.Fa ifbr_ifsname .
.It Dv SIOCBRDGGRL
.Pq Li "struct ifbrlconf"
-Retrieve an array of rules from the bridge for a
-particular interface. This request takes an
-.Ar ifbrlconf
+Retrieve an array of rules from the bridge for a particular interface.
+This request takes an
+.Li ifbrlconf
structure (see below) as a value-result parameter.
The
-.Ar ifbrl_len
+.Fa ifbrl_len
field should be initially set to the size of the buffer
pointed to by
-.Ar ifbrl_buf .
+.Fa ifbrl_buf .
On return it will contain the length, in bytes, of the rule list.
Alternatively, if the
-.Ar ifbrl_len
+.Fa ifbrl_len
passed in is set to 0,
-SIOCBRDGGRL will set
-.Ar ifbrl_len
+.Dv SIOCBRDGGRL
+will set
+.Fa ifbrl_len
to the size that
-.Ar ifbrl_buf
+.Fa ifbrl_buf
needs to be to fit the entire configuration list,
and will not fill in the other parameters.
This is useful for determining the exact size that
-.Ar ifbrl_buf
+.Fa ifbrl_buf
needs to be in advance.
.Pp
The argument structure is as follows:
@@ -495,8 +505,11 @@ in the down state.
Super-user privilege is required to add and delete interfaces to and from
bridges and to set the bridge interface flags.
.It Bq Eq EFAULT
-The buffer used in a SIOCBRDGIFS or SIOCBRDGRTS request points outside
-of the process's allocated address space.
+The buffer used in a
+.Dv SIOCBRDGIFS
+or
+.Dv SIOCBRDGRTS
+request points outside of the process's allocated address space.
.It Bq Eq ESRCH
No such member interface in the bridge.
.El
@@ -509,13 +522,6 @@ No such member interface in the bridge.
.Xr netintro 4 ,
.Xr bridgename.if 5 ,
.Xr brconfig 8
-.Sh HISTORY
-The
-.Xr brconfig 8
-command and the
-.Xr bridge 4
-kernel interface first appeared in
-.Ox 2.5 .
.Sh AUTHORS
The
.Xr brconfig 8
@@ -525,9 +531,17 @@ kernel interface were written by
.An Jason L. Wright Aq jason@thought.net
as part of an undergraduate independent study at the
University of North Carolina at Greensboro.
+.Sh HISTORY
+The
+.Xr brconfig 8
+command and the
+.Xr bridge 4
+kernel interface first appeared in
+.Ox 2.5 .
.Sh BUGS
-There is currently no loop detection. Care must be taken to make sure
-that loops are not created when a bridge is brought up.
+There is currently no loop detection.
+Care must be taken to ensure that loops are not created when a bridge
+is brought up.
.Pp
Only
.Xr ipf 4
diff --git a/share/man/man4/ccd.4 b/share/man/man4/ccd.4
index 4a11f0ef7af..1a195555f36 100644
--- a/share/man/man4/ccd.4
+++ b/share/man/man4/ccd.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ccd.4,v 1.13 2000/03/29 01:28:56 deraadt Exp $
+.\" $OpenBSD: ccd.4,v 1.14 2000/12/21 05:32:52 aaron Exp $
.\" $NetBSD: ccd.4,v 1.5 1995/10/09 06:09:09 thorpej Exp $
.\"
.\" Copyright (c) 1994 Jason Downs.
@@ -38,7 +38,7 @@
.Os
.Sh NAME
.Nm ccd
-.Nd Concatenated Disk Driver
+.Nd concatenated disk driver
.Sh SYNOPSIS
.Cd "pseudo-device ccd 4"
.Sh DESCRIPTION
@@ -54,14 +54,18 @@ configuration file, and how to partition disks.
Note that the
.Sq raw
partitions of the disks
-.Pa should not
-be combined. Each component partition should be offset at least one
-cylinder from the beginning of the component disk. This avoids potential
-conflicts between the component disk's disklabel and the
+.Em should not
+be combined.
+Each component partition should be offset at least one
+cylinder from the beginning of the component disk.
+This avoids potential conflicts between the component disk's disklabel and the
.Nm ccd Ns 's
-disklabel. The kernel wants to only allow component partitions of type FS_CCD,
+disklabel.
+The kernel wants to only allow component partitions of type
+.Dv FS_CCD ,
but due to disklabel restrictions on some architectures will also accept
-component partitions of FS_BSDFFS.
+component partitions of
+.Dv FS_BSDFFS .
.Pp
In order to compile in support for the ccd, you must add a line similar
to the following to your kernel configuration file:
@@ -70,9 +74,10 @@ pseudo-device ccd 4 # concatenated disk devices
.Ed
.Pp
The count argument is how many
-.Nm ccds
-memory is allocated for at boot time. In this example, no more than 4
-.Nm ccds
+.Nm ccd Ns No 's
+memory is allocated for at boot time.
+In this example, no more than 4
+.Nm ccd Ns No 's
may be configured.
.Pp
A
@@ -84,27 +89,38 @@ If a
.Nm
is interleaved correctly, a
.Dq striping
-effect is achieved, which can increase performance. Finding the optimum
-interleave factor is a hard problem. Some things to think about are the
-number of disks in the ccd, the typical readahead opportunities, the
-filesystem blocksize and if it's possible to use the optimized ccd I/O
-protocol. The optimized protocol allows smaller interleave factors for a
+effect is achieved, which can increase performance.
+Finding the optimum interleave factor is a hard problem.
+Some things to think about are the number of disks in the ccd,
+the typical readahead opportunities, the filesystem blocksize, and if
+it's possible to use the optimized ccd I/O protocol.
+The optimized protocol allows smaller interleave factors for a
comparably cheap price but requires that the factor be a multiple of the
-software page size (CLBYTES), and that mirroring is not requested. So far the
-best policy is to test with different interleaves and benchmark typical uses.
+software page size
+.Pf ( Dv CLBYTES ) ,
+and that mirroring is not requested.
+So far the best policy is to test with different interleaves and
+benchmark typical uses.
A rule of thumb might be to use the software pagesize with the optimized
I/O protocol (the default, unless the requirements mentioned above are not
-fulfilled) or MAXBSIZE / #components with the unoptimized protocol.
-Since the interleave factor is expressed in units of DEV_BSIZE, one must
-account for sector sizes other than DEV_BSIZE in order to calculate the
-correct interleave. The kernel will not allow an interleave factor less than
-the size of the largest component sector divided by DEV_BSIZE.
+fulfilled) or
+.Dv MAXBSIZE /
+#components with the unoptimized protocol.
+Since the interleave factor is expressed in units of
+.Dv DEV_BSIZE ,
+one must account for sector sizes other than
+.Dv DEV_BSIZE
+in order to calculate the correct interleave.
+The kernel will not allow an interleave factor less than the size
+of the largest component sector divided by
+.Dv DEV_BSIZE .
.Pp
Note that best performance is achieved if all component disks have the same
-geometry and size. Optimum striping cannot occur with different disk types.
+geometry and size.
+Optimum striping cannot occur with different disk types.
.Pp
There is a run-time utility that is used for configuring
-.Nm ccds .
+.Nm ccd Ns No 's .
See
.Xr ccdconfig 8
for more information.
@@ -115,13 +131,13 @@ fails, the entire
file system will be lost.
.Sh FILES
/dev/{,r}ccd* - ccd device special files.
-.Sh HISTORY
-The concatenated disk driver was originally written at the University of
-Utah.
.Sh SEE ALSO
.Xr MAKEDEV 8 ,
.Xr ccdconfig 8 ,
.Xr config 8 ,
.Xr fsck 8 ,
.Xr mount 8 ,
-.Xr newfs 8 .
+.Xr newfs 8
+.Sh HISTORY
+The concatenated disk driver was originally written at the University of
+Utah.
diff --git a/share/man/man4/cd.4 b/share/man/man4/cd.4
index c553a028b4d..c4b2cf5fc93 100644
--- a/share/man/man4/cd.4
+++ b/share/man/man4/cd.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: cd.4,v 1.7 1999/11/13 04:07:56 angelos Exp $
+.\" $OpenBSD: cd.4,v 1.8 2000/12/21 05:32:52 aaron Exp $
.\" $NetBSD: cd.4,v 1.3 1996/10/20 23:15:21 explorer Exp $
.\"
.\" Copyright (c) 1996
@@ -38,30 +38,26 @@
.Sh DESCRIPTION
The
.Nm cd
-driver provides support for a
-.Tn SCSI
-.Tn CD-ROM
-(Compact Disc-Read Only Memory) drive.
+driver provides support for a SCSI CD-ROM (Compact Disc-Read Only Memory)
+drive.
In an attempt to look like a regular disk, the
.Nm
driver synthesizes a partition table, with one partition covering the entire
-.Tn CD-ROM .
+CD-ROM.
It is possible to modify this partition table using
.Xr disklabel 8 ,
-but it will only last until the
-.Tn CD-ROM
-is unmounted.
+but it will only last until the CD-ROM is unmounted.
In general the interfaces are similar to those described by
.Xr wd 4
and
.Xr sd 4 .
.Pp
-As the
-.Tn SCSI
-adapter is probed during boot, the
-.Tn SCSI
-bus is scanned for devices. Any devices found which answer as `Read-only'
-type devices will be `attached' to the
+As the SCSI adapter is probed during boot, the SCSI bus is scanned for devices.
+Any devices found which answer as
+.Dq Read-only
+type devices will be
+.Dq attached
+to the
.Nm
driver.
.Pp
@@ -70,37 +66,26 @@ The system utility
may be used to read the synthesized
disk label
structure, which will contain correct figures for the size of the
-.Tn CD-ROM
-should that information be required.
+CD-ROM should that information be required.
.Sh KERNEL CONFIGURATION
-Any number of
-.Tn CD-ROM
-devices may be attached to the system regardless of system
+Any number of CD-ROM devices may be attached to the system regardless of system
configuration as all resources are dynamically allocated.
.Sh IOCTLS
The following
.Xr ioctl 2
-calls which apply to
-.Tn SCSI
-.Tn CD-ROM
-drives are defined
-in the header files
+calls which apply to SCSI CD-ROM drives are defined in the header files
.Aq Pa sys/cdio.h
and
.Aq Pa sys/disklabel.h .
.Pp
-.Bl -tag -width CDIOCREADSUBCHANNEL -compact
-.It Dv DIOCGDINFO
-.It Dv DIOCSDINFO
+.Bl -tag -width Ds
+.It Dv DIOCGDINFO , Dv DIOCSDINFO
.Pq Li "struct disklabel"
-Read or write the in-core copy of the disklabel for the
-drive. The disklabel is initialized with information
-read from the
-.Tn SCSI
-inquiry commands, and should be the same as
-the information printed at boot. This structure is defined in
+Read or write the in-core copy of the disklabel for the drive.
+The disklabel is initialized with information read from the SCSI inquiry
+commands, and should be the same as the information printed at boot.
+This structure is defined in
.Xr disklabel 5 .
-
.\".It Dv CDIOCCAPABILITY
.\".Pq Li "struct ioc_capability"
.\"Retrieve information from the drive on what features it supports. The
@@ -166,8 +151,8 @@ the information printed at boot. This structure is defined in
.\".Ed
.It Dv CDIOCPLAYTRACKS
.Pq Li "struct ioc_play_track"
-Start audio playback given a track address and length. The structure
-is defined as follows:
+Start audio playback given a track address and length.
+The structure is defined as follows:
.Bd -literal -offset indent
struct ioc_play_track {
u_char start_track;
@@ -176,22 +161,22 @@ struct ioc_play_track {
u_char end_index;
};
.Ed
-
.It Dv CDIOCPLAYBLOCKS
.Pq Li "struct ioc_play_blocks"
-Start audio playback given a block address and length. The structure
-is defined as follows:
+Start audio playback given a block address and length.
+The structure is defined as follows:
.Bd -literal -offset indent
struct ioc_play_blocks {
int blk;
int len;
};
.Ed
-
.It Dv CDIOCPLAYMSF
.Pq Li "struct ioc_play_msf"
-Start audio playback given a `minutes-seconds-frames' address and
-length. The structure is defined as follows:
+Start audio playback given a
+.Dq minutes-seconds-frames
+address and length.
+The structure is defined as follows:
.Bd -literal -offset indent
struct ioc_play_msf {
u_char start_m;
@@ -202,7 +187,6 @@ struct ioc_play_msf {
u_char end_f;
};
.Ed
-
.It Dv CDIOCREADSUBCHANNEL
.Pq Li "struct ioc_read_subchannel"
Read information from the subchannel at the location specified by this
@@ -222,11 +206,10 @@ struct ioc_read_subchannel {
struct cd_sub_channel_info *data;
};
.Ed
-
.It Dv CDIOREADTOCHEADER
.Pq Li "struct ioc_toc_header"
-Return summary information about the table of contents for the mounted
-.Tn CD-ROM .
+Return summary information about the table of contents for the
+mounted CD-ROM.
The information is returned into the following structure:
.Bd -literal -offset indent
struct ioc_toc_header {
@@ -235,11 +218,11 @@ struct ioc_toc_header {
u_char ending_track;
};
.Ed
-
.It Dv CDIOREADTOCENTRYS
.Pq Li "struct ioc_read_toc_entry"
-Return information from the table of contents entries mentioned. (Yes, this
-command name is misspelled.) The argument structure is defined as follows:
+Return information from the table of contents entries mentioned.
+(Yes, this command name is misspelled.)
+The argument structure is defined as follows:
.Bd -literal -offset indent
struct ioc_read_toc_entry {
u_char address_format;
@@ -252,70 +235,48 @@ The requested data is written into an area of size
.Li data_len
and pointed to by
.Li data .
-
.It Dv CDIOCSETPATCH
.Pq Li "struct ioc_patch"
-Attach various audio channels to various output channels. The
-argument structure is defined thusly:
+Attach various audio channels to various output channels.
+The argument structure is defined thusly:
.Bd -literal -offset indent
struct ioc_patch {
u_char patch[4];
/* one for each channel */
};
.Ed
-
-.It Dv CDIOCGETVOL
-.It Dv CDIOCSETVOL
+.It Dv CDIOCGETVOL , Dv CDIOSETVOL
.Pq Li "struct ioc_vol"
-Get (set) information about the volume settings of the output channels. The
-argument structure is as follows:
+Get (set) information about the volume settings of the output channels.
+The argument structure is as follows:
.Bd -literal -offset indent
struct ioc_vol {
u_char vol[4];
/* one for each channel */
};
.Ed
-
.It Dv CDIOCSETMONO
Patch all output channels to all source channels.
-
.It Dv CDIOCSETSTEREO
Patch left source channel to the left output channel and the right
source channel to the right output channel.
-
.It Dv CDIOCSETMUTE
Mute output without changing the volume settings.
-
-.It Dv CDIOCSETLEFT
-.It Dv CDIOCSETRIGHT
+.It Dv CDIOCSETLEFT , Dv CDIOCSETRIGHT
Attach both output channels to the left (right) source channel.
-
-.It Dv CDIOCSETDEBUG
-.It Dv CDIOCCLRDEBUG
+.It Dv CDIOCSETDEBUG , Dv CDIOCCLRDEBUG
Turn on (off) debugging for the appropriate device.
-
-.It Dv CDIOCPAUSE
-.It Dv CDIOCRESUME
+.It Dv CDIOCPAUSE , Dv CDIOCRESUME
Pause (resume) audio play, without resetting the location of the read-head.
-
.It Dv CDIOCRESET
Reset the drive.
-
-.It Dv CDIOCSTART
-.It Dv CDIOCSTOP
-Tell the drive to spin-up (-down) the
-.Tn CD-ROM .
-
-.It Dv CDIOCALLOW
-.It Dv CDIOCPREVENT
-Tell the drive to allow (prevent) manual ejection of the
-.Tn CD-ROM
-disc. Not all drives support this feature.
-
+.It Dv CDIOCSTART , Dv CDIOCSTOP
+Tell the drive to spin-up (-down) the CD-ROM.
+.It Dv CDIOCALLOW , Dv CDIOCPREVENT
+Tell the drive to allow (prevent) manual ejection of the CD-ROM disc.
+Not all drives support this feature.
.It Dv CDIOCEJECT
-Eject the
-.Tn CD-ROM .
-
+Eject the CD-ROM.
.\".It Dv CDIOCCLOSE
.\"Tell the drive to close its door and load the media. Not all drives
.\"support this feature.
@@ -334,55 +295,45 @@ Eject the
.\" short speed;
.\"};
.\".Ed
-
.It Dv FIBMAP
Return the physical block number (in 512-byte sectors) given the
-logical block number. The argument is a pointer to an integer. On
-invocation, it should contain the logical block. On return, it
-contains the physical block number.
+logical block number.
+The argument is a pointer to an integer.
+On invocation, it should contain the logical block.
+On return, it contains the physical block number.
.El
.Pp
In addition the general
.Xr scsi 4
ioctls may be used with the
.Nm
-driver, if used against the `whole disk' partition (i.e.
+driver, if used against the `whole disk' partition (i.e.,
.Pa /dev/rcd0c ) .
.Sh NOTES
-When a
-.Tn CD-ROM
-is changed in a drive controlled by the
+When a CD-ROM is changed in a drive controlled by the
.Nm
driver, then the act of changing the media will invalidate the
-disklabel and information held within the kernel. To stop corruption,
-all accesses to the device will be discarded until there are no more
-open file descriptors referencing the device. During this period, all
-new open attempts will be rejected. When no more open file descriptors
-reference the device, the first next open will load a new set of
-parameters (including disklabel) for the drive.
+disklabel and information held within the kernel.
+To stop corruption, all accesses to the device will be discarded until
+there are no more open file descriptors referencing the device.
+During this period, all new open attempts will be rejected.
+When no more open file descriptors reference the device, the first next open
+will load a new set of parameters (including disklabel) for the drive.
.Pp
The audio code in the
.Nm
-driver only supports
-.Tn SCSI-2
-standard audio commands. Because many
-.Tn CD-ROM
-manufacturers have not followed the standard, there are many
-.Tn CD-ROM
-drives for which audio will not work. Some work is planned to support
-some of the more common `broken'
-.Tn CD-ROM
-drives; however, this is not yet under way.
+driver only supports SCSI-2 standard audio commands.
+Because many CD-ROM manufacturers have not followed the standard, there are
+many CD-ROM drives for which audio will not work.
+Some work is planned to support some of the more common
+.Dq broken
+CD-ROM drives; however, this is not yet under way.
.Sh FILES
.Bl -tag -width /dev/rcd[0-9][a-h] -compact
.It Pa /dev/cd[0-9][a-h]
-block mode
-.Tn CD-ROM
-devices
+block mode CD-ROM devices
.It Pa /dev/rcd[0-9][a-h]
-raw mode
-.Tn CD-ROM
-devices
+raw mode CD-ROM devices
.El
.Sh DIAGNOSTICS
None.
@@ -391,6 +342,10 @@ None.
.Xr sd 4 ,
.Xr disklabel 5 ,
.Xr disklabel 8
+.Sh HISTORY
+The
+.Nm
+driver appeared in 386BSD 0.1.
.Sh BUGS
The names of the structures used for the third argument to
.Fn ioctl
@@ -398,7 +353,3 @@ were poorly chosen, and a number of spelling errors have survived in
the names of the
.Fn ioctl
commands.
-.Sh HISTORY
-The
-.Nm
-driver appeared in 386BSD 0.1.
diff --git a/share/man/man4/clnp.4 b/share/man/man4/clnp.4
index abfe711eb84..54c440426c8 100644
--- a/share/man/man4/clnp.4
+++ b/share/man/man4/clnp.4
@@ -46,21 +46,16 @@
.Ft int
.Fn socket AF_ISO SOCK_RAW 0
.Sh DESCRIPTION
-.Tn CLNP
-is the connectionless-mode network protocol used by the
-connectionless-mode network service. This protocol is specified in
-.Tn ISO
-8473.
-It may be accessed
-through a
+CLNP is the connectionless-mode network protocol used by the
+connectionless-mode network service.
+This protocol is specified in ISO 8473.
+It may be accessed through a
.Dq raw socket
for debugging purposes only.
-.Tn CLNP
-sockets are connectionless,
-and are normally used with the
-.Xr sendto
+CLNP sockets are connectionless, and are normally used with the
+.Xr sendto 2
and
-.Xr recvfrom
+.Xr recvfrom 2
calls, though the
.Xr connect 2
call may also be used to fix the destination for future
@@ -74,16 +69,11 @@ or
.Xr send 2
system calls may be used).
.Pp
-Outgoing packets automatically have a
-.Tn CLNP
-header prepended to
-them. Incoming packets received by the user contain the full
-.Tn CLNP
-header.
+Outgoing packets automatically have a CLNP header prepended to them.
+Incoming packets received by the user contain the full CLNP header.
The following
.Xr setsockopt
-options apply to
-.Tn CLNP :
+options apply to CLNP:
.Bl -tag -width CLNPOPT_FLAGS
.It Dv CLNPOPT_FLAGS
Sets the flags which are passed to clnp when sending a datagram.
@@ -91,29 +81,25 @@ Valid flags are:
.Pp
.Bl -tag -width "CLNP_NO_CKSUM" -offset indent -compact
.It Dv CLNP_NO_SEG
-Do not allow segmentation
+Do not allow segmentation.
.It Dv CLNP_NO_ER
-Suppress ER pdus
+Suppress ER pdus.
.It Dv CLNP_NO_CKSUM
-Do not generate the
-.Tn CLNP
-checksum
+Do not generate the CLNP checksum.
.El
.Pp
.It Dv CLNPOPT_OPTS
-Sets
-.Tn CLNP
-options. The options must be formatted exactly as specified by
-.Tn ISO
-8473, section 7.5
+Sets CLNP options.
+The options must be formatted exactly as specified by ISO 8473, section 7.5.
.Dq Options Part.
-Once an option has been set, it will
-be sent on all packets until a different option is set.
+Once an option has been set, it will be sent on all packets until
+a different option is set.
.El
.Sh CONGESTION EXPERIENCE BIT
Whenever a packet is transmitted, the globally unique quality of
-service option is added to the packet. The sequencing preferred bit and
-the low transit delay bit are set in this option.
+service option is added to the packet.
+The sequencing preferred bit and the low transit delay bit are set in
+this option.
.Pp
If a packet is forwarded containing the globally unique quality of
service option, and the interface through which the packet will be
@@ -160,9 +146,7 @@ When specifying unsupported options.
.Xr netintro 4
.Sh BUGS
Packets are sent with the type code of 0x1d (technically an invalid
-packet type) for lack of a better way to identify raw
-.Tn CLNP
-packets.
+packet type) for lack of a better way to identify raw CLNP packets.
.Pp
No more than
.Dv MLEN
diff --git a/share/man/man4/cmpci.4 b/share/man/man4/cmpci.4
index 34862c0affc..6116538e84d 100644
--- a/share/man/man4/cmpci.4
+++ b/share/man/man4/cmpci.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: cmpci.4,v 1.3 2000/07/12 22:00:04 deraadt Exp $
+.\" $OpenBSD: cmpci.4,v 1.4 2000/12/21 05:32:52 aaron Exp $
.\"
.Dd April 26, 2000
.Dt CMPCI 4
@@ -15,9 +15,6 @@ The
driver supports the C-Media CMI8338A, CMI8338B, and CMI8738
sound chips present in some PCI sound cards and some integrated
PC motherboard chipsets (such as the SiS 530).
-.Sh BUGS
-The MIDI and Joystick ports are not supported. Neither OPL nor SPDIF
-functionality is currently supported.
.Sh SEE ALSO
.Xr audio 4
.Sh HISTORY
@@ -25,3 +22,6 @@ The
.Nm
device driver appeared in
.Ox 2.7 .
+.Sh BUGS
+The MIDI and Joystick ports are not supported.
+Neither OPL nor SPDIF functionality is currently supported.
diff --git a/share/man/man4/cnw.4 b/share/man/man4/cnw.4
index 3c8f20e1fbb..de1e0152093 100644
--- a/share/man/man4/cnw.4
+++ b/share/man/man4/cnw.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: cnw.4,v 1.3 1999/10/06 12:54:24 fgsch Exp $
+.\" $OpenBSD: cnw.4,v 1.4 2000/12/21 05:32:52 aaron Exp $
.\"
.\" Copyright (c) 1999 Federico G. Schwindt.
.\" All rights reserved.
@@ -43,15 +43,24 @@ The wireless domain number and scrambling key can be specified by the
following kernel configuration options:
.Bl -tag -width indent
.It Cd CNW_DOMAIN=value
-Selects what access point(s) to talk to, by their domain number. Values
-from 0 to 0x1ff are valid; 0x100 is the default if this option is not
-defined.
+Selects what access point(s) to talk to, by their domain number.
+Values from
+.Li 0
+to
+.Li 0x1ff
+are valid;
+.Li 0x100
+is the default if this option is not defined.
.It Cd CNW_SCRAMBLEKEY=value
-Selects the scramble key for domains that are scrambled. Values from
-0 to 0x1ff are valid; 0 (no scrambling) is the default if this option
-is not defined.
-.Sh BUGS
-Multicasting or receiver promiscuity is not supported yet.
+Selects the scramble key for domains that are scrambled.
+Values from
+.Li 0
+to
+.Li 0x1ff
+are valid;
+.Li 0
+(no scrambling)
+is the default if this option is not defined.
.Sh SEE ALSO
.Xr netintro 4 ,
.Xr pcmcia 4 ,
@@ -63,3 +72,5 @@ The
.Nm
device driver appeared in
.Ox 2.6 .
+.Sh BUGS
+Multicasting or receiver promiscuity is not supported yet.
diff --git a/share/man/man4/cy.4 b/share/man/man4/cy.4
index 0f149ebe6dd..622ab5aad75 100644
--- a/share/man/man4/cy.4
+++ b/share/man/man4/cy.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: cy.4,v 1.3 2000/10/18 02:38:21 aaron Exp $
+.\" $OpenBSD: cy.4,v 1.4 2000/12/21 05:32:52 aaron Exp $
.\"
.\" Copyright (c) 1993 Andrew Herbert.
.\" All rights reserved.
@@ -36,8 +36,8 @@
.Cd "cy1 at pci?"
.Sh DESCRIPTION
This driver provides an interface to Cyclades Cyclom-4Y, Cyclom-8Y and
-Cyclom-16Y asynchronous multiport serial boards. These boards are based
-around Cirrus Logic CD1400 communication controllers.
+Cyclom-16Y asynchronous multiport serial boards.
+These boards are based around Cirrus Logic CD1400 communication controllers.
.Pp
The device minor numbers for this driver are encoded as follows:
.Pp
@@ -46,7 +46,7 @@ The device minor numbers for this driver are encoded as follows:
bits meaning
---- -------
- uuuu physical serial line (i.e. unit) to use
+ uuuu physical serial line (i.e., unit) to use
0-7 on a cyclom-8Y, 0-15 on a cyclom-16Y
xx unused
@@ -61,17 +61,18 @@ The device minor numbers for this driver are encoded as follows:
.Sh DIAGNOSTICS
.Bl -diag
.It "cy%d: tty input queue overflow"
-Incoming characters have been discarded due to a buffer overflow. This is
-caused by the process in control of the device not read(2)ing characters
-fast enough.
+Incoming characters have been discarded due to a buffer overflow.
+This is caused by the process in control of the device not
+.Xr read 2 Ns No 'ing
+characters fast enough.
.It "cy%d: receive fifo overrun"
-Incoming characters have been discarded due to a CD1400 channel overrun. This
-is caused by interrupts not being serviced sufficiently quickly to prevent
-the 12 byte receive FIFO on a serial channel from overflowing. Reducing
-the value of the \fIRxFifoThreshold\fR #define from 8 to something smaller may
-help slow machines avoid this problem. The driver must have been compiled
-with the \fILogOverruns\fR option defined (the default) in order for this
-condition to be logged.
+Incoming characters have been discarded due to a CD1400 channel overrun.
+This is caused by interrupts not being serviced sufficiently quickly to prevent
+the 12 byte receive FIFO on a serial channel from overflowing.
+Reducing the value of the \fIRxFifoThreshold\fR #define from 8 to something
+smaller may help slow machines avoid this problem.
+The driver must have been compiled with the \fILogOverruns\fR option
+defined (the default) in order for this condition to be logged.
.Sh SEE ALSO
.Xr com 4 ,
.Xr termios 4 ,
@@ -86,8 +87,9 @@ were derived from the fas 2.10 driver by Uwe Doering
Evans <bde@kralizec.zeta.org.au>.
.Pp
This work was made possible through the donation of a Cyclom-8Y board by the
-manufacturer, Cyclades Corporation. However, neither Cyclades nor the author
-make any warranties regarding this software, nor guarantees of support.
+manufacturer, Cyclades Corporation.
+However, neither Cyclades nor the author make any warranties regarding
+this software, nor guarantees of support.
.Sh BUGS
There is currently no BREAK handling - breaks are ignored.
There is no support for bad-character reporting, except via PARMRK.
diff --git a/share/man/man4/eap.4 b/share/man/man4/eap.4
index e1ed0d8a0b6..12a322fbc07 100644
--- a/share/man/man4/eap.4
+++ b/share/man/man4/eap.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: eap.4,v 1.5 2000/07/20 08:48:17 deraadt Exp $
+.\" $OpenBSD: eap.4,v 1.6 2000/12/21 05:32:52 aaron Exp $
.\" $NetBSD: eap.4,v 1.2 1998/05/06 19:14:06 augustss Exp $
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -44,11 +44,9 @@
The
.Nm
driver supports the older Ensoniq AudioPCI and other ES1370 based
-sound cards, as well as the Creative Labs SoundBlaster 128PCI. The
-driver also supports many revisions of the more modern Ensoniq
+sound cards, as well as the Creative Labs SoundBlaster 128PCI.
+The driver also supports many revisions of the more modern Ensoniq
AudioPCI 97 (ES1371).
-.Sh BUGS
-The "FM" DAC and MIDI port are not supported.
.Sh SEE ALSO
.Xr audio 4 ,
.XR ac97 4
@@ -57,4 +55,5 @@ The
.Nm
device driver appeared in
.Ox 2.6 .
-
+.Sh BUGS
+The "FM" DAC and MIDI port are not supported.