freebsd-dev/sbin/sconfig/sconfig.8

608 lines
19 KiB
Groff
Raw Normal View History

2004-05-20 16:40:06 +00:00
.\" 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$
2004-05-20 16:40:06 +00:00
.Dd May 19, 2004
2004-01-21 13:24:38 +00:00
.Dt SCONFIG 8 i386
2004-05-18 07:23:37 +00:00
.Os
.Sh NAME
.Nm sconfig
2004-05-20 16:40:06 +00:00
.Nd "channel configuration utility for Cronyx adapters"
.Sh SYNOPSIS
.Nm
.Op Fl aimsxeftuc
2004-05-18 07:23:37 +00:00
.Op Ar device
2004-05-20 16:40:06 +00:00
.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
2004-05-18 07:23:37 +00:00
adapters.
2004-05-20 16:40:06 +00:00
In asynchronous mode, all parameters should be set using the standard
.Xr stty 1
2004-05-20 16:40:06 +00:00
utility.
With
.Nm ,
it is only possible to set some of them (see below).
.Pp
2004-05-20 16:40:06 +00:00
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*
2004-05-20 16:40:06 +00:00
is closed in asynchronous mode.
.Pp
2004-05-20 16:40:06 +00:00
Other channel options can be changed
2004-05-18 07:23:37 +00:00
.Dq "on the fly" .
Generally, the channel options are set up during the operating system startup,
2004-05-20 16:40:06 +00:00
for example, from the
.Pa /etc/rc
2004-05-20 16:40:06 +00:00
script.
.Pp
2004-05-20 16:40:06 +00:00
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.
.\"--------------------------------------------------------------
2004-05-18 07:23:37 +00:00
.Ss "Information Options"
2004-05-20 16:40:06 +00:00
Only one of these options can be specified.
2004-05-18 07:23:37 +00:00
If information option is specified,
.Nm
2004-05-20 16:40:06 +00:00
will show the corresponding information and will ignore all other options,
except
2004-05-18 07:23:37 +00:00
.Ar device .
2004-05-20 16:40:06 +00:00
See also the description of the
.Ar device
argument.
2004-05-18 07:23:37 +00:00
.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
2004-05-20 16:40:06 +00:00
Print interface settings, equal to the output of the
2004-05-18 07:23:37 +00:00
.Xr ifconfig 8
utility.
.It Fl m
2004-05-18 07:23:37 +00:00
Print modem signal status.
2004-05-20 16:40:06 +00:00
The description of all signals can be found in any modem documentation.
2004-05-18 07:23:37 +00:00
Only LE signal should be described.
2004-05-20 16:40:06 +00:00
If this signal is ON then the channel is busy.
If it is OFF then the channel is free.
.It Fl s
2004-05-18 07:23:37 +00:00
Print brief channel statistics.
2004-05-20 16:40:06 +00:00
This is the generic statistics,
see also the
.Fl x , e , f , t ,
and
.Fl u
2004-05-18 07:23:37 +00:00
options.
2004-05-20 16:40:06 +00:00
For a description of the output, see below.
.Pp
2004-05-18 07:23:37 +00:00
This statistics is very useful if something goes wrong.
2004-05-20 16:40:06 +00:00
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
2004-05-18 07:23:37 +00:00
Print full channel statistics.
This options prints additional counters,
2004-05-18 07:23:37 +00:00
but with less precision than with the
.Fl s
option.
.It Fl e
2004-05-18 07:23:37 +00:00
Print brief E1/G703 statistics.
2004-05-20 16:40:06 +00:00
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
2004-05-18 07:23:37 +00:00
Print full E1/G703 statistics.
2004-05-20 16:40:06 +00:00
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
2004-05-18 07:23:37 +00:00
Print brief E3/T3/STS-1 statistics.
2004-05-20 16:40:06 +00:00
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
2004-05-18 07:23:37 +00:00
Print full E3/T3/STS-1 statistics.
2004-05-20 16:40:06 +00:00
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
2004-05-18 07:23:37 +00:00
Cleans all kind of statistics.
.El
.\"--------------------------------------------------------------
2004-05-18 07:23:37 +00:00
.Ss "Device Selection"
2004-05-20 16:40:06 +00:00
The device is selected using the name of the network interface,
as shown by
2004-05-18 07:23:37 +00:00
.Xr ifconfig 8 .
2004-05-20 16:40:06 +00:00
The channel number depends on the order the drivers were loaded into the system.
2004-05-18 07:23:37 +00:00
Sometimes people confuse channel number and adapter number because of the
same spelling.
2004-05-20 16:40:06 +00:00
The adapter number appears in the kernel context, while the channel number
is in the configuration context.
2004-05-18 07:23:37 +00:00
.Bl -tag -width indent
.It <none>
2004-05-20 16:40:06 +00:00
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 ##
2004-05-18 07:23:37 +00:00
This is the channel name for the Sigma family of Cronyx adapters.
(ISA bus.)
2004-05-20 16:40:06 +00:00
.It Li ct Ns Ar ##
2004-05-18 07:23:37 +00:00
This is the channel name for the Tau family of Cronyx adapters.
(ISA bus.)
2004-05-20 16:40:06 +00:00
.It Li cp Ns Ar ##
2004-05-18 07:23:37 +00:00
This is the channel name for the Tau-PCI family of Cronyx adapters.
(PCI bus.)
2004-05-20 16:40:06 +00:00
.It Li ce Ns Ar ##
2004-05-18 07:23:37 +00:00
This is the channel name for the Tau32-PCI family of Cronyx adapters.
(PCI bus.)
.El
.\"--------------------------------------------------------------
2004-05-18 07:23:37 +00:00
.Ss "Data Rate Options"
.Bl -tag -width indent
.It Ar value
2004-05-20 16:40:06 +00:00
A non-zero value will set the data rate to a given value
in asynchronous mode,
and will set the data rate and internal clock source of synchronization
2004-05-20 16:40:06 +00:00
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,
2004-05-18 07:23:37 +00:00
and the signal on the TXCIN pin is ignored.
This mode is used for direct
2004-05-20 16:40:06 +00:00
terminal-to-terminal communication, e.g., when connecting two computers together
in synchronous mode with a relatively short cable.
2004-05-18 07:23:37 +00:00
This method should also be
used for testing channels with an external loopback connector.
2004-05-18 07:23:37 +00:00
.It Cm extclock
2004-05-20 16:40:06 +00:00
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
.\"--------------------------------------------------------------
2004-05-18 07:23:37 +00:00
.Ss "Protocol Options"
2004-05-20 16:40:06 +00:00
Note: these option can only be used on a free channel, and they require
specifying the device name.
2004-05-18 07:23:37 +00:00
.Bl -tag -width indent
.It Cm async
(Only for Sigma family.)
2004-05-20 16:40:06 +00:00
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.
2004-05-18 07:23:37 +00:00
.It Cm cisco
2004-05-20 16:40:06 +00:00
Select the Cisco HDLC synchronous protocol.
2004-05-18 07:23:37 +00:00
.It Cm fr
2004-05-20 16:40:06 +00:00
Select the Frame Relay synchronous protocol
2004-05-18 07:23:37 +00:00
.Tn ( ANSI
T1.617 Annex D).
.It Cm ppp
2004-05-20 16:40:06 +00:00
Select the synchronous PPP protocol.
PPP parameters can be configured using the
.Xr spppcontrol 8
utility.
2004-05-18 07:23:37 +00:00
.It Sm Cm keepalive No = Bro Cm on , off Brc Sm
2004-05-20 16:40:06 +00:00
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.
2004-05-18 07:23:37 +00:00
.It Cm idle
2004-05-20 16:40:06 +00:00
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
.\"--------------------------------------------------------------
2004-05-18 07:23:37 +00:00
.Ss "Interface Options"
2004-05-20 16:40:06 +00:00
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
2004-05-18 07:23:37 +00:00
.Cm debug
option.
.Bl -tag -width indent
.It Sm Cm port No = Bro Cm rs232 , v35 , rs449 Brc Sm
2004-05-20 16:40:06 +00:00
Set the port type for old Sigma models.
2004-05-18 07:23:37 +00:00
.It Sm Cm cfg No = Bro Cm A , B , C Brc Sm
2004-05-20 16:40:06 +00:00
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.
2004-05-18 07:23:37 +00:00
.Bl -tag -width ".Cm cfg Ns = Ns Cm A"
.It Cm cfg Ns = Ns Cm A
Two independent E1/G703 channels.
2004-05-20 16:40:06 +00:00
This is the default setting.
2004-05-18 07:23:37 +00:00
.It Cm cfg Ns = Ns Cm B
(Only for ISA models.)
2004-05-20 16:40:06 +00:00
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.
2004-05-18 07:23:37 +00:00
.It Cm cfg Ns = Ns Cm C
2004-05-20 16:40:06 +00:00
(Only for E1 models.)
In this mode, first
2004-05-18 07:23:37 +00:00
physical channel consists of three data flows.
2004-05-20 16:40:06 +00:00
Two of them go to the two (logical) channels.
2004-05-18 07:23:37 +00:00
The last one goes to the second physical channel.
2004-05-20 16:40:06 +00:00
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.
2004-05-18 07:23:37 +00:00
.El
.Pp
2004-05-20 16:40:06 +00:00
For a detailed description of available configuration modes,
see the adapter documentation.
This option cannot be set on a busy channel.
2004-05-18 07:23:37 +00:00
.It Sm Cm loop No = Bro Cm on , off Brc Sm
Turn on/off internal loopback.
2004-05-20 16:40:06 +00:00
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" .
2004-05-18 07:23:37 +00:00
.It Sm Cm rloop No = Bro Cm on , off Brc Sm
(Only for Tau32-PCI and Tau-PCI/E3.)
2004-05-20 16:40:06 +00:00
Turn on/off remote loopback feature.
This mode is also useful for debugging.
2004-05-18 07:23:37 +00:00
.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.
2004-05-20 16:40:06 +00:00
Must be used with the NRZI
encoding to avoid the synchronization loss.
2004-05-18 07:23:37 +00:00
.It Sm Cm nrzi No = Bro Cm on , off Brc Sm
2004-05-20 16:40:06 +00:00
Turn on/off NRZI encoding.
If
.Cm off ,
NRZ encoding is used.
2004-05-18 07:23:37 +00:00
.Bl -tag -width "NRZI"
.It NRZ
2004-05-20 16:40:06 +00:00
The zero bit is transmitted by the zero signal level,
the one bit is transmitted by the positive signal level.
2004-05-18 07:23:37 +00:00
.It NRZI
2004-05-20 16:40:06 +00:00
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
2004-05-18 07:23:37 +00:00
.Cm dpll Ns = Ns Cm on
option.
2004-05-20 16:40:06 +00:00
.El
2004-05-18 07:23:37 +00:00
.It Sm Cm invclk No = Bro Cm on , off Brc Sm
2004-05-20 16:40:06 +00:00
(Tau and Tau-PCI only.)
Invert both the transmit and receive clock signals.
2004-05-18 07:23:37 +00:00
.It Sm Cm invrclk No = Bro Cm on , off Brc Sm
2004-05-20 16:40:06 +00:00
(Tau-PCI only.)
Invert the receive clock signals.
2004-05-18 07:23:37 +00:00
.It Sm Cm invtclk No = Bro Cm on , off Brc Sm
2004-05-20 16:40:06 +00:00
(Tau-PCI only.)
Invert the transmit clock signals.
2004-05-18 07:23:37 +00:00
.It Sm Cm higain No = Bro Cm on , off Brc Sm
2004-05-20 16:40:06 +00:00
(E1 only.)
In off state the sensitivity is -12 dB.
2004-05-20 16:40:06 +00:00
Turn on/off increasing the E1 receiver's non-linear sensitivity to -30dB.
This allows increasing of the line distance.
2004-05-18 07:23:37 +00:00
.It Sm Cm cablen No = Bro Cm on , off Brc Sm
2004-05-20 16:40:06 +00:00
(Tau-PCI/T3 and Tau-PCI/STS-1 only.)
Turn on/off adjusting of the transmit signal for a long cable T3/STS-1.
2004-05-18 07:23:37 +00:00
.It Sm Cm monitor No = Bro Cm on , off Brc Sm
(Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
2004-05-20 16:40:06 +00:00
Turn on/off increasing of the E1 receiver's linear sensitivity to -30dB.
This can be used for the interception purposes.
2004-05-18 07:23:37 +00:00
.It Sm Cm phony No = Bro Cm on , off Brc Sm
(Tau32-PCI and Tau-PCI E1 family only.)
2004-05-20 16:40:06 +00:00
Turn on/off the so-called
.Dq phony
mode.
2004-05-18 07:23:37 +00:00
This mode allows
2004-05-20 16:40:06 +00:00
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
2004-05-18 07:23:37 +00:00
with length
.No 16* Ns Ar N
(for Tau-PCI/E1 model), where
.Ar N
is the number of timeslots.
For
2004-05-20 16:40:06 +00:00
Tau-PCI/2E1 and Tau-PCI/4E1,
.Ar N
should be equal to 32 regardless of the number of
used timeslots.
2004-05-18 07:23:37 +00:00
.It Sm Cm unfram No = Bro Cm on , off Brc Sm
(Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
2004-05-20 16:40:06 +00:00
Turn on/off unframed mode.
2004-05-18 07:23:37 +00:00
.Bl -tag -width ".Cm unfram Ns = Ns Cm off"
.It Cm unfram Ns = Ns Cm on
2004-05-20 16:40:06 +00:00
Switch channel to the unframed G.703 mode.
2004-05-18 07:23:37 +00:00
.It Cm unfram Ns = Ns Cm off
2004-05-20 16:40:06 +00:00
Switch channel to the framed E1 (G.704) mode.
2004-05-18 07:23:37 +00:00
.El
.It Sm Cm scrambler No = Bro Cm on , off Brc Sm
2004-05-20 16:40:06 +00:00
(Tau32-PCI, Tau-PCI/G.703, Tau-PCI/2E1, and
2004-05-18 07:23:37 +00:00
Tau-PCI/4E1 in unframed mode only.)
2004-05-20 16:40:06 +00:00
Turn on/off scrambling of the G.703 data.
2004-05-18 07:23:37 +00:00
.It Sm Cm use16 No = Bro Cm on , off Brc Sm
(Tau32-PCI and Tau-PCI E1 family only.)
2004-05-20 16:40:06 +00:00
Turn on/off the usage of the 16th timeslot for data transmission.
Normally, the 16th timeslot is used for signalling information
(multiframing CAS).
2004-05-18 07:23:37 +00:00
.It Sm Cm crc4 No = Bro Cm on , off Brc Sm
(E1 only.)
2004-05-20 16:40:06 +00:00
Turn on/off CRC4 superframe mode.
2004-05-18 07:23:37 +00:00
.It Sm Cm syn No = Bro Cm int , rcv , rcv0 , rcv1 , rcv2 , rcv3 Brc Sm
.Bl -tag -width ".Cm rcv3"
.It Cm int
2004-05-20 16:40:06 +00:00
Use an internal clock generator for G703 transmitter
2004-05-18 07:23:37 +00:00
(clock master).
.It Cm rcv
2004-05-20 16:40:06 +00:00
Use the G703 receiver data clock as the transmit clock
2004-05-18 07:23:37 +00:00
(clock slave).
.It Cm rcv0 , rcv1 , rcv2 , rcv3
2004-05-20 16:40:06 +00:00
Use the G703 receiver clock of the other channel
2004-05-18 07:23:37 +00:00
(E1 models only).
.El
.It Cm dir Ns = Ns Ar number
(Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
2004-05-20 16:40:06 +00:00
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.
2004-05-18 07:23:37 +00:00
.It Cm ts Ns = Ns Ar interval
2004-05-20 16:40:06 +00:00
(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,
2004-05-18 07:23:37 +00:00
giving an interval.
2004-05-20 16:40:06 +00:00
Example:
2004-05-18 07:23:37 +00:00
.Dq Li ts=1-3,5,17 .
.It Cm pass Ns = Ns Ar interval
2004-05-20 16:40:06 +00:00
(Tau/E1 only.)
2004-05-18 07:23:37 +00:00
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.
.It Sm Cm debug No = Bro Cm 0 , 1 , 2 Brc Sm
Turn on/off debug messages.
2004-05-18 07:23:37 +00:00
.Bl -tag -width 2n
.It Cm 0
2004-05-20 16:40:06 +00:00
Turn debug messages off.
2004-05-18 07:23:37 +00:00
.It Cm 1
2004-05-20 16:40:06 +00:00
Turn debug messages on, equivalent to the
2004-05-18 07:23:37 +00:00
.Cm debug
2004-05-20 16:40:06 +00:00
option of the
.Xr ifconfig 8
utility.
2004-05-18 07:23:37 +00:00
.It Cm 2
2004-05-20 16:40:06 +00:00
High intensive debug messages, for developers only.
2004-05-18 07:23:37 +00:00
.El
.El
.\"--------------------------------------------------------------
.Sh EXAMPLES
2004-05-20 16:40:06 +00:00
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
2004-05-20 16:40:06 +00:00
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
sconfig ct0 cisco ts=1-10
ifconfig ct0 158.250.244.2 158.250.244.1 up
.Ed
.Pp
2004-05-20 16:40:06 +00:00
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
2004-05-20 16:40:06 +00:00
Set up channel 1 for the leased line link using the data-only
2004-05-18 07:23:37 +00:00
null-modem cable (or modems like Zelax+ M115).
Synchronous DPLL mode, 128000
bits/sec, protocol PPP/HDLC, NRZI encoding (for Sigma):
.Bd -literal -offset indent
sconfig cx1 ppp 128000 nrzi=on dpll=on
ifconfig cx1 158.250.244.2 158.250.244.1 up
.Ed
.\"--------------------------------------------------------------
.Sh DIAGNOSTICS
2004-05-20 16:40:06 +00:00
This section contains a description of abbreviations used by
2004-05-18 07:23:37 +00:00
.Nm
while displaying various statistics.
2004-05-20 16:40:06 +00:00
For a description of options related to
statistics, please see above.
.\"--------------------------------------------------------------
.Ss Statistics
2004-05-20 16:40:06 +00:00
When running, the driver gathers statistics about the channels, which
can be accessed using the
2004-05-18 07:23:37 +00:00
.Nm
2004-05-20 16:40:06 +00:00
utility,
or through the
.Xr ioctl 2
call
2004-05-18 07:23:37 +00:00
.Dv SERIAL_GETSTAT .
2004-05-20 16:40:06 +00:00
.Pp
.Bl -tag -width indent -compact
2004-05-18 07:23:37 +00:00
.It Va Rintr
2004-05-20 16:40:06 +00:00
Total number of receive interrupts.
2004-05-18 07:23:37 +00:00
.It Va Tintr
2004-05-20 16:40:06 +00:00
Total number of transmit interrupts.
2004-05-18 07:23:37 +00:00
.It Va Mintr
2004-05-20 16:40:06 +00:00
Total number of modem interrupts.
2004-05-18 07:23:37 +00:00
.It Va Ibytes
2004-05-20 16:40:06 +00:00
Total bytes received.
2004-05-18 07:23:37 +00:00
.It Va Ipkts
2004-05-20 16:40:06 +00:00
Total packets received (for HDLC mode).
2004-05-18 07:23:37 +00:00
.It Va Ierrs
2004-05-20 16:40:06 +00:00
Number of receive errors.
2004-05-18 07:23:37 +00:00
.It Va Obytes
2004-05-20 16:40:06 +00:00
Total bytes transmitted.
2004-05-18 07:23:37 +00:00
.It Va Opkts
2004-05-20 16:40:06 +00:00
Total packets transmitted (for HDLC mode).
2004-05-18 07:23:37 +00:00
.It Va Oerrs
2004-05-20 16:40:06 +00:00
Number of transmit errors.
.El
.\"--------------------------------------------------------------
.Ss E1/G.703 Statistics
2004-05-20 16:40:06 +00:00
For E1 and G.703 channels, the SNMP-compatible statistics data are gathered
2004-05-18 07:23:37 +00:00
(see RFC 1406).
2004-05-20 16:40:06 +00:00
It can be accessed using the
2004-05-18 07:23:37 +00:00
.Nm
2004-05-20 16:40:06 +00:00
utility,
or through the
2004-05-18 07:23:37 +00:00
.Xr ioctl 2
call
.Dv SERIAL_GETESTAT .
2004-05-20 16:40:06 +00:00
.Bl -tag -width ".Va RCRC Pq Va rcrce"
2004-05-18 07:23:37 +00:00
.It Va Unav Pq Va uas
2004-05-20 16:40:06 +00:00
Unavailable seconds: receiving all ones, loss of carrier, or loss of
signal.
2004-05-18 07:23:37 +00:00
.It Va Degr Pq Va dm
2004-05-20 16:40:06 +00:00
Degraded minutes: having error rate more than 10E-6, not counting unavailable
and severely errored seconds.
2004-05-18 07:23:37 +00:00
.It Va Bpv Pq Va bpv
HDB3 bipolar violation errors.
.It Va Fsyn Pq Va fse
Frame synchronization errors (E1 only).
.It Va CRC Pq Va crce
CRC4 errors (E1).
.It Va RCRC Pq Va rcrce
Remote CRC4 errors: E-bit counter (E1).
.It Va Err Pq Va es
2004-05-20 16:40:06 +00:00
Errored seconds: any framing errors, or out of frame sync, or any slip events.
2004-05-18 07:23:37 +00:00
.It Va Lerr Pq Va les
2004-05-20 16:40:06 +00:00
Line errored seconds: any BPV.
2004-05-18 07:23:37 +00:00
.It Va Sev Pq Va ses
2004-05-20 16:40:06 +00:00
Severely errored seconds: 832 or more framing errors, or 2048 or more bipolar
2004-05-18 07:23:37 +00:00
violations.
.It Va Bur Pq Va bes
2004-05-20 16:40:06 +00:00
Bursty errored seconds: more than 1 framing error, but not severely errored.
2004-05-18 07:23:37 +00:00
.It Va Oof Pq Va oofs
2004-05-20 16:40:06 +00:00
Severely errored framing seconds: out of frame sync.
2004-05-18 07:23:37 +00:00
.It Va Slp Pq Va css
2004-05-20 16:40:06 +00:00
Controlled slip seconds: any slip buffer overflow or underflow.
.El
.\"--------------------------------------------------------------
.Ss E1/G.703 Status
2004-05-18 07:23:37 +00:00
The
.Nm
utility also prints the E1/G.703 channel status.
2004-05-20 16:40:06 +00:00
The status can have the
following values (non-exclusive):
.Pp
.Bl -tag -width ".Li FARLOMF" -compact
2004-05-18 07:23:37 +00:00
.It Li Ok
2004-05-20 16:40:06 +00:00
The channel is in a valid state, synchronized.
2004-05-18 07:23:37 +00:00
.It Li LOS
Loss of sync.
.It Li AIS
Receiving unframed all ones (E1 only).
.It Li LOF
Loss of framing (E1 only).
.It Li LOMF
Loss of multiframing (E1 only).
.It Li FARLOF
Receiving remote alarm (E1 only).
.It Li AIS16
2004-05-20 16:40:06 +00:00
Receiving all ones in the timeslot 16 (E1 only).
2004-05-18 07:23:37 +00:00
.It Li FARLOMF
Receiving distant multiframe alarm (E1 only).
.It Li TSTREQ
Receiving test request code (G.703 only).
.It Li TSTERR
Test error (G.703 only).
.El
.\"--------------------------------------------------------------
.Sh SEE ALSO
2004-05-18 07:23:37 +00:00
.Xr stty 1 ,
.Xr ioctl 2 ,
.Xr sppp 4 ,
.Xr ifconfig 8 ,
.Xr route 8 ,
.Xr spppcontrol 8
.\"--------------------------------------------------------------
.Sh HISTORY
2004-05-20 16:40:06 +00:00
This utility is a replacement for the
.Nm cxconfig
and
.Nm ctconfig
2004-05-20 16:40:06 +00:00
utilities that were used in the past with
2004-05-18 07:23:37 +00:00
.Fx
drivers.
2004-05-20 16:40:06 +00:00
Those two utilities and
.Nm
are not compatible,
and therefore all scripts using them have to be rewritten.
Moreover,
2004-05-18 07:23:37 +00:00
.Tn Linux
and
.Fx
2004-05-20 16:40:06 +00:00
versions of the
.Nm
utility are not fully compatible.
.\"--------------------------------------------------------------
2004-05-20 16:40:06 +00:00
.Sh AUTHORS
.An Cronyx Engineering Aq info@cronyx.ru
.Pp
2004-05-18 07:23:37 +00:00
.Pa http://www.cronyx.ru
2004-05-20 16:40:06 +00:00
.\"--------------------------------------------------------------
.Sh BUGS
All software produced by Cronyx Engineering is thoroughly tested.
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.