IPP> RES - Released draft-ietf-ipp-get-resource-01.txt (Sept 2000)

Thu Sep 7 14:52:22 EDT 2000

Copies: IPP WG <ipp at pwg.org>

Hi folks,                                    Thursday (7 September 2000)

I've just sent a first revision of 'IPP Resource Objects' to the
Internet-Drafts editor and Tom Hastings posted a copy on the PWG server
in the directory:

    ftp://ftp.pwg.org/pub/pwg/ipp/new_RES/

in the files:

    draft-ietf-ipp-get-resource-01.txt - flat text IETF style

    draft-ietf-ipp-get-resource-01.pdf - line numbered PDF of text

This document specifies the IPP Resource object class, three REQUIRED
Resource query (Get) operations, and four OPTIONAL Resource admin
operations.  This document does NOT specify a 'driver' Resource type.

Cheers,
- Ira McDonald
  High North Inc

----------------------------------------------------------------------

Copies: "Internet Drafts Editor" <internet-drafts at ietf.org>
        "Tom Hastings" <hastings at cp10.es.xerox.com>
        "Ira McDonald" <imcdonald at sharplabs.com>

I-D Editor,                                  Thursday (7 September 2000)

IPP:

Please place this document in the Internet-Drafts repository as:

<draft-ietf-ipp-get-resource-01.txt> (September 2000)

It replaces the previous:

<draft-ietf-ipp-get-resource-00.txt> (July 2000)

Thanks very much,
- Ira McDonald (IPP WG member)
  High North Inc
  imcdonald at sharplabs.com

----------------------------------------------------------------------
[Table of Contents from the document]

1.  Introduction ...............................................       4
2.  IPP Model for Resources ....................................       5
  2.1.  Resource Object ........................................       5
3.  Terminology ................................................       6
  3.1.  Conformance Terminology ................................       6
  3.2.  Model Terminology ......................................       6
4.  Resource Operations ........................................       7
  4.1.  Resource Query Package - REQUIRED ......................       7
    4.1.1.  Get-Resource-Attributes Operation ..................       7
      4.1.1.1.  Get-Resource-Attributes Request ................       8
      4.1.1.2.  Get-Resource-Attributes Response ...............       9
    4.1.2.  Get-Resource-Data Operation ........................      10
      4.1.2.1.  Get-Resource-Data Request ......................      10
      4.1.2.2.  Get-Resource-Data Response .....................      11
    4.1.3.  Get-Resources Operation ............................      11
      4.1.3.1.  Get-Resources Request ..........................      12
      4.1.3.2.  Get-Resources Response .........................      13
  4.2.  Resource Admin Package - OPTIONAL ......................      14
    4.2.1.  Create-Resource Operation ..........................      14
      4.2.1.1.  Create-Resource Request ........................      14
      4.2.1.2.  Create-Resource Response .......................      16
    4.2.2.  Delete-Resource Operation ..........................      17
      4.2.2.1.  Delete-Resource Request ........................      17
      4.2.2.2.  Delete-Resource Response .......................      18
    4.2.3.  Refresh-Resource Operation .........................      18
      4.2.3.1.  Refresh-Resource Request .......................      19
      4.2.3.2.  Refresh-Resource Response ......................      19
    4.2.4.  Renew-Resource Operation ...........................      20
      4.2.4.1.  Renew-Resource Request .........................      20
      4.2.4.2.  Renew-Resource Response ........................      21
  4.3.  Printer Operation Extensions - REQUIRED ................      21
    4.3.1.  Get-Printer-Attributes Operation ...................      21
  4.4.  Resource Operation Response Status Codes ...............      22
5.  Resource Attributes ........................................      23
  5.1.  Table of Resource Template Attributes ..................      23
  5.2.  Table of Resource Description Attributes ...............      24
  5.3.  Resource Template Attributes ...........................      24
    5.3.1.  resource-charset (charset) .........................      24
    5.3.2.  resource-natural-language (naturalLanguage) ........      25
    5.3.3.  resource-info (text(127)) ..........................      25
    5.3.4.  resource-document-formats (1setOf mimeMediaType) ...      25
    5.3.5.  resource-create-date-time (dateTime) ...............      25
    5.3.6.  resource-lease-duration (integer(0:MAX)) ...........      26
    5.3.7.  resource-data-present (boolean) ....................      26
    5.3.8.  resource-data-uri (1setOf uri) .....................      27
    5.3.9.  resource-data-k-octets (integer(0:MAX)) ............      27
    5.3.10.  resource-data-compression (type3 keyword) .........      28
  5.4.  Resource Description Attributes ........................      28
    5.4.1.  resource-type (type2 keyword) ......................      28
    5.4.2.  resource-name (name(127)) ..........................      28
    5.4.3.  resource-id (integer(1:MAX)) .......................      29
    5.4.4.  resource-printer-uri (uri) .........................      29
    5.4.5.  resource-create-user-name (name(MAX)) ..............      30
    5.4.6.  resource-create-time (integer(0:MAX)) ..............      30
    5.4.7.  resource-expiration-time (integer(0:MAX)) ..........      30
  5.5.  Job Template Attributes for Resources ..................      31
    5.5.1.  restype (name (127)) ...............................      31
    5.5.2.  restype-required (1setOf name(127)) ................      31
6.  Rules for Resource Type Definitions ........................      32
  6.1.  Do NOT define new operations for Resource ..............      32
  6.2.  Define new type keyword for Resource ...................      32
  6.3.  Define new type-specific attributes for Resource .......      32
  6.4.  Define new Printer attributes for Resource .............      32
  6.5.  Define new Job attributes for Resource .................      32
  6.6.  Define Printer operation extensions for Resource .......      33
7.  Conformance Requirements ...................................      34
  7.1.  IPP Client Conformance Requirements ....................      34
  7.2.  IPP Printer Conformance Requirements ...................      34
    7.2.1.  Resource Operations ................................      34
    7.2.2.  Resource Attributes ................................      35
8.  IANA Considerations ........................................      36
9.  Internationalization Considerations ........................      36
10.  Security Considerations ...................................      36
11.  Encodings of Additional Protocol Tags .....................      36
  11.1.  Encodings of Additional Attribute Tags ................      36
  11.2.  Encodings of Additional Operation Tags ................      36
12.  References ................................................      37
13.  Authors' Addresses ........................................      37
14.  Appendix A - Change History ...............................      38
15.  Full Copyright Statement ..................................      38

----------------------------------------------------------------------