Alcatel-Lucent SPEDDTOUCH DSL ROUTERS User Manual 2

SPEED TOUCH

CLI Reference Guide

DSL Routers

3EC 16982 AAAA TCZZA Ed. 04

Status

Released

2 / 300

Change Note

Short Title

BD F aa 34022

CD-UG STCLI

3EC 16982 AAAA TCZZA Ed. 04

Contents

Preface 5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1 ADSL Commands 19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2 ATMF Commands 21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 Bridge Commands 29. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4 CIP Commands 45. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5 Config Commands 55. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6 DHCP Commands 61. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7 DNS Commands 99. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8 Firewall Commands 121. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents

9 IP Commands 147. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10 MER Commands 169. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11 NAT Commands 181. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

12 Phonebook Commands 197. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13 PPP Commands 207. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14 PPTP Commands 225. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

15 QoSBook Commands 235. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16 SHDSL Commands 243. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17 Software Commands 249. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

18 System Commands 255. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

19 TD Commands 263. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

20 Voice Commands 267. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21 Wireless Commands 273. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Index 297. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3EC 16982 AAAA TCZZA Ed. 04

3 / 300

Contents

4 / 300

3EC 16982 AAAA TCZZA Ed. 04

Preface

Welcome to the Alcatel Speed Touch Command Line Interface Reference Guide !

This Reference Guide aims to give the fastidious user a concise, practical and easy to use document for configuring the Speed Touch via its character based Command Line Interface.

Although the Speed Touch Web interface is adequate enough for most users, access via the CLI may be still important for advanced and detailed configuration and troubleshooting.

This CLI Reference Guide covers the CLI commands of all Alcatel's DSL Speed Touch products. Therefore it is possible that far more commands are described than available on your Speed Touch product. Please ignore all CLI commands which are not applicable for your product.

The Reference Guide consists of three main parts:

 Part 1 : CLI Navigation

This part is meant to make the user familiar with the use and operation of the Speed Touch CLI. In brief some general manipulations are described to navigate through and to perform some operations on the CLI.

 Part 2 : CLI Command Description

This part forms the main part of this Reference Guide. Here all available CLI commands of all Speed Touch products are alphabetically described per group selection.

Each command is described in a systematic manner:

 The full name of the CLI command (including the group selection)

 A short description of the CLI command, if needed completed by a description of the

possible impact on the user and/or the Speed Touch

 The syntax of the command with a description of each parameter

 An example to demonstrate the use of the CLI command

 A list of related CLI commands.

 Part 3 : CLI Command Index

This part allows the user to look up a command alphabetically in its incomplete form.

3EC 16982 AAAA TCZZA Ed. 04

5 / 300

Preface

 Trademarks

The following trademarks are used in this document:

 Speed Touch is a trademark of the Alcatel Company  Netscape and Netscape Navigator are registered trademarks of Netscape

Communications Corporation

 Windows and Internet Explorer are trademarks of Microsoft Corporation  Apple and MacOS are registered trademarks of Apple Computer Inc.  UNIX is a registered trademark of UNIX System Laboratories, Inc.  Ethernet is a trademark of Xerox Corporation.

Other products may be trademarks or registered trademarks of their respective manufacturers.

 Updates

Due to the continuous evolution of the Alcatel DSL technology, existing products are regularly upgraded. Alcatel documentation changes accordingly.

For more information on the newest technological changes and documents, please consult the Alcatel web site at following URL:

http://www.alcatel.com

http://www.alcateldsl.com

 Directive

Unless expressly and unambiguously approved by Alcatel, you may not:

 disassemble, decompile, reverse engineer, trace or otherwise analyse the equipment, its

content, operation, or functionality, or otherwise attempt to derive source code (or the underlying ideas, algorithms, structure or organization) from the equipment or from any other information provided by Alcatel, except to the extent that this restriction is expressly prohibited by local law;

 copy, rent, loan, resell, sublicense, or otherwise transfer or distribute the equipment to

others;

 modify, adapt or create a derivative work of the equipment;

 remove from any copies of the equipment any product identification, copyright or other

notices;

 disseminate performance information or analysis (including, without limitation,

benchmarks) from any source relating to the equipment.

Such acts not expressly approved by Alcatel will result in the loss of product warranty and will invalidate the user's authority to operate this equipment.

6 / 300

3EC 16982 AAAA TCZZA Ed. 04

Alcatel

Speed Touch

CLI Navigation

3EC 16982 AAAA TCZZA Ed. 04

7 / 300

8 / 300

3EC 16982 AAAA TCZZA Ed. 04

Accessing the Command Line Interface

Users can access the Command Line Interface via:

 A Telnet session

This requires that TCP/IP connectivity exists between the host from which the Telnet session is opened and the Speed Touch

 The serial 'Console' interface

This requires a Speed Touch product which is equipped with a 'Console' port on its back panel.

As soon a session to the CLI is opened, the Speed Touch banner pops up, followed by the CLI prompt.

In case of a Telnet session authentication via the Speed Touch System Password might be required before access is granted.

The following figure shows an example of the Speed Touch banner after opening a Telnet session and authentication.

EXAMPLE:

/home/doejohn{1}$ telnet 10.0.0.138 Trying 10.0.0.138... Connected to 10.0.0.138. Escape character is ’^]’. User : SpeedTouch (00–90–D0–00–01–23–45) Password : ###### –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––– * * ______ * ___/_____/\ * / /\\ ALCATEL DSL ROUTER * _____/__ / \\ * _/ /\_____/___ \ * // / \ /\ \ * _______//_______/ \ / _\/______ Copyright 1999–2001. * / / \ \ / / / /\ * __/ / \ \ / / / / _\__ * / / / \_______\/ / / / / /\ * /_/______/___________________/ /________/ /___/ \ * \ \ \ ___________ \ \ \ \ \ / * \_\ \ / /\ \ \ \ \___\/ * \ \/ / \ \ \ \ / * \_____/ / \ \ \________\/ * /__________/ \ \ / * \ _____ \ /_____\/ * \ / /\ \ /___\/ * /____/ \ \ / * \ \ /___\/ * \____\/ * ––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––– =>

3EC 16982 AAAA TCZZA Ed. 04

9 / 300

Navigation and Manipulation

Manipulation commands are commands that manipulate operations on the command line, for example changing the command group, go to the beginning of the command line, go to the end of the command line, etc.

Command group Navigation

From top level, you can change to a command group by executing the name of the desired command group.

To obtain a list of all available command groups, execute help from the top level.

EXAMPLE:

=>help Following commands are available : help : Displays this help information ? : Displays this help information exit : Exits group selection. .. : Exits group selection.

Following command groups are available : dhcp dns td atmf mer bridge pptp ppp cip nat qosbook phonebook ip software system config firewall

=>atmf [atmf]=>

To return to top level, or to descend one level (in case of nested command groups) execute .. or exit (depending on the Speed Touch product).

EXAMPLE:

=>atmf [atmf]=> [atmf]=>.. =>

10 / 300

3EC 16982 AAAA TCZZA Ed. 04

The Help Command

Execute help from top level to list all available command groups for the Speed Touch.

EXAMPLE:

=>help

Following commands are available : help : Displays this help information ? : Displays this help information exit : Exits group selection. .. : Exits group selection.

Following command groups are available : dhcp dns td atmf mer bridge pptp ppp cip nat qosbook phonebook ip software system config firewall

=>

The available command groups depend on the particular Speed Touch the CLI session is opened to, e.g. the wireless command group is only present for the SpeedTouch570 product.

You can execute the help command from each command group selection. This results in a list of the available commands (and nested command groups, if available) in this particular command group.

EXAMPLE:

=>atmf [atmf]=>

[atmf]=>help

Following commands are available : add : Adds a VP or VC cross–connection between the ATMF interface and the WAN interface. delete : Deletes a cross–connection on the ATM–Forum interface. list : Shows all ATM–Forum interface cross–connections. save : Saves the ATM–Forum interface cross–connections. flush : Flushes the ATM–Forum interface cross–connections. load : Loads ATM–Forum interface cross–connections.

[atmf]=>

3EC 16982 AAAA TCZZA Ed. 04

11 / 300

Executing e.g. help atmf from top level gives the same result as executing help from the atmf command group selection.

EXAMPLE:

=>help atmf

Following commands are available : add : Adds a VP or VC cross–connection between the ATMF interface and the WAN interface. delete : Deletes a cross–connection on the ATM–Forum interface. list : Shows all ATM–Forum interface cross–connections. save : Saves the ATM–Forum interface cross–connections. flush : Flushes the ATM–Forum interface cross–connections. load : Loads ATM–Forum interface cross–connections.

=>

Entering help followed by a specific command, e.g. help atmf add (starting from top level) or help add (e.g. on the atmf command group selection) results in a description of the syntax for the

command.

EXAMPLE:

=>help atmf add

add : Adds a VP or VC cross–connection between the ATMF interface and the WAN interface.

vpi = <number{0–15}> The Virtual Path Identifier. vci = <number{0–511}> The Virtual Channel Identifier. Use 0 for a VP crossconnect.

=>

Command Completion

For some Speed Touch products the CLI features command completion, which means that when starting to enter a command it can be completed by pressing the Tab" key.

For example, entering a at the atmf command group selection, followed by a Tab" stroke results in the full add command being completed. Entering atmf a from top level gives the same result.

For the completion to be successful, the part to be added must be unique. Completion works for the command groups, for the commands, for the options, but not for values.

EXAMPLE:

=>atmf [atmf]=>a “Tab“ [atmf]=>add

12 / 300

3EC 16982 AAAA TCZZA Ed. 04

Going to the beginning or end of the Command Line

Go to the beginning of the Command Line by pressing "Ctrl+A"; to go to the end of the Command Line press "Ctrl+E".

In the following example, the first second

 the position of the cursor after pressing "Ctrl+E".

 indicates the position of the cursor after pressing "Ctrl+A", the

EXAMPLE:

=>list

Breaking off Commands

You can break off a command by pressing Ctrl+G". This can be useful in a situation where a user is prompted to enter a value which it does not know and wants to abort the command. Instead of being prompted over and over again for the same value, this allows to break of the command.

In the example below Ctrl+G" is pressed after the third prompt `vpi =`. The command is broken of and the user returns to the command line.

EXAMPLE:

[atmf]=>add vpi = vpi =

vpi =

Ctrl+G" [atmf]=>

History of Commands

To retake previous commands press the up arrow    and come back to more recent commands with the down arrow   . Press Enter (

EXAMPLE:

=>atmf [atmf]=>list VPI = 0 VCI = 0 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0

[atmf]=> =>:list

  

↵)" to select and execute the retaken command.

3EC 16982 AAAA TCZZA Ed. 04

13 / 300

Command Line Interface Top Level Structure

Depending on the Speed Touch product the following command groups are available:

 adsl (only applicable for SpeedTouch ADSL variants)  atmf (only applicable for SpeedTouch models equipped with an ATMF25.6Mbps port)  bridge  cip (only applicable for SpeedTouch DSL routers)  config  dhcp  dns  env (only applicable for SpeedTouch510Series)  firewall (only applicable for SpeedTouchPro with Firewall and

SpeedTouch520Series)

 ip  mer (only applicable for SpeedTouchPro with Firewall and SpeedTouch520Series)  nat (only applicable for Speed Touch DSL routers)  phonebook  ppp (only applicable for Speed Touch DSL routers)  pptp  qosbook (only applicable for SpeedTouchPro with Firewall and

SpeedTouch520Series)

 shdsl (only applicable for SpeedTouch SHDSL variants)  software  system  td  voice (only applicable for the SpeedTouch700/710/720)  wireless (only applicable for the SpeedTouch570)

