Internet Printing Protocol (IPP): Event Notifications and Subscriptions
RFC 3995

• Status
• IESG evaluation record
• IESG writeups
• Email expansions
• History

• Versions
• 12

Network Working Group                                         R. Herriot
Request for Comments: 3995                     Global Workflow Solutions
Category: Standards Track                                    T. Hastings
Updates: 2911, 2910                                    Xerox Corporation
                                                              March 2005

                   Internet Printing Protocol (IPP):
                 Event Notifications and Subscriptions

Status of This Memo

   This document specifies an Internet standards track protocol for the
   Internet community, and requests discussion and suggestions for
   improvements.  Please refer to the current edition of the "Internet
   Official Protocol Standards" (STD 1) for the standardization state
   and status of this protocol.  Distribution of this memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (2005).

Abstract

   This document describes an OPTIONAL extension to the Internet
   Printing Protocol/1.1: Model and Semantics (RFC 2911, RFC 2910).
   This extension allows a client to subscribe to printing related
   Events.  Subscriptions are modeled as Subscription Objects.  The
   Subscription Object specifies that when one of the specified Events
   occurs, the Printer delivers an asynchronous Event Notification to
   the specified Notification Recipient via the specified Push or Pull
   Delivery Method (i.e., protocol).

   A client associates Subscription Objects with a particular Job by
   performing the Create-Job-Subscriptions operation or by submitting a
   Job with subscription information.  A client associates Subscription
   Objects with the Printer by performing a Create-Printer-Subscriptions
   operation.  Four other operations are defined for Subscription
   Objects: Get-Subscriptions-Attributes, Get-Subscriptions, Renew-
   Subscription, and Cancel-Subscription.

Herriot & Hastings          Standards Track                     [Page 1]
RFC 3995       IPP: Event Notifications and Subscriptions     March 2005

Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  5
       1.1.  Notification Overview. . . . . . . . . . . . . . . . . .  5
   2.  Models for Notification. . . . . . . . . . . . . . . . . . . .  8
       2.1.  Model for Simple Notification (Normative). . . . . . . .  8
       2.2.  Additional Models for Notification (Informative) . . . .  9
   3.  Terminology. . . . . . . . . . . . . . . . . . . . . . . . . .  9
       3.1.  Conformance Terminology. . . . . . . . . . . . . . . . .  9
       3.2.  Other Terminology. . . . . . . . . . . . . . . . . . . . 10
   4.  Object Relationships . . . . . . . . . . . . . . . . . . . . . 12
       4.1.  Printer and Per-Printer Subscription Objects . . . . . . 13
       4.2.  Printer, Job and Per-Job Subscription Objects. . . . . . 13
   5.  Subscription Object. . . . . . . . . . . . . . . . . . . . . . 13
       5.1.  Rules for Support of Subscription Template Attributes. . 14
       5.2.  Rules for Processing Subscription Template Attributes. . 15
       5.3.  Subscription Template Attributes . . . . . . . . . . . . 18
             5.3.1.  notify-recipient-uri (uri) . . . . . . . . . . . 20
             5.3.2.  notify-pull-method (type2 keyword) . . . . . . . 21
             5.3.3.  notify-events (1setOf type2 keyword) . . . . . . 22
             5.3.4.  notify-attributes (1setOf type2 keyword) . . . . 29
             5.3.5.  notify-user-data (octetString(63)) . . . . . . . 30
             5.3.6.  notify-charset (charset) . . . . . . . . . . . . 31
             5.3.7.  notify-natural-language (naturalLanguage). . . . 31
             5.3.8.  notify-lease-duration (integer(0:67108863)). . . 32
             5.3.9.  notify-time-interval (integer(0:MAX)). . . . . . 33
       5.4.  Subscription Description Attributes. . . . . . . . . . . 34
             5.4.1.  notify-subscription-id  (integer (1:MAX)). . . . 35
             5.4.2.  notify-sequence-number (integer (0:MAX)) . . . . 35
             5.4.3.  notify-lease-expiration-time (integer(0:MAX)). . 36
             5.4.4.  notify-printer-up-time (integer(1:MAX)). . . . . 37
             5.4.5.  notify-printer-uri (uri) . . . . . . . . . . . . 37
             5.4.6.  notify-job-id (integer(1:MAX)) . . . . . . . . . 37
             5.4.7.  notify-subscriber-user-name (name(MAX)). . . . . 38
   6.  Printer Description Attributes Related to Notification . . . . 38
       6.1.  printer-state-change-time (integer(1:MAX)) . . . . . . . 39
       6.2.  printer-state-change-date-time (dateTime). . . . . . . . 39
   7.  New Values for Existing Printer Description Attributes . . . . 39
       7.1.  operations-supported (1setOf type2 enum) . . . . . . . . 40
   8.  Attributes Only in Event Notifications . . . . . . . . . . . . 40
       8.1.  notify-subscribed-event (type2 keyword). . . . . . . . . 40
       8.2.  notify-text (text(MAX)). . . . . . . . . . . . . . . . . 41