Definition Type: Element
Name: interface_test
Namespace: http://oval.mitre.org/XMLSchema/oval#windows
Type: oval:standardTestType
Containing Schema: windows-schema.xsd
Abstract
Documentation:
Enumerate various attributes about the interfaces on a system. Each interface is uniquely identified by either its name or an index number. For help with this test see the MIB_IFROW and MIB_IPADDRROW structures.
Collapse XSD Schema Diagram:
Drilldown into data in schema windows-schema_xsd Drilldown into object in schema windows-schema_xsd Drilldown into notes in schema oval-schema_xsd Drilldown into comment in schema oval-schema_xsd Drilldown into id in schema oval-schema_xsd Drilldown into testType in schema oval-schema_xsd Drilldown into check in schema oval-schema_xsd Drilldown into standardTestType in schema oval-schema_xsdXSD Diagram of interface_test in schema windows-schema_xsd (Open Vulnerability and Assessment Language (OVAL®))
Collapse XSD Schema Code:
<xsd:element name="interface_test" substitutionGroup="oval:test">
    <xsd:annotation>
        <xsd:documentation>Enumerate various attributes about the interfaces on a system.  Each interface is uniquely identified by either its name or an index number.  For help with this test see the MIB_IFROW and MIB_IPADDRROW structures.</xsd:documentation>
        <xsd:appinfo>
            <test_name>Interface Test</test_name>
            <extends>standardTestType</extends>
            <valid_sections>notes, object, data</valid_sections>
            <example>
                <interface_test id="wit-0" check="all" comment="the interface exists with the specified properties" xmlns="http://oval.mitre.org/XMLSchema/oval#windows">
                    <oval:notes xmlns:oval="http://oval.mitre.org/XMLSchema/oval">
                        <oval:note>This is an example test written under version 4 of the OVAL schema.  It is meant to give a short overview of the test and might not contain every possible child element.</oval:note>
                    </oval:notes>
                    <object>
                        <name>Intel(R) PRO/1000 MTW Network Connection - Packet Scheduler Miniport</name>
                    </object>
                    <data operation="AND">
                        <type>MIB_IF_TYPE_ETHERNET</type>
                        <hardware_addr>33-22-11-AA-CC-BB</hardware_addr>
                        <inet_addr>123.45.67.89</inet_addr>
                    </data>
                </interface_test>
            </example>
        </xsd:appinfo>
    </xsd:annotation>
    <xsd:complexType>
        <xsd:complexContent>
            <xsd:extension base="oval:standardTestType">
                <xsd:sequence>
                    <xsd:element name="object" minOccurs="1" maxOccurs="1">
                        <xsd:complexType>
                            <xsd:complexContent>
                                <xsd:extension base="oval:objectType">
                                    <xsd:sequence>
                                        <xsd:element name="name" type="oval:subtestStringType" minOccurs="1" maxOccurs="1">
                                            <xsd:annotation>
                                                <xsd:documentation>This element specifies the name of an interface.</xsd:documentation>
                                                <xsd:appinfo>
                                                    <parent_test>Interface Test</parent_test>
                                                    <cardinality>1</cardinality>
                                                    <content>string</content>
                                                    <valid_datatypes>string</valid_datatypes>
                                                    <valid_operators>equals, not equal, pattern match</valid_operators>
                                                </xsd:appinfo>
                                            </xsd:annotation>
                                        </xsd:element>
                                    </xsd:sequence>
                                </xsd:extension>
                            </xsd:complexContent>
                        </xsd:complexType>
                    </xsd:element>
                    <xsd:element name="data" minOccurs="0" maxOccurs="1">
                        <xsd:complexType>
                            <xsd:complexContent>
                                <xsd:extension base="oval:dataType">
                                    <xsd:sequence>
                                        <xsd:element name="index" type="oval:subtestIntType" minOccurs="0" maxOccurs="1">
                                            <xsd:annotation>
                                                <xsd:documentation>This element specifies index that identifies the interface.</xsd:documentation>
                                                <xsd:appinfo>
                                                    <parent_test>Interface Test</parent_test>
                                                    <cardinality>0-1</cardinality>
                                                    <content>integer</content>
                                                    <valid_datatypes>integer</valid_datatypes>
                                                    <valid_operators>equals, not equal, greater than, less than, greater than or equal, less than or equal</valid_operators>
                                                </xsd:appinfo>
                                            </xsd:annotation>
                                        </xsd:element>
                                        <xsd:element name="type" minOccurs="0" maxOccurs="1">
                                            <xsd:annotation>
                                                <xsd:documentation>This element specifies the type of interface which is limited to certain set of values.</xsd:documentation>
                                                <xsd:appinfo>
                                                    <parent_test>Interface Test</parent_test>
                                                    <cardinality>0-1</cardinality>
                                                    <content>string</content>
                                                    <valid_datatypes>string</valid_datatypes>
                                                    <valid_operators>equals, not equal</valid_operators>
                                                </xsd:appinfo>
                                            </xsd:annotation>
                                            <xsd:complexType>
                                                <xsd:simpleContent>
                                                    <xsd:restriction base="oval:subtestStringType">
                                                        <xsd:enumeration value="MIB_IF_TYPE_ETHERNET" />
                                                        <xsd:enumeration value="MIB_IF_TYPE_FDDI" />
                                                        <xsd:enumeration value="MIB_IF_TYPE_LOOPBACK" />
                                                        <xsd:enumeration value="MIB_IF_TYPE_OTHER" />
                                                        <xsd:enumeration value="MIB_IF_TYPE_PPP" />
                                                        <xsd:enumeration value="MIB_IF_TYPE_SLIP" />
                                                        <xsd:enumeration value="MIB_IF_TYPE_TOKENRING" />
                                                    </xsd:restriction>
                                                </xsd:simpleContent>
                                            </xsd:complexType>
                                        </xsd:element>
                                        <xsd:element name="hardware_addr" type="oval:subtestStringType" minOccurs="0" maxOccurs="1">
                                            <xsd:annotation>
                                                <xsd:documentation>This element specifies the the physical address of the adapter for this interface.</xsd:documentation>
                                                <xsd:appinfo>
                                                    <parent_test>Interface Test</parent_test>
                                                    <cardinality>0-1</cardinality>
                                                    <content>string</content>
                                                    <valid_datatypes>string</valid_datatypes>
                                                    <valid_operators>equals, not equal, pattern match</valid_operators>
                                                </xsd:appinfo>
                                            </xsd:annotation>
                                        </xsd:element>
                                        <xsd:element name="inet_addr" type="oval:subtestStringType" minOccurs="0" maxOccurs="1">
                                            <xsd:annotation>
                                                <xsd:documentation>This element specifies the IP address.</xsd:documentation>
                                                <xsd:appinfo>
                                                    <parent_test>Interface Test</parent_test>
                                                    <cardinality>0-1</cardinality>
                                                    <content>string</content>
                                                    <valid_datatypes>string</valid_datatypes>
                                                    <valid_operators>equals, not equal, pattern match</valid_operators>
                                                </xsd:appinfo>
                                            </xsd:annotation>
                                        </xsd:element>
                                        <xsd:element name="broadcast_addr" type="oval:subtestStringType" minOccurs="0" maxOccurs="1">
                                            <xsd:annotation>
                                                <xsd:documentation>This element specifies the broadcast address. A broadcast address is typically the IP address with the host portion set to either all zeros or all ones.</xsd:documentation>
                                                <xsd:appinfo>
                                                    <parent_test>Interface Test</parent_test>
                                                    <cardinality>0-1</cardinality>
                                                    <content>string</content>
                                                    <valid_datatypes>string</valid_datatypes>
                                                    <valid_operators>equals, not equal, pattern match</valid_operators>
                                                </xsd:appinfo>
                                            </xsd:annotation>
                                        </xsd:element>
                                        <xsd:element name="netmask" type="oval:subtestStringType" minOccurs="0" maxOccurs="1">
                                            <xsd:annotation>
                                                <xsd:documentation>This element specifies the subnet mask for the IP address.</xsd:documentation>
                                                <xsd:appinfo>
                                                    <parent_test>Interface Test</parent_test>
                                                    <cardinality>0-1</cardinality>
                                                    <content>string</content>
                                                    <valid_datatypes>string</valid_datatypes>
                                                    <valid_operators>equals, not equal, pattern match</valid_operators>
                                                </xsd:appinfo>
                                            </xsd:annotation>
                                        </xsd:element>
                                        <xsd:element name="addr_type" minOccurs="0" maxOccurs="unbounded">
                                            <xsd:annotation>
                                                <xsd:documentation>This element specifies the address type or state of a specific interface.  Each interface can be associated with more than one value meaning the addr_type element can occur multiple times.</xsd:documentation>
                                                <xsd:appinfo>
                                                    <parent_test>Interface Test</parent_test>
                                                    <cardinality>0-n</cardinality>
                                                    <content>string</content>
                                                    <valid_datatypes>string</valid_datatypes>
                                                    <valid_operators>equals, not equal</valid_operators>
                                                </xsd:appinfo>
                                            </xsd:annotation>
                                            <xsd:complexType>
                                                <xsd:simpleContent>
                                                    <xsd:restriction base="oval:subtestStringType">
                                                        <xsd:enumeration value="MIB_IPADDR_DELETED" />
                                                        <xsd:enumeration value="MIB_IPADDR_DISCONNECTED" />
                                                        <xsd:enumeration value="MIB_IPADDR_DYNAMIC" />
                                                        <xsd:enumeration value="MIB_IPADDR_PRIMARY" />
                                                        <xsd:enumeration value="MIB_IPADDR_TRANSIENT" />
                                                    </xsd:restriction>
                                                </xsd:simpleContent>
                                            </xsd:complexType>
                                        </xsd:element>
                                    </xsd:sequence>
                                </xsd:extension>
                            </xsd:complexContent>
                        </xsd:complexType>
                    </xsd:element>
                </xsd:sequence>
            </xsd:extension>
        </xsd:complexContent>
    </xsd:complexType>
</xsd:element>
Collapse Child Elements:
Name Type Min Occurs Max Occurs
notes oval:notes 0 1
object windows:object 1 1
data windows:data 0 1
Collapse Child Attributes:
Name Type Default Value Use
id oval:id Required
comment oval:comment Required
check oval:check all Optional
Collapse Derivation Tree:
Collapse References:
oval:test