MIB Textual Conventions for Uniform Resource Identifiers (URIs)
RFC 5017
| Document | Type |
RFC - Proposed Standard
(September 2007; No errata)
Was draft-mcwalter-uri-mib (individual in rtg area)
|
|
|---|---|---|---|
| Author | David McWalter | ||
| Last updated | 2015-10-14 | ||
| Stream | IETF | ||
| Formats | plain text html pdf htmlized bibtex | ||
| Stream | WG state | (None) | |
| Document shepherd | No shepherd assigned | ||
| IESG | IESG state | RFC 5017 (Proposed Standard) | |
| Consensus Boilerplate | Unknown | ||
| Telechat date | |||
| Responsible AD | Bill Fenner | ||
| Send notices to | (None) | ||
Network Working Group D. McWalter, Ed.
Request for Comments: 5017 Data Connection Ltd
Category: Standards Track September 2007
MIB Textual Conventions for Uniform Resource Identifiers (URIs)
Status of This Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Abstract
This MIB module defines textual conventions to represent STD 66
Uniform Resource Identifiers (URIs). The intent is that these
textual conventions will be imported and used in MIB modules that
would otherwise define their own representation(s).
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 1
2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . 2
3. The Internet-Standard Management Framework . . . . . . . . . . 2
4. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . 2
5. Security Considerations . . . . . . . . . . . . . . . . . . . . 5
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 5
7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 5
8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 5
8.1. Normative References . . . . . . . . . . . . . . . . . . . 5
8.2. Informative References . . . . . . . . . . . . . . . . . . 6
1. Introduction
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community.
It defines textual conventions to represent STD 66 [RFC3986] URIs,
which are further described by [RFC3305].
Three textual conventions are defined: one of unrestricted length,
and two of different restricted lengths. Which length is appropriate
will depend on tradeoffs made in particular MIB modules. The purpose
of providing standard restricted-length textual conventions is to
improve compatibility between MIB modules that require restricted-
length URIs.
McWalter Standards Track [Page 1]
RFC 5017 URI TC MIB September 2007
If a URI needs to be used as an index object, then the 'Uri' TEXTUAL-
CONVENTION SHOULD be subtyped to a length appropriate for the Object
Identifier (OID) of which it is part. The description of the 'Uri'
TEXTUAL-CONVENTION discusses this case.
2. Terminology
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119].
3. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410].
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the
Structure of Management Information (SMI). This memo specifies a MIB
module that is compliant to the SMIv2, which is described in STD 58,
RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580
[RFC2580].
4. Definitions
URI-TC-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, mib-2 FROM SNMPv2-SMI -- [RFC2578]
TEXTUAL-CONVENTION FROM SNMPv2-TC; -- [RFC2579]
uriTcMIB MODULE-IDENTITY
LAST-UPDATED "200709100000Z" -- 10 September 2007
ORGANIZATION "IETF Operations and Management (OPS) Area"
CONTACT-INFO "EMail: ops-area@ietf.org
Home page: http://www.ops.ietf.org/"
DESCRIPTION
"This MIB module defines textual conventions for
representing URIs, as defined by RFC 3986 STD 66."
REVISION "200709100000Z" -- 10 September 2007
DESCRIPTION
"Initial revision, published as RFC 5017.
Copyright (C) The IETF Trust (2007). This version of this
MIB module is part of RFC 5017; see the RFC itself for full
McWalter Standards Track [Page 2]
RFC 5017 URI TC MIB September 2007
legal notices."
::= { mib-2 164 }
Uri ::= TEXTUAL-CONVENTION
DISPLAY-HINT "1a"
STATUS current
DESCRIPTION
"A Uniform Resource Identifier (URI) as defined by STD 66.
Objects using this TEXTUAL-CONVENTION MUST be in US-ASCII
encoding, and MUST be normalized as described by RFC 3986
Show full document text