Container Data Items for DLEP
draft-dlep-containers-00

Abstract

Several DLEP extensions are being suggested that require the ability to group a set of DLEP Data Items into a logical set or bag. This document species a generic method of defining such a bag of Data Items, in what this document defines as a Data Item Container. This document also describes what an extension using Data Item Containers must specify in the extension specification.

Status of This Memo

This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.

Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at http://datatracker.ietf.org/drafts/current/.

Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."

This Internet-Draft will expire on January 20, 2018.

Copyright Notice

Copyright (c) 2017 IETF Trust and the persons identified as the document authors. All rights reserved.

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

Table of Contents

• 1. Introduction
• 1.1. Conventions and Terminology
• 2. Container Data Item
• 2.1. Specification of Conatiner Data Items
• 3. Security Considerations
• 4. IANA Considerations
• 5. References
• 5.1. Normative References
• 5.2. Informative References
• Author's Address

1. Introduction

A DLEP Data Item Container defined by this document is a generic wrapper or container of DLEP Data Items, where the presence of the container around the Data Items implies a logical association between the Data Items in the Container.

This document does not define a new DLEP extension, but does instead define a set of guidelines for DLEP extension authors.

1.1. Conventions and 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 BCP 14, RFC 2119 [RFC2119].

2. Container Data Item

The Container Data Item allows a DLEP extension to parenthesize a set of DLEP Data Items, implying a logical assocaition between the Data Items in the container.

The Container Data Item contains the following fields:

 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Data Item Type                | Length                        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
:               DLEP Data Items (zero or more)                  :
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Data Item Type:

Defined by the extension. Allocated from IANA "DLEP Data Item Values" registry.

Length:

Sum of Lengths of contained DLEP Data Items, including header lengths, i.e. the total length of the Container Data Item

DLEP Data Items:

0 or more DLEP Data Items, as defined in [I-D.ietf-manet-dlep].

2.1. Specification of Conatiner Data Items

When the use of a Container Data Item is defined in a DLEP extension specification, the specification MUST define which DLEP Data Items are valid within the Conatiner, and also the multiplicity of Data Items in the Container.

Unless otherwise allowed by an individual DLEP extension specification, any Data Item not defined as allowed in the Container MUST NOT appear, and an implementation receiving such a Data Item MUST teminate the DLEP session, using the DLEP Status Code 'Invalid Data'.

3. Security Considerations

I'm not sure there are any.

4. IANA Considerations

None.

5. References

5.1. Normative References

5.2. Informative References

Author's Address