About this Document ...................................................................................................................................................... 9
Accessing the Command Line Interface .................................................................................................................... 11
Basic Navigation and Manipulation..............................................................................................................................12
Command Line Interface Top Level Structure ........................................................................................................ 17
Command Line Interface Commands ........................................................................................................................ 18
Configuration Profile Files and the CLI......................................................................................................................20
Direct FTP Access ..........................................................................................................................................................22
adsl info ............................................................................................................................................................................. 27
atm oam status ................................................................................................................................................................ 32
dhcp server clear............................................................................................................................................................. 82
dhcp server config...........................................................................................................................................................83
dhcp server flush .............................................................................................................................................................84
dhcp server policy...........................................................................................................................................................85
dhcp server spoof ...........................................................................................................................................................86
dhcp server start............................................................................................................................................................. 87
dhcp server stats .............................................................................................................................................................88
dhcp server stop ............................................................................................................................................................. 90
dhcp server lease add..................................................................................................................................................... 91
dhcp server lease delete................................................................................................................................................93
dhcp server lease flush................................................................................................................................................... 94
dhcp server lease list......................................................................................................................................................95
dhcp server pool add .....................................................................................................................................................96
dhcp server pool config ................................................................................................................................................. 98
dhcp server pool delete...............................................................................................................................................100
dhcp server pool flush .................................................................................................................................................101
dhcp server pool list.....................................................................................................................................................102
E-SIT-CTC-20021203-0003 v1.0
3
DNS Commands .......................................................................................... 103
dns add ............................................................................................................................................................................104
dns clear ..........................................................................................................................................................................105
dns clrstats......................................................................................................................................................................106
dns delete........................................................................................................................................................................107
dns domain .....................................................................................................................................................................108
dns flush...........................................................................................................................................................................109
dns fwdadd......................................................................................................................................................................110
dns fwddelete.................................................................................................................................................................111
dns fwdlist .......................................................................................................................................................................112
dns fwdtable ...................................................................................................................................................................113
dns list..............................................................................................................................................................................114
dns nslookup ..................................................................................................................................................................115
dns start...........................................................................................................................................................................116
dns stats...........................................................................................................................................................................117
dns status ........................................................................................................................................................................118
dns stop...........................................................................................................................................................................119
dns toutfwd ....................................................................................................................................................................120
dns troff...........................................................................................................................................................................121
dns tron...........................................................................................................................................................................122
env get .............................................................................................................................................................................128
env set .............................................................................................................................................................................130
Eth Commands............................................................................................. 133
eth ifconfig ......................................................................................................................................................................134
eth iflist ............................................................................................................................................................................135
firewall chain list ............................................................................................................................................................146
firewall rule list ..............................................................................................................................................................154
IP Commands ............................................................................................... 157
ip apadd ...........................................................................................................................................................................158
ip apdelete.......................................................................................................................................................................160
ip aplist.............................................................................................................................................................................161
ip arpadd .........................................................................................................................................................................162
ip arpdelete.....................................................................................................................................................................163
ip arplist...........................................................................................................................................................................164
ip config ...........................................................................................................................................................................165
ip flush..............................................................................................................................................................................168
ip ifconfig .........................................................................................................................................................................169
ip iflist...............................................................................................................................................................................170
ip ping...............................................................................................................................................................................171
ip rtadd ............................................................................................................................................................................172
ip rtdelete .......................................................................................................................................................................174
ip rtlist..............................................................................................................................................................................175
ip sendto..........................................................................................................................................................................176
MER Commands .......................................................................................... 187
mer flush .........................................................................................................................................................................188
mer ifadd .........................................................................................................................................................................189
mer ifattach.....................................................................................................................................................................190
mer ifconfig.....................................................................................................................................................................191
mer ifdelete ....................................................................................................................................................................193
mer ifdetach....................................................................................................................................................................194
mer iflist ..........................................................................................................................................................................195
nat list ..............................................................................................................................................................................209
phonebook list ...............................................................................................................................................................217
qosbook list ....................................................................................................................................................................250
System Commands...................................................................................... 259
system clearpassword ..................................................................................................................................................260
system config..................................................................................................................................................................261
system flush ....................................................................................................................................................................262
system reboot................................................................................................................................................................263
system reset ...................................................................................................................................................................264
system setpassword......................................................................................................................................................265
Supported Internet Protocol (IP) Protocol Names ..............................................................................................289
Supported TCP/UDP Port Names............................................................................................................................290
Supported ICMP Type Names ...................................................................................................................................293
8
E-SIT-CTC-20021203-0003 v1.0
About this Document
Introduction
Welcome to the SpeedTouch
TM
500Series Command Line Interface (CLI) Reference Guide!
For the Service Provider this Reference Guide aims to give a concise and practical document for creating a customized
configuration profile file, based on the SpeedTouch
configure the SpeedTouch
For the fastidious user this Reference Guide aims to give a handbook for advanced and detailed configuration and troubleshooting of the SpeedTouch
TM
500Series and PC(s).
TM
500Series via its character based Command Line Interface.
This CLI Reference Guide covers the CLI commands of the following DSL SpeedTouch
•SpeedTouch
•SpeedTouch
•SpeedTouch
•SpeedTouch
•SpeedTouch
TM
TM
TM
TM
TM
510
510i
530
570
570i
TM
500Series CLI command set, to be used by the end-user to
TM
products:
Contents
The Reference Guide consists of two main parts:
•CLI Navigation
The CLI navigation is decribed in this chapter. Here the user is familiarised with the SpeedTouch
TM
500Series CLI.
It describes general manipulations to navigate through and to perform some operations on the CLI.
•CLI Command Description
The other chapters describe all the available CLI commands of the SpeedTouch
TM
500Series per command group
and in alphabetical order.
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 SpeedTouch
TM
500Series
•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.
E-SIT-CTC-20021203-0003 v1.0
9
Trademarks
The following trademarks are used in this document:
•SpeedTouch
TM
is a trademark of THOMSON
•Netscape‚ and Netscape Navigator‚ are registered trademarks of Netscape Communications Corporation
•Windows and Internet Explorer are trademarks of Microsoft Corporation
•Apple‚ and Mac‚OS are registered trademarks of Apple Computer Inc.
•UNIX‚ is a registered trademark of UNIX System Laboratories, Inc.
•Ethernet is a trademark of Xerox Corporation.
Other products may be trademarks or registered trademarks of their respective manufacturers.
Updates
Due to the continuous evolution of DSL technology, existing products are regularly upgraded.
For more information on the latest technological innovations, software upgrades, and documents, please visit the
SpeedTouch
TM
web site at:
http://www.speedtouch.com
Directive
Unless expressly and unambiguously approved by THOMSON, you may not:
•disassemble, de-compile, 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 THOMSON, except to the extent that
this restriction is expressly prohibited by local law;
•copy, rent, loan, re-sell, sublicense, or otherwise transfer or distribute the equipment to others;
•modify, adapt or create a derivative work of the equipment;
•remove from any copies of the equipment any product identification, copyright or other notices;
•disseminate performance information or analysis (including, without limitation, benchmarks) from any source
relating to the equipment.
•Such acts not expressly approved by THOMSON will result in the loss of product warranty and will invalidate the
user's authority to operate this equipment.
10
E-SIT-CTC-20021203-0003 v1.0
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
SpeedTouch
As soon a session to the CLI is opened, the SpeedTouch
In case the SpeedTouch
granted.
The following figure shows an example of the SpeedTouch
authentication.
500Series banner pops up, followed by the CLI prompt.
TM
500Series is protected by a System password, authentication will be required before access is
TM
500Series banner after opening a session and
E-SIT-CTC-20021203-0003 v1.0
11
Basic 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.
The example below shows every possible CLI command group for the SpeedTouch
=>help
Following commands are available :
help: Displays this help information
menu: Displays menu
?: Displays this help information
exit: Exits this shell.
..: Exits group selection.
saveall: Saves current configuration.
510 variants equipped with a single Ethernet port and the
TM
510 variants and the SpeedTouchTM530
TM
570
To return to top level, or to descend one level (in case of nested command groups) execute .. .
EXAMPLE:
=>phonebook
[phonebook]=>
[phonebook]=>..
=>
12
E-SIT-CTC-20021203-0003 v1.0
The Help Command
Execute help or ? from top level to list all available command groups for the SpeedTouch
EXAMPLE for the SpeedTouch
=>help
Following commands are available :
help: Displays this help information
menu: Displays menu
?: Displays this help information
exit: Exits this shell.
..: Exits group selection.
saveall : Saves current configuration.
You can execute the help or ? command from each command group selection. This results in a list of the available
commands (and nested command groups, if available) in this particular command group.
EXAMPLE:
=>firewall
[firewall]=>
[firewall]=>?
Following commands are available :
tron: Enables verbose console messaging.
troff: Disables verbose console messaging.
match: Defines an ip packet match.
assign: Assign a chain to an entry point.
list: Shows a list of all the hooks with the chain attached.
flush: Clears all hooks. If a hook is provided, that hook is cleared.
Following command groups are available :
chainrule
[firewall]=>
As both help and ? have the exact same functionality in the SpeedTouch
TM
500Series CLI, the help command may always
be equally replaced by the ? command.
Executing e.g. help firewall from top level gives the same result as executing help from the firewall command group
selection.
E-SIT-CTC-20021203-0003 v1.0
13
EXAMPLE:
=>firewall help
Following commands are available :
tron: Enables verbose console messaging.
troff: Disables verbose console messaging.
match: Defines an ip packet match.
assign: Assign a chain to an entry point.
list: Shows a list of all the hooks with the chain attached.
flush: Clears all hooks. If a hook is provided, that hook is cleared.
Following command groups are available :
chainrule
=>
14
E-SIT-CTC-20021203-0003 v1.0
Entering help followed by a specific command, e.g. help firewall assign (starting from top level) or help assign (executed
from the the firewall command group selection) results in a description of the syntax for the command.
EXAMPLE:
=>help firewall assign
Assign a chain to an entry point.
Syntax: assign hook = <{input|sink|forward|source|output}> chain = <string>
parameters :
hook = <{input|sink|forward|source|output}>
Name of hook to assign chain to.
chain = <string>
Name of chain to use.
=>
Executing help all will generate the complete listing of all available CLI commands with syntax description.
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 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.
For example, pressing a and TAB at the firewall command group selection results in the full assign command being
completed. Entering firewall a and pressing the TAB key from top level gives the same result.
EXAMPLE:
=>firewall
[firewall]=>"a+TAB"
[firewall]=>assign
Going to the beginning or end of the Command Line
To go to ...Press ...
the beginning of the Command LineCTRL+A
the end of the Command LineCTRL+E
E-SIT-CTC-20021203-0003 v1.0
15
Breaking off Commands
Press CTRL+G to break off a command. This can be useful in a situation where a user is prompted to enter a value
which he does not know and wants to quit the command. Instead of being prompted over and over again for the same
value, this allows to quit the command and return to the command line prompt.
In the example below CTRL+G is pressed after the third prompt chain =
To select previously executed commands, use the UP and DOWN ARROW keys to select a previously executed
command. Press ENTER to execute the selected command.
The following command groups are always available:
•atm
•bridge
•cip
•config
•dhcp
•dns
•env
•firewall
•ip
•ipoa
•mer
•nat
•phonebook
•ppp
•pptp
•qosbook
•software
•system
•td
Following command groups are optional:
•adsl (only applicable for the SpeedTouch
SpeedTouch
TM
570i ADSL/ISDN variants)
TM
510, SpeedTouchTM570 ADSL/POTS, and the SpeedTouchTM510i and
•eth (only applicable for models equipped with a single 10/100Base-T Ethernet port)
•upnp (only applicable for the SpeedTouch
•wireless (only applicable for the SpeedTouch
TM
510 and SpeedTouchTM530 variants)
TM
570 variants)
E-SIT-CTC-20021203-0003 v1.0
17
Command Line Interface Commands
All CLI commands are commands that operate on, or configure, the SpeedTouchTM500Series settings.
You can execute these commands from top level, preceded by the name of the command group from which the
command should be executed (e. g. firewall list).
You can also execute the commands from the command group itself, using the reduced form of the command (e.g. list
at the firewall command group selection).
! in a command means ‘NOT‘, e.g. the [!]syn parameter in the firewall rule create command.
Instead of entering a completely built-up command with all its parameters, you can also enter just the command itself,
without its parameters. After this you are prompted to complete the command with the required and the optional
parameters. For the optional parameters you can simply press enter without giving a value.
The example below is the equivalent of firewall assign hook=input chain=input. To break of such incomplete command
press CTRL+G.
EXAMPLE:
=>firewall assign
hook = input
chain = input
=>
18
E-SIT-CTC-20021203-0003 v1.0
Menu-driven CLI Navigation
To improve the user-friendliness of the SpeedTouchTM500Series CLI, the CLI features a menu-driven interface.
To enter the menu-driven interface, simply execute menu from the CLI prompt:
EXAMPLE (for the SpeedTouch
The semi-graphical CLI offers you an attractive and easy-to-use configuration environment for the CLI.
You can browse through the CLI command groups via the ARROW keys. Press ENTER to execute your selection. From
each level you can select '..' to go back one level up.
TM
510):
Use the TAB key to change from the CLI command menu to the control menu and vice versa.
To setup a CLI command, simply press ENTER on its name. You can configure and overview its various parameters at
one time. In case the parameter provides preset values, you can go through these via the ARROW keys. If you are satisfied, use the TAB key to go to the OK field and press ENTER.
NoteDo not forget to save your changes by executing saveall (from any CLI prompt).
E-SIT-CTC-20021203-0003 v1.0
19
Configuration Profile Files and the CLI
Configuration Profile Files500Series
The configuration profile files, used by the Setup wizard, or directly uploaded via the SpeedTouch
pages, consist of a set of CLI commands. Only CLI commands, which are part of the SpeedTouch
command set may be used in the .ini and .def files. For readability, configuration profile files are partitioned in paragraphs. These paragraphs reflect a CLI command group selection in the SpeedTouch
TM
500Series CLI. However, due to
TM
500Series web
TM
500Series CLI
internal processing, not all paragraph names are the same as their corresponding CLI command group selection.
In the following overview the relationship between the available SpeedTouch
CLI commands in a paragraph of a configuration profile file should always be constructed in their complete form.
Uncompleted CLI commands, i.e. commands in which required parameters are not specified, used in a configuration
profile file will be discarded by the CLI commend interpreter. This may result in a wrongly configured
SpeedTouch
TM
500Series.
In configuration profile files, the use of customization variables, allow the Setup wizard to invite the end-user to provide
some input regarding the settings of the SpeedTouch
TM
500Series. The declaration of such variables must be done in the
[env.ini] paragraph. Further use of the resulting variable TAG is allowed through all other paragraphs, even multiple
times.
To make sure that a variable always will result in a valid variable TAG, the [env.ini] paragraph also allows to declare a
preset value for the variable.
In case the variable TAG is used in a CLI command, the value of the variable should always be in conformity with the
syntax of the CLI command.
Customizing Configuration Profile Files
For more information on the customization possibilities of the SpeedTouch
configuration profile files, please check the SpeedTouch
TM
support pages at:
TM
500Series, the Setup wizard and the
http://www.speedtouch.com
E-SIT-CTC-20021203-0003 v1.0
21
Direct FTP Access
The SpeedTouchTM500Series File System
The SpeedTouch
responsible for storing, retrieving and maintaining the SpeedTouch
TM
500Series permanent storage, further referred to as 'file system', exists of nonvolatile memory
500Series is accessible via the FTP transport protocol. This allows to transfer the
Moreover, via FTP's quote site command you can execute CLI commands from the FTP prompt.
Proceed as indicated in the example below to open an FTP session to the SpeedTouch
/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
Password : ######
330 OK
ftp>
SpeedTouch
TM
(00-90-D0-01-02-03) User 'doejohn' OK. Password required.
TM
500Series File System Structure
TM
500Series file system:
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 SpeedTouch
TM
500Series to
boot correctly.
The 'active' subdirectory always contains the software image in execution.
The 'dl' directory contains dormant software image. In case you have made changes to the SpeedTouch
TM
500Series
configuration and saved them, be it via a Telnet session, via the web pages or via the Setup wizard, a user.ini configuration profile file is created in the 'dl' subdirectory.
In other words, after each 'Save all', or config save call, the user.ini configuration profile file present in the 'dl' subdirectory reflects the current configuration of the SpeedTouch
TM
500Series.
22
E-SIT-CTC-20021203-0003 v1.0
SpeedTouchTM500Series 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, set the transfer mode to “binary”.
NoteTurn on the hashing option to see the progression of the file transfer.
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
Password : ######
330 OK
ftp>
ftp>bin
200 TYPE is now 8-bit binary
ftp>
ftp>hash
200Hash mark printing on (8192 bytes/hash mark).
ftp>
TM
(00-90-D0-01-02-03) User 'doejohn' OK. Password required.
E-SIT-CTC-20021203-0003 v1.0
23
24
E-SIT-CTC-20021203-0003 v1.0
ADSL Commands
ADSL Commands
Contents
This chapter covers the following commands:
TopicPage
adsl config 26
adsl info 27
E-SIT-CTC-20021203-0003 v1.0
25
ADSL Commands
adsl config
Show/set the Asymmetric Digital Subscriber Line (ADSL) configuration.
Although the same command for both SpeedTouch
command features specific parameter values per variant:
SYNTAX FOR ADSL/Plain Old Telephone Service (POTS) variants:
ADSL/POTS and SpeedTouchTM ADSL/ISDN variants, the
[opermode]The operational mode of the SpeedTouch
TM
modem.
Choose between:
•ansi
•g.dmt_annex_a
•g.lite
•multimode
By default the SpeedTouch
TM
will start in multimode.
maxbitspertoneUSA number between 10 and 14 (bits per tone).
Represents the maximum number of bits which can be allocated to
each ADSL DMT tone in the upstream direction.
By default the modem will use up to 13 bits per tone.
SYNTAX FOR ADSL/Integrated Services Digital Network (ISDN) variants:
maxbitspertoneUSA number between 10 and 14 (bits per tone).
TM
will start in multimode.
OPTIONAL
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.
NoteExecuting the :adsl config without specifying parameters, shows the current ADSL configuration.
26
E-SIT-CTC-20021203-0003 v1.0
adsl info
Show ADSL statistics and information about the SpeedTouchTM DSL line status.
Although the same command for both SpeedTouch
command features specific output parameters and counters pe variant:
SYNTAX:
adsl info
TM
ADSL/POTS and SpeedTouchTM ADSL/ISDN variants, the
ADSL Commands
EXAMPLE (for a SpeedTouch
=>adsl info
Modemstate: up
Operation Mode: G.DMT Annex A [POTS Overlay Mode]
Channel Mode: fast
Number of resets: 1
Loss of frame:0 failures
Loss of signal:0 failures
Loss of power:0 failures
Loss of link:0 failures
Errored seconds:0 seconds
Far end failures last 15 minutes
Loss of frame:0 seconds
Loss of signal:0 seconds
Loss of power:0 seconds
Loss of link:0 seconds
Errored seconds:0 seconds
Far end failures current day
Errored seconds:0 seconds
Far end failures previous day
Errored seconds:0 seconds
Near end failures since reset
Loss of frame:0 failures
Loss of signal:0 failures
Loss of power:0 failures
Errored seconds:0 seconds
Near end failures last 15 minutes
Loss of frame:0 seconds
Loss of signal:0 seconds
Loss of power:0 seconds
Errored seconds:0 seconds
Near end failures current day
Errored seconds:0 seconds
Near end failures previous day
Errored seconds:0 seconds
=>
28
E-SIT-CTC-20021203-0003 v1.0
ATM Commands
ATM Commands
Contents
This chapter covers the following commands:
TopicPage
atm portstats 30
atm oam config 31
atm oam status 32
NoteThe command :atm portstats is replaced by the command :atmstats portstats for the SpeedTouch
The command :atmstats portstats is the only ATM command for the SpeedTouch
TM
570.
TM
570.
E-SIT-CTC-20021203-0003 v1.0
29
ATM Commands
atm portstats
Show port specific Asynchronous Transfer Mode (ATM) statistics.
SYNTAX:
atm portstatsport = <{DSL0|ATM|ATMF25|ATM3|ATM4|ATM5} or number>
portThe port to show the ATM statistics of.
Choose between:
•DSL0
•ATM
•ATM F2 5
•ATM 3
•ATM 5
Or specify a port number.
NoteThe parameter DSL0 is replaced by the parameter
ADSL0 for the SpeedTouch
EXAMPLE:
=>atm portstats port=DSL0
# of received octets = 547649.
# of transmitted octets = 191648.
# of received cells = 10333.
# of transmitted cells = 3616.
# of unknown cells= 0.
# of errors on the input = 0.
# of errors on output = 0.
=>
TM
REQUIRED
570.
30
E-SIT-CTC-20021203-0003 v1.0
atm oam config
Configure Operation and Maintenance (OAM) cell settings.
SYNTAX:
atm oam configclp = <number{0-1}>
ATM Commands
clpThe CLP bit value of the OAM cells.
Select either:
•0
•1
REQUIRED
E-SIT-CTC-20021203-0003 v1.0
31
ATM Commands
atm oam status
Show OAM data blocking mode of all ports.
SYNTAX:
atm oam status
EXAMPLE:
=>atm oam status
OAM config dump
------------------CLP bit value : 1
=>
32
E-SIT-CTC-20021203-0003 v1.0
Bridge Commands
Bridge Commands
Contents
This chapter covers the following commands:
TopicPage
bridge config 34
bridge flush 35
bridge ifadd 36
bridge ifattach 39
bridge ifconfig 42
bridge ifdelete 44
bridge ifdetach 45
bridge iflist 46
bridge macadd 48
bridge macdelete 49
bridge maclist 50
E-SIT-CTC-20021203-0003 v1.0
33
Bridge Commands
bridge config
Show/set bridge ageing policy for dynamically learned Medium Access Control (MAC) addresses.
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 ageing timer is 300 seconds.
530 device, never change, or delete the usb_bridge interface!
E-SIT-CTC-20021203-0003 v1.0
Bridge Commands
DESCRIPTION::
RX bytesThe number of Received bytes
TX bytesThe number of Transmitted bytes
OBCShort for On Board Controller and indicates the physical bridge port.
RELATED COMMANDS:
bridge ifaddCreate a bridge interface.
bridge ifattachAttach a created bridge interface.
bridge ifconfigConfigure a bridge interface.
bridge ifdeleteDelete a bridge interface.
bridge ifdetachDetach a bridge interface.
E-SIT-CTC-20021203-0003 v1.0
47
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 macaddintf = <available bridge interfaces>
hwaddr = <hardware-address>
intfThe name of the bridge interface to add the MAC address for.REQUIRED
Flush complete Classical IP over ATM (IPoA) configuration.
NoteThe flush command does not impact previously saved configurations.
SYNTAX:
cip flush
52
E-SIT-CTC-20021203-0003 v1.0
CIP Commands
cip ifadd
Create a Classical IPoA interface at the local side of the Logical IP Subnet (LIS).
SYNTAX:
cip ifaddaddr = <ip-address>
[netmask = <ip-mask (dotted or cidr)>]
[uniaddr = <portspec:address[.selector]>]
addrThe Classical IPoA interface's local IP address in the LIS.REQUIRED
netmaskThe LIS's subnetmask.OPTIONAL
uniaddrThe UNI-address/port specification for incoming connections, e.g.
‘A0:*.04‘: ADSL port, any address, selector 3.
Only applicable in an Switched Virtual Channel (SVC) environment.
In most cases the Classical IPoA LIS is built in a Permanent Virtual
Channel (PVC) environment.
config erasePhysically remove all saved configurations.
config flushFlush complete runtime configuration.
config saveSave current runtime configuration.
64
E-SIT-CTC-20021203-0003 v1.0
config save
Config Commands
Save all existing configurations and modifications entered by the user.
The result of executing this command is a user.ini file saved in the SpeedTouch
downloaded via the SpeedTouch
TM
web pages or via an FTP session.
TM
SYNTAX:
config save
EXAMPLE:
=>config save
=>
RELATED COMMANDS:
config erasePhysically remove all saved configurations.
config flushFlush complete current configuration.
config loadLoad complete saved or default configuration.
=>dhcp client stats
DHCP client statistics:
Corrupted packet recv: 0
OFFERsrecv: 0
ACKsrecv: 0
NAKsrecv: 0
Pure BOOTP REPLIES: 0
Other message types: 0
DISCOVERs sent: 253
REQUESTs sent: 9
DECLINEs sent: 0
RELEASEs sent: 0
INFORMssent: 0
Number of dynamic interfaces: 1
Memory usage:
Table size of dyn leases: 19, in use: 1, free: 94 %
=>dhcp client clear
=>dhcp client stats
DHCP client statistics:
Corrupted packet recv: 0
OFFERsrecv: 0
ACKsrecv: 0
NAKsrecv: 0
Pure BOOTP REPLIES: 0
Other message types: 0
DISCOVERs sent: 0
REQUESTs sent: 0
DECLINEs sent: 0
RELEASEs sent: 0
INFORMssent:0
Number of dynamic interfaces: 1
Memory usage:
Table size of dyn leases: 19, in use: 1, free: 94 %
=>
RELATED COMMANDS:
dhcp client statsShow DHCP client statistics.
68
E-SIT-CTC-20021203-0003 v1.0
DHCP Commands
dhcp client config
Show/set DHCP client configuration.
SYNTAX:
dhcp client config[trace = <{off|on}>]
[trace]Enable tracing (on) or not (off).OPTIONAL
EXAMPLE:
=>dhcp client config
tracing: off
=>dhcp client config trace=on
=>dhcp client config
tracing: on
=>
RELATED COMMANDS:
dhcp client ifconfigConfigure a DHCP lease created for a specific interface.
E-SIT-CTC-20021203-0003 v1.0
69
DHCP Commands
dhcp client flush
Flush complete DHCP client configuration and dynamic interfaces.
NoteThe flush command does not impact previously saved configurations.
SYNTAX:
dhcp client flush
EXAMPLE:
=>dhcp client iflist
NewMer: [SELECTING]
flags= uc
IP address: 10.0.0.10
HW address: 0:90:d0:01:47:de
DHCP server : 255.255.255.255
hostname: NewLease
req.leasetime=10800 s
trying to get a lease for 8 min, 32 sec
transmission of DISCOVER in 57 sec
retransmission timeout: 64
Number of leases: 1
Total size of table: 19, in use: 1, free: 94 %
=>dhcp client flush
=>dhcp client iflist
No dynamic interfaces defined.
=>
nbr of retransmissions: 14
70
E-SIT-CTC-20021203-0003 v1.0
DHCP Commands
dhcp client ifadd
Create a DHCP lease for a specific interface.
SYNTAX:
dhcp client ifaddintf = <interface name>
intfThe name of an existing interface, e.g. created via :mer ifadd.REQUIRED
dhcp client ifattachAttach a DHCP lease to an interface.
dhcp client ifconfigConfigure a DHCP lease created for a specific interface.
dhcp client ifdeleteDelete a dynamic interface.
dhcp client iflistShow all dynamic interfaces.
E-SIT-CTC-20021203-0003 v1.0
71
DHCP Commands
dhcp client ifattach
Attach a DHCP lease to a dynamic interface.
NoteCreate the interface first with :dhcp client ifadd.
SYNTAX:
dhcp client ifattachintf = <interface name>
intf The name of the dynamic interface.REQUIRED
EXAMPLE:
=>dhcp client iflist
NewMer: [INIT]
flags= uc
IP address: 0.0.0.0
HW address: 00:90:d0:01:47:de
Number of leases: 1
Total size of table: 19,in use: 1,free: 94 %
=>dhcp client ifattach intf=NewMer
=>dhcp client iflist
NewMer: [SELECTING]
Number of leases: 1
Total size of table: 19,in use: 1,free: 94 %
=>
DHCP server: 255.255.255.255
flags= uc
IP address: 10.0.0.10
HW address: 0:90:d0:01:47:de
DHCP server: 255.255.255.255
hostname: NewLease
req.leasetime= 10800 s
trying to get a lease for 8 min, 32 sec
transmission of DISCOVER in 57 sec
retransmission timeout: 64
nbr of retransmissions: 14
RELATED COMMANDS:
dhcp client ifaddCreate a DHCP lease for a specific interface.
dhcp client ifconfigConfigure a DHCP lease created for a specific interface.
dhcp client ifreleaseRelease a lease attached to a dynamic interface.
dhcp client iflistShow all dynamic interfaces.
72
E-SIT-CTC-20021203-0003 v1.0
dhcp client ifconfig
Show/set the configuration of DHCP lease created for a specific interface.
NoteExecute the dhcp client ifrelease command before configuring the dhcp client.
intfThe name of the dynamic interface to be configured.REQUIRED
[clientid]The client identity to be associated with the lease. Use none in case
no clientid should be associated with this lease.
[hostname]The host name of the client to be associated with the lease. Use “” in
case no hostname should not be associated with this lease.
[addr]The preferred dynamic IP address.OPTIONAL
[leasetime]A number between 0 and 1814400 (seconds).
Represents the preferred time the client wants to use an address.
By default the leasetime is 7200 seconds (2 hours).
Specifying -1 makes the lease permanent.
[addrtrans]Automatically enable address translation for this dynamic interface
(pat) or not (none).
[dns]Request (and accept) DNS server IP addresses (on) or not (off).OPTIONAL
[gateway]Request (and accept) gateway IP addresses (on) or not (off).OPTIONAL
[metric]A number between 10 and 100000.
Represents the gateway route metric
By default the gateway route metric is 1.
OPTIONAL
OPTIONAL
OPTIONAL
OPTIONAL
OPTIONAL
E-SIT-CTC-20021203-0003 v1.0
73
DHCP Commands
EXAMPLE:
=>dhcp client iflist
NewMer: [INIT]
flags= uc
IP address: 0.0.0.0
HW address: 00:90:d0:01:47:de
Number of leases: 1
Total size of table: 19,in use: 1,free: 4 %
=>dhcp client ifconfig intf=NewMer hostname=NewLease addr=10.0.0.10 leasetime=10800
=>dhcp client iflist
NewMer: [INIT]
Number of leases: 1
Total size of table: 19,in use: 1,free: 4 %
=>
DHCP server: 255.255.255.255
flags= uc
IP address: 10.0.0.10
HW address: 00:90:d0:01:47:de
DHCP server: 255.255.255.255
hostname: NewLease
req.leasetime= 10800 s
RELATED COMMANDS:
dhcp client ifaddCreate a DHCP lease for a specific interface.
dhcp client ifdeleteDelete a dynamic interface.
dhcp client iflistShow all dynamic interfaces.
dhcp client ifreleaseRelease a lease attached to a dynamic interface.
74
E-SIT-CTC-20021203-0003 v1.0
DHCP Commands
dhcp client ifdelete
Delete a dynamic interface.
SYNTAX:
dhcp client ifdeleteintf = <interface name>
intfThe name of the dynamic interface.REQUIRED
EXAMPLE:
=>dhcp client iflist
NewMer: [SELECTING]
Number of leases: 1
Total size of table: 19,in use: 1,free: 94 %
=>dhcp client ifdelete intf NewMer
=>dhcp client iflist
No dynamic interfaces defined.
=>
flags= uc
IP address: 10.0.0.10
HW address: 00:90:d0:01:47:de
DHCP server: 255.255.255.255
hostname: NewLease
req.leasetime= 10800 s
trying to get a lease for 8 min, 32 sec
transmission of DISCOVER in 57 sec
retransmission timeout: 64
nbr of retransmissions: 14
RELATED COMMANDS:
dhcp client ifaddCreate a DHCP lease for a specific interface.
dhcp client ifattachAttach a DHCP lease to an interface.
dhcp client ifconfigConfigure a DHCP lease created for a specific interface.
dhcp client iflistShow all dynamic interfaces.
dhcp client ifreleaseRelease a lease attached to a dynamic interface.
E-SIT-CTC-20021203-0003 v1.0
75
DHCP Commands
dhcp client iflist
Show all dynamic interfaces.
SYNTAX:
dhcp client iflist
EXAMPLE:
=>dhcp client iflist
NewMer: [INIT]
Number of leases: 1
Total size of table: 19,in use: 1,free: 94 %
=>
dhcp client ifaddCreate a DHCP lease for a specific interface.
dhcp client ifdeleteDelete a dynamic interface.
76
E-SIT-CTC-20021203-0003 v1.0
DHCP Commands
dhcp client ifrelease
Release a lease attached to a dynamic interface.
SYNTAX:
dhcp client ifreleaseintf = <interface name>
intf The name of the dynamic interface.REQUIRED
EXAMPLE:
=>dhcp client iflist
NewMer: [SELECTING]
Number of leases: 1
Total size of table: 19,in use: 1,free: 94 %
=>dhcp client ifattach intf=NewMer
=>dhcp client iflist
NewMer: [SELECTING]
Number of leases: 1
Total size of table: 19,in use: 1,free: 94 %
=>
flags= uc
IP address: 10.0.0.10
HW address: 00:90:d0:01:47:de
DHCP server: 255.255.255.255
hostname: NewLease
req.leasetime= 10800 s
trying to get a lease for 8 min, 32 sec
transmission of DISCOVER in 57 sec
retransmission timeout: 64
nbr of retransmissions: 14
flags= uc
IP address: 0.0.0.0
HW address: 00:90:d0:01:47:de
DHCP server: 255.255.255.255
hostname: NewLease
req.leasetime= 10800 s
E-SIT-CTC-20021203-0003 v1.0
77
DHCP Commands
EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
The SpeedTouch
=>dhcp client iflist
eth0: [BOUND]
Number of leases: 1
Total size of table: 18,in use: 1,free: 94 %
=>dhcp client stats
DHCP client statistics:
Corrupted packet recv:0
DECLINEs sent:0
RELEASEs sent:0
INFORMssent:0
Number of dynamic interfaces: 1
Memory usage:
Table size of dyn leases: 19,in use: 1,free: 94 %
=>dhcp client ifrelease intf=eth0
=>(CTRL + Q)
=>STATE ACTIVATE !
STATE IDLE !
STATE ACTIVATE !
dhcc: intf 1 releases 10.0.0.3 to server 10.10.1.1.
dhcc: 10.0.0.3 deleted: ok.
STATE IDLE !
STATE ACTIVATE !
.............
dhcc: intf 1 in init state.
n_send() broadcast triggered; To be verified
dhcc: broadcast discover on intf 1.
=>(CTRL + S)
=>dhcp client stats
DHCP client statistics:
Corrupted packet recv:0
DECLINEs sent:0
RELEASEs sent:1
INFORMssent:0
Number of dynamic interfaces: 1
Memory usage:
Table size of dyn leases: 19,in use: 1,free: 94 %
=>
TM
is configured as DHCP client on its Ethernet interface eth0.
flags= uc
IP address: 10.0.0.10
HW address: 00:90:d0:01:47:de
DHCP server: 255.255.255.255
hostname: NewLease
req.leasetime= 10800 s
trying to get a lease for 12 sec
transmission of DISCOVER in 24 sec
retransmission timeout: 64
nbr of retransmissions: 11
E-SIT-CTC-20021203-0003 v1.0
79
DHCP Commands
EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
The SpeedTouch
=>dhcp client stats
DHCP client statistics:
Corrupted packet recv:0
OFFERsrecv:0
ACKsrecv:0
NAKsrecv:0
Pure BOOTP REPLIES:0
Other message types:0
DISCOVERs sent:0
REQUESTs sent:0
DECLINEs sent:0
RELEASEs sent:1
INFORMssent:0
Number of dynamic interfaces: 1
Memory usage:
Table size of dyn leases: 18,in use: 1,free: 94 %
=>dhcp client ifrenew intf=eth0
=>dhcp client stats
DHCP client statistics:
Corrupted packet recv:0
OFFERsrecv:1
ACKsrecv:1
NAKsrecv:0
Pure BOOTP REPLIES:0
Other message types:0
DISCOVERs sent:1
REQUESTs sent:1
DECLINEs sent:0
RELEASEs sent:1
INFORMssent:0
Number of dynamic interfaces: 1
Memory usage:
Table size of dyn leases: 18,in use: 1,free: 94 %
=>(CTRL + Q)
..................
STATE IDLE !
STATE ACTIVATE !
dhcc: intf 1 renews lease 10.0.0.3.
dhcc: intf 1 requests 10.0.0.3 from 10.10.1.1
dhcc: 10.10.1.1 acks 10.0.0.3 to intf 1.
dhcc: lease 10.0.0.3 bound to intf 1.
STATE IDLE !
STATE ACTIVATE !
...........
=>(CTRL + S)
TM
is configured as DHCP client on its Ethernet interface eth0.
RELATED COMMANDS:
dhcp client ifaddCreate a DHCP lease for a specific interface.
dhcp client ifattachAttach a DHCP lease to an interface.
80
E-SIT-CTC-20021203-0003 v1.0
dhcp client stats
Show DHCP client statistics.
SYNTAX:
dhcp client stats
EXAMPLE:
=>dhcp client stats
DHCP client statistics:
Corrupted packet recv:0
OFFERsrecv:1
ACKsrecv:1
NAKsrecv:0
Pure BOOTP REPLIES:0
Other message types:0
DISCOVERs sent:244
REQUESTs sent:9
DECLINEs sent:0
RELEASEs sent:1
INFORMssent:0
Number of dynamic interfaces: 1
Memory usage:
Table size of dyn leases: 19,in use: 1,free: 94 %
=>
DHCP Commands
RELATED COMMANDS:
dhcp client clearClear DHCP client statistics.
E-SIT-CTC-20021203-0003 v1.0
81
DHCP Commands
dhcp server clear
Clear SpeedTouchTM DHCP server statistics.
SYNTAX:
dhcp server clear
EXAMPLE:
=>dhcp client stats
Corrupted packet recv:0
OFFERsrecv:9575
ACKsrecv:121
NAKsrecv:0
Pure BOOTP REPLIES:0
Other message types:0
DISCOVERs sent:9552
REQUESTs sent:142
DECLINEs sent:0
RELEASEs sent:0
INFORMssent:0
Number of dynamic interfaces: 1
Memory usage:
Table size of dyn leases: 19,in use: 1,free: 94 %
=>dhcp server clear
=>dhcp client stats
DHCP client statistics:
Corrupted packet recv:0
OFFERsrecv:0
ACKsrecv:0
NAKsrecv:0
Pure BOOTP REPLIES:0
Other message types:0
DISCOVERs sent:0
REQUESTs sent:0
DECLINEs sent:0
RELEASEs sent:0
INFORMssent:0
Number of dynamic interfaces: 1
Memory usage:
Table size of dyn leases: 19,in use: 1,free: 94 %
=>
RELATED COMMANDS:
dhcp server statsShow DHCP server statistics.
82
E-SIT-CTC-20021203-0003 v1.0
dhcp server config
Show/set SpeedTouchTM DHCP server configuration settings.
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 its own DHCP
server (yes) or immediately start the DHCP server (no).
[scantime]A number between 0 and 1814400 (seconds).
Represents the time the SpeedTouch
TM
scans for another DHCP
server to be active in the network.
By default the scantime is 20 seconds.
[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.
[trace]Disable verbose console logging and generation of debug traces (off)
or enable verbose console logging and generation of debug traces
(on).
By default tracing is disabled.
EXAMPLE:
OPTIONAL
OPTIONAL
OPTIONAL
OPTIONAL
=>dhcp server config
autodhcp:on
scantime:20s
spoofing:off
tracing:off
=>dhcp server config scantime=30 tracing=on
=>dhcp server config
autodhcp:on
scantime:30s
spoofing:off
tracing:on
=>
RELATED COMMANDS:
dhcp server statsShow current DHCP server state and statistics.
E-SIT-CTC-20021203-0003 v1.0
83
DHCP Commands
dhcp server flush
Flushes all DHCP server pool and lease entries.
NoteThe flush command does not impact previously saved configurations.
SYNTAX:
dhcp server flush
RELATED COMMANDS:
dhcp server statsShow current DHCP server state and statistics.
dhcp server configShow/set current DHCP server configuration.
84
E-SIT-CTC-20021203-0003 v1.0
dhcp server policy
Show/set SpeedTouchTM DHCP server policy.
SYNTAX:
dhcp server policy[verifyfirst = <off|on>]
[trustclient = <off|on>]
DHCP Commands
[verifyfirst]Probe the network for conflicting IP addresses before giving a
suggested IP address to the requesting DHCP client (on) or not (off).
[trustclient]Take the IP address suggested by a DHCP client into account (on) or
not (off).
EXAMPLE:
=>dhcp server policy
Verify first:off
Trust client:on
=>dhcp server policy verifyfirst=on trustclient=off
=>dhcp server policy
Verify first:on
Trust client:off
=>
RELATED COMMANDS:
dhcp server statsShow current DHCP server state and statistics.
dhcp server configShow/set current DHCP server configuration.
OPTIONAL
OPTIONAL
E-SIT-CTC-20021203-0003 v1.0
85
DHCP Commands
dhcp server spoof
Show/set DHCP spoofing parameters. Only applicable in case of a PPP-to-DHCP Spoofing connection. (See dhcp server
config command).
SYNTAX:
dhcp server 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 SpeedTouch
to set up a PPP connection before returning to normal DHCP mode,
i.e. in case the PPP connection cannot be established within the time
lapse determined by failtime, the SpeedTouch
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 dial-on-demand PPP link.
In case of a dial-on-demand PPP link, this parameter determines the
interval at which the the temporary DHCP lease must be maintained
before checking whether a public IP address negotiated by a triggered PPP link is available.
By default the dial-on-demand lease time is 10 seconds.
TM
should try
TM
DHCP server will
OPTIONAL
OPTIONAL
OPTIONAL
EXAMPLE:
=>dhcp server spoof failtime=8 errorlt=120 dodlt=20
=>dhcp server spoof
Failure timeout (!DoD):8 sec
Failure lease time (!DoD): 120 sec
Temp. lease time (DoD):20 sec
=>
RELATED COMMANDS:
dhcp server policySet DHCP server policy.
dhcp server statsShow current DHCP server state and statistics.
86
E-SIT-CTC-20021203-0003 v1.0
dhcp server start
Start SpeedTouchTM DHCP server.
SYNTAX:
dhcp server start
EXAMPLE:
=>dhcp server stats
DHCP Server State:Stopped
DHCP server statistics:
Corrupted packet recv:0
.....
=>dhcp server start
=>dhcp server stats
DHCP server state:Running
DHCP server statistics:
Corrupted packet recv:0
.....
=>
DHCP Commands
RELATED COMMANDS:
dhcp server statsShow current DHCP server state and statistics.
dhcp server stopStop DHCP server.
E-SIT-CTC-20021203-0003 v1.0
87
DHCP Commands
dhcp server stats
Show SpeedTouchTM DHCP server statistics.
SYNTAX:
dhcp server stats
EXAMPLE OUTPUT:
=>dhcp server stats
DHCP Server State:Stopped
DHCP server statistics:
Corrupted packet recv:0
DISCOVER:2451
REQUEST:28
DECLINE:0
RELEASE:22
INFORM:1
Pure BOOTP REQUESTS:2
Other message types:0
OFFERs sent:2451
ACKs sent:19
NAKs sent:0
Lease table got full:no
Ping table got full:no
Second dhcp server seen :no
Total size of lease table: 32, in use: 16, free: 50 %
=>
88
E-SIT-CTC-20021203-0003 v1.0
DESCRIPTION:
DHCP Commands
DHCP server stateIndicates the state of the SpeedTouch
Corrupted packet
recv
Indicates the number of corrupted packets (not complaint to RFC2131) received from
the LAN.
TM
DHCP server.
DISCOVERIndicates the number of DHCP server discovery packets received from the Local Area
Network (LAN). These broadcasts are sent by potential DHCP clients to locate available
DHCP servers.
REQUESTIndicates the number of DHCP address lease requests received from the LAN.
DECLINEIndicates the number of DHCP address lease requests declined.
RELEASEIndicates the number of DHCP address release requests received from DHCP clients.
INFORMIndicates the number of information requests received from DHCP clients.
Pure BOOTP
Indicates the number of BOOTP requests received from the LAN.
requests
OFFERs sentIndicates the number of IP address offers sent in reply to DHCP requests.
ACKs sentIndicates the number of ACKnowledgement replies sent to successfully configured DHCP
clients.
NAKs sentIndicates the number of Not-AcKnowledgement replies 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 SpeedTouch
TM
DHCP server to verify whether the IP address is already in use on
the LAN or not. (dhcp server policy verifyfirst=yes)
Second DHCP
Indicates whether a concurrent DHCP server was found on the LAN or not.
server
RELATED COMMANDS:
dhcp server clearClear DHCP server statistics.
E-SIT-CTC-20021203-0003 v1.0
89
DHCP Commands
dhcp server stop
Stop SpeedTouchTM DHCP server.
SYNTAX:
dhcp server stop
EXAMPLE:
=>dhcp server stats
DHCP Server State:Running
DHCP server statistics:
Corrupted packet recv :0
.....
=>dhcp server start
=>dhcp server stats
DHCP server state:Stopped
DHCP server statistics:
Corrupted packet recv :0
.....
=>
RELATED COMMANDS:
dhcp server startStart DHCP server.
dhcp server statsShow current DHCP server state and statistics.
90
E-SIT-CTC-20021203-0003 v1.0
DHCP Commands
dhcp server lease add
Assign a DHCP server lease to a DHCP host in the local network.
clientidThe DHCP client identification string of the booting host.REQUIRED
poolThe name of the DHCP server pool from which the DHCP lease
should be taken from. Use :dhcp server pool list for a list of available
DHCP server pools.
[addr]The favoured IP address for this DHCP host. This IP address, if spec-
ified, must be in the range of the DHCP pool specified.
[offset]A number between 0 and the integer number defined by the number
of available IP addresses in the DHCP server pool.
Represents the IP address offset in the DHCP server pool preserved
for this host.
Not specifying this parameter does not preserve an IP address for
the host.
[leasetime]A number between 0 and 1814400 (seconds).
Represents the time the host is allowed to use this address, before
renewing.
Specifying -1 makes the lease permanent.
[hostname]The hostname to add to the local Domain Name System (DNS) table
for this host. Use “” in case no hostname is associated with this
lease.
EXAMPLE:
REQUIRED
OPTIONAL
OPTIONAL
OPTIONAL
OPTIONAL
=>dhcp server lease list
LeasePoolTTLStateClientid
0 0.0.0.0dhcp_pool_1 00:26:40FREE00:90:D0:12:34:56
=>dhcp server lease add clientid=01:23:55:67:89:ab pool=Local_pool leasetime=3600
=>dhcp server lease list
LeasePoolTTLStateClientid
0 0.0.0.0dhcp_pool_1 00:26:40FREE00:90:D0:12:34:56
1 10.0.0.1local_pool00:59:22USED01:23:45:67:89:AB
=>
E-SIT-CTC-20021203-0003 v1.0
91
DHCP Commands
RELATED COMMANDS:
dhcp server lease deleteDelete a DHCP lease.
dhcp server lease flushDelete all DHCP leases.
dhcp server lease listShow current DHCP leases.
92
E-SIT-CTC-20021203-0003 v1.0
DHCP Commands
dhcp server lease delete
Delete a DHCP lease.
SYNTAX:
dhcp server lease deleteclientid = <clientid>
[index = <number>]
clientidThe DHCP client identification string of the DHCP lease.REQUIRED
[index]The index number of the entry to be deleted.
Use :dhcp server lease list to see a list of the index numbers of all
current DHCP leases.
EXAMPLE:
=>dhcp server lease list
LeasePoolTTLStateClientid
0 0.0.0.0dhcp_pool_1 00:26:40FREE00:90:D0:12:34:56
1 10.0.0.1local_pool00:59:22USED01:23:45:67:89:AB
=>dhcp server lease delete index=0
=>dhcp server lease list
LeasePoolTTLStateClientid
1 10.0.0.1local_pool00:59:22USED01:23:45:67:89:AB
=>
RELATED COMMANDS:
dhcp server lease addAdd a DHCP lease manually.
dhcp server lease flushDelete all DHCP leases.
dhcp server lease listShow current DHCP leases.
OPTIONAL
E-SIT-CTC-20021203-0003 v1.0
93
DHCP Commands
dhcp server lease flush
Flush complete DHCP server configuration and dynamic leases.
NoteThe flush command does not impact previously saved configurations.
SYNTAX:
dhcp server lease flush
EXAMPLE:
=>dhcp server lease list
LeasePoolTTLStateClientid
0 0.0.0.0dhcp_pool_1 00:26:40FREE00:90:D0:12:34:56
1 10.0.0.1local_pool00:59:22USED01:23:45:67:89:AB
2 10.0.0.101 local_pool00:21:01USED01:23:89:AB:80:CD
3 10.0.0.132 local_pool00:45:37USED09:D0:25:CE:F1:31
5 10.0.0.5local_pool00:21:11USEDAB:33:A1:7C:89:DD
4 10.0.0.6local_pool00:59:01USEDE3:81:9F:11:11:11
8 10.0.0.8local_pool00:01:00USED08:80:09:90:AB:DC
9 10.0.0.15 local_pool00:00:23USED08:93:DA:AE:01:AF
=>dhcp server lease flush
=>dhcp server lease list
=>
RELATED COMMANDS:
dhcp server lease addAdd a DHCP lease manually.
dhcp server lease deleteDelete a DHCP lease.
dhcp server lease listShow current DHCP leases.
94
E-SIT-CTC-20021203-0003 v1.0
dhcp server lease list
List current DHCP leases, indicated by their index number.
SYNTAX:
dhcp server leaselist
EXAMPLE OUTPUT:
=>dhcp server lease list
=>dhcp server lease list
LeasePoolTTLStateClientid
0 0.0.0.0dhcp_pool_1 00:26:40FREE00:90:D0:12:34:56
1 10.0.0.1local_pool00:59:22USED01:23:45:67:89:AB
2 10.0.0.101 local_pool00:21:01USED01:23:89:AB:80:CD
3 10.0.0.132 local_pool00:45:37USED09:D0:25:CE:F1:31
5 10.0.0.5local_pool00:21:11USEDAB:33:A1:7C:89:DD
4 10.0.0.6local_pool00:59:01USEDE3:81:9F:11:11:11
8 10.0.0.8local_pool00:01:00USED08:80:09:90:AB:DC
9 10.0.0.15 local_pool00:00:23USED08:93:DA:AE:01:AF
=>
DHCP Commands
RELATED COMMANDS:
dhcp server lease addAdd a DHCP lease manually.
dhcp server lease deleteDelete a DHCP lease.
dhcp server lease flushDelete complete DHCP server configuration and dynamic leases.
E-SIT-CTC-20021203-0003 v1.0
95
DHCP Commands
dhcp server pool add
Add a DHCP server pool.
SYNTAX:
dhcp server pool add[name = <string>]
[index = <number>]
[name]A name for the DHCP server pool. If not specified, the name is
“dhcp_pool_x”, where x is a subsequent number.
[index]A number between 0 (highest priority) and the highest number
(lowest priority) found in the list of existing DHCP server pools.
Represents a (higher) priority for the DHCP server pool.
If not specified, the DHCP pool is given the lowest subsequent
priority.
EXAMPLE:
=>dhcp server pool list
PoolStartEndStatePPP
0 dhcp_pool_10.0.0.00.0.0.0FREE
1 My_LAN_Pool10.0.0.110.0.0.254USED
2 dhcp_pool_20.0.0.00.0.0.0FREE
=>dhcp server pool add
=>dhcp server pool list
PoolStartEndStatePPP
0 dhcp_pool_10.0.0.00.0.0.0FREE
1 My_LAN_Pool10.0.0.110.0.0.254USED
2 dhcp_pool_20.0.0.00.0.0.0FREE
3 dhcp_pool_30.0.0.00.0.0.0FREE
=>dhcp server pool add name=POOL_EXTRA1
=>dhcp server pool list
PoolStartEndStatePPP
0 dhcp_pool_10.0.0.00.0.0.0FREE
1 My_LAN_Pool10.0.0.110.0.0.254USED
2 dhcp_pool_20.0.0.00.0.0.0FREE
3 dhcp_pool_30.0.0.00.0.0.0FREE
4 POOL_EXTRA10.0.0.00.0.0.0FREE
=>ppp ifconfig name=PPP_Test pool=POOL_EXTRA1
=>dhcp server pool list
PoolStartEndStatePPP
0 dhcp_pool_10.0.0.00.0.0.0FREE
1 My_LAN_Pool10.0.0.110.0.0.254USED
2 dhcp_pool_20.0.0.00.0.0.0FREE
3 dhcp_pool_30.0.0.00.0.0.0FREE
4 POOL_EXTRA10.0.0.00.0.0.0FREEPPP_Test
=>
OPTIONAL
OPTIONAL
96
E-SIT-CTC-20021203-0003 v1.0
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.