Alcatel-Lucent SPEDDTOUCH PRO User Manual 1

SPEED TOUCH Pro

CLI Reference Guide

with Firewall DSL Router

3EC 16982 AFAA TCZZA Ed. 01

Status

Released

2 / 264

Change Note

Short Title

BD F aa 39813

CD-RG STFire CLI

All rights reserved. Passing on and copying of this
document, use and communication of its contents
not permitted without written authorization from Alcatel.

3EC 16982 AFAA TCZZA Ed. 01

Contents

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

1 ADSL Commands 21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2 ATMF Commands 23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 Bridge Commands 31. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4 CIP Commands 47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5 Config Commands 57. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6 DHCP Commands 63. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7 DNS Commands 101. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8 Firewall Commands 123. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents

9 IP Commands 149. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10 MER Commands 171. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

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

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

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

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

15 Software Commands 233. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16 SHDSL Commands 239. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17 System Commands 245. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

18 TD Commands 253. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Index 257. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3EC 16982 AFAA TCZZA Ed. 01

3 / 264

Contents

4 / 264

3EC 16982 AFAA TCZZA Ed. 01

Preface

Preface

Welcome to the Alcatel SpeedTouchPro with Firewall Series 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 SpeedTouchPro with Firewall via its character based Command Line
Interface.

Although the SpeedTouchPro with Firewall 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 the following Alcatel DSL Speed Touch
products:

 Alcatel SpeedTouchPro with Firewall

 Alcatel SpeedTouchPro with Firewall ISDN

 Alcatel SpeedTouchPro with Firewall SHDSL

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
SpeedTouchPro with Firewall CLI. Next to describing the various access methods to the
CLI, this part will describe in brief some general manipulations 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 the
Speed TouchPro with Firewall 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Pro with Firewall

 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 AFAA TCZZA Ed. 01

5 / 264

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 / 264

3EC 16982 AFAA TCZZA Ed. 01

Alcatel

Speed TouchPro

with Firewall

CLI Navigation

3EC 16982 AFAA TCZZA Ed. 01

7 / 264

8 / 264

3EC 16982 AFAA TCZZA Ed. 01

Accessing the Command Line Interface

Users can access the Command Line Interface via:

 The Speed TouchPro with Firewall CLI web pages

This requires that TCP/IP connectivity exists between the host from which the web browser is
opened and the Speed TouchPro with Firewall

 A Telnet session

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

 The serial 'Console' interface

Access via the Web Pages

The Speed TouchPro with Firewall CLI is accessible via its web interface. Browse to the Speed
TouchPro with Firewall web pages and click

menu is opened in a new browser window:

in the left frame. As a result the CLI web

You can open the CLI web pages directly by pointing the browser to the following URL:
http://10.0.0.138/cli.htm (in which the 10.0.0.138 IP address should be replaced by the
actual Speed TouchPro with Firewall IP address if needed).

All CLI groups and commands are placed in a menu. You can open a group by clicking the
next to a group name, or clicking the group name.

Clicking on a command name will execute it. Commands without parameters are indicated with
and are executed immediately.

Commands which require additional parameters are indicated with
parameters you must click

3EC 16982 AFAA TCZZA Ed. 01

to execute the command.

. After you configured all

mark

9 / 264

Access via a Telnet Session or Serial Console

As soon a session to the CLI is opened, the SpeedTouchPro with Firewall banner pops up,
followed by the CLI prompt.

In case of a Telnet session authentication via the System password might be required before access
is granted.

The following figure shows an example of the SpeedTouchPro with Firewall 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 Speed Touch Pro
* _____/__ / \\ with Firewall DSL Router
* _/ /\_____/___ \ Version R3.4
* // / \ /\ \
* _______//_______/ \ / _\/____ Copyright (c) 1999–2001 Alcatel
* / / \ \ / / / /\
* __/ / \ \ / / / / _\__
* / / / \_______\/ / / / / /\
* /_/______/___________________/ /________/ /___/ \
* \ \ \ ___________ \ \ \ \ \ /
* \_\ \ / /\ \ \ \ \___\/
* \ \/ / \ \ \ \ /
* \_____/ / \ \ \________\/
* /__________/ \ \ /
* \ _____ \ /_____\/
* \ / /\ \ /___\/
* /____/ \ \ /
* \ \ /___\/
* \____\/
*
–––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
=>

