Internet Printing Protocol (IPP): The 'collection' attribute syntax
RFC 3382

Document Type RFC - Proposed Standard (October 2002; Errata)
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 3382 (Proposed Standard)
Telechat date
Responsible AD Ned Freed
IESG note Published as RFC 3382 2-Oct-2002
Send notices to <carl@manros.com>
Network Working Group                                           R. deBry
Request for Comments: 3382                     Utah Valley State College
Updates: 2910, 2911                                           R. Herriot
Category: Standards Track                                     Consultant
                                                             T. Hastings
                                                                 K. Ocke
                                                               P. Zehler
                                                       Xerox Corporation
                                                          September 2002

                   Internet Printing Protocol (IPP):
                   The 'collection' attribute syntax

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.

Copyright Notice

   Copyright (C) The Internet Society (2002).  All Rights Reserved.

Abstract

   This document specifies an OPTIONAL attribute syntax called
   'collection' for use with the Internet Printing Protocol (IPP/1.0 and
   IPP/1.1).  A 'collection' is a container holding one or more named
   values, which are called "member" attributes.  A collection allows
   data to be grouped like a PostScript dictionary or a Java Map.  This
   document also specifies the conformance requirements for a definition
   document that defines a collection attribute.  Finally, this document
   gives some illustrative example collection attribute definitions that
   are not intended as actual attribute specifications.

Table of Contents

   1 Introduction.....................................................3
   1.1 Problem Statement..............................................3
   1.2 Solution.......................................................3
   2 Terminology......................................................4
   2.1 Conformance Terminology........................................4
   2.2 Other terminology..............................................5
   3 Definition of a Collection Attribute.............................5
   3.1 Information to Include.........................................5

deBry, et. al.              Standards Track                     [Page 1]
RFC 3382         IPP: The 'collection' attribute syntax   September 2002

   3.2 Nested Collections.............................................9
   4 Collection Attributes as Attributes in Operations................9
   4.1 General Rules..................................................9
   4.2 Unsupported Values.............................................9
   5 Example definition of a collection attribute.....................9
   5.1 media-col (collection)........................................10
   5.1.1 media-color (type3 keyword | name(MAX)......................10
   5.1.2 media-size (collection).....................................11
   5.2 media-col-default (collection)................................11
   5.3 media-col-ready (1setOf collection)...........................12
   5.4 media-col-supported (1setOf type2 keyword)....................12
   6 A Second Example Definition Of A Collection Attribute...........12
   7 Encoding........................................................13
   7.1 Additional tags defined for representing a collection
       attribute value...............................................13
   7.2 Example encoding: "media-col" (collection)....................14
   8 Legacy issues...................................................20
   9 IANA Considerations.............................................20
   10 Internationalization Considerations............................20
   11 Security Considerations........................................21
   12 References.....................................................21
   Appendix A: Encoding Example of a Simple Collection (Informative).22
   Appendix B: Encoding Example of 1setOf Collection (Informative)...25
   Appendix C: Encoding Example of Collection containing 1setOf XXX
               attribute (Informative)...............................31
   Appendix D: Description of the Base IPP Documents (Informative)...35
   Authors' Addresses................................................36
   Full Copyright Statement..........................................38

Table of Tables

   Table 1 - "media-col" member attributes...........................10
   Table 2 - "media-size" collection member attributes...............11
Show full document text