418 lines
16 KiB
Plaintext
418 lines
16 KiB
Plaintext
TRANSPORT-ADDRESS-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-IDENTITY, mib-2 FROM SNMPv2-SMI
|
|
TEXTUAL-CONVENTION FROM SNMPv2-TC;
|
|
|
|
transportAddressMIB MODULE-IDENTITY
|
|
LAST-UPDATED "200211010000Z"
|
|
ORGANIZATION
|
|
"IETF Operations and Management Area"
|
|
CONTACT-INFO
|
|
"Juergen Schoenwaelder (Editor)
|
|
TU Braunschweig
|
|
Bueltenweg 74/75
|
|
38106 Braunschweig, Germany
|
|
Phone: +49 531 391-3289
|
|
EMail: schoenw@ibr.cs.tu-bs.de
|
|
|
|
Send comments to <mibs@ops.ietf.org>."
|
|
DESCRIPTION
|
|
"This MIB module provides commonly used transport
|
|
address definitions.
|
|
|
|
Copyright (C) The Internet Society (2002). This version of
|
|
this MIB module is part of RFC 3419; see the RFC itself for
|
|
full legal notices."
|
|
|
|
-- Revision log
|
|
|
|
REVISION "200211010000Z"
|
|
DESCRIPTION
|
|
"Initial version, published as RFC 3419."
|
|
::= { mib-2 100 }
|
|
|
|
|
|
transportDomains OBJECT IDENTIFIER ::= { transportAddressMIB 1 }
|
|
|
|
transportDomainUdpIpv4 OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The UDP over IPv4 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv4 for
|
|
global IPv4 addresses."
|
|
::= { transportDomains 1 }
|
|
|
|
transportDomainUdpIpv6 OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The UDP over IPv6 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv6 for
|
|
global IPv6 addresses."
|
|
::= { transportDomains 2 }
|
|
|
|
transportDomainUdpIpv4z OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The UDP over IPv4 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv4z for
|
|
scoped IPv4 addresses with a zone index."
|
|
::= { transportDomains 3 }
|
|
|
|
transportDomainUdpIpv6z OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The UDP over IPv6 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv6z for
|
|
scoped IPv6 addresses with a zone index."
|
|
::= { transportDomains 4 }
|
|
|
|
transportDomainTcpIpv4 OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The TCP over IPv4 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv4 for
|
|
global IPv4 addresses."
|
|
::= { transportDomains 5 }
|
|
|
|
transportDomainTcpIpv6 OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The TCP over IPv6 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv6 for
|
|
global IPv6 addresses."
|
|
::= { transportDomains 6 }
|
|
|
|
transportDomainTcpIpv4z OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The TCP over IPv4 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv4z for
|
|
scoped IPv4 addresses with a zone index."
|
|
::= { transportDomains 7 }
|
|
|
|
transportDomainTcpIpv6z OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The TCP over IPv6 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv6z for
|
|
scoped IPv6 addresses with a zone index."
|
|
::= { transportDomains 8 }
|
|
|
|
transportDomainSctpIpv4 OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The SCTP over IPv4 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv4 for
|
|
global IPv4 addresses. This transport domain usually
|
|
represents the primary address on multihomed SCTP
|
|
endpoints."
|
|
::= { transportDomains 9 }
|
|
|
|
transportDomainSctpIpv6 OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The SCTP over IPv6 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv6 for
|
|
global IPv6 addresses. This transport domain usually
|
|
represents the primary address on multihomed SCTP
|
|
endpoints."
|
|
::= { transportDomains 10 }
|
|
|
|
transportDomainSctpIpv4z OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The SCTP over IPv4 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv4z for
|
|
scoped IPv4 addresses with a zone index. This transport
|
|
domain usually represents the primary address on
|
|
multihomed SCTP endpoints."
|
|
::= { transportDomains 11 }
|
|
|
|
transportDomainSctpIpv6z OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The SCTP over IPv6 transport domain. The corresponding
|
|
transport address is of type TransportAddressIPv6z for
|
|
scoped IPv6 addresses with a zone index. This transport
|
|
domain usually represents the primary address on
|
|
multihomed SCTP endpoints."
|
|
::= { transportDomains 12 }
|
|
|
|
transportDomainLocal OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The Posix Local IPC transport domain. The corresponding
|
|
transport address is of type TransportAddressLocal.
|
|
|
|
The Posix Local IPC transport domain incorporates the
|
|
well-known UNIX domain sockets."
|
|
::= { transportDomains 13 }
|
|
|
|
transportDomainUdpDns OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The UDP transport domain using fully qualified domain
|
|
names. The corresponding transport address is of type
|
|
TransportAddressDns."
|
|
::= { transportDomains 14 }
|
|
|
|
transportDomainTcpDns OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The TCP transport domain using fully qualified domain
|
|
names. The corresponding transport address is of type
|
|
TransportAddressDns."
|
|
::= { transportDomains 15 }
|
|
|
|
transportDomainSctpDns OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The SCTP transport domain using fully qualified domain
|
|
names. The corresponding transport address is of type
|
|
TransportAddressDns."
|
|
::= { transportDomains 16 }
|
|
|
|
TransportDomain ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A value that represents a transport domain.
|
|
|
|
Some possible values, such as transportDomainUdpIpv4, are
|
|
defined in this module. Other possible values can be
|
|
defined in other MIB modules."
|
|
SYNTAX OBJECT IDENTIFIER
|
|
|
|
--
|
|
-- The enumerated values of the textual convention below should
|
|
-- be identical to the last sub-identifier of the OID registered
|
|
-- for the same domain.
|
|
--
|
|
|
|
TransportAddressType ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A value that represents a transport domain. This is the
|
|
enumerated version of the transport domain registrations
|
|
in this MIB module. The enumerated values have the
|
|
following meaning:
|
|
|
|
unknown(0) unknown transport address type
|
|
udpIpv4(1) transportDomainUdpIpv4
|
|
udpIpv6(2) transportDomainUdpIpv6
|
|
udpIpv4z(3) transportDomainUdpIpv4z
|
|
udpIpv6z(4) transportDomainUdpIpv6z
|
|
tcpIpv4(5) transportDomainTcpIpv4
|
|
tcpIpv6(6) transportDomainTcpIpv6
|
|
tcpIpv4z(7) transportDomainTcpIpv4z
|
|
tcpIpv6z(8) transportDomainTcpIpv6z
|
|
sctpIpv4(9) transportDomainSctpIpv4
|
|
sctpIpv6(10) transportDomainSctpIpv6
|
|
sctpIpv4z(11) transportDomainSctpIpv4z
|
|
sctpIpv6z(12) transportDomainSctpIpv6z
|
|
local(13) transportDomainLocal
|
|
udpDns(14) transportDomainUdpDns
|
|
tcpDns(15) transportDomainTcpDns
|
|
sctpDns(16) transportDomainSctpDns
|
|
|
|
This textual convention can be used to represent transport
|
|
domains in situations where a syntax of TransportDomain is
|
|
unwieldy (for example, when used as an index).
|
|
|
|
The usage of this textual convention implies that additional
|
|
transport domains can only be supported by updating this MIB
|
|
module. This extensibility restriction does not apply for the
|
|
TransportDomain textual convention which allows MIB authors
|
|
to define additional transport domains independently in
|
|
other MIB modules."
|
|
SYNTAX INTEGER {
|
|
unknown(0),
|
|
udpIpv4(1),
|
|
udpIpv6(2),
|
|
udpIpv4z(3),
|
|
udpIpv6z(4),
|
|
tcpIpv4(5),
|
|
tcpIpv6(6),
|
|
tcpIpv4z(7),
|
|
tcpIpv6z(8),
|
|
sctpIpv4(9),
|
|
sctpIpv6(10),
|
|
sctpIpv4z(11),
|
|
sctpIpv6z(12),
|
|
local(13),
|
|
udpDns(14),
|
|
tcpDns(15),
|
|
sctpDns(16)
|
|
}
|
|
|
|
TransportAddress ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Denotes a generic transport address.
|
|
|
|
A TransportAddress value is always interpreted within the
|
|
context of a TransportAddressType or TransportDomain value.
|
|
Every usage of the TransportAddress textual convention MUST
|
|
specify the TransportAddressType or TransportDomain object
|
|
which provides the context. Furthermore, MIB authors SHOULD
|
|
define a separate TransportAddressType or TransportDomain
|
|
object for each TransportAddress object. It is suggested that
|
|
the TransportAddressType or TransportDomain is logically
|
|
registered before the object(s) which use the
|
|
TransportAddress textual convention if they appear in the
|
|
same logical row.
|
|
|
|
The value of a TransportAddress object must always be
|
|
consistent with the value of the associated
|
|
TransportAddressType or TransportDomain object. Attempts
|
|
to set a TransportAddress object to a value which is
|
|
inconsistent with the associated TransportAddressType or
|
|
TransportDomain must fail with an inconsistentValue error.
|
|
|
|
When this textual convention is used as a syntax of an
|
|
index object, there may be issues with the limit of 128
|
|
sub-identifiers specified in SMIv2, STD 58. In this case,
|
|
the OBJECT-TYPE declaration MUST include a 'SIZE' clause
|
|
to limit the number of potential instance sub-identifiers."
|
|
SYNTAX OCTET STRING (SIZE (0..255))
|
|
|
|
TransportAddressIPv4 ::= TEXTUAL-CONVENTION
|
|
DISPLAY-HINT "1d.1d.1d.1d:2d"
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Represents a transport address consisting of an IPv4
|
|
address and a port number (as used for example by UDP,
|
|
TCP and SCTP):
|
|
|
|
octets contents encoding
|
|
1-4 IPv4 address network-byte order
|
|
5-6 port number network-byte order
|
|
|
|
This textual convention SHOULD NOT be used directly in object
|
|
definitions since it restricts addresses to a specific format.
|
|
However, if it is used, it MAY be used either on its own or
|
|
in conjunction with TransportAddressType or TransportDomain
|
|
as a pair."
|
|
SYNTAX OCTET STRING (SIZE (6))
|
|
|
|
TransportAddressIPv6 ::= TEXTUAL-CONVENTION
|
|
DISPLAY-HINT "0a[2x:2x:2x:2x:2x:2x:2x:2x]0a:2d"
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Represents a transport address consisting of an IPv6
|
|
address and a port number (as used for example by UDP,
|
|
TCP and SCTP):
|
|
|
|
octets contents encoding
|
|
1-16 IPv6 address network-byte order
|
|
17-18 port number network-byte order
|
|
|
|
This textual convention SHOULD NOT be used directly in object
|
|
definitions since it restricts addresses to a specific format.
|
|
However, if it is used, it MAY be used either on its own or
|
|
in conjunction with TransportAddressType or TransportDomain
|
|
as a pair."
|
|
SYNTAX OCTET STRING (SIZE (18))
|
|
|
|
TransportAddressIPv4z ::= TEXTUAL-CONVENTION
|
|
DISPLAY-HINT "1d.1d.1d.1d%4d:2d"
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Represents a transport address consisting of an IPv4
|
|
address, a zone index and a port number (as used for
|
|
example by UDP, TCP and SCTP):
|
|
|
|
octets contents encoding
|
|
1-4 IPv4 address network-byte order
|
|
5-8 zone index network-byte order
|
|
9-10 port number network-byte order
|
|
|
|
This textual convention SHOULD NOT be used directly in object
|
|
definitions since it restricts addresses to a specific format.
|
|
However, if it is used, it MAY be used either on its own or
|
|
in conjunction with TransportAddressType or TransportDomain
|
|
as a pair."
|
|
SYNTAX OCTET STRING (SIZE (10))
|
|
|
|
TransportAddressIPv6z ::= TEXTUAL-CONVENTION
|
|
DISPLAY-HINT "0a[2x:2x:2x:2x:2x:2x:2x:2x%4d]0a:2d"
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Represents a transport address consisting of an IPv6
|
|
address, a zone index and a port number (as used for
|
|
example by UDP, TCP and SCTP):
|
|
|
|
octets contents encoding
|
|
1-16 IPv6 address network-byte order
|
|
17-20 zone index network-byte order
|
|
21-22 port number network-byte order
|
|
|
|
This textual convention SHOULD NOT be used directly in object
|
|
definitions since it restricts addresses to a specific format.
|
|
However, if it is used, it MAY be used either on its own or
|
|
in conjunction with TransportAddressType or TransportDomain
|
|
as a pair."
|
|
SYNTAX OCTET STRING (SIZE (22))
|
|
|
|
TransportAddressLocal ::= TEXTUAL-CONVENTION
|
|
DISPLAY-HINT "1a"
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Represents a POSIX Local IPC transport address:
|
|
|
|
octets contents encoding
|
|
all POSIX Local IPC address string
|
|
|
|
The Posix Local IPC transport domain subsumes UNIX domain
|
|
sockets.
|
|
|
|
This textual convention SHOULD NOT be used directly in object
|
|
definitions since it restricts addresses to a specific format.
|
|
However, if it is used, it MAY be used either on its own or
|
|
in conjunction with TransportAddressType or TransportDomain
|
|
as a pair.
|
|
|
|
When this textual convention is used as a syntax of an
|
|
index object, there may be issues with the limit of 128
|
|
sub-identifiers specified in SMIv2, STD 58. In this case,
|
|
the OBJECT-TYPE declaration MUST include a 'SIZE' clause
|
|
to limit the number of potential instance sub-identifiers."
|
|
REFERENCE
|
|
"Protocol Independent Interfaces (IEEE POSIX 1003.1g)"
|
|
SYNTAX OCTET STRING (SIZE (1..255))
|
|
|
|
TransportAddressDns ::= TEXTUAL-CONVENTION
|
|
DISPLAY-HINT "1a"
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Represents a DNS domain name followed by a colon ':'
|
|
(ASCII character 0x3A) and a port number in ASCII.
|
|
The name SHOULD be fully qualified whenever possible.
|
|
|
|
Values of this textual convention are not directly useable as
|
|
transport-layer addressing information, and require runtime
|
|
resolution. As such, applications that write them must be
|
|
prepared for handling errors if such values are not
|
|
supported, or cannot be resolved (if resolution occurs at the
|
|
time of the management operation).
|
|
|
|
The DESCRIPTION clause of TransportAddress objects that may
|
|
have TransportAddressDns values must fully describe how (and
|
|
when) such names are to be resolved to IP addresses and vice
|
|
versa.
|
|
|
|
This textual convention SHOULD NOT be used directly in object
|
|
definitions since it restricts addresses to a specific format.
|
|
However, if it is used, it MAY be used either on its own or
|
|
in conjunction with TransportAddressType or TransportDomain
|
|
as a pair.
|
|
|
|
When this textual convention is used as a syntax of an
|
|
index object, there may be issues with the limit of 128
|
|
sub-identifiers specified in SMIv2, STD 58. In this case,
|
|
the OBJECT-TYPE declaration MUST include a 'SIZE' clause
|
|
to limit the number of potential instance sub-identifiers."
|
|
SYNTAX OCTET STRING (SIZE (1..255))
|
|
|
|
END
|