Convert to mdoc format.

1 files changed, 178 insertions, 152 deletions

diff --git a/sbin/i386/cxconfig/cxconfig.8 b/sbin/i386/cxconfig/cxconfig.8
index 9907435..e250483 100644
--- a/sbin/i386/cxconfig/cxconfig.8
+++ b/sbin/i386/cxconfig/cxconfig.8
@@ -1,107 +1,119 @@
-.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 cxconfig
-\- channel options management utility for Cronyx-Sigma adapter
-.SH DESCRIPTION
-.PP
-The \fBcxconfig\fP utility is used for configuring the channel options of
+.Dd "December 2, 1994"
+.Dt CXCONFIG 8
+.Os FreeBSD
+.Sh NAME
+.Nm cxconfig
+.Nd channel options management utility for Cronyx-Sigma adapter
+.Sh DESCRIPTION
+.Pp
+The 
+.Nm
+utility is used for configuring the channel options of
 the Cronyx-Sigma adapter.
-.PP
-To change cha options the channel should be free: the corresponding
-network interface in ``down'' state, the asynchronous terminal device /dev/tty*
+.Pp
+To change channel options the channel should be free: the corresponding
+network interface in ``down'' state, the asynchronous terminal device 
+.Pa /dev/tty*
 closed.
 Generally, the channel options are set up during the operating
-system startup, for example from the \fI/etc/rc\fP file.
-.PP
+system startup, for example from the 
+.Pa /etc/rc
+file.
+.Pp
 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.
-.SH "Usage"
-.IP "cxconfig"
+.Sh "Usage"
+.Bl -tag -width 10n
+.It "cxconfig"
 The brief information about all channels.
-.IP "cxconfig -a"
+.It "cxconfig -a"
 The full information about all channels.
-.IP "cxconfig <channel>"
+.It "cxconfig <channel>"
 The brief information about the channel.
-.IP "cxconfig -a <channel>"
+.It "cxconfig -a <channel>"
 The full information about the channel.
-.IP "cxconfig <channel> <option>..."
+.It "cxconfig <channel> <option>..."
 Setting the channel options.
-.SH "Channel options"
-.IP ispeed=#
+.El
+.Sh "Channel options"
+.Bl -tag -width 10n
+.It ispeed=#
 Set the receiver baud rate to the number given.
 The maximal value is 256000 bits/sec.
 In the synchronous mode the receiver baud rate is significant
 only when DPLL mode is used.
-.IP ospeed=#
+.It ospeed=#
 Set the transmitter baud rate to the number given.
 The maximal value is 256000 bits/sec.
 In the synchronous mode the transmitter baud rate is significant
 only in the case of the internal clock source.
 If receiver and transmitter have equal data rate, then it could
 be set by specifying only the numerical argument.
-.IP async
+.It async
 Set the asynchronous channel mode.
-.IP "hdlc, bisync, bsc, x.21, x21
+.It "hdlc, bisync, bsc, x.21, x21
 Set the synchronous channel mode: HDLC, Bisync (BSC) or X.21.
-.IP ppp
-Set the link-level protocol: PPP/HDLC.  The built-in simplified synchronous PPP
+.It ppp
+Set the link-level protocol: PpP/HDLC.  The built-in simplified synchronous PPP
 implementation is used (see RFC-1548, RFC-1549).
-.IP cisco
+.It cisco
 Set the link-level protocol: Cisco/HDLC (see RFC-1547).
 This protocol is intended for compatibility with old models of Cisco routers,
 and with early versions of BSD/386 drivers.
 The extensive usage of this protocol is not recommended.
-.IP ext
+.It ext
 Use the external link-level protocol suite (for BSD/386 only).
-.IP "+keepalive, -keepalive"
+.It "+keepalive, -keepalive"
 Enable the automatic line state control sub-protocol.
 This setting is not significant when the external link-level protocol is used.
-.IP "+autorts, -autorts"
+.It "+autorts, -autorts"
 Enable the automatic RTS signal control.
 When enabled, the RTS signal goes up only when both halves of
 the receiver ring buffer are free and ready for receive,
 and goes down when one or both buffers are busy.
-.IP "port=rs232, port=rs449, port=v35
+.It "port=rs232, port=rs449, port=v35
 Set the zero channel hardware interface type.
-.SH "Common options"
-.IP "nrz, nrzi, manchester
+.El
+.Sh "Common options"
+.Bl -tag -width 10n
+.It "nrz, nrzi, manchester"
 Set the data line signal encoding.
-In the case of \fINRZ\fP encoding the zero bit is transmitted by the zero signal
+In the case of 
+.Em NRZ
+encoding the zero bit is transmitted by the zero signal
 level, the one bit - by the positive signal level.