10 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 this shell.
.. : Exits group selection.

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

=>

To return to top level, or to descend one level (in case of nested command groups) execute .. .

EXAMPLE:

=>phonebook
[phonebook]=>
[phonebook]=>..
=>

3EC 16982 AFAA TCZZA Ed. 01

11 / 264

The Help Command

Execute help from top level to list all available command groups for the SpeedTouchPro with
Firewall.

EXAMPLE:

=>help

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

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

=>

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:

=>firewall
[firewall]=>

[firewall]=>help

Following commands are available :

tron : Enables verbose console messaging.
troff : Disables verbose console messaging.
match : Defines an ip packet match.
assign : Assign a chain to an entry point.
list : Shows a list of all the hooks with the chain attached.
flush : Clears all hooks. If a hook is provided, that hook is cleared.

Following command groups are available :

chain rule

[firewall]=>

12 / 264

3EC 16982 AFAA TCZZA Ed. 01

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

EXAMPLE:

=>firewall help

Following commands are available :

tron : Enables verbose console messaging.
troff : Disables verbose console messaging.
match : Defines an ip packet match.
assign : Assign a chain to an entry point.
list : Shows a list of all the hooks with the chain attached.
flush : Clears all hooks. If a hook is provided, that hook is cleared.

Following command groups are available :

chain rule

=>

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

EXAMPLE:

=>help firewall assign

Assign a chain to an entry point.
Syntax : assign hook = <{input|sink|forward|source|output}> chain = <string>

parameters :

hook = <{input|sink|forward|source|output}>

Name of hook to assign chain to.

chain = <string>

Name of chain to use.

=>

3EC 16982 AFAA TCZZA Ed. 01

13 / 264

Command Completion

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 firewall command group selection, followed by a Tab" stroke
results in the full assign command being completed. Entering firewall 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:

=>firewall
[firewall]=>a “Tab“
[firewall]=>assign

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:

[firewall]=>match
chain =
chain =

chain =
[firewall]=>

Ctrl+G"

14 / 264

3EC 16982 AFAA TCZZA Ed. 01

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:

=>firewall
[firewall]=>list
assign hook=input chain=input
assign hook=sink chain=sink
assign hook=forward chain=forward
assign hook=source chain=source

[firewall]=>
[firewall]=>:firewall list

  

↵)" to select and execute the retaken command.

3EC 16982 AFAA TCZZA Ed. 01

15 / 264

Command Line Interface Top Level Structure

The following command groups are available:

 adsl (only applicable for the SpeedTouchPro with Firewall ADSL/POTS variant)
 atmf (only applicable for models equipped with an ATMF25.6Mbps port)
 bridge
 cip
 config
 dhcp
 dns
 firewall
 ip
 mer
 nat
 phonebook
 ppp
 pptp
 shdsl (only applicable for the SpeedTouchPro with Firewall SHDSL variant)
 software
 system
 td

16 / 264

3EC 16982 AFAA TCZZA Ed. 01

Command Line Interface Commands

All CLI commands are commands that operate on, or configure, the SpeedTouchPro with
Firewall.

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. firewall list).

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

`!` in a command means `NOT`, e.g. the `[!]syn` parameter in the firewall rule create command.

EXAMPLE:

=>firewall list

assign hook=input chain=input
assign hook=sink chain=sink
assign hook=forward chain=forward
assign hook=source chain=source

=>firewall
[firewall]=>list

assign hook=input chain=input
assign hook=sink chain=sink
assign hook=forward chain=forward
assign hook=source chain=source
[firewall]=>

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 `firewall assign hook=input chain=input`. To break of
such incomplete command press Ctrl+G".

EXAMPLE:

=>firewall assign

hook = input
chain= input
=>

3EC 16982 AFAA TCZZA Ed. 01

17 / 264

18 / 264

3EC 16982 AFAA TCZZA Ed. 01

Alcatel

Speed Touch

CLI Command Description

3EC 16982 AFAA TCZZA Ed. 01

19 / 264

20 / 264

3EC 16982 AFAA TCZZA Ed. 01

