ISDNCTRL(8)

NAME
isdnctrl - get/set ISDN device information

SYNOPSIS
isdnctrl action device ...

DESCRIPTION
isdnctrl is used to create and delete network interfaces for ISDN, set up the various parameters and phone numbers for dial in and dial out. It is also used to list the current paramteters of an already configured interface.

The use of isdnctrl is independent of the hardware driver.

OPTIONS
The following actions may be given to isdnctrl.

addif [name]
    Adds a new ISDN IP-interface "name" to the kernel. If "name" is omitted, the kernel will use "ethX", while X is an increasing number starting from 0.

delif name
    Removes the ISDN IP-interface "name" from the kernel.

addphone name out num
    Set the phone number(s) of the remote site for the IP-interface "name". More than one number can be set by calling isdnctrl addphone repeatedly. If more than one number is set these will be tried one after another. When using an german SPV-type connection, with a ICN-card, the number has to be preceeded by a capital S.

addphone name in num
    Set the phone number(s) that the IP-interface "name" is supposed to accept for incoming calls. If no number is given incoming calls are disabled. More than one number can be set by calling isdnctrl addphone repeatedly. Also wildcards can be used (see below).

delphone name in|out num
    Remove phone number "num" from the incoming or outgoing phone list.

eaz name [num]
    Set the EAZ (German 1TR6 protocol) or MSN (Euro-ISDN E-DSS1) for interface "name" to "num". For an EAZ this is only one digit, for a MSN "num" is the whole MSN. If "num" is omitted isdnctrl eaz name prints the current setting for interface "name".

huptimeout name [seconds]
    Set the hangup timeout for interface "name" to "seconds". If there is inactivity (i.e. no traffic on the interface) for the given time the driver automatically shuts down the connection. If "seconds" is omitted isdnctrl huptimeout name prints the current setting for interface "name".

cbdelay name [seconds]
    Set the callback delay for interface "name" to "seconds". If callback mode for this interface is in , dialing is delayed the given time. If the callback mode is out , after dialing out and waiting the given time, a hangup is issued to free the line for the incoming callback from the remote machine. This hangup-after-dial is disabled by setting cbdelay to 0. If "seconds" is omitted isdnctrl cbdelay name prints the current setting for interface "name".

dialmax name [num]
    Set the number of dial atempts for interface "name" to "num". If dialing, each phonenumber is tried this many times before giving up. If "num" is omitted isdnctrl dialmax name prints the current setting for interface "name".

ihup name [on|off]
    Turn on or off the hangup timeout for incoming calls on interface "name". If none of on or off is given the current setting is printed.

chargehup name [on|off]
    Turn on or off hangup before next charge info for interface name. This can only be used if the 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 none of on or off is given the current setting is printed.

chargeint name [seconds]
    When "seconds" are given, the charge interval for the given interface is set. This may be of use on ISDN lines with no chargeinfo or no online chargeinfo. The connection will only be closed 2 seconds before the end of the next charge interval and only, if huptimeout seconds of inactivity have been reached. If ihup is on, also incomming connections are closed by this mechanism. On lines with online charge info you also might ask by chargeint name for the current charge interval as delivered from the telecom on a given interface.

secure name [on|off]
    Turns on or off the security feature for interface "name". If set to on, incoming calls will only be accepted if the calling number has been added to the access list with isdnctrl addphone name in. If none of on or off is given the current setting is printed.

callback name [on|off|in|out]
    Selects callback mode for interface "name". If callback mode is in , then after getting an incoming call, a callback is triggered. If callback mode is out , then this system does the initial call, then waiting for callback of the remote machine. The option on is available only for compatibility with older versions. Its meaning is the same like in.

cbhup name [on|off]
    Turns on or off Hangup (Reject) for interface "name" before starting Callback. If none of on or off is given the current setting is printed.

encap name [encapname]
    Set the encapsulation mode for interface "name". Possible modes for encapname are: rawip raw ip encapsulation (default) ip ip + typefield encapsulation cisco_h Special mode for communicating with a Cisco in HDLC-mode. ethernet ethernet over ISDN syncppp Synchronous PPP over ISDN uihdlc raw ip with additional ui-header If encapname is omitted the current setting is printed.

l2_prot name [protocol]
    Set the layer-2 protocol for interface "name". Possible values for "protocol" are x75i, x75ui, x75bui and hdlc If protocol is omitted the current setting is printed.

l3_prot name [protocol]
    Set the layer-3 protocol for interface "name". At the moment only trans is supported. If protocol is omitted the current setting is printed.

list name
    List all parameters and the charge info for interface "name".

verbose <num>
    Set verbosity level to <num>.

hangup name
    The connection of interface "name" is cloes immediately.

bind name driverId channel [exclusive]
    Binds an interface "name" to specific physical channel. The driverId identifies the desired driver. The channels of a card start counting with zero. If "exclusive" is given, other interfaces cannot use that interface anymore.

unbind name
    Unbinds a the previously bound interface "name".

busreject driverId [on|off]
    If switched on, isdn4linux replies a REJECT to incoming calls, it cannot match to any configured interface. If switched off, nothing happens in this case. You normally should NOT enable this feature, if the 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.

addslave name slavename
    Adds a slave interface to interface "name" for channel-bundling. For bundling of more than two channels, any number of slaves can be added to an interface. "name"must refer to an existing "real" interface (not a slave). Slaves are not visible to the kernel, however all usual ISDN-settings can be configured. It is important that slave interfaces are added before the corresponding master is started by ifconfig. If the master is already up, it has to be shutdown with ifconfig down ... otherwise the addslave command will be rejected.

sdelay name <num>
    Set delay for slave-dialing. An interface has to have a load of more than 7000 cps for at least this time (in seconds), before it's slave is started.

dial name
    Force dialing of interface "name".

mapping driverId MSN0[,MSN1[,MSN2]] ... [,MSN9]
    Installs a mapping-table for MSN<->EAZ-mapping. See README for details.

WILDCARDS
For matching incoming calls phone numbers can be be set by isdnctrl addphone name in num using pattern matching like the regular expressions in shells. The following wildcards are supported:

?   one arbitrary digit

*   zero or arbitrary many digits

[123]
    one of the digits in the list

[1-5]
    one digit between '1' and '5'

^   as the first character in a list inverts the list

BUGS
This man page is not complete.

AUTHOR
Volker Goetz <volker@oops.franken.de>

SEE ALSO
ttyI (4), icnctrl (8), telesctrl (8), isdninfo (4).