home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_i / draft-ietf-ipp-dir-schema-01.txt < prev    next >
Text File  |  1997-06-24  |  17KB  |  455 lines
  1.  
  2.  
  3.  
  4.        INTERNET-DRAFT
  5.                                                                    K. Carter
  6.                                                                          IBM
  7.                                                                  S. Isaacson
  8.                                                                 Novell, Inc.
  9.                                                                June 12, 1997
  10.  
  11.  
  12.  
  13.  
  14.                  Internet Printing Protocol/1.0: Directory Schema
  15.                          draft-ietf-ipp-dir-schema-01.txt
  16.  
  17.  
  18.  
  19.        Status of this Memo
  20.  
  21.        This document is an Internet-Draft.  Internet-Drafts are working
  22.        documents of the Internet Engineering Task Force (IETF), its areas,
  23.        and its working groups.  Note that other groups may also distribute
  24.        working documents as Internet-Drafts.
  25.  
  26.        Internet-Drafts are draft documents valid for a maximum of six months
  27.        and may be updated, replaced, or obsoleted by other documents at any
  28.        time.  It is inappropriate to use Internet-Drafts as reference
  29.        material or to cite them other than as "work in progress."
  30.  
  31.        To learn the current status of any Internet-Draft, please check the
  32.        "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow
  33.        Directories on ftp.is.co.za (Africa), nic.nordu.net (Europe),
  34.        munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or
  35.        ftp.isi.edu (US West Coast).
  36.  
  37.        Abstract
  38.  
  39.        This document is one of a set of documents which together describe
  40.        all aspects of a new Internet Printing Protocol (IPP). IPP is an
  41.        application level protocol that can be used for distributed printing
  42.        using Internet tools and technology. The protocol is heavily
  43.        influenced by the printing model introduced in the Document Printing
  44.        Application (ISO/IEC 10175 DPA) standard.  Although DPA specifies
  45.        both end user and administrative features, IPP version 1.0 is focused
  46.        on end user functionality.  Although DPA specifies both end user and
  47.        administrative features, IPP version 1.0 is focused only on end user
  48.        functionality.
  49.  
  50.        The full set of IPP documents includes:
  51.  
  52.  
  53.        Carter, Isaacson                                    [Page 1]
  54.                  June 12, 1997, Expires December 12, 1997
  55.  
  56.  
  57.  
  58.        INTERNET-DRAFT   IPP/1.0: Directory Schema     June 12, 1997
  59.  
  60.  
  61.          Internet Printing Protocol : Requirements
  62.          Internet Printing Protocol/1.0: Model and Semantics
  63.          Internet Printing Protocol/1.0: Security
  64.          Internet Printing Protocol/1.0: Protocol Specification
  65.          Internet Printing Protocol/1.0: Directory Schema
  66.  
  67.  
  68.        The requirements document takes a broad look at distributed printing
  69.        functionality, and it enumerates real-life scenarios that help to
  70.        clarify the features that need to be included in a printing protocol
  71.        for the Internet.  It identifies requirements for three types of
  72.        users: end users, operators, and administrators.  The requirements
  73.        document calls out a subset of end user requirements that must be
  74.        satisfied in the first version of IPP.  Operator and administrator
  75.        requirements are out of scope for v1.0. The model and semantics
  76.        document describes a simplified model with abstract objects, their
  77.        attributes, and their operations.  The security document covers
  78.        potential threats and proposed counters to those threats.  The
  79.        protocol specification incorporates the ideas in all the other
  80.        documents into a concrete mapping using clearly defined data
  81.        representations and transport protocol mappings that real
  82.        implementers can use to develop interoperable client and server side
  83.        components. Finally, the directory schema document shows a generic
  84.        schema for directory service entries that represent instances of IPP
  85.        Printers.
  86.  
  87.        This document is the "Internet Printing Protocol/1.0: Directory
  88.        Schema" document.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.        Carter, Isaacson                                    [Page 2]
  111.                  June 12, 1997, Expires December 12, 1997
  112.  
  113.  
  114.  
  115.        INTERNET-DRAFT   IPP/1.0: Directory Schema     June 12, 1997
  116.  
  117.  
  118.                                  Table of Contents
  119.  
  120.        1.  Introduction ..........................................4
  121.        2.  Directory Entry Schema ................................5
  122.        2.1   printer-URI (uri, MANDATORY) ........................5
  123.        2.2   printer-name (name, MANDATORY) ......................5
  124.        2.3   printer-location (text) .............................5
  125.        2.4   printer-description (text) ..........................6
  126.        2.5   printer-more-info-site (uri) ........................6
  127.        2.6   printer-make-and-model (text) .......................6
  128.        2.7   printer-more-info-manf (uri) ........................6
  129.        2.8   media-supported (1setOftype4 keyword) ...............6
  130.        2.9   number-up-supported (1setOftype3 keyword) ...........6
  131.        2.10  sides-supported (1setOftype2 keyword) ...............7
  132.        2.11  printer-resolution-supported (1setOftype2 keyword) ..7
  133.        2.12  maximum-printer-speed-supported (integerUnits) ......7
  134.        2.13  print-quality-supported (1setOftype2 keyword) .......7
  135.        2.14  color-supported (boolean) ...........................7
  136.        2.15  finishings-supported (setOftype2 keyword) ...........7
  137.        2.16  document-formats-supported (1setOftype2 keyword) ....7
  138.        2.17  printer-locales-supported
  139.              (1setOflocale keyword, MANDATORY) ...................7
  140.        3.  Security Considerations ...............................7
  141.        4.  References ............................................8
  142.        5.  Author's Address ......................................8
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.        Carter, Isaacson                                    [Page 3]
  168.                  June 12, 1997, Expires December 12, 1997
  169.  
  170.  
  171.  
  172.        INTERNET-DRAFT   IPP/1.0: Directory Schema     June 12, 1997
  173.  
  174.  
  175.        1. Introduction
  176.  
  177.        A Directory Service is a means by which service users can locate
  178.        service providers.  The directory contains entries for each type of
  179.        object within the system:  entries for users, file systems, servers,
  180.        applications, printers, other devices, etc.  End users use a
  181.        Directory Service to locate objects based on naming and
  182.        organizational contexts.  For example, find all servers in the "Local
  183.        Department" context.  Authentication and authorization are also often
  184.        part of a directory service.  Users are only allowed to find objects
  185.        to which they have certain access rights.  Each service provider
  186.        registers with the directory (either automatically or with the help
  187.        of an administrator) as an entry of a certain type.  For example, an
  188.        IPP Printer can be registered in the directory as a Printer object
  189.        with certain registration attributes (name, address, static
  190.        characteristics, etc.).  Given a Directory Service provides this type
  191.        of interaction for both service providers and service users, it is
  192.        possible for end users to locate an IPP Printer using either a simple
  193.        name lookup or a filtered attribute search.
  194.  
  195.        After an end user locates one or more IPP Printers, the end user
  196.        selects a Printer.  Certain attributes in the directory entry for a
  197.        Printer provide additional information to the end user, such as the
  198.        cost to print jobs on this Printer, that assist the end user in
  199.        selecting a Printer.
  200.  
  201.        After an end user selects an IPP Printer, the end user performs an
  202.        IPP print operation on that Printer.  IPP provides the protocol that
  203.        communicates this print operation to the IPP Printer in the network.
  204.        An IPP client addresses an IPP Printer using a URI.  This URI is a
  205.        required attribute in the directory entry for an IPP Printer.  Thus,
  206.        the Printer's URI _links_ the directory entry for an IPP Printer to
  207.        the corresponding IPP Printer in the network.
  208.  
  209.        IPP does not require any specific Directory Service provider.
  210.        However, this specification does define a generic schema that can be
  211.        used to implement directory entries for Printers using a specific
  212.        Directory Service.
  213.  
  214.        Section 2 introduces the generic schema for entries in a directory
  215.        that represent IPP Printer objects.
  216.  
  217.        Sections 3-5 cover security, technical references, and author contact
  218.        information.
  219.  
  220.  
  221.  
  222.  
  223.  
  224.        Carter, Isaacson                                    [Page 4]
  225.                  June 12, 1997, Expires December 12, 1997
  226.  
  227.  
  228.  
  229.        INTERNET-DRAFT   IPP/1.0: Directory Schema     June 12, 1997
  230.  
  231.  
  232.        2. Directory Entry Schema
  233.  
  234.        The following attributes define the generic directory entry schema
  235.        for an IPP Printer.  The conformance terminology, the syntax
  236.        definitions of the attributes and the values of the attributes are
  237.        defined in the _Internet Printing Protocol/1.0 Model and Semantics_
  238.        document and are not repeated in this document.  The attribute
  239.        definitions in this schema match the corresponding attribute
  240.        definitions in the model to facilitate manual and/or automatic
  241.        mechanisms of mapping an IPP Printer to its corresponding directory
  242.        entry.
  243.  
  244.        All MANDATORY attributes MUST be defined in each directory entry for
  245.        an IPP Printer.  All other attributes SHOULD be defined in each
  246.        directory entry for an IPP Printer.  Furthermore, a directory entry
  247.        for an IPP Printer SHOULD be an instance of a Printer object class
  248.        defined by the Directory Service to scope searches for Printers.
  249.        Finally, a directory entry for an IPP Printer SHOULD reflect the
  250.        current attribute values for an IPP Printer in the network at any
  251.        point in time.
  252.  
  253.        2.1 printer-URI (uri, MANDATORY)
  254.  
  255.        This attribute contains the URI for the Printer.  An administrator
  256.        shall determine a printer's URI and shall set this attribute to that
  257.        URI. The precise format of a printer URI SHALL be implementation
  258.        dependent.
  259.  
  260.        2.2 printer-name (name, MANDATORY)
  261.  
  262.        This attribute contains the name of the Printer. It is a name that is
  263.        more user friendly than the printer-URI.  An administrator shall
  264.        determine a Printer's name and shall set this attribute to that name.
  265.        This name may be the last part of the printer's URI or it may be
  266.        unrelated. In non-US-English locales, a name may contain characters
  267.        that are not allowed in a URI.
  268.  
  269.        2.3 printer-location (text)
  270.  
  271.        This attribute identifies the location of this Printer.
  272.  
  273.        In order for filtered searches to be more effective, a given site may
  274.        use some regular structuring within the attribute value such as
  275.        "SITE:USA-San Jose,BUILDING:A1,FLOOR:2,ROOM:555" or "department5-
  276.        2ndFloor-A5-IndianHills-Chicago-IL-USA".
  277.  
  278.  
  279.  
  280.  
  281.        Carter, Isaacson                                    [Page 5]
  282.                  June 12, 1997, Expires December 12, 1997
  283.  
  284.  
  285.  
  286.        INTERNET-DRAFT   IPP/1.0: Directory Schema     June 12, 1997
  287.  
  288.  
  289.        2.4 printer-description (text)
  290.  
  291.        This attribute identifies the descriptive information about this
  292.        Printer.  This could include things like: "This printer can be used
  293.        for printing color transparencies for HR presentations", or "Out of
  294.        courtesy for others, please print only small (1-5 page) jobs at this
  295.        printer", or even "this printer is going away on July 1, 1997, please
  296.        find a new printer".
  297.  
  298.        2.5 printer-more-info-site (uri)
  299.  
  300.        This attribute contains a URI used to obtain more information about
  301.        this specific Printer.  The information obtained from this URI is
  302.        intended for end user consumption.  Features outside the scope of IPP
  303.        can be accessed from this URI.  The information is intended to be
  304.        specific to this Printer and site services (e.g. job pricing,
  305.        services offered, end user assistance).  The manufacturer may
  306.        initially populate this attribute.
  307.  
  308.        2.6 printer-make-and-model (text)
  309.  
  310.        This attribute identifies the make and model of the printer.
  311.  
  312.        2.7 printer-more-info-manf (uri)
  313.  
  314.        This attribute contains a URI used to obtain more information about
  315.        this type of printer.  The information obtained from this URI is
  316.        intended for end user consumption. Features outside the scope of IPP
  317.        can be accessed from this URI. (e.g. latest firmware,  upgrades,
  318.        print drivers, optional features available).  The information is
  319.        intended to be germane to this printer without regard to site
  320.        specific modifications or services.
  321.  
  322.        2.8 media-supported (1setOftype4 keyword)
  323.  
  324.        This attribute identifies the media supported by the Printer.  This
  325.        directory attribute SHOULD only be updated with values that are
  326.        relatively static values, not values which are constantly being
  327.        updated by the Printer.
  328.  
  329.        2.9 number-up-supported (1setOftype3 keyword)
  330.  
  331.        This attribute specifies the number of source page-images to impose
  332.        upon a single side of an instance of a selected medium.
  333.  
  334.  
  335.  
  336.  
  337.  
  338.        Carter, Isaacson                                    [Page 6]
  339.                  June 12, 1997, Expires December 12, 1997
  340.  
  341.  
  342.  
  343.        INTERNET-DRAFT   IPP/1.0: Directory Schema     June 12, 1997
  344.  
  345.  
  346.        2.10 sides-supported (1setOftype2 keyword)
  347.  
  348.        This attribute specifies how source page-images are to be imposed
  349.        upon the sides of an instance of a selected medium.
  350.  
  351.        2.11 printer-resolution-supported (1setOftype2 keyword)
  352.  
  353.        This attribute specifies the printer resolutions supported by this
  354.        printer.
  355.  
  356.        2.12 maximum-printer-speed-supported (integerUnits)
  357.  
  358.        This attribute specifies the maximum printer speed of the Printer.
  359.  
  360.        2.13 print-quality-supported (1setOftype2 keyword)
  361.  
  362.        This attribute specifies the print qualities supported by the
  363.        Printer.
  364.  
  365.        2.14 color-supported (boolean)
  366.  
  367.        This attribute specifies whether the Printer supports color or not.
  368.  
  369.        2.15 finishings-supported (setOftype2 keyword)
  370.  
  371.        This attribute identifies the finishing operations that the Printer
  372.        can apply to each copy of each printed document in a job.
  373.  
  374.        2.16 document-formats-supported (1setOftype2 keyword)
  375.  
  376.        This attribute specifies a list of the document formats that the
  377.        Printer supports.
  378.  
  379.        2.17 printer-locales-supported (1setOflocale keyword, MANDATORY)
  380.  
  381.        This attribute specifies the locales that the Printer operates in.
  382.  
  383.        3. Security Considerations
  384.  
  385.        An end user's access to a directory entry for an IPP Printer is
  386.        controlled by the Directory Service.  An end user's access to an IPP
  387.        Printer in the network is controlled by the service provider for that
  388.        IPP Printer.
  389.  
  390.        NOTE: There is another Internet-Draft called "Internet Printing
  391.        Protocol/1.0: Security."  That document is being drafted and reviewed
  392.        in parallel with this document.  Before this document can become a
  393.  
  394.  
  395.        Carter, Isaacson                                    [Page 7]
  396.                  June 12, 1997, Expires December 12, 1997
  397.  
  398.  
  399.  
  400.        INTERNET-DRAFT   IPP/1.0: Directory Schema     June 12, 1997
  401.  
  402.  
  403.        formal RFC, any relevant issues from that document will be rolled
  404.        into this one.
  405.  
  406.        4. References
  407.  
  408.          [1]  Internet Printing Protocol: Requirements.
  409.  
  410.          [2]  Internet Printing Protocol/1.0: Model and Semantics.
  411.  
  412.          [3]  Internet Printing Protocol/1.0: Security.
  413.  
  414.        5. Author's Address
  415.  
  416.        Scott A. Isaacson
  417.        Novell, Inc.
  418.        122 E 1700 S
  419.        Provo, UT   84606
  420.  
  421.        Phone: 801-861-7366
  422.        Fax:   801-861-4025
  423.        EMail: scott_isaacson@novell.com
  424.  
  425.  
  426.        Keith Carter
  427.        IBM Corporation
  428.        11400 Burnet Road
  429.        Internal Zip 9372
  430.        Austin, Texas 78758
  431.  
  432.        Phone: (512) 838-2155
  433.        Fax: (512) 838-2611
  434.        Email: carterk@us.ibm.com
  435.  
  436.        IPP Mailing List:  ipp@pwg.org
  437.        IPP Mailing List Subscription Information: ipp-request@pwg.org
  438.        IPP Home Page: http://www.pwg.org/ipp/
  439.  
  440.        Other Participants:
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.        Carter, Isaacson                                    [Page 8]
  453.                  June 12, 1997, Expires December 12, 1997
  454.  
  455.