diff options
Diffstat (limited to 'share')
-rw-r--r-- | share/man/man4/bridge.4 | 216 | ||||
-rw-r--r-- | share/man/man4/ccd.4 | 74 | ||||
-rw-r--r-- | share/man/man4/cd.4 | 191 | ||||
-rw-r--r-- | share/man/man4/clnp.4 | 58 | ||||
-rw-r--r-- | share/man/man4/cmpci.4 | 8 | ||||
-rw-r--r-- | share/man/man4/cnw.4 | 29 | ||||
-rw-r--r-- | share/man/man4/cy.4 | 34 | ||||
-rw-r--r-- | share/man/man4/eap.4 | 11 |
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. |