IPP Mail Archive: IPP> RES - Released draft-ietf-ipp-get-res

IPP Mail Archive: IPP> RES - Released draft-ietf-ipp-get-res

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

From: McDonald, Ira (imcdonald@sharplabs.com)
Date: Thu Sep 07 2000 - 14:52:22 EDT

  • Next message: McDonald, Ira: "RE: IPP> RES - Updated Resource [bad dates in filenames]"

    Copies: IPP WG <ipp@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@ietf.org>
            "Tom Hastings" <hastings@cp10.es.xerox.com>
            "Ira McDonald" <imcdonald@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@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

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



    This archive was generated by hypermail 2b29 : Thu Sep 07 2000 - 15:01:37 EDT