d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Clean up language.

Browse Source 
Reviewed by:	rik
This commit is contained in:
ru 2004-05-20 16:40:06 +00:00
parent 5e189e571a
commit fb7ca181a0
1 changed files with 293 additions and 261 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

554
sbin/sconfig/sconfig.8
View File

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