diff options
Diffstat (limited to 'sbin/cxconfig/cxconfig.8')
-rw-r--r-- | sbin/cxconfig/cxconfig.8 | 330 |
1 files changed, 178 insertions, 152 deletions
diff --git a/sbin/cxconfig/cxconfig.8 b/sbin/cxconfig/cxconfig.8 index 9907435..e250483 100644 --- a/sbin/cxconfig/cxconfig.8 +++ b/sbin/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 |