-In the case of \fINRZI\fP encoding the zero bit is transmitted by the change of
+In the case of 
+.Em NRZI
+encoding the zero bit is transmitted by the change of
 the signal level, the one bit - by the constant signal level.
-In the case of \fIManchester\fP encoding the zero bit is encoded as 01 value,
+In the case of 
+.Em Manchester
+encoding the zero bit is encoded as 01 value,
 the one bit - as 10 value.
-.IP "+dpll, -dpll"
+.It "+dpll, -dpll"
 Enable the digital phase locked loop mode (DPLL).
 When enabled, the receiver timing clock signal
 is derived from the received data.
-.IP "+lloop, -lloop"
+.It "+lloop, -lloop"
 Set the local loopback mode.
-.IP "+extclock, -extclock"
+.It "+extclock, -extclock"
 Set the timing clock source of synchronous channels.  There are
-two possible variants: \fIexternal clock\fP source or \fIinternal clock\fP
+two possible variants: 
+.Em "external clock"
+source or 
+.Em "internal clock"
 generation.
-.br
-\fIExternal clock\fP mode is the most common method for connecting
+.Pp
+.Em"External clock"
+mode is the most common method for connecting
 external modem hardware.  In this mode the external timing
 signal is received on TXCIN pin of the connector, and it is
 used as a synchronization clock for transmitting data (TXD).
-.br
-In the case of \fIinternal clock\fP mode the transmitted data (TXD)
+.Pp
+In the case of 
+.Em "internal clock"
+mode the transmitted data (TXD)
 are synchronized using the internal on-board timing generator,
 the internally generated timing signal is driven on the TXCOUT
 pin, and the signal on the TXCIN pin is ignored.  This mode
@@ -109,189 +121,203 @@ is used for direct terminal-to-terminal communication,
 e.g. for connecting two computers together in a synchronous mode
 via relatively short cable.  This method should also be used
 for testing channels with an external loopback connector.
-.IP fifo=#
+.It fifo=#
 FIFO threshold level setup for receiver and transmitter.
-.IP rfifo=#
+.It rfifo=#
 Hardware RTS/CTS flow control FIFO threshold setup.
-.IP "+ctsup, -ctsup"
+.It "+ctsup, -ctsup"
 Enable/disable interrupts on CTS (Clear To Send) signal setup (0 to 1 transition).
-.IP "+ctsdown, -ctsdown"
+.It "+ctsdown, -ctsdown"
 Enable/disable interrupts on CTS (Clear To Send) signal clear (1 to 0 transition).
-.IP "+cdup, -cdup"
+.It "+cdup, -cdup"
 Enable/disable interrupts on CD (Carrier Detect) signal setup (0 to 1 transition).
-.IP "+cddown, -cddown"
+.It "+cddown, -cddown"
 Enable/disable interrupts on CD (Carrier Detect) signal clear (1 to 0 transition).
-.IP "+dsrup, -dsrup"
+.It "+dsrup, -dsrup"
 Enable/disable interrupts on DSR (Data Set Ready) signal setup (0 to 1 transition).
-.IP "+dsrdown, -dsrdown"
+.It "+dsrdown, -dsrdown"
 Enable/disable interrupts on DSR (Data Set Ready) signal clear (1 to 0 transition).
-.SH "Asynchronous mode options"
-.IP cs#
+.El
+.Sh "Asynchronous mode options"
+.Bl -tag -width 10n
+.It cs#
 Select character size: 5, 6, 7 or 8 bits.
-.IP "parodd, pareven
+.It "parodd, pareven
 Parity mode: odd or even.
-.IP "+ignpar, -ignpar
+.It "+ignpar, -ignpar
 Disable/enable parity detection.
-.IP nopar
+.It nopar
 Disable parity bit generation.
-.IP forcepar
+.It forcepar
 Force parity: even - 0, odd - 1.
-.IP "stopb1, stopb1.5, stopb2
+.It "stopb1, stopb1.5, stopb2
 Use 1 or 1.5 or 2 stop bits per character.
-.IP "+dsr, -dsr"
+.It "+dsr, -dsr"
 Use the DSR input signal as receiver enable/disable.
-.IP "+cts, -cts"
+.It "+cts, -cts"
 Use the CTS input signal as transmitter enable/disable.
-.IP "+rts, -rts"
+.It "+rts, -rts"
 Drive the RTS output signal as transmitter ready.
-.IP "+rloop, -rloop"
+.It "+rloop, -rloop"
 Set the remote loopback mode.
