SYNTAX 子句

OBJECT-TYPE 巨集包含一個 SYNTAX 子句，定義 MIB 對象的數據和類型。 雖然 SNMP 提供者會觀察對應 SYNTAX 子句的一般規則，但提供者也會遵循數種數據類型特有的規則。

下列對應規則適用於下表所述的所有資料類型：

• SYNTAX 子句的文字表示法會對應至 CIM 屬性限定符 textual_convention。
• SYNTAX 子句中的具名型別定義會對應至 CIM 屬性限定符 object_syntax。 此對應會根據數據類型而有所不同。 如需詳細資訊，請參閱對應描述。
• 編碼 SNMPv1 和 SNMPv2C 通訊協定框架時所使用的 SNMP 類型會對應至 CIM 屬性限定符 編碼。
• CIM 屬性限定符 cimtype 包含格式化基礎 CIM 通訊協定值的文字表示法。

下表列出具有管理提供者對應行為之特定規則的數據類型。

基本類型

基本類型是管理信息結構 （SMI） 檔案中定義的其中一種基本數據類型，檔 RFC 1213 和 RFC 1903。 SNMP 基本類型會對應至 CIM 定義型別。 下表列出當SYNTAX子句明確參考SNMPv1基本類型時所發生的對應。 textual_convention、編碼和 object_syntax 限定符一律與 MIB 類型相同，預設值一律 NULL。

當 SYNTAX 子句參考 NULL時，提供者會忽略 OBJECT-TYPE 巨集，無論是明確還是透過具名類型指派。 下表列出當SYNTAX子句明確參考SNMPv2基本類型時所發生的對應。 textual_convention、編碼和 object_syntax 限定符一律與 MIB 類型相同，預設值一律 NULL。

具名類型

SNMP 具名類型會對應至 CIM 定義的類型。 當 SYNTAX 子句參考 基本類型、文字慣例，或透過類型指派衍生 限制類型時，請使用這些類型來判斷套用的對應程式。

• 如果透過類型指派規則的衍生，您會遇到限制的類型定義：

  • 而且，如果透過進一步的衍生，您遇到 TEXTUAL-CONVENTION Macro中列出的其中一個文字慣例，則請套用限制型別和文字慣例的對應規則。
  • 否則，如果您在任一基本類型數據表中遇到其中一個基本類型，請套用基本型別和限制型別的對應規則。

• 如果您遇到 TEXTUAL_CONVENTION 巨集中列出的其中一個文字慣例，請套用文字慣例的對應規則。

• 如果您遇到任一基本類型數據表中列出的其中一個基本類型，請套用基本類型的對應規則。

限制類型

限制類型是基本類型、具名型別或文字慣例，受到 SMI 檔 RFC 1213 和 RFC 1903 中定義的一些子系結機制所限制。 發生子型別時，需要額外的 CIM 限定符來指定子類型值。 SYNTAX 子句中的具名型別定義會將逐字對應至 CIM 屬性限定符 object_syntax，但不包括子類型的條件約束。

子類型可能遵循下列任何格式：

• 列舉的 INTEGER

  CIM 屬性限定符 列舉 指定列舉值。 這個限定符會以字串表示，其中包含帶正負號 32 位整數值的逗號分隔清單。 下表列出對應類型。 預設值一律 NULL。

• 位

  CIM 屬性限定符 位 指定列舉值。 這個限定符會以字串表示，其中包含帶正負號 32 位整數值的逗號分隔清單。 下表列出對應類型。 預設值一律 NULL。

• 可變長度

  當 SYNTAX 子句參照為可變長度 OCTET STRING 或 Opaque 的基本類型、具名型別或文字慣例時，CIM 屬性限定符 variable_length 會指定與類型定義相關聯的最小、最大值和固定長度值。 此限定符會以下列格式實作為字串，其中可變長度值會以不帶正負號的 32 位整數表示。

  (((0.9) .. (0.9)) | (0.9))(, (((0.9) .. (0.9)) | (0.9)))*
  

• 固定長度

  當SYNTAX子句參照為固定長度 OCTET STRING 或 Opaque 的基本類型、具名型別或文字慣例時，CIM 屬性限定符 fixed_length 指定固定長度值。 這個限定符會以不帶正負號的 32 位整數值表示。

• 範圍

  當 SYNTAX 子句參考基本型別、具名型別或文字慣例時，該類型為範圍或固定值 INTEGER 或量測計，CIM 屬性限定符 variable_value 會指定與類型定義相關聯的範圍和固定值。 此限定符會以下列格式實作為字串，其中範圍和固定長度值會以不帶正負號的 32 位整數表示。

  (((0.9)..(0.9))|(0.9))(,(((0.9)..(0.9))|(0.9)))*
  

範例程序代碼

下列範例描述列舉的 INTEGER 子類型。

Status := INTEGER {
up(1),
down(2),
testing(3)
}

此範例對應至：

enumeration("up(1),down(2),testing(3)")

下列程式代碼範例描述 BITS 子類型。

Status := BITS {
up(1),
down(2), 
testing(3)
}

下列程式代碼範例會對應至：

bits("up(1),down(2),testing(3)")

下列程式代碼範例描述可變長度子類型。

MySnmpOSIAddress ::=  TEXTUAL-CONVENTION

    DISPLAY-HINT    "*1x:/1x:"
    STATUS        current
    DESCRIPTION
            "Represents an OSI transport-address:

            octets    contents         encoding
              1        length of NSAP   'n' as an unsigned-integer
                                        (either 0 or from 3 to 20)
              2..(n+1)  NSAP          concrete binary representation
              (n+2)..m  TSEL             string of (up to 64) octets
            "
    SYNTAX         OCTET STRING (SIZE (1|4..85))

此範例對應至：

display_hint("*1x:/1x:"),
encoding("OCTETSTRING"),
textual_convention("OCTETSTRING"),
variable_length ("1,4..85")

下列範例描述固定長度子類型。

IPXADDRESS := OCTET STRING (SIZE (6))

此範例對應至：

fixed_length(6)

下列範例描述範圍子類型。

Status := INTEGER (10..20|8)

此範例對應至：

variable_value("10..20,8")