alcatel cli reference guide

8/2/2019 Alcatel CLI Reference Guide

1/198

3EC 16982 AAAA TCZZA Ed. 05

SPEED TOUCHHome/ProCLI Reference Guide

ADSL Router Series


2/198

3EC 16982 AAAA TCZZA Ed. 052 / 198

Status Released

Change Note BD F aa 39813

Short Title CD-RG STHome/Pro CLI

All rights reserved. Passing on and copying of thisdocument, use and communication of its contentsnot permitted without written authorization from Alcatel.


3/198

Contents

3EC 16982 AAAA TCZZA Ed. 05 3 / 198

Contents

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

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

2 ATMF Commands 25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 Bridge Commands 33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

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

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

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

7 DNS Commands 83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 IP Commands 105. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9 NAT Commands 125. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10 Phonebook Commands 141. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11 PPP Commands 149. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

12 PPTP Commands 165. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13 Software Commands 173. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14 System Commands 179. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

15 TD Commands 187. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Index 193. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


4/198

Contents

3EC 16982 AAAA TCZZA Ed. 054 / 198


5/198

Preface

5 / 1983EC 16982 AAAA TCZZA Ed. 05

PrefaceWelcome to theAlcatel SpeedTouchtHome/Pro 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 SpeedTouchtHome/Pro via its character based Command Line Interface.

Although the SpeedTouchtHome/ProWeb 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 SpeedTouch

products:

" Alcatel SpeedTouchtHome

" Alcatel SpeedTouchtHome ISDN

" Alcatel SpeedTouchtPro

" Alcatel SpeedTouchtPro ISDN

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 theSpeedTouchtHome/Pro 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 performsome 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 theSpeedTouchtHome/Pro products are alphabetically described per group selection.

Each command is described in a systematic manner:

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

D A short description of the CLI command, if needed completed by a description of thepossible impact on the user and/or the SpeedTouchtHome/Pro

D The syntax of the command with a description of each parameterD An example to demonstrate the use of the CLI command

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


6/198

Preface

6 / 198 3EC 16982 AAAA TCZZA Ed. 05

" Trademarks

The following trademarks are used in this document:

D Speed Touch is a trademark of the Alcatel Company

D Netscape

and Netscape Navigator

are registered trademarks of NetscapeCommunications Corporation

D Windows and Internet Explorer are trademarks of Microsoft Corporation

D Apple and MacOS are registered trademarks of Apple Computer Inc.

D UNIX is a registered trademark of UNIX System Laboratories, Inc.

D 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 regularlyupgraded. Alcatel documentation changes accordingly.

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

http://www.alcatel.com

http://www.alcateldsl.com

" Directive

Unless expressly and unambiguously approved by Alcatel, you may not:D disassemble, decompile, reverse engineer, trace or otherwise analyze the equipment, its

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

D copy, rent, loan, resell, sublicense, or otherwise transfer or distribute the equipment toothers;

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

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

notices;D 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 willinvalidate the user's authority to operate this equipment.


7/198

7 / 1983EC 16982 AAAA TCZZA Ed. 05

AlcatelSpeedTouchHome/Pro

CLI Navigation


8/198

8 / 198 3EC 16982 AAAA TCZZA Ed. 05


9/198

9 / 1983EC 16982 AAAA TCZZA Ed. 05

Accessing the Command Line Interface

Users can access the Command Line Interface via:" A Telnet session

This requires that TCP/IP connectivity exists between the host from which the Telnet session isopened and the SpeedTouchtHome/Pro

" The serial 'Console' interface, if equipped.

Access via a Telnet Session or Serial Console

As soon a session to the CLI is opened, the SpeedTouchtHome/Pro banner pops up, followed bythe CLI prompt.

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

The following figure shows an example of the SpeedTouchtHome/Pro banner after opening aTelnet session and authentication.

EXAMPLE:

/home/doejohn{1}$ telnet 10.0.0.138Trying 10.0.0.138...

Connected to 10.0.0.138.

Escape character is ^].

User :

SpeedTouch (0090D000012345)

Password : ######

*

* ______

* ___/_____/\

* / /\\ Alcatel Speed Touch

* _____/__ / \\ ADSL Modem/Router

* _/ /\_____/___ \ Version R3.2

* // / \ /\ \

* _______//_______/ \ / _\/____ Copyright (c) 19992001 Alcatel

* / / \ \ / / / /\

* __/ / \ \ / / / / _\__

* / / / \_______\/ / / / / /\

* /_/______/___________________/ /________/ /___/ \