-.IP "+etc, -etc"
+.It "+etc, -etc"
 Enable the embedded transmit commands mode.
-.IP "+ixon, -ixon"
+.It "+ixon, -ixon"
 Enable the hardware XON/XOFF flow control support.
-.IP "+ixany, -ixany"
+.It "+ixany, -ixany"
 Use the hardware IXANY mode support.
-.IP "+sdt, -sdt"
+.It "+sdt, -sdt"
 Detect the spec. characters SCHR1 and SCHR2 in the receive data.
-.IP "+flowct, -flowct"
+.It "+flowct, -flowct"
 Receive the flow control spec. characters as data.
-.IP "+rdt, -rdt"
+.It "+rdt, -rdt"
 Detect the spec. characters in range SCRL..SCRH in the receive data.
-.IP "+exdt, -exdt"
+.It "+exdt, -exdt"
 Detect the spec. characters SCHR3 and SCHR4 in the receive data.
-.IP "parintr, parnull, parign, pardisc, parffnull
+.It "parintr, parnull, parign, pardisc, parffnull
 Action on parity errors:
-.ES
-  Mode       Action
- -----------------------------------------------------
-  parintr    Generate the receiver error interrupt
-  parnull    Input the NULL character
-  parign     Ignore the error, receive as good data
-  pardisc    Ignore the character
-  parffnull  Input the sequence <0xFF, NULL, character>
-.EE
-.IP "brkintr, brknull, brkdisc
+.Pp
+.Bl -tag -width parffnullxxx -compact
+.It Mode
+Action
+.It parintr
+Generate the receiver error interrupt
+.It parnull
+Input the NULL character
+.It parign
+Ignore the error, receive as good data
+.It pardisc
+Ignore the character
+.It parffnull
+Input the sequence <0xFF, NULL, character>
+.El
+.It "brkintr, brknull, brkdisc
 Line break state action:
-.ES
-  Mode     Action
- ---------------------------------------------------
-  brkintr  Generate the receiver error interrupt
-  brknull  Input the NULL character
-  brkdisc  Ignore the line break state
-.EE
-.IP "+inlcr, -inlcr"
+.Pp
+.Bl -tag -width parffnullxxx -compact
+.It Mode
+Action
+.It brkintr
+Generate the receiver error interrupt
+.It brknull
+Input the NULL character
+.It brkdisc
+Ignore the line break state
+.El
+.It "+inlcr, -inlcr"
 Translate received NL characters to CR.
-.IP "+icrnl, -icrnl"
+.It "+icrnl, -icrnl"
 Translate received CR characters to NL.
-.IP "+igncr, -igncr"
+.It "+igncr, -igncr"
 Ignore received CR characters.
-.IP "+ocrnl, -ocrnl"
+.It "+ocrnl, -ocrnl"
 Translate transmitted CR characters to NL.
-.IP "+onlcr, -onlcr"
+.It "+onlcr, -onlcr"
 Translate transmitted NL characters to CR.