14 / 300

3EC 16982 AAAA TCZZA Ed. 04

Command Line Interface Commands

All CLI commands are commands that operate on, or configure, the Speed Touch settings.

You can execute these commands from top level, preceded by the name of the command group from which the command should be executed (e. g. atmf list).

You can also execute the commands from the command group itself, using the reduced form of the command (e.g. list at the atmf command group selection).

When executing commands with specification of their parameter values, it is not necessary to use `=`. E.g. `atmf add vpi 0 vci 35` is equal to `atmf add vpi=0 vci=35`. `!` in a command means `NOT`, e.g. the `[!]syn` parameter in the firewall rule create command.

EXAMPLE:

=>atmf list

VPI = 0 VCI = 0 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0

=>atmf [atmf]=>list

VPI = 0 VCI = 0 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0 [atmf]=>

Instead of entering a completely builtup command with all its parameters, you can also enter just the command itself, without its parameters. After this you are prompted to complete the command with the required and the optional parameters. For the optional parameters you can simply press enter without giving a value.

The example below is the equivalent of `atmf add vpi 0 vci 35`. To break of such incomplete command press Ctrl+G".

EXAMPLE:

=>atmf add vpi = 0 vci = 35 =>

3EC 16982 AAAA TCZZA Ed. 04

15 / 300

16 / 300

3EC 16982 AAAA TCZZA Ed. 04

Alcatel

Speed Touch

CLI Command Description

3EC 16982 AAAA TCZZA Ed. 04

17 / 300

18 / 300

3EC 16982 AAAA TCZZA Ed. 04

1 ADSL Commands

adsl (to access the ADSL level) adsl info

1 ADSL Commands

3EC 16982 AAAA TCZZA Ed. 04

19 / 300

1 ADSL Commands

adsl info

Show ADSL statistics and information about the SpeedTouch status.

SYNTAX:

adsl info

EXAMPLE:

=>adsl info

Modemstate : up Operation Mode : G.DMT Annex A [ POTS Overlay Mode ] Channel Mode : fast Number of resets : 1

Vendor (ITU) Local Remote Country : 0f 0f Vendor : ALCB ALCB VendorSpecific : 0000 0000 StandardRevisionNr : 01 01

Downstream Upstream Margin [dB] : 31 31 Attenuation [dB] : 26 13

Available Bandwidth Cells Kbits Downstream : 2641 1014 Upstream : 301 115

Transfer statistics Total since power On Cells Kbits Downstream : 185670 71297 Upstream : 10254 3937 Current Connection Downstream : 185668 71296 Upstream : N/Avail N/Avail Errors Received FEC : 0 Received CRC : 0 Received HEC : 0 =>

20 / 300

3EC 16982 AAAA TCZZA Ed. 04

2 ATMF Commands

atmf (to access the ATMF level) atmf add atmf delete atmf flush atmf list atmf load atmf save

2 ATMF Commands

3EC 16982 AAAA TCZZA Ed. 04

21 / 300

2 ATMF Commands

atmf add

Add a crossconnection between the ATMF25 interface and the WAN interface.

SYNTAX:

atmf add vpi = <number {07}>

vci = <number {0511}>

vpi A number between 0 and 7.

Represents the Virtual Path identifier.

vci A number between 0 and 511.

Represents the Virtual Channel identifier. Use VCI=0 for a VP crossconnection.

EXAMPLE:

=>atmf list VPI = 0 VCI = 0 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0 =>atmf delete vpi 0 vci 0

=>atmf add vpi 0 vci 35

=>atmf list VPI = 0 VCI = 35 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0 =>

REQUIRED

RELATED COMMANDS:

atmf delete Delete a crossconnection on the ATMF25 interface. atmf list Show current ATMF25 interface configuration.

22 / 300

3EC 16982 AAAA TCZZA Ed. 04

atmf delete

Delete a crossconnection on the ATMF25 interface.

SYNTAX:

atmf delete vpi = <number {07}>

vci = <number {0511}>

2 ATMF Commands

vpi A number between 0 and 7.

Represents the Virtual Path identifier.

vci A number between 0 and 511.

Represents the Virtual Channel identifier. Use VCI=0 for a VP crossconnection.

EXAMPLE:

=>atmf list VPI = 0 VCI = 35 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0

=>atmf delete vpi 0 vci 35

=>atmf list VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0 =>

REQUIRED

RELATED COMMANDS:

atmf add Add a crossconnection on the ATMF25 interface. atmf list Show current ATMF25 interface configuration.

3EC 16982 AAAA TCZZA Ed. 04

23 / 300

2 ATMF Commands

atmf flush

Flush complete ATMF25 interface configuration. The flush command does not impact previously saved configurations.

SYNTAX:

atmf flush

EXAMPLE:

=>atmf list VPI = 0 VCI = 35 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0

=>atmf flush

=>atmf list =>atmf load =>atmf list VPI = 0 VCI = 35 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0 =>

RELATED COMMANDS:

atmf load Load saved or default ATMF25 interface configuration. atmf save Save current ATMF25 interface configuration.

24 / 300

3EC 16982 AAAA TCZZA Ed. 04

atmf list

Show all current ATMF25 interface crossconnections .

SYNTAX:

atmf list

EXAMPLE OUTPUT:

=>atmf list

VPI = 0 VCI = 35 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0 =>

2 ATMF Commands

RELATED COMMANDS:

atmf add atmf delete

Add an ATMF25 interface crossconnection. Delete a crossconnection on the ATMF25 interface.

3EC 16982 AAAA TCZZA Ed. 04

25 / 300

2 ATMF Commands

atmf load

Load saved (or default) ATMF25 interface configuration. Execute atmf flush prior to atmf load.

SYNTAX:

atmf load [defaults <yes|no>]

[defaults] Load factory defaults (yes) or saved configuration (no).

Not specifying this parameter loads the saved configuration

EXAMPLE:

=>atmf list VPI = 0 VCI = 35 =>atmf save =>atmf flush

=>atmf load defaults yes

=>atmf list VPI = 0 VCI = 0 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 VPI = 4 VCI = 0 VPI = 5 VCI = 0 VPI = 6 VCI = 0 VPI = 7 VCI = 0 =>atmf flush

=>atmf load defaults no

=>atmf list VPI = 0 VCI = 35 =>

RELATED COMMANDS:

atmf flush Flush complete ATMF25 interface configuration. atmf save Save current ATMF25 interface configuration.

OPTIONAL

26 / 300

3EC 16982 AAAA TCZZA Ed. 04

atmf save

Save current ATMF25 interface configuration.

SYNTAX:

atmf save

EXAMPLE:

>atmf list VPI = 0 VCI = 0 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 =>atmf delete vpi 0 vci 0 =>atmf add vpi 0 vci 35 =>atmf list VPI = 0 VCI = 35 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0

=>atmf save

=>atmf flush =>atmf list =>atmf load =>atmf list VPI = 0 VCI = 35 VPI = 1 VCI = 0 VPI = 2 VCI = 0 VPI = 3 VCI = 0 =>

2 ATMF Commands

RELATED COMMANDS:

atmf flush Flush complete ATMF25 interface configuration. atmf load Load saved or default ATMF25 interface configuration.

3EC 16982 AAAA TCZZA Ed. 04

27 / 300

2 ATMF Commands

28 / 300

3EC 16982 AAAA TCZZA Ed. 04

3 Bridge Commands

bridge (to access the Bridge level) bridge config bridge flush bridge ifadd bridge ifattach bridge ifconfig bridge ifdelete bridge ifdetach bridge iflist

3 Bridge Commands

bridge load bridge macadd bridge macdelete bridge maclist bridge save

3EC 16982 AAAA TCZZA Ed. 04

29 / 300

3 Bridge Commands

bridge config

Show/set bridge aging policy.

SYNTAX:

bridge config [age = <number {10  100000}>]

[age] A number between 10 and 100000.

Represents the lifetime in seconds of a dynamically learned MAC address. By default the aging timer is 300 seconds.

EXAMPLE:

=>bridge config

Aging : 300

=>bridge config age 600

=>bridge config Aging : 600 =>

OPTIONAL

30 / 300

3EC 16982 AAAA TCZZA Ed. 04

3 Bridge Commands

bridge flush

Flush complete bridging configuration. The flush command does not impact previously saved configurations.

SYNTAX:

bridge flush

EXAMPLE:

=>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 75783 frames: 572 TX bytes: 82768372 frames: 341221 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 156344216 frames: 5899238 TX bytes: 75689 frames: 425 dropframes: 5558017 =>bridge ifadd intf NewBridge dest Br1 =>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 75783 frames: 572 TX bytes: 82843610 frames: 341554 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 156472129 frames: 5903256 TX bytes: 75689 frames: 425 dropframes: 5561702 NewBridge : dest : Br1 Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State: not–connected Port : (Unassigned) PortState : forwarding

=>bridge flush

=>bridge load =>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 75783 frames: 572 TX bytes: 82908667 frames: 341735 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 156553257 frames: 5904070 TX bytes: 75689 frames: 425 dropframes: 5562335 =>

RELATED COMMANDS:

bridge load Load saved or default bridge configuration. bridge save Save current bridge configuration.

3EC 16982 AAAA TCZZA Ed. 04

31 / 300

3 Bridge Commands

bridge ifadd

Create a bridge interface.

SYNTAX:

bridge ifadd intf = <string>

dest = <phonebook entry>

intf The bridge interface name.

If not specified, the destination parameter must be specified. In this case the name of the destination will double as interface name.

dest The destination address for the new interface.

Typically a phonebook entry.

EXAMPLE:

=>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 75783 frames: 572 TX bytes: 83293945 frames: 343261 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 157212625 frames: 5920249 TX bytes: 75689 frames: 425 dropframes: 5576988 =>phonebook list Name Type Use Address Br1 bridge 0 8.35

=>bridge ifadd intf NewBridge dest Br1

=>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 76713 frames: 578 TX bytes: 84056140 frames: 346238 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 158501623 frames: 5952020 TX bytes: 76643 frames: 431 dropframes: 5605782 NewBridge : dest : Br1 Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State : not–connected Port : (Unassigned)PortState :forwarding =>

OPTIONAL

RELATED COMMANDS:

bridge ifattach Attach a bridge interface. bridge ifdetach Detach a bridge interface. bridge ifdelete Delete a bridge interface. bridge ifconfig Configure a bridge interface. bridge iflist Show current bridge configuration.

32 / 300

3EC 16982 AAAA TCZZA Ed. 04

3 Bridge Commands

bridge ifattach

Attach (i.e. connect) a bridge interface.

SYNTAX:

bridge ifattach intf = <ifname>

intf The name of the bridge interface to attach. REQUIRED

EXAMPLE:

=>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 76713 frames: 578 TX bytes: 84571673 frames: 348117 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 159362213 frames: 5969925 TX bytes: 76643 frames: 431 dropframes: 5621648 NewBridge : dest : Br1 Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State : not–connected

=>bridge ifattach intf NewBridge

=>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 76713 frames: 578 TX bytes: 84643057 frames: 348365 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 159468781 frames: 5973337 TX bytes: 76643 frames: 431 dropframes: 5624791 NewBridge : dest : Br1 Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State : connected RX bytes: 0 frames: 0 TX bytes: 30246 frames: 91 dropframes: 0 =>

Port : (Unassigned) PortState: forwarding

Port : wan0 PortState : forwarding

RELATED COMMANDS:

