SPEED TOUCH
Home/Pro
CLI Reference Guide
ADSL Router Series
3EC 16982 AAAA TCZZA Ed. 05
Status
Released
2 / 198
Change Note
Short Title
BD F aa 39813
CD-RG STHome/Pro 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 AAAA TCZZA Ed. 05
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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents
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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3EC 16982 AAAA TCZZA Ed. 05
3 / 198
Contents
4 / 198
3EC 16982 AAAA TCZZA Ed. 05
Preface
Preface
Welcome to the Alcatel SpeedTouchHome/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 SpeedTouchHome/Pro via its character based Command Line Interface.
Although the SpeedTouchHome/Pro 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 SpeedTouch
products:
Alcatel SpeedTouchHome
Alcatel SpeedTouchHome ISDN
Alcatel SpeedTouchPro
Alcatel SpeedTouchPro 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 the
SpeedTouchHome/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 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
SpeedTouchHome/Pro 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 SpeedTouchHome/Pro
The syntax of the command with a description of each parameter
An example to demonstrate the use of the CLI command
A list of related CLI commands.
Part 3 : CLI Command Index
This part allows the user to look up a command alphabetically in its incomplete form.
3EC 16982 AAAA TCZZA Ed. 05
5 / 198
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 MacOS 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, decompile, reverse engineer, trace or otherwise analyze 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, resell, 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 / 198
3EC 16982 AAAA TCZZA Ed. 05
Alcatel
SpeedTouchHome/Pro
CLI Navigation
3EC 16982 AAAA TCZZA Ed. 05
7 / 198
8 / 198
3EC 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 is
opened and the SpeedTouchHome/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 SpeedTouchHome/Pro 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 SpeedTouchHome/Pro 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
* _____/__ / \\ ADSL Modem/Router
* _/ /\_____/___ \ Version R3.2
* // / \ /\ \
* _______//_______/ \ / _\/____ Copyright (c) 1999–2001 Alcatel
* / / \ \ / / / /\
* __/ / \ \ / / / / _\__
* / / / \_______\/ / / / / /\
* /_/______/___________________/ /________/ /___/ \
* \ \ \ ___________ \ \ \ \ \ /
* \_\ \ / /\ \ \ \ \___\/
* \ \/ / \ \ \ \ /
* \_____/ / \ \ \________\/
* /__________/ \ \ /
* \ _____ \ /_____\/
* \ / /\ \ /___\/
* /____/ \ \ /
* \ \ /___\/
* \____\/
*
–––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
=>
3EC 16982 AAAA TCZZA Ed. 05
9 / 198
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 (SpeedTouchHome):
=>help
Following command groups are available :
config system software ip phonebook
adsl pptp bridge atmf td
dns dhcp
=>
EXAMPLE (SpeedTouchPro):
=>help
Following command groups are available :
config system software ip phonebook
adsl nat cip ppp pptp
bridge atmf td dns dhcp
=>
To return to top level, execute exit.
EXAMPLE:
=>phonebook
[phonebook]=>
[phonebook]=>exit
=>
10 / 198
3EC 16982 AAAA TCZZA Ed. 05
The Help Command
Execute help from top level to list all available command groups for the SpeedTouchHome/Pro.
EXAMPLE
=>help
Following command groups are available :
config system software ip phonebook
adsl nat cip ppp pptp
bridge atmf td dns dhcp
dhcp dns td atmf mer
=>
(SpeedTouchPro):
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:
=>phonebook
[phonebook]=>
[phonebook]=>help
Following commands are available :
list add delete save flush
load autolist help exit
[phonebook]=>
Executing e.g. help phonebook from top level gives the same result as executing help from the
phonebook command group selection.
EXAMPLE:
=>phonebook help
Following commands are available :
list add delete save flush
load autolist help exit
=>
3EC 16982 AAAA TCZZA Ed. 05
11 / 198
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 the
syntax for the command.
EXAMPLE:
=>help phonebook add
add : Adds a phonebook entry
name=<string>
addr=<vp*vc>
type=<bridge|ppp|cip|pptp>
=>
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:
=>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 the
Command Line press "Ctrl+E".
In the following example, the first
indicates the position of the cursor after pressing "Ctrl+A", the
second the position of the cursor after pressing "Ctrl+E".
EXAMPLE:
=>list
Breaking off Commands
12 / 198
3EC 16982 AAAA TCZZA Ed. 05
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 `name =`. The command is
broken of and the user returns to the command line.
EXAMPLE:
[phonebook]=>add
name =
name =
name =
[phonebook]=>
Ctrl+G"
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:
=>phonebook
[phonebook]=>list
Name address type usage
Br1 8*35 bridge configured
Br2 8*36 bridge free
Br3 8*37 bridge free
Br4 8*38 bridge free
RELAY_PPP1 8*48 pptp configured
RELAY_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
CIPPVC3 8*82 cip free
CIPPVC4 8*83 cip free
↵)" to select and execute the retaken command.
[phonebook]=>
[phonebook]=>:phonebook list
3EC 16982 AAAA TCZZA Ed. 05
13 / 198
Command Line Interface Top Level Structure
The following command groups are available:
adsl (only applicable for the SpeedTouchHome/Pro ADSL/POTS variants)
atmf (only applicable for models equipped with an ATMF25.6Mbps port)
bridge
cip (only applicable for the SpeedTouchPro)
config
dhcp
dns
ip
nat (only applicable for the SpeedTouchPro)
phonebook
ppp (only applicable for the SpeedTouchPro)
pptp
software
system
td
14 / 198
3EC 16982 AAAA TCZZA Ed. 05
Command Line Interface Commands
All CLI commands are commands that operate on, or configure, the SpeedTouchHome/Pro.
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. phonebook list).
You can also execute the commands from the command group itself, using the reduced form of the
command (e.g. list at the phonebooke command group selection).
EXAMPLE:
=>phonebook autolist
8.35
8.36
=>phonebook
[phonebook]=>autolist
8.35
8.36
[firewall]=>
Instead of entering a completely builtup 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 `phonebook add name=Test addr=8*33 type=pptp`.
To break of such incomplete command press Ctrl+G".
EXAMPLE:
=>phonebook add
name=Test
addr=8*33
type=pptp
=>
3EC 16982 AAAA TCZZA Ed. 05
15 / 198
Direct FTP Access
The SpeedTouchHome/Pro File System
The SpeedTouchHome/Pro permanent storage, further referred to as 'file system', exists of
nonvolatile memory responsible for storing, retrieving and maintaining the
SpeedTouchHome/Pro software image(s) and configuration files.
The file system of the SpeedTouchHome/Pro is accessible via the FTP transport protocol. This
allows 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/Pro
file system:
EXAMPLE:
/home/doejohn{1}$ftp 10.0.0.138
Connected to 10.0.0.138
220 Inactivity timer = 120 seconds. Use ’site idle <secs>’ 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>
SpeedTouchHome/Pro File System Structure
The files system features a tiny multilevel directory structure with a single root node called 'root' and
two leaf nodes called 'active' and 'dl'.
The 'root' contains next to the two subdirectories 'active' and 'dl' all necessary files for the
SpeedTouchHome/Pro to boot correctly.
The 'active' subdirectory always contains the software image in execution. The 'active' subdirectory
may also contain one or more .ini configuration files. These files are created seperately via the CLI
save 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.
16 / 198
3EC 16982 AAAA TCZZA Ed. 05
SpeedTouchHome/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 to
turn on the hashing option to be able to see how the file transfer proceeds:
EXAMPLE:
/home/doejohn{1}$ftp 10.0.0.138
Connected to 10.0.0.138
220 Inactivity timer = 120 seconds. Use ’site idle <secs>’ 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>bin
200 TYPE is now 8-bit binary
ftp>
ftp>hash
200Hash mark printing on (8192 byts/hash mark).
ftp>
Customization, Backup and Restore of Configuration Files
For more information on the possibilities of the Alcatel SpeedTouchHome/Pro, configuration
files 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.
3EC 16982 AAAA TCZZA Ed. 05
17 / 198
18 / 198
3EC 16982 AAAA TCZZA Ed. 05
Alcatel
SpeedTouchHome/Pro
CLI Command Description
3EC 16982 AAAA TCZZA Ed. 05
19 / 198
20 / 198
3EC 16982 AAAA TCZZA Ed. 05
1 ADSL Commands
1 ADSL Commands
The adsl command group is only applicable to the SpeedTouchHome/Pro ADSL/POTS
variants, NOT to the SpeedTouchHome ISDN and SpeedTouchPro ISDN ADSL/ISDN
variants.
adsl (to access the ADSL level)
adsl config
adsl load
adsl save
3EC 16982 AAAA TCZZA Ed. 05
21 / 198
1 ADSL Commands
adsl config
Show/set the ADSL/POTS configuration.
SYNTAX:
adsl config [opermode = <ansi|g.dmt_annex_a|g.lite|multimode>]
[maxbitspertoneUS = <number{1014}>]
[opermode] The operational mode of the SpeedTouchHome/Pro modem.
Choose between:
ansi
g.dmt_annex_a
g.lite
multimode
By default the ADSL modem will start in multimode.
maxbitspertoneUS A number between 10 and 14 (bits per tone).
Represents the maximum number of bits whic hcan be allocated to
each ADSL DMT tone in the upstream direction.
By default the modem will use up to 13 bits per tone.
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.
OPTIONAL
OPTIONAL
22 / 198
3EC 16982 AAAA TCZZA Ed. 05
adsl load
Load 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.
1 ADSL Commands
3EC 16982 AAAA TCZZA Ed. 05
23 / 198
1 ADSL Commands
adsl save
Save current ADSL configuration.
SYNTAX:
adsl save
24 / 198
3EC 16982 AAAA TCZZA Ed. 05
2 ATMF Commands
2 ATMF Commands
The atmf command group is only applicable to the SpeedTouchHome/Pro ADSL/POTS
variants equipped with an ATMF25.6Mbps port.
atmf (to access the ATMF level)
atmf add
atmf config
atmf delete
atmf flush
atmf list
atmf load
atmf save
3EC 16982 AAAA TCZZA Ed. 05
25 / 198
2 ATMF Commands
atmf add
Add a crossconnection between the ATMF25 interface and the WAN interface.
SYNTAX:
atmf add vpi = <number {07}>
vci = <number {0511}>
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 crossconnection.
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
Current 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
VPI = 6 VCI = 0
VPI = 7 VCI = 0
=>
REQUIRED
REQUIRED
RELATED COMMANDS:
atmf delete Delete a crossconnection on the ATMF25 interface.
atmf list Show current ATMF25 interface configuration.
26 / 198
3EC 16982 AAAA TCZZA Ed. 05
atmf config
Show/set the ATMF25 interface configuration.
SYNTAX:
atmf config [status = <line|on>]
2 ATMF Commands
maxbitspertoneUS Let the SpeedTouchHome/Pro assume that the physical link of the
ATMF connection is always enabled (on) or allow to check the pysical
link.
By default the ATMF25 pysical link status will be assumed always to
be enabled (on), in which case the SpeedTouchHome/Pro will not
(never) be the source of F4/F5 AIS OAM cells.
EXAMPLE:
=>atmf config
ATM-Forum state = ON
=>
OPTIONAL
3EC 16982 AAAA TCZZA Ed. 05
27 / 198
2 ATMF Commands
atmf delete
Delete a crossconnection on the ATMF25 interface.
SYNTAX:
atmf delete vpi = <number {07}>
vci = <number {0511}>
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 crossconnection.
EXAMPLE:
=>atmf list
Current 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
VPI = 6 VCI = 0
VPI = 7 VCI = 0
=>atmf delete vpi=0 vci=35
=>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
=>
REQUIRED
REQUIRED
RELATED COMMANDS:
atmf add Add a crossconnection on the ATMF25 interface.
atmf list Show current ATMF25 interface configuration.
28 / 198
3EC 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
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 flush
=>atmf list
Current ATM-Forum cross-connections:
=>
2 ATMF Commands
RELATED COMMANDS:
atmf load Load saved or default ATMF25 interface configuration.
atmf save Save current ATMF25 interface configuration.
3EC 16982 AAAA TCZZA Ed. 05
29 / 198
2 ATMF Commands
atmf list
Show all current ATMF25 interface crossconnections .
SYNTAX:
atmf list
EXAMPLE OUTPUT:
=>atmf list
Current 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
VPI = 6 VCI = 0
VPI = 7 VCI = 0
=>
RELATED COMMANDS:
atmf add
atmf delete
Add an ATMF25 interface crossconnection.
Delete a crossconnection on the ATMF25 interface.
30 / 198
3EC 16982 AAAA TCZZA Ed. 05
atmf load
Load 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.
2 ATMF Commands
3EC 16982 AAAA TCZZA Ed. 05
31 / 198
2 ATMF Commands
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.
32 / 198
3EC 16982 AAAA TCZZA Ed. 05
3 Bridge Commands
bridge (to access the Bridge level)
bridge config
bridge flush
bridge load
bridge macadd
bridge macdelete
bridge maclist
bridge portadd
bridge portconfig
3 Bridge Commands
bridge portdelete
bridge portlist
bridge save
3EC 16982 AAAA TCZZA Ed. 05
33 / 198
3 Bridge Commands
bridge config
Show/set bridge aging policy.
SYNTAX:
bridge config [age = <number {10 100000}>]
[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.
EXAMPLE:
=>bridge config
Aging : 300
=>bridge config age=600
=>bridge config
Aging : 600
=>
OPTIONAL
34 / 198
3EC 16982 AAAA TCZZA Ed. 05
bridge flush
Flush complete bridging configuration.
The flush command does not impact previously saved configurations.
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
TX bytes: 75689 frames: 425 dropframes: 5558017
2 Br1 state: forwarding
vpi: 8 vci: 35 protocol: vc-muc
fcs: off compression: off
RX bytes: 75 frames: 12
TX bytes: 30246 frames: 91 dropframes: 0
=>bridge flush
=>bridge portlist
0 OBC state: forwarding
RX bytes: 75783 frames: 572
TX bytes: 82768372 frames: 341221 dropframes: 0
3 Bridge Commands
1 eth0 state: forwarding
RX bytes: 156344216 frames: 5899238
TX bytes: 75689 frames: 425 dropframes: 5558017
=>
RELATED COMMANDS:
bridge load Load saved or default bridge configuration.
bridge save Save current bridge configuration.
3EC 16982 AAAA TCZZA Ed. 05
35 / 198
3 Bridge Commands
bridge load
Load 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.
36 / 198
3EC 16982 AAAA TCZZA Ed. 05
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 port = <name>
hwaddr = <hardwareaddress>
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 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: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.
3EC 16982 AAAA TCZZA Ed. 05
37 / 198
3 Bridge Commands
bridge macdelete
Remove a MAC address from the filtering database.
SYNTAX:
bridge macdelete hwaddr = <hardwareaddress>
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.
38 / 198
3EC 16982 AAAA TCZZA Ed. 05
bridge maclist
Show current MAC address filtering database.
SYNTAX:
bridge maclist
EXAMPLE:
=>bridge maclist
00:90:d0:01:02:03 –– static, OBC
ff:ff:ff:ff:ff:ff –– static, OBC
01:80:c2:00:00:00 –– static, OBC
01:80:c2:00:00:01 –– static, OBC
...
01:80:c2:00:00:10 –– static, OBC
00:80:9f:24:ab:cf –– static, OBC
00:01:42:5f:7d:81 –– dynamic, eth0, 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
...
=>
3 Bridge Commands
RELATED COMMANDS:
bridge macadd Add a static MAC address entry.
bridge macdelete Delete a MAC address entry.
3EC 16982 AAAA TCZZA Ed. 05
39 / 198
3 Bridge Commands
bridge portadd
Create a bridge interface.
SYNTAX:
bridge portadd dest = <vp*vc|name>
[proto = {vcmux|llc}]
[vc_mux_fcs = {off|on}]
dest The destination address for the new interface.
Typically a phonebook entry.
[encaps] The type of encapsulation to be used for this bridge interface. Choose
between:
llc/snap
vcmux
[vc_mux_fcs] Whether or not to include the Ethernet FCS in the packet header on
the WAN side. Choose between:
off
on
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
TX bytes: 75689 frames: 425 dropframes: 5558017
=>bridge portadd dest=Br1 proto=vc-mux vc_mux_fcs=on
=>bridge portlist
0 OBC state: forwarding
RX bytes: 75783 frames: 572
TX bytes: 82768372 frames: 341221 dropframes: 0
REQUIRED
OPTIONAL
OPTIONAL
1 eth0 state: forwarding
RX bytes: 156344216 frames: 5899238
TX bytes: 75689 frames: 425 dropframes: 5558017
2 Br1
vpi: 8 vci: 35 protocol: vc-muc
fcs: on compression: off
RX bytes: 0 frames: 0
TX bytes: 0 frames: 0 dropframes: 0
=>
state: forwarding
RELATED COMMANDS:
bridge portdelete Delete a bridge interface.
bridge portconfig Configure a bridge interface.
bridge portlist Show current bridge configuration.
40 / 198
3EC 16982 AAAA TCZZA Ed. 05
3 Bridge Commands
bridge portconfig
Configure a bridge interface.
SYNTAX:
bridge portconfig port = <name>
[state = <{disabled|learning|forwarding}>]
port The name of the bridge interface to configure. REQUIRED
[state] The bridge portstate for this interface. Choose between:
disabled
learning
forwarding
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
TX bytes: 75689 frames: 425 dropframes: 5558017
2 Br1 state: forwarding
vpi: 8 vci: 35 protocol: vc-muc
fcs: on compression: off
RX bytes: 0 frames: 0
TX bytes: 0 frames: 0 dropframes: 0
=>bridge portconfig port=Br1 state=learning
=>bridge portlist
0 OBC state: forwarding
RX bytes: 75783 frames: 572
TX bytes: 82768372 frames: 341221 dropframes: 0
OPTIONAL
1 eth0 state: forwarding
RX bytes: 156344216 frames: 5899238
TX bytes: 75689 frames: 425 dropframes: 5558017
2 Br1 state: learning
vpi: 8 vci: 35 protocol: vc-muc
fcs: on compression: off
RX bytes: 0 frames: 0
TX bytes: 0 frames: 0 dropframes: 0
=>
RELATED COMMANDS:
bridge portadd
bridge portdelete
bridge portlist
3EC 16982 AAAA TCZZA Ed. 05
Create a bridge interface.
Delete a bridge interface.
Show current bridge configuration.
41 / 198
3 Bridge Commands
bridge portdelete
Delete a bridge interface.
bridge portdelete port = <name>
port The name of the interface name to delete. REQUIRED
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
TX bytes: 75689 frames: 425 dropframes: 5558017
2 Br1
vpi: 8 vci: 35 protocol: vc-muc
fcs: on compression: off
RX bytes: 0 frames: 0
TX bytes: 0 frames: 0 dropframes: 0
=>bridge portdelete port=Br1
=>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
TX bytes: 75689 frames: 425 dropframes: 5558017
=>
state: forwarding
RELATED COMMANDS:
bridge portadd Create a bridge interface.
bridge portconfig Configure a bridge interface.
bridge portlist Show current bridge configuration.
42 / 198
3EC 16982 AAAA TCZZA Ed. 05
bridge portlist
Show all current bridge interfaces.
SYNTAX:
bridge portlist
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
TX bytes: 75689 frames: 425 dropframes: 5558017
2 Br1 state: forwarding
vpi: 8 vci: 35 protocol: vc-muc
fcs: off compression: off
RX bytes: 75 frames: 12
TX bytes: 30246 frames: 91 dropframes: 0
=>
3 Bridge Commands
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.
RELATED COMMANDS:
bridge portadd Create a bridge interface.
bridge portconfig Configure a bridge interface.
bridge portdelete Delete a bridge interface.
3EC 16982 AAAA TCZZA Ed. 05
43 / 198
3 Bridge Commands
bridge save
Save current bridge configuration.
SYNTAX:
bridge save
RELATED COMMANDS:
bridge flush Flush complete bridge configuration.
bridge load Load saved or default bridge configuration.
44 / 198
3EC 16982 AAAA TCZZA Ed. 05
4 CIP Commands
The cip command group is only applicable to the SpeedTouchPro, NOT to the
SpeedTouchHome .
cip (to access the CIP level)
cip flush
cip ifadd
cip ifdelete
cip iflist
cip load
cip pvcadd
4 CIP Commands
cip pvcdelete
cip pvclist
cip save
3EC 16982 AAAA TCZZA Ed. 05
45 / 198
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
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.
46 / 198
3EC 16982 AAAA TCZZA Ed. 05
4 CIP Commands
cip ifadd
Create a CIP interface at the local side of the Logical IP Subnet (LIS).
SYNTAX:
cip ifadd addr = <ipaddress>
[netmask = <ipmask (dotted or cidr)>]
[hwaddr = <hwaddress>]
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 =
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
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
cip0 addr = 172.16.1.1 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
=>
RELATED COMMANDS:
cip ifdelete Delete a CIP interface.
cip ifadd Show current CIP configuration.
3EC 16982 AAAA TCZZA Ed. 05
47 / 198
4 CIP Commands
cip ifdelete
Delete a CIP interface at the local side of the Logical IP Subnet (LIS).
SYNTAX:
cip ifdelete addr = <ipaddress>
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 =
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
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 ifdelete addr=172.16.1.1
=>cip iflist
cip1 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
=>
RELATED COMMANDS:
cip ifadd Create a CIP interface.
cip iflist Show current CIP configuration.
48 / 198
3EC 16982 AAAA TCZZA Ed. 05
cip iflist
Show current CIP configuration.
SYNTAX:
cip iflist
EXAMPLE OUTPUT:
=>cip iflist
cip0 addr = 172.16.1.1 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
cip1 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
=>
4 CIP Commands
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.0
hwaddr =
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
hwaddr =
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
hwaddr =
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 AAAA TCZZA Ed. 05
49 / 198
4 CIP Commands
cip load
Load 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.
50 / 198
3EC 16982 AAAA TCZZA Ed. 05
4 CIP Commands
cip pvcadd
Create a PVC ARP entry for destinations which are not RFC 1577/RFC2225 compliant.
SYNTAX:
cip pvcadd dest = <vp*vc|name>
[destaddr = <ipaddress>]
[mtu = <number {273-20000}>]
dest The destination address for the new interface.
Typically a phonebook entry.
[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.
REQUIRED
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.
3EC 16982 AAAA TCZZA Ed. 05
51 / 198
4 CIP Commands
cip pvcdelete
Delete a PVC ARP entry.
SYNTAX:
cip pvcdelete dest = <name>
dest The destination address of the interface.
Typically a phonebook entry.
EXAMPLE:
=>cip pvclist
CIPPVC1
=>cip pvcdelete dest=CIPPVC1
=>cip pvclist
=>
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
52 / 198
3EC 16982 AAAA TCZZA Ed. 05
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
CIPPVC1 vpi = 6 vci = 99 dest_ip = 172.16.1.3
vpi = 8 vci = 80 dest_ip = 172.16.1.2
encaps = llc mtu = 546
hwaddr = 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
4 CIP Commands
CIPPVC2 vpi = 8 vci = 50 dest_ip = 200.200.200.14
encaps = llc mtu = 9180
=>
RELATED COMMANDS:
cip pvcdelete Delete a PVC ARP entry.
cip pvcadd Create a PVC ARP entry.
3EC 16982 AAAA TCZZA Ed. 05
53 / 198
4 CIP Commands
cip save
Save current CIP configuration.
SYNTAX:
cip save
RELATED COMMANDS:
cip flush Flush complete CIP configuration.
cip load Load saved or default CIP configuration.
54 / 198
3EC 16982 AAAA TCZZA Ed. 05
5 Config Commands
config (to access the Config level)
config erase
config flush
config load
config reset
config save
5 Config Commands
3EC 16982 AAAA TCZZA Ed. 05
55 / 198
5 Config Commands
config erase
Physically 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.
56 / 198
3EC 16982 AAAA TCZZA Ed. 05
5 Config Commands
config flush
Flush complete current configuration without affecting saved configurations.
This combines all flush commands: atmf flush, bridge flush, cip flush, config flush, dhcp flush,
dns flush, nat flush, phonebook flush, ppp flush, pptp flush, system flush and optionally ip
flush.
SYNTAX:
config flush [keep_ip = <{no|yes}>]
[keep_ip] Keep current IP configuration (yes) or not (no).
Not keeping the IP settings could cause lost IP connectivity in the LAN.
By default IP settings are preserved.
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 AAAA TCZZA Ed. 05
57 / 198
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 load, dns load, nat load, phonebook load, ppp load,
pptp load, system load and optionally ip load.
SYNTAX:
config load [load_ip = <{no|yes}>]
[config_set = {saved|defaults}]
[load_ip] Load IP settings (yes) or not (no).
Not specifying thisd parameter preserves the current IP configuration.
[config_set] Load saved configuration (saved) or default configuration (defaults).
Not specifying this parameter loads the saved configuration
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.
OPTIONAL
OPTIONAL
58 / 198
3EC 16982 AAAA TCZZA Ed. 05
5 Config Commands
config reset
Flush current runtime configuration and restore factory default configuration. Optionally the
runtime, saved IP configuration can be preserved.
SYNTAX:
config reset [keep_ip = <{no|yes}>]
[keep_ip] Keep IP settings (yes) or not (no).
Not keeping the IP settings could cause lost IP connectivity in the LAN.
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.
OPTIONAL
3EC 16982 AAAA TCZZA Ed. 05
59 / 198
5 Config Commands
config save
Save all existing configurations and modifications entered by the user.
This combines all save commands: atmf save, bridge save, cip save, config save, dhcp save,
dns save, 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.
60 / 198
3EC 16982 AAAA TCZZA Ed. 05
6 DHCP Commands
dhcp add
dhcp client
dhcp clrstats
dhcp config
dhcp delete
dhcp flush
dhcp list
dhcp load
dhcp policy
6 DHCP Commands
dhcp save
dhcp spoof
dhcp start
dhcp stats
dhcp status
dhcp stop
dhcp troff
dhcp tron
3EC 16982 AAAA TCZZA Ed. 05
61 / 198
6 DHCP Commands
dhcp 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 SpeedTouchHome/Pro DHCP
server.
SYNTAX:
dhcp add clientid = <clientid>
addr = <ipaddress>
[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 1814400 (seconds).
OPTIONAL
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.
[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
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 delete Delete a DHCP lease.
dhcp list Show current DHCP leases.
62 / 198
3EC 16982 AAAA TCZZA Ed. 05
6 DHCP Commands
dhcp client
Set the AutoDHCP client timeout in startup phase. Only applicable in AutoDHCP mode (See
dhcp policy command).
SYNTAX:
dhcp client timeout = <number>
timeout A number between 0 and 1814400 (seconds).
Represents the time to look for another DHCP server.
Specifying `1` will make the timeout infinite: the
SpeedTouchHome/Pro will remain client.
By default the timeout is 20 seconds.
EXAMPLE:
=>dhcp 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 client timeout=15
=>dhcp 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 policy Set DHCP policy.
dhcp start Start DHCP server.
dhcp status Show current DHCP server configuration.
dhcp stop Stop DHCP server.
3EC 16982 AAAA TCZZA Ed. 05
63 / 198
6 DHCP Commands
dhcp clrstats
Clear SpeedTouchHome/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 : 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 clrstats
=>dhcp 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 stats Show DHCP server statistics.
64 / 198
3EC 16982 AAAA TCZZA Ed. 05
dhcp config
Set SpeedTouchHome/Pro DHCP server configuration.
Execute dhcp status to see the actual status and configuration.
SYNTAX:
dhcp config [beginrange = <ipaddress>]
[endrange = <ipaddress>]
[netmask = <ipaddress>]
[leasetime = <number>]
[gateway = <{ipaddress|0}>]
[dnsaddr = <{ipaddress|0}>]
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).
Specifying -1 makes the lease permanent.
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 Home/Pro as DNS server.
OPTIONAL
OPTIONAL
OPTIONAL
OPTIONAL
3EC 16982 AAAA TCZZA Ed. 05
65 / 198
6 DHCP Commands
EXAMPLE:
=>dhcp 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 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 status Show current DHCP server configuration.
66 / 198
3EC 16982 AAAA TCZZA Ed. 05
dhcp delete
Delete a DHCP lease.
SYNTAX:
dhcp delete index = <number>
6 DHCP Commands
index The index number of the entry to be deleted.
Execute dhcp list to see a list of the index numbers of all current
DHCP leases.
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.
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 delete index=1
=>dhcp 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 add Add a DHCP lease manually.
dhcp list Show current DHCP leases.
3EC 16982 AAAA TCZZA Ed. 05
67 / 198
6 DHCP Commands
dhcp flush
Flush complete DHCP server configuration and dynamic leases.
The flush command does not impact previously saved configurations.
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.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 flush
=>dhcp list
No active leases
Total size of table: 36, in use: 0 free: 100 %
=>
RELATED COMMANDS:
dhcp load Load saved or default DHCP server configuration and permanent
leases.
dhcp save Save current DHCP server configuration and permanent leases.
68 / 198
3EC 16982 AAAA TCZZA Ed. 05
dhcp list
List current DHCP leases, indicated by their index number.
SYNTAX:
dhcp list
EXAMPLE OUTPUT:
=>dhcp 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 add Add a DHCP lease manually.
dhcp delete Delete a DHCP lease.
dhcp flush Delete complete DHCP server configuration and dynamic leases.
3EC 16982 AAAA TCZZA Ed. 05
69 / 198
6 DHCP Commands
dhcp load
Load 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.
70 / 198
3EC 16982 AAAA TCZZA Ed. 05
dhcp policy
Set SpeedTouchHome/Pro DHCP server policy.
SYNTAX:
dhcp 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 SpeedTouchHome/Pro 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 status
DHCP Server Status: Running
Current configuration:
.....
Policies:
Verify first:no
Trust client:yes
Spoofing: no
Start as client: yes
.....
=>dhcp policy verifyfirst=yes trustclient=no spoofing=yes client=no
=>dhcp status
DHCP Server Status: Running
Current configuration:
.....
Policies:
Verify first:yes
Trust client:no
Spoofing: yes
Start as client: no
.....
=>
OPTIONAL
OPTIONAL
OPTIONAL
OPTIONAL
RELATED COMMANDS:
dhcp status Show current DHCP server configuration.
3EC 16982 AAAA TCZZA Ed. 05
71 / 198
6 DHCP Commands
dhcp save
Save complete SpeedTouchHome/Pro DHCP server configuration and permanent DHCP leases.
SYNTAX:
dhcp save
RELATED COMMANDS:
dhcp flush Flush complete DHCP server configuration and dynamic leases
dhcp load Load saved or default DHCP server configuration and permanent
leases.
72 / 198
3EC 16982 AAAA TCZZA Ed. 05
6 DHCP Commands
dhcp spoof
Set DHCP spoofing parameters. Only applicable in case of a PPPtoDHCP Spoofing connection.
(See dhcp policy command).
SYNTAX:
dhcp spoof [failtime = <number>]
[errorlt = <number>]
[dodlt = <number>]
[failtime] A number between 0 and 1814400 (seconds).
Represents the time to wait for a PPP link to successfully negotiate an
IP address.
This parameter determines how long the SpeedTouchHome/Pro
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
SpeedTouchHome/Pro 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 1814400 (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 1814400 (seconds).
Represents the leasetime of the temporary private IP address in case
of a dialondemand PPP link.
In case of a dialondemand 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 dialondemand lease time is 10 seconds.
OPTIONAL
OPTIONAL
OPTIONAL
3EC 16982 AAAA TCZZA Ed. 05
73 / 198
6 DHCP Commands
EXAMPLE:
=>dhcp 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 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 policy Set DHCP server policy.
dhcp status Show current DHCP server configuration.
74 / 198
3EC 16982 AAAA TCZZA Ed. 05
dhcp start
Start SpeedTouchHome/Pro DHCP server.
SYNTAX:
dhcp start
EXAMPLE:
=>dhcp status
DHCP Server Status: Stopped
Current configuration:
.....
=>dhcp start
=>dhcp status
DHCP Server Status: Searching for server...
Current configuration:
.....
=>
=>dhcp status
DHCP Server Status: Running
Current configuration:
.....
=>
6 DHCP Commands
RELATED COMMANDS:
dhcp status Show current DHCP server configuration.
dhcp stop Stop DHCP server.
3EC 16982 AAAA TCZZA Ed. 05
75 / 198
6 DHCP Commands
dhcp stats
Show SpeedTouchHome/Pro DHCP server statistics.
SYNTAX:
dhcp stats
EXAMPLE OUTPUT:
=>dhcp 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.
76 / 198
3EC 16982 AAAA TCZZA Ed. 05
6 DHCP Commands
ACKs sent Indicates the number of ACKnowledgement replies were sent to successfully
configured DHCP clients.
NAKs sent Indicates the number of NotAcKnowledgement 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 SpeedTouchHome/Pro 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 clrstats Clear DHCP server statistics.
3EC 16982 AAAA TCZZA Ed. 05
77 / 198
6 DHCP Commands
dhcp status
Show current DHCP server configuration.
SYNTAX:
dhcp status
EXAMPLE:
=>dhcp 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 stop Stop DHCP server.
dhcp start Start DHCP server.
dhcp policy Set DHCP server policy.
dhcp spoof Set spoofing parameters.
78 / 198
3EC 16982 AAAA TCZZA Ed. 05
dhcp stop
Stop SpeedTouchHome/Pro DHCP server.
SYNTAX:
dhcp stop
EXAMPLE:
=>dhcp status
DHCP Server Status: Running
Current configuration:
.....
=>dhcp stop
=>dhcp status
DHCP Server Status: Stopped
Current configuration:
.....
=>
6 DHCP Commands
RELATED COMMANDS:
dhcp start Start DHCP server.
dhcp status Show current DHCP server configuration.
3EC 16982 AAAA TCZZA Ed. 05
79 / 198
6 DHCP Commands
dhcp troff
Disable verbose console logging. No debug traces are generated anymore.
SYNTAX:
dhcp troff
EXAMPLE:
=>dhcp status
DHCP Server Status: Running
Current configuration:
.....
Tracing: on
.....
=>dhcp troff
=>dhcp status
DHCP Server Status: Running
Current configuration:
.....
Tracing: off
.....
=>
RELATED COMMANDS:
dhcp status Show current DHCP server configuration.
dhcp tron Enable verbose console logging.
80 / 198
3EC 16982 AAAA TCZZA Ed. 05
dhcp tron
Enable verbose console logging. Debug traces are generated.
SYNTAX:
dhcp tron
EXAMPLE:
=>dhcp status
DHCP Server Status: Running
Current configuration:
.....
Tracing: off
.....
=>dhcp tron
=>dhcp status
DHCP Server Status: Running
Current configuration:
.....
Tracing: on
.....
=>
6 DHCP Commands
RELATED COMMANDS:
dhcp status Show current DHCP server configuration
dhcp troff Disable verbose console logging.
3EC 16982 AAAA TCZZA Ed. 05
81 / 198
6 DHCP Commands
82 / 198
3EC 16982 AAAA TCZZA Ed. 05
7 DNS Commands
dns (to access the DNS level)
dns add
dns clear
dns clrstats
dns delete
dns domain
dns flush
dns fwdadd
dns fwddelete
7 DNS Commands
dns fwdlist
dns fwdtable
dns list
dns load
dns nslookup
dns save
dns start
dns stats
dns status
dns stop
dns toutfwd
dns troff
dns tron
3EC 16982 AAAA TCZZA Ed. 05
83 / 198
7 DNS Commands
dns add
Add a static DNS entry for IP hosts who do not reveal their hostname in the DHCP request, or even
worse, not support DHCP.
SYNTAX:
dns add hostname = <string>
[addr = <ipaddress>]
hostname The name of the IP host (without the (sub)domain name). REQUIRED
[addr] The IP address of the host (without mask).
In case this parameter is not specified the hostname applies to the
SpeedTouchHome/Pro itself.
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
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:
dns list List current DNS entries.
dns delete Delete a DNS entry.
84 / 198
3EC 16982 AAAA TCZZA Ed. 05
dns clear
Delete current DNS entries.
SYNTAX:
dns clear
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 clear
=>dns list
Domain: business.lan
Nr. Hostname IP Address
Total Table Size: 73 entries
Amount used: 0 (0%)
=>
7 DNS Commands
RELATED COMMANDS:
dns list List current DNS entries.
3EC 16982 AAAA TCZZA Ed. 05
85 / 198
7 DNS Commands
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 : 0
Unknown query types : 0
Total number of packets received : 4
=>dns clrstats
DNS 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 : 0
Unknown query types : 0
Total number of packets received : 0
=>
RELATED COMMANDS:
dns stats Show DNS server/forwarder statistics.
86 / 198
3EC 16982 AAAA TCZZA Ed. 05
dns delete
Delete a DNS entry.
SYNTAX:
dns delete index = <number>
7 DNS Commands
index The index number of the entry to be deleted.
Execute dns list to see a list of the index numbers of all current DNS
entries.
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 delete index=2
=>dns list
Domain: business.lan
Nr. Hostname IP Address
0 SpeedTouch *.*.*.*
1 TestHost 10.0.0.140
3 FTP_Server 10.0.0.7
Total Table Size: 73 entries
Amount used: 3 (4%)
=>
REQUIRED
RELATED COMMANDS:
dns add Add a static DNS entry.
dns list List current DNS entries.
3EC 16982 AAAA TCZZA Ed. 05
87 / 198
7 DNS Commands
dns domain
Set local DNS (sub)domain name.
SYNTAX:
dns domain domain = <string>
domain The local DNS (sub)domain name. REQUIRED
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 domain domain=office.home.lan
=>dns list
Domain: office.home.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%)
RELATED COMMANDS:
dns list List current DNS entries.
88 / 198
3EC 16982 AAAA TCZZA Ed. 05
7 DNS Commands
dns flush
Flush complete SpeedTouchHome/Pro DNS server/forwarder configuration and static entries.
The flush command does not impact previously saved configurations.
SYNTAX:
dns flush
EXAMPLE:
=>dns list
Domain: office.home.lan
Nr. Hostname IP Address
4* Z7V1D8 10.0.0.29
0 SpeedTouch *.*.*.*
1 TestHost 10.0.0.140
2 Default 10.0.0.8
3 ftpserver 172.16.0.1
Total Table Size: 73 entries
Amount used: 5 (6%)
=>dns flush
=>dns list
Domain: lan
Nr. Hostname IP Address
3* Z7V1D8 10.0.0.29
Total Table Size: 73 entries
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 stat
ic entries.
3EC 16982 AAAA TCZZA Ed. 05
89 / 198
7 DNS Commands
dns fwdadd
Add a DNS forwarding entry. The entries in the forwarding list determine which DNS server should
be used for which PC. If an identification cannot be established within the local LAN , the request is
forwarded to another DNS server, on another network (Internet/LAN to LAN connection). The
connection is negotiated within a PPP link.
SYNTAX:
dns fwdadd dns = <ipaddress>
src = <ipaddress>
mask = <ipmask (dotted or cidr)>
[direct = <number>]
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 SpeedTouchHome/Pro DHCP server's DNS
forwarder (0) in case of PPPtoDHCP spoofing connections.
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 src–10.0.0.3 mask=24 direct=1
Dns forwarding server added.
=>dns fwdlist
DNS forwarding servers:
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.
OPTIONAL
90 / 198
3EC 16982 AAAA TCZZA Ed. 05
7 DNS Commands
dns fwddelete
Delete a DNS forwarding entry.
SYNTAX:
dns fwddelete src = <ipaddress>
mask = <ipmask (dotted or cidr)>
[dns = <ipaddress>]
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 DNS
server entries).
EXAMPLE:
=>dns fwdlist
DNS forwarding servers:
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 src–192.6.11.0 mask=24 dns=192.6.11.150
Dns forwarding server deleted.
=>dns fwdlist
DNS forwarding servers:
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.
OPTIONAL
3EC 16982 AAAA TCZZA Ed. 05
91 / 198
7 DNS Commands
dns fwdlist
Show current DNS forwarding entries.
SYNTAX:
dns fwdlist
EXAMPLE OUTPUT:
=>dns fwdlist
DNS forwarding servers:
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
=>
RELATED COMMANDS:
dns fwdadd Add a DNS forwarding entry.
dns fwddelete Delete a DNS forwarding entry.
dns fwdtable Show DNS forwarding table.
92 / 198
3EC 16982 AAAA TCZZA Ed. 05
7 DNS Commands
dns fwdtable
Show DNS forwarding table, i.e. list all curently unresolved DNS requests.
SYNTAX:
dns fwdtable
EXAMPLE OUTPUT:
=>dns fwdtable
Forwarding 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.
3EC 16982 AAAA TCZZA Ed. 05
93 / 198
7 DNS Commands
dns list
Show current DNS entries.
SYNTAX:
dns list
EXAMPLE OUTPUT:
=>dns list
Domain: office.home.lan
Nr. Hostname IP Address
4* Z7V1D8 10.0.0.29
0 SpeedTouch *.*.*.*
1 TestHost 10.0.0.140
2 Default 10.0.0.8
3 ftpserver 172.16.0.1
Total Table Size: 73 entries
Amount used: 5 (6%)
=>
EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
The SpeedTouchHome/Pro is configured as DNS server.
=>dns list
Domain: SpeedLAN.local
Nr. Hostname IP Address
0 SpeedTouch *.*.*.*
1 Server 10.10.1.1
2 Client 10.0.0.3
Total Table Size: 73 entries
Amount used: 3 (4%)
=>
RELATED COMMANDS:
dns add Add a static DNS entry.
dns delete Delete a DNS entry (via its index number).
94 / 198
3EC 16982 AAAA TCZZA Ed. 05
7 DNS Commands
dns load
Load saved or default SpeedTouchHome/Pro DNS server/forwarder configuration and static
DNS entries.
Execute dns flush prior to dns load.
SYNTAX:
dns load [{saved|defaults}]
dns load Load saved bridge configuration.
dns load saved Load saved bridge configuration.
dns load defaults Load default bridge configuration.
RELATED COMMANDS:
dns flush Flush complete DNS server/forwarder configuration and static
entries.
dns save Save current DNS server/forwarder configuration and static entries
3EC 16982 AAAA TCZZA Ed. 05
95 / 198
7 DNS Commands
dns nslookup
Search the hostname (via a known IP address) or the IP address (via a known hostname) of a DNS
host.
SYNTAX:
dns nslookup lookup = <string>
lookup The DNS hostname or IP address to query. REQUIRED
EXAMPLE:
=>dns list
Domain: office.home.lan
Nr. Hostname IP Address
4* Z7V1D8 10.0.0.29
0 SpeedTouch *.*.*.*
1 TestHost 10.0.0.140
2 Default 10.0.0.8
3 ftpserver 172.16.0.1
Total Table Size: 73 entries
Amount used: 5 (6%)
=>dns nslookup lookup=TestHost
Name: TestHost
Address: 10.0.0.140
=>dns nslookup lookup=10.0.0.29
Name: Z7V1D8
Address: 10.0.0.29
=>
RELATED COMMANDS:
dns list List current DNS entries.
96 / 198
3EC 16982 AAAA TCZZA Ed. 05
7 DNS Commands
dns save
Save current SpeedTouchHome/Pro DNS server/forwarder configuration and static entries.
SYNTAX:
dns save
RELATED COMMANDS:
dns flush Flush complete DNS server/forwarder configuration and dynamic
entries.
dns load Load saved or default DNS server/forwarder configuration and stat
ic entries.
3EC 16982 AAAA TCZZA Ed. 05
97 / 198
7 DNS Commands
dns start
Start SpeedTouchHome/Pro DNS server/forwarder.
SYNTAX:
dns start
EXAMPLE:
=>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
=>dns start
DNS server started.
=>dns status
DNS server status: Started
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 status Show DNS server/forwarder configuration.
dns stop Stop DNS server/forwarder.
98 / 198
3EC 16982 AAAA TCZZA Ed. 05
dns stats
Show SpeedTouchHome/Pro DNS server/forwarder statistics.
SYNTAX:
dns stats
EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
The SpeedTouchHome/Pro is configured as DNS server.
=>dns list
Domain: SpeedLAN.local
Nr. Hostname IP Address
0 SpeedTouch *.*.*.*
1 Server 10.10.1.1
2 Client 10.0.0.3
Total Table Size: 73 entries
Amount used: 3 (4%)
=>dns stats
DNS Statistics:
Corrupted packets recv : 0
Local questions resolved : 1
Local neg answers sent : 0
Total DNS packets fwd : 0
External answers recv : 0
Fwd table full, discard : 0
Spurious answers : 0
Unknown query types : 0
Total number of packets received : 1
=>(Ping Client.SpeedLAN.local)
=>(CTRL + Q)
dnsd: Internet class type A request received from 10.10.1.1.
dnsd: Client.SpeedLAN.local
dnsd: Client.SpeedLAN.local
=>(Ping Server.SpeedLAN.local)
dnsd: Internet class type A request received from 10.10.1.1.
dnsd: Server.SpeedLAN.local
dnsd: Server.SpeedLAN.local
=>(CTRL + S)
=>dns stats
DNS Statistics:
Corrupted packets recv : 0
Local questions resolved : 3
Local neg answers sent : 0
Total DNS packets fwd : 0
External answers recv : 0
Fwd table full, discard : 0
Spurious answers : 0
Unknown query types : 0
Total number of packets received : 3
=>
found in local database.
resolved into 10.0.0.3.
found in local database.
resolved into 10.0.0.3.
7 DNS Commands
RELATED COMMANDS:
dns clrstats Clear DNS server/forwarder statistics.
3EC 16982 AAAA TCZZA Ed. 05
99 / 198
7 DNS Commands
dns status
Show SpeedTouchHome/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 dynamic
entries.
dns load Load saved or default DNS server/forwarder configuration and stat
ic entries.
dns save Save current DNS server/forwarder configuration and static entries.
100 / 198
3EC 16982 AAAA TCZZA Ed. 05
Loading...