* \ \ \ ___________ \ \ \ \ \ /* \_\ \ / /\ \ \ \ \___\/

* \ \/ / \ \ \ \ /

* \_____/ / \ \ \________\/

* /__________/ \ \ /

* \ _____ \ /_____\/

* \ / /\ \ /___\/

* /____/ \ \ /

* \ \ /___\/

* \____\/

*

=>


10/198

10 / 198 3EC 16982 AAAA TCZZA Ed. 05

Navigation and Manipulation

Manipulation commands are commands that manipulate operations on the command line, forexample 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 desiredcommand group.

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

EXAMPLE (SpeedTouchtHome):

=>helpFollowing command groups are available :config system software ip phonebook

adsl pptp bridge atmf td

dns dhcp

=>

EXAMPLE (SpeedTouchtPro):

=>helpFollowing command groups are available :

config system software ip phonebook

adsl nat cip ppp pptpbridge atmf td dns dhcp

=>

To return to top level, execute exit.

EXAMPLE:

=>phonebook

[phonebook]=>

[phonebook]=>exit

=>


11/198

11 / 1983EC 16982 AAAA TCZZA Ed. 05

The Help Command

Execute help from top level to list all available command groups for the SpeedTouchtHome/Pro.

EXAMPLE (SpeedTouchtPro):=>helpFollowing command groups are available :

config system software ip phonebook

adsl nat cip ppp pptp

bridge atmf td dns dhcp

dhcp dns td atmf mer

=>

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

EXAMPLE:

=>phonebook

[phonebook]=>

[phonebook]=>helpFollowing commands are available :

list add delete save flush

load autolist help exit

[phonebook]=>

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

EXAMPLE:

=>phonebook helpFollowing commands are available :

list add delete save flush

load autolist help exit

=>


12/198

12 / 198 3EC 16982 AAAA TCZZA Ed. 05

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

EXAMPLE:=>help phonebook addadd : Adds a phonebook entry

name=

addr=

type=

=>

Command Completion

The CLI features command completion, which means that when starting to enter a command it canbe completed by pressing the Tab" key.

For example, entering a at the firewall command group selection, followed by a Tab" strokeresults in the full assign command being completed. Entering firewall a from top level gives thesame result.

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

EXAMPLE:

=>phonebook

[phonebook]=>d Tab[phonebook]=>delete

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 theCommand Line press "Ctrl+E".

In the following example, the first indicates the position of the cursor after pressing "Ctrl+A", thesecond the position of the cursor after pressing "Ctrl+E".

EXAMPLE:

=>list

Breaking off Commands


13/198

13 / 1983EC 16982 AAAA TCZZA Ed. 05

You can break off a command by pressing Ctrl+G". This can be useful in a situation where a useris prompted to enter a value which it does not know and wants to abort the command. Instead ofbeing 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 `name =`. The command isbroken of and the user returns to the command line.

EXAMPLE:

[phonebook]=>add

name =

name =

name = Ctrl+G"[phonebook]=>

History of Commands

To retake previous commands press the up arrow and come back to more recent commandswith the down arrow . Press Enter ()" to select and execute the retaken command.

EXAMPLE:

=>phonebook

[phonebook]=>list

Name address type usage

Br1 8*35 bridge configured

Br2 8*36 bridge free



RELAY_PPP1 8*48 pptp configuredRELAY_PPP2 8*49 pptp configured

RELAY_PPP3 8*50 pptp configured

RELAY_PPP4 8*51 pptp configured

PPP1 8*64 ppp configured

PPP2 8*65 ppp configured

PPP3 8*66 ppp free

DHCP_SPOOF 8*67 ppp configured

CIPPVC1 8*80 cip configured

CIPPVC1 8*81 cip free



[phonebook]=>

[phonebook]=>:phonebook list


14/198

14 / 198 3EC 16982 AAAA TCZZA Ed. 05

Command Line Interface Top Level Structure

The following command groups are available:

" adsl (only applicable for the SpeedTouchtHome/Pro ADSL/POTS variants)" atmf(only applicable for models equipped with an ATMF25.6Mbps port)

" bridge

" cip (only applicable for the SpeedTouchtPro)

" config

" dhcp

" dns

" ip

" nat (only applicable for the SpeedTouchtPro)

" phonebook

" ppp (only applicable for the SpeedTouchtPro)

" pptp

" software

" system

" td


15/198

15 / 1983EC 16982 AAAA TCZZA Ed. 05

Command Line Interface Commands

All CLI commands are commands that operate on, or configure, the SpeedTouchtHome/Pro.

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

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

EXAMPLE:

=>phonebook autolist8.35

8.36

=>phonebook[phonebook]=>autolist

8.358.36

[firewall]=>

Instead of entering a completely builtup command with all its parameters, you can also enter justthe command itself, without its parameters. After this you are prompted to complete the commandwith the required and the optional parameters. For the optional parameters you can simply pressenter without giving a value.

The example below is the equivalent of `phonebook add name=Test addr=8*33 type=pptp`.To break of such incomplete command press Ctrl+G".

EXAMPLE:

=>phonebook addname=Test

addr=8*33

type=pptp

=>


16/198

16 / 198 3EC 16982 AAAA TCZZA Ed. 05

Direct FTP Access

The SpeedTouchtHome/Pro File SystemThe SpeedTouchHome/Pro permanent storage, further referred to as 'file system', exists ofnonvolatile memory responsible for storing, retrieving and maintaining theSpeedTouchHome/Pro software image(s) and configuration files.

The file system of the SpeedTouchHome/Pro is accessible via the FTP transport protocol. Thisallows to transfer the SpeedTouchHome/Pro software image(s) and/or configuration profile files.

Moreover, via FTP's quote site command you can execute CLI commands from the FTP prompt.

Proceed as indicated in the exmaple below to open an FTP session to the SpeedTouchHome/Profile system:

EXAMPLE:

/home/doejohn{1}$ftp 10.0.0.138Connected to 10.0.0.138

220 Inactivity timer = 120 seconds. Use site idle to change.

Name (10.0.0.138:doejohn):

331 SpeedTouch (00-90-D0-01-02-03) User doejohn OK. Password required.

Password : ######

330 OK

ftp>

SpeedTouchtHome/Pro File System Structure

The files system features a tiny multilevel directory structure with a single root node called 'root' andtwo leaf nodes called 'active' and 'dl'.

The 'root' contains next to the two subdirectories 'active' and 'dl' all necessary files for theSpeedTouchHome/Pro to boot correctly.

The 'active' subdirectory always contains the software image in execution. The 'active' subdirectorymay also contain one or more .ini configuration files. These files are created seperately via the CLIsave command (per command group) or as a complete set of configuration files via the web page'Save all' button or the CLI :config save command.

In other words, after each 'Save all', or config save call, the configuration files present in the 'active'subdirectory reflect the current configuration of the SpeedTouchHome/Pro.

The 'dl' directory contains the dormant software image, if present.


17/198

17 / 1983EC 16982 AAAA TCZZA Ed. 05

SpeedTouchtHome/Pro File System Access Rights

Following access rights apply on the file system:

" 'root'Directory

Listing of 'root' directory files (dir)" 'active'Subdirectory

Listing of 'active' subdirectory files (dir)

FTP (m)get of (multiple) 'active' subdirectory files

" 'dl'Subdirectory

Listing of 'dl' subdirectory files (dir)

FTP (m)get of (multiple) 'dl' subdirectory files

FTP (m)put of (multiple) 'dl' subdirectory files

FTP (m)delete of (multiple) 'dl' subdirectory files..

FTP File Transfer

To allow correct file transfers the transfer mode must be set to binary". Moreover, it is suggested toturn on the hashing option to be able to see how the file transfer proceeds:

EXAMPLE:

/home/doejohn{1}$ftp 10.0.0.138Connected to 10.0.0.138

220 Inactivity timer = 120 seconds. Use site idle to change.

Name (10.0.0.138:doejohn):

331 SpeedTouch (00-90-D0-01-02-03) User doejohn OK. Password required.

Password : ######330 OK

ftp>

ftp>bin200 TYPE is now 8-bit binary

ftp>

ftp>hash200Hash mark printing on (8192 byts/hash mark).

ftp>

Customization, Backup and Restore of Configuration Files

For more information on the possibilities of theAlcatel SpeedTouchHome/Pro, configurationfiles and file system, please check the Alcatel support pages at:

http://www.alcatel.com

http://www.alcateldsl.com

Or contact your local Alcatel Sales representative.


18/198

18 / 198 3EC 16982 AAAA TCZZA Ed. 05


19/198

19 / 1983EC 16982 AAAA TCZZA Ed. 05

AlcatelSpeedTouchHome/Pro

CLI Command Description


20/198

20 / 198 3EC 16982 AAAA TCZZA Ed. 05


21/198

1 ADSL Commands

21 / 1983EC 16982 AAAA TCZZA Ed. 05

1 ADSL CommandsThe adsl command group is only applicable to the SpeedTouchtHome/ProADSL/POTSvariants, NOT to the SpeedTouchtHome ISDN and SpeedTouchtPro ISDNADSL/ISDNvariants.

adsl (to access the ADSL level)

adsl configadsl load

adsl save


22/198

1 ADSL Commands

22 / 198 3EC 16982 AAAA TCZZA Ed. 05

adsl configShow/set theADSL/POTS configuration.

SYNTAX:

adsl config [opermode = ][maxbitspertoneUS = ]

[opermode] The operational mode of the SpeedTouchtHome/Pro modem.Choose between:G ansiG g.dmt_annex_aG g.liteG multimodeBy default the ADSL modem will start in multimode.

OPTIONAL

maxbitspertoneUS A number between 10 and 14 (bits per tone).

Represents the maximum number of bits whic hcan be allocated toeach ADSL DMT tone in the upstream direction.By default the modem will use up to 13 bits per tone.

OPTIONAL

EXAMPLE:

=>adsl config

ADSL configuration:

opermode = multimode

maxbitspertoneUS = 13

=>

RELATED COMMANDS:

adsl load Load saved or default ADSL configuration.adsl save Save current ADSL interface configuration.


23/198

1 ADSL Commands

23 / 1983EC 16982 AAAA TCZZA Ed. 05

adsl loadLoad saved or default ADSL configuration.

SYNTAX:

adsl load [{saved|defaults}]

adsl load Load saved ADSL configuration.

adsl load saved Load saved ADSL configuration.

adsl load defaults Load default ADSL configuration.


24/198

1 ADSL Commands

24 / 198 3EC 16982 AAAA TCZZA Ed. 05

adsl save

Save current ADSL configuration.

SYNTAX:

adsl save


25/198

2 ATMF Commands

25 / 1983EC 16982 AAAA TCZZA Ed. 05

2 ATMF CommandsThe atmf command group is only applicable to the SpeedTouchtHome/ProADSL/POTSvariants equipped with an ATMF25.6Mbps port.

atmf (to access the ATMF level)

atmf add

atmf config

atmf delete

atmf flushatmf list

atmf load

atmf save


26/198

2 ATMF Commands

26 / 198 3EC 16982 AAAA TCZZA Ed. 05

atmf addAdd a crossconnection between the ATMF25 interface and the WAN interface.

SYNTAX:

atmf add vpi = vci =

vpi A number between 0 and 7.Represents the Virtual Path identifier.

REQUIRED

vci A number between 0 and 511.Represents the Virtual Channel identifier.Use VCI=0 for a VP crossconnection.

REQUIRED

EXAMPLE:

=>atmf list

Current ATM-Forum cross-connections:

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 = 0VPI = 3 VCI = 0

VPI = 4 VCI = 0

VPI = 5 VCI = 0

VPI = 6 VCI = 0

VPI = 7 VCI = 0

=>

RELATED COMMANDS:

atmf delete Delete a crossconnection on the ATMF25 interface.atmf list Show current ATMF25 interface configuration.


27/198

2 ATMF Commands

27 / 1983EC 16982 AAAA TCZZA Ed. 05

atmf configShow/set theATMF25 interface configuration.

SYNTAX:

atmf config [status = ]

maxbitspertoneUS Let the SpeedTouchtHome/Pro assume that the physical link of theATMF connection is always enabled (on) or allow to check the pysicallink.By default the ATMF25 pysical link status will be assumed always tobe enabled (on), in which case the SpeedTouchtHome/Pro will not(never) be the source of F4/F5 AIS OAM cells.

OPTIONAL

EXAMPLE:

=>atmf config

ATM-Forum state = ON

=>


28/198

2 ATMF Commands

28 / 198 3EC 16982 AAAA TCZZA Ed. 05

atmf deleteDelete a crossconnection on the ATMF25 interface.

SYNTAX:

atmf delete vpi = vci =

vpi A number between 0 and 7.Represents the Virtual Path identifier.

REQUIRED

vci A number between 0 and 511.Represents the Virtual Channel identifier.Use VCI=0 for a VP crossconnection.

REQUIRED

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 = 4 VCI = 0

VPI = 5 VCI = 0

VPI = 6 VCI = 0

VPI = 7 VCI = 0

=>

RELATED COMMANDS:

atmf add Add a crossconnection on the ATMF25 interface.atmf list Show current ATMF25 interface configuration.


29/198

2 ATMF Commands

29 / 1983EC 16982 AAAA TCZZA Ed. 05

atmf flush

Flush complete ATMF25 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


=>atmf flush=>atmf list


=>

RELATED COMMANDS:

atmf load Load saved or default ATMF25 interface configuration.atmf save Save current ATMF25 interface configuration.


30/198

2 ATMF Commands

30 / 198 3EC 16982 AAAA TCZZA Ed. 05

atmf list

Show all current ATMF25 interface crossconnections .

SYNTAX:

atmf list

EXAMPLE OUTPUT:

=>atmf listCurrent ATM-Forum cross-connections:

VPI = 0 VCI = 35

VPI = 1 VCI = 0

VPI = 2 VCI = 0

VPI = 3 VCI = 0

VPI = 4 VCI = 0

VPI = 5 VCI = 0


=>

RELATED COMMANDS:

atmf add Add an ATMF25 interface crossconnection.

atmf delete Delete a crossconnection on the ATMF25 interface.


31/198

2 ATMF Commands

31 / 1983EC 16982 AAAA TCZZA Ed. 05

atmf loadLoad saved (or default) ATMF25 interface configuration.

SYNTAX:

atmf load [{saved|defaults}]

atmf load Load saved ATMF25 interface configuration.

atmf load saved Load saved ATMF25 interface configuration.

atmf load defaults Load default ATMF25 interface configuration.

RELATED COMMANDS:

atmf flush Flush complete ATMF25 interface configuration.atmf save Save current ATMF25 interface configuration.


32/198

2 ATMF Commands

32 / 198 3EC 16982 AAAA TCZZA Ed. 05

atmf save

Save current ATMF25 interface configuration.

SYNTAX:

atmf save

RELATED COMMANDS:

atmf flush Flush complete ATMF25 interface configuration.

atmf load Load saved or default ATMF25 interface configuration.


33/198

3 Bridge Commands

33 / 1983EC 16982 AAAA TCZZA Ed. 05

3 Bridge Commandsbridge (to access the Bridge level)

bridge config

bridge flush

bridge load

bridge macadd

bridge macdelete

bridge maclistbridge portadd

bridge portconfig

bridge portdelete

bridge portlist

bridge save


34/198

3 Bridge Commands

34 / 198 3EC 16982 AAAA TCZZA Ed. 05

bridge configShow/set bridge aging policy.

SYNTAX:

bridge config [age = ]

[age] A number between 10 and 100000 (seconds).Represents the lifetime of a dynamically learned MAC address.By default the aging timer is 300 seconds.

OPTIONAL

EXAMPLE:

=>bridge configAging : 300

=>bridge config age=600=>bridge config

Aging : 600=>


35/198

3 Bridge Commands

35 / 1983EC 16982 AAAA TCZZA Ed. 05

bridge flushFlush complete bridging configuration.


SYNTAX:

bridge flush

EXAMPLE:

=>bridge portlist

0 OBC state: forwarding

RX bytes: 75783 frames: 572

TX bytes: 82768372 frames: 341221 dropframes: 0

1 eth0 state: forwarding

RX bytes: 156344216 frames: 5899238


2 Br1 state: forwarding

vpi: 8 vci: 35 protocol: vc-muc

fcs: off compression: off



=>bridge flush=>bridge portlist





RX bytes: 156344216 frames: 5899238


=>

RELATED COMMANDS:

bridge load Load saved or default bridge configuration.

bridge save Save current bridge configuration.


36/198

3 Bridge Commands

36 / 198 3EC 16982 AAAA TCZZA Ed. 05

bridge loadLoad saved (or default) bridge configuration.

SYNTAX:

bridge load [{saved|defaults}]

bridge load Load saved bridge configuration.

bridge load saved Load saved bridge configuration.

bridge load defaults Load default bridge configuration.

RELATED COMMANDS:

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


37/198

3 Bridge Commands

37 / 1983EC 16982 AAAA TCZZA Ed. 05

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

SYNTAX:

bridge macadd port = hwaddr =

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, OBCff: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 port=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:08:c7:c3:5f:fc dynamic, eth0, 215 seconds

...

=>

RELATED COMMANDS:

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


38/198

3 Bridge Commands

38 / 198 3EC 16982 AAAA TCZZA Ed. 05

bridge macdeleteRemove a MAC address from the filtering database.

SYNTAX:

bridge macdelete hwaddr =

hwaddr The MAC address of the entry to delete. REQUIRED

EXAMPLE:

=>bridge maclist

00:90:d0:01:02:03 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, OBC00:80:9f:01:23:45 permanent, OBC




...

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

00:90:d0:01:02:03 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





...

=>

RELATED COMMANDS:

bridge macadd Add a static MAC address entry.

bridge maclist Show current filtering database.


39/198

3 Bridge Commands

39 / 1983EC 16982 AAAA TCZZA Ed. 05

bridge maclistShow current MAC address filtering database.

SYNTAX:

bridge maclist

EXAMPLE:

=>bridge maclist

00:90:d0:01:02:03 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 seconds00:50:8b:31:cc:aa dynamic, eth0, 379 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.


40/198

3 Bridge Commands

40 / 198 3EC 16982 AAAA TCZZA Ed. 05

bridge portaddCreate a bridge interface.

SYNTAX:

bridge portadd dest = [proto = {vcmux|llc}][vc_mux_fcs = {off|on}]

dest The destination address for the new interface.Typically a phonebook entry.

REQUIRED

[encaps] The type of encapsulation to be used for this bridge interface. Choosebetween:G llc/snapG vcmux

OPTIONAL

[vc_mux_fcs] Whether or not to include the Ethernet FCS in the packet header onthe WAN side. Choose between:G offG on

OPTIONAL

EXAMPLE:

=>bridge portlist





RX bytes: 156344216 frames: 5899238TX bytes: 75689 frames: 425 dropframes: 5558017

=>bridge portadd dest=Br1 proto=vc-mux vc_mux_fcs=on=>bridge portlist





RX bytes: 156344216 frames: 5899238




fcs: on compression: off

RX bytes: 0 frames: 0TX bytes: 0 frames: 0 dropframes: 0

=>

RELATED COMMANDS:

bridge portdelete Delete a bridge interface.

bridge portconfig Configure a bridge interface.

bridge portlist Show current bridge configuration.


41/198

3 Bridge Commands

41 / 1983EC 16982 AAAA TCZZA Ed. 05

bridge portconfigConfigure a bridge interface.

SYNTAX:

bridge portconfig port = [state = ]

port The name of the bridge interface to configure. REQUIRED

[state] The bridge portstate for this interface. Choose between:G disabledG learningG forwarding

OPTIONAL

EXAMPLE:=>bridge portlist





RX bytes: 156344216 frames: 5899238






TX bytes: 0 frames: 0 dropframes: 0=>bridge portconfig port=Br1 state=learning=>bridge portlist





RX bytes: 156344216 frames: 5899238


2 Br1 state: learning





=>

RELATED COMMANDS:

bridge portadd Create a bridge interface.

bridge portdelete Delete a bridge interface.

bridge portlist Show current bridge configuration.


42/198

3 Bridge Commands

42 / 198 3EC 16982 AAAA TCZZA Ed. 05

bridge portdeleteDelete a bridge interface.

bridge portdelete port =

port The name of the interface name to delete. REQUIRED

EXAMPLE:

=>bridge portlist





RX bytes: 156344216 frames: 5899238







=>bridge portdelete port=Br1=>bridge portlist





RX bytes: 156344216 frames: 5899238

TX bytes: 75689 frames: 425 dropframes: 5558017=>

RELATED COMMANDS:

bridge portadd Create a bridge interface.bridge portconfig Configure a bridge interface.bridge portlist Show current bridge configuration.


43/198

3 Bridge Commands

43 / 1983EC 16982 AAAA TCZZA Ed. 05

bridge portlistShow all current bridge interfaces.

SYNTAX:

bridge portlist

EXAMPLE:

=>bridge portlist





RX bytes: 156344216 frames: 5899238




fcs: off compression: off



=>

DESCRIPTION:

`RX bytes` indicates the number of Received bytes, `TX bytes the number of Transmitted bytes. OBCis short for On Board Controller and indicates the physical bridge port.

RELATED COMMANDS:

bridge portadd Create a bridge interface.bridge portconfig Configure a bridge interface.bridge portdelete Delete a bridge interface.


44/198

3 Bridge Commands

44 / 198 3EC 16982 AAAA TCZZA Ed. 05

bridge saveSave current bridge configuration.

SYNTAX:

bridge save

RELATED COMMANDS:

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


45/198

4 CIP Commands

45 / 1983EC 16982 AAAA TCZZA Ed. 05

4 CIP CommandsThe cip command group is only applicable to the SpeedTouchtPro, NOT to theSpeedTouchtHome .

cip (to access the CIP level)

cip flush

cip ifadd

cip ifdelete

cip iflistcip load

cip pvcadd

cip pvcdelete

cip pvclist

cip save


46/198

4 CIP Commands

46 / 198 3EC 16982 AAAA TCZZA Ed. 05

cip flushFlush complete CIP configuration.


SYNTAX:

cip flush

EXAMPLE:

=>cip iflist

cip0 addr = 172.16.0.5 mask = 255.255.255.0

hwaddr =

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.


47/198

4 CIP Commands

47 / 1983EC 16982 AAAA TCZZA Ed. 05

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

SYNTAX:

cip ifadd addr = [netmask = ][hwaddr = ]

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

netmask The LIS's subnetmask. OPTIONAL

hwaddr The ATM address (hardware address) of the entry. OPTIONAL

EXAMPLE:

=>cip iflist

cip1 addr = 172.16.0.5 mask = 255.255.255.0

hwaddr =



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

hwaddr =



cip0 addr = 172.16.1.1 mask = 255.255.255.0

hwaddr =inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0


=>

RELATED COMMANDS:

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


48/198

4 CIP Commands

48 / 198 3EC 16982 AAAA TCZZA Ed. 05

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

SYNTAX:

cip ifdelete addr =

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

hwaddr =



cip1 addr = 172.16.0.5 mask = 255.255.255.0hwaddr =



=>cip ifdelete addr=172.16.1.1=>cip iflist

cip1 addr = 172.16.0.5 mask = 255.255.255.0

hwaddr =



=>

RELATED COMMANDS:

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


49/198

4 CIP Commands

49 / 1983EC 16982 AAAA TCZZA Ed. 05

cip iflistShow current CIP configuration.

SYNTAX:

cip iflist

EXAMPLE OUTPUT:

=>cip iflistcip0 addr = 172.16.1.1 mask = 255.255.255.0

hwaddr =



cip1 addr = 172.16.0.5 mask = 255.255.255.0

hwaddr =

inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0inarp_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

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

=>cip iflist

cip0 addr = 200.200.200.138 mask = 255.255.255.0hwaddr =




hwaddr =




hwaddr =

inarp_reqs_in = 22 inarp_repl_in = 76 inarp_inv_in = 0inarp_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.


50/198

4 CIP Commands

50 / 198 3EC 16982 AAAA TCZZA Ed. 05

cip loadLoad saved (or default) CIP configuration.

Execute cip flush prior to cip load.

SYNTAX:

cip load [{saved|defaults}]

cip load Load saved CIP configuration.

cip load saved Load saved CIP configuration.

cip load defaults Load default CIP configuration.

RELATED COMMANDS:cip flush Flush complete CIP configuration.cip save Save current CIP configuration.


51/198

4 CIP Commands

51 / 1983EC 16982 AAAA TCZZA Ed. 05

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

SYNTAX:

cip pvcadd dest = [destaddr = ][mtu = ]

dest The destination address for the new interface.Typically a phonebook entry.

REQUIRED

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

[mtu] A number between 273 and 20000 (bytes).Represents the maximum AAL5 packet size for this connection.By default the mtu is 9180 bytes.

OPTIONAL

EXAMPLE:

=>cip pvclist

=>cip pvcadd dest=CIPPVC1 destaddr=172.16.1.2 mtu=546=>cip pvclist

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


52/198

4 CIP Commands

52 / 198 3EC 16982 AAAA TCZZA Ed. 05

cip pvcdeleteDelete a PVC ARP entry.

SYNTAX:

cip pvcdelete dest =

dest The destination address of the interface.Typically a phonebook entry.

REQUIRED

EXAMPLE:

=>cip pvclist



=>cip pvcdelete dest=CIPPVC1=>cip pvclist

=>

RELATED COMMANDS:

cip pvcadd Create a PVC ARP entry.

cip pvclist Show current PVC ARP entries.


53/198

4 CIP Commands

53 / 1983EC 16982 AAAA TCZZA Ed. 05

cip pvclistShow current PVC ARP entries.

SYNTAX:

cip pvclist

EXAMPLE OUTPUT:

=>cip pvclist



=>

EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:


hwaddr = A0:*.03



=>cip pvclistCIPPVC1 vpi = 6 vci = 99 dest_ip = 172.16.1.3




=>

RELATED COMMANDS:cip pvcdelete Delete a PVC ARP entry.cip pvcadd Create a PVC ARP entry.


54/198

4 CIP Commands

54 / 198 3EC 16982 AAAA TCZZA Ed. 05

cip saveSave current CIP configuration.

SYNTAX:

cip save

RELATED COMMANDS:

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


55/198

5 Config Commands

55 / 1983EC 16982 AAAA TCZZA Ed. 05

5 Config Commandsconfig (to access the Config level)

config erase

config flush

config load

config reset

config save


56/198

5 Config Commands

56 / 198 3EC 16982 AAAA TCZZA Ed. 05

config erasePhysically remove all saved configurations.

SYNTAX:

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.


57/198

5 Config Commands

57 / 1983EC 16982 AAAA TCZZA Ed. 05

config flushFlush complete current configuration without affecting saved configurations.

This combines all flush commands: atmf flush, bridge flush, cip flush, config flush, dhcp flush,dns flush, nat flush, phonebook flush, ppp flush, pptp flush, system flush and optionallyip

flush.

SYNTAX:

config flush [keep_ip = ]

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

OPTIONAL

RELATED COMMANDS:

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


58/198

5 Config Commands

58 / 198 3EC 16982 AAAA TCZZA Ed. 05

config loadLoad 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: atmfload, bridge load, cip load, dhcp load, dns load, nat load, phonebook load, ppp load,

pptp load, system load and optionallyip load.

SYNTAX:

config load [load_ip = ][config_set = {saved|defaults}]

[load_ip] Load IP settings (yes) or not (no).Not specifying thisd parameter preserves the current IP configuration.

OPTIONAL

[config_set] Load saved configuration (saved) or default configuration (defaults).Not specifying this parameter loads the saved configuration

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.


59/198

5 Config Commands

59 / 1983EC 16982 AAAA TCZZA Ed. 05

config resetFlush current runtime configuration and restore factory default configuration. Optionally theruntime, saved IP configuration can be preserved.

SYNTAX:

config reset [keep_ip = ]

[keep_ip] Keep IP settings (yes) or not (no).Not keeping the IP settings could cause lost IP connectivity in the LAN.

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.


60/198

5 Config Commands

60 / 198 3EC 16982 AAAA TCZZA Ed. 05

config saveSave all existing configurations and modifications entered by the user.

This combines all save commands: atmf save, bridge save, cip save, config save, dhcp save,dns save, ip save, nat save, phonebook save, ppp save, pptp save, and system save.

SYNTAX:

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.


61/198

6 DHCP Commands

61 / 1983EC 16982 AAAA TCZZA Ed. 05

6 DHCP Commandsdhcp add

dhcp client

dhcp clrstats

dhcp config

dhcp delete

dhcp flush

dhcp listdhcp load

dhcp policy

dhcp save

dhcp spoof

dhcp start

dhcp stats

dhcp status

dhcp stop

dhcp troff

dhcp tron


62/198

6 DHCP Commands

62 / 198 3EC 16982 AAAA TCZZA Ed. 05

dhcp addAssign a static IP address to a host in the local network. This address is allocated on a permanentbasis, and is excluded from the pool of addresses used by the SpeedTouchtHome/Pro DHCPserver.

SYNTAX:

dhcp add clientid = addr = [leasetime = ][hostname = ]

clientid The DHCP client's MAC address. REQUIRED

addr The IP address for this DHCP host. REQUIRED

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

Represents the preferred time the client wants to use an address.By default the leasetime is 7200 seconds (2 hours).Specifying -1 makes the lease permanent.

OPTIONAL

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

EXAMPLE:

=>dhcp 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 add clientid=01:23:45:67:89:ab addr=10.0.0.1 leastime=60 hostname=NewLease=>dhcp list

Leases:

Lease 0: 01:00:A0:24:AE:66:E1

Hostname = Default




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

Hostname = NewLease


expires in : 23 seclease is being used.


=>

RELATED COMMANDS:

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


63/198

6 DHCP Commands

63 / 1983EC 16982 AAAA TCZZA Ed. 05

dhcp clientSet the AutoDHCP client timeout in startup phase. Only applicable in AutoDHCP mode (Seedhcp policycommand).

SYNTAX:

dhcp client timeout =

timeout A number between 0 and 1814400 (seconds).Represents the time to look for another DHCP server.Specifying `1` will make the timeout infinite: theSpeedTouchtHome/Pro will remain client.By default the timeout is 20 seconds.

REQUIRED

EXAMPLE:

=>dhcp status

DHCP Server Status: Running

Current configuration:

Address Range: 10.0.0.1 ... 10.255.255.254

.......

Startup client parameters:

Timeout: 20 sec

Tracing: off

Memory usage:

Leases: total: 36, in use: 7 free: 80 %

=>dhcp client timeout=15=>dhcp status



Address Range: 10.0.0.1 ... 10.255.255.254

.......Startup client parameters:

Timeout: 15 sec

Tracing: off

Memory usage:


=>

RELATED COMMANDS:

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


64/198

6 DHCP Commands

64 / 198 3EC 16982 AAAA TCZZA Ed. 05

dhcp clrstatsClear SpeedTouchtHome/Pro DHCP server statistics.

SYNTAX:

dhcp clrstats

EXAMPLE:

=>dhcp stats

DHCP server statistics:

Corrupted packet recv : 0

DISCOVER : 9575

REQUEST : 121

DECLINE : 0

RELEASE : 0

INFORM : 13

Pure BOOTP REQUESTS : 2Other 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 clrstats=>dhcp stats

DHCP server statistics:


DISCOVER : 0

REQUEST : 0

DECLINE : 0

RELEASE : 0INFORM : 0

Pure BOOTP REQUESTS : 0

Other message types : 0

OFFERs sent : 0

ACKs sent : 0

NAKs sent : 0




=>

RELATED COMMANDS:

dhcp stats Show DHCP server statistics.


65/198

6 DHCP Commands

65 / 1983EC 16982 AAAA TCZZA Ed. 05

dhcp configSet SpeedTouchtHome/Pro DHCP server configuration.

Execute dhcp status to see the actual status and configuration.

SYNTAX:

dhcp config [beginrange = ][endrange = ][netmask = ][leasetime = ][gateway = ][dnsaddr = ]

beginrange The lowest IP address in the DHCP address range to use for leasing.Default value of this parameter is 10.0.0.1.

OPTIONAL

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

Default value of this parameter is 10.255.255.254.

OPTIONAL

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 dynamicallyallocated IP address.By default the leasetime is 2 hours (7200 seconds).Specifying -1 makes the lease permanent.

OPTIONAL

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 SpeedTouchtHome/Pro as DNS server.

OPTIONAL


66/198

6 DHCP Commands

66 / 198 3EC 16982 AAAA TCZZA Ed. 05

EXAMPLE:

=>dhcp status



Address Range: 10.0.0.1 ... 10.255.255.254

Netmask: 255.0.0.0Lease 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


Timeout: 15 secTracing: off

Memory usage:


=>dhcp server config beginrange=172.16.0.2endrange=172.16.0.122netmask=255.0.0.0leasetime=21600 gateway=172.16.0.1 dnsaddr=172.16.0.254

=>dhcp status



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







Timeout: 15 sec

Tracing: off

Memory usage:


=>

RELATED COMMANDS:

dhcp status Show current DHCP server configuration.


67/198

6 DHCP Commands

67 / 1983EC 16982 AAAA TCZZA Ed. 05

dhcp deleteDelete a DHCP lease.

SYNTAX:

dhcp delete index =

index The index number of the entry to be deleted.Execute dhcp list to see a list of the index numbers of all currentDHCP leases.

REQUIRED

EXAMPLE:

=>dhcp list

Leases:

Lease 0: 01:00:A0:24:AE:66:E1

Hostname = Default

ip address : 10.0.0.8expires in : 1 h, 16 min, 20 sec


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

Hostname = NewLease


expires in : 23 sec



=>dhcp delete index=1=>dhcp list

Leases:

Lease 0: 01:00:A0:24:AE:66:E1

Hostname = Default

ip address : 10.0.0.8expires in : 1 h, 15 min, 32 sec



=>

RELATED COMMANDS:

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


68/198

6 DHCP Commands

68 / 198 3EC 16982 AAAA TCZZA Ed. 05

dhcp flushFlush complete DHCP server configuration and dynamic leases.


SYNTAX:

dhcp flush

EXAMPLE:

=>dhcp 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.62Spoofed lease from 2: DHCP_SPOOF

Assigned (temporary) private ip address.

expires in: 1 min, 39 sec


Lease 0: 01:00:A0:24:AE:66:E1

Hostname = Default




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

Hostname = Tempo


never expires!



=>dhcp flush=>dhcp list

No active leases


=>

RELATED COMMANDS:

dhcp load Load saved or default DHCP server configuration and permanentleases.

dhcp save Save current DHCP server configuration and permanent leases.


69/198

6 DHCP Commands

69 / 1983EC 16982 AAAA TCZZA Ed. 05

dhcp listList current DHCP leases, indicated by their index number.

SYNTAX:

dhcp list

EXAMPLE OUTPUT:

=>dhcp listLeases:

Lease 2: 01:52:41:53:20:50:6D:C0:40:02:32:C0:01:01:00:00:00


expires in: 3 sec


Lease 3: 01:52:41:53:20:A0:1B:A7:EB:AD:3C:C0:01:01:00:00:00


expires in: 17 seclease is not being used.

Lease 5: 01:52:41:53:20:F0:90:8F:09:E1:35:BE:01:01:00:00:00


expires in: 55 sec


Lease 6: 01:52:41:53:20:30:F4:89:5F:9B:44:C0:01:01:00:00:00




Lease 1: 01:52:41:53:20:20:4D:0D:CB:03:40:C0:01:01:00:00:00


Spoofed lease from 2: DHCP_SPOOF

Assigned (temporary) private ip address.


lease is not being used.Lease 0: 01:00:A0:24:AE:66:E1

Hostname = Default


expires in: 1 h, 17 min, 21 sec


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

Hostname = Tempo


never expires!



=>

RELATED COMMANDS:

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


70/198

6 DHCP Commands

70 / 198 3EC 16982 AAAA TCZZA Ed. 05

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

SYNTAX:

dhcp load [{saved|defaults}]

dhcp load Load saved DHCP server configuration and permanent leases.

dhcp load saved Load saved DHCP server configuration and permanent leases.

dhcp load defaults Load default DHCP server configuration.

RELATED COMMANDS:

dhcp flush Flush current DHCP server configuration and dynamic leases.dhcp save Save DHCP server configuration and permanent leases.


71/198

6 DHCP Commands

71 / 1983EC 16982 AAAA TCZZA Ed. 05

dhcp policySet SpeedTouchtHome/Pro DHCP server policy.

SYNTAX:

dhcp policy [verifyfirst = ][trustclient = ][spoofing = ][client = ]

[verifyfirst] Probe the network for conflicting IP addresses before giving asuggested IP address to the requesting DHCP client (yes) or not (no).

OPTIONAL

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

OPTIONAL

[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 externalPPP connection having a specific IP address negotiation mechanism.DHCP replies are in turn generated by the DHCP server based on theIP address information received by the PPP link.

OPTIONAL

[client] Allow the SpeedTouchtHome/Pro DHCP server to present itself asDHCP client (AutoDHCP mode) at boot time and probe for anotherDHCP server on the network for some time before starting the DHCPserver (yes) or immediately start the DHCP server (no).

OPTIONAL

EXAMPLE:

=>dhcp status



.....

Policies:

Verify first:no

Trust client:yes

Spoofing: no


.....

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



.....Policies:

Verify first:yes

Trust client:no

Spoofing: yes

Start as client: no

.....

=>

RELATED COMMANDS:



72/198

6 DHCP Commands

72 / 198 3EC 16982 AAAA TCZZA Ed. 05

dhcp saveSave complete SpeedTouchtHome/Pro DHCP server configuration and permanent DHCP leases.

SYNTAX:

dhcp save

RELATED COMMANDS:

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

leases.


73/198

6 DHCP Commands

73 / 1983EC 16982 AAAA TCZZA Ed. 05

dhcp spoofSet DHCP spoofing parameters. Only applicable in case of a PPPtoDHCP Spoofing connection.(See dhcp policycommand).

SYNTAX:

dhcp spoof [failtime = ][errorlt = ][dodlt = ]

[failtime] A number between 0 and 1814400 (seconds).Represents the time to wait for a PPP link to successfully negotiate anIP address.This parameter determines how long the SpeedTouchtHome/Proshould try to set up a PPP connection before returning to normalDHCP mode, i.e. in case the PPP connection cannot be established

within the time lapse determined by failtime, theSpeedTouchtHome/Pro DHCP server will allocate an local privateIP address to the DHCP client.By default the failtime is 4 seconds.

OPTIONAL

[errorlt] A number between 0 and 1814400 (seconds).Represents the leasetime of the private address issued when a PPPlink fails.In case the PPP link fails after failtime has elapsed, this parameterdetermines how long the private DHCP lease must be maintainedbefore retrying to set up the PPP link again.By default the error lease time is 60 seconds.

OPTIONAL

[dodlt] A number between 0 and 1814400 (seconds).Represents the leasetime of the temporary private IP address in caseof a dialondemand PPP link.In case of a dialondemand PPP link, this parameter determines theinterval at which the the temporary DHCP lease must be maintainedbefore checking whether a public IP address negotiated by atriggered PPP link is available.By default the dialondemand lease time is 10 seconds.

OPTIONAL


74/198


75/198

6 DHCP Commands

75 / 1983EC 16982 AAAA TCZZA Ed. 05

dhcp startStart SpeedTouchtHome/Pro DHCP server.

SYNTAX:

dhcp start

EXAMPLE:

=>dhcp status

DHCP Server Status: Stopped


.....

=>dhcp start=>dhcp status

DHCP Server Status: Searching for server...


.....=>

=>dhcp status



.....

=>

RELATED COMMANDS:


dhcp stop Stop DHCP server.


76/198

6 DHCP Commands

76 / 198 3EC 16982 AAAA TCZZA Ed. 05

dhcp statsShow SpeedTouchtHome/Pro DHCP server statistics.

SYNTAX:

dhcp stats

EXAMPLE OUTPUT:

=>dhcp statsDHCP server statistics:


DISCOVER : 9575

REQUEST : 121

DECLINE : 0

RELEASE : 0

INFORM : 13

Pure BOOTP REQUESTS : 2Other message types : 0

OFFERs sent : 9552

ACKs sent : 121

NAKs sent : 0




=>

DESCRIPTION:

Corrupted packet recv Indicates the number of corrupted packets (not complaint to RFC2131) werereceived 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 DHCPservers.

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


77/198

6 DHCP Commands

77 / 1983EC 16982 AAAA TCZZA Ed. 05

ACKs sent Indicates the number of ACKnowledgement replies were sent to successfullyconfigured DHCP clients.

NAKs sent Indicates the number of NotAcKnowledgement replies were sent to wronglyconfigured 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 aresent by the SpeedTouchtHome/Pro DHCP server to verify whether the IP addressis already in use on the LAN or not. (dhcp server policyverifyfirst=yes)

Second DHCP serverseen

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

RELATED COMMANDS:

dhcp clrstats Clear DHCP server statistics.


78/198

6 DHCP Commands

78 / 198 3EC 16982 AAAA TCZZA Ed. 05

dhcp statusShow current DHCP server configuration.

SYNTAX:

dhcp status

EXAMPLE:

=>dhcp statusDHCP Server Status: Client


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

Verify first:no

Trust client:yes

Spoofing: no







Timeout: 20 sec

Tracing: off

Memory usage:


=>

RELATED COMMANDS:

dhcp stop Stop DHCP server.

dhcp start Start DHCP server.dhcp policy Set DHCP server policy.dhcp spoof Set spoofing parameters.


79/198

6 DHCP Commands

79 / 1983EC 16982 AAAA TCZZA Ed. 05

dhcp stopStop SpeedTouchtHome/Pro DHCP server.

SYNTAX:

dhcp stop

EXAMPLE:

=>dhcp status



.....

=>dhcp stop=>dhcp status

DHCP Server Status: Stopped


.....=>

RELATED COMMANDS:

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


80/198

6 DHCP Commands

80 / 198 3EC 16982 AAAA TCZZA Ed. 05

dhcp troffDisable verbose console logging. No debug traces are generated anymore.

SYNTAX:

dhcp troff

EXAMPLE:

=>dhcp status



.....

Tracing: on

.....

=>dhcp troff=>dhcp status

DHCP Server Status: RunningCurrent configuration:

.....

Tracing: off

.....

=>

RELATED COMMANDS:


dhcp tron Enable verbose console logging.


81/198

6 DHCP Commands

81 / 1983EC 16982 AAAA TCZZA Ed. 05

dhcp tronEnable verbose console logging. Debug traces are generated.

SYNTAX:

dhcp tron

EXAMPLE:

=>dhcp status



.....

Tracing: off

.....

=>dhcp tron=>dhcp status

DHCP Server Status: RunningCurrent configuration:

.....

Tracing: on

.....

=>

RELATED COMMANDS:

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


82/198


83/198

7 DNS Commands

83 / 1983EC 16982 AAAA TCZZA Ed. 05

7 DNS Commandsdns (to access the DNS level)

dns add

dns clear

dns clrstats

dns delete

dns domain

dns flushdns fwdadd

dns fwddelete

dns fwdlist

dns fwdtable

dns list

dns load

dns nslookup

dns save

dns start

dns stats

dns status

dns stopdns toutfwd

dns troff

dns tron


84/198

7 DNS Commands

84 / 198 3EC 16982 AAAA TCZZA Ed. 05

dns addAdd a static DNS entry for IP hosts who do not reveal their hostname in the DHCP request, or evenworse, not support DHCP.

SYNTAX:

dns add hostname = [addr = ]

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

[addr] The IP address of the host (without mask).In case this parameter is not specified the hostname applies to theSpeedTouchtHome/Pro itself.

OPTIONAL

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

Total Table Size: 73 entries

Amount used: 3 (4%)

=>dns add hostname=FTP_Server addr=10.0.0.7=>dns list




1 TestHost 10.0.0.140

2 HTTP_Server 10.0.0.83 FTP_Server 10.0.0.7


Amount used: 4 (5%)

=>

RELATED COMMANDS:

dns list List current DNS entries.dns delete Delete a DNS entry.


85/198

7 DNS Commands

85 / 1983EC 16982 AAAA TCZZA Ed. 05

dns clear

Delete current DNS entries.

SYNTAX:

dns clear

EXAMPLE:

=>dns list




1 TestHost 10.0.0.140


3 FTP_Server 10.0.0.7


Amount used: 4 (5%)=>dns clear=>dns list




Amount used: 0 (0%)

=>

RELATED COMMANDS:

dns list List current DNS entries.


86/198

7 DNS Commands

86 / 198 3EC 16982 AAAA TCZZA Ed. 05

dns clrstats

Clear DNS statistics.

SYNTAX:

dns clrstats

EXAMPLE:

=>dns stats

DNS Statistics:

Corrupted packets recv : 0

Local questions resolved : 0

Local neg answers sent : 4

Total DNS packets fwd : 0

External answers recv : 0

Fwd table full, discard : 0

Spurious answers : 0Unknown query types : 0

Total number of packets received : 4

=>dns clrstatsDNS statistics cleared.

=>dns stats

DNS Statistics:

Corrupted packets recv : 0

Local questions resolved : 0

Local neg answers sent : 0

Total DNS packets fwd : 0

External answers recv : 0

Fwd table full, discard : 0

Spurious answers : 0Unknown query types : 0

Total number of packets received : 0

=>

RELATED COMMANDS:

dns stats Show DNS server/forwarder statistics.


87/198

7 DNS Commands

87 / 1983EC 16982 AAAA TCZZA Ed. 05

dns delete

Delete a DNS entry.

SYNTAX:

dns delete index =

index The index number of the entry to be deleted.Execute dns list to see a list of the index numbers of all current DNSentries.

REQUIRED

EXAMPLE:

=>dns list




1 TestHost 10.0.0.1402 HTTP_Server 10.0.0.8



Amount used: 4 (5%)

=>dns delete index=2=>dns list




1 TestHost 10.0.0.140



Amount used: 3 (4%)

=>

RELATED COMMANDS:

dns add Add a static DNS entry.dns list List current DNS entries.


88/198

7 DNS Commands

88 / 198 3EC 16982 AAAA TCZZA Ed. 05

dns domainSet local DNS (sub)domain name.

SYNTAX:

dns domain domain =

domain The local DNS (sub)domain name. REQUIRED

EXAMPLE:

=>dns list




1 TestHost 10.0.0.140


3 FTP_Server 10.0.0.7Total Table Size: 73 entries

Amount used: 4 (5%)

=>dns domain domain=office.home.lan=>dns list

Domain: office.home.lan



1 TestHost 10.0.0.140




Amount used: 4 (5%)

RELATED COMMANDS:



89/198

7 DNS Commands

89 / 1983EC 16982 AAAA TCZZA Ed. 05

dns flush

Flush complete SpeedTouchtHome/Pro DNS server/forwarder configuration and static entries.


SYNTAX:

dns flush

EXAMPLE:

=>dns list



4* Z7V1D8 10.0.0.29


1 TestHost 10.0.0.140

2 Default 10.0.0.8

3 ftpserver 172.16.0.1Total Table Size: 73 entries

Amount used: 5 (6%)

=>dns flush=>dns list

Domain: lan


3* Z7V1D8 10.0.0.29


Amount used: 1 (1%)

=>

RELATED COMMANDS:

dns save Save current DNS server/forwarder configuration and static entries.

dns load Load saved or default DNS server/forwarder configuration and static entries.


90/198

7 DNS Commands

90 / 198 3EC 16982 AAAA TCZZA Ed. 05

dns fwdaddAdd a DNS forwarding entry. The entries in the forwarding list determine which DNS server shouldbe used for which PC. If an identification cannot be established within the local LAN , the request isforwarded to another DNS server, on another network (Internet/LAN to LAN connection). The

connection is negotiated within a PPP link.

SYNTAX:

dns fwdadd dns = src = mask = [direct = ]

dns The IP address of the (remote) DNS server. REQUIRED

src The source IP address (pool) of the host(s) using this DNS server. REQUIRED

mask The appropriate source IP (sub)netmask. REQUIRED

[direct] Determines whether DNS replies are sent directly back to the client(1) or relayed by the SpeedTouchtHome/Pro DHCP server's DNSforwarder (0) in case of PPPtoDHCP spoofing connections.

OPTIONAL

EXAMPLE:

=>dns fwdlist

DNS forwarding servers:

DNS SRC MASK Direct

10.0.0.138 10.0.0.2 255.255.255.0 yes

=>dns fwdadd dns=10.0.0.138 src10.0.0.3 mask=24 direct=1Dns forwarding server added.

=>dns fwdlist


DNS SRC MASK Direct

10.0.0.138 10.0.0.2 255.255.255.0 yes

10.0.0.138 10.0.0.3 255.255.255.0 yes

=>

RELATED COMMANDS:

dns fwddelete Delete a DNS forwarding entry.dns fwdlist Show current DNS forwarding entries.


91/198

7 DNS Commands

91 / 1983EC 16982 AAAA TCZZA Ed. 05

dns fwddeleteDelete a DNS forwarding entry.

SYNTAX:

dns fwddelete src = mask = [dns = ]

src The source IP address (pool) of the hosts to remove the entry for. REQUIRED

mask The source IP (sub)netmask. REQUIRED

[dns] The IP address of the (remote) DNS server (in case of multiple DNSserver entries).

OPTIONAL

EXAMPLE:

=>dns fwdlist


DNS SRC MASK Direct

10.0.0.138 10.0.0.0 255.255.255.0 yes

192.6.11.150 192.6.11.0 255.255.255.0 yes

=>dns fwddelete src192.6.11.0 mask=24 dns=192.6.11.150Dns forwarding server deleted.

=>dns fwdlist


DNS SRC MASK Direct

10.0.0.138 10.0.0.0 255.255.255.0 yes

=>

RELATED COMMANDS:

dns fwdadd Add a DNS forwarding entry.dns fwdlist Show current DNS forwarding entries.


92/198


93/198

7 DNS Commands

93 / 1983EC 16982 AAAA TCZZA Ed. 05

dns fwdtable

Show DNS forwarding table, i.e. list all curently unresolved DNS requests.

SYNTAX:

dns fwdtable

EXAMPLE OUTPUT:

=>dns fwdtableForwarding table:

Nr. Ip Address (port#): id(hex) (expiry) dns server tries

0 10.10.10.12 (54751): 8331 (13 sec) 10.10.10.112 1

Timeout: 15 seconds

Table size: 10

amount of table used: 1 (10%)

=>

RELATED COMMANDS:

dns fwdlist Show current DNS forwarding entries.


94/198

7 DNS Commands

94 / 198 3EC 16982 AAAA TCZZA Ed. 05

dns list

Show current DNS entries.

SYNTAX:

dns list

EXAMPLE OUTPUT:

=>dns listDomain: office.home.lan


4* Z7V1D8 10.0.0.29


1 TestHost 10.0.0.140

2 Default 10.0.0.8

3 ftpserver 172.16.0.1

Total Table Size: 73 entriesAmount used: 5 (6%)

=>

EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:

The SpeedTouchtHome/Pro is configured as DNS server.

=>dns listDomain: SpeedLAN.local



1 Server 10.10.1.1

2 Client 10.0.0.3

Total Table Size: 73 entriesAmount used: 3 (4%)

=>

RELATED COMMANDS:

dns add Add a static DNS entry.dns delete Delete a DNS entry (via its index number).


95/198


96/198

7 DNS Commands

96 / 198 3EC 16982 AAAA TCZZA Ed. 05

dns nslookupSearch the hostname (via a known IP address) or the IP address (via a known hostname) of a DNShost.

SYNTAX:

dns nslookup lookup =

lookup The DNS hostname or IP address to query. REQUIRED

EXAMPLE:

=>dns list



4* Z7V1D8 10.0.0.29


1 TestHost 10.0.0.1402 Default 10.0.0.8

3 ftpserver 172.16.0.1


Amount used: 5 (6%)

=>dns nslookup lookup=TestHostName: TestHost

Address: 10.0.0.140

=>dns nslookup lookup=10.0.0.29Name: Z7V1D8

Address: 10.0.0.29

=>

RELATED COMMANDS:



97/198

7 DNS Commands

97 / 1983EC 16982 AAAA TCZZA Ed. 05

dns save

Save current SpeedTouchtHome/Pro DNS server/forwarder configuration and static entries.

SYNTAX:

dns save

RELATED COMMANDS:

dns flush Flush complete DNS server/forwarder configuration and dynamicentries.



98/198


99/198


100/198

7 DNS Commands

100 / 198 3EC 16982 AAAA TCZZA Ed. 05

dns status

Show SpeedTouchtHome/Pro DNS server/forwarder configuration.

SYNTAX:

dns status

EXAMPLE OUTPUT:

=>dns status

DNS server status: Stopped

DNS table size : 73, in use: 4, free: 94 %

DNS forwarding table size : 10, in use: 0, free:100 %

DNS forwarding dns servers table size : 25, in use: 4, free:84 %

No dns cache.

Tracing: off

=>

RELATED COMMANDS:

dns flush Flush complete DNS server/forwarder configuration and dynamicentries.


dns save Save current DNS server/forwarder configuration and static entries.


101/198

7 DNS Commands

101 / 1983EC 16982 AAAA TCZZA Ed. 05

dns stopStop SpeedTouchtHome/Pro DNS server/forwarder.

SYNTAX:

dns stop

EXAMPLE:

=>dns status

DNS server status: Started




No dns cache.

Tracing: off

=>dns stop

DNS server stopped.=>dns status

DNS server status: Stopped




No dns cache.

Tracing: off

=>

RELATED COMMANDS:

dns status Show DNS server/forwarder configuration.

dns start Start DNS server/forwarder.


102/198

7 DNS Commands

102 / 198 3EC 16982 AAAA TCZZA Ed. 05

alcatel cli reference guide

Documents