131
The Printer Working Group July 6, 2022 Working Draft IPP Implementor's Guide v2.0 (IG) (Updates RFC 3196) Status: Stable Abstract: This document updates and extends "Internet Printing Protocol/1.1: Implementor’s Guide" (RFC 3196) for all IPP protocol versions. This document is a PWG Working Draft. For a definition of a "PWG Working Draft", see: http://ftp.pwg.org/pub/pwg/general/pwg- process30.pdf http://ftp.pwg.org/pub/pwg/general/pwg- process30.pdf This document is available electronically at: http://ftp.pwg.org/pub/pwg/ipp/wd/wd-ippig20-20150211.pdf Copyright © 2014 The Printer Working Group. All rights reserved. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

Page 1: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

The Printer Working Group

May 16, 2023Working Draft

IPP Implementor's Guide v2.0 (IG)(Updates RFC 3196)

Status: Stable

Abstract: This document updates and extends "Internet Printing Protocol/1.1: Implementor’s Guide" (RFC 3196) for all IPP protocol versions.

This document is a PWG Working Draft. For a definition of a "PWG Working Draft", see: http://ftp.pwg.org/pub/pwg/general/pwg-process30.pdf http://ftp.pwg.org/pub/pwg/ general/pwg-process30.pdf

This document is available electronically at:

http://ftp.pwg.org/pub/pwg/ipp/wd/wd-ippig20-20150211.pdf

Copyright © 2014 The Printer Working Group. All rights reserved.

123456789

1011

12

13

14

15

1617

181920

21

22

Page 2: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

The Printer Working Group

May 16, 2023Working Draft

http://ftp.pwg.org/pub/pwg/ipp/wd/wd-ippig20-20150303.pdf

Copyright © 20142012-2015 The Printer Working Group. All rights reserved.

23

Page 3: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Copyright © 2012-2015 The Printer Working Group. All rights reserved.

This document 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, this paragraph and the title of the Document as referenced below 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 IEEE-ISTO and the Printer Working Group, a program of the IEEE-ISTO.

Title: IPP Implementor's Guide v2.0 (IG)

The IEEE-ISTO and the Printer Working Group DISCLAIM ANY AND ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED INCLUDING (WITHOUT LIMITATION) ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

The Printer Working Group, a program of the IEEE-ISTO, reserves the right to make changes to the document without further notice. The document may be updated, replaced or made obsolete by other documents at any time.

The IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights.

The IEEE-ISTO invites any interested party to bring to its attention any copyrights, patents, or patent applications, or other proprietary rights which may cover technology that may be required to implement the contents of this document. The IEEE-ISTO and its programs shall not be responsible for identifying patents for which a license may be required by a document and/or IEEE-ISTO Industry Group Standard or for conducting inquiries into the legal validity or scope of those patents that are brought to its attention. Inquiries may be submitted to the IEEE-ISTO by e-mail at: [email protected].

The Printer Working Group acknowledges that the IEEE-ISTO (acting itself or through its designees) is, and shall at all times, be the sole entity that may authorize the use of certification marks, trademarks, or other special designations to indicate compliance with these materials.

Use of this document is wholly voluntary. The existence of this document does not imply that there are no other ways to produce, test, measure, purchase, market, or provide other goods and services related to its scope.

Page 3 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

12

24

2526272829303132

33

34353637

383940

4142434445

46474849505152

53545556

57585960

3

Page 4: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

About the IEEE-ISTO

