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
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
Internet打印协议(IPP):作业和打印机设置操作
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.
本文件规定了互联网社区的互联网标准跟踪协议,并要求进行讨论和提出改进建议。有关本协议的标准化状态和状态,请参考当前版本的“互联网官方协议标准”(STD 1)。本备忘录的分发不受限制。
Copyright Notice
版权公告
Copyright (C) The Internet Society (2002). All Rights Reserved.
版权所有(C)互联网协会(2002年)。版权所有。
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.
本文件是Internet打印协议(IPP/1.0和IPP/1.1)的可选扩展。本文件规定了与Internet打印协议/1.0(IPP)和IPP/1.1一起使用的3个附加可选操作。最终用户、操作员和管理员设置作业属性和设置打印机属性操作分别用于修改IPP作业对象和打印机对象。Get Printer Supported Values(获取打印机支持的值)管理操作返回IPP打印机在设置其“支持的xxx”属性时将接受的值。
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 11.1 Operation Registrations.......................................35 11.2 Additional Enum Attribute Value Registrations for the "operations-supported" Printer Attribute......................35
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 11.1 Operation Registrations.......................................35 11.2 Additional Enum Attribute Value Registrations for the "operations-supported" Printer Attribute......................35
11.3 Attribute Registrations.......................................35 11.4 Status code Registrations.....................................36 11.5 Out-of-band Attribute Value Registrations.....................36 12 Internationalization Considerations.............................37 13 Security Considerations.........................................37 14 References......................................................38 14.1 Normative References..........................................38 14.2 Informative References........................................38 Appendix A: Allowed Values for Set-Printer-Attributes and Set-Job- Attributes requests (Normative)........................39 Appendix B: Attributes returned from Get-Printer-Supported-Values (Normative)............................................50 Appendix C: Description of the Base IPP Documents (Informative)....55 Authors' Addresses.................................................56 Full Copyright Statement...........................................58
11.3 Attribute Registrations.......................................35 11.4 Status code Registrations.....................................36 11.5 Out-of-band Attribute Value Registrations.....................36 12 Internationalization Considerations.............................37 13 Security Considerations.........................................37 14 References......................................................38 14.1 Normative References..........................................38 14.2 Informative References........................................38 Appendix A: Allowed Values for Set-Printer-Attributes and Set-Job- Attributes requests (Normative)........................39 Appendix B: Attributes returned from Get-Printer-Supported-Values (Normative)............................................50 Appendix C: Description of the Base IPP Documents (Informative)....55 Authors' Addresses.................................................56 Full Copyright Statement...........................................58
Table of Tables
表格
Table 1 - Operation-Id assignments.................................7 Table 2 - Job State Transition Table for the Set-Job-Attributes operation ..............................................15 Table 3 - Member attributes of "printer-xri-supported" (1setOf collection) ............................................27 Table 4 - Operation-id assignments................................33 Table 5 - Validation rules for 'Any of "xxx-supported" '..........40 Table 6 - Validation rules for 'From Get-Printer-Supported-Values'41 Table 7 - Values allowed for Job Template Attributes in the Set-Job- Attributes Operation ...................................42 Table 8 - Values allowed for Job Description Attributes in the Set- Job-Attributes Operation ...............................43 Table 9 - Values allowed for Printer Job Template Attributes in the Set-Printer-Attributes Operation .......................44 Table 10 - Values allowed for Printer Description Attributes in the Set-Printer-Attributes Operation .......................47 Table 11 - Printer Job Template Attributes returned from Get-Printer- Supported-Values .......................................51 Table 12 - Printer Job Template Attributes returned from Get-Printer- Supported-Values .......................................51 Table 13 - Printer Description Attributes returned from Get-Printer- Supported-Values .......................................51 Table 14 - Printer Job Template Attributes returned from Get-Printer- Supported-Values .......................................52 Table 15 - Printer Job Template Attributes returned from Get-Printer- Supported-Values .......................................52 Table 16 - Printer Description Attributes returned from Get-Printer- Supported-Values .......................................53
Table 1 - Operation-Id assignments.................................7 Table 2 - Job State Transition Table for the Set-Job-Attributes operation ..............................................15 Table 3 - Member attributes of "printer-xri-supported" (1setOf collection) ............................................27 Table 4 - Operation-id assignments................................33 Table 5 - Validation rules for 'Any of "xxx-supported" '..........40 Table 6 - Validation rules for 'From Get-Printer-Supported-Values'41 Table 7 - Values allowed for Job Template Attributes in the Set-Job- Attributes Operation ...................................42 Table 8 - Values allowed for Job Description Attributes in the Set- Job-Attributes Operation ...............................43 Table 9 - Values allowed for Printer Job Template Attributes in the Set-Printer-Attributes Operation .......................44 Table 10 - Values allowed for Printer Description Attributes in the Set-Printer-Attributes Operation .......................47 Table 11 - Printer Job Template Attributes returned from Get-Printer- Supported-Values .......................................51 Table 12 - Printer Job Template Attributes returned from Get-Printer- Supported-Values .......................................51 Table 13 - Printer Description Attributes returned from Get-Printer- Supported-Values .......................................51 Table 14 - Printer Job Template Attributes returned from Get-Printer- Supported-Values .......................................52 Table 15 - Printer Job Template Attributes returned from Get-Printer- Supported-Values .......................................52 Table 16 - Printer Description Attributes returned from Get-Printer- Supported-Values .......................................53
1 Introduction
1导言
This document is an OPTIONAL extension to IPP/1.0 [RFC2565, RFC2566] and IPP/1.1 [RFC2911, RFC2910]. For a description of the base IPP documents see Appendix C.
本文档是IPP/1.0[RFC2565,RFC2566]和IPP/1.1[RFC2911,RFC2910]的可选扩展。有关基本IPP文件的说明,请参见附录C。
The Internet Printing Protocol (IPP) is an application level protocol that can be used for distributed printing using Internet tools and technologies. IPP version 1.1 [RFC2911, RFC2910] focuses on end user functionality with a few administrative operations included. This document defines additional OPTIONAL end user, operator, and administrator Set-Job-Attributes and Set-Printer-Attributes operations used to modify IPP Job objects and Printer objects, respectively. It also defines a third Get-Printer-Supported-Values administrator operation that returns values that the IPP Printer will accept for setting its "xxx-supported" attributes. The Get-Printer-Supported-Values operation MUST be supported, if the implementation supports setting any "xxx-supported" Printer attributes using the Set-Printer-Attributes operation.
Internet打印协议(IPP)是一种应用程序级协议,可用于使用Internet工具和技术进行分布式打印。IPP版本1.1[RFC2911,RFC2910]侧重于最终用户功能,包括一些管理操作。本文档定义了用于分别修改IPP作业对象和打印机对象的其他可选最终用户、操作员和管理员设置作业属性和设置打印机属性操作。它还定义了第三个“获取打印机支持的值”管理员操作,该操作返回IPP打印机在设置其“支持的xxx”属性时将接受的值。如果实现支持使用“设置打印机属性”操作设置任何“xxx支持的”打印机属性,则必须支持“获取打印机支持的值”操作。
Nine Printer Description attributes are defined:
定义了九个打印机描述属性:
printer-settable-attributes-supported (1setOf type2 keyword) job-settable-attributes-supported (1setOf type2 keyword) document-format-varying-attributes (1setOf type2 keyword) printer-message-time (integer(MIN:MAX)) printer-message-date-time (dateTime) printer-xri-supported (1setOf collection) xri-uri-scheme-supported (1setOf uriScheme) xri-authentication-supported (1setOf type2 keyword) xri-security-supported (1setOf type2 keyword)
支持的打印机可设置属性(1setOf type2关键字)支持的作业可设置属性(1setOf type2关键字)支持的文档格式变化属性(1setOf type2关键字)打印机消息时间(整数(最小值:最大值))打印机消息日期时间(日期时间)支持的打印机xri(1setOf collection)支持的xri uri方案(1setOf uri方案)支持xri身份验证(1setOf type2关键字)支持xri安全性(1setOf type2关键字)
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 'admin-define' 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.
定义了两个操作属性:“来自操作员的打印机消息”(文本)和“来自操作员的作业消息”(文本),以设置具有相同名称的相应IPP/1.1打印机和作业描述属性。这些操作属性可用于影响打印机或作业对象的任何操作,操作可能要为其指示消息。对于设置作业属性和设置打印机属性操作,客户端必须显式设置它们,而不是使用这些操作属性。
A Printer implementation can make the value of some attributes dependent on the document-format, e.g., "resolution-supported".
打印机实现可以使某些属性的值依赖于文档格式,例如“支持分辨率”。
2 Terminology
2术语
This section defines terminology used throughout this document.
本节定义了本文件中使用的术语。
Capitalized terms, such as MUST, MUST NOT, REQUIRED, SHOULD, SHOULD NOT, MAY, NEED NOT, and OPTIONAL, have special meaning relating to conformance as defined in BCP 14, RFC 2119 [RFC2119] and [RFC2911] section 12.1. If an implementation supports the extension defined in this document, then these terms apply; otherwise, they do not. These terms define conformance to this document only; they do not affect conformance to other documents, unless explicitly stated otherwise.
如BCP 14、RFC 2119[RFC2119]和[RFC2911]第12.1节所定义,大写术语(如必须、不得、必需、应该、不应该、可能、不需要和可选)具有与合规性相关的特殊含义。如果实施支持本文件中定义的扩展,则这些条款适用;否则,他们不会。这些术语仅定义与本文件的一致性;除非另有明确说明,否则它们不影响与其他文件的一致性。
This document uses terms such as Job object (or Job), IPP Printer object (or Printer), "operation", "request", response", "attributes", "keywords", and "support". These terms have special meaning and are defined in the model terminology [RFC2911], section 12.2. The following additional terms are introduced in this document:
本文档使用诸如作业对象(或作业)、IPP打印机对象(或打印机)、“操作”、“请求”、“响应”、“属性”、“关键字”和“支持”等术语。这些术语具有特殊含义,并在模型术语[RFC2911]第12.2节中进行了定义。本文档中介绍了以下附加术语:
READ-ONLY: used in an attribute definition document to indicate that the attribute MUST NOT be settable using an IPP protocol Set operation. In other words, the attribute is not settable by definition.
只读:在属性定义文档中使用,表示不能使用IPP协议集操作设置属性。换句话说,该属性不可根据定义进行设置。
not-settable: an implementation does not support setting an attribute (whether or not the attribute's definition is READ-ONLY).
不可设置:实现不支持设置属性(无论属性的定义是否为只读)。
3 Requirements and Use Cases
3需求和用例
The following requirements and usage are intended to be met by the specification in this document.
本文件中的规范应满足以下要求和用途。
1. The end-user and the operator need a way to modify a Job that is in the 'pending' or 'pending-held' state.
1. 最终用户和操作员需要一种方法来修改处于“挂起”或“挂起挂起”状态的作业。
Usage: The end-user discovers that he/she forgot to include a print instruction, such as "finishings" = 'staple' after submitting a job. Rather than canceling the job and resubmitting it to the same IPP Printer, the end-user is able to modify the job on the IPP Printer.
用法:最终用户在提交作业后发现他/她忘记包含打印指令,例如“finishings”=“装订”。最终用户可以在IPP打印机上修改作业,而不是取消作业并将其重新提交给同一台IPP打印机。
The operator needs to modify a job because it is requesting a particular kind of media for which there is no more, but the policy is to print the job on a comparable medium.
操作员需要修改作业,因为它请求的是一种特殊类型的介质,而该介质已经没有了,但策略是在类似介质上打印作业。
2. The system administrator needs a way to re-configure or change the policy of the IPP Printer remotely.
2. 系统管理员需要一种远程重新配置或更改IPP打印机策略的方法。
Usage: The system administrator is adding additional named media to the supported media list (setting 'name' values to the "media-supported" Printer attribute).
用法:系统管理员正在将其他命名介质添加到支持的介质列表中(将“名称”值设置为“支持的介质”打印机属性)。
The system administrator is reducing the capability of the IPP Printer by removing one of the operations from the supported operations list, such as Cancel-Job, because the policy is to run the IPP Printer like a public facsimile machine. After having removed Cancel-Job from the list of supported operations, an administrative client needs to be able to display to an administrator that the implementation is capable of being reconfigured to support Cancel-Job once again.
系统管理员通过从支持的操作列表中删除其中一项操作(如取消作业)来降低IPP打印机的容量,因为策略是像公共传真机一样运行IPP打印机。从支持的操作列表中删除“取消作业”后,管理客户端需要能够向管理员显示该实现能够重新配置以再次支持“取消作业”。
The system administrator is remotely configuring the IPP Printer after installing it, and so is replacing the Printer Description attributes that have the out-of-band 'no-value' value (see [RFC2911], section 4.1) with the proper values.
安装IPP打印机后,系统管理员将对其进行远程配置,并将带外“无值”值(请参见[RFC2911],第4.1节)的打印机描述属性替换为正确的值。
The operator is changing the media loaded in the input tray, and so is replacing the "media-ready" Job Template Printer attribute value with the proper values.
操作员正在更改装入进纸盘中的介质,并将“介质就绪”作业模板打印机属性值替换为正确的值。
4 Definition of the Set operations
4集合运算的定义
The Set-Printer-Attributes operations (as are all Printer operations) are directed at Printer objects. A client MUST always supply the "printer-uri" operation attribute in order to identify the correct target of the operation. These descriptions assume all of the common semantics of the IPP/1.1 Model and Semantics document [RFC2911], section 3.1.
设置打印机属性操作(与所有打印机操作一样)针对打印机对象。客户端必须始终提供“打印机uri”操作属性,以便标识正确的操作目标。这些描述假设IPP/1.1模型和语义文档[RFC2911]第3.1节的所有通用语义。
The Set-Job-Attributes operations (as are all Job operations) are directed at Job objects. A client MUST always supply some means 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 or a combination of a Printer URI with a Job ID, as defined in [RFC2911]. The IPP object implementation MUST support both forms of identification for every job. If possible, a client SHOULD use the Printer URI with a Job ID rather than a Job URI, since the 32-bit
设置作业属性操作(与所有作业操作一样)针对作业对象。客户机必须始终提供一些识别作业对象的方法,以便识别正确的操作目标。该作业标识可以是单个作业URI,也可以是打印机URI与作业ID的组合,如[RFC2911]中所定义。IPP对象实现必须支持每个作业的两种标识形式。如果可能,客户端应该使用带有作业ID的打印机URI,而不是作业URI,因为32位
"job-id" is more readily translated to and from other print protocols that MAY be serving as gateways into or out of the IPP implementation.
“作业id”更容易转换为其他打印协议,也更容易转换为其他打印协议,这些协议可以作为进出IPP实现的网关。
The Set Printer operations are summarized in Table 1:
表1总结了设置打印机的操作:
Table 1 - Operation-Id assignments
表1-操作Id分配
Operation Name Operation Brief description -Id
操作名称操作简要说明-Id
Set-Printer- 0x0013 Sets attribute values of the target Attributes Printer object
设置打印机-0x0013设置目标属性打印机对象的属性值
Set-Job-Attributes 0x0014 Sets attribute values of the target Job object
设置作业属性0x0014设置目标作业对象的属性值
Get-Printer- 0x0015 Gets values that are valid for Supported-Values setting "xxx-supported" attributes using the Set-Printer-Attributes operation
获取打印机-0x0015获取对使用设置打印机属性操作设置“xxx支持”属性的支持值有效的值
This OPTIONAL operation allows a client to set the values of the attributes of a Printer object. In the request, the client supplies the set of Printer keyword attribute names and values that are to be set. In the response, the Printer object returns success or rejects the entire request with indications of which attribute or attributes could not be set.
此可选操作允许客户端设置打印机对象的属性值。在请求中,客户端提供一组要设置的打印机关键字属性名称和值。在响应中,Printer对象返回成功或拒绝整个请求,并指示无法设置哪些属性。
The Printer object validates the client-supplied attributes in the Set-Printer-Attributes request. For an attribute to validate, it MUST meet all of the following rules:
打印机对象在设置打印机属性请求中验证客户端提供的属性。要验证属性,它必须满足以下所有规则:
1. The number of attributes supplied by the client MUST NOT exceed the maximum number that the Printer supports in a Set-Printer-Attributes request. A Printer MUST accept at least one attribute, but SHOULD accept a reasonable number in a single Set-Printer-Attributes request.
1. 客户端提供的属性数量不得超过打印机在“设置打印机属性”请求中支持的最大数量。打印机必须至少接受一个属性,但应在单组打印机属性请求中接受一个合理的数字。
Note: There is no way for the client to determine the maximum number of attributes that the Printer supports in a Set-Printer-Attributes request, except to try a reasonable number.
注意:客户端无法确定打印机在“设置打印机属性”请求中支持的最大属性数,除非尝试一个合理的数目。
2. The Printer MUST support the attribute.
2. 打印机必须支持该属性。
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 Appendix A for an indication of which IPP/1.1 attributes are READ-ONLY).
3. 属性不得为只读,即属性的定义不得表明属性为只读(关于哪些IPP/1.1属性为只读的指示,请参见附录A)。
4. The attribute MUST be settable in this implementation.
4. 该属性在此实现中必须是可设置的。
5. The Printer MUST support the value, according to the rules defined in Appendix A, i.e., each value of each supplied "xxx" attribute MUST be validated against the value of a corresponding "xxx-supported" Printer attribute. One of those rules permits an administrator to set arbitrary 'name' values to those "xxx-supported" Printer attributes that include the 'name' attribute syntax if the implementation supports the 'admin-define' out-of-band value for that "xxx-supported" attribute (see section 8.3 and Appendix A).
5. 根据附录A中定义的规则,打印机必须支持该值,即每个提供的“xxx”属性的每个值都必须根据相应的“xxx支持的”打印机属性的值进行验证。其中一条规则允许管理员为“xxx支持的”打印机属性设置任意“名称”值,这些属性包括“名称”属性语法,前提是实现支持该“xxx支持的”属性的“管理员定义”带外值(见第8.3节和附录A)。
6. The attribute's values MUST NOT conflict with the values of other Printer attributes, including ones being set in this same operation.
6. 该属性的值不得与其他打印机属性的值冲突,包括在此同一操作中设置的属性。
If any of the supplied attributes are not validate, the Printer object MUST reject the entire operation; the Printer object MUST NOT partially set some of the supplied attributes. In other words, after the operation, all the supplied attributes MUST be set or none of them MUST be set, thus making the Set-Printer-Attributes an atomic operation.
如果提供的任何属性未验证,打印机对象必须拒绝整个操作;打印机对象不能部分设置某些提供的属性。换句话说,在操作之后,必须设置所有提供的属性,或者不设置任何属性,从而使设置的打印机属性成为原子操作。
The Printer MUST accept this operation when its READ-ONLY "printer-state" attribute (see [RFC2911], section 4.4.11) is 'idle' or 'stopped', and SHOULD accept it when the value is 'processing'. The Printer MUST accept this operation for any of the values of the Printer object's READ-ONLY "printer-state-reasons" and "printer-is-accepting-jobs" attributes, unless explicitly defined otherwise in the definition of these attributes' values.
当打印机的只读“打印机状态”属性(见[RFC2911],第4.4.11节)为“空闲”或“停止”时,打印机必须接受此操作,当值为“处理”时,打印机应接受此操作。打印机必须接受打印机对象的只读“打印机状态原因”和“打印机正在接受作业”属性的任何值的此操作,除非在这些属性值的定义中另有明确定义。
This operation MUST NOT change the value of attributes not specified in the operation unless the definition of the attribute explicitly specifies such side-effects. For example, this document explicitly specifies that when this operation sets "printer-message-from-operator", the Printer also MUST set the READ-ONLY "printer-message-time" and READ-ONLY "printer-message-date-time" attributes to the time of the operation as a side effect. In particular, if this operation changes an "xxx-default" attribute, the new value MUST be in the "xxx-supported" attributes or the request MUST contain a new value for "xxx-supported", which contains the new value for the "xxx-default". Otherwise, the Printer MUST reject the operation. In general, Printer attribute definitions that are settable will not
除非属性定义明确指定了此类副作用,否则此操作不得更改操作中未指定的属性的值。例如,本文档明确规定,当此操作设置“来自操作员的打印机消息”时,打印机还必须将只读“打印机消息时间”和只读“打印机消息日期时间”属性设置为操作时间,作为副作用。特别是,如果此操作更改了“xxx default”属性,则新值必须在“xxx supported”属性中,或者请求必须包含“xxx supported”的新值,其中包含“xxx default”的新值。否则,打印机必须拒绝该操作。通常,无法设置可设置的打印机属性定义
define side-effects on other attributes that are settable, only side effects on READ-ONLY attributes, if any.
定义可设置的其他属性的副作用,仅定义只读属性的副作用(如果有)。
If the Printer supports the Set-Printer-Attributes operation, then it SHOULD support the setting of:
如果打印机支持设置打印机属性操作,则应支持以下设置:
all Job Template Default ("xxx-default") attributes all Job Template Supported ("xxx-supported") attributes all Job Template Ready ("xxx-ready") attributes
所有作业模板默认(“xxx默认”)属性所有支持的作业模板(“xxx支持”)属性所有作业模板就绪(“xxx就绪”)属性
that the implementation supports (see [RFC2911] section 4.2 and extensions).
实施支持(参见[RFC2911]第4.2节和扩展)。
Some Printer Description attributes (see [RFC2911] section 4.4) MUST NOT be settable, i.e., they are defined to be READ-ONLY. An attribute marked as "READ-ONLY" in the Printer Description attribute table in Appendix A is such an attribute. The Printer attributes that are not marked as "READ-ONLY" MAY be settable using the Set-Printer-Attributes operation, depending on implementation.
某些打印机描述属性(参见[RFC2911]第4.4节)不能设置,即它们被定义为只读。附录A中打印机描述属性表中标记为“只读”的属性就是此类属性。未标记为“只读”的打印机属性可以使用“设置打印机属性”操作进行设置,具体取决于实现。
Note: From now on, all extensions that define new object attributes will indicate whether or not the attributes are READ-ONLY, by including the "READ-ONLY" adjective in their descriptions and/or explicitly stating whether they MAY be settable.
注意:从现在起,所有定义新对象属性的扩展将通过在其描述中包含“只读”形容词和/或明确说明它们是否可设置来指示属性是否为只读。
The current values of each "xxx-supported" Printer attribute MUST reflect the current policy for support of the corresponding "xxx" attribute. If an "xxx-supported" Printer attribute is settable in an implementation, then its value(s) MUST affect the behavior of the implementation. If an "xxx-supported" Printer attribute is defined to be READ-ONLY or is not-settable in an implementation, then its values MUST NOT be settable using the Set-Printer-Attributes operation. Consider the following examples:
每个“支持的xxx”打印机属性的当前值必须反映支持相应“xxx”属性的当前策略。如果“支持xxx”打印机属性可在实现中设置,则其值必须影响实现的行为。如果“xxx支持的”打印机属性定义为只读或在实现中不可设置,则其值不得使用“设置打印机属性”操作进行设置。考虑下面的例子:
For example, if the "operations-supported" Printer Description attribute (see [RFC2911] section 4.4.15) is settable in a particular implementation, then changing its value with a Set-Printer-Attributes operation MUST affect the operations that the implementation accepts or rejects. Such an implementation will need to be able to reject values for operations that it contains no code support for (see section 4.3). If the "operations-supported" Printer Description attribute is not settable in a particular implementation, then that implementation MUST reject an attempt to set it with a Set-Printer-Attributes operation, return the 'client-error-attributes-not-settable' status code (see section 7.1), and return the "operations-supported" attribute,
例如,如果“支持的操作”打印机描述属性(参见[RFC2911]第4.4.15节)可在特定实现中设置,则使用设置打印机属性操作更改其值必须影响实现接受或拒绝的操作。这种实现需要能够拒绝不包含代码支持的操作的值(参见第4.3节)。如果“支持的操作”打印机描述属性在特定实现中不可设置,则该实现必须拒绝使用“设置打印机属性”操作对其进行设置的尝试,返回“客户端错误属性不可设置”状态代码(参见第7.1节),并返回“支持的操作”属性,
with the out-of-band 'not-settable' value in the Unsupported Attributes Group.
在“不支持的属性”组中使用带外“不可设置”值。
As another example, consider an implementation in which the "media-default" and "media-supported" are settable. If a client supplies a Set-Printer-Attributes request that contains the "media-default" attribute with a value that is not a member of the Printer's "media-supported" attribute, the Printer MUST reject the request and return the "client-error-conflicting-attributes" status code with the "media-default" and "media-supported" attributes and their values (see [RFC2911] section 3.1.7).
作为另一个例子,考虑一个实现“媒体默认”和“媒体支持”的实现。如果客户机提供的设置打印机属性请求包含“介质默认”属性,且该属性的值不是打印机“介质支持”属性的成员,则打印机必须拒绝该请求,并返回“客户机错误冲突属性”状态代码以及“介质默认”和“介质支持”属性及其值(见[RFC2911]第3.1.7节)。
As a third example, if a client supplies a Set-Printer-Attributes request that contains both the "media-default" and the "media-supported" attributes, but includes a value in the "media-default" that is not a member of the supplied "media-supported" attribute, the Printer MUST reject the request and return the "client-error-conflicting-attributes" status code with the "media-default" and "media-supported" attributes and their values (see [RFC2911] section 3.1.7).
作为第三个示例,如果客户端提供一个设置打印机属性请求,该请求包含“介质默认”和“介质支持”属性,但“介质默认”中包含一个值,该值不是所提供的“介质支持”属性的成员,则打印机必须拒绝该请求并返回“客户端错误冲突属性”带有“介质默认”和“介质支持”属性及其值的状态代码(参见[RFC2911]第3.1.7节)。
Access Rights: The authenticated user (see [RFC2911] section 8.3) performing this operation must be an operator or administrator of the Printer object (see [RFC2911] Sections 1 and 8.5). Most Printer attributes will require administrator access rights to set, such as "xxx-supported", while some will require operator access rights only, such as "media-ready" and "printer-message-from-operator". Which attributes require which access rights depends on implementation, and MAY depend on site policy.
访问权限:执行此操作的经过身份验证的用户(请参见[RFC2911]第8.3节)必须是打印机对象的操作员或管理员(请参见[RFC2911]第1节和第8.5节)。大多数打印机属性需要管理员访问权限才能设置,如“支持xxx”,而有些属性只需要操作员访问权限,如“介质就绪”和“操作员发送的打印机消息”。哪些属性需要哪些访问权限取决于实现,也可能取决于站点策略。
The following sets of attributes are part of the Set-Printer-Attributes Request:
以下属性集是“设置打印机属性”请求的一部分:
Group 1: Operation Attributes
第1组:操作属性
Natural Language and Character Set: The "attributes-charset" and "attributes-natural-language" attributes, as described in [RFC2911], section 3.1.4.1.
自然语言和字符集:“属性字符集”和“属性自然语言”属性,如[RFC2911]第3.1.4.1节所述。
Target: The "printer-uri" (uri) operation attribute, which is the target for this operation, as described in [RFC2911], section 3.1.5.
目标:“打印机uri”(uri)操作属性,即此操作的目标,如[RFC2911]第3.1.5节所述。
Requesting User Name: The "requesting-user-name" (name(MAX)) attribute SHOULD be supplied by the client, as described in [RFC2911], section 8.3.
请求用户名:“请求用户名”(Name(MAX))属性应由客户机提供,如[RFC2911]第8.3节所述。
"document-format" (mimeMediaType): The client OPTIONALLY supplies this attribute. The Printer object MUST support this attribute. This attribute is useful for a client to select the document-format to which the attribute modification should be applied. A Printer implementation MAY allow some attributes to have different values for each document format that it supports. See [RFC2911], section 3.2.5.1 "Get-Printer-Attributes Request".
“文档格式”(mimeMediaType):客户机可以选择提供此属性。打印机对象必须支持此属性。此属性对于客户端选择属性修改应应用到的文档格式非常有用。打印机实现可能允许某些属性对其支持的每种文档格式具有不同的值。请参阅[RFC2911],第3.2.5.1节“获取打印机属性请求”。
If the client includes this attribute, the Printer MUST change the supplied attributes for the document format specified by this attribute. If a supplied attribute is a member of the "document-format-varying-attributes" (i.e., the attribute varies by document format, see section 6.3), the Printer MUST change the supplied attribute for the document format specified by this attribute, but not for other document formats. If a supplied attribute isn't a member of the "document-format-varying-attributes" (i.e., it doesn't vary by document format), the Printer MUST change the supplied attribute for all document formats.
如果客户端包含此属性,打印机必须更改为此属性指定的文档格式提供的属性。如果提供的属性是“文档格式变化属性”的成员(即,属性因文档格式而变化,请参见第6.3节),则打印机必须为该属性指定的文档格式更改提供的属性,但不能为其他文档格式更改提供的属性。如果提供的属性不是“文档格式变化属性”的成员(即,它不随文档格式变化),则打印机必须更改所有文档格式的提供属性。
If the client omits this attribute, the Printer MUST change the supplied attributes for all document formats, whether or not they vary by document-format.
如果客户端忽略此属性,则打印机必须更改为所有文档格式提供的属性,无论这些属性是否因文档格式而异。
If the client supplies a value for the "document-format" Operation attribute, that is either 'application/octet-stream' or not supported by the Printer, i.e., is not among the values of the Printer object's "document-format-supported" attribute, the Printer object MUST reject the operation and return the 'client-error-document-format-not-supported' status code. Note: the document-format 'application/octet-stream' is the union of several document-formats (see [RFC2911] section 3.2.5.1, Get-Printer-Attributes) and is not a true document-format.
如果客户端为“文档格式”操作属性提供值,即“应用程序/八位字节流”或打印机不支持,即不在打印机对象的“支持的文档格式”属性的值中,打印机对象必须拒绝该操作并返回“客户端错误文档格式不受支持”状态代码。注:文件格式“应用程序/八位字节流”是多种文件格式的联合(见[RFC2911]第3.2.5.1节,获取打印机属性),不是真正的文件格式。
Group 2: Printer Attributes
组2:打印机属性
The client MUST supply a set of Printer attributes with one or more values (including explicitly allowed out-of-band values) as defined in [RFC2911] section 4.2 Job Template Attributes ("xxx-default", "xxx-supported", and "xxx-ready" attributes), section 4.4 Printer Description Attributes, and any attribute extensions supported by the Printer. The value(s) of each Printer attribute
客户机必须提供一组打印机属性,其中包含[RFC2911]第4.2节作业模板属性(“xxx默认”、“xxx支持”和“xxx准备”属性)、第4.4节打印机描述属性以及打印机支持的任何属性扩展中定义的一个或多个值(包括明确允许的带外值)。每个打印机属性的值
supplied in Group 2 replaces the value(s) of the corresponding Printer attribute on the target Printer object. For attributes that can have multiple values (1setOf), all values supplied by the client replace all values of the corresponding Printer object attribute. If a Printer object attribute had not yet been configured, and so assumed the 'no-value' out-of-band value (see [RFC2911] section 4.1), the supplied value(s) replaces the 'no-value' value.
组2中提供的值替换目标打印机对象上相应打印机属性的值。对于可以具有多个值的属性(1setOf),客户端提供的所有值将替换相应打印机对象属性的所有值。如果尚未配置打印机对象属性,因此假定带外值为“无值”(参见[RFC2911]第4.1节),则提供的值将替换“无值”值。
The Printer object returns the following sets of attributes as part of the Get-Printer-Attributes Response:
打印机对象返回以下属性集,作为获取打印机属性响应的一部分:
Group 1: Operation Attributes
第1组:操作属性
Status Message: In addition to the REQUIRED status code returned in every response, the response OPTIONALLY includes a "status-message" (text(255)) and/or a "detailed-status-message" (text(MAX)) operation attribute, as described in [RFC2911] sections 3.1.6 and 13.
状态消息:除了在每个响应中返回所需的状态代码外,响应还可选地包括“状态消息”(文本(255))和/或“详细状态消息”(文本(最大))操作属性,如[RFC2911]第3.1.6和13节所述。
Natural Language and Character Set: The "attributes-charset" and "attributes-natural-language" attributes, as described in [RFC2911], section 3.1.4.2.
自然语言和字符集:“属性字符集”和“属性自然语言”属性,如[RFC2911]第3.1.4.2节所述。
Group 2: Unsupported Attributes
第2组:不支持的属性
See [RFC2911], section 3.1.7, for details on returning Unsupported Attributes.
有关返回不支持的属性的详细信息,请参见[RFC2911],第3.1.7节。
If some of the attributes in the operation fail to validate, the Printer MUST reject the operation, MUST NOT change any Printer attributes, and MUST return the indicated status code below. In this group, the Printer MUST also return all attributes that fail to validate. The following are the reasons that an attribute fails to validate and the value returns for the attribute, along with the indicated status code and order of detection:
如果操作中的某些属性无法验证,打印机必须拒绝该操作,不得更改任何打印机属性,并且必须返回下面指示的状态代码。在此组中,打印机还必须返回所有无法验证的属性。以下是属性无法验证和属性返回值的原因,以及指示的状态代码和检测顺序:
1. The number of attributes supplied by the client exceeds the maximum number that the Printer supports in a Set-Printer-Attributes request: return the 'client-error-request-entity-too-large' (see [RFC2911], section 13.1.4.9).
1. 客户端提供的属性数量超过了打印机在设置打印机属性请求中支持的最大数量:返回“客户端错误请求实体太大”(请参阅[RFC2911],第13.1.4.9节)。
2. The Printer doesn't support the attribute: return the attribute with the "out-of-band" value 'unsupported' (see [RFC2911] section 3.1.7 and [RFC2910]) and the 'client-error-attributes-or-values-not-supported (see [RFC2911], section 13.1.4.12).
2. 打印机不支持该属性:返回“带外”值为“不支持”的属性(参见[RFC2911]第3.1.7节和[RFC2910])和“不支持的客户端错误属性或值”(参见[RFC2911]第13.1.4.12节)。
3. The attribute is either READ-ONLY (in its definition) or is not-settable in this implementation: return the attribute with the "out-of-band" value 'not-settable' (see section 8.1) and the 'client-error-attributes-not-settable' status code (see section 7.1).
3. 该属性为只读(在其定义中)或在此实现中不可设置:返回带有“带外”值“不可设置”(参见第8.1节)和“客户端错误属性不可设置”状态代码(参见第7.1节)的属性。
4. The Printer doesn't support the value: if the attribute in the operation has a single value, return it. If the attribute in the operation is multi-valued, return only those values in a 1setOf that are not supported. Return the 'client-error-attributes-or-values-not-supported' status code (see [RFC2911], section 13.1.4.12).
4. 打印机不支持该值:如果操作中的属性只有一个值,则返回该值。如果操作中的属性是多值的,则仅返回1setOf中不受支持的值。返回“不支持的客户端错误属性或值”状态代码(请参阅[RFC2911],第13.1.4.12节)。
5. The values of some of the supplied attributes conflict with one another and/or other Printer attribute values not being set: if the conflicting attribute in the operation has a single value, return the attribute and the value. If the attribute in the operation is multi-valued, return only the attribute and those values in a 1setOf that are conflicting with other attributes. Return the 'client-error-conflicting-attributes' status code (see [RFC2911], section 13.1.4.15).
5. 提供的某些属性的值相互冲突和/或未设置其他打印机属性值:如果操作中的冲突属性具有单个值,则返回属性和值。如果操作中的属性是多值的,则仅返回该属性以及1setOf中与其他属性冲突的值。返回“客户端错误冲突属性”状态代码(参见[RFC2911],第13.1.4.15节)。
This OPTIONAL operation allows a client to set the values of the attributes of a Job object. In the request, the client supplies the set of Job keyword attribute names and values that are to be set. In the response, the IPP object returns success or rejects the entire request with indications of which attribute or attributes could not be set.
此可选操作允许客户端设置作业对象属性的值。在请求中,客户端提供一组要设置的作业关键字属性名称和值。在响应中,IPP对象返回成功或拒绝整个请求,并指示无法设置哪些属性。
This operation is almost identical to the Set-Printer-Attributes operation and follows the same rules for validation (see section 4.1). The only differences are that the Set-Job-Attributes operation is directed at a Job object rather than a Printer object, there is no "document-format" operation attribute used when setting a Job object, the operation can add an attribute to the (Job) object, the 'delete-attributes' out-of-band value is permitted to remove an attribute, and the validation is the same as the Job Creation operations (Print-Job, Print-URI, and Create-Job), i.e., depends on the "xxx-supported" Printer Description attributes (see [RFC2911] section 3.1). Using the Set-Printer-Attributes operation, the administrator can set arbitrary 'name' values to those "xxx-supported" Printer
此操作与设置打印机属性操作几乎相同,并遵循相同的验证规则(请参见第4.1节)。唯一的区别是,设置作业属性操作针对的是作业对象而不是打印机对象,设置作业对象时没有使用“文档格式”操作属性,该操作可以向(作业)对象添加属性,“删除属性”带外值允许删除属性,验证与作业创建操作(打印作业、打印URI和创建作业)相同,即取决于“支持xxx”的打印机描述属性(请参见[RFC2911]第3.1节)。使用“设置打印机属性”操作,管理员可以将任意“名称”值设置为“xxx支持的”打印机
attributes, that include the 'name' attribute syntax, if the implementation supports the 'admin-define' out-of-band value for that "xxx-supported" attribute (see section 8.3 and Appendix A). However, the Set-Job-Attributes cannot be used to add unsupported names to the Job object.
属性,包括“name”属性语法,如果实现支持“xxx支持”属性的“admin define”带外值(参见第8.3节和附录A)。但是,“设置作业属性”不能用于向作业对象添加不受支持的名称。
If a client supplies a job attribute in a Set-Job-Attributes request that the Printer supports, and the job was originally submitted without supplying that attribute, the Printer adds the attribute to the Job object.
如果客户机在打印机支持的“设置作业属性”请求中提供了作业属性,并且最初提交作业时未提供该属性,则打印机会将该属性添加到作业对象中。
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 attribute and all of its values from the Job object, if present. The 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 not been supplied with the Job object in the Job Creation operation, i.e., the Printer applies its default attribute or behavior with lower precedence that the PDL (see the beginning of [RFC2911] section 4.2 and [RFC2911] 3.2.1.1). Any subsequent query of the Job object using Get-Job-Attributes or Get-Jobs, MUST NOT return any attribute that has been deleted using the 'delete-attribute' out-of-band value. However, a client can re-establish such a deleted Job attribute with any supported value(s), using a subsequent Set-Job-Attributes operation.
如果客户机为作业属性提供“带外”值“删除属性”(请参阅第8.2节),则打印机必须从作业对象(如果存在)中删除该属性及其所有值。在“设置作业属性”操作中提供“删除属性”值的客户端的语义效果必须与在作业创建操作中未随作业对象提供属性的情况相同,即打印机应用其默认属性或行为的优先级低于PDL(请参阅[RFC2911]开头部分)第4.2节和[RFC2911]3.2.1.1)节)。使用Get Job Attributes或Get Jobs对作业对象的任何后续查询不得返回已使用“delete attribute”带外值删除的任何属性。但是,客户端可以使用后续的“设置作业属性”操作,使用任何支持的值重新建立这样一个已删除的作业属性。
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 Job object, the Printer ignores that supplied attribute in the request, does not return the attribute in the Unsupported Attributes group, and returns the 'successful-ok' status code, if there are no other problems with the request.
如果客户端在“设置作业属性”请求中提供了具有“删除属性”值的属性,而该属性在作业对象上不存在,则打印机将忽略请求中提供的属性,不返回“不支持的属性”组中的属性,并返回“成功确定”状态代码,如果请求没有其他问题。
The validation of the Set-Job-Attributes request is performed by the Printer as if the job had been submitted originally with the new attribute values (and the deleted attributes removed) and with "ipp-attribute-fidelity" set to 'true', i.e., all modified attributes Job attributes and values MUST be supported in combination with the Job attributes not modified. If such a Job Creation operation would have been accepted, then the Set-Job-Attributes MUST be accepted. If such a Job Creation operation would have been rejected, then the Set-Job-Attributes MUST be rejected and the Job MUST be unchanged. In addition, if any of the supplied attributes are not supported, are not settable, or the values are not supported, the Printer object MUST reject the entire operation; the Printer object MUST NOT partially set some of the supplied attributes. In other words, after
设置作业属性请求的验证由打印机执行,就像作业最初提交时带有新属性值(删除的属性)且“ipp属性保真度”设置为“真”,即。,所有修改的属性作业属性和值必须与未修改的作业属性结合使用。如果已接受此类作业创建操作,则必须接受设置的作业属性。如果这样的作业创建操作将被拒绝,则必须拒绝设置的作业属性,并且作业必须保持不变。此外,如果提供的任何属性不受支持、不可设置或不支持值,则打印机对象必须拒绝整个操作;打印机对象不能部分设置某些提供的属性。换句话说,在
the operation, all the supplied attributes MUST be set or none of them MUST be set, thus making the Set-Job-Attributes an atomic operation.
在该操作中,必须设置所有提供的属性或不设置任何属性,从而使设置的作业属性成为原子操作。
The IPP object MUST accept or reject this operation when the Job's READ-ONLY "job-state" attribute has the values shown in Table 2. The job's current state MUST affect whether the IPP object accepts or rejects the request. For example, in the case where the operation creates a request for unavailable resources, the Job transitions to a new state. Table 2 shows the allowed behaviors in each job state and the transitions.
当作业的只读“作业状态”属性的值如表2所示时,IPP对象必须接受或拒绝此操作。作业的当前状态必须影响IPP对象是否接受或拒绝请求。例如,在操作创建不可用资源请求的情况下,作业将转换到新状态。表2显示了每个作业状态和转换中允许的行为。
Table 2 - Job State Transition Table for the Set-Job-Attributes operation
表2-设置作业属性操作的作业状态转换表
Current New IPP object's response status code "job-state" "job-state" and "action":
当前新IPP对象的响应状态代码“作业状态”、“作业状态”和“操作”:
'pending' 'pending' 'successful-ok'
“挂起”“挂起”“成功确定”
'pending' 'pending-held' 'successful-ok' - needed resources are not ready
“挂起”“挂起”“成功确定”-所需资源未就绪
'pending-held' 'pending-held' 'successful-ok'
“挂起挂起”“挂起挂起”“成功确定”
'pending-held' 'pending' 'successful-ok' - needed resources are ready
“挂起”“挂起”“成功确定”-所需资源已准备就绪
'processing' 'processing' 'successful-ok' or 'client-error-not-possible' depending on implementation, including the attributes being set, whether the job has started marking media, etc.
“正在处理”“正在处理”“成功确定”或“客户端错误不可能”,具体取决于实现,包括正在设置的属性、作业是否已开始标记媒体等。
'processing- 'processing- 'successful-ok' or 'client-error-stopped' stopped' not-possible' depending on implementation, including the attributes being set, whether the job has started marking media, etc.
“处理-”处理-“成功确定”或“客户端错误已停止”已停止“不可能”,具体取决于实现,包括正在设置的属性、作业是否已开始标记介质等。
'completed' 'completed' 'client-error-not-possible'
“已完成”“已完成”“客户端错误不可能”
'canceled' 'canceled' 'client-error-not-possible'
“已取消”“已取消”“客户端错误不可能”
'aborted' 'aborted' 'client-error-not-possible'
“已中止”“已中止”“客户端错误不可能”
This operation MUST NOT change the value of attributes not specified in the operation unless the definition of the attribute explicitly specifies such side-effects. In general, Job attribute definitions that are settable will not define side-effects on other attributes that are settable, only side effects on READ-ONLY attributes, if any.
除非属性定义明确指定了此类副作用,否则此操作不得更改操作中未指定的属性的值。通常,可设置的作业属性定义不会定义对其他可设置属性的副作用,仅定义对只读属性(如果有)的副作用。
If the Printer supports the "job-message-from-operator" Job Description attribute (see [RFC2911] section 4.3.16) and the client explicitly supplies a new value for the "job-message-from-operator" Job Description attribute in Group 2 in the Set-Job-Attributes request, then the Printer MUST set the "job-message-from-operator" Job Description attribute to this new value.
如果打印机支持“来自操作员的作业消息”作业描述属性(请参阅[RFC2911]第4.3.16节),并且客户端在“设置作业属性”请求中为组2中的“来自操作员的作业消息”作业描述属性显式提供新值,则打印机必须设置“来自操作员的作业消息”此新值的职务说明属性。
If the Printer supports the Set-Job-Attributes operation, then it SHOULD support the setting of:
如果打印机支持设置作业属性操作,则应支持以下设置:
all Job Template job ("xxx") attributes
所有作业模板作业(“xxx”)属性
that the implementation supports (see [RFC2911] section 4.2 and extensions).
实施支持(参见[RFC2911]第4.2节和扩展)。
Some Job Description attributes (see [RFC2911] section 4.3) MUST NOT be 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 such an attribute. The Job attributes not marked as "READ-ONLY" MAY be settable using the Set-Job-Attributes operation, depending on implementation.
某些职务描述属性(见[RFC2911]第4.3节)不能设置,即它们被定义为只读。附录A中职务描述属性表中标记为“只读”的属性就是这样一个属性。未标记为“只读”的作业属性可以使用“设置作业属性”操作进行设置,具体取决于实现。
Note: From now on, all extensions that define new object attributes will indicate whether or not the attributes are READ-ONLY, by including the "READ-ONLY" adjective in their descriptions and/or explicitly stating whether they MAY be settable.
注意:从现在起,所有定义新对象属性的扩展将通过在其描述中包含“只读”形容词和/或明确说明它们是否可设置来指示属性是否为只读。
Access Rights: The authenticated user (see [RFC2911] section 8.3) performing this operation must either be the job owner (as determined in the Job Creation operation) or an operator or administrator of the Printer object (see [RFC2911] Sections 1 and 8.5).
访问权限:执行此操作的经过身份验证的用户(请参见[RFC2911]第8.3节)必须是作业所有者(在作业创建操作中确定)或打印机对象的操作员或管理员(请参见[RFC2911]第1节和第8.5节)。
The following sets of attributes are part of the Set-Job-Attributes Request:
以下属性集是“设置作业属性”请求的一部分:
Group 1: Operation Attributes
第1组:操作属性
Natural Language and Character Set: The "attributes-charset" and "attributes-natural-language" attributes as described in [RFC2911], section 3.1.4.1.
自然语言和字符集:“属性字符集”和“属性自然语言”属性如[RFC2911]第3.1.4.1节所述。
Target: Either (1) the "printer-uri" (uri) plus "job-id" (integer(1:MAX)) or (2) the "job-uri" (uri) operation attribute(s), which defines the target for this operation as described in [RFC2911], section 3.1.5.
目标:要么(1)“打印机uri”(uri)加上“作业id”(整数(1:MAX))要么(2)“作业uri”(uri)操作属性,如[RFC2911]第3.1.5节所述,定义此操作的目标。
Requesting User Name: The "requesting-user-name" (name(MAX)) attribute SHOULD be supplied by the client, as described in [RFC2911], section 8.3.
请求用户名:“请求用户名”(Name(MAX))属性应由客户机提供,如[RFC2911]第8.3节所述。
Group 2: Job Attributes
第2组:作业属性
The client MUST supply a set of Job attributes with one or more values (including explicitly allowed out-of-band values) as defined in [RFC2911], section 4.2, Job Template Attributes ("xxx" attributes), section 4.3, Job Description Attributes, and any attribute extensions supported by the Printer. The value(s) of each Job attribute supplied in Group 2 replaces the value(s) of the corresponding Job attribute on the target Job object. For attributes that can have multiple values (1setOf), all values supplied by the client replace all values of the corresponding Job object attribute.
客户机必须提供一组作业属性,其中包含[RFC2911],第4.2节,作业模板属性(“xxx”属性),第4.3节,作业描述属性以及打印机支持的任何属性扩展中定义的一个或多个值(包括明确允许的带外值)。组2中提供的每个作业属性的值替换目标作业对象上相应作业属性的值。对于可以具有多个值的属性(1setOf),客户端提供的所有值将替换相应作业对象属性的所有值。
If the client supplies an "xxx" attribute with the 'delete-attribute' out-of-band value (see section 8.2), the Printer MUST remove the "xxx" attribute from the Job object, if present.
如果客户端提供带外值为“删除属性”的“xxx”属性(参见第8.2节),打印机必须从作业对象中删除“xxx”属性(如果存在)。
The IPP object returns the following sets of attributes as part of the Set-Job-Attributes Response:
IPP对象返回以下属性集,作为Set Job attributes响应的一部分:
Group 1: Operation Attributes
第1组:操作属性
Status Message: In addition to the REQUIRED status code returned in every response, the response OPTIONALLY includes a "status-message" (text(255)) and/or a "detailed-status-message" (text(MAX)) operation attribute as described in [RFC2911], sections 3.1.6 and 13.
状态消息:除了在每个响应中返回所需的状态代码外,响应还可选地包括“状态消息”(文本(255))和/或“详细状态消息”(文本(最大))操作属性,如[RFC2911]第3.1.6和13节所述。
Natural Language and Character Set: The "attributes-charset" and "attributes-natural-language" attributes as described in [RFC2911], section 3.1.4.2.
自然语言和字符集:“属性字符集”和“属性自然语言”属性如[RFC2911]第3.1.4.2节所述。
Group 2: Unsupported Attributes
第2组:不支持的属性
See [RFC2911], section 3.1.7, for details on returning Unsupported Attributes.
有关返回不支持的属性的详细信息,请参见[RFC2911],第3.1.7节。
If some of the attributes in the operation fail to validate, the Printer MUST reject the operation, MUST NOT change any Job attributes, and MUST return the indicated status code below. In this group, the Printer MUST also return all attributes that fail to validate. The following are the reasons that an attribute fails to validate and the value returns for the attribute, along with the indicated status code and order of detection:
如果操作中的某些属性无法验证,打印机必须拒绝该操作,不得更改任何作业属性,并且必须返回下面指示的状态代码。在此组中,打印机还必须返回所有无法验证的属性。以下是属性无法验证和属性返回值的原因,以及指示的状态代码和检测顺序:
1. The number of attributes supplied by the client exceeds the maximum number that the Printer supports in a Set-Printer-Attributes request: return the 'client-error-request-entity-too-large' (see [RFC2911], section 13.1.4.9).
1. 客户端提供的属性数量超过了打印机在设置打印机属性请求中支持的最大数量:返回“客户端错误请求实体太大”(请参阅[RFC2911],第13.1.4.9节)。
2. The Printer doesn't support the attribute: return the attribute with the 'unsupported' out-of-band attribute value (see [RFC2911], section 3.1.7 and [RFC2910]) and the 'client-error-attributes-or-values-not-supported (see [RFC2911], section 13.1.4.12).
2. 打印机不支持该属性:返回带有“不支持的”带外属性值的属性(请参阅[RFC2911],第3.1.7节和[RFC2910])和“不支持的客户端错误属性或值”(请参阅[RFC2911],第13.1.4.12节)。
3. The attribute is READ-ONLY (in its definition) or is not-settable in this implementation: return the attribute with the 'not-settable' out-of-band attribute value (see section 8.1) and the 'client-error-attributes-not-settable' status code (see section 7.1).
3. 该属性为只读(在其定义中)或在此实现中不可设置:返回带有“不可设置”带外属性值(参见第8.1节)和“客户端错误属性不可设置”状态代码(参见第7.1节)的属性。
4. The Printer doesn't support the value: if the attribute in the operation has a single value return it. If the attribute in the operation is multi-valued, return only those values in a 1setOf that are not supported. Return the 'client-error-attributes-or-values-not-supported' status code (see [RFC2911], section 13.1.4.12).
4. 打印机不支持该值:如果操作中的属性只有一个值,则返回该值。如果操作中的属性是多值的,则仅返回1setOf中不受支持的值。返回“不支持的客户端错误属性或值”状态代码(请参阅[RFC2911],第13.1.4.12节)。
5. The values of some of the supplied attributes conflict with one another and/or other Job attribute values not being set: if the conflicting attribute in the operation has a single value, return the attribute and the value. If the attribute in the operation is multi-valued, return only the attribute and those values in a 1setOf that are conflicting with other attributes. Return the 'client-error-conflicting-attributes' status code (see [RFC2911],y section 13.1.4.15).
5. 提供的某些属性的值相互冲突和/或未设置的其他作业属性值:如果操作中的冲突属性具有单个值,则返回属性和值。如果操作中的属性是多值的,则仅返回该属性以及1setOf中与其他属性冲突的值。返回“客户端错误冲突属性”状态代码(参见[RFC2911],y第13.1.4.15节)。
This OPTIONAL operation allows a client to request the values that the Printer allows in the Set-Printer-Attributes operation for "xxx-supported" attributes. If the Printer supports the Set-Printer-Attributes operation AND some of its "xxx-supported" Printer attributes are settable, then the Printer MUST also support this operation.
此可选操作允许客户端请求打印机在设置打印机属性操作中为“支持xxx”属性允许的值。如果打印机支持设置打印机属性操作,并且其某些“xxx支持的”打印机属性是可设置的,则打印机也必须支持此操作。
The Printer MUST return in the Get-Printer-Supported-Values response, those, and only those, "xxx-supported" Printer attributes that it supports setting with the Set-Printer-Attributes operation. Furthermore, if a client requests the value of an attribute that is not settable or is not supported (as in the Get-Printer-Attributes response), the Unsupported Attributes Group of the response NEED NOT contain the "requested-attributes" operation attribute with any such requested (attribute keyword) values.
打印机必须在Get Printer Supported Values(获取打印机支持的值)响应中返回这些属性,并且仅返回其支持使用Set Printer attributes(设置打印机属性)操作设置的“xxx支持的”打印机属性。此外,如果客户端请求不可设置或不受支持的属性值(如Get Printer Attributes响应中),则响应的Unsupported Attributes(不受支持的属性)组不需要包含具有任何此类请求(属性关键字)值的“requested Attributes”(请求的属性)操作属性。
This operation has identical request/response attributes to the Get-Printer-Attributes operation in IPP/1.1 [RFC2911]. The operation also behaves identically to the Get-Printer-Attributes operation in IPP/1.1 [RFC2911], with the following exceptions:
此操作与IPP/1.1[RFC2911]中的“获取打印机属性”操作具有相同的请求/响应属性。该操作的行为与IPP/1.1[RFC2911]中的“获取打印机属性”操作相同,但以下情况除外:
1. The Get-Printer-Supported-Values operation supports only "xxx-supported" attributes.
1. “获取打印机支持的值”操作仅支持“xxx支持的”属性。
2. The Get-Printer-Attributes operation returns the few "xxx-supported" attributes that are defined to be single valued, such as "page-ranges-supported" (boolean) or "pdl-override-supported" (type2 keyword), as single values, while Get-Printer-Supported-
2. Get Printer Attributes(获取打印机属性)操作将定义为单值的少数“支持xxx”属性(如“支持的页面范围”(布尔值)或“支持的pdl覆盖”(type2关键字)作为单值返回,而Get Printer supported(获取打印机支持))-
Values returns the possible values that can be set as a 1setOf of the same attribute syntax type (See Appendix B: Attributes returned from Get-Printer-Supported-Values).
Values返回可以设置为相同属性语法类型的1setOf的可能值(请参阅附录B:从Get Printer Supported Values返回的属性)。
3. The Get-Printer-Attributes operation returns the current values of requested attributes, while the Get-Printer-Supported-Values operation returns the values that are inherently supported by the implementation code, i.e., the values that an administrative client can set in a Set-Printer-Attributes request.
3. Get Printer Attributes(获取打印机属性)操作返回请求属性的当前值,而Get Printer Supported values(获取打印机支持的值)操作返回实现代码固有支持的值,即管理客户端可以在set Printer Attributes(设置打印机属性)请求中设置的值。
4. The Get-Printer-Attributes operation returns the current values of requested "xxx-supported" attributes that the Printer is configured to accept in Job Creation operations, including additional values defined by the administrator, while the Get-Printer-Supported-Values operation returns only the values of "xxx-supported" attributes that are inherently supported by the implementation and does not return any additional values defined by the administrator, where the implementation supports the 'admin-define' out-of-band value.
4. Get Printer Attributes(获取打印机属性)操作返回打印机在创建作业操作中配置为接受的请求的“支持的xxx”属性的当前值,包括管理员定义的其他值,而Get Printer supported values(获取打印机支持的值)操作仅返回“支持的xxx”的值实现本身支持的属性,并且不返回管理员定义的任何附加值,其中实现支持“admin define”带外值。
5. The Get-Printer-Attributes never returns the 'admin-define' out-of-band attribute value, while the Get-Printer-Supported-Attributes operation does, if the implementation allows the administrator to define name values by setting that "xxx-supported" attribute with any 'name' value(s).
5. 如果实现允许管理员通过将“xxx支持”属性设置为任何“名称”值来定义名称值,则Get Printer属性永远不会返回“admin define”带外属性值,而Get Printer Supported Attributes操作则会返回。
6. The Get-Printer-Attributes operation only requires end-user access rights, while the Get-Printer-Supported-Values requires administrator access rights.
6. “获取打印机属性”操作只需要最终用户访问权限,而“获取打印机支持的值”需要管理员访问权限。
Access Rights: The authenticated user (see [RFC2911], section 8.3) performing this operation must be an administrator of the Printer object (see [RFC2911], Sections 1 and 8.5).
访问权限:执行此操作的经过身份验证的用户(请参阅[RFC2911],第8.3节)必须是打印机对象的管理员(请参阅[RFC2911],第1节和第8.5节)。
4.3.1 Definition of the usage of the 'admin-define' out-of-band attribute value
4.3.1 “admin define”带外属性值用法的定义
If the Set-Printer-Attributes operation allows the System Administrator to define arbitrary 'name' values for an "xxx-supported" attribute, then the Get-Printer-Supported-Values operation MUST return the 'admin-define' out-of-band attribute value (see section 8.3) as one of the values of the "xxx-supported" attribute. In other words, the 'admin-define' out-of-band attribute value indicates that the Printer implementation supports clients setting arbitrary 'name' attribute syntax values for that "xxx-supported" attribute using the Set-Printer-Attributes operation, as long as the attribute is defined with the 'name' attribute syntax.
如果“设置打印机属性”操作允许系统管理员为“支持的xxx”属性定义任意“名称”值,则“获取打印机支持的值”操作必须将“管理员定义”带外属性值(参见第8.3节)作为“支持的xxx”属性的值之一返回。换句话说,“admin define”带外属性值表示打印机实现支持客户端使用“Set Printer Attributes”操作为“xxx supported”属性设置任意“name”属性语法值,只要该属性是使用“name”属性语法定义的。
For example, if the Get-Printer-Supported-Values operation returns several keywords as the value of the "media-supported" attribute, then the Set-Printer-Attributes operation MUST accept any of these keywords as values for the "media-supported" attribute. If the Get-Printer-Supported-Values operation returns an 'admin-define' out-of-band attribute value as one of the values of the "media-supported" attribute, then the Set-Printer-Attributes operation MUST accept any value whose attribute syntax is 'name', as a value for the "media-supported" attribute (provided that the user is properly authenticated to use the Set-Printer-Attributes operation, e.g., has administrative access rights).
例如,如果“获取打印机支持的值”操作返回多个关键字作为“支持的介质”属性的值,则“设置打印机属性”操作必须接受其中任何关键字作为“支持的介质”属性的值。如果“获取打印机支持的值”操作将“管理定义”带外属性值作为“支持的介质”属性的值之一返回,则“设置打印机属性”操作必须接受属性语法为“名称”的任何值作为“支持的介质”属性的值(前提是用户经过正确的身份验证,可以使用“设置打印机属性”操作,例如,具有管理访问权限)。
The Get-Printer-Supported-Values MAY return the 'admin-define' out-of-band attribute value for any IPP/1.1 or extension Job Template attribute if the implementation supports allowing the System Administrator to add values to the "xxx-supported" attribute using the Set-Printer-Attributes operation. In this case, the Printer MUST accept any 'name' value of the correct attribute syntax in a Set-Printer-Attributes operation that is setting that attribute. For "xxx-supported" attributes that are defined with a choice of attribute syntaxes, such as 'keyword | name', it is the 'name' attribute syntax that the System Administrator can use to add new values, not the 'keyword' attribute syntax. For IPP/1.1, this requirement includes the following Job Template attributes:
如果实现支持允许系统管理员使用“设置打印机属性”操作向“支持xxx”属性添加值,则“获取打印机支持的值”可能会返回任何IPP/1.1或扩展作业模板属性的“管理定义”带外属性值。在这种情况下,打印机必须在设置属性的“设置打印机属性”操作中接受正确属性语法的任何“名称”值。对于使用属性语法选择定义的“xxx支持的”属性,例如“关键字|名称”,系统管理员可以使用“名称”属性语法来添加新值,而不是“关键字”属性语法。对于IPP/1.1,此要求包括以下作业模板属性:
media-supported job-hold-until-supported job-sheets-supported
介质支持的作业保留,直到支持的作业表
Implementations that support additional Job Template attributes that include the 'name' attribute syntax, MAY use the 'admin-define' out-of-band value with them.
支持包含“name”属性语法的其他作业模板属性的实现可能会使用“admin define”带外值。
If the 'admin-define' out-of-band attribute value is not one of the values of an "xxx-supported" attribute returned in a Get-Printer-Supported-Values response, then the Printer MUST NOT allow the Set-Printer-Attributes operation for that attribute to contain a value that is not one of the explicit 'keyword' or 'name' values returned in a Get-Printer-Supported-Values response.
如果“admin define”带外属性值不是Get Printer supported values响应中返回的“xxx supported”属性值之一,然后,打印机不得允许该属性的“设置打印机属性”操作包含的值不是Get Printer Supported values响应中返回的显式“关键字”或“名称”值之一。
See Appendix B: Attributes returned from Get-Printer-Supported-Values for a full list of values returned by this operation.
有关此操作返回的值的完整列表,请参阅附录B:从获取打印机支持的值返回的属性。
5 New Operation attributes
5个新的操作属性
This section defines new operation attributes for use with the IPP/1.1 operations indicated. As new operations are defined, they will also indicate explicitly whether these operation attributes are defined for use with them.
本节定义了用于所示IPP/1.1操作的新操作属性。在定义新操作时,它们还将明确指示是否定义了这些操作属性以供使用。
The Printer SHOULD support this Operation attribute in following operations if it supports the corresponding "printer-message-from-operator" Printer Description attribute.
如果打印机支持相应的“来自操作员的打印机消息”打印机描述属性,则在以下操作中应支持此操作属性。
Pause-Printer Resume-Printer Purge-Jobs
暂停打印机恢复打印机清除作业
The client OPTIONALLY supplies this Operation attribute in the above operations. The value of this attribute is a message from the operator about the Printer object on which the operator is performing the operation. If this operation attribute is supported, the Printer copies the value to its "printer-message-from-operator" Printer Description attribute (see [RFC2911], section 4.4.25), even if this Operation attribute is a zero-length text value or consists solely of white space.
客户机在上述操作中可选地提供此操作属性。此属性的值是来自操作员的关于操作员正在其上执行操作的打印机对象的消息。如果支持此操作属性,打印机会将该值复制到其“来自操作员的打印机消息”打印机描述属性(请参阅[RFC2911],第4.4.25节),即使此操作属性为零长度文本值或仅包含空白。
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 [RFC2911] section 4.1) to indicate that the operator has sent no message. In this case, the Printer sets the value of the "printer-message-from-operator" to the zero-length value or 'no-value' out-of-band value, respectively. If the client queries the "printer-message-from-operator" Printer attribute, the Printer returns the attribute with the zero-length value or the 'no-value' value, respectively.
如果打印机支持此操作属性,则必须同时支持零长度文本值和“无值”带外值(请参阅[RFC2911]第4.1节),以指示操作员未发送任何消息。在这种情况下,打印机将“来自操作员的打印机消息”的值分别设置为零长度值或“无值”带外值。如果客户端查询“来自操作员的打印机消息”打印机属性,打印机将分别返回长度为零或“无值”的属性。
In addition, the Printer automatically copies:
此外,打印机还会自动复制:
1. the value of its "printer-up-time" attribute (see [RFC2911], section 4.4.29) to its "printer-message-time" attribute,
1. 将其“打印机启动时间”属性(见[RFC2911],第4.4.29节)的值更改为“打印机消息时间”属性,
2. the value of its printer-current-time" (dateTime) attribute (see [RFC2911], section 4.4.30) to its "printer-message-date-time" attribute, if supported.
2. 其打印机当前时间(dateTime)属性的值(参见[RFC2911],第4.4.30节)为其“打印机消息日期时间”属性(如果支持)。
If the client omits this operation attribute, the Printer does not change the value of its "printer-message-from-operator", "printer-message-time" and "printer-message-date-time" Printer Description attributes.
如果客户端忽略此操作属性,则打印机不会更改其“来自操作员的打印机消息”、“打印机消息时间”和“打印机消息日期时间”打印机描述属性的值。
The "printer-message-from-operator" operation attribute MUST NOT be supported as an operation attribute for the Set-Printer-Attributes operation. If the operator wants to set the Printer's "printer-message-from-operator" Printer Description attribute when issuing the Set-Printer-Attributes operation, the client supplies the "printer-message-from-operator" explicitly with its new value as one of the Printer Description attributes in Group 2 in the request; the Printer also updates its "printer-message-time" and "printer-message-date-time" Printer Description attributes. If the client does not explicitly supply the "printer-message-from-operator" with its new value in the Set-Printer-Attributes request, the Printer leaves the value of the Printer's "printer-message-from-operator" Printer Description attribute unchanged.
“来自操作员的打印机消息”操作属性不能作为“设置打印机属性”操作的操作属性。如果操作员在发出“设置打印机属性”操作时希望设置打印机的“来自操作员的打印机消息”打印机描述属性,则客户端将“来自操作员的打印机消息”显式地提供其新值,作为请求中组2中的打印机描述属性之一;打印机还更新其“打印机消息时间”和“打印机消息日期时间”打印机描述属性。如果客户端未在“设置打印机属性”请求中明确提供“来自操作员的打印机消息”及其新值,则打印机将保持打印机“来自操作员的打印机消息”打印机描述属性的值不变。
The Printer SHOULD support this Operation attribute in following operations if it supports the corresponding "job-message-from-operator" Job Description attribute.
如果打印机支持相应的“来自操作员的作业消息”作业描述属性,则在以下操作中应支持此操作属性。
Cancel-Job Hold-Job Release-Job Restart-Job
取消作业保留作业释放作业重新启动作业
The client OPTIONALLY supplies this attribute in the above operations. 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 supported, the Printer copies the value to the Job's "job-message-from-operator" Job Description attribute (see [RFC2911], section 4.3.16) (even if this Operation attribute is a zero-length text value or consists solely of white space).
客户机在上述操作中可选地提供此属性。此属性的值是来自操作员的关于操作员刚刚对其执行操作的作业对象的消息。如果支持,打印机将该值复制到作业的“来自操作员的作业消息”作业描述属性(请参阅[RFC2911],第4.3.16节)(即使该操作属性为零长度文本值或仅包含空白)。
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 [RFC2911], 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" 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 IPP object returns the attribute with the zero-length value or the 'no-value' value, respectively.
如果打印机支持此操作属性,则必须同时支持零长度文本值和“无值”带外值(请参阅[RFC2911],第4.1节),以表明操作员未发送任何消息。在这种情况下,打印机将“来自操作员的作业消息”的值分别设置为零长度值或“无值”带外值。如果客户机查询“来自操作员的作业消息”作业属性,IPP对象将分别返回长度为零或“无值”的属性。
If the client omits this attribute, the Printer does not change the value of its "job-message-from-operator" Job Description attribute.
如果客户端忽略此属性,打印机不会更改其“来自操作员的作业消息”作业描述属性的值。
Note: There are no corresponding 'job-message-time" and "job-message-date-time" Job Description attributes, since the usual lifetime of a job is limited.
注意:没有相应的“作业消息时间”和“作业消息日期时间”作业描述属性,因为作业的通常生命周期是有限的。
The "job-message-from-operator" operation attribute MUST NOT be supported as an operation attribute for the Set-Job-Attributes operation. If the operator wants to set the Job's "job-message-from-operator" Job Description attribute when issuing the Set-Job-Attributes 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 request. Otherwise, the Printer leaves the value of the Job's "job-message-from-operator" Job Description attribute unchanged by not explicitly setting the attribute. If the client does not explicitly 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-message-from-operator" Job Description attribute unchanged.
“来自操作员的作业消息”操作属性不能被支持作为设置作业属性操作的操作属性。如果操作员在发出“设置作业属性”操作时希望设置作业的“来自操作员的作业消息”作业描述属性,则客户机必须将“来自操作员的作业消息”及其新值作为请求中组2中的作业描述属性之一提供。否则,打印机将不显式设置作业的“来自操作员的作业消息”作业描述属性的值,使其保持不变。如果客户端未在“设置作业属性”请求中显式提供“来自操作员的作业消息”及其新值,打印机将保持作业“来自操作员的作业消息”作业描述属性的值不变。
6 New Printer Description Attributes
6新的打印机描述属性
The following new Printer Description attributes are needed to support the new operations defined in this document.
需要以下新的打印机描述属性来支持本文档中定义的新操作。
This REQUIRED READ-ONLY Printer Description attribute identifies the Printer object attributes that are settable in this implementation, i.e., that are settable using the Set-Printer-Attributes operations (see section 4.1). This attribute MUST be supported if the Set-Printer-Attributes operations is supported. The Printer MUST reject attempts to set any Printer attributes that are not one of the values of this attribute, returning the 'client-error-attributes-not-settable' status code (see section 7.1). The value of this attribute MAY depend on the value of the "document-format" operation attribute supplied in the Get-Printer-Attributes operation (see [RFC2911], section 3.2.5.1).
此必需的只读打印机描述属性标识了在此实现中可设置的打印机对象属性,即可使用设置打印机属性操作设置的打印机对象属性(请参阅第4.1节)。如果支持“设置打印机属性”操作,则必须支持此属性。打印机必须拒绝设置任何不属于此属性值之一的打印机属性的尝试,并返回“客户端错误属性不可设置”状态代码(请参阅第7.1节)。此属性的值可能取决于“获取打印机属性”操作中提供的“文档格式”操作属性的值(请参阅[RFC2911],第3.2.5.1节)。
Standard keyword values are:
标准关键字值为:
'none': There are no settable Printer attributes. 'xxx': Where 'xxx' is any of the keyword attribute names allowed by section 4.1.1.
“无”:没有可设置的打印机属性xxx”:其中“xxx”是第4.1.1节允许的任何关键字属性名称。
This REQUIRED READ-ONLY Printer Description attribute identifies the Job object attributes that are settable in this implementation, i.e., that are settable using the Set-Job-Attributes operation (see section 4.2). This attribute MUST be supported if the Set-Job-Attributes operations are supported. The Printer MUST reject attempts to set any Job attributes that are not one of the values of this attribute, returning the 'client-error-attributes-not-settable' status code (see section 7.1).
此必需的只读打印机描述属性标识了在此实现中可设置的作业对象属性,即可使用“设置作业属性”操作设置的作业对象属性(参见第4.2节)。如果支持设置作业属性操作,则必须支持此属性。打印机必须拒绝设置任何不属于此属性值之一的作业属性的尝试,并返回“客户端错误属性不可设置”状态代码(请参阅第7.1节)。
Standard keyword values are:
标准关键字值为:
'none': There are no settable Job attributes. 'xxx': Where 'xxx' is any of the keyword attribute names allowed by section 4.2.1.
“无”:没有可设置的作业属性xxx”:其中“xxx”是第4.2.1节允许的任何关键字属性名称。
This OPTIONAL READ-ONLY Printer Description attribute contains a set of attribute name keywords. This attribute SHOULD be supported by a Printer object if the Printer object has Printer attributes whose value vary depending on document format (see [RFC2911], Get-Printer-Attributes operation). This attribute specifies which attribute values can vary by 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-Printer-Attributes operation that included the "document-format" operation attribute, then the Printer MUST change the value for the specified document format and no other document formats (see section 4.1.2). If an attribute's name, "xxx", is not a member of this attribute and the value of attribute "xxx" is changed with the Set-Printer-Attributes operation, then the attribute is changed for all document formats (whether or not the client supplied the "document-format" operation attribute).
此可选只读打印机描述属性包含一组属性名称关键字。如果打印机对象的打印机属性的值因文档格式而异,则打印机对象应支持此属性(请参阅[RFC2911],获取打印机属性操作)。此属性指定哪些属性值可能因文档格式而异。如果属性名称“xxx”是该属性的成员,并且属性“xxx”的值随包含“文档格式”操作属性的“设置打印机属性”操作而更改,则打印机必须更改指定文档格式的值,而不更改其他文档格式(见第4.1.2节)。如果属性的名称“xxx”不是该属性的成员,并且属性“xxx”的值随“设置打印机属性”操作而更改,则所有文档格式的属性都会更改(无论客户端是否提供了“文档格式”操作属性)。
This OPTIONAL READ-ONLY Printer Description attribute contains the time that the Printer's "printer-message-from-operator" was changed by the operator using any operation where the client supplied the "printer-message-from-operator" operation attribute (see section 5.1) or was explicitly set using the Set-Printer-Attributes operation (see section 4.1). This attribute allows the users to know when the "printer-message-from-operator" Printer Description attribute was last set.
此可选只读打印机描述属性包含打印机的“来自操作员的打印机消息”被操作员使用任何操作更改的时间,其中客户端提供了“来自操作员的打印机消息”操作属性(请参见第5.1节),或者是使用“设置打印机属性”操作显式设置的(参见第4.1节)。此属性允许用户知道“来自操作员的打印机消息”打印机描述属性上次设置的时间。
The Printer sets the value of this attribute by copying the value of the Printer's "printer-up-time" attribute (see [RFC2911], section 4.3.14). If the Printer resets its "printer-up-time" attribute to 1 on power-up, then it MUST change the value of the "printer-message-time" to 0 or a negative number as specified in [RFC2911], section 4.3.14.
打印机通过复制打印机的“打印机启动时间”属性的值来设置该属性的值(请参阅[RFC2911],第4.3.14节)。如果打印机在通电时将其“打印机启动时间”属性重置为1,则必须将“打印机消息时间”的值更改为0或[RFC2911]第4.3.14节中规定的负数。
Note: This attribute helps users better understand the context for the "printer-message-from-operator" message.
注意:此属性有助于用户更好地理解“来自操作员的打印机消息”消息的上下文。
This OPTIONAL READ-ONLY Printer Description attribute contains the date and time that the Printer's "printer-message-from-operator" was changed by the operator, using any operation where the client supplied the "printer-message-from-operator" operation attribute (see section 5.1) or was explicitly set using the Set-Printer-Attributes operation (see section 4.1). This attribute allows the users to know when the "printer-message-from-operator" Printer Description attribute was last set.
此可选只读打印机描述属性包含操作员使用任何操作更改打印机“来自操作员的打印机消息”的日期和时间,其中客户端提供了“来自操作员的打印机消息”操作属性(请参阅第5.1节),或使用“设置打印机属性”操作显式设置(参见第4.1节)。此属性允许用户知道“来自操作员的打印机消息”打印机描述属性上次设置的时间。
This attribute MUST be supported if the Printer supports both the "printer-message-time" and the "printer-current-time" (dateTime) attributes (see [RFC2911], section 4.4.30).
如果打印机同时支持“打印机消息时间”和“打印机当前时间”(日期时间)属性,则必须支持此属性(请参阅[RFC2911],第4.4.30节)。
Note: This attribute helps users better understand the context for the "printer-message-from-operator" message.
注意:此属性有助于用户更好地理解“来自操作员的打印机消息”消息的上下文。
This OPTIONAL Printer Description attribute is a multi-valued attribute where each value has the 'collection' attribute syntax (see [RFC3382]), containing member attributes with the same semantics as the following IPP/1.1 READ-ONLY Printer Description attributes, except for cardinality:
此可选打印机描述属性是一个多值属性,其中每个值都具有“collection”属性语法(请参见[RFC3382]),包含与以下IPP/1.1只读打印机描述属性具有相同语义的成员属性,但基数除外:
printer-uri-supported (1setOf uri) - see [RFC2911], section 4.4.1 uri-authentication-supported (1setOf type2 keyword) - see [RFC2911], section 4.4.2. uri-security-supported (1setOf type2 keyword) - see [RFC2911], section 4.4.3.
支持的打印机uri(1setOf uri)-请参阅[RFC2911],第4.4.1节支持的uri身份验证(1setOf type2关键字)-请参阅[RFC2911],第4.4.2节。支持uri安全性(1setOf type2关键字)-请参阅[RFC2911],第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
在使用Set printer Attributes请求设置“printer xri supported”(打印机xri支持)属性时,打印机还必须将这三个IPP/1.1只读打印机描述属性设置为已定义的边
effect. Thus, this collection attribute provides the means to set these three IPP/1.1 READ-ONLY attributes atomically so that they are never left in a partially inconsistent state.
效应因此,此集合属性提供了以原子方式设置这三个IPP/1.1只读属性的方法,以便它们永远不会处于部分不一致的状态。
An IPP Printer MUST NOT provide any other way, using IPP, to set these three IPP/1.1 READ-ONLY Printer Description attributes, since they are READ-ONLY and MUST have consistent values at all times. Note: The "printer-xri-supported" (1setOf collection) attribute can be put into a directory schema that requires a single text string value, such as could be used with SLPv2 [RFC2608], [RFC2609] or LDAPv3 [RFC2251], [RFC2252], [RFC2926], by using suitable delimiting characters to separate member attributes of the collection and/or terminating collection values.
IPP打印机不得使用IPP提供任何其他方式来设置这三个IPP/1.1只读打印机描述属性,因为它们是只读的,并且必须始终具有一致的值。注意:“printer xri supported”(1setOf collection)属性可以放入需要单个文本字符串值的目录架构中,例如可以与SLPv2[RFC2608]、[RFC2609]或LDAPv3[RFC2251]、[RFC2252]、[RFC2926]一起使用,通过使用合适的分隔字符来分隔集合的成员属性和/或终止集合值。
The member attributes of the "printer-xri-supported" (1setOf collection) are given in Table 3.
表3给出了“支持的打印机xri”(1setOf集合)的成员属性。
Table 3 - Member attributes of "printer-xri-supported" (1setOf collection)
表3“支持打印机xri”的成员属性(集合1)
Member attribute client Printer MUST MUST supply support
成员属性客户端打印机必须提供支持
xri-uri (uri) yes yes
xri uri(uri)是是
xri-authentication (type2 keyword) yes yes
xri身份验证(type2关键字)是是
xri-security (type2 keyword) yes yes
xri安全性(type2关键字)是是
Other than the uniqueness and the cardinality requirements, the semantics of these three member attributes is given in [RFC2911] sections 4.4.1, 4.4.2, and 4.4.3, respectively.
除了唯一性和基数要求外,[RFC2911]第4.4.1、4.4.2和4.4.3节分别给出了这三个成员属性的语义。
A client can query the current values using the Get-Printer-Attributes operation by supplying 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
1. 三个IPP/1.1属性名称:“支持的打印机uri”、“支持的uri身份验证”、“支持的uri安全性”以及获取并行值或
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.
2. 单一属性名:“printer xri supported”并返回1setOf集合,该集合在语义上包含相同的信息,但形式不同。
A client can query what member attribute values can be set by supplying the three attribute names: "xri-uri-scheme-supported", "xri-authentication-supported", and "xri-security-supported" in a
客户机可以通过提供以下三个属性名称来查询可以设置哪些成员属性值:“支持的xri uri方案”、“支持的xri身份验证”和“支持的xri安全性”
Get-Printer-Supported-Values request and getting back the uriScheme and 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 the Get-Printer-Supported-Values operation (see section 4.3). See Table 16.
获取打印机支持的值请求,并获取可设置的URI模式和type2关键字值。由于“支持打印机xri”、“支持uri身份验证”和“支持uri安全性”属性是只读的,因此无法使用“获取打印机支持的值”操作查询这些属性(请参阅第4.3节)。见表16。
For example:
例如:
"printer-xri-supported = { "xri-uri" = ipp://abc.com/p1 "xri-authentication" = basic "xri-security" = tls }, { "xri-uri" = ipp://abc.com/p2 "xri-authentication" = digest "xri-security" = tls }, { "xri-uri" = ipp://abc.com/p3 "xri-authentication" = none "xri-security" = none }
"printer-xri-supported = { "xri-uri" = ipp://abc.com/p1 "xri-authentication" = basic "xri-security" = tls }, { "xri-uri" = ipp://abc.com/p2 "xri-authentication" = digest "xri-security" = tls }, { "xri-uri" = ipp://abc.com/p3 "xri-authentication" = none "xri-security" = none }
would cause the Printer to set the three corresponding IPP/1.1 READ-ONLY attributes, each with three parallel values as follows:
将导致打印机设置三个相应的IPP/1.1只读属性,每个属性具有三个并行值,如下所示:
"printer-uri-supported" = { ipp://abc.com/p1, ipp://abc.com/p2, ipp://abc.com/p3 } "uri-authentication-supported" = { basic, digest, none } "uri-security-supported" = { tls, tls, none }
"printer-uri-supported" = { ipp://abc.com/p1, ipp://abc.com/p2, ipp://abc.com/p3 } "uri-authentication-supported" = { basic, digest, none } "uri-security-supported" = { tls, tls, none }
This OPTIONAL READ-ONLY Printer Description attribute identifies the URI schemes that the implementation supports for use in the "printer-uri-supported" (1setOf uri) Printer Description attribute (see [RFC2911] section 4.4.1) and the "xri-uri" member attribute of the "printer-xri-supported" (1setOf collection) Printer Description attribute (see section 6.6).
此可选只读打印机描述属性标识实现支持的URI方案,用于“支持的打印机URI”(1setOf URI)打印机描述属性(请参阅[RFC2911]第4.4.1节)和“支持的打印机xri”(1setOf collection)打印机描述属性的“xri URI”成员属性(见第6.6节)。
A Printer MUST support this attribute if it supports the setting of the "printer-xri-supported" (1setOf collection) with the Set-Printer-Attributes operation.
如果打印机支持使用“设置打印机属性”操作设置“支持的打印机xri”(1setOf collection),则打印机必须支持此属性。
This OPTIONAL READ-ONLY Printer Description attribute identifies the Client Authentication mechanisms that the implementation supports for use in the "uri-authentication-supported" (1setOf type2 keyword) Printer Description attribute (see [RFC2911], section 4.4.2) and the "xri-authentication" member attribute of the "printer-xri-supported" (1setOf collection) Printer Description attribute (see section 6.6).
此可选只读打印机描述属性标识实现支持的客户端身份验证机制,以用于“支持的uri身份验证”(1setOf type2关键字)打印机描述属性(请参阅[RFC2911],第4.4.2节)和“支持的打印机xri”的“xri身份验证”成员属性(1setOf collection)打印机描述属性(参见第6.6节)。
A Printer MUST support this attribute if it supports setting the "printer-xri-supported" (1setOf collection) with the Set-Printer-Attributes operation.
如果打印机支持使用“设置打印机属性”操作设置“支持的打印机xri”(1setOf collection),则打印机必须支持此属性。
This OPTIONAL READ-ONLY Printer Description attribute identifies the URI schemes that the implementation supports for use in the "uri-security-supported" (1setOf type2 keyword) Printer Description attribute (see [RFC2911], section 4.4.3) and the "xri-security" member attribute of the "printer-xri-supported" (1setOf collection) Printer Description attribute (see section 6.6).
此可选只读打印机描述属性标识实现支持的URI方案,用于“支持的URI安全性”(1setOf type2关键字)打印机描述属性(请参阅[RFC2911],第4.4.3节)和“支持的打印机xri”(1setOf集合)的“xri安全性”成员属性打印机描述属性(参见第6.6节)。
A Printer MUST support this attribute if it supports setting the "printer-xri-supported" (1setOf collection) with the Set-Printer-Attributes operation.
如果打印机支持使用“设置打印机属性”操作设置“支持的打印机xri”(1setOf collection),则打印机必须支持此属性。
7 Additional status codes
7附加状态代码
This section defines new status codes used by the operations defined in this document.
本节定义了本文档中定义的操作所使用的新状态代码。
The Set-Printer-Attributes or Set-Job-Attributes operation failed 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 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) and the 'not-settable' out-of-band value (see section 8.1) in the Unsupported Attributes Group (see [RFC2911], section 3.1.7) for all of the attributes that could not be set. When the Printer returns this status, it MUST NOT change any of the attributes supplied in the operation.
“设置打印机属性”或“设置作业属性”操作失败,因为无法设置一个或多个指定属性,原因可能是该属性被定义为只读,或者该属性在此实现中不可设置(请参阅第4.1.3节和第4.2.3节)。对于所有无法设置的属性,打印机必须返回此错误代码、属性关键字名称以及“不可设置”带外值(参见第8.1节)中的“不支持的属性”组(参见[RFC2911],第3.1.7节)。打印机返回此状态时,不得更改操作中提供的任何属性。
8 Additional out-of-band values
8额外的带外值
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 unless the definition of the attribute in an operation request and/or response explicitly allows such usage. See the beginning of [RFC2911], section 4.1.
本节定义了其他带外值。与所有带外值一样,客户端或打印机不得使用带外值,除非操作请求和/或响应中的属性定义明确允许此类使用。参见[RFC2911]的开头,第4.1节。
The 'not-settable' out-of-band attribute value is returned by the IPP Printer in the Unsupported Attributes group of a response to indicate that the attribute supplied by the client in the request is READ-ONLY by definition or is not settable in this implementation.
IPP打印机在响应的Unsupported Attributes(不支持的属性)组中返回“not settable”(不可设置)带外属性值,以指示请求中客户端提供的属性是只读的,或者在此实现中不可设置。
The 'not-settable' out-of-band attribute value is defined for use with the Set-Job-Attributes and Set-Printer-Attributes responses only. If a future additional "set" operation allows the 'not-settable' out-of-band value, its definition document MUST indicate such use explicitly, including with which attributes.
“不可设置”带外属性值仅定义用于设置作业属性和设置打印机属性响应。如果未来的附加“设置”操作允许“不可设置”带外值,则其定义文档必须明确指出此类使用,包括使用哪些属性。
An IPP object MUST support the 'not-settable' out-of-band value in a Set-Job-Attributes or Set-Printer-Attributes request if it supports those operations. A client MUST NOT supply the 'not-settable' out-of-band value in any request. An IPP object MUST NOT support the 'not-settable' out-of-band value in other operations, unless the operations' definition document explicitly defines such usage. If a Printer receives this out-of-band value in any operation request, the Printer MUST either (1) reject the entire request and return the 'client-error-bad-request' status code or (2) ignore the attribute and return it with the 'unsupported' out-of-band value.
IPP对象必须支持设置作业属性或设置打印机属性请求中的“不可设置”带外值(如果支持这些操作)。客户端不得在任何请求中提供“不可设置”带外值。IPP对象在其他操作中不得支持“不可设置”带外值,除非操作定义文档明确定义了此类用法。如果打印机在任何操作请求中收到此带外值,则打印机必须(1)拒绝整个请求并返回“客户端错误错误请求”状态代码,或(2)忽略该属性并返回“不支持的”带外值。
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-Attributes and Set-Job-Attributes responses.
有关“设置打印机属性”和“设置作业属性”响应中“不可设置”带外值用法的示例定义,请参阅本文档第4.1.3节和第4.2.3节。
The encoding of the 'not-settable' out-of-band value is 0x15 (see [RFC2910]). The value-length MUST be 0 and the value empty.
“不可设置”带外值的编码为0x15(参见[RFC2910])。值长度必须为0,且值为空。
The 'delete-attribute' out-of-band attribute value is supplied by the client in a request to indicate that the Printer is to remove the supplied attribute and all of its values from the target object, if present.
“删除属性”带外属性值由客户端在请求中提供,以指示打印机将从目标对象(如果存在)中删除提供的属性及其所有值。
The 'delete-attribute' out-of-band attribute value is defined for use with the Set-Job-Attributes request only. If a future additional "set" operation allows the 'delete-attribute' out-of-band value, its definition document MUST indicate such use explicitly, including with which attributes.
“删除属性”带外属性值仅定义用于设置作业属性请求。如果未来的附加“设置”操作允许“删除属性”带外值,则其定义文档必须明确指出此类使用,包括使用哪些属性。
An IPP Printer MUST support the 'delete-attribute' out-of-band value if it supports the Set-Job-Attributes operation. A client MUST NOT supply, and an IPP object MUST NOT support, the 'delete-attribute' out-of-band value in other operations, unless the operations' definition document explicitly defines such usage. For example, the 'delete-attribute' out-of-band value MUST NOT be used in the Set-Printer-Attributes operation, where the absence of an attribute from an IPP object indicates that the attribute is not supported. If a Printer receives this out-of-band value in other operation requests, the Printer MUST either (1) reject the entire request and return the 'client-error-bad-request' status code or (2) ignore the attribute and return it with the 'unsupported' out-of-band value.
如果IPP打印机支持“设置作业属性”操作,则必须支持“删除属性”带外值。客户机不得在其他操作中提供且IPP对象不得支持“删除属性”带外值,除非操作定义文档明确定义了此类用法。例如,“设置打印机属性”操作中不得使用“删除属性”带外值,如果IPP对象中缺少属性,则表示不支持该属性。如果打印机在其他操作请求中收到此带外值,则打印机必须(1)拒绝整个请求并返回“客户端错误错误请求”状态代码,或(2)忽略该属性并返回“不支持的”带外值。
See section 4.2 in this document for the definition of the usage of the 'delete-attribute' out-of-band value in the Set-Job-Attributes request.
有关设置作业属性请求中“删除属性”带外值用法的定义,请参阅本文档第4.2节。
The encoding of the 'delete-attribute' out-of-band value is 0x16 (see [RFC2910]). The value-length MUST be 0 and the value empty.
“删除属性”带外值的编码为0x16(请参阅[RFC2910])。值长度必须为0,且值为空。
Section 4.3 defines the Get-Printer-Supported-Values response to contain the values of an "xxx-supported" attribute that are supported by the implementation before any additional values are defined by the administrator. The 'admin-define' out-of-band attribute value is returned as an additional value of an "xxx-supported" attribute in a Get-Printer-Supported-Values response to indicate that the implementation supports allowing an administrator to define additional arbitrary 'name' values for that "xxx-supported" attribute.
第4.3节定义了Get Printer Supported Values响应,以在管理员定义任何其他值之前,包含实现支持的“xxx Supported”属性的值。“admin define”带外属性值在Get Printer supported Values响应中作为“xxx supported”属性的附加值返回,以指示实现支持允许管理员为该“xxx supported”属性定义附加的任意“name”值。
For example, if the "media-supported" (1setOf (type3 keyword | name)) attribute contains this value, then the Printer MUST permit an administrator to add new media names to the Printer's "media-supported" attribute. In order for an administrator to add new values to a Printer's "xxx-supported" attribute, the client supplies the existing and new values in a Set-Printer-Attributes request for
例如,如果“支持的介质”(1setOf(type3关键字| name))属性包含此值,则打印机必须允许管理员向打印机的“支持的介质”属性添加新的介质名称。为了让管理员向打印机的“支持xxx”属性添加新值,客户机在设置打印机属性请求中提供现有值和新值
that attribute. The client MUST supply any such administratively defined values in the Set-Printer-Attributes request, using the 'name' attribute syntax.
这个属性。客户端必须使用“名称”属性语法在“设置打印机属性”请求中提供任何此类管理定义的值。
The 'admin-define' out-of-band attribute value is defined for use with the Get-Printer-Supported-Values response only. A Printer MUST NOT return the 'admin-define' out-of-band value in a Get-Printer-Attributes response, since such a response indicates what an end-user client can supply in a Job Creation operation. If a future additional "get" operation allows the 'admin-define' out-of-band value, its definition document MUST indicate such use explicitly, including with which attributes.
“admin define”带外属性值的定义仅用于“获取打印机支持的值”响应。打印机不得在Get Printer Attributes响应中返回“admin define”带外值,因为这样的响应指示最终用户客户端可以在作业创建操作中提供什么。如果未来的附加“get”操作允许“admin define”带外值,则其定义文档必须明确指示此类使用,包括使用哪些属性。
An IPP Printer MUST support the 'admin-define' out-of-band value, if it supports a client setting arbitrary 'name' values of an "xxx-supported" Printer attribute using the Set-Printer-Attributes operation. A client MUST NOT supply the 'admin-define' out-of-band value in any request. An IPP object MUST NOT support the 'admin-define' out-of-band value in other operations, unless the operations' definition document explicitly defines such usage. If a Printer receives this out-of-band value in any operation request, the Printer MUST either (1) reject the entire request and return the 'client-error-bad-request' status code or (2) ignore the attribute and return it with the 'unsupported' out-of-band value.
如果IPP打印机支持客户端使用“设置打印机属性”操作设置“支持xxx”打印机属性的任意“名称”值,则它必须支持“管理定义”带外值。客户端不得在任何请求中提供“admin define”带外值。IPP对象在其他操作中不得支持“admin define”带外值,除非操作定义文档明确定义了此类用法。如果打印机在任何操作请求中收到此带外值,则打印机必须(1)拒绝整个请求并返回“客户端错误错误请求”状态代码,或(2)忽略该属性并返回“不支持的”带外值。
This document defines that the 'admin-define' out-of-band value MUST be used only with "xxx-supported" attributes that are defined to include the 'name' attribute syntax. This out-of-band value is not intended to be used with "xxx-supported" attributes of other attribute syntaxes, such as 'uri', even though the administrator defines arbitrary values for such attributes. If other documents extend the use of the 'admin-define' out-of-band value to other attribute syntaxes, such a document MUST define such use explicitly, including with which attributes.
本文档规定“admin define”带外值只能与定义为包含“name”属性语法的“xxx supported”属性一起使用。此带外值不用于其他属性语法的“xxx支持”属性,例如“uri”,即使管理员为此类属性定义了任意值。如果其他文档将“admin define”带外值的使用扩展到其他属性语法,则此类文档必须明确定义此类使用,包括使用哪些属性。
See section 4.3 in this document for an example definition of the usage of the 'admin-define' out-of-band attribute value in any "xxx-supported" attribute returned in a Get-Printer-Supported-Values response that is defined to include the 'name' attribute syntax.
有关在Get Printer supported Values响应(定义为包含“name”属性语法)中返回的任何“xxx supported”属性中使用“admin define”带外属性值的示例定义,请参阅本文档第4.3节。
The encoding of the 'admin-define' out-of-band attribute value is 0x17 (see [RFC2910]). The value-length MUST be 0 and the value empty.
“admin define”带外属性值的编码为0x17(请参阅[RFC2910])。值长度必须为0,且值为空。
9 New Values for Existing Printer Description Attributes
9现有打印机描述属性的新值
This section contains those attributes for which additional values are added.
本节包含为其添加附加值的属性。
The following "operation-id" values are added in order to support the new operations defined in this document:
添加以下“操作id”值以支持本文档中定义的新操作:
Table 4 - Operation-id assignments
表4-操作id分配
Value Operation Name
值操作名
0x0013 Set-Printer-Attributes
0x0013设置打印机属性
0x0014 Set-Job-Attributes
0x0014设置作业属性
0x0015 Get-Printer-Supported-Values
0x0015获取打印机支持的值
10 Conformance Requirements
10符合性要求
This section specifies the conformance requirements for clients and IPP objects.
本节规定了客户机和IPP对象的一致性要求。
Both the Set-Job-Attributes and the Set-Printer-Attributes operations 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. However, if the Set-Printer-Attributes operation is supported, then the Get-Printer-Supported-Values operation MUST be supported if any "xxx-supported" attributes are settable. Otherwise, the Get-Printer-Supported-Values operation is OPTIONAL for an IPP Printer to support.
文档中定义的“设置作业属性”和“设置打印机属性”操作都是IPP对象支持的可选操作。其中一个可以不支持另一个,或者两个都可以支持。但是,如果支持“设置打印机属性”操作,则如果任何“支持xxx”属性可设置,则必须支持“获取打印机支持的值”操作。否则,IPP打印机支持的“获取打印机支持的值”操作是可选的。
If the Set-Printer-Attributes operation is supported, then the Printer MUST support the following additional items:
如果支持设置打印机属性操作,则打印机必须支持以下附加项:
1. the Get-Printer-Supported-Values operation (see section 5), if any "xxx-supported" attributes are settable.
1. 获取打印机支持的值操作(参见第5节),如果任何“xxx支持”属性是可设置的。
2. the "printer-settable-attributes-supported" Printer Description attribute (see section 6.1).
2. “支持的打印机可设置属性”打印机描述属性(见第6.1节)。
3. the 'not-settable' out-of-band value in responses (see section 8.1).
3. 响应中的“不可设置”带外值(见第8.1节)。
4. the 'client-error-not-settable' status code (see section 7.1).
4. “客户端错误不可设置”状态代码(见第7.1节)。
5. if the "printer-message-from-operator" Printer Description attribute is supported (see [RFC2911], section 4.4.25), then it MUST be settable.
5. 如果支持“来自操作员的打印机消息”打印机描述属性(请参阅[RFC2911],第4.4.25节),则必须设置该属性。
6. the Get-Printer-Supported-Values operation (see section 4.3), if any "xxx-supported" attributes are settable.
6. 获取打印机支持的值操作(参见第4.3节),如果任何“xxx支持”属性可设置。
7. If a client can set a value with the 'name' attribute syntax for one or more "xxx-supported" attributes, then the 'admin-define' out-of-band attribute value (see section 8.3) MUST be supported in the Get-Printer-Supported-Values response for each such settable attribute (see section 4.3)
7. 如果客户端可以使用“名称”属性语法为一个或多个“xxx支持的”属性设置值,则对于每个此类可设置属性(参见第4.3节),必须在“获取打印机支持的值”响应中支持“管理定义”带外属性值(参见第8.3节)
If the Set-Job-Attributes operation is supported, then the Printer MUST support the following additional items:
如果支持设置作业属性操作,则打印机必须支持以下附加项:
1. the "job-settable-attributes-supported" Printer Description attribute (see section 6.2).
1. “支持的作业可设置属性”打印机描述属性(见第6.2节)。
2. the 'not-settable' out-of-band value in responses (see section 8.1).
2. 响应中的“不可设置”带外值(见第8.1节)。
3. the 'delete-attribute' out-of-band value in requests (see section 8.2).
3. 请求中的“删除属性”带外值(参见第8.2节)。
4. the 'client-error-not-settable' status code (see section 7.1).
4. “客户端错误不可设置”状态代码(见第7.1节)。
5. if the "job-message-from-operator" Printer Description attribute is supported (see [RFC2911], 4.3.16), then it MUST be settable.
5. 如果支持“来自操作员的作业消息”打印机描述属性(请参阅[RFC2911],4.3.16),则必须设置该属性。
It is OPTIONAL for the Printer object to support the "printer-message-time" (integer) and "printer-message-date-time" (dateTime) Printer Description attributes. If both the "printer-message-time" (integer) and the "printer-current-time" (dateTime) (see [RFC2911], section 4.4.30) attributes are supported, then the "printer-message-date-time" (dateTime) Printer Description attribute MUST be supported.
打印机对象支持“打印机消息时间”(整数)和“打印机消息日期时间”(日期时间)打印机描述属性是可选的。如果同时支持“打印机消息时间”(整数)和“打印机当前时间”(日期时间)(参见[RFC2911],第4.4.30节)属性,则必须支持“打印机消息日期时间”(日期时间)打印机描述属性。
As with all out-of-band values, a client or a Printer MUST NOT use an out-of-band value, unless the definition document for the attribute in an operation request and/or response explicitly allows such usage.
与所有带外值一样,客户机或打印机不得使用带外值,除非操作请求和/或响应中的属性定义文档明确允许此类使用。
11 IANA Considerations
11 IANA考虑因素
This section contains registration information for IANA to add to the various IPP Registries according to the procedures defined in RFC 2911 [RFC2911], section 6. The resulting registrations will be published in the http://www.iana.org/assignments/ipp-registrations registry.
本节包含IANA根据RFC 2911[RFC2911]第6节中规定的程序添加到各种IPP注册中的注册信息。由此产生的注册将在http://www.iana.org/assignments/ipp-registrations 登记处。
The following table lists all of the operations defined in this document. These are to be registered according to the procedures defined in RFC 2911 [RFC2911], section 6.4.
下表列出了本文档中定义的所有操作。根据RFC 2911[RFC2911]第6.4节规定的程序进行注册。
Operations: Ref. Section: Set-Printer-Attributes RFC 3380 4.1 Set-Job-Attributes RFC 3380 4.2 Get-Printer-Supported-Values RFC 3380 4.3
操作:参考部分:设置打印机属性RFC 3380 4.1设置作业属性RFC 3380 4.2获取打印机支持的值RFC 3380 4.3
11.2 Additional Enum Attribute Value Registrations for the "operations-supported" Printer Attribute
11.2 “支持的操作”打印机属性的其他枚举属性值注册
The following table lists all the new enum attribute values defined in this document as additional type2 enum values for use with the "operations-supported" Printer Description attribute. These are to be registered according to the procedures defined in RFC 2911 [RFC 2911], section 6.1.
下表列出了本文档中定义的所有新枚举属性值,作为附加的type2枚举值,用于“支持的操作”打印机描述属性。根据RFC 2911[RFC 2911]第6.1节规定的程序进行注册。
Enum Attribute Values: Value Ref. Section: Set-Printer-Attributes 0x0013 RFC 3380 4 Set-Job-Attributes 0x0014 RFC 3380 4 Get-Printer-Supported-Values 0x0015 RFC 3380 4
枚举属性值:值引用部分:设置打印机属性0x0013 RFC 3380 4设置作业属性0x0014 RFC 3380 4获取打印机支持的值0x0015 RFC 3380 4
The following table lists all of the attributes defined in this standard which have keywords values defined:
下表列出了本标准中定义的所有属性,这些属性定义了关键字值:
printer-settable-attributes-supported (1setOf type2 keyword) RFC 3380 6.1 none RFC 3380 6.1 <Any other Printer attribute keyword name> job-settable-attributes-supported (1setOf type2 keyword) RFC 3380 6.2 none RFC 3380 6.2 <Any other Job attribute keyword name> document-format-varying-attributes (1setOf type2 keyword) RFC 3380 6.3 none <Any Printer attribute keyword name> xri-security-supported (1setOf type2 keyword) RFC 3380 6.9 none RFC 2911 4.4.3 ssl3 RFC 2911 4.4.3 tls' RFC 2911 4.4.3 xri-authentication-supported (1setOf type2 keyword) none RFC 2911 4.4.2 requesting-user-name RFC 2911 4.4.2 basic RFC 2911 4.4.2 digest RFC 2911 4.4.2 certificate RFC 2911 4.4.2
支持的打印机可设置属性(1setOf type2关键字)RFC 3380 6.1无RFC 3380 6.1<任何其他打印机属性关键字名称>支持的作业可设置属性(1setOf type2关键字)RFC 3380 6.2无RFC 3380 6.2<任何其他作业属性关键字名称>文档格式变化属性(1setOf type2关键字)RFC 3380 6.3无<任何打印机属性关键字名称>支持的xri安全性(1setOf type2关键字)RFC 3380 6.9无RFC 2911 4.4.3 ssl3 RFC 2911 4.4.3 tls的RFC 2911 4.4.3支持的xri身份验证(1setOf type2关键字)无RFC 2911 4.4.2请求用户名RFC 2911 4.4.2基本RFC 2911 4.4.2摘要RFC 2911 4.4.2证书RFC 2911 4.4.2
The following table lists all of the attributes defined in this document. These are to be registered according to the procedures in RFC 2911 [RFC2911], section 6.2.
下表列出了本文档中定义的所有属性。根据RFC 2911[RFC2911]第6.2节中的程序进行注册。
Operation attributes: Ref. Section: printer-message-from-operator (text(127)) RFC 3380 5.1 job-message-from-operator (text(127)) RFC 3380 5.2
操作属性:参考部分:来自操作员的打印机消息(文本(127))RFC 3380 5.1来自操作员的作业消息(文本(127))RFC 3380 5.2
Printer Description attributes: Ref. Section: printer-settable-attributes-supported (1setOf type2 keyword) RFC 3380 6.1 job-settable-attributes-supported (1setOf type2 keyword) RFC 3380 6.2 document-format-varying-attributes (1setOf type2 keyword) RFC 3380 6.3 printer-message-time (integer(MIN:MAX)) RFC 3380 6.4 printer-message-date-time (dateTime) RFC 3380 6.5 printer-xri-supported (1setOf collection) RFC 3380 6.6 xri-uri (uri) RFC 3380 6.6 xri-authentication (type2 keyword) RFC 3380 6.6 xri-security (type2 keyword) RFC 3380 6.6 xri-uri-scheme-supported (1setOf uriScheme) RFC 3380 6.7 xri-authentication-supported (1setOf type2 keyword) 6.8 xri-security-supported (1setOf type2 keyword) RFC 3380 6.9
打印机描述属性:参考部分:支持的打印机可设置属性(1setOf type2关键字)RFC 3380 6.1支持的作业可设置属性(1setOf type2关键字)RFC 3380 6.2文档格式变化属性(1setOf type2关键字)RFC 3380 6.3打印机消息时间(整数(最小值:最大值))RFC 3380 6.4打印机消息日期时间(日期时间)支持RFC 3380 6.5打印机xri(1setOf collection)支持RFC 3380 6.6 xri uri(uri)RFC 3380 6.6 xri身份验证(type2关键字)RFC 3380 6.6 xri安全性(type2关键字)支持RFC 3380 6.6 xri uri方案(1setOf uri方案)支持RFC 3380 6.7 xri身份验证(1setOf type2关键字)支持6.8 xri安全性(1setOf type2关键字)RFC 3380 6.9
The following table lists the status code defined in this document. This is to be registered according to the procedures in RFC 2911 [RFC2911], section 6.6.
下表列出了本文档中定义的状态代码。根据RFC 2911[RFC2911]第6.6节中的程序进行注册。
Status codes: Ref. Section: client-error-attributes-not-settable (0x0413) RFC 3380 7.1
状态代码:参考章节:客户端错误属性不可设置(0x0413)RFC 3380 7.1
The following table lists all of the out-of-band attribute values defined in this document. These are to be registered according to the procedures in RFC 2911 [RFC2911] section 6.7.
下表列出了本文档中定义的所有带外属性值。根据RFC 2911[RFC2911]第6.7节中的程序进行注册。
Value: Out-of-band Attribute value name: Ref. Section: 0x15 not-settable RFC 3380 8.1 0x16 delete-attribute RFC 3380 8.2 0x17 admin-define RFC 3380 8.3
值:带外属性值名称:参考节:0x15不可设置RFC 3380 8.1 0x16删除属性RFC 3380 8.2 0x17管理员定义RFC 3380 8.3
12 Internationalization Considerations
12国际化考虑
This document has the same localization considerations as [RFC2911].
本文件具有与[RFC2911]相同的本地化注意事项。
13 Security Considerations
13安全考虑
The IPP Model and Semantics document ([RFC2911], section 8) discusses high level security requirements (Client Authentication, Server Authentication and Operation Privacy). Client Authentication is the mechanism by which the client proves its identity to the server in a secure manner. Server Authentication is the mechanism by which the server proves its identity to the client in a secure manner. Operation Privacy is defined as a mechanism for protecting operations from eavesdropping.
IPP模型和语义文档([RFC2911],第8节)讨论了高级安全要求(客户端身份验证、服务器身份验证和操作隐私)。客户端身份验证是客户端以安全的方式向服务器证明其身份的机制。服务器身份验证是服务器以安全的方式向客户端证明其身份的机制。操作隐私被定义为防止操作被窃听的机制。
In addition, the introduction of the Set-Printer-Attributes and Set-Job-Attributes operations creates another security threat, since the client is able to modify the Printer and Job attributes stored in the Printer. Such modifications could lead to denial of service.
此外,由于客户端能够修改存储在打印机中的打印机和作业属性,因此引入“设置打印机属性”和“设置作业属性”操作会造成另一种安全威胁。这种修改可能导致拒绝服务。
A malicious user could alter the policy established by the system administrator and stored in the Printer attributes. Such alteration could either grant access to more resources or deny access to resources that the system administrator has established. For example, the malicious user could remove all of the document-format values from the "document-format-supported" Printer attribute so that the Printer would refuse to accept all jobs.
恶意用户可能会更改由系统管理员建立并存储在打印机属性中的策略。这种更改可以授予对更多资源的访问权限,也可以拒绝对系统管理员已建立的资源的访问权限。例如,恶意用户可以从“支持的文档格式”打印机属性中删除所有文档格式值,以便打印机拒绝接受所有作业。
The general remedy for such malicious user actions against Printer attributes is to have strong Client Authentication coupled with Printer access control, to limit the users who have System Administrator or Operator privileges.
针对此类针对打印机属性的恶意用户操作的一般补救措施是使用强大的客户端身份验证和打印机访问控制,以限制具有系统管理员或操作员权限的用户。
A malicious user could modify the Job Template attributes of another user's Job, such as the "copies" attribute. For example, setting the number of copies to a large number.
恶意用户可以修改其他用户作业的作业模板属性,例如“副本”属性。例如,将副本数设置为一个较大的数字。
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.
针对针对其他用户作业的此类恶意用户操作的一般补救措施是使用强大的客户端身份验证和打印机访问控制,以限制具有系统管理员或操作员权限的用户修改任何作业,此外,存储每个作业的客户端身份验证,以便只有作业所有者最终用户可以修改他/她自己的作业。
14 References
14参考文献
[RFC2565] Herriot, R., Butler, S., Moore, P. and R. Tuner, "Internet Printing Protocol/1.0: Encoding and Transport", RFC 2565, April 1999.
[RFC2565]Herriot,R.,Butler,S.,Moore,P.和R.Tuner,“互联网打印协议/1.0:编码和传输”,RFC 25651999年4月。
[RFC2566] deBry, R., Hastings, T., Herriot, R., Isaacson, S. and P. Powell, "Internet Printing Protocol/1.0: Model and Semantics", RFC 2566, April 1999.
[RFC2566]deBry,R.,Hastings,T.,Herriot,R.,Isaacson,S.和P.Powell,“互联网打印协议/1.0:模型和语义”,RFC 2566,1999年4月。
[RFC2910] Herriot, R., Butler, S., Moore, P. and R. Turner, "Internet Printing Protocol/1.1: Encoding and Transport", RFC 2910, September 2000.
[RFC2910]Herriot,R.,Butler,S.,Moore,P.和R.Turner,“互联网打印协议/1.1:编码和传输”,RFC 29102000年9月。
[RFC2911] Hastings, T., Herriot, R., deBry, R., Isaacson, S. and P. Powell, "Internet Printing Protocol/1.0: Model and Semantics", RFC 2911, September 2000.
[RFC2911]黑斯廷斯,T.,赫里奥特,R.,德布雷,R.,艾萨克森,S.和P.鲍威尔,“互联网打印协议/1.0:模型和语义”,RFC 29112000年9月。
[RFC3382] deBry, R., Hastings, T., Herriot, R., Ocke, K. and P. Zehler, "Internet Printing Protocol (IPP): The 'collection' attribute syntax", RFC 3382, September 2002.
[RFC3382]deBry,R.,Hastings,T.,Herriot,R.,Ocke,K.和P.Zehler,“互联网打印协议(IPP)‘收集’属性语法”,RFC 3382,2002年9月。
[RFC2251] Wahl, M., Howes, T. abd S. Kille, "Lightweight Directory Access Protocol (v3)", RFC 2251, December 1997.
[RFC2251]Wahl,M.,Howes,T.abd S.Kille,“轻量级目录访问协议(v3)”,RFC 2251,1997年12月。
[RFC2252] Wahl, M., Coulbeck, A., Howes, T. and S. Kille, "Lightweight Directory Access Protocol (v3): Attribute Syntax Definitions", RFC 2252, December 1997.
[RFC2252]Wahl,M.,Coulbeck,A.,Howes,T.和S.Kille,“轻量级目录访问协议(v3):属性语法定义”,RFC2252,1997年12月。
[RFC2608] Guttman, E., Perkins, C., Veizades, J. and M. Day, "Service Location Protocol, Version 2", RFC 2608, June 1999.
[RFC2608]Guttman,E.,Perkins,C.,Veizades,J.和M.Day,“服务位置协议,版本2”,RFC 26081999年6月。
[RFC2609] Guttman, E., Perkins, C. and J. Kempf, "Service Templates and service: Schemes", RFC 2609, June 1999.
[RFC2609]Guttman,E.,Perkins,C.和J.Kempf,“服务模板和服务:方案”,RFC 26091999年6月。
[RFC3196] Hastings, T., Manros, C., Zehler, P., Kugler, C. and H. Holst, "Internet Printing Protocol/1.1: Implementor's Guide", RFC 3196, November 2001.
[RFC3196]Hastings,T.,Manros,C.,Zehler,P.,Kugler,C.和H.Holst,“互联网打印协议/1.1:实施者指南”,RFC 31962001年11月。
Appendix A: Allowed Values for Set-Printer-Attributes and Set-Job-Attributes requests (Normative)
附录A:设置打印机属性和设置作业属性请求的允许值(标准)
This appendix is a normative part of this document and contains a table of all IPP/1.1 attributes. Each row contains:
本附录是本文件的规范性部分,包含所有IPP/1.1属性的表格。每行包含:
- an attribute and
- 属性和
- the values allowed in the Set-Printer-Attributes or Set-Job-Attributes request for the attribute. The entry in each cell is the name (first few words) of each item below 1, 2, 3, 4a-g, and 5.
- 属性的“设置打印机属性”或“设置作业属性”请求中允许的值。每个单元格中的条目是1、2、3、4a-g和5下面每个项目的名称(前几个单词)。
The allowed values include the following cases:
允许的值包括以下情况:
1. READ-ONLY: the Set-Printer-Attributes or Set-Job-Attributes operation MUST NOT change this attribute and MUST reject the entire operation (see section 7.1).
1. 只读:设置打印机属性或设置作业属性操作不得更改此属性,并且必须拒绝整个操作(请参阅第7.1节)。
2. Any of "xxx-supported": the Set-Printer-Attributes or Set-Job-Attributes operation accepts values that are allowed according to the IPP/1.1 rules for validating the value(s) of an "xxx" Printer or Job attribute against the value(s) of the corresponding "xxx-supported" Printer attribute. Table 5 summarizes those validation rules depending on each attribute syntax and value of an "xxx" attribute supplied in the request and that of the corresponding "xxx-supported" Printer attribute. The "xxx-supported" attribute syntax type and value(s) are obtained from a Get-Printer-Supported-Values response (see the tables in this Appendix).
2. 任何“支持xxx”:设置打印机属性或设置作业属性操作接受根据IPP/1.1规则允许的值,用于对照相应的“支持xxx”打印机属性的值验证“xxx”打印机或作业属性的值。表5根据请求中提供的“xxx”属性和相应的“xxx支持的”打印机属性的每个属性语法和值总结了这些验证规则。“xxx支持的”属性语法类型和值可从Get Printer supported Values响应中获得(请参阅本附录中的表格)。
Table 5 - Validation rules for 'Any of "xxx-supported" '
表5-任何“支持xxx”的验证规则
Type of "xxx" Type of "xxx- Validates if: value to be supported" value set
类型为“xxx”类型为“xxx-验证是否:要支持的值”值集
integer rangeOfInteger each value is in one of the "xxx-supported" ranges
整数范围整数每个值都在“支持的xxx”范围内
uri uriScheme each uri scheme matches one of the "xxx-supported" schemes
uri uriScheme每个uri方案都匹配一个“xxx支持的”方案
any boolean if the boolean "xxx-supported" is 'true'
如果布尔值“xxx受支持”为“真”,则为任意布尔值
any same type each value matches an "xxx-supported" value of the same type
任何相同类型的每个值都与相同类型的“xxx支持”值匹配
For additional non-normative explanatory information see section 3.1.2.3 of the "Internet Printing Protocol/1.1: Implementer's Guide" [RFC3196].
更多非规范性解释信息,请参见“互联网打印协议/1.1:实施者指南”[RFC3196]第3.1.2.3节。
3. From Get-Printer-Supported-Values: the Set-Printer-Attributes operation accepts values that are allowed according to the IPP/1.1 rules for validating the value(s) of an "xxx" Printer attribute against the value(s) of the corresponding "xxx-supported" Printer attribute. Table 6 summarizes those validation rules depending on each attribute syntax and value of an "xxx" attribute supplied in the request and that of the corresponding "xxx-supported" Printer attribute. The "xxx-supported" attribute syntax type and attribute value(s) are obtained from a Get-Printer-Supported-Values response (see Appendix B: Attributes returned from Get-Printer-Supported-Values below).
3. 从获取打印机支持的值:设置打印机属性操作接受根据IPP/1.1规则允许的值,该规则用于对照相应的“支持xxx”打印机属性的值验证“xxx”打印机属性的值。表6根据请求中提供的“xxx”属性和相应的“xxx支持的”打印机属性的每个属性语法和值总结了这些验证规则。“xxx支持的”属性语法类型和属性值是从Get-Printer supported Values响应中获得的(请参阅下面的附录B:从Get-Printer supported Values返回的属性)。
Table 6 - Validation rules for 'From Get-Printer-Supported-Values'
表6“从获取打印机支持的值”的验证规则
Type of - "xxx" supported" value Validates if: value to be set Type of "xxx
“xxx”支持的“值”类型验证:值是否设置为“xxx”类型
integer rangeOfInteger each 'integer' value is in one of the "xxx-supported" ranges
整数范围整数每个“整数”值都在“支持的xxx”范围内
uri uriScheme the uri scheme of each value matches one of the "xxx-supported" schemes
uri uriScheme每个值的uri方案都与其中一个“xxx支持的”方案匹配
any boolean if the boolean "xxx-supported" is 'true'
如果布尔值“xxx受支持”为“真”,则为任意布尔值
name 'admin-define' any 'name' value matches out-of-band value
名称“admin define”任何“name”值都与带外值匹配
any same type each value matches an "xxx-supported" value of the same type
任何相同类型的每个值都与相同类型的“xxx支持”值匹配
For additional non-normative explanatory information see section 3.1.2.3 of the "Internet Printing Protocol/1.1: Implementer's Guide" [RFC3196].
更多非规范性解释信息,请参见“互联网打印协议/1.1:实施者指南”[RFC3196]第3.1.2.3节。
4. Any value of the proper attribute syntax: the Set-Printer-Attributes or Set-Job-Attributes operation accepts any value of the specified attribute syntax. The attribute syntaxes supported are enumerated below.
4. 正确属性语法的任何值:“设置打印机属性”或“设置作业属性”操作接受指定属性语法的任何值。下面列举了支持的属性语法。
a. Any text(127) b. Any name(127) c. Any uri d. Any boolean e. Any positive integer f. Any dateTime g. 1setOf any uri
a. 任何文本(127)b。任何名字(127)c。任何urid。任意布尔e。任意正整数f。任何日期时间g。1任何uri的设置
5. Combination of 'Any of "xxx-supported"' or 'Any name'. If a Printer implementation doesn't want to allow setting values indicated in this Appendix as "any xxx", it can make the value be not-settable.
5. “支持xxx”或“任意名称”的组合。如果打印机实现不希望允许将本附录中指示的值设置为“任意xxx”,则可使该值不可设置。
Table 7 - Values allowed for Job Template Attributes in the Set-Job-Attributes Operation
表7-设置作业属性操作中作业模板属性允许的值
Job Template Attributes Values allowed for Set
设置允许的作业模板属性值
job-priority (integer(1:100)) Any of "xxx-supported"
作业优先级(整数(1:100))任何“支持xxx”
job-hold-until (type3 keyword | name (MAX)) Any of "xxx-supported"
作业保留到(type3关键字| name(MAX))任何“支持xxx”为止
job-sheets (type3 keyword | name(MAX)) Any of "xxx-supported"
工作表(类型3关键字|名称(最大值))任何“支持xxx”
multiple-document-handling (type2 keyword) Any of "xxx-supported"
多文档处理(type2关键字)“支持xxx”中的任意一个
copies (integer(1:MAX)) Any of "xxx-supported"
复制(整数(1:MAX))任何“支持xxx”
finishings (1setOf type2 enum) Any of "xxx-supported"
“支持xxx”中的任何一项的饰面(类型2枚举的第1部分)
page-ranges (1setOf rangeOfInteger (1:MAX)) Any of "xxx-supported"
页面范围(1整型范围的设置(1:MAX))任何“支持xxx”
sides (type2 keyword) Any of "xxx-supported"
侧面(type2关键字)任何“支持xxx”
number-up (integer(1:MAX)) Any of "xxx-supported"
向上编号(整数(1:MAX))任何“支持xxx”
orientation-requested (type2 enum) Any of "xxx-supported"
要求定向(类型2枚举)任何“支持xxx”
media (type3 keyword | name(MAX)) Any of "xxx-supported"
媒体(type3关键字|名称(最大值))任何“支持xxx”
printer-resolution (resolution) Any of "xxx-supported"
打印机分辨率(分辨率)“支持xxx”中的任意一种
print-quality (type2 enum) Any of "xxx-supported"
打印质量(type2枚举)任何“支持xxx”
Table 8 - Values allowed for Job Description Attributes in the Set-Job-Attributes Operation
表8-设置作业属性操作中作业描述属性允许的值
Job Description Attributes Values allowed for Set
设置允许的职务说明属性值
job-uri (uri) READ-ONLY
作业uri(uri)只读
job-id (integer(1:MAX)) READ-ONLY
作业id(整数(1:MAX))只读
job-printer-uri (uri) READ-ONLY
作业打印机uri(uri)只读
job-more-info (uri) READ-ONLY
作业详细信息(uri)只读
job-name (name(MAX)) Any name(MAX)
作业名称(名称(最大值))任意名称(最大值)
job-originating-user-name (name(MAX)) READ-ONLY
作业发起用户名(名称(最大值))只读
job-state (type1 enum) READ-ONLY
作业状态(类型1枚举)只读
job-state-reasons (1setOf type2 keyword) READ-ONLY
作业状态原因(1setOf type2关键字)只读
job-state-message (text(MAX)) READ-ONLY
作业状态消息(文本(最大值))只读
job-detailed-status-messages (1setOf READ-ONLY text(MAX))
作业详细状态消息(1个只读文本设置(最大值))
job-document-access-errors (1setOf READ-ONLY text(MAX))
作业文档访问错误(1设置只读文本(最大值))
number-of-documents (integer(0:MAX)) READ-ONLY
只读文档数(整数(0:MAX))
output-device-assigned (name(127)) READ-ONLY
指定的输出设备(名称(127))只读
time-at-creation (integer(MIN:MAX)) READ-ONLY
创建时的时间(整数(最小值:最大值))只读
time-at-processing (integer(MIN:MAX)) READ-ONLY
处理时的时间(整数(最小值:最大值))只读
time-at-completed (integer(MIN:MAX)) READ-ONLY
完成时的时间(整数(最小值:最大值))只读
job-printer-up-time (integer(1:MAX)) READ-ONLY
作业打印机启动时间(整数(1:MAX))只读
date-time-at-creation (dateTime) READ-ONLY
创建时的日期时间(日期时间)只读
Job Description Attributes Values allowed for Set
设置允许的职务说明属性值
date-time-at-processing (dateTime) READ-ONLY
处理时的日期时间(日期时间)只读
date-time-at-completed (dateTime) READ-ONLY
完成时的日期时间(日期时间)只读
number-of-intervening-jobs (integer(0:MAX)) READ-ONLY
中间作业数(整数(0:MAX))为只读
job-message-from-operator (text(127)) Any text(127)
来自操作员的作业消息(文本(127))任何文本(127)
job-k-octets (integer(0:MAX)) READ-ONLY
job-k-octets(整数(0:MAX))只读
job-impressions (integer(0:MAX)) READ-ONLY
工作印象(整数(0:MAX))只读
job-media-sheets (integer(0:MAX)) READ-ONLY
作业介质表(整数(0:MAX))只读
job-k-octets-processed (integer(0:MAX)) READ-ONLY
job-k-octets-processed(整数(0:MAX))只读
job-impressions-completed (integer(0:MAX)) READ-ONLY
已完成工作印象(整数(0:MAX))只读
job-media-sheets-completed (integer(0:MAX)) READ-ONLY
作业介质表已完成(整数(0:MAX))只读
attributes-charset (charset) READ-ONLY
属性字符集(字符集)只读
attributes-natural-language READ-ONLY (naturalLanguage)
属性自然语言只读(自然语言)
Table 9 - Values allowed for Printer Job Template Attributes in the Set-Printer-Attributes Operation
表9-设置打印机属性操作中允许的打印机作业模板属性值
Printer Job Template Attributes Values allowed for Set
设置允许的打印机作业模板属性值
job-priority-default (integer(1:100)) Any of "xxx-supported"
作业优先级默认值(整数(1:100))任何“支持xxx”
job-hold-until-default (type3 keyword | name Any of "xxx-(MAX)) supported"
作业保留到默认值(type3关键字|命名支持的任何“xxx-(MAX))项”
job-sheets-default (type3 keyword | name(MAX)) Any of "xxx-supported"
工作表默认值(type3关键字| name(MAX))任何“支持xxx”
multiple-document-handling-default (type2 Any of "xxx-keyword) supported"
支持多文档处理默认值(类型2“xxx关键字”中的任意一个)
copies-default (integer(1:MAX)) Any of "xxx-supported"
复制任何“支持xxx”的默认值(整数(1:MAX))
Printer Job Template Attributes Values allowed for Set
设置允许的打印机作业模板属性值
finishings-default (1setOf type2 enum) Any of "xxx-supported"
完成默认值(1类型2枚举)任何“支持xxx”
sides-default (type2 keyword) Any of "xxx-supported"
默认情况下(type2关键字)任何“支持xxx”
number-up-default (integer(1:MAX)) Any of "xxx-supported"
向上编号默认值(整数(1:MAX))任何“支持xxx”
orientation-requested-default (type2 enum) Any of "xxx-supported"
方向请求默认值(type2枚举)任何“支持xxx”
media-default (type3 keyword | name(MAX)) Any of "xxx-supported"
媒体默认值(type3关键字| name(MAX))任何“支持xxx”
printer-resolution-default (resolution) Any of "xxx-supported"
打印机分辨率默认值(分辨率)“支持xxx”中的任意一个
print-quality-default (type2 enum) Any of "xxx-supported"
打印质量默认值(type2枚举)任何“支持xxx”
job-priority-supported (integer(1:100)) From Get-Printer-Supported-Values
从获取打印机支持的值中支持作业优先级(整数(1:100))
job-hold-until-supported (1setOf(type3 keyword From Get-| name (MAX))) Printer-Supported-Values
作业保留直到受支持(1setOf(Get-| name(MAX)中的type3关键字)打印机支持的值
job-sheets-supported (1setOf(type3 keyword | From Get-name(MAX))) Printer-Supported-Values
支持的工作表(1setOf(type3关键字| From Get name(MAX)))打印机支持的值
multiple-document-handling-supported (1setOf From Get-type2 keyword) Printer-Supported-Values
支持多文档处理(1setOf From Get-type2关键字)打印机支持的值
copies-supported (rangeOfInteger(1:MAX)) From Get-Printer-Supported-Values
从获取打印机支持的值复制支持的副本(rangeOfInteger(1:MAX))
finishings-supported (1setOf type2 enum) From Get-Printer-Supported-Values
从“获取打印机支持的值”支持的完成(1类型2枚举的设置)
Printer Job Template Attributes Values allowed for Set
设置允许的打印机作业模板属性值
page-ranges-supported (boolean) From Get-Printer-Supported-Values
获取打印机支持的值时支持的页面范围(布尔值)
sides-supported (1setOf type2 keyword) From Get-Printer-Supported-Values
从“获取打印机支持的值”支持的边(1setOf type2关键字)
number-up-supported (1setOf (integer(1:MAX) | From Get-rangeOfInteger(1:MAX))) Printer-Supported-Values
支持的数字上限(1setOf(整数(1:MAX)|来自Get rangeOfInteger(1:MAX)))打印机支持的值
orientation-requested-supported (1setOf type2 From Get-enum) Printer-Supported-Values
支持请求的方向(1从Get enum获取类型2的设置)打印机支持的值
media-supported (1setOf (type3 keyword | From Get-name(MAX))) Printer-Supported-Values
支持的介质(1setOf(type3关键字| From Get name(MAX)))打印机支持的值
printer-resolution-supported (1setOf From Get-resolution) Printer-Supported-Values
支持的打印机分辨率(1setOf From Get resolution)打印机支持的值
print-quality-supported (1setOf type2 enum) From Get-Printer-Supported-Values
从“获取打印机支持的值”支持的打印质量(1setOf type2枚举)
media-ready (type3 keyword | name(MAX)) From Get-Printer-Supported-Values
“获取打印机支持的值”中的“介质就绪”(type3关键字|名称(最大值))
Table 10 - Values allowed for Printer Description Attributes in the Set-Printer-Attributes Operation
表10-设置打印机属性操作中允许的打印机描述属性值
Printer Description Attributes Values allowed for Set
设置允许的打印机描述属性值
printer-uri-supported (1setOf uri) READ-ONLY
支持的打印机uri(1setOf uri)只读
uri-authentication-supported (1setOf type2 READ-ONLY keyword)
支持uri身份验证(1setOf type2只读关键字)
uri-security-supported (1setOf type2 READ-ONLY keyword)
支持uri安全性(1setOf type2只读关键字)
printer-xri-supported (1setOf collection) member attributes:
支持的打印机xri(1setOf collection)成员属性:
xri-uri (uri) any uriScheme of "xri-uri-scheme-supported" from Get-Printer-Attributes
xri uri(uri)从Get Printer Attributes获得的“支持xri uri方案”的任何uri模式
xri-authentication (type2 keyword) any keyword of "xri-authentication-supported" from Get-Printer-Attributes
xri身份验证(type2关键字)获取打印机属性中“支持xri身份验证”的任何关键字
xri-security (type2 keyword) any keyword of "xri-security-supported" from Get-Printer-Attributes
xri安全性(type2关键字)获取打印机属性中“支持xri安全性”的任何关键字
xri-uri-scheme-supported (1setOf uriScheme) READ-ONLY
支持的xri uri方案(1setOf uri方案)只读
xri-authentication-supported (1setOf type2 READ-ONLY keyword)
支持xri身份验证(1setOf type2只读关键字)
xri-security-supported (1setOf type2 READ-ONLY keyword)
支持xri安全性(1setOf type2只读关键字)
Printer Description Attributes Values allowed for Set
设置允许的打印机描述属性值
printer-name (name(127)) Any name(127)
打印机名称(名称(127))任何名称(127)
printer-location (text(127)) Any text(127)
打印机位置(文本(127))任何文本(127)
printer-info (text(127)) Any text(127)
打印机信息(文本(127))任何文本(127)
printer-more-info (uri) Any uri
打印机更多信息(uri)任何uri
printer-driver-installer (uri) Any uri
打印机驱动程序安装程序(uri)任何uri
printer-make-and-model (text(127)) Any text(127)
打印机品牌和型号(文本(127))任何文本(127)
printer-more-info-manufacturer (uri) Any uri
打印机更多信息制造商(uri)任何uri
printer-state (type1 enum) READ-ONLY
打印机状态(type1枚举)只读
printer-state-reasons (1setOf type2 READ-ONLY keyword)
打印机状态原因(1setOf TYPE 2只读关键字)
printer-state-message (text(MAX)) READ-ONLY
打印机状态消息(文本(最大值))只读
ipp-versions-supported (1setOf type2 From Get-Printer-keyword) Supported-Values
支持的ipp版本(1 Get Printer关键字中的类型2设置)支持的值
operations-supported (1setOf type2 enum) From Get-Printer-Supported-Values
从获取打印机支持的值支持的操作(1setOf type2枚举)
multiple-document-jobs-supported (boolean) From Get-Printer-Supported-Values
从“获取打印机支持的值”支持多个文档作业(布尔值)
charset-configured (charset) Any of "xxx-supported", use "charset-supported"
已配置字符集(字符集)任何“支持xxx”,请使用“支持字符集”
charset-supported (1setOf charset) From Get-Printer-Supported-Values
从获取打印机支持的值中获取支持的字符集(1setOf charset)
Printer Description Attributes Values allowed for Set
设置允许的打印机描述属性值
natural-language-configured Any of "xxx-(naturalLanguage) supported", use "generated-natural-language-supported"
自然语言配置为“支持xxx-(自然语言)中的任何一种”,使用“支持生成的自然语言”
generated-natural-language-supported From Get-Printer-(1setOf naturalLanguage) Supported-Values
从Get Printer-(1setOf naturalLanguage)支持的值生成支持的自然语言
document-format-default (mimeMediaType) Any of "xxx-supported"
文档格式默认值(mimeMediaType)“支持xxx”中的任意一种
document-format-supported (1setOf From Get-Printer-mimeMediaType) Supported-Values
支持的文档格式(1setOf From Get Printer mimeMediaType)支持的值
printer-is-accepting-jobs (boolean) READ-ONLY
打印机正在接受只读作业(布尔值)
queued-job-count (integer(0:MAX)) READ-ONLY
队列作业计数(整数(0:MAX))只读
printer-message-from-operator (text(127)) Any text(127)
来自操作员的打印机消息(文本(127))任何文本(127)
color-supported (boolean) From Get-Printer-Supported-Values
从获取打印机支持的值中获取支持的颜色(布尔值)
reference-uri-schemes-supported (1setOf From Get-Printer-uriScheme) Supported-Values
支持的引用uri方案(来自Get Printer uri方案的1setOf)支持的值
pdl-override-supported (type2 keyword) From Get-Printer-Supported-Values
从“获取打印机支持的值”支持pdl覆盖(type2关键字)
printer-up-time (integer(1:MAX)) READ-ONLY
打印机启动时间(整数(1:MAX))只读
printer-current-time (dateTime) Any dateTime **
打印机当前时间(dateTime)任意日期时间**
multiple-operation-time-out any positive (integer(1:MAX)) integer
多次操作超时任意正(整数(1:MAX))整数
compression-supported (1setOf type3 From Get-Printer-keyword) Supported-Values
支持压缩(1 Get Printer关键字中的类型3设置)支持的值
job-k-octets-supported From Get-Printer-(rangeOfInteger(0:MAX)) Supported-Values
job-k-octets-受Get Printer支持-(rangeOfInteger(0:MAX))支持的值
Printer Description Attributes Values allowed for Set
设置允许的打印机描述属性值
job-impressions-supported From-Get-Printer-(rangeOfInteger(0:MAX)) Supported-Values
Get Printer-(rangeOfInteger(0:MAX))支持的值支持的作业印象
job-media-sheets-supported From Get-Printer-(rangeOfInteger(0:MAX)) Supported-Values
Get Printer-(rangeOfInteger(0:MAX))支持的值支持的作业介质表
pages-per-minute (integer(0:MAX)) READ-ONLY
每分钟页数(整数(0:MAX))只读
pages-per-minute-color (integer(0:MAX)) READ-ONLY
每分钟页数颜色(整数(0:MAX))只读
printer-settable-attributes-supported From Get-Printer-(1setOf type2 keyword) Supported-Values
Get printer-(1setOf type2关键字)支持的值支持的打印机可设置属性
job-settable-attributes-supported (1setOf From Get-Printer-type2 keyword) Supported-Values
支持的作业可设置属性(1setOf From Get-Printer-type2关键字)支持的值
document-format-varying-attributes (1setOf READ-ONLY type2 keyword)
文档格式可变属性(1只读类型的设置2关键字)
printer-message-time (integer(MIN:MAX)) READ-ONLY
打印机消息时间(整数(最小值:最大值))只读
printer-message-date-time(dateTime) READ-ONLY
打印机消息日期时间(dateTime)只读
** - The "printer-current-time" (dateTime) attribute is settable in order to allow an administrator to correct an incorrect dateTime or time zone.
**-可设置“打印机当前时间”(dateTime)属性,以便管理员更正不正确的日期时间或时区。
Appendix B: Attributes returned from Get-Printer-Supported-Values (Normative)
附录B:从获取打印机支持的值返回的属性(标准)
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."
本附录是本文档的规范性部分,列出了实现在Get Printer Supported Values响应中可能返回的所有属性,即在Set Printer attributes请求中可以提供的所有“xxx Supported”属性。只读属性不得在Get Printer Supported Values响应中返回,并在表中指示为“只读-不得返回”
For the following attributes, the value allowed by the Set-Printer-Attributes operation MUST be a single integer value in the range specified by the value returned by the Get-Printer-Supported-Values operation.
对于以下属性,“设置打印机属性”操作允许的值必须是“获取打印机支持的值”操作返回的值所指定范围内的单个整数值。
Table 11 - Printer Job Template Attributes returned from Get-Printer-Supported-Values
表11-从获取打印机支持的值返回的打印机作业模板属性
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-Attributes operation MUST be a single rangeOfInteger value whose bounds do not exceed those of the range specified by the value returned by the Get-Printer-Supported-Values operation.
对于以下属性,“设置打印机属性”操作允许的值必须是单个rangeOfInteger值,其边界不得超过“获取打印机支持的值”操作返回的值所指定的范围。
Table 12 - Printer Job Template Attributes returned from Get-Printer-Supported-Values
表12-从获取打印机支持的值返回的打印机作业模板属性
Printer Job Template Attributes Values Returned
返回的打印机作业模板属性值
copies-supported (rangeOfInteger(1:MAX)) rangeOfInteger(1:MAX)
copies-supported (rangeOfInteger(1:MAX)) rangeOfInteger(1:MAX)
The following table has the same criteria as the last, but is for Printer Description attributes.
下表的条件与上表相同,但适用于打印机描述属性。
Table 13 - Printer Description Attributes returned from Get-Printer-Supported-Values
表13-从获取打印机支持的值返回的打印机描述属性
Printer Description Attributes Values allowed for Set
设置允许的打印机描述属性值
job-k-octets-supported rangeOfInteger(0:MAX) (rangeOfInteger(0:MAX))
job-k-octets-supported rangeOfInteger(0:MAX) (rangeOfInteger(0:MAX))
job-impressions-supported (rangeOfInteger(0:MAX)) rangeOfInteger(0:MAX)
job-impressions-supported (rangeOfInteger(0:MAX)) rangeOfInteger(0:MAX)
job-media-sheets-supported rangeOfInteger(0:MAX) (rangeOfInteger(0:MAX))
job-media-sheets-supported rangeOfInteger(0:MAX) (rangeOfInteger(0:MAX))
For the following attributes, the value allowed by the Set-Printer-Attributes operation MUST be one or more integers and rangeOfInteger values, such that the integer values described by these integers and rangeOfInteger is the same as or a subset of the integers described by the integers and rangeOf Integer of values returned by the Get-Printer-Supported-Values operation.
对于以下属性,“设置打印机属性”操作允许的值必须是一个或多个整数和rangeOfInteger值,使这些integers和rangeOfInteger描述的整数值与Get Printer Supported values操作返回的integers和rangeOfInteger值描述的整数值相同或是其子集。
Table 14 - Printer Job Template Attributes returned from Get-Printer-Supported-Values
表14-从获取打印机支持的值返回的打印机作业模板属性
Printer Job Template Attributes Values Returned
返回的打印机作业模板属性值
number-up-supported (1setOf (integer(1:MAX) 1setOf | rangeOfInteger(1:MAX))) (integer(1:MAX) | rangeOfInteger(1:MA X))
number-up-supported (1setOf (integer(1:MAX) 1setOf | rangeOfInteger(1:MAX))) (integer(1:MAX) | rangeOfInteger(1:MA X))
For the following attributes, the value allowed by the Set-Printer-Attributes operation MUST be one or more values, where each such value matches a value returned by the Get-Printer-Supported-Values operation. A keyword, enum, boolean, charset, naturalLanguage, uriScheme, mimeMediaType or resolution value matches if it is equal. For Job Template attributes, with the attribute syntax 'type3 keyword | name', any 'name' attribute syntax value matches the 'admin-define' out-of-band value, if the implementation allows the administrator to set any name values for the attribute.
对于以下属性,“设置打印机属性”操作允许的值必须是一个或多个值,其中每个值都与“获取打印机支持的值”操作返回的值匹配。关键字、枚举、布尔值、字符集、自然语言、URI模式、mimeMediaType或分辨率值匹配(如果相等)。对于作业模板属性,如果实现允许管理员为属性设置任何名称值,则使用属性语法“type3关键字| name”,任何“name”属性语法值都与“admin define”带外值匹配。
Table 15 - Printer Job Template Attributes returned from Get-Printer-Supported-Values
表15-从获取打印机支持的值返回的打印机作业模板属性
Printer Job Template Attributes Values Returned
返回的打印机作业模板属性值
job-hold-until-supported (1setOf(type3 1setOf (type3 keyword | name (MAX))) keyword | 'admin-define')
作业保持到支持为止(1setOf(type3 1setOf(type3关键字| name(MAX)))关键字|“admin define”)
job-sheets-supported (1setOf(type3 keyword 1setOf (type3 | name(MAX))) keyword | 'admin-define')
支持的工作表(1setOf(type3关键字1setOf(type3 | name(MAX)))关键字|“admin define”)
multiple-document-handling-supported 1setOf type2 (1setOf type2 keyword) keyword
支持多文档处理1setOf type2(1setOf type2关键字)关键字
finishings-supported (1setOf type2 enum) 1setOf type2 enum
支持的完成(1类型2枚举的设置)1类型2枚举的设置
page-ranges-supported (boolean) 1setOf boolean **
支持的页面范围(布尔值)1布尔值设置**
sides-supported (1setOf type2 keyword) 1setOf type2 keyword
支持的边(1setOf type2关键字)1setOf type2关键字
orientation-requested-supported (1setOf 1setOf type2 enum type2 enum)
支持请求的方向(1setOf 1setOf type2枚举类型2枚举)
Printer Job Template Attributes Values Returned
返回的打印机作业模板属性值
media-supported (1setOf (type3 keyword | 1setOf (type3 name(MAX))) keyword | 'admin-define')
支持媒体(1setOf(type3关键字| 1setOf(type3名称(最大)))关键字|“admin define”)
printer-resolution-supported (1setOf 1setOf resolution resolution)
支持打印机分辨率(1setOf 1setOf分辨率)
print-quality-supported (1setOf type2 enum) 1setOf type2 enum
支持的打印质量(1设置类型2枚举)1设置类型2枚举
** Note: the Get-Printer-Supported-Values returns a '1setOf boolean' so that all possible values are indicated, while ** Get-Printer-Attributes returns only a single 'boolean' value.
**注意:Get Printer Supported(获取打印机支持的)值返回一个“1setOf boolean”(布尔值),以便指示所有可能的值,而**Get Printer属性仅返回一个“boolean”(布尔值)。
The following table has the same criteria as the last, but is for Printer Description attributes.
下表的条件与上表相同,但适用于打印机描述属性。
Table 16 - Printer Description Attributes returned from Get-Printer-Supported-Values
表16-从获取打印机支持的值返回的打印机描述属性
Printer Description Attributes Values allowed for Set
设置允许的打印机描述属性值
printer-uri-supported (1setOf uri) READ-ONLY - MUST NOT be returned
支持的打印机uri(1setOf uri)只读-不得返回
uri-authentication-supported (1setOf type2 READ-ONLY - MUST keyword) NOT be returned
不返回支持的uri身份验证(1setOf type2只读-必须为关键字)
uri-security-supported (1setOf type2 READ-ONLY - MUST keyword) NOT be returned
不返回支持的uri安全性(1setOf type2只读-必须为关键字)
printer-xri-supported (1setOf collection) MUST NOT be returned; see next three attributes returned with Get-Printer-Attributes:
不可退回支持的打印机xri(1setOf collection);请参阅“获取打印机属性”返回的下三个属性:
xri-uri-scheme-supported (1setOf uriScheme) READ-ONLY - MUST NOT be returned
支持的xri uri方案(1setOf uri方案)只读-不得返回
xri-authentication-supported (1setOf type2 READ-ONLY - MUST keyword) NOT be returned
不返回支持的xri身份验证(1setOf type2只读-必须为关键字)
xri-security-supported (1setOf type2 READ-ONLY - MUST keyword) NOT be returned
不返回支持的xri安全性(1setOf type2只读-必须为关键字)
Printer Description Attributes Values allowed for Set
设置允许的打印机描述属性值
ipp-versions-supported (1setOf type2 1setOf type2 keyword) keyword
支持的ipp版本(1setOf type2 1setOf type2关键字)关键字
operations-supported (1setOf type2 enum) 1setOf type2 keyword
支持的操作(1setOf type2枚举)1setOf type2关键字
multiple-document-jobs-supported (boolean) 1setOf boolean **
支持多个文档作业(布尔值)1布尔值**
charset-supported (1setOf charset) 1setOf charset
支持的字符集(1setOf字符集)1setOf字符集
generated-natural-language-supported 1setOf (1setOf naturalLanguage) naturalLanguage
生成的自然语言支持1setOf(1setOf naturalLanguage)自然语言
document-format-supported (1setOf 1setOf mimeMediaType) mimeMediaType
支持的文档格式(1setOf 1setOf mimeMediaType)mimeMediaType
color-supported (boolean) 1setOf boolean **
支持颜色(布尔值)1布尔值**
reference-uri-schemes-supported (1setOf 1setOf uriScheme uriScheme)
支持的参考uri方案(1setOf 1setOf uriScheme uriScheme)
pdl-override-supported (type2 keyword) 1setOf type2 keyword **
支持pdl覆盖(type2关键字)1设置type2关键字**
compression-supported (1setOf type3 1setOf type3 keyword) keyword
支持压缩(1setOf type3 1setOf type3关键字)关键字
printer-settable-attributes-supported 1setOf type2 (1setOf type2 keyword) keyword
支持的打印机可设置属性1setOf type2(1setOf type2关键字)关键字
job-settable-attributes-supported (1setOf 1setOf type2 type2 keyword) keyword
支持的作业可设置属性(1setOf 1setOf type2关键字)关键字
** Note: the Get-Printer-Supported-Values returns a '1setOf X' so that all possible values are indicated, while Get-Printer-Attributes returns only a single 'X' value.
**注意:Get-Printer Supported(获取打印机支持的)值返回一个“1setOf X”,以便指示所有可能的值,而Get-Printer属性仅返回一个“X”值。
Appendix C: Description of the Base IPP Documents (Informative)
附录C:基础IPP文件说明(资料性)
The base set of IPP documents includes:
IPP文件的基本集包括:
Design Goals for an Internet Printing Protocol [RFC2567] Rationale for the Structure and Model and Protocol for the Internet Printing Protocol [RFC2568] Internet Printing Protocol/1.1: Model and Semantics [RFC2911] Internet Printing Protocol/1.1: Encoding and Transport [RFC2910] Internet Printing Protocol/1.1: Implementer's Guide [RFC3196] Mapping between LPD and IPP Protocols [RFC2569]
Design Goals for an Internet Printing Protocol [RFC2567] Rationale for the Structure and Model and Protocol for the Internet Printing Protocol [RFC2568] Internet Printing Protocol/1.1: Model and Semantics [RFC2911] Internet Printing Protocol/1.1: Encoding and Transport [RFC2910] Internet Printing Protocol/1.1: Implementer's Guide [RFC3196] Mapping between LPD and IPP Protocols [RFC2569]
The "Design Goals for an Internet Printing Protocol" document takes a broad look at distributed printing functionality, and it enumerates real-life scenarios that help to clarify the features that need to be included in a printing protocol for the Internet. It identifies requirements for three types of users: end users, operators, and administrators. It calls out a subset of end user requirements that are satisfied in IPP/1.0 [RFC2566, RFC2565]. A few OPTIONAL operator operations have been added to IPP/1.1 [RFC2911, RFC2910].
“Internet打印协议的设计目标”文档广泛介绍了分布式打印功能,并列举了有助于澄清需要包含在Internet打印协议中的功能的实际场景。它确定了三类用户的需求:最终用户、操作员和管理员。它调用了IPP/1.0[RFC2566,RFC2565]中满足的最终用户需求子集。IPP/1.1[RFC2911、RFC2910]中增加了一些可选的操作员操作。
The "Rationale for the Structure and Model and Protocol for the Internet Printing Protocol" document describes IPP from a high level view, defines a roadmap for the various documents that form the suite of IPP specification documents, and gives background and rationale for the IETF IPP working group's major decisions.
“互联网打印协议的结构、模型和协议的基本原理”文件从高层次上描述了IPP,定义了构成IPP规范文件套件的各种文件的路线图,并为IETF IPP工作组的主要决策提供了背景和基本原理。
The "Internet Printing Protocol/1.1: Model and Semantics" document describes a simplified model with abstract objects, their attributes, and their operations. The model introduces a Printer and a Job. The Job supports multiple documents per Job. The model document also addresses how security, internationalization, and directory issues are addressed.
“Internet打印协议/1.1:模型和语义”文档描述了一个简化模型,其中包含抽象对象、它们的属性及其操作。该模型引入了打印机和作业。每个作业支持多个文档。模型文档还讨论了如何解决安全性、国际化和目录问题。
The "Internet Printing Protocol/1.1: Encoding and Transport" document is a formal mapping of the abstract operations and attributes defined in the model document onto HTTP/1.1 [RFC2616]. It also defines the encoding rules for a new Internet MIME media type called "application/ipp". This document also defines the rules for transporting over HTTP, a message body whose Content-Type is "application/ipp". This document defines the 'ipp' scheme for identifying IPP printers and jobs.
“Internet打印协议/1.1:编码和传输”文档是模型文档中定义的抽象操作和属性到HTTP/1.1[RFC2616]的正式映射。它还定义了称为“应用程序/ipp”的新Internet MIME媒体类型的编码规则。本文档还定义了通过HTTP传输的规则,HTTP是一种内容类型为“application/ipp”的消息体。本文件定义了识别ipp打印机和作业的“ipp”方案。
The "Internet Printing Protocol/1.1: Implementer's Guide" document gives insight and advice to implementers of IPP clients and IPP objects. It is intended to help them understand IPP/1.1 and some of the considerations that may assist them in the design of their client
“互联网打印协议/1.1:实施者指南”文件为IPP客户端和IPP对象的实施者提供了见解和建议。旨在帮助他们理解IPP/1.1和一些可能有助于他们设计客户的注意事项
and/or IPP object implementations. For example, a typical order of processing requests is given, including error checking. Motivation for some of the specification decisions are also included.
和/或IPP对象实现。例如,给出了处理请求的典型顺序,包括错误检查。还包括一些规范决策的动机。
The "Mapping between LPD and IPP Protocols" document gives some advice to implementers of gateways between IPP and LPD (Line Printer Daemon) implementations.
“LPD和IPP协议之间的映射”文档为IPP和LPD(Line Printer Daemon)实现之间网关的实现者提供了一些建议。
Authors' Addresses
作者地址
Carl Kugler IBM P.O. Box 1900 Boulder, CO 80301-9191
美国科罗拉多州博尔德市1900号卡尔·库格勒IBM邮政信箱80301-9191
Phone: (303) 924-5060 EMail: kugler@us.ibm.com
电话:(303)924-5060电子邮件:kugler@us.ibm.com
Tom Hastings Xerox Corporation 737 Hawaii St. ESAE 231 El Segundo, CA 90245
汤姆黑斯廷斯施乐公司737夏威夷圣埃塞231埃尔塞贡多,加利福尼亚州90245
Phone: 310-333-6413 Fax: 310-333-5514 EMail: hastings@cp10.es.xerox.com
电话:310-333-6413传真:310-333-5514电子邮件:hastings@cp10.es.xerox.com
Robert Herriot Consultant 706 Colorado Ave Palo Alto, CA 94303
加利福尼亚州帕洛阿尔托市科罗拉多大道706号罗伯特·赫里奥特咨询公司,邮编94303
Phone: 650-327-4466 Fax: 650-327-4466 EMail: bob@Herriot.com
电话:650-327-4466传真:650-327-4466电子邮件:bob@Herriot.com
Harry Lewis IBM 6300 Diagonal Hwy. Boulder, CO 80301-9191
哈里·刘易斯IBM 6300对角高速公路。科罗拉多州博尔德80301-9191
Phone: (303) 924-5337 EMail: harryl@us.ibm.com
电话:(303)924-5337电子邮件:harryl@us.ibm.com
IPP Web Page: http://www.pwg.org/ipp/ IPP Mailing List: ipp@pwg.org
IPP Web Page: http://www.pwg.org/ipp/ IPP Mailing List: ipp@pwg.org
To subscribe to the ipp mailing list, send the following email:
要订阅ipp邮件列表,请发送以下电子邮件:
1) send it to majordomo@pwg.org 2) leave the subject line blank 3) put the following two lines in the message body: subscribe ipp end
1) 寄到majordomo@pwg.org2)主题行留空3)在消息正文中插入以下两行:subscribe ipp end
Implementers of this specification document are encouraged to join the IPP Mailing List in order to participate in any discussions of clarification issues and review of registration proposals for additional attributes and values. In order to reduce spam the mailing list rejects mail from non-subscribers, so you must subscribe to the mailing list in order to send a question or comment to the mailing list.
鼓励本规范文件的实施者加入IPP邮件列表,以便参与澄清问题的任何讨论,并审查其他属性和值的注册提案。为了减少垃圾邮件,邮件列表拒绝来自非订阅者的邮件,因此您必须订阅邮件列表才能向邮件列表发送问题或评论。
Full Copyright Statement
完整版权声明
Copyright (C) The Internet Society (2002). All Rights Reserved.
版权所有(C)互联网协会(2002年)。版权所有。
This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English.
本文件及其译本可复制并提供给他人,对其进行评论或解释或协助其实施的衍生作品可全部或部分编制、复制、出版和分发,不受任何限制,前提是上述版权声明和本段包含在所有此类副本和衍生作品中。但是,不得以任何方式修改本文件本身,例如删除版权通知或对互联网协会或其他互联网组织的引用,除非出于制定互联网标准的需要,在这种情况下,必须遵循互联网标准过程中定义的版权程序,或根据需要将其翻译成英语以外的其他语言。
The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns.
上述授予的有限许可是永久性的,互联网协会或其继承人或受让人不会撤销。
This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
本文件和其中包含的信息是按“原样”提供的,互联网协会和互联网工程任务组否认所有明示或暗示的保证,包括但不限于任何保证,即使用本文中的信息不会侵犯任何权利,或对适销性或特定用途适用性的任何默示保证。
Acknowledgement
确认
Funding for the RFC Editor function is currently provided by the Internet Society.
RFC编辑功能的资金目前由互联网协会提供。