bridge ifadd Create a bridge interface. bridge ifdetach Detach a bridge interface. bridge ifdelete Delete a bridge interface. bridge ifconfig Configure a bridge interface. bridge iflist Show current bridge configuration.

3EC 16982 AAAA TCZZA Ed. 04

33 / 300

3 Bridge Commands

bridge ifconfig

Configure a bridge interface.

SYNTAX:

bridge ifconfig intf = <ifname>

[dest = <ifname>] [qos = <string>] [encaps = <{llc/snap|vcmux}>] [fcs = <{off|on}>] [portstate = <{disabled|learning|forwarding}>] [retry = <number {065535}>]

intf The name of the bridge interface to configure. REQUIRED

[dest] The destination for this interface. Typically a phonebook entry.

This parameter needs only to be specified in case of an interface created without specified destination.

[qos] The name of a configured Quality Of Service book entry. OPTIONAL

[encaps] The type of encapsulation to be used for this bridge interface. Choose

between:

 llc/snap  vcmux

[fcs] Whether or not to include the Ethernet FCS in the packet header on

the WAN side. Choose between:

 off  on

[portstate] The bridge portstate for this interface. Choose between:

 disabled  learning  forwarding

[retry] A number between 0 and 65535.

Represents the number of WAN connection setup retries before giving up. By default the retry value is 10.

OPTIONAL

34 / 300

3EC 16982 AAAA TCZZA Ed. 04

3 Bridge Commands

EXAMPLE:

=>bridge iflist intf NewBridge NewBridge : dest : Br1 Retry : 10 Connection State : connected Port : wan0 PortState : forwarding RX bytes: 0 frames: 0 TX bytes: 5103034 frames: 22139 dropframes: 0 =>qosbook list Name Ref Type TX peek sust burst RX peek sust burst (Kbits) (Kbits) (bytes) (Kbits) (Kbits) (bytes) default 3 ubr Linerate 0 0 Linerate 0 0 PPP3 0 ubr 6144 0 0 Linerate 0 0 voice 0 cbr 64 0 0 64 0 0

=>bridge ifconfig intf NewBridge qos PPP3 encaps vcmux retry 15

=>bridge iflist intf NewBridge NewBridge : dest : Br1 Retry : 15 Connection State : connected Port : wan0 PortState : forwarding RX bytes: 0 frames: 0 TX bytes: 6094426 frames: 26373 dropframes: 0 =>

QoS : default Encaps : llc/snap Fcs : off

QoS : PPP3 Encaps : vcmux Fcs : off

RELATED COMMANDS:

bridge ifadd bridge ifattach bridge ifdetach bridge ifdelete bridge iflist

Create a bridge interface. Attach a bridge interface. Detach a bridge interface. Delete a bridge interface. Show current bridge configuration.

3EC 16982 AAAA TCZZA Ed. 04

35 / 300

3 Bridge Commands

bridge ifdelete

Delete a bridge interface.

bridge ifdelete intf = <ifname>

intf The name of the interface name to delete. REQUIRED

EXAMPLE:

=>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 79742 frames: 595 TX bytes: 88218185 frames: 362634 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 165656174 frames: 6517744 TX bytes: 79740 frames: 448 dropframes: 6141689 NewBridge : dest : Br1 Retry : 15 QoS : PPP3 Encaps : vcmux Fcs : off Connection State : connected Port : wan0 PortState : forwarding RX bytes: 0 frames: 0 TX bytes: 6379953 frames: 27586 dropframes: 0

=>bridge ifdelete intf NewBridge

=>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 79742 frames: 595 TX bytes: 88296241 frames: 362952 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 165797004 frames: 6520010 TX bytes: 79740 frames: 448 dropframes: 6143571 =>

RELATED COMMANDS:

bridge ifadd Create a bridge interface. bridge ifattach Attach a bridge interface. bridge ifconfig Configure a bridge interface. bridge ifdetach Detach a bridge interface. bridge iflist Show current bridge configuration.

36 / 300

3EC 16982 AAAA TCZZA Ed. 04

3 Bridge Commands

bridge ifdetach

Detach (i.e. disconnect) a bridge interface.

SYNTAX:

bridge ifdetach intf = <ifname>

intf The name of the bridge interface to detach. REQUIRED

EXAMPLE:

=>bridge iflist intf NewBridge NewBridge : dest : Br1 Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State : connected RX bytes: 0 frames: 0 TX bytes: 16363 frames: 98 dropframes: 0

=>bridge ifdetach intf NewBridge

=>bridge iflist intf NewBridge NewBridge : dest : Br1 Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State : not–connected =>

Port : wan0 PortState : forwarding

Port : (Unassigned) PortState :forwarding

RELATED COMMANDS:

bridge ifadd Create a bridge interface. bridge ifattach Attach a bridge interface. bridge ifconfig Configure a bridge interface. bridge ifdelete Delete a bridge interface. bridge iflist Show current bridge configuration.

3EC 16982 AAAA TCZZA Ed. 04

37 / 300

3 Bridge Commands

bridge iflist

Show the current state of all or the selected bridge interfaces.

SYNTAX:

bridge iflist [intf = <ifname>]

[intf] The name of the bridge interface to show the configuration of.

If not specified all bridge interfaces are shown.

EXAMPLE OUTPUT:

=>bridge iflist

OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 0 frames: 0 TX bytes: 1964 frames: 31 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 23660 frames: 788 TX bytes: 0 frames: 0 dropframes: 757 =>bridge ifadd intf NewBridge dest Br1 =>bridge ifattach intf NewBridge

=>bridge iflist intf NewBridge

NewBridge : dest : Br1 Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State : connected Port : wan0 PortState : forwarding RX bytes: 0 frames: 0 TX bytes: 16363 frames: 98 dropframes: 0 =>

DESCRIPTION: `RX bytes` indicates the number of R

eceived bytes, `TX bytes` the number of Transmitted bytes. OBC

is short for On Board Controller and indicates the physical bridge port.

OPTIONAL

RELATED COMMANDS:

bridge ifadd Create a bridge interface. bridge ifattach Attach a created bridge interface. bridge ifconfig Configure a bridge interface. bridge ifdelete Delete a bridge interface. bridge ifdetach Detach a bridge interface.

38 / 300

3EC 16982 AAAA TCZZA Ed. 04

bridge load

Load saved (or default) bridge configuration. Execute bridge flush prior to bridge load.

SYNTAX:

bridge load [defaults <yes|no>]

3 Bridge Commands

[defaults] Load factory defaults (yes) or saved configuration (no).

Not specifying this parameter loads the saved configuration

EXAMPLE:

=>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 2706 frames: 16 TX bytes: 1798797 frames: 6807 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 3205514 frames: 151375 TX bytes: 2770 frames: 16 dropframes: 144380 =>bridge ifadd intf NewBridge dest Br1 =>bridge save =>bridge flush =>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 3029 frames: 17 TX bytes: 2171576 frames: 8299 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 3868737 frames: 170628 TX bytes: 3097 frames: 17 dropframes: 162141

=>bridge load defaults no

=>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 3029 frames: 17 TX bytes: 2261537 frames: 8663 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 4037236 frames: 184096 TX bytes: 3097 frames: 17 dropframes: 175245 NewBridge : dest : Br1 Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State : not–connected Port : (Unassigned) PortState : forwarding =>

OPTIONAL

RELATED COMMANDS:

bridge flush Flush complete bridge configuration. bridge save Save current bridge configuration.

3EC 16982 AAAA TCZZA Ed. 04

39 / 300

3 Bridge Commands

bridge macadd

Add a static MAC address to the filtering database. Allows to manually add static addresses, which should normally be dynamically discovered by the bridge itself.

SYNTAX:

bridge macadd intf = <ifname>

hwaddr = <hardwareaddress>

intf The name of the bridge interface to add the MAC address for. REQUIRED

hwaddr The MAC address of the new entry. REQUIRED

EXAMPLE:

=>bridge maclist 00:90:d0:01:02:03 –– static, OBC ff:ff:ff:ff:ff:ff –– static, OBC 01:80:c2:00:00:00 –– static, OBC 01:80:c2:00:00:01 –– static, OBC ... 01:80:c2:00:00:10 –– static, OBC 00:01:42:5f:7d:81 –– dynamic, eth0, 597 seconds 00:50:8b:31:cc:aa –– dynamic, eth0, 513 seconds 08:00:20:c1:9a:12 –– dynamic, eth0, 600 seconds

......

=>bridge macadd intf eth0 hwaddr 00:80:9f:01:23:45

=>bridge maclist 00:90:d0:01:02:03 –– static, OBC ff:ff:ff:ff:ff:ff –– static, OBC 01:80:c2:00:00:00 –– static, OBC 01:80:c2:00:00:01 –– static, OBC ... 01:80:c2:00:00:10 –– static, OBC 00:80:9f:01:23:45 –– permanent, OBC 00:01:42:5f:7d:81 –– dynamic, eth0, 598 seconds 00:50:8b:31:cc:aa –– dynamic, eth0, 379 seconds 08:00:20:c1:9a:12 –– dynamic, eth0, 600 seconds 00:08:c7:c3:5f:fc –– dynamic, eth0, 215 seconds

.........

RELATED COMMANDS:

bridge macdelete Delete a MAC address entry. bridge maclist Show current filtering database.

40 / 300

3EC 16982 AAAA TCZZA Ed. 04

3 Bridge Commands

bridge macdelete

Remove a MAC address from the filtering database.

SYNTAX:

bridge macdelete hwaddr = <hardwareaddress>

hwaddr The MAC address of the entry to delete. REQUIRED

EXAMPLE:

=>bridge maclist 00:90:d0:01:02:03 –– static, OBC ff:ff:ff:ff:ff:ff –– static, OBC 01:80:c2:00:00:00 –– static, OBC 01:80:c2:00:00:01 –– static, OBC ... 01:80:c2:00:00:10 –– static, OBC 00:80:9f:01:23:45 –– permanent, OBC 00:01:42:5f:7d:81 –– dynamic, eth0, 598 seconds 00:50:8b:31:cc:aa –– dynamic, eth0, 379 seconds 08:00:20:c1:9a:12 –– dynamic, eth0, 600 seconds

...............

=>bridge macdelete hwaddr 00:80:9f:01:23:45

=>bridge maclist 00:90:d0:01:02:03 –– static, OBC ff:ff:ff:ff:ff:ff –– static, OBC 01:80:c2:00:00:00 –– static, OBC 01:80:c2:00:00:01 –– static, OBC ... 01:80:c2:00:00:10 –– static, OBC 00:01:42:5f:7d:81 –– dynamic, eth0, 597 seconds 00:50:8b:31:cc:aa –– dynamic, eth0, 513 seconds 08:00:20:c1:9a:12 –– dynamic, eth0, 600 seconds

......

RELATED COMMANDS:

bridge macadd Add a static MAC address entry. bridge maclist Show current filtering database.

3EC 16982 AAAA TCZZA Ed. 04

41 / 300

3 Bridge Commands

bridge maclist

Show current MAC address filtering database.

SYNTAX:

bridge maclist

EXAMPLE:

=>bridge maclist

00:90:d0:01:02:03 –– static, OBC ff:ff:ff:ff:ff:ff –– static, OBC 01:80:c2:00:00:00 –– static, OBC 01:80:c2:00:00:01 –– static, OBC ... 01:80:c2:00:00:10 –– static, OBC 00:80:9f:24:ab:cf –– static, OBC 00:01:42:5f:7d:81 –– dynamic, eth0, 597 seconds 00:50:8b:31:cc:aa –– dynamic, eth0, 513 seconds 08:00:20:c1:9a:12 –– dynamic, eth0, 600 seconds 00:08:c7:c3:5f:fc –– dynamic, eth0, 349 seconds 08:00:20:a8:f4:34 –– dynamic, eth0, 600 seconds 08:00:20:83:b7:26 –– dynamic, eth0, 600 seconds 00:10:83:1b:13:18 –– dynamic, eth0, 599 seconds

