THOMSON SPEEDTOUCH 510I - REFERENCE GUIDE RELEASE 4.0 Reference Manual

500 series multi-user adsl gateways
Hide thumbs Also See for SPEEDTOUCH 510I - REFERENCE GUIDE RELEASE 4.0:
Table of Contents

Advertisement

SpeedTouch
510(i)/530/570(i)
Multi-User ADSL Gateways
CLI Reference Guide
500
SERIES
TM

Advertisement

Table of Contents
loading

Summary of Contents for THOMSON SPEEDTOUCH 510I - REFERENCE GUIDE RELEASE 4.0

  • Page 1 SpeedTouch 510(i)/530/570(i) Multi-User ADSL Gateways CLI Reference Guide SERIES...
  • Page 3 SpeedTouch 500Series CLI Reference Guide Release R4.0...
  • Page 4 CLI ST500Series R4.0 Copyright © 2003 THOMSON. All rights reserved. Passing on, and copying of this document, use and communication of its contents is not permitted without written authorization from THOMSON. The content of this document is furnished for informational use only, may be subject to change without notice, and should not be construed as a commitment by THOMSON.
  • Page 5: Table Of Contents

    About this Document ..............................9 Accessing the Command Line Interface ........................11 Basic Navigation and Manipulation..........................12 Command Line Interface Top Level Structure ......................17 Command Line Interface Commands ........................18 Menu-driven CLI Navigation ............................19 Configuration Profile Files and the CLI........................20 Direct FTP Access ................................
  • Page 6 CIP Commands ....................51 cip flush....................................52 cip ifadd ..................................... 53 cip ifdelete..................................54 cip iflist....................................55 cip pvcadd ..................................57 cip pvcdelete ..................................58 cip pvclist................................... 59 Config Commands ..................61 config erase..................................62 config flush ..................................63 config load..................................64 config save..................................
  • Page 7 91 dhcp server lease delete..............................93 dhcp server lease flush..............................94 dhcp server lease list..............................95 dhcp server pool add ..............................96 dhcp server pool config ..............................98 dhcp server pool delete...............................100 dhcp server pool flush ..............................101 dhcp server pool list..............................102...
  • Page 8 DNS Commands ..................103 dns add ....................................104 dns clear ..................................105 dns clrstats..................................106 dns delete..................................107 dns domain ..................................108 dns flush...................................109 dns fwdadd..................................110 dns fwddelete.................................111 dns fwdlist ..................................112 dns fwdtable ...................................113 dns list....................................114 dns nslookup ..................................115 dns start...................................116 dns stats...................................117 dns status ..................................118 dns stop ...................................119...
  • Page 9 ................................146 firewall rule clear................................147 firewall rule create................................148 firewall rule delete ................................152 firewall rule flush ................................153 firewall rule list ................................154 firewall rule stats ................................155 IP Commands ....................
  • Page 10 ..................................178 ipoa ifadd..................................179 ipoa ifattach ..................................180 ipoa ifconfig..................................181 ipoa ifdelete ..................................183 ipoa ifdetach ...................................184 ipoa iflist ..................................185 MER Commands ..................187 mer flush ..................................188 mer ifadd ..................................189 mer ifattach..................................190 mer ifconfig..................................191 mer ifdelete ..................................193 mer ifdetach..................................194 mer iflist ..................................195 NAT Commands ..................
  • Page 11 PPP Commands ................... 219 ppp flush ..................................220 ppp ifadd..................................221 ppp ifattach ..................................223 ppp ifconfig..................................225 ppp ifdelete ..................................230 ppp ifdetach ..................................232 ppp iflist ...................................233 ppp ifscan ..................................234 ppp rtadd..................................235 ppp rtdelete..................................237 PPTP Commands..................239 pptp flush..................................240 pptp list....................................241 pptp profadd...................................242 pptp profdelete................................243 pptp proflist ..................................244...
  • Page 12 ................................279 wireless status................................281 wireless counters ................................282 wireless scan ..................................283 wireless flush ..................................284 Abbreviations ....................285 Supported Key Names ................289 Supported Internet Protocol (IP) Protocol Names ....................289 Supported TCP/UDP Port Names..........................290 Supported ICMP Type Names ...........................293 E-SIT-CTC-20021203-0003 v1.0...
  • Page 13: About This Document

    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).
  • Page 14 (including, without limitation, benchmarks) from any source • relating to the equipment. Such acts not expressly approved by THOMSON will result in the loss of product warranty and will invalidate the • user's authority to operate this equipment.
  • Page 15: 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.
  • Page 16: Basic Navigation And Manipulation

    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.
  • Page 17 => You can execute the help or ? command from each command group selection. This results in a list of the available commands (and nested command groups, if available) in this particular command group. EXAMPLE: =>firewall [firewall]=>...
  • Page 18 : Assign a chain to an entry point. list : Shows a list of all the hooks with the chain attached. flush : Clears all hooks. If a hook is provided, that hook is cleared. Following command groups are available : chain rule =>...
  • Page 19 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.
  • Page 20 Breaking off Commands Press CTRL+G to break off a command. This can be useful in a situation where a user is prompted to enter a value which he does not know and wants to quit the command. Instead of being prompted over and over again for the same value, this allows to quit the command and return to the command line prompt.
  • Page 21: Command Line Interface Top Level Structure

    510, SpeedTouch 570 ADSL/POTS, and the SpeedTouch 510i and • SpeedTouch 570i ADSL/ISDN variants) eth (only applicable for models equipped with a single 10/100Base-T Ethernet port) • upnp (only applicable for the SpeedTouch 510 and SpeedTouch 530 variants) • wireless (only applicable for the SpeedTouch 570 variants) •...
  • Page 22: Command Line Interface Commands

    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).
  • Page 23: Menu-Driven Cli Navigation

    To setup a CLI command, simply press ENTER on its name. You can configure and overview its various parameters at one time. In case the parameter provides preset values, you can go through these via the ARROW keys. If you are satis- fied, use the TAB key to go to the OK field and press ENTER.
  • Page 24: Configuration Profile Files And The Cli

    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 para- graphs. These paragraphs reflect a CLI command group selection in the SpeedTouch 500Series CLI.
  • Page 25 To make sure that a variable always will result in a valid variable TAG, the [env.ini] paragraph also allows to declare a preset value for the variable. In case the variable TAG is used in a CLI command, the value of the variable should always be in conformity with the syntax of the CLI command.
  • Page 26: Direct Ftp Access

    The 'dl' directory contains dormant software image. In case you have made changes to the SpeedTouch 500Series configuration and saved them, be it via a Telnet session, via the web pages or via the Setup wizard, a user.ini configura- tion profile file is created in the 'dl' subdirectory.
  • Page 27 FTP (m)put of (multiple) 'dl' subdirectory files FTP (m)delete of (multiple) 'dl' subdirectory files. FTP File Transfer To allow correct file transfers, set the transfer mode to “binary”. Turn on the hashing option to see the progression of the file transfer. Note EXAMPLE: /home/doejohn{1}$ftp 10.0.0.138 Connected to 10.0.0.138...
  • Page 28 E-SIT-CTC-20021203-0003 v1.0...
  • Page 29: Adsl Commands

    ADSL Commands ADSL Commands Contents This chapter covers the following commands: Topic Page adsl config adsl info E-SIT-CTC-20021203-0003 v1.0...
  • Page 30: Adsl Config

    Represents the maximum number of bits which can be allocated to each ADSL DMT tone in the upstream direction. By default the modem will use up to 13 bits per tone. SYNTAX FOR ADSL/Integrated Services Digital Network (ISDN) variants: adsl config [opermode = <{etsi|g.dmt_annex_b|multimode}>]...
  • Page 31: 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 pe variant: SYNTAX: adsl info EXAMPLE (for a SpeedTouch 500Series ADSL/POTS variant): =>adsl info...
  • Page 32 0 failures Loss of power: 0 failures Loss of link: 0 failures Errored seconds: 0 seconds Far end failures last 15 minutes Loss of frame: 0 seconds Loss of signal: 0 seconds Loss of power: 0 seconds Loss of link:...
  • Page 33: Atm Commands

    Topic Page atm portstats atm oam config atm oam status The command :atm portstats is replaced by the command :atmstats portstats for the SpeedTouch 570. Note The command :atmstats portstats is the only ATM command for the SpeedTouch 570. E-SIT-CTC-20021203-0003 v1.0...
  • Page 34: Atm Portstats

    ATM Commands atm portstats Show port specific Asynchronous Transfer Mode (ATM) statistics. SYNTAX: atm portstats port = <{DSL0|ATM|ATMF25|ATM3|ATM4|ATM5} or number> port The port to show the ATM statistics of. REQUIRED Choose between: DSL0 • • ATMF25 • ATM3 • ATM5 •...
  • Page 35: Atm Oam Config

    ATM Commands atm oam config Configure Operation and Maintenance (OAM) cell settings. SYNTAX: atm oam config clp = <number{0-1}> The CLP bit value of the OAM cells. REQUIRED Select either: • • E-SIT-CTC-20021203-0003 v1.0...
  • Page 36: Atm Oam Status

    ATM Commands atm oam status Show OAM data blocking mode of all ports. SYNTAX: atm oam status EXAMPLE: =>atm oam status OAM config dump ------------------- CLP bit value : 1 => E-SIT-CTC-20021203-0003 v1.0...
  • Page 37: Bridge Commands

    Bridge Commands Bridge Commands Contents This chapter covers the following commands: Topic Page bridge config bridge flush bridge ifadd bridge ifattach bridge ifconfig bridge ifdelete bridge ifdetach bridge iflist bridge macadd bridge macdelete bridge maclist E-SIT-CTC-20021203-0003 v1.0...
  • Page 38: Bridge Config

    Bridge Commands bridge config Show/set bridge ageing policy for dynamically learned Medium Access Control (MAC) addresses. SYNTAX: bridge config [age = <number {10 - 100000}>] [age] A number between 10 and 100000 (seconds). OPTIONAL Represents the lifetime of a dynamically learned MAC address.
  • Page 39: Bridge Flush

    Bridge Commands bridge flush Flush bridge interfaces and parameters. The flush command does not impact previously saved configurations. Note SYNTAX: bridge flush E-SIT-CTC-20021203-0003 v1.0...
  • Page 40: Bridge Ifadd

    Bridge Commands bridge ifadd Create a bridged Ethernet interface. E-SIT-CTC-20021203-0003 v1.0...
  • Page 41 [dest = <available ETHoA phonebook entries>] [intf] The bridged Ethernet interface name. OPTIONAL If not specified, the destination parameter must be specified. In this case the name of the destination will double as interface name. [dest] The destination address for the new interface.
  • Page 42 Bridge Commands RELATED COMMANDS: bridge ifattach Attach a bridge interface. bridge ifdetach Detach a bridge interface. bridge ifdelete Delete a bridge interface. bridge ifconfig Configure a bridge interface. bridge iflist Show current bridge configuration. E-SIT-CTC-20021203-0003 v1.0...
  • Page 43: Bridge Ifattach

    Bridge Commands bridge ifattach Attach (i.e. connect) a bridged Ethernet interface. E-SIT-CTC-20021203-0003 v1.0...
  • Page 44 SYNTAX: bridge ifattach intf = <available Bridged Ethernet interfaces> intf The name of the interface to attach. REQUIRED Browse through the available entries via the ARROW UP and ARROW DOWN keys. EXAMPLE: =>bridge iflist Internal Connection State: connected Port: OBC...
  • Page 45 Bridge Commands RELATED COMMANDS: bridge ifadd Create a bridge interface. bridge ifdetach Detach a bridge interface. bridge ifdelete Delete a bridge interface. bridge ifconfig Configure a bridge interface. bridge iflist Show current bridge configuration. E-SIT-CTC-20021203-0003 v1.0...
  • Page 46: Bridge Ifconfig

    OPTIONAL This parameter needs only to be specified in case of an interface created without specified destination. [qos] The name of the Quality Of Service book entry to apply on this OPTIONAL bridge interface. [encaps] The type of encapsulation to be used for this bridge interface.
  • Page 47 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...
  • Page 48: Bridge Ifdelete

    SYNTAX: bridge ifdelete intf = <available Bridged Ethernet interfaces> intf The name of the interface name to delete. REQUIRED Browse through the available entries via the ARROW UP and ARROW DOWN keys. EXAMPLE: =>bridge ifdelete intf=TestBridge =>bridge iflist Internal Connection State: connected...
  • Page 49: Bridge Ifdetach

    = <available Bridged Ethernet interfaces> intf The name of the bridge interface to detach. REQUIRED Browse through the available entries via the ARROW UP and ARROW DOWN keys. EXAMPLE: =>bridge iflist intf=TestBridge TestBridge : dest : Br1...
  • Page 50: Bridge Iflist

    Bridge Commands bridge iflist Show the current state of all or the selected bridge interfaces. SYNTAX: bridge iflist [intf = <available Bridged Ethernet interfaces>] [intf] The name of the bridge interface to show the configuration of. OPTIONAL Browse through the available entries via the ARROW UP and ARROW DOWN keys.
  • Page 51 DESCRIPTION:: RX bytes The number of Received bytes TX bytes The number of Transmitted bytes Short for On Board Controller and indicates the physical bridge port. RELATED COMMANDS: bridge ifadd Create a bridge interface. bridge ifattach Attach a created bridge interface.
  • Page 52: Bridge Macadd

    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 = <available bridge interfaces> hwaddr = <hardware-address>...
  • Page 53: Bridge Macdelete

    Bridge Commands bridge macdelete Remove a MAC address from the filtering database. SYNTAX: bridge macdelete hwaddr = <hardware-address> hwaddr The MAC address of the entry to delete. REQUIRED EXAMPLE: =>bridge maclist 00:90:d0:01:02:03 static, ff:ff:ff:ff:ff:ff static, 01:80:c2:00:00:00 static, 01:80:c2:00:00:01 static, 01:80:c2:00:00:10...
  • Page 54: Bridge Maclist

    Bridge Commands bridge maclist Show current MAC address filtering database. SYNTAX: bridge maclist EXAMPLE: =>bridge maclist =>bridge maclist 00:90:d0:01:02:03 static, ff:ff:ff:ff:ff:ff static, 01:80:c2:00:00:00 static, 01:80:c2:00:00:01 static, 01:80:c2:00:00:10 static, 00:80:9f:24:ab:cf static, 00:01:42:5f:7d:81 dynamic, eth0, 598 seconds 00:50:8b:31:cc:aa dynamic, eth0, 379 seconds...
  • Page 55: Cip Commands

    CIP Commands CIP Commands Contents This chapter covers the following commands: Topic Page cip flush cip ifadd cip ifdelete cip iflist cip pvcadd cip pvcdelete cip pvclist E-SIT-CTC-20021203-0003 v1.0...
  • Page 56: Cip Flush

    CIP Commands cip flush Flush complete Classical IP over ATM (IPoA) configuration. The flush command does not impact previously saved configurations. Note SYNTAX: cip flush E-SIT-CTC-20021203-0003 v1.0...
  • Page 57: Cip Ifadd

    CIP Commands cip ifadd Create a Classical IPoA interface at the local side of the Logical IP Subnet (LIS). SYNTAX: cip ifadd addr = <ip-address> [netmask = <ip-mask (dotted or cidr)>] [uniaddr = <portspec:address[.selector]>] addr The Classical IPoA interface's local IP address in the LIS.
  • Page 58: Cip Ifdelete

    CIP Commands cip ifdelete Delete a Classical IPoA interface at the local side of the Logical IP Subnet (LIS). SYNTAX: cip ifdelete addr = <ip-address> addr The Classical IPoA interface's local IP address in the LIS. REQUIRED EXAMPLE: =>cip iflist cip0 addr = 172.16.1.1...
  • Page 59: Cip Iflist

    Incoming/outgoing inverse ARP requests inarp_repl_in/inarp_repl_out Incoming/outgoing inverse ARP replies inarp_inv_in/inarp_inv_out Incoming/outgoing invalid inverse ARP messages EXAMPLE INPUT/OUTPUT: EVOLUTION OF ARP REQUESTS IN A NETWORKED ENVIRONMENT: =>cip iflist cip0 addr = 200.200.200.138 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in...
  • Page 60 CIP Commands RELATED COMMANDS: cip ifadd Create a Classical IPoA interface. cip ifdelete Delete a Classical IPoA interface. E-SIT-CTC-20021203-0003 v1.0...
  • Page 61: Cip Pvcadd

    CIP Commands cip pvcadd Create a PVC Address Resolution Protocol (ARP) entry for destinations which are not RFC 1577/RFC2225 compliant. SYNTAX: cip pvcadd dest = <phonebookname> [destaddr = <ip-address>] [mtu = <number {273-20000}>] dest The ATM address (hardware address) of the destination host.
  • Page 62: Cip Pvcdelete

    Delete a PVC ARP entry. SYNTAX: cip pvcdelete dest = <phonebookname> dest Typically a phonebook entry name. REQUIRED Represents the ATM address (hardware address) or name of the entry to delete. EXAMPLE: =>cip pvclist CIPPVC1 atmport = 80 dest_ip = 172.16.1.2...
  • Page 63: Cip Pvclist

    = 0 vpi = 8 vci = 80 dest_ip = 172.16.1.2 encaps = llc mtu = 546 => 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 inarp_repl_in...
  • Page 64: Cip Commands

    CIP Commands E-SIT-CTC-20021203-0003 v1.0...
  • Page 65: Config Commands

    Config Commands Config Commands Contents This chapter covers the following commands: Topic Page config erase config flush config load config save E-SIT-CTC-20021203-0003 v1.0...
  • Page 66: Config Erase

    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 RELATED COMMANDS: config flush Flush complete runtime configuration. config load Load complete saved or default configuration.
  • Page 67: Config Flush

    Flush complete current configuration without affecting saved configurations. This combines all flush commands: bridge flush, cip flush, dhcp client flush, dhcp server flush, dns flush, env flush, firewall flush, firewall rule flush, ipoa flush, mer flush, nat flush, phonebook flush, ppp flush, pptp flush, qosbook flush, system flush and optionally ip flush.
  • Page 68: Config Load

    [load_ip = <{no|yes}>] [defaults = <{yes|no}>] [load_ip] Load IP settings (yes) or not (no). OPTIONAL Not keeping the IP settings could cause lost IP connectivity in the LAN. [defaults] Load default configuration (yes) or saved configuration (no). OPTIONAL Not specifying this parameter loads the saved configuration EXAMPLE: =>ip rtlist...
  • Page 69: Config Save

    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.
  • Page 70 Config Commands E-SIT-CTC-20021203-0003 v1.0...
  • Page 71: Dhcp Commands

    config...
  • Page 72: Dhcp Client Clear

    DHCP Commands dhcp client clear Clear Dynamic Host Configuration Protocol (DHCP) client statistics. SYNTAX: dhcp client clear EXAMPLE: =>dhcp client stats DHCP client statistics: Corrupted packet recv OFFERs recv ACKs recv NAKs recv Pure BOOTP REPLIES Other message types DISCOVERs sent...
  • Page 73: Dhcp Client Config

    [trace] Enable tracing (on) or not (off). OPTIONAL EXAMPLE: =>dhcp client config tracing: off =>dhcp client config trace=on =>dhcp client config tracing: on => RELATED COMMANDS: dhcp client ifconfig Configure a DHCP lease created for a specific interface. E-SIT-CTC-20021203-0003 v1.0...
  • Page 74: Dhcp Client Flush

    DHCP server 255.255.255.255 hostname NewLease req.leasetime= 10800 s trying to get a lease for 8 min, 32 sec transmission of DISCOVER in 57 sec retransmission timeout: nbr of retransmissions: Number of leases: Total size of table: 19, in use: 1, free: 94 % =>dhcp client flush...
  • Page 75: Dhcp Client Ifadd

    Create a DHCP lease for a specific interface. SYNTAX: dhcp client ifadd intf = <interface name> intf The name of an existing interface, e.g. created via :mer ifadd. REQUIRED EXAMPLE: =>dhcp client iflist No dynamic interfaces defined. =>dhcp client ifadd intf=NewMer =>dhcp client iflist...
  • Page 76: Dhcp Client Ifattach

    DHCP server 255.255.255.255 hostname NewLease req.leasetime 10800 s trying to get a lease for 8 min, 32 sec transmission of DISCOVER in 57 sec retransmission timeout: 64 nbr of retransmissions: 14 Number of leases: Total size of table: 19, in use: 1, free: 94 % =>...
  • Page 77: Dhcp Client Ifconfig

    The client identity to be associated with the lease. Use none in case OPTIONAL no clientid should be associated with this lease. [hostname] The host name of the client to be associated with the lease. Use “” in OPTIONAL case no hostname should not be associated with this lease. [addr] The preferred dynamic IP address.
  • Page 78: Dhcp Client Ifrelease

    Total size of table: 19, in use: 1, free: 4 % => RELATED COMMANDS: dhcp client ifadd Create a DHCP lease for a specific interface. dhcp client ifdelete Delete a dynamic interface. dhcp client iflist Show all dynamic interfaces. dhcp client ifrelease Release a lease attached to a dynamic interface.
  • Page 79: Dhcp Client Ifdelete

    DHCP server 255.255.255.255 hostname NewLease req.leasetime 10800 s trying to get a lease for 8 min, 32 sec transmission of DISCOVER in 57 sec retransmission timeout: nbr of retransmissions: Number of leases: Total size of table: 19, in use: 1, free: 94 % =>dhcp client ifdelete intf NewMer...
  • Page 80: Dhcp Client Iflist

    Number of leases: Total size of table: 19, 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= IP address 10.0.0.3...
  • Page 81: Dhcp Client Ifrelease

    DHCP server 255.255.255.255 hostname NewLease req.leasetime 10800 s trying to get a lease for 8 min, 32 sec transmission of DISCOVER in 57 sec retransmission timeout: nbr of retransmissions: Number of leases: Total size of table: 19, in use: 1, free: 94 % =>dhcp client ifattach intf=NewMer...
  • Page 82 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= IP address 10.0.0.3 HW address 00:90:d0:01:47:f1 DHCP server 10.10.1.1 lease renewal in days, 58 min, 45 sec...
  • Page 83: Dhcp Client Ifrenew

    00:90:d0:01:47:de DHCP server 255.255.255.255 hostname NewLease req.leasetime 10800 s trying to get a lease for 12 sec transmission of DISCOVER in 24 sec retransmission timeout: nbr of retransmissions: Number of leases: Total size of table: 19, in use: 1, free: 94 % =>...
  • Page 84 DHCP Commands EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch is configured as DHCP client on its Ethernet interface eth0. =>dhcp client stats DHCP client statistics: Corrupted packet recv OFFERs recv ACKs recv NAKs recv Pure BOOTP REPLIES Other message types...
  • Page 85: Dhcp Client Stats

    DISCOVERs sent REQUESTs sent DECLINEs sent RELEASEs sent INFORMs sent Number of dynamic interfaces: Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % => RELATED COMMANDS: dhcp client clear Clear DHCP client statistics. E-SIT-CTC-20021203-0003 v1.0...
  • Page 86: Dhcp Server Clear

    REQUESTs sent DECLINEs sent RELEASEs sent INFORMs sent Number of dynamic interfaces: Memory usage: Table size of dyn leases: 19, in use: 1, free: 94 % =>dhcp server clear =>dhcp client stats DHCP client statistics: Corrupted packet recv OFFERs recv...
  • Page 87: Dhcp Server Config

    DHCP client OPTIONAL (AutoDHCP mode) at boot time and probe for another DHCP server on the network for some time before starting its own DHCP server (yes) or immediately start the DHCP server (no). [scantime] A number between 0 and 1814400 (seconds).
  • Page 88: Dhcp Server Flush

    DHCP Commands dhcp server flush Flushes all DHCP server pool and lease entries. The flush command does not impact previously saved configurations. Note 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.
  • Page 89: Dhcp Server Policy

    Probe the network for conflicting IP addresses before giving a OPTIONAL suggested IP address to the requesting DHCP client (on) or not (off). [trustclient] Take the IP address suggested by a DHCP client into account (on) or OPTIONAL not (off). EXAMPLE: =>dhcp server policy...
  • Page 90: Dhcp Server Spoof

    DHCP Commands dhcp server spoof Show/set DHCP spoofing parameters. Only applicable in case of a PPP-to-DHCP Spoofing connection. (See dhcp server config command). SYNTAX: dhcp server spoof [failtime = <number>] [errorlt = <number>] [dodlt = <number>] [failtime] A number between 0 and 1814400 (seconds).
  • Page 91: Dhcp Server Start

    Corrupted packet recv ..=>dhcp server start =>dhcp server stats DHCP server state: Running DHCP server statistics: Corrupted packet recv ..=> RELATED COMMANDS: dhcp server stats Show current DHCP server state and statistics. dhcp server stop Stop DHCP server. E-SIT-CTC-20021203-0003 v1.0...
  • Page 92: Dhcp Server Stats

    Pure BOOTP REQUESTS Other message types OFFERs sent 2451 ACKs sent NAKs sent Lease table got full Ping table got full Second dhcp server seen : Total size of lease table: 32, in use: 16, free: 50 % => E-SIT-CTC-20021203-0003 v1.0...
  • Page 93 Indicates whether the maximum number of DHCP leases is reached or not. Ping table got full Indicates whether the history list of IP address pings got full or not. These pings are sent by the SpeedTouch DHCP server to verify whether the IP address is already in use on the LAN or not.
  • Page 94: Dhcp Server Stop

    Corrupted packet recv ..=>dhcp server start =>dhcp server stats DHCP server state: Stopped DHCP server statistics: Corrupted packet recv ..=> RELATED COMMANDS: dhcp server start Start DHCP server. dhcp server stats Show current DHCP server state and statistics. E-SIT-CTC-20021203-0003 v1.0...
  • Page 95: Dhcp Server Lease Add

    The name of the DHCP server pool from which the DHCP lease REQUIRED should be taken from. Use :dhcp server pool list for a list of available DHCP server pools. [addr] The favoured IP address for this DHCP host. This IP address, if spec- OPTIONAL ified, must be in the range of the DHCP pool specified.
  • Page 96 DHCP Commands RELATED COMMANDS: dhcp server lease delete Delete a DHCP lease. dhcp server lease flush Delete all DHCP leases. dhcp server lease list Show current DHCP leases. E-SIT-CTC-20021203-0003 v1.0...
  • Page 97: Dhcp Server Lease Delete

    The DHCP client identification string of the DHCP lease. REQUIRED [index] The index number of the entry to be deleted. OPTIONAL Use :dhcp server lease list to see a list of the index numbers of all current DHCP leases. EXAMPLE: =>dhcp server lease list Lease...
  • Page 98: Dhcp Server Lease Flush

    DHCP Commands dhcp server lease flush Flush complete DHCP server configuration and dynamic leases. The flush command does not impact previously saved configurations. Note SYNTAX: dhcp server lease flush EXAMPLE: =>dhcp server lease list Lease Pool State Clientid 0.0.0.0 dhcp_pool_1...
  • Page 99: Dhcp Server Lease List

    DHCP Commands dhcp server lease list List current DHCP leases, indicated by their index number. SYNTAX: dhcp server lease list EXAMPLE OUTPUT: =>dhcp server lease list =>dhcp server lease list Lease Pool State Clientid 0.0.0.0 dhcp_pool_1 00:26:40 FREE 00:90:D0:12:34:56 10.0.0.1...
  • Page 100: Dhcp Server Pool Add

    [name = <string>] [index = <number>] [name] A name for the DHCP server pool. If not specified, the name is OPTIONAL “dhcp_pool_x”, where x is a subsequent number. [index] A number between 0 (highest priority) and the highest number OPTIONAL (lowest priority) found in the list of existing DHCP server pools.
  • Page 101 DHCP Commands RELATED COMMANDS: dhcp server pool delete Delete a DHCP pool. dhcp server pool flush Delete all DHCP pools. dhcp server pool list Show current DHCP pools. E-SIT-CTC-20021203-0003 v1.0...
  • Page 102: Dhcp Server Pool Config

    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. SYNTAX: dhcp server pool config name = <string> [index = <number>] [poolstart = <ip-address>]...
  • Page 103 The IP address of the optional secondary DNS server for DHCP OPTIONAL 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.
  • Page 104: Dhcp Server Pool Delete

    = <string> name The name of the DHCP server pool to delete. REQUIRED Use :dhcp server pool list to see a list of all current DHCP leases. EXAMPLE: =>dhcp server pool list Pool Start State 0 LAN_Private 10.0.0.1...
  • Page 105: Dhcp Server Pool Flush

    DHCP Commands dhcp server pool flush Flush all DHCP pools The flush command does not impact previously saved configurations. Note SYNTAX: dhcp server pool flush EXAMPLE: =>dhcp server pool list Pool Start State 0 dhcp_pool_1 0.0.0.0 0.0.0.0 FREE 1 My_LAN_Pool 10.0.0.1...
  • Page 106: Dhcp Server Pool List

    DHCP Commands dhcp server pool list List current DHCP leases. SYNTAX: dhcp server pool list EXAMPLE: =>dhcp server pool list Pool Start State 0 dhcp_pool_1 0.0.0.0 0.0.0.0 FREE 1 My_LAN_Pool 10.0.0.1 10.0.0.254 USED 2 POOL_EXTRA2 0.0.0.0 0.0.0.0 FREE 3 dhcp_pool_2 0.0.0.0...
  • Page 107: Dns Commands

    DNS Commands DNS Commands Contents This chapter covers the following commands: Topic Page dns add dns clear dns clrstats dns delete dns domain dns flush dns fwdadd dns fwddelete dns fwdlist dns fwdtable dns list dns nslookup dns start dns stats...
  • Page 108: Dns Add

    DNS Commands dns add Add a static DNS entry for IP hosts who do not reveal their hostname in the DHCP request, or do not support DHCP. SYNTAX: dns add hostname = <string> [addr = <ip-address>] hostname The name of the IP host (without the (sub)domain name).
  • Page 109: Dns Clear

    Hostname IP Address SpeedTouch *.*.*.* TestHost 10.0.0.140 HTTP_Server 10.0.0.8 FTP_Server 10.0.0.7 Total Table Size: 73 entries Amount used: 4 (5%) =>dns clear =>dns list Domain: business.lan Hostname IP Address Total Table Size: 73 entries Amount used: 0 (0%) => RELATED COMMANDS: dns list List current DNS entries.
  • Page 110: Dns Clrstats

    Local neg answers sent Total DNS packets fwd External answers recv Fwd table full, discard Spurious answers Unknown query types Total number of packets received =>dns clrstats DNS statistics cleared. =>dns stats DNS Statistics: Corrupted packets recv Local questions resolved...
  • Page 111: Dns Delete

    SYNTAX: dns delete index = <number> index The index number of the entry to be deleted. REQUIRED Use :dns list to see a list of the index numbers of all current DNS entries. EXAMPLE: =>dns list Domain: business.lan Hostname IP Address SpeedTouch *.*.*.*...
  • Page 112: Dns Domain

    DNS Commands dns domain Set local DNS (sub)domain name. SYNTAX: dns domain domain = <string> domain The local DNS (sub)domain name. REQUIRED EXAMPLE: =>dns list Domain: business.lan Hostname IP Address SpeedTouch *.*.*.* TestHost 10.0.0.140 HTTP_Server 10.0.0.8 FTP_Server 10.0.0.7 Total Table Size: 73 entries Amount used: 4 (5%) =>dns domain domain=office.home.lan...
  • Page 113: Dns Flush

    DNS Commands dns flush Flush the complete SpeedTouch DNS server/forwarder configuration and static entries. The flush command does not impact previously saved configurations. Note SYNTAX: dns flush EXAMPLE: =>dns list Domain: office.home.lan Hostname IP Address Z7V1D8 10.0.0.29 SpeedTouch *.*.*.* TestHost 10.0.0.140...
  • Page 114: 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).
  • Page 115: Dns Fwddelete

    Delete a DNS forwarding entry. SYNTAX: dns fwddelete src = <ip-address> mask = <ip-mask (dotted or cidr)> [dns = <ip-address>] The source IP address (pool) of the hosts to remove the entry for. REQUIRED mask The source IP (sub)netmask. REQUIRED [dns]...
  • Page 116: Dns Fwdlist

    DNS Commands dns fwdlist Show current DNS forwarding entries. SYNTAX: dns fwdlist EXAMPLE OUTPUT: =>dns fwdlist DNS forwarding servers: MASK Direct 10.0.0.138 10.0.0.0 255.255.255.0 192.6.11.150 192.6.11.0 255.255.255.0 => RELATED COMMANDS: dns fwdadd Add a DNS forwarding entry. dns fwddelete Delete a DNS forwarding entry.
  • Page 117: Dns Fwdtable

    DNS Commands dns fwdtable Show DNS forwarding table, i.e. list all curently unresolved DNS requests. SYNTAX: dns fwdtable EXAMPLE OUTPUT: =>dns fwdtable Forwarding table: Ip Address (port#):id(hex) (expiry) dns server tries 10.10.10.12 (54751):8331 (13 sec) 10.10.10.112 Timeout: 15 seconds Table size: 10 amount of table used: 1 (10%) =>...
  • Page 118: Dns List

    Hostname IP Address SpeedTouch *.*.*.* Server 10.10.1.1 Client 10.0.0.3 Total Table Size: 73 entries Amount used: 3 (4%) => RELATED COMMANDS: dns add Add a static DNS entry. dns delete Delete a DNS entry (via its index number). E-SIT-CTC-20021203-0003 v1.0...
  • Page 119: Dns Nslookup

    DNS Commands dns nslookup Search the hostname (via a known IP address) or the IP address (via a known hostname) of a DNS host. SYNTAX: dns nslookup lookup = <string> lookup The DNS hostname or IP address to query. REQUIRED EXAMPLE: =>dns list...
  • Page 120: Dns Start

    DNS table size in use: free: 94 % DNS forwarding table size in use: free: 100 % DNS forwarding dns servers table size in use: free: 84 % No dns cache. Tracing: off =>dns start DNS server started. =>dns status...
  • Page 121: Dns Stats

    Unknown query types Total number of packets received =>(Ping Client.SpeedLAN.local) =>(CTRL + Q) dnsd: Internet class type A request received from 10.10.1.1. dnsd: Client.SpeedLAN.local found in local database. dnsd: Client.SpeedLAN.local resolved into 10.0.0.3. =>(Ping Server.SpeedLAN.local) dnsd: Internet class type A request received from 10.10.1.1.
  • Page 122: Dns Status

    DNS server status: Stopped DNS table size in use: free: 94 % DNS forwarding table size in use: free: 100 % DNS forwarding dns servers table size in use: free: 84 % No dns cache. Tracing: off => E-SIT-CTC-20021203-0003 v1.0...
  • Page 123: Dns Stop

    DNS table size in use: free: 94 % DNS forwarding table size in use: free: 100 % DNS forwarding dns servers table size in use: free: 84 % No dns cache. Tracing: off =>dns stop DNS server stopped. =>dns status...
  • Page 124: Dns Toutfwd

    REQUIRED 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...
  • Page 125: Dns Troff

    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 in use: free: 94 % DNS forwarding table size in use: free: 100 %...
  • Page 126: Dns Tron

    84 % No dns cache. Tracing: on =>(CTRL + Q) dnsd: Internet class type A request received from 10.0.0.10. dnsd: aa.aa.be is outside our domain: forward. dnsd: forwarding request from 10.0.0.10 (1318,0x0001) to 138.203.68.61 (try=1): 'reply to ant' mode. dnsd: Internet class type A request received from 10.0.0.10.
  • Page 127: Env Commands

    Env Commands Env Commands Contents This chapter covers the following commands Topic Page env def env flush env get env list env set env unset E-SIT-CTC-20021203-0003 v1.0...
  • Page 128: Env Def

    Env Commands env def Define an environment variable. This command is for internal use by the Setup wizard application only. Do not use it. Note SYNTAX: env def E-SIT-CTC-20021203-0003 v1.0...
  • Page 129: Env Flush

    Env Commands env flush Flush all non-system environment variables. E-SIT-CTC-20021203-0003 v1.0...
  • Page 130 _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.0 _MACADDR=00-90-D0-03-02-01 _UDN=uuid:UPnP-SpeedTouch510-1_00-90-D0-03-02-01 CONF_REGION=World CONF_PROVIDER=Generic ISP CONF_DESCRIPTION=Relayed PPPoA Packet Service configuration CONF_SERVICE=Relayed PPPoA CONF_VERSION=4.1.1.0 HOST_SETUP=auto UPGRADE_URL=http://www.speedtouch.com/upgrade500.htm COLUMNS=80 ROWS=24 SESSIONTIMEOUT=0...
  • Page 131 Env Commands RELATED COMMANDS: env list List all environment variables. E-SIT-CTC-20021203-0003 v1.0...
  • Page 132: Env Get

    Get the current value of a environment variable. SYNTAX: env get var = <string> The name of the environment variable. REQUIRED Execute env list to see a list of all environment variables. EXAMPLE: =>env list _COMPANY_NAME=THOMSON multimedia _COMPANY_URL=http://www.speedtouch.com _PROD_NAME=SpeedTouch _PROD_FRIENDLY_NAME=SpeedTouch 610 Business DSL Router...
  • Page 133: Env List

    Env Commands env list Show all currently available environment variables. SYNTAX: env list EXAMPLE: =>env list _COMPANY_NAME=THOMSON multimedia _COMPANY_URL=http://www.speedtouch.com _PROD_NAME=SpeedTouch _PROD_FRIENDLY_NAME=SpeedTouch 610 Business DSL Router _PROD_NUMBER=610 _BOARD_SERIAL_NBR=012345678 _BUILD=R4.1.0.9 _BUILDNAME=Sascha4.109 _PRL=3EC99999XXXX _BOARD_NAME=ADNT-R _COMPANY_ID=NWBGL _COPYRIGHT=Copyright(c) 2002 THOMSON multimedia _MACADDR=00-90-D0-01-02-03 _UDN=uuid:UPnP-SpeedTouch 520-1_00-90-D0-01-02-03 CONF_REGION=Belgium...
  • Page 134: Env Set

    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 = <string> value = <string> The name of the environment variable. REQUIRED 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 “_”...
  • Page 135: Env Unset

    = <string> The name of the environment variable to delete. REQUIRED System variables (built-in variables with names starting with an under- score “_”, “CONF” or “HOST”) can not be unset, nor changed or deleted. EXAMPLE: =>env list _COMPANY_NAME=THOMSON multimedia _COMPANY_URL=http://www.speedtouch.com...
  • Page 136 Env Commands E-SIT-CTC-20021203-0003 v1.0...
  • Page 137: Eth Commands

    Eth Commands Eth Commands Introduction The eth command group is only applicable to SpeedTouch 500Series variants equipped with a single Ethernet port (i.e. no switch variants). Contents This chapter covers the following topics: Topic Page eth ifconfig eth iflist E-SIT-CTC-20021203-0003 v1.0...
  • Page 138: Eth Ifconfig

    100BaseTFD • 100Mb/s communication speed in full duplex mode. • By default the Ethenet type is set to auto and should never be changed, except in case of communication problems. RELATED COMMANDS: eth iflist Show Ethernet port configuration and current operating mode.
  • Page 139: Eth Iflist

    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. RELATED COMMANDS: eth ifconfig Configure the Ethernet port.
  • Page 140 Eth Commands E-SIT-CTC-20021203-0003 v1.0...
  • Page 141: Firewall Commands

    Firewall Commands Firewall Commands Contents This chapter covers the following topics: Topic Page firewall assign firewall flush firewall list firewall troff firewall tron firewall unassign firewall chain create firewall chain delete firewall chain list firewall rule clear firewall rule create...
  • Page 142: Firewall Assign

    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...
  • Page 143: Firewall Flush

    Firewall Commands firewall flush Flush all associations between a hook and its chain(s). The chain itself is not removed. The flush command does not impact previously saved configurations. Note SYNTAX: firewall flush [hook = <{input|sink|forward|source|output}>] [hook] The name of the hook to clear. Choose between:...
  • Page 144: Firewall List

    Firewall Commands firewall list Show association(s) between all hooks and their chain(s) or of one specified hook SYNTAX: firewall list [hook = <{input|sink|forward|source|output}>] [hook] The name of the hook to show the associations for. Choose OPTIONAL between: input • sink •...
  • Page 145: Firewall Troff

    Firewall Commands firewall troff Disable verbose console messaging. SYNTAX: firewall troff EXAMPLE: =>firewall troff RELATED COMMANDS: firewall tron Enable verbose console messaging. E-SIT-CTC-20021203-0003 v1.0...
  • Page 146: Firewall Tron

    Firewall Commands firewall tron Enable verbose console messaging. SYNTAX: firewall tron EXAMPLE: =>firewall tron RELATED COMMANDS: firewall troff Disable verbose console messaging. E-SIT-CTC-20021203-0003 v1.0...
  • Page 147: Firewall Unassign

    Firewall Commands firewall unassign Unassign all chains from a hook. SYNTAX: firewall unassign hook = <{input|sink|forward|source|output}> hook The hook's name to unassign all chain from. Choose between: REQUIRED input • sink • forward • source • output. • RELATED COMMANDS: ipsec policy assign Assign a chain to a hook.
  • Page 148: Firewall Chain Create

    Firewall Commands firewall chain create Create a new chain. SYNTAX: firewall chain create chain = <string> 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 =>...
  • Page 149: Firewall Chain Delete

    Delete a chain. SYNTAX: firewall chain delete chain = <string> chain The name of the chain to be deleted. REQUIRED EXAMPLE: =>firewall chain list Telnet, Tempo, source, forward, sink =>firewall chain list Telnet, Tempo, source, forward, sink =>firewall chain delete chain=Tempo...
  • Page 150: Firewall Chain List

    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 =>...
  • Page 151: Firewall Rule Clear

    SYNTAX: firewall rule clear [chain = <string>] [index = <number>] [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 OPTIONAL chain EXAMPLE: =>firewall rule stats...
  • Page 152: Firewall Rule Create

    The name of the chain to insert the rule in. REQUIRED [index] The number of the rule before which the new rule must be added. OPTIONAL [srcintf] The name of the interface the packet should [or should NOT] arrive OPTIONAL on to make this rule apply.
  • Page 153 OPTIONAL Choose between: • local • • (NOT applicable if used in a chain assigned to the output hook) [srcbridgeport] A number between 0 and 6. OPTIONAL Represents the bridge port the virtual packet should [or should NOT] arrive on.
  • Page 154 A number between 0 and 15. OPTIONAL Represents the ICMP code range end. Only applicable for ranges. [clink] The name of the chain to be parsed when this rule applies. (action is OPTIONAL ignored). action Action to be taken when this rule applies. Choose between: REQUIRED accept : the packet may pass.
  • Page 155 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. E-SIT-CTC-20021203-0003 v1.0...
  • Page 156: Firewall Rule Delete

    The name of the chain in which to delete the rule. REQUIRED index The index number of the rule in the chain. REQUIRED 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...
  • Page 157: Firewall Rule Flush

    Firewall Commands firewall rule flush Flush all rules created for a chain(s). The chain itself is not removed. The flush command does not impact previously saved configurations. Note SYNTAX: firewall rule flush [chain = <string>] [chain] The name of the chain to empty.
  • Page 158: Firewall Rule List

    [chain = <string>] [chain] The name of the chain to list the rules of. OPTIONAL If this parameter is not specified, all rules for all chains Note are shown. EXAMPLE INPUT AND OUTPUT: =>firewall rule list chain=Telnet :firewall rule create chain=Telnet index=0 srcintfgrp=lan src=10.0.0.0/8 |...
  • Page 159: Firewall Rule Stats

    => DESCRIPTION: The statistics for the ‘Test‘ chain are the result of sending udp packets to the SpeedTouch . The chain ‘Test‘ is assigned to the hook ‘input‘ and prohibits the sending of udp packets from one host to another.
  • Page 160 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.3/32 prot=icmp action=count...
  • Page 161: Ip Commands

    IP Commands IP Commands Contents This chapter covers the following commands: Topic Page ip apadd ip apdelete ip aplist ip arpadd ip arpdelete ip arplist ip config ip flush ip ifconfig ip iflist ip ping ip rtadd ip rtdelete ip rtlist ip sendto E-SIT-CTC-20021203-0003 v1.0...
  • Page 162: Ip Apadd

    The subnetmask associated with this address. OPTIONAL intf The interface name. REQUIRED [pointopoint]] The remote IP address in case of a dedicated point-to-point link. OPTIONAL [addrtrans] Indicates whether network address translation mode is allowed OPTIONAL (pat) for this IP address or not (none).
  • Page 163 ReasmMAX:65535 Group:1 IPRX bytes:116 unicastpkts:0 brcastpkts:2 IPTX bytes:0 unicastpkts:0 brcastpkts:0 droppkts:0 HWRX bytes:0 unicastpkts:0 brcastpkts:0 HWTX bytes:0 unicastpkts:0 brcastpkts:0 droppkts:0 => RELATED COMMANDS: ip apdelete Remove an IP address from an interface. ip aplist Show current IP addresses. E-SIT-CTC-20021203-0003 v1.0...
  • Page 164: Ip Apdelete

    IP Commands ip apdelete Remove an IP address from an interface. SYNTAX: ip apdelete addr = <ip-address> addr The IP address to delete. REQUIRED 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.0 UP RUNNING...
  • Page 165: Ip Aplist

    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.0 UP RUNNING MTU:1500 ReasmMAX:65535 Group:2 IPRX bytes:0 unicastpkts:0...
  • Page 166: Ip Arpadd

    = <interface name> ip = <ip-address> [hwaddr = <hardware-address>] intf The interface name. REQUIRED The IP address. REQUIRED [hwaddr] The hardware address (e.g. the Ethernet MAC address). OPTIONAL EXAMPLE: =>ip arplist Intf IP-address HW-address Type eth0 10.0.0.1...
  • Page 167: Ip Arpdelete

    IP Commands ip arpdelete Remove an entry from the SpeedTouch ARP cache. SYNTAX: ip arpdelete intf = <interface name> ip = <ip-address> [hwaddr = <hardware-address>] intf The interface name. REQUIRED The IP address. REQUIRED [hwaddr] The hardware address. OPTIONAL EXAMPLE: =>ip arplist...
  • Page 168: Ip Arplist

    10.0.0.8 00:a0:24:ae:66:e1 DYNAMIC eth0 10.0.1.99 52:41:53:20:20:4d STATIC eth0 10.0.1.100 52:41:53:20:f0:90 STATIC eth0 10.0.0.2 00:10:a4:d0:9a:db STATIC => RELATED COMMANDS: ip arpadd Add a static entry to the ARP cache. ip arpdelete Delete an entry from the ARP cache. E-SIT-CTC-20021203-0003 v1.0...
  • Page 169: Ip Config

    [redirects] Disable (off) or enable (on) the sending of ICMP redirect messages. OPTIONAL A router can send a redirect message in case a shorter path than the path followed is discovered. For security reasons this parameter is disabled per default.
  • Page 170 • Checking of the address configuration of the SpeedTouch and also of traffic: addresses of incoming packets; this checking is related to constants (e. g. an address may not be entirely composed of one‘s or zero‘s). dynamic • Besides the address configuration of the SpeedTouch...
  • Page 171 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...
  • Page 172: Ip Flush

    Flush complete IP configuration. Dynamic configurations (e.g. from PPP or CIP links) remain. As an ip flush causes all local IP connectivity to be deleted, do not execute this command during an IP based Note local connection, e.g. a Telnet CLI session, or web based CLI access.
  • Page 173: Ip Ifconfig

    OPTIONAL Represents the maximum transmission unit, i.e. the maximum packet size (including IP header) to use on this interface. The default value depends on the connection and packet service for which the interface was created. [status] The administrative status of the interface.
  • Page 174: Ip Iflist

    IP Commands ip iflist Show all current interfaces. SYNTAX: ip iflist EXAMPLE OUTPUT: =>ip iflist loop 1500 eth0 3000 21045795 1019664 00:80:9f:24:ab:cf NewMer 1500 00:80:9f:24:ab:cf cip0 9180 => RELATED COMMANDS: ip ifconfig Configure interface parameters. E-SIT-CTC-20021203-0003 v1.0...
  • Page 175: Ip Ping

    A number between 100 and 10000000 (milliseconds). OPTIONAL Represents the intermediate interval between two sent ICMP packets. [listen] Listen for incoming ICMP packets (on) or only send ICMP packets OPTIONAL (off). EXAMPLE: =>ip ping addr=10.0.0.148 listen=off =>ip ping addr=10.0.0.148 listen=on 9 bytes from 10.0.0.148: Echo Request...
  • Page 176: Ip Rtadd

    [srcmsk] The source IP address mask. OPTIONAL [gateway] The IP address of the next hop. Must be directly connected. OPTIONAL The parameters ‘gateway‘ and ‘intf‘ are mutually exclusive. [intf] Only for special interface routes : the outgoing IP interface name.
  • Page 177 IP Commands RELATED COMMANDS: ip rtdelete Remove a route from the routing table. ip rtlist Show current routing table. E-SIT-CTC-20021203-0003 v1.0...
  • Page 178: Ip Rtdelete

    [srcmsk] The source IP address mask. OPTIONAL [gateway] The IP address of the next hop. Must be directly connected. OPTIONAL The parameters ‘gateway‘ and ‘intf‘ are mutually exclusive. [intf] Only for special interface routes : the outgoing IP interface name.
  • Page 179: Ip Rtlist

    0.0.0.140/32 0.0.0.0/0 10.0.0.140 eth0 127.0.0.1/32 0.0.0.0/0 127.0.0.1 loop 10.0.0.0/24 0.0.0.0/0 10.0.0.140 eth0 172.16.0.0/24 0.0.0.0/0 172.16.0.5 cip1 => RELATED COMMANDS: ip rtadd Add a route to the routing table. ip rtdelete Remove a route from the routing table. E-SIT-CTC-20021203-0003 v1.0...
  • Page 180: Ip Sendto

    A number between 100 and 10000000 (milliseconds). OPTIONAL Represents the intermediate interval between two sent UDP packets. [listen] Listen for incoming UDP packets (on) or only send UDP packets OPTIONAL (off). [srcport] The UDP source port number to use. OPTIONAL dstport The UDP destination port number to send to.
  • Page 181: Ipoa Commands

    IPoA Commands IPoA Commands Contents This chapter covers the following commands: Topic Page ipoa flush ipoa ifadd ipoa ifattach ipoa ifconfig ipoa ifdelete ipoa ifdetach ipoa iflist E-SIT-CTC-20021203-0003 v1.0...
  • Page 182: Ipoa Flush

    IPoA Commands ipoa flush Flush complete Routed IPoA configuration. The flush command does not impact previously saved configurations. Note SYNTAX: ipoa flush RELATED COMMANDS: ipoa ifadd Create a new Routed IPoA interface. ipoa ifconfig Configure a Routed IPoA interface. ipoa ifdelete Delete a Routed IPoA interface.
  • Page 183: Ipoa Ifadd

    [intf] The name for the new Routed IPoA interface. OPTIONAL If not specified, the destination parameter must be specified. In this case the name of the destination will double as interface name. [dest] The destination for the new Routed IPoA interface.
  • Page 184: Ipoa Ifattach

    IPoA Commands ipoa ifattach Attach (i.e. connect) an Routed IPoA interface. SYNTAX: ipoa ifattach intf = <intfname> intf The name of the Routed IPoA interface to attach. REQUIRED EXAMPLE: =>ipoa iflist IPoA_PVC1 dest : Br4 Retry : 10 QoS : default...
  • Page 185: Ipoa Ifconfig

    REQUIRED [dest] The destination for this interface. Typically a phonebook entry. OPTIONAL This parameter needs only to be specified in case of an interface created without specified destination. [qos] The name of a configured Quality Of Service book entry. OPTIONAL If not specified, the default Quality Of Service book entry will be used.
  • Page 186 IPoA Commands RELATED COMMANDS: ipoa ifadd Create a new Routed IPoA interface. ipoa ifattach Attach 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.
  • Page 187: Ipoa Ifdelete

    IPoA Commands ipoa ifdelete Delete a Routed IPoA interface. SYNTAX: ipoa ifdelete intf = <intfname> intf The name of the Routed IPoA interface. REQUIRED EXAMPLE: =>ipoa iflist Newipoa dest : Br3 Retry : 10 QoS : default Encaps : llc/snap...
  • Page 188: Ipoa Ifdetach

    IPoA Commands ipoa ifdetach Detach a Routed IPoA interface. SYNTAX: ipoa ifdetach intf = <intfname> intf The name of the Routed IPoA interface. REQUIRED EXAMPLE: =>ipoa iflist Newipoa dest : Br3 Retry : 10 QoS : default Encaps : llc/snap...
  • Page 189: Ipoa Iflist

    Show all or a specified Routed IPoA interface(s). SYNTAX: ipoa iflist [intf = <intfname>] [intf] The name of the Routed IPoA interface. OPTIONAL If not specified all Routed IPoA interfaces are listed. EXAMPLE OUTPUT: =>ipoa iflist Newipoa dest : Br3 Retry : 10 QoS : default...
  • Page 190 IPoA Commands E-SIT-CTC-20021203-0003 v1.0...
  • Page 191: Mer Commands

    MER Commands MER Commands Contents This chapter covers the following topics: Topic Page mer flush mer ifadd mer ifattach mer ifconfig mer ifdelete mer ifdetach mer iflist E-SIT-CTC-20021203-0003 v1.0...
  • Page 192: Mer Flush

    MER Commands mer flush Flush complete Routed Ethernet, often referred to as MAC Encapsulated Routing (MER), configuration. The flush command does not impact previously saved configurations. Note SYNTAX: mer flush EXAMPLE: =>mer iflist NewMer : dest : Br3 Retry : 10...
  • Page 193: Mer Ifadd

    The name for the new Routed Ethernet interface. OPTIONAL If not specified, the destination parameter must be specified. In Note this case the name of the destination will double as interface name. [dest] The destination for the new Routed Ethernet interface.
  • Page 194: Mer Ifattach

    MER Commands mer ifattach Attach (i.e. connect) a Routed Ethernet interface. SYNTAX: mer ifattach intf = <intfname> intf The name of the Routed Ethernet interface to attach. REQUIRED EXAMPLE: =>mer iflist NewMer : dest : Br3 Retry : 10 QoS : default...
  • Page 195: Mer Ifconfig

    REQUIRED [dest] The destination for this interface. Typically a phonebook entry. OPTIONAL This parameter needs only to be specified in case of an interface created without specified destination. [qos] The name of a configured Quality Of Service book entry. OPTIONAL This parameter never needs to be specified.
  • Page 196 MER Commands RELATED COMMANDS: mer ifadd Create a new Routed Ethernet interface. mer ifattach Attach a Routed Ethernet interface. mer ifdelete Delete a Routed Ethernet interface. mer ifdetach Detach a Routed Ethernet interface. mer iflist Show current Routed Ethernet interfaces.
  • Page 197: Mer Ifdelete

    MER Commands mer ifdelete Delete a Routed Ethernet interface. SYNTAX: mer ifdelete intf = <intfname> intf The name of the Routed Ethernet interface. REQUIRED EXAMPLE: =>mer iflist NewMer : dest : Br3 Retry : 10 QoS : default Encaps : llc/snap...
  • Page 198: Mer Ifdetach

    MER Commands mer ifdetach Detach a Routed Ethernet interface. SYNTAX: mer ifdetach intf = <intfname> intf The name of the Routed Ethernet interface. REQUIRED EXAMPLE: =>mer iflist NewMer : dest : Br3 Retry : 10 QoS : default Encaps : llc/snap...
  • Page 199: Mer Iflist

    Show all or a specified Routed Ethernet interface(s). SYNTAX: mer iflist [intf = <intfname>] [intf] The name of the Routed Ethernet interface. OPTIONAL If not specified, all Routed Ethernet interfaces are listed. Note EXAMPLE OUTPUT: =>mer iflist NewMer : dest : Br3 Retry : 10...
  • Page 200 MER Commands E-SIT-CTC-20021203-0003 v1.0...
  • Page 201: Nat Commands

    NAT Commands NAT Commands Contents This chapter covers the following commands: Topic Page nat applist nat bind nat bindlist nat create nat defserver nat delete nat disable nat enable nat flush nat list nat unbind E-SIT-CTC-20021203-0003 v1.0...
  • Page 202: Nat Applist

    List available Network Address and Port Translation (NAPT) protocol helpers. Certain protocols are ‘sensitive‘ to NAPT in that they do not function properly when dealing with it. This list shows which ‘NAPT-sensitive‘ applications are supported on the SpeedTouch , i.e.
  • Page 203: Nat Bind

    = <{<supported TCP/UDP port name>|<number>}> application The name of a NAPT application helper. REQUIRED The name must be spelled exactly as listed in the application list (:nat applist). port The TCP/UDP port this application handler should work on. REQUIRED Select one of the supported TCP/UDP port names (See “...
  • Page 204: Nat Bindlist

    Application Proto Port 5060 PPTP 1723 1002 H323 1720 RTSP 6667 RAUDIO(PNA) 7070 => RELATED COMMANDS: nat applist List available NAPT protocol helpers. nat bind Create a new NAPT helper/port binding. nat unbind Delete an existing helper/port binding. E-SIT-CTC-20021203-0003 v1.0...
  • Page 205: Nat Create

    NAT Commands nat create Create a static NAPT entry. Typically used to install specific servers behind the SpeedTouch NAPT device. SYNTAX: nat create protocol = <{<supported IP protocol name>|<number>}> inside_addr = <ip-address> [inside_port = <{<supported TCP/ UDP port name>|<number>}>] outside_addr = <ip-address>...
  • Page 206 “ Supported TCP/UDP Port Names” on page 290 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.
  • Page 207: Nat Defserver

    NAPT 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, ... connec- tivity. This command allows to specify this server. For specific services, use :nat create.
  • Page 208: Nat Delete

    SpeedTouch Alternatively, specify the protocol number. inside_addr The IP address of the local host (intended to receive the incoming REQUIRED traffic) behind the SpeedTouch 's NAPT device. Typically, a private IP address.
  • Page 209 “ Supported TCP/UDP Port Names” on page 290 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. E-SIT-CTC-20021203-0003 v1.0...
  • Page 210: Nat Disable

    10.0.0.138:137 10.0.0.140:137 10.0.0.254:137 10.0.0.138:7938 10.0.0.140:7938 10.0.0.96:4756 10.0.0.138:513 10.0.0.140:513 10.0.0.109:513 10.0.0.138:111 10.0.0.140:111 10.0.0.96:4756 =>nat disable addr 172.16.0.5 =>nat list Indx Prot Inside-addr:Port Outside-addr:Port Foreign-addr:Port Flgs Expir State Control 10.0.0.138:138 10.0.0.140:138 10.0.0.20:138 10.0.0.138:137 10.0.0.140:137 10.0.0.254:137 10.0.0.138:7938 10.0.0.140:7938 10.0.0.96:4756 10.0.0.138:513 10.0.0.140:513 10.0.0.109:513 10.0.0.138:111 10.0.0.140:111...
  • Page 211: Nat Enable

    Enable NAPT on a SpeedTouch IP address. SYNTAX: nat enable addr = <ip-address> [type = <{none|pat}>] addr The SpeedTouch IP address for which NAPT must be enabled. REQUIRED [type] Enable port translation (pat) or not (none). OPTIONAL EXAMPLE: =>ip aplist 1 eth0...
  • Page 212: Nat Flush

    NAT Commands nat flush Flush complete NAPT configuration. The flush command does not impact previously saved configurations. Note SYNTAX: nat flush RELATED COMMANDS: nat create Create a static NAPT entry. nat delete Delete a static NAPT entry. nat disable Disable NAPT on one of the SpeedTouch IP addresses.
  • Page 213: Nat List

    [addr] The SpeedTouch IP address for which the NAPT connection OPTIONAL database must be shown. If the parameter is not specified, the NAPT connection Note database for all IP addresses is shown. EXAMPLE INPUT/OUTPUT: =>nat list Indx Prot Inside-addr:Port Outside-addr:Port Foreign-addr:Port Flgs Expir State Control 10.0.0.138:80...
  • Page 214: Nat Unbind

    = <{<supported TCP/UDP port name>|<number>}> application The name of a NAPT application helper. REQUIRED The name must be spelled exactly as listed in the application list (:nat applist). port The TCP/UDP port this application handler is working on. REQUIRED Select one of the supported TCP/UDP port names (See “...
  • Page 215: Phonebook Commands

    Phonebook Commands Phonebook Commands Contents This chapter covers the following comands: Topic Page phonebook add phonebook autolist phonebook delete phonebook flush phonebook list E-SIT-CTC-20021203-0003 v1.0...
  • Page 216: Phonebook Add

    The ATM address for this destination. REQUIRED It is composed of a Virtual Path Identifier (VPI) and a Virtual Channel Identifier (VCI) identifying ATM virtual channels. In most cases the values are provided by the Service Provider. Accepted VPI: a number between 0 and 15 Accepted VCI: a number between 0 and 511.
  • Page 217: Phonebook Delete

    8.82 PVC_Test pppoa 8.68 => The usb_port phonebook entry is only applicable in case of a SpeedTouch 530 variant. Do not change this Note phonebook entry in any way, or delete it from the phonebook! RELATED COMMANDS: phonebook delete Remove a phonebook entry.
  • Page 218: Phonebook Autolist

    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 Show current phonebook. E-SIT-CTC-20021203-0003 v1.0...
  • Page 219: Phonebook Delete

    The name of the phonebook entry to delete. REQUIRED Only applicable for phonebook entries that are not used, i.e. not config- ured for any packet service. Execute phonebook list to check whether the entry is used (Use=1) or not (Use=0).
  • Page 220: Phonebook Flush

    8.38 CIPPVC3 ipoa 8.82 PVC_Test pppoa 8.68 =>phonebook flush =>phonebook list Name Type Address => In case of a SpeedTouch 530 variant, flushing the Phonebook may cause the device te become unaccesible Note from its USB interface. E-SIT-CTC-20021203-0003 v1.0...
  • Page 221: Phonebook List

    8.82 PVC_Test pppoa 8.68 => The usb_port phonebook entry is only applicable in case of a SpeedTouch 530 variant. Do not change this Note phonebook entry in any way, or delete it from the phonebook! RELATED COMMANDS: phonebook add Add a phonebook entry.
  • Page 222 Phonebook Commands E-SIT-CTC-20021203-0003 v1.0...
  • Page 223: Ppp Commands

    PPP Commands PPP Commands Contents This chapter covers the following commands: Topic Page ppp flush ppp ifadd ppp ifattach ppp ifconfig ppp ifdelete ppp ifdetach ppp iflist ppp ifscan ppp rtadd ppp rtdelete E-SIT-CTC-20021203-0003 v1.0...
  • Page 224: Ppp Flush

    PPP Commands ppp flush Flush complete Routed PPP over ATM (PPPoA) and Routed PPP over Ethernet (PPPoE) configuration. The flush command does not impact previously saved configurations. Note SYNTAX: ppp flush EXAMPLE: =>ppp iflist PPP1: dest : PPP1 Retry: default encaps...
  • Page 225: Ppp Ifadd

    [intf] The name for the new Routed PPP(oA/oE) interface. OPTIONAL If not specified, the destination parameter must be specified. In this case the name of the destination will double as interface name. [dest] The destination for the new Routed PPP(oA/oE) interface.
  • Page 226: Ppp Ifdetach

    PPPOA trans addr = pat mru = 1500 route = 0.0.0.0/0 - 0.0.0.0/0 (metric 0) user name = guest password = ******** admin state = down oper state = down link state = not-connected LCP: state = initial retransm = 10 term.
  • Page 227: Ppp Ifattach

    PPP Commands ppp ifattach Attach (i.e. connect) a Routed PPP(oA/oE) interface. SYNTAX: ppp ifattach intf = <intfname> intf The name of the Routed PPP(oA/oE) interface to attach. REQUIRED EXAMPLE: =>ppp iflist PPP1: dest : PPP1 Retry: 10 default encaps mode = IP Routing...
  • Page 228 PPP Commands RELATED COMMANDS: ppp ifadd Create a Routed PPP(oA/oE) interface. ppp ifconfig Configure a Routed PPP(oA/oE) interface. ppp ifdelete Delete a Routed PPP(oA/oE) interface. ppp ifdetach Detach a Routed PPP(oA/oE) interface. ppp iflist Show current Routed PPP(oA/oE) configuration. E-SIT-CTC-20021203-0003 v1.0...
  • Page 229: Ppp Ifconfig

    PPP Commands ppp ifconfig Configure a Routed PPP(oA/oE) interface. The interface to be configured may not be connected at the time of configuration. Execute ppp ifdetach Note prior to executing the ppp ifconfig command. SYNTAX: ppp ifconfig intf = <intfname>...
  • Page 230 The Service Name for a Routed PPPoE connection. OPTIONAL This parameter is applicable only for Routed PPPoE PPP interfaces (proto=pppoe). Execute the ppp ifscan command to see the available service names, if any. [encaps] The type of encapsulation to be used for this Routed PPP(oA/oE) inter- OPTIONAL face.
  • Page 231 Represents the intermediate interval between two retries to establish the connection on ATM level.. [passive] Put the link in listening state in case LCP times out (on) or not (off). OPTIONAL This parameter allows to determine whether the link should be left open to wait for incoming messages from the remote side after 10 unsuccessful tries to establish the connection or not.
  • Page 232 The remote IP address of the peer-to-peer connection. OPTIONAL Specifying a remote IP address forces the remote side of the PPP link (if it allows to) to accept this IP address as its PPP session IP address. If not specified, the SpeedTouch will accept any IP address.
  • Page 233 PPPOA trans addr = pat mru = 1492 route = 0.0.0.0/0 - 0.0.0.0/0 (metric 0) user name = My_Connection@MY_ISP password = ******** admin state = down oper state = down link state = not-connected LCP: state = initial retransm = 10 term.
  • Page 234: Ppp Ifdelete

    PPP Commands ppp ifdelete Delete a Routed PPP(oA/oE) interface. SYNTAX: ppp ifdelete intf = <intfname> intf The name of the Routed PPP(oA/oE) interface to delete. EXAMPLE: =>ppp iflist PPP1: dest : PPP1 Retry: 10 default encaps VC-MUX mode = IP Routing...
  • Page 235 PPP Commands RELATED COMMANDS: ppp ifadd Create a Routed PPP(oA/oE) interface. ppp ifattach Attach a Routed PPP(oA/oE) interface. ppp ifconfig Configure a Routed PPP(oA/oE) interface. ppp ifdetach Detach a Routed PPP(oA/oE) interface. ppp iflist Show current Routed PPP(oA/oE) configuration. E-SIT-CTC-20021203-0003 v1.0...
  • Page 236: Ppp Ifdetach

    PPP Commands ppp ifdetach Detach a Routed PPP(oA/oE) interface. SYNTAX: ppp ifdetach intf = <intfname> intf The name of the Routed PPP(oA/oE) interface. REQUIRED EXAMPLE: =>ppp iflist PPP1: dest : PPP1 Retry: 10 default encaps VC-MUX mode = IP Routing...
  • Page 237: Ppp Iflist

    PPP Commands ppp iflist Show current configuration of all or a specified Routed PPP(oA/oE) interface(s). SYNTAX: ppp iflist [intf = <intfname>] intf The name of the Routed PPP(oA/oE) interface. OPTIONAL If this parameter is not specified, all Routed PPP(oA/oE) interfaces are shown.
  • Page 238: Ppp Ifscan

    PPP Commands ppp ifscan Scan a Routed PPPoE interface ( proto=pppoe) for available Access Concentrator names and Service Names. Execute the ppp ifdetach command for this interface before performing a scan on it. Note SYNTAX: ppp ifscan intf = <intfname>...
  • Page 239: Ppp Rtadd

    Automatically add a route configuration to the routing table in case the specified Routed PPP(oA/oE) 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.
  • Page 240 Depending on the source netmask: Everybody is allowed to use this Routed PPP(oA/oE) connection • (dstmsk=0) Only members of the same subnet as the host which opened the • Routed PPP(oA/oE) connection are allowed to use the Routed PPP(oA/oE) connection (dstmsk=1) The actual destination mask will be the netmask applicable for the IP •...
  • Page 241: Ppp Rtdelete

    PPP Commands ppp rtdelete Delete the route specification for a Routed PPP(oA/oE) link. Execute the ppp ifdetach command for this interface prior to deleting route configurations. Note SYNTAX: ppp rtdelete intf = <intfname> intf The Routed PPP(oA/oE) interface name for which to delete the route REQUIRED settings.
  • Page 242 PPP Commands E-SIT-CTC-20021203-0003 v1.0...
  • Page 243: Pptp Commands

    PPTP Commands PPTP Commands Contents This chapter covers the following commands: Topic Page pptp flush pptp list pptp profadd pptp profdelete pptp proflist E-SIT-CTC-20021203-0003 v1.0...
  • Page 244: Pptp Flush

    PPTP Commands pptp flush Flush complete Relayed PPPoA, often referred to as PPPoA/Point-to-Point Tunneling Protocol (PPTP) configuration. The flush command does not impact previously saved configurations. Note SYNTAX: pptp flush EXAMPLE: =>pptp profadd name=Relay_PPP1 encaps=nlpid ac=always =>pptp proflist Profile Encaps...
  • Page 245: Pptp List

    PPTP Commands pptp list Show current Relayed PPPoA configuration. SYNTAX: pptp list EXAMPLE INPUT/OUTPUT: =>pptp list Dialstr Destination Encaps State User DIALUP_PPP3 default vcmux never CONNECTED (10.0.0.2) => E-SIT-CTC-20021203-0003 v1.0...
  • Page 246: Pptp Profadd

    Relayed PPPoA interfaces using this Relayed PPPoA profile. Before relaying the encapsulated PPP frames over the PPPoA link, make sure that the address and control field (0xFF03) is always in front of the frames (always), make sure the address and control field will never be found in front of the frames (never) or do not change the frames arriving via the PPTP tunnel (keep).
  • Page 247: Pptp Profdelete

    PPTP Commands pptp profdelete Delete a Relayed PPPoA profile. SYNTAX: pptp profdelete name <string> name The name for the Relayed PPPoA profile. REQUIRED EXAMPLE: =>pptp proflist Profile Encaps Relay_PPP1 default nlpid always PPTPLink default vcmux never =>pptp profdelete name=PPTPLink =>pptp proflist...
  • Page 248: Pptp Proflist

    PPTP Commands pptp proflist Show all current Relayed PPPoA profiles. SYNTAX: pptp proflist EXAMPLE: =>pptp proflist Profile Encaps Relay_PPP1 default nlpid always PPTPLink default vcmux never => RELATED COMMANDS: pptp profadd Define a new Relayed PPPoA profile. pptp profdelete Delete a Relayed PPPoA profile.
  • Page 249: Qosbook Commands

    QoSBook Commands QoSBook Commands Contents This chapter covers the following commands: Topic Page qosbook add qosbook delete qosbook flush qosbook list E-SIT-CTC-20021203-0003 v1.0...
  • Page 250: Qosbook Add

    Only applicable in case class=vbr-nrt. [tx_maxburst] A number between 0 and 2147483600 (bytes per second). OPTIONAL Indicates the maximum burst size in the transmit (upstream) direc- tion. Only applicable in case class=vbr-nrt. [rx_peakrate] A number between 0 and 2147483 (Kilobits per second).
  • Page 251: Qosbook Delete

    In the example above a burst size of 100 bytes is specified (tx_maxburst=100). The SpeedTouch will round up the burst size to the closest matching multiple of 48 bytes, as can be seen when displaying the profile via :qosbook list (burst=144).
  • Page 252: Qosbook Delete

    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 OPTIONAL force the deletion (no). By default forced deletion is disabled. EXAMPLE: =>qosbook list...
  • Page 253: Qosbook Flush

    QoSBook Commands qosbook flush Flush complete Quality of Service book. The flush command does not impact previously saved configurations. Note SYNTAX: qosbook flush RELATED COMMANDS: qosbook load Load saved or default QoS book. qosbook save Save current QoS book. E-SIT-CTC-20021203-0003 v1.0...
  • Page 254: Qosbook List

    (Kbits) (bytes) (Kbits) (Kbits) (bytes) default 24 Linerate 0 Linerate 0 PPP3 6144 Linerate 0 =>qosbook add name voice class cbr tx_peakrate 64 rx_peakrate 64 =>qosbook list Name Ref Type TX peek sust burst RX peek sust burst (Kbits) (Kbits)
  • Page 255: Software Commands

    Software Commands Software Commands Contents This chapter covers the following commands: Topic Page software cleanup software deletepassive software duplicate software setpassive software switch software version E-SIT-CTC-20021203-0003 v1.0...
  • Page 256: Software Cleanup

    Software Commands software cleanup Remove all unused files from the passive software subdirectory. This command frees the passive software subdirectory from corrupted software files and configuration files. Software marked as passive software is not deleted. SYNTAX: software cleanup RELATED COMMANDS: software deletepassive Delete the passive software.
  • Page 257: Software Deletepassive

    =>Software deletepassive =>Software version Active Sascha.abc Passive => RELATED COMMANDS: software cleanup Remove all unused files from the passive software subdirectory. software duplicate Duplicate the active software as passive software. software setpassive Mark a file as passive software version. E-SIT-CTC-20021203-0003 v1.0...
  • Page 258: Software Duplicate

    Sascha.abc Passive =>Software duplicate =>Software version Active Sascha.abc Passive Sascha.abc => RELATED COMMANDS: software cleanup Remove all unused files from the passive software subdirectory. software deletepassive Delete passive software. software setpassive Mark a file as passive software version. E-SIT-CTC-20021203-0003 v1.0...
  • Page 259: Software Setpassive

    Software Commands software setpassive Mark a file as passive software version. Only correctly uploaded software, valid for the SpeedTouch , can be marked as passive software., SYNTAX: software setpassive file = <string> file The filename (without directory path) of the software package.
  • Page 260: Software Switch

    Switch active and passive versions and reboot the SpeedTouch Because rebooting implies a flush of all non-saved configurations it is highly recommended to save the current configu- ration if needed, e.g. via saveall or :config save before executing a software switch.
  • Page 261: Software Version

    Software Commands software version Show active and passive software versions. SYNTAX: software version EXAMPLE: =>Software version Active Sascha.xyz Passive Sascha.abc => RELATED COMMANDS: software switch Switch active and passive software versions and reboot the SpeedTouch Note E-SIT-CTC-20021203-0003 v1.0...
  • Page 262 Software Commands E-SIT-CTC-20021203-0003 v1.0...
  • Page 263: System Commands

    System Commands System Commands Contents This chapter covers the following commands: Topic Page system clearpassword system config system flush system reboot system reset system setpassword E-SIT-CTC-20021203-0003 v1.0...
  • Page 264: System Clearpassword

    To avoid unrestricted and unauthorized access to the SpeedTouch , it is highly recommended to make sure Note 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...
  • Page 265: System Config

    System Commands system config Show/set SpeedTouch system configuration parameters. For a good operation of Universal Plug and Play (UPnP) and the discovery mechanism, it is highly recom- Note mended not to change the System config settings. SYNTAX: system config [upnp = <{disabled|enabled}>] [mdap = <{disabled|enabled}>]...
  • Page 266: System Flush

    System Commands system flush Flush current SpeedTouch system configuration, i.e. the System password and the system config settings (dcache excluded). To avoid unrestricted and unauthorized access to the SpeedTouch , it is highly recommended to make sure Note it is protected by a SpeedTouch system password (via :system setpassword) and to change the password on a regular basis.
  • Page 267: System Reboot

    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) ..E-SIT-CTC-20021203-0003 v1.0...
  • Page 268: System Reset

    =>system reset --------------- !! WARNING !! --------------- The SpeedTouch(TM)610 DSL Router will be reset to factory defaults clearing all user and ISP speci fic settings. Connectivity with the ISP network might be lost. Do you want to proceed ? no/yes = no =>...
  • Page 269: System Setpassword

    To avoid unrestricted and unauthorized access to the SpeedTouch , it is highly recommended to make sure Note it is protected by a SpeedTouch system password (via :system setpassword) and to change the password on a regular basis SYNTAX: system setpassword password = {<string>|$_BOARD_SERIAL_NBR}...
  • Page 270 System Commands E-SIT-CTC-20021203-0003 v1.0...
  • Page 271: Td Commands

    TD Commands TD Commands Contents This chapter covers the following commands: Topic Page td call E-SIT-CTC-20021203-0003 v1.0...
  • Page 272: Td Call

    TD Commands td call Call a ‘Trace & Debug‘ command. For qualified personnel only. Note SYNTAX: td call cmd = <string> Quoted 'Trace & Debug' command string. REQUIRED E-SIT-CTC-20021203-0003 v1.0...
  • Page 273: Upnp Commands

    UPnP Commands UPnP Commands Contents This chapter covers the following commands: Topic Page upnp config upnp flush upnp list E-SIT-CTC-20021203-0003 v1.0...
  • Page 274: Upnp Config

    Internet Gateway Device (IGD) on the network. Setting this parameter to a low value will increase the number of packets sent over time on the network, but will make the state of the device more up to date.
  • Page 275: Upnp Flush

    UPnP Commands upnp flush Flushes the UPnP configuration (i.e. reset to default configuration). SYNTAX: upnp flush EXAMPLE: =>upnp config ssdp max-age: 4200 =>upnp flush =>upnp config ssdp max-age: 1800 RELATED COMMANDS: upnp config Configure upnp parameter(s). upnp list List all registered UPnP devices.
  • Page 276: Upnp List

    This command lists the devices and services currently offered by the SpeedTouch . E.g. use this command to check whether a PPP connection is properly configured and thus advertised as a PPP connection. SYNTAX: upnp list [verbose = <number{0-2}>] verbose Verbose level.
  • Page 277: Wireless Commands

    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 wepconfig wireless aclconfig wireless acllist wireless aclflush wireless aclentry wireless ifconfig...
  • Page 278: Wireless Wepconfig

    [key = <password>] [encryption = <{off|on}>] The WEP key. OPTIONAL In case of 64 bit encryption, the 40-bits WEPkey must consist of 10 hexadecimal digits. In case of 128 bit encryption, the 104-bits WEPkey must consist of 26 hexadecimal digits.
  • Page 279: Wireless Aclconfig

    • 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. Unlock Every wireless client is unconditionally added to the ACL.
  • Page 280: 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 aclflush Flushes the ACL. wireless aclentry Adds or deletes an entry in the ACL. E-SIT-CTC-20021203-0003 v1.0...
  • Page 281: Wireless Aclflush

    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 acllist Lists the ACL. wireless aclentry Adds or deletes an entry in the ACL. E-SIT-CTC-20021203-0003 v1.0...
  • Page 282: Wireless Aclentry

    Wireless Commands wireless aclentry Adds or deletes an entry in the ACL. SYNTAX: wireless aclentry hwaddr = <hardware-address> action = <{allow|deny|delete}> [name = <quoted string>] hwaddr The Ethernet MAC address of the ACL entry REQUIRED action The action to be performed on ACL entry.
  • Page 283: Wireless Ifconfig

    OPTIONAL It represents the value of the RTS threshold. Setting this parameter to a small value causes RTS messages to be send more often, consuming more of the available bandwidth, there- fore reducing the apparent throughput of other network packets.
  • Page 284 Wireless Commands RELATED COMMANDS: wireless status Shows the status of the wireless interface. wireless scan Scans for other APs in the area. wireless flush Flushes the wireless parameters. E-SIT-CTC-20021203-0003 v1.0...
  • Page 285: 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.
  • Page 286: Wireless Counters

    Wireless Commands wireless counters Displays the value of the SpeedTouch 570 WLAN counters. SYNTAX: wireless counters [clear <{no|yes}>] clear Clear the wireless counters OPTIONAL EXAMPLE: =>wireless counters Tx Frames Count : 497 Rx Frames Count Station Not Allowed Count Station Unknown Count...
  • Page 287: Wireless Scan

    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...
  • Page 288: Wireless Flush

    Wireless Commands wireless flush Flush the SpeedTouch 570 WLAN parameters, i.e. reset to the factory defaults. SYNTAX: wireless flush EXAMPLE: =>wireless ifconfig Wireless SSID : SpeedTouch3A6115 Accept any SSID : yes Communication channel : 3 (selected) RTS Threshold : 1000...
  • Page 289: Abbreviations

    Abbreviations Abbreviations The table below lists all the abbreviations used in the CLI Guide. Abbreviation Description AAL5 ATM Adaption Layer 5 Access Control List ADSL Asymmetric Digital Subscriber Line Authentication Header Address Resolution Protocol Asynchronous Transfer Mode ATMF ATM Forum...
  • Page 290 Light-weight Directory Access Protocol Logical IP Subnet Logical Link Control Medium Access Control Message Digest 5 MAC Encapsulated Routing NAPT Network Address and Port Translation Network Address Translation Name Binding Protocol NLPID Network Layer Protocol IDentifiers NNTP Network News Transfer Protocol...
  • Page 291 Permanent Virtual Channel Routing Information Protocol RTMP RouTing Maintenance Protocol RTSP Real Time Stream Control Protocol Security Associations SHDSL Symmetric High speed Digital Subscriber Line SMTP Simple Mail Transfer Protocol SNAP Sub Network Access Protocol SNMP Simple Network Management Protocol SNPP...
  • Page 292 Abbreviations Abbreviation Description Wide Area Network WAN Connection Device Wired Equivalent Privacy WLAN Wireless LAN World Wide Web Zone Information System E-SIT-CTC-20021203-0003 v1.0...
  • Page 293: Supported Key Names

    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. Protocol name Number Description...
  • Page 294: Supported Tcp/Udp Port Names

    Supported Key Names Supported TCP/UDP Port Names For more information on the listed TCP/UDP port assignments, see RFC1340 or www.iana.org. Port name Number Description echo Echo discard Discard systat Active Users daytime Daytime qotd Quote of the Day chargen Character Generator...
  • Page 295 ISAKMP exec Remote process execution biff Used by mail system to notify users of new mail received login Remote login a la telnet Maintains data bases showing who's logged in to machines on a local net and the load average of the machine...
  • Page 296 Syslog printer Spooler talk Like Tenex link, but across machine ntalk NTalk utime UNIX Time Local routing process (on site); uses variant of Xerox NS Routing Information Protocol (RIP) timed Timeserver netwall For emergency broadcasts uucp uucpd uucp-rlogin uucpd remote login...
  • Page 297: Supported Icmp Type Names

    Supported Key Names Supported ICMP Type Names For more information on the listed ICMP type names, see RFC1340 or www.iana.org. ICMP Type name Number Description echo-reply Echo Reply destination-unreachable Destination Unreachable source-quench Source Quench redirect Redirect echo-request Echo router-advertisement Router Advertisement...
  • Page 298 Supported Key Names E-SIT-CTC-20021203-0003 v1.0...
  • Page 300 SERIES Built for excellence...

This manual is also suitable for:

Speedtouch 530Speedtouch 570i

Table of Contents