Operation Manual

ManualsBrandsThomson ManualsADSL modem510 530 Cli Refence Guide Release R4.2.7

SpeedTouch™510/530

Multi-User ADSL Gateways

CLI Reference Guide

Release R4.2.7

500

SERIES

Summary of content (422 pages)

PAGE 1
SpeedTouch™510/530 Multi-User ADSL Gateways CLI Reference Guide Release R4.2.
PAGE 2
PAGE 3
SpeedTouch™ 510/530 CLI Reference Guide Release R4.2.
PAGE 4
Status v1.0 Reference E-DOC-CTC-20040210-0030 Short Title CLI ST510(i)/530(i) R4.2.7 Copyright © 2004 THOMSON Telecom. All rights reserved. Passing on, and copying of this document, use and communication of its contents is not permitted without written authorization from THOMSON Telecom. 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 Telecom.
PAGE 5
Content About this Document .................................................................................... 15 CLI Navigation ............................................................................................... 17 Accessing the Command Line Interface .................................................................................................................... 18 Basic Navigation and Manipulation............................................................................................
PAGE 6
Bridge Commands ......................................................................................... 49 bridge config .....................................................................................................................................................................50 bridge flush .......................................................................................................................................................................51 bridge ifadd .........................
PAGE 7
DHCP Commands ......................................................................................... 83 dhcp client clear ..............................................................................................................................................................85 dhcp client config ............................................................................................................................................................86 dhcp client flush...............................
PAGE 8
DNS Commands .......................................................................................... 125 dns add ............................................................................................................................................................................126 dns clear ..........................................................................................................................................................................127 dns clrstats........................
PAGE 9
ETHoA Commands ..................................................................................... 155 ethoa flush.......................................................................................................................................................................156 ethoa ifadd ......................................................................................................................................................................157 ethoa ifattach.............................
PAGE 10
IP Commands ............................................................................................... 187 ip apadd ...........................................................................................................................................................................188 ip apdelete.......................................................................................................................................................................190 ip aplist.........................
PAGE 11
IPQoS Commands ....................................................................................... 229 ipqos config.....................................................................................................................................................................230 ipqos list ..........................................................................................................................................................................232 ipqos queue clear .....................
PAGE 12
NAT Commands .......................................................................................... 265 nat applist........................................................................................................................................................................266 nat bind............................................................................................................................................................................267 nat bindlist.........................
PAGE 13
PPPoE Commands....................................................................................... 309 pppoe flush .....................................................................................................................................................................310 pppoe ifadd .....................................................................................................................................................................311 pppoe ifattach..............................
PAGE 14
SNMP Commands........................................................................................ 353 snmp config.....................................................................................................................................................................354 snmp get..........................................................................................................................................................................355 snmp getNext ...............................
PAGE 15
UPnP Commands......................................................................................... 387 upnp config .....................................................................................................................................................................388 upnp flush........................................................................................................................................................................390 upnp list ................................
PAGE 16
14 E-DOC-CTC-20040210-0030 v1.
PAGE 17
About this Document About this Document Introduction Welcome to the SpeedTouch™ Command Line Interface (CLI) Reference Guide! For the Service Provider, this Reference Guide aims to be a concise and practical document for creating a customized Service Template file, based on the SpeedTouch™ CLI command set, to be used by the end-user to configure the SpeedTouch™ and PC(s).
PAGE 18
About this Document Trademarks The following trademarks are used in this document: • SpeedTouch™ is a trademark of THOMSON Telecom. • Netscape and Netscape Navigator are registered trademarks of Netscape Communications Corporation. • Windows and Internet Explorer are trademarks of Microsoft Corporation. • Apple and MacOS are registered trademarks of Apple Computer Inc. • UNIX is a registered trademark of UNIX System Laboratories, Inc. • Ethernet is a trademark of Xerox Corporation.
PAGE 19
CLI Navigation CLI Navigation Introduction This chapter familiarizes the user with the SpeedTouch™ CLI. It describes general manipulations: • to navigate through the CLI • to perform some operations on the CLI.
PAGE 20
CLI Navigation Accessing the Command Line Interface Users can access the Command Line Interface via a Telnet session. This requires that TCP/IP connectivity exists between the host from which the Telnet session is opened and the SpeedTouch™. .Proceed as follows to open a Telnet session: 1 Open a Command Prompt window, e.g. by clicking Start > All Programs > Accessories > Command Prompt. 2 At the prompt, type telnet followed by the IP address of the SpeedTouch™ (default is 10.0.0.138).
PAGE 21
CLI Navigation Basic Navigation and Manipulation Manipulation commands are commands that manipulate operations on the command line, for example changing the command group, go to the beginning of the command line, go to the end of the command line, etc. Command group navigation From top level, you can change to a command group by executing the name of the desired command group. To obtain a list of all available command groups, execute help from the top level.
PAGE 22
CLI Navigation The Help Command Execute help or ? from top level to list all available commands and command groups for the SpeedTouch™. Example for the SpeedTouch™510: =>help Following commands are available : help menu ? exit .. saveall : : : : : : Displays this help information Displays menu Displays this help information Exits this shell. Exits group selection. Saves current configuration.
PAGE 23
CLI Navigation As both help and ? have the exact same functionality in the SpeedTouch™ CLI, the help command may always be equally replaced by the ? command. Executing e.g. help firewall from top level gives the same result as executing help from the firewall command group selection. Example: =>firewall help Following commands are available : assign unassign list flush tron troff : : : : : : Assign a chain to an entry point. Clear a specific hook Shows a list of all the hooks with the chains attached.
PAGE 24
CLI Navigation Command Line Navigation • Press CTRL+A to go to the beginning of the command line. • Press CTRL+L to go to the end of the command line. Breaking off Commands You can break off a command by pressing CTRL+G. 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 25
CLI Navigation Command Line Interface Top Level Structure The table below shows the available command groups for the different SpeedTouch™ variants: Command group Available? adsl Only for the SpeedTouch™510 ADSL/POTS and the SpeedTouch™510i ADSL/ISDN variants. atm Yes. autopvc Yes. bridge Yes. cip Yes config Yes. dhcp Yes. dns Yes. env Yes. eth Yes. ethoa Yes. firewall Yes. ip Yes. ipoa Yes. ipqos Yes. label Yes. language Yes. nat Yes. phonebook Yes. pppoa Yes.
PAGE 26
CLI Navigation Command Line Interface Commands Command Execution All CLI commands are commands that operate on, or configure, the SpeedTouch™ settings. The CLI commands can be executed: • from top level, preceded by the name of the command group from which the command should be executed. E. g. firewall list.
PAGE 27
CLI Navigation Menu-driven CLI Navigation Introduction To improve the user-friendliness of the SpeedTouch™ CLI, the CLI features a menu-driven interface. The semi-graphical menu offers an attractive and easy-to-use configuration environment for the CLI. Calling the menu To call the menu-driven interface, type menu at the CLI prompt. Example (for the SpeedTouch™510): Leaving the menu To leave the menu-driven interface, use the TAB key to go to the Cancel field and press ENTER.
PAGE 28
CLI Navigation 2 Press ENTER to select a command group. The figure below shows the menu after the phonebook command group has been selected: 3 Browse through the CLI commands with the ARROW keys or select .. to go back up one level: 4 Press ENTER to select the command.
PAGE 29
CLI Navigation 3 Fill in the parameter value and press ENTER: 4 Use the ARROW keys to scroll to the next parameter: 5 When all the necessary parameters have been entered, use the TAB key to go to the OK field and press ENTER. Note Do not forget to save your changes by executing saveall (from any CLI prompt). Preset parameter values In case preset values are provided for a parameter, they are shown at the bottom of the menu.
PAGE 30
CLI Navigation Service Template Files and the CLI Service Template Files The Service Template files, used by the Setup wizard, or directly uploaded via the SpeedTouch™ web pages, consist of a set of CLI commands. Only CLI commands, which are part of the SpeedTouch™ CLI command set, may be used in the .ini and .def files. For readability, Service Template files are partitioned in paragraphs. These paragraphs reflect a CLI command group selection in the SpeedTouch™ CLI.
PAGE 31
CLI Navigation [.ini] paragraphs Available SpeedTouch™ CLI commands [pppoa.ini] The pppoa CLI command group [pppoe.ini] The pppoe CLI command group [pppoerelay.ini] The pppoe relay CLI command subgroup [pptp.ini] The pptp CLI command group [qos.ini] The qosbook CLI command group [script.ini] The script CLI command group [snmp.ini] The snmp CLI command group [switch.ini] The switch CLI command group (only for SpeedTouch™ devices with a four port switch). [system.
PAGE 32
CLI Navigation Direct FTP Access The SpeedTouch™ File System The SpeedTouch™ permanent storage, further referred to as 'file system', exists of nonvolatile memory responsible for storing, retrieving and maintaining the SpeedTouch™ software image(s), Service Template files and optionally default settings files. The file system of the SpeedTouch™ is accessible via the File Transfer Protocol (FTP) transport protocol.
PAGE 33
CLI Navigation FTP File Transfer To allow correct file transfers, set the transfer mode to “binary”. Note Turn on the hashing option to see the progression of the file transfer. Example: /home/doejohn{1}$ftp 10.0.0.138 Connected to 10.0.0.138 220 Inactivity timer = 120 seconds. Use 'site idle ' to change. Name (10.0.0.138:doejohn): 331 SpeedTouch™ (00-90-D0-01-02-03) User 'doejohn' OK. Password required.
PAGE 34
CLI Navigation 32 E-DOC-CTC-20040210-0030 v1.
PAGE 35
ADSL Commands ADSL Commands Contents This chapter covers the following commands: Topic Page adsl config 34 adsl info 35 E-DOC-CTC-20040210-0030 v1.
PAGE 36
ADSL Commands adsl config Show/set the Asymmetric Digital Subscriber Line (ADSL) configuration. Although the command is the same for both SpeedTouch™ ADSL/POTS and SpeedTouch™ ADSL/ISDN variants, the command features specific parameter values per variant: SYNTAX FOR ADSL/Plain Old Telephone Service (POTS) variants: adsl config [opermode = <{ansi|g.dmt_annex_a|g.
PAGE 37
ADSL Commands adsl info Show ADSL statistics and information about the SpeedTouch™ DSL line status. Although the same command is used for both SpeedTouch™ ADSL/POTS and SpeedTouch™ ADSL/ISDN variants, the command features specific output parameters and counters per variant. SYNTAX: adsl info EXAMPLE (for a SpeedTouch™ ADSL/POTS variant): =>adsl info Modemstate Operation Mode Channel Mode Number of resets : : : : up G.
PAGE 38
ADSL Commands .. Continued output ..
PAGE 39
ATM Commands ATM Commands Contents This chapter covers the following commands: Topic Page atm oam ccconfig 38 atm oam cclist 39 atm oam ccsend 40 atm oam config 41 atm oam mode 42 atm oam ping 43 atm oam status 44 E-DOC-CTC-20040210-0030 v1.
PAGE 40
ATM Commands atm oam ccconfig Configure Operation and Maintenance (OAM) Continuity Check (CC) on the connection. SYNTAX: atm oam ccconfig port = <{dsl0|dsl1|atm2|atm3|aal5|atm5} or number> vpi = [vci = ] [transmit = <{disabled|enabled}>] [receive = <{disabled|enabled}>] [auto = <{disabled|enabled}>] [span = <{segment|end2end}>] where: port REQUIRED The ATM port number. Choose between: • DSL0 • DSL1 • ATM2 • ATM3 • AAL5 • ATM5.
PAGE 41
ATM Commands atm oam cclist Show current OAM CC configuration. SYNTAX: atm oam cclist EXAMPLE (default configuration): =>atm oam cclist PORT = 0 VPI = 15 VCI = 64 End2End Mode = Auto Segment Mode = Auto PORT = 0 VPI = 15 VCI = 16 End2End Mode = Auto Segment Mode = Auto PORT = 0 VPI = 0 VCI = 16 End2End Mode = Auto Segment Mode = Auto => RELATED COMMANDS: atm oam ccconfig Configure CC on the connection. atm oam ccsend Send CC activate/deactivate to connection. E-DOC-CTC-20040210-0030 v1.
PAGE 42
ATM Commands atm oam ccsend Send CC activate/deactivate to connection. SYNTAX: atm oam ccsend port = <{dsl0|dsl1|atm2|atm3|aal5|atm5} or number> vpi = [vci = ] [span = <{segment|end2end}>] [action = <{activate|deactivate}>] [direction = <{source|sink|both}>] where: port REQUIRED The ATM port number. Choose between: • DSL0 • DSL1 • ATM2 • ATM3 • AAL5 • ATM5. Or specify a port number (dsl0 has port number 0, ..., atm5 has port number 5).
PAGE 43
ATM Commands atm oam config Configure OAM cell settings. SYNTAX: atm oam config [clp = ] [loopbackid = ] where: clp loopbackid The CLP bit value of the OAM cells. Choose between: • 0 • 1. The loopback id (hexadecimal string) for processing of segment loopback cells. OPTIONAL OPTIONAL The default is 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a. E-DOC-CTC-20040210-0030 v1.
PAGE 44
ATM Commands atm oam mode Configure the OAM data blocking mode. SYNTAX: atm oam mode port = <{dsl0|dsl1|atm2|atm3|aal5|atm5} or number> blocking = <{disabled|enabled}> where: port REQUIRED The port for which OAM blocking is configured. Choose between: • DSL0 • DSL1 • ATM2 • ATM3 • AAL5 • ATM5 Or specify a port number (dsl0 has port number 0, ..., atm5 has port number 5). blocking Enable or disable the OAM data blocking mode on this port. REQUIRED The default is enabled.
PAGE 45
ATM Commands atm oam ping Sends ATM loopback cells. SYNTAX: atm oam ping dest = [count = ] [interval = ] where: dest The destination address for the request. Can be any phonebook entry. REQUIRED count A number between 1 and 1000000. Represents the number of pings to send. OPTIONAL interval A number between 100 and 1000000 (milliseconds). Represents the interval between packets.
PAGE 46
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 Loopback id : 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a 6a OAM data blocking mode -------------------------Port dsl0: blocking Port dsl1: blocking Port atm2: blocking Port atm3: blocking Port aal5: blocking Port atm5: blocking => 44 E-DOC-CTC-20040210-0030 v1.
PAGE 47
AutoPVC Commands AutoPVC Commands Contents This chapter covers the following commands: Topic Page autopvc config 46 autopvc info 48 E-DOC-CTC-20040210-0030 v1.
PAGE 48
AutoPVC Commands autopvc config Configure autopvc. SYNTAX: autopvc config [mode = <{pseudo|passive|active}>] [type = <{bridge|pppoerelay}>] [opmode = <{partial|full}>] [overwrite = <{disabled|enabled}>] [peakrate = ] where: mode OPTIONAL Select the autopvc mode: • pseudo: enable only pseudo-ILMI (VP/VC 15/16). When connection parameters are written to the MIB, display this information on CLI or web-interface but do not use these parameters for configuration.
PAGE 49
AutoPVC Commands EXAMPLE: =>autopvc config Autopvc mode : Autopvc opmode : Autopvc type : Autopvc standard: Autopvc pseudo : UBR overwrite : UBR peak rate : => pseudo partial bridge down up disabled linerate RELATED COMMANDS: autopvc info E-DOC-CTC-20040210-0030 v1.0 Show retrieved information.
PAGE 50
AutoPVC Commands autopvc info Show retrieved information. SYNTAX: autopvc info [table = <{Vpc|Vcc}>] where: table Choose the autopvc table for which the information must be shown. Choose between: • Vpc • Vcc. OPTIONAL EXAMPLE (default configuration): =>autopvc info Address Type 8.35 ubr BestEff Enabled Par1 Tx: 451 Rx: 7923 Par2 0 0 Par3 0 0 Par4 0 0 Par5 0 0 => RELATED COMMANDS: autopvc config 48 Configure autopvc. E-DOC-CTC-20040210-0030 v1.
PAGE 51
Bridge Commands Bridge Commands Contents This chapter covers the following commands: Topic Page bridge config 50 bridge flush 51 bridge ifadd 52 bridge ifattach 54 bridge ifconfig 56 bridge ifdelete 58 bridge ifdetach 59 bridge iflist 60 bridge macadd 62 bridge macdelete 63 bridge maclist 64 E-DOC-CTC-20040210-0030 v1.
PAGE 52
Bridge Commands bridge config Show/set bridge ageing policy for dynamically learned Medium Access Control (MAC) addresses. SYNTAX: bridge config [age = ] [filter = <{no_WAN_broadcast|PPPoE_only|none}>] where: age A number between 10 and 100000 (seconds). Represents the lifetime of a dynamically learned MAC address. The default is 300. OPTIONAL filter The bridge filter to be applied for all WAN bridge ports.
PAGE 53
Bridge Commands bridge flush Flush bridge interfaces and parameters. Note The flush command does not impact previously saved configurations. SYNTAX: bridge flush E-DOC-CTC-20040210-0030 v1.
PAGE 54
Bridge Commands bridge ifadd Create a bridged Ethernet interface. SYNTAX: bridge ifadd [intf = ] [dest = ] where: intf The bridged Ethernet interface name. If not specified, the destination name will double as interface name. OPTIONAL dest The destination address for the new interface. Typically a phonebook entry. Browse through the available entries via the ARROW UP and ARROW DOWN keys.
PAGE 55
Bridge Commands RELATED COMMANDS: bridge ifattach Attach a bridge interface. bridge ifconfig Configure a bridge interface. bridge ifdelete Delete a bridge interface. bridge ifdetach Detach a bridge interface. bridge iflist Show current bridge configuration. E-DOC-CTC-20040210-0030 v1.
PAGE 56
Bridge Commands bridge ifattach Attach (i.e. connect) a bridged Ethernet interface. SYNTAX: bridge ifattach intf = where: intf The name of the interface to attach. Browse through the available entries via the ARROW UP and ARROW DOWN keys.
PAGE 57
Bridge Commands RELATED COMMANDS: bridge ifadd Create a bridged Ethernet interface. bridge ifconfig Configure a bridge interface. bridge ifdelete Delete a bridge interface. bridge ifdetach Detach a bridge interface. bridge iflist Show current bridge configuration. E-DOC-CTC-20040210-0030 v1.
PAGE 58
Bridge Commands bridge ifconfig Configure a bridge interface. SYNTAX: bridge ifconfig intf = [dest = ] [qos = ] [encaps = <{llc/snap|vcmux}>] [fcs = <{off|on}>] [portstate = <{disabled|learning|forwarding}>] [retry = ] where: intf The name of the bridge interface to configure. REQUIRED dest The destination for this interface. Typically a phonebook entry.
PAGE 59
Bridge Commands EXAMPLE: =>bridge iflist intf=TestBridge TestBridge: dest : TestBridge Retry : 10 QoS : default Encaps : llc/snap Fcs : off Connection State: connected Port: wan0 PortNr: 5 PortState: forwarding RX bytes: 0 frames: 0 TX bytes: 0 frames: 0 dropframes: 0 =>bridge ifconfig intf=TestBridge encaps=vcmux retry=15 =>bridge iflist intf=TestBridge TestBridge: dest : TestBridge Retry : 15 QoS : default Encaps : vcmux Fcs : off Connection State: connected Port: wan0 PortNr: 5 PortState: forwarding RX
PAGE 60
Bridge Commands bridge ifdelete Delete a bridge interface. SYNTAX: bridge ifdelete intf = where: intf The name of the interface name to be deleted. Browse through the available entries via the ARROW UP and ARROW DOWN keys.
PAGE 61
Bridge Commands bridge ifdetach Detach (i.e. disconnect) a bridge interface. SYNTAX: bridge ifdetach intf = where: intf The name of the bridge interface to be detached. Browse through the available entries via the ARROW UP and ARROW DOWN keys.
PAGE 62
Bridge Commands bridge iflist Show the current state of all or the selected bridge interfaces. SYNTAX: bridge iflist [intf = ] where: intf The name of the bridge interface for which the configuration must be shown. Browse through the available entries via the ARROW UP and ARROW DOWN keys. If no interface is specified, all bridge interfaces are shown.
PAGE 63
Bridge Commands DESCRIPTION: RX bytes The number of Received bytes. TX bytes The number of Transmitted bytes. OBC On Board Controller: indicates the physical bridge port. RELATED COMMANDS: bridge ifadd Create a bridged Ethernet interface. bridge ifattach Attach a bridge interface. bridge ifconfig Configure a bridge interface. bridge ifdelete Delete a bridge interface. bridge ifdetach Detach a bridge interface. E-DOC-CTC-20040210-0030 v1.
PAGE 64
Bridge Commands bridge macadd Add a static MAC address to the filtering database. This command allows to manually add static addresses, which should normally be dynamically discovered by the bridge itself. SYNTAX: bridge macadd intf = hwaddr = where: intf The name of the bridge interface for which the MAC address must be added. REQUIRED hwaddr The Ethernet MAC address of the new entry.
PAGE 65
Bridge Commands bridge macdelete Remove a MAC address from the filtering database. SYNTAX: bridge macdelete hwaddr = where: hwaddr The Ethernet MAC address of the entry which must be deleted.
PAGE 66
Bridge Commands bridge maclist Show the current MAC address filtering database.
PAGE 67
CIP Commands CIP Commands Contents This chapter covers the following commands: Topic Page cip flush 66 cip ifadd 67 cip ifdelete 68 cip iflist 69 cip pvcadd 70 cip pvcdelete 71 cip pvclist 72 E-DOC-CTC-20040210-0030 v1.
PAGE 68
CIP Commands cip flush Flush complete Classical IP over ATM (IP oA) configuration. Note The flush command does not impact previously saved configurations. SYNTAX: cip flush 66 E-DOC-CTC-20040210-0030 v1.
PAGE 69
CIP Commands cip ifadd Create a Classical IP oA interface at the local side of the Logical IP Subnet (LIS). SYNTAX: cip ifadd addr = [netmask = ] [uniaddr = ] where: addr The Classical IP oA interface's local IP address in the LIS. REQUIRED netmask The LIS's subnetmask. OPTIONAL uniaddr The UNI-address/port specification for incoming connections, e.g. ‘A0:*.03‘: ADSL port, any address, selector 3.
PAGE 70
CIP Commands cip ifdelete Delete a Classical IP oA interface at the local side of the LIS. SYNTAX: cip ifdelete addr = where: addr The Classical IP oA interface's local IP address in the LIS. REQUIRED EXAMPLE: =>cip iflist cip0 addr = 172.16.1.1 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = inarp_reqs_out = 0 inarp_repl_out = cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.
PAGE 71
CIP Commands cip iflist Show current Classical IP oA configuration. SYNTAX: cip iflist EXAMPLE: =>cip iflist cip0 addr = 172.16.1.1 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = inarp_reqs_out = 0 inarp_repl_out = cip1 addr = 172.16.0.5 mask = 255.255.255.0 UNI address = A0:*.
PAGE 72
CIP Commands cip pvcadd Create a PVC Address Resolution Protocol (ARP) entry for destinations which are not RFC1577/RFC2225 compliant. SYNTAX: cip pvcadd dest = [destaddr = ] [mtu = ] where: dest The ATM address (hardware address) of the destination host. Typically a phonebook name. REQUIRED destaddr The IP address of the destination host Typically for destinations without Inverse ATMARP support. OPTIONAL mtu A number between 273 and 20000.
PAGE 73
CIP Commands cip pvcdelete Delete a PVC ARP entry. SYNTAX: cip pvcdelete dest = where: dest Typically a phonebook entry name. Represents the ATM address (hardware address) or name of the entry to be deleted. REQUIRED EXAMPLE: =>cip pvclist CIPPVC1 atmport = 0 encaps = llc =>cip pvcdelete dest=CIPPVC1 =>cip pvclist => vpi mtu = 8 = 546 vci = 80 dest_ip = 172.16.1.2 RELATED COMMANDS: cip pvcadd Create a PVC ARP entry. cip pvclist Show current PVC ARP entries.
PAGE 74
CIP Commands cip pvclist Show current PVC ARP entries. SYNTAX: cip pvclist EXAMPLE: =>cip pvclist CIPPVC1 atmport = 0 encaps = llc => vpi = 8 mtu = 546 vci = 80 dest_ip = 172.16.1.2 EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: =>cip iflist cip0 addr = 200.200.200.138 mask = 255.255.255.0 UNI address = A0:*.03 inarp_reqs_in = 0 inarp_repl_in = 75 inarp_inv_in = 0 inarp_reqs_out = 0 inarp_repl_out = 75 inarp_inv_out = 0 =>cip pvclist 699 atmport = 0 vpi = 6 vci = 99 dest_ip = 172.16.1.
PAGE 75
Config Commands Config Commands Contents This chapter covers the following commands: Topic Page config backup 74 config dump 75 config erase 76 config flush 77 config list 78 config load 79 config save 81 E-DOC-CTC-20040210-0030 v1.
PAGE 76
Config Commands config backup Store current configuration to backup file. SYNTAX: config backup filename = where: filename Filename for backup file of current configuration. REQUIRED RELATED COMMANDS: config dump Show the saved configuration file. config list Save complete runtime configuration. 74 E-DOC-CTC-20040210-0030 v1.
PAGE 77
Config Commands config dump Show the saved configuration file. SYNTAX: config dump RELATED COMMANDS: config backup Store current configuration to backup file. config list Load complete saved or default configuration. E-DOC-CTC-20040210-0030 v1.
PAGE 78
Config Commands config erase Erase a user configuration file. Note If no filename is specified, all the user configuration files, saved in the SpeedTouch™ permanent storage, are deleted. SYNTAX: config erase [filename = ] where: filename Name of the configuration file to erase. OPTIONAL RELATED COMMANDS: config flush Flush complete runtime configuration. config load Load complete saved or default configuration. config save Save complete runtime configuration.
PAGE 79
Config Commands config flush Flush complete current configuration without affecting saved configurations.
PAGE 80
Config Commands config list Show the current configuration set. SYNTAX: config list [templates = <{no|yes}>] where: templates List the template files (yes) or not (no) OPTIONAL The default is no. EXAMPLE: =>config list templates=yes Configurations file(s): user.ini Template file(s) No template files present Factory template file(s) : pppoe.tpl pppoa.tpl br.tpl => RELATED COMMANDS: config backup Store current configuration to backup file. config dump Show the saved configuration file.
PAGE 81
Config Commands config load Load complete saved (backup) or default configuration file. Note Use the command config flush before using the command config load. SYNTAX: config load [load_ip = <{no|yes}>] [defaults = <{yes|no}>] [flush = <{yes|no}>] [echo = <{no|yes}>] [filename = ] where: load_ip Load IP settings (yes) or not (no). Note defaults OPTIONAL Not keeping the IP settings could cause lost IP connectivity in the LAN. Load default configuration (yes) or saved configuration (no).
PAGE 82
Config Commands RELATED COMMANDS: config erase Erase a user configuration file. config flush Flush complete runtime configuration. config save Save current runtime configuration. 80 E-DOC-CTC-20040210-0030 v1.
PAGE 83
Config Commands config save Save the current configuration, i.e. all existing configurations and modifications entered by the user. The result of executing this command is a user.ini file saved in the SpeedTouch™ permanent storage. This file can be downloaded via the SpeedTouch™ web pages or via an FTP session. SYNTAX: config save RELATED COMMANDS: config erase Erase a user configuration file. config flush Flush complete runtime configuration. config load Load complete saved or default configuration.
PAGE 84
Config Commands 82 E-DOC-CTC-20040210-0030 v1.
PAGE 85
DHCP Commands DHCP Commands Contents This chapter covers the following commands Topic Page dhcp client clear 85 dhcp client config 86 dhcp client flush 87 dhcp client ifadd 88 dhcp client ifattach 89 dhcp client ifconfig 90 dhcp client ifdelete 92 dhcp client iflist 93 dhcp client ifrelease 94 dhcp client ifrenew 96 dhcp client stats 98 dhcp relay add 99 dhcp relay config 100 dhcp relay delete 101 dhcp relay flush 102 dhcp relay ifconfig 103 dhcp relay iflist 104 dhcp re
PAGE 86
DHCP Commands Topic Page dhcp server lease list 117 dhcp server pool add 118 dhcp server pool config 119 dhcp server pool delete 121 dhcp server pool flush 122 dhcp server pool list 123 84 E-DOC-CTC-20040210-0030 v1.
PAGE 87
DHCP Commands dhcp client clear Clear Dynamic Host Configuration Protocol (DHCP) client statistics.
PAGE 88
DHCP Commands dhcp client config Show/set DHCP client configuration. SYNTAX: dhcp client config [trace = <{off|on}>] where: 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 86 Configure a DHCP lease created for a specific interface. E-DOC-CTC-20040210-0030 v1.
PAGE 89
DHCP Commands dhcp client flush Flush complete DHCP client configuration and dynamic interfaces. Note The flush command does not impact previously saved configurations. SYNTAX: dhcp client flush EXAMPLE: =>dhcp client iflist NewETHoA : [SELECTING] flags= uc IP address : 10.0.0.10 HW address : 0:90:d0:01:47:de DHCP server : 255.255.255.255 hostname : NewLease req.
PAGE 90
DHCP Commands dhcp client ifadd Create a DHCP lease for a specific interface. SYNTAX: dhcp client ifadd intf = where: intf The name of the dynamic interface to be created. REQUIRED EXAMPLE: =>dhcp client iflist No dynamic interfaces defined. =>dhcp client ifadd intf=NewEthoa =>dhcp client iflist NewETHoA : [INIT] flags= uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server : 255.255.255.
PAGE 91
DHCP Commands dhcp client ifattach Attach a DHCP lease to a dynamic interface. Note Create the interface first with the command dhcp client ifadd. SYNTAX: dhcp client ifattach intf = where: intf The name of the dynamic interface to be attached. REQUIRED EXAMPLE: =>dhcp client iflist NewETHoA : [INIT] flags= uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server : 255.255.255.
PAGE 92
DHCP Commands dhcp client ifconfig Show/set the configuration of DHCP lease created for a specific interface. Note Use the command dhcp client ifrelease before configuring the dhcp client.
PAGE 93
DHCP Commands EXAMPLE: =>dhcp client iflist NewETHoA : [INIT] flags= uc IP address : 0.0.0.0 HW address : 00:90:d0:01:47:de DHCP server : 255.255.255.255 Number of leases: 1 Total size of table: 19, in use: 1, free: 4 % =>dhcp client ifconfig intf=NewETHoA hostname=NewLease addr=10.0.0.10 leasetime=10800 =>dhcp client iflist NewETHoA : [INIT] flags= uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server : 255.255.255.255 hostname : NewLease req.
PAGE 94
DHCP Commands dhcp client ifdelete Delete a dynamic interface. SYNTAX: dhcp client ifdelete intf = where: intf The name of the dynamic interface to be deleted. REQUIRED EXAMPLE: =>dhcp client iflist NewETHoA : [SELECTING] flags= uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server : 255.255.255.255 hostname : NewLease req.
PAGE 95
DHCP Commands dhcp client iflist Show all dynamic interfaces. SYNTAX: dhcp client iflist EXAMPLE: =>dhcp client iflist NewETHoA : [INIT] flags= uc IP address HW address DHCP server Number of leases: 1 Total size of table: 19, => : : : 0.0.0.0 00:90:d0:01:47:de 255.255.255.255 in use: 1, free: 94 % EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DHCP client on its Ethernet interface eth0. =>dhcp client iflist eth0 : [BOUND] flags= uc IP address : 10.0.0.
PAGE 96
DHCP Commands dhcp client ifrelease Release a lease attached to a dynamic interface. SYNTAX: dhcp client ifrelease intf = where: intf The name of the dynamic interface. REQUIRED EXAMPLE: =>dhcp client iflist NewETHoA : [SELECTING] flags= uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:de DHCP server : 255.255.255.255 hostname : NewLease req.
PAGE 97
DHCP Commands EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DHCP client on its Ethernet interface eth0. =>dhcp client iflist eth0 : [BOUND] flags= uc IP address : 10.0.0.3 HW address : 00:90:d0:01:47:f1 DHCP server : 10.10.1.
PAGE 98
DHCP Commands dhcp client ifrenew Renew the lease of a dynamic interface. SYNTAX: dhcp client ifrenew intf = where: intf The name of the dynamic interface. REQUIRED EXAMPLE: =>dhcp client iflist NewETHoA : [BOUND] flags= uc IP address : 10.0.0.10 HW address : 00:90:d0:01:47:f1 DHCP server : 255.255.255.255 hostname : NewLease req.
PAGE 99
DHCP Commands EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DHCP client on its Ethernet interface eth0.
PAGE 100
DHCP Commands dhcp client stats Show DHCP client statistics.
PAGE 101
DHCP Commands dhcp relay add Add a DHCP server to the DHCP server list. SYNTAX: dhcp relay add addr = [intf = ] [giaddr = ] where: addr The DHCP server IP address. REQUIRED intf The name of the relay interface. Use None to indicate that no interface is specified. OPTIONAL giaddr The giaddr field to be used in relayed DHCP packets. OPTIONAL RELATED COMMANDS: dhcp relay config Set the relay configuration settings.
PAGE 102
DHCP Commands dhcp relay config Set the relay configuration settings. SYNTAX: dhcp server config [agentinfo = <{off|on}>] [agentmismatch = <{off|on}>] [trace = <{off|on}>] where: agentinfo Sets the relay agent info status (RFC3046) off or on. The default is off. OPTIONAL agentmismatch Forward/Drop DHCP reply packet when a relay agent info mismatch is detected (RFC3046) (on) or not (off). The default is off.
PAGE 103
DHCP Commands dhcp relay delete Delete a DHCP server from the DHCP server list. SYNTAX: dhcp relay delete addr = [intf = ] where: addr The DHCP server IP address. REQUIRED intf The name of the dynamic interface. OPTIONAL RELATED COMMANDS: dhcp relay add Add a DHCP server to the DHCP server list. dhcp relay config Set the relay configuration settings. E-DOC-CTC-20040210-0030 v1.
PAGE 104
DHCP Commands dhcp relay flush Flush the DHCP relay settings. Note The flush command does not impact previously saved configurations. SYNTAX: dhcp relay flush EXAMPLE: =>dhcp relay list DHCP server Interface giaddr ------------------------------------------------------127.0.0.1 =>dhcp relay flush =>dhcp relay list No dynamic interfaces defined. => 102 E-DOC-CTC-20040210-0030 v1.
PAGE 105
DHCP Commands dhcp relay ifconfig Configure a relay interface. SYNTAX: dhcp relay ifconfig intf = [relay = <{off|on}>] [maxhops = ] [remoteid = ] [trusted = <{no|yes}>] where: intf The name of the dynamic interface to be configured. REQUIRED relay Sets the relay status. OPTIONAL maxhops A number between 0 and 16. Represents the maximum number of hops allowed in the DHCP packet. The default is 4.
PAGE 106
DHCP Commands dhcp relay iflist Show all dynamic interfaces. SYNTAX: dhcp relay iflist [intf = ] where: intf The name of the dynamic interface to be configured. OPTIONAL EXAMPLE: =>dhcp relay iflist pppoa_pppoa : admin state = down oper state = down max hops = 4 trusted = no remote id = eth0 : admin state = up oper state = up max hops = 4 trusted = no remote id = => RELATED COMMANDS: dhcp relay ifconfig 104 Configure a relay interface. E-DOC-CTC-20040210-0030 v1.
PAGE 107
DHCP Commands dhcp relay list List the DHCP server list. SYNTAX: dhcp relay list EXAMPLE: =>dhcp relay list DHCP server Interface giaddr ------------------------------------------------------127.0.0.1 eth0 10.0.0.138 => RELATED COMMANDS: dhcp relay add Add a DHCP server to the DHCP server list. dhcp relay config Set the relay configuration settings. dhcp relay delete Delete a DHCP server from the DHCP server list. E-DOC-CTC-20040210-0030 v1.
PAGE 108
DHCP Commands dhcp relay stats Show DHCP relay statistics. SYNTAX: dhcp relay stats EXAMPLE: =>dhcp relay stats DHCP relay statistics ------------------------Client packet relayed : Server packet relayed : Bogus relay agent : Bogus giaddr recv : Corrupt agent option : Missing agent option : Bad circuit id : Missing circuit id : => 106 64 0 0 0 0 0 0 0 E-DOC-CTC-20040210-0030 v1.
PAGE 109
DHCP Commands dhcp server clear Clear SpeedTouch™ DHCP server statistics.
PAGE 110
DHCP Commands dhcp server config Show/set SpeedTouch™ DHCP server configuration settings. SYNTAX: dhcp server config [autodhcp = <{off|on}>] [scantime = ] [state = <{disabled|enabled}>] [trace = <{off|on}>] where: autodhcp Allow the SpeedTouch™ to present itself as DHCP client (AutoDHCP mode) at boot time and probe for another DHCP server on the network for some time before starting its own DHCP server (on) or immediately start the DHCP server (off).
PAGE 111
DHCP Commands dhcp server flush Flush all DHCP server pool and lease entries. Note The flush command does not impact previously saved configurations. SYNTAX: dhcp server flush RELATED COMMANDS: dhcp server stats Show current DHCP server state and statistics. dhcp server config Show/set current DHCP server configuration. E-DOC-CTC-20040210-0030 v1.
PAGE 112
DHCP Commands dhcp server policy Show/set SpeedTouch™ DHCP server policy. SYNTAX: dhcp server policy [verifyfirst = ] [trustclient = ] where: verifyfirst Probe the network for conflicting IP addresses before giving a suggested IP address to the requesting DHCP client (on) or not (off). OPTIONAL trustclient Take the IP address suggested by a DHCP client into account (on) or not (off).
PAGE 113
DHCP Commands dhcp server stats Show SpeedTouch™ DHCP server statistics.
PAGE 114
DHCP Commands DESCRIPTION: The stat ... indicates ... DHCP server state the state of the SpeedTouch™ DHCP server. Corrupted packet recv the number of corrupted packets (not complaint to RFC2131) received from the LAN. DISCOVER the number of DHCP server discovery packets received from the Local Area Network (LAN). These broadcasts are sent by potential DHCP clients to locate available DHCP servers. REQUEST the number of DHCP address lease requests received from the LAN.
PAGE 115
DHCP Commands dhcp server lease add Assign a DHCP server lease to a DHCP host in the local network. SYNTAX: dhcp server lease add clientid = pool = [addr = ] [offset = ] [leasetime = ] [hostname = <{hostname|""}>] where: clientid The DHCP client identification string of the booting host. REQUIRED pool The name of the DHCP server pool from which the DHCP lease should be taken.
PAGE 116
DHCP Commands EXAMPLE: =>dhcp server Lease 0 0.0.0.0 =>dhcp server =>dhcp server Lease 0 0.0.0.0 1 10.0.0.1 => lease list Pool TTL State dhcp_pool_1 00:26:40 FREE lease add clientid=01:23:55:67:89:ab lease list Pool TTL State dhcp_pool_1 00:26:40 FREE local_pool 00:59:22 USED Clientid 00:90:D0:12:34:56 pool=Local_pool leasetime=3600 Clientid 00:90:D0:12:34:56 01:23:45:67:89:AB RELATED COMMANDS: dhcp server lease delete Delete a DHCP lease. dhcp server lease flush Delete all DHCP leases.
PAGE 117
DHCP Commands dhcp server lease delete Delete a DHCP lease. SYNTAX: dhcp server lease delete [clientid = ] [index = ] where: clientid The DHCP client identification string of the DHCP lease. If no DHCP client is specified, all DHCP clients are deleted. OPTIONAL index The index number of the entry to be deleted. OPTIONAL Note Use the command dhcp server lease list to see a list of the index numbers of all current DHCP leases. EXAMPLE: =>dhcp server Lease 0 0.0.0.0 1 10.0.0.
PAGE 118
DHCP Commands dhcp server lease flush Flush complete DHCP server configuration and dynamic leases. Note The flush command does not impact previously saved configurations. SYNTAX: dhcp server lease flush [pool = ] where: pool The name of the DHCP server pool to be flushed. Only the leases belonging to this pool will be deleted. OPTIONAL EXAMPLE: =>dhcp server Lease 0 0.0.0.0 1 10.0.0.1 2 10.0.0.101 3 10.0.0.132 5 10.0.0.5 4 10.0.0.6 8 10.0.0.8 9 10.0.0.
PAGE 119
DHCP Commands dhcp server lease list List current DHCP leases, indicated by their index number. SYNTAX: dhcp server lease list [clientid = ] [index = ] where: clientid The DHCP client identification string of the DHCP lease. If no DHCP client is specified, all DHCP clients are listed. OPTIONAL index The index number of the entry to be deleted. OPTIONAL EXAMPLE: =>dhcp server Lease 0 0.0.0.0 1 10.0.0.1 2 10.0.0.101 3 10.0.0.132 5 10.0.0.5 4 10.0.0.6 8 10.0.0.8 9 10.0.0.
PAGE 120
DHCP Commands dhcp server pool add Add a DHCP server pool. SYNTAX: dhcp server pool add [name = ] [index = ] where: name A name for the DHCP server pool. If not specified, the name is “dhcp_pool_x”, where x is a subsequent number. OPTIONAL index The number of the pool before which you want the new pool to be added. OPTIONAL EXAMPLE: =>dhcp server pool list Pool Start End 0 dhcp_pool_1 0.0.0.0 0.0.0.0 1 My_LAN_Pool 10.0.0.1 10.0.0.254 2 dhcp_pool_2 0.0.0.0 0.0.0.
PAGE 121
DHCP Commands dhcp server pool config Configure an existing DHCP server pool. Before you are able to configure the DHCP server pool, you must create it via the command dhcp server pool add.
PAGE 122
DHCP Commands server The IP address of the DHCP server for DHCP clients. OPTIONAL primdns The IP address of the primary DNS server for the DHCP clients. Default value of this parameter is 0 (not specified), which means that the IP address of the DNS server will be communicated by the remote server as soon as the PPP IPCP subnetmasking connection is established or that the SpeedTouch™ acts as the LAN DNS server. OPTIONAL secdns The IP address of the optional secondary DNS server for DHCP clients.
PAGE 123
DHCP Commands dhcp server pool delete Delete a DHCP server pool. SYNTAX: dhcp server pool delete name = where: name The name of the DHCP server pool to delete. Note REQUIRED Use the command dhcp server pool list to see a list of all current DHCP leases. EXAMPLE: =>dhcp server pool list Pool Start End 0 LAN_Private 10.0.0.1 10.0.0.254 1 My_Pool 192.6.11.101 192.6.11.254 =>dhcp server pool delete name=My_Pool =>dhcp server pool list Pool Start End 0 LAN_Private 10.0.0.1 10.0.0.
PAGE 124
DHCP Commands dhcp server pool flush Flush all DHCP server pools. Note The flush command does not impact previously saved configurations. SYNTAX: dhcp server pool flush EXAMPLE: =>dhcp server pool list Pool Start 0 LAN_Private 10.0.0.1 1 My_Pool 192.6.11.101 =>dhcp server pool flush =>dhcp server pool list => End 10.0.0.254 192.6.11.254 Intf eth0 eth0 State USED USED RELATED COMMANDS: dhcp server pool add Add a DHCP server pool. dhcp server pool delete Delete a DHCP server pool.
PAGE 125
DHCP Commands dhcp server pool list List current DHCP server pools. SYNTAX: dhcp server pool list [name = ] where: name The name of the DHCP server pool to be shown. Note OPTIONAL Use the command dhcp server pool list to see a list of all current DHCP server pools. EXAMPLE: =>dhcp server pool list Pool Start 0 LAN_Private 10.0.0.1 1 My_Pool 192.6.11.101 => End 10.0.0.254 192.6.11.254 Intf eth0 eth0 State USED USED RELATED COMMANDS: dhcp server pool add Add a DHCP server pool.
PAGE 126
DHCP Commands 124 E-DOC-CTC-20040210-0030 v1.
PAGE 127
DNS Commands DNS Commands Contents This chapter covers the following commands: Topic Page dns add 126 dns clear 127 dns clrstats 128 dns delete 129 dns domain 130 dns flush 131 dns fwdadd 132 dns fwddelete 133 dns fwdlist 134 dns fwdtable 135 dns list 136 dns nslookup 137 dns start 138 dns stats 139 dns status 140 dns stop 141 dns toutfwd 142 dns troff 143 dns tron 144 E-DOC-CTC-20040210-0030 v1.
PAGE 128
DNS Commands dns add Add an entry to the local Domain Name System (DNS) table. SYNTAX: dns add hostname = [addr = ] where: hostname The name of the IP host to add (without the (sub)domain name). REQUIRED addr The IP address of the host (without mask). OPTIONAL Note If this parameter is not specified, the hostname applies to the SpeedTouch™ itself. EXAMPLE: =>dns list Domain: business.lan Nr. Hostname IP Address 0 SpeedTouch™ *.*.*.* 1 TestHost 10.0.0.140 2 HTTP_Server 10.0.0.
PAGE 129
DNS Commands dns clear Clear the local DNS table. SYNTAX: dns clear EXAMPLE: =>dns list Domain: business.lan Nr. Hostname 0 SpeedTouch™ 1 TestHost 2 HTTP_Server 3 FTP_Server Total Table Size: 73 entries Amount used: 4 (5%) =>dns clear =>dns list Domain: business.lan Nr. Hostname Total Table Size: 73 entries Amount used: 0 (0%) => IP Address *.*.*.* 10.0.0.140 10.0.0.8 10.0.0.7 IP Address RELATED COMMANDS: dns list E-DOC-CTC-20040210-0030 v1.0 List the contents of the local DNS table.
PAGE 130
DNS Commands dns clrstats Clear the DNS statistics. SYNTAX: dns clrstats EXAMPLE: =>dns stats DNS Statistics: Corrupted packets recv Local questions resolved Local neg answers sent Total DNS packets fwd External answers recv Fwd table full, discard Spurious answers Unknown query types : : : : : : : : 0 0 4 0 0 0 0 0 Total number of packets received : 4 =>dns clrstats DNS statistics cleared.
PAGE 131
DNS Commands dns delete Delete an entry from the local DNS table by index. SYNTAX: dns delete index = where: index The index of the entry to be deleted. Note REQUIRED Use dns list to see a list of the index numbers of all current DNS entries. EXAMPLE: =>dns list Domain: business.lan Nr. Hostname 0 SpeedTouch™ 1 TestHost 2 HTTP_Server 3 FTP_Server Total Table Size: 73 entries Amount used: 4 (5%) =>dns delete index=2 =>dns list Domain: business.lan Nr.
PAGE 132
DNS Commands dns domain Set the local DNS domain name. SYNTAX: dns domain domain = where: domain The local DNS domain name of this domain. REQUIRED EXAMPLE: =>dns list Domain: business.lan Nr. Hostname 0 SpeedTouch™ 1 TestHost 2 HTTP_Server 3 FTP_Server Total Table Size: 73 entries Amount used: 4 (5%) =>dns domain domain=office.home.lan =>dns list Domain: office.home.lan Nr.
PAGE 133
DNS Commands dns flush Flush the complete SpeedTouch™ DNS server/forwarder configuration and static entries. Note The flush command does not impact previously saved configurations. SYNTAX: dns flush EXAMPLE: =>dns list Domain: office.home.lan Nr. Hostname 4* Z7V1D8 0 SpeedTouch™ 1 TestHost 2 Default 3 ftpserver Total Table Size: 73 entries Amount used: 5 (6%) =>dns flush =>dns list Domain: lan Nr. Hostname 3* Z7V1D8 Total Table Size: 73 entries Amount used: 1 (1%) => E-DOC-CTC-20040210-0030 v1.
PAGE 134
DNS Commands dns fwdadd Add a DNS forwarding entry. The entries in the forwarding list determine which DNS server should be used for which PC. If an identification cannot be established within the local LAN, the request is forwarded to another DNS server, on another network (Internet/LAN to LAN connection). The connection is negotiated within a PPP link.
PAGE 135
DNS Commands dns fwddelete Delete a DNS forwarding entry. SYNTAX: dns fwddelete src = mask = [dns = ] where: src The source IP address (pool) of the hosts to remove the entry for. REQUIRED mask The source IP (sub)netmask. REQUIRED dns The IP address of the (remote) DNS server (in case of multiple DNS server entries). OPTIONAL EXAMPLE: =>dns fwdlist DNS SRC Metric Direct Permanent 10.0.0.138 10.0.0.2 1 no yes 10.0.0.138 10.0.0.
PAGE 136
DNS Commands dns fwdlist List all forwarding entries. SYNTAX: dns fwdlist EXAMPLE: =>dns fwdlist DNS forwarding servers: DNS SRC 10.0.0.138 10.0.0.0 192.6.11.150 192.6.11.0 => MASK 255.255.255.0 255.255.255.0 Direct yes yes RELATED COMMANDS: dns fwdadd Add a DNS forwarding entry. dns fwddelete Delete a DNS forwarding entry. dns fwdtable Show DNS forwarding table. 134 E-DOC-CTC-20040210-0030 v1.
PAGE 137
DNS Commands dns fwdtable Show DNS forwarding table, i.e. list all currently unresolved DNS requests. SYNTAX: dns fwdtable EXAMPLE: =>dns fwdtable Forwarding table: Nr. Ip Address (port#):id(hex) 0 10.10.10.12 (54751):8331 Timeout: 15 seconds Table size: 10 amount of table used: 1 (10%) => (expiry) (13 sec) dns server 10.10.10.112 tries 1 RELATED COMMANDS: dns fwdlist E-DOC-CTC-20040210-0030 v1.0 Show current DNS forwarding entries.
PAGE 138
DNS Commands dns list List the contents of the local DNS table. SYNTAX: dns list EXAMPLE: =>dns list Domain: office.home.lan Nr. Hostname 4* Z7V1D8 0 SpeedTouch™ 1 TestHost 2 Default 3 ftpserver Total Table Size: 73 entries Amount used: 5 (6%) => IP Address 10.0.0.29 *.*.*.* 10.0.0.140 10.0.0.8 172.16.0.1 EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DNS server. =>dns list Domain: SpeedLAN.local Nr.
PAGE 139
DNS Commands dns nslookup Look up a name or an IP address via local DNS. SYNTAX: dns nslookup lookup = where: lookup The DNS hostname or IP address to query. REQUIRED EXAMPLE: =>dns list Domain: office.home.lan Nr. Hostname 4* Z7V1D8 0 SpeedTouch™ 1 TestHost 2 Default 3 ftpserver Total Table Size: 73 entries Amount used: 5 (6%) =>dns nslookup lookup=TestHost Name: TestHost Address: 10.0.0.140 =>dns nslookup lookup=10.0.0.29 Name: Z7V1D8 Address: 10.0.0.29 => IP Address 10.0.0.29 *.*.*.* 10.
PAGE 140
DNS Commands dns start Start the local DNS server and forwarder. SYNTAX: dns start EXAMPLE: =>dns status DNS server status: Stopped DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache. Tracing: off =>dns start DNS server started. =>dns status DNS server status: Started DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache.
PAGE 141
DNS Commands dns stats Show the DNS server/forwarder statistics. SYNTAX: dns stats EXAMPLE INPUT/OUTPUT IN A NETWORKED ENVIRONMENT: The SpeedTouch™ is configured as DNS server. =>dns list Domain: SpeedLAN.local Nr. Hostname IP Address 0 SpeedTouch™ *.*.*.* 1 Server 10.10.1.1 2 Client 10.0.0.
PAGE 142
DNS Commands dns status Show the current status of the DNS server/forwarder. SYNTAX: dns status EXAMPLE: =>dns status DNS server status: Stopped DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache. Tracing: off => 140 : : : 73, 10, 25, in use: in use: in use: 4, 0, 4, free: free: free: 94 % 100 % 84 % E-DOC-CTC-20040210-0030 v1.
PAGE 143
DNS Commands dns stop Stop the local DNS server/forwarder. SYNTAX: dns stop EXAMPLE: =>dns status DNS server status: Started DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache. Tracing: off =>dns stop DNS server stopped. =>dns status DNS server status: Stopped DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache.
PAGE 144
DNS Commands dns toutfwd Set the DNS forwarding timeout. SYNTAX: dns toutfwd timeout = where: timeout A number (of seconds). Represents the query forwarding timeout. This parameter determines how long the SpeedTouch™ DNS server should try to contact a (remote) DNS server before (temporarily) declaring the DNS requests unresolved. The default is 15. REQUIRED EXAMPLE: =>dns fwdtable Forwarding table: Nr. Ip Address (port#):id(hex) 0 10.10.10.
PAGE 145
DNS Commands dns troff Disable verbose console messaging. No debug traces are generated. SYNTAX: dns troff EXAMPLE: =>dns status DNS server status: Started DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache. Tracing: on =>dns troff =>dns status DNS server status: Started DNS table size DNS forwarding table size DNS forwarding dns servers table size No dns cache.
PAGE 146
DNS Commands dns tron Enable verbose console messaging. Debug traces are generated. SYNTAX: dns tron EXAMPLE: =>dns status DNS server status: Started DNS table size : 73, in use: 4, free: 94 % DNS forwarding table size : 10, in use: 0, free: 100 % DNS forwarding dns servers table size : 25, in use: 4, free: 84 % No dns cache. Tracing: off =>dns tron Tracing on.
PAGE 147
Env Commands Env Commands Contents This chapter covers the following commands Topic Page env flush 146 env get 147 env list 148 env set 149 env unset 150 E-DOC-CTC-20040210-0030 v1.
PAGE 148
Env Commands env flush Flush all non-system environment variables. SYNTAX: env flush EXAMPLE : =>env list _COMPANY_NAME=THOMSON _COMPANY_URL=http://www.thomson.net _PROD_NAME=SpeedTouch ... _COMPANY_ID=ALCL _COPYRIGHT=Copyright (c) 1999-2004, THOMSON _TPVERSION=1.2.0 _ETHERNET=SWITCH _MACADDR=00-90-D0-8D-A5-04 _UDN=uuid:UPnP-SpeedTouch510-1_00-90-D0-8D-A5-04 _IGDX_VERSION=1.
PAGE 149
Env Commands env get Get the current value of a environment variable. SYNTAX: env get var = where: var The name of the environment variable. Use the command env list to see a list of all environment variables. REQUIRED EXAMPLE: =>env get var=ATM_addr 8*35 => RELATED COMMANDS: env list List all current environment variables. env set Create and set a non-system environment variable. E-DOC-CTC-20040210-0030 v1.
PAGE 150
Env Commands env list Show all currently available environment variables. SYNTAX: env list EXAMPLE: =>env list _COMPANY_NAME=THOMSON _COMPANY_URL=http://www.thomson.net _PROD_NAME=SpeedTouch _PROD_URL=http://www.speedtouch.com _PROD_FRIENDLY_NAME=SpeedTouch 510 _PROD_DESCRIPTION=DSL Internet Gateway Device _PROD_NUMBER=510 _BOARD_SERIAL_NBR=0311LZGYP _PROD_SERIAL_NBR=CP0311LZGYP _FII=4.2.7.9.0 _BUILD=4.2.7.9.
PAGE 151
Env Commands env set Create and set a non-system environment variable or change the value of a non-system environment variable. SYNTAX: env set var = value = where: var The name of the environment variable. When creating an environment variable, any name is allowed, however spaces are not allowed and the name may not start with “CONF”, “HOST”, an underscore “_” or the dollar sign “$”.
PAGE 152
Env Commands env unset Delete a non-system environment variable. SYNTAX: env unset var = where: var The name of the environment variable to delete. System variables (built-in variables with names starting with an underscore “_”, “CONF” or “HOST”) cannot be unset, changed or deleted. REQUIRED EXAMPLE: =>env list _COMPANY_NAME=THOMSON multimedia _COMPANY_URL=http://www.speedtouch.com _PROD_NAME=SpeedTouch .....
PAGE 153
Eth Commands Eth Commands Contents This chapter covers the following commands: Topic Page eth config 152 eth ifconfig 153 eth iflist 154 E-DOC-CTC-20040210-0030 v1.
PAGE 154
Eth Commands eth config Enable/disable the Ethernet interface. SYNTAX: eth config intf = [state = <{enabled|disabled}>] where: intf The Ethernet interface to be configured. REQUIRED state Enable or disable the Ethernet interface. The default is enabled.
PAGE 155
Eth Commands eth ifconfig Configure the Ethernet port. SYNTAX: eth ifconfig intf = type = <{auto|10BaseTHD|10BaseTFD|100BaseTHD|100BaseTFD} or number> where: intf The Ethernet interface to be configured. REQUIRED type The Ethernet type. Select either: REQUIRED • auto: Auto negotiation of Ethernet communication speed (10Mb/s or 100Mb/s) and Duplex mode (half duplex or full duplex). • 10BaseTHD: 10Mb/s communication speed in half duplex mode.
PAGE 156
Eth Commands eth iflist Show the Ethernet port configuration and current operating status. SYNTAX: eth iflist EXAMPLE: =>eth iflist Intf Type 1 auto 2 auto 3 auto 4 auto => Result Type 100BaseTFD 100BaseTFD 100BaseTFD 100BaseTFD DESCRIPTION: Type Indicates the configured Ethernet communication speed and duplex mode. Result type Indicates the effective operating status if Type equals auto.
PAGE 157
ETHoA Commands ETHoA Commands Contents This chapter covers the following commands: Topic Page ethoa flush 156 ethoa ifadd 157 ethoa ifattach 158 ethoa ifconfig 159 ethoa ifdelete 161 ethoa ifdetach 162 ethoa iflist 163 E-DOC-CTC-20040210-0030 v1.
PAGE 158
ETHoA Commands ethoa flush Flush ETHoA interfaces. Note The flush command does not impact previously saved configurations. SYNTAX: ethoa flush EXAMPLE: =>ethoa iflist Newethoa : dest : Br3 Retry : 10 QoS : default Connection State : connected RX bytes: 0 frames: 0 TX bytes: 0 frames: 0 =>ethoa flush =>ethoa iflist => 156 Encaps : llc/snap Fcs : off dropframes: 0 E-DOC-CTC-20040210-0030 v1.
PAGE 159
ETHoA Commands ethoa ifadd Create a new ETHoA interface. SYNTAX: ethoa ifadd [intf = ] [dest = ] where: intf The name for the new ETHoA interface. If not specified, the destination will double as interface name. OPTIONAL dest The destination for the new ETHoA interface. Typically, a phonebook entry.
PAGE 160
ETHoA Commands ethoa ifattach Attach (i.e. connect) an ETHoA interface. SYNTAX: ethoa ifattach intf = where: intf The name of the ETHoA interface to attach.
PAGE 161
ETHoA Commands ethoa ifconfig Configure an ETHoA interface. SYNTAX: ethoa ifconfig intf = [dest = ] [qos = ] [encaps = <{llc/snap|vcmux}>] [retry = ] where: intf The name of the ETHoA interface to be configured. REQUIRED dest The destination for this interface. Typically a phonebook entry. This parameter needs only to be specified in case of an interface created without specified destination.
PAGE 162
ETHoA Commands RELATED COMMANDS: ethoa ifadd Create a new ETHoA interface. ethoa ifattach Attach an ETHoA interface. ethoa ifdelete Delete an ETHoA interface. ethoa ifdetach Detach an ETHoA interface. ethoa iflist Show current ETHoA interfaces. 160 E-DOC-CTC-20040210-0030 v1.
PAGE 163
ETHoA Commands ethoa ifdelete Delete an ETHoA interface. SYNTAX: ethoa ifdelete intf = here: intf The name of the ETHoA interface.
PAGE 164
ETHoA Commands ethoa ifdetach Detach an ETHoA interface. SYNTAX: ethoa ifdetach intf = where: intf The name of the ETHoA interface.
PAGE 165
ETHoA Commands ethoa iflist Show all or a specified ETHoA interface(s). SYNTAX: ethoa iflist [intf = ] where: intf The name of the ETHoA interface. Note OPTIONAL If not specified, all ETHoA interfaces are shown.
PAGE 166
ETHoA Commands 164 E-DOC-CTC-20040210-0030 v1.
PAGE 167
Firewall Commands Firewall Commands Contents This chapter covers the following commands: Topic Page firewall assign 166 firewall flush 168 firewall list 169 firewall troff 170 firewall tron 171 firewall unassign 172 firewall chain create 173 firewall chain delete 174 firewall chain flush 175 firewall chain list 176 firewall rule clear 177 firewall rule create 178 firewall rule delete 182 firewall rule flush 183 firewall rule list 184 firewall rule stats 185 E-DOC-CTC-20040
PAGE 168
Firewall Commands firewall assign Assign a chain to an entry point. An entry point, also referred to as hook or a Packet Interception Point (PIP), is the location where packets are intercepted to be compared against a chain of rules. SYNTAX: firewall assign hook = <{input|sink|forward|source|output}> chain = where: hook chain REQUIRED The name of the entry point to which a chain must be assigned. Choose between: • input: The point of all incoming traffic.
PAGE 169
Firewall Commands RELATED COMMANDS: firewall flush Clear all hooks. firewall list Show a list of all chain assignments. firewall unassign Clear a specific hook. E-DOC-CTC-20040210-0030 v1.
PAGE 170
Firewall Commands firewall flush Clear all hooks, chains and rules. Note The flush command does not impact previously saved configurations.
PAGE 171
Firewall Commands firewall list Show the association(s) between all hooks or a specified hook and their chain(s). SYNTAX: firewall list [hook = <{input|sink|forward|source|output}>] where: hook The name of the hook for which the associations must be shown. Choose between: • input • sink • forward • source • output. Note OPTIONAL If this parameter is not specified, the associations for all hooks are shown.
PAGE 172
Firewall Commands firewall troff Disable verbose console messaging. SYNTAX: firewall troff EXAMPLE: =>firewall troff RELATED COMMANDS: firewall tron 170 Enable verbose console messaging. E-DOC-CTC-20040210-0030 v1.
PAGE 173
Firewall Commands firewall tron Enable verbose console messaging. SYNTAX: firewall tron EXAMPLE: =>firewall tron RELATED COMMANDS: firewall troff E-DOC-CTC-20040210-0030 v1.0 Disable verbose console messaging.
PAGE 174
Firewall Commands firewall unassign Clear a specific hook. SYNTAX: firewall unassign hook = <{input|sink|forward|source|output}> where: hook The name of the hook to be cleared. Choose between: • input • sink • forward • source • output. REQUIRED RELATED COMMANDS: firewall assign Assign a chain to a hook. firewall flush Clear all hooks. firewall list Show a list of all chain assignments. 172 E-DOC-CTC-20040210-0030 v1.
PAGE 175
Firewall Commands firewall chain create Create a new chain. SYNTAX: firewall chain create chain = where: chain The name of the chain to be created. REQUIRED EXAMPLE: =>firewall chain list Tempo, source, forward, sink =>firewall chain create chain=Telnet =>firewall chain list Telnet, Tempo, source, forward, sink => RELATED COMMANDS: firewall chain delete Delete a chain. firewall chain list Show a list of all current chains. E-DOC-CTC-20040210-0030 v1.
PAGE 176
Firewall Commands firewall chain delete Delete a chain. SYNTAX: firewall chain delete chain = where: 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 chain list Telnet, source, forward, sink => RELATED COMMANDS: firewall chain create Create a chain. firewall chain list Show a list of all chains.
PAGE 177
Firewall Commands firewall chain flush Flush all chains. SYNTAX: firewall chain flush EXAMPLE: =>firewall chain source, forward, =>firewall chain =>firewall chain => E-DOC-CTC-20040210-0030 v1.
PAGE 178
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 => RELATED COMMANDS: firewall assign Assign a chain to an entry point. firewall chain create Create a chain. firewall chain delete Delete a chain. 176 E-DOC-CTC-20040210-0030 v1.
PAGE 179
Firewall Commands firewall rule clear Clear statistics SYNTAX: firewall rule clear [chain = ] [index = ] where: chain The name of the chain in which the rule is to be found. Note index OPTIONAL If no chain is specified, the statistics of all the chains will be cleared. The index number (determined by the position) of the rule in the chain.
PAGE 180
Firewall Commands firewall rule create Create a rule. Note If a value is preceded by a “!”, it means "NOT". E.g. "dstintfgrp=!wan" means "if dstintfgrp is different from WAN".
PAGE 181
Firewall Commands srcintfgrp The interface group the packet should [or should NOT] arrive on. Choose between: • wan • local • lan. Note OPTIONAL NOT applicable if used in a chain assigned to the output hook. src The source IP address (range) the packet should [or should NOT] come from. (Supports cidr notation). OPTIONAL dstintf The name of the interface the packet should [or should NOT] be going to. OPTIONAL Note dstintfgrp NOT applicable if used in a chain assigned to the output hook.
PAGE 182
Firewall Commands prot The protocol (name or number) expected [or NOT expected] in the IP packet. OPTIONAL Choose between: • icmp • igmp • ipinip • tcp • udp • ah • esp • ipcomp or, alternatively, specify the protocol number. syn Expect TCP SYN flag set (yes) or not (no). In combination with TCP ACK, this allows selection of incoming versus outgoing TCP connections. OPTIONAL urg Expect TCP URG flag set (yes) or not (no). OPTIONAL ack Expect TCP ACK flag set (yes) or not (no).
PAGE 183
Firewall Commands icmptype The expected [or NOT expected] ICMP type (name or number) of the packet. Select one of the supported ICMP type names (See “ Supported ICMP Type Names” on page 415 for a listing of ICMP type names supported by the SpeedTouch™). Alternatively, specify the protocol number. OPTIONAL icmpcode A number between 0 and 15. Represents the expected [or NOT expected] ICMP code (or beginning of range) of the packet as specified in the latest version of RFC1700: Assigned numbers.
PAGE 184
Firewall Commands firewall rule delete Delete a rule. SYNTAX: firewall rule delete chain = index = where: chain The name of the chain in which the rule must be deleted. REQUIRED index The index number of the rule in the chain. REQUIRED Note Use firewall rule list first to determine the index number of the applicable rule. EXAMPLE: =>firewall rule list chain=Telnet :firewall rule create chain=Telnet index=0 srcintfgrp=lan src=10.0.0.0/8 dst=200.200.200.
PAGE 185
Firewall Commands firewall rule flush Flush all rules created for a chain(s). The chain itself is not removed. Note The flush command does not impact previously saved configurations. SYNTAX: firewall rule flush [chain = ] where: chain The name of the chain to be emptied. Note OPTIONAL If this parameter is not specified, all rules for all chains are deleted. EXAMPLE: =>firewall rule list chain=Telnet :firewall rule create chain=Telnet index=0 srcintfgrp=lan src=10.0.0.0/8 | dst=200.200.200.
PAGE 186
Firewall Commands firewall rule list Show a list of rules. SYNTAX: firewall rule list [chain = ] where: chain The name of the chain for which the rules must be listed. Note OPTIONAL If this parameter is not specified, all rules for all chains are shown. EXAMPLE: =>firewall rule list chain=Telnet :firewall rule create chain=Telnet index=0 srcintfgrp=lan src=10.0.0.0/8 | dst=200.200.200.
PAGE 187
Firewall Commands firewall rule stats Show statistics, i.e. the number of packets and bytes which have passed the hooks. SYNTAX: firewall rule stats [chain = ] [index = ] where: chain The name of the chain for which the statistics must be listed. In case this parameter is not specified, the statistics for the rules applicable to all chains are shown. OPTIONAL index The index number of the chain's rule for which the statistics must be listed.
PAGE 188
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.
PAGE 189
IP Commands IP Commands Contents This chapter covers the following commands: Topic Page ip apadd 188 ip apdelete 190 ip aplist 191 ip arpadd 192 ip arpdelete 193 ip arplist 194 ip config 195 ip flush 198 ip ifconfig 199 ip iflist 200 ip ifwait 201 ip mcadd 202 ip mcdelete 203 ip mclist 204 ip ping 205 ip rtadd 206 ip rtdelete 207 ip rtlist 208 ip sendto 209 ip traceroute 210 ip auto flush 211 ip auto ifadd 212 ip auto ifattach 213 ip auto ifconfig 214 ip au
PAGE 190
IP Commands ip apadd Assign an Internet Protocol (IP) address to an IP interface. SYNTAX: ip apadd addr = [netmask = ] intf = [pointopoint = ] [addrtrans = <{none|pat}>] [addroute = <{no|yes}>] where: addr The new IP address to be added. REQUIRED netmask The subnetmask associated with this address. OPTIONAL intf The IP interface name. REQUIRED pointopoint The remote IP address in case of a dedicated point-to-point link.
PAGE 191
IP Commands EXAMPLE: =>ip aplist 1 eth0 Type:Ethernet HWaddr 00:80:9f:24:ab:cf BRHWaddr ff:ff:ff:ff:ff:ff inet addr:10.10.10.147 Bcast:10.10.10.255 Mask:255.0.0.0 UP RUNNING pat MTU:1500 ReasmMAX:65535 Group:2 IPRX bytes:19791886 unicastpkts:11341 brcastpkts:290555 IPTX bytes:839550 unicastpkts:11477 brcastpkts:0 droppkts:0 HWRX bytes:0 unicastpkts:0 brcastpkts:0 HWTX bytes:0 unicastpkts:0 brcastpkts:0 droppkts:0 0 loop Type:0 inet addr:127.0.0.1 Bcast:127.255.255.255 Mask:255.0.0.
PAGE 192
IP Commands ip apdelete Remove an IP address from an IP interface. SYNTAX: ip apdelete addr = where: addr The IP address to be deleted. 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.
PAGE 193
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.
PAGE 194
IP Commands ip arpadd Add an entry to the ARP cache of a broadcast IP interface. SYNTAX: ip arpadd intf = ip = [hwaddr = ] where: intf The IP interface name. REQUIRED ip The IP address [range] of the entry to be added. REQUIRED hwaddr The hardware address (e.g. the Ethernet MAC address) of the entry to be added. OPTIONAL EXAMPLE: =>ip arplist Intf IP-address HW-address eth0 10.0.0.1 00:01:42:5f:7d:81 eth0 10.0.0.8 00:a0:24:ae:66:e1 eth0 10.0.1.
PAGE 195
IP Commands ip arpdelete Remove an entry from the ARP cache. SYNTAX: ip arpdelete intf = ip = [hwaddr = ] where: intf The interface name. REQUIRED ip The IP address [range] of the entry to be deleted. REQUIRED hwaddr The hardware address (e.g. the Ethernet MAC address) of the entry to be deleted. OPTIONAL EXAMPLE: =>ip arplist Intf IP-address HW-address eth0 10.0.0.1 00:01:42:5f:7d:81 eth0 10.0.0.8 00:a0:24:ae:66:e1 eth0 10.0.1.
PAGE 196
IP Commands ip arplist Show the ARP cache. SYNTAX: ip arplist EXAMPLE: =>ip arplist Intf eth0 eth0 eth0 eth0 eth0 => IP-address 10.0.0.1 10.0.0.8 10.0.1.99 10.0.1.100 10.0.0.2 HW-address 00:01:42:5f:7d:81 00:a0:24:ae:66:e1 52:41:53:20:20:4d 52:41:53:20:f0:90 00:10:a4:d0:9a:db Type DYNAMIC DYNAMIC STATIC STATIC STATIC RELATED COMMANDS: ip arpadd Add a static entry to the ARP cache. ip arpdelete Delete an entry from the ARP cache. 194 E-DOC-CTC-20040210-0030 v1.
PAGE 197
IP Commands ip config Show/set global IP stack configuration options. SYNTAX: ip config [forwarding = <{off|on}>] [firewalling = <{off|on}>] [redirects = <{off|on}>] [sourcerouting = <{off|on}>] [netbroadcasts = <{off|on}>] [ttl = ] [fraglimit = ] [defragmode = <{normal|always|nat}>] [addrcheck = <{off|own|static|dynamic}>] [mssclamping = <{off|on}>] where: forwarding Disable (off) or enable (on) the IP routing functionality.
PAGE 198
IP Commands fraglimit A number between 1 and 1024. Represents the maximum number of IP packet fragments waiting for completion. Generally, the fragmentation limit is 64. By limiting the fragmentation limit, the depletion of the buffer is avoided. OPTIONAL defragmode Define which packets are reassembled under which circumstances. Choose between: OPTIONAL addrcheck mssclamping • normal: Packets to be forwarded will not be reassembled. Packets with local destination, i.e.
PAGE 199
IP Commands EXAMPLE: =>ip config Forwarding on Firewalling off Sendredirects off Sourcerouting on NetBroadcasts off Default TTL 128 Fraglimit 32 fragments Fragcount currently 0 fragments Defragment mode : always Address checks : static Mss clamping : on =>ip config firewalling=on ttl=64 fraglimit=64 defragmode=nat =>ip config Forwarding on Firewalling on Sendredirects off Sourcerouting on NetBroadcasts off Default TTL 64 Fraglimit 64 fragments Fragcount currently 0 fragments Defragment mode : nat Address c
PAGE 200
IP Commands ip flush Flush complete IP configuration. Dynamic configurations (e.g. from PPP or CIP links) remain. Note 1.The flush command does not impact previously saved configurations. 2. As the command ip flush causes all local IP connectivity to be deleted, do not use this command during an IP based local connection, e.g. a Telnet CLI session, or web based CLI access. SYNTAX: ip flush EXAMPLE: =>ip aplist 3 cip1 Type:ATM inet addr:172.16.0.5 Bcast:172.16.0.255 Mask:255.255.255.
PAGE 201
IP Commands ip ifconfig Configure IP interface parameters. SYNTAX: ip ifconfig intf = [mtu = ] [status = <{down|up}>] [hwaddr = ] [group = <{wan|local|lan}> or number] [linksensing = <{off|on}>] where: intf The IP interface name. REQUIRED mtu A number between 68 and 20000. Represents the maximum transmission unit, i.e. the maximum packet size (including IP header) to use on this interface.
PAGE 202
IP Commands ip iflist Show all IP interfaces. SYNTAX: ip iflist EXAMPLE: =>ip iflist Interface 0 loop 1 eth0 2 ETHoA 5 cip0 => GRP 1 2 0 0 MTU 1500 3000 1500 9180 RX 116 21045795 0 0 TX 0 1019664 0 0 TX-DROP 0 0 0 0 STATUS UP UP UP UP HWADDR 00:80:9f:24:ab:cf 00:80:9f:24:ab:cf RELATED COMMANDS: ip ifconfig 200 Configure interface parameters. E-DOC-CTC-20040210-0030 v1.
PAGE 203
IP Commands ip ifwait Wait for a status change of an IP interface. SYNTAX: ip ifwait intf = [timeout = ] [adminstatus = <{down|up}>] [operstatus = <{down|up}>] [linkstatus = <{down|up}>] where: intf The IP interface name. REQUIRED timeout A number between 1 and 600000 (seconds). Represents the timeout. OPTIONAL adminstatus The administrative state of the interface. Choose between: OPTIONAL operstatus linkstatus E-DOC-CTC-20040210-0030 v1.0 • down • up.
PAGE 204
IP Commands ip mcadd Add a MC address to a MC capable interface. SYNTAX: ip mcadd intf = addr = [mask = ] where: intf The IP interface name. REQUIRED addr The Multicast IP address. OPTIONAL mask The Multicast IP address mask associated with this address (use 0 for promiscuous mode). OPTIONAL RELATED COMMANDS: ip mcdelete Delete a MC address to a MC capable interface. ip mclist List all MC addresses. 202 E-DOC-CTC-20040210-0030 v1.
PAGE 205
IP Commands ip mcdelete Delete a MC address to a MC capable interface. SYNTAX: ip mcadd intf = addr = [mask = ] where: intf The IP interface name. REQUIRED addr The Multicast IP address. OPTIONAL mask The Multicast IP address mask associated with this address (use 0 for promiscuous mode). OPTIONAL RELATED COMMANDS: ip mcadd Add a MC address to a MC capable interface. ip mclist List all MC addresses. E-DOC-CTC-20040210-0030 v1.
PAGE 206
IP Commands ip mclist List all MC addresses. SYNTAX: ip mclist RELATED COMMANDS: ip mcadd Add a MC address to a MC capable interface. ip mcdelete Delete a MC address to a MC capable interface. 204 E-DOC-CTC-20040210-0030 v1.
PAGE 207
IP Commands ip ping Send ICMP ECHO_REQUEST packets. SYNTAX: ip ping addr = [count = ] [size = ] [interval = ] [listen = <{off|on}>] where: addr The destination IP address. REQUIRED count A number between 1 and 1000000. Represents the number of pings to send. OPTIONAL size A number between 1 and 20000 (bytes). Represents the size of the ping packet(s). OPTIONAL interval A number between 100 and 10000000 (milliseconds).
PAGE 208
IP Commands ip rtadd Add a route to the SpeedTouch™ routing table. SYNTAX: ip rtadd dst = [dstmsk = ] [label = ] [gateway = ] [intf = ] [metric = ] where: dst The destination IP address(es) for this route. Supports cidr notation. REQUIRED dstmsk The destination IP address mask. OPTIONAL label The name of the label. OPTIONAL gateway The IP address of the next hop. Must be directly connected.
PAGE 209
IP Commands ip rtdelete Delete a route from the routing table. SYNTAX: ip rtdelete dst = [dstmsk = ] [label = ] [gateway = ] [intf = ] where: dst The destination IP address(es) for this route. Supports cidr notation. REQUIRED dstmsk The destination IP address mask. OPTIONAL label The name of the label. OPTIONAL gateway The IP address of the next hop. Must be directly connected.
PAGE 210
IP Commands ip rtlist Show the current routing table. SYNTAX: ip rtlist EXAMPLE: =>ip rtlist Destination Label 10.0.0.0/24 10.0.0.140/32 127.0.0.1/32 => Gateway 10.0.0.140 10.0.0.140 127.0.0.1 Intf Mtrc Status eth0 0 [UP] eth0 0 [UP] loop 0 [UP] RELATED COMMANDS: ip rtadd Add a route to the routing table. ip rtdelete Remove a route from the routing table. 208 E-DOC-CTC-20040210-0030 v1.
PAGE 211
IP Commands ip sendto Send UDP packets. SYNTAX: ip sendto addr = [count = ] [size = ] [interval = ] [listen = <{off|on}>] [srcport = ] dstport = where: addr The destination IP address. REQUIRED count A number between 1 (default) and 1000000. Represents the number of UDP packets to send. OPTIONAL size A number between 1 (default) and 20000 (bytes). Represents the size of the ping packet(s).
PAGE 212
IP Commands ip traceroute Send ICMP/UDP packets to trace the ip path. SYNTAX: ip traceroute addr = [count = ] [size = ] [interval = ] [maxhops = ] [dstport = ] [maxfail = ] [type = <{icmp|udp}>] [utime = <{no|yes}>] where: addr The destination IP address. REQUIRED count A number between 1 and 10. Represents the number of times to reissue a traceroute request with the same time to live.
PAGE 213
IP Commands ip auto flush Flush the autoIP interfaces. SYNTAX: ip auto flush E-DOC-CTC-20040210-0030 v1.
PAGE 214
IP Commands ip auto ifadd Create a new autoIP interface. SYNTAX: ip auto ifadd intf = [addr = ] where: intf The name of the IP interface for which a link-local address has to be allocated. REQUIRED addr The preferred link-local IP address. OPTIONAL RELATED COMMANDS: ip auto flush Flush the autoIP interfaces. ip auto ifdelete Delete an existing autoIP interface. ip auto iflist Show the autoIP interfaces. 212 E-DOC-CTC-20040210-0030 v1.
PAGE 215
IP Commands ip auto ifattach Select and assign a link-local address to an autoIP interface. SYNTAX: ip auto ifattach intf = where: intf The name of the IP interface for which a link-local address has to be attached. REQUIRED RELATED COMMANDS: ip auto ifdetach E-DOC-CTC-20040210-0030 v1.0 Release the link-local address for the given autoIP interface.
PAGE 216
IP Commands ip auto ifconfig Configure an autoIP interface. SYNTAX: ip auto ifconfig intf = [addr = ] [poolstart = ] [poolend = ] [netmask = ] [claim = ] [defence = ] [probe = ] [interval = ] where: intf The name of the autoIP interface to configure. REQUIRED addr The preferred link-local IP address.
PAGE 217
IP Commands ip auto ifdelete Delete an existing autoIP interface. SYNTAX: ip auto ifdelete intf = where: intf The name of the IP interface to be deleted. Typically, a phonebook entry. REQUIRED RELATED COMMANDS: ip auto flush Flush the autoIP interfaces. ip auto ifadd Create a new autoIP interface. ip auto iflist Show the autoIP interfaces. E-DOC-CTC-20040210-0030 v1.
PAGE 218
IP Commands ip auto ifdetach Release the link-local address for the given autoIP interface. SYNTAX: ip auto ifdetach intf = where: intf The name of the IP interface for which a link-local address has to be detached. REQUIRED RELATED COMMANDS: ip auto ifattach 216 Select and assign a link-local address to an autoIP interface. E-DOC-CTC-20040210-0030 v1.
PAGE 219
IP Commands ip auto iflist Show the autoIP interfaces. SYNTAX: ip auto iflist [intf = ] where: intf The name of the interface to be listed. If no name is specified, all the autoIP interfaces are shown. OPTIONAL EXAMPLE: =>ip auto iflist eth0 : [CLAIMED] 169.254.138.1 poolstart = 169.254.1.1 claim : 10 defence : 5 probes sent = 2 collisions = 0 poolend = 169.254.254.254 netmask = 255.255.0.
PAGE 220
IP Commands 218 E-DOC-CTC-20040210-0030 v1.
PAGE 221
IPoA Commands IPoA Commands Contents This chapter covers the following commands: Topic Page ipoa flush 220 ipoa ifadd 221 ipoa ifattach 222 ipoa ifconfig 223 ipoa ifdelete 225 ipoa ifdetach 226 ipoa iflist 227 E-DOC-CTC-20040210-0030 v1.
PAGE 222
IPoA Commands ipoa flush Flush complete IPoA configuration. Note The flush command does not impact previously saved configurations. SYNTAX: ipoa flush 220 E-DOC-CTC-20040210-0030 v1.
PAGE 223
IPoA Commands ipoa ifadd Create a new IPoA interface. SYNTAX: ipoa ifadd [intf = ] [dest = ] where: intf The name for the new IPoA interface. If not specified, the destination will double as interface name. OPTIONAL dest The destination for the new IPoA interface. Typically, a phonebook entry.
PAGE 224
IPoA Commands ipoa ifattach Attach (i.e. connect) an IPoA interface. SYNTAX: ipoa ifattach intf = where: intf The name of the IPoA interface to attach.
PAGE 225
IPoA Commands ipoa ifconfig Configure an IPoA interface. SYNTAX: ipoa ifconfig intf = [dest = ] [qos = ] [encaps = <{llc/snap|vcmux}>] [retry = ] where: intf The name of the IPoA interface to configure. REQUIRED dest The destination for this interface. Typically a phonebook entry. This parameter needs only to be specified in case of an interface created without specified destination. OPTIONAL qos The name of a configured Quality of Service book entry.
PAGE 226
IPoA Commands RELATED COMMANDS: ipoa ifadd Create a new IPoA interface. ipoa ifattach Attach (i.e. connect) an IPoA interface. ipoa ifdelete Delete an IPoA interface. ipoa ifdetach Detach an IPoA interface. ipoa iflist Show current IPoA interfaces. 224 E-DOC-CTC-20040210-0030 v1.
PAGE 227
IPoA Commands ipoa ifdelete Delete an IPoA interface. SYNTAX: ipoa ifdelete intf = where: intf The name of the IPoA interface.
PAGE 228
IPoA Commands ipoa ifdetach Detach an IPoA interface. SYNTAX: ipoa ifdetach intf = where: intf The name of the IPoA interface.
PAGE 229
IPoA Commands ipoa iflist Show all or a specified IPoA interface(s). SYNTAX: ipoa iflist [intf = ] where: intf The name of the IPoA interface. If not specified all IPoA interfaces are listed.
PAGE 230
IPoA Commands 228 E-DOC-CTC-20040210-0030 v1.
PAGE 231
IPQoS Commands IPQoS Commands Contents This chapter covers the following commands: Topic Page ipqos config 230 ipqos list 232 ipqos queue clear 233 ipqos queue config 234 ipqos queue list 236 ipqos queue stats 237 E-DOC-CTC-20040210-0030 v1.
PAGE 232
IPQoS Commands ipqos config Configure Internet Protocol (IP) Quality of Service (QoS) for a given destination interface for the IP QoS queues instantiation. Note When enabling/disabling of IP QoS, take the following into account: • if the WAN interface (e.g. PPPoA, IPoA, ...) is detached at the time of enabling/disabling IP QoS, then the WAN interface has to be attached in order for the enabling/disabling of IP QoS to take effect.
PAGE 233
IPQoS Commands maxbytes A number between 0 and 128. Represents the maximum size in kilobytes in all IP QoS queues instantiated for one interface. OPTIONAL EXAMPLE: =>ipqos config dest = PVC_1 [state] = enabled [discard] = early [realtimerate] = [burstsize] = [maxpackets] = [maxbytes] = :ipqos config dest=PVC_1 state=enabled discard=early => RELATED COMMANDS: ipqos list E-DOC-CTC-20040210-0030 v1.0 List IP QoS configuration.
PAGE 234
IPQoS Commands ipqos list List IP QoS configuration. SYNTAX: ipqos list EXAMPLE: =>ipqos list Name State PVC_1 enabled => Discard early Packets 0 Kbytes 0 Rate 100% Burstsize 2 RELATED COMMANDS: ipqos config 232 Configure IP QoS for a given destination interface for the IP QoS queues instantiation. E-DOC-CTC-20040210-0030 v1.
PAGE 235
IPQoS Commands ipqos queue clear Clear IP QoS statistics.
PAGE 236
IPQoS Commands ipqos queue config Configure IP QoS subqueues. SYNTAX: ipqos queue config dest = queue = [propagate = <{disabled|enabled}>] [maxpackets = ] [maxbytes = ] where: dest The destination interface for the IP QoS queues instantiation. Typically, a phonebook entry. REQUIRED queue A number between 0 and 3.
PAGE 237
IPQoS Commands EXAMPLE: => ipqos queue config dest=PVC_1 queue=2 propagate=enabled packets=20 =>ipqos queue list Name Queue Propagate Packets Kbytes PVC_1 0 0 24 1 disabled 0 24 2 enabled 20 24 3 disabled 0 20 => RELATED COMMANDS: ipqos queue list List IP QoS subqueue configuration. ipqos queue stats IP QoS subqueue statistics. E-DOC-CTC-20040210-0030 v1.
PAGE 238
IPQoS Commands ipqos queue list List IP QoS subqueue configuration. SYNTAX: ipqos queue list EXAMPLE (the default configuration is shown): =>ipqos queue list Name Queue Propagate PVC_1 0 1 disabled 2 disabled 3 disabled => Packets 0 0 0 0 Kbytes 24 24 24 20 RELATED COMMANDS: ipqos queue config Configure IP QoS subqueues. ipqos queue stats IP QoS subqueue statistics. 236 E-DOC-CTC-20040210-0030 v1.
PAGE 239
IPQoS Commands ipqos queue stats Show IP QoS subqueue statistics. SYNTAX: ipqos queue stats EXAMPLE: =>ipqos queue stats Name Queue # packets added PVC_1 0 1240 1 0 2 0 3 234 => # packets marked 0 0 0 0 # packets removed 1240 0 0 234 # packets dropped 0 0 0 0 # packets replaced 0 0 0 0 Marking 0 0 0 0 RELATED COMMANDS: ipqos queue config Configure IP QoS subqueues. ipqos queue list List IP QoS subqueue configuration. E-DOC-CTC-20040210-0030 v1.
PAGE 240
IPQoS Commands 238 E-DOC-CTC-20040210-0030 v1.
PAGE 241
Label Commands Label Commands Contents This chapter covers the following commands: Topic Page label add 240 label config 241 label delete 243 label flush 244 label list 245 label troff 246 label tron 247 label chain create 248 label chain delete 249 label chain flush 250 label chain list 251 label rule clear 252 label rule create 253 label rule delete 256 label rule flush 257 label rule list 258 label rule stats 259 E-DOC-CTC-20040210-0030 v1.
PAGE 242
Label Commands label add Create a new label. SYNTAX: label add name = where: name The name of the label to be added.
PAGE 243
Label Commands label config Configure a label. SYNTAX: label config name = [classification = <{ignore|overwrite|increase}>] [defclass = ] [ackclass = ] [ttloverwrite = <{disabled|enabled}>] [ttl = ] [tosmarking = <{disabled|enabled}>] [tos = ] [trace = <{disabled|enabled}>] where: name The name of the label to be configured. REQUIRED classification Select the method of classification, i.e.
PAGE 244
Label Commands tosmarking OPTIONAL Enable/disable tos marking. Choose between: • disabled • enabled. The default is disabled. tos A number between 0 and 255. Represents the Type of Service (ToS) specification in the IP packet (used for tosmarking). The default is 0. OPTIONAL trace Enable/disable tracing for this label. Choose between: OPTIONAL • disabled • enabled. The default is disabled.
PAGE 245
Label Commands label delete Delete a label. SYNTAX: label delete name = [force = <{no|yes}>] where: name The name of the label to be deleted. REQUIRED force Force delete and cleanup references even when the label is still in use. Choose between: OPTIONAL • no • yes. The default is no.
PAGE 246
Label Commands label flush Delete all labels that are not in use. Note The flush command does not impact previously saved configurations.
PAGE 247
Label Commands label list Show the association(s) between all hooks or a specified hook and their chain(s). SYNTAX: label list [name = ] where: name The name of the label to be shown. Note OPTIONAL If no name is specified, all labels will be shown.
PAGE 248
Label Commands label troff Disable verbose console messaging. SYNTAX: label troff EXAMPLE: =>label troff RELATED COMMANDS: label tron 246 Enable verbose console messaging. E-DOC-CTC-20040210-0030 v1.
PAGE 249
Label Commands label tron Enable verbose console messaging. SYNTAX: label tron EXAMPLE: =>label tron RELATED COMMANDS: label troff E-DOC-CTC-20040210-0030 v1.0 Disable verbose console messaging.
PAGE 250
Label Commands label chain create Create a new chain. SYNTAX: label chain create chain = where: chain The name of the chain to be created. REQUIRED EXAMPLE: =>label chain list :label chain create chain=user_labels :label chain create chain=_auto_labels =>label chain create chain = my_labels =>label chain list :label chain create chain=my_labels :label chain create chain=user_labels :label chain create chain=_auto_labels => RELATED COMMANDS: label chain delete Delete a chain.
PAGE 251
Label Commands label chain delete Delete a chain. SYNTAX: label chain delete chain = where: chain The name of the chain to be deleted. REQUIRED EXAMPLE: =>label chain list :label chain create chain=my_labels :label chain create chain=user_labels :label chain create chain=_auto_labels =>label chain delete chain = my_labels =>label chain list :label chain create chain=user_labels :label chain create chain=_auto_labels => RELATED COMMANDS: label chain create Create a chain.
PAGE 252
Label Commands label chain flush Flush all chains. SYNTAX: label chain flush RELATED COMMANDS: label chain create Create a chain. label chain delete Delete a chain. label chain list Show a list of all chains. 250 E-DOC-CTC-20040210-0030 v1.
PAGE 253
Label Commands label chain list Show a list of all current chains. SYNTAX: label chain list EXAMPLE: =>label chain list :label chain create chain=user_labels :label chain create chain=_auto_labels => RELATED COMMANDS: label chain create Create a chain. label chain delete Delete a chain. E-DOC-CTC-20040210-0030 v1.
PAGE 254
Label Commands label rule clear Clear statistics for a given rule or all the rules. SYNTAX: label rule clear [chain = ] [index = ] where: chain The name of the chain in which the rule is to be found. Note index OPTIONAL If this parameter is not specified, the statistics for all the rules in all chains will be cleared. The index number (determined by the position) of the rule in the chain.
PAGE 255
Label Commands label rule create Create a rule. Note If a value is preceded by a “!”, it means "NOT". E.g. "srcintfgrp=!wan" means "if srcintfgrp is different from WAN".
PAGE 256
Label Commands prot OPTIONAL The protocol (name or number) expected in the IP packet. Select one of the following protocol names: • icmp • igmp • ipinip • tcp • udp • ah • esp • ipcomp or, alternatively, specify the protocol number. srcport The TCP/UDP port (or beginning of range) the packet is coming from. Select one of the supported TCP/UDP port names (See “ Supported TCP/UDP Port Names” on page 412 for a listing of TCP/UDP port names supported by the SpeedTouch™).
PAGE 257
Label Commands RELATED COMMANDS: label rule clear Clear statistics for a given rule. label rule delete Delete a specified rule in a chain. label rule flush Delete all rules in a chain. label rule list Show a list of all (or a specified) chains' rules. label rule stats Show statistics for all (or a specified) chains' rules. E-DOC-CTC-20040210-0030 v1.
PAGE 258
Label Commands label rule delete Delete a rule. SYNTAX: label rule delete chain = index = where: chain The name of the chain in which a rule must be deleted. REQUIRED index The index number of the rule in the chain. REQUIRED Note Use the command label rule list first to determine the index number of the applicable rule.
PAGE 259
Label Commands label rule flush Flush all rules created for a chain(s). The chain itself is not removed. Note The flush command does not impact previously saved configurations. SYNTAX: label rule flush [chain = ] where: chain The name of the chain to be emptied. Note OPTIONAL If this parameter is not specified, all rules for all chains are deleted. RELATED COMMANDS: label rule clear Clear statistics for a given rule. label rule create Create a rule.
PAGE 260
Label Commands label rule list Show a list of rules. SYNTAX: label rule list [chain = ] where: chain The name of the chain for which the rules must be listed. Note OPTIONAL If this parameter is not specified, all rules for all chains are shown.
PAGE 261
Label Commands label rule stats Show statistics. SYNTAX: label rule stats [chain = ] [index = ] where: chain The name of the chain for which the statistics must be listed. OPTIONAL If this parameter is not specified, the statistics for the rules applicable to all chains are shown. index The index number of the rule for which the statistics must be listed. Note OPTIONAL Use the command label rule list first to determine the index number of the applicable rule.
PAGE 262
Label Commands 260 E-DOC-CTC-20040210-0030 v1.
PAGE 263
Language Commands Language Commands Contents This chapter covers the following commands: Topic Page language config 262 language list 263 language remove 264 E-DOC-CTC-20040210-0030 v1.
PAGE 264
Language Commands language config Select a language. SYNTAX: language config [language = ] where: language Language code: OSI language code (2 chars) for language. OPTIONAL Example: en for english. RELATED COMMANDS: language list List available languages archives. language remove Remove one or all language archives. 262 E-DOC-CTC-20040210-0030 v1.
PAGE 265
Language Commands language list List the available languages archives. The currently selected language is indicated by a “*” next to the OSI language code. SYNTAX: language list EXAMPLE: =>language list CODE LANGUAGE en* english => VERSION FILENAME 4.2.7.3 RELATED COMMANDS: language config Select a language. language remove Remove one or all language archives. E-DOC-CTC-20040210-0030 v1.
PAGE 266
Language Commands language remove Remove one or all language archives. SYNTAX: language remove [file = ] [all <{yes|no}>] where: file The filename of the language archive to be removed. OPTIONAL all Removes all languages archives. OPTIONAL Choose between: • yes • no. RELATED COMMANDS: language config Select a language. language remove Remove one or all language archives. 264 E-DOC-CTC-20040210-0030 v1.
PAGE 267
NAT Commands NAT Commands Contents This chapter covers the following commands: Topic Page nat applist 266 nat bind 267 nat bindlist 268 nat clear 269 nat config 270 nat create 271 nat defserver 273 nat delete 274 nat disable 276 nat enable 277 nat flush 279 nat list 280 nat multinatadd 281 nat multinatdelete 282 nat multinatlist 283 nat unbind 284 E-DOC-CTC-20040210-0030 v1.
PAGE 268
NAT Commands nat applist List available Network Address Translation / Port Address Translation (NAT/PAT) protocol helpers. Certain protocols are ‘sensitive‘ to NAT/PAT in that they do not function properly when dealing with it. This list shows which ‘NAT/PAT-sensitive‘ applications are supported on the SpeedTouch™, i.e. the inherent knowledge of the SpeedTouch™ on this matter.
PAGE 269
NAT Commands nat bind Create a new helper/port binding. SYNTAX: nat bind application = port = <{|}> [port_end = <{|}>] where: application The name of a NAT/PAT application helper. The name must be spelled exactly as listed in the application list. Use the command nat applist to obtain the list of applications. REQUIRED port The TCP/UDP port this application handler should work on.
PAGE 270
NAT Commands nat bindlist List current NAT/PAT helper/port bindings. SYNTAX: nat bindlist EXAMPLE: =>nat bindlist Application Proto SIP udp GRE gre PPTP tcp ILS tcp ILS tcp H323 tcp FTP tcp RTSP tcp IRC tcp RAUDIO(PNA) tcp => Port 5060 1 1723 1002 389 1720 21 554 6667 7070 RELATED COMMANDS: nat applist List available NAT/PAT protocol helpers. nat bind Create a new helper/port binding. nat unbind Delete an existing helper/port binding. 268 E-DOC-CTC-20040210-0030 v1.
PAGE 271
NAT Commands nat clear Clear NAT/PAT connection database. SYNTAX: nat clear [addr = ] where: addr An address-translation enabled IP address. Note E-DOC-CTC-20040210-0030 v1.0 OPTIONAL If no IP address is specified, all IP addresses are cleared.
PAGE 272
NAT Commands nat config Configure NAT parameters for IP session. SYNTAX: nat config [timeout_ICMP = ] [timeout_UDP = ] [timeout_TCP = ] [timeout_TCP_nego = ] [timeout_other = ] [ike_port = <{fixed|floated}>] where: timeout_ICMP The interval of time for which an ICMP protocol session is allowed to remain valid without any activity. Syntax: or .
PAGE 273
NAT Commands nat create Create a static NAT/PAT entry. Typically used to install specific servers behind the SpeedTouch™ NAT/PAT device.
PAGE 274
NAT Commands foreign_port The port of the routable host. Select one of the supported TCP/UDP port names (See “ Supported TCP/UDP Port Names” on page 412 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. OPTIONAL RELATED COMMANDS: nat delete Delete a static NAT/PAT entry.
PAGE 275
NAT Commands nat defserver Define the default server behind the SpeedTouch™ NAT/PAT device that receives all (unknown) incoming packets. In typical LAN configurations, one local 'default' server will be responsible for all WAN-LAN mail, http, ftp, ... connectivity. This command allows to specify this server. For specific services, use nat create. SYNTAX: nat defserver [addr = ] where: addr The IP address of the server (on the ‘inside‘) that will receive all (unknown) incoming packets.
PAGE 276
NAT Commands nat delete Delete a static NAT/PAT entry. SYNTAX: nat delete protocol = <{|}> inside_addr = [inside_port = <{|}>] outside_addr = [outside_port = <{|}>] [foreign_addr = ] [foreign_port = <{|}>] where: protocol The IP protocol name (or number) of the incoming stream.
PAGE 277
NAT Commands foreign_port The port of the routable host. Select one of the supported TCP/UDP port names (See “ Supported TCP/UDP Port Names” on page 412 for a listing of TCP/UDP port names supported by the SpeedTouch™). Alternatively, specify the protocol number. Applicable for TCP and UDP protocols only. Other protocols do not need a port to be specified. OPTIONAL RELATED COMMANDS: nat create Create a static NAT/PAT entry. nat disable Disable NAT/PAT on a SpeedTouch™ IP address.
PAGE 278
NAT Commands nat disable Disable NAT or PAT on the specified SpeedTouch™ IP address. SYNTAX: nat disable addr = where: addr The SpeedTouch™ IP address for which NAT/PAT must be disabled. REQUIRED EXAMPLE: =>nat list Indx Prot Inside-addr:Port Outside-addr:Port 1 6 10.0.0.138:80 172.16.0.5:1080 2 17 10.0.0.138:138 10.0.0.140:138 3 17 10.0.0.138:137 10.0.0.140:137 4 17 10.0.0.138:7938 10.0.0.140:7938 5 17 10.0.0.138:513 10.0.0.140:513 6 17 10.0.0.138:111 10.0.0.
PAGE 279
NAT Commands nat enable Enable NAT/PAT on a SpeedTouch™ IP address. SYNTAX: nat enable addr = [type = <{none|pat}>] where: addr The IP address to use for outgoing address translation. Must be one of the own IP addresses of the SpeedTouch™. Note type REQUIRED Use the command ip aplist to obtain a list of all configured IP addresses. Enable port translation (pat) or not (none).
PAGE 280
NAT Commands RELATED COMMANDS: nat create Create a static NAT/PAT entry. nat delete Delete a static NAT/PAT entry. nat disable Disable NAT/PAT on a SpeedTouch™ IP address. nat list List NAT/PAT connection database. 278 E-DOC-CTC-20040210-0030 v1.
PAGE 281
NAT Commands nat flush Flush complete NAT/PAT configuration. Note The flush command does not impact previously saved configurations. SYNTAX: nat flush RELATED COMMANDS: nat create Create a static NAT/PAT entry. nat delete Delete a static NAT/PAT entry. nat disable Disable NAT/PAT on a SpeedTouch™ IP address. nat enable Enable NAT/PAT on one of the SpeedTouch™ IP addresses. E-DOC-CTC-20040210-0030 v1.
PAGE 282
NAT Commands nat list Lists NAT/PAT connection database. SYNTAX: nat list [addr = ] where: addr An address-translation enabled IP address. Note OPTIONAL If no address is specified, all IP addresses are shown. EXAMPLE: =>nat list Indx Prot Inside-addr:Port 1 6 10.0.0.138:80 2 17 10.0.0.138:138 3 17 10.0.0.138:137 4 17 10.0.0.138:7938 5 17 10.0.0.138:513 6 17 10.0.0.138:111 => Outside-addr:Port 172.16.0.5:1080 10.0.0.140:138 10.0.0.140:137 10.0.0.140:7938 10.0.0.140:513 10.0.0.
PAGE 283
NAT Commands nat multinatadd Add a MultiNAT configuration. SYNTAX: nat multinatadd intf = inside_addr = outside_addr = [addroute = <{no|yes}>] where: intf The IP interface name where MultiNAT has to be applied. REQUIRED inside_addr The IP address of the host behind the address translation device that will receive the incoming traffic. Typically, a private IP address. REQUIRED outside_addr The apparent host IP address this application will running on.
PAGE 284
NAT Commands nat multinatdelete Delete a MultiNAT configuration. SYNTAX: nat multinatdelete index = where: index The MultiNAT index as listed by maplist. REQUIRED EXAMPLE: =>nat multinatlist Indx Intf Inside-address 64 PPPoE_1 10.0.0.1 =>nat multinatdelete index=64 =>nat multinatlist Indx Intf Inside-address => Outside-address 10.10.0.138 Static MultiNAT Outside-address RELATED COMMANDS: nat multinatadd Add a MultiNAT configuration. nat multinatlist List MultiNAT configurations.
PAGE 285
NAT Commands nat multinatlist List MultiNAT configurations. SYNTAX: nat multinatlist [intf = ] where: intf The IP interface name for which the MultiNAT configuration must be listed. Note OPTIONAL If no name is specified, all MultiNAT configurations are listed. EXAMPLE: =>nat multinatlist Indx Intf 64 PPPoE_1 => Inside-address 10.0.0.1 Outside-address 10.10.0.138 Static MultiNAT RELATED COMMANDS: nat multinatadd Add a MultiNAT configuration.
PAGE 286
NAT Commands nat unbind Delete an existing helper/port binding. SYNTAX: nat unbind application = port = <{|}> [port_end = <{|}>] where: application The name of a NAT/PAT application helper. The name must be spelled exactly as listed in the application list. Note REQUIRED Use the command nat applist to list the names of the NAT/PAT application helpers. port The TCP/UDP port this application handler is working on.
PAGE 287
Phonebook Commands Phonebook Commands Contents This chapter covers the following commands: Topic Page phonebook add 286 phonebook autolist 288 phonebook delete 289 phonebook flush 290 phonebook list 291 E-DOC-CTC-20040210-0030 v1.
PAGE 288
Phonebook Commands phonebook add Add a phonebook entry. SYNTAX: phonebook add name = addr = type = <{any|ethoa|pppoa|ipoa}> where: name REQUIRED A free to choose phonebook name for the destination.
PAGE 289
Phonebook Commands EXAMPLE: =>phonebook list Name Type Use Address usb_port any 1 usb.0.35 PVC1 any 1 8.35 PVC2 ethoa 0 8.36 Br4 ethoa 0 8.38 CIPPVC3 ipoa 1 8.82 =>phonebook add name=PVC_Test addr=8.68 type=pppoa =>phonebook list Name Type Use Address usb_port any 1 usb.0.35 PVC1 any 1 8.35 PVC2 ethoa 0 8.36 Br4 ethoa 0 8.38 CIPPVC3 ipoa 1 8.82 PVC_Test pppoa 0 8.68 => Note The usb_port phonebook entry is only applicable in case of a SpeedTouch™530 variant.
PAGE 290
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 288 Show current phonebook. E-DOC-CTC-20040210-0030 v1.
PAGE 291
Phonebook Commands phonebook delete Remove an unused phonebook entry. SYNTAX: phonebook delete name = where: name The name of the phonebook entry to be deleted. REQUIRED Only applicable for phonebook entries that are not used, i.e. not configured for any packet service. Note Use the command phonebook list to check whether the entry is in use (Use=1) or not (Use=0). EXAMPLE: =>phonebook list Name Type Use Address usb_port any 1 usb.0.35 PVC1 any 1 8.35 PVC2 ethoa 0 8.36 Br4 ethoa 0 8.
PAGE 292
Phonebook Commands phonebook flush Flush complete phonebook. Note 1. Phonebook entries that are in use, cannot be flushed. 2.The flush command does not impact previously saved configurations. SYNTAX: phonebook flush EXAMPLE: =>phonebook list Name Type usb_port any PVC1 any PVC2 ethoa Br4 ethoa CIPPVC3 ipoa PVC_Test pppoa =>phonebook flush =>phonebook list Name Type => Note 290 Use 1 1 0 0 1 0 Address usb.0.35 8.35 8.36 8.38 8.82 8.
PAGE 293
Phonebook Commands phonebook list Show current phonebook. SYNTAX: phonebook list EXAMPLE INPUT/OUTPUT: =>phonebook list Name Type usb_port any PVC1 any PVC2 ethoa Br4 ethoa CIPPVC3 ipoa PVC_Test pppoa => Note Use 1 1 0 0 1 0 Address usb.0.35 8.35 8.36 8.38 8.82 8.68 The usb_port phonebook entry is only applicable in case of a SpeedTouch™530 variant. Do not change this phonebook entry in any way, or delete it from the phonebook! RELATED COMMANDS: phonebook add Add a phonebook entry.
PAGE 294
Phonebook Commands 292 E-DOC-CTC-20040210-0030 v1.
PAGE 295
PPPoA Commands PPPoA Commands Contents This chapter covers the following commands: Topic Page pppoa flush 294 pppoa ifadd 295 pppoa ifattach 297 pppoa ifconfig 298 pppoa ifdelete 302 pppoa ifdetach 303 pppoa iflist 304 pppoa rtadd 305 pppoa rtdelete 307 E-DOC-CTC-20040210-0030 v1.
PAGE 296
PPPoA Commands pppoa flush Flush the current PPP configuration. Note The flush command does not impact previously saved configurations. SYNTAX: pppoa flush EXAMPLE: =>pppoa iflist pppoa1: dest : pppoa1 Retry: 10 QoS default encaps VC-MUX mode = IP Routing flags = echo magic accomp mru addr route savepwd pppoaOA trans addr = pat mru = 1500 route = 0.0.0.0/0 - 0.0.0.
PAGE 297
PPPoA Commands pppoa ifadd Create a new PPPoA interface. SYNTAX: pppoa ifadd [intf = ] [dest = ] where: intf The name for the new PPP interface. If not specified, the destination will double as interface name. OPTIONAL dest The ATM channel to be used for this PPP interface. Typically, an phonebook entry.
PAGE 298
PPPoA Commands RELATED COMMANDS: pppoa ifattach Attach a PPPoA interface. pppoa ifconfig Configure a PPPoA interface. pppoa ifdelete Delete a PPPoA interface. pppoa ifdetach Detach a PPPoA interface. pppoa iflist Show current PPPoA configuration. 296 E-DOC-CTC-20040210-0030 v1.
PAGE 299
PPPoA Commands pppoa ifattach Attach (i.e. connect) a PPPoA interface. SYNTAX: pppoa ifattach intf = where: intf The name of the PPPoA interface to be attached. REQUIRED EXAMPLE: =>pppoa iflist pppoa1: dest : pppoa1 [00:00:00] Retry : 10 QoS default encaps VC-MUX mode = IP routing flags = echo magic accomp restart mru addr savepwd dns metric = 0 mru = 1500 auth = auto user = password = admin state = down oper state = down link state = not-connected LCP : state = initial retransm = 10 term.
PAGE 300
PPPoA Commands pppoa ifconfig Configure a PPPoA interface. Note The interface to be configured may not be connected at the time of configuration. Use the command pppoa ifdetach prior to using the command pppoa ifconfig.
PAGE 301
PPPoA Commands encaps The WAN protocol encapsulation to be used on this interface. Choose between: • vcmux • llc. OPTIONAL The default is vcmux. pcomp Try (on) or do not try (off) to negotiate PPPoA protocol compression (LCP PCOMP). The default is off. OPTIONAL accomp Try (on), do never try (off) or negotiate (negotiate) to negotiate PPPoA address & control field compression (LCP ACCOMP). In most cases, LCP ACCOMP should not be disabled nor negotiated, i.e.
PAGE 302
PPPoA Commands mru A number between 293 and 8192. Represents the maximum packet size the SpeedTouch™ should negotiate to be able to receive. The default is 1500. OPTIONAL laddr The local IP address of the peer-to-peer connection. Specifying a local IP address forces the remote side of the PPPoA link (if it allows to) to accept this IP address as the SpeedTouch™ PPPoA session IP address. If not specified, the SpeedTouch™ will accept any IP address.
PAGE 303
PPPoA Commands idletrigger Consider the link being idle if no traffic is sent and/or received during the idle time. Choose between: • RxTx: The idle time period restarts when a packet is transmitted or received (default value) • Rx: The idle time period restarts when a packet is received. Transmitted packets are ignored • Tx: The idle time period restarts when a packet is transmitted. Received packets are ignored. OPTIONAL The default is RxTx.
PAGE 304
PPPoA Commands pppoa ifdelete Delete a PPPoA interface. SYNTAX: pppoa ifdelete intf = where: intf The name of the PPPoA interface to be deleted. EXAMPLE: =>pppoa iflist pppoa_pppoa: dest : pppoa [00:00:00] Retry : 10 QoS default encaps VC-MUX mode = IP routing flags = echo magic accomp restart mru addr route savepwd dns metric = 0 trans addr = pat mru = 1500 route : dst=0.0.0.0/0 - src=10.0.0.
PAGE 305
PPPoA Commands pppoa ifdetach Detach a PPPoA interface. SYNTAX: pppoa ifdetach intf = where: intf The name of the PPPoA interface to be detached. REQUIRED EXAMPLE: =>pppoa iflist PPPoA_1: dest : PVC_1 [00:00:00] Retry : 10 QoS default encaps VC-MUX mode = IP routing flags = echo magic accomp restart mru addr route savepwd dns metric = 0 trans addr = pat mru = 1500 route : dst=0.0.0.0/0 - src=0.0.0.
PAGE 306
PPPoA Commands pppoa iflist Show current configuration of a specific or all PPPoA interface(s). SYNTAX: pppoa iflist [intf = ] where: intf The name of the PPPoA interface for which the configuration must be shown. OPTIONAL If this parameter is not specified, all PPPoA interfaces are shown.
PAGE 307
PPPoA Commands pppoa rtadd Automatically add a route configuration to the routing table in case the specified PPPoA interface link comes up. This route configuration will determine which local hosts are allowed to use this link and/or which remote destinations should be or should not be reachable. Note Use the command pppoa ifdetach for this interface prior to configuring routes.
PAGE 308
PPPoA Commands srcmsk metric OPTIONAL The source IP mask. Depending on the source netmask: • Everybody is allowed to use this PPPoA connection (srcmsk=0) • Only members of the same subnet as the host which opened the PPPoA connection are allowed to use the PPPoA connection (srcmsk=1) • The actual destination mask will be the netmask applicable for the IP address of the host which opened the PPPoA connection.
PAGE 309
PPPoA Commands pppoa rtdelete Delete the route specification for a PPPoA link. Note Use the command pppoa ifdetach for this interface prior to deleting route configurations. SYNTAX: pppoa rtdelete intf = where: intf The PPPoA interface name for which to delete the route settings.
PAGE 310
PPPoA Commands 308 E-DOC-CTC-20040210-0030 v1.
PAGE 311
PPPoE Commands PPPoE Commands Contents This chapter covers the following commands: Topic Page pppoe flush 310 pppoe ifadd 311 pppoe ifattach 313 pppoe ifconfig 314 pppoe ifdelete 318 pppoe ifdetach 319 pppoe iflist 320 pppoe ifscan 321 pppoe rtadd 322 pppoe rtdelete 324 pppoe relay add 325 pppoe relay delete 326 pppoe relay flush 327 pppoe relay portlist 328 pppoe relay sesslist 329 E-DOC-CTC-20040210-0030 v1.
PAGE 312
PPPoE Commands pppoe flush Flush the current PPPoE configuration. Note The flush command does not impact previously saved configurations. SYNTAX: pppoe flush EXAMPLE: =>pppoe iflist PPPoE1: dest : PPPoE1 Retry: 10 QoS default encaps VC-MUX mode = IP Routing flags = echo magic accomp mru addr route savepwd PPPoEOA trans addr = pat mru = 1500 route = 0.0.0.0/0 - 0.0.0.
PAGE 313
PPPoE Commands pppoe ifadd Create a new PPPoE interface. SYNTAX: pppoe ifadd [intf = ] [dest = ] where: intf The name for the new PPPoE interface. If not specified, the destination parameter must be specified. In this case the name of the destination will double as interface name. OPTIONAL dest The Ethernet port to be used for this PPPoE interface (e.g. an ETHoA name).
PAGE 314
PPPoE Commands RELATED COMMANDS: pppoe ifattach Attach a PPPoE interface. pppoe ifconfig Configure a PPPoE interface. pppoe ifdelete Delete a PPPoE interface. pppoe ifdetach Detach a PPPoE interface. pppoe iflist Show current PPPoE configuration. 312 E-DOC-CTC-20040210-0030 v1.
PAGE 315
PPPoE Commands pppoe ifattach Attach (i.e. connect) a PPPoE interface. SYNTAX: pppoe ifattach intf = where: intf The name of the PPPoE interface to be attached. REQUIRED EXAMPLE: =>pppoe iflist PPPoE1: dest : PPPoE1 Retry: 10 QoS default encaps LLC mode = IP Routing flags = echo magic accomp restart mru addr route trans addr = pat mru = 1492 route = 0.0.0.0/0 - 0.0.0.
PAGE 316
PPPoE Commands pppoe ifconfig Configure a PPPoE interface. Note The interface to be configured may not be connected at the time of configuration. Use the command pppoe ifdetach prior to using the command pppoe ifconfig.
PAGE 317
PPPoE Commands servicename The Service Name for a PPPoE connection. Use the command pppoe ifscan to see the available service names, if any. OPTIONAL pcomp Try (on) or do not try (off) to negotiate PPPoE protocol compression (LCP PCOMP). The default is off. OPTIONAL accomp Try (on), do never try (off) or negotiate (negotiate) to negotiate PPPoE address & control field compression (LCP ACCOMP). In most cases, LCP ACCOMP should not be disabled nor negotiated, i.e.
PAGE 318
PPPoE Commands mru A number between 293 and 8192. Represents the maximum packet size the SpeedTouch™ should negotiate to be able to receive. The default is 1492. OPTIONAL laddr The local IP address of the peer-to-peer connection. Specifying a local IP address forces the remote side of the PPPoE link (if it allows to) to accept this IP address as the SpeedTouch™ PPPoE session IP address. If not specified, the SpeedTouch™ will accept any IP address.
PAGE 319
PPPoE Commands idletrigger Consider the link being idle if no traffic is sent and/or received during the idle time. Choose between: • RxTx: The idle time period restarts when a packet is transmitted or received. • Rx: The idle time period restarts when a packet is received. Transmitted packets are ignored. • Tx: The idle time period restarts when a packet is transmitted. Received packets are ignored. OPTIONAL The default is RxTx.
PAGE 320
PPPoE Commands pppoe ifdelete Delete a PPPoE interface. SYNTAX: pppoe ifdelete intf = where: intf The name of the PPPoE interface to be deleted. EXAMPLE: =>pppoe iflist PPPoE1: dest : PPPoE1 Retry: 10 QoS default encaps VC-MUX mode = IP Routing flags = echo magic accomp restart mru addr route savepwd PPPoEOA trans addr = pat mru = 1500 route = 0.0.0.0/0 - 0.0.0.
PAGE 321
PPPoE Commands pppoe ifdetach Detach a PPPoE interface. SYNTAX: pppoe ifdetach intf = where: intf The name of the PPPoE interface. REQUIRED EXAMPLE: =>pppoe iflist PPPoE1: dest : PPPoE1 Retry: 10 QoS default encaps VC-MUX mode = IP Routing flags = echo magic accomp restart mru addr route savepwd PPPoEOA trans addr = pat mru = 1492 route = 0.0.0.0/0 - 0.0.0.
PAGE 322
PPPoE Commands pppoe iflist Show current configuration of all or a specified PPPoE interface(s). SYNTAX: pppoe iflist [intf = ] where: intf The name of the PPPoE interface. If this parameter is not specified, all PPPoE interfaces are shown. OPTIONAL EXAMPLE INPUT/OUTPUT : =>pppoe iflist PPPoE1: dest : PPPoE1 Retry: 10 QoS default encaps VC-MUX mode = IP Routing flags = echo magic accomp restart mru addr route savepwd PPPoEOA trans addr = pat mru = 1500 route = 0.0.0.0/0 - 0.0.0.
PAGE 323
PPPoE Commands pppoe ifscan Scan a PPPoE interface for available Access Concentrator names and Service Names. Note Use the command pppoe ifdetach for this interface before performing a scan on it. SYNTAX: pppoe ifscan intf = [time = ] where: intf The name of the Routed PPPoE interface to be scanned. REQUIRED time A number between 0 and 36000 (seconds). Represents the time to scan for services.
PAGE 324
PPPoE Commands pppoe rtadd Automatically add a route configuration to the routing table in case the specified PPPoE interface link comes up. This route configuration will determine which local hosts are allowed to use this link and/or which remote destinations should be or should not be reachable. Note Use the command pppoe ifdetach for this interface prior to configuring routes.
PAGE 325
PPPoE Commands srcmsk metric The source IP mask. Depending on the source netmask: • Everybody is allowed to use this PPPoE connection (dstmsk=0) • Only members of the same subnet as the host which opened the PPPoE connection are allowed to use the PPPoE connection (dstmsk=1) • The actual destination mask will be the netmask applicable for the IP address of the host which opened the PPPoE connection.
PAGE 326
PPPoE Commands pppoe rtdelete Delete the route specification for a PPPoE link. Note Use the command pppoe ifdetach for this interface prior to deleting route configurations. SYNTAX: pppoe rtdelete intf = where: intf The PPPoE interface name for which to delete the route settings. REQUIRED EXAMPLE: =>pppoe iflist PPPoE1: dest : PVC3 Retry: 10 QoS default encaps LLC mode = IP Routing flags = echo magic accomp restart mru addr route trans addr = pat mru = 1492 route = 10.0.0.2/24 - 172.16.0.
PAGE 327
PPPoE Commands pppoe relay add Add an Ethernet port to the PPPoE relay list. SYNTAX: pppoe relay add port = where: port The Ethernet port to be added to the PPPoE relay agent list. REQUIRED RELATED COMMANDS: pppoe relay delete Delete an Ethernet port from the PPPoE relay agent list. pppoe relay flush Remove all Ethernet ports from the PPPoE relay agent list and terminate all sessions. pppoe relay portlist List all Ethernet ports added to the PPPoE relay agent list.
PAGE 328
PPPoE Commands pppoe relay delete Delete an Ethernet port from the PPPoE relay agent list. SYNTAX: pppoe relay delete port = where: port The Ethernet port to be deleted from the PPPoE relay agent list. REQUIRED RELATED COMMANDS: pppoe relay add Add an Ethernet port to the PPPoE relay list. pppoe relay flush Remove all Ethernet ports from the PPPoE relay agent list and terminate all sessions. pppoe relay portlist List all Ethernet ports added to the PPPoE relay agent list.
PAGE 329
PPPoE Commands pppoe relay flush Remove all Ethernet ports from the PPPoE relay agent list and terminate all sessions. SYNTAX: pppoe relay flush RELATED COMMANDS: pppoe relay add Add an Ethernet port to the PPPoE relay list. pppoe relay delete Delete an Ethernet port from the PPPoE relay agent list. pppoe relay portlist List all Ethernet ports added to the PPPoE relay agent list. pppoe relay sesslist List all active PPPoE relay sessions. E-DOC-CTC-20040210-0030 v1.
PAGE 330
PPPoE Commands pppoe relay portlist List all Ethernet ports added to the PPPoE relay agent list. SYNTAX: pppoe relay portlist RELATED COMMANDS: pppoe relay add Add an Ethernet port to the PPPoE relay list. pppoe relay delete Delete an Ethernet port from the PPPoE relay agent list. pppoe relay flush Remove all Ethernet ports from the PPPoE relay agent list and terminate all sessions. pppoe relay sesslist List all active PPPoE relay sessions. 328 E-DOC-CTC-20040210-0030 v1.
PAGE 331
PPPoE Commands pppoe relay sesslist List all active PPPoE relay sessions. SYNTAX: pppoe relay sesslist RELATED COMMANDS: pppoe relay add Add an Ethernet port to the PPPoE relay list. pppoe relay delete Delete an Ethernet port from the PPPoE relay agent list. pppoe relay flush Remove all Ethernet ports from the PPPoE relay agent list and terminate all sessions. pppoe relay portlist List all Ethernet ports added to the PPPoE relay agent list. E-DOC-CTC-20040210-0030 v1.
PAGE 332
PPPoE Commands 330 E-DOC-CTC-20040210-0030 v1.
PAGE 333
PPTP Commands PPTP Commands Contents This chapter covers the following commands: Topic Page pptp ifadd 332 pptp flush 333 pptp list 334 pptp profadd 335 pptp profdelete 337 pptp proflist 338 E-DOC-CTC-20040210-0030 v1.
PAGE 334
PPTP Commands pptp ifadd Add a Point-to-Point Tunneling Protocol (PPTP) profile (backwards compatible with previous release, use profiles instead). SYNTAX: pptp ifadd dest = [rate = ] [encaps = <{vcmux|nlpid}>] [ac = <{never|always|keep}>] where: dest The WAN destination for this PPTP tunnel. Typically a phonebook entry. REQUIRED rate A number between 10 and 10000. Represents the transmit speed in bits/s for the WAN link. OPTIONAL encaps The type of WAN encapsulation.
PAGE 335
PPTP Commands pptp flush Flush complete PPTP configuration. Note The flush command does not impact previously saved configurations. SYNTAX: pptp flush EXAMPLE: =>pptp profadd name=Relay_PPP1 encaps=nlpid ac=always =>pptp proflist Profile QoS Encaps AC Relay_PPP1 default nlpid always =>pptp flush =>pptp proflist => E-DOC-CTC-20040210-0030 v1.
PAGE 336
PPTP Commands pptp list Show current PPTP configuration. SYNTAX: pptp list EXAMPLE INPUT/OUTPUT: =>pptp list Dialstr Destination DIALUP_PPP3 => 334 QoS default Encaps vcmux AC never State CONNECTED User (10.0.0.2) E-DOC-CTC-20040210-0030 v1.
PAGE 337
PPTP Commands pptp profadd Define a new PPTP profile. SYNTAX: pptp profadd name = [qos = ] [encaps = <{vcmux|nlpid}>] [ac = <{never|always|keep}>] where: name The name for the PPTP profile. REQUIRED qos The name of the qosbook entry, containing the settings for this profile. This parameter never needs to be specified. OPTIONAL encaps The type of WAN encapsulation applicable to PPTP interfaces using this PPTP profile.
PAGE 338
PPTP Commands EXAMPLE: =>pptp proflist Profile QoS Encaps AC Relay_PPP1 default nlpid always =>pptp profadd name=PPTPLink encaps=vcmux ac=never =>pptp proflist Profile QoS Encaps AC Relay_PPP1 default nlpid always PPTPLink default vcmux never => RELATED COMMANDS: pptp profdelete Delete a PPTP profile. pptp proflist Show current PPTP profiles. 336 E-DOC-CTC-20040210-0030 v1.
PAGE 339
PPTP Commands pptp profdelete Delete a PPTP profile. SYNTAX: pptp profdelete name where: name The name for the PPTP profile. REQUIRED EXAMPLE: =>pptp proflist Profile QoS Encaps Relay_PPP1 default nlpid PPTPLink default vcmux =>pptp profdelete name=PPTPLink =>pptp proflist Profile QoS Encaps Relay_PPP1 default nlpid => AC always never AC always RELATED COMMANDS: pptp profadd Define a new PPTP profile. pptp proflist Show current PPTP profiles. E-DOC-CTC-20040210-0030 v1.
PAGE 340
PPTP Commands pptp proflist Show all current PPTP profiles. SYNTAX: pptp proflist EXAMPLE: =>pptp proflist Profile QoS Relay_PPP1 default PPTPLink default => Encaps nlpid vcmux AC always never RELATED COMMANDS: pptp profadd Define a new PPTP profile. pptp profdelete Delete a PPTP profile. 338 E-DOC-CTC-20040210-0030 v1.
PAGE 341
QoSBook Commands QoSBook Commands Contents This chapter covers the following commands: Topic Page qosbook add 340 qosbook config 342 qosbook delete 343 qosbook flush 344 qosbook list 345 E-DOC-CTC-20040210-0030 v1.
PAGE 342
QoSBook Commands qosbook add Add a Quality of Service (QoS) book entry. SYNTAX: qosbook add name = class = <{ubr|cbr|vbr-rt|vbr-nrt}> [tx_peakrate = ] [tx_sustrate = ] [tx_maxburst = ] [rx_peakrate = ] [rx_sustrate = ] [rx_maxburst = ] [framediscard = <{enabled|disabled}>] where: name The name for the new QoS entry. REQUIRED class The ATM service category.
PAGE 343
QoSBook Commands EXAMPLE: =>qosbook list Name Ref Type TX peak sust burst RX peak sust burst framediscard (Kbits) (Kbits) (bytes) (Kbits) (Kbits) (bytes) default 3 ubr linerate 0 0 linerate 0 0 disabled =>qosbook add name=TestVBR class=vbr-nrt tx_peakrate=1500 tx_sustrate=1000 tx_maxburst=100 rx_sustrate=1000 rx_maxburst=100 framediscard=enabled =>qosbook list Name Ref Type TX peak sust burst RX peak sust burst framediscard (Kbits) (Kbits) (bytes) (Kbits) (Kbits) (bytes) default 3 ubr linerate 0 0 linerat
PAGE 344
QoSBook Commands qosbook config Set or change qosbook config parameters. SYNTAX: qosbook config [format = <{bytes|cells}>] format The input/output format of the qosbook. Choose between: • bytes • cells. OPTIONAL The default is bytes.
PAGE 345
QoSBook Commands qosbook delete Remove a Quality of Service book entry. SYNTAX: qosbook delete name = [force = <{no|yes}>] where: name The name of the QoS book entry to be deleted. REQUIRED force Force deletion of the entry even if it is still in use (yes) or do not force the deletion (no). The default is no.
PAGE 346
QoSBook Commands qosbook flush Flush complete Quality of Service book. Note The flush command does not impact previously saved configurations. SYNTAX: qosbook flush 344 E-DOC-CTC-20040210-0030 v1.
PAGE 347
QoSBook Commands qosbook list Show current Quality of Service book. SYNTAX: qosbook list EXAMPLE: =>qosbook list Name Ref Type default 3 TestVBR 0 => TX peak (Kbits) ubr linerate vbr-nrt 1500 sust (Kbits) 0 1000 burst (bytes) 0 144 RX peak (Kbits) linerate 1500 sust (Kbits) 0 1000 burst (bytes) 0 144 framediscard disabled enabled RELATED COMMANDS: qosbook add Add a QoS book entry. qosbook delete Remove a QoS book entry. E-DOC-CTC-20040210-0030 v1.
PAGE 348
QoSBook Commands 346 E-DOC-CTC-20040210-0030 v1.
PAGE 349
Script Commands Script Commands Introduction Scripting is not a general purpose mechanism but is only used in the autoPVC/ILMI mechanism. Note It is not recommended to change the default scripts. Contents This chapter covers the following commands: Topic Page script add 348 script delete 349 script flush 350 script list 351 script run 352 E-DOC-CTC-20040210-0030 v1.
PAGE 350
Script Commands script add Add a line to a script. SYNTAX: script add name = [index = ] command = where: name Name of script. REQUIRED index Line number (0 = add). OPTIONAL command Command. REQUIRED RELATED COMMANDS: script delete Delete a complete script or a line from a script. script list List script. 348 E-DOC-CTC-20040210-0030 v1.
PAGE 351
Script Commands script delete Delete a complete script or a line from a script. SYNTAX: script delete name = [index = ] where: name Name of script to be deleted. Note index REQUIRED The names of the different scripts can be viewed with the command script list. Line number to be deleted. If no line number is specified, the whole script will be deleted. OPTIONAL RELATED COMMANDS: script add Add a line to a script. script list List script. E-DOC-CTC-20040210-0030 v1.
PAGE 352
Script Commands script flush Flush all scripts. Note The flush command does not impact previously saved configurations. SYNTAX: script flush 350 E-DOC-CTC-20040210-0030 v1.
PAGE 353
Script Commands script list List script(s). SYNTAX: script list [name = ] where: name Name of the script to be shown. OPTIONAL If no name is specified, all the scripts are listed. EXAMPLE Some of the default scripts are shown below: =>script list Script: autopvc_add_qos 0: qosbook add name _auto_$1_$2 class $3 tx_peakrate $4 tx_sustrate $5 tx_maxburst $6 rx_peakrate $4 rx_sustrate $5 rx_maxburst $6 dynamic yes ...
PAGE 354
Script Commands script run Run a script. SYNTAX: script run name = [par1 = ] [par2 = ] [par3 = ] [par4 = ] [par5 = ] [par6 = ] [par7 = ] [par8 = ] [par9 = ] where: name Name of the script to be run. Note par1 ... par9 352 REQUIRED The names of the different scripts can be viewed with the command script list. Parameters to be used in the script. OPTIONAL E-DOC-CTC-20040210-0030 v1.
PAGE 355
SNMP Commands SNMP Commands Contents This chapter covers the following commands: Topic Page snmp config 354 snmp get 355 snmp getNext 356 snmp list 357 snmp walk 358 E-DOC-CTC-20040210-0030 v1.
PAGE 356
SNMP Commands snmp config Show/set global Simple Network Management Protocol (SNMP) parameters. SYNTAX: snmp config [RWCommunity = ] [ROCommunity = ] [sysContact = ] [sysName = ] [sysLocation = ] where: RWCommunity The read-write community name. The default is private. OPTIONAL ROCommunity The read-only community name. The default is public. OPTIONAL sysContact The SNMP system contact. The default is Service Provider.
PAGE 357
SNMP Commands snmp get Get from the supplied SNMP Object IDentifier (OID), e.g. get ObjectId=.1.3.6.1.2.1.1.1.0. SYNTAX: snmp get [ObjectId = ] where: ObjectID The Object Identifier. Object id to get from ... must include the instance which is 0 for scalar objects, e.g. .1.3.6.1.2.1.1.1.0 sysDescription. Note OPTIONAL If not specified, the sysDescription OID .1.3.6.1.2.1.1.1.0 is assumed. Its value is SpeedTouch™. EXAMPLE: =>snmp get VB_octetStr => .1.3.6.1.2.1.1.1.
PAGE 358
SNMP Commands snmp getNext GetNext from the supplied SNMP OID. SYNTAX: snmp getNext [ObjectId = ] where: [ObjectID] The Object Identifier. OPTIONAL Object id to getNext from e.g. .1.3.6.1.2.1.1 system returns sysDescription. EXAMPLE: =>snmp getNext ObjectId=.1.3.6.1.2.1.1.4.0 VB_octetStr .1.3.6.1.2.1.1.5.0 => Sascha RELATED COMMANDS: snmp get Get from the supplied SNMP OID. snmp walk Walk from the supplied SNMP OID. 356 E-DOC-CTC-20040210-0030 v1.
PAGE 359
SNMP Commands snmp list List all SNMP global parameters. SYNTAX: snmp list EXAMPLE: =>snmp list Read-write SNMP community Read-only SNMP community SNMP System Contact : SNMP System Name : SNMP System Location : => E-DOC-CTC-20040210-0030 v1.
PAGE 360
SNMP Commands snmp walk Walk from the supplied SNMP Object IDentifier (OID). SYNTAX: snmp walk [ObjectId = ] where: ObjectID The Object Identifier. OPTIONAL Object id to walk from e.g. .1.3.6.1.2.1.1 system walks the system group. EXAMPLE: =>snmp walk ObjectId=.1.3.6.1.2.1.1 VB_octetStr .1.3.6.1.2.1.1.1.0 VB_objId .1.3.6.1.2.1.1.2.0 VB_timeTicks .1.3.6.1.2.1.1.3.0 VB_octetStr .1.3.6.1.2.1.1.4.0 VB_octetStr .1.3.6.1.2.1.1.5.0 VB_octetStr .1.3.6.1.2.1.1.6.0 VB_integer .1.3.6.1.2.1.1.7.
PAGE 361
Software Commands Software Commands Contents This chapter covers the following commands: Topic Page software version 360 software upgrade 361 E-DOC-CTC-20040210-0030 v1.
PAGE 362
Software Commands software version Show the software version. SYNTAX: software version EXAMPLE: =>software version Flash image : 4.2.7.9.0 Build name : LLT6AA4.279 => 360 E-DOC-CTC-20040210-0030 v1.
PAGE 363
Software Commands software upgrade Reboot the modem to initiate the SW upgrade. New software available on a remote LAN host will be uploaded to the modem. SYNTAX: software upgrade E-DOC-CTC-20040210-0030 v1.
PAGE 364
Software Commands 362 E-DOC-CTC-20040210-0030 v1.
PAGE 365
Switch Commands Switch Commands Introduction These commands are only applicable to the SpeedTouch™510 four port switch version. Contents This chapter covers the following commands: Topic Page switch group flush 364 switch group list 365 switch group move 366 switch mirror capture 367 switch mirror egress 368 switch mirror ingress 369 E-DOC-CTC-20040210-0030 v1.
PAGE 366
Switch Commands switch group flush Set all ports to the default settings, i.e. all ports in group 0. SYNTAX: switch group flush EXAMPLE: =>switch group Group 0 Ports: Group 1 Ports: Group 2 Ports: =>switch group =>switch group Group 0 Ports: => list 4 1 2 3 flush list 1 2 3 4 RELATED COMMANDS: switch group list List all configured groups. switch group move Move a specified port to a specified group. 364 E-DOC-CTC-20040210-0030 v1.
PAGE 367
Switch Commands switch group list List all configured groups. SYNTAX: switch group list EXAMPLE: =>switch group Group 0 Ports: Group 1 Ports: Group 2 Ports: list 4 1 2 3 RELATED COMMANDS: switch group flush Set all ports to the default settings (all ports in group 0). switch group move Move a specified port to a specified group. E-DOC-CTC-20040210-0030 v1.
PAGE 368
Switch Commands switch group move Move a specified port to a specified group. SYNTAX: switch group move group = port = where: group The group id to which the port must be moved. REQUIRED port The port to be moved. REQUIRED EXAMPLE: =>switch group Group 0 Ports: =>switch group =>switch group Group 0 Ports: Group 3 Ports: list 1 2 3 4 move group=3 port=1 list 2 3 4 1 RELATED COMMANDS: switch group flush Set all ports to the default settings (all ports in group 0).
PAGE 369
Switch Commands switch mirror capture Define the specified port to be the Mirror Capture Port. Note Only one port can be the Mirror Capture Port at any one time. SYNTAX: switch mirror capture port = where: port The port to be the Mirror Capture Port. REQUIRED If no port number is specified, then the port number of the Mirror Capture Port is shown.
PAGE 370
Switch Commands switch mirror egress Enable or disable the specified port to be the Mirror Egress Port. Note Only one port can be the Mirror Egress Port at any one time. But a port can be the Mirror Egress Port and the Mirror Ingress Port at the same time. SYNTAX: switch mirror egress port = [state = <{enabled|disabled}>] where: port The port to be the Mirror Egress Port. REQUIRED If no port number is specified, then the port number of the current Mirror Egress Port is shown.
PAGE 371
Switch Commands switch mirror ingress Enable or disable the specified port to be the Mirror Ingress Port. Note Only one port can be the Mirror Ingress Port at any one time. But a port can be the Mirror Egress Port and the Mirror Ingress Port at the same time. SYNTAX: switch mirror ingress port = [state = <{enabled|disabled}>] where: port The port to be the Mirror Ingress Port. REQUIRED If no port number is specified, then the port number of the current Mirror Ingress Port is shown.
PAGE 372
Switch Commands 370 E-DOC-CTC-20040210-0030 v1.
PAGE 373
System Commands System Commands Contents This chapter covers the following commands: Topic Page system clearpassword 372 system config 373 system flush 374 system reboot 375 system reset 376 system setpassword 377 system stats 378 E-DOC-CTC-20040210-0030 v1.
PAGE 374
System Commands system clearpassword Clear current SpeedTouch™ system password. Note To avoid unrestricted and unauthorized access to the SpeedTouch™, it is highly recommended to make sure the SpeedTouch™ is protected by a system password (can be set via the command system setpassword) and to change the password on a regular basis. SYNTAX: system clearpassword EXAMPLE: =>system clearpassword Security notification: Password changed, use 'saveall' to make it permanent.
PAGE 375
System Commands system config Show/set SpeedTouch™ system configuration parameters. Note For a good operation of UPnP™ and the discovery mechanism, it is highly recommended not to change the system config settings.
PAGE 376
System Commands system flush Flush current SpeedTouch™ system configuration, i.e. the System password and the system config settings (dcache excluded). Note 1. To avoid unrestricted and unauthorized access to the SpeedTouch™, it is highly recommended to make sure the SpeedTouch™ is protected by a system password (via the command system setpassword) and to change the password on a regular basis. 2. The flush command does not impact previously saved configurations.
PAGE 377
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-DOC-CTC-20040210-0030 v1.
PAGE 378
System Commands system reset Reset the SpeedTouch™ to its factory default settings and reboot the device. All user and Service Provider specific settings and all saved configuration changes are lost after reboot. SYNTAX: system reset factory yes/no = <{yes|no}> proceed no/yes = <{no|yes}> where: factory yes/no Note proceed no/yes REQUIRED Proceed with resetting the SpeedTouch™ device to its factory default settings (yes) or not (no).
PAGE 379
System Commands system setpassword Set/change the current SpeedTouch™ system password. Note To avoid unrestricted and unauthorized access to the SpeedTouch™, it is highly recommended to make sure the SpeedTouch™ is protected by a system password (via the command system setpassword) and to change the password on a regular basis SYNTAX: system setpassword [userid = ] password = where: userid The new access userid. OPTIONAL password The new access password.
PAGE 380
System Commands system stats Show/set the SpeedTouch™ cpu and memory statistics. SYNTAX: system stats [reset = <{no|yes}>] where: reset Reset cpu statistics.
PAGE 381
Systemlog Commands Systemlog Commands Contents This chapter covers the following commands: Topic Page systemlog flush 380 systemlog show 381 systemlog send 383 E-DOC-CTC-20040210-0030 v1.
PAGE 382
Systemlog Commands systemlog flush Flush all messages in the internal SpeedTouch™ Syslog message buffer. SYNTAX: systemlog flush 380 E-DOC-CTC-20040210-0030 v1.
PAGE 383
Systemlog Commands systemlog show Show syslog messages in the internal SpeedTouch™ Syslog message buffer. SYNTAX: systemlog show [fac = ] [sev = ] [hist = <{no|yes}>] where: fac Optionally, Specify the facility name of the syslog messages to show. Use one of the supported facility names (See “ Supported Syslog Facilities” on page 416 for a listing of syslog facility names supported by the SpeedTouch™).
PAGE 384
Systemlog Commands EXAMPLE: =>syslog msgbuf show fac=kern sev=emerg hist=yes <0> SysUpTime: 14:45:43 KERNEL Controlled restart (after internal error or explicit system reboot) <0> SysUpTime: 02:58:18 KERNEL Controlled restart (after internal error or explicit system reboot) <0> SysUpTime: 04 days 04:52:37 KERNEL Controlled restart (after internal error or explicit system reboot) <0> SysUpTime: 00:00:41 KERNEL Controlled restart (after internal error or explicit system reboot) =>syslog msgbuf show fac=kern
PAGE 385
Systemlog Commands systemlog send Send syslog messages from the internal SpeedTouch™ Syslog message buffer to a specified local or remote syslog server host. SYNTAX: systemlog send [fac = ] [sev = ] [hist = <{no|yes}>] dest = where: fac Specify the facility name of the syslog messages to show.
PAGE 386
Systemlog Commands 384 E-DOC-CTC-20040210-0030 v1.
PAGE 387
TD Commands TD Commands Contents This chapter covers the following commands: Topic td call E-DOC-CTC-20040210-0030 v1.
PAGE 388
TD Commands td call Call a ‘Trace & Debug‘ command. Note For qualified personnel only. SYNTAX: td call cmd = where: cmd 386 Quoted 'Trace & Debug' command string. REQUIRED E-DOC-CTC-20040210-0030 v1.
PAGE 389
UPnP Commands UPnP Commands Contents This chapter covers the following commands: Topic Page upnp config 388 upnp flush 390 upnp list 391 E-DOC-CTC-20040210-0030 v1.
PAGE 390
UPnP Commands upnp config Configure UPnP™ parameter(s). SYNTAX: upnp config [maxage = ] [defcservice = ] [writemode = <{full|natonly|readonly}>] [safenat = <{disabled|enabled}>] [preferredaddress = ] where: maxage This parameter allows to configure how often the SpeedTouch™ sends a notification message to advertise its presence as an Internet Gateway Device IGD) on the network.
PAGE 391
UPnP Commands EXAMPLE (shows the default configuration): =>upnp config ssdp max-age default connection service write mode safe nat entries preferred address multicast interface(s) => E-DOC-CTC-20040210-0030 v1.0 : : : : : : 1800 full disabled eth0 (10.0.0.
PAGE 392
UPnP Commands upnp flush Flush the UPnP™ configuration (i.e. reset to default configuration). SYNTAX: upnp flush 390 E-DOC-CTC-20040210-0030 v1.
PAGE 393
UPnP Commands upnp list List the devices and services currently offered by the SpeedTouch™. Use this command to check whether a PPP connection is properly configured and thus advertised as a PPP service. SYNTAX: upnp list [verbose = ] where: verbose Verbose level. The default is 1. OPTIONAL EXAMPLE: =>upnp list Advertising UPnP devices on address: 10.0.0.138 ---------------- device: IGD.
PAGE 394
UPnP Commands 392 E-DOC-CTC-20040210-0030 v1.
PAGE 395
USB Commands USB Commands Introduction These commands are valid only for the SpeedTouch™530 USB. Contents This chapter covers the following commands: Topic Page usb add 394 usb config 395 usb delete 396 usb info 397 usb list 398 E-DOC-CTC-20040210-0030 v1.
PAGE 396
USB Commands usb add Adds a VP or VC cross-connection between the USB interface and the WAN interface. SYNTAX: usb add wanvpi wanvci usbvpi usbvci [qos = = = = = <{default}>] where: wanvpi A number between 0 and 15. Represents the Virtual Path Identifier (VPI) of WAN interface. REQUIRED wanvci A number between 0 and 511. Represents the Virtual Channel Identifier (VCI) of WAN interface. REQUIRED usbvpi A number between 0 and 15.
PAGE 397
USB Commands usb config Enable/disable the USB interface. SYNTAX: usb config [state = <{enabled|disabled}>] where: state Enable or disable the USB interface. OPTIONAL EXAMPLE: =>usb config USB port state = UP [configured] => E-DOC-CTC-20040210-0030 v1.
PAGE 398
USB Commands usb delete Deletes a cross-connection on the USB interface. SYNTAX: usb delete wanvpi = [wanvci = ] where: wanvpi A number between 0 and 15. Represents the Virtual Path Identifier (VPI) of WAN interface. REQUIRED wanvci A number between 0 and 511. Represents the Virtual Channel Identifier (VCI) of WAN interface. OPTIONAL RELATED COMMANDS: usb add Adds a VP or VC cross-connection between the USB interface and the WAN interface.
PAGE 399
USB Commands usb info Show USB properties/statistics.
PAGE 400
USB Commands usb list Shows all cross-connections on the USB interface. SYNTAX: usb list 398 E-DOC-CTC-20040210-0030 v1.
PAGE 401
Abbreviations Abbreviations The table below lists all the abbreviations used in the CLI Guide.
PAGE 402
Abbreviations Abbreviation Description HTTP HyperText Transfer Protocol ICMP Internet Control Message Protocol IGD Internet Gateway Device IGMP Internet Group Management Protocol IKE Internet Key Exchange IMAP Interim Mail Access Protocol IMAP Interactive Mail Access Protocol IP Internet Protocol IPCP Internet Protocol Control Protocol IPCP IP Payload Compression Protocol IP oA IP over ATM IPSec IP Security IRC Internet Relay Chat ISDN Integrated Services Digital Network LAN
PAGE 403
Abbreviations Abbreviation Description PBX Private Branch Exchange PHB Per Hop Behavior PIP Packet Interception Point PKCS Public Key Cryptography Standard PKI Public Key Infrastructure POP Post Office Protocol POTS Plain Old Telephone Service PPP Point-to-Point Protocol PPPoA PPP over ATM PPPoE PPP over Ethernet PPTP Point-to-Point Tunneling Protocol PSD Power Spectral Density PVC Permanent Virtual Channel QoS Quality of Service RIP Routing Information Protocol RTMP RouTin
PAGE 404
Abbreviations Abbreviation Description UPnP Universal Plug and Play URI Uniform Resource Identifier URL Uniform Resource Locator VC Virtual Channel VCMUX Virtual Channel MUltipleXing VDSL Very high speed Digital Subscriber Line VLSM Variable Length Subnet Masking VP Virtual Path VPN Virtual Private Networking WAN Wide Area Network WCD WAN Connection Device WEP Wired Equivalent Privacy WFQ Weighted Fair Queueing WINS Windows Internet Naming Service WLAN Wireless LAN WWW Worl
PAGE 405
Syslog Messages Syslog Messages Introduction This chapter lists the different Syslog messages.
PAGE 406
Syslog Messages Auto-PVC Module Facility Severity Contents LOCAL5 WARNING AUTOPVC script failed LOCAL5 WARNING AUTOPVC script failed LOCAL5 WARNING AUTOPVC script (name1, qosb_name) failed LOCAL5 WARNING AUTOPVC script (name1, qosb_name, name2) failed LOCAL5 WARNING AUTOPVC script 'autopvc_change_qos (itable[i].
PAGE 407
Syslog Messages DHCP CLient Module Facility Severity Contents LOCAL2 WARNING DHCP lease ip-address bound to intf LOCAL2 WARNING DHCP intf renews lease ip-address LOCAL2 WARNING DHCP intf rebinds lease ip-address from server () LOCAL2 WARNING DHCP offer received from (can be relay agent) for intf LOCAL2 WARNING DHCP server () offers to intf LOCAL2 WARN
PAGE 408
Syslog Messages DHCP Server Module Facility Severity Contents LOCAL2 WARNING DHCP server: %s cannot be send due to invalid server identifier LOCAL2 WARNING DHCP server: DHCPACK cannot be send due to invalid server identifier LOCAL2 WARNING DHCP server: DHCPNAK cannot be send due to invalid server identifier LOCAL2 WARNING DHCP Auto DHCP: server detected on LAN, own dhcp server disabled LOCAL2 WARNING DHCP Auto DHCP: no server detected on LAN, SpeedTouch server started LOCAL2 WARNING DHC
PAGE 409
Syslog Messages Kernel Module Facility Severity Contents KERN WARNING KERNEL cold reset KERN WARNING KERNEL warm reset KERN EMERG KERNEL Controlled restart (after internal error or explicit system reboot) Linestate Module Facility Severity Contents LOCAL5 NOTICE xDSL linestate up (downstream: kbit/s, upstream: kbit/s) LOCAL5 NOTICE xDSL linestate down Login Module Facility Severity Contents AUTH NOTICE LOGIN User logged on telnet (
PAGE 410
Syslog Messages PPP Module Facility Severity Contents LOCAL0 WARNING PPP Link up () LOCAL0 WARNING PPP Link down () AUTH ERROR PPP PAP authentication failed () [protocol reject] AUTH INFO PPP PAP on intf no response to PAP authenticate-request AUTH NOTICE PPP PAP remote user successful authenticated AUTH ERROR PPP PAP authentication for remote user failed AUTH DEBUG PPP PAP Authenticate Ack received AUTH DE
PAGE 411
Syslog Messages Software Module Facility Severity Contents KERN INFO SOFTWARE Copying all data files from to KERN INFO SOFTWARE Switchover going down in seconds KERN INFO SOFTWARE No passive software found, duplicating active software KERN INFO SOFTWARE Duplication of active software failed UPnP Module Facility Severity Contents WARNING SECURITY UPnP refused for ip= NOTICE SECURITY UPnP () for
PAGE 412
Syslog Messages 410 E-DOC-CTC-20040210-0030 v1.
PAGE 413
Supported Key Names Supported Key Names Contents This chapter lists all the key names supported by the SpeedTouch™, that can be used for completing CLI command parameters. Supported Internet Protocol (IP) Protocol Names For more information on the listed IP protocols, see RFC1340 or www.iana.org.
PAGE 414
Supported Key Names Supported TCP/UDP Port Names For more information on the listed TCP/UDP port assignments, see RFC1340 or www.iana.org.
PAGE 415
Supported Key Names Port name Number TCP UDP Description sntp 123 Y Y Simple Network Time Protocol (SNTP) ntp 123 Y Y Network Time Protocol (NTP) ingres-net 134 Y Y INGRES-NET Service netbios-ns 137 Y Y NETBIOS Naming System netbios-dgm 138 Y Y NETBIOS Datagram Service netbios-ssn 139 Y Y NETBIOS Session Service imap2 143 Y Y Interim Mail Access Protocol (IMAP) v2 sql-net 150 Y Y SQL-NET pcmail-srv 158 Y Y PCMail Server snmp 161 Y Y Simple Network Manag
PAGE 416
Supported Key Names Port name Number TCP UDP Description talk 517 Y Y Like Tenex link, but across machine ntalk 518 Y Y NTalk utime 519 Y Y UNIX Time rip 520 - Y Local routing process (on site); uses variant of Xerox NS Routing Information Protocol (RIP) timed 525 Y Y Timeserver netwall 533 Y Y For emergency broadcasts uucp 540 Y Y uucpd uucp-rlogin 540 Y Y uucpd remote login new-rwho 540 Y Y uucpd remote who is rtsp 554 Y Y Real Time Stream Control Pro
PAGE 417
Supported Key Names Supported ICMP Type Names For more information on the listed ICMP type names, see RFC1340 or www.iana.org.
PAGE 418
Supported Key Names Supported Syslog Facilities For more information on the listed Syslog facilities, see RFC3164.
PAGE 419
Supported Key Names Supported Syslog Severities For more information on the listed Syslog severities, see RFC3164.
PAGE 420
Supported Key Names 418 E-DOC-CTC-20040210-0030 v1.
PAGE 421