Convert to mdoc format.

1 files changed, 187 insertions, 147 deletions

diff --git a/share/man/man4/man4.i386/cx.4 b/share/man/man4/man4.i386/cx.4
index 969b735..8f03d14 100644
--- a/share/man/man4/man4.i386/cx.4
+++ b/share/man/man4/man4.i386/cx.4
@@ -1,144 +1,180 @@
-.TH Cronyx-Sigma 1
-.rm ES
-.rm EE
-.de ES
-.PP
-.nf
-.in +0.5i
-..
-.de EE
-.in -0.5i
-.fi
-..
-.na
-.SH NAME
-.B cx
-\- asynchronous Cronyx-Sigma adapter driver
-.br
-.B if_cx
-\- synchronous Cronyx-Sigma adapter driver
-.SH CONFIGURATION
-.B
-device cx0 at isa? port 0x240 irq 15 drq 7
-.br
-.B
-device cx1 at isa? port 0x260 irq 12 drq 6
-.br
-.B
-pseudo-device sppp
-.P
+.Dd "December 12, 1994"
+.Dt CX 4 i386
+.Os FreeBSD
+.Sh NAME
+.Nm cx ,
+.Nm if_cx
+.Nd asynchronous/synchronous Cronyx-Sigma adapter driver
+.Sh CONFIGURATION
+.Cd "device cx0 at isa? port 0x240 irq 15 drq 7"
+.Cd "device cx1 at isa? port 0x260 irq 12 drq 6"
+.Cd pseudo-device sppp
+.Pp
 The base i/o port address should be set by jumpers on the board.
 The DMA i/o channel and interrupt request numbers are configured
 by software at adapter initialization.  Legal values are:
-.IP Port
+.Pp
+.Bl -tag -compact -width Port
+.It Port
 0x240, 0x260, 0x280, 0x300, 0x320, 0x380
-.IP IRQ
+.It IRQ
 3, 5, 7, 10, 11, 12, 15
-.IP DMA
+.It DMA
 5, 6, 7
-.SH DESCRIPTION
-.PP
+.Sh DESCRIPTION
 The Cronyx-Sigma driver supports the adapters of models 100,
 400, 500, 401, 404, 410, 440, 703, 801, 810, 840. Different models have
 different set of channels:
-.ES
- Model                  Channels
-----------------------------------------------
- Cronyx-Sigma-100       0
- Cronyx-Sigma-400       4, 5, 6, 7
- Cronyx-Sigma-500       0, 4, 5, 6, 7
- Cronyx-Sigma-401       0, 1, 2, 3
- Cronyx-Sigma-404       0, 1, 2, 3
- Cronyx-Sigma-410       0, 1, 2, 3
- Cronyx-Sigma-440       0, 1, 2, 3
- Cronyx-Sigma-703       0, 1, 2, 4, 5, 6, 7
- Cronyx-Sigma-801       0, 1, 2, 3, 4, 5, 6, 7
- Cronyx-Sigma-810       0, 1, 2, 3, 4, 5, 6, 7
- Cronyx-Sigma-840       0, 1, 2, 3, 4, 5, 6, 7
-.EE
-.PP
+.Pp
+.Bl -tag -compact -width Cronyx-Sigma-999
+.It Model
+Channels
+.It Cronyx-Sigma-100
+0
+.It Cronyx-Sigma-400
+4, 5, 6, 7
+.It Cronyx-Sigma-500       
+0, 4, 5, 6, 7
+.It Cronyx-Sigma-401       
+0, 1, 2, 3
+.It Cronyx-Sigma-404       
+0, 1, 2, 3
+.It Cronyx-Sigma-410       
+0, 1, 2, 3
+.It Cronyx-Sigma-440       
+0, 1, 2, 3
+.It Cronyx-Sigma-703       
+0, 1, 2, 4, 5, 6, 7
+.It Cronyx-Sigma-801       
+0, 1, 2, 3, 4, 5, 6, 7
+.It Cronyx-Sigma-810       
+0, 1, 2, 3, 4, 5, 6, 7
+.It Cronyx-Sigma-840       
+0, 1, 2, 3, 4, 5, 6, 7
+.El
+.Pp
 A pair of two adapters can be united together by the special
 short inter-board cable.  Two united adapters use the same
 IRQ and DMA channels and from the point of driver works
 as the single 16-channel multiplexer.  One of the united
 boards is ``master'' and the other is ``slave''.