......

RELATED COMMANDS:

bridge macadd Add a static MAC address entry. bridge macdelete Delete a MAC address entry.

42 / 300

3EC 16982 AAAA TCZZA Ed. 04

3 Bridge Commands

bridge save

Save current bridge configuration.

SYNTAX:

bridge save

EXAMPLE:

=>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 2706 frames: 16 TX bytes: 1798797 frames: 6807 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 3205514 frames: 151375 TX bytes: 2770 frames: 16 dropframes: 144380 =>bridge ifadd intf NewBridge dest Br1

=>bridge save

=>bridge flush =>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 3029 frames: 17 TX bytes: 2171576 frames: 8299 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 3868737 frames: 170628 TX bytes: 3097 frames: 17 dropframes: 162141 =>bridge load =>bridge iflist OBC : Internal Connection State : connected Port : OBC PortState : forwarding RX bytes: 3029 frames: 17 TX bytes: 2261537 frames: 8663 dropframes: 0 eth0 : Internal Connection State : connected Port : eth0 PortState : forwarding RX bytes: 4037236 frames: 184096 TX bytes: 3097 frames: 17 dropframes: 175245 NewBridge : dest : Br1 Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State : not–connected Port : (Unassigned) PortState : forwarding =>

RELATED COMMANDS:

bridge flush Flush complete bridge configuration. bridge load Load saved or default bridge configuration.

3EC 16982 AAAA TCZZA Ed. 04

43 / 300

3 Bridge Commands

44 / 300

3EC 16982 AAAA TCZZA Ed. 04

4 CIP Commands

cip (to access the CIP level) cip flush cip ifadd cip ifdelete cip iflist cip load cip pvcadd cip pvcdelete cip pvclist

4 CIP Commands

cip save

3EC 16982 AAAA TCZZA Ed. 04

45 / 300

4 CIP Commands

cip flush

Flush complete CIP configuration. The flush command does not impact previously saved configurations.

SYNTAX:

cip flush

EXAMPLE:

=>cip iflist cip0 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0

=>cip flush

=>cip iflist =>cip load =>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>

RELATED COMMANDS:

cip load Load saved or default CIP configuration. cip save Save current CIP configuration.

46 / 300

3EC 16982 AAAA TCZZA Ed. 04

4 CIP Commands

cip ifadd

Create a CIP interface at the local side of the Logical IP Subnet (LIS).

SYNTAX:

cip ifadd addr = <ipaddress>

[netmask = <ipmask (dotted or cidr)>] [uniaddr = <portspec:address[.selector]>]

addr The CIP interface's local IP address in the LIS. REQUIRED

netmask The LIS's subnetmask. OPTIONAL

uniaddr The UNIaddress/port specification for incoming connections, e.g.

`A0:*.04`: ADSL port, any address, selector 3. Only applicable in an SVC environment.

EXAMPLE:

=>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>

=>cip ifadd addr 172.16.1.1 netmask 255.255.255.0

=> =>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 cip0 addr = 172.16.1.1 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 => =>cip save =>

OPTIONAL

RELATED COMMANDS:

cip ifdelete Delete a CIP interface. cip ifadd Show current CIP configuration.

3EC 16982 AAAA TCZZA Ed. 04

47 / 300

4 CIP Commands

cip ifdelete

Delete a CIP interface at the local side of the Logical IP Subnet (LIS).

SYNTAX:

cip ifdelete addr = <ipaddress>

addr The CIP interface's local IP address in the LIS. REQUIRED

EXAMPLE:

=>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 cip0 addr = 172.16.1.1 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>

=>cip ifdelete addr 172.16.1.1

=> =>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>

RELATED COMMANDS:

cip ifadd Create a CIP interface. cip iflist Show current CIP configuration.

48 / 300

3EC 16982 AAAA TCZZA Ed. 04

cip iflist

Show current CIP configuration.

SYNTAX:

cip iflist

EXAMPLE OUTPUT:

=>cip iflist

cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 cip0 addr = 172.16.1.1 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>

DESCRIPTION: inarp_reqs_in/inarp_reqs_out : Incoming/outgoing inverse ARP requests inarp_repl_in/inarp_repl_out : Incoming/outgoing inverse ARP replies inarp_inv_in/inarp_inv_out : Incoming/outgoing invalid inverse ARP messages

4 CIP Commands

EXAMPLE INPUT/OUTPUT: EVOLUTION OF ARP REQUESTS IN A NETWORKED ENVIRONMENT:

=>cip iflist

cip0 addr = 200.200.200.138 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 18 inarp_reqs_out = 18

=>cip iflist

cip0 addr = 200.200.200.138 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 22 inarp_reqs_out = 22

=>cip iflist

cip0 addr = 200.200.200.138 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 22 inarp_reqs_out = 22 =>

inarp_repl_in = 75 inarp_inv_in = 0 inarp_repl_out = 75 inarp_inv_out = 0

inarp_repl_in = 76 inarp_inv_in = 0 inarp_repl_out = 76 inarp_inv_out = 0

RELATED COMMANDS:

cip ifadd Create a CIP interface. cip ifdelete Delete a CIP interface.

3EC 16982 AAAA TCZZA Ed. 04

49 / 300

4 CIP Commands

cip load

Load saved (or default) CIP configuration. Execute cip flush prior to cip load.

SYNTAX:

cip load [defaults <yes/no>]

[defaults] Load factory defaults (yes) or saved configuration (no).

Not specifying this parameter loads the saved configuration

EXAMPLE:

=>cip iflist cip0 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 cip1 addr = 172.16.1.1 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>cip flush

=>cip load defaults

=>cip iflist cip1 addr = 172.16.1.1 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>

RELATED COMMANDS:

cip flush Flush complete CIP configuration. cip save Save current CIP configuration.

OPTIONAL

50 / 300

3EC 16982 AAAA TCZZA Ed. 04

4 CIP Commands

cip pvcadd

Create a PVC ARP entry for destinations which are not RFC 1577/RFC2225 compliant.

SYNTAX:

cip pvcadd dest = <phonebookname>

[destaddr = <ipaddress>] [mtu = <number {273-20000}>]

dest The ATM address (hardware address) of the destination host.

REQUIRED

Typically a phonebook name.

[destaddr] The IP address of the destination host. OPTIONAL

[mtu] A number between 273 and 20000 (bytes).

OPTIONAL Represents the maximum AAL5 packet size for this connection. By default the mtu is 9180 bytes.

EXAMPLE:

=>phonebook list Name Type Use Address Br1 bridge 1 8.35 Br2 bridge 1 8.36 Br3 bridge 1 8.37 Br4 bridge 0 8.38 RELAY_PPP1 ppp 0 8.48 RELAY_PPP2 ppp 0 8.49 RELAY_PPP3 ppp 0 8.50 RELAY_PPP4 ppp 0 8.51 PPP1 ppp 1 8.64 PPP2 ppp 1 8.65 PPP3 ppp 1 8.66 DHCP_SPOOF ppp 1 8.67 CIPPVC1 cip 0 8.80 CIPPVC2 cip 0 8.81 CIPPVC3 cip 0 8.82 CIPPVC4 cip 0 8.83 =>cip pvclist

=>cip pvcadd dest CIPPVC1 destaddr 172.16.1.2 mtu 546

=>cip pvclist CIPPVC1 encaps = llc mtu = 546 =>

atmport = 0 vpi = 8 vci = 80 dest_ip = 172.16.1.2

RELATED COMMANDS:

cip pvcdelete Delete a PVC ARP entry. cip pvclist Show current PVC ARP entries.

3EC 16982 AAAA TCZZA Ed. 04

51 / 300

4 CIP Commands

cip pvcdelete

Delete a PVC ARP entry.

SYNTAX:

cip pvcdelete dest = <phonebookname>

dest Typically a phonebook entry name.

Represents the ATM address (hardware address) or name of the entry to delete.

EXAMPLE:

=>phonebook list Name Type Use Address Br1 bridge 1 8.35 PPP1 ppp 1 8.64 DHCP_SPOOF ppp 1 8.67 CIPPVC1 cip 0 8.80 CIPPVC2 cip 0 8.81 CIPPVC3 cip 0 8.82 =>cip pvclist CIPPVC1 encaps = llc mtu = 546

=>cip pvcdelete dest CIPPVC1

=>cip pvclist =>

atmport = 0 vpi = 8 vci = 80 dest_ip = 172.16.1.2

RELATED COMMANDS:

cip pvcadd Create a PVC ARP entry. cip pvclist Show current PVC ARP entries.

REQUIRED

52 / 300

3EC 16982 AAAA TCZZA Ed. 04

cip pvclist

Show current PVC ARP entries.

SYNTAX:

cip pvclist

EXAMPLE OUTPUT:

=>cip pvclist

CIPPVC1 atmport = 0 vpi = 8 vci = 80 dest_ip = 172.16.1.2 encaps = llc mtu = 546 =>

EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:

=>cip iflist cip0 addr = 200.200.200.138 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = 75 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 75 inarp_inv_out = 0

=>cip pvclist

699 atmport = 0 vpi = 6 vci = 99 dest_ip = 172.16.1.3 encaps = llc mtu = 9180

8.50 atmport = 0 vpi = 8 vci = 50 res_ip = 200.200.200.14 encaps = llc mtu = 9180 =>

4 CIP Commands

RELATED COMMANDS:

cip pvcdelete Delete a PVC ARP entry. cip pvcadd Create a PVC ARP entry.

3EC 16982 AAAA TCZZA Ed. 04

53 / 300

4 CIP Commands

cip save

Save current CIP configuration.

SYNTAX:

cip save

EXAMPLE:

=>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 cip0 addr = 172.16.1.1 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>cip ifdelete addr 172.16.1.1 =>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0

=>cip save

=>cip flush =>cip load =>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>

RELATED COMMANDS:

cip flush Flush complete CIP configuration. cip load Load saved or default CIP configuration.

54 / 300

3EC 16982 AAAA TCZZA Ed. 04

5 Config Commands

config (to access the Config level) config erase config flush config load config reset config save

5 Config Commands

3EC 16982 AAAA TCZZA Ed. 04

55 / 300

5 Config Commands

config erase

Physically remove all saved configurations.

SYNTAX:

config erase

EXAMPLE:

=>config erase

RELATED COMMANDS:

config flush Flush complete runtime configuration. config load Load complete saved or default configuration. config reset Flush current and optionally restore default configuration. config save Save complete runtime configuration.

56 / 300

3EC 16982 AAAA TCZZA Ed. 04

5 Config Commands

config flush

Flush complete current configuration without affecting saved configurations. This combines all flush commands: atmf flush, bridge flush, cip flush, config flush, dhcp flush,

dns flush, firewall flush, firewall rule flush, mer flush, nat flush, phonebook flush, ppp flush, pptp flush, qosbook flush, system flush and optionally ip flush.

SYNTAX:

config flush [keep_ip = <{no|yes}>]

[keep_ip] Keep current IP configuration (yes) or not (no).

Not keeping the IP settings could cause lost IP connectivity in the LAN.

EXAMPLE:

=>ip rtlist Destination Source Gateway Intf Mtrc

10.0.0.0/24 10.0.0.0/24 10.0.0.140 eth0 0

