The LANCOM command-line interface can be operated with the following DOS- or UNIX-style commands. The LCOS menu commands that are available to you can be displayed at any time by entering HELP at the command line.
Note: Supervisor rights are necessary to execute some commands.
| Command | Description |
|---|---|
| beginscript | Resets the console session to script mode. In this state, commands entered are not transferred directly to the LANCOM's configuration RAM but initially to the device's script memory. |
| cd [PATH] | Switch to the current directory. Various abbreviations can be used, such as replacing " cd ../.." with "cd ...", etc. |
| del [PATH]* | Deletes the table in the branch of the menu tree defined with Path. |
| default [-r] [PATH] | Resets individual parameters, tables or entire menu trees back to their default configuration. If PATH indicates a branch of the menu tree, then the option -r (recursive) must be entered. |
| dir [PATH] list [PATH] ls [PATH] ll [PATH] | Displays the current directory content. The suffix parameter "-a" lists the SNMP IDs associated with the content of the query. The output begins with the SNMP ID of the device followed by the SNMP ID of the current menu. The SNMP IDs of the subordinate items can be read from the individual entries. |
| do [PATH] [<Parameter>] | Executes the action [PATH] in the current directory. Other parameters can be entered in addition. |
| echo <ARG>... | Display argument on console |
| exit/quit/x | Ends the command line session |
| feature <code> | Activation of a software feature with the feature code as entered |
| flash Yes/No | Changes to the configuration using commands in the command line are written directly to the boot-resistant Flash memory of the devices as standard (flash yes). If updating the configuration is suppressed in Flash (flash no), changes are only stored in RAM (deleted on booting). |
| history | Displays a list of recently executed commands. Command "!#“ can be used to directly call the list commands using their number (#): For example, "!3“ runs the third list command. |
| killscript | Deletes the script session contents yet to be processed. The script session is selected by its name. |
| loadconfig | Load configuration into device via TFTP client |
| loadfirmware | Load firmware into device via TFTP client |
| loadscript | Load script into device via TFTP client |
| passwd | Change password |
| passwd -n new [old] | Change password (no prompt) |
| ping [IP address or name] | Sends an ICMP echo request to the IP address specified |
| readconfig | Display of the entire configuration in the device syntax |
| readmib | Display of the SNMP Management Information Base |
| readscript [-n] [-d] [-c] [-m] [PATH] | In a console session, the readscript command generates a text dump of all commands and parameters required to configure the LANCOM in its current state. |
| repeat <INTERVAL> <Command> | Repeats the command every INTERVAL seconds until the process is ended with new input |
| sleep [-u] value[suffix] | Delays the processing of configuration commands by a particular time or terminates them at a particular time. Permissible suffixes are s, m and h for seconds, minutes and hours. If no suffix is defined, the command uses milliseconds. With option switch -u, the sleep command accepts times in format MM/DD/YYYY hh:mm:ss (English) or in format TT.MM.JJJJ hh:mm:ss (German). Date configuration is only accepted if the system time is set. |
| stop | Ends the PING command |
| set [PATH] <value(s)> | Sets a configuration parameter to a particular value. If the configuration parameter is a table value, a value must be specified for each column. Entering the "*" character leaves any existing table entry unchanged. |
| set [PATH] ? | Listing of the possible input values for a configuration parameter. If no name is specified, the possible input values for all configuration parameters in the current directory are specified. |
| setenv <NAME> <VALUE> | Set environment variable |
| unsetenv <NAME> | Delete environment variable |
| getenv <NAME> | Display environment variable (no line feed) |
| printenv | Display the entire environment |
| show <options> | Display of special internal data. show ? displays all available information, such as most recent boot processes (’bootlog’), firewall filter rules (’filter’), VPN rules (’VPN’) and memory usage (’mem’ and ’heap’) |
| sysinfo | Display of system information (e.g. hardware/software version) |
| testmail | Sends an e-mail. See 'testmail ?' for parameters |
| time | Set time (DD.MM.YYYY hh:mm:ss) |
| trace […] | Configuration of the diagnostics display. |
| who | List active sessions |
| writeconfig | Load a new configuration file in the device syntax. All subsequent lines are interpreted as configuration values until two blank lines occur |
| writeflash | Load a new firmware file (only via TFTP) |
| !! | Repeat last command |
| !<num> | Repeat command <num> times |
| !<prefix> | Repeat last command beginning with <prefix> |
| #<blank> | Comment |
- PATH:
- Path name for a menu or parameter, separated by / or \
- .. means one level higher
- . means the current level
- VALUE:
- Possible input value
- "" is a blank input value
- NAME:
- Sequence of characters (made up of _ 0..9 A..Z)
- First character cannot be a digit
- Case insensitive
- All commands and directory/parameter names can be entered using their short-forms as long as they are unambiguous. For example, command ”sysinfo” can be shortened to ”sys” and ”cd Management” to ”c ma”. Input ”cd /s” is not valid, however, since it corresponds to both ”cd /Setup” and ”cd /Status”.
- Names that contain spaces must be enclosed within quotation marks (““).
- A command-specific help function is available for actions and commands (call the function with a question mark as the parameter). For example, 'ping ?’ shows the options of the integrated ping command.
- Enter ’?’ on the command line for a complete listing of the console commands available.