-.PP
+.Pp
 The channels of the slave united board are numbered by the driver
 beginning with 8, for example, the united adapter of the model 100/500
 has channels 0, 8, 12, 13, 14, 15.
-.PP
+.Pp
 The channels which have the RS-232 interface can be used
 both in synchronous and asynchronous modes (software selectable
 by cxconfig utility) and hence are called ``universal'' channels.
-.PP
-The special device files (/dev/*) for the adapter Cronyx-Sigma
-are created by the command file ``/dev/MAKEDEV.cx''.
+.Pp
+The special device files,
+.Pa /dev/* ,
+for the adapter Cronyx-Sigma
+are created by th
+.Xr MAKEDEV 8
 An example:
-.ES
+.Bd -literal
 cd /dev
-sh MAKEDEV.cx cronyx ttyx0 ttyx1 ttyy0
-.EE
-.SH "Asynchronous driver"
-.PP
+sh MAKEDEV cronyx ttyx0 ttyx1 ttyy0
+.El
+.Sh "Asynchronous driver"
+.Pp
 The asynchronous channel device files have the names:
-/dev/ttyx# - for adapter cx0, /dev/ttyy# - for adapter cx1,
-/dev/ttyz# - for cx2.
-Here\ # is the channel number in hexadecimal form, 0-9-a-f.
-.PP
-The driver fulfills the following standard ioctl requests (see ioctl(2)):
-.IP TIOCSBRK
+.Pa /dev/ttyx# 
+- for adapter cx0, 
+.Pa /dev/ttyy# 
+- for adapter cx1,
+.Pa /dev/ttyz# 
+- for cx2.
+Here # is the channel number in hexadecimal form, 0-9-a-f.
+.Pp
+The driver fulfills the following standard ioctl requests (see 
+.Xr ioctl ) :
+.Pp
+.Bl -tag -width TIOCXXXXX -compact
+.It Dv TIOCSBRK
 Start sending BREAK.
-.IP TIOCCBRK
+.It Dv TIOCCBRK
 Stop sending BREAK.
-.IP TIOCSDTR
+.It Dv TIOCSDTR
 Set DTR signal (DTR := 1).  The DTR signal is always set
 on the first open(2) and could be changed by
-TIOCCDTR, TIOCSDTR, TIOCMSET, TIOCMBIS, TIOCMBIC ioctl calls.
-.IP TIOCCDTR
+.Dv TIOCCDTR ,
+.Dv TIOCSDTR , 
+.Dv TIOCMSET , 
+.Dv TIOCMBIS , 
+.Dv TIOCMBIC 
+ioctl calls.
+.It TIOCCDTR
 Clear DTR signal (DTR := 0).
-.IP TIOCMSET
+.It TIOCMSET
 Set the given values of DTR and RTS signals (<DTR:RTS> := data).
-The signals DTR and RTS are controlled by  TIOCM_DTR and TIOCM_RTS
+The signals DTR and RTS are controlled by
+.Dv TIOCM_DTR 
+and
+.DvTIOCM_RTS
 bits of the data argument of the ioctl system call.
-.IP TIOCMBIS
+.It TIOCMBIS
 Set DTR and RTS signals (<DTR:RTS> |= data).
-The signals DTR and RTS are controlled by  TIOCM_DTR and TIOCM_RTS
+The signals DTR and RTS are controlled by 
+.Dv TIOCM_DTR 
+and 
+.Dv TIOCM_RTS
 bits of the data argument of the ioctl system call.
-.IP TIOCMBIC
+.It TIOCMBIC
 Clear DTR and RTS signals (<DTR:RTS> &= ~data).
-The signals DTR and RTS are controlled by  TIOCM_DTR and TIOCM_RTS
+The signals DTR and RTS are controlled by 
+.Dv TIOCM_DTR
+and 
+.Dv TIOCM_RTS
 bits of the data argument of the ioctl system call.
-.IP TIOCMGET
+.It TIOCMGET
 Determine the state of the modem signals of the line.
 After the call the data argument contains the following bits:
-.ES
-TIOCM_LE  - always set (Line Enabled)
-TIOCM_DSR - Data Set Ready signal received
-TIOCM_CTS - Clear To Send signal received
-TIOCM_CD  - Data Carrier Detect signal received
-TIOCM_DTR - Data Terminal Ready signal transmitted
-TIOCM_RTS - Request To Send signal transmitted
-.EE
-.SH "Synchronous driver"
-.PP
+.Pp
+.Bl -tag -width TIOCM_XXX -compact
+.It TIOCM_LE 
+always set (Line Enabled)
+.It TIOCM_DSR 
+Data Set Ready signal received
+.It TIOCM_CTS 
+Clear To Send signal received
+.It TIOCM_CD  
+Data Carrier Detect signal received
+.It TIOCM_DTR 
+Data Terminal Ready signal transmitted
+.It TIOCM_RTS 
+Request To Send signal transmitted
+.El
+.El
+.Sh "Synchronous driver"
+.Pp
 The synchronous channels and universal channels, turned to the synchronous
-mode by the cxconfig(8) utility, are accessible as network
-interfaces named ``cx#'' where\ # is the channel number, 0..47.
-All standard network interface parameters could be set by ifconfig(8) utility.
-The cxconfig(8) command is used to change some extended channel
+mode by the 
+.Xr cxconfig 8
+utility, are accessible as network
+interfaces named ``cx#'' where # is the channel number, 0..47.
+All standard network interface parameters could be set by 
+.Xr ifconfig 8
+utility.
+The 
+.Xr cxconfig 8
+command is used to change some extended channel
 options, and also for setting the high-level software protocol
-(e.g. PPP or Cisco HDLC).
-.PP
+(e.g. PpP or Cisco HDLC).
+.Pp
 The universal channels could be used both in asynchronous and synchronous modes.
 By default the asynchronous mode is set.
-The mode could be changed by cxconfig(8) utility.
+The mode could be changed by 
+.Xr cxconfig 8
+utility.
 The mode is blocked while the channel is busy (an asynchronous channel
 in open state or the network interface is up).
-.SH "Synchronous Point-to-Point protocol"
-.PP
+.Sj "Synchronous Point-to-Point protocol"
+.Pp
 The Cronyx-Sigma driver uses the built-in implementation of the synchronous
 Point-to-Point protocol (sppp).  It includes the support for such
-protocols as PPP/HDLC and Cisco/HDLC, and also the automatic
+protocols as PpP/HDLC and Cisco/HDLC, and also the automatic
 connection loss test (via keepalive packets).
 The sppp protocol set is implemented as an independent module
 and could be used by other drivers of synchronous serial channels.
@@ -146,26 +182,33 @@ The version of the driver for BSD/386 (BSDI) operating system
 also supports the usage of the general set of synchronous
 protocols, implemented inside the OS.
 The external protocol set could be selected by ``cxconfig ext'' command
-(see cxconfig(8)).
-.SH "Channel Options Management"
-.PP
-The cxconfig(8) utility is used for setting the channels options.
+(see 
+.Xr cxconfig 8 ) .
+.Sh "Channel Options Management"
+.Pp
+The 
+.Xr cxconfig 8
+utility is used for setting the channels options.
 The channel options are generally set at the start of the operating
-system (for example, from the file /etc/rc).
+system (for example, from the file 
+.Pa /etc/rc ) .
 Note, that not all options have a sense for every particular
 case, and an attempt to set some of them can hang up the channel or
 the whole adapter.
-.PP
+.Pp
 The actual channel options control functions are implemented via
 the ioctl-s on the special device file /dev/cronyx.
 There are the following ioctl-s available:
-.IP CXIOCGETMODE
+.Pp
+.Bl -tag -width CXIOCXXXXXXX -compact
+.It CXIOCGETMODE
 Get the channel option values.
-.IP CXIOCSETMODE
+.It CXIOCSETMODE
 Set the channel option values.
-.PP
+.El
+.Pp
 The data argument of the ioctl call has an address of the options structure:
-.ES
+.Bd -literal
 typedef struct {
     unsigned char board;   /* adapter number, 0..2 */
     unsigned char channel; /* channel number, 0..15 */
@@ -181,59 +224,56 @@ typedef struct {
     cx_opt_x21_t xopt;     /* x.21 mode options */
     cx_soft_opt_t sopt;    /* software options and state flags */
 } cx_options_t;            /* user settable options */
-.EE
-.IP board
+.Ed
+.Pp
+.Bl -tag -width rxbaudxxx
+.It Fa board
 The adapter number, 0..2.
-.IP channel
+.It Fa channel
 The channel number, 0..15.
-.IP type
+.It Fa type
 The type of the channel (read-only argument).
-.IP iftype
+.It Fa iftype
 The interface type of the zero (and also the eight) channel: 0 - RS-232,
 1 - RS-449/V.35.
-.IP rxbaud
+.It Fa rxbaud
 The receiver data baud rate.
-.IP txbaud
+.It Fa txbaud
 The transmitter data baud rate.
-.IP mode
+.It Fa mode
 The channel mode: asynchronous/HDLC/Bisync/X.21.
-.IP opt
+.It Fa opt
 The general channel options.
-.IP aopt
+.It Fa aopt
 The asynchronous mode options.
-.IP hopt
+.It Fa hopt
 The HDLC mode options.
-.IP bopt
+.It Fa bopt
 The Bisync mode options.
-.IP xopt
+.It Fa xopt
 The X.21 mode options.
-.IP sopt
+.It Fa sopt
 The software protocol options.
-.SH FILES
-.PP
-/dev/cx??
-.IP
+.El
+.Sh FILES
+.Bl -tag -width /dev/cxXXXX -compact
+.It Pa /dev/cx??
 Asynchronous channels.
-.PP
-/dev/cronyx
-.IP
+.It Pa /dev/cronyx
+.El
 The special device file for the channel options management.
-.PP
-/sys/i386/isa/cronyx.c
-.br
-/sys/i386/isa/cx.c
-.br
-/sys/i386/isa/if_cx.c
-.br
-/sys/i386/isa/cronyx.h
-.br
-/sys/i386/isa/cxreg.h
-.br
-/sys/net/if_spppsubr.c
-.br
-/sys/net/if_sppp.h
-.IP
-The sources of the driver.
-.SH SEE ALSO
-.PP
-cxconfig(8)
+.Pp
+The sources for the driver reside in:
+.Pp
+.Bl -tag -width /dev/cxXXXX -compact
+.It Pa /sys/i386/isa/cronyx.c
+.It Pa /sys/i386/isa/cx.c
+.It Pa /sys/i386/isa/if_cx.c
+.It Pa /sys/i386/isa/cronyx.h
+.It Pa /sys/i386/isa/cxreg.h
+.It Pa /sys/net/if_spppsubr.c
+.It Pa /sys/net/if_sppp.h
+.El
+.Sh SEE ALSO
+.Xr cxconfig 8 ,
+.Xr ifconfig 8