172.16.0.5/32 0.0.0.0/0 172.16.0.5 cip1 0

10.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 0

127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0

10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 0

172.16.0.0/24 0.0.0.0/0 172.16.0.5 cip1 1

=>config flush keep_ip yes

=>ip rtlist Destination Source Gateway Intf Mtrc

10.0.0.0/24 10.0.0.0/24 10.0.0.140 eth0 0

10.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 0

127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0

10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 0

=>config flush keep_ip no

=> =>ip rtlist Destination Source Gateway Intf Mtrc

127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0 =>config load load_ip yes =>ip rtlist Destination Source Gateway Intf Mtrc

10.0.0.0/24 10.0.0.0/24 10.0.0.140 eth0 0

10.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 0

172.16.0.5/32 0.0.0.0/0 172.16.0.5 cip1 0

127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0

10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 0

172.16.0.0/24 0.0.0.0/0 172.16.0.5 cip1 1 =>

OPTIONAL

RELATED COMMANDS:

config erase Physically remove all saved configurations. config load Load complete saved or default configuration. config reset Flush current and optionally restore default configuration. config save Save current runtime configuration.

3EC 16982 AAAA TCZZA Ed. 04

57 / 300

5 Config Commands

config load

Load complete saved or default configuration. Execute config flush prior to config load.

SYNTAX:

config load [load_ip = <{no|yes}>]

[config_set = {saved|default}]

[load_ip] Load IP settings (yes) or not (no).

Not keeping the IP settings could cause lost IP connectivity in the LAN.

[config_set] Load complete saved configuration (saved) or the default

configuration (default). Not specifying this parameter loads the saved configuration

EXAMPLE:

=>ip rtlist Destination Source Gateway Intf Mtrc

10.0.0.0/24 10.0.0.0/24 10.0.0.140 eth0 0

172.16.0.5/32 0.0.0.0/0 172.16.0.5 cip1 0

10.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 0

127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0

10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 0

172.16.0.0/24 0.0.0.0/0 172.16.0.5 cip1 1 =>config flush keep_ip no =>ip rtlist Destination Source Gateway Intf Mtrc

127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0

=>config load load_ip yes

=>ip rtlist Destination Source Gateway Intf Mtrc

10.0.0.0/24 10.0.0.0/24 10.0.0.140 eth0 0

10.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 0

172.16.0.5/32 0.0.0.0/0 172.16.0.5 cip1 0

127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0

10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 0

172.16.0.0/24 0.0.0.0/0 172.16.0.5 cip1 1 =>

OPTIONAL

RELATED COMMANDS:

config erase Physically remove all saved configurations. config flush Flush complete runtime configuration. config reset Flush current and optionally restore default configuration. config save Save current runtime configuration.

58 / 300

3EC 16982 AAAA TCZZA Ed. 04

5 Config Commands

config reset

Flush current runtime configuration and optionally restore factory default configuration. The reset command does not impact saved configurations.

SYNTAX:

config reset [keep_ip = <{no|yes}>]

[load_ip] Load IP settings (yes) or not (no).

Not keeping the IP settings could cause lost IP connectivity in the LAN.

EXAMPLE:

=>dns list Domain: lan Nr. Hostname IP Address 0 TestHost 10.0.0.140 1 Default 10.0.0.8 Total Table Size: 73 entries Amount used: 2 (2%)

=>config reset

=>dns list Domain: lan Nr. Hostname IP Address 0 SpeedTouch *.*.*.* Total Table Size: 73 entries Amount used: 1 (1%) =>config flush =>config load =>dns list Domain: lan Nr. Hostname IP Address 0 TestHost 10.0.0.140 1 Default 10.0.0.8 Total Table Size: 73 entries Amount used: 2 (2%) =>

OPTIONAL

RELATED COMMANDS:

config erase Physically remove all saved configurations. config flush Flush complete current configuration. config load Load complete saved or default configuration. config save Save current runtime configuration.

3EC 16982 AAAA TCZZA Ed. 04

59 / 300

5 Config Commands

config save

Save all existing configurations and modifications entered by the user. This combines all save commands: atmf save, bridge save, cip save, config save, dhcp save,

dns save, firewall chain save, firewall save, ip save, mer save, nat save, phonebook save, ppp save, pptp save, qosbook save, system save.

SYNTAX:

config save

EXAMPLE:

=>dns list Domain: lan Nr. Hostname IP Address 0 Default 10.0.0.8 Total Table Size: 73 entries Amount used: 1 (1%) =>dns list Domain: lan Nr. Hostname IP Address 0 Default 10.0.0.8 Total Table Size: 73 entries Amount used: 1 (1%) =>dns add hostname TestHost addr 172.16.1.1 =>dns list Domain: lan Nr. Hostname IP Address 0 Default 10.0.0.8 1 Testhost 172.16.1.1 Total Table Size: 73 entries Amount used: 2 (2%)

=>config save

=>dns flush =>dns load =>dns list Domain: lan Nr. Hostname IP Address 0 Default 10.0.0.8 1 Testhost 172.16.1.1 Total Table Size: 73 entries Amount used: 2 (2%) =>

RELATED COMMANDS:

config erase Physically remove all saved configurations. config flush Flush complete current configuration. config load Load complete saved or default configuration. config reset Flush current and optionally restore default configuration.

60 / 300

3EC 16982 AAAA TCZZA Ed. 04

6 DHCP Commands

dhcp (to access the DHCP level) dhcp client (to access the DHCP CLIENT level) dhcp client clear dhcp client config dhcp client flush dhcp client ifadd dhcp client ifattach dhcp client ifconfig dhcp client ifdelete

6 DHCP Commands

dhcp client iflist dhcp client ifrelease dhcp client ifrenew dhcp client load dhcp client save dhcp client stats dhcp server (to access the DHCP SERVER level) dhcp server add dhcp server client dhcp server clrstats dhcp server config dhcp server delete dhcp server flush dhcp server list dhcp server load dhcp server policy dhcp server save dhcp server spoof dhcp server start

3EC 16982 AAAA TCZZA Ed. 04

61 / 300

6 DHCP Commands

dhcp server stats dhcp server status dhcp server stop dhcp server troff dhcp server tron

62 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp client clear

Clear DHCP client statistics.

SYNTAX:

dhcp client clear

EXAMPLE:

=>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 0 ACKs recv : 0 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 253 REQUESTs sent : 9 DECLINEs sent : 0 RELEASEs sent : 0 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 %

=>dhcp client clear

=>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 0 ACKs recv : 0 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 0 REQUESTs sent : 0 DECLINEs sent : 0 RELEASEs sent : 0 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % =>

6 DHCP Commands

RELATED COMMANDS:

dhcp client stats Show DHCP client statistics.

3EC 16982 AAAA TCZZA Ed. 04

63 / 300

6 DHCP Commands

dhcp client config

Show/set DHCP client configuration.

SYNTAX:

dhcp client config [trace <{off|on}>]

[trace] Enable tracing (on) or not (off). OPTIONAL

EXAMPLE:

=>dhcp client config

tracing: off

=>dhcp client config trace on =>dhcp client config

tracing: on =>

RELATED COMMANDS:

dhcp client ifconfig Configure a DHCP lease created for a specific interface.

64 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp client flush

Flush complete DHCP client configuration and dynamic interfaces. The flush command does not impact previously saved configurations.

SYNTAX:

dhcp client flush

EXAMPLE:

=>dhcp client iflist NewMer : [SELECTING] flags = uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s trying to get a lease for 8 min, 32 sec transmission of DISCOVER in 57 sec retransmission timeout: 64 nbr of retransmissions: 14 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>dhcp client save Number of leases: 1 Total size of table: 19, in use: 1, free: 94 %

=>dhcp client flush

=>dhcp client iflist No dynamic interfaces defined. =>dhcp client load =>dhcp client iflist NewMer : [REBOOTING] flags = uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s trying to request known lease for 2 sec retransmission of REQUEST in 2 sec retransmission timeout : 4 retransmissions left before reinitializing : 2 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>

6 DHCP Commands

RELATED COMMANDS:

dhcp client load Load saved or default DHCP client configuration and dynamic

interfaces.

dhcp client save Save current DHCP client configuration and dynamic interfaces.

3EC 16982 AAAA TCZZA Ed. 04

65 / 300

6 DHCP Commands

dhcp client ifadd

Create a DHCP lease for a specific interface.

SYNTAX:

dhcp client ifadd intf = <interface name>

intf The name of an existing interface, e.g. created via mer ifadd. REQUIRED

EXAMPLE:

=>dhcp client iflist No dynamic interfaces defined. =>mer iflist =>mer ifadd intf NewMer

=>dhcp client ifadd intf NewMer

=>dhcp client iflist NewMer : [INIT] flags = uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>

RELATED COMMANDS:

dhcp client ifattach Attach a DHCP lease to an interface. dhcp client ifconfig Configure a DHCP lease created for a specific interface. dhcp client ifdelete Delete a dynamic interface. dhcp client iflist Show all dynamic interfaces.

66 / 300

3EC 16982 AAAA TCZZA Ed. 04

6 DHCP Commands

dhcp client ifattach

Attach a DHCP lease to a dynamic interface. Firstly create the interface with the dhcp client ifadd command.

SYNTAX:

dhcp client ifattach intf = <interface name>

intf The name of the dynamic interface. REQUIRED

EXAMPLE:

=>dhcp client iflist NewMer : [INIT] flags = uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 %

=>dhcp client ifattach intf NewMer

=>dhcp client iflist NewMer : [SELECTING] flags = uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 trying to get a lease for 8 sec transmission of DISCOVER in 4 sec retransmission timeout: 8 nbr of retransmissions: 3 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>

RELATED COMMANDS:

dhcp client ifadd Create a DHCP lease for a specific interface. dhcp client ifconfig Configure a DHCP lease created for a specific interface. dhcp client ifrelease Release a lease attached to a dynamic interface.

3EC 16982 AAAA TCZZA Ed. 04

67 / 300

6 DHCP Commands

dhcp client ifconfig

Show/set the configuration of DHCP lease created for a specific interface. Execute the dhcp client ifrelease command prior to configuring it.

SYNTAX:

dhcp client ifconfig intf = <interface name>

[clientid = <client-id>] [hostname = <hostname>] [addr = <ip-address>] [leasetime = <number>] [addrtrans = <{none|pat}>] [dns = <{off|on}>] [gateway = <{off|on}>]

intf The name of the dynamic interface to be configured. REQUIRED

[clientid] The client identity to be associated with the lease. OPTIONAL

[hostname] The host name of the client to be associated with the lease. OPTIONAL

[addr] The preferred dynamic IP address. OPTIONAL

[leasetime] The time in seconds the client wants to use an address. OPTIONAL

[addrtrans] Automatically enable address translation for this dynamic interface

OPTIONAL

(pat) or not (none).

[dns] Request (and accept) DNS server IP addresses (on) or not (off). OPTIONAL

[gateway] Request (and accept) gateway IP addresses (on) or not (off). OPTIONAL

EXAMPLE:

=>dhcp client iflist NewMer : [INIT] flags = uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 %

=>dhcp client ifconfig intf=NewMer hostname=NewLease addr=10.0.0.10 leasetime=10800

=>dhcp client iflist NewMer : [INIT] flags = uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>

68 / 300

3EC 16982 AAAA TCZZA Ed. 04

6 DHCP Commands

dhcp client ifdelete

Delete a dynamic interface.

SYNTAX:

dhcp client ifdelete intf = <interface name>

intf The name of the dynamic interface. REQUIRED

