SpeedTouch™ 500Series Multi-User ADSL Gateways CLI Reference Guide Release R4.
SpeedTouch™ 500Series CLI Reference Guide Release R4.
Status Change Note Short Title Copyright Released PeckelbeenS CLI ST500Series R4.2 © 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.
Content About this Document .................................................................................... 17 CLI Navigation ............................................................................................... 19 Accessing the Command Line Interface .................................................................................................................... 20 Basic Navigation and Manipulation............................................................................................
Bridge Commands ......................................................................................... 53 bridge config ..................................................................................................................................................................... 54 bridge flush ....................................................................................................................................................................... 55 bridge ifadd .......................
DHCP Commands ......................................................................................... 89 dhcp client clear .............................................................................................................................................................. 91 dhcp client config ............................................................................................................................................................ 92 dhcp client flush.............................
DNS Commands .......................................................................................... 131 dns add ............................................................................................................................................................................132 dns clear ..........................................................................................................................................................................133 dns clrstats........................
ETHoA Commands ..................................................................................... 163 ethoa flush.......................................................................................................................................................................164 ethoa ifadd ......................................................................................................................................................................165 ethoa ifattach.............................
IP Commands ............................................................................................... 195 ip apadd ...........................................................................................................................................................................196 ip apdelete.......................................................................................................................................................................198 ip aplist.........................
Label Commands ......................................................................................... 235 label add ..........................................................................................................................................................................236 label config ......................................................................................................................................................................237 label delete........................
NAT Commands .......................................................................................... 259 nat applist........................................................................................................................................................................260 nat bind............................................................................................................................................................................261 nat bindlist.........................
PPPoE Commands....................................................................................... 305 pppoe flush .....................................................................................................................................................................306 pppoe ifadd .....................................................................................................................................................................307 pppoe ifattach..............................
SNMP Commands........................................................................................ 347 snmp config.....................................................................................................................................................................348 snmp get..........................................................................................................................................................................349 snmp getNext ...............................
UPnP Commands......................................................................................... 379 upnp config .....................................................................................................................................................................380 upnp flush........................................................................................................................................................................381 upnp list ................................
Syslog Messages............................................................................................ 405 Auto-PVC Module ........................................................................................................................................................406 Configuration Module ..................................................................................................................................................406 DHCP CLient Module ......................................
About this Document About this Document Introduction Welcome to the SpeedTouch™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™500Series CLI command set, to be used by the end-user to configure the SpeedTouch™500Series and PC(s).
About this Document Trademarks The following trademarks are used in this document: • SpeedTouch™ 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 MacOS are registered trademarks of Apple Computer Inc. • UNIX is a registered trademark of UNIX System Laboratories, Inc. • Ethernet is a trademark of Xerox Corporation.
CLI Navigation CLI Navigation Contents This chapter covers the following topics: Topic Page Accessing the Command Line Interface 20 Basic Navigation and Manipulation 21 Command Line Interface Top Level Structure 25 Command Line Interface Commands 26 Menu-driven CLI Navigation 27 Configuration Profile Files and the CLI 28 E-SIT-CTC-20030410-0049 v1.
CLI Navigation 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™500Series. .As soon a session to the CLI is opened, the SpeedTouch™500Series banner pops up, followed by the CLI prompt. In case the SpeedTouch™500Series is protected by a System password, authentication will be required before access is granted.
CLI Navigation 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.
CLI Navigation The Help Command Execute help or ? from top level to list all available command groups for the SpeedTouch™500Series. EXAMPLE for the SpeedTouch™510: =>help Following commands are available : help menu ? exit .. saveall : : : : : : Displays this help information Displays menu Displays this help information Exits this shell. Exits group selection. Saves current configuration.
CLI Navigation As both help and ? have the exact same functionality in the SpeedTouch™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. EXAMPLE: =>firewall help Following commands are available : assign unassign list flush tron troff : : : : : : Assign a chain to an entry point.
CLI Navigation 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.
CLI Navigation Command Line Interface Top Level Structure The table below shows the available command groups for the different SpeedTouch™500Series variants: Command group Availability adsl Only applicable for the SpeedTouch™510 and SpeedTouch™570 ADSL/POTS, and the SpeedTouch™510i and SpeedTouch™570i ADSL/ISDN variants.
CLI Navigation Command Line Interface Commands All CLI commands are commands that operate on, or configure, the SpeedTouch™500Series 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.
CLI Navigation Menu-driven CLI Navigation To improve the user-friendliness of the SpeedTouch™500Series 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™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 '..
CLI Navigation Configuration Profile Files and the CLI Configuration Profile Files The configuration profile files, used by the Setup wizard, or directly uploaded via the SpeedTouch™500Series web pages, consist of a set of CLI commands. Only CLI commands, which are part of the SpeedTouch™500Series CLI command set may be used in the .ini and .def files. For readability, configuration profile files are partitioned in paragraphs.
CLI Navigation [.ini] paragraphs Available SpeedTouch™500Series CLI commands [phone.ini] The phonebook CLI command group [ppp.ini] The ppp CLI command group [pppoa.ini] The pppoa CLI command group [pppoe.ini] The pppoe CLI command group [pppoerelay.ini] The pppoe relay CLI command subgroup [pptp.ini] The pptp CLI command group [qos.ini] The qosbook CLI command group [script.ini] The script CLI command group [snmp.ini] The snmp CLI command group [system.
CLI Navigation 30 E-SIT-CTC-20030410-0049 v1.
ADSL Commands ADSL Commands Contents This chapter covers the following commands: Topic Page adsl config 32 adsl info 33 31
ADSL Commands adsl config Show/set the Asymmetric Digital Subscriber Line (ADSL) configuration. Although the same command for both SpeedTouch™ ADSL/POTS and SpeedTouch™ ADSL/ISDN variants, the command features specific parameter values per variant: SYNTAX for ADSL/Plain Old Telephone Service (POTS) variants: adsl config [opermode = <{ansi|g.dmt_annex_a|g.lite|multimode}>] [maxbitspertoneUS = ] [trace = <{off|on}>] opermode The operational mode of the SpeedTouch™ modem.
ADSL Commands adsl info Show ADSL statistics and information about the SpeedTouch™ DSL line status. Although the same command for both SpeedTouch™ ADSL/POTS and SpeedTouch™ ADSL/ISDN variants, the command features specific output parameters and counters per variant: SYNTAX: adsl info EXAMPLE (for a SpeedTouch™500Series ADSL/POTS variant): =>adsl info Modemstate Operation Mode Channel Mode Number of resets : : : : up G.
ADSL Commands .. Continued output ..
ATM Commands ATM Commands Contents This chapter covers the following commands: Topic Page atm aal5stats 36 atm gstats 37 atm portstats 38 atm vcstats 39 atm oam ccconfig 40 atm oam cclist 42 atm oam ccsend 43 atm oam config 45 atm oam mode 46 atm oam ping 47 atm oam status 48 35
ATM Commands atm aal5stats Display AAL5 port specific Asynchronous Transfer Mode (ATM) statistics SYNTAX: atm aal5stats port = <{dsl0|dsl1|atm2|atm3|aal5|atm5} or number> vpi = [vci = ] [reset = <{no|yes}>] port Port for which statistics will be retrieved. Choose between: • DSL0 • DSL1 • ATM2 • ATM3 • AAL5 • ATM5 REQUIRED Or specify a port number (dsl0 has port number 0, ..., atm5 has port number 5).
ATM Commands atm gstats Display ATM global statistics. SYNTAX: atm gstats [reset = <{no|yes}>] reset Reset the statistics after request Note OPTIONAL The command :atm portstats is replaced by the command :atmstats portstats for the SpeedTouch™570. The command :atmstats portstats is the only ATM command for the SpeedTouch™570. EXAMPLE: =>atm gstats # of # of # of # of # of # of # of => received octets = 170554. transmitted octets = 519665. received cells = 3218. transmitted cells = 9805.
ATM Commands atm portstats Show port specific ATM statistics. SYNTAX: atm portstats port = <{dsl0|dsl1|atm2|atm3|aal5|atm5} or number> [reset = <{no|yes}>] port Port for which statistics will be retrieved. Choose between: • DSL0 • DSL1 • ATM2 • ATM3 • AAL5 • ATM5 REQUIRED Or specify a port number (dsl0 has port number 0, ..., atm5 has port number 5). The parameter DSL0 is replaced by the parameter ADSL0 for the SpeedTouch™570. reset Reset the statistics after request.
ATM Commands atm vcstats Display VC specific atm statistics SYNTAX: atm vcstats port = <{dsl0|dsl1|atm2|atm3|aal5|atm5} or number> vpi = [vci = ] [reset = <{no|yes}>] port Port for which statistics will be retrieved. Choose between: • DSL0 • DSL1 • ATM2 • ATM3 • AAL5 • ATM5 REQUIRED Or specify a port number (dsl0 has port number 0, ..., atm5 has port number 5). The parameter DSL0 is replaced by the parameter ADSL0 for the SpeedTouch™570.
ATM Commands atm oam ccconfig Configure Operation and Maintenance (OAM) Continuity Check (CC) on the connection. SYNTAX: atm oam ccconfig port = <{dsl0|dsl1|atm2|atm3|aal5|atm5} or number> vpi = [vci = ] [transmit = <{disabled|enabled}>] [receive = <{disabled|enabled}>] [auto = <{disabled|enabled}>] [span = <{segment|end2end}>] port ATM port number.
ATM Commands atm oam ccsend Send CC activate/deactivate to connection.
ATM Commands atm oam cclist Show current OAM CC configuration SYNTAX: atm oam cclist EXAMPLE (default configuration): =>atm oam cclist PORT = 0 VPI = 15 VCI = 64 End2End Mode = Auto Segment Mode = Auto PORT = 0 VPI = 15 VCI = 16 End2End Mode = Auto Segment Mode = Auto PORT = 0 VPI = 0 VCI = 16 End2End Mode = Auto Segment Mode = Auto => RELATED COMMANDS: atm oam ccconfig Configure CC on the connection. atm oam ccsend Send CC activate/deactivate to connection.
ATM Commands atm oam ccsend Send CC activate/deactivate to connection. SYNTAX: atm oam ccsend port = <{dsl0|dsl1|atm2|atm3|aal5|atm5} or number> vpi = [vci = ] [span = <{segment|end2end}>] [action = <{activate|deactivate}>] [direction = <{source|sink|both}>] port ATM port number. Choose between: • DSL0 • DSL1 • ATM2 • ATM3 • AAL5 • ATM5 REQUIRED Or specify a port number (dsl0 has port number 0, ..., atm5 has port number 5).
ATM Commands atm oam cclist 44 Show current CC configuration.
ATM Commands atm oam config Configure OAM cell settings. SYNTAX: atm oam config [clp = ] [loopbackid = ] clp The CLP bit value of the OAM cells. OPTIONAL Select either: loopbackid • 0 • 1 The loopback id (hexadecimal string) for processing of segment loopback cells. OPTIONAL Default is 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a.
ATM Commands atm oam mode Configure the OAM data blocking mode. SYNTAX: atm oam mode port = <{dsl0|dsl1|atm2|atm3|aal5|atm5} or number> blocking = <{disabled|enabled}> port Port for which OAM blocking is configured. Choose between: • DSL0 • DSL1 • ATM2 • ATM3 • AAL5 • ATM5 REQUIRED Or specify a port number (dsl0 has port number 0, ..., atm5 has port number 5). blocking Enable (enabled) or disable (disabled) the OAM data blocking mode on this port.
ATM Commands atm oam ping Sends ATM loopback cells. SYNTAX: atm oam ping dest = [count = ] [interval = ] dest The destination address for the request. Can be any phonebook entry. REQUIRED count A number between 1 and 1000000. Represents the number of pings to send. OPTIONAL interval A number between 1 and 1000000. Represents the interval in milliseconds between packets.
ATM Commands atm oam status Show OAM data blocking mode of all ports.
AutoPVC Commands AutoPVC Commands Contents This chapter covers the following commands: Topic Page autopvc config 50 autopvc info 52 49
AutoPVC Commands autopvc config Configure autopvc SYNTAX: autopvc config [mode = <{pseudo|passive|active}>] [type = <{bridge|pppoerelay}>] [opmode = <{partial|full}>] [overwrite = <{disabled|enabled}>] [peakrate = ] mode Select the autopvc mode: type opmode • pseudo: enable only pseudo-ILMI (VP/VC 15/16). When connection parameters are written to the MIB, display this information on CLI or web-interface but do not use these parameters for configuration.
AutoPVC Commands EXAMPLE (default configuration): =>autopvc config Autopvc mode : Autopvc opmode : Autopvc type : Autopvc standard: Autopvc pseudo : UBR overwrite : UBR peak rate : => pseudo partial bridge down up disabled linerate RELATED COMMANDS: autopvc info Show retrieved information.
AutoPVC Commands autopvc info Show retrieved information. SYNTAX: autopvc info [table = <{Port|AtmLayer|Vpc|Vcc|Address| AddressRegistrationAdmin|AtmServiceType| AtmServiceConnectionInfo|AAL1Profile| AAL34Profile|AAL5Profile|AAL2CommonProfile| AAL2TrunkingProfile|AAL2LESProfile}>] table Choose the autopvc table for which the information must be shown.
Bridge Commands Bridge Commands Contents This chapter covers the following commands: Topic Page bridge config 54 bridge flush 55 bridge ifadd 56 bridge ifattach 59 bridge ifconfig 62 bridge ifdelete 64 bridge ifdetach 65 bridge iflist 66 bridge macadd 68 bridge macdelete 69 bridge maclist 70 53
Bridge Commands bridge config Show/set bridge ageing policy for dynamically learned Medium Access Control (MAC) addresses. SYNTAX: bridge config [age = ] [filter = <{no_WAN_broadcast|PPPoE_only|none}>] 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 filter The bridge filter to be applied for all WAN bridge ports.
Bridge Commands bridge flush Flush bridge interfaces and parameters. Note The flush command does not impact previously saved configurations.
Bridge Commands bridge ifadd Create a bridged Ethernet interface.
Bridge Commands SYNTAX: bridge ifadd [intf = ] [dest = ] intf The bridged Ethernet interface name. If not specified, the destination name 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.
Bridge Commands bridge ifdetach Detach a bridge interface. bridge iflist Show current bridge configuration.
Bridge Commands bridge ifattach Attach (i.e. connect) a bridged Ethernet interface.
Bridge Commands SYNTAX: bridge ifattach intf = intf The name of the interface to attach. Browse through the available entries via the ARROW UP and ARROW DOWN keys.
Bridge Commands bridge ifdetach Detach a bridge interface. bridge iflist Show current bridge configuration.
Bridge Commands bridge ifconfig Configure a bridge interface. SYNTAX: bridge ifconfig intf = [dest = ] [qos = ] [encaps = <{llc/snap|vcmux}>] [fcs = <{off|on}>] [portstate = <{disabled|learning|forwarding}>] [retry = ] intf The name of the bridge interface to configure. REQUIRED dest The destination for this interface. Typically a phonebook entry. This parameter only needs to be specified when an interface has been created without specified destination.
Bridge Commands EXAMPLE: =>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: 30
Bridge Commands bridge ifdelete Delete a bridge interface. SYNTAX: bridge ifdelete intf = intf The name of the interface name to delete. Browse through the available entries via the ARROW UP and ARROW DOWN keys.
Bridge Commands bridge ifdetach Detach (i.e. disconnect) a bridge interface. SYNTAX: bridge ifdetach intf = intf The name of the bridge interface to detach. Browse through the available entries via the ARROW UP and ARROW DOWN keys.
Bridge Commands bridge iflist Show the current state of all or the selected bridge interfaces. SYNTAX: bridge iflist [intf = ] intf The name of the bridge interface for which the configuration must be shown. Browse through the available entries via the ARROW UP and ARROW DOWN keys. If no interface is specified, all bridge interfaces are shown.
Bridge Commands bridge ifattach Attach a bridge interface. bridge ifconfig Configure a bridge interface. bridge ifdelete Delete a bridge interface. bridge ifdetach Detach a bridge interface.
Bridge Commands bridge macadd Add a static MAC address to the filtering database. Allows to manually add static addresses, which should normally be dynamically discovered by the bridge itself. SYNTAX: bridge macadd intf = hwaddr = intf The name of the bridge interface to add the MAC address for. REQUIRED hwaddr The Ethernet MAC address of the new entry.
Bridge Commands bridge macdelete Remove a MAC address from the filtering database. SYNTAX: bridge macdelete hwaddr hwaddr = The Ethernet MAC address of the entry to delete. REQUIRED EXAMPLE: =>bridge maclist 00:90:d0:01:02:03 -static, OBC ff:ff:ff:ff:ff:ff -static, OBC 01:80:c2:00:00:00 -static, OBC 01:80:c2:00:00:01 -static, OBC ...
Bridge Commands bridge maclist Shows the current MAC address filtering database. SYNTAX: bridge maclist EXAMPLE: =>bridge maclist =>bridge maclist 00:90:d0:01:02:03 ff:ff:ff:ff:ff:ff 01:80:c2:00:00:00 01:80:c2:00:00:01 ... 01:80:c2:00:00:10 00:80:9f:24:ab:cf 00:01:42:5f:7d:81 00:50:8b:31:cc:aa 08:00:20:c1:9a:12 00:08:c7:c3:5f:fc 08:00:20:a8:f4:34 08:00:20:83:b7:26 00:10:83:1b:13:18 ...
CIP Commands CIP Commands Contents This chapter covers the following commands: Topic Page cip flush 72 cip ifadd 73 cip ifdelete 74 cip iflist 75 cip pvcadd 76 cip pvcdelete 77 cip pvclist 78 71
CIP Commands cip flush Flush complete Classical IP over ATM (IP oA) configuration. Note The flush command does not impact previously saved configurations.
CIP Commands cip ifadd Create a Classical IP oA interface at the local side of the Logical IP Subnet (LIS). SYNTAX: cip ifadd addr = [netmask = ] [uniaddr = ] addr The Classical IP oA 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:*.03‘: ADSL port, any address, selector 3.
CIP Commands cip ifdelete Delete a Classical IP oA interface at the local side of the LIS. SYNTAX: cip ifdelete addr = addr The Classical IP oA interface's local IP address in the LIS. REQUIRED EXAMPLE: =>cip iflist cip0 addr = 172.16.1.1 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = inarp_reqs_out = 0 inarp_repl_out = cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.
CIP Commands cip iflist Show current Classical IP oA configuration. SYNTAX: cip iflist EXAMPLE: =>cip iflist cip0 addr = 172.16.1.1 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = inarp_reqs_out = 0 inarp_repl_out = cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.
CIP Commands cip pvcadd Create a PVC Address Resolution Protocol (ARP) entry for destinations which are not RFC1577/RFC2225 compliant. SYNTAX: cip pvcadd dest = [destaddr = ] [mtu = ] 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).
CIP Commands cip pvcdelete Delete a PVC ARP entry. SYNTAX: cip pvcdelete dest = dest Typically a phonebook entry name. Represents the ATM address (hardware address) or name of the entry to delete. REQUIRED EXAMPLE: =>cip pvclist CIPPVC1 atmport = 0 encaps = llc =>cip pvcdelete dest=CIPPVC1 =>cip pvclist => vpi mtu = 8 = 546 vci = 80 dest_ip = 172.16.1.2 RELATED COMMANDS: cip pvcadd Creates a PVC ARP entry. cip pvclist Show current PVC ARP entries.
CIP Commands cip pvclist Show current PVC ARP entries. SYNTAX: cip pvclist EXAMPLE: =>cip pvclist CIPPVC1 atmport = 0 encaps = llc => vpi = 8 mtu = 546 vci = 80 dest_ip = 172.16.1.2 EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: =>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.
Config Commands Config Commands Contents This chapter covers the following commands: Topic Page config backup 80 config dump 81 config erase 82 config flush 83 config list 84 config load 85 config save 87 79
Config Commands config backup Store current configuration to backup file. SYNTAX: config backup filename filename = Filename for backup file of current configuration RELATED COMMANDS: config dump Shows the saved configuration file config list Shows the current configuration set.
Config Commands config dump Shows the saved configuration file. SYNTAX: config dump RELATED COMMANDS: config backup Store current configuration to backup file. config list Shows the current configuration set.
Config Commands config erase Physically remove all saved configurations, i.e. the user configuration file, saved in the SpeedTouch™ permanent storage, is deleted. SYNTAX: config erase filename [filename = ] Name of the configuration file to erase. RELATED COMMANDS: config flush Flush complete runtime configuration. config load Load complete saved or default configuration. config save Save complete runtime configuration.
Config Commands config flush Flush complete current configuration without affecting saved configurations.
Config Commands config list Shows the current configuration set. SYNTAX: config list [templates = <{no|yes}>] templates Select yes to include the template configuration files in the list. EXAMPLE: =>config list templates=yes Configurations file(s): user.ini Template file(s) No template files present Factory template file(s) : pppoe.tpl pppoa.tpl br.tpl => RELATED COMMANDS: config backup Store current configuration to backup file.
Config Commands config load Load complete saved (backup) or default configuration file. Note Execute config flush prior to config load. SYNTAX: config load [load_ip = <{no|yes}>] [defaults = <{yes|no}>] [flush = <{yes|no}>] [echo = <{no|yes}>] [filename = ] 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).
Config Commands RELATED COMMANDS: config erase Physically remove all saved configurations. config flush Flush complete runtime configuration. config save Save current runtime configuration.
Config Commands 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™ permanent storage. This file can be downloaded via the SpeedTouch™ web pages or via an FTP session. SYNTAX: config save EXAMPLE: =>config save => RELATED COMMANDS: config erase Physically remove all saved configurations. config flush Flush complete runtime configuration.
Config Commands 88
DHCP Commands DHCP Commands Contents This chapter covers the following commands Topic Page dhcp client clear 91 dhcp client config 92 dhcp client flush 93 dhcp client ifadd 94 dhcp client ifattach 95 dhcp client ifconfig 96 dhcp client ifdelete 98 dhcp client iflist 99 dhcp client ifrelease 100 dhcp client ifrenew 102 dhcp client stats 104 dhcp relay add 105 dhcp relay config 106 dhcp relay delete 107 dhcp relay flush 108 dhcp relay ifconfig 109 dhcp relay iflist 110 dhc
DHCP Commands Topic Page dhcp server lease flush 122 dhcp server lease list 123 dhcp server pool add 124 dhcp server pool config 125 dhcp server pool delete 127 dhcp server pool flush 128 dhcp server pool list 129 90
DHCP Commands dhcp client clear Clear Dynamic Host Configuration Protocol (DHCP) client statistics.
DHCP Commands dhcp client config Show/set DHCP client configuration. SYNTAX: dhcp client config [trace = <{off|on}>] trace Enable tracing (on) or not (off). EXAMPLE: =>dhcp client config tracing: off =>dhcp client config trace=on =>dhcp client config tracing: on => RELATED COMMANDS: dhcp client ifconfig 92 Configure a DHCP lease created for a specific interface.
DHCP Commands dhcp client flush Flush complete DHCP client configuration and dynamic interfaces. Note The flush command does not impact previously saved configurations. SYNTAX: dhcp client flush EXAMPLE: =>dhcp client iflist NewETHoA : [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.
DHCP Commands dhcp client ifadd Create a DHCP lease for a specific interface. SYNTAX: dhcp client ifadd intf = intf The name of an existing interface, e.g. created via :mer ifadd. EXAMPLE: =>dhcp client iflist No dynamic interfaces defined. =>dhcp client ifadd intf=NewEthoa =>dhcp client iflist NewETHoA : [INIT] flags= uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server : 255.255.255.
DHCP Commands dhcp client ifattach Attach a DHCP lease to a dynamic interface. Note Create the interface first with :dhcp client ifadd. SYNTAX: dhcp client ifattach intf intf = The name of the dynamic interface. REQUIRED EXAMPLE: =>dhcp client iflist NewETHoA : [INIT] flags= uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server : 255.255.255.
DHCP Commands 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.
DHCP Commands EXAMPLE: =>dhcp client iflist NewETHoA : [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: 36, in use: 1, free: 97% =>dhcp client ifconfig intf=NewETHoA hostname=NewLease addr=10.0.0.10 leasetime=10800 =>dhcp client iflist NewETHoA : [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.
DHCP Commands dhcp client ifdelete Delete a dynamic interface. SYNTAX: dhcp client ifdelete intf intf = The name of the dynamic interface. EXAMPLE: =>dhcp client iflist NewETHoA : [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.
DHCP Commands dhcp client iflist Show all dynamic interfaces. SYNTAX: dhcp client iflist EXAMPLE: =>dhcp client iflist NewETHoA : [INIT] flags= uc IP address HW address DHCP server Number of leases: 1 Total size of table: 19, => : : : 0.0.0.0 00:90:d0:01:47:de 255.255.255.255 in use: 1, free: 94 % EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DHCP client on its Ethernet interface eth0. =>dhcp client iflist eth0 : [BOUND] flags= uc IP address : 10.0.0.
DHCP Commands dhcp client ifrelease Release a lease attached to a dynamic interface. SYNTAX: dhcp client ifrelease intf intf = The name of the dynamic interface. EXAMPLE: =>dhcp client iflist NewETHoA : [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.
DHCP Commands EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DHCP client on its Ethernet interface eth0. =>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.
DHCP Commands dhcp client ifrenew Renew the lease of a dynamic interface. SYNTAX: dhcp client ifrenew intf = intf The name of the dynamic interface. EXAMPLE: =>dhcp client iflist NewETHoA : [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.
DHCP Commands EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DHCP client on its Ethernet interface eth0.
DHCP Commands dhcp client stats Show DHCP client statistics.
DHCP Commands dhcp relay add Adds a DHCP server to the DHCP server list. SYNTAX: dhcp relay add addr = [intf = ] [giaddr = ] addr The DHCP server IP address. REQUIRED intf The name of the relay interface, 'None' to indicate no interface is specified. OPTIONAL giaddr The giaddr field to be used in relayed DHCP packets. OPTIONAL RELATED COMMANDS: dhcp relay config Sets the relay configuration settings.
DHCP Commands dhcp relay config Sets the relay configuration settings. SYNTAX: dhcp server config [agentinfo = <{off|on}>] [agentmismatch = <{off|on}>] [trace = <{off|on}>] agentinfo Sets the relay agent info status (RFC3046) off or on. Default is off. OPTIONAL agentmismatch Forward/Drop DHCP reply packet when a relay agent info mismatch is detected (RFC3046).
DHCP Commands dhcp relay delete Deletes a DHCP server from the DHCP server list. SYNTAX: dhcp relay delete addr = [intf = ] addr The DHCP server IP address. REQUIRED intf The name of the dynamic interface. OPTIONAL RELATED COMMANDS: dhcp relay add Adds a DHCP server to the DHCP server list. dhcp relay config Sets the relay configuration settings.
DHCP Commands dhcp relay flush Flushes the DHCP relay settings. Note The flush command does not impact previously saved configurations. SYNTAX: dhcp relay flush EXAMPLE: =>dhcp relay list DHCP server Interface giaddr ------------------------------------------------------127.0.0.1 =>dhcp relay flush =>dhcp relay list No dynamic interfaces defined.
DHCP Commands dhcp relay ifconfig Configures a relay interface. SYNTAX: dhcp relay ifconfig intf = [relay = <{off|on}>] [maxhops = ] [remoteid = ] [trusted = <{no|yes}>] intf The name of the dynamic interface to be configured. REQUIRED relay Sets the relay status. OPTIONAL maxhops A number between 0 and 16. Represents the maximum number of hops allowed in the DHCP packet. Default is 4. OPTIONAL remoteid Sets the remote id as specified in RFC3046.
DHCP Commands dhcp relay iflist Show all dynamic interfaces. SYNTAX: dhcp relay iflist [intf = ] intf The name of the dynamic interface to be configured. EXAMPLE: =>dhcp relay iflist pppoa_pppoa : admin state = down oper state = down max hops = 4 trusted = no remote id = eth0 : admin state = up oper state = up max hops = 4 trusted = no remote id = => RELATED COMMANDS: dhcp relay ifconfig 110 Configures a relay interface.
DHCP Commands dhcp relay list Lists the DHCP server list. SYNTAX: dhcp relay list EXAMPLE: =>dhcp relay list DHCP server Interface giaddr ------------------------------------------------------127.0.0.1 => RELATED COMMANDS: dhcp relay add Adds a DHCP server to the DHCP server list. dhcp relay config Sets the relay configuration settings. dhcp relay delete Deletes a DHCP server from the DHCP server list.
DHCP Commands dhcp relay stats Shows DHCP relay statistics.
DHCP Commands dhcp server clear Clear SpeedTouch™ DHCP server statistics.
DHCP Commands dhcp server config Show/set SpeedTouch™ DHCP server configuration settings. SYNTAX: dhcp server config [autodhcp = <{off|on}>] [scantime = ] [state = <{disabled|enabled}>] [trace = <{off|on}>] autodhcp Allow the SpeedTouch™ 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).
DHCP Commands dhcp server flush Flushes all DHCP server pool and lease entries. Note The flush command does not impact previously saved configurations. SYNTAX: dhcp server flush RELATED COMMANDS: dhcp server stats Show current DHCP server state and statistics. dhcp server config Show/set current DHCP server configuration.
DHCP Commands dhcp server policy Show/set SpeedTouch™ DHCP server policy. SYNTAX: dhcp server policy [verifyfirst = ] [trustclient = ] 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).
DHCP Commands dhcp server stats Show SpeedTouch™ DHCP server statistics.
DHCP Commands DESCRIPTION: DHCP server state Indicates the state of the SpeedTouch™ DHCP server. Corrupted packet recv Indicates the number of corrupted packets (not compliant 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.
DHCP Commands dhcp server lease add Assign a DHCP server lease to a DHCP host in the local network. SYNTAX: dhcp server lease add clientid = pool = [addr = ] [offset = ] [leasetime = ] [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.
DHCP Commands EXAMPLE: =>dhcp server Lease 0 0.0.0.0 =>dhcp server =>dhcp server Lease 0 0.0.0.0 1 10.0.0.1 => lease list Pool TTL State dhcp_pool_1 00:26:40 FREE lease add clientid=01:23:55:67:89:ab lease list Pool TTL State dhcp_pool_1 00:26:40 FREE local_pool 00:59:22 USED Clientid 00:90:D0:12:34:56 pool=Local_pool leasetime=3600 Clientid 00:90:D0:12:34:56 01:23:45:67:89:AB RELATED COMMANDS: dhcp server lease delete Delete a DHCP lease. dhcp server lease flush Delete all DHCP leases.
DHCP Commands dhcp server lease delete Delete a DHCP lease. SYNTAX: dhcp server lease delete [clientid = ] [index = ] clientid The DHCP client identification string of the DHCP lease. If no DHCP client is specified, all DHCP clients are deleted. OPTIONAL 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 EXAMPLE: =>dhcp server Lease 0 0.0.0.0 1 10.0.0.
DHCP Commands dhcp server lease flush Flush all DHCP server leases. Note The flush command does not impact previously saved configurations. SYNTAX: dhcp server lease flush pool [pool = ] The name of the DHCP server pool. Only the leases belonging to this pool will be deleted. EXAMPLE: =>dhcp server Lease 0 0.0.0.0 1 10.0.0.1 2 10.0.0.101 3 10.0.0.132 5 10.0.0.5 4 10.0.0.6 8 10.0.0.8 9 10.0.0.
DHCP Commands dhcp server lease list List current DHCP leases, indicated by their index number. SYNTAX: dhcp server lease list [clientid = ] [index = ] clientid The DHCP client identification string of the DHCP lease. If no DHCP client is specified, all DHCP clients are listed. OPTIONAL index The index number of the entry to be deleted. OPTIONAL EXAMPLE: =>dhcp server Lease 0 0.0.0.0 1 10.0.0.1 2 10.0.0.101 3 10.0.0.132 5 10.0.0.5 4 10.0.0.6 8 10.0.0.8 9 10.0.0.
DHCP Commands dhcp server pool add Add a DHCP server pool. SYNTAX: dhcp server pool add [name = ] [index = ] 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 The number of the pool before which you want the new pool to be added. OPTIONAL EXAMPLE: =>dhcp server pool list Pool Start End 0 dhcp_pool_1 0.0.0.0 0.0.0.0 1 My_LAN_Pool 10.0.0.1 10.0.0.254 2 dhcp_pool_2 0.0.0.0 0.0.0.
DHCP Commands dhcp server pool config Configure an existing DHCP pool. Before you are able to configure the DHCP pool, you must create it via :dhcp server pool add.
DHCP Commands gateway The IP address of the default gateway for the DHCP clients. Default value of this parameter is 0 (not specified), which means that the gateway IP address will be communicated by the remote server as soon as the PPP IPCP subnetmasking connection is established or that the SpeedTouch™ acts as the LAN default gateway. OPTIONAL server The IP address of the DHCP server for DHCP clients. OPTIONAL primdns The IP address of the primary DNS server for the DHCP clients.
DHCP Commands dhcp server pool delete Delete a DHCP pool. SYNTAX: dhcp server pool delete name name = The name of the DHCP server pool to delete. Use :dhcp server pool list to see a list of all current DHCP leases. REQUIRED EXAMPLE: =>dhcp server pool list Pool Start End 0 LAN_Private 10.0.0.1 10.0.0.254 1 My_Pool 192.6.11.101 192.6.11.254 =>dhcp server pool delete name=My_Pool =>dhcp server pool list Pool Start End 0 LAN_Private 10.0.0.1 10.0.0.
DHCP Commands dhcp server pool flush Flush all DHCP pools Note The flush command does not impact previously saved configurations. SYNTAX: dhcp server pool flush EXAMPLE: =>dhcp server pool list Pool Start 0 LAN_Private 10.0.0.1 1 My_Pool 192.6.11.101 =>dhcp server pool flush =>dhcp server pool list => End 10.0.0.254 192.6.11.254 Intf eth0 eth0 RELATED COMMANDS: dhcp server pool add Add a DHCP pool. dhcp server pool delete Delete a DHCP pool. dhcp server pool list Show current DHCP pools.
DHCP Commands dhcp server pool list List current DHCP pools. SYNTAX: dhcp server pool list EXAMPLE: =>dhcp server pool list Pool Start 0 LAN_Private 10.0.0.1 1 My_Pool 192.6.11.101 => End 10.0.0.254 192.6.11.254 Intf eth0 eth0 State USED USED RELATED COMMANDS: dhcp server pool add Add a DHCP pool. dhcp server pool delete Delete a DHCP pool. dhcp server pool flush Delete all DHCP pools.
DHCP Commands 130
DNS Commands DNS Commands Contents This chapter covers the following commands: Topic Page dns add 132 dns clear 133 dns clrstats 134 dns delete 135 dns domain 136 dns flush 137 dns fwdadd 138 dns fwddelete 139 dns fwdlist 140 dns fwdtable 141 dns list 142 dns nslookup 143 dns start 144 dns stats 145 dns status 146 dns stop 147 dns toutfwd 148 dns troff 149 dns tron 150 131
DNS Commands dns add Adds an entry to the local Domain Name System (DNS) table. SYNTAX: dns add hostname = [addr = ] hostname The name of the IP host to add (without the (sub)domain name). REQUIRED addr The IP address of the host (without mask). OPTIONAL Note If this parameter is not specified, the hostname applies to the SpeedTouch™ itself. EXAMPLE: =>dns list Domain: business.lan Nr. Hostname IP Address 0 SpeedTouch™ *.*.*.* 1 TestHost 10.0.0.140 2 HTTP_Server 10.0.0.
DNS Commands dns clear Clears the local DNS table. SYNTAX: dns clear EXAMPLE: =>dns list Domain: business.lan Nr. Hostname 0 SpeedTouch™ 1 TestHost 2 HTTP_Server 3 FTP_Server Total Table Size: 73 entries Amount used: 4 (5%) =>dns clear =>dns list Domain: business.lan Nr. Hostname Total Table Size: 73 entries Amount used: 0 (0%) => IP Address *.*.*.* 10.0.0.140 10.0.0.8 10.0.0.7 IP Address RELATED COMMANDS: dns list Lists the contents of the local DNS table.
DNS Commands dns clrstats Clears the DNS statistics. SYNTAX: dns clrstats EXAMPLE: =>dns stats DNS Statistics: Corrupted packets recv Local questions resolved Local neg answers sent Total DNS packets fwd External answers recv Fwd table full, discard Spurious answers Unknown query types : : : : : : : : 0 0 4 0 0 0 0 0 Total number of packets received : 4 =>dns clrstats DNS statistics cleared.
DNS Commands dns delete Deletes an entry from the local DNS table by index. SYNTAX: dns delete index = index The index of the entry to be deleted. Use dns list to see a list of the index numbers of all current DNS entries. REQUIRED EXAMPLE: =>dns list Domain: business.lan Nr. Hostname 0 SpeedTouch™ 1 TestHost 2 HTTP_Server 3 FTP_Server Total Table Size: 73 entries Amount used: 4 (5%) =>dns delete index=2 =>dns list Domain: business.lan Nr.
DNS Commands dns domain Set the local DNS domain name. SYNTAX: dns domain domain = domain The local DNS domain name. EXAMPLE: =>dns list Domain: business.lan Nr. Hostname 0 SpeedTouch™ 1 TestHost 2 HTTP_Server 3 FTP_Server Total Table Size: 73 entries Amount used: 4 (5%) =>dns domain domain=office.home.lan =>dns list Domain: office.home.lan Nr. Hostname 0 SpeedTouch™ 1 TestHost 2 HTTP_Server 3 FTP_Server Total Table Size: 73 entries Amount used: 4 (5%) IP Address *.*.*.* 10.0.0.140 10.0.0.
DNS Commands dns flush Flush the complete SpeedTouch™ DNS server/forwarder configuration and static entries. Note The flush command does not impact previously saved configurations. SYNTAX: dns flush EXAMPLE: =>dns list Domain: office.home.lan Nr. Hostname 4* Z7V1D8 0 SpeedTouch™ 1 TestHost 2 Default 3 ftpserver Total Table Size: 73 entries Amount used: 5 (6%) =>dns flush =>dns list Domain: lan Nr. Hostname 3* Z7V1D8 Total Table Size: 73 entries Amount used: 1 (1%) => IP Address 10.0.0.29 *.*.*.* 10.0.
DNS Commands dns fwdadd Add a DNS forwarding entry. The entries in the forwarding list determine which DNS server should be used for which PC. If an identification cannot be established within the local LAN, the request is forwarded to another DNS server, on another network (Internet/LAN to LAN connection). The connection is negotiated within a PPP link.
DNS Commands dns fwddelete Delete a DNS forwarding entry. SYNTAX: dns fwddelete src = mask = [dns = ] src The source IP address (pool) of the hosts to remove the entry for. REQUIRED mask The source IP (sub)netmask. REQUIRED dns The IP address of the (remote) DNS server (in case of multiple DNS server entries). OPTIONAL EXAMPLE: =>dns fwdlist DNS SRC Metric Direct Permanent 10.0.0.138 10.0.0.2 1 no yes 10.0.0.138 10.0.0.
DNS Commands dns fwdlist Lists all forwarding entries. SYNTAX: dns fwdlist EXAMPLE: =>dns fwdlist DNS forwarding servers: DNS SRC 10.0.0.138 10.0.0.0 192.6.11.150 192.6.11.0 => MASK 255.255.255.0 255.255.255.0 Direct yes yes RELATED COMMANDS: dns fwdadd Add a DNS forwarding entry. dns fwddelete Delete a DNS forwarding entry. dns fwdtable Show DNS forwarding table.
DNS Commands dns fwdtable Show DNS forwarding table, i.e. list all currently unresolved DNS requests. SYNTAX: dns fwdtable EXAMPLE: =>dns fwdtable Forwarding table: Nr. Ip Address (port#):id(hex) 0 10.10.10.12 (54751):8331 Timeout: 15 seconds Table size: 10 amount of table used: 1 (10%) => (expiry) (13 sec) dns server 10.10.10.112 tries 1 RELATED COMMANDS: dns fwdlist Show current DNS forwarding entries.
DNS Commands dns list Lists the contents of the local DNS table. SYNTAX: dns list EXAMPLE: =>dns list Domain: office.home.lan Nr. Hostname 4* Z7V1D8 0 SpeedTouch™ 1 TestHost 2 Default 3 ftpserver Total Table Size: 73 entries Amount used: 5 (6%) => IP Address 10.0.0.29 *.*.*.* 10.0.0.140 10.0.0.8 172.16.0.1 EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DNS server. =>dns list Domain: SpeedLAN.local Nr.
DNS Commands dns nslookup Looks up a name or an IP address via local DNS. SYNTAX: dns nslookup lookup = lookup The DNS hostname or IP address to query. REQUIRED EXAMPLE: =>dns list Domain: office.home.lan Nr. Hostname 4* Z7V1D8 0 SpeedTouch™ 1 TestHost 2 Default 3 ftpserver Total Table Size: 73 entries Amount used: 5 (6%) =>dns nslookup lookup=TestHost Name: TestHost Address: 10.0.0.140 =>dns nslookup lookup=10.0.0.29 Name: Z7V1D8 Address: 10.0.0.29 => IP Address 10.0.0.29 *.*.*.* 10.0.0.
DNS Commands dns start Starts the local DNS server and forwarder. SYNTAX: dns start EXAMPLE: =>dns status DNS server status: Stopped DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache. Tracing: off =>dns start DNS server started. =>dns status DNS server status: Started DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache.
DNS Commands dns stats Show SpeedTouch™ DNS server/forwarder statistics. SYNTAX: dns stats EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DNS server. =>dns list Domain: SpeedLAN.local Nr. Hostname IP Address 0 SpeedTouch™ *.*.*.* 1 Server 10.10.1.1 2 Client 10.0.0.
DNS Commands dns status Shows the current status of the DNS server/forwarder. SYNTAX: dns status EXAMPLE: =>dns status DNS server status: Stopped DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache.
DNS Commands dns stop Stops the local DNS server/forwarder. SYNTAX: dns stop EXAMPLE: =>dns status DNS server status: Started DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache. Tracing: off =>dns stop DNS server stopped. =>dns status DNS server status: Stopped DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache.
DNS Commands dns toutfwd Sets the DNS forwarding timeout. SYNTAX: dns toutfwd timeout = timeout A number (seconds). Represents the query forwarding timeout. This parameter determines how long the SpeedTouch™ DNS server should try to contact a (remote) DNS server before (temporarily) declaring the DNS requests unresolved. By default the timeout is 15 seconds. EXAMPLE: =>dns fwdtable Forwarding table: Nr. Ip Address (port#):id(hex) 0 10.10.10.
DNS Commands dns troff Disable verbose console messaging. No debug traces are generated. SYNTAX: dns troff EXAMPLE: =>dns status DNS server status: Started DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache. Tracing: on =>dns troff =>dns status DNS server status: Started DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache.
DNS Commands dns tron Enable verbose console messaging. Debug traces are generated. SYNTAX: dns tron EXAMPLE: =>dns status DNS server status: Started DNS table size : 73, in use: 4, free: 94 % DNS forwarding table size : 10, in use: 0, free: 100 % DNS forwarding dns servers table size : 25, in use: 4, free: 84 % No dns cache. Tracing: off =>dns tron Tracing on.
Env Commands Env Commands Contents This chapter covers the following commands Topic Page env flush 152 env get 154 env list 156 env set 157 env unset 158 151
Env Commands env flush Flush all non-system environment variables.
Env Commands EXAMPLE: =>env list _COMPANY_NAME=THOMSON multimedia _COMPANY_URL=http://www.thomson-multimedia.com _PROD_NAME=SpeedTouch _PROD_URL=http://www.speedtouch.com _PROD_FRIENDLY_NAME=SpeedTouch 510 _PROD_DESCRIPTION=DSL Internet Gateway _PROD_NUMBER=510 _BOARD_SERIAL_NBR=0238J1035 _BUILD=4.0.0.9.0 _BUILDNAME=Sascha4.0090 _PRL=3EC36939AAAA _FIA=ND _BOARD_NAME=ADNT-Q _COMPANY_ID=ALCL _COPYRIGHT=Copyright (c) 1999-2002, THOMSON multimedia _TPVERSION=1.1.
Env Commands env get Get the current value of a environment variable. SYNTAX: env get var = var The name of the environment variable. Execute env list to see a list of all environment variables.
Env Commands EXAMPLE: =>env list _COMPANY_NAME=THOMSON _COMPANY_URL=http://www.thomson.net _PROD_NAME=SpeedTouch _PROD_URL=http://www.speedtouch.com _PROD_FRIENDLY_NAME=SpeedTouch 610 _PROD_DESCRIPTION=Business DSL Router _PROD_NUMBER=610 _BOARD_SERIAL_NBR=0238L1949 _BUILD=4.2.0.10 _MODEMLABEL=MOD_SACHEM_SEA_CPE_V2.11.27 _PHYSLAYERTYPE=POTS _BUILDNAME=LLT5AA4.20A _PRL=3EC18603GCAA _FIA=NE _BOARD_NAME=ADNT-R _COMPANY_ID=ALCL _COPYRIGHT=Copyright (c) 1999-2003, THOMSON _TPVERSION=1.2.
Env Commands env list Show all currently available environment variables. SYNTAX: env list EXAMPLE: =>env list _COMPANY_NAME=THOMSON _COMPANY_URL=http://www.thomson.net _PROD_NAME=SpeedTouch _PROD_URL=http://www.speedtouch.com _PROD_FRIENDLY_NAME=SpeedTouch 610 _PROD_DESCRIPTION=Business DSL Router _PROD_NUMBER=610 _BOARD_SERIAL_NBR=0238L1949 _BUILD=4.2.0.10 _MODEMLABEL=MOD_SACHEM_SEA_CPE_V2.11.27 _PHYSLAYERTYPE=POTS _BUILDNAME=LLT5AA4.
Env Commands env set Create and set a non-system environment variable or change the value of a non-system environment variable. SYNTAX: env set var = value = var The name of the environment variable. When creating an environment variable, any name is allowed, however spaces are not allowed and the name may not start with “CONF”, “HOST”, an underscore “_” or the dollar sign “$”. REQUIRED value A quoted translated string which defines the value of the environment variable.
Env Commands env unset Delete a non-system environment variable. SYNTAX: env unset var = var The name of the environment variable to delete. System variables (built-in variables with names starting with an underscore “_”, “CONF” or “HOST”) can not be unset, nor changed or deleted. EXAMPLE: =>env list _COMPANY_NAME=THOMSON multimedia _COMPANY_URL=http://www.speedtouch.com _PROD_NAME=SpeedTouch .....
Eth Commands Eth Commands Contents This chapter covers the following topics: Topic Page eth config 160 eth ifconfig 161 eth iflist 162 159
Eth Commands eth config Enable/disable the Ethernet interface. SYNTAX: eth config intf = [state = <{enabled|disabled}>] intf The Ethernet interface to configure. REQUIRED state Enable or disable the Ethernet interface. By default, all Ethernet interfaces are enabled.
Eth Commands eth ifconfig Configure the Ethernet port. SYNTAX: eth ifconfig intf = type = <{auto|10BaseTHD|10BaseTFD|100BaseTHD|100BaseTFD} or number> intf The Ethernet interface to configure. REQUIRED type The Ethernet type. Select either: REQUIRED • auto Auto negotiation of Ethernet communication speed (10Mb/s or 100Mb/s) and Duplex mode (half duplex or full duplex). • 10BaseTHD 10Mb/s communication speed in half duplex mode.
Eth Commands eth iflist Show the Ethernet port configuration and current operating status. SYNTAX: eth iflist EXAMPLE: =>eth iflist Intf Type 1 auto 2 auto 3 auto 4 auto => Result Type 100BaseTFD 100BaseTFD 100BaseTFD 100BaseTFD DESCRIPTION: Type Indicates the configured Ethernet communication speed and duplex mode. Result type Indicates the effective operating status in case Type=auto. In other cases, when the Ethernet types do NOT match, Result type=unknown and no Ethernet connectivity will exist.
ETHoA Commands ETHoA Commands Contents This chapter covers the following topics: Topic Page ethoa flush 164 ethoa ifadd 165 ethoa ifattach 166 ethoa ifconfig 167 ethoa ifdelete 169 ethoa ifdetach 170 ethoa iflist 171 163
ETHoA Commands ethoa flush Flushes ETHoA interfaces. Note The flush command does not impact previously saved configurations.
ETHoA Commands ethoa ifadd Create a new ETHoA interface. SYNTAX: ethoa ifadd [intf = ] [dest = ] intf The name for the new ETHoA interface. If not specified, the destination will double as interface name. OPTIONAL dest The destination for the new ETHoA interface. Typically, a phonebook entry.
ETHoA Commands ethoa ifattach Attach (i.e. connect) an ETHoA interface. SYNTAX: ethoa ifattach intf = intf The name of the ETHoA interface to attach.
ETHoA Commands ethoa ifconfig Configure an ETHoA interface. SYNTAX: ethoa ifconfig intf = [dest = ] [qos = ] [encaps = <{llc/snap|vcmux}>] [retry = ] intf The name of the ETHoA 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.
ETHoA Commands RELATED COMMANDS: ethoa ifadd Create a new ETHoA interface. ethoa ifattach Attach an ETHoA interface. ethoa ifdelete Delete an ETHoA interface. ethoa ifdetach Detach an ETHoA interface. ethoa iflist Show current ETHoA interfaces.
ETHoA Commands ethoa ifdelete Delete an ETHoA interface. SYNTAX: ethoa ifdelete intf = intf The name of the ETHoA interface.
ETHoA Commands ethoa ifdetach Detach an ETHoA interface. SYNTAX: ethoa ifdetach intf = intf The name of the ETHoA interface.
ETHoA Commands ethoa iflist Show all or a specified ETHoA interface(s). SYNTAX: ethoa iflist [intf = ] intf The name of the ETHoA interface. Note OPTIONAL If not specified, all ETHoA interfaces are listed.
ETHoA Commands 172
Firewall Commands Firewall Commands Contents This chapter covers the following topics: Topic Page firewall assign 174 firewall flush 176 firewall list 177 firewall troff 178 firewall tron 179 firewall unassign 180 firewall chain create 181 firewall chain delete 182 firewall chain flush 183 firewall chain list 184 firewall rule clear 185 firewall rule create 186 firewall rule delete 190 firewall rule flush 191 firewall rule list 192 firewall rule stats 193 173
Firewall Commands firewall assign Assign a chain to an entry point. An entry point, also referred to as hook or a Packet Interception Point (PIP), is the location where packets are intercepted to be compared against a chain of rules SYNTAX: firewall assign hook = <{input|sink|forward|source|output}> chain = hook The name of the entry point to which a chain must be assigned. Choose between: chain • input: The point off all incoming traffic.
Firewall Commands RELATED COMMANDS: firewall flush Clear all hooks. firewall list Show a list of all chain assignments. firewall unassign Clear a specific hook.
Firewall Commands firewall flush Clears all hooks, chains and rules. Note The flush command does not impact previously saved configurations.
Firewall Commands firewall list Show the association(s) between all hooks or a specified hook and their chain(s). SYNTAX: firewall list [hook = <{input|sink|forward|source|output}>] hook The name of the hook for which the associations must be shown. Choose between: • input • sink • forward • source • output. Note OPTIONAL If this parameter is not specified, the associations for all hooks are shown.
Firewall Commands firewall troff Disable verbose console messaging. SYNTAX: firewall troff EXAMPLE: =>firewall troff RELATED COMMANDS: firewall tron 178 Enable verbose console messaging.
Firewall Commands firewall tron Enable verbose console messaging. SYNTAX: firewall tron EXAMPLE: =>firewall tron RELATED COMMANDS: firewall troff Disable verbose console messaging.
Firewall Commands firewall unassign Clear a specific hook. SYNTAX: firewall unassign hook = <{input|sink|forward|source|output}> hook The name of the hook to be cleared. Choose between: • input • sink • forward • source • output. RELATED COMMANDS: firewall assign Assign a chain to a hook. firewall flush Clear all hooks. firewall list Show a list of all chain assignments.
Firewall Commands firewall chain create Create a new chain. SYNTAX: firewall chain create chain chain = The name of the chain to create. REQUIRED EXAMPLE: =>firewall chain list Tempo, source, forward, sink =>firewall chain create chain=Telnet =>firewall chain list Telnet, Tempo, source, forward, sink => RELATED COMMANDS: firewall chain delete Delete a chain. firewall chain list Show a list of all current chains.
Firewall Commands firewall chain delete Delete a chain. SYNTAX: firewall chain delete chain chain = The name of the chain to be deleted. EXAMPLE: =>firewall chain list Telnet, Tempo, source, forward, sink =>firewall chain list Telnet, Tempo, source, forward, sink =>firewall chain delete chain=Tempo =>firewall chain list Telnet, source, forward, sink => RELATED COMMANDS: firewall chain create Create a chain. firewall chain list Show a list of all chains.
Firewall Commands firewall chain flush Flush all chains. SYNTAX: firewall chain flush EXAMPLE: =>firewall rule list chain=Telnet :firewall rule create chain=Telnet index=0 srcintfgrp=lan src=10.0.0.0/8 | dst=200.200.200.1/32 prot=tcp srcport=1024 srcportend=65535 dstport=telnet | action=accept :firewall rule create chain=Telnet index=1 srcintfgrp=wan | src=200.200.200.1/32 dst=10.0.0.
Firewall Commands firewall chain list Show a list of all current chains. SYNTAX: firewall chain list EXAMPLE INPUT/OUTPUT: =>firewall chain list source, forward, sink =>firewall chain create chain Telnet =>firewall chain list Telnet, source, forward, sink =>firewall chain list Telnet, source, forward, sink => RELATED COMMANDS: firewall assign Assign a chain to an entry point. firewall chain create Create a chain. firewall chain delete Delete a chain.
Firewall Commands firewall rule clear Clear statistics for a given rule. SYNTAX: firewall rule clear [chain = ] [index = ] chain The name of the chain in which the rule is to be found. OPTIONAL index The index number (determined by the position) of the rule in the chain.
Firewall Commands firewall rule create Create a rule.
Firewall Commands srcbridgeport A number between 0 and 6. Represents the bridge port the virtual packet should [or should NOT] arrive on. Use :bridge iflist for a list of available bridge ports. OPTIONAL src The source IP address (range) the packet should [or should NOT] come from. (Supports cidr notation). OPTIONAL dstintf The name of the interface the packet should [or should NOT] be going to.
Firewall Commands srcportend The source TCP/UDP port range end (inclusive). (Only applicable for ranges) Select one of the supported TCP/UDP port names (See “ Supported TCP/UDP Port Names” on page 414 for a listing of TCP/UDP port names supported by the SpeedTouch™). Alternatively, specify the protocol number. OPTIONAL dstport The TCP/UDP port (or beginning of range) the packet should [or should NOT] be going to.
Firewall Commands RELATED COMMANDS: firewall rule clear Clear statistics for a given rule. firewall rule delete Delete a specified rule in a chain. firewall rule flush Delete all rules in a chain. firewall rule list Show a list of all (or a specified) chains' rules. firewall rule stats Show statistics for all (or a specified) chains' rules.
Firewall Commands firewall rule delete Delete a rule. SYNTAX: firewall rule delete chain = index = chain The name of the chain in which to delete the rule. REQUIRED index The index number of the rule in the chain. REQUIRED Note Use :firewall rule list first to determine the index number of the applicable rule. EXAMPLE: =>firewall rule list chain=Telnet :firewall rule create chain=Telnet index=0 srcintfgrp=lan src=10.0.0.0/8 dst=200.200.200.
Firewall Commands firewall rule flush Flush all rules created for a chain(s). The chain itself is not removed. Note The flush command does not impact previously saved configurations. SYNTAX: firewall rule flush [chain = ] chain The name of the chain to empty. Note OPTIONAL If this parameter is not specified, all rules for all chains are deleted. EXAMPLE: =>firewall rule list chain=Telnet :firewall rule create chain=Telnet index=0 srcintfgrp=lan src=10.0.0.0/8 | dst=200.200.200.
Firewall Commands firewall rule list Show a list of rules. SYNTAX: firewall rule list [chain = ] chain The name of the chain to list the rules of. Note If this parameter is not specified, all rules for all chains are shown. EXAMPLE: =>firewall rule list chain=Telnet :firewall rule create chain=Telnet index=0 srcintfgrp=lan src=10.0.0.0/8 | dst=200.200.200.
Firewall Commands firewall rule stats Show statistics, i.e. the number of packets and bytes which have passed the hooks. SYNTAX: firewall rule stats [chain = ] [index = ] chain The name of the chain of which the statistics must be listed. In case this parameter is not specified the statistics for the rules applicable to all chains are shown. OPTIONAL index The index number of the chain's rule of which the statistics must be listed.
Firewall Commands EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DHCP client on its Ethernet interface eth0. =>firewall rule list chain=Sending :firewall rule create chain=Sending index=0 srcintfgrp=lan src=10.0.0.3/32 dst=10.10.1.1/32 prot=icmp action=count :firewall rule create chain=Sending index=1 srcintfgrp=lan src=10.10.1.1/32 dst=10.0.0.
IP Commands IP Commands Contents This chapter covers the following commands: Topic Page ip apadd 196 ip apdelete 198 ip aplist 199 ip arpadd 200 ip arpdelete 201 ip arplist 202 ip config 203 ip flush 206 ip ifconfig 207 ip iflist 208 ip ifwait 209 ip ping 210 ip rtadd 211 ip rtdelete 212 ip rtlist 213 ip sendto 214 ip traceroute 215 ip auto flush 217 ip auto ifadd 218 ip auto ifattach 219 ip auto ifconfig 220 ip auto ifdelete 221 ip auto ifdetach 222 ip auto
IP Commands ip apadd Assign an Internet Protocol (IP) address to an interface. SYNTAX: ip apadd addr = [netmask = ] intf = [pointopoint = ] [addrtrans = <{none|pat}>] [addroute = <{no|yes}>] addr The new IP address to add. REQUIRED netmask The subnetmask associated with this address. OPTIONAL intf The IP interface name. REQUIRED pointopoint The remote IP address in case of a dedicated point-to-point link.
IP Commands EXAMPLE: =>ip aplist 1 eth0 Type:Ethernet HWaddr 00:80:9f:24:ab:cf BRHWaddr ff:ff:ff:ff:ff:ff inet addr:10.10.10.147 Bcast:10.10.10.255 Mask:255.0.0.0 UP RUNNING pat MTU:1500 ReasmMAX:65535 Group:2 IPRX bytes:19791886 unicastpkts:11341 brcastpkts:290555 IPTX bytes:839550 unicastpkts:11477 brcastpkts:0 droppkts:0 HWRX bytes:0 unicastpkts:0 brcastpkts:0 HWTX bytes:0 unicastpkts:0 brcastpkts:0 droppkts:0 0 loop Type:0 inet addr:127.0.0.1 Bcast:127.255.255.255 Mask:255.0.0.
IP Commands ip apdelete Remove an IP address from an interface. SYNTAX: ip apdelete addr = addr The IP address to delete. EXAMPLE: =>ip aplist 2 eth0 Type:Ethernet HWaddr 00:80:9f:24:ab:cf BRHWaddr ff:ff:ff:ff:ff:ff inet addr:10.0.0.2 Bcast:10.0.0.255 Mask:255.255.255.
IP Commands ip aplist Show a list of all configured IP addresses. SYNTAX: ip aplist EXAMPLE: =>ip aplist 2 eth0 Type:Ethernet HWaddr 00:80:9f:24:ab:cf BRHWaddr ff:ff:ff:ff:ff:ff inet addr: 10.0.0.2 Bcast: 10.0.0.255 Mask: 255.255.255.
IP Commands ip arpadd Adds an entry to the ARP cache of a broadcast IP interface. SYNTAX: ip arpadd intf = ip = [hwaddr = ] intf The interface name. REQUIRED ip The IP address. REQUIRED hwaddr The hardware address (e.g. the Ethernet MAC address). OPTIONAL EXAMPLE: =>ip arplist Intf IP-address HW-address eth0 10.0.0.1 00:01:42:5f:7d:81 eth0 10.0.0.8 00:a0:24:ae:66:e1 eth0 10.0.1.99 52:41:53:20:20:4d eth0 10.0.1.
IP Commands ip arpdelete Remove an entry from the SpeedTouch™ ARP cache. SYNTAX: ip arpdelete intf = ip = [hwaddr = ] intf The interface name. REQUIRED ip The IP address. REQUIRED hwaddr The hardware address (e.g. the Ethernet MAC address). OPTIONAL EXAMPLE: =>ip arplist Intf IP-address HW-address eth0 10.0.0.1 00:01:42:5f:7d:81 eth0 10.0.0.8 00:a0:24:ae:66:e1 eth0 10.0.1.99 52:41:53:20:20:4d eth0 10.0.1.100 52:41:53:20:f0:90 eth0 10.0.0.
IP Commands ip arplist Show the SpeedTouch™ ARP cache. SYNTAX: ip arplist EXAMPLE: =>ip arplist Intf eth0 eth0 eth0 eth0 eth0 => IP-address 10.0.0.1 10.0.0.8 10.0.1.99 10.0.1.100 10.0.0.2 HW-address 00:01:42:5f:7d:81 00:a0:24:ae:66:e1 52:41:53:20:20:4d 52:41:53:20:f0:90 00:10:a4:d0:9a:db RELATED COMMANDS: ip arpadd Add a static entry to the ARP cache. ip arpdelete Delete an entry from the ARP cache.
IP Commands ip config Show/set global IP stack configuration options. SYNTAX: ip config [forwarding = <{off|on}>] [firewalling = <{off|on}>] [redirects = <{off|on}>] [sourcerouting = <{off|on}>] [netbroadcasts = <{off|on}>] [ttl = ] [fraglimit = ] [defragmode = <{normal|always|nat}>] [addrcheck = <{off|own|static|dynamic}>] [mssclamping = <{off|on}>] forwarding Disable (off) or enable (on) the IP routing functionality.
IP Commands fraglimit A number between 1 and 1024. Represents the maximum number of IP packet fragments waiting for completion. Generally the fragmentation limit is 64. By limiting the fragmentation limit the depletion of the buffer is avoided. OPTIONAL defragmode Define which packets are reassembled under which circumstances. Choose between: OPTIONAL addrcheck mssclamping 204 • normal Packets to be forwarded will not be reassembled. Packets with local destination, i.e.
IP Commands EXAMPLE: =>ip config Forwarding on Firewalling off Sendredirects off Sourcerouting on NetBroadcasts off Default TTL 128 Fraglimit 32 fragments Fragcount currently 0 fragments Defragment mode : always Address checks : static Mss clamping : on =>ip config firewalling=on ttl=64 fraglimit=64 defragmode=nat =>ip config Forwarding on Firewalling on Sendredirects off Sourcerouting on NetBroadcasts off Default TTL 64 Fraglimit 64 fragments Fragcount currently 0 fragments Defragment mode : nat Address c
IP Commands ip flush Flush complete IP configuration. Dynamic configurations (e.g. from PPP or CIP links) remain. Note As an ip flush causes all local IP connectivity to be deleted, do not execute this command during an IP based local connection, e.g. a Telnet CLI session, or web based CLI access. Note The flush command does not impact previously saved configurations. SYNTAX: ip flush EXAMPLE: =>ip aplist 3 cip1 Type:ATM inet addr:172.16.0.5 Bcast:172.16.0.255 Mask:255.255.255.
IP Commands ip ifconfig Configure IP interface parameters. SYNTAX: ip ifconfig intf = [mtu = ] [status = <{down|up}>] [hwaddr = ] [group = <{wan|local|lan}>] [linksensing = <{off|on}>] intf The IP interface name. REQUIRED mtu A number between 68 and 20000. Represents the maximum transmission unit, i.e. the maximum packet size (including IP header) to use on this interface.
IP Commands ip iflist Show all current interfaces. SYNTAX: ip iflist EXAMPLE: =>ip iflist Interface GRP 0 loop 1 1 eth0 2 2 NewETHoA 0 5 cip0 0 => MTU RX 1500 116 3000 21045795 1500 0 9180 0 TX 0 1019664 0 0 TX-DROP 0 0 0 0 STATUS UP UP UP UP RELATED COMMANDS: ip ifconfig 208 Configure interface parameters.
IP Commands ip ifwait Wait for a status change of an IP interface. SYNTAX: ip ifwait intf = [timeout = ] [adminstatus = <{down|up}>] [operstatus = <{down|up}>] [linkstatus = <{down|up}>] intf The IP interface name. REQUIRED timeout A number between 1 and 600000. Represents the timeout in seconds. OPTIONAL adminstatus The administrative state of the interface.
IP Commands ip ping Send ICMP ECHO_REQUEST packets. SYNTAX: ip ping addr = [count = ] [size = ] [interval = ] [listen = <{off|on}>] addr The destination IP address. REQUIRED count A number between 1 and 1000000. Represents the number of pings to send. OPTIONAL size A number between 1 and 20000 (bytes). Represents the size of the ping packet(s). OPTIONAL interval A number between 100 and 10000000 (milliseconds).
IP Commands ip rtadd Add a route to the SpeedTouch™ routing table. SYNTAX: ip rtadd dst = [dstmsk = ] [label = <{}>] [gateway = ] [intf = ] [metric = ] dst The destination IP address(es) for this route. Supports cidr notation. REQUIRED dstmsk The destination IP address mask. OPTIONAL label The name of the label. OPTIONAL gateway The IP address of the next hop. Must be directly connected.
IP Commands ip rtdelete Delete a route from the SpeedTouch™ routing table. SYNTAX: ip rtdelete dst = [dstmsk = ] [label = <{}>] [gateway = ] [intf = ] dst The destination IP address(es) for this route. Supports cidr notation. REQUIRED dstmsk The destination IP address mask. OPTIONAL label The name of the label. OPTIONAL gateway The IP address of the next hop. Must be directly connected.
IP Commands ip rtlist Show current SpeedTouch™ routing table. SYNTAX: ip rtlist EXAMPLE: =>ip rtlist Destination Label 10.0.0.0/24 10.0.0.140/32 127.0.0.1/32 => Gateway 10.0.0.140 10.0.0.140 127.0.0.1 Intf Mtrc Status eth0 0 [UP] eth0 0 [UP] loop 0 [UP] RELATED COMMANDS: ip rtadd Add a route to the routing table. ip rtdelete Remove a route from the routing table.
IP Commands ip sendto Send UDP packets. SYNTAX: ip sendto addr = [count = ] [size = ] [interval = ] [listen = <{off|on}>] [srcport = ] dstport = addr The destination IP address. REQUIRED count A number between 1 (default) and 1000000. Represents the number of UDP packets to send. OPTIONAL size A number between 1 (default) and 20000 (bytes). Represents the size of the ping packet(s).
IP Commands ip traceroute Sends ICMP/UDP packets to trace the ip path. SYNTAX: ip traceroute addr = [count = ] [size = ] [interval = ] [maxhops = ] [dstport = ] [maxfail = ] [type = <{icmp|udp}>] [utime = <{no|yes}>] addr The destination IP address. REQUIRED count A number between 1 and 10. Represents the number of times to reissue a traceroute request with the same time to live.
IP Commands EXAMPLE: =>ip traceroute addr = 192.193.195.250 count=3 size=1 interval=1000 maxhops=30 dstport=33433 maxfail=5 type=icmp utime=yes :ip traceroute addr=192.193.195.250 ttl=1 192.193.195.
IP Commands ip auto flush Flush the autoIP interfaces. SYNTAX: ip auto flush RELATED COMMANDS: ip auto ifadd Create a new autoIP interface. ip auto ifdelete Delete an existing autoIP interface. ip auto iflist Show the autoIP interfaces.
IP Commands ip auto ifadd Create a new autoIP interface. SYNTAX: ip auto ifadd intf = [addr = ] intf The name of the IP interface for which a link-local address has to be allocated. REQUIRED addr The preferred link-local IP address. OPTIONAL RELATED COMMANDS: ip auto flush Flush the autoIP interfaces. ip auto ifdelete Delete an existing autoIP interface. ip auto iflist Show the autoIP interfaces.
IP Commands ip auto ifattach Select and assign a link-local address to an autoIP interface. SYNTAX: ip auto ifattach intf = intf The name of the IP interface for which a link-local address has to be attached. REQUIRED RELATED COMMANDS: ip auto ifdetach Release the link-local address for the given autoIP interface.
IP Commands ip auto ifconfig Configure an autoIP interface. SYNTAX: ip auto ifconfig intf = [addr = ] [poolstart = ] [poolend = ] [netmask = ] [claim = ] [defence = ] [probe = ] [interval = ] intf The name of the autoIP interface to configure. REQUIRED addr The preferred link-local IP address.
IP Commands ip auto ifdelete Delete an existing autoIP interface. SYNTAX: ip auto ifdelete intf = intf The name of the IP interface to be deleted. REQUIRED RELATED COMMANDS: ip auto flush Flush the autoIP interfaces. ip auto ifadd Create a new autoIP interface. ip auto iflist Show the autoIP interfaces.
IP Commands ip auto ifdetach Release the link-local address for the given autoIP interface. SYNTAX: ip auto ifdetach intf = intf The name of the IP interface for which a link-local address has to be detached. RELATED COMMANDS: ip auto ifattach 222 Select and assign a link-local address to an autoIP interface.
IP Commands ip auto iflist Shows the autoIP interfaces. SYNTAX: ip auto iflist [intf = ] intf The name of the interface to be listed. If no name is specified, all the autoIP interfaces are shown. OPTIONAL EXAMPLE: =>ip auto iflist eth0 : [CLAIMED] 169.254.138.1 poolstart = 169.254.1.1 claim : 10 defence : 5 probes sent = 2 collisions = 0 poolend = 169.254.254.254 netmask = 255.255.0.0 probe : 4 interval : 2 (sec) => RELATED COMMANDS: ip auto ifadd Create a new autoIP interface.
IP Commands 224
IPoA Commands IPoA Commands Contents This chapter covers the following commands: Topic Page ipoa flush 226 ipoa ifadd 227 ipoa ifattach 228 ipoa ifconfig 229 ipoa ifdelete 231 ipoa ifdetach 232 ipoa iflist 233 225
IPoA Commands ipoa flush Flush complete Routed IPoA configuration. Note The flush command does not impact previously saved configurations. SYNTAX: ipoa flush RELATED COMMANDS: ipoa ifadd Create a new Routed IPoA interface. ipoa ifattach Attach (i.e. connect) an Routed IPoA interface. ipoa ifconfig Configure a Routed IPoA interface. ipoa ifdelete Delete a Routed IPoA interface. ipoa ifdetach Detach a Routed IPoA interface. ipoa iflist Show current Routed IPoA interfaces.
IPoA Commands ipoa ifadd Create a new Routed IPoA interface. SYNTAX: ipoa ifadd [intf = ] [dest = ] intf The name for the new Routed IPoA interface. If not specified, the destination will double as interface name. OPTIONAL dest The destination for the new Routed IPoA interface. Typically, a phonebook entry.
IPoA Commands ipoa ifattach Attach (i.e. connect) an Routed IPoA interface. SYNTAX: ipoa ifattach intf = intf The name of the Routed IPoA interface to attach.
IPoA Commands ipoa ifconfig Configure an IPoA interface. SYNTAX: ipoa ifconfig intf = [dest = ] [qos = ] [encaps = <{llc/snap|vcmux}>] [retry = ] intf The name of the Routed IPoA 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 a configured Quality Of Service book entry.
IPoA Commands RELATED COMMANDS: ipoa ifadd Create a new Routed IPoA interface. ipoa ifattach Attach (i.e. connect) an Routed IPoA interface. ipoa ifdelete Delete a Routed IPoA interface. ipoa ifdetach Detach a Routed IPoA interface. ipoa iflist Show current Routed IPoA interfaces.
IPoA Commands ipoa ifdelete Delete a Routed IPoA interface. SYNTAX: ipoa ifdelete intf = intf The name of the Routed IPoA interface.
IPoA Commands ipoa ifdetach Detach a Routed IPoA interface. SYNTAX: ipoa ifdetach intf = intf The name of the Routed IPoA interface.
IPoA Commands ipoa iflist Show all or a specified Routed IPoA interface(s). SYNTAX: ipoa iflist [intf = ] intf The name of the Routed IPoA interface. If not specified all Routed IPoA interfaces are listed.
IPoA Commands 234
Label Commands Label Commands Contents This chapter covers the following commands: Topic Page label add 236 label config 237 label delete 238 label flush 239 label list 240 label troff 241 label tron 242 label chain create 243 label chain delete 244 label chain flush 245 label chain list 246 label rule clear 247 label rule create 248 label rule delete 250 label rule flush 251 label rule list 252 label rule stats 253 235
Label Commands label add Create a new label. SYNTAX: label add name = name The name of the label to add. EXAMPLE: =>label add name=Label1 =>label list Name Tosmark Tos Label1 disabled 0 => Use 0 Trace disabled RELATED COMMANDS: label config Configure a label. label delete Delete a label.
Label Commands label config Configure a label. SYNTAX: label config name = [tosmarking = <{disabled|enabled}>] [tos = ] [trace = <{disabled|enabled}>] name The name of the label to configure. REQUIRED tosmarking Enable/disable tos marking. Choose between OPTIONAL • disabled (default). • enabled. tos A number between 0 and 255. Represents the Type of Service (ToS) specification in the IP packet (used for tosmarking). Default is 0.
Label Commands label delete Delete a label SYNTAX: label delete name = [force = <{no|yes}>] name The name of the label to delete. REQUIRED force Force delete and cleanup references even when the label is still in use. Choose between OPTIONAL • no (default). • yes. RELATED COMMANDS: label add Add a label. label config Configure a label.
Label Commands label flush Flushes all labels. Note The flush command does not impact previously saved configurations.
Label Commands label list Show the association(s) between all hooks or a specified hook and their chain(s). SYNTAX: label list [name = ] name The name of the label to be shown. If no name is specified, all labels will be shown EXAMPLE: =>label list Name Tosmark Tos Label1 enabled 25 Label2 disabled 0 =>label list name=Label2 Name Tosmark Tos Label2 disabled 0 => Use 0 0 Trace enabled disabled Use 0 Trace disabled RELATED COMMANDS: label flush 240 Flushes all labels.
Label Commands label troff Disable verbose console messaging. SYNTAX: label troff EXAMPLE: =>label troff RELATED COMMANDS: label tron Enable verbose console messaging.
Label Commands label tron Enable verbose console messaging. SYNTAX: label tron EXAMPLE: =>label tron RELATED COMMANDS: label troff 242 Disable verbose console messaging.
Label Commands label chain create Create a new chain. SYNTAX: label chain create chain chain = The name of the chain to create. REQUIRED RELATED COMMANDS: label chain delete Delete a chain. label chain list Show a list of all current chains.
Label Commands label chain delete Delete a chain. SYNTAX: label chain delete chain chain = The name of the chain to be deleted. RELATED COMMANDS: label chain create Create a chain. label chain list Show a list of all chains.
Label Commands label chain flush Flush all chains. SYNTAX: label chain flush RELATED COMMANDS: label chain create Create a chain. label chain delete Delete a chain. label chain list Show a list of all chains.
Label Commands label chain list Show a list of all current chains. SYNTAX: label chain list RELATED COMMANDS: label chain create Create a chain. label chain delete Delete a chain.
Label Commands label rule clear Clear statistics for a given rule. SYNTAX: label rule clear [chain = ] [index = ] chain The name of the chain in which the rule is to be found. OPTIONAL index The index number (determined by the position) of the rule in the chain. OPTIONAL RELATED COMMANDS: label rule create Create a rule. label rule delete Delete a specified rule in a chain. label rule flush Delete all rules in a chain.
Label Commands label rule create Create a rule.
Label Commands precedence A number between 0 and 7. Represents the precedence in the IP packet (is part of tos) OPTIONAL dscp The DSCP in the IP packet (part of tos). OPTIONAL prot The protocol (name or number) expected in the IP packet. Select one of the supported protocol names (See “ Supported Internet Protocol (IP) Protocol Names” on page 413 for a listing of protocol names supported by the SpeedTouch™). Alternatively, specify the protocol number.
Label Commands label rule delete Delete a rule. SYNTAX: label rule delete chain = index = chain The name of the chain in which to delete the rule. REQUIRED index The index number of the rule in the chain. REQUIRED Note Use :label rule list first to determine the index number of the applicable rule. RELATED COMMANDS: label rule clear Clear statistics for a given rule. label rule create Create a rule. label rule flush Delete all rules in a chain.
Label Commands label rule flush Flush all rules created for a chain(s). The chain itself is not removed. Note The flush command does not impact previously saved configurations. SYNTAX: label rule flush [chain = ] chain The name of the chain to empty. Note OPTIONAL If this parameter is not specified, all rules for all chains are deleted. RELATED COMMANDS: label rule clear Clear statistics for a given rule. label rule create Create a rule.
Label Commands label rule list Show a list of rules. SYNTAX: label rule list [chain = ] chain The name of the chain to list the rules of. Note If this parameter is not specified, all rules for all chains are shown. EXAMPLE INPUT AND OUTPUT: =>label rule list label rule create chain=_auto_labels index=0 clink=user_labels label=link => RELATED COMMANDS: label rule clear Clear statistics for a given rule. label rule create Create a rule. label rule delete Delete a specified rule in a chain.
Label Commands label rule stats Show statistics, i.e. the number of packets and bytes which have passed the hooks. SYNTAX: label rule stats [chain = ] [index = ] chain The name of the chain of which the statistics must be listed. In case this parameter is not specified the statistics for the rules applicable to all chains are shown. OPTIONAL index The index number of the chain's rule of which the statistics must be listed.
Label Commands 254
Language Commands Language Commands Contents This chapter covers the following commands: Topic Page language config 256 language list 257 language remove 258 255
Language Commands language config Select a language. SYNTAX: language config [language = ] language Language code: OSI language code (2 chars) for language (en=english) RELATED COMMANDS: language list List available languages archives. language remove Remove one or all language archives.
Language Commands language list List available languages archives. SYNTAX: language list EXAMPLE: =>language list CODE LANGUAGE en* english VERSION FILENAME 4.2.0.1 RELATED COMMANDS: language config Select a language. language remove Remove one or all language archives.
Language Commands language remove Remove one or all language archives. SYNTAX: language remove [file = ] [all <{yes|no}>] file Filename: name of language archive to remove OPTIONAL all Removes all languages archives. Choose between: OPTIONAL • yes • no RELATED COMMANDS: language config Select a language. language remove Remove one or all language archives.
NAT Commands NAT Commands Contents This chapter covers the following commands: Topic Page nat applist 260 nat bind 261 nat bindlist 264 nat clear 265 nat config 266 nat create 267 nat defserver 269 nat delete 270 nat disable 272 nat enable 273 nat flush 274 nat list 275 nat multinatadd 276 nat multinatdelete 277 nat multinatlist 278 nat unbind 279 259
NAT Commands nat applist List available Network Address Translation / Port Address Translation (NAT/PAT) protocol helpers. Certain protocols are ‘sensitive‘ to NAT/PAT in that they do not function properly when dealing with it. This list shows which ‘NAT/PAT-sensitive‘ applications are supported on the SpeedTouch™, i.e. the inherent knowledge of the SpeedTouch™ on this matter.
NAT Commands nat bind Create a new helper/port binding. SYNTAX: nat bind application = port = <{|}> [port_end = <{|}>] application The name of a NAT/PAT application helper. The name must be spelled exactly as listed in the application list (:nat applist). REQUIRED port The TCP/UDP port this application handler should work on.
NAT Commands EXAMPLE: =>nat bindlist Application Proto Port SIP udp 5060 GRE gre 1 PPTP tcp 1723 ILS tcp 1002 ILS tcp 389 H323 tcp 1720 FTP tcp 21 IRC tcp 6667 RAUDIO(PNA) tcp 7070 =>nat bind application=RAUDIO(PNA) port=7071 =>nat bindlist Application Proto Port SIP udp 5060 GRE gre 1 PPTP tcp 1723 ILS tcp 1002 ILS tcp 389 H323 tcp 1720 FTP tcp 21 IRC tcp 6667 RAUDIO(PNA) tcp 7070 RAUDIO(PNA) tcp 7071 => EXAMPLE: =>nat bindlist Application Proto Port FTP tcp 21 GRE gre 1 H323 tcp 1720 ILS tcp 389 ILS tcp
NAT Commands RELATED COMMANDS: nat applist List available NAT/PAT protocol helpers. nat bindlist List current NAT/PAT helper/port bindings.
NAT Commands nat bindlist List current NAT/PAT helper/port bindings. SYNTAX: nat bindlist EXAMPLE: =>nat bindlist Application Proto SIP udp GRE gre PPTP tcp ILS tcp ILS tcp H323 tcp FTP tcp RTSP tcp IRC tcp RAUDIO(PNA) tcp => Port 5060 1 1723 1002 389 1720 21 554 6667 7070 RELATED COMMANDS: nat applist List available NAT/PAT protocol helpers. nat bind Create a new helper/port binding.
NAT Commands nat clear Clear NAT/PAT connection database. SYNTAX: nat clear [addr = ] addr An address-translation enabled IP address. If no IP address is specified, all IP addresses are cleared.
NAT Commands nat config Configure NAT parameters for IP session. SYNTAX: nat config [timeout_ICMP = ] [timeout_UDP = ] [timeout_TCP = ] [timeout_TCP_nego = ] [timeout_other = ] [ike_port = <{fixed|floated}>] timeout_ICMP The interval of time for which an ICMP protocol session is allowed to remain valid without any activity. Syntax: or .
NAT Commands nat create Create a static NAT/PAT entry. Typically used to install specific servers behind the SpeedTouch™ NAT/PAT device.
NAT Commands foreign_port The port of the routable host. Select one of the supported TCP/UDP port names (See “ Supported TCP/UDP Port Names” on page 414 for a listing of TCP/UDP port names supported by the SpeedTouch™). Alternatively, specify the protocol number. Do not use '0' in case a foreign IP address is specified. Applicable for TCP and UDP protocols only. Other protocols do not need a port to be specified. RELATED COMMANDS: nat delete Delete a static NAT/PAT entry.
NAT Commands nat defserver Define the default server behind the SpeedTouch™ NAT/PAT device that receives all (unknown) incoming packets. In typical LAN configurations one local 'default' server will be responsible for all WAN-LAN mail, http, ftp, ... connectivity. This command allows to specify this server. For specific services, use :nat create. SYNTAX: nat defserver [addr = ] addr The IP address of the server (on the ‘inside‘) that will receive all (unknown) incoming packets.
NAT Commands nat delete Delete a static NAT/PAT entry. SYNTAX: nat delete protocol = <{|}> inside_addr = [inside_port = <{|}>] outside_addr = [outside_port = <{|}>] [foreign_addr = ] [foreign_port = <{|}>] protocol The IP protocol name (or number) of the incoming stream.
NAT Commands foreign_port The port of the routable host. Select one of the supported TCP/UDP port names (See “ Supported TCP/UDP Port Names” on page 414 for a listing of TCP/UDP port names supported by the SpeedTouch™). Alternatively, specify the protocol number. Applicable for TCP and UDP protocols only. Other protocols do not need a port to be specified. OPTIONAL RELATED COMMANDS: nat create Create a static NAT/PAT entry. nat disable Disable NAT/PAT on a SpeedTouch™ IP address.
NAT Commands nat disable Disable NAT or PAT on the specified SpeedTouch™ IP address. SYNTAX: nat disable addr = addr The SpeedTouch™ IP address for which NAT/PAT must be disabled. REQUIRED EXAMPLE: =>nat list Indx Prot Inside-addr:Port Outside-addr:Port 1 6 10.0.0.138:80 172.16.0.5:1080 2 17 10.0.0.138:138 10.0.0.140:138 3 17 10.0.0.138:137 10.0.0.140:137 4 17 10.0.0.138:7938 10.0.0.140:7938 5 17 10.0.0.138:513 10.0.0.140:513 6 17 10.0.0.138:111 10.0.0.140:111 =>nat disable addr 172.16.0.
NAT Commands nat enable Enable NAT/PAT on a SpeedTouch™ IP address. SYNTAX: nat enable addr = [type = <{none|pat}>] addr The IP address to use for outgoing address translation. Must be one of the own IP addresses of the SpeedTouch™ (see 'ip aplist'). REQUIRED type Enable port translation (pat) or not (none). OPTIONAL EXAMPLE: =>ip aplist 1 eth0 Type:Ethernet HWaddr 00:80:9f:24:ab:cf BRHWaddr ff:ff:ff:ff:ff:ff inet addr:10.10.10.147 Bcast:10.10.10.255 Mask:255.0.0.
NAT Commands nat flush Flush complete NAT/PAT configuration. Note The flush command does not impact previously saved configurations. SYNTAX: nat flush RELATED COMMANDS: nat create Create a static NAT/PAT entry. nat delete Delete a static NAT/PAT entry. nat disable Disable NAT/PAT on a SpeedTouch™ IP address. nat enable Enable NAT/PAT on one of the SpeedTouch™ IP addresses.
NAT Commands nat list Lists NAT/PAT connection database. SYNTAX: nat list [addr = ] addr An address-translation enabled IP address. If no address is specified, all IP addresses are shown. OPTIONAL EXAMPLE: =>nat list Indx Prot Inside-addr:Port 1 6 10.0.0.138:80 2 17 10.0.0.138:138 3 17 10.0.0.138:137 4 17 10.0.0.138:7938 5 17 10.0.0.138:513 6 17 10.0.0.138:111 => Outside-addr:Port 172.16.0.5:1080 10.0.0.140:138 10.0.0.140:137 10.0.0.140:7938 10.0.0.140:513 10.0.0.
NAT Commands nat multinatadd Add a MultiNAT configuration. SYNTAX: nat multinatadd intf = inside_addr = outside_addr = intf The IP interface name where MultiNAT has to be applied. REQUIRED inside_addr The IP address of the host behind the address translation device that will receive the incoming traffic. Typically, a private IP address. REQUIRED outside_addr The apparent host IP address this application will running on. Use '0' to create a template.
NAT Commands nat multinatdelete Delete a MultiNAT configuration. SYNTAX: nat multinatdelete index index = The MultiNAT index as listed by maplist. REQUIRED RELATED COMMANDS: nat multinatadd Add a MultiNAT configuration. nat multinatlist List MultiNAT configurations.
NAT Commands nat multinatlist List MultiNAT configurations. SYNTAX: nat multinatlist addr [intf = ] The IP interface name for which the MultiNAT configuration must be listed. If no name is specified, all MultiNAT configurations are listed. RELATED COMMANDS: nat multinatadd Add a MultiNAT configuration. nat multinatdelete Delete a MultiNAT configuration.
NAT Commands nat unbind Delete an existing helper/port binding. SYNTAX: nat unbind application = port = <{|}> [port_end = <{|}>] application The name of a NAT/PAT application helper. The name must be spelled exactly as listed in the application list (:nat applist). REQUIRED port The TCP/UDP port this application handler is working on.
NAT Commands RELATED COMMANDS: nat applist List available NAT/PAT protocol helpers. nat bind Create a new helper/port binding. nat bindlist List current NAT/PAT helper/port bindings.
Phonebook Commands Phonebook Commands Contents This chapter covers the following commands: Topic Page phonebook add 282 phonebook autolist 284 phonebook delete 285 phonebook flush 286 phonebook list 287 281
Phonebook Commands phonebook add Add a phonebook entry. SYNTAX: phonebook add name = addr = type = <{any|ethoa|pppoa|ipoa}> name A free to choose phonebook name for the destination.
Phonebook Commands EXAMPLE: =>phonebook list Name Type Use Address usb_port any 1 usb.0.35 PVC1 any 1 8.35 PVC2 ethoa 0 8.36 Br4 ethoa 0 8.38 CIPPVC3 ipoa 1 8.82 =>phonebook add name=PVC_Test addr=8.68 type=pppoa =>phonebook list Name Type Use Address usb_port any 1 usb.0.35 PVC1 any 1 8.35 PVC2 ethoa 0 8.36 Br4 ethoa 0 8.38 CIPPVC3 ipoa 1 8.82 PVC_Test pppoa 0 8.68 => Note The usb_port phonebook entry is only applicable in case of a SpeedTouch™530 variant.
Phonebook Commands phonebook autolist Show auto PVCs, if supported by the Central Office DSLAM. SYNTAX: phonebook autolist EXAMPLE INPUT/OUTPUT: =>phonebook autolist 8.35 => RELATED COMMANDS: phonebook list 284 Show current phonebook.
Phonebook Commands phonebook delete Remove an unused phonebook entry. SYNTAX: phonebook delete name name = The name of the phonebook entry to delete. Only applicable for phonebook entries that are not used, i.e. not configured for any packet service. Execute phonebook list to check whether the entry is used (Use=1) or not (Use=0). REQUIRED EXAMPLE: =>phonebook list Name Type Use Address usb_port any 1 usb.0.35 PVC1 any 1 8.35 PVC2 ethoa 0 8.36 Br4 ethoa 0 8.38 CIPPVC3 ipoa 1 8.
Phonebook Commands phonebook flush Flush complete phonebook. Note The flush command does not impact previously saved configurations. SYNTAX: phonebook flush EXAMPLE: =>phonebook list Name Type usb_port any PVC1 any PVC2 ethoa Br4 ethoa CIPPVC3 ipoa PVC_Test pppoa =>phonebook flush =>phonebook list Name Type => Note 286 Use 1 1 0 0 1 0 Address usb.0.35 8.35 8.36 8.38 8.82 8.
Phonebook Commands phonebook list Show current phonebook. SYNTAX: phonebook list EXAMPLE INPUT/OUTPUT: =>phonebook list Name Type usb_port any PVC1 any PVC2 ethoa Br4 ethoa CIPPVC3 ipoa PVC_Test pppoa => Note Use 1 1 0 0 1 0 Address usb.0.35 8.35 8.36 8.38 8.82 8.68 The usb_port phonebook entry is only applicable in case of a SpeedTouch™530 variant. Do not change this phonebook entry in any way, or delete it from the phonebook! RELATED COMMANDS: phonebook add Add a phonebook entry.
Phonebook Commands 288
PPPoA Commands PPPoA Commands Contents This chapter covers the following commands: Topic Page pppoa flush 290 pppoa ifadd 291 pppoa ifattach 293 pppoa ifconfig 294 pppoa ifdelete 298 pppoa ifdetach 299 pppoa iflist 300 pppoa rtadd 301 pppoa rtdelete 303 289
PPPoA Commands pppoa flush Flushes the current PPPoA configuration. Note The flush command does not impact previously saved configurations. SYNTAX: pppoa flush EXAMPLE: =>pppoa iflist pppoa1: dest : pppoa1 Retry: 10 QoS default encaps VC-MUX mode = IP Routing flags = echo magic accomp mru addr route savepwd pppoaOA trans addr = pat mru = 1500 route = 0.0.0.0/0 - 0.0.0.
PPPoA Commands pppoa ifadd Create a new PPPoA interface. SYNTAX: pppoa ifadd [intf = ] [dest = ] intf The name for the new PPPoA interface. If not specified, the destination will double as interface name. OPTIONAL dest The ATM channel to be used for this PPPoA interface. Typically, an phonebook entry.
PPPoA Commands RELATED COMMANDS: pppoa ifattach Attach a PPPoA interface. pppoa ifconfig Configure a PPPoA interface. pppoa ifdelete Delete a PPPoA interface. pppoa ifdetach Detach a PPPoA interface. pppoa iflist Show current PPPoA configuration.
PPPoA Commands pppoa ifattach Attach (i.e. connect) a PPPoA interface. SYNTAX: pppoa ifattach intf = intf The name of the PPPoA interface to attach. REQUIRED EXAMPLE: =>pppoa iflist pppoa1: dest : pppoa1 [00:00:00] Retry : 10 QoS default encaps VC-MUX mode = IP routing flags = echo magic accomp restart mru addr savepwd dns metric = 0 mru = 1500 auth = auto user = password = admin state = down oper state = down link state = not-connected LCP : state = initial retransm = 10 term.
PPPoA Commands pppoa ifconfig Configure a PPPoA interface. Note The interface to be configured may not be connected at the time of configuration. Execute PPPoA ifdetach prior to executing the PPPoA ifconfig command.
PPPoA Commands encaps The WAN protocol encapsulation to be used on this interface. Choose between: • vcmux • llc OPTIONAL pcomp Try (on) or do not try (off) to negotiate PPPoA protocol compression (LCP PCOMP). By default the negotiation is disabled (off). OPTIONAL accomp Try (on), do never try (off) or negotiate (negotiate) to negotiate PPPoA address & control field compression (LCP ACCOMP). In most cases, LCP ACCOMP should not be disabled nor negotiated, i.e.
PPPoA Commands laddr The local IP address of the peer-to-peer connection. Specifying a local IP address forces the remote side of the PPPoA link (if it allows to) to accept this IP address as the SpeedTouch™ PPPoA session IP address. If not specified, the SpeedTouch™ will accept any IP address. Typically the local IP address parameter is not specified. OPTIONAL raddr The remote IP address of the peer-to-peer connection.
PPPoA Commands idletrigger Consider the link being idle if no traffic is sent and/or received during the idle time. Choose between: • RxTx The idle time period restarts when a packet is transmitted or received (default value). • Rx: The idle time period restarts when a packet is received. Transmitted packets are ignored. • Tx The idle time period restarts when a packet is transmitted. Received packets are ignored.
PPPoA Commands pppoa ifdelete Delete a PPPoA interface. SYNTAX: pppoa ifdelete intf = intf The name of the PPPoA interface to delete. EXAMPLE: =>pppoa iflist pppoa_pppoa: dest : pppoa [00:00:00] Retry : 10 QoS default encaps VC-MUX mode = IP routing flags = echo magic accomp restart mru addr route savepwd dns metric = 0 trans addr = pat mru = 1500 route : dst=0.0.0.0/0 - src=10.0.0.
PPPoA Commands pppoa ifdetach Detach a PPPoA interface. SYNTAX: pppoa ifdetach intf = intf The name of the PPPoA interface. REQUIRED EXAMPLE: =>pppoa iflist pppoa1: dest : pppoa1 [00:00:00] Retry : 10 QoS default encaps VC-MUX mode = IP routing flags = echo magic accomp restart mru addr savepwd dns metric = 0 mru = 1500 auth = auto user = password = admin state = up oper state = up link state = connected LCP : state = starting retransm = 1 term.
PPPoA Commands pppoa iflist Show current configuration of all or a specified PPPoA interface(s). SYNTAX: pppoa iflist [intf = ] intf The name of the PPPoA interface. If this parameter is not specified, all PPPoA interfaces are shown. EXAMPLE INPUT/OUTPUT: =>pppoa iflist pppoa_pppoa: dest : pppoa [00:00:00] Retry : 10 QoS default encaps VC-MUX mode = IP routing flags = echo magic accomp restart mru addr route savepwd dns metric = 0 trans addr = pat mru = 1500 route : dst=0.0.0.0/0 - src=10.0.
PPPoA Commands pppoa rtadd Automatically add a route configuration to the routing table in case the specified PPPoA interface link comes up. This route configuration will determine which local hosts are allowed to use this link and/or which remote destinations should be or should not be reachable. Note Execute the PPPoA ifdetach command for this interface prior to configuring routes.
PPPoA Commands srcmsk metric The source IP mask. Depending on the source netmask: • Everybody is allowed to use this PPPoA connection (dstmsk=0) • Only members of the same subnet as the host which opened the PPPoA connection are allowed to use the PPPoA connection (dstmsk=1) • The actual destination mask will be the netmask applicable for the IP address of the host which opened the PPPoA connection. • Only the host which opened the PPPoA connection is allowed to use the PPPoA connection.
PPPoA Commands pppoa rtdelete Delete the route specification for a PPPoA link. Note Execute the PPPoA ifdetach command for this interface prior to deleting route configurations. SYNTAX: pppoa rtdelete intf = intf The PPPoA interface name for which to delete the route settings.
PPPoA Commands 304
PPPoE Commands PPPoE Commands Contents This chapter covers the following commands: Topic Page pppoe flush 306 pppoe ifadd 307 pppoe ifattach 309 pppoe ifconfig 311 pppoe ifdelete 316 pppoe ifdetach 317 pppoe iflist 318 pppoe ifscan 319 pppoe relay add 320 pppoe relay delete 321 pppoe relay flush 322 pppoe relay portlist 323 pppoe relay sesslist 324 pppoe rtadd 325 pppoe rtdelete 327 305
PPPoE Commands pppoe flush Flush the current PPPoE configuration. Note The flush command does not impact previously saved configurations. SYNTAX: pppoe flush EXAMPLE: =>pppoe iflist PPPoE1: dest : PPPoE1 Retry: 10 QoS default encaps VC-MUX mode = IP Routing flags = echo magic accomp mru addr route savepwd PPPoEOA trans addr = pat mru = 1500 route = 0.0.0.0/0 - 0.0.0.
PPPoE Commands pppoe ifadd Create a new PPPoE interface. SYNTAX: pppoe ifadd [intf = ] [dest = ] intf The name for the new PPPoE interface. 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 ethernet port to be used for this PPPoE interface (e.g. an ETHoA name).
PPPoE Commands RELATED COMMANDS: pppoe ifattach Attach a PPPoE interface. pppoe ifconfig Configure a PPPoE interface. pppoe ifdelete Delete a PPPoE interface. pppoe ifdetach Detach a PPPoE interface. pppoe iflist Show current PPPoE configuration.
PPPoE Commands pppoe ifattach Attach (i.e. connect) a PPPoE interface. SYNTAX: pppoe ifattach intf = intf The name of the PPPoE interface to attach. REQUIRED EXAMPLE: =>pppoe iflist PPPoE1: dest : PPPoE1 Retry: 10 QoS default encaps LLC mode = IP Routing flags = echo magic accomp restart mru addr route trans addr = pat mru = 1492 route = 0.0.0.0/0 - 0.0.0.
PPPoE Commands RELATED COMMANDS: pppoe ifadd Create a new PPPoE interface. pppoe ifconfig Configure a PPPoE interface. pppoe ifdelete Delete a PPPoE interface. pppoe ifdetach Detach a PPPoE interface. pppoe iflist Show current PPPoE configuration.
PPPoE Commands pppoe ifconfig Configure a PPPoE interface. Note The interface to be configured may not be connected at the time of configuration. Execute pppoe ifdetach prior to executing the pppoe ifconfig command.
PPPoE Commands acname The Access Concentrator name for a PPPoE connection. Execute the pppoe ifscan command to see the names of available access concentrators, if any. OPTIONAL servicename The Service Name for a PPPoE connection. Execute the pppoe ifscan command to see the available service names, if any. OPTIONAL pcomp Try (on) or do not try (off) to negotiate PPPoE protocol compression (LCP PCOMP). By default the negotiation is disabled (off).
PPPoE Commands silent Do not send anything at startup and just listen for incoming LCP messages (on) or retry up to 10 times to establish the connection (off). By default, the silent state is disabled. OPTIONAL echo Send LCP echo requests at regular intervals (on) or not (off). By default the sending of LCP echo requests is enabled. OPTIONAL mru A number between 293 and 8192. Represents the maximum packet size the SpeedTouch™ should negotiate to be able to receive (default=1492).
PPPoE Commands idle A number between 0 and 1000000 (seconds). Represents after how many seconds an idle link goes down (default is 0). OPTIONAL idletrigger Consider the link being idle if no traffic is sent and/or received during the idle time. Choose between: OPTIONAL • RxTx The idle time period restarts when a packet is transmitted or received (default value). • Rx: The idle time period restarts when a packet is received. Transmitted packets are ignored.
PPPoE Commands RELATED COMMANDS: pppoe ifadd Create a new PPPoE interface. pppoe ifattach Attach a PPPoE interface. pppoe ifdelete Delete a PPPoE interface. pppoe ifdetach Detach a PPPoE interface. pppoe iflist Show current PPPoE configuration.
PPPoE Commands pppoe ifdelete Delete a PPPoE interface. SYNTAX: pppoe ifdelete intf = intf The name of the PPPoE interface to delete. EXAMPLE: =>pppoe iflist PPPoE1: dest : PPPoE1 Retry: 10 QoS default encaps VC-MUX mode = IP Routing flags = echo magic accomp restart mru addr route savepwd PPPoEOA trans addr = pat mru = 1500 route = 0.0.0.0/0 - 0.0.0.
PPPoE Commands pppoe ifdetach Detach a PPPoE interface. SYNTAX: pppoe ifdetach intf = intf The name of the PPPoE interface. REQUIRED EXAMPLE: =>pppoe iflist PPPoE1: dest : PPPoE1 Retry: 10 QoS default encaps VC-MUX mode = IP Routing flags = echo magic accomp restart mru addr route savepwd PPPoEOA trans addr = pat mru = 1492 route = 0.0.0.0/0 - 0.0.0.
PPPoE Commands pppoe iflist Show current configuration of all or a specified PPPoE interface(s). SYNTAX: pppoe iflist [intf = ] intf The name of the PPPoE interface. If this parameter is not specified, all PPPoE interfaces are shown. EXAMPLE INPUT/OUTPUT: =>pppoe iflist PPPoE1: dest : PPPoE1 Retry: 10 QoS default encaps VC-MUX mode = IP Routing flags = echo magic accomp restart mru addr route savepwd PPPoEOA trans addr = pat mru = 1500 route = 0.0.0.0/0 - 0.0.0.
PPPoE Commands pppoe ifscan Scan a PPPoE interface (proto=pppoe) for available Access Concentrator names and Service Names. Note Execute the pppoe ifdetach command for this interface before performing a scan on it. SYNTAX: pppoe ifscan intf = [time = ] intf The name of the Routed PPPoE interface to scan. REQUIRED time A number between 0 and 36000 (seconds). Represents the time to scan for services.
PPPoE Commands pppoe relay add Add an ethernet port to the PPPoE relay list. SYNTAX: pppoe relay add port port = The ethernet port to be added to the PPPoE relay agent list. REQUIRED RELATED COMMANDS: pppoe relay delete Delete an ethernet port from the PPPoE relay agent list. pppoe relay flush Remove all ethernet ports from the PPPoE relay agent list and terminate all sessions. pppoe relay portlist List all ethernet ports added to the PPPoE relay agent list.
PPPoE Commands pppoe relay delete Delete an ethernet port from the PPPoE relay agent list. SYNTAX: pppoe relay delete port port = The ethernet port to be deleted from the PPPoE relay agent list. REQUIRED RELATED COMMANDS: pppoe relay add Add an ethernet port to the PPPoE relay list. pppoe relay flush Remove all ethernet ports from the PPPoE relay agent list and terminate all sessions. pppoe relay portlist List all ethernet ports added to the PPPoE relay agent list.
PPPoE Commands pppoe relay flush Remove all ethernet ports from the PPPoE relay agent list and terminate all sessions. SYNTAX: pppoe relay flush RELATED COMMANDS: pppoe relay add Add an ethernet port to the PPPoE relay list. pppoe relay delete Delete an ethernet port from the PPPoE relay agent list. pppoe relay portlist List all ethernet ports added to the PPPoE relay agent list. pppoe relay sesslist List all active PPPoE relay sessions.
PPPoE Commands pppoe relay portlist List all ethernet ports added to the PPPoE relay agent list. SYNTAX: pppoe relay portlist EXAMPLE: =>pppoe relay portlist # Port HWaddr 1 ETHoA_1 00-90-d0-72-88-64 => Status UP RELATED COMMANDS: pppoe relay add Add an ethernet port to the PPPoE relay list. pppoe relay delete Delete an ethernet port from the PPPoE relay agent list. pppoe relay flush Remove all ethernet ports from the PPPoE relay agent list and terminate all sessions.
PPPoE Commands pppoe relay sesslist List all active PPPoE relay sessions. SYNTAX: pppoe relay sesslist RELATED COMMANDS: pppoe relay add Add an ethernet port to the PPPoE relay list. pppoe relay delete Delete an ethernet port from the PPPoE relay agent list. pppoe relay flush Remove all ethernet ports from the PPPoE relay agent list and terminate all sessions. pppoe relay portlist List all ethernet ports added to the PPPoE relay agent list.
PPPoE Commands pppoe rtadd Automatically add a route configuration to the routing table in case the specified PPPoE interface link comes up. This route configuration will determine which local hosts are allowed to use this link and/or which remote destinations should be or should not be reachable. Note Execute the pppoe ifdetach command for this interface prior to configuring routes.
PPPoE Commands srcmsk metric The source IP mask. Depending on the source netmask: • Everybody is allowed to use this PPPoE connection (dstmsk=0) • Only members of the same subnet as the host which opened the PPPoE connection are allowed to use the PPPoE connection (dstmsk=1) • The actual destination mask will be the netmask applicable for the IP address of the host which opened the PPPoE connection. • Only the host which opened the PPPoE connection is allowed to use the PPPoE connection.
PPPoE Commands pppoe rtdelete Delete the route specification for a PPPoE link. Note Execute the pppoe ifdetach command for this interface prior to deleting route configurations. SYNTAX: pppoe rtdelete intf = intf The PPPoE interface name for which to delete the route settings. REQUIRED EXAMPLE: =>pppoe iflist PPPoE1: dest : PVC3 Retry: 10 QoS default encaps LLC mode = IP Routing flags = echo magic accomp restart mru addr route trans addr = pat mru = 1492 route = 10.0.0.2/24 - 172.16.0.
PPPoE Commands 328
PPTP Commands PPTP Commands Contents This chapter covers the following commands: Topic Page pptp ifadd 330 pptp flush 331 pptp list 332 pptp profadd 333 pptp profdelete 334 pptp proflist 335 329
PPTP Commands pptp ifadd Adds a Point-to-Point Tunneling Protocol (PPTP) profile (backwards compatible with previous release, use profiles instead). SYNTAX: pptp ifadd dest = [rate = ] [encaps = <{vcmux|nlpid}>] [ac = <{never|always|keep}>] dest The WAN destination for this PPTP tunnel. Typically a phonebook entry. REQUIRED rate A number between 10 and 10000. Represents the transmit speed in bits/s for the WAN link. OPTIONAL encaps The type of WAN encapsulation.
PPTP Commands pptp flush Flush complete PPTP configuration. Note The flush command does not impact previously saved configurations.
PPTP Commands pptp list Show current PPTP configuration. SYNTAX: pptp list EXAMPLE INPUT/OUTPUT: =>pptp list Dialstr Destination DIALUP_PPP3 => 332 QoS default Encaps vcmux AC never State CONNECTED User (10.0.0.
PPTP Commands pptp profadd Define a new PPTP profile. SYNTAX: pptp profadd name = [qos = ] [encaps = <{vcmux|nlpid}>] [ac = <{never|always|keep}>] name The name for the PPTP profile. REQUIRED qos The name of the qosbook entry, containing the settings for this profile. This parameter never needs to be specified. OPTIONAL encaps The type of WAN encapsulation applicable to PPTP interfaces using this PPTP profile.
PPTP Commands pptp profdelete Delete a PPTP profile. SYNTAX: pptp profdelete name name The name for the PPTP profile. EXAMPLE: =>pptp proflist Profile QoS Encaps Relay_PPP1 default nlpid PPTPLink default vcmux =>pptp profdelete name=PPTPLink =>pptp proflist Profile QoS Encaps Relay_PPP1 default nlpid => AC always never AC always RELATED COMMANDS: pptp profadd Define a new PPTP profile. pptp proflist Show current PPTP profiles.
PPTP Commands pptp proflist Show all current PPTP profiles. SYNTAX: pptp proflist EXAMPLE: =>pptp proflist Profile QoS Relay_PPP1 default PPTPLink default => Encaps nlpid vcmux AC always never RELATED COMMANDS: pptp profadd Define a new PPTP profile. pptp profdelete Delete a PPTP profile.
PPTP Commands 336
QoSBook Commands QoSBook Commands Contents This chapter covers the following commands: Topic Page qosbook add 338 qosbook config 340 qosbook delete 341 qosbook flush 342 qosbook list 343 337
QoSBook Commands qosbook add Add a Quality of Service (QoS) book entry. SYNTAX: qosbook add name = class = <{ubr|cbr|vbr-rt|vbr-nrt}> [tx_peakrate = ] [tx_sustrate = ] [tx_maxburst = ] [rx_peakrate = ] [rx_sustrate = ] [rx_maxburst = ] [framediscard = <{enabled|disabled}>] name The name for the new QoS entry. REQUIRED class The ATM service category.
QoSBook Commands EXAMPLE: =>qosbook list Name Ref Type TX peak sust burst RX peak sust burst framediscard (Kbits) (Kbits) (bytes) (Kbits) (Kbits) (bytes) default 3 ubr linerate 0 0 linerate 0 0 disabled =>qosbook add name=TestVBR class=vbr-nrt tx_peakrate=1500 tx_sustrate=1000 tx_maxburst=100 rx_sustrate=1000 rx_maxburst=100 framediscard=enabled =>qosbook list Name Ref Type TX peak sust burst RX peak sust burst framediscard (Kbits) (Kbits) (bytes) (Kbits) (Kbits) (bytes) default 3 ubr linerate 0 0 linerat
QoSBook Commands qosbook config Sets or changes qosbook config parameters. SYNTAX: qosbook config [format = <{bytes|cells}>] format The input, output format of the qosbook.
QoSBook Commands qosbook delete Remove a Quality of Service book entry. SYNTAX: qosbook delete name = [force = <{no|yes}>] name The name of the QoS book entry to delete. REQUIRED force Force deletion of the entry even if it is still in use (yes) or do not force the deletion (no). By default forced deletion is disabled.
QoSBook Commands qosbook flush Flush complete Quality of Service book. Note The flush command does not impact previously saved configurations.
QoSBook Commands qosbook list Show current Quality of Service book. SYNTAX: qosbook list EXAMPLE: =>qosbook list Name Ref Type default 3 TestVBR 0 => TX peak (Kbits) ubr linerate vbr-nrt 1500 sust (Kbits) 0 1000 burst (bytes) 0 144 RX peak (Kbits) linerate 1500 sust (Kbits) 0 1000 burst (bytes) 0 144 framediscard disabled enabled RELATED COMMANDS: qosbook add Add a QoS book entry. qosbook delete Remove a QoS book entry.
QoSBook Commands 344
Script Commands Script Commands WARNING Scripting is not a general purpose mechanism but is only used in the autoPVC/ILMI mechanism. Do not use any commands of the Script CLI command group.
Script Commands 346
SNMP Commands SNMP Commands Contents This chapter covers the following commands: Topic Page snmp config 348 snmp get 349 snmp getNext 350 snmp list 351 snmp walk 352 347
SNMP Commands snmp config Show/set global Simple Network Management Protocol (SNMP) parameters. SYNTAX: snmp config [RWCommunity = ] [ROCommunity = ] [sysContact = ] [sysName = ] [sysLocation = ] RWCommunity The read-write community name. By default the read-write community name is private. OPTIONAL ROCommunity The read-only community name. By default the read-only community name is public. OPTIONAL sysContact The SNMP system contact.
SNMP Commands snmp get Get from the supplied SNMP Object IDentifier (OID), e.g. get ObjectId=.1.3.6.1.2.1.1.1.0. SYNTAX: snmp get [ObjectId = ] ObjectID The Object Identifier. Object id to get from ... must include the instance which is 0 for scalar objects e.g. .1.3.6.1.2.1.1.1.0 sysDescription If not specified, the sysdescription OID .1.3.6.1.2.1.1.1.0 is assumed. Its value is SpeedTouch™. OPTIONAL EXAMPLE: =>snmp get VB_octetStr => .1.3.6.1.2.1.1.1.
SNMP Commands snmp getNext GetNext from the supplied SNMP OID. SYNTAX: snmp get [ObjectId = ] [ObjectID] The Object Identifier. Object id to getNext from e.g. .1.3.6.1.2.1.1 system returns sysDescription EXAMPLE: =>snmp getNext ObjectId=.1.3.6.1.2.1.1.4.0 VB_octetStr .1.3.6.1.2.1.1.5.0 => Sascha RELATED COMMANDS: snmp get Get from the supplied SNMP OID. snmp walk Walk from the supplied SNMP OID.
SNMP Commands snmp list List all SNMP global parameters.
SNMP Commands snmp walk Walk from the supplied SNMP Object IDentifier (OID). SYNTAX: snmp get [ObjectId = ] ObjectID The Object Identifier. Object id to walk from e.g. .1.3.6.1.2.1.1 system walks the system group EXAMPLE: =>snmp walk ObjectId=.1.3.6.1.2.1.1 VB_octetStr .1.3.6.1.2.1.1.1.0 VB_objId .1.3.6.1.2.1.1.2.0 VB_timeTicks .1.3.6.1.2.1.1.3.0 VB_octetStr .1.3.6.1.2.1.1.4.0 VB_octetStr .1.3.6.1.2.1.1.5.0 VB_octetStr .1.3.6.1.2.1.1.6.0 VB_integer .1.3.6.1.2.1.1.7.0 => SpeedTouch™ 610 .1.3.6.
Software Commands Software Commands Contents This chapter covers the following commands: Topic Page software version 354 software upgrade 355 353
Software Commands software version Show the software version. SYNTAX: software version EXAMPLE: =>software version Flash image : 4.2.1.15.0 Build name : LLT5AA4.
Software Commands software upgrade Reboots the modem to initiate the SW upgrade. New software available on a remote LAN host will be uploaded to the modem.
Software Commands 356
Switch Commands Switch Commands Introduction These commands are only applicable to the SpeedTouch™510 four port switch version.
Switch Commands switch group flush To set all ports to the default settings, i.e. all ports in group 0. SYNTAX: switch group flush EXAMPLE: =>switch group Group 0 Ports: Group 1 Ports: Group 2 Ports: =>switch group =>switch group Group 0 Ports: => list 4 1 2 3 flush list 1 2 3 4 RELATED COMMANDS: switch group list List all configured groups. switch group move Move a specified port to a specified group.
Switch Commands switch group list List all configured groups. SYNTAX: switch group list EXAMPLE: =>switch group Group 0 Ports: Group 1 Ports: Group 2 Ports: list 4 1 2 3 RELATED COMMANDS: switch group flush To set all ports to the default settings (all ports in group 0). switch group move Move a specified port to a specified group.
Switch Commands switch group move Move a specified port to a specified group. SYNTAX: switch group move group = port = group The group id. REQUIRED port The port. REQUIRED EXAMPLE: =>switch group Group 0 Ports: =>switch group =>switch group Group 0 Ports: Group 3 Ports: list 1 2 3 4 move group=3 port=1 list 2 3 4 1 RELATED COMMANDS: switch group flush To set all ports to the default settings (all ports in group 0). switch group list List all configured groups.
Switch Commands switch mirror capture Define the specified port to be the Mirror Capture Port. Note Only one port can be the Mirror Capture Port at any one time. SYNTAX: switch mirror capture port port = The port to be the Mirror Capture Port. REQUIRED EXAMPLE: =>switch mirror capture port=2 =>switch mirror capture Mirror capture port = 2 RELATED COMMANDS: switch mirror egress Enable or disable the specified port to be a Transmitted Port Mirroring.
Switch Commands switch mirror egress Enable or disable the specified port to be the Mirror Egress Port. Note Only one port can be the Mirror Egress Port at any one time. But a port can be the Mirror Egress Port and the Mirror Ingress Port at the same time. SYNTAX: switch mirror egress port = [state = <{enabled|disabled}>] port The port to be the Mirror Egress Port. REQUIRED state This parameter permits to enable/disable a port as Mirror Egress Port.
Switch Commands switch mirror ingress Enable or disable the specified port to be the Mirror Ingress Port. Note Only one port can be the Mirror Ingress Port at any one time. But a port can be the Mirror Egress Port and the Mirror Ingress Port at the same time. SYNTAX: switch mirror egress port = [state = <{enabled|disabled}>] port The port to be the Mirror Ingress Port. REQUIRED state This parameter permits to enable/disable a port as Mirror Ingress Port.
Switch Commands 364
System Commands System Commands Contents This chapter covers the following commands: Topic Page system clearpassword 366 system config 367 system flush 368 system reboot 369 system reset 370 system setpassword 371 system stats 372 365
System Commands system clearpassword Clear current SpeedTouch™ system password. Note To avoid unrestricted and unauthorized access to the SpeedTouch™, it is highly recommended to make sure it is protected by a SpeedTouch™ system password (via :system setpassword) and to change the password on a regular basis. SYNTAX: system clearpassword EXAMPLE: =>system clearpassword Security notification: Password changed, use 'saveall' to make it permanent.
System Commands system config Show/set SpeedTouch™ system configuration parameters. Note For a good operation of Universal Plug and Play (UPnP) and the discovery mechanism, it is highly recommended not to change the System config settings.
System Commands system flush Flush current SpeedTouch™ system configuration, i.e. the System password and the system config settings (dcache excluded). Note To avoid unrestricted and unauthorized access to the SpeedTouch™, it is highly recommended to make sure it is protected by a SpeedTouch™ system password (via :system setpassword) and to change the password on a regular basis. Note The flush command does not impact previously saved configurations.
System Commands system reboot Reboot the SpeedTouch™. Non-saved configuration settings are lost after reboot. SYNTAX: system reboot EXAMPLE: =>system reboot ..... (lost session connectivity due to reboot) .....
System Commands system reset Reset the SpeedTouch™ to its factory default settings and reboot the device. All user and Service Provider specific settings and all saved configuration changes are lost after reboot. SYNTAX: system reset factory yes/no = <{yes|no}> proceed no/yes = <{no|yes}> factory yes/no Proceed with resetting the SpeedTouch™ device to its factory default settings (yes) or not (no). By default the system reboot command is discarded if no explicit positive confirmation is given.
System Commands system setpassword Set/change the current SpeedTouch™ system password. Note To avoid unrestricted and unauthorized access to the SpeedTouch™, it is highly recommended to make sure it is protected by a SpeedTouch™ system password (via :system setpassword) and to change the password on a regular basis SYNTAX: system setpassword [userid = ] password = userid The new access userid. OPTIONAL password The new access password.
System Commands system stats Show/set the SpeedTouch™ cpu and memory statistics. SYNTAX: system stats [reset = <{no|yes}>] reset Reset cpu statistics.
Systemlog Commands Systemlog Commands Contents This chapter covers the following commands: Topic Page systemlog show 374 systemlog send 375 373
Systemlog Commands systemlog show Show syslog messages in the internal SpeedTouch™ Syslog message buffer. SYNTAX: systemlog show [fac = ] [sev = ] [hist = <{no|yes}>] fac Optionally, Specify the facility name of the syslog messages to show. Use one of the supported facility names (See “ Supported Syslog Facilities” on page 418 for a listing of syslog facility names supported by the SpeedTouch™). Do not specify to show messages of any facility.
Systemlog Commands systemlog send Send syslog messages from the internal SpeedTouch™ Syslog message buffer to a specified local or remote syslog server host. SYNTAX: systemlog send [fac = ] [sev = ] [hist = <{no|yes}>] dest = fac Optionally, Specify the facility name of the syslog messages to show.
Systemlog Commands 376
TD Commands TD Commands Contents This chapter covers the following commands: Topic td call Page 378 377
TD Commands td call Call a ‘Trace & Debug‘ command. Note For qualified personnel only. SYNTAX: td call cmd = cmd Quoted 'Trace & Debug' command string.
UPnP Commands UPnP Commands Contents This chapter covers the following commands: Topic Page upnp config 380 upnp flush 381 upnp list 382 379
UPnP Commands upnp config Configure UPnP parameter(s). SYNTAX: upnp config [maxage = ] [defcservice = ] [writemode = <{full|natonly|readonly}>] [safenat = <{disabled|enabled}>] [preferredaddress = ] maxage This parameter allows to configure how often the SpeedTouch™ sends a notification message to advertise its presence as an Internet Gateway Device IGD) on the network.
UPnP Commands upnp flush Flushes the UPnP configuration (i.e. reset to default configuration).
UPnP Commands upnp list This command lists the devices and services currently offered by the SpeedTouch™. Use this command to check whether a PPP connection is properly configured and thus advertised as a PPP service. SYNTAX: upnp list [verbose = ] verbose Verbose level. Default is 1. EXAMPLE: =>upnp list Advertising UPnP devices on address: 10.0.0.138 ---------------- device: IGD.
USB Commands USB Commands Introduction These commands are valid only for the SpeedTouch™530.
USB Commands usb add Adds a VP or VC cross-connection between the USB interface and the WAN interface. SYNTAX: usb add wanvpi wanvci usbvpi usbvci [qos = = = = = <{default}>] wanvpi A number between 0 and 15. Represents the Virtual Path Identifier (VPI) of WAN interface. REQUIRED wanvci A number between 0 and 511. Represents the Virtual Channel Identifier (VCI) of WAN interface. REQUIRED usbvpi A number between 0 and 15.
USB Commands usb config Enable/disable the USB interface. SYNTAX: usb config [state = <{enabled|disabled}>] state Enable or disable the USB interface.
USB Commands usb delete Deletes a cross-connection on the USB interface. SYNTAX: usb delete wanvpi = [wanvci = ] wanvpi A number between 0 and 15. Represents the Virtual Path Identifier (VPI) of WAN interface. REQUIRED wanvci A number between 0 and 511. Represents the Virtual Channel Identifier (VCI) of WAN interface.
USB Commands usb info Show USB properties/statistics SYNTAX: usb info EXAMPLE: =>usb info MACaddr = 00-90-d0-02-8a-a3 Type = Device Rate = FullSpeed Power = SelfPowered Properties DataTransferType = Bulk DataAlternateSetting = 1 MajorRelease = 1 MinorRelease = 10 NumberOfConfigurations = 1 DeviceClass = Vendor Specific DeviceSubclass = 0 Protocol = 0 Ep0MaxPacketSize = 64 Bytes Statistics : ReservedBandwidth = Not Applicable Bytes tx = 406245 Bytes rx = 238341 Blocks tx = 6697 Blocks rx = 4256 => 387
USB Commands usb list Shows all cross-connections on the USB interface.
Wireless Commands Wireless Commands Introduction The commands covered in this chapter can only be used with the SpeedTouch™570. Contents This chapter covers the following commands:I Topic Page wireless aclconfig 390 wireless aclentry 391 wireless aclflush 392 wireless acllist 393 wireless counters 394 wireless flush 395 wireless ifconfig 396 wireless scan 397 wireless status 398 wireless wepconfig 399 E-SIT-CTC-20030410-0050 Ed.
Wireless Commands wireless aclconfig Configures the Access Control List (ACL) mode. SYNTAX: wireless aclconfig control [control = <{register|lock|unlock}>] OPTIONAL Select the Access Control List mode. Choose between: • register button mode • lock/unlock mode Default setting is Register Button mode. DESCRIPTION: Register A wireless client is only added to the ACL after using the Register Button. Lock The ACL is locked. No new entries are allowed in the ACL.
Wireless Commands wireless aclentry Adds or deletes an entry in the ACL. SYNTAX: wireless aclentry hwaddr = action = <{allow|deny|delete}> [name = ] hwaddr The Ethernet MAC address of the ACL entry REQUIRED action The action to be performed on ACL entry.
Wireless Commands wireless aclflush Flushes the ACL. SYNTAX: wireless aclflush EXAMPLE: =>wireless acllist Station Name MAC address Allowed Test 00:90:D0:01:47:DE : yes Test2 01:67:D0:23:56:CD : yes =>wireless aclflush =>wireless acllist The access control list is empty. => RELATED COMMANDS: wireless aclentry Adds or deletes an entry in the ACL. wireless acllist Lists the ACL. 392 E-SIT-CTC-20030410-0050 Ed.
Wireless Commands wireless acllist Lists the ACL. SYNTAX: wireless acllist EXAMPLE: =>wireless acllist Station Name MAC address Allowed Test 00:02:2d:42:E5:2D : yes Test2 01:67:D0:23:56:CD : yes => RELATED COMMANDS: wireless aclentry Adds or deletes an entry in the ACL. wireless aclflush Flushes the ACL. E-SIT-CTC-20030410-0050 Ed.
Wireless Commands wireless counters Displays the value of the SpeedTouch™570 WLAN counters.
Wireless Commands wireless flush Flush the SpeedTouch™570 WLAN parameters, i.e. reset to the factory defaults.
Wireless Commands wireless ifconfig Configures and shows the SpeedTouch™570 Wireless LAN (WLAN) interface parameters. SYNTAX: wireless ifconfig [ssid = ] [any = <{off|on}>] [channel = <{auto|1|2|3|4|5|6|7|8|9|10|11}>] [rts = ] ssid The Service Set Identifier (SSID) OPTIONAL any Accept stations with SSID ‘any’ or blank SSID. Default is no. OPTIONAL channel The communication channel number.
Wireless Commands wireless scan Scans for other APs in the area. An overview of all the radio channels and their respective ratings is shown. SYNTAX: wireless scan EXAMPLE: =>wireless scan Channel rating 1 : Good 2 : Good 3 : Good 4 : Good 5 : Good 6 : Recommended 7 : Good 8 : Good 9 : Good 10 : Good 11 : Good Recommended channel : 6 => RELATED COMMANDS: wireless ifconfig Configures and shows the wireless interface parameters. wireless status Shows the status of the wireless interface.
Wireless Commands wireless status Shows the status of the SpeedTouch™570 WLAN interface. SYNTAX: wireless status EXAMPLE: =>wireless status Wireless interface is running on channel 3 in clear-text =>wireless ifconfig channel=auto =>wireless status Wireless interface is running on channel 6 in clear-text RELATED COMMANDS: wireless ifconfig Configures and shows the wireless interface parameters. wireless scan Scans for other APs in the area. 398 E-SIT-CTC-20030410-0050 Ed.
Wireless Commands wireless wepconfig Configures Wired Equivalent Privacy (WEP) secure access. SYNTAX: wireless wepconfig key [key = ] [encryption = <{off|on}>] The WEP key. In case of 64 bit encryption, the 40-bits WEPkey must consist of 10 hexadecimal digits. OPTIONAL In case of 128 bit encryption, the 104-bits WEPkey must consist of 26 hexadecimal digits.
Wireless Commands 400 E-SIT-CTC-20030410-0050 Ed.
Abbreviations Abbreviations The table below lists all the abbreviations used in the CLI Guide.
Abbreviations Abbreviation Description IGD Internet Gateway Device IGMP Internet Group Management Protocol IKE Internet Key Exchange IMAP Interim Mail Access Protocol IMAP Interactive Mail Access Protocol IP Internet Protocol IPCP Internet Protocol Control Protocol IPCP IP Payload Compression Protocol IP oA IP over ATM IPSec IP Security IRC Internet Relay Chat ISDN Integrated Services Digital Network LAN Local Area Network LCP Link Control Protocol LDAP Light-weight Directory
Abbreviations Abbreviation Description PIP Packet Interception Point PKCS Public Key Cryptography Standard PKI Public Key Infrastructure POP Post Office Protocol POTS Plain Old Telephone Service PPP Point-to-Point Protocol PPPoA PPP over ATM PPPoE PPP over Ethernet PPTP Point-to-Point Tunneling Protocol PSD Power Spectral Density PVC Permanent Virtual Channel QoS Quality of Service RIP Routing Information Protocol RTMP RouTing Maintenance Protocol RTSP Real Time Stream Contro
Abbreviations Abbreviation Description URL Uniform Resource Locator VC Virtual Channel VCMUX Virtual Channel MUltipleXing VDSL Very high speed Digital Subscriber Line VLSM Variable Length Subnet Masking VP Virtual Path VPN Virtual Private Networking WAN Wide Area Network WCD WAN Connection Device WEP Wired Equivalent Privacy WINS Windows Internet Naming Service WLAN Wireless LAN WWW World Wide Web ZIS Zone Information System 404
Syslog Messages Syslog Messages Introduction This chapter lists the different Syslog messages.
Syslog Messages Auto-PVC Module Facility Severity Contents LOCAL5 WARNING AUTOPVC script failed LOCAL5 WARNING AUTOPVC script failed LOCAL5 WARNING AUTOPVC script (name1, qosb_name) failed LOCAL5 WARNING AUTOPVC script (name1, qosb_name, name2) failed LOCAL5 WARNING AUTOPVC script 'autopvc_change_qos (itable[i].
Syslog Messages DHCP CLient Module Facility Severity Contents LOCAL2 WARNING DHCP lease ip-address bound to intf LOCAL2 WARNING DHCP intf renews lease ip-address LOCAL2 WARNING DHCP intf rebinds lease ip-address from server () LOCAL2 WARNING DHCP offer received from (can be relay agent) for intf LOCAL2 WARNING DHCP server () offers to intf LOCAL2 WARN
Syslog Messages DHCP Server Module Facility Severity Contents LOCAL2 WARNING DHCP server: DHCPOFFER || DHCPACK cannot be send due to invalid server identifier LOCAL2 WARNING DHCP server: DHCPACK cannot be send due to invalid server identifier LOCAL2 WARNING DHCP server: DHCPNAK cannot be send due to invalid server identifier LOCAL2 WARNING DHCP Auto DHCP: server detected on LAN, own dhcp server disabled LOCAL2 WARNING DHCP Auto DHCP: no server detected on LAN, SpeedTouch server started LO
Syslog Messages Kernel Module Facility Severity Contents KERN WARNING KERNEL cold reset KERN WARNING KERNEL warm reset KERN EMERG KERNEL Controlled restart (after internal error or explicit system reboot) Linestate Module Facility Severity Contents LOCAL5 NOTICE xDSL linestate up (downstream: kbit/s, upstream: kbit/s) LOCAL5 NOTICE xDSL linestate down Login Module Facility Severity Contents AUTH NOTICE LOGIN User logged on telnet (
Syslog Messages PPP Module Facility Severity Contents LOCAL0 WARNING PPP Link up () LOCAL0 WARNING PPP Link down () AUTH ERROR PPP PAP authentication failed () [protocol reject] AUTH INFO PPP PAP on intf no response to PAP authenticate-request AUTH NOTICE PPP PAP remote user succesfull authenticated AUTH ERROR PPP PAP authentication for remote user failed AUTH DEBUG PPP PAP Authenticate Ack received AUTH DE
Syslog Messages Software Module Facility Severity Contents KERN INFO SOFTWARE Copying all data files from to KERN INFO SOFTWARE Switchover going down in seconds KERN INFO SOFTWARE No passive software found, duplicating active software KERN INFO SOFTWARE Duplication of active software failed UPnP Module Facility Severity Contents WARNING SECURITY UPnP refused for ip= NOTICE SECURITY UPnP () for
Syslog Messages 412
Supported Key Names Supported Key Names Contents This chapter lists all the key names supported by the SpeedTouch™, that can be used for completing CLI command parameters. Supported Internet Protocol (IP) Protocol Names For more information on the listed IP protocols, see RFC1340 or www.iana.org.
Supported Key Names Supported TCP/UDP Port Names For more information on the listed TCP/UDP port assignments, see RFC1340 or www.iana.org.
Supported Key Names Port name Number TCP UDP Description nntp 119 Y Y Network News Transfer Protocol (NNTP) sntp 123 Y Y Simple Network Time Protocol (SNTP) ntp 123 Y Y Network Time Protocol (NTP) ingres-net 134 Y Y INGRES-NET Service netbios-ns 137 Y Y NETBIOS Naming System netbios-dgm 138 Y Y NETBIOS Datagram Service netbios-ssn 139 Y Y NETBIOS Session Service imap2 143 Y Y Interim Mail Access Protocol (IMAP) v2 sql-net 150 Y Y SQL-NET pcmail-srv 158 Y
Supported Key Names Port name Number TCP UDP Description syslog 514 - Y Syslog printer 515 Y Y Spooler talk 517 Y Y Like Tenex link, but across machine ntalk 518 Y Y NTalk utime 519 Y Y UNIX Time rip 520 - Y Local routing process (on site); uses variant of Xerox NS Routing Information Protocol (RIP) timed 525 Y Y Timeserver netwall 533 Y Y For emergency broadcasts uucp 540 Y Y uucpd uucp-rlogin 540 Y Y uucpd remote login new-rwho 540 Y Y uucpd remo
Supported Key Names Supported ICMP Type Names For more information on the listed ICMP type names, see RFC1340 or www.iana.org.
Supported Key Names Supported Syslog Facilities For more information on the listed Syslog facilities, see RFC3164.
Supported Key Names Supported Syslog Severities For more information on the listed Syslog severities, see RFC3164.
Supported Key Names 420
© 2003 THOMSON. All rights reserved. E-SIT-CTC-20030410-0050 v1.0 www.speedtouch.