From d6617c93fd1d6ccb8948b7c78bee6c41750ef190 Mon Sep 17 00:00:00 2001 From: Ruslan Ermilov Date: Thu, 20 May 2004 16:40:06 +0000 Subject: [PATCH] Clean up language. Reviewed by: rik --- sbin/sconfig/sconfig.8 | 554 ++++++++++++++++++++++------------------- 1 file changed, 293 insertions(+), 261 deletions(-) diff --git a/sbin/sconfig/sconfig.8 b/sbin/sconfig/sconfig.8 index a169c4a4a10..d319797884e 100644 --- a/sbin/sconfig/sconfig.8 +++ b/sbin/sconfig/sconfig.8 @@ -1,150 +1,161 @@ +.\" Copyright (c) 2002-2004 Roman Kurakin +.\" Copyright (c) 2002-2004 Cronyx Engineering +.\" All rights reserved. +.\" +.\" This software is distributed with NO WARRANTIES, not even the implied +.\" warranties for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.\" +.\" Authors grant any other persons or organisations a permission to use, +.\" modify and redistribute this software in source and binary forms, +.\" as long as this message is kept with the software, all derivative +.\" works or modified versions. +.\" .\" $FreeBSD$ -.Dd November 21, 2003 +.Dd May 19, 2004 .Dt SCONFIG 8 i386 .Os .Sh NAME .Nm sconfig -.Nd channel configuration utility for Cronyx adapters +.Nd "channel configuration utility for Cronyx adapters" .Sh SYNOPSIS .Nm .Op Fl aimsxeftuc .Op Ar device -.Op Ar data rate options -.Op Ar protocol options ... -.Op Ar interface options ... +.Op Ar data_rate_options +.Op Ar protocol_options ... +.Op Ar interface_options ... .Sh DESCRIPTION The .Nm utility is used for configuring the channel options of the Cronyx adapters. -In asynchronous mode all the parameters should be set by standard +In asynchronous mode, all parameters should be set using the standard .Xr stty 1 -utility, with -.Nm -you could set only few of them (see below). +utility. +With +.Nm , +it is only possible to set some of them (see below). .Pp -Some of the options could be set only on free channels, that is the -corresponding network interface in -.Ar down -state in the synchronous mode, and in the asynchronous mode the asynchronous -terminal device +Some of the options can be set only on free channels, +that is when the corresponding network interface is in the +.Cm down +state in the synchronous mode, +and the terminal device .Pa /dev/tty* -closed. +is closed in asynchronous mode. .Pp -Other channel options could be changed +Other channel options can be changed .Dq "on the fly" . Generally, the channel options are set up during the operating system startup, -for example from the +for example, from the .Pa /etc/rc -file. +script. .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. +Note that not all options make sense in every particular case, +and an attempt to set some of them may hung up the channel +or the whole adapter. .\"-------------------------------------------------------------- .Ss "Information Options" -You can specify only one of these options. +Only one of these options can be specified. If information option is specified, .Nm -will show corresponding information and will ignore all other options, +will show the corresponding information and will ignore all other options, except .Ar device . -See also description of the -.Ar device . +See also the description of the +.Ar device +argument. .Bl -tag -width indent .It This will show settings of the channel. .It Fl a Print all settings of the channel. .It Fl i -Print interface settings, equal to the output of +Print interface settings, equal to the output of the .Xr ifconfig 8 utility. .It Fl m Print modem signal status. -The description of all signals can be found in -any document related to the modems. +The description of all signals can be found in any modem documentation. Only LE signal should be described. -If this signal is On, than some what use channel. -If it is Off, than channel is free. +If this signal is ON then the channel is busy. +If it is OFF then the channel is free. .It Fl s Print brief channel statistics. -This is general statistics. -See also -.Fl x , e , f , t +This is the generic statistics, +see also the +.Fl x , e , f , t , and .Fl u options. -For the description of output, see below. +For a description of the output, see below. .Pp This statistics is very useful if something goes wrong. -For example, if you -have no any interrupts, than you use interrupt that is not registered in BIOS -for use with ISA bus. +For example, if all interrupt counters are zero then the device +was configured to use an interrupt that was not registered in the +BIOS for use with the ISA bus. .It Fl x Print full channel statistics. -This options allows to see some more counters, +This options prints additinal counters, but with less precision than with the .Fl s option. .It Fl e Print brief E1/G703 statistics. -If you select this option, you will get -statistics accumulated for period of time equal to 15 minutes. -For the -description of output, see below. +If this option is selected, the +statistics accumulated over the last 15 minutes is printed. +For a description of the output, see below. .It Fl f Print full E1/G703 statistics. -This option shows all E1/G703 statistics that -shows previous option -.Pq Fl e , -but also total statistics for whole period of time and statistics for 24 -hours (if available). -For the description of output, see below. +This option shows all E1/G703 statistics that the +.Fl e +option shows, +plus total statistics for the whole period of time and statistics for +last 24 hours (if available). +For a description of the output, see below. .It Fl t Print brief E3/T3/STS-1 statistics. -If you select this option, you will -get statistics accumulated for period of time equal to 15 minutes. -For -the description of output, see below. +If this option is selected, the +statistics accumulated over the last 15 minutes is printed. +For a description of the output, see below. .It Fl u Print full E3/T3/STS-1 statistics. -This option shows all E3/T3/STS-1 -statistics that shows previous option -.Pq Fl t , -but also total statistics for whole period of time and statistics for 24 -hours (if available). -For the description of output, see below. +This option shows all E3/T3/STS-1 statistics that the +.Fl t +option shows, +plus total statistics for the whole period of time and statistics for +last 24 hours (if available). +For a description of the output, see below. .It Fl c Cleans all kind of statistics. .El .\"-------------------------------------------------------------- .Ss "Device Selection" -Device is equal to the name of the interface that is used for a name of -the interface that is sees +The device is selected using the name of the network interface, +as shown by .Xr ifconfig 8 . -The channel number depends on the order of loading drivers by the system. +The channel number depends on the order the drivers were loaded into the system. Sometimes people confuse channel number and adapter number because of the same spelling. -Adapter number appears in kernel context, channel number -in configuration context. +The adapter number appears in the kernel context, while the channel number +is in the configuration context. .Bl -tag -width indent .It -You can omit device name only if you want to get information. -This will cause -printing information about all available channels of Cronyx adapters. -In the -case you want to make some settings you MUST specify device name. -.It Li cx## +If the device name is omitted, +.Nm +will print information about all channels of all Cronyx adapters +available in the system. +If some settings need to be made, the device name must be specified. +.It Li cx Ns Ar ## This is the channel name for the Sigma family of Cronyx adapters. (ISA bus.) -.It Li ct## +.It Li ct Ns Ar ## This is the channel name for the Tau family of Cronyx adapters. (ISA bus.) -.It Li cp## +.It Li cp Ns Ar ## This is the channel name for the Tau-PCI family of Cronyx adapters. (PCI bus.) -.It Li ce## +.It Li ce Ns Ar ## This is the channel name for the Tau32-PCI family of Cronyx adapters. (PCI bus.) .El @@ -152,261 +163,278 @@ This is the channel name for the Tau32-PCI family of Cronyx adapters. .Ss "Data Rate Options" .Bl -tag -width indent .It Ar value -In case of nonzero value it will cause setting data rate to given value and -setting the internal clock source of the synchronization (in synchronous mode). -Zero value is equal to the -.Cm extclock . -The transmitted data (TXD) are synchronized using the internal on-board timing +A non-zero value will set the data rate to a given value +in asynchronous mode, +and will set the date rate and internal clock source of synchronization +in synchronous mode. +A zero value is equivalent to specifying the +.Cm extclock +option. +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 is used for direct -terminal-to-terminal communication, e.g., for connecting two computers together -in a synchronous mode via relatively short cable. +terminal-to-terminal communication, e.g., when connecting two computers together +in synchronous mode with a relatively short cable. This method should also be used for testing channels with an external loopback connector. .It Cm extclock -Set the external timing clock source of synchronous channels. -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). +Set the external timing clock source for synchronous channels. +External clock mode is the most commonly used method for connecting +external modem hardware. +In this mode, +the external timing signal is received on the TXCIN pin of the connector, +and it is used as a synchronization clock for transmitting data (TxD). +.Pp +Note: in +.Cm extclock +mode, the device cannot determine the value of the external timing clock +since it does not have the built-in clock gauge. .El .\"-------------------------------------------------------------- .Ss "Protocol Options" -Note. -These option could be set only if channel is free and they requires -specifying of the device name. +Note: these option can only be used on a free channel, and they require +specifying the device name. .Bl -tag -width indent .It Cm async -Set asynchronous protocol (or mode). -In this mode Cronyx adapters behave as a -usual serial devices and you may work with them using usual serial utilities. -All asynchronous settings are performed via serial configuration utilities. -With -.Nm -you may set only a few of them. -See also -.Xr stty 1 . (Only for Sigma family.) +Select the asynchronous protocol (or mode). +In this mode, Cronyx adapters behave as normal serial devices, +and standard serial communications utilities can be used to +work with them. +All asynchronous settings should be set using the standard +serial communications configuration utilities, e.g., +.Xr stty 1 . +With +.Nm , +it is only possible to set some of them. .It Cm cisco -Set the Cisco HDLC synchronous protocol. +Select the Cisco HDLC synchronous protocol. .It Cm fr -Set the Frame Relay synchronous protocol +Select the Frame Relay synchronous protocol .Tn ( ANSI T1.617 Annex D). .It Cm ppp -Set the PPP synchronous protocol. -Parameters to the PPP could be set by the -command -.Xr spppcontrol 8 . +Select the synchronous PPP protocol. +PPP parameters can be configured using the +.Xr spppcontrol 8 +utility. .It Sm Cm keepalive No = Bro Cm on , off Brc Sm -Turns on/off sending keepalive messages. -This option is used only for -synchronous PPP. -If this option is on, than PPP will periodically send -echo-request messages. -If it would not receive any echo-reply messages for -some (definite) period of time it will break connection. -It is used for -tracking line state. +Turn on/off transmission of keepalive messages. +This option is used only for synchronous PPP. +If this option is +.Cm on , +PPP will periodically send ECHO-REQUEST messages. +If it will not receive any ECHO-REPLY messages for +some (definite) period of time it will break the connection. +It is used for tracking the line state. .It Cm idle -You are using Netgraph. -Protocol depends on connected module. +This mode is reported when using Netgraph. +An actual protocol depends on the type of a connected Netgraph node, +and it cannot be changed with +.Nm . .El .\"-------------------------------------------------------------- .Ss "Interface Options" -Not all of these options could be set on running channel and not all of them -are suits to all kind of adapters/channels. -In all dual state options off is -default value. -All this options is not applicable in asynchronous mode, except +Not all of these options can be set on a busy channel, and not all of them +are applicable to all kinds of adapters/channels. +For all dual-state options, +.Cm off +is the default value. +None of these options can be used in the asynchronous mode, +except for the .Cm debug option. .Bl -tag -width indent .It Sm Cm port No = Bro Cm rs232 , v35 , rs449 Brc Sm -Set port type for old Sigma models. +Set the port type for old Sigma models. .It Sm Cm cfg No = Bro Cm A , B , C Brc Sm -Set configuration for the adapter. -This option could be set only for Tau/E1 -and Tau/G703 and only if all channels are not running. +Set the configuration for the adapter. +This option can be used only with Tau/E1 +and Tau/G703 adapters, and only if all channels are free. .Bl -tag -width ".Cm cfg Ns = Ns Cm A" .It Cm cfg Ns = Ns Cm A Two independent E1/G703 channels. -This is default setting. +This is the default setting. .It Cm cfg Ns = Ns Cm B (Only for ISA models.) -For Tau/G703 this mean one G703 channel and one digital channel. -For Tau/E1 first physical channel divides on to subchannels. -One of them -goes to the first logical channel and another one goes to the second physical -channel. -Second (logical) channel is digital channel. +For Tau/G703 this means one G703 channel and one digital channel. +For Tau/E1, the first physical channel is divided into two subchannels. +One of them goes to the first logical channel, another one goes to the +second physical channel. +Second (logical) channel is the digital channel. .It Cm cfg Ns = Ns Cm C -This configuration is used only for E1 models. -In this case first +(Only for E1 models.) +In this mode, first physical channel consists of three data flows. -Two of them go to two -(logical) channels. +Two of them go to the two (logical) channels. The last one goes to the second physical channel. -On new -models (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1) this configuration means single source -of synchronization and passing all unused (in both channels) timeslots from -one channel to other. +On newer models (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1), +this programs the hardware to use a single source of synchronization +and pass all unused (in both channels) timeslots from +one channel to another. .El .Pp -For the detailed description of the configuration see -your documentation to the adapter. -This option could not be set on running -channel. +For a detailed description of available configuration modes, +see the adapter documentation. +This option cannot be set on a busy channel. .It Sm Cm loop No = Bro Cm on , off Brc Sm Turn on/off internal loopback. -This mode is useful for testing. -Switch on this -option and try to send something. -If you have no any interrupt, than, probably, -you forgot to switch using IRQ for PCI to ISA bus. -Check your BIOS settings. +This mode is useful for debugging. +When this mode is +.Cm on , +some data should be sent. +If no interrupts are generated, chances are that +the corresponding IRQ configuration entry in the BIOS +was not switched from +.Dq Li "PCI/ISA PNP" +to +.Dq Li "Legacy ISA" . .It Sm Cm rloop No = Bro Cm on , off Brc Sm (Only for Tau32-PCI and Tau-PCI/E3.) -Turn on/off remote loopback. -This mode is also useful for testing. +Turn on/off remote loopback feature. +This mode is also useful for debugging. .It Sm Cm dpll No = Bro Cm on , off Brc Sm Turn on/off digital phase locked loop mode (DPLL). When enabled, the receiver timing clock signal is derived from the received data. -Must be used with NRZI -encoding, to avoid the synchronization loss. +Must be used with the NRZI +encoding to avoid the synchronization loss. .It Sm Cm nrzi No = Bro Cm on , off Brc Sm -Turn on/off nrzi encoding. -In off state nrz encoding is used. +Turn on/off NRZI encoding. +If +.Cm off , +NRZ encoding is used. .Bl -tag -width "NRZI" .It NRZ -the zero -bit is transmitted by the zero signal level, the one bit - by the positive -signal level. +The zero bit is transmitted by the zero signal level, +the one bit is transmitted by the positive signal level. .It NRZI -the bit number zero is transmitted by the change of the -signal level, the one bit - by the constant signal level. -.El -.Pp -Commonly is used with +The zero bit is transmitted by the change of the signal +level, the one bit is by the constant signal level. +Commonly used with the .Cm dpll Ns = Ns Cm on option. +.El .It Sm Cm invclk No = Bro Cm on , off Brc Sm -Invert the both transmit and receive clock signals (Tau and Tau-PCI only). +(Tau and Tau-PCI only.) +Invert both the transmit and receive clock signals. .It Sm Cm invrclk No = Bro Cm on , off Brc Sm -Invert the receive clock signals (Tau-PCI only). +(Tau-PCI only.) +Invert the receive clock signals. .It Sm Cm invtclk No = Bro Cm on , off Brc Sm -Invert the transmit clock signals (Tau-PCI only). +(Tau-PCI only.) +Invert the transmit clock signals. .It Sm Cm higain No = Bro Cm on , off Brc Sm -Turn on/off increasing the E1 receiver non linear sensitivity to -30 dB (E1 -only). +(E1 only.) In of state the sensitivity is -12 dB. -This allows increasing line -distance. +Turn on/off increasing the E1 receiver's non-linear sensitivity to -30dB. +This allows increasing of the line distance. .It Sm Cm cablen No = Bro Cm on , off Brc Sm -(Only for Tau-PCI/T3 and Tau-PCI/STS-1.) -Turn on/off adjusting transmit signal for long cable T3/STS-1. +(Tau-PCI/T3 and Tau-PCI/STS-1 only.) +Turn on/off adjusting of the transmit signal for a long cable T3/STS-1. .It Sm Cm monitor No = Bro Cm on , off Brc Sm -Turn on/off increasing the E1 receiver lines sensitivity to -30 dB. (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.) -This could be used for interception -purposes. +Turn on/off increasing of the E1 receiver's linear sensitivity to -30dB. +This can be used for the interception purposes. .It Sm Cm phony No = Bro Cm on , off Brc Sm -Turn on/off the so-called phony mode. (Tau32-PCI and Tau-PCI E1 family only.) +Turn on/off the so-called +.Dq phony +mode. This mode allows -receiving raw CEPT frames from E1 line. -Raw frames could be accessed, for -example, via raw protocol. -Packets would come at rate of 500 frames per second +receiving raw CEPT frames from the E1 line. +Raw frames can be accessed, for example, with the raw protocol. +Packets would come at a rate of 500 frames per second with length .No 16* Ns Ar N (for Tau-PCI/E1 model), where .Ar N is the number of timeslots. For -Tau-PCI/2E1 and Tau-PCI/4E1 N should be equal to 32 independently from number of +Tau-PCI/2E1 and Tau-PCI/4E1, +.Ar N +should be equal to 32 regardless of the number of used timeslots. .It Sm Cm unfram No = Bro Cm on , off Brc Sm -Turn on/off unframed mode. (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.) +Turn on/off unframed mode. .Bl -tag -width ".Cm unfram Ns = Ns Cm off" .It Cm unfram Ns = Ns Cm on -switches channel to unframed G.703 mode. +Switch channel to the unframed G.703 mode. .It Cm unfram Ns = Ns Cm off -switches channel to framed E1 (G.704 mode). +Switch channel to the framed E1 (G.704) mode. .El .It Sm Cm scrambler No = Bro Cm on , off Brc Sm -Turn on/off the scrambling of G.703 data. -(Tau32-PCI, Tau-PCI/G.703 and Tau-PCI/2E1, +(Tau32-PCI, Tau-PCI/G.703, Tau-PCI/2E1, and Tau-PCI/4E1 in unframed mode only.) +Turn on/off scrambling of the G.703 data. .It Sm Cm use16 No = Bro Cm on , off Brc Sm -Turn on/off the usage of 16-th timeslot for data transmission. (Tau32-PCI and Tau-PCI E1 family only.) -Normally 16th timeslot is used for signaling information (multiframing CAS). +Turn on/off the usage of the 16th timeslot for data transmission. +Normally, the 16th timeslot is used for signalling information +(multiframing CAS). .It Sm Cm crc4 No = Bro Cm on , off Brc Sm -Turn on/off CRC4 superframe mode. (E1 only.) +Turn on/off CRC4 superframe mode. .It Sm Cm syn No = Bro Cm int , rcv , rcv0 , rcv1 , rcv2 , rcv3 Brc Sm .Bl -tag -width ".Cm rcv3" .It Cm int -use an internal clock generator for G703 transmitter +Use an internal clock generator for G703 transmitter (clock master). .It Cm rcv -use the G703 receiver data clock as the transmit clock +Use the G703 receiver data clock as the transmit clock (clock slave). .It Cm rcv0 , rcv1 , rcv2 , rcv3 -use the G703 receiver clock of the other channel +Use the G703 receiver clock of the other channel (E1 models only). .El .It Cm dir Ns = Ns Ar number -Binds logical channel to the physical channel. (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.) -Using this parameter you could, for example, split E1 physical channel -into several channels. +Bind a logical channel to a physical channel. +Using this parameter it is possible, for example, to split +physical E1 channel into several logical channels. .It Cm ts Ns = Ns Ar interval -Set up the list of timeslots to use by the channel (E1 only). -The -timeslots are numbered from 1 to 31, and are separated by comma or minus sign, +(E1 only.) +Set up the list of timeslots for use by the channel. +The timeslots are numbered from 1 to 31, +and are separated by a comma or a minus sign, giving an interval. -For example: +Example: .Dq Li ts=1-3,5,17 . .It Cm pass Ns = Ns Ar interval +(Tau/E1 only.) Set up the list of timeslots, translated to the E1 subchannel in .Cm cfg Ns = Ns Cm B and .Cm cfg Ns = Ns Cm C configurations. -(Tau/E1 only.) .It Sm Cm debug No = Bro Cm 0 , 1 , 2 Brc Sm Turn on/off debug messages. .Bl -tag -width 2n .It Cm 0 -turn off debug messages. +Turn debug messages off. .It Cm 1 -turn on debug -messages, equal to the +Turn debug messages on, equivalent to the .Cm debug -option to the +option of the .Xr ifconfig 8 utility. .It Cm 2 -high intensive debug message, developers only. +High intensive debug messages, for developers only. .El .El .\"-------------------------------------------------------------- .Sh EXAMPLES -Set up the channel 1 for use with the HDSL modem or any other +Set up channel 1 for use with the HDSL modem or any other synchronous leased-line modem, and PPP/HDLC protocol (for Sigma): .Bd -literal -offset indent sconfig cx1 ppp extclock ifconfig cx1 158.250.244.2 158.250.244.1 up .Ed .Pp -Set up the channel 0 of Tau/E1 for use with the Cisco protocol -over E1 link, with the single virtual connection. +Set up channel 0 of Tau/E1 for use with the Cisco protocol +over the E1 link, with a single virtual connection. The DLCI number is detected automatically. Use timeslots 1-10: .Bd -literal -offset indent @@ -414,14 +442,14 @@ sconfig ct0 cisco ts=1-10 ifconfig ct0 158.250.244.2 158.250.244.1 up .Ed .Pp -Set up the channel 0 for the synchronous null-modem link to the nearby computer, +Set up channel 0 for the synchronous null-modem link to the nearby computer, internal clock source, 256000 bits/sec, protocol Cisco/HDLC (for Tau): .Bd -literal -offset indent sconfig ct0 cisco 256000 ifconfig ct0 200.1.1.1 200.1.1.2 up .Ed .Pp -Set up the channel 1 for the leased line link using data-only +Set up channel 1 for the leased line link using the data-only null-modem cable (or modems like Zelax+ M115). Synchronous DPLL mode, 128000 bits/sec, protocol PPP/HDLC, NRZI encoding (for Sigma): @@ -431,56 +459,59 @@ ifconfig cx1 158.250.244.2 158.250.244.1 up .Ed .\"-------------------------------------------------------------- .Sh DIAGNOSTICS -This section contains description of abbreviations used by +This section contains a description of abbreviations used by .Nm while displaying various statistics. -For description of options connected with -statistics see above. +For a description of options related to +statistics, please see above. .\"-------------------------------------------------------------- .Ss Statistics -When running, the driver gathers the statistics about the channels, which -could be accessed via the +When running, the driver gathers statistics about the channels, which +can be accessed using the .Nm -utility or by +utility, +or through the .Xr ioctl 2 call .Dv SERIAL_GETSTAT . -.Bl -tag -width indent +.Pp +.Bl -tag -width indent -compact .It Va Rintr -The total number of receive interrupts. +Total number of receive interrupts. .It Va Tintr -The total number of transmit interrupts. +Total number of transmit interrupts. .It Va Mintr -The total number of modem interrupts. +Total number of modem interrupts. .It Va Ibytes -The total bytes received. +Total bytes received. .It Va Ipkts -The total packets received (for HDLC mode). +Total packets received (for HDLC mode). .It Va Ierrs -The number of receive errors. +Number of receive errors. .It Va Obytes -The total bytes transmitted. +Total bytes transmitted. .It Va Opkts -The total packets transmitted (for HDLC mode). +Total packets transmitted (for HDLC mode). .It Va Oerrs -The number of transmit errors. +Number of transmit errors. .El .\"-------------------------------------------------------------- .Ss E1/G.703 Statistics -For E1 and G.703 channels the SNMP-compatible statistics data are gathered +For E1 and G.703 channels, the SNMP-compatible statistics data are gathered (see RFC 1406). -It could be accessed via the +It can be accessed using the .Nm -utility or by +utility, +or through the .Xr ioctl 2 call .Dv SERIAL_GETESTAT . -.Bl -tag -width indent +.Bl -tag -width ".Va RCRC Pq Va rcrce" .It Va Unav Pq Va uas -Unavailable seconds - receiving all ones, or loss of carrier, or loss of +Unavailable seconds: receiving all ones, loss of carrier, or loss of signal. .It Va Degr Pq Va dm -Degraded minutes - having error rate more than 10e-6, not counting unavailable +Degraded minutes: having error rate more than 10E-6, not counting unavailable and severely errored seconds. .It Va Bpv Pq Va bpv HDB3 bipolar violation errors. @@ -491,29 +522,30 @@ CRC4 errors (E1). .It Va RCRC Pq Va rcrce Remote CRC4 errors: E-bit counter (E1). .It Va Err Pq Va es -Errored seconds - any framing errors, or out of frame sync, or any slip events. +Errored seconds: any framing errors, or out of frame sync, or any slip events. .It Va Lerr Pq Va les -Line errored seconds - any BPV. +Line errored seconds: any BPV. .It Va Sev Pq Va ses -Severely errored seconds - 832 or more framing errors, or 2048 or more bipolar +Severely errored seconds: 832 or more framing errors, or 2048 or more bipolar violations. .It Va Bur Pq Va bes -Bursty errored seconds - more than 1 framing error, but not severely errored. +Bursty errored seconds: more than 1 framing error, but not severely errored. .It Va Oof Pq Va oofs -Severely errored framing seconds - out of frame sync. +Severely errored framing seconds: out of frame sync. .It Va Slp Pq Va css -Controlled slip second \[em] any slip buffer overflow or underflow. +Controlled slip seconds: any slip buffer overflow or underflow. .El .\"-------------------------------------------------------------- .Ss E1/G.703 Status The .Nm utility also prints the E1/G.703 channel status. -The status could have the -following values (nonexclusive): -.Bl -tag -width indent +The status can have the +following values (non-exclusive): +.Pp +.Bl -tag -width ".Li FARLOMF" -compact .It Li Ok -The channel is in valid state, synchronized. +The channel is in a valid state, synchronized. .It Li LOS Loss of sync. .It Li AIS @@ -525,7 +557,7 @@ Loss of multiframing (E1 only). .It Li FARLOF Receiving remote alarm (E1 only). .It Li AIS16 -Receiving all ones in timeslot 16 (E1 only). +Receiving all ones in the timeslot 16 (E1 only). .It Li FARLOMF Receiving distant multiframe alarm (E1 only). .It Li TSTREQ @@ -543,33 +575,33 @@ Test error (G.703 only). .Xr spppconrol 8 .\"-------------------------------------------------------------- .Sh HISTORY -This utility is a replacement of utilities +This utility is a replacement for the .Nm cxconfig and .Nm ctconfig -that was used in past with +utilities that were used in the past with .Fx drivers. -Those two utilities and the present -utility are not compatible. -And therefore all scripts should be rewritten. -More over, +Those two utilities and +.Nm +are not compatible, +and therefore all scripts using them have to be rewritten. +Moreover, .Tn Linux and .Fx -version of present utility not fully compatible. +versions of the +.Nm +utility are not fully compatible. +.\"-------------------------------------------------------------- +.Sh AUTHORS +.An Cronyx Engineering Aq info@cronyx.ru +.Pp +.Pa http://www.cronyx.ru .\"-------------------------------------------------------------- .Sh BUGS All software produced by Cronyx Engineering is thoroughly tested. -But -as created by the man it can contain some bugs. -If you have caught one, try to localize it and send a letter with description -of this bug and all operation that you have done. -We will try to reproduce -an error and fix it. -.\"-------------------------------------------------------------- -.Sh CONTACT -E-mail: -.Aq info@cronyx.ru -.Pp -.Pa http://www.cronyx.ru +But as created by a man, it can contain some bugs. +If you have caught one, try to localize it and send an email with the +description of the bug, and all operations that you have done. +We will try to reproduce the error and fix it.