EXAMPLE:

=>dhcp client iflist NewMer : [SELECTING] flags = uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 trying to get a lease for 2 h, 16 min, 54 sec transmission of DISCOVER in 53 sec retransmission timeout: 64 nbr of retransmissions: 134 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 %

=>dhcp client ifdelete intf NewMer

=>dhcp client iflist No dynamic interfaces defined. =>

RELATED COMMANDS:

dhcp client ifadd Create a DHCP lease for a specific interface. dhcp client ifattach Attach a DHCP lease to an interface. dhcp client ifconfig Configure a DHCP lease created for a specific interface. dhcp client iflist Show all dynamic interfaces.

3EC 16982 AAAA TCZZA Ed. 04

69 / 300

6 DHCP Commands

dhcp client iflist

Show all dynamic interfaces.

SYNTAX:

dhcp client iflist

EXAMPLE:

=>dhcp client iflist

No dynamic interfaces defined. =>dhcp client ifadd intf NewMer

=>dhcp client iflist

NewMer : [INIT] flags = uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>

EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT (SpeedTouch as DHCP client):

=>dhcp client iflist

eth0 : [BOUND] flags = uc IP address : 10.0.0.3 HW address : 00:90:d0:01:47:f1 DHCP server: 10.10.1.1 lease renewal in 5 days, 1 h, 26 min, 45 sec lease rebinding in 8 days, 20 h, 34 min, 15 sec lease expires in 10 days, 2 h, 56 min, 45 sec Number of leases: 1 Total size of table: 18, in use: 1, free: 94 %

=>dhcp client iflist

eth0 : [BOUND] flags = uc IP address : 10.0.0.3 HW address : 00:90:d0:01:47:f1 DHCP server: 10.10.1.1 lease renewal in 5 days, 1 h, 25 min, 27 sec lease rebinding in 8 days, 20 h, 32 min, 57 sec lease expires in 10 days, 2 h, 55 min, 27 sec Number of leases: 1 Total size of table: 18, in use: 1, free: 94 % =>

RELATED COMMANDS:

dhcp client ifadd Create a DHCP lease for a specific interface. dhcp client ifdelete Delete a dynamic interface.

70 / 300

3EC 16982 AAAA TCZZA Ed. 04

6 DHCP Commands

dhcp client ifrelease

Release a lease attached to a dynamic interface.

SYNTAX:

dhcp client ifrelease intf = <interface name>

intf The name of the dynamic interface. REQUIRED

EXAMPLE:

=>dhcp client iflist NewMer : [SELECTING] flags = uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s trying to get a lease for 6 min, 7 sec transmission of DISCOVER in 13 sec retransmission timeout: 64 nbr of retransmissions: 10 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 %

=>dhcp client ifrelease intf NewMer

=>dhcp client iflist NewMer : [INIT] flags = uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>

3EC 16982 AAAA TCZZA Ed. 04

71 / 300

6 DHCP Commands

EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT (SpeedTouch as DHCP client):

=>dhcp client iflist eth0 : [BOUND] flags = uc IP address : 10.0.0.3 HW address : 00:90:d0:01:47:f1 DHCP server: 10.10.1.1 lease renewal in 5 days, 58 min, 48 sec lease rebinding in 8 days, 20 h, 6 min, 18 sec lease expires in 10 days, 2 h, 28 min, 48 sec Number of leases: 1 Total size of table: 18, in use: 1, free: 94 % =>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 DECLINEs sent : 0 RELEASEs sent : 0 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 18, in use: 1, free: 94 %

=>dhcp client ifrelease intf eth0

=>(CTRL + Q) =>STATE ACTIVATE ! STATE IDLE ! STATE ACTIVATE ! dhcc: intf 1 releases 10.0.0.3 to server 10.10.1.1. dhcc: 10.0.0.3 deleted: ok. STATE IDLE ! STATE ACTIVATE !

.............

: intf 1 in init state.

dhcc n_send() broadcast triggered; To be verified

: broadcast discover on intf 1.

dhcc =>(CTRL + S) =>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 DECLINEs sent : 0 RELEASEs sent : 1 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 18, in use: 1, free: 94 % =>

RELATED COMMANDS:

dhcp client ifattach Attach a DHCP lease to an interface. dhcp client ifconfig Configure a DHCP lease created for a specific interface. dhcp client ifdelete Delete a dynamic interface.

72 / 300

3EC 16982 AAAA TCZZA Ed. 04

6 DHCP Commands

dhcp client ifrenew

Renew the lease of a dynamic interface.

SYNTAX:

dhcp client ifrenew intf = <interface name>

intf The name of the dynamic interface. REQUIRED

EXAMPLE:

=>dhcp client iflist NewMer : [SELECTING] flags = uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s trying to get a lease for 8 min, 13 sec transmission of DISCOVER in 49 sec retransmission timeout: 64 nbr of retransmissions: 13 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 %

=>dhcp client ifrenew intf = NewMer

=>dhcp client iflist NewMer : [SELECTING] flags = uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s trying to get a lease for 8 min, 32 sec transmission of DISCOVER in 57 sec retransmission timeout: 64 nbr of retransmissions: 14 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>

3EC 16982 AAAA TCZZA Ed. 04

73 / 300

6 DHCP Commands

EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT (SpeedTouch as DHCP client):

=>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 0 ACKs recv : 0 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 0 REQUESTs sent : 0 DECLINEs sent : 0 RELEASEs sent : 1 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 18, in use: 1, free: 94 %

=>dhcp client ifrenew intf eth0

=>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 1 ACKs recv : 1 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 1 REQUESTs sent : 1 DECLINEs sent : 0 RELEASEs sent : 1 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 18, in use: 1, free: 94 % =>(CTRL + Q)

..................

STATE IDLE ! STATE ACTIVATE ! dhcc: intf 1 renews lease 10.0.0.3 dhcc: intf 1 requests 10.0.0.3 from 10.10.1.1 dhcc: 10.10.1.1 acks 10.0.0.3 to intf 1. dhcc: lease 10.0.0.3 bound to intf 1. STATE IDLE ! STATE ACTIVATE !

...........

=>(CTRL + S)

.

RELATED COMMANDS:

dhcp client ifadd Create a DHCP lease for a specific interface. dhcp client ifattach Attach a DHCP lease to an interface.

74 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp client load

Load saved (or default) DHCP client configuration and dynamic interfaces. Execute dhcp client flush prior to dhcp client load.

SYNTAX:

dhcp client load

EXAMPLE:

=>dhcp client iflist NewMer : [SELECTING] flags = uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s trying to get a lease for 8 min, 32 sec transmission of DISCOVER in 57 sec retransmission timeout: 64 nbr of retransmissions: 14 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>dhcp client save Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>dhcp client flush =>dhcp client iflist No dynamic interfaces defined.

=>dhcp client load

=>dhcp client iflist NewMer : [REBOOTING] flags = uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s trying to request known lease for 2 sec retransmission of REQUEST in 2 sec retransmission timeout : 4 retransmissions left before reinitializing : 2 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>

6 DHCP Commands

RELATED COMMANDS:

dhcp client flush Delete all dynamic interfaces. dhcp client save Save current DHCP client configuration and dynamic interfaces.

3EC 16982 AAAA TCZZA Ed. 04

75 / 300

6 DHCP Commands

dhcp client save

Save current DHCP client configuration and dynamic interfaces.

SYNTAX:

dhcp client save

EXAMPLE:

=>dhcp client iflist NewMer : [SELECTING] flags = uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s trying to get a lease for 8 min, 32 sec transmission of DISCOVER in 57 sec retransmission timeout: 64 nbr of retransmissions: 14 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 %

=>dhcp client save

Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>dhcp client flush =>dhcp client iflist No dynamic interfaces defined. =>dhcp client load =>dhcp client iflist NewMer : [REBOOTING] flags = uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server: 255.255.255.255 hostname : NewLease req.leasetime = 10800 s trying to request known lease for 2 sec retransmission of REQUEST in 2 sec retransmission timeout : 4 retransmissions left before reinitializing : 2 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>

RELATED COMMANDS:

dhcp client flush Flush complete DHCP client configuration and dynamic interfaces. dhcp client load Load saved or default DHCP client configuration and dynamic

interfaces.

76 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp client stats

Show DHCP client statistics.

SYNTAX:

dhcp client stats

EXAMPLE:

=>dhcp client stats

DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 0 ACKs recv : 0 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 244 REQUESTs sent : 9 DECLINEs sent : 0 RELEASEs sent : 0 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % =>

6 DHCP Commands

EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT (SpeedTouch as DHCP client):

=>dhcp client stats

DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 1 ACKs recv : 1 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 4 REQUESTs sent : 1 DECLINEs sent : 0 RELEASEs sent : 0 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 18, in use: 1, free: 94 %=>

RELATED COMMANDS:

dhcp client clear Clear DHCP client statistics.

3EC 16982 AAAA TCZZA Ed. 04

77 / 300

6 DHCP Commands

dhcp server add

Assign a static IP address to a host in the local network. This address is allocated on a permanent basis, and is excluded from the pool of addresses used by the SpeedTouch DHCP server.

SYNTAX:

dhcp server add clientid <clientid>

addr <ipaddress> [leasetime <number>] [hostname <hostname>]

clientid The DHCP client's MAC address. REQUIRED

addr The IP address for this DHCP host. REQUIRED

[leasetime] A number between 0 and (seconds).

OPTIONAL Represents the time he host is allowed to use this address, before renewing. Not specifying this parameter makes the lease permanent. By default the lease time is 7200 seconds.

[hostname] The hostname to add to the local DNS table for this host. OPTIONAL

EXAMPLE:

=>dhcp server list Leases: Lease 0: 01:00:A0:24:AE:66:E1 Hostname = Default ip address: 10.0.0.8 expires in: 1 h, 16 min, 20 sec lease is being used. Total size of table: 36, in use: 1 free: 97 %

=>dhcp server add clientid 01:23:55:67:89:ab addr 10.0.0.1 leasetime 7200 hostname NewLease

=>dhcp server list Leases: Lease 0: 01:00:A0:24:AE:66:E1 Hostname = Default ip address: 10.0.0.8 expires in: 1 h, 15 min, 19 sec lease is being used. Lease 1: 01:23:55:67:89:AB Hostname = NewLease ip address: 10.0.0.1 expires in: 1 h, 59 min, 52 sec lease is not being used. Total size of table: 36, in use: 2 free: 94 % =>

RELATED COMMANDS:

dhcp server delete Delete a DHCP lease. dhcp server list Show current DHCP leases.

78 / 300

3EC 16982 AAAA TCZZA Ed. 04

6 DHCP Commands

dhcp server client

Set the AutoDHCP client timeout in startup phase. Only applicable in AutoDHCP mode (See dhcp server policy command).

SYNTAX:

dhcp server client timeout <number>

timeout A number between -1 and 1814400 (seconds).

Represents the time to look for another DHCP server. Entering `1` means infinite: the SpeedTouch will remain client. By default the timeout is 20 seconds.

EXAMPLE:

=>dhcp server status DHCP Server Status: Running Current configuration: Address Range: 10.0.0.1 ... 10.255.255.254

.......

Policies: Verify first: no Spoofing parameters: Failure timeout (!DoD): 4 sec Start–up client parameters: Timeout: 20 sec Tracing: off Memory usage: Leases: total: 36, in use: 7 free: 80 %

=>dhcp server client timeout 15

=>dhcp server status DHCP Server Status: Running Current configuration: Address Range: 10.0.0.1 ... 10.255.255.254

.......

