Clean up language.
Reviewed by: rik
This commit is contained in:
Ruslan Ermilov
parent
5a8f125ad9
commit
d6617c93fd
@ -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$
|
||||
.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 <none>
|
||||
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 <none>
|
||||
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.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user