[lisp-snmp] New ASN.1:OID documentation

[Chun T. (b. <bin...@gm...>]

ASN.1:OID (general function)

Convert anything to OBJECT-ID.

1. For single names, return all possible OIDs as multiple values:

    > (oid "linux")
    #<OBJECT-ID NET-SNMP-TC::linux (10) [0]>
    #<OBJECT-ID UCD-SNMP-MIB::linux (10) [0]>

2. For names plus numbers, create new OID instances:

    > (oid "sysDescr.0")
    #<OBJECT-ID SNMPv2-MIB::sysDescr.0>

3. For names list, validating every names:

    > (oid "ucdSnmpAgent.linux")
    #<OBJECT-ID UCD-SNMP-MIB::linux (10) [0]>

4. For pure number list, search and build OID from 'zero':

    > (oid "0.2.3.4")
    #<OBJECT-ID zero.2.3.4>
    > (oid "1.2.3")
    #<OBJECT-ID iso.2.3>
    > (oid ".1.2.3")
    #<OBJECT-ID iso.2.3>

5. OID name with module is supported:

    > (oid "NET-SNMP-TC::linux")
    #<OBJECT-ID NET-SNMP-TC::linux (10) [0]>

--
Chun Tian (binghe)
NetEase.com, Inc.
P. R. China