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)
Last updated 2013-03-02
Stream IETF
Formats plain text pdf html
Stream WG state (None)
Consensus Unknown
Document shepherd No shepherd assigned
IESG IESG state RFC 5017 (Proposed Standard)
Telechat date
Responsible AD Bill Fenner
Send notices to dmcw@dataconnection.com
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]
Show full document text