draft-ietf-ipp-job-printer-set-ops-04.txt   rfc3380.txt 
Internet Printing Protocol WG T. Hastings Network Working Group T. Hastings
INTERNET-DRAFT R. Herriot Request for Comments: 3380 Xerox Corporation
<draft-ietf-ipp-job-printer-set-ops-04.txt> Xerox Corporation Updates: 2910, 2911 R. Herriot
Updates: RFC 2910 and 2911 Carl Kugler Category: Standards Track Consultant
[Target Category: standards track] H. Lewis C. Kugler
Expires: January 17, 2002 IBM Corporation H. Lewis
July 17, 2001 IBM Corporation
September 2002
Internet Printing Protocol (IPP): Internet Printing Protocol (IPP):
Job and Printer Set Operations Job and Printer Set Operations
Copyright (C) The Internet Society (2001). All Rights Reserved.
Status of this Memo Status of this Memo
This document is an Internet-Draft and is in full conformance with This document specifies an Internet standards track protocol for the
all provisions of Section 10 of [RFC2026]. Internet-Drafts are Internet community, and requests discussion and suggestions for
working documents of the Internet Engineering Task Force (IETF), its improvements. Please refer to the current edition of the "Internet
areas, and its working groups. Note that other groups may also Official Protocol Standards" (STD 1) for the standardization state
distribute working documents as Internet-Drafts. and status of this protocol. Distribution of this memo is unlimited.
Internet-Drafts are draft documents valid for a maximum of six months Copyright Notice
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".
The list of current Internet-Drafts can be accessed at Copyright (C) The Internet Society (2002). All Rights Reserved.
http://www.ietf.org/ietf/1id-abstracts.txt
The list of Internet-Draft Shadow Directories can be accessed as
http://www.ietf.org/shadow.html.
Abstract Abstract
This document specifies 3 additional OPTIONAL operations for use with This document is an OPTIONAL extension to the Internet Printing
the Internet Printing Protocol/1.0 (IPP) [RFC2565, RFC2566], and Protocol (IPP/1.0 and IPP/1.1). This document specifies 3 additional
IPP/1.1 [RFC2911, RFC2910]. The end user, operator, and OPTIONAL operations for use with the Internet Printing Protocol/1.0
administrator Set-Job-Attributes and Set-Printer-Attributes (IPP) and IPP/1.1. The end user, operator, and administrator Set-
operations are used to modify IPP Job objects and Printer objects, Job-Attributes and Set-Printer-Attributes operations are used to
respectively. The third administrator Get-Printer-Supported-Values modify IPP Job objects and Printer objects, respectively. The Get-
operation returns values that the IPP Printer will accept for setting Printer-Supported-Values administrative operation returns values that
its "xxx-supported" attributes. the IPP Printer will accept for setting its "xxx-supported"
attributes.
Three out-of-band values are defined for use with these operations:
'delete-attribute', 'admin-define', and 'not-settable', along with a
'client-error-attributes-not-settable' status code.
Two operation attributes: "printer-message-from-operator" (text) and
"job-message-from-operator" (text) are defined to set the
corresponding IPP/1.1 Printer and Job Description attributes with the
same names.
Nine Printer Description attributes are defined:
printer-settable-attributes-supported (1setOf type2 keyword)
job-settable-attributes-supported (1setOf type2 keyword)
document-format-varying-attributes (1setOf type2 keyword)
printer-message-time (integer(MIN:MAX))
printer-message-date-time (dateTime)
printer-xri-supported (1setOf collection)
xri-uri-scheme-supported (1setOf uriScheme)
xri-authentication-supported (1setOf type2 keyword)
xri-security-supported (1setOf type2 keyword)
Table of Contents Table of Contents
1 Introduction.....................................................6 1 Introduction......................................................4
2 Terminology.......................................................5
2 Terminology......................................................6 2.1 Conformance Terminology.........................................5
2.1 Conformance Terminology........................................6 2.2 Other terminology...............................................5
2.2 Other terminology..............................................7 3 Requirements and Use Cases........................................5
4 Definition of the Set operations..................................6
3 Requirements and Use Cases.......................................7 4.1 Set-Printer-Attributes Operation................................7
4.1.1 Settable and READ-ONLY Printer Description attributes.........9
4 Definition of the Set operations.................................8 4.1.2 Set-Printer-Attributes Request...............................10
4.1 Set-Printer-Attributes Operation...............................9 4.1.3 Set-Printer-Attributes Response..............................12
4.1.1 Settable and READ-ONLY Printer Description attributes.......11 4.2 Set-Job-Attributes Operation...................................13
4.1.2 Set-Printer-Attributes Request..............................12 4.2.1 Settable and READ-ONLY Job Description attributes............16
4.1.3 Set-Printer-Attributes Response.............................14 4.2.2 Set-Job-Attributes Request...................................17
4.2 Set-Job-Attributes Operation..................................15 4.2.3 Set-Job-Attributes Response..................................18
4.2.1 Settable and READ-ONLY Job Description attributes...........18 4.3 Get-Printer-Supported-Values Operation.........................19
4.2.2 Set-Job-Attributes Request..................................18
4.2.3 Set-Job-Attributes Response.................................19
4.3 Get-Printer-Supported-Values Operation........................21
4.3.1 Definition of the usage of the 'admin-define' out-of-band 4.3.1 Definition of the usage of the 'admin-define' out-of-band
attribute value...................................................22 attribute value..............................................20
5 New Operation attributes.........................................22
5 New Operation attributes........................................23 5.1 printer-message-from-operator (text(127))......................22
5.1 printer-message-from-operator (text(127)).....................23 5.2 job-message-from-operator (text(127))..........................23
5.2 job-message-from-operator (text(127)).........................25 6 New Printer Description Attributes...............................24
6.1 printer-settable-attributes-supported (1setOf type2 keyword)...24
6 New Printer Description Attributes..............................26 6.2 job-settable-attributes-supported (1setOf type2 keyword).......25
6.1 printer-settable-attributes-supported (1setOf type2 keyword)..26 6.3 document-format-varying-attributes (1setOf type2 keyword)......25
6.2 job-settable-attributes-supported (1setOf type2 keyword)......26 6.4 printer-message-time (integer(MIN:MAX))........................25
6.3 document-format-varying-attributes (1setOf type2 keyword).....27 6.5 printer-message-date-time (dateTime)...........................26
6.4 printer-message-time (integer(MIN:MAX)).......................27 6.6 printer-xri-supported (1setOf collection)......................26
6.5 printer-message-date-time (dateTime)..........................27 6.7 xri-uri-scheme-supported (1setOf uriScheme)....................28
6.6 printer-xri-supported (1setOf collection).....................28 6.8 xri-authentication-supported (1setOf type2 keyword)............29
6.7 xri-uri-scheme-supported (1setOf uriScheme)...................30 6.9 xri-security-supported (1setOf type2 keyword)..................29
6.8 xri-authentication-supported (1setOf type2 keyword)...........30 7 Additional status codes..........................................29
6.9 xri-security-supported (1setOf type2 keyword).................31 7.1 client-error-attributes-not-settable (0x0413)..................29
8 Additional out-of-band values....................................30
7 Additional status codes.........................................31 8.1 'not-settable' out-of-band value...............................30
7.1 client-error-attributes-not-settable (0x0413).................31 8.1.1 Encoding of the 'not-settable' out-of-band attribute value...30
8.2 'delete-attribute' out-of-band value...........................30
8 Additional out-of-band values...................................32 8.2.1 Encoding of the 'delete-attribute' out-of-band value.........31
8.1 'not-settable' out-of-band value..............................32 8.3 'admin-define' out-of-band attribute value.....................31
8.1.1 Encoding of the 'not-settable' out-of-band attribute value..32 8.3.1 Encoding of the 'admin-define' out-of-band attribute value...32
8.2 'delete-attribute' out-of-band value..........................32 9 New Values for Existing Printer Description Attributes...........33
8.2.1 Encoding of the 'delete-attribute' out-of-band value........33 9.1 operations-supported (1setOf type2 enum).......................33
8.3 'admin-define' out-of-band attribute value....................33 10 Conformance Requirements........................................33
8.3.1 Encoding of the 'admin-define' out-of-band attribute value..35 11 IANA Considerations.............................................34
11.1 Operation Registrations.......................................35
9 New Values for Existing Printer Description Attributes..........35
9.1 operations-supported (1setOf type2 enum)......................35
10 Conformance Requirements.......................................35
11 IANA Considerations............................................37
11.1 Operation Registrations......................................37
11.2 Additional Enum Attribute Value Registrations for the 11.2 Additional Enum Attribute Value Registrations for the
"operations-supported" Printer Attribute..........................37 "operations-supported" Printer Attribute......................35
11.3 Attribute Registrations......................................38
11.4 Status code Registrations....................................38
11.5 Out-of-band Attribute Value Registrations....................39
12 Internationalization Considerations............................39
13 Security Considerations........................................39
14 Author's Addresses.............................................40
15 References.....................................................41
16 Appendix A: Allowed Values for Set-Printer-Attributes and Set-Job-
Attributes requests...............................................43
17 Appendix B: Attributes returned from Get-Printer-Supported-Values
56
18 Appendix C: Description of the Base IPP Documents..............61
19 Appendix D: Full Copyright Statement...........................62
Table of Tables 11.3 Attribute Registrations.......................................35
11.4 Status code Registrations.....................................36
11.5 Out-of-band Attribute Value Registrations.....................36
12 Internationalization Considerations.............................37
13 Security Considerations.........................................37
14 References......................................................38
14.1 Normative References..........................................38
14.2 Informative References........................................38
Appendix A: Allowed Values for Set-Printer-Attributes and Set-Job-
Attributes requests (Normative)........................39
Appendix B: Attributes returned from Get-Printer-Supported-Values
(Normative)............................................50
Appendix C: Description of the Base IPP Documents (Informative)....55
Authors' Addresses.................................................56
Full Copyright Statement...........................................58
Table 1 - Operation-Id assignments.................................9 Table of Tables
Table 2 - Job State Transition Table for the Set-Job-Attributes
operation .....................................................17
Table 3 - Member attributes of "printer-xri-supported" (1setOf
collection) ...................................................29
Table 4 - Operation-id assignments................................35
Table 5 - Validation rules for 'Any of "xxx-supported" '..........44
Table 6 - Validation rules for 'From Get-Printer-Supported-Values'45
Table 7 - Values allowed for Job Template Attributes in the Set-Job-
Attributes Operation ..........................................47
Table 8 - Values allowed for Job Description Attributes in the Set-
Job-Attributes Operation ......................................49
Table 9 - Values allowed for Printer Job Template Attributes in the Table 1 - Operation-Id assignments.................................7
Set-Printer-Attributes Operation ..............................51 Table 2 - Job State Transition Table for the Set-Job-Attributes
operation ..............................................15
Table 3 - Member attributes of "printer-xri-supported" (1setOf
collection) ............................................27
Table 4 - Operation-id assignments................................33
Table 5 - Validation rules for 'Any of "xxx-supported" '..........40
Table 6 - Validation rules for 'From Get-Printer-Supported-Values'41
Table 7 - Values allowed for Job Template Attributes in the Set-Job-
Attributes Operation ...................................42
Table 8 - Values allowed for Job Description Attributes in the Set-
Job-Attributes Operation ...............................43
Table 9 - Values allowed for Printer Job Template Attributes in the
Set-Printer-Attributes Operation .......................44
Table 10 - Values allowed for Printer Description Attributes in the Table 10 - Values allowed for Printer Description Attributes in the
Set-Printer-Attributes Operation ..............................53 Set-Printer-Attributes Operation .......................47
Table 11 - Printer Job Template Attributes returned from Get-Printer- Table 11 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values ..............................................57 Supported-Values .......................................51
Table 12 - Printer Job Template Attributes returned from Get-Printer- Table 12 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values ..............................................57 Supported-Values .......................................51
Table 13 - Printer Description Attributes returned from Get-Printer- Table 13 - Printer Description Attributes returned from Get-Printer-
Supported-Values ..............................................58 Supported-Values .......................................51
Table 14 - Printer Job Template Attributes returned from Get-Printer- Table 14 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values ..............................................58 Supported-Values .......................................52
Table 15 - Printer Job Template Attributes returned from Get-Printer- Table 15 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values ..............................................59 Supported-Values .......................................52
Table 16 - Printer Description Attributes returned from Get-Printer- Table 16 - Printer Description Attributes returned from Get-Printer-
Supported-Values ..............................................60 Supported-Values .......................................53
1 Introduction 1 Introduction
This document is an OPTIONAL extension to IPP/1.0 [RFC2565, RFC2566] This document is an OPTIONAL extension to IPP/1.0 [RFC2565, RFC2566]
and IPP/1.1 [RFC2911, RFC2910]. For a description of the base IPP and IPP/1.1 [RFC2911, RFC2910]. For a description of the base IPP
documents see section 18. documents see Appendix C.
The Internet Printing Protocol (IPP) is an application level protocol The Internet Printing Protocol (IPP) is an application level protocol
that can be used for distributed printing using Internet tools and that can be used for distributed printing using Internet tools and
technologies. IPP version 1.1 [RFC2911, RFC2910] focuses on end user technologies. IPP version 1.1 [RFC2911, RFC2910] focuses on end user
functionality with a few administrative operations included. This functionality with a few administrative operations included. This
document defines additional OPTIONAL end user, operator, and document defines additional OPTIONAL end user, operator, and
administrator Set-Job-Attributes and Set-Printer-Attributes administrator Set-Job-Attributes and Set-Printer-Attributes
operations used to modify IPP Job objects and Printer objects, operations used to modify IPP Job objects and Printer objects,
respectively. It also defines a third Get-Printer-Supported-Values respectively. It also defines a third Get-Printer-Supported-Values
administrator operation that returns values that the IPP Printer will administrator operation that returns values that the IPP Printer will
accept for setting its "xxx-supported" attributes. The Get-Printer- accept for setting its "xxx-supported" attributes. The Get-Printer-
Supported-Values operation MUST be supported, if the implementation Supported-Values operation MUST be supported, if the implementation
supports setting any "xxx-supported" Printer attributes using the supports setting any "xxx-supported" Printer attributes using the
Set-Printer-Attributes operation. Set-Printer-Attributes operation.
Nine Printer Description attributes are defined:
printer-settable-attributes-supported (1setOf type2 keyword)
job-settable-attributes-supported (1setOf type2 keyword)
document-format-varying-attributes (1setOf type2 keyword)
printer-message-time (integer(MIN:MAX))
printer-message-date-time (dateTime)
printer-xri-supported (1setOf collection)
xri-uri-scheme-supported (1setOf uriScheme)
xri-authentication-supported (1setOf type2 keyword)
xri-security-supported (1setOf type2 keyword)
Three out-of-band values are defined for use with these three Three out-of-band values are defined for use with these three
operations: 'delete-attribute' for deleting Job attributes with the operations: 'delete-attribute' for deleting Job attributes with the
Set-Job-Attributes request, 'not-settable' for use in either the Set- Set-Job-Attributes request, 'not-settable' for use in either the
Job-Attributes or Set-Printer-Attributes responses, and 'admin- Set-Job-Attributes or Set-Printer-Attributes responses, and 'admin-
define' for use in the Get-Printer-Supported-Values response. define' for use in the Get-Printer-Supported-Values response.
Two operation attributes: "printer-message-from-operator" (text) and Two operation attributes: "printer-message-from-operator" (text) and
"job-message-from-operator" (text) are defined to set the "job-message-from-operator" (text) are defined to set the
corresponding IPP/1.1 Printer and Job Description attributes with the corresponding IPP/1.1 Printer and Job Description attributes with the
same names. These operation attributes may be used with any same names. These operation attributes may be used with any
operation that affect the Printer or Job object for which an operation that affect the Printer or Job object for which an
operation might want to indicate a message. For the Set-Job- operation might want to indicate a message. For the Set-Job-
Attributes and Set-Printer-Attributes operations, the client MUST Attributes and Set-Printer-Attributes operations, the client MUST
explicitly set them, rather than using these operation attributes. explicitly set them, rather than using these operation attributes.
A Printer implementation can make the value of some attributes A Printer implementation can make the value of some attributes
dependent on the document-format, e.g. "resolution-supported". dependent on the document-format, e.g., "resolution-supported".
2 Terminology 2 Terminology
This section defines terminology used throughout this document. This section defines terminology used throughout this document.
2.1 Conformance Terminology 2.1 Conformance Terminology
Capitalized terms, such as MUST, MUST NOT, REQUIRED, SHOULD, SHOULD Capitalized terms, such as MUST, MUST NOT, REQUIRED, SHOULD, SHOULD
NOT, MAY, NEED NOT, and OPTIONAL, have special meaning relating to NOT, MAY, NEED NOT, and OPTIONAL, have special meaning relating to
conformance as defined in RFC 2119 [RFC2119] and [RFC2911] section conformance as defined in BCP 14, RFC 2119 [RFC2119] and [RFC2911]
12.1. If an implementation supports the extension defined in this section 12.1. If an implementation supports the extension defined in
document, then these terms apply; otherwise, they do not. These this document, then these terms apply; otherwise, they do not. These
terms define conformance to this document only; they do not affect terms define conformance to this document only; they do not affect
conformance to other documents, unless explicitly stated otherwise. conformance to other documents, unless explicitly stated otherwise.
2.2 Other terminology 2.2 Other terminology
This document uses terms such as Job object (or Job), IPP Printer This document uses terms such as Job object (or Job), IPP Printer
object (or Printer), "operation", "request", response", "attributes", object (or Printer), "operation", "request", response", "attributes",
"keywords", and "support". These terms have special meaning and are "keywords", and "support". These terms have special meaning and are
defined in the model terminology [RFC2911] section 12.2. The defined in the model terminology [RFC2911], section 12.2. The
following additional terms are introduced in this document: following additional terms are introduced in this document:
READ-ONLY: used in an attribute definition document to indicate that READ-ONLY: used in an attribute definition document to indicate that
the attribute MUST NOT be settable using an IPP protocol Set the attribute MUST NOT be settable using an IPP protocol Set
operation. In other words, the attribute is not settable by operation. In other words, the attribute is not settable by
definition. definition.
not-settable: an implementation does not support setting an
attribute (whether or not the attribute's definition is READ- not-settable: an implementation does not support setting an attribute
ONLY). (whether or not the attribute's definition is READ-ONLY).
3 Requirements and Use Cases 3 Requirements and Use Cases
The following requirements and usage are intended to be met by the The following requirements and usage are intended to be met by the
specification in this document. specification in this document.
1. The end-user and the operator need a way to modify a Job that is 1. The end-user and the operator need a way to modify a Job that is
in the 'pending' or 'pending-held' state. in the 'pending' or 'pending-held' state.
Usage: The end-user discovers that he/she forgot to include a Usage: The end-user discovers that he/she forgot to include a
print instruction, such as "finishings" = 'staple' after print instruction, such as "finishings" = 'staple' after
submitting a job. Rather than canceling the job and resubmitting submitting a job. Rather than canceling the job and resubmitting
it to the same IPP Printer, the end-user is able to modify the job it to the same IPP Printer, the end-user is able to modify the job
on the IPP Printer. on the IPP Printer.
The operator needs to modify a job because it is requesting a The operator needs to modify a job because it is requesting a
particular kind of media for which there is no more, but the particular kind of media for which there is no more, but the
policy is to print the job on a comparable medium. policy is to print the job on a comparable medium.
2. The system administrator needs a way to re-configure or change the 2. The system administrator needs a way to re-configure or change the
policy of the IPP Printer remotely. policy of the IPP Printer remotely.
Usage: The system administrator is adding additional named media Usage: The system administrator is adding additional named media
to the supported media list (setting 'name' values to the "media- to the supported media list (setting 'name' values to the "media-
supported" Printer attribute). supported" Printer attribute).
The system administrator is reducing the capability of the IPP The system administrator is reducing the capability of the IPP
Printer by removing one of the operations from the supported Printer by removing one of the operations from the supported
operations list, such as Cancel-Job, because the policy is to run operations list, such as Cancel-Job, because the policy is to run
the IPP Printer like a public facsimile machine. After having the IPP Printer like a public facsimile machine. After having
removed Cancel-Job from the list of supported operations, an removed Cancel-Job from the list of supported operations, an
administrative client needs to be able to display to an administrative client needs to be able to display to an
administrator that the implementation is capable of being administrator that the implementation is capable of being
reconfigured to support Cancel-Job once again. reconfigured to support Cancel-Job once again.
The system administrator is remotely configuring the IPP Printer The system administrator is remotely configuring the IPP Printer
after installing it, and so is replacing the Printer Description after installing it, and so is replacing the Printer Description
attributes that have the out-of-band 'no-value' value (see attributes that have the out-of-band 'no-value' value (see
[RFC2911] section 4.1) with the proper values. [RFC2911], section 4.1) with the proper values.
The operator is changing the media loaded in the input tray and so The operator is changing the media loaded in the input tray, and
is replacing the "media-ready" Job Template Printer attribute so is replacing the "media-ready" Job Template Printer attribute
value with the proper values value with the proper values.
4 Definition of the Set operations 4 Definition of the Set operations
The Set-Printer-Attributes operation (as are all Printer operations) The Set-Printer-Attributes operations (as are all Printer operations)
are directed at Printer objects. A client MUST always supply the are directed at Printer objects. A client MUST always supply the
"printer-uri" operation attribute in order to identify the correct "printer-uri" operation attribute in order to identify the correct
target of the operation. These descriptions assume all of the common target of the operation. These descriptions assume all of the common
semantics of IPP/1.1 Model and Semantics document [RFC2911] section semantics of the IPP/1.1 Model and Semantics document [RFC2911],
3.1. section 3.1.
The Set-Job-Attributes operation (as are all Job operations) are The Set-Job-Attributes operations (as are all Job operations) are
directed at Job objects. A client MUST always supply some means of directed at Job objects. A client MUST always supply some means of
identifying the Job object in order to identify the correct target of identifying the Job object in order to identify the correct target of
the operation. That job identification MAY either be a single Job the operation. That job identification MAY either be a single Job
URI or a combination of a Printer URI with a Job ID as defined in URI or a combination of a Printer URI with a Job ID, as defined in
[RFC2911]. The IPP object implementation MUST support both forms of [RFC2911]. The IPP object implementation MUST support both forms of
identification for every job. If possible, a client SHOULD use the identification for every job. If possible, a client SHOULD use the
Printer URI with a Job ID rather than a Job URI, since the 32-bit Printer URI with a Job ID rather than a Job URI, since the 32-bit
"job-id" is more readily translated to and from other print protocols "job-id" is more readily translated to and from other print protocols
that MAY be serving as gateways into or out of the IPP that MAY be serving as gateways into or out of the IPP
implementation. implementation.
The Set Printer operations are summarized in Table 1: The Set Printer operations are summarized in Table 1:
Table 1 - Operation-Id assignments Table 1 - Operation-Id assignments
Operation Name Operation Brief description Operation Name Operation Brief description
-Id -Id
Set-Printer- 0x0013 Sets attribute values of the target Set-Printer- 0x0013 Sets attribute values of the target
Attributes Printer object Attributes Printer object
Set-Job-Attributes 0x0014 Sets attribute values of the target Set-Job-Attributes 0x0014 Sets attribute values of the target
Job object Job object
Get-Printer- Gets values that are valid for Get-Printer- 0x0015 Gets values that are valid for
Supported-Values 0x0015 setting "xxx-supported" attributes Supported-Values setting "xxx-supported" attributes
using the Set-Printer-Attributes using the Set-Printer-Attributes
operation operation
4.1 Set-Printer-Attributes Operation 4.1 Set-Printer-Attributes Operation
This OPTIONAL operation allows a client to set the values of the This OPTIONAL operation allows a client to set the values of the
attributes of a Printer object. In the request, the client supplies attributes of a Printer object. In the request, the client supplies
the set of Printer keyword attribute names and values that are to be the set of Printer keyword attribute names and values that are to be
set. In the response, the Printer object returns success or rejects set. In the response, the Printer object returns success or rejects
the entire request with indications of which attribute or attributes the entire request with indications of which attribute or attributes
could not be set. could not be set.
The Printer object validates the client-supplied attributes in the The Printer object validates the client-supplied attributes in the
Set-Printer-Attributes request. For an attribute to validate it MUST Set-Printer-Attributes request. For an attribute to validate, it
meet all of the following rules: MUST meet all of the following rules:
1. The number of attributes supplied by the client MUST NOT exceed 1. The number of attributes supplied by the client MUST NOT exceed
the maximum number that the Printer supports in a Set-Printer- the maximum number that the Printer supports in a Set-Printer-
Attributes request. A Printer MUST accept at least one attribute, Attributes request. A Printer MUST accept at least one attribute,
but SHOULD accept a reasonable number in a single Set-Printer- but SHOULD accept a reasonable number in a single Set-Printer-
Attributes request. Attributes request.
Note: There is no way for the client to determine the maximum Note: There is no way for the client to determine the maximum
number of attributes that the Printer supports in a Set-Printer- number of attributes that the Printer supports in a Set-Printer-
Attributes request, except to try a reasonable number. Attributes request, except to try a reasonable number.
2. The Printer MUST support the attribute. 2. The Printer MUST support the attribute.
3. The attribute MUST NOT be READ-ONLY, i.e., the definition of the 3. The attribute MUST NOT be READ-ONLY, i.e., the definition of the
attribute MUST NOT indicate that the attribute is READ-ONLY (see attribute MUST NOT indicate that the attribute is READ-ONLY (see
Appendix A for an indication of which IPP/1.1 attributes are READ- Appendix A for an indication of which IPP/1.1 attributes are
ONLY). READ-ONLY).
4. The attribute MUST be settable in this implementation. 4. The attribute MUST be settable in this implementation.
5. The Printer MUST support the value according to the rules defined 5. The Printer MUST support the value, according to the rules defined
in Appendix A, i.e., each value of each supplied "xxx" attribute in Appendix A, i.e., each value of each supplied "xxx" attribute
MUST be validated against a value of a corresponding "xxx- MUST be validated against the value of a corresponding "xxx-
supported" Printer attribute. One of those rules permits an supported" Printer attribute. One of those rules permits an
administrator to set arbitrary 'name' values to those "xxx- administrator to set arbitrary 'name' values to those "xxx-
supported" Printer attributes that include the 'name' attribute supported" Printer attributes that include the 'name' attribute
syntax if the implementation supports the 'admin-define' out-of- syntax if the implementation supports the 'admin-define' out-of-
band value for that "xxx-supported" attribute (see section 16 and band value for that "xxx-supported" attribute (see section 8.3 and
8.3). Appendix A).
6. The attribute's values MUST NOT conflict with the values of other 6. The attribute's values MUST NOT conflict with the values of other
Printer attributes, including ones being set in this same Printer attributes, including ones being set in this same
operation. operation.
If any of the supplied attributes does not validate, the Printer If any of the supplied attributes are not validate, the Printer
object MUST reject the entire operation; the Printer object MUST NOT object MUST reject the entire operation; the Printer object MUST NOT
partially set some of the supplied attributes. In other words, after partially set some of the supplied attributes. In other words, after
the operation, all the supplied attributes MUST be set or none of the operation, all the supplied attributes MUST be set or none of
them MUST be set, thus making the Set-Printer-Attributes an atomic them MUST be set, thus making the Set-Printer-Attributes an atomic
operation. operation.
The Printer MUST accept this operation when its READ-ONLY "printer- The Printer MUST accept this operation when its READ-ONLY "printer-
state" attribute (see RFC2911] section 4.4.11) is 'idle' or state" attribute (see [RFC2911], section 4.4.11) is 'idle' or
'stopped', and SHOULD accept it when the value is 'processing'. The 'stopped', and SHOULD accept it when the value is 'processing'. The
Printer MUST accept this operation for any of the values of the Printer MUST accept this operation for any of the values of the
Printer object's READ-ONLY "printer-state-reasons" and "printer-is- Printer object's READ-ONLY "printer-state-reasons" and "printer-is-
accepting-jobs" attributes, unless explicitly defined otherwise in accepting-jobs" attributes, unless explicitly defined otherwise in
the definition of these attributes' values. the definition of these attributes' values.
This operation MUST NOT change the value of attributes not specified This operation MUST NOT change the value of attributes not specified
in the operation unless the definition of the attribute explicitly in the operation unless the definition of the attribute explicitly
specifies such side-effects. For example, this document explicitly specifies such side-effects. For example, this document explicitly
specifies that when this operation sets "printer-message-from- specifies that when this operation sets "printer-message-from-
operator", the Printer also MUST set the READ-ONLY "printer-message- operator", the Printer also MUST set the READ-ONLY "printer-message-
time" and READ-ONLY "printer-message-date-time" attributes to the time" and READ-ONLY "printer-message-date-time" attributes to the
time of the operation as a side effect . In particular, if this time of the operation as a side effect. In particular, if this
operation changes an "xxx-default" attribute, the new value MUST be operation changes an "xxx-default" attribute, the new value MUST be
in the "xxx-supported" attribute or the request MUST contain a new in the "xxx-supported" attributes or the request MUST contain a new
value for "xxx-supported" which contains the new value for the "xxx- value for "xxx-supported", which contains the new value for the
default". Otherwise, the Printer MUST reject the operation. In "xxx-default". Otherwise, the Printer MUST reject the operation. In
general, Printer attribute definitions that are settable will not general, Printer attribute definitions that are settable will not
define side-effects on other attributes that are settable, only side define side-effects on other attributes that are settable, only side
effects on READ-ONLY attributes, if any. effects on READ-ONLY attributes, if any.
4.1.1 Settable and READ-ONLY Printer Description attributes 4.1.1 Settable and READ-ONLY Printer Description attributes
If the Printer supports the Set-Printer-Attributes operation, then it If the Printer supports the Set-Printer-Attributes operation, then it
SHOULD support setting of: SHOULD support the setting of:
all Job Template Default ("xxx-default") attributes
all Job Template Supported ("xxx-supported") attributes all Job Template Default ("xxx-default") attributes
all Job Template Ready ("xxx-ready") attributes all Job Template Supported ("xxx-supported") attributes
all Job Template Ready ("xxx-ready") attributes
that the implementation supports (see [RFC2911] section 4.2 and that the implementation supports (see [RFC2911] section 4.2 and
extensions). extensions).
Some Printer Description attributes (see [RFC2911] section 4.4) MUST Some Printer Description attributes (see [RFC2911] section 4.4) MUST
NOT be settable, i.e., they are defined to be READ-ONLY. An NOT be settable, i.e., they are defined to be READ-ONLY. An
attribute marked as "READ-ONLY" in the Printer Description attribute attribute marked as "READ-ONLY" in the Printer Description attribute
table in Appendix A is such an attribute. The Printer attributes table in Appendix A is such an attribute. The Printer attributes
that are not marked as "READ-ONLY" MAY be settable using the Set- that are not marked as "READ-ONLY" MAY be settable using the Set-
Printer-Attributes operation, depending on implementation. Printer-Attributes operation, depending on implementation.
Note: From now on, all extensions that define new object attributes Note: From now on, all extensions that define new object attributes
will indicate whether or not the attributes are READ-ONLY, by will indicate whether or not the attributes are READ-ONLY, by
including the "READ-ONLY" adjective in their descriptions and/or including the "READ-ONLY" adjective in their descriptions and/or
explicitly stating whether they MAY be settable. explicitly stating whether they MAY be settable.
The current values of each "xxx-supported" Printer attribute MUST The current values of each "xxx-supported" Printer attribute MUST
reflect the current policy for support of the corresponding "xxx" reflect the current policy for support of the corresponding "xxx"
attribute. If an "xxx-supported" Printer attribute is settable in an attribute. If an "xxx-supported" Printer attribute is settable in an
implementation, then its value(s) MUST affect the behavior of the implementation, then its value(s) MUST affect the behavior of the
implementation. If an "xxx-supported" Printer attribute is defined implementation. If an "xxx-supported" Printer attribute is defined
to be READ-ONLY or is not-settable in an implementation, then its to be READ-ONLY or is not-settable in an implementation, then its
values MUST NOT be settable using the Set-Printer-Attributes values MUST NOT be settable using the Set-Printer-Attributes
operation. Consider the following example: operation. Consider the following examples:
For example, if the "operations-supported" Printer Description For example, if the "operations-supported" Printer Description
attribute (see [RFC2911] section 4.4.15) is settable in a attribute (see [RFC2911] section 4.4.15) is settable in a
particular implementation, then changing its value with a Set- particular implementation, then changing its value with a Set-
Printer-Attributes operation MUST affect the operations that the Printer-Attributes operation MUST affect the operations that the
implementation accepts or rejects. Such an implementation will implementation accepts or rejects. Such an implementation will
need to be able to reject values for operations that it contains no need to be able to reject values for operations that it contains
code support for (see section 4.3). If the "operations-supported" no code support for (see section 4.3). If the "operations-
Printer Description attribute is not settable in a particular supported" Printer Description attribute is not settable in a
implementation, then that implementation MUST reject an attempt to particular implementation, then that implementation MUST reject an
set it with a Set-Printer-Attributes operation, return the 'client- attempt to set it with a Set-Printer-Attributes operation, return
error-attributes-not-settable' status code (see section 7.1), and the 'client-error-attributes-not-settable' status code (see
return the "operations-supported" attribute with the out-of-band section 7.1), and return the "operations-supported" attribute,
'not-settable' value in the Unsupported Attributes Group. with the out-of-band 'not-settable' value in the Unsupported
Attributes Group.
As another example, consider an implementation in which the "media- As another example, consider an implementation in which the
default" and "media-supported" are settable. If a client supplies "media-default" and "media-supported" are settable. If a client
a Set-Printer-Attributes request that contains the "media-default" supplies a Set-Printer-Attributes request that contains the
attribute with a value that is not a member of the Printer's "media-default" attribute with a value that is not a member of the
"media-supported" attribute, the Printer MUST reject the request Printer's "media-supported" attribute, the Printer MUST reject the
and return the "client-error-conflicting-attributes" status code request and return the "client-error-conflicting-attributes"
with the "media-default" and "media-supported" attributes and their status code with the "media-default" and "media-supported"
values (see [RFC2911] section 3.1.7). attributes and their values (see [RFC2911] section 3.1.7).
As a third example, if a client supplies a Set-Printer-Attributes As a third example, if a client supplies a Set-Printer-Attributes
request that contains both the "media-default" and the "media- request that contains both the "media-default" and the "media-
supported" attributes, but includes a value in the "media-default" supported" attributes, but includes a value in the "media-default"
that is not a member of the supplied "media-supported" attribute, that is not a member of the supplied "media-supported" attribute,
the Printer MUST reject the request and return the "client-error- the Printer MUST reject the request and return the "client-error-
conflicting-attributes" status code with the "media-default" and conflicting-attributes" status code with the "media-default" and
"media-supported" attributes and their values (see [RFC2911] "media-supported" attributes and their values (see [RFC2911]
section 3.1.7). section 3.1.7).
Access Rights: The authenticated user (see [RFC2911] section 8.3) Access Rights: The authenticated user (see [RFC2911] section 8.3)
performing this operation must be an operator or administrator of the performing this operation must be an operator or administrator of the
Printer object (see [RFC2911] Sections 1 and 8.5). Most Printer Printer object (see [RFC2911] Sections 1 and 8.5). Most Printer
attributes will require administrator access rights to set, such as attributes will require administrator access rights to set, such as
"xxx-supported", while some will require operator access rights only, "xxx-supported", while some will require operator access rights only,
such as "media-ready" and "printer-message-from-operator". Which such as "media-ready" and "printer-message-from-operator". Which
attributes require which access rights depends on implementation and attributes require which access rights depends on implementation, and
MAY depend on site policy. MAY depend on site policy.
4.1.2 Set-Printer-Attributes Request 4.1.2 Set-Printer-Attributes Request
The following sets of attributes are part of the Set-Printer- The following sets of attributes are part of the Set-Printer-
Attributes Request: Attributes Request:
Group 1: Operation Attributes Group 1: Operation Attributes
Natural Language and Character Set: Natural Language and Character Set:
The "attributes-charset" and "attributes-natural-language" The "attributes-charset" and "attributes-natural-language"
attributes as described in [RFC2911] section 3.1.4.1. attributes, as described in [RFC2911], section 3.1.4.1.
Target: Target:
The "printer-uri" (uri) operation attribute which is the target The "printer-uri" (uri) operation attribute, which is the
for this operation as described in [RFC2911] section 3.1.5. target for this operation, as described in [RFC2911], section
3.1.5.
Requesting User Name: Requesting User Name:
The "requesting-user-name" (name(MAX)) attribute SHOULD be The "requesting-user-name" (name(MAX)) attribute SHOULD be
supplied by the client as described in [RFC2911] section 8.3. supplied by the client, as described in [RFC2911], section 8.3.
"document-format" (mimeMediaType): "document-format" (mimeMediaType):
The client OPTIONALLY supplies this attribute. The Printer The client OPTIONALLY supplies this attribute. The Printer
object MUST support this attribute. This attribute is useful object MUST support this attribute. This attribute is useful
for a client to select the document-format to which the for a client to select the document-format to which the
attribute modification should be applied. A Printer attribute modification should be applied. A Printer
implementation MAY allow some attributes to have different implementation MAY allow some attributes to have different
values for each document format that it supports. See [RFC2911] values for each document format that it supports. See
section 3.2.5.1 "Get-Printer-Attributes Request". [RFC2911], section 3.2.5.1 "Get-Printer-Attributes Request".
If the client includes this attribute, the Printer MUST change If the client includes this attribute, the Printer MUST change
the supplied attributes for the document format specified by the supplied attributes for the document format specified by
this attribute. If a supplied attribute is a member of the this attribute. If a supplied attribute is a member of the
"document-format-varying-attributes" (i.e., the attribute "document-format-varying-attributes" (i.e., the attribute
varies by document format, see section 6.3), the Printer MUST varies by document format, see section 6.3), the Printer MUST
change the supplied attribute for the document format specified change the supplied attribute for the document format specified
by this attribute, but not for other document formats. If a by this attribute, but not for other document formats. If a
supplied attribute isn't a member of the "document-format- supplied attribute isn't a member of the "document-format-
varying-attributes" (i.e. it doesn't vary by document format), varying-attributes" (i.e., it doesn't vary by document format),
the Printer MUST change the supplied attribute for all document the Printer MUST change the supplied attribute for all document
formats. formats.
If the client omits this attribute, the Printer MUST change the If the client omits this attribute, the Printer MUST change the
supplied attributes for all document formats whether or not supplied attributes for all document formats, whether or not
they vary by document-format. they vary by document-format.
If the client supplies a value for the "document-format" If the client supplies a value for the "document-format"
Operation attribute that is either 'application/octet-stream' Operation attribute, that is either 'application/octet-stream'
or not supported by the Printer, i.e., is not among the values or not supported by the Printer, i.e., is not among the values
of the Printer object's "document-format-supported" attribute, of the Printer object's "document-format-supported" attribute,
the Printer object MUST reject the operation and return the the Printer object MUST reject the operation and return the
'client-error-document-format-not-supported' status code. 'client-error-document-format-not-supported' status code.
Note: the document-format 'application/octet-stream' is the Note: the document-format 'application/octet-stream' is the
union of several document-formats (see [RFC2911] section union of several document-formats (see [RFC2911] section
3.2.5.1, Get-Printer-Attributes) and is not a true document- 3.2.5.1, Get-Printer-Attributes) and is not a true document-
format. format.
Group 2: Printer Attributes Group 2: Printer Attributes
The client MUST supply a set of Printer attributes with one or The client MUST supply a set of Printer attributes with one or
more values (including explicitly allowed out-of-band values) more values (including explicitly allowed out-of-band values) as
as defined in [RFC2911] section 4.2 Job Template Attributes defined in [RFC2911] section 4.2 Job Template Attributes ("xxx-
("xxx-default", "xxx-supported", and "xxx-ready" attributes), default", "xxx-supported", and "xxx-ready" attributes), section
section 4.4 Printer Description Attributes, and any attribute 4.4 Printer Description Attributes, and any attribute extensions
extensions supported by the Printer. The value(s) of each supported by the Printer. The value(s) of each Printer attribute
Printer attribute supplied in Group 2 replaces the value(s) of supplied in Group 2 replaces the value(s) of the corresponding
the corresponding Printer attribute on the target Printer Printer attribute on the target Printer object. For attributes
object. For attributes that can have multiple values (1setOf), that can have multiple values (1setOf), all values supplied by the
all values supplied by the client replace all values of the client replace all values of the corresponding Printer object
corresponding Printer object attribute. If a Printer object attribute. If a Printer object attribute had not yet been
attribute had not been configured yet and so had the 'no-value' configured, and so assumed the 'no-value' out-of-band value (see
out-of-band value (see [RFC2911] section 4.1), the supplied [RFC2911] section 4.1), the supplied value(s) replaces the 'no-
value(s) replace the 'no-value' value. value' value.
4.1.3 Set-Printer-Attributes Response 4.1.3 Set-Printer-Attributes Response
The Printer object returns the following sets of attributes as part The Printer object returns the following sets of attributes as part
of the Get-Printer-Attributes Response: of the Get-Printer-Attributes Response:
Group 1: Operation Attributes Group 1: Operation Attributes
Status Message: Status Message:
In addition to the REQUIRED status code returned in every In addition to the REQUIRED status code returned in every
response, the response OPTIONALLY includes a "status-message" response, the response OPTIONALLY includes a "status-message"
(text(255)) and/or a "detailed-status-message" (text(MAX)) (text(255)) and/or a "detailed-status-message" (text(MAX))
operation attribute as described in [RFC2911] sections 13 and operation attribute, as described in [RFC2911] sections 3.1.6
3.1.6. and 13.
Natural Language and Character Set: Natural Language and Character Set:
The "attributes-charset" and "attributes-natural-language" The "attributes-charset" and "attributes-natural-language"
attributes as described in [RFC2911] section 3.1.4.2. attributes, as described in [RFC2911], section 3.1.4.2.
Group 2: Unsupported Attributes Group 2: Unsupported Attributes
See [RFC2911] section 3.1.7 for details on returning See [RFC2911], section 3.1.7, for details on returning Unsupported
Unsupported Attributes. Attributes.
If some of the attributes in the operation fail to validate, If some of the attributes in the operation fail to validate, the
the Printer MUST reject the operation, MUST NOT change any Printer MUST reject the operation, MUST NOT change any Printer
Printer attributes, and MUST return the indicated status code attributes, and MUST return the indicated status code below. In
below. In this group, the Printer MUST also return all this group, the Printer MUST also return all attributes that fail
attributes that fail to validate. The following are the to validate. The following are the reasons that an attribute
reasons that an attribute fails to validate and the value fails to validate and the value returns for the attribute, along
returned for the attribute, along with the indicated status with the indicated status code and order of detection:
code and order of detection:
1.The number of attributes supplied by the client exceeds the 1. The number of attributes supplied by the client exceeds the
maximum number that the Printer supports in a Set-Printer- maximum number that the Printer supports in a Set-Printer-
Attributes request: return the 'client-error-request- Attributes request: return the 'client-error-request-entity-
entity-too-large' (see [RFC2911] section 13.1.4.9). too-large' (see [RFC2911], section 13.1.4.9).
2.The Printer doesn't support the attribute: return the 2. The Printer doesn't support the attribute: return the attribute
attribute with the "out-of-band" value 'unsupported' (see with the "out-of-band" value 'unsupported' (see [RFC2911]
[RFC2911] section 3.1.7 and [RFC2910]) and the 'client- section 3.1.7 and [RFC2910]) and the 'client-error-attributes-
error-attributes-or-values-not-supported (see [RFC2911] or-values-not-supported (see [RFC2911], section 13.1.4.12).
section 13.1.4.12).
3.The attribute is either READ-ONLY (in its definition) or is 3. The attribute is either READ-ONLY (in its definition) or is
not-settable in this implementation: return the attribute not-settable in this implementation: return the attribute with
with the "out-of-band" value 'not-settable' (see section the "out-of-band" value 'not-settable' (see section 8.1) and
8.1) and the 'client-error-attributes-not-settable' status the 'client-error-attributes-not-settable' status code (see
code (see section 7.1). section 7.1).
4.The Printer doesn't support the value: if the attribute in 4. The Printer doesn't support the value: if the attribute in the
the operation has a single value return it. If the operation has a single value, return it. If the attribute in
attribute in the operation is multi-valued, return only the operation is multi-valued, return only those values in a
those values in a 1setOf that are not supported. Return the 1setOf that are not supported. Return the 'client-error-
'client-error-attributes-or-values-not-supported' status attributes-or-values-not-supported' status code (see [RFC2911],
code (see [RFC2911] section 13.1.4.12). section 13.1.4.12).
5.The values of some of the supplied attributes conflict with 5. The values of some of the supplied attributes conflict with one
one another and/or other Printer attribute values not being another and/or other Printer attribute values not being set: if
set: if the conflicting attribute in the operation has a the conflicting attribute in the operation has a single value,
single value return the attribute and the value. If the return the attribute and the value. If the attribute in the
attribute in the operation is multi-valued, return only the operation is multi-valued, return only the attribute and those
attribute and those values in a 1setOf that are conflicting values in a 1setOf that are conflicting with other attributes.
with other attributes. Return the 'client-error- Return the 'client-error-conflicting-attributes' status code
conflicting-attributes' status code (see [RFC2911] section (see [RFC2911], section 13.1.4.15).
13.1.4.15).
4.2 Set-Job-Attributes Operation 4.2 Set-Job-Attributes Operation
This OPTIONAL operation allows a client to set the values of the This OPTIONAL operation allows a client to set the values of the
attributes of a Job object. In the request, the client supplies the attributes of a Job object. In the request, the client supplies the
set of Job keyword attribute names and values that are to be set. In set of Job keyword attribute names and values that are to be set. In
the response, the IPP object returns success or rejects the entire the response, the IPP object returns success or rejects the entire
request with indications of which attribute or attributes could not request with indications of which attribute or attributes could not
be set. be set.
This operation is almost identical to the Set-Printer-Attributes This operation is almost identical to the Set-Printer-Attributes
operation and follows the same rules for validation (see section operation and follows the same rules for validation (see section
4.1). The only differences are that the Set-Job-Attributes operation 4.1). The only differences are that the Set-Job-Attributes operation
is directed at a Job object rather than a Printer object, there is no is directed at a Job object rather than a Printer object, there is no
"document-format" operation attribute used when setting a Job object, "document-format" operation attribute used when setting a Job object,
the operation can add an attribute to the (Job) object, the 'delete- the operation can add an attribute to the (Job) object, the 'delete-
attributes' out-of-band value is permitted to remove an attribute, attributes' out-of-band value is permitted to remove an attribute,
and the validation is the same as the Job Creation operations (Print- and the validation is the same as the Job Creation operations
Job, Print-URI, and Create-Job), i.e., depends on the "xxx-supported" (Print-Job, Print-URI, and Create-Job), i.e., depends on the "xxx-
Printer Description attributes (see [RFC2911] section 3.1). Using supported" Printer Description attributes (see [RFC2911] section
the Set-Printer-Attributes operation, the administrator can set 3.1). Using the Set-Printer-Attributes operation, the administrator
arbitrary 'name' values to those "xxx-supported" Printer attributes can set arbitrary 'name' values to those "xxx-supported" Printer
that include the 'name' attribute syntax if the implementation attributes, that include the 'name' attribute syntax, if the
supports the 'admin-define' out-of-band value for that "xxx- implementation supports the 'admin-define' out-of-band value for that
supported" attribute (see section 16 and 8.3). However, the Set-Job- "xxx-supported" attribute (see section 8.3 and Appendix A). However,
Attributes cannot be used to add unsupported names to the Job object. the Set-Job-Attributes cannot be used to add unsupported names to the
Job object.
If a client supplies a job attribute in a Set-Job-Attributes request If a client supplies a job attribute in a Set-Job-Attributes request
that the Printer supports, and the job was originally submitted that the Printer supports, and the job was originally submitted
without supplying that attribute, the Printer adds the attribute to without supplying that attribute, the Printer adds the attribute to
the Job object. the Job object.
If the client supplies a job attribute with the "out-of-band" value If the client supplies a job attribute with the "out-of-band" value
'delete-attribute' (see section 8.2), then the Printer MUST remove 'delete-attribute' (see section 8.2), then the Printer MUST remove
the attribute and all of its values from the Job object, if present. the attribute and all of its values from the Job object, if present.
The semantic effect of the client supplying the 'delete-attribute' The semantic effect of the client supplying the 'delete-attribute'
value in a Set-Job-Attributes operation MUST be the same as if the value in a Set-Job-Attributes operation MUST be the same as if the
attribute had not been supplied with the Job object in the Job attribute had not been supplied with the Job object in the Job
Creation operation, i.e., the Printer applies its default attribute Creation operation, i.e., the Printer applies its default attribute
or behavior with lower precedence that the PDL (see the beginning of or behavior with lower precedence that the PDL (see the beginning of
[RFC2911] section 4.2 and [RFC2911] 3.2.1.1). Any subsequent query [RFC2911] section 4.2 and [RFC2911] 3.2.1.1). Any subsequent query
of the Job object using Get-Job-Attributes or Get-Jobs MUST NOT of the Job object using Get-Job-Attributes or Get-Jobs, MUST NOT
return any attribute that has been deleted using the 'delete- return any attribute that has been deleted using the 'delete-
attribute' out-of-band value. However, a client can re-establish attribute' out-of-band value. However, a client can re-establish
such a deleted Job attribute with any supported value(s) using a such a deleted Job attribute with any supported value(s), using a
subsequent Set-Job-Attributes operation. subsequent Set-Job-Attributes operation.
If the client supplies an attribute in a Set-Job-Attributes request If the client supplies an attribute in a Set-Job-Attributes request
with the 'delete-attribute' value and that attribute is not present with the 'delete-attribute' value and that attribute is not present
on the Job object, the Printer ignores that supplied attribute in the on the Job object, the Printer ignores that supplied attribute in the
request, does not return the attribute in the Unsupported Attributes request, does not return the attribute in the Unsupported Attributes
group, and returns the 'successful-ok' status code, if there are no group, and returns the 'successful-ok' status code, if there are no
other problems with the request. other problems with the request.
The validation of the Set-Job-Attributes request is performed by the The validation of the Set-Job-Attributes request is performed by the
skipping to change at page 16, line 49 skipping to change at page 15, line 8
a Job Creation operation would have been rejected, then the Set-Job- a Job Creation operation would have been rejected, then the Set-Job-
Attributes MUST be rejected and the Job MUST be unchanged. In Attributes MUST be rejected and the Job MUST be unchanged. In
addition, if any of the supplied attributes are not supported, are addition, if any of the supplied attributes are not supported, are
not settable, or the values are not supported, the Printer object not settable, or the values are not supported, the Printer object
MUST reject the entire operation; the Printer object MUST NOT MUST reject the entire operation; the Printer object MUST NOT
partially set some of the supplied attributes. In other words, after partially set some of the supplied attributes. In other words, after
the operation, all the supplied attributes MUST be set or none of the operation, all the supplied attributes MUST be set or none of
them MUST be set, thus making the Set-Job-Attributes an atomic them MUST be set, thus making the Set-Job-Attributes an atomic
operation. operation.
The IPP object MUST accept or reject this operations when the Job's The IPP object MUST accept or reject this operation when the Job's
READ-ONLY "job-state" attribute has the values shown in Table 2. The READ-ONLY "job-state" attribute has the values shown in Table 2. The
job's current state MUST affect whether the IPP object accepts or job's current state MUST affect whether the IPP object accepts or
rejects the request. For example, in the case where the operation rejects the request. For example, in the case where the operation
creates a request for unavailable resources, the Job transitions to a creates a request for unavailable resources, the Job transitions to a
new state. Table 2 shows the allowed behaviors in each job state and new state. Table 2 shows the allowed behaviors in each job state and
the transitions. the transitions.
Table 2 - Job State Transition Table for the Set-Job-Attributes Table 2 - Job State Transition Table for the Set-Job-Attributes
operation operation
Current New P object's response status code Current New IPP object's response status code
"job-state" "job-state" Iand "action": "job-state" "job-state" and "action":
'pending' 'pending' 'successful-ok' 'pending' 'pending' 'successful-ok'
'pending' 'pending-held' 'successful-ok' - needed resources 'pending' 'pending-held' 'successful-ok' - needed resources
are not ready are not ready
'pending-held' 'pending-held' 'successful-ok' 'pending-held' 'pending-held' 'successful-ok'
'pending-held' 'pending' 'successful-ok' - needed resources 'pending-held' 'pending' 'successful-ok' - needed resources
are ready are ready
'processing' 'processing' 'successful-ok' or 'client-error- 'processing' 'processing' 'successful-ok' or 'client-error-
not-possible' depending on not-possible' depending on
implementation, including the implementation, including the
attributes being set, whether the attributes being set, whether the
job has started marking media, job has started marking media,
etc. etc.
'processing- 'processing- 'successful-ok' or 'client-error- 'processing- 'processing- 'successful-ok' or 'client-error-
stopped' stopped' not-possible' depending on stopped' stopped' not-possible' depending on
implementation, including the implementation, including the
attributes being set, whether the attributes being set, whether the
job has started marking media, job has started marking media,
etc. etc.
'completed' 'completed' 'client-error-not-possible' 'completed' 'completed' 'client-error-not-possible'
'canceled' 'canceled' 'client-error-not-possible' 'canceled' 'canceled' 'client-error-not-possible'
'aborted' 'aborted' 'client-error-not-possible' 'aborted' 'aborted' 'client-error-not-possible'
This operation MUST NOT change the value of attributes not specified This operation MUST NOT change the value of attributes not specified
in the operation unless the definition of the attribute explicitly in the operation unless the definition of the attribute explicitly
specifies such side-effects. In general, Job attribute definitions specifies such side-effects. In general, Job attribute definitions
that are settable will not define side-effects on other attributes that are settable will not define side-effects on other attributes
that are settable, only side effects on READ-ONLY attributes, if any. that are settable, only side effects on READ-ONLY attributes, if any.
4.2.1 Settable and READ-ONLY Job Description attributes 4.2.1 Settable and READ-ONLY Job Description attributes
If the Printer supports the "job-message-from-operator" Job If the Printer supports the "job-message-from-operator" Job
Description attribute (see [RFC2911] section 4.3.16) and the client Description attribute (see [RFC2911] section 4.3.16) and the client
explicitly supplies a new value for the "job-message-from-operator" explicitly supplies a new value for the "job-message-from-operator"
in the Set-Job-Attributes request, then the Printer MUST set the Job Description attribute in Group 2 in the Set-Job-Attributes
"job-message-from-operator" Job attribute to this new value. request, then the Printer MUST set the "job-message-from-operator"
Job Description attribute to this new value.
If the Printer supports the Set-Job-Attributes operation, then it If the Printer supports the Set-Job-Attributes operation, then it
SHOULD support setting of: SHOULD support the setting of:
all Job Template job ("xxx") attributes
all Job Template job ("xxx") attributes
that the implementation supports (see [RFC2911] section 4.2 and that the implementation supports (see [RFC2911] section 4.2 and
extensions). extensions).
Some Job Description attributes (see [RFC2911] section 4.3) MUST NOT Some Job Description attributes (see [RFC2911] section 4.3) MUST NOT
be settable, i.e., they are defined to be READ-ONLY. An attribute be settable, i.e., they are defined to be READ-ONLY. An attribute
marked as "READ-ONLY" in the Job Description attribute table in marked as "READ-ONLY" in the Job Description attribute table in
Appendix A is such an attribute. The Job attributes not marked as Appendix A is such an attribute. The Job attributes not marked as
"READ-ONLY" MAY be settable using the Set-Job-Attributes operation, "READ-ONLY" MAY be settable using the Set-Job-Attributes operation,
depending on implementation. depending on implementation.
Note: From now on, all extensions that define new object attributes Note: From now on, all extensions that define new object attributes
will indicate whether or not the attributes are READ-ONLY, by will indicate whether or not the attributes are READ-ONLY, by
including the "READ-ONLY" adjective in their descriptions and/or including the "READ-ONLY" adjective in their descriptions and/or
explicitly stating whether they MAY be settable. explicitly stating whether they MAY be settable.
Access Rights: The authenticated user (see [RFC2911] section 8.3) Access Rights: The authenticated user (see [RFC2911] section 8.3)
performing this operation must either be the job owner (as determined performing this operation must either be the job owner (as determined
in the Job Creation operation) or an operator or administrator of the in the Job Creation operation) or an operator or administrator of the
Printer object (see [RFC2911] Sections 1 and 8.5). Printer object (see [RFC2911] Sections 1 and 8.5).
4.2.2 Set-Job-Attributes Request 4.2.2 Set-Job-Attributes Request
The following sets of attributes are part of the Set-Job-Attributes The following sets of attributes are part of the Set-Job-Attributes
Request: Request:
Group 1: Operation Attributes Group 1: Operation Attributes
Natural Language and Character Set: Natural Language and Character Set:
The "attributes-charset" and "attributes-natural-language" The "attributes-charset" and "attributes-natural-language"
attributes as described in [RFC2911] section 3.1.4.1. attributes as described in [RFC2911], section 3.1.4.1.
Target: Target:
Either (1) the "printer-uri" (uri) plus "job-id" Either (1) the "printer-uri" (uri) plus "job-id"
(integer(1:MAX)) or (2) the "job-uri" (uri) operation (integer(1:MAX)) or (2) the "job-uri" (uri) operation
attribute(s) which define the target for this operation as attribute(s), which defines the target for this operation as
described in [RFC2911] section 3.1.5. described in [RFC2911], section 3.1.5.
Requesting User Name: Requesting User Name:
The "requesting-user-name" (name(MAX)) attribute SHOULD be The "requesting-user-name" (name(MAX)) attribute SHOULD be
supplied by the client as described in [RFC2911] section 8.3. supplied by the client, as described in [RFC2911], section 8.3.
Group 2: Job Attributes Group 2: Job Attributes
The client MUST supply a set of Job attributes with one or more The client MUST supply a set of Job attributes with one or more
values (including explicitly allowed out-of-band values) as values (including explicitly allowed out-of-band values) as
defined in [RFC2911] section 4.2 Job Template Attributes ("xxx" defined in [RFC2911], section 4.2, Job Template Attributes ("xxx"
attributes), section 4.3 Job Description Attributes, and any attributes), section 4.3, Job Description Attributes, and any
attribute extensions supported by the Printer. The value(s) of attribute extensions supported by the Printer. The value(s) of
each Job attribute supplied in Group 2 replaces the value(s) of each Job attribute supplied in Group 2 replaces the value(s) of
the corresponding Job attribute on the target Job object. For the corresponding Job attribute on the target Job object. For
attributes that can have multiple values (1setOf), all values attributes that can have multiple values (1setOf), all values
supplied by the client replace all values of the corresponding supplied by the client replace all values of the corresponding Job
Job object attribute. object attribute.
If the client supplies an "xxx" attribute with the 'delete- If the client supplies an "xxx" attribute with the 'delete-
attribute' out-of-band value (see section 8.2), the Printer attribute' out-of-band value (see section 8.2), the Printer MUST
MUST remove the "xxx" attribute from the Job object, if remove the "xxx" attribute from the Job object, if present.
present.
4.2.3 Set-Job-Attributes Response 4.2.3 Set-Job-Attributes Response
The IPP object returns the following sets of attributes as part of The IPP object returns the following sets of attributes as part of
the Set-Job-Attributes Response: the Set-Job-Attributes Response:
Group 1: Operation Attributes Group 1: Operation Attributes
Status Message: Status Message:
In addition to the REQUIRED status code returned in every In addition to the REQUIRED status code returned in every
response, the response OPTIONALLY includes a "status-message" response, the response OPTIONALLY includes a "status-message"
(text(255)) and/or a "detailed-status-message" (text(MAX)) (text(255)) and/or a "detailed-status-message" (text(MAX))
operation attribute as described in [RFC2911] sections 13 and operation attribute as described in [RFC2911], sections 3.1.6
3.1.6. and 13.
Natural Language and Character Set: Natural Language and Character Set:
The "attributes-charset" and "attributes-natural-language" The "attributes-charset" and "attributes-natural-language"
attributes as described in [RFC2911] section 3.1.4.2. attributes as described in [RFC2911], section 3.1.4.2.
Group 2: Unsupported Attributes Group 2: Unsupported Attributes
See [RFC2911] section 3.1.7 for details on returning
Unsupported Attributes.
If some of the attributes in the operation fail to validate, See [RFC2911], section 3.1.7, for details on returning Unsupported
the Printer MUST reject the operation, MUST NOT change any Job Attributes.
attributes, and MUST return the indicated status code below.
In this group, the Printer MUST also return all attributes that
fail to validate. The following are the reasons that an
attribute fails to validate and the value returned for the
attribute, along with the indicated status code and order of
detection:
1.The number of attributes supplied by the client exceeds the If some of the attributes in the operation fail to validate, the
maximum number that the Printer supports in a Set-Printer- Printer MUST reject the operation, MUST NOT change any Job
Attributes request: return the 'client-error-request- attributes, and MUST return the indicated status code below. In
entity-too-large' (see [RFC2911] section 13.1.4.9). this group, the Printer MUST also return all attributes that fail
to validate. The following are the reasons that an attribute
fails to validate and the value returns for the attribute, along
with the indicated status code and order of detection:
2.The Printer doesn't support the attribute: return the 1. The number of attributes supplied by the client exceeds the
attribute with the 'unsupported' out-of-band attribute value maximum number that the Printer supports in a Set-Printer-
(see [RFC2911] section 3.1.7 and [RFC2910]) and the 'client- Attributes request: return the 'client-error-request-entity-
error-attributes-or-values-not-supported (see [RFC2911] too-large' (see [RFC2911], section 13.1.4.9).
section 13.1.4.12).
3.The attribute is READ-ONLY (in its definition) or is not- 2. The Printer doesn't support the attribute: return the attribute
settable in this implementation: return the attribute with with the 'unsupported' out-of-band attribute value (see
the 'not-settable' out-of-band attribute value (see section [RFC2911], section 3.1.7 and [RFC2910]) and the 'client-error-
8.1) and the 'client-error-attributes-not-settable' status attributes-or-values-not-supported (see [RFC2911], section
code (see section 7.1). 13.1.4.12).
4.The Printer doesn't support the value: if the attribute in 3. The attribute is READ-ONLY (in its definition) or is not-
the operation has a single value return it. If the settable in this implementation: return the attribute with the
attribute in the operation is multi-valued, return only 'not-settable' out-of-band attribute value (see section 8.1)
those values in a 1setOf that are not supported. Return the and the 'client-error-attributes-not-settable' status code (see
'client-error-attributes-or-values-not-supported' status section 7.1).
code (see [RFC2911] section 13.1.4.12).
5.The values of some of the supplied attributes conflict with 4. The Printer doesn't support the value: if the attribute in the
one another and/or other Job attribute values not being set: operation has a single value return it. If the attribute in
if the conflicting attribute in the operation has a single the operation is multi-valued, return only those values in a
value return the attribute and the value. If the attribute 1setOf that are not supported. Return the 'client-error-
in the operation is multi-valued, return only the attribute attributes-or-values-not-supported' status code (see [RFC2911],
and those values in a 1setOf that are conflicting with other section 13.1.4.12).
attributes. Return the 'client-error-conflicting-
attributes' status code (see [RFC2911] section 13.1.4.15). 5. The values of some of the supplied attributes conflict with one
another and/or other Job attribute values not being set: if
the conflicting attribute in the operation has a single value,
return the attribute and the value. If the attribute in the
operation is multi-valued, return only the attribute and those
values in a 1setOf that are conflicting with other attributes.
Return the 'client-error-conflicting-attributes' status code
(see [RFC2911],y section 13.1.4.15).
4.3 Get-Printer-Supported-Values Operation 4.3 Get-Printer-Supported-Values Operation
This OPTIONAL operation allows a client to request the values that This OPTIONAL operation allows a client to request the values that
the Printer allows in the Set-Printer-Attributes operation for "xxx- the Printer allows in the Set-Printer-Attributes operation for "xxx-
supported" attributes. If the Printer supports the Set-Printer- supported" attributes. If the Printer supports the Set-Printer-
Attributes operation AND some of its "xxx-supported" Printer Attributes operation AND some of its "xxx-supported" Printer
attributes are settable, then the Printer MUST also support this attributes are settable, then the Printer MUST also support this
operation. operation.
The Printer MUST return in the Get-Printer-Supported-Values response The Printer MUST return in the Get-Printer-Supported-Values response,
those, and only those, "xxx-supported" Printer attributes that it those, and only those, "xxx-supported" Printer attributes that it
supports setting with the Set-Printer-Attributes operation. supports setting with the Set-Printer-Attributes operation.
Furthermore, if a client requests the value of an attribute that is Furthermore, if a client requests the value of an attribute that is
not settable or is not supported (as in the Get-Printer-Attributes not settable or is not supported (as in the Get-Printer-Attributes
response), the Unsupported Attributes Group of the response NEED NOT response), the Unsupported Attributes Group of the response NEED NOT
contain the "requested-attributes" operation attribute with any such contain the "requested-attributes" operation attribute with any such
requested (attribute keyword) values. requested (attribute keyword) values.
This operation has identical request/response attributes to the Get- This operation has identical request/response attributes to the Get-
Printer-Attributes operation in IPP/1.1 [RFC2911]. The operation Printer-Attributes operation in IPP/1.1 [RFC2911]. The operation
also behaves identically to the Get-Printer-Attributes operation in also behaves identically to the Get-Printer-Attributes operation in
IPP/1.1 [RFC2911] with the following exceptions: IPP/1.1 [RFC2911], with the following exceptions:
1.The Get-Printer-Supported-Values operation supports only "xxx- 1. The Get-Printer-Supported-Values operation supports only "xxx-
supported" attributes. supported" attributes.
2.The Get-Printer-Attributes operation returns the few "xxx- 2. The Get-Printer-Attributes operation returns the few "xxx-
supported" attributes that are defined to be single valued, such supported" attributes that are defined to be single valued, such
as "page-ranges-supported" (boolean) or "pdl-override-supported" as "page-ranges-supported" (boolean) or "pdl-override-supported"
(type2 keyword), as single values, while Get-Printer-Supported- (type2 keyword), as single values, while Get-Printer-Supported-
Values returns the possible values that can be set as a 1setOf of Values returns the possible values that can be set as a 1setOf of
the same attribute syntax type (See Appendix B: Attributes the same attribute syntax type (See Appendix B: Attributes
returned from Get-Printer-Supported-Values). returned from Get-Printer-Supported-Values).
3.The Get-Printer-Attributes operation returns the current values of 3. The Get-Printer-Attributes operation returns the current values of
requested attributes while the Get-Printer-Supported-Values requested attributes, while the Get-Printer-Supported-Values
operation returns the values that are inherently supported by the operation returns the values that are inherently supported by the
implementation code, i.e., the values that an administrative implementation code, i.e., the values that an administrative
client can set in a Set-Printer-Attributes request. client can set in a Set-Printer-Attributes request.
4.The Get-Printer-Attributes operation returns the current values of 4. The Get-Printer-Attributes operation returns the current values of
requested "xxx-supported" attributes that the Printer is requested "xxx-supported" attributes that the Printer is
configured to accept in Job Creation operations, including configured to accept in Job Creation operations, including
additional values defined by the administrator, while the Get- additional values defined by the administrator, while the Get-
Printer-Supported-Values operation returns only the values of Printer-Supported-Values operation returns only the values of
"xxx-supported" attributes that are inherently supported by the "xxx-supported" attributes that are inherently supported by the
implementation and does not return any additional values defined implementation and does not return any additional values defined
by the administrator where the implementation supports the 'admin- by the administrator, where the implementation supports the
define' out-of-band value. 'admin-define' out-of-band value.
5.The Get-Printer-Attributes never returns the 'admin-define' out- 5. The Get-Printer-Attributes never returns the 'admin-define' out-
of-band attribute value, while the Get-Printer-Supported- of-band attribute value, while the Get-Printer-Supported-
Attributes operation does, if the implementation allows the Attributes operation does, if the implementation allows the
administrator to define name values by setting that "xxx- administrator to define name values by setting that "xxx-
supported" attribute with any 'name' value(s). supported" attribute with any 'name' value(s).
6.The Get-Printer-Attributes operation only requires end-user access 6. The Get-Printer-Attributes operation only requires end-user access
rights, while the Get-Printer-Supported-Values requires rights, while the Get-Printer-Supported-Values requires
administrator access rights. administrator access rights.
Access Rights: The authenticated user (see [RFC2911] section 8.3) Access Rights: The authenticated user (see [RFC2911], section 8.3)
performing this operation must be an administrator of the Printer performing this operation must be an administrator of the Printer
object (see [RFC2911] Sections 1 and 8.5). object (see [RFC2911], Sections 1 and 8.5).
4.3.1 Definition of the usage of the 'admin-define' out-of-band 4.3.1 Definition of the usage of the 'admin-define' out-of-band
attribute value attribute value
If the Set-Printer-Attributes operation allows the System If the Set-Printer-Attributes operation allows the System
Administrator to define arbitrary 'name' values for an "xxx- Administrator to define arbitrary 'name' values for an "xxx-
supported" attribute, then the Get-Printer-Supported-Values operation supported" attribute, then the Get-Printer-Supported-Values operation
MUST return the 'admin-define' out-of-band attribute value (see MUST return the 'admin-define' out-of-band attribute value (see
section 8.3) as one of the values of the "xxx-supported" attribute. section 8.3) as one of the values of the "xxx-supported" attribute.
In other words, the 'admin-define' out-of-band attribute value In other words, the 'admin-define' out-of-band attribute value
indicates that the Printer implementation supports clients setting indicates that the Printer implementation supports clients setting
arbitrary 'name' attribute syntax values for that "xxx-supported" arbitrary 'name' attribute syntax values for that "xxx-supported"
attribute using the Set-Printer-Attributes operation as long as the attribute using the Set-Printer-Attributes operation, as long as the
attribute is defined with the 'name' attribute syntax. attribute is defined with the 'name' attribute syntax.
For example, if the Get-Printer-Supported-Values operation returns For example, if the Get-Printer-Supported-Values operation returns
several keywords as the value of the "media-supported" attribute, several keywords as the value of the "media-supported" attribute,
then the Set-Printer-Attributes operation MUST accept any of these then the Set-Printer-Attributes operation MUST accept any of these
keywords as values for the "media-supported" attribute. If the Get- keywords as values for the "media-supported" attribute. If the Get-
Printer-Supported-Values operation returns an 'admin-define' out-of- Printer-Supported-Values operation returns an 'admin-define' out-of-
band attribute value as one of the values of the "media-supported" band attribute value as one of the values of the "media-supported"
attribute, then the Set-Printer-Attributes operation MUST accept any attribute, then the Set-Printer-Attributes operation MUST accept any
value whose attribute syntax is 'name' as a value for the "media- value whose attribute syntax is 'name', as a value for the "media-
supported" attribute (provided that the user is properly supported" attribute (provided that the user is properly
authenticated to use the Set-Printer-Attributes operation, e.g., has authenticated to use the Set-Printer-Attributes operation, e.g., has
administrative access rights). administrative access rights).
The Get-Printer-Supported-Values MAY return the 'admin-define' out- The Get-Printer-Supported-Values MAY return the 'admin-define' out-
of-band attribute value for any IPP/1.1 or extension Job Template of-band attribute value for any IPP/1.1 or extension Job Template
attribute if the implementation supports allowing the System attribute if the implementation supports allowing the System
Administrator to add values to the "xxx-supported" attribute using Administrator to add values to the "xxx-supported" attribute using
the Set-Printer-Attributes operation. In this case, the Printer MUST the Set-Printer-Attributes operation. In this case, the Printer MUST
accept any 'name' value of the correct attribute syntax in a Set- accept any 'name' value of the correct attribute syntax in a Set-
Printer-Attributes operation that is setting that attribute. For Printer-Attributes operation that is setting that attribute. For
"xxx-supported" attributes that are defined with a choice of "xxx-supported" attributes that are defined with a choice of
attribute syntaxes, such as 'keyword | name', it is the 'name' attribute syntaxes, such as 'keyword | name', it is the 'name'
attribute syntax that the System Administrator can use to add new attribute syntax that the System Administrator can use to add new
values, not the 'keyword' attribute syntax. For IPP/1.1 this values, not the 'keyword' attribute syntax. For IPP/1.1, this
requirement includes the following Job Template attributes: requirement includes the following Job Template attributes:
media-supported media-supported
job-hold-until-supported job-hold-until-supported
job-sheets-supported job-sheets-supported
Implementations that support additional Job Template attributes that Implementations that support additional Job Template attributes that
include the 'name' attribute syntax, MAY use the 'admin-define' out- include the 'name' attribute syntax, MAY use the 'admin-define' out-
of-band value with them. of-band value with them.
If the 'admin-define' out-of-band attribute value is not one of the If the 'admin-define' out-of-band attribute value is not one of the
values of an "xxx-supported" attribute returned in a Get-Printer- values of an "xxx-supported" attribute returned in a Get-Printer-
Supported-Values response, then the Printer MUST NOT allow the Set- Supported-Values response, then the Printer MUST NOT allow the Set-
Printer-Attributes operation for that attribute to contain a value Printer-Attributes operation for that attribute to contain a value
that is not one of the explicit 'keyword' or 'name' values returned that is not one of the explicit 'keyword' or 'name' values returned
in a Get-Printer-Supported-Values response. in a Get-Printer-Supported-Values response.
See Appendix B: Attributes returned from Get-Printer-Supported-Values See Appendix B: Attributes returned from Get-Printer-Supported-Values
for a full list of values returned by this operation. for a full list of values returned by this operation.
5 New Operation attributes 5 New Operation attributes
This section defines new operation attributes for use with the This section defines new operation attributes for use with the
IPP/1.1 operations indicated. As new operations are defined they IPP/1.1 operations indicated. As new operations are defined, they
will also indicate explicitly whether these operation attributes are will also indicate explicitly whether these operation attributes are
defined for use with them. defined for use with them.
5.1 printer-message-from-operator (text(127)) 5.1 printer-message-from-operator (text(127))
The Printer SHOULD support this Operation attribute in following The Printer SHOULD support this Operation attribute in following
operations if it supports the corresponding "printer-message-from- operations if it supports the corresponding "printer-message-from-
operator" Printer Description attribute. operator" Printer Description attribute.
Pause-Printer Pause-Printer
Resume-Printer Resume-Printer
Purge-Jobs Purge-Jobs
The client OPTIONALLY supplies this attribute in the above The client OPTIONALLY supplies this Operation attribute in the above
operations. The value of this attribute is a message from the operations. The value of this attribute is a message from the
operator about the Printer object on which the operator is performing operator about the Printer object on which the operator is performing
the operation. If this operation attribute is supported, the Printer the operation. If this operation attribute is supported, the Printer
copies the value to its "printer-message-from-operator" Printer copies the value to its "printer-message-from-operator" Printer
Description attribute (see [RFC2911] section 4.4.25) even if this Description attribute (see [RFC2911], section 4.4.25), even if this
Operation attribute is a zero-length text value or consists solely of Operation attribute is a zero-length text value or consists solely of
white space. white space.
If the Printer supports this operation attribute, it MUST support If the Printer supports this operation attribute, it MUST support
both a zero-length text value and the 'no-value' out-of-band value both a zero-length text value and the 'no-value' out-of-band value
(see [RFC2911] section 4.1) to indicate that the operator has sent no (see [RFC2911] section 4.1) to indicate that the operator has sent no
message. In this case, the Printer sets the value of the "printer- message. In this case, the Printer sets the value of the "printer-
message-from-operator" to the zero-length value or 'no-value' out-of- message-from-operator" to the zero-length value or 'no-value' out-
band value, respectively. If the client queries the "printer- of-band value, respectively. If the client queries the "printer-
message-from-operator" Printer attribute, the Printer returns the message-from-operator" Printer attribute, the Printer returns the
attribute with the zero-length value or the 'no-value' value, attribute with the zero-length value or the 'no-value' value,
respectively. respectively.
In addition, the Printer automatically copies: In addition, the Printer automatically copies:
1.the value of its "printer-up-time" attribute (see [RFC2911] 1. the value of its "printer-up-time" attribute (see [RFC2911],
section 4.4.29) to its "printer-message-time" attribute, section 4.4.29) to its "printer-message-time" attribute,
2.the value of its printer-current-time" (dateTime) attribute (see 2. the value of its printer-current-time" (dateTime) attribute (see
[RFC2911] section 4.4.30) to its "printer-message-date-time" [RFC2911], section 4.4.30) to its "printer-message-date-time"
attribute, if supported. attribute, if supported.
If the client omits this operation attribute, the Printer does not If the client omits this operation attribute, the Printer does not
change the value of its "printer-message-from-operator", "printer- change the value of its "printer-message-from-operator", "printer-
message-time" and "printer-message-date-time" Printer Description message-time" and "printer-message-date-time" Printer Description
attributes. attributes.
The "printer-message-from-operator" operation attribute MUST NOT be The "printer-message-from-operator" operation attribute MUST NOT be
supported as an operation attribute for the Set-Printer-Attributes supported as an operation attribute for the Set-Printer-Attributes
operation. If the operator wants to set the Printer's "printer- operation. If the operator wants to set the Printer's "printer-
message-from-operator" Printer Description attribute when issuing the message-from-operator" Printer Description attribute when issuing the
Set-Printer-Attributes operation, the client supplies the "printer- Set-Printer-Attributes operation, the client supplies the "printer-
message-from-operator" explicitly with its new value as one of the message-from-operator" explicitly with its new value as one of the
Printer Description attributes in Group 2 in the request. The Printer Description attributes in Group 2 in the request; the Printer
Printer also updates its "printer-message-time" and "printer-message- also updates its "printer-message-time" and "printer-message-date-
date-time" Printer Description attributes. If the client does not time" Printer Description attributes. If the client does not
explicitly supply the "printer-message-from-operator" with its new explicitly supply the "printer-message-from-operator" with its new
value in the Set-Printer-Attributes request, the Printer leaves the value in the Set-Printer-Attributes request, the Printer leaves the
value of the Printer's "printer-message-from-operator" Printer value of the Printer's "printer-message-from-operator" Printer
Description attribute unchanged. Description attribute unchanged.
5.2 job-message-from-operator (text(127)) 5.2 job-message-from-operator (text(127))
The Printer SHOULD support this Operation attribute in following The Printer SHOULD support this Operation attribute in following
operations if it supports the corresponding "job-message-from- operations if it supports the corresponding "job-message-from-
operator" Job Description attribute. operator" Job Description attribute.
Cancel-Job Cancel-Job
Hold-Job Hold-Job
Release-Job Release-Job
Restart-Job Restart-Job
The client OPTIONALLY supplies this attribute in the above The client OPTIONALLY supplies this attribute in the above
operations. The value of this attribute is a message from the operations. The value of this attribute is a message from the
operator about the Job object on which the operator has just operator about the Job object on which the operator has just
performed an operation. If supported, the Printer copies the value performed an operation. If supported, the Printer copies the value
to the Job's "job-message-from-operator" Job Description attribute to the Job's "job-message-from-operator" Job Description attribute
(see [RFC2911] section 4.3.16) (even if this Operation attribute is a (see [RFC2911], section 4.3.16) (even if this Operation attribute is
zero-length text value or consists solely of white space). a zero-length text value or consists solely of white space).
If the Printer supports this operation attribute, it MUST support If the Printer supports this operation attribute, it MUST support
both a zero-length text value and the 'no-value' out-of-band value both a zero-length text value and the 'no-value' out-of-band value
(see [RFC2911] section 4.1) to indicate that the operator has sent no (see [RFC2911], section 4.1), to indicate that the operator has sent
message. In this case, the Printer sets the value of the "job- no message. In this case, the Printer sets the value of the "job-
message-from-operator" to the zero-length value or 'no-value' out-of- message-from-operator" to the zero-length value or 'no-value' out-
band value, respectively. If the client queries the "job-message- of-band value, respectively. If the client queries the "job-
from-operator" Job attribute, the IPP object returns the attribute message-from-operator" Job attribute, the IPP object returns the
with the zero-length value or the 'no-value' value, respectively. attribute with the zero-length value or the 'no-value' value,
respectively.
If the client omits this attribute, the Printer does not change the If the client omits this attribute, the Printer does not change the
value of its "job-message-from-operator" Job Description attribute. value of its "job-message-from-operator" Job Description attribute.
Note: There are no corresponding 'job-message-time" and "job- Note: There are no corresponding 'job-message-time" and "job-
message-date-time" Job Description attributes, since the usual message-date-time" Job Description attributes, since the usual
lifetime of a job is limited. lifetime of a job is limited.
The "job-message-from-operator" operation attribute MUST NOT be The "job-message-from-operator" operation attribute MUST NOT be
supported as an operation attribute for the Set-Job-Attributes supported as an operation attribute for the Set-Job-Attributes
operation. If the operator wants to set the Job's "job-message-from- operation. If the operator wants to set the Job's "job-message-
operator" Job Description attribute when issuing the Set-Job- from-operator" Job Description attribute when issuing the Set-Job-
Attributes operation, the client MUST supply the "job-message-from- Attributes operation, the client MUST supply the "job-message-from-
operator" with its new value as one of the Job Description attributes operator" with its new value as one of the Job Description attributes
in Group 2 in the request. Otherwise, the Printer leaves the value in Group 2 in the request. Otherwise, the Printer leaves the value
of the Job's "job-message-from-operator" Job Description attribute of the Job's "job-message-from-operator" Job Description attribute
unchanged by not explicitly setting the attribute. If the client unchanged by not explicitly setting the attribute. If the client
does not explicitly supply the "job-message-from-operator" with its does not explicitly supply the "job-message-from-operator" with its
new value in the Set-Job-Attributes request, the Printer leaves the new value in the Set-Job-Attributes request, the Printer leaves the
value of the Job's "job-message-from-operator" Job Description value of the Job's "job-message-from-operator" Job Description
attribute unchanged. attribute unchanged.
6 New Printer Description Attributes 6 New Printer Description Attributes
The following new Printer Description attributes are needed to The following new Printer Description attributes are needed to
support the new operations defined in this document. support the new operations defined in this document.
6.1 printer-settable-attributes-supported (1setOf type2 keyword) 6.1 printer-settable-attributes-supported (1setOf type2 keyword)
This REQUIRED READ-ONLY Printer attribute identifies the Printer This REQUIRED READ-ONLY Printer Description attribute identifies the
object attributes that are settable in this implementation, i.e., Printer object attributes that are settable in this implementation,
that are settable using the Set-Printer-Attributes operations (see i.e., that are settable using the Set-Printer-Attributes operations
section 4.1). This attribute MUST be supported if the Set-Printer- (see section 4.1). This attribute MUST be supported if the Set-
Attributes operations is supported. The Printer MUST reject attempts Printer-Attributes operations is supported. The Printer MUST reject
to set any Printer attributes that are not one of the values of this attempts to set any Printer attributes that are not one of the values
attribute, returning the 'client-error-attributes-not-settable' of this attribute, returning the 'client-error-attributes-not-
status code (see section 7.1). The value of this attribute MAY settable' status code (see section 7.1). The value of this attribute
depend on the value of the "document-format" operation attribute MAY depend on the value of the "document-format" operation attribute
supplied in the Get-Printer-Attributes operation (see [RFC2911] supplied in the Get-Printer-Attributes operation (see [RFC2911],
section 3.2.5.1). section 3.2.5.1).
Standard keyword values are: Standard keyword values are:
'none': There are no settable Printer attributes. 'none': There are no settable Printer attributes.
'xxx': Where 'xxx' is any of the keyword attribute names allowed 'xxx': Where 'xxx' is any of the keyword attribute names allowed
by section 4.1.1 by section 4.1.1.
6.2 job-settable-attributes-supported (1setOf type2 keyword) 6.2 job-settable-attributes-supported (1setOf type2 keyword)
This REQUIRED READ-ONLY Printer attribute identifies the Job object This REQUIRED READ-ONLY Printer Description attribute identifies the
attributes that are settable in this implementation, i.e., that are Job object attributes that are settable in this implementation, i.e.,
settable using the Set-Job-Attributes operation (see section 4.2). that are settable using the Set-Job-Attributes operation (see section
This attribute MUST be supported if the Set-Job-Attributes operations 4.2). This attribute MUST be supported if the Set-Job-Attributes
is supported. The Printer MUST reject attempts to set any Job operations are supported. The Printer MUST reject attempts to set
attributes that are not one of the values of this attribute, any Job attributes that are not one of the values of this attribute,
returning the 'client-error-attributes-not-settable' status code (see returning the 'client-error-attributes-not-settable' status code (see
section 7.1). section 7.1).
Standard keyword values are: Standard keyword values are:
'none': There are no settable Job attributes. 'none': There are no settable Job attributes.
'xxx': Where 'xxx' is any of the keyword attribute names allowed 'xxx': Where 'xxx' is any of the keyword attribute names allowed
by section 4.2.1. by section 4.2.1.
6.3 document-format-varying-attributes (1setOf type2 keyword) 6.3 document-format-varying-attributes (1setOf type2 keyword)
This OPTIONAL READ-ONLY Printer Description attribute contains a set This OPTIONAL READ-ONLY Printer Description attribute contains a set
of attribute name keywords. This attribute SHOULD be supported by a of attribute name keywords. This attribute SHOULD be supported by a
Printer object, if the Printer object has Printer attributes whose Printer object if the Printer object has Printer attributes whose
value vary depending on document format (see [RFC2911] Get-Printer- value vary depending on document format (see [RFC2911], Get-Printer-
Attributes operation). This attribute specifies which attribute Attributes operation). This attribute specifies which attribute
values can vary by document-format. If an attribute's name "xxx" is values can vary by document-format. If an attribute's name, "xxx",
a member of this attribute and the value of attribute "xxx" is is a member of this attribute and the value of attribute "xxx" is
changed with the Set-Printer-Attributes operation that included the changed with the Set-Printer-Attributes operation that included the
"document-format" operation attribute, then the Printer MUST change "document-format" operation attribute, then the Printer MUST change
the value for the specified document format and no other document the value for the specified document format and no other document
formats (see section 4.1.2). If an attribute's name "xxx" is not a formats (see section 4.1.2). If an attribute's name, "xxx", is not a
member of this attribute and the value of attribute "xxx" is changed member of this attribute and the value of attribute "xxx" is changed
with the Set-Printer-Attributes operation, then the attribute is with the Set-Printer-Attributes operation, then the attribute is
changed for all document formats (whether or not the client supplied changed for all document formats (whether or not the client supplied
the "document-format" operation attribute). the "document-format" operation attribute).
6.4 printer-message-time (integer(MIN:MAX)) 6.4 printer-message-time (integer(MIN:MAX))
This OPTIONAL READ-ONLY Printer Description attribute contains the This OPTIONAL READ-ONLY Printer Description attribute contains the
time that the Printer's "printer-message-from-operator" was changed time that the Printer's "printer-message-from-operator" was changed
by the operator using any operation where the client supplied the by the operator using any operation where the client supplied the
"printer-message-from-operator" operation attribute (see section 5.1) "printer-message-from-operator" operation attribute (see section 5.1)
or was explicitly set using the Set-Printer-Attributes operation (see or was explicitly set using the Set-Printer-Attributes operation (see
section 4.1). This attribute allows the users to know when the section 4.1). This attribute allows the users to know when the
"printer-message-from-operator" attribute was last set. "printer-message-from-operator" Printer Description attribute was
last set.
The Printer sets the value of this attribute by copying the value of The Printer sets the value of this attribute by copying the value of
the Printer's "printer-up-time" attribute (see [RFC2911] section the Printer's "printer-up-time" attribute (see [RFC2911], section
4.3.14). If the Printer resets its "printer-up-time" attribute to 1 4.3.14). If the Printer resets its "printer-up-time" attribute to 1
on power-up, then it MUST change the value of the "printer-message- on power-up, then it MUST change the value of the "printer-message-
time" to 0 or a negative number as specified in [RFC2911] section time" to 0 or a negative number as specified in [RFC2911], section
4.3.14. 4.3.14.
Note: This attribute helps users better understand the context for Note: This attribute helps users better understand the context for
the "printer-message-from-operator" message. the "printer-message-from-operator" message.
6.5 printer-message-date-time (dateTime) 6.5 printer-message-date-time (dateTime)
This OPTIONAL READ-ONLY Printer Description attribute contains the This OPTIONAL READ-ONLY Printer Description attribute contains the
date and time that the Printer's "printer-message-from-operator" was date and time that the Printer's "printer-message-from-operator" was
changed by the operator using any operation where the client supplied changed by the operator, using any operation where the client
the "printer-message-from-operator" operation attribute (see section supplied the "printer-message-from-operator" operation attribute (see
5.1) or was explicitly set using the Set-Printer-Attributes operation section 5.1) or was explicitly set using the Set-Printer-Attributes
(see section 4.1). This attribute allows the users to know when the operation (see section 4.1). This attribute allows the users to know
"printer-message-from-operator" attribute was last set. when the "printer-message-from-operator" Printer Description
attribute was last set.
This attribute MUST be supported if the Printer supports both the This attribute MUST be supported if the Printer supports both the
"printer-message-time" and the "printer-current-time" (dateTime) "printer-message-time" and the "printer-current-time" (dateTime)
attributes (see [RFC2911] section 4.4.30). attributes (see [RFC2911], section 4.4.30).
Note: This attribute helps users better understand the context for Note: This attribute helps users better understand the context for
the "printer-message-from-operator" message. the "printer-message-from-operator" message.
6.6 printer-xri-supported (1setOf collection) 6.6 printer-xri-supported (1setOf collection)
This OPTIONAL Printer Description attribute is a multi-valued This OPTIONAL Printer Description attribute is a multi-valued
attribute where each value has the 'collection' attribute syntax (see attribute where each value has the 'collection' attribute syntax (see
[ipp-coll]) containing member attributes with the same semantics as [RFC3382]), containing member attributes with the same semantics as
the following IPP/1.1 READ-ONLY Printer Description attributes, the following IPP/1.1 READ-ONLY Printer Description attributes,
except for cardinality: except for cardinality:
printer-uri-supported (1setOf uri) - see [RFC2911] section printer-uri-supported (1setOf uri)
4.4.1 - see [RFC2911], section 4.4.1
uri-authentication-supported (1setOf type2 keyword) - see uri-authentication-supported (1setOf type2 keyword)
[RFC2911] section 4.4.2 - see [RFC2911], section 4.4.2.
uri-security-supported (1setOf type2 keyword) - see [RFC2911] uri-security-supported (1setOf type2 keyword)
section 4.4.3 - see [RFC2911], section 4.4.3.
When setting the "printer-xri-supported" attribute with a Set- When setting the "printer-xri-supported" attribute with a Set-
Printer-Attributes request, the Printer MUST also set these three Printer-Attributes request, the Printer MUST also set these three
IPP/1.1 READ-ONLY Printer Description attributes as a defined side IPP/1.1 READ-ONLY Printer Description attributes as a defined side
effect. Thus, this collection attribute provides the means to set effect. Thus, this collection attribute provides the means to set
these three IPP/1.1 READ-ONLY attributes atomically so that they are these three IPP/1.1 READ-ONLY attributes atomically so that they are
never left in a partially inconsistent state. never left in a partially inconsistent state.
An IPP Printer MUST NOT provide any other way using IPP to set these An IPP Printer MUST NOT provide any other way, using IPP, to set
three IPP/1.1 READ-ONLY Printer Description attributes, since they these three IPP/1.1 READ-ONLY Printer Description attributes, since
are READ-ONLY and MUST have consistent values at all times. Note: they are READ-ONLY and MUST have consistent values at all times.
The "xri-printer-supported" (1setOf collection) attribute can be put Note: The "printer-xri-supported" (1setOf collection) attribute can
into a directory schema that requires a single text string value, be put into a directory schema that requires a single text string
such as SLP or LDPA, by using suitable delimiting characters to value, such as could be used with SLPv2 [RFC2608], [RFC2609] or
separate member attributes of the collection and/or terminating LDAPv3 [RFC2251], [RFC2252], [RFC2926], by using suitable delimiting
collection values. See [svrloc-printer] and [ldap-printer]. characters to separate member attributes of the collection and/or
terminating collection values.
The member attributes of the "printer-xri-supported" (1setOf The member attributes of the "printer-xri-supported" (1setOf
collection) are given in Table 3. collection) are given in Table 3.
Table 3 - Member attributes of "printer-xri-supported" (1setOf Table 3 - Member attributes of "printer-xri-supported" (1setOf
collection) collection)
Member attribute client Member attribute client Printer
MUST MUST MUST MUST
supply support supply support
xri-uri (uri) yes yes xri-uri (uri) yes yes
xri-authentication (1setOf type2 keyword) yes yes xri-authentication (type2 keyword) yes yes
xri-security (1setOf type2 keyword) yes yes xri-security (type2 keyword) yes yes
Each collection value MUST contain a single unique value for the Other than the uniqueness and the cardinality requirements, the
"xri-uri" member attribute. However, the other two member attributes semantics of these three member attributes is given in [RFC2911]
are multi-valued, so that a single URI can support more than one sections 4.4.1, 4.4.2, and 4.4.3, respectively.
authentication scheme and/or more than one security scheme. Other
than the uniqueness and the cardinality requirements, the semantics
of these three member attributes is given in [RFC2911] sections
4.4.1, 4.4.2, and 4.4.3, respectively.
A client can query the current values using the Get-Printer- A client can query the current values using the Get-Printer-
Attributes operation by supplying either: Attributes operation by supplying either:
1.the three IPP/1.1 attribute names: "printer-uri-supported", "uri- 1. the three IPP/1.1 attribute names: "printer-uri-supported", "uri-
authentication-supported", "uri-security-supported" and getting authentication-supported", "uri-security-supported" and getting
back the parallel values OR back the parallel values OR
2.the single attribute name: "printer-xri-supported" and getting 2. the single attribute name: "printer-xri-supported" and getting
back the 1setOf collection which contains the same information back the 1setOf collection which contains the same information
semantically, but in a different form. semantically, but in a different form.
A client can query what member attribute values can be set by A client can query what member attribute values can be set by
supplying the three attribute names: "xri-uri-scheme-supported", supplying the three attribute names: "xri-uri-scheme-supported",
"xri-authentication-supported", and "xri-security-supported" in a "xri-authentication-supported", and "xri-security-supported" in a
Get-Printer-Supported-Values request and getting back the uriScheme Get-Printer-Supported-Values request and getting back the uriScheme
and type2 keyword values that can be set. Since the "printer-xri- and type2 keyword values that can be set. Since the "printer-xri-
supported", "uri-authentication-supported", and "uri-security- supported", "uri-authentication-supported", and "uri-security-
supported" attributes are READ-ONLY, they are not queriable with the supported" attributes are READ-ONLY, they are not queriable with the
Get-Printer-Supported-Values operation (see section 4.3). See Table Get-Printer-Supported-Values operation (see section 4.3). See Table
16. 16.
When performing a Set-Printer-Attributes operation, if there are For example:
multiple values for the "xri-authentication" and/or "xri-security"
member attributes, the Printer MUST set the corresponding three READ-
ONLY attributes with all possible combinations of values. For
example, setting the "printer-xri-supported" with the following two
collection values where the first URI has both 'basic' and 'digest'
authentication:
"printer-xri-supported = "printer-xri-supported =
{ "xri-uri" = ipp://abc.com/p1 { "xri-uri" = ipp://abc.com/p1
"xri-authentication" = basic, digest "xri-authentication" = basic
"xri-security" = tls "xri-security" = tls
}, },
{ "xri-uri" = http://abc.com/pq { "xri-uri" = ipp://abc.com/p2
"xri-authentication" = none "xri-authentication" = digest
"xri-security" = none "xri-security" = tls
} },
{ "xri-uri" = ipp://abc.com/p3
"xri-authentication" = none
"xri-security" = none
}
would cause the Printer to set the three corresponding IPP/1.1 READ- would cause the Printer to set the three corresponding IPP/1.1 READ-
ONLY attributes, each with three parallel values as follows: ONLY attributes, each with three parallel values as follows:
"printer-uri-supported" = { ipp://abc.com/p1, ipp://abc.com/p1, "printer-uri-supported" = { ipp://abc.com/p1, ipp://abc.com/p2,
http://abc.com/pq } ipp://abc.com/p3 }
"uri-authentication-supported" = { basic, digest, none } "uri-authentication-supported" = { basic, digest, none }
"uri-security-supported" = { tls, tls, none } "uri-security-supported" = { tls, tls, none }
Because there were two authentication values for the ipp://abc.com/p1
URL, that URL value is repeated. Had the ipp URL had 2
authentication values and 3 security values, then there would have
been 7 (2*3 + 1) parallel values for each of the three attributes, 6
with the same ipp URI and 1 with the http URI.
6.7 xri-uri-scheme-supported (1setOf uriScheme) 6.7 xri-uri-scheme-supported (1setOf uriScheme)
This OPTIONAL READ-ONLY Printer Description attribute identifies the This OPTIONAL READ-ONLY Printer Description attribute identifies the
URI schemes that the implementation supports for use in the "printer- URI schemes that the implementation supports for use in the
uri-supported" (1setOf uri) Printer Description attribute (see "printer-uri-supported" (1setOf uri) Printer Description attribute
[RFC2911] section 4.4.1) and the "xri-uri" member attribute of the (see [RFC2911] section 4.4.1) and the "xri-uri" member attribute of
"xri-printer-supported" (1setOf collection) Printer Description the "printer-xri-supported" (1setOf collection) Printer Description
attribute (see section 6.6). attribute (see section 6.6).
A Printer MUST support this attribute if it supports setting the A Printer MUST support this attribute if it supports the setting of
"printer-xri-supported" (1setOf collection) with the Set-Printer- the "printer-xri-supported" (1setOf collection) with the Set-
Attributes operation. Printer-Attributes operation.
6.8 xri-authentication-supported (1setOf type2 keyword) 6.8 xri-authentication-supported (1setOf type2 keyword)
This OPTIONAL READ-ONLY Printer Description attribute identifies the This OPTIONAL READ-ONLY Printer Description attribute identifies the
Client Authentication mechanisms that the implementation supports for Client Authentication mechanisms that the implementation supports for
use in the "uri-authentication-supported" (1setOf type2 keyword) use in the "uri-authentication-supported" (1setOf type2 keyword)
Printer Description attribute (see [RFC2911] section 4.4.2) and the Printer Description attribute (see [RFC2911], section 4.4.2) and the
"xri-authentication" member attribute of the "xri-printer-supported" "xri-authentication" member attribute of the "printer-xri-supported"
(1setOf collection) Printer Description attribute (see section 6.6). (1setOf collection) Printer Description attribute (see section 6.6).
A Printer MUST support this attribute if it supports setting the A Printer MUST support this attribute if it supports setting the
"printer-xri-supported" (1setOf collection) with the Set-Printer- "printer-xri-supported" (1setOf collection) with the Set-Printer-
Attributes operation. Attributes operation.
6.9 xri-security-supported (1setOf type2 keyword) 6.9 xri-security-supported (1setOf type2 keyword)
This OPTIONAL READ-ONLY Printer Description attribute identifies the This OPTIONAL READ-ONLY Printer Description attribute identifies the
URI schemes that the implementation supports for use in the "uri- URI schemes that the implementation supports for use in the "uri-
security-supported" (1setOf type2 keyword) Printer Description security-supported" (1setOf type2 keyword) Printer Description
attribute (see [RFC2911] section 4.4.3) and the "xri-security" member attribute (see [RFC2911], section 4.4.3) and the "xri-security"
attribute of the "xri-printer-supported" (1setOf collection) Printer member attribute of the "printer-xri-supported" (1setOf collection)
Description attribute (see section 6.6). Printer Description attribute (see section 6.6).
A Printer MUST support this attribute if it supports setting the A Printer MUST support this attribute if it supports setting the
"printer-xri-supported" (1setOf collection) with the Set-Printer- "printer-xri-supported" (1setOf collection) with the Set-Printer-
Attributes operation. Attributes operation.
7 Additional status codes 7 Additional status codes
This section defines new status codes used by the operations defined This section defines new status codes used by the operations defined
in this document. in this document.
7.1 client-error-attributes-not-settable (0x0413) 7.1 client-error-attributes-not-settable (0x0413)
The Set-Printer-Attributes or Set-Job-Attributes operation failed The Set-Printer-Attributes or Set-Job-Attributes operation failed
because one or more of the specified attributes cannot be set either because one or more of the specified attributes cannot be set, either
because the attribute is defined to be READ-ONLY or the attribute is because the attribute is defined to be READ-ONLY or the attribute is
not settable in this implementation (see sections 4.1.3 and 4.2.3), not settable in this implementation (see sections 4.1.3 and 4.2.3).
the Printer MUST return this error code and the attribute keyword The Printer MUST return this error code and the attribute keyword
name(s) and the 'not-settable' out-of-band value (see section 8.1) in name(s) and the 'not-settable' out-of-band value (see section 8.1) in
the Unsupported Attributes Group(see [RFC2911] section 3.1.7) for all the Unsupported Attributes Group (see [RFC2911], section 3.1.7) for
of the attributes that could not be set. When the Printer returns all of the attributes that could not be set. When the Printer
this status, it MUST NOT change any of the attributes supplied in the returns this status, it MUST NOT change any of the attributes
operation. supplied in the operation.
8 Additional out-of-band values 8 Additional out-of-band values
This section defines additional out-of-band values. As with all out- This section defines additional out-of-band values. As with all
of-band values, a client or a Printer MUST NOT use an out-of-band out-of-band values, a client or a Printer MUST NOT use an out-of-band
value unless the definition of the attribute in an operation request value unless the definition of the attribute in an operation request
and/or response explicitly allows such usage. See the beginning of and/or response explicitly allows such usage. See the beginning of
[RFC2911] section 4.1. [RFC2911], section 4.1.
8.1 'not-settable' out-of-band value 8.1 'not-settable' out-of-band value
The 'not-settable' out-of-band attribute value is returned by the IPP The 'not-settable' out-of-band attribute value is returned by the IPP
Printer in the Unsupported Attributes group of a response to indicate Printer in the Unsupported Attributes group of a response to indicate
that the attribute supplied by the client in the request is READ-ONLY that the attribute supplied by the client in the request is READ-ONLY
by definition or is not settable in this implementation. by definition or is not settable in this implementation.
The 'not-settable' out-of-band attribute value is defined for use The 'not-settable' out-of-band attribute value is defined for use
with the Set-Job-Attributes and Set-Printer-Attributes response only. with the Set-Job-Attributes and Set-Printer-Attributes responses
If a future additional "set" operation allows the 'not-settable' out- only. If a future additional "set" operation allows the 'not-
of-band value, its definition document MUST indicate such use settable' out-of-band value, its definition document MUST indicate
explicitly, including with which attributes. such use explicitly, including with which attributes.
An IPP object MUST support the 'not-settable' out-of-band value in a An IPP object MUST support the 'not-settable' out-of-band value in a
Set-Job-Attributes or Set-Printer-Attributes request if it supports Set-Job-Attributes or Set-Printer-Attributes request if it supports
those operations. A client MUST NOT supply the 'not-settable' out- those operations. A client MUST NOT supply the 'not-settable' out-
of-band value in any request. An IPP object MUST NOT support the of-band value in any request. An IPP object MUST NOT support the
'not-settable' out-of-band value in other operations, unless the 'not-settable' out-of-band value in other operations, unless the
operations' definition document explicitly defines such usage. If a operations' definition document explicitly defines such usage. If a
Printer receives this out-of-band value in any operation request, the Printer receives this out-of-band value in any operation request, the
Printer MUST either (1) reject the entire request and return the Printer MUST either (1) reject the entire request and return the
'client-error-bad-request' status code or (2) ignore the attribute 'client-error-bad-request' status code or (2) ignore the attribute
skipping to change at page 33, line 15 skipping to change at page 31, line 13
present. present.
The 'delete-attribute' out-of-band attribute value is defined for use The 'delete-attribute' out-of-band attribute value is defined for use
with the Set-Job-Attributes request only. If a future additional with the Set-Job-Attributes request only. If a future additional
"set" operation allows the 'delete-attribute' out-of-band value, its "set" operation allows the 'delete-attribute' out-of-band value, its
definition document MUST indicate such use explicitly, including with definition document MUST indicate such use explicitly, including with
which attributes. which attributes.
An IPP Printer MUST support the 'delete-attribute' out-of-band value An IPP Printer MUST support the 'delete-attribute' out-of-band value
if it supports the Set-Job-Attributes operation. A client MUST NOT if it supports the Set-Job-Attributes operation. A client MUST NOT
supply and an IPP object MUST NOT support the 'delete-attribute' out- supply, and an IPP object MUST NOT support, the 'delete-attribute'
of-band value in other operations, unless the operations' definition out-of-band value in other operations, unless the operations'
document explicitly defines such usage. For example, the 'delete- definition document explicitly defines such usage. For example, the
attribute' out-of-band value MUST NOT be used in the Set-Printer- 'delete-attribute' out-of-band value MUST NOT be used in the Set-
Attributes operation, where the absence of an attribute from an IPP Printer-Attributes operation, where the absence of an attribute from
object indicates that the attribute is not supported. If a Printer an IPP object indicates that the attribute is not supported. If a
receives this out-of-band value in other operation requests, the Printer receives this out-of-band value in other operation requests,
Printer MUST either (1) reject the entire request and return the the Printer MUST either (1) reject the entire request and return the
'client-error-bad-request' status code or (2) ignore the attribute 'client-error-bad-request' status code or (2) ignore the attribute
and return it with the 'unsupported' out-of-band value. and return it with the 'unsupported' out-of-band value.
See section 4.2 in this document for the definition of the usage of See section 4.2 in this document for the definition of the usage of
the 'delete-attribute' out-of-band value in the Set-Job-Attributes the 'delete-attribute' out-of-band value in the Set-Job-Attributes
request. request.
8.2.1 Encoding of the 'delete-attribute' out-of-band value 8.2.1 Encoding of the 'delete-attribute' out-of-band value
The encoding of the 'delete-attribute' out-of-band value is 0x16 (see The encoding of the 'delete-attribute' out-of-band value is 0x16 (see
[RFC2910]). The value-length MUST be 0 and the value empty. [RFC2910]). The value-length MUST be 0 and the value empty.
8.3 'admin-define' out-of-band attribute value 8.3 'admin-define' out-of-band attribute value
Section 4.3 defines the Get-Printer-Supported-Values response to Section 4.3 defines the Get-Printer-Supported-Values response to
contain the values of an "xxx-supported" attribute that are supported contain the values of an "xxx-supported" attribute that are supported
by the implementation before any additional value are defined by the by the implementation before any additional values are defined by the
administrator. The 'admin-define' out-of-band attribute value is administrator. The 'admin-define' out-of-band attribute value is
returned as an additional value of an "xxx-supported" attribute in a returned as an additional value of an "xxx-supported" attribute in a
Get-Printer-Supported-Values response to indicate that the Get-Printer-Supported-Values response to indicate that the
implementation supports allowing an administrator to define implementation supports allowing an administrator to define
additional arbitrary 'name' values for that "xxx-supported" additional arbitrary 'name' values for that "xxx-supported"
attribute. attribute.
For example, if the "media-supported" (1setOf (type3 keyword | name)) For example, if the "media-supported" (1setOf (type3 keyword | name))
attribute contains this value, then the Printer MUST permit an attribute contains this value, then the Printer MUST permit an
administrator to add new media names to the Printer's "media- administrator to add new media names to the Printer's "media-
supported" attribute. In order for an administrator to add new supported" attribute. In order for an administrator to add new
values to a Printer's "xxx-supported" attribute, the client supplies values to a Printer's "xxx-supported" attribute, the client supplies
the existing and new values in a Set-Printer-Attributes request for the existing and new values in a Set-Printer-Attributes request for
that attribute. The client MUST supply any such administratively that attribute. The client MUST supply any such administratively
defined values in the Set-Printer-Attributes request using the 'name' defined values in the Set-Printer-Attributes request, using the
attribute syntax. 'name' attribute syntax.
The 'admin-define' out-of-band attribute value is defined for use The 'admin-define' out-of-band attribute value is defined for use
with the Get-Printer-Supported-Values response only. A Printer MUST with the Get-Printer-Supported-Values response only. A Printer MUST
NOT return the 'admin-define' out-of-band value in a Get-Printer- NOT return the 'admin-define' out-of-band value in a Get-Printer-
Attributes response, since such a response indicates what an end-user Attributes response, since such a response indicates what an end-user
client can supply in a Job Creation operation. If a future client can supply in a Job Creation operation. If a future
additional "get" operation allows the 'admin-define' out-of-band additional "get" operation allows the 'admin-define' out-of-band
value, its definition document MUST indicate such use explicitly, value, its definition document MUST indicate such use explicitly,
including with which attributes. including with which attributes.
skipping to change at page 35, line 21 skipping to change at page 33, line 15
9 New Values for Existing Printer Description Attributes 9 New Values for Existing Printer Description Attributes
This section contains those attributes for which additional values This section contains those attributes for which additional values
are added. are added.
9.1 operations-supported (1setOf type2 enum) 9.1 operations-supported (1setOf type2 enum)
The following "operation-id" values are added in order to support the The following "operation-id" values are added in order to support the
new operations defined in this document: new operations defined in this document:
Table 4 - Operation-id assignments Table 4 - Operation-id assignments
Value Operation Name Value Operation Name
0x0013 Set-Printer-Attributes 0x0013 Set-Printer-Attributes
0x0014 Set-Job-Attributes 0x0014 Set-Job-Attributes
0x0015 Get-Printer-Supported-Values 0x0015 Get-Printer-Supported-Values
10 Conformance Requirements 10 Conformance Requirements
This section specifies the conformance requirements for clients and This section specifies the conformance requirements for clients and
IPP objects. IPP objects.
Both the Set-Job-Attributes and the Set-Printer-Attributes operations Both the Set-Job-Attributes and the Set-Printer-Attributes operations
defined in the document are OPTIONAL for an IPP object to support. defined in the document are OPTIONAL for an IPP object to support.
Either one MAY be supported without the other or both MAY be Either one MAY be supported without the other or both MAY be
supported. However, if the Set-Printer-Attributes operation is supported. However, if the Set-Printer-Attributes operation is
supported, then the Get-Printer-Supported-Values operation MUST be supported, then the Get-Printer-Supported-Values operation MUST be
supported if any "xxx-supported" attributes are settable. Otherwise, supported if any "xxx-supported" attributes are settable. Otherwise,
the Get-Printer-Supported-Values operation is OPTIONAL for an IPP the Get-Printer-Supported-Values operation is OPTIONAL for an IPP
Printer to support. Printer to support.
If the Set-Printer-Attributes operation is supported, then the If the Set-Printer-Attributes operation is supported, then the
Printer MUST support the following additional items: Printer MUST support the following additional items:
1. the Get-Printer-Supported-Values operation (see section 5), if 1. the Get-Printer-Supported-Values operation (see section 5), if
any "xxx-supported" attributes are settable. any "xxx-supported" attributes are settable.
2. the "printer-settable-attributes-supported" Printer Description 2. the "printer-settable-attributes-supported" Printer Description
attribute (see section 6.1) attribute (see section 6.1).
3. the 'not-settable' out-of-band value in responses (see section 3. the 'not-settable' out-of-band value in responses (see section
8.1) 8.1).
4. the 'client-error-not-settable' status code (see section 7.1) 4. the 'client-error-not-settable' status code (see section 7.1).
5. If "printer-message-from-operator" Printer Description attribute 5. if the "printer-message-from-operator" Printer Description
is supported (see [RFC2911] section 4.4.25), then it MUST be attribute is supported (see [RFC2911], section 4.4.25), then it
settable. MUST be settable.
6. the Get-Printer-Supported-Values operation (see section 4.3), if 6. the Get-Printer-Supported-Values operation (see section 4.3),
any "xxx-supported" attributes are settable. if any "xxx-supported" attributes are settable.
7. If a client can set a value with the 'name' attribute syntax for 7. If a client can set a value with the 'name' attribute syntax
one or more "xxx-supported" attributes, then the 'admin-define' for one or more "xxx-supported" attributes, then the 'admin-
out-of-band attribute value (see section 8.3) MUST be supported define' out-of-band attribute value (see section 8.3) MUST be
in the Get-Printer-Supported-Values response for each such supported in the Get-Printer-Supported-Values response for each
settable attribute (see section 4.3) such settable attribute (see section 4.3)
If the Set-Job-Attributes operation is supported, then the Printer If the Set-Job-Attributes operation is supported, then the Printer
MUST support the following additional items: MUST support the following additional items:
1. the "job-settable-attributes-supported" Printer Description 1. the "job-settable-attributes-supported" Printer Description
attribute (see section 6.2) attribute (see section 6.2).
2. the 'not-settable' out-of-band value in responses (see section 2. the 'not-settable' out-of-band value in responses (see section
8.1) 8.1).
3. the 'delete-attribute' out-of-band value in requests (see 3. the 'delete-attribute' out-of-band value in requests (see
section 8.2) section 8.2).
4. the 'client-error-not-settable' status code (see section 7.1) 4. the 'client-error-not-settable' status code (see section 7.1).
5. If the "job-message-from-operator" Printer Description attribute 5. if the "job-message-from-operator" Printer Description
is supported (see [RFC2911] 4.3.16), then it MUST be settable. attribute is supported (see [RFC2911], 4.3.16), then it MUST be
settable.
It is OPTIONAL for the Printer object to support the "printer- It is OPTIONAL for the Printer object to support the "printer-
message-time" (integer) and "printer-message-date-time" (dateTime) message-time" (integer) and "printer-message-date-time" (dateTime)
Printer Description attributes. If both the "printer-message-time" Printer Description attributes. If both the "printer-message-time"
(integer) and the "printer-current-time" (dateTime) (see [RFC2911] (integer) and the "printer-current-time" (dateTime) (see [RFC2911],
section 4.4.30) attributes are supported, then the "printer-message- section 4.4.30) attributes are supported, then the "printer-message-
date-time" (dateTime) Printer Description attribute MUST be date-time" (dateTime) Printer Description attribute MUST be
supported. supported.
As with all out-of-band values, a client or a Printer MUST NOT use an As with all out-of-band values, a client or a Printer MUST NOT use an
out-of-band value unless the definition document for the attribute in out-of-band value, unless the definition document for the attribute
an operation request and/or response explicitly allows such usage. in an operation request and/or response explicitly allows such usage.
11 IANA Considerations 11 IANA Considerations
This section contains registration information for IANA to add to the This section contains registration information for IANA to add to the
various IPP Registries according to the procedures defined in RFC various IPP Registries according to the procedures defined in RFC
2911 [RFC2911] section 6. 2911 [RFC2911], section 6. The resulting registrations will be
published in the http://www.iana.org/assignments/ipp-registrations
Note to RFC Editors: Replace RFC NNNN below with the RFC number for registry.
this document, so that it accurately reflects the content of the
information for the IANA Registry.
11.1 Operation Registrations 11.1 Operation Registrations
The following table lists all of the operations defined in this The following table lists all of the operations defined in this
document. These are to be registered according to the procedures document. These are to be registered according to the procedures
defined in RFC 2911 [RFC2911] section 6.4. defined in RFC 2911 [RFC2911], section 6.4.
Operations: Ref. Section: Operations: Ref. Section:
Set-Printer-Attributes RFC NNNN 4.1 Set-Printer-Attributes RFC 3380 4.1
Set-Job-Attributes RFC NNNN 4.2 Set-Job-Attributes RFC 3380 4.2
Get-Printer-Supported-Values RFC NNNN 4.3 Get-Printer-Supported-Values RFC 3380 4.3
The resulting operation registrations will be published in the
ftp://ftp.iana.org/in-notes/iana/assignments/ipp/operations/
area.
11.2 Additional Enum Attribute Value Registrations for the "operations- 11.2 Additional Enum Attribute Value Registrations for the
supported" Printer Attribute "operations-supported" Printer Attribute
The following table lists all the new enum attribute values defined The following table lists all the new enum attribute values defined
in this document as additional type2 enum values for use with the in this document as additional type2 enum values for use with the
"operations-supported" Printer Description attribute. These are to be "operations-supported" Printer Description attribute. These are to
registered according to the procedures defined in RFC 2911 [RFC 2911] be registered according to the procedures defined in RFC 2911 [RFC
section 6.1. 2911], section 6.1.
Enum Attribute Values: Value Ref. Section: Enum Attribute Values: Value Ref. Section:
Set-Printer-Attributes 0x0013 RFC NNNN 4 Set-Printer-Attributes 0x0013 RFC 3380 4
Set-Job-Attributes 0x0014 RFC NNNN 4 Set-Job-Attributes 0x0014 RFC 3380 4
Get-Printer-Supported-Values 0x0015 RFC NNNN 4 Get-Printer-Supported-Values 0x0015 RFC 3380 4
The resulting enum attribute value registrations will be published in 11.3 Keyword attribute value registrations
the
ftp://ftp.iana.org/in-notes/iana/assignments/ipp/attribute-
values/operations-supported/
area.
11.3 Attribute Registrations The following table lists all of the attributes defined in this
standard which have keywords values defined:
printer-settable-attributes-supported (1setOf type2 keyword)
RFC 3380 6.1
none RFC 3380 6.1
<Any other Printer attribute keyword name>
job-settable-attributes-supported (1setOf type2 keyword)
RFC 3380 6.2
none RFC 3380 6.2
<Any other Job attribute keyword name>
document-format-varying-attributes (1setOf type2 keyword)
RFC 3380 6.3
none
<Any Printer attribute keyword name>
xri-security-supported (1setOf type2 keyword) RFC 3380 6.9
none RFC 2911 4.4.3
ssl3 RFC 2911 4.4.3
tls' RFC 2911 4.4.3
xri-authentication-supported (1setOf type2 keyword)
none RFC 2911 4.4.2
requesting-user-name RFC 2911 4.4.2
basic RFC 2911 4.4.2
digest RFC 2911 4.4.2
certificate RFC 2911 4.4.2
11.4 Attribute Registrations
The following table lists all of the attributes defined in this The following table lists all of the attributes defined in this
document. These are to be registered according to the procedures in document. These are to be registered according to the procedures in
RFC 2911 [RFC2911] section 6.2. RFC 2911 [RFC2911], section 6.2.
Operation attributes: Ref. Section: Operation attributes: Ref. Section:
printer-message-from-operator (text(127)) RFC NNNN 5.1 printer-message-from-operator (text(127)) RFC 3380 5.1
job-message-from-operator (text(127)) RFC NNNN 5.2 job-message-from-operator (text(127)) RFC 3380 5.2
Printer Description attributes: Ref. Section: Printer Description attributes: Ref. Section:
printer-settable-attributes-supported (1setOf type2 keyword) printer-settable-attributes-supported (1setOf type2 keyword)
RFC NNNN 6.1 RFC 3380 6.1
job-settable-attributes-supported (1setOf type2 keyword) job-settable-attributes-supported (1setOf type2 keyword)
RFC NNNN 6.2 RFC 3380 6.2
document-format-varying-attributes (1setOf type2 keyword) document-format-varying-attributes (1setOf type2 keyword)
RFC NNNN 6.3 RFC 3380 6.3
printer-message-time (integer(MIN:MAX)) RFC NNNN 6.4 printer-message-time (integer(MIN:MAX)) RFC 3380 6.4
printer-message-date-time (dateTime) RFC NNNN 6.5 printer-message-date-time (dateTime) RFC 3380 6.5
printer-xri-supported (1setOf collection) RFC NNNN 6.6 printer-xri-supported (1setOf collection) RFC 3380 6.6
xri-uri-scheme-supported (1setOf uriScheme) RFC NNNN 6.7 xri-uri (uri) RFC 3380 6.6
xri-authentication (type2 keyword) RFC 3380 6.6
xri-security (type2 keyword) RFC 3380 6.6
xri-uri-scheme-supported (1setOf uriScheme) RFC 3380 6.7
xri-authentication-supported (1setOf type2 keyword) 6.8 xri-authentication-supported (1setOf type2 keyword) 6.8
xri-security-supported (1setOf type2 keyword) RFC NNNN 6.9 xri-security-supported (1setOf type2 keyword) RFC 3380 6.9
The resulting attribute registrations will be published in the
ftp://ftp.iana.org/in-notes/iana/assignments/ipp/attributes/
area.
11.4 Status code Registrations 11.5 Status code Registrations
The following table lists the status code defined in this document. The following table lists the status code defined in this document.
This is to be registered according to the procedures in RFC 2911 This is to be registered according to the procedures in RFC 2911
[RFC2911] section 6.6. [RFC2911], section 6.6.
Status codes: Ref. Section: Status codes: Ref. Section:
client-error-attributes-not-settable (0x0413) RFC NNNN 7.1 client-error-attributes-not-settable (0x0413) RFC 3380 7.1
The resulting status code registration will be published in the
ftp://ftp.iana.org/in-notes/iana/assignments/ipp/status-codes/
area.
11.5 Out-of-band Attribute Value Registrations 11.6 Out-of-band Attribute Value Registrations
The following table lists all of the out-of-band attribute values The following table lists all of the out-of-band attribute values
defined in this document. These are to be registered according to defined in this document. These are to be registered according to
the procedures in RFC 2911 [RFC2911] section 6.7. the procedures in RFC 2911 [RFC2911] section 6.7.
Out-of-band Attribute Values: Ref. Section: Value: Out-of-band Attribute value name: Ref. Section:
'not-settable' out-of-band value RFC NNNN 8.1 0x15 not-settable RFC 3380 8.1
'delete-attribute' out-of-band value RFC NNNN 8.2 0x16 delete-attribute RFC 3380 8.2
'admin-define' out-of-band attribute value RFC NNNN 8.3 0x17 admin-define RFC 3380 8.3
The resulting out-of-band attribute value registrations will be
published in the
ftp.iana.org/in-notes/iana/assignments/ipp/out-of-band-attribute-
value-tags/
area.
12 Internationalization Considerations 12 Internationalization Considerations
This document has the same localization considerations as the This document has the same localization considerations as [RFC2911].
[RFC2911].
13 Security Considerations 13 Security Considerations
The IPP Model and Semantics document [RFC2911 section 8] discusses The IPP Model and Semantics document ([RFC2911], section 8) discusses
high level security requirements (Client Authentication, Server high level security requirements (Client Authentication, Server
Authentication and Operation Privacy). Client Authentication is the Authentication and Operation Privacy). Client Authentication is the
mechanism by which the client proves its identity to the server in a mechanism by which the client proves its identity to the server in a
secure manner. Server Authentication is the mechanism by which the secure manner. Server Authentication is the mechanism by which the
server proves its identity to the client in a secure manner. server proves its identity to the client in a secure manner.
Operation Privacy is defined as a mechanism for protecting operations Operation Privacy is defined as a mechanism for protecting operations
from eavesdropping. from eavesdropping.
In addition, the introduction of the Set-Printer-Attributes and Set- In addition, the introduction of the Set-Printer-Attributes and Set-
Job-Attributes operations creates another security threat, since the Job-Attributes operations creates another security threat, since the
client is able to modify the Printer and Job attributes stored in the client is able to modify the Printer and Job attributes stored in the
Printer. Such modifications could lead to denial of service. Printer. Such modifications could lead to denial of service.
A malicious user could alter the policy established by the system A malicious user could alter the policy established by the system
administrator and stored in the Printer attributes. Such alteration administrator and stored in the Printer attributes. Such alteration
could either grant access to more resources or deny access to could either grant access to more resources or deny access to
resources that the system administrator has established. For resources that the system administrator has established. For
example, the malicious user could remove all of the document-format example, the malicious user could remove all of the document-format
values from the "document-format-supported" Printer attribute so that values from the "document-format-supported" Printer attribute so that
the Printer would refuse to accept all jobs. the Printer would refuse to accept all jobs.
The general remedy for such malicious user actions against Printer The general remedy for such malicious user actions against Printer
attributes is to have strong Client Authentication coupled with attributes is to have strong Client Authentication coupled with
Printer access control to limit the users who have System Printer access control, to limit the users who have System
Administrator or Operator privileges. Administrator or Operator privileges.
A malicious user could modify the Job Template attributes of another A malicious user could modify the Job Template attributes of another
user's Job, such as the "copies" attribute. For example, setting the user's Job, such as the "copies" attribute. For example, setting the
number of copies to a large number. number of copies to a large number.
The general remedy for such malicious user actions against another The general remedy for such malicious user actions against another
user's job is to have strong Client Authentication coupled with user's job is to have strong Client Authentication coupled with
Printer access control to limit the users who have System Printer access control to limit the users who have System
Administrator or Operator privileges who can modify any job and, in Administrator or Operator privileges who can modify any job and, in
addition, store the Client Authentication with each Job so that only addition, store the Client Authentication with each Job so that only
the job owner End User can modify his/her own job. the job owner End User can modify his/her own job.
14 Author's Addresses 14 References
Carl Kugler
IBM
P.O. Box 1900
Boulder, CO 80301-9191
Phone: (303) 924-5060
FAX:
e-mail: kugler@us.ibm.com
Tom Hastings
Xerox Corporation
737 Hawaii St. ESAE 231
El Segundo, CA 90245
Phone: 310-333-6413
Fax: 310-333-5514
e-mail: hastings@cp10.es.xerox.com
Robert Herriot
Xerox Corp.
3400 Hill View Ave, Building 1
Palo Alto, CA 94304
Phone: 650-813-7696
Fax: 650-813-6860
e-mail: robert.herriot@pahv.xerox.com
Harry Lewis
IBM
P.O. Box 1900
Boulder, CO 80301-9191
Phone: (303) 924-5337
FAX:
e-mail: harryl@us.ibm.com
IPP Web Page: http://www.pwg.org/ipp/ 14.1 Normative References
IPP Mailing List: ipp@pwg.org
To subscribe to the ipp mailing list, send the following email: [RFC2565] Herriot, R., Butler, S., Moore, P. and R. Tuner, "Internet
1) send it to majordomo@pwg.org Printing Protocol/1.0: Encoding and Transport", RFC 2565,
2) leave the subject line blank April 1999.
3) put the following two lines in the message body:
subscribe ipp
end
Implementers of this specification document are encouraged to join [RFC2566] deBry, R., Hastings, T., Herriot, R., Isaacson, S. and P.
the IPP Mailing List in order to participate in any discussions of Powell, "Internet Printing Protocol/1.0: Model and
clarification issues and review of registration proposals for Semantics", RFC 2566, April 1999.
additional attributes and values. In order to reduce spam the
mailing list rejects mail from non-subscribers, so you must subscribe
to the mailing list in order to send a question or comment to the
mailing list.
15 References [RFC2910] Herriot, R., Butler, S., Moore, P. and R. Turner,
"Internet Printing Protocol/1.1: Encoding and Transport",
RFC 2910, September 2000.
[ipp-coll] [RFC2911] Hastings, T., Herriot, R., deBry, R., Isaacson, S. and P.
deBry, R., , Hastings, T., Herriot, R., "Internet Printing Protocol Powell, "Internet Printing Protocol/1.0: Model and
(IPP): The Collection Attribute Syntax", <draft-ietf-ipp- Semantics", RFC 2911, September 2000.
collection-05.txt>, work in progress, July 17, 2001.
[ipp-set2] [RFC3382] deBry, R., Hastings, T., Herriot, R., Ocke, K. and P.
Kugler, C, Hastings, T., Lewis, H., "Internet Printing Zehler, "Internet Printing Protocol (IPP): The
Protocol/1.1: Job and Printer Administrative Operations", <draft- 'collection' attribute syntax", RFC 3382, September 2002.
ietf-ipp-ops-set2-02.txt>, July 19, 2000.
[ldap-printer] 14.2 Informative References
Fleming, P., Jones, K., Lewis, H., McDonald, I., "Internet Printing
Protocol (IPP): LDAP Schema for Printer Services", <draft-ietf-ipp-
ldap-printer-schema-04.txt>, work in progress, December 20, 2000.
[RFC2565] [RFC2251] Wahl, M., Howes, T. abd S. Kille, "Lightweight Directory
Herriot, R., Butler, S., Moore, P., Tuner, R., "Internet Printing Access Protocol (v3)", RFC 2251, December 1997.
Protocol/1.0: Encoding and Transport", RFC 2565, April 1999.
[RFC2566] [RFC2252] Wahl, M., Coulbeck, A., Howes, T. and S. Kille,
R. deBry, T. Hastings, R. Herriot, S. Isaacson, P. Powell, "Lightweight Directory Access Protocol (v3): Attribute
"Internet Printing Protocol/1.0: Model and Semantics", RFC 2566, Syntax Definitions", RFC 2252, December 1997.
April 1999.
[RFC2910] [RFC2608] Guttman, E., Perkins, C., Veizades, J. and M. Day,
Herriot, R., Butler, S., Moore, P., Turner, R., "Internet Printing "Service Location Protocol, Version 2", RFC 2608, June
Protocol/1.1: Encoding and Transport", RFC 2910, September 2000. 1999.
[RFC2911] [RFC2609] Guttman, E., Perkins, C. and J. Kempf, "Service Templates
R. deBry, T. Hastings, R. Herriot, S. Isaacson, P. Powell, and service: Schemes", RFC 2609, June 1999.
"Internet Printing Protocol/1.0: Model and Semantics", RFC 2911,
September 2000.
[svrloc-printer] [RFC3196] Hastings, T., Manros, C., Zehler, P., Kugler, C. and H.
St. Pierre, P., Isaacson, S., McDonald, I., "Definition of the Holst, "Internet Printing Protocol/1.1: Implementor's
Printer Abstract Service Type v2.0", <draft-ietf-svrloc-printer- Guide", RFC 3196, November 2001.
scheme-06.txt>, work in progress, March 8, 2000.
16 Appendix A: Allowed Values for Set-Printer-Attributes and Set-Job- Appendix A: Allowed Values for Set-Printer-Attributes and
Attributes requests Set-Job-Attributes requests (Normative)
This appendix is a normative part of this document and contains a This appendix is a normative part of this document and contains a
table of all IPP/1.1 attributes. Each row contains: table of all IPP/1.1 attributes. Each row contains:
? an attribute and - an attribute and
? the values allowed in the Set-Printer-Attributes or Set-Job- - the values allowed in the Set-Printer-Attributes or Set-Job-
Attributes request for the attribute. The entry in each cell is Attributes request for the attribute. The entry in each cell
the name (first few words) of each item below 1, 2, 3, 4a-g, and is the name (first few words) of each item below 1, 2, 3, 4a-g,
5. and 5.
The allowed values include the following cases: The allowed values include the following cases:
1. READ-ONLY: the Set-Printer-Attributes or Set-Job-Attributes 1. READ-ONLY: the Set-Printer-Attributes or Set-Job-Attributes
operation MUST NOT change this attribute and MUST reject the operation MUST NOT change this attribute and MUST reject the
entire operation (see section 7.1). entire operation (see section 7.1).
2. Any of "xxx-supported": the Set-Printer-Attributes or Set-Job-
Attributes operation accepts values that are allowed according to
the IPP/1.1 rules for validating the value(s) of an "xxx" Printer
or Job attribute against the value(s) of the corresponding "xxx-
supported" Printer attribute. Table 5 summarizes those validation
rules depending on each attribute syntax and value of an "xxx"
attribute supplied in the request and that of the corresponding
"xxx-supported" Printer attribute. The "xxx-supported" attribute
syntax type and value(s) are obtained from a Get-Printer-
Supported-Values response (see the tables in this Appendix).
Table 5 - Validation rules for 'Any of "xxx-supported" '
Type of "xxx" Type of "xxx- Validates if:
value to be supported" value
set
integer rangeOfInteger each value is in one of the 2. Any of "xxx-supported": the Set-Printer-Attributes or Set-
"xxx-supported" ranges Job-Attributes operation accepts values that are allowed
according to the IPP/1.1 rules for validating the value(s) of
an "xxx" Printer or Job attribute against the value(s) of the
corresponding "xxx-supported" Printer attribute. Table 5
summarizes those validation rules depending on each attribute
syntax and value of an "xxx" attribute supplied in the request
and that of the corresponding "xxx-supported" Printer
attribute. The "xxx-supported" attribute syntax type and
value(s) are obtained from a Get-Printer-Supported-Values
response (see the tables in this Appendix).
uri uriScheme each uri scheme matches one Table 5 - Validation rules for 'Any of "xxx-supported" '
of the "xxx-supported"
schemes
any boolean if the boolean "xxx- Type of "xxx" Type of "xxx- Validates if:
supported" is 'true' value to be supported" value
set
any same type each value matches an "xxx- integer rangeOfInteger each value is in one of the
supported" value of the same "xxx-supported" ranges
type
For additional non-normative explanatory information see section uri uriScheme each uri scheme matches one
3.1.2.3 of the "Internet Printing Protocol/1.1: Implementer's of the "xxx-supported"
Guide" [ipp-iig]). schemes
3. From Get-Printer-Supported-Values: the Set-Printer-Attributes any boolean if the boolean "xxx-
operation accepts values that are allowed according to the IPP/1.1 supported" is 'true'
rules for validating the value(s) of an "xxx" Printer attribute
against the value(s) of the corresponding "xxx-supported" Printer
attribute. Table 6 summarizes those validation rules depending on
each attribute syntax and value of an "xxx" attribute supplied in
the request and that of the corresponding "xxx-supported" Printer
attribute. The "xxx-supported" attribute syntax type and
attribute value(s) are obtained from a Get-Printer-Supported-
Values response (see Appendix B: Attributes returned from Get-
Printer-Supported-Values below).
Table 6 - Validation rules for 'From Get-Printer-Supported-Values' any same type each value matches an "xxx-
supported" value of the same
type
Type of Type of "xxx- Validates if: For additional non-normative explanatory information see section
"xxx" supported" value 3.1.2.3 of the "Internet Printing Protocol/1.1: Implementer's Guide"
value to [RFC3196].
be set
integer rangeOfInteger each 'integer' value is in one of 3. From Get-Printer-Supported-Values: the Set-Printer-Attributes
the "xxx-supported" ranges operation accepts values that are allowed according to the
IPP/1.1 rules for validating the value(s) of an "xxx" Printer
attribute against the value(s) of the corresponding "xxx-
supported" Printer attribute. Table 6 summarizes those
validation rules depending on each attribute syntax and value
of an "xxx" attribute supplied in the request and that of the
corresponding "xxx-supported" Printer attribute. The "xxx-
supported" attribute syntax type and attribute value(s) are
obtained from a Get-Printer-Supported-Values response (see
Appendix B: Attributes returned from Get-Printer-Supported-
Values below).
uri uriScheme the uri scheme of each value Table 6 - Validation rules for 'From Get-Printer-Supported-Values'
matches one of the "xxx-supported"
schemes
any boolean if the boolean "xxx-supported" is Type of -
'true' "xxx" supported" value Validates if:
value to
be set Type of "xxx
name 'admin-define' any 'name' value matches integer rangeOfInteger each 'integer' value is in one of
out-of-band the "xxx-supported" ranges
value
any same type each value matches an "xxx- uri uriScheme the uri scheme of each value
supported" value of the same type matches one of the "xxx-supported"
schemes
For additional non-normative explanatory information see section any boolean if the boolean "xxx-supported" is
3.1.2.3 of the "Internet Printing Protocol/1.1: Implementer's 'true'
Guide" [ipp-iig]).
4. Any value of the proper attribute syntax: the Set-Printer- name 'admin-define' any 'name' value matches
Attributes or Set-Job-Attributes operation accepts any value of out-of-band
the specified attribute syntax. The attribute syntaxes supported value
are enumerated below.
a. Any text(127) any same type each value matches an "xxx-
b. Any name(127) supported" value of the same type
c. Any uri
d. Any boolean
e. Any positive integer
f. Any dateTime
g. 1setOf any uri
5. Combination of 'Any of "xxx-supported"' or 'Any name'. For additional non-normative explanatory information see section
3.1.2.3 of the "Internet Printing Protocol/1.1: Implementer's Guide"
[RFC3196].
If a Printer implementation doesn't want to allow setting values 4. Any value of the proper attribute syntax: the Set-Printer-
indicated in this Appendix as "any xxx", it can make the value be Attributes or Set-Job-Attributes operation accepts any value of
not-settable. the specified attribute syntax. The attribute syntaxes
supported are enumerated below.
Table 7 - Values allowed for Job Template Attributes in the Set-Job- a. Any text(127)
Attributes Operation b. Any name(127)
c. Any uri
d. Any boolean
e. Any positive integer
f. Any dateTime
g. 1setOf any uri
Job Template Attributes Values allowed for 5. Combination of 'Any of "xxx-supported"' or 'Any name'. If a
Set Printer implementation doesn't want to allow setting values
indicated in this Appendix as "any xxx", it can make the value
be not-settable.
job-priority (integer(1:100)) Any of "xxx- Table 7 - Values allowed for Job Template Attributes in the
supported" Set-Job-Attributes Operation
job-hold-until (type3 keyword | name (MAX)) Any of "xxx- Job Template Attributes Values allowed for
supported" Set
job-sheets (type3 keyword | name(MAX)) Any of "xxx- job-priority (integer(1:100)) Any of "xxx-
supported" supported"
multiple-document-handling (type2 keyword) Any of "xxx- job-hold-until (type3 keyword | name (MAX)) Any of "xxx-
supported" supported"
copies (integer(1:MAX)) Any of "xxx- job-sheets (type3 keyword | name(MAX)) Any of "xxx-
supported" supported"
finishings (1setOf type2 enum) Any of "xxx- multiple-document-handling (type2 keyword) Any of "xxx-
supported" supported"
page-ranges (1setOf rangeOfInteger (1:MAX)) Any of "xxx- copies (integer(1:MAX)) Any of "xxx-
supported" supported"
sides (type2 keyword) Any of "xxx- finishings (1setOf type2 enum) Any of "xxx-
supported" supported"
number-up (integer(1:MAX)) Any of "xxx- page-ranges (1setOf rangeOfInteger (1:MAX)) Any of "xxx-
supported" supported"
orientation-requested (type2 enum) Any of "xxx- sides (type2 keyword) Any of "xxx-
supported" supported"
media (type3 keyword | name(MAX)) Any of "xxx- number-up (integer(1:MAX)) Any of "xxx-
supported" supported"
printer-resolution (resolution) Any of "xxx- orientation-requested (type2 enum) Any of "xxx-
supported" supported"
print-quality (type2 enum) Any of "xxx- media (type3 keyword | name(MAX)) Any of "xxx-
supported" supported"
Table 8 - Values allowed for Job Description Attributes in the Set- printer-resolution (resolution) Any of "xxx-
Job-Attributes Operation supported"
Job Description Attributes Values allowed for print-quality (type2 enum) Any of "xxx-
Set supported"
job-uri (uri) READ-ONLY Table 8 - Values allowed for Job Description Attributes in the
Set-Job-Attributes Operation
job-id (integer(1:MAX)) READ-ONLY Job Description Attributes Values allowed for
Set
job-printer-uri (uri) READ-ONLY job-uri (uri) READ-ONLY
job-more-info (uri) READ-ONLY job-id (integer(1:MAX)) READ-ONLY
job-name (name(MAX)) Any name(MAX) job-printer-uri (uri) READ-ONLY
job-originating-user-name (name(MAX)) READ-ONLY job-more-info (uri) READ-ONLY
job-state (type1 enum) READ-ONLY job-name (name(MAX)) Any name(MAX)
job-state-reasons (1setOf type2 keyword) READ-ONLY job-originating-user-name (name(MAX)) READ-ONLY
job-state-message (text(MAX)) READ-ONLY job-state (type1 enum) READ-ONLY
job-detailed-status-messages (1setOf READ-ONLY job-state-reasons (1setOf type2 keyword) READ-ONLY
text(MAX))
job-document-access-errors (1setOf READ-ONLY job-state-message (text(MAX)) READ-ONLY
text(MAX))
number-of-documents (integer(0:MAX)) READ-ONLY job-detailed-status-messages (1setOf READ-ONLY
text(MAX))
output-device-assigned (name(127)) READ-ONLY job-document-access-errors (1setOf READ-ONLY
text(MAX))
time-at-creation (integer(MIN:MAX)) READ-ONLY number-of-documents (integer(0:MAX)) READ-ONLY
time-at-processing (integer(MIN:MAX)) READ-ONLY output-device-assigned (name(127)) READ-ONLY
time-at-completed (integer(MIN:MAX)) READ-ONLY time-at-creation (integer(MIN:MAX)) READ-ONLY
job-printer-up-time (integer(1:MAX)) READ-ONLY time-at-processing (integer(MIN:MAX)) READ-ONLY
date-time-at-creation (dateTime) READ-ONLY time-at-completed (integer(MIN:MAX)) READ-ONLY
Job Description Attributes Values allowed for
Set
date-time-at-processing (dateTime) READ-ONLY job-printer-up-time (integer(1:MAX)) READ-ONLY
date-time-at-completed (dateTime) READ-ONLY date-time-at-creation (dateTime) READ-ONLY
Job Description Attributes Values allowed for
Set
number-of-intervening-jobs (integer(0:MAX)) READ-ONLY date-time-at-processing (dateTime) READ-ONLY
job-message-from-operator (text(127)) Any text(127) date-time-at-completed (dateTime) READ-ONLY
job-k-octets (integer(0:MAX)) READ-ONLY number-of-intervening-jobs (integer(0:MAX)) READ-ONLY
job-impressions (integer(0:MAX)) READ-ONLY job-message-from-operator (text(127)) Any text(127)
job-media-sheets (integer(0:MAX)) READ-ONLY job-k-octets (integer(0:MAX)) READ-ONLY
job-k-octets-processed (integer(0:MAX)) READ-ONLY job-impressions (integer(0:MAX)) READ-ONLY
job-impressions-completed (integer(0:MAX)) READ-ONLY job-media-sheets (integer(0:MAX)) READ-ONLY
job-media-sheets-completed (integer(0:MAX)) READ-ONLY job-k-octets-processed (integer(0:MAX)) READ-ONLY
attributes-charset (charset) READ-ONLY job-impressions-completed (integer(0:MAX)) READ-ONLY
attributes-natural-language READ-ONLY job-media-sheets-completed (integer(0:MAX)) READ-ONLY
(naturalLanguage)
Table 9 - Values allowed for Printer Job Template Attributes in the
Set-Printer-Attributes Operation
Printer Job Template Attributes Values allowed attributes-charset (charset) READ-ONLY
for Set
job-priority-default (integer(1:100)) Any of "xxx- attributes-natural-language READ-ONLY
supported" (naturalLanguage)
job-hold-until-default (type3 keyword | name - Table 9 - Values allowed for Printer Job Template Attributes in
(MAX)) supported"xx the Set-Printer-Attributes Operation
job-sheets-default (type3 keyword | name(MAX)) Any of "xxx- Printer Job Template Attributes Values allowed
supported" for Set
multiple-document-handling-default (type2 - job-priority-default (integer(1:100)) Any of "xxx-
keyword) supported"xx supported"
copies-default (integer(1:MAX)) Any of "xxx- job-hold-until-default (type3 keyword | name Any of "xxx-
supported" (MAX)) supported"
finishings-default (1setOf type2 enum) Any of "xxx- job-sheets-default (type3 keyword | name(MAX)) Any of "xxx-
supported" supported"
sides-default (type2 keyword) Any of "xxx- multiple-document-handling-default (type2 Any of "xxx-
supported" keyword) supported"
number-up-default (integer(1:MAX)) Any of "xxx- copies-default (integer(1:MAX)) Any of "xxx-
supported" supported"
orientation-requested-default (type2 enum) Any of "xxx- Printer Job Template Attributes Values allowed
supported" for Set
media-default (type3 keyword | name(MAX)) Any of "xxx- finishings-default (1setOf type2 enum) Any of "xxx-
supported" supported"
printer-resolution-default (resolution) Any of "xxx- sides-default (type2 keyword) Any of "xxx-
supported" supported"
print-quality-default (type2 enum) Any of "xxx- number-up-default (integer(1:MAX)) Any of "xxx-
supported" supported"
job-priority-supported (integer(1:100)) From Get- orientation-requested-default (type2 enum) Any of "xxx-
Printer- supported"
Supported-Values
Printer Job Template Attributes Values allowed media-default (type3 keyword | name(MAX)) Any of "xxx-
for Set supported"
job-hold-until-supported (1setOf(type3 keyword From Get- printer-resolution-default (resolution) Any of "xxx-
| name (MAX))) Printer- supported"
Supported-Values
job-sheets-supported (1setOf(type3 keyword | - print-quality-default (type2 enum) Any of "xxx-
name(MAX))) Printer- supported"
Supported-Values
multiple-document-handling-supported (1setOf - job-priority-supported (integer(1:100)) From Get-
type2 keyword) FromtGet Printer-
Supported-Values Supported-Values
copies-supported (rangeOfInteger(1:MAX)) From Get- job-hold-until-supported (1setOf(type3 keyword From Get-
Printer- | name (MAX))) Printer-
Supported-Values Supported-Values
finishings-supported (1setOf type2 enum) From Get- job-sheets-supported (1setOf(type3 keyword | From Get-
Printer- name(MAX))) Printer-
Supported-Values Supported-Values
page-ranges-supported (boolean) From Get- multiple-document-handling-supported (1setOf From Get-
Printer- type2 keyword) Printer-
Supported-Values Supported-Values
sides-supported (1setOf type2 keyword) From Get- copies-supported (rangeOfInteger(1:MAX)) From Get-
Printer- Printer-
Supported-Values Supported-Values
number-up-supported (1setOf (integer(1:MAX) | From Get- finishings-supported (1setOf type2 enum) From Get-
rangeOfInteger(1:MAX))) Printer- Printer-
Supported-Values Supported-Values
orientation-requested-supported (1setOf type2 From Get- Printer Job Template Attributes Values allowed
enum) Printer- for Set
Supported-Values
media-supported (1setOf (type3 keyword | From Get- page-ranges-supported (boolean) From Get-
name(MAX))) Printer- Printer-
Supported-Values Supported-Values
printer-resolution-supported (1setOf From Get- sides-supported (1setOf type2 keyword) From Get-
resolution) Printer- Printer-
Supported-Values Supported-Values
Printer Job Template Attributes Values allowed number-up-supported (1setOf (integer(1:MAX) | From Get-
for Set rangeOfInteger(1:MAX))) Printer-
Supported-Values
Supported-Values orientation-requested-supported (1setOf type2 From Get-
enum) Printer-
Supported-Values
print-quality-supported (1setOf type2 enum) From Get- media-supported (1setOf (type3 keyword | From Get-
Printer- name(MAX))) Printer-
Supported-Values Supported-Values
media-ready (type3 keyword | name(MAX)) From Get- printer-resolution-supported (1setOf From Get-
Printer- resolution) Printer-
Supported-Values Supported-Values
Table 10 - Values allowed for Printer Description Attributes in the print-quality-supported (1setOf type2 enum) From Get-
Set-Printer-Attributes Operation Printer-
Supported-Values
Printer Description Attributes Values allowed for media-ready (type3 keyword | name(MAX)) From Get-
Set Printer-
Supported-Values
printer-uri-supported (1setOf uri) READ-ONLY Table 10 - Values allowed for Printer Description Attributes in
the Set-Printer-Attributes Operation
uri-authentication-supported (1setOf type2 READ-ONLY Printer Description Attributes Values allowed for
keyword) Set
uri-security-supported (1setOf type2 READ-ONLY printer-uri-supported (1setOf uri) READ-ONLY
keyword)
printer-xri-supported (1setOf collection) uri-authentication-supported (1setOf type2 READ-ONLY
member attributes: keyword)
xri-uri (uri) any uriScheme of uri-security-supported (1setOf type2 READ-ONLY
"xri-uri-scheme- keyword)
supported" from
Get-Printer-
Attributes
xri-authentication (1setOf type2 keyword) any keyword of printer-xri-supported (1setOf collection)
"xri- member attributes:
authentication-
supported" from
Get-Printer-
Attributes
Printer Description Attributes Values allowed for xri-uri (uri) any uriScheme of
Set "xri-uri-scheme-
supported" from
Get-Printer-
Attributes
xri-security (1setOf type2 keyword) any keyword of xri-authentication (type2 keyword) any keyword of
"xri-security- "xri-
supported" from authentication-
Get-Printer- supported" from
Attributes Get-Printer-
Attributes
xri-uri-scheme-supported (1setOf uriScheme) READ-ONLY xri-security (type2 keyword) any keyword of
"xri-security-
supported" from
Get-Printer-
Attributes
xri-authentication-supported (1setOf type2 -ONLY xri-uri-scheme-supported (1setOf uriScheme) READ-ONLY
keyword) READ
xri-security-supported (1setOf type2 READ-ONLY xri-authentication-supported (1setOf type2 READ-ONLY
keyword) keyword)
printer-name (name(127)) Any name(127) xri-security-supported (1setOf type2 READ-ONLY
keyword)
Printer Description Attributes Values allowed for
Set
printer-location (text(127)) Any text(127) printer-name (name(127)) Any name(127)
printer-info (text(127)) Any text(127) printer-location (text(127)) Any text(127)
printer-more-info (uri) Any uri printer-info (text(127)) Any text(127)
printer-driver-installer (uri) Any uri printer-more-info (uri) Any uri
printer-make-and-model (text(127)) Any text(127) printer-driver-installer (uri) Any uri
printer-more-info-manufacturer (uri) Any uri printer-make-and-model (text(127)) Any text(127)
printer-state (type1 enum) READ-ONLY printer-more-info-manufacturer (uri) Any uri
printer-state-reasons (1setOf type2 READ-ONLY printer-state (type1 enum) READ-ONLY
keyword)
printer-state-message (text(MAX)) READ-ONLY printer-state-reasons (1setOf type2 READ-ONLY
keyword)
ipp-versions-supported (1setOf type2 From Get-Printer- printer-state-message (text(MAX)) READ-ONLY
keyword) Supported-Values
operations-supported (1setOf type2 enum) From Get-Printer- ipp-versions-supported (1setOf type2 From Get-Printer-
Supported-Values keyword) Supported-Values
multiple-document-jobs-supported (boolean) From Get-Printer- operations-supported (1setOf type2 enum) From Get-Printer-
Supported-Values Supported-Values
Printer Description Attributes Values allowed for multiple-document-jobs-supported (boolean) From Get-Printer-
Set Supported-Values
Supported-Values charset-configured (charset) Any of "xxx-
supported", use
"charset-supported"
charset-configured (charset) Any of "xxx- charset-supported (1setOf charset) From Get-Printer-
supported", use Supported-Values
"charset-supported"
charset-supported (1setOf charset) From Get-Printer- Printer Description Attributes Values allowed for
Supported-Values Set
natural-language-configured Any of "xxx- natural-language-configured Any of "xxx-
(naturalLanguage) supported", use (naturalLanguage) supported", use
"generated-natural- "generated-natural-
language-supported" language-supported"
generated-natural-language-supported From Get-Printer- generated-natural-language-supported From Get-Printer-
(1setOf naturalLanguage) Supported-Values (1setOf naturalLanguage) Supported-Values
document-format-default (mimeMediaType) Any of "xxx- document-format-default (mimeMediaType) Any of "xxx-
supported" supported"
document-format-supported (1setOf From Get-Printer- document-format-supported (1setOf From Get-Printer-
mimeMediaType) Supported-Values mimeMediaType) Supported-Values
printer-is-accepting-jobs (boolean) READ-ONLY printer-is-accepting-jobs (boolean) READ-ONLY
queued-job-count (integer(0:MAX)) READ-ONLY queued-job-count (integer(0:MAX)) READ-ONLY
printer-message-from-operator (text(127)) Any text(127) printer-message-from-operator (text(127)) Any text(127)
color-supported (boolean) From Get-Printer- color-supported (boolean) From Get-Printer-
Supported-Values Supported-Values
reference-uri-schemes-supported (1setOf From Get-Printer- reference-uri-schemes-supported (1setOf From Get-Printer-
uriScheme) Supported-Values uriScheme) Supported-Values
pdl-override-supported (type2 keyword) From Get-Printer- pdl-override-supported (type2 keyword) From Get-Printer-
Supported-Values Supported-Values
printer-up-time (integer(1:MAX)) READ-ONLY printer-up-time (integer(1:MAX)) READ-ONLY
printer-current-time (dateTime) Any dateTime ** printer-current-time (dateTime) Any dateTime **
Printer Description Attributes Values allowed for
Set
multiple-operation-time-out any positive multiple-operation-time-out any positive
(integer(1:MAX)) integer (integer(1:MAX)) integer
compression-supported (1setOf type3 From Get-Printer- compression-supported (1setOf type3 From Get-Printer-
keyword) Supported-Values keyword) Supported-Values
job-k-octets-supported From Get-Printer- job-k-octets-supported From Get-Printer-
(rangeOfInteger(0:MAX)) Supported-Values (rangeOfInteger(0:MAX)) Supported-Values
Printer Description Attributes Values allowed for
Set
job-impressions-supported From Get-Printer- job-impressions-supported From-Get-Printer-
(rangeOfInteger(0:MAX)) Supported-Values (rangeOfInteger(0:MAX)) Supported-Values
job-media-sheets-supported -Printer- job-media-sheets-supported From Get-Printer-
(rangeOfInteger(0:MAX)) Supported-Values (rangeOfInteger(0:MAX)) Supported-Values
pages-per-minute (integer(0:MAX)) READ-ONLY pages-per-minute (integer(0:MAX)) READ-ONLY
pages-per-minute-color (integer(0:MAX)) READ-ONLY pages-per-minute-color (integer(0:MAX)) READ-ONLY
printer-settable-attributes-supported From Get-Printer- printer-settable-attributes-supported From Get-Printer-
(1setOf type2 keyword) Supported-Values (1setOf type2 keyword) Supported-Values
job-settable-attributes-supported (1setOf From Get-Printer- job-settable-attributes-supported (1setOf From Get-Printer-
type2 keyword) Supported-Values type2 keyword) Supported-Values
document-format-varying-attributes (1setOf READ-ONLY document-format-varying-attributes (1setOf READ-ONLY
type2 keyword) type2 keyword)
printer-message-time (integer(MIN:MAX)) READ-ONLY printer-message-time (integer(MIN:MAX)) READ-ONLY
printer-message-date-time(dateTime) READ-ONLY printer-message-date-time(dateTime) READ-ONLY
** - The "printer-current-time" (dateTime) attribute is settable in ** - The "printer-current-time" (dateTime) attribute is settable in
order to allow an administrator to correct an incorrect dateTime or order to allow an administrator to correct an incorrect dateTime or
time zone. time zone.
17 Appendix B: Attributes returned from Get-Printer-Supported-Values Appendix B: Attributes returned from Get-Printer-Supported-Values
(Normative)
This Appendix is a normative part of this document and lists all the This Appendix is a normative part of this document and lists all the
attributes that are possible for an implementation to return in a attributes that are possible for an implementation to return in a
Get-Printer-Supported-Values response, i.e., all the "xxx-supported" Get-Printer-Supported-Values response, i.e., all the "xxx-supported"
attributes that can be supplied in a Set-Printer-Attributes request. attributes that can be supplied in a Set-Printer-Attributes request.
READ-ONLY attributes MUST NOT be returned in a Get-Printer-Supported- READ-ONLY attributes MUST NOT be returned in a Get-Printer-
Values response and are indicated in the tables as "READ-ONLY - MUST Supported-Values response and are indicated in the tables as "READ-
NOT be returned." ONLY - MUST NOT be returned."
For the following attributes, the value allowed by the Set-Printer- For the following attributes, the value allowed by the Set-Printer-
Attributes operation MUST be a single integer value in the range Attributes operation MUST be a single integer value in the range
specified by the value returned by the Get-Printer-Supported-Values specified by the value returned by the Get-Printer-Supported-Values
operation. operation.
Table 11 - Printer Job Template Attributes returned from Get-Printer- Table 11 - Printer Job Template Attributes returned from
Supported-Values Get-Printer-Supported-Values
Printer Job Template Attributes Values Returned Printer Job Template Attributes Values Returned
job-priority-supported (integer(1:100)) rangeOfInteger(1:100) job-priority-supported (integer(1:100)) rangeOfInteger(1:100)
For the following attributes, the value allowed by the Set-Printer- For the following attributes, the value allowed by the Set-Printer-
Attributes operation MUST be a single rangeOfInteger value whose Attributes operation MUST be a single rangeOfInteger value whose
bounds do not exceed those of the range specified by the value bounds do not exceed those of the range specified by the value
returned by the Get-Printer-Supported-Values operation. returned by the Get-Printer-Supported-Values operation.
Table 12 - Printer Job Template Attributes returned from Get-Printer- Table 12 - Printer Job Template Attributes returned from
Supported-Values Get-Printer-Supported-Values
Printer Job Template Attributes Values Returned Printer Job Template Attributes Values Returned
copies-supported (rangeOfInteger(1:MAX)) rangeOfInteger(1:MAX) copies-supported (rangeOfInteger(1:MAX)) rangeOfInteger(1:MAX)
The following table has the same criteria as the last, but is for The following table has the same criteria as the last, but is for
Printer Description attributes. Printer Description attributes.
Table 13 - Printer Description Attributes returned from Get-Printer- Table 13 - Printer Description Attributes returned from
Supported-Values Get-Printer-Supported-Values
Printer Description Attributes Values allowed for Set Printer Description Attributes Values allowed for Set
job-k-octets-supported rangeOfInteger(0:MAX) job-k-octets-supported rangeOfInteger(0:MAX)
(rangeOfInteger(0:MAX)) (rangeOfInteger(0:MAX))
job-impressions-supported rangeOfInteger(0:MAX) job-impressions-supported
(rangeOfInteger(0:MAX)) (rangeOfInteger(0:MAX)) rangeOfInteger(0:MAX)
job-media-sheets-supported rangeOfInteger(0:MAX) job-media-sheets-supported rangeOfInteger(0:MAX)
(rangeOfInteger(0:MAX)) (rangeOfInteger(0:MAX))
For the following attributes, the value allowed by the Set-Printer- For the following attributes, the value allowed by the Set-Printer-
Attributes operation MUST be one or more integers and rangeOfInteger Attributes operation MUST be one or more integers and rangeOfInteger
values, such that the integer values described by these integers and values, such that the integer values described by these integers and
rangeOfInteger is the same as or a subset of the integers described rangeOfInteger is the same as or a subset of the integers described
by the integers and rangeOf Integer of value returned by the Get- by the integers and rangeOf Integer of values returned by the Get-
Printer-Supported-Values operation. Printer-Supported-Values operation.
Table 14 - Printer Job Template Attributes returned from Get-Printer- Table 14 - Printer Job Template Attributes returned from
Supported-Values Get-Printer-Supported-Values
Printer Job Template Attributes Values Returned Printer Job Template Attributes Values Returned
number-up-supported (1setOf (integer(1:MAX) 1setOf number-up-supported (1setOf (integer(1:MAX) 1setOf
| rangeOfInteger(1:MAX))) (integer(1:MAX) | | rangeOfInteger(1:MAX))) (integer(1:MAX) |
rangeOfInteger(1:MA rangeOfInteger(1:MA
X)) X))
For the following attributes, the value allowed by the Set-Printer- For the following attributes, the value allowed by the Set-Printer-
Attributes operation MUST be one or more values, where each such Attributes operation MUST be one or more values, where each such
value matches a value returned by the Get-Printer-Supported-Values value matches a value returned by the Get-Printer-Supported-Values
operation. A keyword, enum, boolean, charset, naturalLanguage, operation. A keyword, enum, boolean, charset, naturalLanguage,
uriScheme, mimeMediaType or resolution value matches if it is equal. uriScheme, mimeMediaType or resolution value matches if it is equal.
For Job Template attributes with the attribute syntax 'type3 keyword For Job Template attributes, with the attribute syntax 'type3 keyword
| name', any 'name' attribute syntax value matches the 'admin-define' | name', any 'name' attribute syntax value matches the 'admin-define'
out-of-band value, if the implementation allows the administrator to out-of-band value, if the implementation allows the administrator to
set any name values for the attribute. set any name values for the attribute.
Table 15 - Printer Job Template Attributes returned from Get-Printer- Table 15 - Printer Job Template Attributes returned from
Supported-Values Get-Printer-Supported-Values
Printer Job Template Attributes Values Returned Printer Job Template Attributes Values Returned
job-hold-until-supported (1setOf(type3 1setOf (type3 job-hold-until-supported (1setOf(type3 1setOf (type3
keyword | name (MAX))) keyword | 'admin- keyword | name (MAX))) keyword | 'admin-
define') define')
job-sheets-supported (1setOf(type3 keyword 1setOf (type3 job-sheets-supported (1setOf(type3 keyword 1setOf (type3
| name(MAX))) keyword | 'admin- | name(MAX))) keyword | 'admin-
define') define')
multiple-document-handling-supported multiple-document-handling-supported 1setOf type2
(1setOf type2 keyword) keywordtype2 (1setOf type2 keyword) keyword
finishings-supported (1setOf type2 enum) 1setOf type2 enum finishings-supported (1setOf type2 enum) 1setOf type2 enum
page-ranges-supported (boolean) 1setOf boolean ** page-ranges-supported (boolean) 1setOf boolean **
sides-supported (1setOf type2 keyword) 1setOf type2 sides-supported (1setOf type2 keyword) 1setOf type2
keyword keyword
orientation-requested-supported (1setOf 1setOf type2 enum orientation-requested-supported (1setOf 1setOf type2 enum
type2 enum) type2 enum)
Printer Job Template Attributes Values Returned
media-supported (1setOf (type3 keyword | 1setOf (type3 media-supported (1setOf (type3 keyword | 1setOf (type3
name(MAX))) keyword | 'admin- name(MAX))) keyword | 'admin-
define') define')
printer-resolution-supported (1setOf 1setOf resolution printer-resolution-supported (1setOf 1setOf resolution
resolution) resolution)
print-quality-supported (1setOf type2 enum) 1setOf type2 enum print-quality-supported (1setOf type2 enum) 1setOf type2 enum
** Note: the Get-Printer-Supported-Values returns a '1setOf boolean' ** Note: the Get-Printer-Supported-Values returns a '1setOf boolean'
so that all possible values are indicated, while Get-Printer- so that all possible values are indicated, while ** Get-Printer-
Attributes returns only a single 'boolean' value. Attributes returns only a single 'boolean' value.
The following table has the same criteria as the last, but is for The following table has the same criteria as the last, but is for
Printer Description attributes. Printer Description attributes.
Table 16 - Printer Description Attributes returned from Get-Printer- Table 16 - Printer Description Attributes returned from
Supported-Values Get-Printer-Supported-Values
Printer Description Attributes Values allowed for Printer Description Attributes Values allowed for
Set Set
printer-uri-supported (1setOf uri) READ-ONLY - MUST printer-uri-supported (1setOf uri) READ-ONLY - MUST
NOT be returned NOT be returned
uri-authentication-supported (1setOf type2 READ-ONLY - MUST uri-authentication-supported (1setOf type2 READ-ONLY - MUST
keyword) NOT be returned keyword) NOT be returned
uri-security-supported (1setOf type2 READ-ONLY - MUST uri-security-supported (1setOf type2 READ-ONLY - MUST
keyword) NOT be returned keyword) NOT be returned
xri-printer-supported (1setOf collection) MUST NOT be printer-xri-supported (1setOf collection) MUST NOT be
returned; see next returned; see next
three attributes three attributes
returned with Get- returned with Get-
Printer-Attributes: Printer-Attributes:
xri-uri-scheme-supported (1setOf uriScheme) READ-ONLY - MUST xri-uri-scheme-supported (1setOf uriScheme) READ-ONLY - MUST
NOT be returned NOT be returned
xri-authentication-supported (1setOf type2 READ-ONLY - MUST xri-authentication-supported (1setOf type2 READ-ONLY - MUST
keyword) NOT be returned keyword) NOT be returned
xri-security-supported (1setOf type2 READ-ONLY - MUST xri-security-supported (1setOf type2 READ-ONLY - MUST
keyword) NOT be returned keyword) NOT be returned
Printer Description Attributes Values allowed for
Set
ipp-versions-supported (1setOf type2 1setOf type2 ipp-versions-supported (1setOf type2 1setOf type2
keyword) keyword keyword) keyword
operations-supported (1setOf type2 enum) 1setOf type2 operations-supported (1setOf type2 enum) 1setOf type2
keyword keyword
multiple-document-jobs-supported (boolean) 1setOf boolean ** multiple-document-jobs-supported (boolean) 1setOf boolean **
charset-supported (1setOf charset) 1setOf charset charset-supported (1setOf charset) 1setOf charset
generated-natural-language-supported 1setOf generated-natural-language-supported 1setOf
(1setOf naturalLanguage) naturalLanguage (1setOf naturalLanguage) naturalLanguage
document-format-supported (1setOf 1setOf document-format-supported (1setOf 1setOf
mimeMediaType) mimeMediaType mimeMediaType) mimeMediaType
Printer Description Attributes Values allowed for
Set
color-supported (boolean) 1setOf boolean ** color-supported (boolean) 1setOf boolean **
reference-uri-schemes-supported (1setOf 1setOf uriScheme reference-uri-schemes-supported (1setOf 1setOf uriScheme
uriScheme) uriScheme)
pdl-override-supported (type2 keyword) 1setOf type2 pdl-override-supported (type2 keyword) 1setOf type2
keyword ** keyword **
compression-supported (1setOf type3 1setOf type3 compression-supported (1setOf type3 1setOf type3
keyword) keyword keyword) keyword
printer-settable-attributes-supported 1setOf type2 printer-settable-attributes-supported 1setOf type2
(1setOf type2 keyword) keyword (1setOf type2 keyword) keyword
job-settable-attributes-supported (1setOf 1setOf type2 job-settable-attributes-supported (1setOf 1setOf type2
type2 keyword) keyword type2 keyword) keyword
** Note: the Get-Printer-Supported-Values returns a '1setOf X' so ** Note: the Get-Printer-Supported-Values returns a '1setOf X' so
that all possible values are indicated, while Get-Printer-Attributes that all possible values are indicated, while Get-Printer-Attributes
returns only a single 'X' value. returns only a single 'X' value.
18 Appendix C: Description of the Base IPP Documents Appendix C: Description of the Base IPP Documents (Informative)
The base set of IPP documents includes: The base set of IPP documents includes:
Design Goals for an Internet Printing Protocol [RFC2567] Design Goals for an Internet Printing Protocol [RFC2567]
Rationale for the Structure and Model and Protocol for the Internet Rationale for the Structure and Model and Protocol for the
Printing Protocol [RFC2568] Internet Printing Protocol [RFC2568]
Internet Printing Protocol/1.1: Model and Semantics [RFC2911] Internet Printing Protocol/1.1: Model and Semantics [RFC2911]
Internet Printing Protocol/1.1: Encoding and Transport [RFC2910] Internet Printing Protocol/1.1: Encoding and Transport [RFC2910]
Internet Printing Protocol/1.1: Implementer's Guide [IPP-IIG] Internet Printing Protocol/1.1: Implementer's Guide [RFC3196]
Mapping between LPD and IPP Protocols [RFC2569] Mapping between LPD and IPP Protocols [RFC2569]
The "Design Goals for an Internet Printing Protocol" document takes a The "Design Goals for an Internet Printing Protocol" document takes a
broad look at distributed printing functionality, and it enumerates broad look at distributed printing functionality, and it enumerates
real-life scenarios that help to clarify the features that need to be real-life scenarios that help to clarify the features that need to be
included in a printing protocol for the Internet. It identifies included in a printing protocol for the Internet. It identifies
requirements for three types of users: end users, operators, and requirements for three types of users: end users, operators, and
administrators. It calls out a subset of end user requirements that administrators. It calls out a subset of end user requirements that
are satisfied in IPP/1.0 [RFC2566, RFC2565]. A few OPTIONAL operator are satisfied in IPP/1.0 [RFC2566, RFC2565]. A few OPTIONAL operator
operations have been added to IPP/1.1 [RFC2911, RFC2910]. operations have been added to IPP/1.1 [RFC2911, RFC2910].
skipping to change at page 62, line 19 skipping to change at page 56, line 38
view, defines a roadmap for the various documents that form the suite view, defines a roadmap for the various documents that form the suite
of IPP specification documents, and gives background and rationale of IPP specification documents, and gives background and rationale
for the IETF IPP working group's major decisions. for the IETF IPP working group's major decisions.
The "Internet Printing Protocol/1.1: Model and Semantics" document The "Internet Printing Protocol/1.1: Model and Semantics" document
describes a simplified model with abstract objects, their attributes, describes a simplified model with abstract objects, their attributes,
and their operations. The model introduces a Printer and a Job. The and their operations. The model introduces a Printer and a Job. The
Job supports multiple documents per Job. The model document also Job supports multiple documents per Job. The model document also
addresses how security, internationalization, and directory issues addresses how security, internationalization, and directory issues
are addressed. are addressed.
The "Internet Printing Protocol/1.1: Encoding and Transport" document The "Internet Printing Protocol/1.1: Encoding and Transport" document
is a formal mapping of the abstract operations and attributes defined is a formal mapping of the abstract operations and attributes defined
in the model document onto HTTP/1.1 [RFC2616]. It also defines the in the model document onto HTTP/1.1 [RFC2616]. It also defines the
encoding rules for a new Internet MIME media type called encoding rules for a new Internet MIME media type called
"application/ipp". This document also defines the rules for "application/ipp". This document also defines the rules for
transporting over HTTP a message body whose Content-Type is transporting over HTTP, a message body whose Content-Type is
"application/ipp". This document defines the 'ipp' scheme for "application/ipp". This document defines the 'ipp' scheme for
identifying IPP printers and jobs. identifying IPP printers and jobs.
The "Internet Printing Protocol/1.1: Implementer's Guide" document The "Internet Printing Protocol/1.1: Implementer's Guide" document
gives insight and advice to implementers of IPP clients and IPP gives insight and advice to implementers of IPP clients and IPP
objects. It is intended to help them understand IPP/1.1 and some of objects. It is intended to help them understand IPP/1.1 and some of
the considerations that may assist them in the design of their client the considerations that may assist them in the design of their client
and/or IPP object implementations. For example, a typical order of and/or IPP object implementations. For example, a typical order of
processing requests is given, including error checking. Motivation processing requests is given, including error checking. Motivation
for some of the specification decisions is also included. for some of the specification decisions are also included.
The "Mapping between LPD and IPP Protocols" document gives some The "Mapping between LPD and IPP Protocols" document gives some
advice to implementers of gateways between IPP and LPD (Line Printer advice to implementers of gateways between IPP and LPD (Line Printer
Daemon) implementations. Daemon) implementations.
19 Appendix D: Full Copyright Statement Authors' Addresses
Copyright (C) The Internet Society (1998,1999,2000,2001). All Rights Carl Kugler
Reserved IBM
P.O. Box 1900
Boulder, CO 80301-9191
Phone: (303) 924-5060
EMail: kugler@us.ibm.com
Tom Hastings
Xerox Corporation
737 Hawaii St. ESAE 231
El Segundo, CA 90245
Phone: 310-333-6413
Fax: 310-333-5514
EMail: hastings@cp10.es.xerox.com
Robert Herriot
Consultant
706 Colorado Ave
Palo Alto, CA 94303
Phone: 650-327-4466
Fax: 650-327-4466
EMail: bob@Herriot.com
Harry Lewis
IBM
6300 Diagonal Hwy.
Boulder, CO 80301-9191
Phone: (303) 924-5337
EMail: harryl@us.ibm.com
IPP Web Page: http://www.pwg.org/ipp/
IPP Mailing List: ipp@pwg.org
To subscribe to the ipp mailing list, send the following email:
1) send it to majordomo@pwg.org
2) leave the subject line blank
3) put the following two lines in the message body:
subscribe ipp
end
Implementers of this specification document are encouraged to join
the IPP Mailing List in order to participate in any discussions of
clarification issues and review of registration proposals for
additional attributes and values. In order to reduce spam the
mailing list rejects mail from non-subscribers, so you must subscribe
to the mailing list in order to send a question or comment to the
mailing list.
Full Copyright Statement
Copyright (C) The Internet Society (2002). All Rights Reserved.
This document and translations of it may be copied and furnished to This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it others, and derivative works that comment on or otherwise explain it
or assist in its implementation may be prepared, copied, published or assist in its implementation may be prepared, copied, published
and distributed, in whole or in part, without restriction of any and distributed, in whole or in part, without restriction of any
kind, provided that the above copyright notice and this paragraph are kind, provided that the above copyright notice and this paragraph are
included on all such copies and derivative works. However, this included on all such copies and derivative works. However, this
document itself may not be modified in any way, such as by removing document itself may not be modified in any way, such as by removing
the copyright notice or references to the Internet Society or other the copyright notice or references to the Internet Society or other
Internet organizations, except as needed for the purpose of Internet organizations, except as needed for the purpose of
 End of changes. 454 change blocks. 
1250 lines changed or deleted 1224 lines changed or added

This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/