Channel Binding Signalling for the Generic Security Services Application Programming Interface
draft-ietf-kitten-channel-bound-flag-04

Request for posting confirmation emailed to previous authors: kitten-chairs@ietf.org, Nico Williams quot;This value indicates whether a virtual machine has a
              persistent configuration which means the virtual machine
              will still exist after shutting down:

              unknown(1)    The persistent configuration is unknown,
                              e.g., because the implementation failed
                              to obtain the persistent configuration
                              from the hypervisor. (read-only)

              persistent(2)  The virtual machine is persistent, i.e.,
                              the virtual machine will exist after its
                              shutting down.

              transient(3)  The virtual machine is transient, i.e.,
                              the virtual machine will not exist after
                              its shutting down."
      SYNTAX      INTEGER {
                      unknown(1),
                      persistent(2),
                      transient(3)
                    }

  VirtualMachineCpuIndex ::= TEXTUAL-CONVENTION
      DISPLAY-HINT "d"
      STATUS      current
      DESCRIPTION
              "A unique value for each virtual machine, greater than
              zero, identifying a virtual CPU assigned to a virtual
              machine.  The value for each virtual CPU must remain
              constant at least from one re-initialization of the
              hypervisor to the next re-initialization."
        SYNTAX      Integer32 (1..2147483647)

  VirtualMachineStorageIndex ::= TEXTUAL-CONVENTION
      DISPLAY-HINT "d"
      STATUS      current
      DESCRIPTION
              "A unique value for each virtual machine, greater than
              zero, identifying a virtual storage device allocated to
              a virtual machine.  The value for each virtual storage
              device must remain constant at least from one
              re-initialization of the hypervisor to the next
              re-initialization."
        SYNTAX      Integer32 (1..2147483647)

  VirtualMachineStorageSourceType ::= TEXTUAL-CONVENTION
      STATUS      current

Asai, et al.            Expires January 5, 2015              [Page 19]
Internet-Draft      Virtual Machine Monitoring MIB            July 2014

      DESCRIPTION
              "The source type of a virtual storage device:

              unknown(1)    The source type is unknown, e.g., because
                              the implementation failed to obtain the
                              media type from the hypervisor.

              other(2)      The source type is other than those
                              defined in this conversion.

              block(3)      The source type is a block device.

              raw(4)        The source type is a raw-formatted file.

              sparse(5)      The source type is a sparse file.

              network(6)    The source type is a network device."
      SYNTAX      INTEGER {
                      unknown(1),
                      other(2),
                      block(3),
                      raw(4),
                      sparse(5),
                      network(6)
                    }

  VirtualMachineStorageAccess ::= TEXTUAL-CONVENTION
      STATUS      current
      DESCRIPTION
              "The access permission of a virtual storage:

              readwrite(1)  The virtual storage is a read-write
                              device.

              readonly(2)    The virtual storage is a read-only
                              device."
      SYNTAX      INTEGER {
                      readwrite(1),
                      readonly(2)
                    }

  VirtualMachineStorageMediaType ::= TEXTUAL-CONVENTION
      STATUS      current
      DESCRIPTION
              "The media type of a virtual storage device:

              unknown(1)    The media type is unknown, e.g., because
                              the implementation failed to obtain the

Asai, et al.            Expires January 5, 2015              [Page 20]
Internet-Draft      Virtual Machine Monitoring MIB            July 2014

                              media type from the hypervisor.

              other(2)      The media type is other than those
                              defined in this conversion.

              hardDisk(3)    The media type is hard disk.

              opticalDisk(4) The media type is optical disk."
      SYNTAX      INTEGER {
                      other(1),
                      unknown(2),
                      hardDisk(3),
                      opticalDisk(4)
                    }

  VirtualMachineNetworkIndex ::= TEXTUAL-CONVENTION
      DISPLAY-HINT "d"
      STATUS      current
      DESCRIPTION
              "A unique value for each virtual machine, greater than
              zero, identifying a virtual network interface allocated
              to the virtual machine.  The value for each virtual
              network interface must remain constant at least from one
              re-initialization of the hypervisor to the next
              re-initialization."
        SYNTAX      Integer32 (1..2147483647)

  VirtualMachineList ::= TEXTUAL-CONVENTION
      DISPLAY-HINT "1x"
      STATUS      current
      DESCRIPTION
              "Each octet within this value specifies a set of eight
              virtual machine vmIndex, with the first octet specifying
              virtual machine 1 through 8, the second octet specifying
              virtual machine 9 through 16, etc.  Within each octet,
              the most significant bit represents the lowest numbered
              vmIndex, and the least significant bit represents the
              highest numbered vmIndex.  Thus, each virtual machine of
              the host is represented by a single bit within the value
              of this object.  If that bit has a value of '1', then
              that virtual machine is included in the set of virtual
              machines; the virtual machine is not included if its bit
              has a value of '0'."
      SYNTAX      OCTET STRING

  -- The hypervisor group
  --
  -- A collection of objects common to all hypervisors.

