1997-10-23 22:39:09 +00:00
|
|
|
.\" $Id$
|
|
|
|
.\"
|
|
|
|
.\" CHECKIN $Date$
|
|
|
|
.\"
|
|
|
|
.\" Process this file with
|
|
|
|
.\" groff -man -Tascii isdnctrl.8 for ASCII output, or
|
|
|
|
.\" groff -man -Tps isdnctrl.8 for PostScript output
|
|
|
|
.\"
|
|
|
|
.TH ISDNCTRL 8 "@MANDATE@" isdn4k-utils-@I4LVERSION@ "Linux System Administration"
|
1997-02-17 00:09:41 +00:00
|
|
|
.SH NAME
|
|
|
|
isdnctrl \- get/set ISDN device information
|
|
|
|
.SH SYNOPSIS
|
1997-10-23 22:39:09 +00:00
|
|
|
.BI isdnctrl " action device " ...
|
1997-02-17 00:09:41 +00:00
|
|
|
.SH DESCRIPTION
|
1997-10-23 22:39:09 +00:00
|
|
|
.B isdnctrl
|
|
|
|
is used to create and delete network interfaces for
|
|
|
|
.SM ISDN,
|
|
|
|
set up the various parameters and phone numbers for dial in and dial
|
|
|
|
out. It is also used to list the current parameters of an already
|
|
|
|
configured network interface.
|
|
|
|
.BR isdnctrl " is " not
|
|
|
|
needed for configuration of
|
|
|
|
.SM ISDN
|
|
|
|
ttys!
|
1997-02-17 00:09:41 +00:00
|
|
|
.LP
|
|
|
|
The use of
|
1997-10-23 22:39:09 +00:00
|
|
|
.B isdnctrl
|
|
|
|
is independant of the hardware driver.
|
1997-02-17 00:09:41 +00:00
|
|
|
.LP
|
|
|
|
.SH OPTIONS
|
|
|
|
The following
|
1997-10-23 22:39:09 +00:00
|
|
|
.B actions
|
1997-02-17 00:09:41 +00:00
|
|
|
may be given to
|
1997-10-23 22:39:09 +00:00
|
|
|
.BR isdnctrl .
|
|
|
|
.TP
|
|
|
|
.BI addif " name"
|
|
|
|
Adds a new
|
|
|
|
.SM ISDN
|
|
|
|
interface
|
|
|
|
.IR name " to the kernel. If " name
|
|
|
|
is omitted, the kernel will use
|
|
|
|
.BI eth X,
|
|
|
|
where
|
|
|
|
.I X
|
|
|
|
is an increasing number starting from 0. This is probably not useful with
|
|
|
|
.SM ISDN
|
|
|
|
so using a name like
|
|
|
|
.B isdn0
|
|
|
|
is always recommended.
|
|
|
|
.TP
|
|
|
|
.BI delif " name " [force]
|
|
|
|
Removes the
|
|
|
|
.SM ISDN
|
|
|
|
interface
|
|
|
|
.I name
|
|
|
|
from the kernel. If the optional keyword
|
|
|
|
.B force
|
|
|
|
is appended,
|
|
|
|
.BR isdnctrl " executes"
|
|
|
|
.BI ifconfig " name " down
|
|
|
|
before removing it.
|
|
|
|
.TP
|
1997-07-23 20:39:22 +00:00
|
|
|
.B reset [force]
|
1997-10-23 22:39:09 +00:00
|
|
|
Removes all
|
|
|
|
.SM ISDN
|
|
|
|
interfaces from the kernel if it is possible. If the optional keyword
|
|
|
|
.B force
|
|
|
|
is appended,
|
|
|
|
.BR isdnctrl " executes"
|
|
|
|
.BI ifconfig " name " down
|
|
|
|
before removing an interface.
|
|
|
|
.TP
|
|
|
|
.BI addphone " name " out " num"
|
|
|
|
Adds the phone number
|
|
|
|
.I num
|
|
|
|
to the list of outgoing numbers of the
|
|
|
|
.SM ISDN
|
|
|
|
interface
|
|
|
|
.IR name .
|
|
|
|
Numbers in this list are used to dial the remote station if
|
|
|
|
the connection is down and packets are to be send via the interface
|
|
|
|
(Dial on demand). More than one number can be set by calling
|
|
|
|
.B isdnctrl addphone
|
|
|
|
repeatedly. If more than one number is set, these will be tried
|
|
|
|
one after another. When using a german SPV-type connection,
|
|
|
|
the number has to be prefixed by a capital S.
|
|
|
|
.TP
|
|
|
|
.BI addphone " name " in " num"
|
|
|
|
Adds the phone number
|
|
|
|
.I num
|
|
|
|
to the list of incoming numbers of the
|
|
|
|
.SM ISDN
|
|
|
|
interface
|
|
|
|
.IR name .
|
|
|
|
Numbers in this list are used to verify access permission of
|
|
|
|
the remote station if an incoming call is received. The verification
|
|
|
|
can be disabled by setting the interface into insecure mode using
|
|
|
|
.BI isdnctrl " name " secure " off."
|
|
|
|
If the list is empty, incoming calls are disabled.
|
|
|
|
More than one number can be added by calling
|
|
|
|
.B isdnctrl addphone
|
1997-02-17 00:09:41 +00:00
|
|
|
repeatedly. Also wildcards can be used (see below).
|
1997-10-23 22:39:09 +00:00
|
|
|
.TP
|
|
|
|
.BI delphone " name " in|out " num"
|
|
|
|
Removes phone number
|
|
|
|
.I num
|
|
|
|
from the incoming or outgoing phone list.
|
|
|
|
.TP
|
|
|
|
.BI eaz " name " [ num ]
|
1997-02-17 00:09:41 +00:00
|
|
|
Set the EAZ (German 1TR6 protocol) or MSN (Euro-ISDN E-DSS1) for
|
1997-10-23 22:39:09 +00:00
|
|
|
.SM ISDN
|
|
|
|
interface
|
|
|
|
.IR name " to " num .
|
|
|
|
For an EAZ this is only one digit, while for a MSN
|
|
|
|
.I num
|
|
|
|
is the whole MSN (usually the local phone number). If
|
|
|
|
.I num
|
|
|
|
is omitted,
|
|
|
|
.B isdnctrl
|
|
|
|
prints the current setting for
|
|
|
|
.SM ISDN
|
|
|
|
interface
|
|
|
|
.IR name .
|
|
|
|
.TP
|
|
|
|
.BI huptimeout " name " [ seconds ]
|
|
|
|
Set the hangup timeout for
|
|
|
|
.SM ISDN
|
|
|
|
interface
|
|
|
|
.IR name " to " seconds .
|
|
|
|
If there is inactivity (i.e. no traffic on the interface) for the
|
1997-02-17 00:09:41 +00:00
|
|
|
given time the driver automatically shuts down the connection.
|
1997-10-23 22:39:09 +00:00
|
|
|
If
|
|
|
|
.I seconds
|
|
|
|
is omitted
|
|
|
|
.B isdnctrl
|
|
|
|
prints the current setting for interface
|
|
|
|
.IR name .
|
|
|
|
.TP
|
|
|
|
.BI cbdelay " name " [ seconds ]
|
|
|
|
Set the callback delay for
|
|
|
|
.SM ISDN
|
|
|
|
interface
|
|
|
|
.IR name " to " seconds .
|
|
|
|
If callback mode for this interface is
|
|
|
|
.BR in ,
|
|
|
|
dialing is delayed the given time. If the callback mode is
|
|
|
|
.BR out ,
|
|
|
|
after dialing out and waiting the given time, a hangup is
|
1997-02-17 00:09:41 +00:00
|
|
|
issued to free the line for the incoming callback from the remote
|
1997-10-23 22:39:09 +00:00
|
|
|
machine. This hangup-after-dial is disabled by setting
|
|
|
|
.B cbdelay
|
|
|
|
to 0. If
|
|
|
|
.I seconds
|
|
|
|
is omitted
|
|
|
|
.B isdnctrl
|
|
|
|
prints the current setting for interface
|
|
|
|
.IR name .
|
|
|
|
.TP
|
|
|
|
.BI dialmax " name " [ num ]
|
|
|
|
Set the number of dial attempts for
|
|
|
|
.SM ISDN
|
|
|
|
interface
|
|
|
|
.IR name " to " num .
|
|
|
|
If dialing, each phone number is tried this many times before giving up.
|
|
|
|
If
|
|
|
|
.I num
|
|
|
|
is omitted
|
|
|
|
.B isdnctrl
|
|
|
|
prints the current setting for interface
|
|
|
|
.IR name .
|
|
|
|
.TP
|
|
|
|
.BI ihup " name " [on|off]
|
1997-02-17 00:09:41 +00:00
|
|
|
Turn on or off the hangup timeout for incoming calls on
|
1997-10-23 22:39:09 +00:00
|
|
|
interface
|
|
|
|
.IR name .
|
|
|
|
If on or off is omitted the current setting is printed.
|
|
|
|
.TP
|
|
|
|
.BI chargehup " name " [on|off]
|
1997-02-17 00:09:41 +00:00
|
|
|
Turn on or off hangup before next charge info for interface
|
1997-10-23 22:39:09 +00:00
|
|
|
.IR name .
|
|
|
|
This can only be used if the
|
|
|
|
.SM ISDN
|
|
|
|
provider transmits charge info during and after the connection.
|
|
|
|
If set to on, the driver will close the connection just before the
|
|
|
|
next charge info will be received if the interface is inactive. If
|
|
|
|
on or off is omitted the current setting is printed.
|
|
|
|
.TP
|
|
|
|
.BI chargeint " name " [ seconds ]
|
|
|
|
If
|
|
|
|
.I seconds
|
|
|
|
are given, the charge interval for the given
|
|
|
|
interface is set. This may be useful on
|
|
|
|
.SM ISDN
|
|
|
|
lines with no chargeinfo or no online chargeinfo. The connection
|
|
|
|
will be closed 2 seconds before the end of the next estimated
|
|
|
|
charge interval if
|
1997-02-17 00:09:41 +00:00
|
|
|
.I huptimeout
|
|
|
|
seconds of inactivity have been reached. If
|
|
|
|
.I ihup
|
1997-10-23 22:39:09 +00:00
|
|
|
is
|
|
|
|
.BR on ,
|
|
|
|
incoming connections are closed by this mechanism also.
|
1997-02-17 00:09:41 +00:00
|
|
|
On lines with online charge info you also might ask by
|
1997-10-23 22:39:09 +00:00
|
|
|
.BI chargeint " name"
|
1997-02-17 00:09:41 +00:00
|
|
|
for the current charge interval as delivered from the
|
|
|
|
telecom on a given interface.
|
1997-10-23 22:39:09 +00:00
|
|
|
.TP
|
|
|
|
.BI secure " name " [on|off]
|
|
|
|
Turns on or off the security feature for interface
|
|
|
|
.IR name .
|
|
|
|
If set to
|
|
|
|
.BR on ,
|
|
|
|
incoming calls will only be accepted if the calling number can be
|
|
|
|
found in the incoming access list. See description of action
|
|
|
|
.B addphone
|
|
|
|
for information about how to add numbers to this list.
|
|
|
|
.RB If " on " or " off
|
|
|
|
is omitted, the current setting is printed.
|
|
|
|
.TP
|
|
|
|
.BI callback " name " [ mode ]
|
|
|
|
Set callback mode for interface
|
|
|
|
.IR name " to mode " mode .
|
|
|
|
If callback mode is
|
|
|
|
.BR in ,
|
|
|
|
then after getting an incoming call, a callback is triggered. If
|
1997-02-17 00:09:41 +00:00
|
|
|
callback mode is
|
1997-10-23 22:39:09 +00:00
|
|
|
.BR out ,
|
|
|
|
then the local system does the initial call and then waits for callback of
|
1997-02-17 00:09:41 +00:00
|
|
|
the remote machine. The option
|
1997-10-23 22:39:09 +00:00
|
|
|
.B on
|
1997-02-17 00:09:41 +00:00
|
|
|
is available only for compatibility with older versions. Its meaning is
|
|
|
|
the same like
|
1997-10-23 22:39:09 +00:00
|
|
|
.BR in .
|
|
|
|
If callback mode is
|
|
|
|
.BR off ,
|
|
|
|
calls are handled normally without special processing.
|
|
|
|
.TP
|
|
|
|
.BI cbhup " name " [on|off]
|
|
|
|
Turns on or off Hangup (Reject) for interface
|
|
|
|
.I name
|
|
|
|
before starting callback. If cbhup is
|
|
|
|
.BR on ,
|
|
|
|
when receiving an incoming call, the interface first rejects that
|
|
|
|
call before the callback sequence is started. If
|
|
|
|
.BR on " or " off
|
|
|
|
is omitted, the current setting is printed.
|
|
|
|
.TP
|
|
|
|
.BI encap " name " [ encapsulation ]
|
|
|
|
Set the encapsulation mode for interface
|
|
|
|
.IR name .
|
|
|
|
Possible encapsulations are:
|
|
|
|
.LP
|
|
|
|
.RS
|
1997-02-17 00:09:41 +00:00
|
|
|
.B rawip
|
1997-10-23 22:39:09 +00:00
|
|
|
.br
|
1997-02-17 00:09:41 +00:00
|
|
|
raw ip encapsulation (default)
|
1997-10-23 22:39:09 +00:00
|
|
|
.LP
|
1997-02-17 00:09:41 +00:00
|
|
|
.B ip
|
1997-10-23 22:39:09 +00:00
|
|
|
.br
|
|
|
|
IP + typefield encapsulation
|
|
|
|
.LP
|
1997-02-17 00:09:41 +00:00
|
|
|
.B cisco_h
|
1997-10-23 22:39:09 +00:00
|
|
|
.br
|
|
|
|
Special mode for communicating with a Cisco in HDLC-mode with
|
|
|
|
Cisco-keepalive switched off.
|
|
|
|
.LP
|
1997-02-17 00:09:41 +00:00
|
|
|
.B ethernet
|
1997-10-23 22:39:09 +00:00
|
|
|
.br
|
|
|
|
ethernet over
|
|
|
|
.SM ISDN
|
|
|
|
(MAC-header included)
|
|
|
|
.LP
|
1997-02-17 00:09:41 +00:00
|
|
|
.B syncppp
|
1997-10-23 22:39:09 +00:00
|
|
|
.br
|
|
|
|
Synchronous PPP over
|
|
|
|
.SM ISDN
|
|
|
|
.LP
|
1997-02-17 00:09:41 +00:00
|
|
|
.B uihdlc
|
1997-10-23 22:39:09 +00:00
|
|
|
.br
|
1997-02-17 00:09:41 +00:00
|
|
|
raw ip with additional ui-header
|
1997-10-23 22:39:09 +00:00
|
|
|
.LP
|
|
|
|
.B cisco_hk
|
|
|
|
.br
|
|
|
|
Special mode for communicating with a Cisco in HDLC-mode with
|
|
|
|
Cisco-keepalive switched on.
|
|
|
|
.RE
|
|
|
|
.LP
|
|
|
|
If
|
|
|
|
.I encapsulation
|
|
|
|
is omitted, the current setting is printed.
|
|
|
|
.TP
|
|
|
|
.BI l2_prot " name " [ protocol ]
|
|
|
|
Set the layer-2 protocol for interface
|
|
|
|
.IR name .
|
|
|
|
Possible values for
|
|
|
|
.IR protocol " are:"
|
|
|
|
.br
|
|
|
|
.BR x75i ", " x75ui ", " x75bui " and " hdlc .
|
|
|
|
If
|
|
|
|
.I protocol
|
|
|
|
is omitted the current setting is printed.
|
|
|
|
.TP
|
|
|
|
.B l3_prot " name " [ protocol ]
|
|
|
|
Set the layer-3 protocol for interface
|
|
|
|
.IR name .
|
|
|
|
At the moment only
|
1997-02-17 00:09:41 +00:00
|
|
|
.B trans
|
1997-10-23 22:39:09 +00:00
|
|
|
is supported here.
|
|
|
|
If
|
|
|
|
.I protocol
|
|
|
|
is omitted the current setting is printed.
|
|
|
|
.TP
|
|
|
|
.BI list " name"
|
|
|
|
List all parameters and the charge info for interface
|
|
|
|
.IR name .
|
|
|
|
If
|
|
|
|
.I name
|
|
|
|
is
|
|
|
|
.BR all ,
|
|
|
|
then all interfaces are listed.
|
|
|
|
.TP
|
|
|
|
.BI verbose " num"
|
|
|
|
Set verbosity level to
|
|
|
|
.IR num .
|
|
|
|
.TP
|
|
|
|
.BI hangup " name"
|
|
|
|
The connection of interface
|
|
|
|
.I name
|
|
|
|
is closed immediately.
|
|
|
|
.TP
|
|
|
|
.BI bind " name driverId" , "channel " [exclusive]
|
|
|
|
Binds an interface
|
|
|
|
.I name
|
|
|
|
to a physical channel.
|
|
|
|
The
|
|
|
|
.I driverId
|
|
|
|
identifies a specific S0-Port. The channels of a port start
|
|
|
|
counting with zero. If
|
|
|
|
.B exclusive
|
|
|
|
is given, other interfaces cannot use that interface anymore.
|
|
|
|
Otherwise, the channel may be used by other interfaces.
|
|
|
|
.TP
|
|
|
|
.BI unbind " name"
|
|
|
|
Unbinds a the previously bound interface
|
|
|
|
.IR name .
|
|
|
|
.TP
|
|
|
|
.BI pppbind " name " [ num ]
|
|
|
|
Binds the interface
|
|
|
|
.I name
|
|
|
|
to an ippp device
|
|
|
|
.BI /dev/ippp num .
|
|
|
|
This works only for synchronous ppp. The value must be a number.
|
|
|
|
If
|
|
|
|
.I num
|
|
|
|
is omitted and
|
|
|
|
.I name
|
|
|
|
is called
|
|
|
|
.BI ippp X
|
|
|
|
, then the interface is bound to
|
|
|
|
.BI /dev/ippp X .
|
|
|
|
.TP
|
|
|
|
.BI pppunbind " name"
|
|
|
|
Unbinds the previously bound interface
|
|
|
|
.IR name .
|
|
|
|
.TP
|
|
|
|
.BI busreject " driverId " [on|off]
|
|
|
|
If switched
|
|
|
|
.BR on ,
|
|
|
|
instead of ignoring incoming calls not matching any interface,
|
|
|
|
isdn4linux responds with a
|
|
|
|
.B REJECT
|
|
|
|
to those calls. If switched
|
|
|
|
.BR off ,
|
|
|
|
isdn4linux is passive, allowing other devices connected to the same
|
|
|
|
S0-bus to answer the call.
|
|
|
|
You normally should
|
|
|
|
.B not
|
|
|
|
enable this feature, if the
|
|
|
|
.SM ISDN
|
|
|
|
adaptor is not the only device connected to the S0-bus.
|
|
|
|
Otherwise it could happen, that isdn4linux rejects an incoming call
|
|
|
|
which belongs to another device on the bus.
|
|
|
|
.TP
|
|
|
|
.BI addslave " name slave"
|
|
|
|
Adds a slave interface named
|
|
|
|
.I slave
|
|
|
|
to interface
|
|
|
|
.I name
|
|
|
|
for raw channel-bundling. For bundling of more than two channels, any number
|
|
|
|
of slaves can be added to an interface by using this command repeatedly.
|
|
|
|
.I name
|
|
|
|
must refer to an existing "master" interface (not a slave). Slave
|
|
|
|
interfaces are not visible to the kernel, however all usual
|
|
|
|
.SM ISDN
|
|
|
|
settings can be configured. Because slave interfaces are not visible
|
|
|
|
to the kernel, they are configured "through" their "master", so
|
|
|
|
.B it is important
|
1997-02-17 00:09:41 +00:00
|
|
|
that slave interfaces are added
|
|
|
|
.B before
|
1997-10-23 22:39:09 +00:00
|
|
|
the corresponding "master" is started by
|
|
|
|
.BR ifconfig .
|
|
|
|
If the "master" is already up, it has to be shutdown with
|
1997-02-17 00:09:41 +00:00
|
|
|
.B ifconfig down ...
|
1997-10-23 22:39:09 +00:00
|
|
|
otherwise the
|
|
|
|
.B addslave
|
|
|
|
command will be rejected.
|
|
|
|
.TP
|
|
|
|
.BI sdelay " name num"
|
1997-02-17 00:09:41 +00:00
|
|
|
Set delay for slave-dialing.
|
1997-10-23 22:39:09 +00:00
|
|
|
The master interface
|
|
|
|
.I name
|
|
|
|
has to have a load of more than
|
1997-06-22 11:58:24 +00:00
|
|
|
.B trigger
|
1997-10-23 22:39:09 +00:00
|
|
|
cps for at least
|
|
|
|
.I num
|
|
|
|
seconds, before it's slave starts dialing.
|
|
|
|
.TP
|
|
|
|
.BI trigger " name num"
|
1997-06-22 11:58:24 +00:00
|
|
|
Set trigger level for slave-dialing.
|
1997-10-23 22:39:09 +00:00
|
|
|
The master interface
|
|
|
|
.I name
|
|
|
|
has to have a load of more than
|
|
|
|
.I num
|
1997-06-22 11:58:24 +00:00
|
|
|
cps for at least
|
|
|
|
.B sdelay
|
1997-10-23 22:39:09 +00:00
|
|
|
seconds, before it's slave starts dialing.
|
|
|
|
.TP
|
|
|
|
.BI dial " name"
|
|
|
|
Force dialing of interface
|
|
|
|
.IR name .
|
|
|
|
.TP
|
|
|
|
.BI mapping " driverId MSN0" [, MSN1 [, MSN2 "]] ... [," MSN9 ]
|
1997-02-17 00:09:41 +00:00
|
|
|
Installs a mapping-table for MSN<->EAZ-mapping. See README for details.
|
1997-10-23 22:39:09 +00:00
|
|
|
@MANINC@ @MAN8DIR@/.isdnctrl_conf.8
|
1997-02-17 00:09:41 +00:00
|
|
|
.SH WILDCARDS
|
1997-10-23 22:39:09 +00:00
|
|
|
When using
|
|
|
|
.BI "isdnctrl addphone " name " in " num
|
|
|
|
to add phone numbers to the incoming-call accept-list of an interface,
|
|
|
|
wildcards similar to shell wildcards can be used.
|
1997-02-17 00:09:41 +00:00
|
|
|
The following wildcards are supported:
|
|
|
|
|
|
|
|
.TP 7
|
1997-10-23 22:39:09 +00:00
|
|
|
.B ?
|
1997-02-17 00:09:41 +00:00
|
|
|
one arbitrary digit
|
|
|
|
.TP 7
|
1997-10-23 22:39:09 +00:00
|
|
|
.B *
|
|
|
|
zero or arbitrary number of digits
|
1997-02-17 00:09:41 +00:00
|
|
|
.TP 7
|
1997-10-23 22:39:09 +00:00
|
|
|
.BI [ list ]
|
|
|
|
one of the digits in
|
|
|
|
.I list
|
1997-02-17 00:09:41 +00:00
|
|
|
.TP 7
|
1997-10-23 22:39:09 +00:00
|
|
|
.BI [ 1 - 5 ]
|
|
|
|
one digit in the range of (including)
|
|
|
|
.IR 1 " and " 5 .
|
1997-02-17 00:09:41 +00:00
|
|
|
.TP 7
|
1997-10-23 22:39:09 +00:00
|
|
|
.B ^
|
|
|
|
if this appears as the first character in a list, inverts the list.
|
1997-02-17 00:09:41 +00:00
|
|
|
.LP
|
|
|
|
.SH BUGS
|
|
|
|
This man page is not complete.
|
|
|
|
.LP
|
|
|
|
.SH AUTHOR
|
1997-10-23 22:39:09 +00:00
|
|
|
Fritz Elfert <fritz@wuemaus.franken.de>
|
1997-02-17 00:09:41 +00:00
|
|
|
.LP
|
|
|
|
.SH SEE ALSO
|
1997-10-23 22:39:09 +00:00
|
|
|
.BR ttyI "(4), " isdnctrl "(4), " isdninfo "(4), " isdn_audio "(4), "
|
|
|
|
.BR isdn_cause (7).
|