Policies: Verify first: no Spoofing parameters: Failure timeout (!DoD): 4 sec Start–up client parameters: Timeout: 15 sec Tracing: off Memory usage: Leases: total: 36, in use: 7 free: 80 % =>

REQUIRED

RELATED COMMANDS:

dhcp server policy Set DHCP server policy. dhcp server start Start DHCP server. dhcp server status Show current DHCP server configuration. dhcp server stop Stop DHCP server.

3EC 16982 AAAA TCZZA Ed. 04

79 / 300

6 DHCP Commands

dhcp server clrstats

Clear SpeedTouch DHCP server statistics.

SYNTAX:

dhcp server clrstats

EXAMPLE:

=>dhcp server stats DHCP server statistics: Corrupted packet recv : 0 DISCOVER : 9575 REQUEST : 121 DECLINE : 0 RELEASE : 0 INFORM : 13 Pure BOOTP REQUESTS : 2 Other message types : 0 OFFERs sent : 9552 ACKs sent : 121 NAKs sent : 0 Lease table got full : no Ping table got full : no Second dhcp server seen : no

=>dhcp server clrstats

=>dhcp server stats DHCP server statistics: Corrupted packet recv : 0 DISCOVER : 0 REQUEST : 0 DECLINE : 0 RELEASE : 0 INFORM : 0 Pure BOOTP REQUESTS : 0 Other message types : 0 OFFERs sent : 0 ACKs sent : 0 NAKs sent : 0 Lease table got full : no Ping table got full : no Second dhcp server seen : no =>

RELATED COMMANDS:

dhcp server stats Show DHCP server statistics.

80 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp server config

Set SpeedTouch DHCP server configuration. Execute dhcp server status to see the actual status and configuration.

SYNTAX:

dhcp server config [beginrange = <ipaddress>]

[endrange = <ipaddress>] [netmask = <ipaddress>] [leasetime = <number>] [gateway = <ipaddress | 0>] [dnsaddr = <ipaddress>]

6 DHCP Commands

beginrange The lowest IP address in the DHCP address range to use for leasing.

Default value of this parameter is 10.0.0.1.

endrange The highest IP address in the DHCP address range to use for leasing.

Default value of this parameter is 10.255.255.254.

netmask The applicable netmask for the DHCP leases. OPTIONAL

leasetime A number between 0 and 1814400 (seconds).

Represents the time for which a client can use its dynamically allocated IP address. By default the leasetime is 2 hours (7200 seconds).

gateway The IP address of the gateway for DHCP clients. OPTIONAL

dnsaddr The IP address of the DNS server for DHCP clients.

Entering '0' sets the SpeedTouch  as DNS server.

OPTIONAL

3EC 16982 AAAA TCZZA Ed. 04

81 / 300

6 DHCP Commands

EXAMPLE:

=>dhcp server status DHCP Server Status: Running Current configuration: Address Range: 10.0.0.1 ... 10.255.255.254 Netmask: 255.0.0.0 Lease time: 10800 seconds Gateway (default router): 10.0.0.138 DNS server: 10.0.0.1 Domain name: lan Policies: Verify first: no Trust client: yes Spoofing: no Start as client: yes Spoofing parameters: Failure timeout (!DoD): 4 sec Failure lease time (!DoD): 60 sec Temp. lease time (DoD): 10 sec Start–up client parameters: Timeout: 15 sec Tracing: off Memory usage: Leases: total: 36, in use: 7 free: 80 %

=>dhcp server config beginrange=172.16.0.0 endrange=172.16.0.122 netmask=255.0.0.0 leasetime=21600 gateway=172.16.1.1 dnsaddr=172.16.1.1

=>dhcp server status DHCP Server Status: Running Current configuration: Address Range: 172.16.0.0 ... 172.16.0.122 Netmask: 255.0.0.0 Lease time: 21600 seconds Gateway (default router): 172.16.1.1 DNS server: 172.16.1.1 Domain name: lan Policies: Verify first: no Trust client: yes Spoofing: no Start as client: yes Spoofing parameters: Failure timeout (!DoD): 4 sec Failure lease time (!DoD): 60 sec Temp. lease time (DoD): 10 sec Start–up client parameters: Timeout: 15 sec Tracing: off Memory usage: Leases: total: 36, in use: 6 free: 83 % =>

RELATED COMMANDS:

dhcp server status Show current DHCP server configuration.

82 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp server delete

Delete a DHCP lease.

SYNTAX:

dhcp server delete index <number>

6 DHCP Commands

index The index number of the entry to be deleted.

Execute dhcp server status to see a list of the index numbers of all current DHCP leases.

EXAMPLE:

=>dhcp server list Leases: Lease 1: 01:23:55:67:89:AB Hostname = NewLease ip address: 10.0.0.1 expires in: 1 h, 21 min, 9 sec lease is not being used. Lease 0: 01:00:A0:24:AE:66:E1 Hostname = Default ip address: 10.0.0.8 expires in: 1 h, 31 min, 36 sec lease is being used. Total size of table: 36, in use: 2 free: 94 %

=>dhcp server delete index 1

=>dhcp server list Leases: Lease 0: 01:00:A0:24:AE:66:E1 Hostname = Default ip address: 10.0.0.8 expires in: 1 h, 31 min, 18 sec lease is being used. Total size of table: 36, in use: 1 free: 97 % =>

REQUIRED

RELATED COMMANDS:

dhcp server add Add a DHCP lease manually. dhcp server list Show current DHCP leases.

3EC 16982 AAAA TCZZA Ed. 04

83 / 300

6 DHCP Commands

dhcp server flush

Flush complete DHCP server configuration and dynamic leases. The flush command does not impact previously saved configurations.

SYNTAX:

dhcp server flush

EXAMPLE:

=>dhcp server list Leases: Lease 2: 01:52:41:53:20:A0:1B:A7:EB:AD:3C:C0:01:01:00:00:00 ip address: 10.0.7.79 expires in: 11 sec lease is not being used. Lease 1: 01:52:41:53:20:20:4D:0D:CB:03:40:C0:01:01:00:00:00 ip address: 10.0.7.62 Spoofed lease from 2: DHCP_SPOOF Assigned (temporary) private ip address. expires in: 1 min, 39 sec lease is not being used. Lease 0: 01:00:A0:24:AE:66:E1 Hostname = Default ip address: 10.0.0.8 expires in: 1 h, 57 min, 9 sec lease is being used. Lease 3: 01:23:55:67:89:AB Hostname = Tempo ip address: 10.0.0.1 never expires! lease is not being used. Total size of table: 36, in use: 7 free: 80 %

=>dhcp server flush

=>dhcp server list No active leases Total size of table: 36, in use: 0 free: 100 % =>

RELATED COMMANDS:

dhcp server load Load saved or default DHCP server configuration and permanent

leases.

dhcp server save Save current DHCP server configuration and permanent leases.

84 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp server list

List current DHCP leases, indicated by their index number.

SYNTAX:

dhcp server list

EXAMPLE OUTPUT:

=>dhcp server list

Leases: Lease 2: 01:52:41:53:20:50:6D:C0:40:02:32:C0:01:01:00:00:00 ip address: 10.0.7.142 expires in: 3 sec lease is not being used. Lease 3: 01:52:41:53:20:A0:1B:A7:EB:AD:3C:C0:01:01:00:00:00 ip address: 10.0.7.143 expires in: 17 sec lease is not being used. Lease 5: 01:52:41:53:20:F0:90:8F:09:E1:35:BE:01:01:00:00:00 ip address: 10.0.7.144 expires in: 55 sec lease is not being used. Lease 6: 01:52:41:53:20:30:F4:89:5F:9B:44:C0:01:01:00:00:00 ip address: 10.0.7.145 expires in: 1 min, 6 sec lease is not being used. Lease 1: 01:52:41:53:20:20:4D:0D:CB:03:40:C0:01:01:00:00:00 ip address: 10.0.7.62 Spoofed lease from 2: DHCP_SPOOF Assigned (temporary) private ip address. expires in: 1 min, 57 sec lease is not being used. Lease 0: 01:00:A0:24:AE:66:E1 Hostname = Default ip address: 10.0.0.8 expires in: 1 h, 17 min, 21 sec lease is being used. Total size of table: 36, in use: 7 free: 80 % =>

6 DHCP Commands

RELATED COMMANDS:

dhcp server add Add a DHCP lease manually. dhcp server delete Delete a DHCP lease. dhcp server flush Delete complete DHCP server configuration and dynamic leases.

3EC 16982 AAAA TCZZA Ed. 04

85 / 300

6 DHCP Commands

dhcp server load

Load saved (or default) DHCP server configuration and permanent leases.

SYNTAX:

dhcp server load [defaults <yes|no>]

[defaults] Load factory defaults (yes) or saved configuration (no).

Not specifying this parameter loads the saved configuration.

EXAMPLE:

=>dhcp server status DHCP Server Status: Stopped

.....

=>dhcp server load defaults yes =>dhcp server status DHCP Server Status: Running Current configuration: Address Range: 10.0.0.1 ... 10.255.255.254 Netmask: 255.0.0.0 Lease time: 7200 seconds Gateway (default router): 11.11.144.144 DNS server: 10.0.0.1 Domain name: lan Policies Verify first: no Trust client: yes Spoofing: no Start as client: yes Spoofing parameters: Failure timeout (!DoD): 4 sec Failure lease time (!DoD): 60 sec Temp. lease time (DoD): 10 sec Start–up client parameters: Timeout: 20 sec Tracing: off Memory usage: Leases: total: 36, in use: 7 free: 80 % =>

:

OPTIONAL

RELATED COMMANDS:

dhcp server flush Flush current DHCP server configuration and dynamic leases. dhcp server load Load saved or default DHCP server configuration and permanent

leases.

86 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp server policy

Set SpeedTouch DHCP server policy.

SYNTAX:

dhcp server policy [verifyfirst <yes|no>]

[trustclient <yes|no>] [spoofing <yes|no>] [client <yes|no>]

6 DHCP Commands

[verifyfirst] Probe the network for conflicting IP addresses before giving a

suggested IP address to the requesting DHCP client (yes) or not (no).

[trustclient] Take the IP address suggested by a DHCP client into account (yes) or

not (no).

[spoofing] Allow a remote DHCP server to hand out IP addresses negotiated by

PPP on WAN side (yes) or not (no). DHCP spoofing is used to relay local DHCP requests to an external PPP connection having a specific IP address negotiation mechanism. DHCP replies are in turn generated by the DHCP server based on the IP address information received by the PPP link.

[client] Allow the Speed Touch DHCP server to present itself as DHCP

client (AutoDHCP mode) at boot time and probe for another DHCP server on the network for some time before starting the DHCP server (yes) or immediately start the DHCP server (no).

EXAMPLE:

=>dhcp server status DHCP Server Status: Running

.....

Policies Verify first: no Trust client: yes Spoofing: no Start as client: yes

.....

=>dhcp server policy verifyfirst yes trustclient no spoofing yes client no

=>dhcp server status DHCP Server Status: Running Policies Verify first: yes Trust client: no Spoofing: yes Start as client: no

.....

=>

:

OPTIONAL

RELATED COMMANDS:

dhcp server status Show current DHCP server configuration.

3EC 16982 AAAA TCZZA Ed. 04

87 / 300

6 DHCP Commands

dhcp server save

Save complete Speed Touch DHCP server configuration and permanent DHCP leases.

SYNTAX:

dhcp server save

EXAMPLE:

