All rights reserved. Passing on and copying of this
document, use and communication of its contents
not permitted without written authorization from Alcatel.
Welcome to the Alcatel SpeedTouch350i 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 SpeedTouch350i via its character based Command Line Interface.
Although the SpeedTouch350i 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
product:
Alcatel SpeedTouch350i
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
SpeedTouch350i 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
SpeedTouch350i 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 SpeedTouch350i
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 AGAA TCZZA Ed. 01
5 / 138
Page 6
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 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 7
Alcatel
SpeedTouch350i
CLI Navigation
3EC 16982 AGAA TCZZA Ed. 01
7 / 138
Page 8
8 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 9
Accessing the Command Line Interface
Endusers can access the Command Line Interface via a Telnet session. However, this requires that
TCP/IP connectivity exists between the host from which the Telnet session is opened and the
SpeedTouch350i.
Access via a Telnet Session
As soon a session to the CLI is opened, the SpeedTouch350i banner pops up, followed by the
CLI prompt.
In case the SpeedTouch350i is protected by a System password authentication will be required
before access is granted.
The following figure shows an example of the SpeedTouch350i banner after opening a Telnet
session and authentication.
Manipulation commands are commands that manipulate operations on the command line, for
example changing the command group, go to the beginning of the command line, go to the end of
the command line, etc.
Command group Navigation
From top level, you can change to a command group by executing the name of the desired
command group.
To obtain a list of all available command groups, execute help from the top level.
EXAMPLE:
=>help
Following command groups are available :
configsystemsoftwareipphonebook
pptpbridgeatmftddns
dhcp
=>
To return to top level, execute exit.
EXAMPLE:
=>phonebook
[phonebook]=>
[phonebook]=>exit
=>
10 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 11
The Help Command
Execute help from top level to list all available command groups for the SpeedTouch350i.
EXAMPLE
=>help
Following command groups are available :
configsystemsoftwareipphonebook
pptpbridgeatmftddns
dhcp
=>
(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 :
listadddeletesaveflush
loadautolisthelpexit
[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 :
listadddeletesaveflush
loadautolisthelpexit
=>
3EC 16982 AGAA TCZZA Ed. 01
11 / 138
Page 12
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.
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.
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 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 13
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 (
All CLI commands are commands that operate on, or configure, the SpeedTouch350i.
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 AGAA TCZZA Ed. 01
15 / 138
Page 16
Direct FTP Access
The SpeedTouch350i File System
The SpeedTouch350i permanent storage, further referred to as 'file system', exists of nonvolatile
memory responsible for storing, retrieving and maintaining the SpeedTouch350i software
image(s) and configuration files.
The file system of the SpeedTouch350i is accessible via the FTP transport protocol. This allows to
transfer the SpeedTouch350i 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 SpeedTouch350i 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>
SpeedTouch350i 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
SpeedTouch350i 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 SpeedTouch350i.
The 'dl' directory contains the dormant software image, if present.
16 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 17
SpeedTouch350i 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 SpeedTouch350i, 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.
bridge flushFlush complete bridge configuration.
bridge saveSave current bridge configuration.
24 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 25
1 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 macaddport = <name>
hwaddr = <hardwareaddress>
intfThe name of the bridge interface to add the MAC address for.REQUIRED
config (to access the Config level)
config erase
config flush
config load
config reset
config save
2 Config Commands
3EC 16982 AGAA TCZZA Ed. 01
33 / 138
Page 34
2 Config Commands
config erase
Physically remove all saved configurations.
SYNTAX:
config erase
RELATED COMMANDS:
config flushFlush complete runtime configuration.
config loadLoad complete saved or default configuration.
config resetFlush current and optionally restore default configuration.
config saveSave complete runtime configuration.
34 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 35
2 Config Commands
config flush
Flush complete current configuration without affecting saved configurations.
This combines all flush commands: bridge flush, dhcp flush, dns flush, phonebook 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 erasePhysically remove all saved configurations.
config loadLoad complete saved or default configuration.
config resetFlush current and optionally restore default configuration.
config saveSave current runtime configuration.
OPTIONAL
3EC 16982 AGAA TCZZA Ed. 01
35 / 138
Page 36
2 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: bridge
load, dhcp load, dns load, phonebook 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 erasePhysically remove all saved configurations.
config flushFlush complete runtime configuration.
config resetFlush current and optionally restore default configuration.
config saveSave current runtime configuration.
OPTIONAL
OPTIONAL
36 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 37
2 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 erasePhysically remove all saved configurations.
config flushFlush complete current configuration.
config loadLoad complete saved or default configuration.
config saveSave current runtime configuration.
OPTIONAL
3EC 16982 AGAA TCZZA Ed. 01
37 / 138
Page 38
2 Config Commands
config save
Save all existing configurations and modifications entered by the user.
This combines all save commands: bridge save, config save, dhcp save, dns save, ip save,
phonebook save, pptp save, and system save.
SYNTAX:
config save
RELATED COMMANDS:
config erasePhysically remove all saved configurations.
config flushFlush complete current configuration.
config loadLoad complete saved or default configuration.
config resetFlush current and optionally restore default configuration.
dhcp save
dhcp start
dhcp stats
dhcp status
dhcp stop
dhcp troff
dhcp tron
3EC 16982 AGAA TCZZA Ed. 01
39 / 138
Page 40
3 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 SpeedTouch350i DHCP server.
[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:
Lease0: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.
Hostname= Default
ip address : 10.0.0.8
expires in : 1 h, 15 min, 32 sec
lease is being used.
Lease1: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 deleteDelete a DHCP lease.
dhcp listShow current DHCP leases.
40 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 41
3 DHCP Commands
dhcp client
Set the AutoDHCP client timeout in startup phase. Only applicable in AutoDHCP mode (See
dhcp policy command).
SYNTAX:
dhcp clienttimeout = <number>
timeoutA number between 0 and 1814400 (seconds).
Represents the time to look for another DHCP server.
Specifying `1` will make the timeout infinite: the SpeedTouch350i
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 policySet DHCP policy.
dhcp startStart DHCP server.
dhcp statusShow current DHCP server configuration.
dhcp stopStop DHCP server.
3EC 16982 AGAA TCZZA Ed. 01
41 / 138
Page 42
3 DHCP Commands
dhcp clrstats
Clear SpeedTouch350i 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 statsShow DHCP server statistics.
42 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 43
dhcp config
Set SpeedTouch350i DHCP server configuration.
Execute dhcp status to see the actual status and configuration.
beginrangeThe lowest IP address in the DHCP address range to use for leasing.
Default value of this parameter is 10.0.0.1.
endrangeThe highest IP address in the DHCP address range to use for leasing.
Default value of this parameter is 10.255.255.254.
netmaskThe applicable netmask for the DHCP leases.OPTIONAL
leasetimeA 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.
gatewayThe IP address of the gateway for DHCP clients.OPTIONAL
dnsaddrThe IP address of the DNS server for DHCP clients.
Entering '0' sets the SpeedTouch 350i as DNS server.
OPTIONAL
OPTIONAL
OPTIONAL
OPTIONAL
3EC 16982 AGAA TCZZA Ed. 01
43 / 138
Page 44
3 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
[verifyfirst]Probe the network for conflicting IP addresses before giving a
OPTIONAL
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
OPTIONAL
not (no).
[spoofing]Do not use this parameter.OPTIONAL
[client]Allow the SpeedTouch350i DHCP server to present itself as DHCP
OPTIONAL
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 status
DHCP Server Status:Running
Current configuration:
.....
Policies:
Verify first:yes
Trust client:no
Spoofing: no
Start as client:no
.....
=>
RELATED COMMANDS:
dhcp statusShow current DHCP server configuration.
3EC 16982 AGAA TCZZA Ed. 01
49 / 138
Page 50
3 DHCP Commands
dhcp save
Save complete SpeedTouch350i DHCP server configuration and permanent DHCP leases.
SYNTAX:
dhcp save
RELATED COMMANDS:
dhcp flushFlush complete DHCP server configuration and dynamic leases
dhcp loadLoad saved or default DHCP server configuration and permanent
leases.
50 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 51
dhcp spoof
Do not use this command.
3 DHCP Commands
3EC 16982 AGAA TCZZA Ed. 01
51 / 138
Page 52
3 DHCP Commands
dhcp start
Start SpeedTouch350i 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:
.....
=>
RELATED COMMANDS:
dhcp statusShow current DHCP server configuration.
dhcp stopStop DHCP server.
52 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 53
dhcp stats
Show SpeedTouch350i 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
=>
3 DHCP Commands
DESCRIPTION:
Corrupted packet recv Indicates the number of corrupted packets (not complaint to RFC2131) were
received from the LAN.
DISCOVERIndicates 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.
REQUESTIndicates the number of DHCP address lease requests were received from the LAN.
DECLINEIndicates the number of DHCP address lease requests that were declined.
RELEASEIndicates the number of DHCP address release requests that were received from
DHCP clients.
INFORMIndicates the number of information requests that were received from DHCP clients.
Pure BOOTP requestsIndicates the number of BOOTP requests that were received from the LAN.
OFFERs sentIndicates the number of IP address offers were sent in reply to DHCP requests.
3EC 16982 AGAA TCZZA Ed. 01
53 / 138
Page 54
3 DHCP Commands
ACKs sentIndicates the number of ACKnowledgement replies were sent to successfully
configured DHCP clients.
NAKs sentIndicates the number of NotAcKnowledgement replies were sent to wrongly
configured DHCP clients.
Lease table got fullIndicates whether the maximum number of DHCP leases is reached or not.
Ping table got fullIndicates whether the history list of IP address pings got full or not. These pings are
sent by the SpeedTouch350i 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 clrstatsClear DHCP server statistics.
54 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 55
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:
dns addAdd a static DNS entry.
dns deleteDelete a DNS entry (via its index number).
70 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 71
4 DNS Commands
dns load
Load saved or default SpeedTouch350i DNS server configuration and static DNS entries.
Execute dns flush prior to dns load.
SYNTAX:
dns load[{saved|defaults}]
dns loadLoad saved bridge configuration.
dns load savedLoad saved bridge configuration.
dns load defaultsLoad default bridge configuration.
RELATED COMMANDS:
dns flushFlush complete DNS server configuration and static entries.
dns saveSave current DNS server configuration and static entries
3EC 16982 AGAA TCZZA Ed. 01
71 / 138
Page 72
4 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 nslookuplookup = <string>
lookupThe DNS hostname or IP address to query.REQUIRED
EXAMPLE:
=>dns list
Domain: office.home.lan
Nr.HostnameIP Address
4*Z7V1D810.0.0.29
0SpeedTouch*.*.*.*
1TestHost10.0.0.140
2Default10.0.0.8
3ftpserver172.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 listList current DNS entries.
72 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 73
4 DNS Commands
dns save
Save current SpeedTouch350i DNS server configuration and static entries.
SYNTAX:
dns save
RELATED COMMANDS:
dns flushFlush complete DNS server configuration and dynamic entries.
dns loadLoad saved or default DNS server configuration and static entries.
3EC 16982 AGAA TCZZA Ed. 01
73 / 138
Page 74
4 DNS Commands
dns start
Start SpeedTouch350i DNS server.
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 statusShow DNS server configuration.
dns stopStop DNS server.
74 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 75
dns stats
Show SpeedTouch350i DNS server statistics.
SYNTAX:
dns stats
EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
The SpeedTouch350i is configured as DNS server.
=>dns list
Domain: SpeedLAN.local
Nr.HostnameIP Address
0SpeedTouch*.*.*.*
1Server10.10.1.1
2Client10.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.
4 DNS Commands
RELATED COMMANDS:
dns clrstatsClear DNS server statistics.
3EC 16982 AGAA TCZZA Ed. 01
75 / 138
Page 76
4 DNS Commands
dns status
Show SpeedTouch350i DNS server 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: 0, free:100%
No dns cache.
Tracing: off
=>
RELATED COMMANDS:
dns flushFlush complete DNS server configuration and dynamic entries.
dns loadLoad saved or default DNS server configuration and static entries.
dns saveSave current DNS server configuration and static entries.
76 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 77
4 DNS Commands
dns stop
Stop SpeedTouch350i DNS server.
SYNTAX:
dns stop
EXAMPLE:
=>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: 0, free:100%
No dns cache.
Tracing: off
=>dns stop
DNS server stopped.
=>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: 0, free:100%
No dns cache.
Tracing: off
=>
RELATED COMMANDS:
dns statusShow DNS server configuration.
dns startStart DNS server.
3EC 16982 AGAA TCZZA Ed. 01
77 / 138
Page 78
4 DNS Commands
dns toutfwd
Set DNS forwarding timeout.
SYNTAX:
dns toutfwdtimeout = <number>
timeoutA number (seconds).
REQUIRED
Represents the query forwarding timeout.
This parameter determines how long the SpeedTouch350i DNS
server should try to contact a (remote) DNS server before
(temporarily) declaring the DNS requests unresolved.
By default the timeout is 15 seconds.
Current timeout: 15 seconds
Timeout set to: 20 seconds
=>dns fwdtable
Forwarding table:
Nr.Ip Address(port#):id(hex) (expiry)dns servertries
010.10.10.12(54751):8331(13 sec)10.10.10.1121
Timeout: 20 seconds
Table size: 10
amount of table used: 1 (10%)
=>
RELATED COMMANDS:
dns fwdtableShow DNS forwarding table.
dns fwdlistShow current DNS forwarding entries..
dns fwdaddAdd a DNS forwarding entry.
dns fwddeleteDelete a DNS forwarding entry.
78 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 79
4 DNS Commands
dns troff
Disable verbose console messaging. No debug traces are generated.
SYNTAX:
dns troff
EXAMPLE:
=>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: 0, free:100%
No dns cache.
Tracing: on
=>dns troff
=>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: 0, free:100%
No dns cache.
Tracing: off
=>
RELATED COMMANDS:
dns fwdtableShow DNS forwarding table.
dns fwdlistShow current DNS forwarding entries..
dns statusShow DNS server configuration.
dns tronEnable verbose console messaging.
3EC 16982 AGAA TCZZA Ed. 01
79 / 138
Page 80
4 DNS Commands
dns tron
Enable verbose console messaging. Debug traces are generated.
SYNTAX:
dns tron
EXAMPLE:
=>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: 0, free:100%
No dns cache.
Tracing: off
=>dns tron
Tracing on.
=>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: 0, free:100%
No dns cache.
Tracing: on
=>(CTRL + Q)
:Internet class type A request received from 10.0.0.10.
dnsd
dnsd:aa.aa.be is outside our domain: forward.
dnsd:forwarding request from 10.0.0.10 (1318,0x0001) to 138.203.68.61
(try=1): ’reply to ant’ mode.
:Internet class type A request received from 10.0.0.10.
dnsd
dnsd
:aa.aa.be is outside our domain: forward.
:forwarding request from 10.0.0.10 (1318,0x0001) to 138.203.68.11
dnsd
(try=2): ’reply to ant’ mode.
:forward answer from 138.203.68.11 to 10.0.0.10 (1318,0001).
dnsd
:Internet class type A request received from 10.0.0.10.
dnsd
:aa.aa.be.lan unknown: return error.
dnsd
.....
.
=>(CTRL + S)
RELATED COMMANDS:
dns fwdtableShow DNS forwarding table.
dns fwdlistShow current DNS forwarding entries..
dns statusShow DNS server configuration.
dns troffDisable verbose console messaging.
80 / 138
3EC 16982 AGAA TCZZA Ed. 01
Page 81
5IP Commands
ip (to access the IP level)
ip apadd
ip apdelete
ip aplist
ip arpadd
ip arpdelete
ip arplist
ip config
ip flush
5 IP Commands
ip ifconfig
ip iflist
ip load
ip ping
ip rtadd
ip rtdelete
ip rtlist
ip save
ip sendto
[firewalling]Enable (on) or disable (off) IP firewalling (master switch).
For security reasons this parameter is enabled per default.
It is strongly recommended never to disable the SpeedTouch350i
firewall.
[redirects]Do not use this parameter.OPTIONAL
[sourcerouting]Do not use this parameter.OPTIONAL
[ttl]Do not use this parameter.OPTIONAL
[fraglimit]Do not use this parameter.OPTIONAL
[defragmode]Do not use this parameter.OPTIONAL
OPTIONAL
3EC 16982 AGAA TCZZA Ed. 01
89 / 138
Page 90
5 IP Commands
ip flush
Flush complete IP configuration. Dynamic configurations (e.g. from PPP or CIP links) remain.
The flush command does not impact previously saved configurations.
As an ip flush causes all local IP connectivity to be deleted, do not execute this command during an
IP based local connection, e.g. a Telnet CLI session.