draft-ietf-ipp-job-printer-set-ops-00.txt   draft-ietf-ipp-job-printer-set-ops-01.txt 
INTERNET-DRAFT Carl Kugler INTERNET-DRAFT T. Hastings
<draft-ietf-ipp-job-printer-set-ops-00.txt> IBM Corporation <draft-ietf-ipp-job-printer-set-ops-01.txt> R. Herriot
T. Hastings
Xerox Corporation
R. Herriot
Xerox Corporation Xerox Corporation
Carl Kugler
H. Lewis H. Lewis
IBM Corporation IBM Corporation
March 1, 2000 March 8, 2000
Internet Printing Protocol (IPP): Job and Printer Set Operations Internet Printing Protocol (IPP):
Job and Printer Set Operations
Copyright (C) The Internet Society (2000). All Rights Reserved.
Status of this Memo Status of this Memo
This document is an Internet-Draft and is in full conformance with all This document is an Internet-Draft and is in full conformance with all
provisions of Section 10 of [RFC2026]. Internet-Drafts are working provisions of Section 10 of [RFC2026]. Internet-Drafts are working
documents of the Internet Engineering Task Force (IETF), its areas, and documents of the Internet Engineering Task Force (IETF), its areas, and
its working groups. Note that other groups may also distribute working its working groups. Note that other groups may also distribute working
documents as Internet-Drafts. documents as Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
skipping to change at page 1, line 30 skipping to change at page 1, line 31
its working groups. Note that other groups may also distribute working its working groups. Note that other groups may also distribute working
documents as Internet-Drafts. documents as Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference material time. It is inappropriate to use Internet-Drafts as reference material
or to cite them other than as "work in progress". or to cite them other than as "work in progress".
The list of current Internet-Drafts can be accessed at The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt http://www.ietf.org/ietf/1id-abstracts.txt
The list of Internet-Draft Shadow Directories can be accessed as The list of Internet-Draft Shadow Directories can be accessed as
http://www.ietf.org/shadow.html. http://www.ietf.org/shadow.html.
Abstract Abstract
This document specifies 3 additional OPTIONAL operations for use with This document specifies 3 additional OPTIONAL operations for use with
the Internet Printing Protocol/1.0 (IPP) [RFC2565, RFC2566], IPP/1.1 the Internet Printing Protocol/1.0 (IPP) [RFC2565, RFC2566], IPP/1.1
[ipp-mod, ipp-pro], and future versions. The first is the Set-Printer- [ipp-mod, ipp-pro], and future versions. The end user, operator, and
Attributes operation that operators/administrators may perform on a administrator Set-Job-Attributes and Set-Printer-Attributes operations
Printer object to change Printer attribute values. The second is the are used to modify IPP Job objects and Printer objects, respectively.
Set-Job-Attributes operation that end-users may perform on their jobs The third Get-Printer-Supported-Values operation returns values that the
and operators/administrators may perform on any job, depending on IPP Printer will accept for setting its "xxx-supported" attributes.
circumstances. The operation changes the Job attribute values. The third
is the Get-Printer-Supported-Values operation that
operators/administrators may perform on a Printer object in order to
determine acceptable values for setting "xxx-supported" attributes using
the Set-Printer-Attributes operation.
A Printer implementation can make the value of some attributes dependent Three out-of-band values are defined for use with these operations:
on the document-format, e.g. "resolution-supported". 'delete-attribute', 'any-value', and 'not-settable', along with a
'client-error-attributes-not-settable' status code.
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 corresponding "job-message-from-operator" (text) are defined to set the corresponding
IPP/1.1 Printer and Job Description attributes with the same names. A IPP/1.1 Printer and Job Description attributes with the same names.
new out-of-band value 'any-value' is added which may be used with any
Expires: September 1, 2000
attribute syntax if an attribute definition allows. The 'any-value'
value used with the 'name' attribute syntax can be (one of) the values
of "xxx-supported" attributes whose attribute syntaxes include both
'keyword' and 'name'. The 'any-value' value with the 'name' attribute
syntax matches any name supplied by the client during validation.
New Printer Description attributes are defined: Six Printer Description attributes are defined:
printer-settable-attributes-supported (1setOf type2 keyword) printer-settable-attributes-supported (1setOf type2 keyword)
job-settable-attributes-supported (1setOf type2 keyword) job-settable-attributes-supported (1setOf type2 keyword)
document-format-varying-attributes (1setOf type2 keyword) document-format-varying-attributes (1setOf type2 keyword)
printer-message-time (integer(MIN:MAX)) printer-message-time (integer(MIN:MAX))
printer-message-date-time (dateTime) printer-message-date-time (dateTime)
printer-xri-supported (1setOf collection)
A new status code is defined: 'client-error-attributes-not-settable'. Expires: September 8, 2000
A 'delete-attribute' out-of-band attribute value is defined for use by
the client in the Set-Job-Attributes request to indicate explicitly that
the Printer is to remove the specified attribute from the Job object.
Finally, the 'not-settable' out-of-band attribute value is defined for
returning in the Set-Printer-Attributes and Set-Job-Attributes operation
responses.
The scope of IPP is characterized in RFC2526 "Design Goals for an
Internet Printing Protocol". It is not the intent of this document to
revise or clarify this scope or conjecture as to the degree of industry
adoption or trends related to IPP within printing systems. It is the
intent of this document to extend the original set of operations - in a
similar fashion to the Set1 extensions which referred to IPP/1.0 and
were later incorporated into IPP/1.1.
Expires: September 1, 2000
The full set of IPP documents includes: The full 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 Internet
Printing Protocol [RFC2568] Printing Protocol [RFC2568]
Internet Printing Protocol/1.1: Model and Semantics (this document) Internet Printing Protocol/1.1: Model and Semantics (this document)
Internet Printing Protocol/1.1: Encoding and Transport [IPP-PRO] Internet Printing Protocol/1.1: Encoding and Transport [IPP-PRO]
Internet Printing Protocol/1.1: Implementer's Guide [IPP-IIG] Internet Printing Protocol/1.1: Implementer's Guide [IPP-IIG]
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
skipping to change at page 4, line 5 skipping to change at page 3, line 5
is intended to help them understand IPP/1.1 and some of the is intended to help them understand IPP/1.1 and some of the
considerations that may assist them in the design of their client and/or considerations that may assist them in the design of their client and/or
IPP object implementations. For example, a typical order of processing IPP object implementations. For example, a typical order of processing
requests is given, including error checking. Motivation for some of the requests is given, including error checking. Motivation for some of the
specification decisions is also included. specification decisions is also included.
The "Mapping between LPD and IPP Protocols" document gives some advice The "Mapping between LPD and IPP Protocols" document gives some advice
to implementers of gateways between IPP and LPD (Line Printer Daemon) to implementers of gateways between IPP and LPD (Line Printer Daemon)
implementations. implementations.
Expires: September 1, 2000 Expires: September 8, 2000
Table of Contents Table of Contents
1 Introduction.....................................................6 1 Introduction.....................................................5
2 Terminology......................................................6 2 Terminology......................................................5
2.1 Conformance Terminology.......................................6 2.1 Conformance Terminology.......................................5
2.2 Other terminology.............................................6 2.2 Other terminology.............................................6
3 Requirements and Use Cases.......................................7 3 Requirements and Use Cases.......................................6
4 Definition of the Set operations.................................7 4 Definition of the Set operations.................................7
4.1 Set-Printer-Attributes Operation..............................8 4.1 Set-Printer-Attributes Operation..............................7
4.1.1 Settable and READ-ONLY Printer Description attributes.....9 4.1.1 Settable and READ-ONLY Printer Description attributes.....9
4.1.2 Set-Printer-Attributes Request...........................10 4.1.2 Set-Printer-Attributes Request...........................10
4.1.3 Set-Printer-Attributes Response..........................12 4.1.3 Set-Printer-Attributes Response..........................11
4.2 Set-Job-Attributes Operation.................................13 4.2 Set-Job-Attributes Operation.................................12
4.2.1 Settable and READ-ONLY Job Description attributes........15 4.2.1 Settable and READ-ONLY Job Description attributes........14
4.2.2 Set-Job-Attributes Request...............................15 4.2.2 Set-Job-Attributes Request...............................15
4.2.3 Set-Job-Attributes Response..............................16 4.2.3 Set-Job-Attributes Response..............................16
4.3 Get-Printer-Supported-Values Operation.......................17 4.3 Get-Printer-Supported-Values Operation.......................17
5 New Operation attributes........................................18 5 New Operation attributes........................................18
5.1 "printer-message-from-operator" (text(127))..................19 5.1 "printer-message-from-operator" (text(127))..................18
5.2 "job-message-from-operator" (text(127))......................20 5.2 "job-message-from-operator" (text(127))......................19
6 New Printer Description Attributes..............................21 6 New Printer Description Attributes..............................20
6.1 printer-settable-attributes-supported (1setOf type2 keyword).21 6.1 printer-settable-attributes-supported (1setOf type2 keyword).20
6.2 job-settable-attributes-supported (1setOf type2 keyword).....21 6.2 job-settable-attributes-supported (1setOf type2 keyword).....21
6.3 document-format-varying-attributes (1setOf type2 keyword)....21 6.3 document-format-varying-attributes (1setOf type2 keyword)....21
6.4 printer-message-time (integer(MIN:MAX))......................22 6.4 printer-message-time (integer(MIN:MAX))......................21
6.5 printer-message-date-time (dateTime).........................22 6.5 printer-message-date-time (dateTime).........................22
6.6 printer-xri-supported (1setOf collection)....................22
7 Additional status codes.........................................22 7 Additional status codes.........................................24
7.1 'client-error-attributes-not-settable' (0x0413)..............23 7.1 'client-error-attributes-not-settable' (0x0413)..............24
8 Additional out-of-band values...................................23 8 Additional out-of-band values...................................24
8.1 'not-settable' out-of-band value.............................23 8.1 'not-settable' out-of-band value.............................25
8.1.1 Encoding of the 'not-settable' out-of-band attribute value23 8.1.1 Encoding of the 'not-settable' out-of-band attribute value25
8.2 'delete-attribute' out-of-band value.........................23 8.2 'delete-attribute' out-of-band value.........................25
8.2.1 Encoding of the 'delete-attribute' out-of-band value.....24 8.2.1 Encoding of the 'delete-attribute' out-of-band value.....25
8.3 'any-value' out-of-band attribute value......................24 8.3 'any-value' out-of-band attribute value......................25
8.3.1 Encoding of the 'any-value' out-of-band attribute value..24 8.3.1 Encoding of the 'any-value' out-of-band attribute value..26
9 Conformance Requirements........................................24 9 Conformance Requirements........................................26
10 IANA Considerations.............................................26 10 IANA Considerations.............................................27
11 Internationalization Considerations.............................26 11 Internationalization Considerations.............................27
12 Security Considerations.........................................26 12 Security Considerations.........................................28
13 Author's Addresses..............................................27 13 Author's Addresses..............................................28
Expires: September 1, 2000 Expires: September 8, 2000
14 References......................................................27 14 References......................................................29
15 Change History..................................................28 15 Change History..................................................30
15.1 Changes to the January 30, 2000 version to make the March 1, 2000 15.1 Changes to the March 1, 2000 version to make the March 8, 2000
version 28 version 30
15.2 Changes to the January 20, 2000 version to make the January 30, 15.2 Changes to the January 30, 2000 version to make the March 1, 2000
2000 version30 version 31
15.3 Changes to the January 4, 2000 version to make the January 20, 15.3 Changes to the January 20, 2000 version to make the January 30,
2000 version30 2000 version32
15.4 Changes to the December 8, 1999 version to make the January 4, 15.4 Changes to the January 4, 2000 version to make the January 20,
2000 version31 2000 version33
15.5 Changes to the December 8, 1999 version to make the January 4,
2000 version34
16 Appendix A: Allowed Values for Set-Printer-Attributes...........32 16 Appendix A: Allowed Values for Set-Printer-Attributes...........35
17 Appendix B: Attributes returned from Get-Printer-Supported-Values36 17 Appendix B: Attributes returned from Get-Printer-Supported-Values39
18 Appendix C: Full Copyright Statement............................39 18 Appendix C: Full Copyright Statement............................42
Table of Tables Table of Tables
Table 1 - Operation-Id assignments....................................8 Table 1 - Operation-Id assignments....................................7
Table 2 - Job State Transition Table for the Set-Job-Attributes Table 2 - Job State Transition Table for the Set-Job-Attributes
operation........................................................14 operation........................................................14
Table 3 - Values allowed for Job Template Attributes in the Set-Job- Table 3 - Member attributes of "printer-xri-supported" (1setOf
Attributes Operation.............................................33 collection)......................................................22
Table 4 - Values allowed for Job Description Attributes in the Set-Job- Table 4 - Values allowed for Job Template Attributes in the Set-Job-
Attributes Operation.............................................33 Attributes Operation.............................................35
Table 5 - Values allowed for Printer Job Template Attributes in the Set- Table 5 - Values allowed for Job Description Attributes in the Set-Job-
Printer-Attributes Operation.....................................34 Attributes Operation.............................................36
Table 6 - Values allowed for Printer Description Attributes in the Set- Table 6 - Values allowed for Printer Job Template Attributes in the Set-
Printer-Attributes Operation.....................................35 Printer-Attributes Operation.....................................37
Table 7 - Printer Job Template Attributes returned from Get-Printer- Table 7 - Values allowed for Printer Description Attributes in the Set-
Supported-Values.................................................36 Printer-Attributes Operation.....................................37
Table 8 - Printer Job Template Attributes returned from Get-Printer- Table 8 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values.................................................37 Supported-Values.................................................39
Table 9 - Printer Description Attributes returned from Get-Printer- Table 9 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values.................................................37 Supported-Values.................................................39
Table 10 - Printer Job Template Attributes returned from Get-Printer- Table 10 - Printer Description Attributes returned from Get-Printer-
Supported-Values.................................................37 Supported-Values.................................................40
Table 11 - Printer Job Template Attributes returned from Get-Printer- Table 11 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values.................................................37 Supported-Values.................................................40
Table 12 - Printer Description Attributes returned from Get-Printer- Table 12 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values.................................................38 Supported-Values.................................................40
Table 13 - Printer Description Attributes returned from Get-Printer- Table 13 - Printer Description Attributes returned from Get-Printer-
Supported-Values.................................................39 Supported-Values.................................................41
Table 14 - Printer Description Attributes returned from Get-Printer- Table 14 - Printer Description Attributes returned from Get-Printer-
Supported-Values.................................................39 Supported-Values.................................................42
Table 15 - Printer Description Attributes returned from Get-Printer-
Supported-Values.................................................42
Expires: September 1, 2000 Expires: September 8, 2000
1 Introduction 1 Introduction
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 [ipp-mod, ipp-pro] focuses on end user technologies. IPP version 1.1 [ipp-mod, ipp-pro] 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 operations administrator Set-Job-Attributes and Set-Printer-Attributes operations
used to modify IPP Job objects and Printer objects. It also defines a used to modify IPP Job objects and Printer objects, respectively. It
third Get-Printer-Supported-Values operation that returns values that also defines a third Get-Printer-Supported-Values operation that returns
the IPP Printer will accept for setting its "xxx-supported" attributes. values that the IPP Printer will accept for setting its "xxx-supported"
The Get-Printer-Supported-Values operation MUST be supported, if the attributes. The Get-Printer-Supported-Values operation MUST be
Set-Printer-Attributes operation is supported. supported, if the implementation supports setting any "xxx-supported"
Printer attributes using the Set-Printer-Attributes operation.
Three out-of-band values are defined for use with these three
operations: 'delete-attribute' for deleting Job attributes with the
Set-Job-Attributes request, 'not-settable' for use in either the Set-
Job-Attributes or Set-Printer-Attributes responses, and 'any-value' for
use in the Get-Printer-Supported-Values response.
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.
These operation attributes may be used with any operation that affect
the Printer or Job object for which an operation might want to indicate
a message. For the Set-Job-Attributes and Set-Printer-Attributes
operations, the client MUST explicitly set them, rather than using these
operation attributes.
A Printer implementation can make the value of some attributes dependent
on the document-format, e.g. "resolution-supported".
This document is an extension to IPP/1.0 [RFC2565, RFC2566] and IPP/1.1 This document is an extension to IPP/1.0 [RFC2565, RFC2566] and IPP/1.1
[ipp-mod, ipp-pro], and future versions. [ipp-mod, ipp-pro], and future versions.
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 NOT, Capitalized terms, such as MUST, MUST NOT, REQUIRED, SHOULD, SHOULD NOT,
MAY, NEED NOT, and OPTIONAL, have special meaning relating to MAY, NEED NOT, and OPTIONAL, have special meaning relating to
conformance. These terms are defined in [ipp-mod] section 12.1 on conformance. These terms are defined in [ipp-mod] section 12.1 on
conformance terminology, most of which is taken from RFC 2119 [RFC2119]. conformance terminology, most of which is taken from RFC 2119 [RFC2119].
The following specialization of these terms apply to this document: The following specialization of these terms apply to this document:
REQUIRED: if an implementation supports the extensions described in REQUIRED: if an implementation supports the extensions described in
this document, it MUST support a REQUIRED feature. this document, it MUST support a REQUIRED feature.
Expires: September 8, 2000
OPTIONAL: if an implementation supports the extensions described in OPTIONAL: if an implementation supports the extensions described in
this document, it MAY support an OPTIONAL feature. this document, it MAY support an OPTIONAL feature.
2.2 Other terminology 2.2 Other terminology
This document uses terms such as Job object (or Job), IPP Printer object This document uses terms such as Job object (or Job), IPP Printer object
(or Printer), "operation", "request", response", "attributes", (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 [ipp-mod] section 12.2. The following defined in the model terminology [ipp-mod] section 12.2. The following
additional terms are introduced in this document: additional terms are introduced in this document:
READ-ONLY: used in an attribute definition to indicate that the READ-ONLY: used in an attribute definition to indicate that the
attribute MUST NOT be settable using an IPP protocol Set operation. attribute MUST NOT be settable using an IPP protocol Set operation.
In other words, the attribute is not settable by definition. In other words, the attribute is not settable by definition.
not-settable: an implementation does not support setting an not-settable: an implementation does not support setting an
attribute (whether or not the attribute's definition is READ-ONLY). attribute (whether or not the attribute's definition is READ-ONLY).
Expires: September 1, 2000
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 in 1.The end-user and the operator need a way to modify a Job that is in
the 'pending' or 'pending-held' state. the 'pending' or 'pending-held' state.
Usage: The end-user discovers that he/she forgot to include a print Usage: The end-user discovers that he/she forgot to include a print
instruction, such as "finishings" = 'staple' after submitting a job. instruction, such as "finishings" = 'staple' after submitting a job.
skipping to change at page 7, line 40 skipping to change at page 7, line 5
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 the operations list, such as Cancel-Job, because the policy is to run the
IPP Printer like a public facsimile machine. IPP Printer like a public facsimile machine.
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 [ipp-mod] attributes that have the out-of-band 'no-value' value (see [ipp-mod]
section 4.1) with the proper values. section 4.1) with the proper values.
Expires: September 8, 2000
The operator is changing the media loaded in the input tray and so is The operator is changing the media loaded in the input tray and so is
replacing the "media-ready" Job Template Printer attribute value with replacing the "media-ready" Job Template Printer attribute value with
the proper values 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) are The Set-Printer-Attributes operation (as are all Printer operations) are
directed at Printer objects. A client MUST always supply the "printer- directed at Printer objects. A client MUST always supply the "printer-
uri" operation attribute in order to identify the correct target of the uri" operation attribute in order to identify the correct target of the
operation. These descriptions assume all of the common semantics of operation. These descriptions assume all of the common semantics of
IPP/1.1 Model and Semantics document [ipp-mod] section 3.1. IPP/1.1 Model and Semantics document [ipp-mod] section 3.1.
The Set-Job-Attributes operation (as are all Job operations) are The Set-Job-Attributes operation (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 URI 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 [ipp-mod]. or a combination of a Printer URI with a Job ID as defined in [ipp-mod].
The IPP object implementation MUST support both forms of identification The IPP object implementation MUST support both forms of identification
Expires: September 1, 2000
for every job. If possible, a client SHOULD use the Printer URI with a 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 "job-id" is more readily Job ID rather than a Job URI, since the 32-bit "job-id" is more readily
translated to and from other print protocols that MAY be serving as translated to and from other print protocols that MAY be serving as
gateways into or out of the IPP implementation. gateways into or out of the IPP 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
skipping to change at page 8, line 40 skipping to change at page 8, line 5
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 attribute name keywords and values that are to be the set of Printer attribute name keywords and values that are to be
set. In the response, the Printer object returns success or rejects the set. In the response, the Printer object returns success or rejects the
entire request with indications of which attribute or attributes could entire request with indications of which attribute or attributes could
not be set. not be set.
The Printer object validates the client-supplied attributes in the Set- The Printer object validates the client-supplied attributes in the Set-
Printer-Attributes request. For an attribute to validate it MUST meet Printer-Attributes request. For an attribute to validate it MUST meet
all of the following rules: all of the following rules:
Expires: September 8, 2000
1. The number of attributes supplied by the client MUST NOT exceed the 1. The number of attributes supplied by the client MUST NOT exceed the
maximum number that the Printer supports in a Set-Printer- 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. If a Printer supports setting the three Attributes request.
"parallel" Printer Description attributes ("printer-uri-supported",
"uri-authentication-supported", and "uri-security-supported" (see
[ipp-mod] sections 4.4.1 through 4.4.3), then the Printer MUST
accept at least three attributes in a Set-Printer-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 READ-
ONLY). ONLY).
Expires: September 1, 2000
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. in Appendix A.
6. The attribute's values MUST NOT conflict with other Printer 6. The attribute's values MUST NOT conflict with other Printer
attribute, including ones being set in this same operation. attribute, including ones being set in this same operation.
If any of the supplied attributes does not validate, the Printer object If any of the supplied attributes does not validate, the Printer object
MUST reject the entire operation; the Printer object MUST NOT partially MUST reject the entire operation; the Printer object MUST NOT partially
skipping to change at page 9, line 43 skipping to change at page 9, line 5
ONLY "printer-message-date-time" attributes to the time of the operation ONLY "printer-message-date-time" attributes to the time of the operation
as a side effect . In particular, if this operation changes an "xxx- as a side effect . In particular, if this operation changes an "xxx-
default" attribute, the new value MUST be in the "xxx-supported" default" attribute, the new value MUST be in the "xxx-supported"
attribute or the request MUST contain a new value for "xxx-supported" attribute or the request MUST contain a new value for "xxx-supported"
which contains the new value for the "xxx-default". Otherwise, the which contains the new value for the "xxx-default". Otherwise, the
Printer MUST reject the operation. In general, Printer attribute Printer MUST reject the operation. In general, Printer attribute
definitions that are settable will not define side-effects on other definitions that are settable will not define side-effects on other
attributes that are settable, only side effects on READ-ONLY attributes, attributes that are settable, only side effects on READ-ONLY attributes,
if any. if any.
Expires: September 8, 2000
4.1.1Settable and READ-ONLY Printer Description attributes 4.1.1Settable 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 setting of:
all Job Template Default ("xxx-default") attributes all Job Template Default ("xxx-default") attributes
all Job Template Supported ("xxx-supported") attributes all Job Template Supported ("xxx-supported") attributes
all Job Template Ready ("xxx-ready") attributes all Job Template Ready ("xxx-ready") attributes
that the implementation supports (see [ipp-mod] section 4.2 and that the implementation supports (see [ipp-mod] section 4.2 and
extensions). extensions).
Some Printer Description attributes (see [ipp-mod] section 4.4) MUST NOT Some Printer Description attributes (see [ipp-mod] section 4.4) 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 Printer Description attribute table in marked as "READ-ONLY" in the Printer Description attribute table in
Appendix A is such an attribute. The Printer attributes that are not Appendix A is such an attribute. The Printer attributes that are not
Expires: September 1, 2000
marked as "READ-ONLY" MAY be settable using the Set-Printer-Attributes marked as "READ-ONLY" MAY be settable using the Set-Printer-Attributes
operation, depending on implementation. 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 including will indicate whether or not the attributes are READ-ONLY, by including
the "READ-ONLY" adjective in their descriptions and/or explicitly the "READ-ONLY" adjective in their descriptions and/or explicitly
stating whether they MAY be settable. stating whether they MAY be settable.
If "xxx-supported" Printer Description attribute are settable, then they If "xxx-supported" Printer Description attribute are settable, then they
MUST affect the behavior of the implementation. If they are READ-ONLY MUST affect the behavior of the implementation. If they are READ-ONLY
skipping to change at page 10, line 44 skipping to change at page 10, line 5
Access Rights: The authenticated user (see [ipp-mod] section 8.3) Access Rights: The authenticated user (see [ipp-mod] 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 [ipp-mod] Sections 1 and 8.5). Most Printer Printer object (see [ipp-mod] Sections 1 and 8.5). Most Printer
attributes will require administrator privileges to set, such as "xxx- attributes will require administrator privileges to set, such as "xxx-
supported", while some will require operator privileges only, such as supported", while some will require operator privileges only, such as
"media-ready" and "printer-message-from-operator". Which attributes "media-ready" and "printer-message-from-operator". Which attributes
require which privileges depends on implementation and MAY depend on require which privileges depends on implementation and MAY depend on
site policy. site policy.
Expires: September 8, 2000
4.1.2Set-Printer-Attributes Request 4.1.2Set-Printer-Attributes Request
The following sets of attributes are part of the Set-Printer-Attributes The following sets of attributes are part of the Set-Printer-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 [ipp-mod] section 3.1.4.1. attributes as described in [ipp-mod] section 3.1.4.1.
Target: Target:
The "printer-uri" (uri) operation attribute which is the target for The "printer-uri" (uri) operation attribute which is the target for
this operation as described in [ipp-mod] section 3.1.5. this operation as described in [ipp-mod] section 3.1.5.
Expires: September 1, 2000
Requesting User Name: Requesting User Name:
The "requesting-user-name" (name(MAX)) attribute SHOULD be supplied The "requesting-user-name" (name(MAX)) attribute SHOULD be supplied
by the client as described in [ipp-mod] section 8.3. by the client as described in [ipp-mod] section 8.3.
"document-format" (mimeMediaType): "document-format" (mimeMediaType):
The client OPTIONALLY supplies this attribute. The Printer object The client OPTIONALLY supplies this attribute. The Printer object
MUST support this attribute. This attribute is useful for a client MUST support this attribute. This attribute is useful for a client
to select the document-format to which the attribute modification to select the document-format to which the attribute modification
should be applied. A Printer implementation MAY allow some should be applied. A Printer implementation MAY allow some
attributes to have different values for each document format that attributes to have different values for each document format that
skipping to change at page 11, line 46 skipping to change at page 11, line 5
supported by the Printer, i.e., is not among the values of the supported by the Printer, i.e., is not among the values of the
Printer object's "document-format-supported" attribute, the Printer Printer object's "document-format-supported" attribute, the Printer
object MUST reject the operation and return the 'client-error- object MUST reject the operation and return the 'client-error-
document-format-not-supported' status code. Note: the document- document-format-not-supported' status code. Note: the document-
format 'application/octet-stream' is the union of several document- format 'application/octet-stream' is the union of several document-
formats (see [ipp-mod] section 3.2.5.1, Get-Printer-Attributes) and formats (see [ipp-mod] section 3.2.5.1, Get-Printer-Attributes) and
is not a true document-format. is not a true document-format.
Group 2: Printer Attributes Group 2: Printer Attributes
Expires: September 8, 2000
The client MUST supply a set of Printer attributes with one or more The client MUST supply a set of Printer attributes with one or more
values (including explicitly allowed out-of-band values) as defined values (including explicitly allowed out-of-band values) as defined
in [ipp-mod] section 4.2 Job Template Attributes ("xxx-default", in [ipp-mod] section 4.2 Job Template Attributes ("xxx-default",
"xxx-supported", and "xxx-ready" attributes), section 4.4 Printer "xxx-supported", and "xxx-ready" attributes), section 4.4 Printer
Description Attributes, and any attribute extensions supported by Description Attributes, and any attribute extensions supported by
the Printer. The value(s) of each Printer attribute supplied in the Printer. The value(s) of each Printer attribute supplied in
Group 2 replaces the value(s) of the corresponding Printer Group 2 replaces the value(s) of the corresponding Printer
attribute on the target Printer object. For attributes that can attribute on the target Printer object. For attributes that can
have multiple values (1setOf), all values supplied by the client have multiple values (1setOf), all values supplied by the client
replace all values of the corresponding Printer object attribute. replace all values of the corresponding Printer object attribute.
If a Printer object attribute had not been configured yet and so If a Printer object attribute had not been configured yet and so
had the 'no-value' out-of-band value (see [ipp-mod] section 4.1), had the 'no-value' out-of-band value (see [ipp-mod] section 4.1),
the supplied value(s) replace the 'no-value' value. the supplied value(s) replace the 'no-value' value.
Expires: September 1, 2000
4.1.3Set-Printer-Attributes Response 4.1.3Set-Printer-Attributes Response
The Printer object returns the following sets of attributes as part of The Printer object returns the following sets of attributes as part of
the Get-Printer-Attributes Response: 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 response, In addition to the REQUIRED status code returned in every response,
the response OPTIONALLY includes a "status-message" (text(255)) the response OPTIONALLY includes a "status-message" (text(255))
skipping to change at page 12, line 48 skipping to change at page 12, line 5
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-entity- Attributes request: return the 'client-error-request-entity-
too-large' (see [ipp-mod] section 13.1.4.9). too-large' (see [ipp-mod] 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 with the "out-of-band" value 'unsupported' (see attribute with the "out-of-band" value 'unsupported' (see
[ipp-mod] section 3.1.7 and [ipp-pro]) and the 'client-error- [ipp-mod] section 3.1.7 and [ipp-pro]) and the 'client-error-
attributes-or-values-not-supported (see [ipp-mod] section attributes-or-values-not-supported (see [ipp-mod] section
13.1.4.12). 13.1.4.12).
Expires: September 8, 2000
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 the "out-of-band" value 'not-settable' (see section 8.1) with the "out-of-band" value 'not-settable' (see section 8.1)
and the 'client-error-attributes-not-settable' status code and the 'client-error-attributes-not-settable' status code
(see section 7.1). (see 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 operation has a single value return it. If the attribute the operation has a single value return it. If the attribute
in the operation is multi-valued, return only those values in in the operation is multi-valued, return only those values in
a 1setOf that are not supported. Return the 'client-error- a 1setOf that are not supported. Return the 'client-error-
attributes-or-values-not-supported' status code (see [ipp-mod] attributes-or-values-not-supported' status code (see [ipp-mod]
section 13.1.4.12). section 13.1.4.12).
Expires: September 1, 2000
5. The values of some of the supplied attributes conflict with 5. The values of some of the supplied attributes conflict with
one another and/or other Printer attribute values not being one another and/or other Printer attribute values not being
set: if the conflicting attribute in the operation has a set: if the conflicting attribute in the operation has a
single value return the attribute and the value. If the single value return the attribute and the value. If the
attribute in the operation is multi-valued, return only the attribute in the operation is multi-valued, return only the
attribute and those values in a 1setOf that are conflicting attribute and those values in a 1setOf that are conflicting
with other attributes. Return the 'client-error-conflicting- with other attributes. Return the 'client-error-conflicting-
attributes' status code (see [ipp-mod] section 13.1.4.15). attributes' status code (see [ipp-mod] section 13.1.4.15).
4.2 Set-Job-Attributes Operation 4.2 Set-Job-Attributes Operation
skipping to change at page 13, line 46 skipping to change at page 13, line 4
supplying that attribute, the Printer adds the attribute to the Job supplying that attribute, the Printer adds the attribute to the Job
object. 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 the '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' value in semantic effect of the client supplying the 'delete-attribute' value in
a Set-Job-Attributes operation MUST be the same as if the attribute had a Set-Job-Attributes operation MUST be the same as if the attribute had
not been supplied with the Job object in the Job Creation operation, not been supplied with the Job object in the Job Creation operation,
i.e., the Printer applies its default attribute or behavior with lower i.e., the Printer applies its default attribute or behavior with lower
Expires: September 8, 2000
precedence that the PDL (see the beginning of [ipp-mod] section 4.2 and precedence that the PDL (see the beginning of [ipp-mod] section 4.2 and
[ipp-mod] 3.2.1.1). Any subsequent query of the Job object using Get- [ipp-mod] 3.2.1.1). Any subsequent query of the Job object using Get-
Job-Attributes or Get-Jobs MUST NOT return any attribute that has been Job-Attributes or Get-Jobs MUST NOT return any attribute that has been
deleted using the 'delete-attribute' out-of-band value. However, a deleted using the 'delete-attribute' out-of-band value. However, a
client can re-establish such a deleted Job attribute with any supported client can re-establish such a deleted Job attribute with any supported
value(s) using a subsequent Set-Job-Attributes operation. value(s) using a subsequent Set-Job-Attributes operation.
If the client supplies an attribute in a Set-Job-Attributes request with If the client supplies an attribute in a Set-Job-Attributes request with
the 'delete-attribute' value and that attribute is not present on the the 'delete-attribute' value and that attribute is not present on the
Job object, the Printer ignores that supplied attribute in the request, Job object, the Printer ignores that supplied attribute in the request,
does not return the attribute in the Unsupported Attributes group, and does not return the attribute in the Unsupported Attributes group, and
returns the 'successful-ok' status code, if there are no other problems returns the 'successful-ok' status code, if there are no other problems
with the request. with the request.
Expires: September 1, 2000
The validation of the Set-Job-Attributes request is performed by the The validation of the Set-Job-Attributes request is performed by the
Printer as if the job had been submitted originally with the new Printer as if the job had been submitted originally with the new
attribute values (and the deleted attributes removed) and with "ipp- attribute values (and the deleted attributes removed) and with "ipp-
attribute-fidelity" set to 'true', i.e., all modified attributes Job attribute-fidelity" set to 'true', i.e., all modified attributes Job
attributes and values MUST be supported in combination with the Job attributes and values MUST be supported in combination with the Job
attributes not modified. If such a Job Creation operation would have attributes not modified. If such a Job Creation operation would have
been accepted, then the Set-Job-Attributes MUST be accepted. If such a been accepted, then the Set-Job-Attributes MUST be accepted. If such a
Job Creation operation would have been rejected, then the Set-Job- Job Creation operation would have been rejected, then the Set-Job-
Attributes MUST be rejected and the Job MUST be unchanged. In addition, Attributes MUST be rejected and the Job MUST be unchanged. In addition,
if any of the supplied attributes are not supported, are not settable, if any of the supplied attributes are not supported, are not settable,
skipping to change at page 14, line 31 skipping to change at page 14, line 5
the Set-Job-Attributes an atomic operation. the Set-Job-Attributes an atomic operation.
The IPP object MUST accept or reject this operations when the Job's The IPP object MUST accept or reject this operations 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.
Expires: September 8, 2000
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 "job- New "job- IPP object's response status Current "job- New "job- IPP object's response status
state" state" code and action: state" state" code and action:
'pending' 'pending' 'successful-ok' 'pending' 'pending' 'successful-ok'
'pending' 'pending- 'successful-ok' - needed 'pending' 'pending-held' 'successful-ok' - needed
held' resources are not ready resources are not ready
'pending-held' 'pending- 'successful-ok' 'pending-held' 'pending-held' 'successful-ok'
held'
'pending-held' 'pending' 'successful-ok' - needed 'pending-held' 'pending' 'successful-ok' - needed
resources are ready resources are ready
'processing' 'processing' 'successful-ok' or 'client- 'processing' 'processing' 'successful-ok' or 'client-
error-not-possible' depending on error-not-possible' depending on
implementation, including the implementation, including the
attributes being set, whether attributes being set, whether
the job has started marking the job has started marking
media, etc. media, etc.
'processing- 'processing- 'successful-ok' or 'client- 'processing- 'processing- 'successful-ok' or 'client-
stopped' stopped' error-not-possible' depending on stopped' stopped' error-not-possible' depending on
implementation, including the implementation, including the
attributes being set, whether attributes being set, whether
the job has started marking the job has started marking
media, etc. media, 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'
Expires: September 1, 2000
This operation MUST NOT change the value of attributes not specified in This operation MUST NOT change the value of attributes not specified in
the operation unless the definition of the attribute explicitly the operation unless the definition of the attribute explicitly
specifies such side-effects. In general, Job attribute definitions that specifies such side-effects. In general, Job attribute definitions that
are settable will not define side-effects on other attributes that are are settable will not define side-effects on other attributes that are
settable, only side effects on READ-ONLY attributes, if any. settable, only side effects on READ-ONLY attributes, if any.
4.2.1Settable and READ-ONLY Job Description attributes 4.2.1Settable and READ-ONLY Job Description attributes
If the Printer supports the "job-message-from-operator" Job Description If the Printer supports the "job-message-from-operator" Job Description
attribute (see [ipp-mod] section 4.3.16) and the client explicitly attribute (see [ipp-mod] section 4.3.16) and the client explicitly
skipping to change at page 15, line 32 skipping to change at page 15, line 4
support setting of: support setting of:
all Job Template job ("xxx") attributes all Job Template job ("xxx") attributes
that the implementation supports (see [ipp-mod] section 4.2 and that the implementation supports (see [ipp-mod] section 4.2 and
extensions). extensions).
Some Job Description attributes (see [ipp-mod] section 4.3) MUST NOT be Some Job Description attributes (see [ipp-mod] section 4.3) MUST NOT be
settable, i.e., they are defined to be READ-ONLY. An attribute marked settable, i.e., they are defined to be READ-ONLY. An attribute marked
as "READ-ONLY" in the Job Description attribute table in Appendix A is as "READ-ONLY" in the Job Description attribute table in Appendix A is
Expires: September 8, 2000
such an attribute. The Job attributes not marked as "READ-ONLY" MAY be such an attribute. The Job attributes not marked as "READ-ONLY" MAY be
settable using the Set-Job-Attributes operation, depending on settable using the Set-Job-Attributes operation, depending on
implementation. 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 including will indicate whether or not the attributes are READ-ONLY, by including
the "READ-ONLY" adjective in their descriptions and/or explicitly the "READ-ONLY" adjective in their descriptions and/or explicitly
stating whether they MAY be settable. stating whether they MAY be settable.
Access Rights: The authenticated user (see [ipp-mod] section 8.3) Access Rights: The authenticated user (see [ipp-mod] section 8.3)
skipping to change at page 16, line 5 skipping to change at page 15, line 37
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 [ipp-mod] section 3.1.4.1. attributes as described in [ipp-mod] section 3.1.4.1.
Target: Target:
Either (1) the "printer-uri" (uri) plus "job-id" (integer(1:MAX)) Either (1) the "printer-uri" (uri) plus "job-id" (integer(1:MAX))
or (2) the "job-uri" (uri) operation attribute(s) which define the or (2) the "job-uri" (uri) operation attribute(s) which define the
target for this operation as described in [ipp-mod] section 3.1.5. target for this operation as described in [ipp-mod] section 3.1.5.
Expires: September 1, 2000
Requesting User Name: Requesting User Name:
The "requesting-user-name" (name(MAX)) attribute SHOULD be supplied The "requesting-user-name" (name(MAX)) attribute SHOULD be supplied
by the client as described in [ipp-mod] section 8.3. by the client as described in [ipp-mod] 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 defined values (including explicitly allowed out-of-band values) as defined
in [ipp-mod] section 4.2 Job Template Attributes ("xxx" in [ipp-mod] 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
skipping to change at page 16, line 27 skipping to change at page 16, line 5
each Job attribute supplied in Group 2 replaces the value(s) of the each Job attribute supplied in Group 2 replaces the value(s) of the
corresponding Job attribute on the target Job object. For 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 Job supplied by the client replace all values of the corresponding 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 MUST attribute' out-of-band value (see section 8.2), the Printer MUST
remove the "xxx" attribute from the Job object, if present. remove the "xxx" attribute from the Job object, if present.
Expires: September 8, 2000
4.2.3Set-Job-Attributes Response 4.2.3Set-Job-Attributes Response
The IPP object returns the following sets of attributes as part of the The IPP object returns the following sets of attributes as part of the
Set-Job-Attributes Response: 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 response, In addition to the REQUIRED status code returned in every response,
the response OPTIONALLY includes a "status-message" (text(255)) the response OPTIONALLY includes a "status-message" (text(255))
skipping to change at page 17, line 4 skipping to change at page 16, line 39
If some of the attributes in the operation fail to validate, the If some of the attributes in the operation fail to validate, the
Printer MUST reject the operation, MUST NOT change any Job Printer MUST reject the operation, MUST NOT change any Job
attributes, and MUST return the indicated status code below. In attributes, and MUST return the indicated status code below. In
this group, the Printer MUST also return all attributes that fail this group, the Printer MUST also return all attributes that fail
to validate. The following are the reasons that an attribute fails to validate. The following are the reasons that an attribute fails
to validate and the value returned for the attribute, along with to validate and the value returned for the attribute, along with
the indicated status code and order of detection: the indicated status 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-
Expires: September 1, 2000
Attributes request: return the 'client-error-request-entity- Attributes request: return the 'client-error-request-entity-
too-large' (see [ipp-mod] section 13.1.4.9). too-large' (see [ipp-mod] 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 with the "out-of-band" value 'unsupported' (see attribute with the "out-of-band" value 'unsupported' (see
[ipp-mod] section 3.1.7 and [ipp-pro]) and the 'client-error- [ipp-mod] section 3.1.7 and [ipp-pro]) and the 'client-error-
attributes-or-values-not-supported (see [ipp-mod] section attributes-or-values-not-supported (see [ipp-mod] section
13.1.4.12). 13.1.4.12).
3. The attribute is READ-ONLY (in its definition) or is not- 3. The attribute is READ-ONLY (in its definition) or is not-
skipping to change at page 17, line 28 skipping to change at page 17, line 5
the 'client-error-attributes-not-settable' status code (see the 'client-error-attributes-not-settable' status 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 operation has a single value return it. If the attribute the operation has a single value return it. If the attribute
in the operation is multi-valued, return only those values in in the operation is multi-valued, return only those values in
a 1setOf that are not supported. Return the 'client-error- a 1setOf that are not supported. Return the 'client-error-
attributes-or-values-not-supported' status code (see [ipp-mod] attributes-or-values-not-supported' status code (see [ipp-mod]
section 13.1.4.12). section 13.1.4.12).
Expires: September 8, 2000
5. The values of some of the supplied attributes conflict with 5. The values of some of the supplied attributes conflict with
one another and/or other Job attribute values not being set: one another and/or other Job attribute values not being set:
if the conflicting attribute in the operation has a single if the conflicting attribute in the operation has a single
value return the attribute and the value. If the attribute in value return the attribute and the value. If the attribute in
the operation is multi-valued, return only the attribute and the operation is multi-valued, return only the attribute and
those values in a 1setOf that are conflicting with other those values in a 1setOf that are conflicting with other
attributes. Return the 'client-error-conflicting-attributes' attributes. Return the 'client-error-conflicting-attributes'
status code (see [ipp-mod] section 13.1.4.15). status code (see [ipp-mod] section 13.1.4.15).
4.3 Get-Printer-Supported-Values Operation 4.3 Get-Printer-Supported-Values Operation
skipping to change at page 18, line 5 skipping to change at page 17, line 36
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 current value of 2. The Get-Printer-Attributes operation returns the current value of
specified attributes while the Get-Printer-Supported-Values specified attributes while the Get-Printer-Supported-Values
operation returns values that permit a client to determine what operation returns values that permit a client to determine what
values of "xxx-supported" attributes the Printer supports in the values of "xxx-supported" attributes the Printer supports in the
Set-Printer-Attributes operation. Set-Printer-Attributes operation.
Expires: September 1, 2000 3. If an implementation does not support setting an attribute that is
3. The Get-Printer-Supported-Values operation does not return any requested, it MUST NOT return that attribute in the Printer
Attributes Group of the Get-Printer-Supported-Values response.
Furthermore, in such a case, as in the Get-Printer-Attributes
response, the Unsupported Attributes Group of the response NEED NOT
contain the "requested-attributes" operation attribute with any
supplied values (attribute keywords) that were requested by the
client but are not supported or are not settable by the IPP
Printer.
4. The Get-Printer-Supported-Values operation does not return any
'name' attribute syntax values for any "xxx-supported" attributes. 'name' attribute syntax values for any "xxx-supported" attributes.
Instead, if the Set-Printer-Attributes operation will accept (any) Instead, if the Set-Printer-Attributes operation will accept (any)
name value for an "xxx-supported" attribute, then the Get-Printer- name value for an "xxx-supported" attribute, then the Get-Printer-
Supported-Values operation MUST return the 'any-value' out-of-band Supported-Values operation MUST return the 'any-value' out-of-band
attribute value with the 'name' attribute syntax (see section 8.3) attribute value with the 'name' attribute syntax (see section 8.3)
as one of the values of the "xxx-supported" attribute. In other as one of the values of the "xxx-supported" attribute. In other
words, the 'any-value' out-of-band attribute value used in words, the 'any-value' out-of-band attribute value used in
combination with the 'name' attribute syntax indicates that the combination with the 'name' attribute syntax indicates that the
Printer implementation supports clients setting 'name' attribute Printer implementation supports clients setting 'name' attribute
syntax values for "xxx-supported" attributes that are defined with syntax values for "xxx-supported" attributes that are defined with
the 'name' attribute syntax. the 'name' attribute syntax.
Expires: September 8, 2000
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, then several keywords as the value of the "media-supported" attribute, then
the Set-Printer-Attributes operation MUST accept any of these keywords the Set-Printer-Attributes operation MUST accept any of these keywords
as values for the "media-supported" attribute. If the Get-Printer- as values for the "media-supported" attribute. If the Get-Printer-
Supported-Values operation returns an 'any-value' out-of-band attribute Supported-Values operation returns an 'any-value' out-of-band attribute
value with the 'name' attribute syntax as one of the values of the value with the 'name' attribute syntax as one of the values of the
"media-supported" attribute, then the Set-Printer-Attributes operation "media-supported" attribute, then the Set-Printer-Attributes operation
MUST accept any value whose attribute syntax is 'name' as values for the MUST accept any value whose attribute syntax is 'name' as values for the
"media-supported" attribute. "media-supported" attribute.
skipping to change at page 19, line 5 skipping to change at page 18, line 42
See Appendix B for a full list of values returned by this operation. See Appendix B 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 IPP/1.1 This section defines new operation attributes for use with the IPP/1.1
operations indicated. As new operations are defined they will also operations indicated. As new operations are defined they will also
indicate explicitly whether these operation attributes are defined for indicate explicitly whether these operation attributes are defined for
use with them. use with them.
Expires: September 1, 2000
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 operations. The client OPTIONALLY supplies this attribute in the above operations.
The value of this attribute is a message from the operator about the The value of this attribute is a message from the operator about the
Printer object on which the operator is performing the operation. If Printer object on which the operator is performing the operation. If
this operation attribute is supported, the Printer copies the value to this operation attribute is supported, the Printer copies the value to
its "printer-message-from-operator" Printer Description attribute (see its "printer-message-from-operator" Printer Description attribute (see
[ipp-mod] section 4.4.25) even if this Operation attribute is a zero- [ipp-mod] section 4.4.25) even if this Operation attribute is a zero-
length text value or consists solely of white space. length text value or consists solely of white space.
Expires: September 8, 2000
If the Printer supports this operation attribute, it MUST support both a If the Printer supports this operation attribute, it MUST support both a
zero-length text value and the 'no-value' out-of-band value (see [ipp- zero-length text value and the 'no-value' out-of-band value (see [ipp-
mod] section 4.1) to indicate that the operator has sent no message. In mod] section 4.1) to indicate that the operator has sent no message. In
this case, the Printer sets the value of the "printer-message-from- this case, the Printer sets the value of the "printer-message-from-
operator" to the zero-length value or 'no-value' out-of-band value, operator" to the zero-length value or 'no-value' out-of-band value,
respectively. If the client queries the "printer-message-from-operator" respectively. If the client queries the "printer-message-from-operator"
Printer attribute, the Printer returns the attribute with the zero- Printer attribute, the Printer returns the attribute with the zero-
length value or the 'no-value' value, respectively. length value or the 'no-value' value, respectively.
In addition, the Printer automatically copies: In addition, the Printer automatically copies:
skipping to change at page 20, line 4 skipping to change at page 19, line 41
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-message- operation. If the operator wants to set the Printer's "printer-message-
from-operator" Printer Description attribute when issuing the Set- from-operator" Printer Description attribute when issuing the Set-
Printer-Attributes operation, the client supplies the "printer-message- Printer-Attributes operation, the client supplies the "printer-message-
from-operator" explicitly with its new value as one of the Printer from-operator" explicitly with its new value as one of the Printer
Description attributes in Group 2 in the request. The Printer also Description attributes in Group 2 in the request. The Printer also
updates its "printer-message-time" and "printer-message-date-time" updates its "printer-message-time" and "printer-message-date-time"
Printer Description attributes. If the client does not explicitly Printer Description attributes. If the client does not explicitly
supply the "printer-message-from-operator" with its new value in the supply the "printer-message-from-operator" with its new value in the
Set-Printer-Attributes request, the Printer leaves the value of the Set-Printer-Attributes request, the Printer leaves the value of the
Expires: September 1, 2000
Printer's "printer-message-from-operator" Printer Description attribute Printer's "printer-message-from-operator" Printer Description attribute
unchanged. 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-operator" operations if it supports the corresponding "job-message-from-operator"
Job Description attribute. 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 operations. The client OPTIONALLY supplies this attribute in the above operations.
The value of this attribute is a message from the operator about the Job The value of this attribute is a message from the operator about the Job
object on which the operator has just performed an operation. If object on which the operator has just performed an operation. If
supported, the Printer copies the value to the Job's "job-message-from- supported, the Printer copies the value to the Job's "job-message-from-
operator" Job Description attribute (see [ipp-mod] section 4.3.16) (even operator" Job Description attribute (see [ipp-mod] section 4.3.16) (even
Expires: September 8, 2000
if this Operation attribute is a zero-length text value or consists if this Operation attribute is a zero-length text value or consists
solely of white space). solely of white space).
If the Printer supports this operation attribute, it MUST support both a If the Printer supports this operation attribute, it MUST support both a
zero-length text value and the 'no-value' out-of-band value (see [ipp- zero-length text value and the 'no-value' out-of-band value (see [ipp-
mod] section 4.1) to indicate that the operator has sent no message. In mod] section 4.1) to indicate that the operator has sent no message. In
this case, the Printer sets the value of the "job-message-from-operator" this case, the Printer sets the value of the "job-message-from-operator"
to the zero-length value or 'no-value' out-of-band value, respectively. to the zero-length value or 'no-value' out-of-band value, respectively.
If the client queries the "job-message-from-operator" Job attribute, the If the client queries the "job-message-from-operator" Job attribute, the
IPP object returns the attribute with the zero-length value or the 'no- IPP object returns the attribute with the zero-length value or the 'no-
skipping to change at page 21, line 5 skipping to change at page 20, line 39
operator" Job Description attribute when issuing the Set-Job-Attributes operator" Job Description attribute when issuing the Set-Job-Attributes
operation, the client MUST supply the "job-message-from-operator" with operation, the client MUST supply the "job-message-from-operator" with
its new value as one of the Job Description attributes in Group 2 in the its new value as one of the Job Description attributes in Group 2 in the
request. Otherwise, the Printer leaves the value of the Job's "job- request. Otherwise, the Printer leaves the value of the Job's "job-
message-from-operator" Job Description attribute unchanged by not message-from-operator" Job Description attribute unchanged by not
explicitly setting the attribute. If the client does not explicitly explicitly setting the attribute. If the client does not explicitly
supply the "job-message-from-operator" with its new value in the Set- supply the "job-message-from-operator" with its new value in the Set-
Job-Attributes request, the Printer leaves the value of the Job's "job- Job-Attributes request, the Printer leaves the value of the Job's "job-
message-from-operator" Job Description attribute unchanged. message-from-operator" Job Description attribute unchanged.
Expires: September 1, 2000
6 New Printer Description Attributes 6 New Printer Description Attributes
The following new Printer Description attributes are needed to support The following new Printer Description attributes are needed to support
the new operations defined in this document. 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 object This REQUIRED READ-ONLY Printer attribute identifies the Printer object
attributes that are settable in this implementation, i.e., that are attributes that are settable in this implementation, i.e., that are
settable using the Set-Printer-Attributes operations (see section 4.1). settable using the Set-Printer-Attributes operations (see section 4.1).
This attribute MUST be supported if the Set-Printer-Attributes This attribute MUST be supported if the Set-Printer-Attributes
operations is supported. The Printer MUST reject attempts to set any operations is supported. The Printer MUST reject attempts to set any
Printer attributes that are not one of the values of this attribute, Printer 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). The value of this attribute MAY depend on the value of section 7.1). The value of this attribute MAY depend on the value of
the "document-format" operation attribute supplied in the Get-Printer- the "document-format" operation attribute supplied in the Get-Printer-
Attributes operation (see [ipp-mod] section 3.2.5.1). Attributes operation (see [ipp-mod] section 3.2.5.1).
Standard keyword values are: Standard keyword values are:
Expires: September 8, 2000
'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 by 'xxx': Where 'xxx' is any of the keyword attribute names allowed by
section 4.1.1 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 attribute identifies the Job object
attributes that are settable in this implementation, i.e., that are attributes that are settable in this implementation, i.e., that are
settable using the Set-Job-Attributes operation (see section 4.2). This settable using the Set-Job-Attributes operation (see section 4.2). This
attribute MUST be supported if the Set-Job-Attributes operations is attribute MUST be supported if the Set-Job-Attributes operations is
skipping to change at page 22, line 4 skipping to change at page 21, line 38
This OPTIONAL READ-ONLY Printer Description attribute contains a set of This OPTIONAL READ-ONLY Printer Description attribute contains a set of
attribute name keywords. This attribute SHOULD be supported by a attribute name keywords. This attribute SHOULD be supported by a
Printer object, if the Printer object has Printer attributes whose value Printer object, if the Printer object has Printer attributes whose value
vary depending on document format (see [ipp-mod] Get-Printer-Attributes vary depending on document format (see [ipp-mod] Get-Printer-Attributes
operation). This attribute specifies which attribute values can vary by operation). This attribute specifies which attribute values can vary by
document-format. If an attribute's name "xxx" is a member of this document-format. If an attribute's name "xxx" is a member of this
attribute and the value of attribute "xxx" is changed with the Set- attribute and the value of attribute "xxx" is changed with the Set-
Printer-Attributes operation that included the "document-format" Printer-Attributes operation that included the "document-format"
operation attribute, then the Printer MUST change the value for the operation attribute, then the Printer MUST change the value for the
specified document format and no other document formats (see section specified document format and no other document formats (see section
Expires: September 1, 2000
4.1.2). If an attribute's name "xxx" is not a member of this attribute 4.1.2). If an attribute's name "xxx" is not a member of this attribute
and the value of attribute "xxx" is changed with the Set-Printer- and the value of attribute "xxx" is changed with the Set-Printer-
Attributes operation, then the attribute is changed for all document Attributes operation, then the attribute is changed for all document
formats (whether or not the client supplied the "document-format" formats (whether or not the client supplied the "document-format"
operation attribute). 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 time This OPTIONAL READ-ONLY Printer Description attribute contains the time
that the Printer's "printer-message-from-operator" was changed by the that the Printer's "printer-message-from-operator" was changed by the
operator using any operation where the client supplied the "printer- operator using any operation where the client supplied the "printer-
message-from-operator" operation attribute (see section 5.1) or was message-from-operator" operation attribute (see section 5.1) or was
explicitly set using the Set-Printer-Attributes operation (see section explicitly set using the Set-Printer-Attributes operation (see section
4.1). This attribute allows the users to know when the "printer- 4.1). This attribute allows the users to know when the "printer-
message-from-operator" attribute was last set. message-from-operator" attribute was last set.
The Printer sets the value of this attribute by copying the value of the The Printer sets the value of this attribute by copying the value of the
Printer's "printer-up-time" attribute (see [ipp-mod] section 4.3.14). Printer's "printer-up-time" attribute (see [ipp-mod] section 4.3.14).
If the Printer resets its "printer-up-time" attribute to 1 on power-up, If the Printer resets its "printer-up-time" attribute to 1 on power-up,
Expires: September 8, 2000
then it MUST change the value of the "printer-message-time" to 0 or a then it MUST change the value of the "printer-message-time" to 0 or a
negative number as specified in [ipp-mod] section 4.3.14. negative number as specified in [ipp-mod] section 4.3.14.
Note: This attribute helps users better understand the context for the Note: This attribute helps users better understand the context for the
"printer-message-from-operator" message. "printer-message-from-operator" message.
6.5 printer-message-date-time (dateTime) 6.5 printer-message-date-time (dateTime)
This READ-ONLY Printer Description attribute contains the date and time This OPTIONAL READ-ONLY Printer Description attribute contains the date
that the Printer's "printer-message-from-operator" was changed by the and time that the Printer's "printer-message-from-operator" was changed
operator using any operation where the client supplied the "printer- by the operator using any operation where the client supplied the
message-from-operator" operation attribute (see section 5.1) or was "printer-message-from-operator" operation attribute (see section 5.1) or
explicitly set using the Set-Printer-Attributes operation (see section was explicitly set using the Set-Printer-Attributes operation (see
4.1). This attribute allows the users to know when the "printer- section 4.1). This attribute allows the users to know when the
message-from-operator" attribute was last set. "printer-message-from-operator" 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 [ipp-mod] section 4.4.30). attributes (see [ipp-mod] section 4.4.30).
Note: This attribute helps users better understand the context for the Note: This attribute helps users better understand the context for the
"printer-message-from-operator" message. "printer-message-from-operator" message.
6.6 printer-xri-supported (1setOf collection)
This OPTIONAL Printer Description attribute is a multi-valued attribute
where each value has the 'collection' attribute syntax (see [ipp-coll])
containing member attributes with the same semantics as the following
IPP/1.1 READ-ONLY Printer Description attributes, except for
cardinality:
printer-uri-supported (1setOf uri) - see [ipp-mod] section 4.4.1
uri-authentication-supported (1setOf type2 keyword) - see [ipp-mod]
section 4.4.2
uri-security-supported (1setOf type2 keyword) - see [ipp-mod]
section 4.4.3
When setting the "printer-xri-supported" attribute with a Set-Printer-
Attributes request, the Printer MUST also set these three IPP/1.1 READ-
ONLY Printer Description attributes as a defined side effect. Thus,
this collection attribute provides the means to guarantee that these
three IPP/1.1 READ-ONLY attributes are always set together, thereby
never leaving these three attributes in a partially inconsistent state.
The member attributes of the "printer-xri-supported" (1setOf collection)
are given in Table 3.
Table 3 - Member attributes of "printer-xri-supported" (1setOf
collection)
Member attribute client Printer
MUST MUST
Expires: September 8, 2000
supply support
xri-uri (uri) yes yes
xri-authentication (1setOf type2 keyword) yes yes
xri-security (1setOf type2 keyword) yes yes
Each collection value MUST contain a single unique value for the "xri-
uri" member attribute. However, the other two member attributes are
multi-valued, so that a single URI can support more than one
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 [ipp-mod] sections 4.4.1, 4.4.2, and
4.4.3, respectively.
A client can query the current values by supplying in a Get-Printer-
Attributes request either:
1. the three IPP/1.1 attribute names: "printer-uri-supported", "uri-
authentication-supported", "uri-security-supported" and getting
back the parallel values OR
2. the single attribute name: "printer-xri-supported" and getting back
the 1setOf collection which contains the same information
semantically, but in a different form.
A client can query what member attribute values can be set by supplying
the two attribute names: "xri-authentication-supported" and "xri-
security-supported" in a Get-Printer-Supported-Values request and
getting back the 1setOf type2 keyword values that can be set. Since the
"printer-xri-supported", "uri-authentication-supported", and "uri-
security-supported" attributes are READ-ONLY, they are not queriable
with Get-Printer-Supported-Values operation (see section 4.3). See
Table 13.
When performing a Set-Printer-Attributes operation, if there are
multiple values for the "printer-xri-supported-authentication" and/or
"printer-xri-supported-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-uri" = ipp://abc.com/p1
"printer-xri-supported-authentication" = basic, digest
"printer-xri-supported-security" = tls
},
{ "printer-xri-supported-uri" = http://abc.com/pq
"printer-xri-supported-authentication" = none
"printer-xri-supported-security" = none
}
Expires: September 8, 2000
would cause the Printer to set the three corresponding IPP/1.1 READ-ONLY
attributes, each with three parallel values as follows:
"printer-uri-supported" = { ipp://abc.com/p1, ipp://abc.com/p1,
http://abc.com/pq }
"uri-authentication-supported" = { basic, digest, 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.
Note: The "xri-printer-supported" (1setOf collection) attribute can be
put into a directory schema that requires a single text string value,
such as SLP or LDPA, by using suitable delimiting characters to separate
member attributes and/or terminating collection values. See [svrloc-
printer] and [ldap-printer].
7 Additional status codes 7 Additional status codes
This section defines new status codes used by the operations defined in This section defines new status codes used by the operations defined in
this document. this document.
Expires: September 1, 2000
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 not 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), the settable in this implementation (see sections 4.1.3 and 4.2.3), the
Printer MUST return this error code and the attribute keyword name(s) 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 the and the 'not-settable' out-of-band value (see section 8.1) in the
Unsupported Attributes Group(see [ipp-mod] section 3.1.7) for all of the Unsupported Attributes Group(see [ipp-mod] section 3.1.7) for all of the
attributes that could not be set. When the Printer returns this status, attributes that could not be set. When the Printer returns this status,
it MUST NOT change any of the attributes supplied in the operation. it MUST NOT change any of the attributes 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-of- This section defines additional out-of-band values. As with all out-of-
band values, a client or a Printer MUST NOT use an out-of-band value 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 and/or unless the definition of the attribute in an operation request and/or
response explicitly allows such usage. See the beginning of [ipp-mod] response explicitly allows such usage. See the beginning of [ipp-mod]
section 4.1. section 4.1.
Expires: September 8, 2000
8.1 'not-settable' out-of-band value 8.1 'not-settable' out-of-band value
The 'not-settable' out-of-band value is used by the IPP Printer in the The 'not-settable' out-of-band value is used by the IPP Printer in the
Unsupported Attributes group of a Set-Job-Attributes or Set-Printer- Unsupported Attributes group of a Set-Job-Attributes or Set-Printer-
Attributes response to indicate that an attribute (supplied by the Attributes response to indicate that an attribute (supplied by the
client) is READ-ONLY by definition or is not settable in this client) is READ-ONLY by definition or is not settable in this
implementation (see sections 4.1.3 and 4.2.3). implementation (see sections 4.1.3 and 4.2.3).
See sections 4.1.3 and 4.2.3 in this document for an example definition See sections 4.1.3 and 4.2.3 in this document for an example definition
of the usage of the 'not-settable' out-of-band value in the Set-Printer- of the usage of the 'not-settable' out-of-band value in the Set-Printer-
skipping to change at page 24, line 4 skipping to change at page 25, line 36
The 'delete-attribute' out-of-band value is supplied by the client in The 'delete-attribute' out-of-band value is supplied by the client in
the Set-Job-Attributes request to indicate that the Printer is to remove the Set-Job-Attributes request to indicate that the Printer is to remove
the supplied attribute and all of its values from the Job object, if the supplied attribute and all of its values from the Job object, if
present (see section 4.2). present (see section 4.2).
The 'delete-attribute' out-of-band value is defined for use with the The 'delete-attribute' out-of-band value is defined for use with the
Set-Job-Attributes only. Clients MUST NOT supply and IPP objects MUST Set-Job-Attributes only. Clients MUST NOT supply and IPP objects MUST
NOT support the 'delete-attribute' out-of-band value in other NOT support the 'delete-attribute' out-of-band value in other
operations, such as the Set-Printer-Attributes operation, where the operations, such as the Set-Printer-Attributes operation, where the
absence of an attribute from an IPP object indicates that the attribute absence of an attribute from an IPP object indicates that the attribute
Expires: September 1, 2000
is not supported. If a Printer receives this out-of-band value in other is not supported. If a Printer receives this out-of-band value in other
operations, the Printer MUST reject the entire request and return the operations, the Printer MUST reject the entire request and return the
'client-error-bad-request' status code and not process any of the other 'client-error-bad-request' status code and not process any of the other
supplied attributes. supplied attributes.
See section 4.2 in this document for an example definition of the usage See section 4.2 in this document for an example definition of the usage
of the 'delete-attribute' out-of-band value in the Set-Job-Attributes of the 'delete-attribute' out-of-band value in the Set-Job-Attributes
request. request.
8.2.1Encoding of the 'delete-attribute' out-of-band value 8.2.1Encoding 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
[ipp-pro]). [ipp-pro]).
8.3 'any-value' out-of-band attribute value 8.3 'any-value' out-of-band attribute value
The 'any-value' out-of-band attribute value MAY be used in combination The 'any-value' out-of-band attribute value MAY be used in combination
with an attribute syntax to represent "any" attribute value of that with an attribute syntax to represent "any" attribute value of that
attribute syntax. attribute syntax.
Expires: September 8, 2000
See section 4.3 in this document for an example definition of the usage See section 4.3 in this document for an example definition of the usage
of the 'any-value' out-of-band attribute value with the 'name' attribute of the 'any-value' out-of-band attribute value with the 'name' attribute
syntax in any "xxx-supported" attribute returned in a Get-Printer- syntax in any "xxx-supported" attribute returned in a Get-Printer-
Supported-Values response. Supported-Values response.
8.3.1Encoding of the 'any-value' out-of-band attribute value 8.3.1Encoding of the 'any-value' out-of-band attribute value
The encoding of the 'any-value' out-of-band attribute value is 0x17 (see The encoding of the 'any-value' out-of-band attribute value is 0x17 (see
[ipp-pro]). This out-of-band value REQUIRES a non-zero length and an [ipp-pro]). This out-of-band value REQUIRES a non-zero length and an
attribute value which identifies an attribute syntax type. The attribute value which identifies an attribute syntax type. The
attribute value is either (1) a one-octet attribute syntax tag as attribute value is either (1) a one-octet attribute syntax tag as
defined in [ipp-pro] (value length = 1) or (2) a 0x7F code followed by a defined in [ipp-pro] (value length = 1) or (2) a 0x7F code followed by a
4-octets of an extended attribute syntax type code as allocated in [ipp- 4-octets of an extended attribute syntax type code as allocated in [ipp-
pro] (value length = 5). pro] (value length = 5).
ISSUE 01 - Ok to define the 'any-value' out-of-band value to have an
actual value, consisting of the attribute syntax code?
9 Conformance Requirements 9 Conformance Requirements
This section specifies the conformance requirements for clients and IPP This section specifies the conformance requirements for clients and IPP
objects. 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 supported. Either one MAY be supported without the other or both MAY be supported.
However, if the Set-Printer-Attributes operation is supported, then the However, if the Set-Printer-Attributes operation is supported, then the
Get-Printer-Supported-Values operation MUST be supported if any "xxx- Get-Printer-Supported-Values operation MUST be supported if any "xxx-
Expires: September 1, 2000
supported" attributes are settable. Otherwise, the Get-Printer- supported" attributes are settable. Otherwise, the Get-Printer-
Supported-Values operation is OPTIONAL for an IPP Printer to support. Supported-Values operation is OPTIONAL for an IPP Printer to support.
If the Set-Printer-Attributes operation is supported, then the Printer If the Set-Printer-Attributes operation is supported, then the Printer
MUST support the following additional items: 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
skipping to change at page 25, line 31 skipping to change at page 27, line 5
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 "printer-message-from-operator" Printer Description attribute
is supported (see [ipp-mod] section 4.4.25), then it MUST be is supported (see [ipp-mod] section 4.4.25), then it MUST be
settable. settable.
6.the Get-Printer-Supported-Values operation (see section 4.3), if 6.the Get-Printer-Supported-Values operation (see section 4.3), if
any "xxx-supported" attributes are settable. any "xxx-supported" attributes are settable.
Expires: September 8, 2000
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 for
one or more "xxx-supported" attributes, then the 'any-value' one or more "xxx-supported" attributes, then the 'any-value'
out-of-band attribute value (see section 8.3) MUST be supported out-of-band attribute value (see section 8.3) MUST be supported
in the Get-Printer-Supported-Values response with the 'name' in the Get-Printer-Supported-Values response with the 'name'
attribute syntax for each such settable attribute (see section attribute syntax for each such settable attribute (see section
4.3) 4.3)
If the Set-Job-Attributes operation is supported, then the Printer MUST If the Set-Job-Attributes operation is supported, then the Printer MUST
support the following additional items: support the following additional items:
skipping to change at page 26, line 5 skipping to change at page 27, line 37
5.If the "job-message-from-operator" Printer Description attribute 5.If the "job-message-from-operator" Printer Description attribute
is supported (see [ipp-mod] 4.3.16), then it MUST be settable. is supported (see [ipp-mod] 4.3.16), then it MUST be settable.
It is OPTIONAL for the Printer object to support the "printer-message- It is OPTIONAL for the Printer object to support the "printer-message-
time" (integer) and "printer-message-date-time" (dateTime) Printer time" (integer) and "printer-message-date-time" (dateTime) Printer
Description attributes. If both the "printer-message-time" (integer) Description attributes. If both the "printer-message-time" (integer)
and the "printer-current-time" (dateTime) (see [ipp-mod] section 4.4.30) and the "printer-current-time" (dateTime) (see [ipp-mod] section 4.4.30)
attributes are supported, then the "printer-message-date-time" attributes are supported, then the "printer-message-date-time"
(dateTime) Printer Description attribute MUST be supported. (dateTime) Printer Description attribute MUST be supported.
Expires: September 1, 2000
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 of the attribute in an operation out-of-band value unless the definition of the attribute in an operation
request and/or response explicitly allows such usage. request and/or response explicitly allows such usage.
10 IANA Considerations 10 IANA Considerations
Since this document is intended to be a standards track document, there Since this document is intended to be a standards track document, there
is no need to also register the operations, attributes, status codes, is no need to also register the operations, attributes, status codes,
and out-of-band values defined here-in with IANA according to the and out-of-band values defined here-in with IANA according to the
procedures in RFC 2566 [rfc2566] section 6. However, other registration procedures in RFC 2566 [rfc2566] section 6. However, other registration
proposals may site the out-of-band attribute values or the status codes proposals may site the out-of-band attribute values or the status codes
defined in this document. defined in this document.
11 Internationalization Considerations 11 Internationalization Considerations
This document has the same localization considerations as the [ipp-mod]. This document has the same localization considerations as the [ipp-mod].
Expires: September 8, 2000
12 Security Considerations 12 Security Considerations
The IPP Model and Semantics document [ipp-mod section 8] discusses high The IPP Model and Semantics document [ipp-mod section 8] discusses high
level security requirements (Client Authentication, Server 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. Operation server proves its identity to the client in a secure manner. Operation
Privacy is defined as a mechanism for protecting operations from Privacy is defined as a mechanism for protecting operations from
eavesdropping. eavesdropping.
skipping to change at page 27, line 5 skipping to change at page 28, line 40
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 Printer attributes is to have strong Client Authentication coupled with Printer
access control to limit the users who have System Administrator or access control to limit the users who have System Administrator or
Operator privileges. 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.
Expires: September 1, 2000 The general remedy for such malicious user actions against another
user's job is to have strong Client Authentication coupled with Printer
access control to limit the users who have System Administrator or
Operator privileges who can modify any job and, in addition, store the
Client Authentication with each Job so that only the job owner End User
can modify his/her own job.
13 The general remedy for such malicious user actions against another 13 Author's Addresses
user's job is to have strong Client Authentication coupled with
Printer access control to limit the users who have System
Administrator or Operator privileges who can modify any job and, in
addition, store the Client Authentication with each Job so that only
the job owner End User can modify his/her own job.Author's Addresses
Carl Kugler Carl Kugler
IBM IBM
P.O. Box 1900 P.O. Box 1900
Boulder, CO 80301-9191 Boulder, CO 80301-9191
Phone: (303) 924-5060 Phone: (303) 924-5060
FAX: FAX:
e-mail: kugler@us.ibm.com e-mail: kugler@us.ibm.com
Tom Hastings Tom Hastings
Expires: September 8, 2000
Xerox Corporation Xerox Corporation
737 Hawaii St. ESAE 231 737 Hawaii St. ESAE 231
El Segundo, CA 90245 El Segundo, CA 90245
Phone: 310-333-6413 Phone: 310-333-6413
Fax: 310-333-5514 Fax: 310-333-5514
e-mail: hastings@cp10.es.xerox.com e-mail: hastings@cp10.es.xerox.com
Robert Herriot Robert Herriot
Xerox Corp. Xerox Corp.
skipping to change at page 27, line 52 skipping to change at page 29, line 34
IBM IBM
P.O. Box 1900 P.O. Box 1900
Boulder, CO 80301-9191 Boulder, CO 80301-9191
Phone: (303) 924-5337 Phone: (303) 924-5337
FAX: FAX:
e-mail: harryl@us.ibm.com e-mail: harryl@us.ibm.com
14 References 14 References
[ipp-coll]
deBry, R., , Hastings, T., Herriot, R., "Internet Printing Protocol
(IPP): The Collection Attribute Syntax", <draft-ietf-ipp-
collection-02.doc>, work in progress, March 9, 2000.
[ipp-mod] [ipp-mod]
R. deBry, T. Hastings, R. Herriot, S. Isaacson, P. Powell, R. deBry, T. Hastings, R. Herriot, S. Isaacson, P. Powell,
"Internet Printing Protocol/1.0: Model and Semantics", <draft-ietf- "Internet Printing Protocol/1.0: Model and Semantics", <draft-ietf-
ipp-model-v11-06.txt>, March 1, 2000. ipp-model-v11-06.txt>, March 1, 2000.
Expires: September 1, 2000
[ipp-pro] [ipp-pro]
Herriot, R., Butler, S., Moore, P., Tuner, R., "Internet Printing Herriot, R., Butler, S., Moore, P., Tuner, R., "Internet Printing
Protocol/1.1: Encoding and Transport", draft-ietf-ipp-protocol-v11- Protocol/1.1: Encoding and Transport", draft-ietf-ipp-protocol-v11-
05.txt, March 1, 2000. 05.txt, March 1, 2000.
[ipp-set2] [ipp-set2]
Kugler, C, Hastings, T., Lewis, H., "Internet Printing Kugler, C, Hastings, T., Lewis, H., "Internet Printing
Protocol/1.1: Job and Printer Administrative Operations", <draft- Protocol/1.1: Job and Printer Administrative Operations", <draft-
ietf-ipp-ops-set2-01.txt>, December 8, 1999. ietf-ipp-ops-set2-01.txt>, December 8, 1999.
[ldap-printer]
Fleming, P., Jones, K., Lewis, H., McDonald, I., "Internet Printing
Protocol (IPP): LDAP Schema for Printer Services", <draft-ietf-ipp-
ldap-printer-schema-00.txt>, work in progress, March 8, 2000.
Expires: September 8, 2000
[RFC2565] [RFC2565]
Herriot, R., Butler, S., Moore, P., Tuner, R., "Internet Printing Herriot, R., Butler, S., Moore, P., Tuner, R., "Internet Printing
Protocol/1.0: Encoding and Transport", RFC 2565, April 1999. Protocol/1.0: Encoding and Transport", RFC 2565, April 1999.
[RFC2566] [RFC2566]
R. deBry, T. Hastings, R. Herriot, S. Isaacson, P. Powell, R. deBry, T. Hastings, R. Herriot, S. Isaacson, P. Powell,
"Internet Printing Protocol/1.0: Model and Semantics", RFC 2566, "Internet Printing Protocol/1.0: Model and Semantics", RFC 2566,
April 1999. April 1999.
[svrloc-printer]
St. Pierre, P., Isaacson, S., McDonald, I., "Definition of the
Printer Abstract Service Type v2.0", <draft-ietf-svrloc-printer-
scheme-06.txt>, work in progress, March 8, 2000.
15 Change History 15 Change History
This section summarizes the changes. Each sub-section is in reverse This section summarizes the changes. Each sub-section is in reverse
chronological order. Adding or removing ISSUES that don't change the chronological order. Adding or removing ISSUES that don't change the
document are not listed here. document are not listed here.
15.1Changes to the January 30, 2000 version to make the March 1, 2000 15.1Changes to the March 1, 2000 version to make the March 8, 2000
version
The following changes have been made to the March 1, 2000 version to
make the March 8, 2000 version as a result of the IPP WG telecons and
mailing list discussion:
1.Added the "printer-xri-supported" (1setOf collection) attribute so
that the three parallel IPP/1.1 "printer-uri-supported", "uri-
authentication-supported", and "uri-security-supported" attributes
could be set as one atomic attribute. Consequently, changed the
three parallel attributes to be READ-ONLY and removed the requirement
that three attributes MUST be set in a single request if the three
parallel IPP/1.1 "printer-uri-supported", "uri-authentication-
supported", and "uri-security-supported" were settable.
2.Clarified Get-Printer-Supported-Values so that if an implementation
does not support setting a settable attribute, it MUST NOT return the
attribute in the Printer Attribute group and it NEED NOT return the
attribute in the Unsupported Attributes group, same as in a Get-
Printer-Attributes response for unsupported attributes. Same
clarification when unsupported attributes are requested.
3.Fixed "printer-message-date-time" (dateTime) attribute to be
OPTIONAL.
4.Added note as to why the "printer-current-time" Printer Description
attribute is settable (to fix an incorrect time or time zone).
Expires: September 8, 2000
5.Added "xri-authentication-supported" (1setOf type2 keyword) and "xri-
security-supported" (1setOf type2 keyword) attributes to the table of
attributes that can be queried with Get-Printer-Supported-Values.
Added a note that these two attributes are NOT queriable with Get-
Printer-Attributes, since the client queries either (1) the three
"printer-uri-supported" (1setOf uri), "uri-authentication-supported"
(1setOf type2 keyword), "uri-security-supported" (1setOf type2
keyword) attributes, or (2) the single "printer-xri-supported"
(1setOf collection) attribute.
15.2Changes to the January 30, 2000 version to make the March 1, 2000
version version
The following changes to the January 30, 2000 version to make the March The following changes to the January 30, 2000 version to make the March
1, 2000 version as a result of the IPP WG telecons and mailing list 1, 2000 version as a result of the IPP WG telecons and mailing list
discussion: discussion:
1.Clarified that this extension may be used with any IPP version, 1.Clarified that this extension may be used with any IPP version,
including 1.0, 1.1, and future versions. including 1.0, 1.1, and future versions.
2.Added "READ-ONLY" and "not-settable" terms to the terminology 2.Added "READ-ONLY" and "not-settable" terms to the terminology
skipping to change at page 29, line 5 skipping to change at page 31, line 43
Get-Printer-Supported-Values operations. Get-Printer-Supported-Values operations.
4.Clarified that the Set-Printer-Attributes operation while a Printer 4.Clarified that the Set-Printer-Attributes operation while a Printer
SHOULD accept a reasonable number of attribute, the Printer need only SHOULD accept a reasonable number of attribute, the Printer need only
support setting one attribute in a request, unless it supports support setting one attribute in a request, unless it supports
setting the three "parallel" attributes, ("printer-uri-supported", setting the three "parallel" attributes, ("printer-uri-supported",
"uri-authentication-supported", and "uri-security-supported" (see "uri-authentication-supported", and "uri-security-supported" (see
[ipp-mod] sections 4.4.1 through 4.4.3), in which case it MUST [ipp-mod] sections 4.4.1 through 4.4.3), in which case it MUST
support setting at least three attributes in a single request. support setting at least three attributes in a single request.
Expires: September 1, 2000
5.Clarified that for the Set-Printer-Attributes operation the Printer 5.Clarified that for the Set-Printer-Attributes operation the Printer
MUST validate all of the supplied attributes in combination with each MUST validate all of the supplied attributes in combination with each
other, as well as with all of the existing attribute of the Printer other, as well as with all of the existing attribute of the Printer
object Set-Printer-Attributes. object Set-Printer-Attributes.
6.Changed the requirements for accepting the Set-Printer-Attributes 6.Changed the requirements for accepting the Set-Printer-Attributes
operation when the Printer is in the 'stopped' state from MUST to operation when the Printer is in the 'stopped' state from MUST to
SHOULD, since some implementations may not be able to accept requests SHOULD, since some implementations may not be able to accept requests
when stopped. when stopped.
7.Clarified that setting certain Printer attributes with Set-Printer- 7.Clarified that setting certain Printer attributes with Set-Printer-
Attributes MAY require more access rights than other attributes, Attributes MAY require more access rights than other attributes,
i.e., System Administrator rights to set policy and only Operator i.e., System Administrator rights to set policy and only Operator
rights to set the configuration attributes to reflect the current rights to set the configuration attributes to reflect the current
hardware setup. hardware setup.
Expires: September 8, 2000
8.Clarified the order of error checking and what is returned in each 8.Clarified the order of error checking and what is returned in each
case in the Set-Printer-Attributes response. case in the Set-Printer-Attributes response.
9.Changed the 'default' out-of-band value to 'delete-attribute' out-of- 9.Changed the 'default' out-of-band value to 'delete-attribute' out-of-
band value so that the effect is to actually remove the Job attribute band value so that the effect is to actually remove the Job attribute
entirely in the Set-Job-Attribute operation. entirely in the Set-Job-Attribute operation.
10. Clarified that removing a Job attribute that is not present is not 10. Clarified that removing a Job attribute that is not present is not
an error. an error.
skipping to change at page 30, line 5 skipping to change at page 32, line 45
supported" Printer attributes. supported" Printer attributes.
15. Changed the IANA Considerations to indicate that the operations, 15. Changed the IANA Considerations to indicate that the operations,
attributes, status codes, and out-of-band-values won't be registered attributes, status codes, and out-of-band-values won't be registered
and published by IANA, since this document is intended to be and published by IANA, since this document is intended to be
standards track. standards track.
16. Added security considerations for denial of service and sabotage 16. Added security considerations for denial of service and sabotage
because of the Set operations. because of the Set operations.
Expires: September 1, 2000 15.3Changes to the January 20, 2000 version to make the January 30, 2000
15.2Changes to the January 20, 2000 version to make the January 30, 2000
version version
The following changes to the January 20, 2000 version to make the The following changes to the January 20, 2000 version to make the
January 30, 2000 version as a result of the IPP WG telecons and mailing January 30, 2000 version as a result of the IPP WG telecons and mailing
list discussion: list discussion:
1.Deleted the "document-format-varying-scope" operation attribute from 1.Deleted the "document-format-varying-scope" operation attribute from
the Set-Printer-Attributes operation and made whether or not the the Set-Printer-Attributes operation and made whether or not the
"document-format" operation was present determine whether one or all "document-format" operation was present determine whether one or all
document formats are affected, respectively. document formats are affected, respectively.
2.Renamed the Get-Reset-Printer-Attributes operation to Get-Printer- 2.Renamed the Get-Reset-Printer-Attributes operation to Get-Printer-
Supported-Values, so that it only returns "xxx-supported" values. Supported-Values, so that it only returns "xxx-supported" values.
Expires: September 8, 2000
Relegate obtaining reset values to another operation to be paired Relegate obtaining reset values to another operation to be paired
with the Reset-Printer operation in the Set2 [ipp-set2] document. with the Reset-Printer operation in the Set2 [ipp-set2] document.
3.Added "-supported" to the names of the "printer-settable-attributes" 3.Added "-supported" to the names of the "printer-settable-attributes"
and "job-settable-attributes" Printer Description attributes, so that and "job-settable-attributes" Printer Description attributes, so that
they could be returned in Get-Printer-Supported-Values and could be they could be returned in Get-Printer-Supported-Values and could be
set by Set-Printer-Attributes. set by Set-Printer-Attributes.
4.Deleted "authentication-methods-supported" (1setOf type2 keyword) and 4.Deleted "authentication-methods-supported" (1setOf type2 keyword) and
"security-methods-supported" (1setOf type2 keyword) and clarified "security-methods-supported" (1setOf type2 keyword) and clarified
that "uri-authentication-supported" (1setOf type2 keyword) and "uri- that "uri-authentication-supported" (1setOf type2 keyword) and "uri-
security-supported" (1setOf type2 keyword) can return multiple security-supported" (1setOf type2 keyword) can return multiple
keywords of the same value in a Get-Printer-Supported-Values keywords of the same value in a Get-Printer-Supported-Values
operation. operation.
15.3Changes to the January 4, 2000 version to make the January 20, 2000 15.4Changes to the January 4, 2000 version to make the January 20, 2000
version version
The following changes to the January 4, 2000 version to make the January The following changes to the January 4, 2000 version to make the January
4, 2000 version as a result of the IPP WG telecons and mailing list 4, 2000 version as a result of the IPP WG telecons and mailing list
discussion: discussion:
1.Replaced the "factory-settings" operation attribute proposed to be 1.Replaced the "factory-settings" operation attribute proposed to be
added to the Get-Printer-Attributes operation with the Get-Rest- added to the Get-Printer-Attributes operation with the Get-Rest-
Printer-Attributes operation which returns the reset values and the Printer-Attributes operation which returns the reset values and the
possible "xxx-supported" values. possible "xxx-supported" values.
skipping to change at page 31, line 5 skipping to change at page 33, line 45
indicate that any name will be accepted in a Job Creation operation indicate that any name will be accepted in a Job Creation operation
for configurations that support such a concept. for configurations that support such a concept.
3.Added authentication-methods-supported (1setOf type2 keyword) and 3.Added authentication-methods-supported (1setOf type2 keyword) and
security-methods-supported (1setOf type2 keyword) Printer Description security-methods-supported (1setOf type2 keyword) Printer Description
attributes so that clients can discover the possible values for use attributes so that clients can discover the possible values for use
in Set-Printer-Attributes to set "uri-authentication-supported" and in Set-Printer-Attributes to set "uri-authentication-supported" and
"uri-security-supported" attributes, since the Reset-Printer "uri-security-supported" attributes, since the Reset-Printer
operation doesn't change them. operation doesn't change them.
Expires: September 1, 2000
4.Added validation rules that the Printer MUST use to validate a Set- 4.Added validation rules that the Printer MUST use to validate a Set-
Printer-Attributes request. Printer-Attributes request.
5.Clarified that the Set-Printer-Attributes operation MUST NOT have any 5.Clarified that the Set-Printer-Attributes operation MUST NOT have any
side effects on other attributes, unless explicitly specified in this side effects on other attributes, unless explicitly specified in this
document. document.
6.Moved the specification of the attributes that MUST be READ-ONLY to 6.Moved the specification of the attributes that MUST be READ-ONLY to
Appendix A. Appendix A.
7.Added the "document-format-varying-attributes" (1setOf type2 keyword) 7.Added the "document-format-varying-attributes" (1setOf type2 keyword)
8.Added the REQUIRED "document-format-varying-scope" operation 8.Added the REQUIRED "document-format-varying-scope" operation
attribute to Set-Printer-Attributes in order to control whether one attribute to Set-Printer-Attributes in order to control whether one
Expires: September 8, 2000
or all document formats are affected for those attributes that vary or all document formats are affected for those attributes that vary
by document format. by document format.
9.Clarified that the Printer returns the 'client-error-attributes-not- 9.Clarified that the Printer returns the 'client-error-attributes-not-
settable' status code in a Set-Printer-Attributes response whether settable' status code in a Set-Printer-Attributes response whether
the attribute is READ-ONLY, the attribute is not supported, or the the attribute is READ-ONLY, the attribute is not supported, or the
value is not supported. value is not supported.
10. Added the out-of-band 'default' value for use with Set-Job- 10. Added the out-of-band 'default' value for use with Set-Job-
Attributes and Job Creation operations. Attributes and Job Creation operations.
skipping to change at page 31, line 50 skipping to change at page 34, line 35
13. Made the 'not-settable' out-of-band value and the 'client-error- 13. Made the 'not-settable' out-of-band value and the 'client-error-
not-settable' status code REQUIRED, if the Set-Printer-Attributes not-settable' status code REQUIRED, if the Set-Printer-Attributes
operation is supported. operation is supported.
14. Made the 'default' out-of-band value REQUIRED, if the Set-Job- 14. Made the 'default' out-of-band value REQUIRED, if the Set-Job-
Attributes operation is supported. Attributes operation is supported.
15. Removed the requirement that "xxx-supported" Printer Description 15. Removed the requirement that "xxx-supported" Printer Description
attributes that contain only one value be read-only. attributes that contain only one value be read-only.
15.4Changes to the December 8, 1999 version to make the January 4, 2000 15.5Changes to the December 8, 1999 version to make the January 4, 2000
version version
The following changes to the December 8, 1999 version to make the The following changes to the December 8, 1999 version to make the
January 4, 2000 version as a result of the IPP WG telecons and mailing January 4, 2000 version as a result of the IPP WG telecons and mailing
list discussion: list discussion:
1.Removed the Set operations and related items from the Set2 1.Removed the Set operations and related items from the Set2
specification [ipp-set2] to create this Set specification. specification [ipp-set2] to create this Set specification.
Expires: September 1, 2000
2.Added that an attribute that can only be set to one fixed value 2.Added that an attribute that can only be set to one fixed value
SHOULD NOT be included in the "printer-settable-attributes" or "job- SHOULD NOT be included in the "printer-settable-attributes" or "job-
settable-attributes" attributes. settable-attributes" attributes.
3.Indicated that the encoding of the 'not-settable' out-of-band value 3.Indicated that the encoding of the 'not-settable' out-of-band value
is TBD. is TBD.
4.Added that Set-Job-Attributes operation adds an attribute to the Job 4.Added that Set-Job-Attributes operation adds an attribute to the Job
object if it wasn't already there object if it wasn't already there
5.Added the conformance section to make it easy to understand the 5.Added the conformance section to make it easy to understand the
conformance requirements. conformance requirements.
Expires: September 8, 2000
16 Appendix A: Allowed Values for Set-Printer-Attributes 16 Appendix A: Allowed Values for Set-Printer-Attributes
This appendix is a normative part of this document and contains a table This appendix is a normative part of this document and contains a table
of all IPP/1.1 attributes. Each row contains of all IPP/1.1 attributes. Each row contains
An attribute and An attribute and
The values allowed in the Set-Printer-Attributes operation for the The values allowed in the Set-Printer-Attributes operation for the
attribute. The entry in each cell is the name (first few words) of attribute. The entry in each cell is the name (first few words) of
each item below 1, 2, 3, 4a-g, and 5. each item below 1, 2, 3, 4a-g, and 5.
skipping to change at page 33, line 5 skipping to change at page 35, line 50
The attribute syntaxes supported are enumerated below. The attribute syntaxes supported are enumerated below.
a.Any text(127) a.Any text(127)
b.Any name(127) b.Any name(127)
c.Any uri c.Any uri
d.Any boolean d.Any boolean
e.Any positive integer e.Any positive integer
f.Any dateTime f.Any dateTime
g.1setOf any uri g.1setOf any uri
Expires: September 1, 2000
5. Combination of 'Any of "xxx-supported"' or 'Any name'. 5. Combination of 'Any of "xxx-supported"' or 'Any name'.
If a Printer implementation doesn't want to allow setting values If a Printer implementation doesn't want to allow setting values
indicated in this Appendix as "any xxx", it can make the value be read- indicated in this Appendix as "any xxx", it can make the value be read-
only. For example, for a monochrome printer the attribute "color- only. For example, for a monochrome printer the attribute "color-
supported" is "false" and MUST be read-only. Otherwise an administrator supported" is "false" and MUST be read-only. Otherwise an administrator
could set it to "true" because the value can have "any boolean" could set it to "true" because the value can have "any boolean"
according to the rules in Table 6 below. according to the rules in Table 7 below.
Table 3 - Values allowed for Job Template Attributes in the Set-Job- Table 4 - Values allowed for Job Template Attributes in the Set-Job-
Attributes Operation Attributes Operation
Job Template Attributes Values allowed for Set Job Template Attributes Values allowed for Set
job-priority (integer(1:100)) Any of "xxx-supported" job-priority (integer(1:100)) Any of "xxx-supported"
Expires: September 8, 2000
Job Template Attributes Values allowed for Set
job-hold-until (type3 keyword | name (MAX)) Any of "xxx-supported" job-hold-until (type3 keyword | name (MAX)) Any of "xxx-supported"
job-sheets (type3 keyword | name(MAX)) Any of "xxx-supported" job-sheets (type3 keyword | name(MAX)) Any of "xxx-supported"
multiple-document-handling (type2 keyword) Any of "xxx-supported" multiple-document-handling (type2 keyword) Any of "xxx-supported"
copies (integer(1:MAX)) Any of "xxx-supported" copies (integer(1:MAX)) Any of "xxx-supported"
finishings (1setOf type2 enum) Any of "xxx-supported" finishings (1setOf type2 enum) Any of "xxx-supported"
page-ranges (1setOf rangeOfInteger (1:MAX)) Any of "xxx-supported" page-ranges (1setOf rangeOfInteger (1:MAX)) Any of "xxx-supported"
sides (type2 keyword) Any of "xxx-supported" sides (type2 keyword) Any of "xxx-supported"
number-up (integer(1:MAX)) Any of "xxx-supported" number-up (integer(1:MAX)) Any of "xxx-supported"
orientation-requested (type2 enum) Any of "xxx-supported" orientation-requested (type2 enum) Any of "xxx-supported"
media (type3 keyword | name(MAX)) Any of "xxx-supported" media (type3 keyword | name(MAX)) Any of "xxx-supported"
printer-resolution (resolution) Any of "xxx-supported" printer-resolution (resolution) Any of "xxx-supported"
print-quality (type2 enum) Any of "xxx-supported" print-quality (type2 enum) Any of "xxx-supported"
Table 4 - Values allowed for Job Description Attributes in the Set-Job- Table 5 - Values allowed for Job Description Attributes in the Set-Job-
Attributes Operation Attributes Operation
Job Description Attributes Values allowed for Set Job Description Attributes Values allowed for Set
job-uri (uri) READ-ONLY job-uri (uri) READ-ONLY
job-id (integer(1:MAX)) READ-ONLY job-id (integer(1:MAX)) READ-ONLY
job-printer-uri (uri) READ-ONLY job-printer-uri (uri) READ-ONLY
job-more-info (uri) READ-ONLY job-more-info (uri) READ-ONLY
job-name (name(MAX)) Any name(MAX) job-name (name(MAX)) Any name(MAX)
job-originating-user-name (name(MAX)) READ-ONLY job-originating-user-name (name(MAX)) READ-ONLY
skipping to change at page 34, line 4 skipping to change at page 36, line 49
text(MAX)) text(MAX))
number-of-documents (integer(0:MAX)) READ-ONLY number-of-documents (integer(0:MAX)) READ-ONLY
output-device-assigned (name(127)) READ-ONLY output-device-assigned (name(127)) READ-ONLY
time-at-creation (integer(MIN:MAX)) READ-ONLY time-at-creation (integer(MIN:MAX)) READ-ONLY
time-at-processing (integer(MIN:MAX)) READ-ONLY time-at-processing (integer(MIN:MAX)) READ-ONLY
time-at-completed (integer(MIN:MAX)) READ-ONLY time-at-completed (integer(MIN:MAX)) READ-ONLY
job-printer-up-time (integer(1:MAX)) READ-ONLY job-printer-up-time (integer(1:MAX)) READ-ONLY
date-time-at-creation (dateTime) READ-ONLY date-time-at-creation (dateTime) READ-ONLY
date-time-at-processing (dateTime) READ-ONLY date-time-at-processing (dateTime) READ-ONLY
date-time-at-completed (dateTime) READ-ONLY date-time-at-completed (dateTime) READ-ONLY
Expires: September 1, 2000
Job Description Attributes Values allowed for Set
number-of-intervening-jobs (integer(0:MAX)) READ-ONLY number-of-intervening-jobs (integer(0:MAX)) READ-ONLY
job-message-from-operator (text(127)) Any text(127) job-message-from-operator (text(127)) Any text(127)
job-k-octets (integer(0:MAX)) READ-ONLY job-k-octets (integer(0:MAX)) READ-ONLY
job-impressions (integer(0:MAX)) READ-ONLY job-impressions (integer(0:MAX)) READ-ONLY
job-media-sheets (integer(0:MAX)) READ-ONLY job-media-sheets (integer(0:MAX)) READ-ONLY
job-k-octets-processed (integer(0:MAX)) READ-ONLY job-k-octets-processed (integer(0:MAX)) READ-ONLY
job-impressions-completed (integer(0:MAX)) READ-ONLY job-impressions-completed (integer(0:MAX)) READ-ONLY
job-media-sheets-completed (integer(0:MAX)) READ-ONLY job-media-sheets-completed (integer(0:MAX)) READ-ONLY
attributes-charset (charset) READ-ONLY attributes-charset (charset) READ-ONLY
attributes-natural-language READ-ONLY attributes-natural-language READ-ONLY
(naturalLanguage) (naturalLanguage)
Table 5 - Values allowed for Printer Job Template Attributes in the Set- Expires: September 8, 2000
Table 6 - Values allowed for Printer Job Template Attributes in the Set-
Printer-Attributes Operation Printer-Attributes Operation
Printer Job Template Attributes Values allowed for Set Printer Job Template Attributes Values allowed for Set
job-priority-default (integer(1:100)) Any of "xxx-supported" job-priority-default (integer(1:100)) Any of "xxx-supported"
job-hold-until-default (type3 keyword | Any of "xxx-supported" job-hold-until-default (type3 keyword | Any of "xxx-supported"
name (MAX)) name (MAX))
job-sheets-default (type3 keyword | Any of "xxx-supported" job-sheets-default (type3 keyword | Any of "xxx-supported"
name(MAX)) name(MAX))
multiple-document-handling-default (type2 Any of "xxx-supported" multiple-document-handling-default (type2 Any of "xxx-supported"
skipping to change at page 35, line 4 skipping to change at page 37, line 47
finishings-supported (1setOf type2 enum) From Get-Printer- finishings-supported (1setOf type2 enum) From Get-Printer-
Supported-Values Supported-Values
page-ranges-supported (boolean) From Get-Printer- page-ranges-supported (boolean) From Get-Printer-
Supported-Values Supported-Values
sides-supported (1setOf type2 keyword) From Get-Printer- sides-supported (1setOf type2 keyword) From Get-Printer-
Supported-Values Supported-Values
number-up-supported (1setOf (integer(1:MAX) From Get-Printer- number-up-supported (1setOf (integer(1:MAX) From Get-Printer-
| rangeOfInteger(1:MAX))) Supported-Values | rangeOfInteger(1:MAX))) Supported-Values
orientation-requested-supported (1setOf From Get-Printer- orientation-requested-supported (1setOf From Get-Printer-
type2 enum) Supported-Values type2 enum) Supported-Values
Expires: September 1, 2000
Printer Job Template Attributes Values allowed for Set
media-supported (1setOf (type3 keyword | From Get-Printer- media-supported (1setOf (type3 keyword | From Get-Printer-
name(MAX))) Supported-Values name(MAX))) Supported-Values
printer-resolution-supported (1setOf From Get-Printer- printer-resolution-supported (1setOf From Get-Printer-
resolution) Supported-Values resolution) Supported-Values
print-quality-supported (1setOf type2 enum) From Get-Printer- print-quality-supported (1setOf type2 enum) From Get-Printer-
Supported-Values Supported-Values
media-ready (type3 keyword | name(MAX)) From Get-Printer- media-ready (type3 keyword | name(MAX)) From Get-Printer-
Supported-Values Supported-Values
Table 6 - Values allowed for Printer Description Attributes in the Set- Table 7 - Values allowed for Printer Description Attributes in the Set-
Printer-Attributes Operation Printer-Attributes Operation
Printer Description Attributes Values allowed for Set Printer Description Attributes Values allowed for Set
printer-uri-supported (1setOf uri) From Get-Printer- Expires: September 8, 2000
Supported-Values
uri-authentication-supported (1setOf type2 From Get-Printer- Printer Description Attributes Values allowed for Set
keyword) Supported-Values
uri-security-supported (1setOf type2 From Get-Printer- printer-uri-supported (1setOf uri) READ-ONLY
keyword) Supported-Values uri-authentication-supported (1setOf type2 READ-ONLY
keyword)
uri-security-supported (1setOf type2 READ-ONLY
keyword)
printer-name (name(127)) Any name(127) printer-name (name(127)) Any name(127)
printer-location (text(127)) Any text(127) printer-location (text(127)) Any text(127)
printer-info (text(127)) Any text(127) printer-info (text(127)) Any text(127)
printer-more-info (uri) Any uri printer-more-info (uri) Any uri
printer-driver-installer (uri) Any uri printer-driver-installer (uri) Any uri
printer-make-and-model (text(127)) Any text(127) printer-make-and-model (text(127)) Any text(127)
printer-more-info-manufacturer (uri) Any uri printer-more-info-manufacturer (uri) Any uri
printer-state (type1 enum) READ-ONLY printer-state (type1 enum) READ-ONLY
printer-state-reasons (1setOf type2 READ-ONLY printer-state-reasons (1setOf type2 READ-ONLY
keyword) keyword)
skipping to change at page 36, line 4 skipping to change at page 38, line 46
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-supported" document-format-default (mimeMediaType) Any of "xxx-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-
Expires: September 1, 2000
Printer Description Attributes Values allowed for Set
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 **
multiple-operation-time-out any positive integer multiple-operation-time-out any positive integer
(integer(1:MAX)) (integer(1:MAX))
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
job-impressions-supported From Get-Printer- job-impressions-supported From Get-Printer-
(rangeOfInteger(0:MAX)) Supported-Values (rangeOfInteger(0:MAX)) Supported-Values
Expires: September 8, 2000
Printer Description Attributes Values allowed for Set
job-media-sheets-supported From Get-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
order to allow an administrator to correct an incorrect dateTime or time
zone.
17 Appendix B: Attributes returned from Get-Printer-Supported-Values 17 Appendix B: Attributes returned from Get-Printer-Supported-Values
This Appendix is a normative part of this document and lists all the
attributes that are possible for an implementation to return in a Get-
Printer-Supported-Values response, i.e., all the "xxx-supported"
attributes that can be supplied in a Set-Printer-Attributes request.
READ-ONLY attributes MUST NOT be returned in a Get-Printer-Supported-
Values response and are indicated in the tables as "READ-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 7 - Printer Job Template Attributes returned from Get-Printer- Table 8 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values 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 bounds Attributes operation MUST be a single rangeOfInteger value whose bounds
do not exceed those of the range specified by the value returned by the do not exceed those of the range specified by the value returned by the
Get-Printer-Supported-Values operation. Get-Printer-Supported-Values operation.
Expires: September 1, 2000 Table 9 - Printer Job Template Attributes returned from Get-Printer-
Table 8 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values 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)
Expires: September 8, 2000
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 9 - Printer Description Attributes returned from Get-Printer- Table 10 - Printer Description Attributes returned from Get-Printer-
Supported-Values 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 by rangeOfInteger is the same as or a subset of the integers described by
the integers and rangeOf Integer of value returned by the Get-Printer- the integers and rangeOf Integer of value returned by the Get-Printer-
Supported-Values operation. Supported-Values operation.
Table 10 - Printer Job Template Attributes returned from Get-Printer- Table 11 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values Supported-Values
Printer Job Template Attributes Values Returned Printer Job Template Attributes Values Returned
number-up-supported (1setOf (integer(1:MAX) 1setOf (integer(1:MAX) | number-up-supported (1setOf (integer(1:MAX) 1setOf (integer(1:MAX) |
| rangeOfInteger(1:MAX))) rangeOfInteger(1:MAX)) | rangeOfInteger(1:MAX))) rangeOfInteger(1: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 values, where each such value Attributes operation MUST be one or more values, where each such value
matches a value returned by the Get-Printer-Supported-Values operation. matches a value returned by the Get-Printer-Supported-Values operation.
A keyword, enum, boolean, charset, naturalLanguage, uriScheme, A keyword, enum, boolean, charset, naturalLanguage, uriScheme,
mimeMediaType or resolution value matches if it is equal. A name matches mimeMediaType or resolution value matches if it is equal. A name matches
the 'any-name' out-of-band value. the 'any-name' out-of-band value.
Table 11 - Printer Job Template Attributes returned from Get-Printer- Table 12 - Printer Job Template Attributes returned from Get-Printer-
Supported-Values Supported-Values
Printer Job Template Attributes Values Returned Printer Job Template Attributes Values Returned
job-hold-until-supported (1setOf(type3 1setOf(type3 keyword | job-hold-until-supported (1setOf(type3 1setOf(type3 keyword |
keyword | name (MAX))) any name) keyword | name (MAX))) any name)
job-sheets-supported (1setOf(type3 keyword 1setOf(type3 keyword | job-sheets-supported (1setOf(type3 keyword 1setOf(type3 keyword |
| name(MAX))) any name) | name(MAX))) any name)
Expires: September 1, 2000
Printer Job Template Attributes Values Returned
multiple-document-handling-supported 1setOf type2 keyword multiple-document-handling-supported 1setOf type2 keyword
(1setOf type2 keyword) (1setOf type2 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 keyword sides-supported (1setOf type2 keyword) 1setOf type2 keyword
orientation-requested-supported (1setOf 1setOf type2 enum orientation-requested-supported (1setOf 1setOf type2 enum
Expires: September 8, 2000
Printer Job Template Attributes Values Returned
type2 enum) type2 enum)
media-supported (1setOf (type3 keyword | 1setOf(type3 keyword | media-supported (1setOf (type3 keyword | 1setOf(type3 keyword |
name(MAX))) any name) name(MAX))) any name)
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
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. Note that the first two attributes in Printer Description attributes.
the table below follow the rules for allowed values in the Set-Printer-
Attributes, but unlike other attributes, there can be more than one
occurrence of each value because the i-th value of these attributes
specifies the authentication or security for the i-th printer in
"printer-uri-supported".
Table 12 - Printer Description Attributes returned from Get-Printer- Table 13 - Printer Description Attributes returned from Get-Printer-
Supported-Values Supported-Values
Printer Description Attributes Values allowed for Set Printer Description Attributes Values allowed for Set
uri-authentication-supported (1setOf type2 1setOf type2 keyword printer-uri-supported (1setOf uri) READ-ONLY - MUST NOT be
keyword) returned
uri-security-supported (1setOf type2 1setOf type2 keyword uri-authentication-supported (1setOf type2 READ-ONLY - MUST NOT be
keyword) keyword) returned
uri-security-supported (1setOf type2 READ-ONLY - MUST NOT be
keyword) returned
xri-authentication-supported (1setOf type2 1setOf type2 keyword
keyword) **
xri-security-supported (1setOf type2 1setOf type2 keyword
keyword) **
ipp-versions-supported (1setOf type2 1setOf type2 keyword ipp-versions-supported (1setOf type2 1setOf type2 keyword
keyword) keyword)
operations-supported (1setOf type2 enum) 1setOf type2 keyword operations-supported (1setOf type2 enum) 1setOf type2 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 naturalLanguage generated-natural-language-supported 1setOf naturalLanguage
(1setOf naturalLanguage) (1setOf naturalLanguage)
document-format-supported (1setOf 1setOf mimeMediaType document-format-supported (1setOf 1setOf mimeMediaType
mimeMediaType) mimeMediaType)
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)
compression-supported (1setOf type3 1setOf type3 keyword compression-supported (1setOf type3 1setOf type3 keyword
keyword) keyword)
printer-settable-attributes-supported 1setOf type2 keyword printer-settable-attributes-supported 1setOf type2 keyword
(1setOf type2 keyword) (1setOf type2 keyword)
job-settable-attributes-supported (1setOf 1setOf type2 keyword job-settable-attributes-supported (1setOf 1setOf type2 keyword
type2 keyword) type2 keyword)
Expires: September 1, 2000 ** Note: there is no corresponding "xri-authentication-supported"
(1setOf type2 keyword) and "xri-security-supported" (1setOf type2
keyword) Printer Description attributes that can be queried using the
Get-Printer-Attributes operation. Instead, the client queries either:
(1) the three "printer-uri-supported" (uri), "uri-authentication-
supported" (1setOf type2 keyword) and "uri-security-supported" (1setOf
Expires: September 8, 2000
type2 keyword) attributes or (2) the single "priner-xri-supported"
(1setOf collection) attribute.
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 value that matches one of the Attributes operation MUST be a single value that matches one of the
values returned by the Get-Printer-Supported-Values operation. A values returned by the Get-Printer-Supported-Values operation. A
keyword, enum, boolean, charset, naturalLanguage, uriScheme, keyword, enum, boolean, charset, naturalLanguage, uriScheme,
mimeMediaType or resolution value matches if it is equal. A name matches mimeMediaType or resolution value matches if it is equal. A name matches
the 'any-name' out-of-band value. the 'any-name' out-of-band value.
Table 13 - Printer Description Attributes returned from Get-Printer- Table 14 - Printer Description Attributes returned from Get-Printer-
Supported-Values Supported-Values
Printer Description Attributes Values allowed for Set Printer Description Attributes Values allowed for Set
pdl-override-supported (type2 keyword) 1 setOf type2 keyword pdl-override-supported (type2 keyword) 1 setOf type2 keyword
For the following attributes, the Set-Printer-Attributes operation MUST For the following attributes, the Set-Printer-Attributes operation MUST
NOT return a value. The IPP Model document [ipp-mod] document specifies NOT return a value. The IPP Model document [ipp-mod] document specifies
the allowed values. the allowed values.
Table 14 - Printer Description Attributes returned from Get-Printer- Table 15 - Printer Description Attributes returned from Get-Printer-
Supported-Values Supported-Values
Printer Description Attributes Values allowed for Set Printer Description Attributes Values allowed for Set
printer-uri-supported (1setOf uri) any uri printer-uri-supported (1setOf uri) any uri
18 Appendix C: Full Copyright Statement 18 Appendix C: Full Copyright Statement
Copyright (C) The Internet Society (1998,1999). All Rights Reserved Copyright (C) The Internet Society (1998,1999). All Rights Reserved
skipping to change at page 39, line 54 skipping to change at page 43, line 4
except as needed for the purpose of developing Internet standards in except as needed for the purpose of developing Internet standards in
which case the procedures for copyrights defined in the Internet which case the procedures for copyrights defined in the Internet
Standards process must be followed, or as required to translate it into Standards process must be followed, or as required to translate it into
languages other than English. languages other than English.
The limited permissions granted above are perpetual and will not be The limited permissions granted above are perpetual and will not be
revoked by the Internet Society or its successors or assigns. revoked by the Internet Society or its successors or assigns.
This document and the information contained herein is provided on an "AS This document and the information contained herein is provided on an "AS
IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK
FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT
Expires: September 1, 2000 Expires: September 8, 2000
FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT
LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT
INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR
FITNESS FOR A PARTICULAR PURPOSE. FITNESS FOR A PARTICULAR PURPOSE.
Expires: September 1, 2000 Expires: September 8, 2000
 End of changes. 

This html diff was produced by rfcdiff 1.25, available from http://www.levkowetz.com/ietf/tools/rfcdiff/