Asai, et al.            Expires January 5, 2015              [Page 21]
Internet-Draft      Virtual Machine Monitoring MIB            July 2014

  --
  vmHypervisor    OBJECT IDENTIFIER ::= { vmObjects 1 }

  vmHvSoftware OBJECT-TYPE
      SYNTAX      SnmpAdminString (SIZE (0..255))
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
              "A textual description of the hypervisor software.  This
              value should not include its version, and it should be
              included in `vmHvVersion'."
      ::= { vmHypervisor 1 }

  vmHvVersion OBJECT-TYPE
      SYNTAX      SnmpAdminString (SIZE (0..255))
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
              "A textual description of the version of the hypervisor
              software."
      ::= { vmHypervisor 2 }

  vmHvObjectID OBJECT-TYPE
      SYNTAX      OBJECT IDENTIFIER
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
              "The vendor's authoritative identification of the
              hypervisor software contained in the entity.  This value
              is allocated within the SMI enterprises
              subtree (1.3.6.1.4.1).  Note that this is different from
              sysObjectID in the SNMPv2-MIB [RFC3418] because
              sysObjectID is not the identification of the hypervisor
              software but the device, firmware, or management
              operating system."
      ::= { vmHypervisor 3 }

  vmHvUpTime OBJECT-TYPE
      SYNTAX      TimeTicks
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
              "The time (in centi-seconds) since the hypervisor was
              last re-initialized.  Note that this is different from
              sysUpTime in the SNMPv2-MIB [RFC3418] and hrSystemUptime
              in the HOST-RESOURCES-MIB [RFC2790] because sysUpTime is
              the uptime of the network management portion of the
              system, and hrSystemUptime is the uptime of the

Asai, et al.            Expires January 5, 2015              [Page 22]
Internet-Draft      Virtual Machine Monitoring MIB            July 2014

              management operating system but not the hypervisor
              software."
      ::= { vmHypervisor 4 }

  -- The virtual machine information
  --
  -- A collection of objects common to all virtual machines.
  --
  vmNumber  OBJECT-TYPE
      SYNTAX      Integer32 (0..2147483647)
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
              "The number of virtual machines (regardless of their
              current state) present on this hypervisor."
      ::= { vmObjects 2 }

  vmTableLastChange  OBJECT-TYPE
      SYNTAX      TimeTicks
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
              "The value of vmHvUpTime at the time of the last creation
              or deletion of an entry in the vmTable."
      ::= { vmObjects 3 }

  vmTable OBJECT-TYPE
      SYNTAX      SEQUENCE OF VmEntry
      MAX-ACCESS  not-accessible
      STATUS      current
      DESCRIPTION
              "A list of virtual machine entries.  The number of
              entries is given by the value of vmNumber."
      ::= { vmObjects 4 }

  vmEntry OBJECT-TYPE
      SYNTAX      VmEntry
      MAX-ACCESS  not-accessible
      STATUS      current
      DESCRIPTION
              "An entry containing management information applicable
              to a particular virtual machine."
      INDEX  { vmIndex }
      ::= { vmTable 1 }

  VmEntry ::=
      SEQUENCE {

Asai, et al.            Expires January 5, 2015              [Page 23]
Internet-Draft      Virtual Machine Monitoring MIB            July 2014

          vmIndex                VirtualMachineIndex,
          vmName                  SnmpAdminString,
          vmUUID                  UUIDorZero,
          vmOSType                SnmpAdminString,
          vmAdminState            VirtualMachineAdminState,
          vmOperState            VirtualMachineOperState,
          vmAutoStart            VirtualMachineAutoStart,
          vmPersistent            VirtualMachinePersistent,
          vmCurCpuNumber          Integer32,
          vmMinCpuNumber          Integer32,
          vmMaxCpuNumber          Integer32,
          vmMemUnit              Integer32,
          vmCurMem                Integer32,
          vmMinMem                Integer32,
          vmMaxMem                Integer32,
          vmUpTime                TimeTicks,
          vmCpuTime              Counter64
      }

  vmIndex OBJECT-TYPE
      SYNTAX      VirtualMachineIndex
      MAX-ACCESS  not-accessible
      STATUS      current
      DESCRIPTION
              "A unique value, greater than zero, identifying the
              virtual machine. The value assigned to a given virtual
              machine may not persist across re-initialization of the
              hypervisor.  A command generator must use the vmUUID to
              identify a given virtual machine of interest."
      ::= { vmEntry 1 }

  vmName OBJECT-TYPE
      SYNTAX      SnmpAdminString (SIZE (0..255))
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
              "A textual name of the virtual machine."
      ::= { vmEntry 2 }

  vmUUID OBJECT-TYPE
      SYNTAX      UUIDorZero
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
              "The virtual machine's 128-bit UUID or the zero-length
              string when a UUID is not available.  The UUID if set
              must uniquely identify a virtual machine from all other
              virtual machines in an administrative region.  A

Asai, et al.            Expires January 5, 2015              [Page 24]
Internet-Draft      Virtual Machine Monitoring MIB            July 2014