The IEEE-ISTO is a not-for-profit corporation offering industry groups an innovative and flexible operational forum and support services. The IEEE-ISTO provides a forum not only to develop standards, but also to facilitate activities that support the implementation and acceptance of standards in the marketplace. The organization is affiliated with the IEEE (http://www.ieee.org/ http://www.ieee.org/ ) and the IEEE Standards Association (http://standards.ieee.org/) http://standards.ieee.org/) .

For additional information regarding the IEEE-ISTO and its industry programs visit:

http://www.ieee-isto.orghttp://www.ieee-isto.org

About the IEEE-ISTO PWG

The Printer Working Group (or PWG) is a Program of the IEEE Industry Standards and Technology Organization (ISTO) with member organizations including printer manufacturers, print server developers, operating system providers, network operating systems providers, network connectivity vendors, and print management application developers. The group is chartered to make printers and the applications and operating systems supporting them work together better. All references to the PWG in this document implicitly mean “The Printer Working Group, a Program of the IEEE ISTO.” In order to meet this objective, the PWG will document the results of their work as open standards that define print related protocols, interfaces, procedures and conventions. Printer manufacturers and vendors of printer related software will benefit from the interoperability provided by voluntary conformance to these standards.

In general, a PWG standard is a specification that is stable, well understood, and is technically competent, has multiple, independent and interoperable implementations with substantial operational experience, and enjoys significant public support.

For additional information regarding the Printer Working Group visit:

http://www.pwg.org

Contact information:

The Printer Working Groupc/o The IEEE Industry Standards and Technology Organization445 Hoes LanePiscataway, NJ 08854USA

Page 4 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

45

61

626364656667

68

6970

71

7273747576777879808182

838485

86

87

88

899091929394

6

Page 5: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

About the Internet Printing Protocol Work Group

The Internet Printing Protocol (IPP) working group has developed a modern, full-featured network printing protocol, which is now the industry standard. IPP allows a print client to query a printer for its supported capabilities, features, and parameters to allow the selection of an appropriate printer for each print job. IPP also provides Job information prior to, during, and at the end of Job processing.

For additional information regarding IPP visit:

http://www.pwg.org/ipp/

Implementers of this specification are encouraged to join the IPP mailing list in order to participate in any discussions of the specification. Suggested additions, changes, or clarification to this specification, should be sent to the IPP mailing list for consideration.

Page 5 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

78

95

96979899

100

101

102

103104105

9

Page 6: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Table of Contents1. Introduction .....................................................................................................................152. Terminology ....................................................................................................................15

2.1 Conformance Terminology ........................................................................................152.2 Imaging Terminology ................................................................................................152.3 Other Terminology ....................................................................................................162.4 Acronyms and Organizations ....................................................................................17

3. Requirements .................................................................................................................183.1 Rationale ...................................................................................................................183.2 Use Cases ................................................................................................................18

3.2.1 Developer Implementing IPP Client Support ......................................................183.2.2 Developer Implementing IPP Printer Support .....................................................18

3.3 Out of Scope .............................................................................................................183.4 Design Requirements ...............................................................................................19

4. Client Tasks and Implementation Alternatives ................................................................194.1 Finding A Printer .......................................................................................................20

4.1.1 Discover And Select A Printer Via A Discovery Protocol ....................................204.1.2 Select A Printer Via Static Hostname Or Address ..............................................23

4.2 Validate Printer Reachability and User Access .........................................................254.3 Identify a Printer ........................................................................................................284.4 Get Printer Capabilities .............................................................................................324.5 Check Constraints Between Print Options ................................................................384.6 Submitting a Print Job ...............................................................................................45

4.6.1 Submitting a Job with Document Data ...............................................................464.6.2 Submitting a Job with Document References .....................................................494.6.3 Handling Print Job Creation Errors .....................................................................53

4.7 Monitoring Job Status ...............................................................................................554.8 Canceling a Print Job During Job or Document Creation .........................................604.9 Getting Printer Supplies Status .................................................................................634.10 Error Handling .........................................................................................................66

5. Using and Evaluating IPP Attributes ...............................................................................665.1 Job Template Attributes And Value Binding ..............................................................66

5.1.1 IPP Client Recommendations .............................................................................675.1.2 IPP Printer Recommendations ...........................................................................67

5.2 Document Format Selection ......................................................................................675.2.1 IPP Client Recommendations .............................................................................685.2.2 IPP Printer Recommendations ...........................................................................68

5.3 Prefer "media-col" Attribute To "media" Attribute ......................................................685.3.1 IPP Client Recommendations .............................................................................685.3.2 IPP Printer Recommendations ...........................................................................69

5.4 Extended Finishings Options With "finishings-col-XXX" ............................................695.4.1 IPP Client Recommendations .............................................................................695.4.2 IPP Printer Recommendations ...........................................................................69

5.5 Controlling Intended Output Using "ipp-attribute-fidelity", "job-mandatory-attributes", and "pdl-override-supported" ..........................................................................................69

5.5.1 IPP Client Recommendations .............................................................................70

Page 6 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

1011

106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151

12

Page 7: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

5.5.2 IPP Printer Recommendations ...........................................................................705.6 Use "multiple-document-handling" to Collate Copies ................................................71

5.6.1 IPP Client Recommendations .............................................................................715.6.2 IPP Printer Recommendations ...........................................................................71

5.7 Specify "orientation-requested" For Supported Document Types .............................715.7.1 IPP Client Recommendations .............................................................................725.7.2 IPP Printer Recommendations ...........................................................................72

5.8 Evaluating Printer Capability Attributes .....................................................................725.8.1 document-format-supported / document-format .................................................735.8.2 printer-get-attributes-supported ..........................................................................735.8.3 document-format-varying-attributes ....................................................................745.8.4 ipp-features-supported .......................................................................................745.8.5 printer-config-change-date-time and printer-config-change-time ........................745.8.6 xxx-supported and xxx-default ............................................................................745.8.7 xxx-supported vs. xxx-ready ...............................................................................755.8.8 job-creation-attributes-supported ........................................................................755.8.9 document-creation-attributes-supported .............................................................755.8.10 job-settable-attributes-supported ......................................................................765.8.11 media-col-ready vs. media-col-database ..........................................................76

5.9 Resolving Job Attribute Conflicts and Constraints ....................................................765.10 IPP Object Status Attributes ....................................................................................79

5.10.1 Printer Status ....................................................................................................795.10.2 Job Status ........................................................................................................795.10.3 Document Status ..............................................................................................80

5.11 IPP Notifications Attributes ......................................................................................806. IPP Document Page Order .............................................................................................807. IPP Printer Best Practices ..............................................................................................81

7.1 IPP Objects and URI Resource Paths ......................................................................817.2 Printer Resource URIs ..............................................................................................827.3 Error Reporting .........................................................................................................82

8. HTTP Protocol Use .........................................................................................................828.1 New HTTP/1.1 Specifications ...................................................................................82

8.1.1 HTTP Client ........................................................................................................838.1.2 HTTP Server ......................................................................................................83

8.2 HTTP/1.1 Expect Header ..........................................................................................838.2.1 HTTP Client ........................................................................................................838.2.2 HTTP Server ......................................................................................................84

8.3 "Host" Header Field ..................................................................................................848.3.1 HTTP Client ........................................................................................................848.3.2 HTTP Server ......................................................................................................84

8.4 If-Modified-Since, Last-Modified, and 304 Not Modified ...........................................858.4.1 HTTP Client ........................................................................................................858.4.2 HTTP Server ......................................................................................................85

8.5 Cache-Control ...........................................................................................................858.5.1 HTTP Client ........................................................................................................858.5.2 HTTP Server ......................................................................................................85

Page 7 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

1314

152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197

15

Page 8: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

9. Important Implementation Options ..................................................................................869.1 Job Receipts: The "xxx-actual" Attributes .................................................................869.2 Printer Constraints: The "preferred-attributes" Attribute ............................................86

10. Conformance Recommendations .................................................................................8610.1 Client Conformance Recommendations .................................................................8610.2 Printer Conformance Recommendations ................................................................87

11. Internationalization Considerations ...............................................................................8711.1 Client Considerations ..............................................................................................8711.2 Server Considerations ............................................................................................87

12. Security Considerations ................................................................................................8812.1 Client Security Considerations ................................................................................88

12.1.1 HTTP/1.1 Expect Header .................................................................................8812.1.2 HTTP Upgrade .................................................................................................8812.1.3 Using The Validate-Job Operation ...................................................................8812.1.4 Preferring The "ipps" URI Scheme ...................................................................88

12.2 Server Security Considerations ...............................................................................8812.2.1 HTTP/1.1 Expect Header .................................................................................8912.2.2 HTTP Upgrade .................................................................................................8912.2.3 Support For The "ipps" URI Scheme ................................................................8912.2.4 DNS Rebinding .................................................................................................89

13. References ...................................................................................................................8913.1 Informative References ...........................................................................................89

14. Annex A: HTTP/2.0 .......................................................................................................9415. Authors' Addresses .......................................................................................................9416. Change History .............................................................................................................94

16.1 February 5, 2013 .....................................................................................................9416.2 March 20, 2013 .......................................................................................................9416.3 May 13, 2013 ..........................................................................................................9516.4 July 19, 2013 ...........................................................................................................9516.5 September 22, 2013 ...............................................................................................9516.6 October 2, 2013 ......................................................................................................9616.7 January 3, 2014 ......................................................................................................9616.8 January 24, 2014 ....................................................................................................9716.9 April 10, 2014 ..........................................................................................................9716.10 May 13, 2014 ........................................................................................................9716.11 August 14, 2014 ....................................................................................................9816.12 November 13, 2014 ..............................................................................................9816.13 January 27, 2015 ..................................................................................................9816.14 February 11, 2015 .................................................................................................9916.15 March 3, 2015 .......................................................................................................99

1. Introduction .......................................................................................................................82. Terminology ......................................................................................................................8

2.1 Conformance Terminology ..........................................................................................82.2 Imaging Terminology ..................................................................................................82.3 Other Terminology ......................................................................................................92.4 Acronyms and Organizations ....................................................................................10

Page 8 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

1617

198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243

18

Page 9: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

3. Requirements .................................................................................................................113.1 Rationale ...................................................................................................................113.2 Use Cases ................................................................................................................11

3.2.1 Developer Implementing IPP Client Support ......................................................113.2.2 Developer Implementing IPP Printer Support .....................................................11

3.3 Out of Scope .............................................................................................................113.4 Design Requirements ...............................................................................................12

4. Client Tasks and Implementation Alternatives ................................................................124.1 Finding A Printer .......................................................................................................13

4.1.1 Discover And Select A Printer Via A Discovery Protocol ....................................134.1.2 Select A Printer Via Static Hostname Or Address ..............................................16

4.2 Validate Printer Reachability and User Access .........................................................184.3 Identify a Printer ........................................................................................................214.4 Get Printer Capabilities .............................................................................................244.5 Check Constraints Between Print Options ................................................................284.6 Submitting a Print Job ...............................................................................................34

4.6.1 Submitting A Job With Document Data ..............................................................354.6.2 Submitting A Job With Document References ...................................................384.6.3 Handling Print Job Creation Errors .....................................................................42

4.7 Submitting a FaxOut Job ..........................................................................................434.8 Monitoring Job Status ...............................................................................................444.9 Canceling a Print Job During Job or Document Creation .........................................494.10 Getting Printer Supplies Status ...............................................................................524.11 Error Handling .........................................................................................................55

5. Using and Evaluating IPP Attributes ...............................................................................555.1 Job Template Attributes And Value Binding ..............................................................55

5.1.1 IPP Client Recommendations .............................................................................565.1.2 IPP Printer Recommendations ...........................................................................56

5.2 Document Format Selection ......................................................................................565.2.1 IPP Client Recommendations .............................................................................575.2.2 IPP Printer Recommendations ...........................................................................57

5.3 Prefer "media-col" Attribute To "media" Attribute ......................................................575.3.1 IPP Client Recommendations .............................................................................575.3.2 IPP Printer Recommendations ...........................................................................58

5.4 Extended Finishings Options With "finishings-col-XXX" ............................................585.4.1 IPP Client Recommendations .............................................................................585.4.2 IPP Printer Recommendations ...........................................................................58

5.5 Controlling Intended Output Using "ipp-attribute-fidelity", "job-mandatory-attributes", and "pdl-override-supported" ..........................................................................................58

5.5.1 IPP Client Recommendations .............................................................................595.5.2 IPP Printer Recommendations ...........................................................................59

5.6 Prefer "multiple-document-handling" For Copies Collation .......................................605.6.1 IPP Client Recommendations .............................................................................605.6.2 IPP Printer Recommendations ...........................................................................60

5.7 Specify "orientation-requested" For Supported Document Types .............................605.7.1 IPP Client Recommendations .............................................................................60

Page 9 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

1920

244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289

21

Page 10: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

5.7.2 IPP Printer Recommendations ...........................................................................615.8 Evaluating Printer Capability Attributes .....................................................................61

5.8.1 document-format-supported / document-format .................................................625.8.2 printer-get-attributes-supported ..........................................................................625.8.3 document-format-varying-attributes ....................................................................625.8.4 ipp-features-supported .......................................................................................635.8.5 printer-config-change-date-time and printer-config-change-time ........................635.8.6 xxx-supported and xxx-default ............................................................................635.8.7 xxx-supported vs. xxx-ready ...............................................................................645.8.8 job-creation-attributes-supported ........................................................................645.8.9 document-creation-attributes-supported .............................................................645.8.10 job-settable-attributes-supported ......................................................................645.8.11 media-col-ready vs. media-col-database ..........................................................65

5.9 Resolving Job Attribute Conflicts and Constraints ....................................................655.10 IPP Object Status Attributes ....................................................................................68

5.10.1 Printer Status ....................................................................................................685.10.2 Job Status ........................................................................................................685.10.3 Document Status ..............................................................................................68

5.11 IPP Notifications Attributes ......................................................................................696. IPP Document Page Order .............................................................................................697. IPP Printer Best Practices ..............................................................................................70

7.1 IPP Objects and URI Resource Paths ......................................................................707.2 Fax Destination URIs ................................................................................................717.3 Printer Resource URIs ..............................................................................................717.4 Error Reporting .........................................................................................................71

8. HTTP Protocol Use .........................................................................................................718.1 New HTTP/1.1 Specifications ...................................................................................71

8.1.1 HTTP Client ........................................................................................................728.1.2 HTTP Server ......................................................................................................72

8.2 HTTP/1.1 Expect Header ..........................................................................................728.2.1 HTTP Client ........................................................................................................728.2.2 HTTP Server ......................................................................................................73

8.3 "Host" Header Field ..................................................................................................738.3.1 HTTP Client ........................................................................................................738.3.2 HTTP Server ......................................................................................................73

8.4 If-Modified-Since, Last-Modified, and 304 Not Modified ...........................................738.4.1 HTTP Client ........................................................................................................748.4.2 HTTP Server ......................................................................................................74

8.5 Cache-Control ...........................................................................................................748.5.1 HTTP Client ........................................................................................................748.5.2 HTTP Server ......................................................................................................74

9. Important Implementation Options ..................................................................................749.1 Job Receipts: The "xxx-actual" Attributes .................................................................749.2 Printer Constraints: The "preferred-attributes" Attribute ............................................75

10. Conformance Recommendations .................................................................................7510.1 Client Conformance Recommendations .................................................................75

Page 10 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

2223

290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335

24

Page 11: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

10.2 Printer Conformance Recommendations ................................................................7511. Internationalization Considerations ...............................................................................76

11.1 Client Considerations ..............................................................................................7611.2 Server Considerations ............................................................................................76

12. Security Considerations ................................................................................................7612.1 Client Security Considerations ................................................................................76

12.1.1 HTTP/1.1 Expect Header .................................................................................7612.1.2 HTTP Upgrade .................................................................................................7712.1.3 Using The Validate-Job Operation ...................................................................7712.1.4 Preferring The "ipps" URI Scheme ...................................................................77

12.2 Server Security Considerations ...............................................................................7712.2.1 HTTP/1.1 Expect Header .................................................................................7712.2.2 HTTP Upgrade .................................................................................................7712.2.3 Support For The "ipps" URI Scheme ................................................................7712.2.4 DNS Rebinding .................................................................................................78

13. References ...................................................................................................................7813.1 Informative References ...........................................................................................78

14. Annex A: HTTP/2.0 .......................................................................................................8115. Authors' Addresses .......................................................................................................8116. PlantUML Sequence Diagram Sources ........................................................................8217. Change History .............................................................................................................82

17.1 February 5, 2013 .....................................................................................................8217.2 March 20, 2013 .......................................................................................................8217.3 May 13, 2013 ..........................................................................................................8217.4 July 19, 2013 ...........................................................................................................8317.5 September 22, 2013 ...............................................................................................8317.6 October 2, 2013 ......................................................................................................8317.7 January 3, 2014 ......................................................................................................8417.8 January 24, 2014 ....................................................................................................8417.9 April 10, 2014 ..........................................................................................................8417.10 May 13, 2014 ........................................................................................................8517.11 August 14, 2014 ....................................................................................................8517.12 November 13, 2014 ..............................................................................................8517.13 January 27, 2015 ..................................................................................................86

1. Introduction .......................................................................................................................82. Terminology ......................................................................................................................8

2.1 Conformance Terminology ..........................................................................................82.2 Imaging Terminology ..................................................................................................82.3 Other Terminology ......................................................................................................92.4 Acronyms and Organizations ....................................................................................10

3. Requirements .................................................................................................................113.1 Rationale ...................................................................................................................113.2 Use Cases ................................................................................................................11

3.2.1 Developer Implementing IPP Client Support ......................................................113.2.2 Developer Implementing IPP Printer Support .....................................................11

3.3 Out of Scope .............................................................................................................11

Page 11 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

2526

336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381

27

Page 12: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

3.4 Design Requirements ...............................................................................................124. Client Tasks and Implementation Alternatives ................................................................12

4.1 Finding A Printer .......................................................................................................134.1.1 Discover And Select A Printer Via A Discovery Protocol ....................................134.1.2 Select A Printer Via Static Hostname Or Address ..............................................16

4.2 Validate Printer Reachability and User Access .........................................................184.3 Identify a Printer ........................................................................................................214.4 Get Printer Capabilities .............................................................................................244.5 Check Constraints Between Print Options ................................................................294.6 Submitting a Print Job ...............................................................................................34

4.6.1 Submitting a Job with Document Data ...............................................................354.6.2 Submitting a Job with Document References .....................................................384.6.3 Handling Print Job Creation Errors .....................................................................42

4.7 Monitoring Job Status ...............................................................................................434.8 Canceling a Print Job During Job or Document Creation .........................................494.9 Getting Printer Supplies Status .................................................................................524.10 Error Handling .........................................................................................................55

5. Using and Evaluating IPP Attributes ...............................................................................555.1 Job Template Attributes And Value Binding ..............................................................55

5.1.1 IPP Client Recommendations .............................................................................565.1.2 IPP Printer Recommendations ...........................................................................56

5.2 Document Format Selection ......................................................................................565.2.1 IPP Client Recommendations .............................................................................575.2.2 IPP Printer Recommendations ...........................................................................57

5.3 Prefer "media-col" Attribute To "media" Attribute ......................................................575.3.1 IPP Client Recommendations .............................................................................575.3.2 IPP Printer Recommendations ...........................................................................58

5.4 Extended Finishings Options With "finishings-col-XXX" ............................................585.4.1 IPP Client Recommendations .............................................................................585.4.2 IPP Printer Recommendations ...........................................................................58

5.5 Controlling Intended Output Using "ipp-attribute-fidelity", "job-mandatory-attributes", and "pdl-override-supported" ..........................................................................................58

5.5.1 IPP Client Recommendations .............................................................................595.5.2 IPP Printer Recommendations ...........................................................................59

5.6 Use "multiple-document-handling" to Collate Copies ................................................595.6.1 IPP Client Recommendations .............................................................................605.6.2 IPP Printer Recommendations ...........................................................................60

5.7 Specify "orientation-requested" For Supported Document Types .............................605.7.1 IPP Client Recommendations .............................................................................605.7.2 IPP Printer Recommendations ...........................................................................60

5.8 Evaluating Printer Capability Attributes .....................................................................605.8.1 document-format-supported / document-format .................................................615.8.2 printer-get-attributes-supported ..........................................................................625.8.3 document-format-varying-attributes ....................................................................625.8.4 ipp-features-supported .......................................................................................625.8.5 printer-config-change-date-time and printer-config-change-time ........................63

Page 12 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

2829

382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427

30

Page 13: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

5.8.6 xxx-supported and xxx-default ............................................................................635.8.7 xxx-supported vs. xxx-ready ...............................................................................635.8.8 job-creation-attributes-supported ........................................................................645.8.9 document-creation-attributes-supported .............................................................645.8.10 job-settable-attributes-supported ......................................................................645.8.11 media-col-ready vs. media-col-database ..........................................................64

5.9 Resolving Job Attribute Conflicts and Constraints ....................................................645.10 IPP Object Status Attributes ....................................................................................67

5.10.1 Printer Status ....................................................................................................675.10.2 Job Status ........................................................................................................685.10.3 Document Status ..............................................................................................68

5.11 IPP Notifications Attributes ......................................................................................686. IPP Document Page Order .............................................................................................687. IPP Printer Best Practices ..............................................................................................69

7.1 IPP Objects and URI Resource Paths ......................................................................697.2 Printer Resource URIs ..............................................................................................707.3 Error Reporting .........................................................................................................70

8. HTTP Protocol Use .........................................................................................................708.1 New HTTP/1.1 Specifications ...................................................................................70

8.1.1 HTTP Client ........................................................................................................718.1.2 HTTP Server ......................................................................................................71

8.2 HTTP/1.1 Expect Header ..........................................................................................718.2.1 HTTP Client ........................................................................................................718.2.2 HTTP Server ......................................................................................................72

8.3 "Host" Header Field ..................................................................................................728.3.1 HTTP Client ........................................................................................................728.3.2 HTTP Server ......................................................................................................72

8.4 If-Modified-Since, Last-Modified, and 304 Not Modified ...........................................738.4.1 HTTP Client ........................................................................................................738.4.2 HTTP Server ......................................................................................................73

8.5 Cache-Control ...........................................................................................................738.5.1 HTTP Client ........................................................................................................738.5.2 HTTP Server ......................................................................................................73

9. Important Implementation Options ..................................................................................749.1 Job Receipts: The "xxx-actual" Attributes .................................................................749.2 Printer Constraints: The "preferred-attributes" Attribute ............................................74

10. Conformance Recommendations .................................................................................7410.1 Client Conformance Recommendations .................................................................7410.2 Printer Conformance Recommendations ................................................................74

11. Internationalization Considerations ...............................................................................7511.1 Client Considerations ..............................................................................................7511.2 Server Considerations ............................................................................................75

12. Security Considerations ................................................................................................7612.1 Client Security Considerations ................................................................................76

12.1.1 HTTP/1.1 Expect Header .................................................................................7612.1.2 HTTP Upgrade .................................................................................................76

Page 13 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

3132

428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473

33

Page 14: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

12.1.3 Using The Validate-Job Operation ...................................................................7612.1.4 Preferring The "ipps" URI Scheme ...................................................................76

12.2 Server Security Considerations ...............................................................................7612.2.1 HTTP/1.1 Expect Header .................................................................................7712.2.2 HTTP Upgrade .................................................................................................7712.2.3 Support For The "ipps" URI Scheme ................................................................7712.2.4 DNS Rebinding .................................................................................................77

13. References ...................................................................................................................7713.1 Informative References ...........................................................................................77

14. Annex A: HTTP/2.0 .......................................................................................................8115. Authors' Addresses .......................................................................................................8116. Change History .............................................................................................................82

16.1 February 5, 2013 .....................................................................................................8216.2 March 20, 2013 .......................................................................................................8216.3 May 13, 2013 ..........................................................................................................8216.4 July 19, 2013 ...........................................................................................................8216.5 September 22, 2013 ...............................................................................................8316.6 October 2, 2013 ......................................................................................................8316.7 January 3, 2014 ......................................................................................................8416.8 January 24, 2014 ....................................................................................................8416.9 April 10, 2014 ..........................................................................................................8416.10 May 13, 2014 ........................................................................................................8516.11 August 14, 2014 ....................................................................................................8516.12 November 13, 2014 ..............................................................................................8516.13 January 27, 2015 ..................................................................................................8616.14 February 11, 2015 .................................................................................................8616.15 March 3, 2015 .......................................................................................................86

Page 14 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

3435

474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503

36

Page 15: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

1. IntroductionIPP defines a rich set of operations and attributes to support the many tasks and features that exist in a networked printing ecosystem. With IPP, it is possible to perform some tasks in a few different ways. The quality of the user experience will be affected by how the tasks are performed. The goal of this specification is to provide IPP Client and Printer implementors with guidance on how to implement their system well from the start to ensure a quality user experience.

2. Terminology

2.1 Conformance Terminology

Capitalized terms, such as MUST, MUST NOT, RECOMMENDED, REQUIRED, SHOULD, SHOULD NOT, MAY, and OPTIONAL, have special meaning relating to conformance as defined in Key words for use in RFCs to Indicate Requirement Levels [RFC2119]. The term CONDITIONALLY REQUIRED is additionally defined for a conformance requirement that applies to a particular capability or feature.

This specification defines a number of normative requirements, but they are all recommendations using SHOULD. There are no MUST requirements in this specification.

2.2 Imaging Terminology

Normative definitions and semantics of printing terms are imported from IETF Printer MIB v2 [RFC3805], IETF Finisher MIB [RFC3806], and IETF Internet Printing Protocol/1.1: Model and Semantics [RFC2911].

This document also defines the following protocol roles in order to specify unambiguous conformance requirements:

Client: Initiator of outgoing IPP session requests and sender of outgoing IPP operation requests (Hypertext Transfer Protocol -- HTTP/1.1 [RFC7230] User Agent).

Device: A Logical or Physical Device associated with one or more Printers; also see section 2.3 of [RFC2911].

Document: An object created and managed by a Printer that contains the description, processing, and status information. A Document object can have attached data and is bound to a single Job.

Page 15 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

3738

504

505506507508509510

511

512

513514515516517

518519520

521

522523524

525526

527528

529530

531532533

39

Page 16: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Logical Device: a print server, software service, or gateway that processes jobs and either forwards or stores the processed Job or uses one or more Physical Devices to render output.

Physical Device: a device that renders output (typically on paper.)

Printer: Listener for incoming IPP session requests and receiver of incoming IPP operation requests (Hypertext Transfer Protocol -- HTTP/1.1 [RFC7230] Server) that represents one or more Physical Devices or a Logical Device.

Imaging Device: A printer or other device that acts as a Printer.

Job: An object created and managed by a Printer that contains description, processing, and status information. The Job also contains zero or more Document objects.

2.3 Other Terminology

Direct Imaging: Printing, facsimile, and scanning performed by direct communication from the Client to an Imaging Device or local print server.

Directory Service: A Service providing query and enumeration of information using names or other identifiers.

Discovery: Finding Printers by querying or browsing local network segments or Enumeration of Directory or Name Services.

Report An Error: An Action taken by an IPP Client that includes informing the User that an error has been detected, and logging the condition in a robust manner.

Enumeration: Listing Printers that are registered with a Directory or other Service.

Indirect Imaging: Printing, facsimile, and scanning performed by communication from the Client and/or Imaging Device to an intermediary service in a different administrative domain, for example when the Client communicates with a third-party print service or when an Imaging Device communicates with a Cloud service.

Network Accessible Device: A Device that can be directly accessed by a Client.

Network Accessible/Accessibility: Refers to the ability of one device to communicate directly with another, for example a Client is able to connect to a Device, query for supported attributes, submit Job creation requests, and so forth.

Operator: A person or automata that typically oversees the Printer. The Operator is allowed to query and manage the Printer, Jobs and Documents based on site policy.

Secure Print: A print Job using the "document-password", "job-password", and/or "job-password-encryption" operation attributes to provide document and/or physical

Page 16 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

4041

534535536

537

538539540

541

542543

544

545546

547548

549550

551552

553

554555556557

558

559560561

562563

564565

42

Page 17: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

security. See [PWG5100.11], [PWG5100.13], and [PWG5100.15] M. Sweet, "IPPFaxOut Service", PWG 5100.15-2013, November 2013,http://ftp.pwg.org/pub/pwg/candidates/cs-ippfaxout10- 20131115-5100.15.pdf.

Service: Software providing access to physical, logical, or virtual resources assisting in the processing of queued Jobs.

User: A person or automata using a Client to communicate with a Printer.

Zombie Job: A Job that was created using a Job Creation operation but that never had a Document associated with it, and that remains in a state of limbo.

2.4 Acronyms and Organizations

IANA: Internet Assigned Numbers Authority, http://www.iana.org/

IEEE: Institute of Electrical and Electronics Engineers, http://www.ieee.org/

IETF: Internet Engineering Task Force, http://www.ietf.org/

ISO: International Organization for Standardization, http://www.iso.org/

PWG: Printer Working Group, http://www.pwg.org/

Page 17 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

4344

566567568

569570

571

572573

574

575

576

577

578

579

580

45

Page 18: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

3. Requirements

3.1 Rationale

The "Internet Printing Protocol/1.1: Implementor's Guide" [RFC3196] was ratified in November 2001. Since that time many extensions to IPP have been ratified, and the scope of use of IPP has grown considerably. Given all these extensions to IPP, implementers will benefit from an updated best practices document that covers these extensions, as well as the core of IPP that has remained unchanged, to assist Client and Printer implementers in their efforts to provide the best possible user experience.

This specification asserts many normative recommendations using SHOULD. There are no MUST requirements in this specification.

3.2 Use Cases

3.2.1 Developer Implementing IPP Client Support

Garrett is a software engineer developing a new client platform that is adding system-level printing support. Many printers support IPP Everywhere [PWG5100.14], so he plans to implement IPP Everywhere printing support in his client platform. But IPP Everywhere and its related standards don't describe how to best use IPP for the various tasks his software needs to perform to deliver a quality client user experience. He finds the "Internet Printing Protocol/1.1: Implementor's Guide" [RFC3196], but finds its Client recommendations insufficient. Using the IPP Implementor's Guide v2.0 (IG), he is able to avoid some common design pitfalls and quickly deliver a quality IPP client experience.

3.2.2 Developer Implementing IPP Printer Support

Duncan is a firmware engineer at a printer vendor creating a new printer, and that printer includes support for IPP Everywhere. In reading the IPP Implementor's Guidev2.0 (IG), he can more accurately anticipate how some segment of clients implemented according to these practices are likely to behave, and more rapidly understand how the various operations can be used with one another to achieve certain tasks.

3.3 Out of Scope

The following are out of scope for this specification:

Definition of extensions or modifications to the Internet Printing Protocol Normative MUST statements regarding user experience Definitions of new file formats or modifications of existing file formats

Page 18 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

4647

581

582

583584585586587588

589590

591

592

593594595596597598599600601

602

603604605606607

608

609

610611612

48

Page 19: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Definition of extensions or modifications to HypertText Transport Protocol [RFC7230]

3.4 Design Requirements

The design requirements for this specification are:

Identify common tasks performed by Clients and Printers Enumerate a series of implementation alternatives Rank those alternatives according to a qualitative grading scheme Discuss proper use of IPP attributes related to the implementation alternatives

and related implementation considerations, including security considerations

4. Client Tasks and Implementation AlternativesA user needs to do certain tasks in order to engage the user's computer with a printer. If that printer is an IPP Printer and the user's computer has an IPP Client, the IPP Client needs to perform certain tasks to provide a basic level of service to the user. A well-implemented Client also performs additional tasks to provide a high quality user experience. A fully featured and well-implemented IPP Client will support all the following tasks:

Find a Printer Validate Printer reachability and User accessibility Identify a Printer Get Printer capabilities Identify and resolve conflicts between a User's feature choices Submit a Job to a Printer, whether a Print Job, FaxOut Job, or Scan Job Monitor Job Status Cancel a Job Getting Printer Supplies Status

Each task is covered in this section, including descriptions of implementation alternatives. Each alternative will be labeled according to its perceived quality, using the following labels, which are listed in order from least desirable to most desirable:

BAD POOR FAIR GOOD BETTER BEST

The most preferred alternative for each task will always be labeled "BEST". Options labeled as "BAD", "POOR" or "FAIR" should be avoided.

Page 19 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

4950

613614

615

616

617618619620621

622

623624625626627628

629630631632633634635636637

638639640

641642643644645646

647648

51

Page 20: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

The task implementations are described using UML sequence diagrams, which provide methods for describing parallel activity, asynchronous activity, iteration, logical branching, and similar constructs.

4.1 Finding A Printer

In order to use a Printer, the Client system needs to connect to it. For a connection to be established, the Client needs to first acquire the Printer's address.

Historically, setting up a printer on a client system included creating persistent local records for that printer to identify drivers needed to communicate at different levels. The number of printers or other devices the user’s system would encounter was small and fairly static. Network discovery protocols were not broadly used.

Recently, the relationship between Client and Printer has become more "dynamic". Clients discover available standardized print services matched to "universal" drivers rather than model-specific ones. These universal drivers acquire that print service instance's capabilities and other attributes by interrogating the chosen print service using sophisticated protocols such as IPP. Based on that, the universal driver provides a set of features based on device information rather than pre-distributed model information (model-specific drivers). This set of capabilities can be acquired at each time the User wishes to print, rather than once when the "print queue" has been created on the Client. In this paradigm, a persistent binding between a driver and a print service (what has historically been referred to as a "print queue") is more like a Web browser bookmark, and need not be persisted except as a "favorite" or "recently used printer" as a convenience to the User.

Even with the recent driver / printer interface standardization and widespread implementation, there are various use cases where the user acquires the Printer's DNS host name or network address and wishes to contact the Printer directly rather than looking it up via a service discovery or directory protocol. Examples of this include: the target printer does not reside within the scope that the discovery protocol service, or when the user has acquired a URI, host name or network address from a banner near the printer. These use cases will continue to be important for the foreseeable future.

4.1.1 Discover And Select A Printer Via A Discovery Protocol

Discovery protocols such as mDNS / DNS-SD, [RFC6762] [RFC6763], SLP, [RFC2608], and WS-Discovery and UPnP SSDP,[WSDiscovery-1.1], as well as directory protocols such as LDAP, [RFC4510], allow a user to find instances of print services or printers without having to perform a survey in physical space to acquire devices' addresses. Service discovery queries are sent via broadcast or multicast to all hosts within scope, or unicast to a directory server. The query specifies the desired service types or device types. Replies to those queries are processed and presented to the user.

Page 20 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

5253

649650651

652

653654

655656657658

659660661662663664665666667668669670

671672673674675676677

678

679680681682683684685686

54

Page 21: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Regardless of the actual discovery protocol used, the APIs driving the protocols generally can be used in either a synchronous or asynchronous fashion. Unfortunately, many legacy software systems (as well as developers) are accustomed to the synchronous model, which is easily identified by the presence of a "refresh button". The synchronous model is not as user friendly as the asynchronous model, but it is somewhat easier to write programs in a synchronous way than an asynchronous way.

Alternatives

POOR:o Perform network discovery with a synchronous API; present static results

after short discovery process period; provide "Refresh" button to restart the process

Figure 1: Discover and Select A Printer Via A Discovery Protocol - POOR

Page 21 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

5556

687688689690691692

693

694695696697698

699

700

701

57

Page 22: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BETTER:o Same as "POOR" above but user interface self-refreshes every few seconds

in a worker thread that refreshes the UI owned by the main thread (or equivalent).

Figure 2: Discover and Select A Printer Via A Discovery Protocol - BETTER

Page 22 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

5859

702703704705706

707

708

709

60

Page 23: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BEST:o Perform network discovery with an asynchronous API for "live" results and

timely, responsive user experience

Figure 3: Discover and Select A Printer Via A Discovery Protocol - BEST

4.1.2 Select A Printer Via Static Hostname Or Address

A Printer is identified in IPP by a URI. The URI identifies a specific resource that is relevant only on the host where the Printer resides. A URI is not typically provided directly to a User; a simple host name or network address is more common.

The "printer-uri-supported" Printer attribute enumerates the allowed URIs on the host system. This attribute can be retrieved via a Get-Printer-Attributes operation. This can be a circular problem since the Client must know at least one of the allowed resource paths to perform a Get-Printer-Attributes operation. If all Printers implement well-known resource paths, this problem can be avoided.

Page 23 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

6162

710711712713

714

715

716

717

718719720

721722723724725726

63

Page 24: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Alternatives

POOR: Each printer model chooses an arbitrary default resource path. The Client must depend on some mechanism out-of-band of IPP to get the resource path. This exposes too many protocol details to the User. Users need not be aware of which print protocol is being used.

Figure 4: Select A Printer Via Static Hostname Or Address - POOR

BETTER: Use a well-known, commonly specified resource path: "/ipp/print"o Not universally implementedo Recommendation to be added to IPP Everywhere [PWG5100.14]

Figure 5: Select A Printer Via Static Hostname Or Address - BETTER

Page 24 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

6465

727

728729730731732

733

734

735736737738

739

740

66

Page 25: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Page 25 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

6768

741

69

Page 26: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BEST: Get a list of all URIs for the default Print service, from a common neutral resource path: "/"

o Allows variance and different Printer Objects to be foundo Not widely implemented, but recommended in IPP Everywhere

[PWG5100.14]

Figure 6: : Select A Printer Via Static Hostname Or Address - BEST

4.2 Validate Printer Reachability and User Access

Once a Printer's address has been acquired, the Client ought to communicate with the Printer to confirm that the Printer is reachable by the Client. The Client SHOULD validate that the Printer is reachable via one of the IPP transports supported by the Client system. Once reachability has been validated, the Client SHOULD validate that the Printer would allow the User operating the Client to use it. The Client SHOULD validate reachability and user access as a precondition to acquiring the Printer's capabilities, which can occur before submitting a Job or before creating a persistent queue or possibly both. If the User is allowed to set up the Client to use a particular Printer, but denied the use of that Printer, the User will most likely be disappointed. If the Printer implements IPPS [RFC-IPPS][RFC-IPPS] and a self-signed TLS certificate, the Client user experience should be managed in such a way that it allows the user to establish trust with unfamiliar devices or credentials, without scaring them away or concealing important details.

Page 26 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

7071

742743744745746747

748

749

750

751752753754755756757758759760761762763764

72

Page 27: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Alternatives

BAD: Do Nothingo Reachability and access not checked; user could easily be disappointed

Figure 7: Validate Printer Reachability and User Access - BAD

FAIR: Validate reachability using a non-IPP protocol (ICMP echo, SNMP GET, etc.)o Validates reachabilityo No validation that IPP service is available on target hosto No validation that the user has access rights to the IPP Printer Object

Page 27 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

7374

765

766767768

769

770

771772773774775

75

Page 28: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Figure 8: : Validate Printer Reachability and User Access - FAIR

BETTER: IPP Get-Printer-Attributeso Validates reachabilityo Validates IPP Printer object is available on target hosto No validation that the user has access rights to the IPP Printer Object

Figure 9: Validate Printer Reachability and User Access - BETTER

Page 28 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

7677

776

777

778779780781782

783

784

785

78

Page 29: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BEST: IPP Get-Printer-Attributes + IPP Validate-Jobo Validates reachabilityo Validates IPP service is available on target hosto Validates user has access rights to the IPP Printer Object

Figure 10: Validate Printer Reachability and User Access - BEST

4.3 Identify a Printer

There are situations where a Client has discovered a Printer on a network, and the User would like to determine its location in physical space, so they can find where to retrieve their printed job. Or the user may want to confirm that the printer they are standing in front of is the printer found on the network. This is increasingly important for users who are printing from highly portable devices such as smartphones or tablets.

Page 29 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

7980

786787788789790

791

792

793

794795796797798

81

Page 30: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

The Identify-Printer operation [PWG5100.13][PWG5100.13] provides a method for a Client to request that the Printer do something to identify itself. It is preferable for the Client to

Page 30 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

8283

799800801802

84

Page 31: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Alternatives

BAD: Client does nothing; User guesses which printero Subpar user experience

Figure 11: Identify a Printer - BAD

Page 31 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

8586

803

804805806

807

808

809

87

Page 32: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

POOR: IPP Print-Job with special "identify page"o Only useful to validate the printer nearby is the printer discoveredo If it is the "wrong printer" the page will come out of an unexpected printero Printing throwaway pages for this purpose can annoy the Printer's owner

Figure 12: Identify a Printer - POOR

Page 32 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

8889

810811812813814

815

816

817

90

Page 33: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BEST: IPP Identify-Printero Add audio indicators only if the user cannot find it using visual means alone,

to avoid causing audio disturbance to others nearby the Printer

Figure 13: Identify a Printer - BEST

4.4 Get Printer Capabilities

Once the user has selected a printer, the Client needs to determine the Printer's capabilities in order to whether and how it can produce Jobs the Printer can process. The Printer's capabilities will include supported Document formats, Job processing alternatives such as "number of copies", "2-sided printing", and perhaps other features. Some capabilities can vary depending on the Document format. It also includes other information about the device itself, such as its model type, location, and so forth.

Traditionally, the Printer's capabilities would be acquired from the drivers bound to that Printer's print queue. A Client binds drivers by matching model identifiers in the driver with model identifiers acquired from the Printer. The Printer's capabilities were assumed to be relatively static; for the Client to get an up-to-date set of the Printer's capabilities the print queue would have to be destroyed and re-created. If driver matching fails because a driver was missing, the Client could not use the Printer because the queue would not get created. Deploying drivers before the user needed them was essential to avoid this problem.

Recently, "universal" printing systems such as IPP Everywhere have emerged that have enabled the Client / Printer relationship to become more dynamic. These systems define a base set of functionality along with methods to describe and use additional features that are agnostic to a particular Printer model. Clients that support these systems no longer depend on model-specific drivers to determine the Printer's capabilities if the Printer also supports the system. This also enables the Client to

Page 33 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

9192

818819820821

822

823

824

825826827828829830

831832833834835836837838

839840841842843844

93

Page 34: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

acquire a Printer's capabilities at the time the User indicates a desire to print. The Client can interrogate the Printer to determine its capabilities and present the available printing options in a just-in-time fashion. This enables more dynamic connection workflows that were impractical with the traditional model.

Alternatives

BAD: Assume all Printers have the same capabilitieso Example: a print queue using a "generic PPD"

Figure 14: Get Printer Capabilities - BAD

Page 34 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

9495

845846847848

849

850851852

853

854

855

96

Page 35: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

POOR: Match model to matching driver (e.g. model-specific PPD file) to acquire list of options supported by the target device; match using non-IPP protocol(s)

o All "legacy style" model specific print drivers are an example of this alternative.

o Printer capability detection using feature identifiers is preferable to detection keying off a model identifier, especially in the case where the source is a statically authored knowledge such as a PPD

Figure 15: Get Printer Capabilities - POOR

Page 35 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

9798

856857858859860861862863

864

865

866

99

Page 36: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

FAIR: Match model to matching driver (e.g. model-specific PPD file) to acquire list of options supported by the target device; match using IPP operations

o Using IPP rather than another protocol means only one protocol is used for pPrinter capability evaluation and jJob submission, even with traditional driver use models

Figure 16: Get Printer Capabilities - FAIR

Page 36 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

100101

867868869870871872

873

874

875

102

Page 37: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BEST: Perform a Get-Printer-Attributes operation, sending "document-format" and other attributes that allow filtering. If needed, start with an initial Get-Printer-Attributes with no filtering attributes, or acquire Printer information via some other method, to get the set of filterable attributes from the Printer

Page 37 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

103104

876877878879880

105

Page 38: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Page 38 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

106107

881

108

Page 39: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Figure 17: Get Printer Capabilities - BEST

4.5 Check Constraints Between Print Options

Printer features and options are presented typically in a print dialog. Some of these have states that have relationships with other options' states, where one cannot be in a particular state if another one is too. These are known as "constraints". Constraints need to be re-evaluated any time a control changes state. There are a few different ways this can be done via IPP.

Page 39 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

109110

882

883

884

885886887888889

111

Page 40: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Page 40 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

112113890

114

Page 41: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Alternatives

BAD: Do nothing

Figure 18: Check Constraints Between Print Options - BAD

Page 41 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

115116

891

892893

894

895

896

117

Page 42: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

POOR: Perform IPP Validate-Job every time a control changes Uses IPP but badly thrashes the network

Figure 19: Check Constraints Between Print Options - POOR

Page 42 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

118119

897898899

900

901

120

Page 43: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

FAIR: Use local model-specific data (i.e. PPDs)o This is preferable because at least it doesn't thrash the network

Figure 20: Check Constraints Between Print Options - FAIR

Page 43 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

121122

902903904

905

906

907

123

Page 44: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

GOOD:o IPP Validate-Job

When "Print" button is pressed, confirms the Job creation / submission will succeed (authentication, etc.)

Client depends on this operation to perform constraints validation printer-side, checking for errors along with "preferred-attributes"

Figure 21: Check Constraints Between Print Options - GOOD

Page 44 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

124125

908909910911912913914

915

916

917

126

Page 45: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BETTER: Use "job-constraints-supported" and "job-resolvers-supported"

Figure 22: Check Constraints Between Print Options - BETTER

Page 45 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

127128

918919

920

921

922

129

Page 46: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BEST: Use "job-constraints-supported" and "job-resolvers-supported" as well as IPP Validate-Job

Figure 23: Check Constraints Between Print Options - BEST

4.6 Submitting a Print Job

Once the user has selected the desired Job options, the print content is generated, and both the Job options and the content is made available to the pPrinter so that it can be printed. There are several different ways this can be done with IPP.

The first set of alternatives a Client must consider involves how the Document content is conveyed to the Printer. The Client can submit document content via an IPP operation. Alternately, the Client can submit to the Printer a URI reference to a Document, with the expectation that the Printer will retrieve the Document itself at Job processing time.

IPP also provides two methods for requesting that a Printer create a new Job. They differ in the number of operations that are needed. The first method, supported by Print-Job and Print-URI, create the Job and provide the document content or reference all in one operation. The second method creates the Job using the Create-Job operation, submits Document content to the Job via separate Send-Document or Send-URI operations, and might conclude with a Close-Job operation. This second more verbose method is preferred because it provides more opportunities for the Printer to provide control over

Page 46 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

130131

923924925

926

927

928

929930931

932933934935936

937938939940941942943944

945

132

Page 47: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

[4.6.1] Submitting Aa Job Wwith Document Data

This is the classical way that a print Job is sent from the Client to the print service: first a Job is created, and then the Job information and payload content are sent from the Client to the print service.

Alternatives

POOR: Send the jJob with IPP Print-Jobo The pPrinter can reject it but only after it has been transmitted. IPP would

never respond early; HTTP could respond early but that would be effectively a transport level exception outside the scope of IPP. Better to check ticket and content types first.

Figure 24: Submitting A Job With Document Data - POOR

Page 47 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

133134946

947948949

950

951952953954955956

957

958

959

135

Page 48: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

GOOD: Pre-flightqualify the job ticket information with Validate-Job, then submit itthe Job using Print-Job

o Doesn’t work well with flow-controlled (low-end) printers

Figure 25: Submitting A Job with Document Data - GOOD

Page 48 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

136137

960961962963

964

965

966

138

Page 49: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BETTER: IPP Create-Job / IPP Send-Document

Figure 26: Submitting A Job with Document Data - BETTER

Page 49 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

139140

967968

969

970

971

141

Page 50: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BEST: IPP Validate-Job / IPP Create-Job / IPP Send-Document / IPP Close-Job

Figure 27: Submitting A Job with Document Data - BEST

[4.6.2] Submitting Aa Job Wwith Document References

This is a slightly different method for the Document content to be available to the Printer. The notion generally consists of creating a Job and then including in the Job references to documents that the Printer will itself "pull" into the Job. The documents might be on the Client but don't have to be.

This method can be potentially useful for working around certain network topology scenarios or limiting the need for the Client to be transmitting the content directly to the Printer across an expensive link. But there are risks to using this method. If the document is reachable by the Client system but not the Printer, the Job will fail. Reachability can be affected by network topology, authorization, or other factors. And since there can be a time delay between Job creation and Job processing, it could be that reachability problems are not discovered in a timely manner. Therefore, this Implementor's Guide generally advises against using this method unless robust

Page 50 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

142143

972973

974

975

976

977978979980

981982983984985986987988

144

Page 51: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

mechanisms are in place to avoid such reachability issues; the Client SHOULD provide URIs that are stable for the life of the Job.

Page 51 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

145146989990

147

Page 52: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Alternatives

POOR: IPP Print-URIo No pre-flight checkso Printer can reject it but only after it has been transmittedo Better to check ticket and content types first

Figure 28: Submitting A Job With Document References - POOR

Page 52 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

148149

991

992993994995996

997

998

999

150

Page 53: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

GOOD: IPP Validate-Job / IPP Print-URIo URI might not be accessible at time of processing

Figure 29: Submitting A Job With Document References - GOOD

Page 53 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

151152

100010011002

1003

1004

1005

153

Page 54: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BETTER: IPP Create-Job / IPP Send-URIo URI might not be accessible at time of processing

Figure 30: Submitting A Job With Document References - BETTER

Page 54 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

154155

100610071008

1009

1010

1011

156

Page 55: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BEST: IPP Validate-Job / IPP Create-Job / IPP Send-URI / IPP Close-Jobo URI equivalent to §4.6.1; better to submit document data to avoid potential

URI accessibility issues

Figure 31: Submitting A Job With Document References - BEST

4.6.1[4.6.3] Handling Print Job Creation Errors

If the IPP Printer reports an error during the process of creating the Job or submitting the Documents to that job, it is best if the Client takes action to ensure that the malformed Job doesn't turn into a "Zombie Job", which is a form of digital pollution.

Page 55 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

157158

1012101310141015

1016

1017

1018

101910201021

1022

159

Page 56: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Alternatives

POOR: Do nothing; leave the malformed Job on the Printer

Figure 32: Handling Print Job Creation Errors - POOR

BEST: Use IPP Cancel-Job to cancel the jJob to clean up the malformed Job

Figure 334.6.3: Handling Print Job Creation Errors - BEST

[4.7] Submitting a FaxOut Job

The process recommendations for submitting a Job to an IPP FaxOut service are identical to those in §4.6.1 and §4.6.2 for conventional Print Job submission.

Page 56 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

160161

1023

10241025

1026

1027

10281029

1030

1031

1032

10331034

162

Page 57: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

[4.8] Monitoring Job Status

While the Job is being processed, users might wish to know whether it is proceeding successfully, or whether there are conditions that they need to handle that are preventing processing from proceeding, such as a media jam, open covers, marking agents depleted, and so forth.

To provide this using IPP, a Client SHOULD monitor the status of the various IPP objects involved, including the Printer, the Job, and Documents within that Job. A Client SHOULD monitor the status of a Job submitted to a Printer and SHOULD continue to monitor it until it has been successfully printed.

The basic system for monitoring IPP object status is to periodically submit one or more IPP operations to retrieve these objects' status. Obviously, this is "polling", and as with most polling based systems, this doesn't scale well and causes frequent unnecessary updates to be communicated. Ideally, this would be avoided and replaced with a system based on asynchronous event notifications.

IPP has an event notification system ([RFC3995], [RFC3996], [RFC3997]). Unfortunately, this system has been largely overlooked. Both IPP Clients and Printers can support IPP notifications to minimize network traffic and monitoring overhead. Section 5.11 discusses this in more detail.

For those options below that involve polling the Printer Object, the degree to which the option is better or worse is due in no small part to the polling frequency. The interval SHOULD be tuned so that the frequency of queries is not so great that it burdens the Printer Object or Job Object or the network, but not so small that there is an undesirable lag between when an event occurs and when the user is notified. It is always a bad practice in any case if a Client is polling as fast as the network can handle traffic. When polling the Printer Object, the Client SHOULD NOT poll as fast as the network can handle traffic; it SHOULD instead tune its polling interval to achieve a suitable balance between user responsiveness and resource overuse.

In some cases the Client will cease monitoring the Job once the Job Creation or Document Creation operations have concluded. There are many scenarios where the User would prefer to be notified about Job status until the Job has finished being processed. For example, with a Job requesting 500 copies of a document containing 4 pages, the Job Creation operations most likely will conclude minutes before the Job has concluded being processed by the Printer. A well-implemented Client SHOULD monitor Job status until the Job has reached a terminal state. If IPP Subscriptions are used, these notifications can be monitored and received quite a long time after the Job Creation operations have been performed.

Page 57 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

163164

1035

1036103710381039

1040104110421043

10441045104610471048

1049105010511052

105310541055105610571058105910601061

106210631064106510661067106810691070

1071

165

Page 58: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Alternatives

BAD: Poll Printer for general Printer status instead of precise Job statuso Polling all status information needlessly uses a large number of resources

(network bandwidth, printer CPU)o Polling for status without the actual Job ID is imprecise

Figure 34: Monitoring Job Status - BAD

Page 58 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

166167

1072

10731074107510761077

1078

1079

1080

168

Page 59: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

POOR: Poll for Job status using Get-Job-Attributeso Monitor the Job with ID acquired earlier, according to a polling interval

Figure 35: Monitoring Job Status - POOR

Page 59 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

169170

108110821083

1084

1085

1086

171

Page 60: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

GOOD: Monitor both Job and Printer status, but restricting Printer status to only attributes germane to status monitoring

o Monitor the value of "printer-state" attribute as well as targeted monitoring of a specific jJob's status

o Only ask for the attributes you need, to minimize the bandwidth needed for the information being used.

Figure 36: Monitoring Job Status - GOOD

Page 60 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

172173

1087108810891090109110921093

1094

1095

1096

174

Page 61: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BETTER: Use IPP Event Notifications and Subscriptions [RFC3995] Asynchronous / long running queries for notifications that don’t require

polling When Job has completed, query the state of that jJob Printer state changes will be provided by subscribing to the printer;

subscribing to the Job will provide less information and not be as useful

Figure 37: Monitoring Job Status - BETTER

Page 61 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

175176

10971098109911001101110211031104

1105

1106

1107

177

Page 62: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BEST: Create the Job using methods in section 4.6 and include the Subscriptions group in the Job Creation operation request; then monitor using the IPP Event Notifications and Subscriptions method [RFC3995]

o Most optimal if IPP Create-Job / IPP Send-Document is used so that the Job URI is positively sent by the Printer Object

Figure 38: Monitoring Job Status - BEST

4.7[4.9] Canceling a Print Job During Job or Document Creation

Situations arise where the user wants to terminate a Job before it is processed. This can occur before the Job's Documents have been completely transmitted to the Printer, or it might occur after the Job has been created but is awaiting processing. If the Job has already been completely created successfully, the Job can be terminated simply using an IPP Cancel-Job operation.

If the Job hasn't been fully created yet there is the risk that artifacts of that incomplete Job might remain. A well-implemented Client SHOULD clean up such artifacts if the Job is not completely created or it’s Documents not all submitted; leaving broken Job objects abandoned on the Printer is bad form.

There is some a dependency between the options below and how the Job was submitted. Adopting a high quality option from those listed below will likely depend on implementing a high quality option from §4.6.

Page 62 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

178179

110811091110111111121113

1114

1115

1116

11171118111911201121

1122112311241125

112611271128

180

Page 63: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Alternatives

BAD: Stop sending octets and abandon the connectiono Abandoned connection after some successful data transmission may allow

Job artifacts to linger

Figure 39: Canceling a Print Job During Job or Document Creation - BAD

Page 63 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

181182

1129

1130113111321133

1134

1135

1136

183

Page 64: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

GOOD: Stop sending on a page boundary; properly terminate Document during IPP Print-Job operation; IPP Cancel-Job to cancel the Job object

Figure 40: Canceling a Print Job During Job or Document Creation - GOOD

Page 64 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

184185

113711381139

1140

1141

1142

186

Page 65: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BEST: Stop sending on a page boundary; properly terminate Document during IPP Send-Document operation; IPP Cancel-Job to cancel the Job object

Figure 41: Canceling a Print Job During Job or Document Creation - BEST

4.8[4.10] Getting Printer Supplies Status

Some administrative tasks, like checking or monitoring consumables levels, are presented to Users in print dialogs or jJob status dialogs. It could also be monitored by printer management software or device status monitoring software on User systems. A well implemented Client SHOULD provide supplies status. Ideally, the Client would check supplies status using publicly specified extensions to IPP.

Alternatives

BAD: Don't provide supplies statuso Not good for users or printer vendors

Page 65 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

187188

114311441145

1146

1147

1148

11491150115111521153

1154

115511561157

189

Page 66: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

POOR: Use some proprietary protocol or (possibly closed) platform-specific extension to IPP

o This falls short of the ideal that all devices implement a publicly specified and open extension to IPP

o Private extensions to IPP are less desirable than a publicly specified and open protocol other than IPP

GOOD: SNMP and standard printer MIBso Public standard but not IPP, so not ideal

Figure 42: Getting Printer Supplies Status - GOOD

Page 66 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

190191

1158115911601161116211631164

116511661167

1168

1169

1170

192

Page 67: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

BETTER: IPP Get-Printer-Attributes to retrieve "printer-supply" attributeo Printer needs to implement "printer-supply" attributeo Supplies events in polling model can monitor "printer-state-reasons" for

'marker-toner-low' and similar states

Figure 43: Getting Printer Supplies Status - BETTER

BEST: Monitor supplies status using the IPP Event Notifications and Subscriptions method [RFC3995]

o Printer needs to implement "printer-supply" attribute to support this scenarioo Printer MAY send affected attributes, e.g. "printer-supply", "printer-input-tray",

"printer-output-tray", etc.

Page 67 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

193194

11711172117311741175

1176

1177

117811791180118111821183

195

Page 68: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Figure 44: Getting Printer Supplies Status - BEST

4.9[4.11] Error Handling

When a Client receives notice of an error, there are various ways to present that to the Client's user. Possible response actions include: presenting messages to the user; flagging or filtering those messages to indicate their severity and recoverability; and logging the event in an appropriate way.

A Client SHOULD log errors using the PWG Common Log Format [PWG5100.17] P.Zehler, M. Sweet, "IPP Scan Service (SCAN)", 5100.17-2014, September 2014,http://ftp.pwg.org/pub/pwg/candidates/cs-ippscan10-20140918-5100.17.pdf.

5. Using and Evaluating IPP AttributesSome attributes that IPP has labeled as optional should always be used as a best practice. Below are some of these attributes and how they should be used in various contexts.

5.1 Job Template Attributes And Value Binding

While it is technically possible for a Client to only send those Job Template attributes whose values do not match the default values, this strategy should be avoided. If the default were to change between Job submission time and Job processing time, the

Page 68 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

196197

1184

1185

1186

1187118811891190

119111921193

1194

119511961197

1198

119912001201

198

Page 69: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

resulting print Job might not meet user expectations. These default values should only be used for setting the initial state of Job Template attribute choice options for the User. This not only ensures the user’s expectations are met; it also makes implementing the client simpler because the Client doesn’t need to maintain any knowledge of whether the value chosen by the user matches the default provided by the Printer when the Job Template attributes were fetched to populate the user selection choices.

A Printer conveys its Job Template attributes’ default values using the “xxx-default” attributes. These attributes indicate the value the Printer will use if the Client does not provide that Job Template attribute at Job Creation time. The "xxx-actual" attributes reported by the IPP Printer in its operation response will report the values that are bound to the Job.

Using the “sides” Job Template attribute as an example, if the Printer reports that “sides-default” is 'one-sided' and “sides-supported” is {‘one-sided', 'two-sided-long-edge', 'two-sided-short-edge’}, a well-implemented Client SHOULD populate its "sides" Job option choice with the value from "sides-default": 'one-sided'. If the user makes some other choice, then the "sides" attribute would be updated to hold that new value. Once the user was satisfied with the choices and had requested the Job be printed, the Client would include the “sides” attribute and the value it holds in the Job Creation operation. Changes on the Printer to "sides-default" between the time the Job was submitted and the time it is processed will have no effect on the Job.

To help eliminate these pitfalls even for Clients that are poorly implemented and don't submit attributes that match the "xxx-default", a well-implemented Printer MAY bind Job Template attribute default values to each Job Template attribute at Job Creation time rather than waiting to do so at Job processing time, to help ensure user expectations.

5.1.1 IPP Client Recommendations

A Client SHOULD plan to submit all Job template attributes at Job creation time. A Client SHOULD set the initial state of each Job Template attribute to the corresponding Job Template attribute default value, if one exists.

5.1.2 IPP Printer Recommendations

A Printer SHOULD make that value binding visible to Clients as soon as possible by setting the xxx-actual Job Status attribute using that value as well.

5.2 Document Format Selection

A Client uses the “document-format” attribute in several ways. The Client evaluates the Printer’s document-format-supported attribute to decide on the most appropriate document format type. Once the Client has selected a format, it should perform a second Get-Printer-Attributes operation including "document-format" in the request, to request the Printer send the set of Job Template attributes and attribute values that correspond to that document format. This is discussed in detail in §4.4.

Page 69 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

199200

120212031204120512061207

12081209121012111212

121312141215121612171218121912201221

1222122312241225

1226

122712281229

1230

12311232

1233

123412351236123712381239

201

Page 70: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

Several factors, including time delays between Job receipt and Job processing as well as implementation challenges, can prevent an IPP Printer from receiving robust and timely feedback from its document format interpreter and rendering engine about the document content submitted with a jJob. It is important for the Client to be as descriptive as possible about the construction of the Job, including not only that Job’s IPP attributes but also accurately reporting the document format for each Document associated with that Job.

5.2.1 IPP Client Recommendations

As with all other Job Template attributes, a Client SHOULD include the "document-format" attribute with all Job creation operations, with the value set to the actual MIME Media type of the document format to be submitted to the Printer. A Client SHOULD NOT submit a Job with the “document-format” attribute specifying “application/octet-stream” as the document format.

5.2.2 IPP Printer Recommendations

A Printer SHOULD NOT implement 'application/octet-stream' as the only document format. A Printer SHOULD list all the document formats it supports (even vendor-specific ones) via the "document-format-supported" attribute. A Printer SHOULD NOT use 'application/octet-stream' as its "document-format-default".

A Printer SHOULD send the "document-format-actual" attribute in relevant IPP responses to report the detected MIME media type. If a request contains a document payload, the Printer SHOULD send the "document-format-actual" attribute value in the IPP operation response. The value of "document-format-actual" SHOULD be the detected format of the payload, not simply the value of the "document-format" attribute sent by the Client in the request.

5.3 Prefer "media-col" Attribute To "media" Attribute

The "media-col" attribute provides finer and more reliable control over media selection. As an example, the "media-col.media-size" sub-attribute is defined using integer value types rather than floating point value types, which avoids floating point calculation problems when converting between PWG size names and dimensions.

5.3.1 IPP Client Recommendations

Given a Printer Object that supports both "media" and "media-col" attributes, a Client SHOULD prefer to use the "media-col" attribute with operations that accept it. This is true for when "media" and "media-col" are top-level attributes as well as when "media" or "media-col" might be included within other collection attributes, such as "job-sheets", "job-error-sheet", "job-accounting-sheets", and others.

Page 70 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

202203

1240124112421243124412451246

1247

12481249125012511252

1253

1254125512561257

125812591260126112621263

1264

1265126612671268

1269

12701271127212731274

204

Page 71: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

5.3.2 IPP Printer Recommendations

The Printer SHOULD allow for a limited degree of inaccuracy even with "media-col.media-size". If the dimensions are off by a small amount (1-3 units) this SHOULD NOT be regarded by the Printer as a mismatch.

For more discussion of the "media-xxx" attributes, see §5.8.11.

5.4 Extended Finishings Options With "finishings-col-XXX"

The IPP "finishings", "finishings-supported" and "finishings-default" attributes [RFC2911] define a basic mechanism for describing finishings capabilities. The "finishings-col-XXX" attributes [PWG5100.1] [PWG5100.3] extend the "finishings-XXX" attribute set by providing a mechanism to convey detailed description of finishing settings. In certain contexts, it is advantageous to use "finishings-col" rather than "finishings" to describe the finishings options, if the Printer supports both. A Printer can precisely describe the implementation underlying each "finishings" keyword using corresponding "finishings-col-database" and "finishings-col-ready" entries. A Client can use these detailed descriptions to provide an accurate print preview, and also provide a scalable user experience that can be simple but allow more detailed user control if desired.

5.4.1 IPP Client Recommendations

A Client SHOULD support "finishings-col-XXX" [PWG5100.1] to allow it to acquire from the Printer detailed descriptions of each value listed in "finishings-supported". This is especially important if the Client needs to map between IPP and JDF or other rich Job ticket formats.

5.4.2 IPP Printer Recommendations

A Printer SHOULD support IPP Finishings 2.0 [PWG5100.1].

5.5 Controlling Intended Output Using "ipp-attribute-fidelity", "job-mandatory-attributes", and "pdl-override-supported"

There are two attributes that might be used by a Client to control whether a print Job will print EXACTLY as requested, or alternately print with "best effort" but might not comply with all requested Job attributes. These attributes are listed below, each with a synopsis of their meaning and purpose.

ipp-attribute-fidelity [RFC2911] - Attribute provided by IPP Client in Job submission operations. If absent the IPP Printer will assume the value is "‘false"’. If present and value is "‘true"’ then the IPP Printer is required to support all Job attributes and attribute values included in the Job submission operation or else the IPP Printer is required to reject the operation.

Page 71 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

205206

1275

127612771278

1279

1280

12811282128312841285128612871288128912901291

1292

1293129412951296

1297

1298

12991300

1301130213031304

13051306130713081309

207

Page 72: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

job-mandatory-attributes [PWG5100.7] - Identifies whichLists the Job Template attributes the Printer is required to support in thisa Job Creation request in order to accept the Job. This allows the IPP Client to specify at a finer level of granularity those attributes that need to be supported. If "job-mandatory-attributes" is included and it lists all the Job attributes, this is equivalent to including the ipp-attribute-fidelity attribute with value set to "‘true"’.

Additionally, a Client can use the following attribute to determine whether the IPP Printer can prefer IPP provided attributes to attributes embedded in the document content itself.

pdl-override-supported [RFC2911] - Specifies whether the pPrinter is capable of overriding Job attributes embedded in the Job document(s) with IPP Job attributes, and with what level of reliability: "'attempted" [RFC2911]; "not-attempted" , 'not-attempted' [RFC2911]; or "guaranteed" , 'guaranteed' [PWG5100.11]. . Although 'attempted' is supposed to convey that the Printer will try to perform overrides, best effort results are variable. Also, for any PDL other than simple raster document formats, "guaranteed" is impractical to implement.

5.5.1 IPP Client Recommendations

Given these descriptions, a A Client SHOULD comply with the following guidelines:

Do not alwaysOnly specify "ipp-attribute-fidelity" = 'true' because this can havewhen unconditional override is required, to avoid unintended side effects, such as output scaling, etc..;

If available preferUse "job-mandatory-attributes" over(if available) instead of "ipp-attribute-fidelity"";

Regard "pdl-override-supported" = 'attempted' as functionally equivalent to "pdl-override-supported" = 'not-attempted', since neither guarantee overrides.

Don't expectUse 'guaranteed' to be available, especially for complex PDLs, since it is impractical to implement with all but the simplest only when "document formats.-format" is specifying a raster document format such as JPEG or PWG Raster;

Don't expect 'guaranteed' to be 100% trustworthy with complex PDLs, since implementing that guarantee would be impractical to implement.

Provide document data that is the correct size, etc. to avoid overrides and not depend on the IPP Printer to perform these overrides unless it can guarantee it.

5.5.2 IPP Printer Recommendations

A Printer SHOULD comply with the following guidelines regarding how to support "ipp-attribute-fidelity",:

Page 72 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

208209

131013111312131313141315

131613171318

1319132013211322132313241325

1326

1327

132813291330

13311332

13331334

133513361337

13381339

13401341

1342

13431344

210

Page 73: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

S upport "job-mandatory-attributes", and "pdl-override-supported":";

The Printer SHOULD support "job-mandatory-attributes"

The Printer SHOULD supportSupport 'guaranteed' for "pdl-override-supported" for JPEG and PWG Rasterraster document formats such as JPEG or PWG Raster.

[5.6] PreferUse "multiple-document-handling" Forto Collate Copies Collation

Although there was a time where specifying multiple copies of a Job would by default produce an un-collateduncollated collection of copies, when a User asks for multiple copies the User's expectation is almost always that the Job will produce a collated collection of copies. Despite this User expectation, for historical reasons the print systems have assumed un-collated to be the norm.

The "sheet-collate" attribute [RFC3381] "specifies whether or not the media sheets of each copy of each printed document in a Job are to be in sequence, when multiple copies of the document are specified by the ’copies’ attribute". The IPP Client likely doesn't want to collate sheets, but rather collate copies of the Job. The "multiple-document-handling" Job Template attribute provides these semantics. Although "Internet Printing Protocol/1.1: Model and Semantics" ([RFC2911] §4.2.4) asserts that the "multiple-document-handling" attribute is relevant only if a Job consists of two or more documents, this attribute provides the desired semantics outside that context as well.

"IPP: Job and Printer Extensions – Set 3 (JPS3)" [PWG5100.13] §10 provides a detailed discussion of the relationship between Impressions, Pages and Sheets, and attributes that influence how the various Job Template attributes affect these metrics.

5.5.3[5.6.1] IPP Client Recommendations

A Client SHOULD request collation for multiple copies of a Job using the "multiple-document-handling" attribute with its value set to "separate-documents-collated-copies" if the Printer supports the "multiple-document-handling" attribute.

5.5.4[5.6.2] IPP Printer Recommendations

A Printer SHOULD implement "multiple-document-handling" to allow a Client to request collated copies of a Job.

5.6[5.7] Specify "orientation-requested" For Supported Document Types

A Client uses the "orientation-requested" attribute [RFC2911] §4.2.10 to convey the desired orientation of the pages for a Job or Document in a Job. Although some

Page 73 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

211212

1345

1346

13471348

13491350

13511352135313541355

135613571358135913601361136213631364

136513661367

1368

136913701371

1372

13731374

1375

13761377

213

Page 74: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

document type formats provide a mechanism to express page orientation, others do not.

5.6.1[5.7.1] IPP Client Recommendations

If "orientation-requested-supported" is in the filtered list of Job Template attributes for the chosen document format, a Client SHOULD provide the "orientation-requested" attribute with the Job or with each Document submitted to an IPP Job.

5.6.2[5.7.2] IPP Printer Recommendations

A Printer SHOULD implement "orientation-requested" for the PDLs it supports that lack a mechanism to specify page orientation.

5.7[5.8] Evaluating Printer Capability Attributes

Before creating a Job, a Client SHOULD query the IPP Printer to evaluate its capabilities. Techniques for doing this using different sequences of operations are described in §4.3. When responding to an IPP Get-Printer-Attributes request, the Printer filters the set of attributes and values [RFC2911] to those that are acceptable to a Job Creation, Validate-Job, and Validate- Document operation...

IPP Client implementations SHOULD evaluate the attributes listed in Table 1, which lists the Printer attributes that are discussed in the following subsections.

Table 1: Printer Capability Attributes A Client Should Evaluate

Attribute Name Reference Description

document-format-supported RFC 2911 Lists the set of supported document formats

printer-get-attributes-supported PWG 5100.13

Lists the set of attributes a Client can send to the Printer in a Get-Printer-Attributes operation request that the Printer can employ to filter the set of Job Template attributes it sends back in its response

document-format-varying-attributes

RFC 3380 Lists the attributes whose defaults or range of supported values vary by document format

ipp-features-supported PWG 5100.13

Lists the set of optional functionality the pPrinter supports

printer-config-change-date-time PWG 5100.13

Helps a Client or operator to determine how recently any of the Printer description attributes has been changed; useful if the Client is caching pPrinter defaults and capabilities

printer-config-change-time PWG 5100.13

Helps a Client or operator to determine how recently any of the Printer description attributes has been changed; useful if the Client is caching

Page 74 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

214215

13781379

1380

138113821383

1384

13851386

1387

13881389139013911392

13931394

1395

216

Page 75: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

pPrinter defaults and capabilities

job-creation-attributes-supported PWG 5100.11

Lists the keyword names of the Job Template and operation attributes that the Printer will accept in Job Creation operations or a Validate-Job operation

document-creation-attributes-supported

PWG 5100.5

Lists the keyword names of the Document Template and operation attributes that the Printer will accept in Document Creation operations (Send-Document, Send-URI) or a Validate-Document operation

IPP Client implementations SHOULD NOT evaluate the attributes listed in Table 2.

Table 2: Printer Capability Attributes A Client Should AVOID

Attribute Name Reference Description

??? ??? ???

??? ??? ???

[5.8.1] document-format-supported / document-format

One of the most elemental tasks that a Client performs is choosing a print Job document format. The Printer's "document-format-supported" attribute enumerates the document formats supported by the Printer. How the Client chooses the particular document format is beyond the scope of this specification.

Once the Client has chosen a format, it SHOULD send a second Get-Printer-Attributes operation request, including the "document-format" attribute. As is described in §4.4, the Client does this to receive the list of Printer and Job Template attributes filtered to correspond to that specific document format. In this way, the Client can get a set of Printer capabilities the accurately describe the possible options supported by the Printer for that document format, with unsupported attributes and values filtered out [RFC2911]. Further filtering can be done using attributes listed in the Printer's "printer-get-attributes-supported" attribute, described in §5.8.2.

5.7.1[5.8.2] printer-get-attributes-supported

The "printer-get-attributes-supported" attribute [PWG5100.13] enumerates those attributes that can be included in a Get-Printer-Attributes request to influence the attributes and attribute values sent by the Printer in its Get-Printer-Attributes operation response. This attribute is useful to a Client because it allows it to further filter the Printer's capabilities so that the options provided to a user can be more tightly

Page 75 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

217218

1396

1397

1398

1399

1400140114021403

14041405140614071408140914101411

1412

14131414141514161417

219

Page 76: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

constrained. Ideally a user will be presented as many options as are supported but no more.

If a Printer supports the "printer-get-attributes-supported" attribute, a Client SHOULD include only attributes whose names are listed in that attribute when performing follow-up Get-Printer-Attributes operations as described in §4.4; otherwise, the Printer might reject the operation or the operation response might contain unfiltered information, which the Client would likely not expect.

5.7.2[5.8.3] document-format-varying-attributes

The "document-format-varying-attributes" attribute [RFC3380] is a Printer attribute that lists the Printer attributes that might vary depending on the document format. While this attribute was designed for use by a management Client engaged in manipulating the state of the Printer via Set-Printer-Attributes operations, a Client can use it in the process of submitting a Job to identify those attributes that could have different values depending on the document format.

This attribute is useful to a Client because it provides another mechanism to detect attributes or attribute value ranges that could vary depending on the document format.

5.7.3[5.8.4] ipp-features-supported

The "ipp-features-supported" Printer attribute [PWG5100.13] provides a mechanism for listing support for a particular IPP extension feature. A feature can be comprised of multiple attributes, can also include new operations, and can have associated semantics defined as well. Examples of these features from [PWG5100.13] include "document-object", "job-save", "page-overrides", "proof-print", and "subscription-object". Other IPP specifications can define their own keywords and associated meanings, which are context-specific. It can be difficult to switch a feature on based solely on the existence of a particular set of attributes or attribute values.

This attribute is useful because it provides a way for a Client to easily enable potentially complex feature support without having to rely on more complicated heuristic analysis and interpolation of the attributes that are used to support the feature.

5.7.4[5.8.5] printer-config-change-date-time and printer-config-change-time

The "printer-config-change-date-time" and "printer-config-change-time" Printer attributes [PWG5100.13] provide 2 different representations of the most recent time at which the printer-config-changed Printer Event occurred.

This attribute is useful because a Client that records and subsequently monitors this attribute will be able to decide whether it needs to re-evaluate the printer's attributes or whether a cached set of values can be used.

Page 76 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

220221

14181419

14201421142214231424

1425

142614271428142914301431

14321433

1434

14351436143714381439144014411442

144314441445

1446

144714481449

145014511452

222

Page 77: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

5.7.5[5.8.6] xxx-supported and xxx-default

"Internet Printing Protocol/1.1: Model and Semantics" [RFC2911] §4.2 provides a set of rules for specifying how a Job Template attribute is defined. Generally a Job Template attribute is defined in a cluster of 3, including the attribute itself ("xxx"), an attribute that conveys the range of possible values that "xxx" can contain ("xxx-supported"), and an attribute that conveys the current default value ("xxx-default") that the Printer will use if that attribute isn't provided by the Client at Job submission time.

The "xxx-supported" and "xxx-default" attributes are reported to the Client using a Get-Printer-Attributes operation. These values can change if the Client includes attributes with the Get-Printer-Attributes operation such as "document-format" as discussed in §Error: Reference source not found or one of the attributes enumerated by the "printer-get-attributes-supported" attribute as discussed in §5.8.2.

A Client SHOULD always provide all intended and applicable Job Template attributes explicitly in its operation requests; a Client SHOULD NOT depend on default values, because the default can change before the Job is processed.

5.7.6[5.8.7] xxx-supported vs. xxx-ready

Most Job Template attributes are defined using a cluster of 3 attributes ("xxx", "xxx-supported" and "xxx-default", as discussed in §5.8.6. Some attributes also have a fourth "xxx-ready" attribute in their cluster. This attribute is used to indicate which of the values in the "xxx-supported" attribute are ready for use with no user interaction needed. The attributes that have an associated "xxx-ready" attribute are generally those that involve consumables such as paper or marking agents. A common example would be the "media-ready" attribute [RFC2911], which indicates the set of media that is physically in the paper trays. This would likely differ from "media-supported" because the set of supported media types is most likely larger than the set of media types currently installed in the paper trays.

This attribute is useful to a Client because it allows the Client to be able to determine whether certain consumables choices are already available for use, and allows the Client to make certain choices as to the workflow it provides to the user.

5.7.7[5.8.8] job-creation-attributes-supported

The "job-creation-attributes-supported" attribute [PWG5100.11] lists the set of Job attributes that can be set by a Client with a Job Creation operation (Create-Job, Print-Job, Print-URI) or a Validate-Job operation. The list of attributes is not limited to Job Template attributes; the list can also include optional Job submission attributes, such as "job-name".

The Client can use this attribute to know which attributes the Printer supports.

Page 77 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

223224

1453

145414551456145714581459

14601461146214631464

146514661467

1468

1469147014711472147314741475147614771478

147914801481

1482

14831484148514861487

1488

225

Page 78: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

5.7.8[5.8.9] document-creation-attributes-supported

The "document-creation-attributes-supported" attribute [PWG5100.5] is similar to the "job-creation-attributes-supported" attribute except it applies to those attributes that can be supplied in Document Creation (Print- Job, Print-URI, Send-Document, and Send-URI) and manipulation (Set-Document-Attributes, Set-Job-Attributes) operations. All recommendations made for the use of "job-creation-attributes-supported" also apply to "document-creation-attributes-supported".

5.7.9[5.8.10] job-settable-attributes-supported

The "job-settable-attributes-supported" attribute [RFC3380] lists the Job object attributes that can have their values changed via a Set-Job-Attributes operation. This is useful to the Client because it provides a mechanism to control some aspects of jJob state, which can affect processing time and execution. For instance, a Client can use this attribute to update Job attributes and release a jJob in the pending-held state after all documents have been submitted.

5.7.10[5.8.11] media-col-ready vs. media-col-database

The “media-col-database” attribute describes all the pre-defined "media-col" values implemented by the Printer, regardless of whether they are currently available. By definition, this attribute is not sent by the Printer unless explicitly requested since it is large, expensive to generate, and likely contains media that are not readily available, which can be misleading to the user. The “media-col-ready” attribute [PWG5100.3] describes the attributes of the media that is currently ready to use.

The Printer SHOULD implement the “media-col-ready” attribute.

The Client SHOULD use “media-col-ready” if the Printer implements it. The Client SHOULD NOT retrieve the “media-col-database” attribute unless the User does something overt that depends on presenting or using the entire "media-col-database".

5.8[5.9] Resolving Job Attribute Conflicts and Constraints

The "job-constraints-supported" and "job-resolvers-supported" attributes [PWG5100.13] provide respectively mechanisms for a Printer to describe to a Client the constraints between sets of attributes and/or attribute values, and associated formulae for resolving constraint conflicts. A Client that supports these attributes properly can resolve conflicts between constrained attributes or attribute values locally, without having to contact the Printer with requests to validate the attribute set correctness. The "preferred-attributes" attribute provides an additional mechanism for a Printer to report attribute conflicts detected during a "Validate-Job" operation. This is covered in more detail in § 4.5§4.5.

The “job-constraints-supported” attribute definition in [PWG5100.13] §5.6.8 provides this example:

Page 78 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

226227

1489

149014911492149314941495

1496

149714981499150015011502

1503

150415051506150715081509

1510

151115121513

1514

151515161517151815191520152115221523

15241525

228

Page 79: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

For example, a constraint for duplex printing on transparency media would be encoded as a collection containing “resolver-name”, “sides”, and “media-col” member attributes. The “sides” member attribute would have two values - “two-sided-long-edge” and “two-sided- short-edge” - while the “media-col” member attribute would have a single "media-type" member attribute with the value “transparency”.

The “job-resolvers-supported” attribute definition in [PWG5100.13] §5.6.11 provides this example:

For example, a resolver for duplex printing on transparency media would be encoded as a collection containing “resolver-name”, “sides”, and “media-col” member attributes. The “sides” member attribute would have the value “one-sided” while the “media-col” member attribute would contain a "media-type" member attribute with the value “stationery”.

To illustrate how this works via 2 examples, the Client is assumed to have received the following attributes from the Printer in a Get-Printer-Attributes operation response. The attributes relevant to these examples are listed below, using the Open Standard Print API [PAPI] attribute list text representation syntax:

sides-default="one-sided"media-col-ready={ { media-size = { x-dimension=21590 y-dimension=27940 } media-top-margin=423 media-bottom-margin=423 media-left-margin=423 media-right-margin=423 media-source=tray-3 media-type="stationery" media-source-properties= { media-source-feed-direction="long-edge-first" media-source-feed-orientation=4 } } { media-size= { x-dimension=27940

Page 79 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

229230

152615271528152915301531

15321533

15341535153615371538

1539154015411542

1543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567

231

Page 80: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

y-dimension=43180 } media-top-margin=423 media-bottom-margin=423 media-left-margin=423 media-right-margin=423 media-source="tray-2" media-type="transparency" media-source-properties= { media-source-feed-direction="short-edge-first" media-source-feed-orientation=3 } }}

job-constraints-supported={ resolver-name=“A” sides= { "two-sided-long-edge" "two-sided-short-edge" } media-col= { media-type="transparency" }}

job-resolvers-supported={ resolver-name=“A” sides="one-sided" media-col= { media-type="stationery" }}

To illustrate how constraints and resolvers work using the above attribute information, two examples will be described. In each of them, the Client loads the attributes from the Printer and presents a print dialog with print options to the User. The state of "sides" is initialized with the value from "sides-default", and “ "media-col" is initialized with the value from "media-col-default".

Page 80 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

232233

156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606

16071608160916101611

234

Page 81: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

As a first example, the User chooses "sides" = 'two-sided-long-edge'. The Client detects a control change, and evaluates the changed value against the constraints. The Client detects no conflicts, so the Client accepts the attribute value change. Then the User selects "transparency" for a media type. The Client detects a control change and evaluates the changed value against the constraints. The Client detects a conflict, so the Client takes some action to resolve the conflict. The Client implementation determines how the conflict is resolved. It could be that the new value is rejected ("media-col" change in this example), or it could be that the new value is kept but the conflicting attribute is changed as per the resolver. Or the choices could be presented to the User in some way.

For a second example, the User selects "transparency" for a media type. The Client detects a control change and evaluates the changed value against the constraints. The Client detects no conflicts, so the Client accepts the attribute value change. Then the User selects "sides"='two-sided-short-edge'. The Client detects a control change and evaluates the changed value against the constraints. The Client detects a conflict, so the Client takes some action to resolve the conflict. Again, how the Client manages the resolution is at the discretion of the Client implementors.

5.9[5.10] IPP Object Status Attributes

A Client will evaluate different sets of attributes when following the procedures in §4.7 or 4.10 to monitor the status of a Printer or Job. These sets should be interpreted in the context of one another to ensure correct status evaluation.

5.9.1[5.10.1] Printer Status

A Printer conveys its status using the "printer-state", "printer-state-reasons" and "printer-state-message" attributes [RFC2911], as well as the "printer-alert" and "printer-alert-description" [PWG5100.9]. A Client can acquire these attributes using a Get-Printer-Attributes operation. A Printer SHOULD append to its "printer-state-reasons" attribute values the appropriate suffixes defined in [RFC2911] §4.4.12.

If the Printer and Client both support IPP Notifications, the Client can create a Printer subscription that includes the "printer-state", "printer-state-reasons" and "printer-state-message" attributes in the "notify-attributes" list. See §5.11 for more information on IPP Notifications.

5.9.2[5.10.2] Job Status

A Job conveys its status using the "job-state", "job-state-reasons" and "job-state-message" attributes. A Client can acquire these attributes using a Get-Job-Attributes operation.

If the Printer and Client both support IPP Notifications, the Client can create a Job subscription that includes the "job-state", "job-state-reasons" and "job-state-message"

Page 81 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

235236

1612161316141615161616171618161916201621

1622162316241625162616271628

1629

163016311632

1633

16341635163616371638

1639164016411642

1643

164416451646

16471648

237

Page 82: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

attributes in the "notify-attributes" list. See §5.11 for more information on IPP Notifications.

5.9.3[5.10.3] Document Status

If the Client wants detailed information about the status of Document objects within a Job, it can get the status of the various Documents within the Job using the Get-Document-Attributes operation, and would examine the "document-state", "document-state-reasons" and "document-state-message" attributes.

5.10[5.11] IPP Notifications Attributes

A well-implemented IPP Printer SHOULD support IPP Notifications [RFC3995]. The Printer SHOULD include additional Printer attributes in Printer event notifications (e.g. "printer-supply" for supply events, "printer-input-tray" for media events, etc.).

When subscribing for IPP notifications, a Client SHOULD include the "notify-attributes" Subscription Template attribute in its Job Creation operations rather than subscribing to events using the separate Create-Job-Subscriptions or Create-Printer-Subscriptions operations. Having the Job Creation operation create the subscription makes the subscription creation and Job creation operations atomic and reduces the need for additional operations.

A Client uses the "notify-attributes" attribute to list the attributes it wants request that each notification include particular attributes. If each notification includes the attributes the Client needs, the Client will not need to perform a subsequent Get-Printer-Attributes operation for a Printer subscription, or Get-Job-Attributes operation for a Job subscription.

6. IPP Document Page OrderDocument formats intended for streaming (printed directly), such as PWG Raster, need to have the pages sent in the order that they should emerge from the printer. This order will be affected in part by which side the marking appears on when the page emerges from the printer. On a pPrinter that implements the "printer-output-tray" attribute and prints its documents “face down” (the paper emerges with the marking on the bottom side of the page), the pages should be sent in the order 1-N. On a pPrinter that prints its pages “face up” (the paper emerges with the marking on the top side of the page), the pages should be sent in the reverse order (N-1). Other aspects, including duplex and page reordering, will further affect this page ordering. If the Printer does not support the "printer-output-tray" attribute, the "output-bin" and "output-bin-default" attributes can be evaluated. The 'face-up' value indicates last-to-first order; all other values are first-to-last.

Other document formats that are not intended for streaming but are rather intended for more general use, such as PDF or word processing document formats, need to be sent

Page 82 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

238239

16491650

1651

1652165316541655

1656

165716581659

166016611662166316641665

16661667166816691670

1671

167216731674167516761677167816791680168116821683

16841685

240

Page 83: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

as-is, with no page reordering. It will be the Printer’s responsibility to paginate and print the file in the order that is appropriate given the paper orientation and other built-in information in the document format (with overriding behavior as per §5.5). This may require the entire Document to be received before the first page can be printed. For instance, if a Client submits a Job with its document content in PDF document format, the Client SHOULD send the document format in 1-N page ordering, and depend on the pPrinter processing the pages in whatever order is appropriate to comply with the preferences in the Job IPP attributes and the settings in the PDF document.

7. IPP Printer Best PracticesThis section enumerates practices that SHOULD be followed by implementers of IPP Printer objects, whether embedded in a Printer or in a separate Print Server.

7.1 IPP Objects and URI Resource Paths

IPP operations require a target consisting of a "printer-uri" attribute and zero or more operation identifiers, such as "job-id", "document-number", or others ([RFC2911] §§3.1.5)..

Each instance of a Printer, FaxOut, or Scan Service provided by an Imaging Device is identified by a URI. The URI scheme MUST be "ipps" [RFC-IPPS] or "ipp" [RFC3510]. It MUST NOT be "http" or "https" [RFC2910].

The path component of an IPP Printer URI SHOULD be “/ipp/print” for the only (or default) instance of the service on an Imaging System and “/ipp/print/instance-name” for each additional, non-default instance on the Imaging System. IPP FaxOut [PWG5100.15] and IPP Scan [PWG5100.17] each define a well-known path for their respective Service Object types.

If the Printer supports IPP operations with the "/" resource path, then the Printer SHOULD support Get-Printer-Attributes and SHOULD NOT support Job Creation operations.

"Internet Printing Protocol/1.1: Model and Semantics" [RFC2911] requires particular Client behavior concerning the use of URIs in an operation's "printer-uri" attribute. [RFC2911] section§ 2.4 requires the Client to only provide URIs that are listed by the Printer's "printer-uri-supported" attribute. [RFC2911] § 3.1.5 requires the Client to only use absolute URIs for the value sent for the "printer-uri" operation attribute. Despite the recommendations in [RFC3196], a Printer SHOULD NOT accept a request where the "printer-uri" value is a relative URI and SHOULD NOT accept a request where the "printer-uri" doesn't match one of those URIs in the Printer's "printer-uri-supported" attribute.

Page 83 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

241242

16861687168816891690169116921693

1694

16951696

1697

169816991700

170117021703

17041705170617071708

170917101711

171217131714171517161717171817191720

243

Page 84: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

A Printer SHOULD reject IPP operations where the value of the "printer-uri" operation attribute is a relative URI. A Client SHOULD NOT use a relative URI in the "printer-uri" operation attribute.

The "job-uri" path has never been fully specified. Printers SHOULD choose a path appropriate for the implementation. Clients SHOULD use the "printer-uri" and "job-id" attributes to target a Job object for a Job operation. Clients SHOULD NOT use the "job-uri" attribute to target a Job object.

[7.2] Fax Destination URIs

When a Client submits a fax Job to an IPP FaxOut service [PWG5100.15], it includes a set of destination URIs. An IPP FaxOut Printer Object SHOULD handle the “fax:” URI scheme as being equivalent to the “tel” URI scheme [RFC3966].

[7.3] Printer Resource URIs

URIs to various Printer resident resources SHOULD be Network Accessible even if all other network services have been disabled in the Output Device.

As an example, the "printer-icons" URI SHOULD be Network Accessible even if the Output Device has its embedded web server turned off. Since the "printer-icons" attribute is defined to contain a set of "http":" or "https":" URIs, each URI SHOULD include the port number of the IPP Server, e.g. "http://myprinter.mydomain.com:631/icon.png".

7.2[7.4] Error Reporting

A Printer SHOULD log errors using the PWG Common Log Format [PWG5100.17] P.Zehler, M. Sweet, "IPP Scan Service (SCAN)", 5100.17-2014, September 2014,http://ftp.pwg.org/pub/pwg/candidates/cs-ippscan10-20140918-5100.17.pdf.

8. HTTP Protocol UseIPP currently uses HTTP/1.1 for its transport. IPP/2.0 and other IPP specifications have specified some of the facilities of HTTP that IPP clients and servers SHOULD support in order to provide the semantics that IPP needs to provide a great user experience. Even so, there are best practices that SHOULD be followed.

What follows includes recommendations for both Client and Server implementations. Each subsection will provide Client recommendations in an 8.x.1 subsection; Server recommendations will be listed in an 8.x.2 subsection.

Page 84 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

244245

172117221723

1724172517261727

1728

172917301731

1732

17331734

17351736173717381739

1740

174117421743

1744

1745174617471748

174917501751

246

Page 85: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

8.1 New HTTP/1.1 Specifications

In June 2014 the IETF published the following specifications, which obsolete RFC 2616:

Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing [RFC7230]

Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content [RFC7231]

Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests [RFC7232]

Hypertext Transfer Protocol (HTTP/1.1): Range Requests [RFC7233]

Hypertext Transfer Protocol (HTTP/1.1): Caching [RFC7234]

Hypertext Transfer Protocol (HTTP/1.1): Authentication [RFC7235]

8.1.1 HTTP Client

Implementors SHOULD review their HTTP stack implementation to ensure conformance with these current HTTP/1.1 specifications.

8.1.2 HTTP Server

Implementors SHOULD review their HTTP stack implementation to ensure conformance with these current HTTP/1.1 specifications.

8.2 HTTP/1.1 Expect Header

The HTTP/1.1 "Expect" header field [RFC7230] allows the HTTP Client to send the HTTP request header to the Server and pause to receive an HTTP response code before sending the request body, if present. This allows a Server to indicate via an appropriate response code if there are any authorization or encryption requirements to be satisfied before sending the HTTP request body.

8.2.1 HTTP Client

In its first request to the HTTP Server, and in all first uses of a particular IPP operation while involved in a session consisting of a sequence of IPP operations, the HTTP Client SHOULD include the "Expect: 100-continue" header in the request headers [RFC7231] §5.1.1. The HTTP Client SHOULD then wait at least 1 second for a response from the HTTP Server. If no response is received, the Client should record this for subsequent requests so that no further response delays are incurred, and then continue sending the message body; otherwise the HTTP Client SHOULD process the response in one of the following ways (which is a more detailed set of behaviors than described in HTTP/1.1 [RFC7230]):

Page 85 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

247248

1752

17531754

1755

1756

1757

1758

1759

1760

1761

17621763

1764

17651766

1767

17681769177017711772

1773

177417751776177717781779178017811782

249

Page 86: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

1. 100 Continue : continue sending the message body

[2.] 301 Moved Permanently /or 302 Moved Temporarily :

a. If the request type is POST or PUT, fail and report an error, since redirection is generally unexpected for this request type

b. If the request type is HEAD or GET, redirect the request to the new URI or address the redirection in an implementation-defined way, e.g. request confirmation from the User, validate the redirected URI scheme and origin server, etc.

2.[3.] 400 Bad Request : the Client should record the lack of an Expect header, and re-send the HTTP request without the Expect header. (An HTTP/1.1 Server is supposed to support the Expect header as per [RFC7230] §5.1.1 but a robust Client might include logic for recovering from interacting with poorly implemented servers.)

3.[4.] 401 Unauthorized : close the connection, acquire new credentials from the User, and retry the HTTP request with the newly acquired credentials

4.[5.] 403 Forbidden : abandon the connection and report an error as per §4.11.

5.[6.] 417 Expectation Failed : resend the HTTP request without the Expect header

[7.] 426 Upgrade Required : if the upgrade response header contains a TLS identifier, upgrade the connection to TLS [RFC2817][RFC2817] and then re-send the HTTP request

6.[8.] Any other HTTP status code : treat this as a fatal error and report it as per §4.11.

8.2.2 HTTP Server

The HTTP Server SHOULD accept and process the "Expect" header as defined in § 5.1.1 of "Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content" [RFC7231].[RFC7231].

8.3 "Host" Header Field

An HTTP Server validates the Host request header in order to protect against DNS rebinding attacks. Section 5.1.1 of "IPP Everywhere" [PWG5100.14][PWG5100.14] places additional requirements on the Host header.

8.3.1 HTTP Client

An HTTP Client SHOULD include the Host header field, and its value SHOULD match the name in the URI it is using.

Page 86 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

250251

1783

1784

17851786

1787178817891790

1791179217931794

17951796

1797

1798

179918001801

18021803

1804

180518061807

1808

180918101811

1812

18131814

252

Page 87: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

8.3.2 HTTP Server

An HTTP Server SHOULD use the Host value in generated URIs, such as the embedded web server web pages or IPP operation responses.

8.4 If-Modified-Since, Last-Modified, and 304 Not Modified

The If-Modified-Since request header allows an HTTP Client to efficiently determine whether a particular resource that can be retrieved using a GET request (icon, ICC profile, localization file, etc.) has been updated since the last time the HTTP Client requested it.

8.4.1 HTTP Client

An HTTP Client should utilize the "If-Modified-Since" header in GET requests for resources that it may already have locally, and support the "Last-Modified" response header and "304 Not Modified" response code, to avoid re-fetching these resources if they haven't changed.

8.4.2 HTTP Server

HTTP Servers SHOULD support the "If-Modified-Since" request header [RFC7232], the Last-Modified response header [RFC7232], and the "304 Not Modified" response code [RFC7232].

8.5 Cache-Control

Most resource files provided by a Printer in a GET response will typically be cacheable. However, IPP responses in a POST response are not [PWG5100.14]. Most resources retrieved by an IPP Client from an IPP Printer via an HTTP GET are usually quite static and ought to be treated as a persistent resource. The HTTP "Cache-Control" header [RFC7234] formalizes this.

8.5.1 HTTP Client

An HTTP Client SHOULD conform to the HTTP/1.1 caching semantics [RFC7234]. An HTTP Client SHOULD support the "Cache-Control" response header.

8.5.2 HTTP Server

An HTTP Server SHOULD conform to the HTTP/1.1 caching semantics [RFC7234]. A Printer's HTTP Server MAY provide a "Cache-Control" header in each HTTP GET response, with an appropriate "max-age" value for that resource. A Printer's HTTP Server SHOULD provide a Cache-Control header in IPP POST responses with the value "no-cache".

Page 87 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

253254

1815

18161817

1818

1819182018211822

1823

1824182518261827

1828

182918301831

1832

18331834183518361837

1838

18391840

1841

18421843184418451846

255

Page 88: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

9. Important Implementation Options

9.1 Job Receipts: The "xxx-actual" Attributes

The "xxx-actual" [PWG5100.8] attributes cannot be used to detect substitutions during. The state of these attributes isare not guaranteed to be set until the Job reaches a terminating state ('aborted', 'canceled' or 'completed'). Processors of the Job receipt SHOULD NOT expect the Printer to bind values toexamine the "xxx-actual" attributes before the jJob has reached a terminateding state.

9.2 Printer Constraints: The "preferred-attributes" Attribute

The Printer indicates it supports the "preferred-attributes" attribute [PWG5100.13] with the "preferred-attributes-supported" Printer Description attribute. IfWhen supported, the Printer will sendreturn the "preferred-attributes" attribute in the Validate-Job operation responsesresponse if itthe Printer will perform substitutions the Printer to resolve detected constraints problems it detected. This giveswill provide the Client the opportunity to resolve these issues locally. before creating the Job. However, although this is useful when performing Job "pre-flight",ticket validation, a Client should not be implemented to use thisValidate-Job operations and the "preferred-attributes" attribute as a mechanism to be called with high frequency for resolving constraints conflicts in an interactive UI. As outlined in §4.5, a Client SHOULD start by using the procedures described in §5.9, which can be performed locally on the Client and doesn't require any network utilization.

10. Conformance Recommendations

10.1 Client Conformance Recommendations

Clients SHOULD implement the following:

1. all of the "best" options in section 4;

2. all of the Client recommendations in section 5;

3. all of the recommendations in section 6;

4. all of the Client recommendations in section 8;

5. all of the Client recommendations in section 11;

6. all of the Client recommendations in section 12

Page 88 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

256257

1847

1848

18491850185118521853

1854

185518561857185818591860186118621863186418651866

1867

1868

1869

1870

1871

1872

1873

1874

1875

258

Page 89: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

10.2 Printer Conformance Recommendations

Printers SHOULD implement the following:

1. all of the "best" options provided in section 4;

2. all of the recommendations in section 5;

3. all of the recommendations in section 7;

4. all of the Printer recommendations in section 8;

5. all of the Printer recommendations in section 11;

6. all of the Printer recommendations in section 12

11. Internationalization ConsiderationsFor interoperability and basic support for multiple languages, conforming implementations MUST support:

[1.] The Universal Character Set (UCS) Transformation Format -- 8 bit (UTF-8) [STD63] encoding of Unicode [UNICODE] [ISO10646];[ISO10646]; and

[2.] The Unicode Format for Network Interchange [RFC5198][RFC5198] that requires transmission of well-formed UTF-8 strings and recommends transmission of normalized UTF-8 strings in Normalization Form C (NFC) [UAX15].

Unicode NFC is defined as the result of performing Canonical Decomposition (into base characters and combining marks) followed by Canonical Composition (into canonical composed characters wherever Unicode has assigned them).

WARNING – Performing normalization on UTF-8 strings received from IPP Clients and subsequently storing the results (e.g., in IPP Job objects) could cause false negatives in IPP Client searches and failed access (e.g., to IPP Printers with percent-encoded UTF-8 URIs now 'hidden').

11.1 Client Considerations

A Client SHOULD query and use localization catalogs provided by the IPP Printer [PWG5100.13], if available.

11.2 Server Considerations

A Printer SHOULD support localization catalogs [PWG5100.13].

Page 89 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

259260

1876

1877

1878

1879

1880

1881

1882

1883

1884

18851886

188718881889189018911892

189318941895

1896189718981899

1900

19011902

1903

1904

261

Page 90: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

12. Security Considerations

12.1 Client Security Considerations

In addition to the sections below, Client implementors should also pay attention to §7.2, §8.2.1 and §8.3.

12.1.1 HTTP/1.1 Expect Header

As discussed in §8.2, a Client SHOULD send the HTTP/1.1 Expect header where it is important to determine if the Printer will request to upgrade the connection to use TLS if it isn't being used already. Examples of this scenario include:

a. First HTTP request for a connectionb. First IPP request for a connectionc. Any request where the Client will be transmitting potentially sensitive data

12.1.2 HTTP Upgrade

A Client or Server MAY be implemented to refuse to use certain operations if a connection is not employing TLS encryption. Encryption can be supplied via HTTP Upgrade [RFC2817] or HTTPS [RFC 2818].HTTP over TLS (HTTPS) [RFC2818]. Clients and Servers SHOULD support TLS encryption via HTTP Upgrade [RFC2817] and/or HTTP Over TLS (HTTPS) [RFC2818].

12.1.3 Using The Validate-Job Operation

A Client SHOULD use the Validate-Job IPP operation and the behavior recommendations enumerated in §8.2.1 to test whether the Printer requires authentication or encryption for Job submission.

12.1.4 Preferring The "ipps" URI Scheme

A Client SHOULD support the “ipps” URI scheme [RFC-IPPS].. A Client SHOULD prefer the “ipps” URI variant when available. A Client probing a Printer for the first time (§4.1.2 and §4.2) SHOULD first try using IPP overOVER HTTPS, and if the connection fails then try IPP over HTTP.

12.2 Server Security Considerations

In addition to the sections below, Client implementors should also pay attention to §7.2, §8.2.1 and §8.3.

Page 90 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

262263

1905

1906

19071908

1909

191019111912

191319141915

1916

19171918191919201921

1922

192319241925

1926

1927192819291930

1931

19321933

264

Page 91: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

12.2.1 HTTP/1.1 Expect Header

As discussed in §8.2, a Server MUST support the HTTP/1.1 Expect header and respond appropriately [RFC7230].

12.2.2 HTTP Upgrade

A Server SHOULD support HTTP Upgrade [RFC2817] to indicate to a Client the need to upgrade the connection to TLS.

12.2.3 Support For The "ipps" URI Scheme

A Printer SHOULD support the "ipps" URI scheme [RFC-IPPS].

If a Printer is configured to only support IPPS (or IPP over HTTPS), and a Client sends an IPP over HTTP request, the Printer MAY do one of the following:

a. Close the connection;

b. Return 301 Moved Permanently;

c. Return 400 Bad Request;

d. Return 426 Upgrade Required to upgrade the connection to TLS

There is no IPP response, just a HTTP response. HTTP requests for embedded web server or resources can be handled in the same way.

12.2.4 DNS Rebinding

Printers SHOULD validate the HTTP Host request header in order to protect against DNS rebinding attacks [PWG5100.14]. The Host header is discussed in §8.3.

13. References

13.1 Informative References

[IANAIPP] Internet Assigned Numbers Authority (IANA) Registries, "Internet Printing Protocol", http://www.iana.org/assignments/ipp-registrations/ http://www.iana.org/assignments/ipp-registrations/

[ISO10646] "Information technology -- Universal Coded Character Set (UCS)", ISO/IEC 10646:2011

[PAPI] A. Hlava, N. Jacobs, M. Sweet, "Open Standard Print API (PAPI)", July 2005, http://prdownloads.sourceforge.net/openprinting/PAPI-

Page 91 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

265266

1934

19351936

1937

19381939

1940

1941

19421943

1944

1945

1946

1947

19481949

1950

19511952

1953

1954

195519561957

19581959

19601961

267

Page 92: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

specification.pdf?download http://prdownloads.sourceforge.net/ openprinting/PAPI-specification.pdf?download

[PWG5100.1] M. Sweet, "IPP Finishings 2.0", PWG 5100.1-2014, December 2014, http://ftp.pwg.org/pub/pwg/candidates/cs-ippfinishings20-20141219-5100.1.pdf http://ftp.pwg.org/pub/pwg/candidates/cs-ippfinishings20- 20141219-5100.1.pdf

[PWG5100.3] K. Ocke, T. Hastings, "Internet Printing Protocol (IPP): Production Printing Attributes – Set1", PWG 5100.3-2001, February 2001, http://ftp.pwg.org/pub/pwg/candidates/cs-ippprodprint10-20010212-5100.3.pdf http://ftp.pwg.org/pub/pwg/candidates/cs-ippprodprint10- 20010212-5100.3.pdf

[PWG5100.5] D. Carney, T. Hastings, P. Zehler. “Internet Printing Protocol (IPP): Document Object”, PWG 5100.5-2003, October 2003, http://ftp.pwg.org/pub/pwg/candidates/cs-ippdocobject10-20031031-5100.5.pdf http://ftp.pwg.org/pub/pwg/candidates/cs-ippdocobject10- 20031031- 5100.5.pdf

[PWG5100.7] T. Hastings, P. Zehler, "Standard for The Internet Printing Protocol (IPP): Job Extensions", PWG 5100.7-2003, October 2003, http://ftp.pwg.org/pub/pwg/candidates/cs-ippjobext10-20031031-5100.7.pdf http://ftp.pwg.org/pub/pwg/candidates/cs-ippjobext10- 20031031-5100.7.pdf

[PWG5100.8] D. Carney, H. Lewis, "Internet Printing Protocol: '-actual' Attributes", PWG 5100.8-2003, March 2003, http://ftp.pwg.org/pub/pwg/candidates/cs-ippactuals10-20030313-5100.8.pdf http://ftp.pwg.org/pub/pwg/candidates/cs-ippactuals10- 20030313-5100.8.pdf

[PWG5100.9] I. McDonald, C. Whittle, "Internet Printing Protocol (IPP) Printer State Extensions v1.0", PWG 5100.9-2009, July 2009, http://ftp.pwg.org/pub/pwg/candidates/cs-ippstate10-20090731-5100.9.pdf http://ftp.pwg.org/pub/pwg/candidates/cs-ippstate10- 20090731-5100.9.pdf

[PWG5100.11] T. Hastings, D. Fullman, “IPP: Job and Printer Operations – Set 2”, PWG 5100.11-2010, October 2010, http://ftp.pwg.org/pub/pwg/candidates/cs-ippjobprinterext10-20101030-5100.11.pdf http://ftp.pwg.org/pub/pwg/candidates/cs- ippjobprinterext10- 20101030-5100.11.pdf

[PWG5100.12] R. Bergman, H. Lewis, I. McDonald, M. Sweet, "IPP/2.0 Second Edition", PWG 5100.12-2011, February 2011, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ipp20-20110214-

Page 92 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

268269

19621963

1964196519661967

19681969197019711972

19731974197519761977

19781979198019811982

19831984198519861987

19881989199019911992

19931994199519961997

199819992000

270

Page 93: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

5100.12.pdf ftp://ftp.pwg.org/pub/pwg/candidates/cs-ipp20-20110214- 5100.12.pdf

[PWG5100.13] M. Sweet, I. McDonald, P. Zehler, " IPP: Job and Printer Extensions – Set 3 (JPS3)", 5100.13-2012, July 2012, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ippjobprinterext3v10-20120727-5100.13.pdf ftp://ftp.pwg.org/pub/pwg/candidates/cs- ippjobprinterext3v10-20120727-5100.13.pdf

[PWG5100.14] M. Sweet, I. McDonald, A. Mitchell, J. Hutchings, "IPP Everywhere", 5100.14-2013, January 2013, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ippeve10-20130128-5100.14.pdf ftp://ftp.pwg.org/pub/pwg/ candidates/cs-ippeve10-20130128-5100.14.pdf

[PWG5100.15] M. Sweet, "IPP FaxOut Service", PWG 5100.15-2013, November 2013, http://ftp.pwg.org/pub/pwg/candidates/cs-ippfaxout10- 20131115-5100.15.pdf

[PWG5100.16] M. Sweet, “IPP Transaction-Based Printing Extensions”, PWG 5100.16-2013, November 2013, http://ftp.pwg.org/pub/pwg/candidates/cs-ipptrans10-20131108-5100.16.pdf http://ftp.pwg.org/pub/pwg/candidates/cs-ipptrans10- 20131108- 5100.16.pdf

[PWG5100.17] P. Zehler, M. Sweet, "IPP Scan Service (SCAN)", 5100.17-2014, September 2014, http://ftp.pwg.org/pub/pwg/candidates/cs-ippscan10-20140918-5100.17.pdf

[PWG5110.3] M. Sweet, "PWG Common Log Format", PWG 5110.3-2013, April, 2013, http://ftp.pwg.org/pub/pwg/candidates/cs-ids-log10-20130401.5110.3.pdf http://ftp.pwg.org/pub/pwg/candidates/cs-ids- log10-20130401.5110.3.pdf

[RFC2119] S. Bradner, “Key words for use in RFCs to Indicate Requirement Levels”, RFC 2119, March 1997, http://www.ietf.org/rfc/rfc2119.txt http://www.ietf.org/rfc/rfc2119.txt

[RFC2608] E. Guttman, C. Perkins, J. Veizades, M. Day, "Service Location Protocol, Version 2", RFC 2608, June 1999, http://www.ietf.org/rfc/rfc2608.txt

[RFC2817] R. Khare, S Lawrence, "Upgrading to TLS Within HTTP/1.1", RFC 2817, September 2000, http://www.ietf.org/rfc/rfc2817.txt http://www.ietf.org/rfc/rfc2817.txt

[RFC2818] E. Rescorla, “HTTP Over TLS”, RFC 2818, May 2000, http://www.ietf.org/rfc/rfc2818.txt http://www.ietf.org/rfc/rfc2818.txt

Page 93 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

271272

20012002

20032004200520062007

2008200920102011

201220132014

20152016201720182019

202020212022

2023202420252026

202720282029

203020312032

203320342035

20362037

273

Page 94: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

[RFC2910] R. Herriot, S. Butler, P. Moore, R. Tuner, J. Wenn, "Internet Printing Protocol/1.1: Encoding and Transport", RFC 2910, September 2000, http://www.ietf.org/rfc/rfc2910.txt http://www.ietf.org/rfc/rfc2910.txt

[RFC2911] R. deBry, T. Hastings, R. Herriot, S. Isaacson, P. Powell, "Internet Printing Protocol/1.1: Model and Semantics", RFC 2911, September 2000, http://www.ietf.org/rfc/rfc2911.txt http://www.ietf.org/rfc/rfc2911.txt

[RFC3196] T. Hastings, C. Manros, P. Zehler, C. Kugler, H. Holst, "Internet Printing Protocol/1.1: Implementer's Guide", RFC 3196, November 2001, http://www.ietf.org/rfc/rfc3196.txt http://www.ietf.org/rfc/rfc3196.txt

[RFC3380] T. Hastings, R. Herriot, C. Kugler, H. Lewis, "Internet Printing Protocol (IPP): Job and Printer Set Operations", RFC 3380, September 2002, http://www.ietf.org/rfc/rfc3381.txt http://www.ietf.org/rfc/rfc3381.txt

[RFC3381] T. Hastings, H. Lewis, R. Bergman, "Internet Printing Protocol (IPP): Job Progress Attributes", RFC 3381, September 2002, http://www.ietf.org/rfc/rfc3381.txt http://www.ietf.org/rfc/rfc3381.txt

[RFC3510] R. Herriot, I. McDonald, "Internet Printing Protocol/1.1 IPP URL Scheme", RFC 3510, April 2003, http://www.ietf.org/rfc/rfc3510.txt http://www.ietf.org/rfc/rfc3510.txt

[RFC3805] R. Bergman, H. Lewis, I. McDonald, "Printer MIB v2", RFC 3805, June 2004, http://www.ietf.org/rfc/rfc3805.txt http://www.ietf.org/rfc/rfc3805.txt

[RFC3806] R. Bergman, H. Lewis, I. McDonald, "Printer Finishing MIB", RFC 3806, June 2004, http://www.ietf.org/rfc/rfc3806.txt http://www.ietf.org/rfc/rfc3806.txt

[RFC3966] H. Schulzrinne, "The tel URI for Telephone Numbers", RFC 3966, December 2004, http://www.ietf.org/rfc/rfc3966.txt http://www.ietf.org/rfc/rfc3966.txt

[RFC3995] R. Herriot, T. Hastings, "Internet Printing Protocol (IPP): Event Notifications and Subscriptions", RFC 3995, March 2005, http://www.ietf.org/rfc/rfc3995.txt http://www.ietf.org/rfc/rfc3995.txt

[RFC3996] R. Herriot, T. Hastings, H. Lewis, "Internet Printing Protocol (IPP): The ’ippget’ Delivery Method for Event Notifications", RFC 3996, March 2005, http://www.ietf.org/rfc/rfc3996.txt http://www.ietf.org/rfc/rfc3996.txt

Page 94 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

274275

203820392040

2041204220432044

2045204620472048

204920502051

205220532054

205520562057

205820592060

206120622063

206420652066

206720682069

2070207120722073

276

Page 95: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

[RFC3997] R. Herriot, T. Hastings, "Internet Printing Protocol (IPP): Requirements for IPP Notifications", RFC 3997, March 2005, http://www.ietf.org/rfc/rfc3997.txt http://www.ietf.org/rfc/rfc3997.txt

[RFC4510] K. Zeilenga, Ed., "Lightweight Directory Access Protocol (LDAP): Technical Specification Road Map", RFC 4510, June 2006, http://www.ietf.org/rfc/rfc4510.txt

[RFC5198] J. Klensin, M. Padlipsky, " Unicode Format for Network Interchange" RFC 5198, March 2008, http://www.ietf.org/rfc/rfc5198.txt

[RFC6762] S. Cheshire, M. Krochmal, "Multicast DNS", RFC 6762, February 2013, http://www.ietf.org/rfc/rfc6762.txt http://www.ietf.org/rfc/rfc6762.txt

[RFC6763] S. Cheshire, M. Krochmal, "DNS-Based Service Discovery", RFC 6763, February 2013, http://www.ietf.org/rfc/rfc6763.txt http://www.ietf.org/rfc/rfc6763.txt

[RFC7230] R. Fielding, J. Reschke, "Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing", RFC 7230, June 2014, http://www.ietf.org/rfc/rfc7230.txt http://www.ietf.org/rfc/rfc7230.txt

[RFC7231] R. Fielding, J. Reschke, "Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content", RFC 7231, June 2014, http://www.ietf.org/rfc/rfc7231.txt http://www.ietf.org/rfc/rfc7231.txt

[RFC7232] R. Fielding, J. Reschke, "Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests", RFC 7232, June 2014, http://www.ietf.org/rfc/rfc7232.txt http://www.ietf.org/rfc/rfc7232.txt

[RFC7233] R. Fielding, Y. Lafon, J. Reschke, "Hypertext Transfer Protocol (HTTP/1.1): Range Requests", RFC 7233, June 2014, http://www.ietf.org/rfc/rfc7233.txt http://www.ietf.org/rfc/rfc7233.txt

[RFC7234] R. Fielding, M. Nottingham, J. Reschke, "Hypertext Transfer Protocol (HTTP/1.1): Caching", RFC 7234, June 2014, http://www.ietf.org/rfc/rfc7234.txt http://www.ietf.org/rfc/rfc7234.txt

[RFC7235] R. Fielding, J. Reschke, "Hypertext Transfer Protocol (HTTP/1.1): Authentication", RFC 7235, June 2014, http://www.ietf.org/rfc/rfc7235.txt http://www.ietf.org/rfc/rfc7235.txt

[RFC-IPPS] I. McDonald, M. Sweet, "IPP over HTTPS Transport Binding and 'ipps' URI Scheme", draft-mcdonald-ipps-uri-scheme-16.txt, November 2014, https://tools.ietf.org/id/draft-mcdonald-ipps-uri-scheme-16.txt https://tools.ietf.org/id/draft-mcdonald-ipps-uri-scheme-16.txt

Page 95 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

277278

207420752076

207720782079

20802081

208220832084

208520862087

208820892090

209120922093

209420952096

209720982099

210021012102

210321042105

2106210721082109

279

Page 96: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

[WSDiscovery-1.1] OASIS, "OASIS Web Services Dynamic Discovery (WS-Discovery) Version 1.1", July 2009, http://docs.oasis-open.org/ws- dd/discovery/1.1/os/wsdd-discovery-1.1-spec-os.html http://docs.oasis- open.org/ws- dd/discovery/1.1/os/wsdd-discovery-1.1-spec-os.html

14. Annex A: HTTP/2.0There is an effort to create a new major revision to HTTP, which for now is being called HTTP/2.0. It brings a number of new facilities to HTTP, many of which could be very useful to IPP. The IEEE ISTO PWG IPP Working Group will produce a binding document for IPP over HTTP/2.0 when HTTP/2.0 is ratified and published. No formal binding for IPP over HTTP/2.0 is currently defined.

15. Authors' AddressesPrimary author:

Smith KennedyHewlett-Packard Co.11311 Chinden Blvd. MS 506Boise, ID [email protected]

The author would like to thank the following individuals for their contributions:

Ezra Brooks - Kentucky State Board of Recreation

16. Change History

16.1 February 5, 2013

Initial revision.

16.2 March 20, 2013

Resolved issues from feedback provided during the IPP conference call on February 25, 2013, as documented in teleconference meeting minutes and author's own notes.

1. Added Validate-Job operation as operation to be used during printer selection process to validate access by Client / user

Page 96 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

280281

2110211121122113

2114

2115

21162117211821192120

2121

2122

21232124212521262127

2128

21292130

2131

2132

2133

2134

21352136

21372138

282

Page 97: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

2. Replaced previous Section 5 "Conformance Requirements" with new Section 5 "Attributes and Their Use in Operations"

3. Replaced previous Section 6 "Internationalization Considerations" with new Section 6 "HTTP Protocol Usage"

4. Added updated list of references

16.3 May 13, 2013

Resolved remaining issues from February 25, 2013 teleconference meeting notes and other feedback received since then.

1. Added PWG 5100.8, 5100.13 and WS-Discovery references; removed boilerplate [REFERENCE] reference entry; fixed references for 5100.14.

2. Updated with meeting notes fixes from April 8, including updated notation for comments (now in italic), revised notation for indicating iterative looping and parallel execution, and many other changes to section 4. Also changed document naming convention and moved URL where it is to be located on PWG FTP site.

16.4 July 19, 2013

Updated with feedback and discussions from the May 2013 F2F in Cupertino, and other piecemeal feedback.

1. Changed title to "IPP/2.0 Implementer's Guide

2. Changed Abstract to "Updates and extends RFC 3196 for IPP/2.0."

3. Renamed to follow the wd-ippig20-yyyymmdd.docx/pdf naming convention given the title change.

4. Made a PWG Working Draft, not a best practice

5. Added normative reference to RFC 3196.

16.5 September 22, 2013

Updated with feedback from reflector discussions and conference calls. This is a "new baseline", and much more work is needed to fill in TBD sections.

1. Substantially elaborated section 5.5.

2. Updated comments about using xxx-actual in detecting whether the printer uses the requested / recommended attribute values (more discussion needed)

Page 97 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

283284

21392140

21412142

2143

2144

21452146

21472148

2149215021512152

2153

21542155

2156

2157

21582159

2160

2161

2162

21632164

2165

21662167

285

Page 98: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

3. Editorial changes (fixed "Implementors" to be "Implementer's", renamed some section titles

16.6 October 2, 2013

1. Changed the title to "IPP Implementor's Guide v2.0" (in part reverting change #3 from 2013-09-23) and the abstract to make it clear this applies to all IPP versions, not just IPP/2.0.

2. Expanded §5.8 to enumerate the attributes used in evaluating printer capabilities and how to properly use them or handle the cases where they are absent and assumed to be not supported. This is mostly a set of placeholders at this point.

3. Updated §5.6 to clarify guidance on "multiple-document-handling" vs. "sheet-collate".

4. Updated §4.2 to include a placeholder statement to make note that a Client should maintain a sense of user identity between 4.2 and 4.3 to ensure that the capabilities evaluated are really those that the user has access to use and more importantly that none are missing.

5. Comments in section 4.5 to catch all the places where using "xxx-actual" to recognize substitutions before the Job has been processed is suggested, because this seems to be a problematic suggestion.

16.7 January 3, 2014

Updated with review feedback from October 2013 face-to-face and December 16 conference call minutes notes. This is a "new baseline". More work is still needed to fill in TBD sections.

1. Addressed scenario where Create-Job created the Job but Send-Document fails (triggered by query from vendor: what to do when “document-format” is unsupported?)

2. Added new proposed operation for filtering features for a given user (JPS4?)

3. Moved discussion of xxx-actual use to its own section (currently section 11.1)

4. Expanded discussion of Send-URI / document-by-reference and recommended generally against it

5. Added new section 9 for covering IPP Notifications

6. Other changes not described in detail (consult -rev document for specifics).

Page 98 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

286287

21682169

2170

217121722173

217421752176

21772178

2179218021812182

218321842185

2186

218721882189

219021912192

2193

2194

21952196

2197

2198

288

Page 99: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

16.8 January 24, 2014

Updated with review feedback from the 2014-01-13 conference call.

1. Refactored section 9 to other locations as per meeting review.

2. Moved section 10 content to section 6 and deleted section 10 as per meeting review.

3. Updated some portions of the “Security” section (what is in this revision labeled section 9) with references back to the HTTP section and also using notes and replies from the reflector.

16.9 April 10, 2014

Updated with review feedback from the February 2014 PWG Face-to-Face and many updates and document structure changes, to resolve all instances of "TBD" in the document. First Prototype draft.

1. Replaced all instances of TBD with their appropriate descriptions. This includes the examination of many attributes in section 5.

2. Rewrote several significant sections of section 4.

3. Added new section on document type considerations, discussing the proper use of “application/octet-stream”, and the difference between media types that are “streaming” and have historically been used as PDLs, as compared with other media types that are more structured.

4. Added conformance requirements but haven't filled it out with a detailed list yet.

5. Listed additional references to RFC 3380, 3995-3997.

6. Many other changes.

16.10 May 13, 2014

Updated start of section 5.8 to include a table of the attributes to be discussed in the subsections of 5.8, right before the May 2014 Face-to-Face. No other significant changes.

16.11 August 14, 2014

Updated with review feedback from August 2014 PWG Face-to-Face meeting review of Section 7 and start of Section 8. Earlier sections include incomplete updates that should be disregarded by the reader.

Page 99 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

289290

2199

2200

2201

22022203

220422052206

2207

220822092210

22112212

2213

2214221522162217

2218

2219

2220

2221

222222232224

2225

222622272228

291

Page 100: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

16.12 November 13, 2014

Updated with review feedback from May 2014 PWG Face-to-Face and subsequent conference calls.

1. Replaced all instances of TBD with their appropriate descriptions. This includes the examination of many attributes in section 5.

2. Rewrote several significant sections of section 4. Contemplating a shift to UML sequence diagrams for section 4.

3. Added new section on document type considerations, discussing the proper use of “application/octet-stream”, and the difference between media types that are “streaming” and have historically been used as PDLs, as compared with other media types that are more structured.

4. Added conformance requirements but haven't filled it out with a detailed list yet.

5. Listed additional references to many RFCs and PWG specifications now referenced by this document

6. Reviewed all meeting minutes since May 2014 and made sure that all points were at least considered if not addressed. Open issues (whether new or dating from earlier) marked with comments for future discussion.

7. Additional IPPS interoperability considerations.

16.13 January 27, 2015

Updated with review feedback on wd-ig-20141113-rev.pdf in several conference calls.

1. Updated section 4 with UML sequence diagrams, generated using PlantUML and the sources added in the new Section 16, to replace the bulleted lists, which were becoming unwieldy.

2. Resolved issues as per feedback from 2014-12-08 conference call meeting minutes

3. Resolved issues as per feedback from 2015-01-05 conference call meeting minutes

16.14 February 11, 2015

Updated following February 2015 F2F review - anticipating this revision will be WG last call.

1. Reviewed the rest of the document starting with §10

Page 100 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

292293

2229

22302231

22322233

22342235

2236223722382239

2240

22412242

224322442245

2246

2247

2248

224922502251

2252

2253

2254

22552256

2257

294

Page 101: ftp.pwg.org · Web viewThe IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation

Working Draft – IPP Implementor's Guide v2.0 (IG) May 16, 2023

a. Re-ordered some of the later sections to more closely resemble the current template

[b.] Added reference to IANA PWG Registry"Internet Printing Protocol (IPP) Registrations" Registry and others

2. Resolved all "open question" comments

a. Merged two "BEST" options from §4.4

b. Updated §5.9 to call out the impracticality of implementing "pdl-override-supported" = 'guaranteed' for all but the simplest document formats

c. Decided that if IPPS is enabled but IPP is not then the Printer should use HTTP redirection and NOT mandate that the Printer implement any "basic set" of IPP

3. Resolved all feedback recorded in meeting minutes from February 4 review at the 2015 February PWG F2F (see ippv2-concall-minutes-20150105.pdf)

[16.15] AddedMarch 3, 2015

Updated following 2015-03-02 conference call review. Anticipating this will be the revision in IPP WG Last Call.

1. Fixed copyright date range to be 2012-2015 in all copyright locations

2. Moved statement about normative language use in the spec ("No MUSTs; only SHOULDs") to section 2.1 "Conformance Terminology"

3. Modified UML "Best" option diagram in section 4.4 to move notes to the left, which reduced the image width and allowed the text to be rendered larger than before, increasing legibility

4. Removed all mention of IPP Scan Service or IPP FaxOut - saving that for a later revision

5. Fixed content in section 5.5

6. Fixed missing references, checked and fixed most (if not all) cross references to be bookmarks, re-checked grammar and spellingthe reference table entries in section 13

Page 101 of 101 Copyright © 2012-2015 The Printer Working Group. All rights reserved.

295296

22582259

22602261

2262

2263

22642265

226622672268

22692270

2271

22722273

2274

22752276

227722782279

22802281

2282

228322842285

2286

297