home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_s_z / draft-schulzrinne-http-status-00.txt < prev    next >
Text File  |  1997-08-01  |  6KB  |  171 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Internet Engineering Task Force                                  HTTP WG
  8. Internet Draft                                            H. Schulzrinne
  9. schulzrinne-http-status-00.txt                               Columbia U.
  10. July 30, 1997
  11. Expires: January 1, 1998
  12.  
  13.  
  14.      Assignment of Status Codes for HTTP and HTTP-Derived Protocols
  15.  
  16. STATUS OF THIS MEMO
  17.  
  18.    This document is an Internet-Draft. Internet-Drafts are working
  19.    documents of the Internet Engineering Task Force (IETF), its areas,
  20.    and its working groups.  Note that other groups may also distribute
  21.    working documents as Internet-Drafts.
  22.  
  23.    Internet-Drafts are draft documents valid for a maximum of six months
  24.    and may be updated, replaced, or obsoleted by other documents at any
  25.    time.  It is inappropriate to use Internet-Drafts as reference
  26.    material or to cite them other than as ``work in progress''.
  27.  
  28.    To learn the current status of any Internet-Draft, please check the
  29.    ``1id-abstracts.txt'' listing contained in the Internet-Drafts Shadow
  30.    Directories on ftp.is.co.za (Africa), nic.nordu.net (Europe),
  31.    munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or
  32.    ftp.isi.edu (US West Coast).
  33.  
  34.    Distribution of this document is unlimited.
  35.  
  36.                                  ABSTRACT
  37.  
  38.  
  39.          A number of other protocols may make use of HTTP syntax
  40.          and facilities; this memo defines a mechanism for IANA to
  41.          allocate status codes.
  42.  
  43. 1 Status Codes
  44.  
  45.    HTTP status codes are defined in RFC 2068 [1], Section 10.  Other
  46.    protocols that share HTTP syntax and standard status codes may need
  47.    to add additional status codes. In addition, implementors may want to
  48.    define new status codes for HTTP in an interoperable manner. This
  49.    memo establishes a mechanism that charges the Internet Assigned
  50.    Numbers Authority (IANA) to manage the HTTP status code space under
  51.    the heading "Status codes for HTTP and HTTP-derived protocols".
  52.  
  53.    We use the notation "x00--x49" to indicate status codes having any
  54.    digit as their first digit and the two-digit numbers zero through 49
  55.  
  56.  
  57.  
  58. H. Schulzrinne                                                [Page 1]
  59.  
  60. Internet Draft                    sip                      July 30, 1997
  61.  
  62.  
  63.    as their second and third digits. Examples include the range 400
  64.    through 449.
  65.  
  66.    IANA manages the status codes of "HTTP and HTTP-derived protocols"
  67.    under the following guidelines:
  68.  
  69.         o Status codes x00 through x49 are reserved for general use of
  70.          HTTP and defined in HTTP-related RFCs or through registration
  71.          with IANA, in consultation with the HTTP working group, if
  72.          available, or the IETF Applications Area director.
  73.  
  74.         o IANA may be asked by authors of IETF standards-track protocols
  75.          to assign blocks of five or ten consecutive status codes across
  76.          all first digits. Each such protocol must use the same range
  77.          across all first digits.
  78.  
  79.         o Due to the limited per-protocl space, private extensions
  80.          SHOULD be registered through the protocol number space, with
  81.          IANA soliciting after advice and consultation with the working
  82.          group "owning" the protocol.  If there is no working group, the
  83.          area director is to be consulted.
  84.  
  85.         o Any extension that is not part of a standards-track protocol
  86.          must be documented as an RFC within one year of assignment.
  87.          Otherwise, the assigned number reverts to general use.
  88.  
  89.         o HTTP uses the first digits 1 through 5, inclusive. Protocols
  90.          other than HTTP may use first digits other than these if they
  91.          define classes of status codes that do not map into the
  92.          following classification:
  93.  
  94.         1xx: This class of status code indicates a provisional response,
  95.          typically indicating progress in serving the request. The
  96.          server will deliver another final response.
  97.  
  98.         2xx: This class of status code indicates that the client's
  99.          request was successfully received, understood, and accepted.
  100.  
  101.         3xx: This class of status code indicates that further action
  102.          needs to be taken by the user agent in order to fulfill the
  103.          request. The response provides indication as to what actions
  104.          the client may take, including contacting another server.
  105.  
  106.         4xx: The 4xx class of status code is intended for cases in which
  107.          the client seems to have erred. The client should not issue the
  108.          same request again. (However, a similar request for the same
  109.          resource may be issued after adding additional information, for
  110.          example, authorization or payment information.) The condition
  111.  
  112.  
  113.  
  114. H. Schulzrinne                                                [Page 2]
  115.  
  116. Internet Draft                    sip                      July 30, 1997
  117.  
  118.  
  119.          reported may be temporary or permanent.
  120.  
  121.         5xx: Response status codes beginning with the digit "5" indicate
  122.          cases in which the server is aware that it has erred or is
  123.          incapable of performing the request.
  124.  
  125. 2 Alternatives
  126.  
  127.    It has been suggsted to use four-digit status codes, with the first
  128.    digit indicating the protocol, with 0 implied and reserved for HTTP.
  129.    (It is advantageous to maintain the significance of the digit
  130.    position so that status code / 100 yields the class and status code %
  131.    100 the sub-code.)
  132.  
  133. 3 Author's Address
  134.  
  135.    Henning Schulzrinne
  136.    Columbia University
  137.    1214 Amsterdam Avenue
  138.    New York, MY 10027
  139.    USA
  140.    electronic mail:  schulzrinne@cs.columbia.edu
  141.  
  142. 4 Bibliography
  143.  
  144.    [1] R. Fielding, J. Gettys, J. Mogul, H. Frystyk, and T. Berners-Lee,
  145.    "Hypertext transfer protocol -- HTTP/1.1,"  RFC 2068, Internet
  146.    Engineering Task Force, Jan. 1997.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. H. Schulzrinne                                                [Page 3]
  171.