=>dhcp server list Leases: Lease 0: 01:00:A0:24:AE:66:E1 Hostname = Default ip address: 10.0.0.8 expires in: 1 h, 57 min, 9 sec lease is being used. Lease 1: 01:23:55:67:89:AB Hostname = Tempo ip address: 10.0.0.1 never expires! lease is not being used. Total size of table: 36, in use: 2 free: 94 % =>dhcp server save =>dhcp server flush =>dhcp server list No active leases Total size of table: 36, in use: 0 free: 100 % =>dhcp server load defaults no =>dhcp server list Leases: Lease 0: 01:00:A0:24:AE:66:E1 Hostname = Default ip address: 10.0.0.8 expires in: 1 h, 57 min, 9 sec lease is being used. Lease 1: 01:23:55:67:89:AB Hostname = Tempo ip address: 10.0.0.1 never expires! lease is not being used. Total size of table: 36, in use: 2 free: 94 % =>

RELATED COMMANDS:

dhcp server flush Flush complete DHCP server configuration and dynamic leases dhcp server load Load saved or default DHCP server configuration and permanent

leases.

88 / 300

3EC 16982 AAAA TCZZA Ed. 04

6 DHCP Commands

dhcp server spoof

Set DHCP spoofing parameters. Only applicable in case of a PPPtoDHCP Spoofing connection. (See dhcp server policy command).

SYNTAX:

dhcp server spoof [failtime <number>]

[errorlt <number>] [dodlt <number>]

[failtime] A number between 0 and (seconds).

Represents the time to wait for a PPP link to successfully negotiate an IP address. This parameter determines how long the Speed Touch should try to set up a PPP connection before returning to normal DHCP mode, i.e. in case the PPP connection cannot be established within the time lapse determined by failtime, the Speed Touch DHCP server will allocate an local private IP address to the DHCP client. By default the failtime is 4 seconds.

[errorlt] A number between 0 and (seconds).

Represents the leasetime of the private address issued when a PPP link fails. In case the PPP link fails after failtime has elapsed, this parameter determines how long the private DHCP lease must be maintained before retrying to set up the PPP link again. By default the error lease time is 60 seconds.

[dodlt] A number between 0 and (seconds).

Represents the leasetime of the temporary private IP address in case of a dialondemand PPP link. In case of a dialondemand PPP link, this parameter determines the interval at which the the temporary DHCP lease must be maintained before checking whether a public IP address negotiated by a triggered PPP link is available. By default the dialondemand lease time is 10 seconds.

OPTIONAL

3EC 16982 AAAA TCZZA Ed. 04

89 / 300

6 DHCP Commands

EXAMPLE:

=>dhcp server status DHCP Server Status: Running

.....

Spoofing parameters Failure timeout (!DoD): 4 sec Failure lease time (!DoD): 60 sec Temp. lease time (DoD): 10 sec Start–up client parameters: Timeout: 20 sec Tracing: off Memory usage: Leases: total: 36, in use: 6 free: 83 %

=>dhcp server spoof failtime 8 errorlt 120 dodlt 20

=>dhcp server status DHCP Server Status: Running

.....

Spoofing parameters Failure timeout (!DoD): 8 sec Failure lease time (!DoD): 120 sec Temp. lease time (DoD): 20 sec Start–up client parameters: Timeout: 20 sec Tracing: off Memory usage: Leases: total: 36, in use: 5 free: 86 % =>

:

RELATED COMMANDS:

dhcp server policy Set DHCP server policy. dhcp server status Show current DHCP server configuration.

90 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp server start

Start Speed Touch DHCP server.

SYNTAX:

dhcp server start

EXAMPLE:

=>dhcp server status DHCP Server Status: Stopped Current configuration: Address Range: 10.0.0.1 ... 10.255.255.254

.....

Leases: total: 36, in use: 0 free: 100 %

=>dhcp server start

=>dhcp server status DHCP Server Status: Searching for server... Current configuration: Address Range: 10.0.0.1 ... 10.255.255.254

.....

Leases: total: 36, in use: 0 free: 100 % => =>dhcp server status DHCP Server Status: Running Current configuration: Address Range: 10.0.0.1 ... 10.255.255.254

.....

Leases: total: 36, in use: 1 free: 97 % =>

6 DHCP Commands

RELATED COMMANDS:

dhcp server status Show current DHCP server configuration. dhcp server stop Stop DHCP server.

3EC 16982 AAAA TCZZA Ed. 04

91 / 300

6 DHCP Commands

dhcp server stats

Show Speed Touch DHCP server statistics.

SYNTAX:

dhcp server stats

EXAMPLE OUTPUT:

=>dhcp server stats

DHCP server statistics: Corrupted packet recv : 0 DISCOVER : 2451 REQUEST : 19 DECLINE : 0 RELEASE : 0 INFORM : 1 Pure BOOTP REQUESTS : 2 Other message types : 0 OFFERs sent : 2451 ACKs sent : 19 NAKs sent : 0 Lease table got full : no Ping table got full : no Second dhcp server seen : no =>

DESCRIPTION:

Corrupted packet recv Indicates the number of corrupted packets (not complaint to RFC2131) were

received from the LAN.

DISCOVER Indicates the number of DHCP server discovery packets were received from the LAN.

These broadcasts are sent by potential DHCP clients to locate available DHCP servers.

REQUEST Indicates the number of DHCP address lease requests were received from the LAN.

DECLINE Indicates the number of DHCP address lease requests that were declined.

RELEASE Indicates the number of DHCP address release requests that were received from

DHCP clients.

INFORM Indicates the number of information requests that were received from DHCP clients.

Pure BOOTP requests Indicates the number of BOOTP requests that were received from the LAN.

OFFERs sent Indicates the number of IP address offers were sent in reply to DHCP requests.

92 / 300

3EC 16982 AAAA TCZZA Ed. 04

6 DHCP Commands

ACKs sent Indicates the number of ACKnowledgement replies were sent to successfully

configured DHCP clients.

NAKs sent Indicates the number of NotAcKnowledgement replies were sent to wrongly

configured DHCP clients.

Lease table got full Indicates whether the maximum number of DHCP leases is reached or not.

Ping table got full Indicates whether the history list of IP address pings got full or not. These pings are

sent by the Speed Touch DHCP server to verify whether the IP address is already in use on the LAN or not. (dhcp server policy verifyfirst=yes)

Second DHCP server seen

Indicates whether a concurrent DHCP server was found on the LAN or not.

RELATED COMMANDS:

dhcp server clrstats Clear DHCP server statistics.

3EC 16982 AAAA TCZZA Ed. 04

93 / 300

6 DHCP Commands

dhcp server status

Show current DHCP server configuration.

SYNTAX:

dhcp server status

EXAMPLE OUTPUT IN A NETWORKED ENVIRONMENT (SpeedTouch as DHCP client):

=>dhcp server status

DHCP Server Status: Client Current configuration: Address Range: 10.0.0.1 ... 10.255.255.254 Netmask: 255.0.0.0 Lease time: 7200 seconds Gateway (default router): 10.0.0.3 (auto) DNS server: 10.0.0.3 (auto) Domain name: SpeedTouch.local Policies: Verify first: no Trust client: yes Spoofing: no Start as client: yes Spoofing parameters: Failure timeout (!DoD): 4 sec Failure lease time (!DoD): 60 sec Temp. lease time (DoD): 10 sec Start–up client parameters: Timeout: 20 sec Tracing: off Memory usage: Leases: total: 36, in use: 0 free: 100 % =>

RELATED COMMANDS:

dhcp server stop Stop DHCP server. dhcp server start Start DHCP server. dhcp server policy Set DHCP server policy. dhcp server spoofing Set spoofing parameters.

94 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp server stop

Stop Speed Touch DHCP server.

SYNTAX:

dhcp server stop

EXAMPLE:

=>dhcp server status DHCP Server Status: Running Current configuration: Address Range: 10.0.0.1 ... 10.255.255.254

.....

Leases: total: 36, in use: 1 free: 97 %

=>dhcp server stop

=>dhcp server status DHCP Server Status: Stopped Current configuration: Address Range: 10.0.0.1 ... 10.255.255.254

.....

Leases: total: 36, in use: 0 free: 100 % =>

6 DHCP Commands

RELATED COMMANDS:

dhcp server start Start DHCP server. dhcp server status Show current DHCP server configuration.

3EC 16982 AAAA TCZZA Ed. 04

95 / 300

6 DHCP Commands

dhcp server troff

Disable verbose console logging. No debug traces are generated anymore.

SYNTAX:

dhcp server troff

EXAMPLE:

=>dhcp server status DHCP Server Status: Running

.....

Start–up client parameters: Timeout: 20 sec Tracing: on Memory usage: Leases: total: 36, in use: 0 free: 100 %

=>dhcp server troff

=>dhcp server status DHCP Server Status: Running

.....

Start–up client parameters: Timeout: 20 sec Tracing: off Memory usage: Leases: total: 36, in use: 1 free: 97 % =>

RELATED COMMANDS:

dhcp server status Show current DHCP server configuration. dhcp server tron Enable verbose console logging.

96 / 300

3EC 16982 AAAA TCZZA Ed. 04

dhcp server tron

Enable verbose console logging. Debug traces are generated.

SYNTAX:

dhcp server tron

EXAMPLE:

=>dhcp server status DHCP Server Status: Running

.....

Start–up client parameters: Timeout: 20 sec Tracing: off Memory usage: Leases: total: 36, in use: 1 free: 97 %

=>dhcp server tron

=>dhcp server status DHCP Server Status: Running

.....

Start–up client parameters: Timeout: 20 sec Tracing: on Memory usage: Leases: total: 36, in use: 1 free: 97 % =>

6 DHCP Commands

RELATED COMMANDS:

dhcp server status Show current DHCP server configuration dhcp server troff Disable verbose console logging.

3EC 16982 AAAA TCZZA Ed. 04

97 / 300

6 DHCP Commands

98 / 300

3EC 16982 AAAA TCZZA Ed. 04

7 DNS Commands

dns (to access the DNS level) dns add dns clear dns clrstats dns delete dns domain dns flush dns fwdadd dns fwddelete

7 DNS Commands

dns fwdlist dns fwdtable dns list dns load dns nslookup dns rem dns save dns start dns stats dns status dns stop dns toutfwd dns troff dns tron

3EC 16982 AAAA TCZZA Ed. 04

99 / 300

7 DNS Commands

dns add

Add a static DNS entry for IP hosts who do not reveal their hostname in the DHCP request, or even worse, not support DHCP.

SYNTAX:

dns add hostname = <string>

[addr = <ipaddress>]

hostname The name of the IP host (without the (sub)domain name). REQUIRED

[addr] The IP address of the host (without mask).

In case this parameter is not specified the hostname applies to the Speed Touch itself.

EXAMPLE:

=>dns list Domain: lan Nr. Hostname IP Address 0 TestHost 10.0.0.140 1 Default 10.0.0.8 Total Table Size: 73 entries Amount used: 2 (2%)

=>dns add hostname ftpserver addr 172.16.0.1

=>dns list Domain: lan Nr. Hostname IP Address 0 TestHost 10.0.0.140 1 Default 10.0.0.8 2 ftpserver 172.16.0.1 Total Table Size: 73 entries Amount used: 3 (4%) =>

RELATED COMMANDS:

dns list List current DNS entries. dns delete Delete a DNS entry (via its index number). dns rem Delete a DNS entry (via its hostname).

OPTIONAL

100 / 300

3EC 16982 AAAA TCZZA Ed. 04

Alcatel-Lucent SPEDDTOUCH DSL ROUTERS User Manual 2

Specifications and Main Features

Frequently Asked Questions

User Manual