Editorials - ISDNCTRL(8) man page


    ISDNCTRL(8)    Linux System Administration    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 parameters of an already configured network interface.
      isdnctrl is notneeded for configuration of ISDNttys!

      The use of isdnctrlis independent of the hardware driver.

    OPTIONS
      The following actions may be given to isdnctrl.

      addif name

        Adds a new ISDN interface name to the kernel. If nameis omitted, the
        kernel will use ethX, where X is an increasing number starting from 0.
        This is probably not useful with ISDN so using a name like isdn0 (for
        raw ip interfaces) or ippp0 (for synchronous PPP interfaces) is always recommended.

      delif name [force]
        Removes the ISDN interface name from the kernel. If the optional keyword force
        is appended, isdnctrl executes ifconfig name down before
        removing it.

      reset [force]
        Removes all ISDN interfaces from the kernel if it is possible. If the optional keyword
        force is appended, isdnctrl executes ifconfig name down
        before removing an interface.

      ifdefaults name
        resets the interface name to some reasonable defaults.

      dialmode name [off|manual|auto]

        Sets the dial mode of the interface to one of:

        off
        no connection can be made; an existing connection is terminated imme-
        diately. Incoming connections are also not possible.

        manual
        manual dialing / hangup; a connection will only be made after isdnctrl
        dial name and only an explicit isdnctrl hangup name will cause the
        connection to be dropped.
        Incoming connections are possible; however, if this interface is con-
        figured in callback in mode, the callback dial will not happen (as
        this is actually an outgoing connection, not an incoming one).

        auto

        autodial mode; an outgoing packet will trigger a dialout, and a hangup
        will occur after the huptimeout value specified (see below).
        An interface in auto dial mode will call another system back (if con-
        figured in callback in mode).

        auto was the "old" behaviour (as it was before dialmode was imple-
        mented).

        If no argument is given, the current dialmode value is displayed.

        You can give all as the interface name; the command will then be exe-
        cuted for all interfaces.

      addphone name out num
        Adds the phone number num to the list of outgoing numbers of the ISDN
        interface name. Numbers in this list are used to dial the remote sta-
        tion if the connection is down and packets are to be sent via the
        interface (Dial on demand). 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 (the last added number is tried first,
        etc.). When using a german SPV-type connection, the number has to be
        prefixed by a capital S.

      addphone name in num
        Adds the phone number num to the list of incoming numbers of the ISDN
        interface name. Numbers in this list are used to verify access per-
        mission of the remote station if an incoming call is received. The
        verification can be disabled by setting the interface into insecure
        mode using isdnctrl name secure off. If the list is empty, incoming
        calls are disabled. More than one number can be added by calling isd-
        nctrl addphone
        repeatedly. Also wildcards can be used (see below).
      delphone name in|out num

        Removes 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 ISDN
        interface name to num. For an EAZ this is only one digit, while for
        an MSN num is the whole MSN (usually the local phone number). If num
        is omitted, isdnctrl prints the current setting for ISDN interface
        name.

      huptimeout name [seconds]
        Set the hangup timeout for ISDN 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 prints the current setting for interface name.

      cbdelay name [seconds]
        Set the callback delay for ISDN interface name to seconds. If call-
        back 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 prints the current set-
        ting for interface name.

      dialmax name [num]
        Set the number of dial attempts for ISDN interface name to num. If
        dialing, each phone number is tried this many times before giving up.
        If num is omitted isdnctrl 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 on or off is omitted 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 dur-
        ing 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.

      chargeint name [seconds]
        If seconds are given, the charge interval for the given interface is
        set. This may be useful on 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 huptimeout seconds of inactivity
        have been reached. If ihup is on, incoming connections are closed by
        this mechanism also. 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 can be
        found in the incoming access list. See description of action addphone
        for information about how to add numbers to this list. If on or off
        is omitted, the current setting is printed.

      callback name [mode]
        Set callback mode for interface name to mode mode. If callback mode
        is in, then after getting an incoming call, a callback is triggered.
        If callback mode is out, then the local system does the initial call
        and then waits for callback of the remote machine. The option on is
        available only for compatibility with older versions. Its meaning is
        the same like in. If callback mode is off, calls are handled normally
        without special processing.

      cbhup name [on|off]
        Turns on or off Hangup (Reject) for interface name before starting
        callback. If cbhup is on, when receiving an incoming call, the inter-
        face first rejects that call before the callback sequence is started.
        If on or off is omitted, the current setting is printed.

      encap name [encapsulation]
        Set the encapsulation mode for interface name. Possible encapsula- tions are:

        rawip
        raw ip encapsulation (default)

        ip
        IP + typefield encapsulation

        cisco_h
        Special mode for communicating with a Cisco in HDLC-mode with Cisco-
        keepalive switched off.

        ethernet
        ethernet over ISDN (MAC-header included)

        syncppp
        Synchronous PPP over ISDN

        uihdlc
        raw ip with additional ui-header

        cisco_hk
        Special mode for communicating with a Cisco in HDLC-mode with Cisco-
        keepalive switched on.

        x25iface
        Provides an interface as required by the Linux X.25 PLP protocol
        implementation (requires Linux 2.1.x or newer).

      If encapsulation is omitted, the current setting is printed.

      l2_prot name [protocol]

        Set the layer-2 protocol for interface name. Possible values for pro-
        tocol
        are:
        x75i, x75ui, x75bui and hdlc. If protocol is omitted the current set-
        ting is printed.

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

      list name
        List all parameters and the charge info for interface name. If name
        is all, then all interfaces are listed.

      verbose num
        Set verbosity level to num.

      hangup name
        The connection of interface name is closed immediately.

      bind name driverId,channel [exclusive]
        Binds an interface name to a physical channel. The driverId identi-
        fies a specific S0-Port. The channels of a port start counting with
        zero. If exclusive is given, other interfaces cannot use that inter-
        face anymore. Otherwise, the channel may be used by other interfaces.

      unbind name
        Unbinds a the previously bound interface name.

      pppbind name [num]
        Binds the interface name to an ippp device /dev/ipppnum. This works
        only for synchronous ppp. The value must be a number. If num is omit-
        ted and name is called ipppX , then the interface is bound to
        /dev/ipppX.

      pppunbind name
        Unbinds the previously bound interface name.

      busreject driverId [on|off]
        If switched on, instead of ignoring incoming calls not matching any
        interface, isdn4linux responds with a REJECT to those calls. If
        switched off, isdn4linux is passive, allowing other devices connected
        to the same S0-bus to answer the call. 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 slave
        Adds a slave interface named slave to interface 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. name
        must refer to an existing "master" interface (not a slave). Slave
        interfaces are not visible to the kernel, however all usual ISDN set-
        tings can be configured. Because slave interfaces are not visible to
        the kernel, they are configured "through" their "master", so 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 com-
        mand will be rejected.

      sdelay name num
        Set delay for slave-dialing. The master interface name has to have a
        load of more than trigger cps for at least num seconds, before it's
        slave starts dialing.

      trigger name num
        Set trigger level for slave-dialing. The master interface name has to
        have a load of more than num cps for at least sdelay seconds, before
        its slave starts dialing.

      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.

      writeconf file
        Writes the configuration into a file. If file is omitted, the default
        file /etc/isdn/isdn.conf will be used.

      readconf file
        Reads the configuration from a file. If file is omitted, the default
        file /etc/isdn/isdn.conf will be used.

    Syntax of the configuration file
      This syntax will be used for the options readconf and writeconf.

      All entries are included in the section [ISDNCTRL]. This section contains an
      entry INTERFACES, which describes the interfaces. Each subsection [INTERFACE]
      or [SLAVE] describes one interface. There are the following entries possible:

      NAME = name

        The name of the interface. This entry is required.

        Example: NAME = ippp0

      EAZ = eaz
        Set the EAZ or the MSN. This entry is required.

        Example: EAZ = 4711

      PHONE_IN = num [num...]
        Set the incoming phone number(s). It requires at least one blank
        between the different numbers.

        Example: PHONE_IN = 08151234 08151235 08151236

      PHONE_OUT = num [num...]
        Set the outgoing phone number(s). It requires at least one blank
        between the different numbers.

        Example: PHONE_OUT = 08151237 08151238

      SECURE = on|off
        Turn on or off the security feature.

        Example: SECURE = on

      CALLBACK = off|in|out
        Selects callback mode.

        Example: CALLBACK = in

      CBHUP = on|off
        Turns on or off hangup before starting callback.

        Example: CBHUP = on

      CBDELAY = seconds
        Set the callback delay to seconds.

        Example: CBDELAY = 5

      DIALMAX = num
        Set the number of dial atempts to num.

        Example: DIALMAX = 1

      HUPTIMEOUT = seconds
        Set the hanguptime to seconds.

        Example: HUPTIMEOUT = 20

      IHUP = on|off
        Turns on or off the hangup timeout for incoming calls.

        Example: IHUP = on

      CHARGEHUP = on|off
        Turns on or off hangup before next charge info.

        Example: CHARGEHUP = on

      CHARGEINT = seconds
        Sets the charge interval to seconds.

        Example: CHARGEINT = 1

      L2_PROT = protocol
      '
        Set the layer-2 protocol. Allowed values for protocol are x75i,x75ui , x75bui and hdlc.

        Example: L2_PROT = hdlc

      L3_PROT = protocol
        Set the layer-3 protocol. Allowed value for protocol is only trans.

        Example: L3_PROT = trans

      ENCAP = encapsulation
        Sets the encapsulation mode. Allowed values for encapsulation are
        rawip, ip, cisco_h, cisco_hk, ethernet, syncppp and uihdlc.

        Example: ENCAP = rawip

      ADDSLAVE = slave
        Adds a slave interface for channel-bundling.

        Example: ADDSLAVE = s-ippp0

      SDELAY = seconds
        Set the delay in seconds for the slave-dialing.

        Example: SDELAY = 10

      TRIGGER = cps
        Set trigger level for slave-dialing.

        Example: TRIGGER = 4000

      BIND = driverId,channel
        Binds the current interface to a specific physical channel. Before and
        after the comma may not be a blank.

        Example: BIND = teles1,0

      PPPBIND = num
        Binds the current interface to the ippp device /dev/ipppX. This works
        only for syncronous ppp. The value must be a number.

        Example: PPPBIND = 0

      Example for a configuration file

        [ISDNCTRL]
          INTERFACES = {
          [INTERFACE]
          NAME = isdn0
          EAZ = 4711
          PHONE_IN = 08151234
          PHONE_OUT = 08151234
          SECURE = on
          DIALMAX = 1
          HUPTIMEOUT= 20
          IHUP = on
          CHARGEHUP = on
          L2_PROT = hdlc
          L3_PROT = trans
          ENCAP = rawip
          ADDSLAVE = s-isdn0
          SDELAY = 10

          [SLAVE]
          NAME = s-isdn0
          EAZ = 4711
          PHONE_OUT = 08151234
          SECURE = on
          DIALMAX = 1
          HUPTIMEOUT= 10
          IHUP = on
          CHARGEHUP = on
          L2_PROT = hdlc
          L3_PROT = trans
          ENCAP = rawip

          [INTERFACE]
          NAME = ippp0
          EAZ = 4712
          PHONE_OUT = 08151235 08151236
          SECURE = on
          DIALMAX = 5
          HUPTIMEOUT= 200
          IHUP = on
          CHARGEHUP = on
          L2_PROT = hdlc
          L3_PROT = trans
          ENCAP = syncppp
          PPPBIND = 0
          }

      status name[on|off]
        Switches the interface name on or off. If set to off , incoming calls
        for this interface are ignored and no dialout will be triggered. If the
        interface is already connected it will be hung up.

      dialtimeout name[seconds]
        Maximum duration of dialattempts. A dialout must not take longer than
        seconds . seconds.

      dialwait name[seconds]
        After a failed dialattempt all dials are blocked for seconds seconds.

      addrule namerule
        adds a timeout-rule to the interface name. The rule is appended to the
        list of rules. The syntax of the rules is explained in section Dynamic
        Timeout Rules
        .

      insrule name.rule
        adds a timeout-rule to the interface name. The rule is prepended to the
        list of rules.

      delrule namerule
        removes a timeout-rule from the list of rules of the interface name.

      showrules name
        shows all timeout-rules of the interface name.

      flushrules nameruletype
        removes all timeout-rules of the given type from the interface name.

      flushallrules name
        removes all timeout-rules from the interface name.

      budget nametypeamountperiod

        sets a budget for the interface name. Budgets are explained in section
        Budgets .

      showbudgets name
        shows all budgets for the interface name.

      readbudgets name
        dumps the budgets for the interface name. in a format suitable for
        laster restore to allow budgetperiods to span reboots.

      writebudgets name
        restore the budgets for the interface name. from the output of a
        "readbudgets" - command.

    WILDCARDS
      When using isdnctrl addphone name in num to add phone numbers to the incom-
      ing-call accept-list of an interface, wildcards similar to shell wildcards
      can be used. The following wildcards are supported:

      ? one arbitrary digit

      * zero or arbitrary number of digits

      [list] one of the digits in list

      [1-5] one digit in the range of (including) 1 and 5.

      ^ if this appears as the first character in a list, inverts the list.

    BUGS

      This man page is not complete.

    AUTHOR

      Fritz Elfert fritz@wuemaus.franken.de

    SEE ALSO

      ttyI(4), isdnctrl(4), isdninfo(4), isdn_audio(4), isdn_cause(7).


    Translated to HTML by [MIA]

Main - Books - Editorials - Linux & Unix Links - Tutorials - X Window Managers - FTP
Distributions - Gimp - Perl - About Us - Sitemap - Mail Us! - Security - Linux Vs. NT - What's New?

Created By [MIA], November 16, 1998 ,Copyright © LinuxPowered.com 1998-1999
Last Modified  February 20, 1999