- Open Vulnerability and Assessment Language -
Element Dictionary

The following is a description of the elements, types, and attributes that compose the IOS specific system characteristic items found in Open Vulnerability and Assessment Language (OVAL). Each item is an extension of the standard item element defined in the Core System Characteristic Schema. Through extension, each item inherits a set of elements and attributes that are shared amongst all OVAL Items. Each item is described in detail and should provide the information necessary to understand what each element and attribute represents. This document is intended for developers and assumes some familiarity with XML. A high level description of the interaction between the different tests and their relationship to the Core System Characteristic Schema is not outlined here.

The OVAL Schema is maintained by The MITRE Corporation and developed by the public OVAL Community. For more information, including how to get involved in the project and how to submit change requests, please visit the OVAL website at http://oval.mitre.org.



< global_item >

Sotres information about the existence of a particular line in the ios config file under the global context

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
global_command oval-sc:EntityItemStringType 0 1



< interface_item >

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
name oval-sc:EntityItemStringType 0 1
ip_directed_broadcast_command oval-sc:EntityItemStringType 0 1
no_ip_directed_broadcast_command oval-sc:EntityItemStringType 0 1
proxy_arp_command oval-sc:EntityItemStringType 0 1
shutdown_command oval-sc:EntityItemStringType 0 1



< line_item >

Stores the properties of specific lines in the ios config file.

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
show_subcommand oval-sc:EntityItemStringType 0 1
The name of the SHOW sub-command.
config_line oval-sc:EntityItemStringType 0 1
The value returned from by the specified SHOW sub-command.



< snmp_item >

Stores results from collecting lines under the global context associated with snmp.

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
access_list oval-sc:EntityItemStringType 0 1
community_name oval-sc:EntityItemStringType 0 1



< tclsh_item >

The tclsh item holds information about the availability of tcl on the IOS operating system. It extends the standard ItemType as defined in the oval-system-characteristics schema and one should refer to the ItemType description for more information.

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
available oval-sc:EntityItemBoolType 0 1
This boolean entity describes whether TCLSH is available on the system. A value of true means that TCLSH is available. Per Cisco documentation, the accepted way to see if the device supports tcl functionality is to enter the tcl shell. If the attempt results in a tcl prompt then the device supports tclsh and has it enabled.



< version_item >

The version_item holds information about the version of the IOS operating system. It extends the standard ItemType as defined in the oval-system-characteristics schema and one should refer to the ItemType description for more information.

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
major_release oval-sc:EntityItemStringType 0 1
The major_release is a combination of train and rebuild information and is used by Cisco advisories to identify major releases.
train_number oval-sc:EntityItemStringType 0 1
The train number is the dotted version that starts a version string. For example the version string 12.2(3)T has a train number of 12.2.
major_version oval-sc:EntityItemIntType 0 1
The major_version entity specifies the major version piece of the version string. The value is an integer and in the example 12.4(9)T0a the major version is '12'.
minor_version oval-sc:EntityItemIntType 0 1
The minor_version entity specifies the minor version piece of the version string. The value is an integer and in the example 12.4(9)T0a the minor version is '4'.
release oval-sc:EntityItemIntType 0 1
The release entity specifies the release piece of the version string. The value is an integer and in the example 12.4(9)T0a the release is '9'.
train_identifier oval-sc:EntityItemStringType 0 1
The train identifier is the type of Train. For example the version string 12.2(3)T has a train identifier of T. Please see the EntityItemTrainIdentifierType for more information about the different train identifiers.The train_identifier entity specifies the type of train represented in the version string. The value is a string and in the example 12.4(9)T0a the train identifier is 'T'. The following explaination from Wikipedia should help explain the different train identifiers. Cisco IOS releases are split into several "trains", each containing a different set of features. Trains more or less map onto distinct markets or groups of customers that Cisco is targeting. The 'mainline' train is designed to be the most stable release the company can offer, and its feature set never expands during its lifetime. Updates are released only to address bugs in the product. The previous technology train becomes the source for the current mainline train--for example, the 12.1T train becomes the basis for the 12.2 mainline. Therefore, to determine the features available in a particular mainline release, look at the previous T train release. The 'T' (Technology) train, gets new features and bug fixes throughout its life, and is therefore less stable than the mainline. (In releases prior to Cisco IOS Release 12.0, the P train served as the Technology train.) The 'S' (Service Provider) train, runs only on the company's core router products and is heavily customized for Service Provider customers. The 'E' (Enterprise) train, is customized for implementation in enterprise environments. The 'B' (broadband) train, support internet based broadband features. The 'XA', 'Xb' ... (special functionality) train, needs to be documented. There are other trains from time to time, designed for specific needs -- for example, the 12.0AA train contained new code required for Cisco's AS5800 product.
rebuild oval-sc:EntityItemIntType 0 1
The rebuild entity specifies the rebuild piece of the version string The value is an integer and in the example 12.4(9)T0a the rebuild is '0'. Often a rebuild is compiled to fix a single specific problem or vulnerability for a given IOS version. For example, 12.1(8)E14 is a Rebuild, the 14 denoting the 14th rebuild of 12.1(8)E. Rebuilds are produced to either quickly repair a defect, or to satisfy customers who do not want to upgrade to a later major revision because they may be running critical infrastructure on their devices, and hence prefer to minimise change and risk.
subrebuild oval-sc:EntityItemStringType 0 1
The subrebuild entity specifies the subrebuild piece of the version string. The value is a string and in the example 12.4(9)T0a the subrebuild is 'a'.
mainline_rebuild oval-sc:EntityItemStringType 0 1
The mainline_rebuild entity specifies the mainline rebuild piece of the version string. The mainline rebuild is just a regular rebuild release against the mainline operating system release (e.g. the branch of development that would typically be called "the trunk" that isn't associated with a train). Since there is no train identifier to stick the rebuild release after, they stick a alphabetic character inside the parens holding the maintenance release number. For example, 12.4(5b) is the second rebuild of the 12.4(5) maintenance release.
version_string oval-sc:EntityItemIOSVersionType 0 1
The version entity holds the raw string output of a 'show version' command.