IPP> RES - IPP Resource and Get Resource operations - 7 July 2000

IPP> RES - IPP Resource and Get Resource operations - 7 July 2000

IPP> RES - IPP Resource and Get Resource operations - 7 July 2000

McDonald, Ira imcdonald at sharplabs.com
Fri Jul 7 21:33:23 EDT 2000


Copies: IPP WG <ipp at pwg.org>

Hi folks,                                           Friday (7 July 2000)

I've just posted 'IPP Resource Objects and Get Resource Operations' to
the PWG server at 'ftp://ftp.pwg.org/pub/pwg/ipp/new_RES/' (note new
subdirectory) in the files:
    
    draft-ietf-ipp-get-resource-00.txt - flat text IETF style

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


This document specifies the IPP Resource object class, the Driver
Resource object subclass, and three Resource get operations:

1)  Get-Resource-Attributes
    - reads Resource object instance attributes
    - via "printer-uri", "resource-type", and "resource-[id|name]"
    - similar to 'Get-Job-Attributes'
    - supports user-friendly "resource-name" (locally unique)

2)  Get-Resource-Data
    - reads Resource object instance attributes and data (if any)
    - via "printer-uri", "resource-type", and "resource-[id|name]"
    - superset of 'Get-Resource-Attributes' (compare w/ 'Print-Job')
    - separate operation for copyright materials access control

3)  Get-Resources
    - reads many Resource object instances (but not their data)
    - via "printer-uri" and "resource-type"
    - superset of 'Get-Resource-Attributes'
    - filters via 0-n Resource Attribute groups in operation request


This document is complete and self-contained and supports 'driver
download' functionality.  It is intended to advance for standardization
immediately.

Cheers,
- Ira McDonald
  High North Inc

----------

PS - Future documents may specify a set of Resource system admin
operations and/or other Resource types, for example:

- Create-Resource operation (passing data by reference or value)
- Delete-Resource operation (removes Resource and any Resource data)
- Refresh-Resource operation (caches a local copy of Resource data)
- Renew-Resource operation (renews lease of Resource object instance)

- 'font' resource type
- 'form' resource type
- 'image' resource type
- 'logo' resource type
- 'media' resource type (media description attributes)

----------------------------------------------------------------------
[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.  Get-Resource-Attributes Operation ......................       7
    4.1.1.  Get-Resource-Attributes Request ....................       8
    4.1.2.  Get-Resource-Attributes Response ...................       9
  4.2.  Get-Resource-Data Operation ............................      10
    4.2.1.  Get-Resource-Data Request ..........................      10
    4.2.2.  Get-Resource-Data Response .........................      10
  4.3.  Get-Resources Operation ................................      11
    4.3.1.  Get-Resources Request ..............................      11
    4.3.2.  Get-Resources Response .............................      12
  4.4.  Resource Operation Response Status Codes ...............      13
5.  Resource Attributes ........................................      14
  5.1.  Table of Required Resource Attributes ..................      14
  5.2.  Table of Optional Resource Attributes ..................      15
  5.3.  Resource Template Attributes ...........................      16
    5.3.1.  resource-info (text(127)) ..........................      16
    5.3.2.  resource-charset (charset) .........................      16
    5.3.3.  resource-natural-language (naturalLanguage) ........      16
    5.3.4.  resource-document-formats (1setOf mimeMediaType) ...      17
    5.3.5.  resource-os-types (1setOf type2 keyword) ...........      17
    5.3.6.  resource-data-present (boolean) ....................      17
    5.3.7.  resource-data-uri (1setOf uri) .....................      18
    5.3.8.  resource-data-k-octets (integer(0:MAX)) ............      18
    5.3.9.  resource-data-compression (type3 keyword) ..........      18
    5.3.10.  resource-create-date-time (dateTime) ..............      19
    5.3.11.  resource-duration (integer(0:MAX)) ................      19
    5.3.12.  resource-persistence (boolean) ....................      19
  5.4.  Resource Description Attributes ........................      20
    5.4.1.  resource-type (type2 keyword) ......................      20
    5.4.2.  resource-name (name(127)) ..........................      20
    5.4.3.  resource-id (integer(1:MAX)) .......................      20
    5.4.4.  resource-printer-uri (uri) .........................      21
    5.4.5.  resource-create-user-name (name(MAX)) ..............      21
    5.4.6.  resource-create-time (integer(0:MAX)) ..............      21
    5.4.7.  resource-change-time (integer(0:MAX)) ..............      22
    5.4.8.  resource-refresh-time (integer(0:MAX)) .............      22
    5.4.9.  resource-expiration-time (integer(0:MAX)) ..........      22
6.  Driver Resource Type .......................................      23
  6.1.  Table of Required Driver Resource Attributes ...........      23
  6.2.  Table of Optional Driver Resource Attributes ...........      23
  6.3.  Driver Resource Template Attributes ....................      24
    6.3.1.  driver-charset (1setOf charset) ....................      24
    6.3.2.  driver-natural-language (1setOf naturalLanguage) ...      24
    6.3.3.  driver-file-type (type2 keyword) ...................      24
    6.3.4.  driver-file-name (name(MAX)) .......................      25
7.  Conformance Requirements ...................................      26
  7.1.  IPP Client Conformance Requirements ....................      26
  7.2.  IPP Printer Conformance Requirements ...................      26
    7.2.1.  Resource Operations ................................      26
    7.2.2.  Resource Attributes ................................      27
    7.2.3.  Driver Resource Attributes .........................      27
8.  IANA Considerations ........................................      28
9.  Internationalization Considerations ........................      28
10.  Security Considerations ...................................      28
11.  Encodings of Additional Resource Tags .....................      28
12.  References ................................................      28
13.  Authors' Addresses ........................................      29
14.  Appendix A - Change History ...............................      30
  14.1.  7 July 2000 - draft-ietf-ipp-get-resource-00.txt ......      30
15.  Full Copyright Statement ..................................      30

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



More information about the Ipp mailing list