How it Works
THOMSON
Loading...
SPEEDTOUCH 570I
Reference Manual
300 pgs2.35 Mb0

THOMSON SPEEDTOUCH 510I - REFERENCE GUIDE RELEASE 4.0, SPEEDTOUCH 530, SPEEDTOUCH 570I Reference Manual

Download
Page 1
SpeedTouch
TM
510(i)/530/570(i) Multi-User ADSL Gateways CLI Reference Guide
500 SERIES
Page 2
Page 3
SpeedTouch
TM
500Series
CLI Reference Guide
Release R4.0
Page 4
Status Released
Change Note PeckelbeenS
Short Title CLI ST500Series R4.0
Copyright
© 2003 THOMSON. All rights reserved. Passing on, and copying of this document, use and communication of its contents is not permitted without written authorization from THOMSON. The content of this document is furnished for informational use only, may be subject to change without notice, and should not be construed as a commitment by THOMSON. THOMSON assumes no responsibility or liability for any errors or inaccuracies that may appear in this document.
Page 5
1
E-SIT-CTC-20021203-0003 v1.0
Content
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
Menu-driven CLI Navigation ........................................................................................................................................ 19
Configuration Profile Files and the CLI......................................................................................................................20
Direct FTP Access ..........................................................................................................................................................22
ADSL Commands .......................................................................................... 25
adsl config .........................................................................................................................................................................26
adsl info .............................................................................................................................................................................27
ATM Commands............................................................................................ 29
atm portstats.................................................................................................................................................................... 30
atm oam config ................................................................................................................................................................ 31
atm oam status ................................................................................................................................................................ 32
Bridge Commands ......................................................................................... 33
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
Page 6
2
E-SIT-CTC-20021203-0003 v1.0
CIP Commands .............................................................................................. 51
cip flush.............................................................................................................................................................................. 52
cip ifadd .............................................................................................................................................................................53
cip ifdelete.........................................................................................................................................................................54
cip iflist...............................................................................................................................................................................55
cip pvcadd ......................................................................................................................................................................... 57
cip pvcdelete .................................................................................................................................................................... 58
cip pvclist...........................................................................................................................................................................59
Config Commands ......................................................................................... 61
config erase.......................................................................................................................................................................62
config flush ........................................................................................................................................................................ 63
config load......................................................................................................................................................................... 64
config save.........................................................................................................................................................................65
Page 7
3
E-SIT-CTC-20021203-0003 v1.0
DHCP Commands ......................................................................................... 67
dhcp client clear .............................................................................................................................................................. 68
dhcp client config ............................................................................................................................................................ 69
dhcp client flush............................................................................................................................................................... 70
dhcp client ifadd............................................................................................................................................................... 71
dhcp client ifattach .......................................................................................................................................................... 72
dhcp client ifconfig .......................................................................................................................................................... 73
dhcp client ifdelete..........................................................................................................................................................75
dhcp client iflist................................................................................................................................................................ 76
dhcp client ifrelease ........................................................................................................................................................ 77
dhcp client ifrenew ......................................................................................................................................................... 79
dhcp client stats............................................................................................................................................................... 81
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
Page 8
4
E-SIT-CTC-20021203-0003 v1.0
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 Commands ............................................................................................ 123
env def .............................................................................................................................................................................124
env flush ..........................................................................................................................................................................125
env get .............................................................................................................................................................................128
env list..............................................................................................................................................................................129
env set .............................................................................................................................................................................130
env unset.........................................................................................................................................................................131
Eth Commands............................................................................................. 133
eth ifconfig ......................................................................................................................................................................134
eth iflist ............................................................................................................................................................................135
Page 9
5
E-SIT-CTC-20021203-0003 v1.0
Firewall Commands..................................................................................... 137
firewall assign .................................................................................................................................................................138
firewall flush....................................................................................................................................................................139
firewall list.......................................................................................................................................................................140
firewall troff ....................................................................................................................................................................141
firewall tron....................................................................................................................................................................142
firewall unassign.............................................................................................................................................................143
firewall chain create......................................................................................................................................................144
firewall chain delete......................................................................................................................................................145
firewall chain list ............................................................................................................................................................146
firewall rule clear...........................................................................................................................................................147
firewall rule create........................................................................................................................................................148
firewall rule delete ........................................................................................................................................................152
firewall rule flush ...........................................................................................................................................................153
firewall rule list ..............................................................................................................................................................154
firewall rule stats ...........................................................................................................................................................155
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
Page 10
6
E-SIT-CTC-20021203-0003 v1.0
IPoA Commands.......................................................................................... 177
ipoa flush .........................................................................................................................................................................178
ipoa ifadd.........................................................................................................................................................................179
ipoa ifattach ....................................................................................................................................................................180
ipoa ifconfig.....................................................................................................................................................................181
ipoa ifdelete ....................................................................................................................................................................183
ipoa ifdetach ...................................................................................................................................................................184
ipoa iflist ..........................................................................................................................................................................185
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 Commands .......................................................................................... 197
nat applist........................................................................................................................................................................198
nat bind............................................................................................................................................................................199
nat bindlist.......................................................................................................................................................................200
nat create........................................................................................................................................................................201
nat defserver ..................................................................................................................................................................203
nat delete ........................................................................................................................................................................204
nat disable .......................................................................................................................................................................206
nat enable........................................................................................................................................................................207
nat flush ...........................................................................................................................................................................208
nat list ..............................................................................................................................................................................209
nat unbind .......................................................................................................................................................................210
Phonebook Commands ............................................................................... 211
phonebook add..............................................................................................................................................................212
phonebook autolist.......................................................................................................................................................214
phonebook delete.........................................................................................................................................................215
phonebook flush............................................................................................................................................................216
phonebook list ...............................................................................................................................................................217
Page 11
7
E-SIT-CTC-20021203-0003 v1.0
PPP Commands ........................................................................................... 219
ppp flush ..........................................................................................................................................................................220
ppp ifadd..........................................................................................................................................................................221
ppp ifattach .....................................................................................................................................................................223
ppp ifconfig......................................................................................................................................................................225
ppp ifdelete.....................................................................................................................................................................230
ppp ifdetach ....................................................................................................................................................................232
ppp iflist ...........................................................................................................................................................................233
ppp ifscan ........................................................................................................................................................................234
ppp rtadd.........................................................................................................................................................................235
ppp rtdelete....................................................................................................................................................................237
PPTP Commands......................................................................................... 239
pptp flush.........................................................................................................................................................................240
pptp list............................................................................................................................................................................241
pptp profadd...................................................................................................................................................................242
pptp profdelete..............................................................................................................................................................243
pptp proflist ....................................................................................................................................................................244
QoSBook Commands .................................................................................. 245
qosbook add...................................................................................................................................................................246
qosbook delete..............................................................................................................................................................248
qosbook flush.................................................................................................................................................................249
qosbook list ....................................................................................................................................................................250
Software Commands ................................................................................... 251
software cleanup ...........................................................................................................................................................252
software deletepassive.................................................................................................................................................253
software duplicate.........................................................................................................................................................254
software setpassive.......................................................................................................................................................255
software switch .............................................................................................................................................................256
software version............................................................................................................................................................257
Page 12
8
E-SIT-CTC-20021203-0003 v1.0
System Commands...................................................................................... 259
system clearpassword ..................................................................................................................................................260
system config..................................................................................................................................................................261
system flush ....................................................................................................................................................................262
system reboot................................................................................................................................................................263
system reset ...................................................................................................................................................................264
system setpassword......................................................................................................................................................265
TD Commands ............................................................................................. 267
td call................................................................................................................................................................................268
UPnP Commands......................................................................................... 269
upnp config .....................................................................................................................................................................270
upnp flush........................................................................................................................................................................271
upnp list...........................................................................................................................................................................272
Wireless Commands ................................................................................... 273
wireless wepconfig........................................................................................................................................................274
wireless aclconfig...........................................................................................................................................................275
wireless acllist ................................................................................................................................................................276
wireless aclflush .............................................................................................................................................................277
wireless aclentry............................................................................................................................................................278
wireless ifconfig .............................................................................................................................................................279
wireless status................................................................................................................................................................281
wireless counters ..........................................................................................................................................................282
wireless scan ..................................................................................................................................................................283
wireless flush ..................................................................................................................................................................284
Abbreviations ............................................................................................... 285
Supported Key Names ................................................................................ 289
Supported Internet Protocol (IP) Protocol Names ..............................................................................................289
Supported TCP/UDP Port Names............................................................................................................................290
Supported ICMP Type Names ...................................................................................................................................293
Page 13
9
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
TM
500Series CLI command set, to be used by the end-user to
configure the SpeedTouch
TM
500Series and PC(s).
For the fastidious user this Reference Guide aims to give a handbook for advanced and detailed configuration and trou­bleshooting of the SpeedTouch
TM
500Series via its character based Command Line Interface.
This CLI Reference Guide covers the CLI commands of the following DSL SpeedTouch
TM
products:
• SpeedTouch
TM
510
• SpeedTouch
TM
510i
• SpeedTouch
TM
530
• SpeedTouch
TM
570
• SpeedTouch
TM
570i
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.
Page 14
10
E-SIT-CTC-20021203-0003 v1.0
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 orga­nization) 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.
Page 15
11
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
TM
500Series.
As soon a session to the CLI is opened, the SpeedTouch
TM
500Series banner pops up, followed by the CLI prompt.
In case the SpeedTouch
TM
500Series is protected by a System password, authentication will be required before access is
granted.
The following figure shows an example of the SpeedTouch
TM
500Series banner after opening a session and
authentication.
/home/doejohn{1}$ telnet 10.0.0.138 Trying 10.0.0.138... Connected to 10.0.0.138. Username : Password : ######
-----------------------------------------------------------------------­* * ______ Speedtouch 510 * ___/_____/\ * / /\\ Version R4.0.0.9.0 * _____/__ / \\ * _/ /\_____/___ \ Copyright (c) 1999-2002, * // / \ /\ \ THOMSON multimedia * _______//_______/ \ / _\/______ * / /\ \/// /\ * __/ / \ \ / / / / _\__ * / / / \_______\/ / / / / /\ * /_/______/___________________/ /________/ /___/ \ * \ \ \ ___________ \ \ \ \ \ / * \_\ \ / /\ \ \ \ \___\/ *\ \/ /\\\ \/ * \_____/ / \ \ \________\/ * /__________/ \ \ / * \ _____ \ /_____\/ * \ / /\ \ /___\/ * /____/\\/ * \ \ /___\/ * \____\/ *
-----------------------------------------------------------------------­=>
Page 16
12
E-SIT-CTC-20021203-0003 v1.0
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
TM
510.
However:
• eth is only available on SpeedTouch
TM
510 variants equipped with a single Ethernet port and the
SpeedTouch
TM
530
• upnp is only available for the SpeedTouch
TM
510 variants and the SpeedTouchTM530
• wireless is only available for the SpeedTouch
TM
570
To return to top level, or to descend one level (in case of nested command groups) execute .. .
EXAMPLE:
=>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.
Following command groups are available :
adsl atm bridge cip config dhcp dns env eth firewall ip ipoa mer nat password phonebook ppp pptp qosbook software system td upnp
=>
=>phonebook [phonebook]=> [phonebook]=>.. =>
Page 17
13
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
TM
500Series.
EXAMPLE for the SpeedTouch
TM
570:
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:
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.
=>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.
Following command groups are available :
adsl atmstats bridge cip config dhcp dns env eth firewall ip mer nat password phonebook ppp pptp qosbook software system td wireless =>
=>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 :
chain rule
[firewall]=>
Page 18
14
E-SIT-CTC-20021203-0003 v1.0
EXAMPLE:
=>firewall help Following commands are available :
tron : Enables verbose console messaging. troff : Disables verbose console messaging. match : Defines an ip packet match. assign : Assign a chain to an entry point. list : Shows a list of all the hooks with the chain attached. flush : Clears all hooks. If a hook is provided, that hook is cleared.
Following command groups are available :
chain rule
=>
Page 19
15
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:
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:
Going to the beginning or end of the Command Line
=>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.
=>
=>firewall [firewall]=>"a+TAB" [firewall]=>assign
To go to ... Press ...
the beginning of the Command Line CTRL+A
the end of the Command Line CTRL+E
Page 20
16
E-SIT-CTC-20021203-0003 v1.0
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 =
History of Commands
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.
EXAMPLE:
[firewall]=>match chain = chain = chain = “CTRL+G” [firewall]=>
=>firewall [firewall]=>list assign hook=input chain=input assign hook=sink chain=sink assign hook=forward chain=forward assign hook=source chain=source [firewall]=> “UP ARROW” [firewall]=>:firewall list
Page 21
17
E-SIT-CTC-20021203-0003 v1.0
Command Line Interface Top Level Structure
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
TM
510, SpeedTouchTM570 ADSL/POTS, and the SpeedTouchTM510i and
SpeedTouch
TM
570i ADSL/ISDN variants)
• eth (only applicable for models equipped with a single 10/100Base-T Ethernet port)
• upnp (only applicable for the SpeedTouch
TM
510 and SpeedTouchTM530 variants)
• wireless (only applicable for the SpeedTouch
TM
570 variants)
Page 22
18
E-SIT-CTC-20021203-0003 v1.0
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.
EXAMPLE:
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 list assign hook=input chain=input assign hook=sink chain=sink assign hook=forward chain=forward assign hook=source chain=source =>firewall [firewall]=>list assign hook=input chain=input assign hook=sink chain=sink assign hook=forward chain=forward assign hook=source chain=source [firewall]=>
=>firewall assign hook = input chain = input =>
Page 23
19
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
TM
510):
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.
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 satis­fied, use the TAB key to go to the OK field and press ENTER.
Note Do not forget to save your changes by executing saveall (from any CLI prompt).
Page 24
20
E-SIT-CTC-20021203-0003 v1.0
Configuration Profile Files and the CLI
Configuration Profile Files500Series
The configuration profile files, used by the Setup wizard, or directly uploaded via the SpeedTouch
TM
500Series web
pages, consist of a set of CLI commands. Only CLI commands, which are part of the SpeedTouch
TM
500Series CLI command set may be used in the .ini and .def files. For readability, configuration profile files are partitioned in para­graphs. These paragraphs reflect a CLI command group selection in the SpeedTouch
TM
500Series CLI. However, due to
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
TM
500Series CLI commands and the
[<configuration>.ini] paragraphs is given:
[<configuration>.ini] paragraphs Available SpeedTouch
TM
500Series CLI commands
[adslisdn.ini] The adsl CLI command group in case of a ADSL/ISDN variant.
[adslpots.ini] The adsl CLI command group in case of a ADSL/POTS variant.
[brfilter.ini] The hidden brfilter CLI command group.
[bridge.ini] The bridge CLI command group.
[cip.ini] The cip CLI command group.
[dhcc.ini] The dhcp client CLI command subgroup.
[dhcp.ini] The dhcp server CLI command subgroup.
[dnsd.ini] The dns CLI command group.
[env.ini] The env CLI command group.
[eth.ini] The eth CLI command group.
[ip.ini] The ip CLI command group.
[ipoa.ini] The cip CLI command group.
[mer.ini] The mer CLI command group.
[nat.ini] The nat CLI command group.
[oam.ini] The atm oam CLI command subgroup.
[pfilter.ini] • The firewall chain CLI command subgroup
• The firewall rule CLI command subgroup.
[pfirewall.ini] The firewall CLI command group (except those part of the firewall chain
and firewall rule CLI command subgroups).
[phone.ini] The phonebook CLI command group.
[ppp.ini] The ppp CLI command group.
[pptp.ini] The pptp CLI command group.
[qos.ini] The qosbook CLI command group.
Page 25
21
E-SIT-CTC-20021203-0003 v1.0
CLI Commands in Configuration Profile Files
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
TM
500Series, the Setup wizard and the
configuration profile files, please check the SpeedTouch
TM
support pages at:
http://www.speedtouch.com
[snmp.ini] The snmp CLI command group.
[system.ini] The system CLI command group.
[wireless.ini] The wireless CLI command group.
[<configuration>.ini] paragraphs Available SpeedTouch
TM
500Series CLI commands
Page 26
22
E-SIT-CTC-20021203-0003 v1.0
Direct FTP Access
The SpeedTouchTM500Series File System
The SpeedTouch
TM
500Series permanent storage, further referred to as 'file system', exists of nonvolatile memory
responsible for storing, retrieving and maintaining the SpeedTouch
TM
500Series software image(s), configuration profile
files and optionally default settings files.
The file system of the SpeedTouch
TM
500Series is accessible via the FTP transport protocol. This allows to transfer the
SpeedTouch
TM
500Series software image(s) and/or configuration profile files and default settings files.
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
TM
500Series file system:
SpeedTouch
TM
500Series 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 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 configura­tion 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' subdirec­tory reflects the current configuration of the SpeedTouch
TM
500Series.
/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
TM
(00-90-D0-01-02-03) User 'doejohn' OK. Password required. Password : ###### 330 OK ftp>
Page 27
23
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”.
Note Turn 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
TM
(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 bytes/hash mark). ftp>
Page 28
24
E-SIT-CTC-20021203-0003 v1.0
Page 29
25
ADSL Commands
E-SIT-CTC-20021203-0003 v1.0
ADSL Commands
Contents
This chapter covers the following commands:
Topic Page
adsl config 26
adsl info 27
Page 30
26
ADSL Commands
E-SIT-CTC-20021203-0003 v1.0
adsl config
Show/set the Asymmetric Digital Subscriber Line (ADSL) configuration.
Although the same command for both SpeedTouch
TM
ADSL/POTS and SpeedTouchTM ADSL/ISDN variants, the
command features specific parameter values per variant:
SYNTAX FOR ADSL/Plain Old Telephone Service (POTS) variants:
SYNTAX FOR ADSL/Integrated Services Digital Network (ISDN) variants:
Note Executing the :adsl config without specifying parameters, shows the current ADSL configuration.
adsl config [opermode = <{ansi|g.dmt_annex_a|g.lite|multimode}>]
[maxbitspertoneUS = <number{10-14}>]
[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.
OPTIONAL
maxbitspertoneUS A 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.
OPTIONAL
adsl config [opermode = <{etsi|g.dmt_annex_b|multimode}>]
[maxbitspertoneUS = <number{10-14}>]
[opermode] The operational mode of the SpeedTouch
TM
modem.
Choose between:
• ansi
• g.dmt_annex_b
• multimode
By default the SpeedTouch
TM
will start in multimode.
OPTIONAL
maxbitspertoneUS A number between 10 and 14 (bits per tone).
Represents the maximum number of bits whic hcan be allocated to each ADSL DMT tone in the upstream direction. By default the modem will use up to 13 bits per tone.
OPTIONAL
Page 31
27
ADSL Commands
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
TM
ADSL/POTS and SpeedTouchTM ADSL/ISDN variants, the
command features specific output parameters and counters pe variant:
SYNTAX:
EXAMPLE (for a SpeedTouch
TM
500Series ADSL/POTS variant):
.. Continued output on following page ..
adsl info
=>adsl info Modemstate : up Operation Mode : G.DMT Annex A [POTS Overlay Mode] Channel Mode : fast Number of resets : 1
Vendor (ITU) Local Remote
Country : 0f 0f Vendor : ALCB ALCB VendorSpecific : 0000 0000 StandardRevisionNr : 01 01
Downstream Upstream Margin [dB] : 25 31 Attenuation [dB] : 26 15
Available Bandwidth Cells/s Kbit/s
Downstream : 7924 3360 Upstream : 452 192
Transfer statistics
Total since power On Cells Kbit
Downstream : 10153 4304 Upstream : 3399 1441
Current Connection
Downstream : 10153 4304 Upstream : 3399 1441 Errors
Received FEC : 0 Received CRC : 0 Received HEC : 0
Page 32
28
ADSL Commands
E-SIT-CTC-20021203-0003 v1.0
.. Continued output ..
Far End Failure
No Failure
Near end failure
No failure
Far end failures since reset
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
=>
Page 33
29
ATM Commands
E-SIT-CTC-20021203-0003 v1.0
ATM Commands
Contents
This chapter covers the following commands:
Note The command :atm portstats is replaced by the command :atmstats portstats for the SpeedTouch
TM
570.
The command :atmstats portstats is the only ATM command for the SpeedTouch
TM
570.
Topic Page
atm portstats 30
atm oam config 31
atm oam status 32
Page 34
30
ATM Commands
E-SIT-CTC-20021203-0003 v1.0
atm portstats
Show port specific Asynchronous Transfer Mode (ATM) statistics.
SYNTAX:
EXAMPLE:
atm portstats port = <{DSL0|ATM|ATMF25|ATM3|ATM4|ATM5} or number>
port The port to show the ATM statistics of.
Choose between:
• DSL0
• ATM
• ATM F2 5
• ATM 3
• ATM 5
Or specify a port number.
Note The parameter DSL0 is replaced by the parameter
ADSL0 for the SpeedTouch
TM
570.
REQUIRED
=>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.
=>
Page 35
31
ATM Commands
E-SIT-CTC-20021203-0003 v1.0
atm oam config
Configure Operation and Maintenance (OAM) cell settings.
SYNTAX:
atm oam config clp = <number{0-1}>
clp The CLP bit value of the OAM cells.
Select either:
• 0
• 1
REQUIRED
Page 36
32
ATM Commands
E-SIT-CTC-20021203-0003 v1.0
atm oam status
Show OAM data blocking mode of all ports.
SYNTAX:
EXAMPLE:
atm oam status
=>atm oam status
OAM config dump
-------------------
CLP bit value : 1
=>
Page 37
33
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
Bridge Commands
Contents
This chapter covers the following commands:
Topic Page
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
Page 38
34
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
bridge config
Show/set bridge ageing policy for dynamically learned Medium Access Control (MAC) addresses.
SYNTAX:
EXAMPLE:
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.
OPTIONAL
=>bridge config Ageing : 300 =>bridge config age=600 =>bridge config Ageing : 600 =>
Page 39
35
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
bridge flush
Flush bridge interfaces and parameters.
Note The flush command does not impact previously saved configurations.
SYNTAX:
bridge flush
Page 40
36
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
bridge ifadd
Create a bridged Ethernet interface.
Page 41
37
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
SYNTAX:
EXAMPLE:
bridge ifadd [intf = <string>]
[dest = <available ETHoA phonebook entries>]
[intf] The bridged Ethernet interface name.
If not specified, the destination parameter must be specified. In this case the name of the destination will double as interface name.
OPTIONAL
[dest] The destination address for the new interface.
Typically a phonebook entry. Browse through the available entries via the ARROW UP and ARROW DOWN keys.
OPTIONAL
=>bridge iflist OBC : Internal
Connection State: connected Port: OBC PortState: forwarding RX bytes: 75783 frames: 572 TX bytes: 82768372 frames: 341221 dropframes: 0
eth0 : Internal
Connection State: connected Port: eth0 PortState: forwarding RX bytes: 156344216 frames: 5899238 TX bytes: 75689 frames: 425 dropframes: 5558017
usb_bridge : dest : usb_port
Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State: connected Port: wan2 PortNr: 4 PortState: forwarding RX bytes: 0 frames: 0
TX bytes: 0 frames: 0 dropframes: 0 =>bridge ifadd intf=TestBridge dest=Br1 =>bridge iflist OBC : Internal
Connection State: connected Port: OBC PortState: forwarding
RX bytes: 75783 frames: 572
TX bytes: 82843610 frames: 341554 dropframes: 0 eth0 : Internal
Connection State: connected Port: eth0 PortState: forwarding
RX bytes: 156472129 frames: 5903256
TX bytes: 75689 frames: 425 dropframes: 5561702 usb_bridge : dest : usb_port
Retry : 10 QoS : default Encaps : llc/snap Fcs : off
Connection State: connected
Port: wan2 PortNr: 4 PortState: forwarding
RX bytes: 0 frames: 0
TX bytes: 0 frames: 0 dropframes: 0 TestBridge : dest : Br1
Retry: 10 QoS: default Encaps: llc/snap Fcs: off
Connection State: not-connected Port: (Unassigned) PortState: forwarding =>
Page 42
38
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
RELATED COMMANDS:
bridge ifattach Attach a bridge interface.
bridge ifdetach Detach a bridge interface.
bridge ifdelete Delete a bridge interface.
bridge ifconfig Configure a bridge interface.
bridge iflist Show current bridge configuration.
Page 43
39
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
bridge ifattach
Attach (i.e. connect) a bridged Ethernet interface.
Page 44
40
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
SYNTAX:
EXAMPLE:
bridge ifattach intf = <available Bridged Ethernet interfaces>
intf The name of the interface to attach.
Browse through the available entries via the ARROW UP and ARROW DOWN keys.
REQUIRED
=>bridge iflist OBC : Internal
Connection State: connected Port: OBC PortState: forwarding
RX bytes: 75783 frames: 572
TX bytes: 82843610 frames: 341554 dropframes: 0 eth0 : Internal
Connection State: connected Port: eth0 PortState: forwarding
RX bytes: 156472129 frames: 5903256
TX bytes: 75689 frames: 425 dropframes: 5561702 usb_bridge : dest : usb_port
Retry : 10 QoS : default Encaps : llc/snap Fcs : off
Connection State: connected
Port: wan2 PortNr: 4 PortState: forwarding
RX bytes: 0 frames: 0
TX bytes: 0 frames: 0 dropframes: 0 TestBridge : dest : Br1
Retry: 10 QoS: default Encaps: llc/snap Fcs: off
Connection State: not­connected Port: (Unassigned) PortState: forwarding =>bridge ifattach intf=TestBridge =>bridge iflist OBC : Internal
Connection State: connected Port: OBC PortState: forwarding
RX bytes: 75783 frames: 572
TX bytes: 82843610 frames: 341554 dropframes: 0 eth0 : Internal
Connection State: connected Port: eth0 PortState: forwarding
RX bytes: 156472129 frames: 5903256
TX bytes: 75689 frames: 425 dropframes: 5561702 usb_bridge : dest : usb_port
Retry : 10 QoS : default Encaps : llc/snap Fcs : off
Connection State: connected
Port: wan2 PortNr: 4 PortState: forwarding
RX bytes: 0 frames: 0
TX bytes: 0 frames: 0 dropframes: 0 TestBridge : dest : Br1
Retry: 10 QoS: default Encaps: llc/snap Fcs: off
Connection State: connected Port: wan0 PortState: forwarding
RX bytes: 75 frames: 12
TX bytes: 30246 frames: 91 dropframes: 0 =>
Page 45
41
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
RELATED COMMANDS:
bridge ifadd Create a bridge interface.
bridge ifdetach Detach a bridge interface.
bridge ifdelete Delete a bridge interface.
bridge ifconfig Configure a bridge interface.
bridge iflist Show current bridge configuration.
Page 46
42
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
bridge ifconfig
Configure a bridge interface.
SYNTAX:
Note In case of a SpeedTouch
TM
530 device, never change, or delete the usb_bridge interface!
bridge ifconfig intf = <intfname>
[dest = <available interface name>] [qos = <string>] [encaps = <{llc/snap|vcmux}>] [fcs = <{off|on}>] [portstate = <{disabled|learning|forwarding}>] [retry = <number {0-65535}>]
intf The name of the bridge interface to configure. REQUIRED
[dest] The destination for this interface. Typically a phonebook entry.
This parameter needs only to be specified in case of an interface created without specified destination.
OPTIONAL
[qos] The name of the Quality Of Service book entry to apply on this
bridge interface.
OPTIONAL
[encaps] The type of encapsulation to be used for this bridge interface.
Choose between:
• llc/snap
• vcmux
OPTIONAL
[fcs] Whether or not to include the Ethernet FCS in the packet header on
the WAN side. Choose between:
• off
• on
OPTIONAL
[portstate] The bridge portstate for this interface. Choose between:
• disabled
• learning
• forwarding
OPTIONAL
[retry] A number between 0 and 65535.
Represents the number of WAN connection setup retries before giving up. By default the retry value is 10.
OPTIONAL
Page 47
43
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
EXAMPLE:
RELATED COMMANDS:
=>bridge iflist intf=TestBridge TestBridge : dest : Br1
Retry: 10 QoS: default Encaps: llc/snap Fcs: off Connection State: connected Port: wan0 PortState: forwarding RX bytes: 75 frames: 12
TX bytes: 30246 frames: 91 dropframes: 0 =>bridge ifconfig intf=TestBridge encaps=vcmux retry=15 =>bridge iflist intf=TestBridge TestBridge : dest : Br1
Retry: 15 QoS: default Encaps: vcmux Fcs: off
Connection State: connected Port: wan0 PortState: forwarding
RX bytes: 83 frames: 13
TX bytes: 30740 frames: 102 dropframes: 0 =>
bridge ifadd Create a bridge interface.
bridge ifattach Attach a bridge interface.
bridge ifdetach Detach a bridge interface.
bridge ifdelete Delete a bridge interface.
bridge iflist Show current bridge configuration.
Page 48
44
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
bridge ifdelete
Delete a bridge interface.
SYNTAX:
EXAMPLE:
Note In case of a SpeedTouch
TM
530 device, never change, or delete the usb_bridge interface!
RELATED COMMANDS:
bridge ifdelete intf = <available Bridged Ethernet interfaces>
intf The name of the interface name to delete.
Browse through the available entries via the ARROW UP and ARROW DOWN keys.
REQUIRED
=>bridge ifdelete intf=TestBridge =>bridge iflist OBC : Internal
Connection State: connected Port: OBC PortState: forwarding RX bytes: 75783 frames: 572 TX bytes: 82843610 frames: 341554 dropframes: 0
eth0 : Internal
Connection State: connected Port: eth0 PortState: forwarding RX bytes: 156472129 frames: 5903256 TX bytes: 75689 frames: 425 dropframes: 5561702
usb_bridge : dest : usb_port
Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State: connected Port: wan2 PortNr: 4 PortState: forwarding RX bytes: 0 frames: 0 TX bytes: 0 frames: 0 dropframes: 0
=>
bridge ifadd Create a bridge interface.
bridge ifattach Attach a bridge interface.
bridge ifconfig Configure a bridge interface.
bridge ifdetach Detach a bridge interface.
bridge iflist Show current bridge configuration.
Page 49
45
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
bridge ifdetach
Detach (i.e. disconnect) a bridge interface.
SYNTAX:
EXAMPLE:
Note In case of a SpeedTouch
TM
530 device, never change, or delete the usb_bridge interface!
RELATED COMMANDS:
bridge ifdetach intf = <available Bridged Ethernet interfaces>
intf The name of the bridge interface to detach.
Browse through the available entries via the ARROW UP and ARROW DOWN keys.
REQUIRED
=>bridge iflist intf=TestBridge TestBridge : dest : Br1
Retry: 10 QoS: default Encaps: llc/snap Fcs: off Connection State: connected Port: wan0 PortState: forwarding RX bytes: 75 frames: 12
TX bytes: 30246 frames: 91 dropframes: 0 =>bridge ifattach intf=TestBridge =>bridge iflist intf=TestBridge TestBridge : dest : Br1
Retry: 10 QoS: default Encaps: llc/snap Fcs: off
Connection State: not-connected Port: (unassigned) PortState: forwarding =>
bridge ifadd Create a bridge interface.
bridge ifattach Attach a bridge interface.
bridge ifconfig Configure a bridge interface.
bridge ifdelete Delete a bridge interface.
bridge iflist Show current bridge configuration.
Page 50
46
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
bridge iflist
Show the current state of all or the selected bridge interfaces.
SYNTAX:
EXAMPLE OUTPUT:
Note In case of a SpeedTouch
TM
530 device, never change, or delete the usb_bridge interface!
bridge iflist [intf = <available Bridged Ethernet interfaces>]
[intf] The name of the bridge interface to show the configuration of.
Browse through the available entries via the ARROW UP and ARROW DOWN keys. If not specified all bridge interfaces are shown.
OPTIONAL
=>bridge iflist OBC : Internal
Connection State: connected Port: OBC PortState: forwarding
RX bytes: 75783 frames: 572
TX bytes: 82768372 frames: 341221 dropframes: 0 eth0 : Internal
Connection State: connected Port: eth0 PortState: forwarding
RX bytes: 156344216 frames: 5899238
TX bytes: 75689 frames: 425 dropframes: 5558017 usb_bridge : dest : usb_port
Retry : 10 QoS : default Encaps : llc/snap Fcs : off
Connection State: connected
Port: wan2 PortNr: 4 PortState: forwarding
RX bytes: 0 frames: 0
TX bytes: 0 frames: 0 dropframes: 0 TestBridge : dest : Br1
Retry: 15 QoS: default Encaps: vcmux Fcs: off
Connection State: connected Port: wan0 PortState: forwarding
RX bytes: 83 frames: 13
TX bytes: 30740 frames: 102 dropframes: 0 =>
Page 51
47
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
DESCRIPTION::
RELATED COMMANDS:
RX bytes The number of Received bytes
TX bytes The number of Transmitted bytes
OBC Short for On Board Controller and indicates the physical bridge port.
bridge ifadd Create a bridge interface.
bridge ifattach Attach a created bridge interface.
bridge ifconfig Configure a bridge interface.
bridge ifdelete Delete a bridge interface.
bridge ifdetach Detach a bridge interface.
Page 52
48
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
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:
EXAMPLE:
RELATED COMMANDS:
bridge macadd intf = <available bridge interfaces>
hwaddr = <hardware-address>
intf The name of the bridge interface to add the MAC address for. REQUIRED
hwaddr The MAC address of the new entry. REQUIRED
=>bridge maclist 00:90:d0:01:02:03 -- static, OBC ff:ff:ff:ff:ff:ff -- static, OBC 01:80:c2:00:00:00 -- static, OBC 01:80:c2:00:00:01 -- static, OBC ... 01:80:c2:00:00:10 -- static, OBC 00:01:42:5f:7d:81 -- dynamic, eth0, 597 seconds 00:50:8b:31:cc:aa -- dynamic, eth0, 513 seconds 08:00:20:c1:9a:12 -- dynamic, eth0, 600 seconds ... =>bridge macadd intf=eth0 hwaddr=00:80:9f:01:23:45 =>bridge maclist 00:90:d0:01:02:03 -- static, OBC ff:ff:ff:ff:ff:ff -- static, OBC 01:80:c2:00:00:00 -- static, OBC 01:80:c2:00:00:01 -- static, OBC ... 01:80:c2:00:00:10 -- static, OBC 00:80:9f:01:23:45 -- permanent, eth0 00:01:42:5f:7d:81 -- dynamic, eth0, 598 seconds 00:50:8b:31:cc:aa -- dynamic, eth0, 379 seconds 08:00:20:c1:9a:12 -- dynamic, eth0, 600 seconds 00:08:c7:c3:5f:fc -- dynamic, eth0, 215 seconds ... =>
bridge macdelete Delete a MAC address entry.
bridge maclist Show current filtering database.
Page 53
49
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
bridge macdelete
Remove a MAC address from the filtering database.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
bridge macdelete hwaddr = <hardware-address>
hwaddr The MAC address of the entry to delete. REQUIRED
=>bridge maclist 00:90:d0:01:02:03 -- static, OBC ff:ff:ff:ff:ff:ff -- static, OBC 01:80:c2:00:00:00 -- static, OBC 01:80:c2:00:00:01 -- static, OBC ... 01:80:c2:00:00:10 -- static, OBC 00:80:9f:01:23:45 -- permanent, OBC 00:01:42:5f:7d:81 -- dynamic, eth0, 597 seconds 00:50:8b:31:cc:aa -- dynamic, eth0, 513 seconds 08:00:20:c1:9a:12 -- dynamic, eth0, 600 seconds ... =>bridge macdelete hwaddr=00:80:9f:01:23:45 =>bridge maclist 00:90:d0:01:02:03 -- static, OBC ff:ff:ff:ff:ff:ff -- static, OBC 01:80:c2:00:00:00 -- static, OBC 01:80:c2:00:00:01 -- static, OBC ... 01:80:c2:00:00:10 -- static, OBC 00:01:42:5f:7d:81 -- dynamic, eth0, 598 seconds 00:50:8b:31:cc:aa -- dynamic, eth0, 379 seconds 08:00:20:c1:9a:12 -- dynamic, eth0, 600 seconds 00:08:c7:c3:5f:fc -- dynamic, eth0, 215 seconds ... =>
bridge macadd Add a static MAC address entry.
bridge maclist Show current filtering database.
Page 54
50
Bridge Commands
E-SIT-CTC-20021203-0003 v1.0
bridge maclist
Show current MAC address filtering database.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
bridge maclist
=>bridge maclist =>bridge maclist 00:90:d0:01:02:03 -- static, OBC ff:ff:ff:ff:ff:ff -- static, OBC 01:80:c2:00:00:00 -- static, OBC 01:80:c2:00:00:01 -- static, OBC ... 01:80:c2:00:00:10 -- static, OBC 00:80:9f:24:ab:cf -- static, OBC 00:01:42:5f:7d:81 -- dynamic, eth0, 598 seconds 00:50:8b:31:cc:aa -- dynamic, eth0, 379 seconds 08:00:20:c1:9a:12 -- dynamic, eth0, 600 seconds 00:08:c7:c3:5f:fc -- dynamic, eth0, 215 seconds 08:00:20:a8:f4:34 -- dynamic, eth0, 600 seconds 08:00:20:83:b7:26 -- dynamic, eth0, 600 seconds 00:10:83:1b:13:18 -- dynamic, eth0, 599 seconds ... =>
bridge macadd Add a static MAC address entry.
bridge macdelete Delete a MAC address entry.
Page 55
51
CIP Commands
E-SIT-CTC-20021203-0003 v1.0
CIP Commands
Contents
This chapter covers the following commands:
Topic Page
cip flush 52
cip ifadd 53
cip ifdelete 54
cip iflist 55
cip pvcadd 57
cip pvcdelete 58
cip pvclist 59
Page 56
52
CIP Commands
E-SIT-CTC-20021203-0003 v1.0
cip flush
Flush complete Classical IP over ATM (IPoA) configuration.
Note The flush command does not impact previously saved configurations.
SYNTAX:
cip flush
Page 57
53
CIP Commands
E-SIT-CTC-20021203-0003 v1.0
cip ifadd
Create a Classical IPoA interface at the local side of the Logical IP Subnet (LIS).
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
cip ifadd addr = <ip-address>
[netmask = <ip-mask (dotted or cidr)>] [uniaddr = <portspec:address[.selector]>]
addr The Classical IPoA interface's local IP address in the LIS. REQUIRED
netmask The LIS's subnetmask. OPTIONAL
uniaddr The UNI-address/port specification for incoming connections, e.g.
‘A0:*.04‘: ADSL port, any address, selector 3. Only applicable in an Switched Virtual Channel (SVC) environment. In most cases the Classical IPoA LIS is built in a Permanent Virtual Channel (PVC) environment.
OPTIONAL
=>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0
UNI address = A0:*.04 inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0
inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>cip ifadd addr=172.16.1.1 netmask=255.255.255.0 =>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0
UNI address = A0:*.04
inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0
inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 cip0 addr = 172.16.1.1 mask = 255.255.255.0
UNI address = A0:*.03
inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0
inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>
cip ifdelete Delete a Classical IPoA interface.
cip ifadd Show current Classical IPoA configuration.
Page 58
54
CIP Commands
E-SIT-CTC-20021203-0003 v1.0
cip ifdelete
Delete a Classical IPoA interface at the local side of the Logical IP Subnet (LIS).
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
cip ifdelete addr = <ip-address>
addr The Classical IPoA interface's local IP address in the LIS. REQUIRED
=>cip iflist cip0 addr = 172.16.1.1 mask = 255.255.255.0
UNI address = A0:*.03
inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0
inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 cip1 addr = 172.16.0.5 mask = 255.255.255.0
UNI address = A0:*.04
inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0
inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>cip ifdelete addr=172.16.1.1 =>cip iflist cip1 addr = 172.16.0.5 mask = 255.255.255.0
UNI address = A0:*.04
inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0
inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>
cip ifadd Create a Classical IPoA interface.
cip iflist Show current Classical IPoA configuration.
Page 59
55
CIP Commands
E-SIT-CTC-20021203-0003 v1.0
cip iflist
Show current Classical IPoA configuration.
SYNTAX:
EXAMPLE OUTPUT:
DESCRIPTION:
EXAMPLE INPUT/OUTPUT: EVOLUTION OF ARP REQUESTS IN A NETWORKED ENVIRONMENT:
cip iflist
=>cip iflist cip0 addr = 172.16.1.1 mask = 255.255.255.0
UNI address = A0:*.03
inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0
inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 cip1 addr = 172.16.0.5 mask = 255.255.255.0
UNI address = A0:*.04
inarp_reqs_in = 0 inarp_repl_in = 0 inarp_inv_in = 0
inarp_reqs_out = 0 inarp_repl_out = 0 inarp_inv_out = 0 =>
inarp_reqs_in/inarp_reqs_out Incoming/outgoing inverse ARP requests
inarp_repl_in/inarp_repl_out Incoming/outgoing inverse ARP replies
inarp_inv_in/inarp_inv_out Incoming/outgoing invalid inverse ARP messages
=>cip iflist cip0 addr = 200.200.200.138 mask = 255.255.255.0
UNI address = A0:*.03
inarp_reqs_in = 18 inarp_repl_in = 75 inarp_inv_in = 0
inarp_reqs_out = 18 inarp_repl_out = 75 inarp_inv_out = 0 =>cip iflist cip0 addr = 200.200.200.138 mask = 255.255.255.0
UNI address = A0:*.03
inarp_reqs_in = 22 inarp_repl_in = 75 inarp_inv_in = 0
inarp_reqs_out = 22 inarp_repl_out = 75 inarp_inv_out = 0 =>cip iflist cip0 addr = 200.200.200.138 mask = 255.255.255.0
UNI address = A0:*.03
inarp_reqs_in = 22 inarp_repl_in = 76 inarp_inv_in = 0
inarp_reqs_out = 22 inarp_repl_out = 76 inarp_inv_out = 0 =>
Page 60
56
CIP Commands
E-SIT-CTC-20021203-0003 v1.0
RELATED COMMANDS:
cip ifadd Create a Classical IPoA interface.
cip ifdelete Delete a Classical IPoA interface.
Page 61
57
CIP Commands
E-SIT-CTC-20021203-0003 v1.0
cip pvcadd
Create a PVC Address Resolution Protocol (ARP) entry for destinations which are not RFC 1577/RFC2225 compliant.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
cip pvcadd dest = <phonebookname>
[destaddr = <ip-address>] [mtu = <number {273-20000}>]
dest The ATM address (hardware address) of the destination host.
Typically a phonebook name.
REQUIRED
[destaddr] The IP address of the destination host. OPTIONAL
[mtu] A number between 273 and 20000 (bytes).
Represents the maximum ATM Adaption Layer 5 (AAL5) packet size for this connection. By default the mtu is 9180 bytes.
OPTIONAL
=>phonebook list Name Type Use Address Br1 bridge 1 8.35 Br2 bridge 1 8.36 Br3 bridge 1 8.37 Br4 bridge 0 8.38 RELAY_PPP1 ppp 0 8.48 RELAY_PPP2 ppp 0 8.49 RELAY_PPP3 ppp 0 8.50 RELAY_PPP4 ppp 0 8.51 PPP1 ppp 1 8.64 PPP2 ppp 1 8.65 PPP3 ppp 1 8.66 DHCP_SPOOF ppp 1 8.67 CIPPVC1 cip 0 8.80 CIPPVC2 cip 0 8.81 CIPPVC3 cip 0 8.82 CIPPVC4 cip 0 8.83 =>cip pvclist =>cip pvcadd dest CIPPVC1 destaddr 172.16.1.2 mtu 546 =>cip pvclist CIPPVC1 atmport = 0 vpi = 8 vci = 80 dest_ip = 172.16.1.2
encaps = llc mtu = 546
=>
cip pvcdelete Delete a PVC ARP entry.
cip pvclist Show current PVC ARP entries.
Page 62
58
CIP Commands
E-SIT-CTC-20021203-0003 v1.0
cip pvcdelete
Delete a PVC ARP entry.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
cip pvcdelete dest = <phonebookname>
dest Typically a phonebook entry name.
Represents the ATM address (hardware address) or name of the entry to delete.
REQUIRED
=>cip pvclist CIPPVC1 atmport = 0 vpi = 8 vci = 80 dest_ip = 172.16.1.2
encaps = llc mtu = 546 =>cip pvcdelete dest=CIPPVC1 =>cip pvclist =>
cip pvcadd Create a PVC ARP entry.
cip pvclist Show current PVC ARP entries.
Page 63
59
CIP Commands
E-SIT-CTC-20021203-0003 v1.0
cip pvclist
Show current PVC ARP entries.
SYNTAX:
EXAMPLE OUTPUT:
EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
RELATED COMMANDS:
cip pvclist
=>cip pvclist CIPPVC1 atmport = 0 vpi = 8 vci = 80 dest_ip = 172.16.1.2
encaps = llc mtu = 546 =>
=>cip iflist cip0 addr = 200.200.200.138 mask = 255.255.255.0
UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = 75 inarp_inv_in = 0
inarp_reqs_out = 0 inarp_repl_out = 75 inarp_inv_out = 0 =>cip pvclist 699 atmport = 0 vpi = 6 vci = 99 dest_ip = 172.16.1.3
encaps = llc mtu = 9180
8.50 atmport = 0 vpi = 8 vci = 50 dest_ip = 200.200.200.14
encaps = llc mtu = 9180
=>
cip pvcdelete Delete a PVC ARP entry.
cip pvcadd Create a PVC ARP entry.
Page 64
60
CIP Commands
E-SIT-CTC-20021203-0003 v1.0
Page 65
61
Config Commands
E-SIT-CTC-20021203-0003 v1.0
Config Commands
Contents
This chapter covers the following commands:
Topic Page
config erase 62
config flush 63
config load 64
config save 65
Page 66
62
Config Commands
E-SIT-CTC-20021203-0003 v1.0
config erase
Physically remove all saved configurations, i.e. the user configuration file, saved in the SpeedTouchTM permanent storage, is deleted.
SYNTAX:
RELATED COMMANDS:
config erase
config flush Flush complete runtime configuration.
config load Load complete saved or default configuration.
config save Save complete runtime configuration.
Page 67
63
Config Commands
E-SIT-CTC-20021203-0003 v1.0
config flush
Flush complete current configuration without affecting saved configurations.
This combines all flush commands: bridge flush, cip flush, dhcp client flush, dhcp server flush, dns flush, env flush, firewall flush, firewall rule flush, ipoa flush, mer flush, nat flush, phonebook flush, ppp flush, pptp flush, qosbook flush, system flush and optionally ip flush.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
config flush [flush_ip = <{no|yes}>]
[flush_ip] Keep current IP configuration (yes) or not (no).
Not keeping the IP settings could cause lost IP connectivity in the LAN. By default IP settings are preserved.
OPTIONAL
=>ip rtlist
Destination Source Gateway Intf Mtrc
10.0.0.0/24 10.0.0.0/24 10.0.0.140 eth0 0
172.16.0.5/32 0.0.0.0/0 172.16.0.5 cip1 0
10.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 0
127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0
10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 0
172.16.0.0/24 0.0.0.0/0 172.16.0.5 cip1 1 =>config flush flush_ip=no =>ip rtlist
Destination Source Gateway Intf Mtrc
10.0.0.0/24 10.0.0.0/24 10.0.0.140 eth0 0
10.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 0
127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0
10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 0 =>config flush flush_ip=yes
######### ALL TCP/IP CONNECTIVITY IS LOST ##########
config erase Physically remove all saved configurations.
config load Load complete saved or default configuration.
config save Save current runtime configuration.
Page 68
64
Config Commands
E-SIT-CTC-20021203-0003 v1.0
config load
Load complete saved or default configuration.
Note Execute config flush prior to config load.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
config load [load_ip = <{no|yes}>]
[defaults = <{yes|no}>]
[load_ip] Load IP settings (yes) or not (no).
Not keeping the IP settings could cause lost IP connectivity in the LAN.
OPTIONAL
[defaults] Load default configuration (yes) or saved configuration (no).
Not specifying this parameter loads the saved configuration
OPTIONAL
=>ip rtlist
Destination Source Gateway Intf Mtrc
10.0.0.0/24 10.0.0.0/24 10.0.0.140 eth0 0
172.16.0.5/32 0.0.0.0/0 172.16.0.5 cip1 0
10.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 0
127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0
10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 0
172.16.0.0/24 0.0.0.0/0 172.16.0.5 cip1 1 =>config flush flush_ip=no =>ip rtlist
Destination Source Gateway Intf Mtrc
10.0.0.0/24 10.0.0.0/24 10.0.0.140 eth0 0
10.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 0
127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0
10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 0 =>config load load_ip=yes =>ip rtlist
Destination Source Gateway Intf Mtrc
10.0.0.0/24 10.0.0.0/24 10.0.0.140 eth0 0
10.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 0
172.16.0.5/32 0.0.0.0/0 172.16.0.5 cip1 0
127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 0
10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 0
172.16.0.0/24 0.0.0.0/0 172.16.0.5 cip1 1 =>
config erase Physically remove all saved configurations.
config flush Flush complete runtime configuration.
config save Save current runtime configuration.
Page 69
65
Config Commands
E-SIT-CTC-20021203-0003 v1.0
config save
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
TM
permanent storage. This file can be
downloaded via the SpeedTouch
TM
web pages or via an FTP session.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
config save
=>config save =>
config erase Physically remove all saved configurations.
config flush Flush complete current configuration.
config load Load complete saved or default configuration.
Page 70
66
Config Commands
E-SIT-CTC-20021203-0003 v1.0
Page 71
67
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
DHCP Commands
Contents
Topic Page
dhcp client clear 68
dhcp client config 69
dhcp client flush 70
dhcp client ifadd 71
dhcp client ifattach 72
dhcp client ifconfig 73
dhcp client ifdelete 75
dhcp client iflist 76
dhcp client ifrelease 77
dhcp client ifrenew 79
dhcp client stats 81
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
Page 72
68
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client clear
Clear Dynamic Host Configuration Protocol (DHCP) client statistics.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp client clear
=>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 0 ACKs recv : 0 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 253 REQUESTs sent : 9 DECLINEs sent : 0 RELEASEs sent : 0 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % =>dhcp client clear =>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 0 ACKs recv : 0 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 0 REQUESTs sent : 0 DECLINEs sent : 0 RELEASEs sent : 0 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % =>
dhcp client stats Show DHCP client statistics.
Page 73
69
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client config
Show/set DHCP client configuration.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp client config [trace = <{off|on}>]
[trace] Enable tracing (on) or not (off). OPTIONAL
=>dhcp client config tracing: off =>dhcp client config trace=on =>dhcp client config tracing: on =>
dhcp client ifconfig Configure a DHCP lease created for a specific interface.
Page 74
70
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client flush
Flush complete DHCP client configuration and dynamic interfaces.
Note The flush command does not impact previously saved configurations.
SYNTAX:
EXAMPLE:
dhcp client flush
=>dhcp client iflist NewMer : [SELECTING]
flags= uc IP address : 10.0.0.10 HW address : 0:90:d0:01:47:de DHCP server : 255.255.255.255 hostname : NewLease req.leasetime= 10800 s trying to get a lease for 8 min, 32 sec transmission of DISCOVER in 57 sec retransmission timeout: 64
nbr of retransmissions: 14 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>dhcp client flush =>dhcp client iflist No dynamic interfaces defined. =>
Page 75
71
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client ifadd
Create a DHCP lease for a specific interface.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp client ifadd intf = <interface name>
intf The name of an existing interface, e.g. created via :mer ifadd. REQUIRED
=>dhcp client iflist No dynamic interfaces defined. =>dhcp client ifadd intf=NewMer =>dhcp client iflist NewMer : [INIT]
flags= uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de
DHCP server : 255.255.255.255 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>
dhcp client ifattach Attach a DHCP lease to an interface.
dhcp client ifconfig Configure a DHCP lease created for a specific interface.
dhcp client ifdelete Delete a dynamic interface.
dhcp client iflist Show all dynamic interfaces.
Page 76
72
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client ifattach
Attach a DHCP lease to a dynamic interface.
Note Create the interface first with :dhcp client ifadd.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp client ifattach intf = <interface name>
intf The name of the dynamic interface. REQUIRED
=>dhcp client iflist NewMer : [INIT]
flags= uc
IP address : 0.0.0.0
HW address : 00:90:d0:01:47:de
DHCP server : 255.255.255.255 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>dhcp client ifattach intf=NewMer =>dhcp client iflist NewMer : [SELECTING]
flags= uc
IP address : 10.0.0.10
HW address : 0:90:d0:01:47:de
DHCP server : 255.255.255.255
hostname : NewLease
req.leasetime = 10800 s
trying to get a lease for 8 min, 32 sec
transmission of DISCOVER in 57 sec
retransmission timeout: 64
nbr of retransmissions: 14 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>
dhcp client ifadd Create a DHCP lease for a specific interface.
dhcp client ifconfig Configure a DHCP lease created for a specific interface.
dhcp client ifrelease Release a lease attached to a dynamic interface.
dhcp client iflist Show all dynamic interfaces.
Page 77
73
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client ifconfig
Show/set the configuration of DHCP lease created for a specific interface.
Note Execute the dhcp client ifrelease command before configuring the dhcp client.
SYNTAX:
dhcp client ifconfig intf = <interface name>
[clientid = <{client-id|none}>] [hostname = <hostname|"">] [addr = <ip-address>] [leasetime = <number>] [addrtrans = <{none|pat}>] [dns = <{off|on}>] [gateway = <{off|on}>] [metric = <number{0-100}>]
intf The 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.
OPTIONAL
[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.
OPTIONAL
[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.
OPTIONAL
[addrtrans] Automatically enable address translation for this dynamic interface
(pat) or not (none).
OPTIONAL
[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
Page 78
74
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
EXAMPLE:
RELATED COMMANDS:
=>dhcp client iflist NewMer : [INIT]
flags= uc
IP address : 0.0.0.0
HW address : 00:90:d0:01:47:de
DHCP server : 255.255.255.255 Number of leases: 1 Total size of table: 19, in use: 1, free: 4 % =>dhcp client ifconfig intf=NewMer hostname=NewLease addr=10.0.0.10 leasetime=10800 =>dhcp client iflist NewMer : [INIT]
flags= uc
IP address : 10.0.0.10
HW address : 00:90:d0:01:47:de
DHCP server : 255.255.255.255
hostname : NewLease
req.leasetime = 10800 s Number of leases: 1 Total size of table: 19, in use: 1, free: 4 % =>
dhcp client ifadd Create a DHCP lease for a specific interface.
dhcp client ifdelete Delete a dynamic interface.
dhcp client iflist Show all dynamic interfaces.
dhcp client ifrelease Release a lease attached to a dynamic interface.
Page 79
75
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client ifdelete
Delete a dynamic interface.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp client ifdelete intf = <interface name>
intf The name of the dynamic interface. REQUIRED
=>dhcp client iflist NewMer : [SELECTING]
flags= uc
IP address : 10.0.0.10
HW address : 00:90:d0:01:47:de
DHCP server : 255.255.255.255
hostname : NewLease
req.leasetime = 10800 s
trying to get a lease for 8 min, 32 sec
transmission of DISCOVER in 57 sec
retransmission timeout: 64
nbr of retransmissions: 14 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>dhcp client ifdelete intf NewMer =>dhcp client iflist No dynamic interfaces defined. =>
dhcp client ifadd Create a DHCP lease for a specific interface.
dhcp client ifattach Attach a DHCP lease to an interface.
dhcp client ifconfig Configure a DHCP lease created for a specific interface.
dhcp client iflist Show all dynamic interfaces.
dhcp client ifrelease Release a lease attached to a dynamic interface.
Page 80
76
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client iflist
Show all dynamic interfaces.
SYNTAX:
EXAMPLE:
EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
The SpeedTouch
TM
is configured as DHCP client on its Ethernet interface eth0.
RELATED COMMANDS:
dhcp client iflist
=>dhcp client iflist NewMer : [INIT]
flags= uc
IP address : 0.0.0.0
HW address : 00:90:d0:01:47:de
DHCP server : 255.255.255.255 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>
=>dhcp client iflist eth0 : [BOUND]
flags= uc
IP address : 10.0.0.3
HW address : 00:90:d0:01:47:f1
DHCP server : 10.10.1.1
lease renewal in 5 days, 1 h, 26 min, 45 sec
lease rebinding in 8 days, 20 h, 34 min, 15 sec
lease expires in 10 days, 2 h, 56 min, 45 sec Number of leases: 1 Total size of table: 18, in use: 1, free: 94 % =>dhcp client iflist eth0 : [BOUND]
flags= uc
IP address : 10.0.0.3
HW address : 00:90:d0:01:47:f1
DHCP server : 10.10.1.1
lease renewal in 5 days, 1 h, 25 min, 27 sec
lease rebinding in 8 days, 20 h, 32 min, 57 sec
lease expires in 10 days, 2 h, 55 min, 27 sec Number of leases: 1 Total size of table: 18, in use: 1, free: 94 % =>
dhcp client ifadd Create a DHCP lease for a specific interface.
dhcp client ifdelete Delete a dynamic interface.
Page 81
77
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client ifrelease
Release a lease attached to a dynamic interface.
SYNTAX:
EXAMPLE:
dhcp client ifrelease intf = <interface name>
intf The name of the dynamic interface. REQUIRED
=>dhcp client iflist NewMer : [SELECTING]
flags= uc
IP address : 10.0.0.10
HW address : 00:90:d0:01:47:de
DHCP server : 255.255.255.255
hostname : NewLease
req.leasetime = 10800 s
trying to get a lease for 8 min, 32 sec
transmission of DISCOVER in 57 sec
retransmission timeout: 64
nbr of retransmissions: 14 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>dhcp client ifattach intf=NewMer =>dhcp client iflist NewMer : [SELECTING]
flags= uc
IP address : 0.0.0.0
HW address : 00:90:d0:01:47:de
DHCP server : 255.255.255.255
hostname : NewLease
req.leasetime = 10800 s Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>
Page 82
78
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
The SpeedTouch
TM
is configured as DHCP client on its Ethernet interface eth0.
RELATED COMMANDS:
=>dhcp client iflist eth0 : [BOUND]
flags= uc
IP address : 10.0.0.3
HW address : 00:90:d0:01:47:f1
DHCP server : 10.10.1.1
lease renewal in 5 days, 58 min, 45 sec
lease rebinding in 8 days, 20 h, 6 min, 18 sec
lease expires in 10 days, 2 h, 28 min, 48 sec Number of leases: 1 Total size of table: 18, in use: 1, free: 94 % =>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 DECLINEs sent : 0 RELEASEs sent : 0 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % =>dhcp client ifrelease intf=eth0 =>(CTRL + Q) =>STATE ACTIVATE ! STATE IDLE ! STATE ACTIVATE ! dhcc: intf 1 releases 10.0.0.3 to server 10.10.1.1. dhcc: 10.0.0.3 deleted: ok. STATE IDLE ! STATE ACTIVATE !
.............
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 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % =>
dhcp client ifattach Attach a DHCP lease to an interface.
dhcp client ifconfig Configure a DHCP lease created for a specific interface.
dhcp client ifdelete Delete a dynamic interface.
Page 83
79
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client ifrenew
Renew the lease of a dynamic interface.
SYNTAX:
EXAMPLE:
dhcp client ifrenew intf = <interface name>
intf The name of the dynamic interface. REQUIRED
=>dhcp client iflist NewMer : [BOUND]
flags= uc
IP address : 10.0.0.10
HW address : 00:90:d0:01:47:f1
DHCP server : 255.255.255.255
hostname : NewLease
req.leasetime = 10800 s
lease renewal in 5 days, 58 min, 48 sec
lease rebinding in 8 days, 20 h, 6 min, 18 sec
lease expires in 10 days, 2 h, 28 min, 48 sec Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>dhcp client ifrenew intf=NewMer =>dhcp client iflist NewMer : [SELECTING]
flags= uc
IP address : 10.0.0.10
HW address : 00:90:d0:01:47:de
DHCP server : 255.255.255.255
hostname : NewLease
req.leasetime = 10800 s
trying to get a lease for 12 sec
transmission of DISCOVER in 24 sec
retransmission timeout: 64
nbr of retransmissions: 11 Number of leases: 1 Total size of table: 19, in use: 1, free: 94 % =>
Page 84
80
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT:
The SpeedTouch
TM
is configured as DHCP client on its Ethernet interface eth0.
RELATED COMMANDS:
=>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 0 ACKs recv : 0 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 0 REQUESTs sent : 0 DECLINEs sent : 0 RELEASEs sent : 1 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 18, in use: 1, free: 94 % =>dhcp client ifrenew intf=eth0 =>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 1 ACKs recv : 1 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 1 REQUESTs sent : 1 DECLINEs sent : 0 RELEASEs sent : 1 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 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)
dhcp client ifadd Create a DHCP lease for a specific interface.
dhcp client ifattach Attach a DHCP lease to an interface.
Page 85
81
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp client stats
Show DHCP client statistics.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp client stats
=>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 1 ACKs recv : 1 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 244 REQUESTs sent : 9 DECLINEs sent : 0 RELEASEs sent : 1 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % =>
dhcp client clear Clear DHCP client statistics.
Page 86
82
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server clear
Clear SpeedTouchTM DHCP server statistics.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp server clear
=>dhcp client stats Corrupted packet recv : 0 OFFERs recv : 9575 ACKs recv : 121 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 9552 REQUESTs sent : 142 DECLINEs sent : 0 RELEASEs sent : 0 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % =>dhcp server clear =>dhcp client stats DHCP client statistics: Corrupted packet recv : 0 OFFERs recv : 0 ACKs recv : 0 NAKs recv : 0 Pure BOOTP REPLIES : 0 Other message types : 0 DISCOVERs sent : 0 REQUESTs sent : 0 DECLINEs sent : 0 RELEASEs sent : 0 INFORMs sent : 0 Number of dynamic interfaces: 1 Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % =>
dhcp server stats Show DHCP server statistics.
Page 87
83
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server config
Show/set SpeedTouchTM DHCP server configuration settings.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp server config [autodhcp = <{off|on}>]
[scantime = <number>] [spoofing = <{off|on}>] [trace = <{off|on}>]
[autodhcp] Allow the SpeedTouch
TM
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).
OPTIONAL
[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.
OPTIONAL
[spoofing] Allow a remote DHCP server to hand out IP addresses negotiated
by PPP on WAN side (yes) or not (no). DHCP spoofing is used to relay local DHCP requests to an 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.
OPTIONAL
[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.
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 =>
dhcp server stats Show current DHCP server state and statistics.
Page 88
84
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server flush
Flushes all DHCP server pool and lease entries.
Note The flush command does not impact previously saved configurations.
SYNTAX:
RELATED COMMANDS:
dhcp server flush
dhcp server stats Show current DHCP server state and statistics.
dhcp server config Show/set current DHCP server configuration.
Page 89
85
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server policy
Show/set SpeedTouchTM DHCP server policy.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp server policy [verifyfirst = <off|on>]
[trustclient = <off|on>]
[verifyfirst] Probe the network for conflicting IP addresses before giving a
suggested IP address to the requesting DHCP client (on) or not (off).
OPTIONAL
[trustclient] Take the IP address suggested by a DHCP client into account (on) or
not (off).
OPTIONAL
=>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 =>
dhcp server stats Show current DHCP server state and statistics.
dhcp server config Show/set current DHCP server configuration.
Page 90
86
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
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:
EXAMPLE:
RELATED COMMANDS:
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
TM
should try to set up a PPP connection before returning to normal DHCP mode, i.e. in case the PPP connection cannot be established within the time lapse determined by failtime, the SpeedTouch
TM
DHCP server will allocate an local private IP address to the DHCP client. By default the failtime is 4 seconds.
OPTIONAL
[errorlt] A number between 0 and 1814400 (seconds).
Represents the leasetime of the private address issued when a 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.
OPTIONAL
[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 trig­gered PPP link is available. By default the dial-on-demand lease time is 10 seconds.
OPTIONAL
=>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 =>
dhcp server policy Set DHCP server policy.
dhcp server stats Show current DHCP server state and statistics.
Page 91
87
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server start
Start SpeedTouchTM DHCP server.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp server start
=>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 server stats Show current DHCP server state and statistics.
dhcp server stop Stop DHCP server.
Page 92
88
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server stats
Show SpeedTouchTM DHCP server statistics.
SYNTAX:
EXAMPLE OUTPUT:
dhcp server stats
=>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 % =>
Page 93
89
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
DESCRIPTION:
RELATED COMMANDS:
DHCP server state Indicates the state of the SpeedTouch
TM
DHCP server.
Corrupted packet recv
Indicates the number of corrupted packets (not complaint to RFC2131) received from the LAN.
DISCOVER Indicates 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.
REQUEST Indicates the number of DHCP address lease requests received from the LAN.
DECLINE Indicates the number of DHCP address lease requests declined.
RELEASE Indicates the number of DHCP address release requests received from DHCP clients.
INFORM Indicates the number of information requests received from DHCP clients.
Pure BOOTP requests
Indicates the number of BOOTP requests received from the LAN.
OFFERs sent Indicates the number of IP address offers sent in reply to DHCP requests.
ACKs sent Indicates the number of ACKnowledgement replies sent to successfully configured DHCP
clients.
NAKs sent Indicates the number of Not-AcKnowledgement replies sent to wrongly configured
DHCP clients.
Lease table got full Indicates whether the maximum number of DHCP leases is reached or not.
Ping table got full Indicates whether the history list of IP address pings got full or not. These pings are sent
by the SpeedTouch
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 server
Indicates whether a concurrent DHCP server was found on the LAN or not.
dhcp server clear Clear DHCP server statistics.
Page 94
90
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server stop
Stop SpeedTouchTM DHCP server.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp server stop
=>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
.....
=>
dhcp server start Start DHCP server.
dhcp server stats Show current DHCP server state and statistics.
Page 95
91
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server lease add
Assign a DHCP server lease to a DHCP host in the local network.
SYNTAX:
EXAMPLE:
dhcp server lease add clientid = <client-id>
pool = <string> [addr = <ip-address>] [offset = <number>] [leasetime = <number>] [hostname = <{hostname|""}>]
clientid The DHCP client identification string of the booting host. REQUIRED
pool The 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.
REQUIRED
[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.
OPTIONAL
[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.
OPTIONAL
[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.
OPTIONAL
[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.
OPTIONAL
=>dhcp server lease list Lease Pool TTL State Clientid 0 0.0.0.0 dhcp_pool_1 00:26:40 FREE 00: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 Lease Pool TTL State Clientid 0 0.0.0.0 dhcp_pool_1 00:26:40 FREE 00:90:D0:12:34:56 1 10.0.0.1 local_pool 00:59:22 USED 01:23:45:67:89:AB =>
Page 96
92
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
RELATED COMMANDS:
dhcp server lease delete Delete a DHCP lease.
dhcp server lease flush Delete all DHCP leases.
dhcp server lease list Show current DHCP leases.
Page 97
93
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server lease delete
Delete a DHCP lease.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp server lease delete clientid = <clientid>
[index = <number>]
clientid The 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.
OPTIONAL
=>dhcp server lease list Lease Pool TTL State Clientid 0 0.0.0.0 dhcp_pool_1 00:26:40 FREE 00:90:D0:12:34:56 1 10.0.0.1 local_pool 00:59:22 USED 01:23:45:67:89:AB =>dhcp server lease delete index=0 =>dhcp server lease list Lease Pool TTL State Clientid 1 10.0.0.1 local_pool 00:59:22 USED 01:23:45:67:89:AB =>
dhcp server lease add Add a DHCP lease manually.
dhcp server lease flush Delete all DHCP leases.
dhcp server lease list Show current DHCP leases.
Page 98
94
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server lease flush
Flush complete DHCP server configuration and dynamic leases.
Note The flush command does not impact previously saved configurations.
SYNTAX:
EXAMPLE:
RELATED COMMANDS:
dhcp server lease flush
=>dhcp server lease list Lease Pool TTL State Clientid 0 0.0.0.0 dhcp_pool_1 00:26:40 FREE 00:90:D0:12:34:56 1 10.0.0.1 local_pool 00:59:22 USED 01:23:45:67:89:AB 2 10.0.0.101 local_pool 00:21:01 USED 01:23:89:AB:80:CD 3 10.0.0.132 local_pool 00:45:37 USED 09:D0:25:CE:F1:31 5 10.0.0.5 local_pool 00:21:11 USED AB:33:A1:7C:89:DD 4 10.0.0.6 local_pool 00:59:01 USED E3:81:9F:11:11:11 8 10.0.0.8 local_pool 00:01:00 USED 08:80:09:90:AB:DC 9 10.0.0.15 local_pool 00:00:23 USED 08:93:DA:AE:01:AF =>dhcp server lease flush =>dhcp server lease list =>
dhcp server lease add Add a DHCP lease manually.
dhcp server lease delete Delete a DHCP lease.
dhcp server lease list Show current DHCP leases.
Page 99
95
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server lease list
List current DHCP leases, indicated by their index number.
SYNTAX:
EXAMPLE OUTPUT:
RELATED COMMANDS:
dhcp server lease list
=>dhcp server lease list =>dhcp server lease list Lease Pool TTL State Clientid 0 0.0.0.0 dhcp_pool_1 00:26:40 FREE 00:90:D0:12:34:56 1 10.0.0.1 local_pool 00:59:22 USED 01:23:45:67:89:AB 2 10.0.0.101 local_pool 00:21:01 USED 01:23:89:AB:80:CD 3 10.0.0.132 local_pool 00:45:37 USED 09:D0:25:CE:F1:31 5 10.0.0.5 local_pool 00:21:11 USED AB:33:A1:7C:89:DD 4 10.0.0.6 local_pool 00:59:01 USED E3:81:9F:11:11:11 8 10.0.0.8 local_pool 00:01:00 USED 08:80:09:90:AB:DC 9 10.0.0.15 local_pool 00:00:23 USED 08:93:DA:AE:01:AF =>
dhcp server lease add Add a DHCP lease manually.
dhcp server lease delete Delete a DHCP lease.
dhcp server lease flush Delete complete DHCP server configuration and dynamic leases.
Page 100
96
DHCP Commands
E-SIT-CTC-20021203-0003 v1.0
dhcp server pool add
Add a DHCP server pool.
SYNTAX:
EXAMPLE:
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.
OPTIONAL
[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.
OPTIONAL
=>dhcp server pool list Pool Start End State PPP 0 dhcp_pool_1 0.0.0.0 0.0.0.0 FREE 1 My_LAN_Pool 10.0.0.1 10.0.0.254 USED 2 dhcp_pool_2 0.0.0.0 0.0.0.0 FREE =>dhcp server pool add =>dhcp server pool list Pool Start End State PPP 0 dhcp_pool_1 0.0.0.0 0.0.0.0 FREE 1 My_LAN_Pool 10.0.0.1 10.0.0.254 USED 2 dhcp_pool_2 0.0.0.0 0.0.0.0 FREE 3 dhcp_pool_3 0.0.0.0 0.0.0.0 FREE =>dhcp server pool add name=POOL_EXTRA1 =>dhcp server pool list Pool Start End State PPP 0 dhcp_pool_1 0.0.0.0 0.0.0.0 FREE 1 My_LAN_Pool 10.0.0.1 10.0.0.254 USED 2 dhcp_pool_2 0.0.0.0 0.0.0.0 FREE 3 dhcp_pool_3 0.0.0.0 0.0.0.0 FREE 4 POOL_EXTRA1 0.0.0.0 0.0.0.0 FREE =>ppp ifconfig name=PPP_Test pool=POOL_EXTRA1 =>dhcp server pool list Pool Start End State PPP 0 dhcp_pool_1 0.0.0.0 0.0.0.0 FREE 1 My_LAN_Pool 10.0.0.1 10.0.0.254 USED 2 dhcp_pool_2 0.0.0.0 0.0.0.0 FREE 3 dhcp_pool_3 0.0.0.0 0.0.0.0 FREE 4 POOL_EXTRA1 0.0.0.0 0.0.0.0 FREE PPP_Test =>
Loading...
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use