Connected: An Internet Encyclopedia
RFC 1907 - 2.1. The System Group

Top: Connected: An Internet Encyclopedia
Up: Requests For Comments
Up: RFC 1907
Up: 2. Definitions
Prev: 2. Definitions
Next: 2.2. The SNMP Group

### 2.1. The System Group

    -- the System group
    --
    -- a collection of objects common to all managed systems.

    system   OBJECT IDENTIFIER ::= { mib-2 1 }

    sysDescr OBJECT-TYPE
        SYNTAX      DisplayString (SIZE (0..255))
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
                "A textual description of the entity.  This value should
                include the full name and version identification of the
                system's hardware type, software operating-system, and
                networking software."
        ::= { system 1 }

    sysObjectID OBJECT-TYPE
        SYNTAX      OBJECT IDENTIFIER
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
                "The vendor's authoritative identification of the network
                management subsystem contained in the entity.  This value is
                allocated within the SMI enterprises subtree (1.3.6.1.4.1)
                and provides an easy and unambiguous means for determining
                `what kind of box' is being managed.  For example, if vendor
                `Flintstones, Inc.' was assigned the subtree
                1.3.6.1.4.1.4242, it could assign the identifier
                1.3.6.1.4.1.4242.1.1 to its `Fred Router'."
        ::= { system 2 }

    sysUpTime OBJECT-TYPE
        SYNTAX      TimeTicks
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
                "The time (in hundredths of a second) since the network
                management portion of the system was last re-initialized."
        ::= { system 3 }

    sysContact OBJECT-TYPE
        SYNTAX      DisplayString (SIZE (0..255))
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
                "The textual identification of the contact person for this
                managed node, together with information on how to contact
                this person.  If no contact information is known, the value
                is the zero-length string."
        ::= { system 4 }

    sysName OBJECT-TYPE
        SYNTAX      DisplayString (SIZE (0..255))
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
                "An administratively-assigned name for this managed node.
                By convention, this is the node's fully-qualified domain
                name.  If the name is unknown, the value is the zero-length
                string."
        ::= { system 5 }

    sysLocation OBJECT-TYPE
        SYNTAX      DisplayString (SIZE (0..255))
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
                "The physical location of this node (e.g., `telephone
                closet, 3rd floor').  If the location is unknown, the value
                is the zero-length string."
        ::= { system 6 }

    sysServices OBJECT-TYPE
        SYNTAX      INTEGER (0..127)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
                "A value which indicates the set of services that this
                entity may potentially offers.  The value is a sum.  This
                sum initially takes the value zero, Then, for each layer, L,
                in the range 1 through 7, that this node performs
                transactions for, 2 raised to (L - 1) is added to the sum.
                For example, a node which performs only routing functions
                would have a value of 4 (2^(3-1)).  In contrast, a node
                which is a host offering application services would have a
                value of 72 (2^(4-1) + 2^(7-1)).  Note that in the context
                of the Internet suite of protocols, values should be
                calculated accordingly:

                     layer      functionality
                       1        physical (e.g., repeaters)
                       2        datalink/subnetwork (e.g., bridges)
                       3        internet (e.g., supports the IP)
                       4        end-to-end  (e.g., supports the TCP)
                       7        applications (e.g., supports the SMTP)

                For systems including OSI protocols, layers 5 and 6 may also
                be counted."
        ::= { system 7 }

    -- object resource information
    --
    -- a collection of objects which describe the SNMPv2 entity's
    -- (statically and dynamically configurable) support of
    -- various MIB modules.

    sysORLastChange OBJECT-TYPE
        SYNTAX     TimeStamp
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The value of sysUpTime at the time of the most recent
                change in state or value of any instance of sysORID."
        ::= { system 8 }

    sysORTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF SysOREntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "The (conceptual) table listing the capabilities of the
                local SNMPv2 entity acting in an agent role with respect to
                various MIB modules.  SNMPv2 entities having dynamically-
                configurable support of MIB modules will have a
                dynamically-varying number of conceptual rows."
        ::= { system 9 }

    sysOREntry OBJECT-TYPE
        SYNTAX     SysOREntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "An entry (conceptual row) in the sysORTable."
        INDEX      { sysORIndex }
        ::= { sysORTable 1 }

    SysOREntry ::= SEQUENCE {
        sysORIndex     INTEGER,
        sysORID        OBJECT IDENTIFIER,
        sysORDescr     DisplayString,
        sysORUpTime    TimeStamp
    }

    sysORIndex OBJECT-TYPE
        SYNTAX     INTEGER (1..2147483647)
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "The auxiliary variable used for identifying instances of
                the columnar objects in the sysORTable."
        ::= { sysOREntry 1 }

    sysORID OBJECT-TYPE
        SYNTAX     OBJECT IDENTIFIER
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "An authoritative identification of a capabilities statement
                with respect to various MIB modules supported by the local
                SNMPv2 entity acting in an agent role."
        ::= { sysOREntry 2 }

    sysORDescr OBJECT-TYPE
        SYNTAX     DisplayString
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "A textual description of the capabilities identified by the
                corresponding instance of sysORID."
        ::= { sysOREntry 3 }

    sysORUpTime OBJECT-TYPE
        SYNTAX     TimeStamp
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The value of sysUpTime at the time this conceptual row was
                last instanciated."
        ::= { sysOREntry 4 }

Next: 2.2. The SNMP Group

Connected: An Internet Encyclopedia
RFC 1907 - 2.1. The System Group