1 ADSL Commands

1 ADSL Commands

The adsl command group is only applicable to the Speed TouchPro with Firewall
ADSL/POTS variant, NOT to the Speed TouchPro with Firewall ADSL/ISDN and Speed

TouchPro with Firewall SHDSL variant.

adsl (to access the ADSL level)
adsl info

3EC 16982 AFAA TCZZA Ed. 01

21 / 264

1 ADSL Commands

adsl info

Show ADSL/POTS statistics and information about the SpeedTouchPro with Firewall 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 Of
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

=>

22 / 264

3EC 16982 AFAA TCZZA Ed. 01

2 ATMF Commands

The atmf command group is only applicable to the Speed TouchPro with Firewall
ADSL/POTS variant equipped with an ATMF25.6Mbps port.

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

2 ATMF Commands

3EC 16982 AFAA TCZZA Ed. 01

23 / 264

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 = 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 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

REQUIRED

RELATED COMMANDS:

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

24 / 264

3EC 16982 AFAA TCZZA Ed. 01

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

REQUIRED

RELATED COMMANDS:

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

3EC 16982 AFAA TCZZA Ed. 01

25 / 264

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 = 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
=>

RELATED COMMANDS:

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

26 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 AFAA TCZZA Ed. 01

27 / 264

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

28 / 264

3EC 16982 AFAA TCZZA Ed. 01

atmf save

Save current ATMF25 interface configuration.

SYNTAX:

atmf save

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 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
VPI = 4 VCI = 0
VPI = 5 VCI = 0
VPI = 6 VCI = 0
VPI = 7 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 AFAA TCZZA Ed. 01

29 / 264

2 ATMF Commands

30 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 AFAA TCZZA Ed. 01

31 / 264

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

32 / 264

3EC 16982 AFAA TCZZA Ed. 01

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

Br1 : dest : Br1

Retry: 10 QoS: default Encaps: llc/snap Fcs: off
Connection State: connected Port:wan0 PortState: forwarding
RX bytes: 75 frames: 12
TX bytes: 30246 frames: 91 dropframes: 0

Br2 : dest : Br2

Retry: 10 QoS: default Encaps: llc/snap Fcs: off
Connection State: connected Port:wan1 PortState: forwarding
RX bytes: 167356345 frames: 7453312
TX bytes: 64234246 frames: 2846491 dropframes: 0

=>bridge flush

=>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

=>

3 Bridge Commands

RELATED COMMANDS:

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

3EC 16982 AFAA TCZZA Ed. 01

33 / 264

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: 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
=>phonebook list
Name Type Use Address
Br1 bridge 0 8.35
Br2 bridge 0 8.36
CIPPVC3 cip 1 8.82
CIPPVC4 cip 1 8.83

=>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–connectedPort:(Unassigned) PortState: forwarding
=>

OPTIONAL

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.

34 / 264

3EC 16982 AFAA TCZZA Ed. 01

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: 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–connectedPort:(Unassigned) PortState: forwarding

=>bridge ifattach intf=NewBridge

=>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: connected
RX bytes: 75 frames: 12
TX bytes: 30246 frames: 91 dropframes: 0

=>

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 AFAA TCZZA Ed. 01

35 / 264

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.

This parameter never needs to be specified.