-.IP "+fcerr, -fcerr"
+.It "+fcerr, -fcerr"
 Process (don't process) the characters, received with errors,
 for special character/flow control matching.
-.IP "+lnext, -lnext"
+.It "+lnext, -lnext"
 Enable the LNEXT character option: the character following
 the LNEXT character is not processed for special character/flow
 control matching.
-.IP "+istrip, -istrip"
+.It "+istrip, -istrip"
 Strip input characters to seven bits.
-.IP schr1=#
+.It schr1=#
 The XON flow control character value.
-.IP schr2=#
+.It schr2=#
 The XOFF flow control character value.
-.IP schr3=#
+.It schr3=#
 The SCHR3 spec. character value.
-.IP schr4=#
+.It schr4=#
 The SCHR4 spec. character value.
-.IP "scrl=#, scrh=#
+.It "scrl=#, scrh=#
 The spec. character range (inclusive).
-.IP lnext=#
+.It lnext=#
 The LNEXT spec. character value.
-.SH "HDLC mode options"
-.IP if#
+.El
+.Sh "HDLC mode options"
+.Bl -tag -width 10n
+.It if#
 The minimum number of flags transmitted before a frame is started.
-.IP noaddr
+.It noaddr
 No frame address recognition.
-.IP "addrlen1, addrlen2"
+.It "addrlen1, addrlen2"
 Address field length: 1 or 2 bytes.
-.IP "addr1, addr2"
+.It "addr1, addr2"
 Addressing mode: 4x1 bytes or 2x2 bytes.
 Registers RFAR1..RFAR4 should contain the address to be matched.
-.IP "+clrdet, -clrdet"
+.It "+clrdet, -clrdet"
 Enable/disable clear detect for X.21 protocol support.
-.IP "+dsr, -dsr"
+.It "+dsr, -dsr"
 Use the DSR input signal as receiver enable/disable.
-.IP "+cts, -cts"
+.It "+cts, -cts"
 Use the CTS input signal as transmitter enable/disable.
-.IP "+rts, -rts"
+.It "+rts, -rts"
 Drive the RTS output signal as transmitter ready.
-.IP "+fcs, -fcs"
+.It "+fcs, -fcs"
 Enable/disable the frame checksum generation and checking.
-.IP "crc-16, crc-v.41
+.It "crc-16, crc-v.41
 Select the CRC polynomial: CRC-16 (x^16+x^15+x^2+1)
 or CRC V.41 (x^16+x^12+x^5+1).
-.IP "fcs-crc-16, fcs-v.41
+.It "fcs-crc-16, fcs-v.41
 Frame checksum preset: all zeros (CRC-16) or all ones (CRC V.41).
-.IP "+crcinv, -crcinv"
+.It "+crcinv, -crcinv"
 Invert (ie. CRC V.41) or don't invert (ie. CRC-16) the transmitted frame checksum.
-.IP "+fcsapd, -fcsapd"
+.It "+fcsapd, -fcsapd"
 Pass the received CRC to the host at the end of receiver data buffer.
-.IP "idlemark, idleflag
+.It "idlemark, idleflag
 Idle mode: idle in mark (transmit all ones) or idle in flag (transmit flag).
-.IP "+syn, -syn"
+.It "+syn, -syn"
 Enable/disable sending pad characters before sending flag when coming out
 of the idle mode.
-.IP pad#
+.It pad#
 The number of synchronous characters sent (0..4).
-.IP "syn=0xaa, syn=0x00
+.It "syn=0xaa, syn=0x00
 Send sync pattern.
-.IP "rfar1=#, rfar2=#, rfar3=#, rfar4=#
+.It "rfar1=#, rfar2=#, rfar3=#, rfar4=#
 Frame address registers for address recognition.
-.SH EXAMPLES
-.PP
+.El
+.Sh EXAMPLES
+.Pp
 Set up the channel 7 of the adapter Sigma-400 under FreeBSD.
 Physical 4-wire leased line with Zelax+ M115 short-range modems.
 Synchronous mode, 128000 bits/sec, interface RS-232,
-protocol PPP/HDLC without keepalive support, NRZI encoding,
+protocol PpP/HDLC without keepalive support, NRZI encoding,
 DPLL mode, no flow control:
-.ES
+.Bd -literal
 cxconfig cx7 128000 hdlc ppp -keepalive nrzi -cts +dpll -extclock
 ifconfig cx7 158.250.244.2 158.250.244.1 up
-.EE
-.PP
+.Ed
+.Pp
 Set up the channel 0 of the adapter Sigma-100 under FreeBSD.
 Attachment to the near computer by short cable, internal clock source.
 Synchronous mode, 256000 bits/sec, interface RS-232,
 protocol Cisco/HDLC with keepalive support:
-.ES
+.Bd -literal
 cxconfig cx0 hdlc 256000 cisco +keepalive -extclock
 ifconfig cx0 200.1.1.1 200.1.1.2 up
-.EE
-.PP
+.Ed
+.Pp
 Set up the channel 1 of the adapter Sigma-840 under BSD/386.
 Synchronous 64 kbit/sec leased line, external clock source.
 Synchronous mode, interface V.35, external protocol suite:
-.ES
+.Bd -literal
 cxconfig cx1 hdlc ext
 ifconfig cx1 193.124.254.50 193.124.254.49 multicast up
-.EE
-.PP
+.Ed
+.Pp
 Set up the channel 0 of the adapter Sigma-840 under FreeBSD.
 Attachment to the Cisco-4000 router by null-modem cable, internal clock source.
 Synchronous mode, 64000 bits/sec, interface RS-232,
-protocol PPP/HDLC with keepalive support and flow control,
+protocol PpP/HDLC with keepalive support and flow control,
 LCP and IPCP protocols (see RFC-1548 and RFC-1332) debug tracing enabled:
-.ES
+.Bd -literal
 cxconfig cx0 hdlc 64000 port=rs232 ppp +keepalive -extclock +cts
 ifconfig cx0 100.0.0.2 100.0.0.1 debug up
-.EE
-.SH FILES
-.IP /dev/cronyx
+.Ed
+.Sh FILES
+.Pa /dev/cronyx
 The special device file for adapter options management.
-.SH SEE ALSO
-.PP
-cx(4)
+.Sh SEE ALSO
+.Xr cx 4