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 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...
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.
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.
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.
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) •...
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).
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.
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.
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...
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}>]...
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:...
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...
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 •...
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...
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 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 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...
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.
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...
= <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...
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.
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>...
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...
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.
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...
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.
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...
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.
[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...
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.
[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...
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...
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...
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 % =>...
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.
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.
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...
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...
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...
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...
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...
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...
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).
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.
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...
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).
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...
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.
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...
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...
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...
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...
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...
[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...
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.
= <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...
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...
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...
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...
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).
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.
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...
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 *.*.*.*...
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...
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...
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).
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]...
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.
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%) =>...
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...
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...
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...
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.
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...
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...
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...
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 %...
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.
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...
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...
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...
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...
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 “_”...
= <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...
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...
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.
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...
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...
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:...
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 •...
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.
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...
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 =>...
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...
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...
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...
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.
[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 |...
=> 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...
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...
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...
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...
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...
= <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...
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...
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...
[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...
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.
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.
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...
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...
[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...
[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.
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...
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.
[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.
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.
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...
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...
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...
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.
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...
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.
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...
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...
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...
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.
= <{<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 “...
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...
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.
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.
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...
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...
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.
[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...
= <{<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 “...
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.
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.
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...
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).
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...
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.
[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.
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.
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.
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.
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>...
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 •...
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.
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...
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).
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).
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).
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...
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...
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.
=>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...
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...
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.
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.
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...
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...
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...
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}>]...
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.
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...
=>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 =>...
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...
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.
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.
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...
[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.
• 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.
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...
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...
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.
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...
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 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...
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...
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...
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...
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...
Need help?
Do you have a question about the SPEEDTOUCH 510I - REFERENCE GUIDE RELEASE 4.0 and is the answer not in the manual?
Questions and answers