[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

OPTIONAL

OPTIONAL

OPTIONAL

OPTIONAL

OPTIONAL

36 / 264

3EC 16982 AFAA TCZZA Ed. 01

EXAMPLE:

=>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: 75 frames: 12
TX bytes: 30246 frames: 91 dropframes: 0

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

=>bridge iflist intf=NewBridge
NewBridge : dest : Br1

Retry: 15 QoS: default Encaps: vcmux Fcs: off
Connection State: connected Port:wan0 PortState: forwarding
RX bytes: 83 frames: 13
TX bytes: 30740 frames: 102 dropframes: 0

=>

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.

3 Bridge Commands

3EC 16982 AFAA TCZZA Ed. 01

37 / 264

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: 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
NewBridge : dest : Br1

Retry: 10 QoS: default Encaps: llc/snap Fcs: off

Connection State: not–connectedPort:(Unassigned) PortState: forwarding

=>bridge ifdelete intf=NewBridge

=>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
=>

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.

38 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 Port:wan0 PortState: forwarding
RX bytes: 75 frames: 12
TX bytes: 30246 frames: 91 dropframes: 0

=>bridge ifattach intf=NewBridge

=>bridge iflist intf=NewBridge
NewBridge : dest : Br1

Retry: 10 QoS: default Encaps: llc/snap Fcs: off
Connection State: not–connected

=>

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 AFAA TCZZA Ed. 01

39 / 264

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: 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
NewBridge : dest : Br1

Retry: 15 QoS: default Encaps: vcmux Fcs: off

Connection State: connected Port:wan0 PortState: forwarding

RX bytes: 83 frames: 13

TX bytes: 30740 frames: 102 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.

40 / 264

3EC 16982 AFAA TCZZA Ed. 01

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: 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=Br1 dest=Br1
=>bridge save
=>bridge flush
=>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

=>bridge load defaults=no

=>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
Br1 : dest : Br1

Retry: 10 QoS: default Encaps: llc/snap Fcs: off

Connection State: connected Port:wan0 PortState: forwarding

RX bytes: 75 frames: 12

TX bytes: 30246 frames: 91 dropframes: 0
=>

OPTIONAL

RELATED COMMANDS:

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

3EC 16982 AFAA TCZZA Ed. 01

41 / 264

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.

42 / 264

3EC 16982 AFAA TCZZA Ed. 01

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, 597 seconds
00:50:8b:31:cc:aa –– dynamic, eth0, 513 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, 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 macadd Add a static MAC address entry.
bridge maclist Show current filtering database.

3EC 16982 AFAA TCZZA Ed. 01

43 / 264

3 Bridge Commands

bridge maclist

Show current MAC address filtering database.

SYNTAX:

bridge maclist

EXAMPLE:

=>bridge maclist

=>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, 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
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.

44 / 264

3EC 16982 AFAA TCZZA Ed. 01

bridge save

Save current bridge configuration.

SYNTAX:

bridge save

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=Br1 dest=Br1

=>bridge save

=>bridge flush
=>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
=>bridge load defaults=no
=>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
Br1 : dest : Br1

Retry: 10 QoS: default Encaps: llc/snap Fcs: off

Connection State: connected Port:wan0 PortState: forwarding

RX bytes: 75 frames: 12

TX bytes: 30246 frames: 91 dropframes: 0
=>

3 Bridge Commands

RELATED COMMANDS:

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

3EC 16982 AFAA TCZZA Ed. 01

45 / 264

3 Bridge Commands

46 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 AFAA TCZZA Ed. 01

47 / 264

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
=>

RELATED COMMANDS:

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

48 / 264

3EC 16982 AFAA TCZZA Ed. 01

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
=>

RELATED COMMANDS:

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

OPTIONAL

3EC 16982 AFAA TCZZA Ed. 01

49 / 264

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
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

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 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.

50 / 264

3EC 16982 AFAA TCZZA Ed. 01

cip iflist

Show current CIP configuration.

SYNTAX:

cip iflist

EXAMPLE OUTPUT:

=>cip iflist

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
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
=>

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_repl_in = 75 inarp_inv_in = 0

inarp_reqs_out = 18 inarp_repl_out = 75 inarp_inv_out= 0

=>cip iflist

cip0 addr = 200.200.200.138 mask = 255.255.255.0

UNI address = A0:*.03

inarp_reqs_in = 22 inarp_repl_in = 75 inarp_inv_in = 0

inarp_reqs_out = 22 inarp_repl_out = 75 inarp_inv_out= 0

=>cip iflist

cip0 addr = 200.200.200.138 mask = 255.255.255.0

UNI address = A0:*.03

inarp_reqs_in = 22 inarp_repl_in = 76 inarp_inv_in = 0

inarp_reqs_out = 22 inarp_repl_out = 76 inarp_inv_out= 0
=>

RELATED COMMANDS:

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

3EC 16982 AFAA TCZZA Ed. 01

51 / 264

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.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

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 iflist

=>cip load defaults=yes

=>cip iflist
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 flush
=>cip iflist

=>cip load defaults=no

=>cip iflist
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
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
=>

OPTIONAL

RELATED COMMANDS:

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

52 / 264

3EC 16982 AFAA TCZZA Ed. 01

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

=>

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

RELATED COMMANDS:

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

3EC 16982 AFAA TCZZA Ed. 01

53 / 264

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:

=>cip pvclist
CIPPVC1

=>cip pvcdelete dest=CIPPVC1

=>cip pvclist
=>

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

RELATED COMMANDS:

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

REQUIRED

54 / 264

3EC 16982 AFAA TCZZA Ed. 01

4 CIP Commands

cip pvclist

Show current PVC ARP entries.

SYNTAX:

cip pvclist

EXAMPLE OUTPUT:

=>cip pvclist
CIPPVC1

=>

EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:

=>cip iflist
cip0 addr = 200.200.200.138 mask = 255.255.255.0

=>cip pvclist

699 atmport = 0 vpi = 6 vci = 99 dest_ip = 172.16.1.3

8.50 atmport = 0 vpi = 8 vci = 50 dest_ip = 200.200.200.14

=>

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

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

encaps = llc mtu = 9180

encaps = llc mtu = 9180

RELATED COMMANDS:

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

3EC 16982 AFAA TCZZA Ed. 01

55 / 264

4 CIP Commands

cip save

Save current CIP configuration.

SYNTAX:

cip save

EXAMPLE:

=>cip iflist
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

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 iflist
=>cip load defaults=no
=>cip iflist
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

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.

56 / 264

3EC 16982 AFAA TCZZA Ed. 01

5 Config Commands

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

5 Config Commands

3EC 16982 AFAA TCZZA Ed. 01

57 / 264

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.

58 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 client

flush, dhcp server flush, dns flush, env 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 [flush_ip = <{no|yes}>]

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

Not keeping the IP settings could cause lost IP connectivity in the LAN.
By default IP settings are preserved.

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

0.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 flush_ip=no

=>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 flush_ip=yes

######### ALL TCP/IP CONNECTIVITY IS LOST ##########

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.

OPTIONAL

3EC 16982 AFAA TCZZA Ed. 01

59 / 264

5 Config Commands

config load

Load complete saved or default configuration. Execute config flush prior to config load.
In case the saved configuration is loaded (defaults=no) this combines all load commands: atmf

load, bridge load, cip load, dhcp client load, dhcp server load, dns load, env load, firewall
load, firewall rule load, mer load, nat load, phonebook load, ppp load, pptp load,
qosbook load, system load and optionally ip load.

SYNTAX:

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

[defaults = {yes|no}]

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

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

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

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

0.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 flush_ip=no
=>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 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

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.

60 / 264

3EC 16982 AFAA TCZZA Ed. 01

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: business.lan
Nr. Hostname IP Address
0 SpeedTouch *.*.*.*
1 TestHost 10.0.0.140
2 HTTP_Server 10.0.0.8
3 FTP_Server 10.0.0.7
Total Table Size: 73 entries
Amount used: 4 (5%)
=>dns save

=>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: business.lan
Nr. Hostname IP Address
0 SpeedTouch *.*.*.*
1 TestHost 10.0.0.140
2 HTTP_Server 10.0.0.8
3 FTP_Server 10.0.0.7
Total Table Size: 73 entries
Amount used: 4 (5%)
=>

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 AFAA TCZZA Ed. 01

61 / 264

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 client

save, dhcp server 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:

=>config save

=>

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.

62 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 AFAA TCZZA Ed. 01

63 / 264

6 DHCP Commands

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

64 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 AFAA TCZZA Ed. 01

65 / 264

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.

66 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 : 0: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 flush

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

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 AFAA TCZZA Ed. 01

67 / 264

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.

=>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.

68 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 : 10.0.0.10

HW address : 0: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 %
=>

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 AFAA TCZZA Ed. 01

69 / 264

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 %
=>

70 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 : 10.0.0.10
HW address : 0: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 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.
dhcp client ifrelease Release a lease attached to a dynamic interface.

3EC 16982 AFAA TCZZA Ed. 01

71 / 264

6 DHCP Commands

dhcp client iflist

Show all dynamic interfaces.

SYNTAX:

dhcp client iflist

EXAMPLE:

=>dhcp client iflist

NewMer : [INIT]

flags= uc
IP address : 0.0.0.0
HW address : 0: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:
The SpeedTouchPro with Firewall is configured as DHCP client on its Ethernet interface eth0.

=>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.

72 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 : 0: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 ifattach 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 AFAA TCZZA Ed. 01

73 / 264

6 DHCP Commands

EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
The SpeedTouchPro with Firewall is configured as DHCP client on its Ethernet interface eth0.

=>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: 19, 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.

74 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 : [BOUND]

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
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: 19, in use: 1, free: 94 %

=>dhcp client ifrenew intf=NewMer

=>dhcp client iflist
NewMer : [RENEWING]

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 12 sec

transmission of DISCOVER in 24 sec

retransmission timeout: 64

nbr of retransmissions: 11
Number of leases: 1
Total size of table: 19, in use: 1, free: 94 %
=>

3EC 16982 AFAA TCZZA Ed. 01

75 / 264

6 DHCP Commands

EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
The SpeedTouchPro with Firewall is configured as DHCP client on its Ethernet interface eth0.

=>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: 19, 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.

76 / 264

3EC 16982 AFAA TCZZA Ed. 01

dhcp client load

Load saved 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
=>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 get a lease for 2 sec

transmission 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 AFAA TCZZA Ed. 01

77 / 264

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

=>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 get a lease for 2 sec

transmission 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.

78 / 264

3EC 16982 AFAA TCZZA Ed. 01

dhcp client stats

Show DHCP client statistics.

SYNTAX:

dhcp client stats

EXAMPLE:

=>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 : 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

RELATED COMMANDS:

dhcp client clear Clear DHCP client statistics.

3EC 16982 AFAA TCZZA Ed. 01

79 / 264

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Pro with Firewall
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:45:67:89:ab addr=10.0.0.1 leastime=60
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, 32 sec
lease is being used.

Lease 1: 01:23:45:67:89:AB

Hostname = NewLease
ip address : 10.0.0.1
expires in : 23 sec

lease is 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.

80 / 264

3EC 16982 AFAA TCZZA Ed. 01

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Pro with Firewall 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

.......

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

.......

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 AFAA TCZZA Ed. 01

81 / 264

6 DHCP Commands

dhcp server clrstats

Clear SpeedTouchPro with Firewall 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.

82 / 264

3EC 16982 AFAA TCZZA Ed. 01

dhcp server config

Set SpeedTouchPro with Firewall 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 Pro with Firewall as DNS server.

OPTIONAL

OPTIONAL

OPTIONAL

OPTIONAL

3EC 16982 AFAA TCZZA Ed. 01

83 / 264

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.2endrange=172.16.0.122netmask=255.0.0.0

leasetime=21600 gateway=172.16.0.1 dnsaddr=172.16.0.254

=>dhcp server status
DHCP Server Status: Running
Current configuration:

Address Range: 172.16.0.2 ... 172.16.0.122

Netmask: 255.0.0.0

Lease time: 21600 seconds

Gateway (default router): 172.16.0.1

DNS server: 172.16.0.254

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 %
=>

RELATED COMMANDS:

dhcp server status Show current DHCP server configuration.

84 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 list to see a list of the index numbers of all
current DHCP leases.

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.

Lease 1: 01:23:45:67:89:AB

Hostname = NewLease
ip address : 10.0.0.1
expires in : 23 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, 15 min, 32 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 AFAA TCZZA Ed. 01

85 / 264

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, 16 min, 20 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: 4 free: 89 %

=>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.

86 / 264

3EC 16982 AFAA TCZZA Ed. 01

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.
Lease 4: 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 %
=>

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 AFAA TCZZA Ed. 01

87 / 264

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 list
Leases:
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 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.

Lease 4: 01:23:55:67:89:AB

Hostname = Tempo
ip address : 10.0.0.1
never expires!

lease is being used.
Total size of table: 36, in use: 3 free: 92 %
=>dhcp server save
=>dhcp server flush

=>dhcp server load

=>dhcp server list
Leases:
Lease 4: 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: 1 free: 97 %
=>

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.

88 / 264

3EC 16982 AFAA TCZZA Ed. 01

dhcp server policy

Set SpeedTouchPro with Firewall 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 SpeedTouchPro with Firewall 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
Current configuration:

.....

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
Current configuration:

.....

Policies:

Verify first:yeso
Trust client:no
Spoofing: yes

Start as client: no

.....

=>

OPTIONAL

OPTIONAL

OPTIONAL

OPTIONAL

RELATED COMMANDS:

dhcp server status Show current DHCP server configuration.

3EC 16982 AFAA TCZZA Ed. 01

89 / 264

6 DHCP Commands

dhcp server save

Save complete SpeedTouchPro with Firewall 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, 58 min, 55 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.

90 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 SpeedTouchPro with
Firewall 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
SpeedTouchPro with Firewall 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

OPTIONAL

OPTIONAL

3EC 16982 AFAA TCZZA Ed. 01

91 / 264

6 DHCP Commands

EXAMPLE:

=>dhcp server status
DHCP Server Status: Running
Current configuration:

.....

Spoofing parameters:

Failure timeout (!DoD): 4 sec

Failure lease time (!DoD): 60 sec

Temp. lease time (DoD): 10 sec

.....

=>dhcp server spoof failtime=8 errorlt=120 dodlt=20

=>dhcp server status
DHCP Server Status: Running
Current configuration:

.....

Spoofing parameters:

Failure timeout (!DoD): 8 sec

Failure lease time (!DoD): 120 sec

Temp. lease time (DoD): 20 sec

.....

=>

RELATED COMMANDS:

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

92 / 264

3EC 16982 AFAA TCZZA Ed. 01

dhcp server start

Start SpeedTouchPro with Firewall DHCP server.

SYNTAX:

dhcp server start

EXAMPLE:

=>dhcp server status
DHCP Server Status: Stopped
Current configuration:

.....

=>dhcp server start

=>dhcp server status
DHCP Server Status: Searching for server...
Current configuration:

.....

=>
=>dhcp server status
DHCP Server Status: Running
Current configuration:

.....

=>

6 DHCP Commands

RELATED COMMANDS:

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

3EC 16982 AFAA TCZZA Ed. 01

93 / 264

6 DHCP Commands

dhcp server stats

Show SpeedTouchPro with Firewall DHCP server statistics.

SYNTAX:

dhcp server stats

EXAMPLE OUTPUT:

=>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
=>

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.

94 / 264

3EC 16982 AFAA TCZZA Ed. 01

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 SpeedTouchPro with Firewall 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 AFAA TCZZA Ed. 01

95 / 264

6 DHCP Commands

dhcp server status

Show current DHCP server configuration.

SYNTAX:

dhcp server status

EXAMPLE:

=>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.1 (auto)

DNS server: 10.0.0.1 (auto)

Domain name: office.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 %
=>

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.

96 / 264

3EC 16982 AFAA TCZZA Ed. 01

dhcp server stop

Stop SpeedTouchPro with Firewall DHCP server.

SYNTAX:

dhcp server stop

EXAMPLE:

=>dhcp server status
DHCP Server Status: Running
Current configuration:

.....

=>dhcp server stop

=>dhcp server status
DHCP Server Status: Stopped
Current configuration:

.....

=>

6 DHCP Commands

RELATED COMMANDS:

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

3EC 16982 AFAA TCZZA Ed. 01

97 / 264

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
Current configuration:

.....

Tracing: on

.....

=>dhcp server troff

=>dhcp server status
DHCP Server Status: Running
Current configuration:

.....

Tracing: off

.....

=>

RELATED COMMANDS:

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

98 / 264

3EC 16982 AFAA TCZZA Ed. 01

dhcp server tron

Enable verbose console logging. Debug traces are generated.

SYNTAX:

dhcp server tron

EXAMPLE:

=>dhcp server status
DHCP Server Status: Running
Current configuration:

.....

Tracing: off

.....

=>dhcp server tron

=>dhcp server status
DHCP Server Status: Running
Current configuration:

.....

Tracing: on

.....

=>

6 DHCP Commands

RELATED COMMANDS:

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

3EC 16982 AFAA TCZZA Ed. 01

99 / 264

6 DHCP Commands

100 / 264

3EC 16982 AFAA TCZZA Ed. 01