Internet Printing Protocol (IPP): Job and Printer Set Operations
RFC 3380
Network Working Group T. Hastings
Request for Comments: 3380 Xerox Corporation
Updates: 2910, 2911 R. Herriot
Category: Standards Track Consultant
C. Kugler
H. Lewis
IBM Corporation
September 2002
Internet Printing Protocol (IPP):
Job and Printer Set Operations
Status of this Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (C) The Internet Society (2002). All Rights Reserved.
Abstract
This document is an OPTIONAL extension to the Internet Printing
Protocol (IPP/1.0 and IPP/1.1). This document specifies 3 additional
OPTIONAL operations for use with the Internet Printing Protocol/1.0
(IPP) and IPP/1.1. The end user, operator, and administrator Set-
Job-Attributes and Set-Printer-Attributes operations are used to
modify IPP Job objects and Printer objects, respectively. The Get-
Printer-Supported-Values administrative operation returns values that
the IPP Printer will accept for setting its "xxx-supported"
attributes.
Hastings, et. al. Standards Track [Page 1]
RFC 3380 IPP: Job and Printer Set Operations September 2002
Table of Contents
1 Introduction......................................................4
2 Terminology.......................................................5
2.1 Conformance Terminology.........................................5
2.2 Other terminology...............................................5
3 Requirements and Use Cases........................................5
4 Definition of the Set operations..................................6
4.1 Set-Printer-Attributes Operation................................7
4.1.1 Settable and READ-ONLY Printer Description attributes.........9
4.1.2 Set-Printer-Attributes Request...............................10
4.1.3 Set-Printer-Attributes Response..............................12
4.2 Set-Job-Attributes Operation...................................13
4.2.1 Settable and READ-ONLY Job Description attributes............16
4.2.2 Set-Job-Attributes Request...................................17
4.2.3 Set-Job-Attributes Response..................................18
4.3 Get-Printer-Supported-Values Operation.........................19
4.3.1 Definition of the usage of the 'admin-define' out-of-band
attribute value..............................................20
5 New Operation attributes.........................................22
5.1 printer-message-from-operator (text(127))......................22
5.2 job-message-from-operator (text(127))..........................23
6 New Printer Description Attributes...............................24
6.1 printer-settable-attributes-supported (1setOf type2 keyword)...24
6.2 job-settable-attributes-supported (1setOf type2 keyword).......25
6.3 document-format-varying-attributes (1setOf type2 keyword)......25
6.4 printer-message-time (integer(MIN:MAX))........................25
6.5 printer-message-date-time (dateTime)...........................26
6.6 printer-xri-supported (1setOf collection)......................26
6.7 xri-uri-scheme-supported (1setOf uriScheme)....................28
6.8 xri-authentication-supported (1setOf type2 keyword)............29
6.9 xri-security-supported (1setOf type2 keyword)..................29
7 Additional status codes..........................................29
7.1 client-error-attributes-not-settable (0x0413)..................29
8 Additional out-of-band values....................................30
8.1 'not-settable' out-of-band value...............................30
8.1.1 Encoding of the 'not-settable' out-of-band attribute value...30
8.2 'delete-attribute' out-of-band value...........................30
8.2.1 Encoding of the 'delete-attribute' out-of-band value.........31
8.3 'admin-define' out-of-band attribute value.....................31
8.3.1 Encoding of the 'admin-define' out-of-band attribute value...32
9 New Values for Existing Printer Description Attributes...........33
9.1 operations-supported (1setOf type2 enum).......................33
10 Conformance Requirements........................................33
11 IANA Considerations.............................................34
Show full document text