cc/td/doc/product/aggr/vpn5000/5000sw/conc52x/ref52x
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

show config

show config

The show config command is used to display various aspects of a text-based configuration that is stored in the device or being modified. For information about the format and syntax of the configuration, please refer to the manual page for each section of the configuration. The list command in the configuration editor uses the same options as show config, except for the section_name, which is implied by the section you are in when you use list. See the "Configure Command" section to enter the configuration editor.

show config [help | list | number |
cook [all | defaults | mark | verbose [#] | origin]]
[
section_name]

Syntax Description

section_name

The section_name must be a valid configuration section and must be fully spelled out in order to be found. If no section name is specified, the entire device configuration will be displayed.

help

The help option is used to generate a message showing all of the options available and a short description of how the option is used.

list

The list option will generate a list of section names known to the device. Not all devices understand all sections listed in this manual, because configuration information is dependent on which features a device has.

number

The number option will cause line numbers to be printed as the configuration is displayed.

cook

Cooked mode is used to display different aspects of the configuration. In cooked mode, the configuration will be reformatted and reordered, and comments will be stripped out of port-specific and general configuration sections. Cooked mode must be enabled using the cook option.

Once the cook option has been specified, the configuration parser will be run causing the configuration to be checked for errors as it is being displayed. The following options may be used with the cook option to tailor the display or find out different information.

  • all. The all option tells the command to display all possible variables in each section, whether they exist in your configuration or not. Normally the cooked mode display command will display configured values and important default keywords and values.

  • defaults. The defaults option causes only default values built into the device to be displayed. Use this option to display the factory default configuration. This option may be used with the all option to display all keywords and values built into the device.

  • mark. The mark option is useful to highlight the differences between the current configuration and the device's defaults. If a keyword's value differs from the default, the default value will be printed out as a comment on the line. This option may not be used with the defaults option.

  • origin. If default sections are used in a hierarchical configuration, the origin command is useful to determine from which line and section a value was found.

  • verbose[#]. The verbose option is used to generate verbose parser output. This is useful only when trying to determine why a configuration parameter is being set to a mysterious value. You may optionally specify different levels of information ranging from level 1 to 7. Level 7 is the most verbose.

Usage Guidelines

In addition to simply displaying a configuration, these commands can be used to:

A configuration can be displayed using one of the two basic modes, raw and cooked. Raw mode is the default way a configuration or section of a configuration will be displayed. In this mode, the configuration will be displayed exactly as it is stored in the device's permanent configuration memory, or, in the case of an edited configuration, as it exists in the edit buffer. When a configuration is displayed using cooked mode, the device will run the raw configuration through a parser to check the values in the configuration. This mode is called "cooked" because the data being displayed has been prepared for display.

When editing a configuration, it is possible to run the configuration through the same parsers that the device uses to initialize itself. Use the existing show * config commands (e.g., show ip config) to run these parsers.

Examples

The following sections show an example for each command.

show config Example

The following example displays a raw version of a configuration section.

show config IP WAN 0
[ IP Wan 0 ]
RIPVersion               = V1   # Turnn RIP on
Numbered                 = TRUE
IPAddress                = 31.0.0.5
SubnetMask               = 255.0.0.0
IPBroadcast              = 31.255.255.255
RemoteAddress            = 0.0.0.0
Updates                  = periodic
 

show config cook Example

The next example shows the same section cooked.

show config cook IP WAN 0
[ IP Wan 0 ]
Mode                     = Routed
IPAddress                = 31.0.0.5
SubnetMask               = 255.0.0.0
IPBroadcast              = 31.255.255.255
RIPVersion               = V1
OutFilters               = 
InFilters                = 
Numbered                 = On
Updates                  = Periodic
RemoteAddress            = 0.0.0.0
 

Notice that the comments have been removed and the configuration has been reformatted. Also notice that several additional keywords have been added to the display. The additional keywords are considered important variables and as such they are displayed in cooked configurations.

show config cook mark Example

The following example shows the same configuration displayed using the mark option.

show config cook mark IP WAN 0
[ IP Wan 0 ]
Mode                     = Routed
IPAddress                = 31.0.0.5           # Default => 0.0.0.0 
SubnetMask               = 255.0.0.0          # Default => 0.0.0.0 
IPBroadcast              = 31.255.255.255     # Default => 0.0.0.0 
RIPVersion               = V1                 # Default => None 
OutFilters               = 
InFilters                = 
Numbered                 = On                 # Default => Off 
Updates                  = Periodic           # Default =>Triggered 
RemoteAddress            = 0.0.0.0
 

show config cook origin Example

The next sequence of commands illustrates the use of hierarchies and the origin option.

 *[ IP Wan 0 ]# configure ip wan default

Section 'ip wan default' not found in the config. 
Do you want to add it to the config? y

 
Configure parameters in this section by entering:
 
   <Keyword> = <Value>
 
To find a list of valid keywords and additional help enter "?"
 
*[ IP Wan Default ]# mode = bridged

*[ IP Wan Default ]# list

[ IP Wan Default ]
Mode                      = Bridged
 
 
*[ IP Wan Default ]# show config cook origin ip wan 0

# TBM Parser: Looking for: IP Wan 0: Mode
#      Found in Cfg Buffer, line 231, section 'IP Wan Default'
[ IP Wan 0 ]
# TBM Parser: Looking for: IP Wan 0: Mode
#      Found in Cfg Buffer, line 231, section 'IP Wan Default'
Mode                     = Bridged
# TBM Parser: Looking for: IP Wan 0: IPAddress
#      Found in Cfg Buffer, line 26, section 'IP Wan 0'
IPAddress                = 31.0.0.5
# TBM Parser: Looking for: IP Wan 0: SubnetMask
#      Found in Cfg Buffer, line 27, section 'IP Wan 0'
SubnetMask               = 255.0.0.0
# TBM Parser: Looking for: IP Wan 0: IPBroadcast
#      Found in Cfg Buffer, line 28, section 'IP Wan 0'
IPBroadcast              = 31.255.255.255
 

Display continues for a while...

*[ IP Wan Default ]# 
 

Notice in the preceding display, the value of the Mode keyword is set to Bridged even though it is not set in the [ IP Wan 0 ] section. The display shows which line and in which section all of the keywords were found.

Related Commands

Command Description

configure

Enters the configuration editor, which allows you to add or modify configuration variables using keyword and value pairs and ensures that they are syntactically correct


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Sep 27 11:45:22 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.