[IPP] Proposed text for a Register-Output-Device operation

[IPP] Proposed text for a Register-Output-Device operation

Michael Sweet msweet at apple.com
Mon May 15 21:29:27 UTC 2017


All,

Here is my proposed text for a Register-Output-Device operation...


6.4.7 Register-Output-Device

This CONDITIONALLY REQUIRED operation allows a Proxy to register an Output Device with the target System object.  Systems that conform to the IPP Shared Infrastructure Extensions (INFRA) MUST support this operation.

The Register-Output-Device operation returns a Printer object of the specified type that accepts Jobs on behalf of the Output Device.  How these Printer objects are created or provisioned is implementation-specific.

Access Rights: The authenticated user (see section 8.3 of [RFC2911]) performing this operation must be a Proxy of the Printer object. Otherwise, the Infrastructure Printer MUST reject the operation and return: 'client-error-forbidden', 'client-error-not-authenticated', or 'client-error-not-authorized' as appropriate.


6.4.7.1 Register-Output-Device Request

The following groups of attributes are part of a Register-Output-Device request.

Group 1: Operation Attributes

"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):

The Client MUST supply and the System MUST support both of these attributes.

“system-uri” (uri):

The Client MUST supply and the System MUST support the “system-uri” operation attribute which is the target System for the operation.

"requesting-user-name" (name(MAX)) and "requesting-user-uri" (uri) and “requesting-user-vcard” (1setOf text(1023)): 

The Client SHOULD supply and the System MUST support all three of these attributes.

“printer-service-type” (type2 keyword):

The Client MUST supply and the System MUST support this attribute.

"output-device-uuid" (uri):

The Proxy MUST supply this attribute and the Infrastructure Printer MUST support this attribute.  It provides the identity of the Output Device for the request.


6.4.7.2 Register-Output-Device Response

The following groups of attributes are part of a Register-Output-Device response.

Group 1: Operation Attributes

"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):

The System MUST return both of these attributes.

"status-message" (text(255)) and/or "detailed-status-message" (text(MAX)):

The System MAY return one or both of these attributes.

Group 2: Unsupported Attributes

See [RFC8011] for details on returning Unsupported Attributes.

Group 3: Printer Attributes

See [RFC8011] for details on returning Printer Attributes.

“printer-id (integer(1:MAX)):

The System MUST return this attribute.

“printer-uuid” (uri(45)):

The System MUST return this attribute.

“printer-xri-supported” (1setOf collection)

The System MUST return this attribute.

“printer-state” (type1 enum) and “printer-state-reasons” (1setOf type2 keyword) and “printer-is-accepting-jobs” (boolean):

The System MUST return all three of these attributes.

_________________________________________________________
Michael Sweet, Senior Printing System Engineer

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.pwg.org/pipermail/ipp/attachments/20170515/daedfa6b/attachment.html>


More information about the ipp mailing list