Ignore:
Timestamp:
17/02/11 16:11:35 (11 years ago)
Author:
julian.reschke@…
Message:

Restructure 'Status Code and Reason Phrase', replace ABNF listing all HTTP/1.1 status codes with an Overview table, remove some redundant text (see #137)

File:
1 edited

Legend:

Unmodified
Added
Removed

  • draft-ietf-httpbis/latest/p2-semantics.xml

    r1120 r1124  
    558558  <x:anchor-alias value="extension-code"/>
    559559<t>
    560    The Status-Code element is a 3-digit integer result code of the
    561    attempt to understand and satisfy the request. The status codes listed
    562    below are defined in <xref target="status.codes"/>, &p4-status-codes;,
    563    &p5-status-codes;, and &p7-status-codes;.
    564 </t>
    565 <t>
    566    The Reason-Phrase is intended to give a short
    567    textual description of the Status-Code. The Status-Code is intended
    568    for use by automata and the Reason-Phrase is intended for the human
    569    user. The client is not required to examine or display the Reason-Phrase.
    570 </t>
    571 <t> 
    572    The individual values of the numeric status codes defined for
    573    HTTP/1.1, and an example set of corresponding Reason-Phrase values, are
    574    presented below. The reason phrases listed here are only
    575    recommendations &mdash; they &MAY; be replaced by local equivalents without
    576    affecting the protocol.
     560   The Status-Code element is a 3-digit integer result code of the attempt to
     561   understand and satisfy the request.
     562</t>
     563<t>
     564   The Reason-Phrase is intended to give a short textual description of the
     565   Status-Code and is intended for the human user. The client is not required
     566   to examine or display the Reason-Phrase.
    577567</t>
    578568<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Status-Code"/><iref primary="true" item="Grammar" subitem="extension-code"/><iref primary="true" item="Grammar" subitem="Reason-Phrase"/>
    579   <x:ref>Status-Code</x:ref> =
    580        "100"  ; <xref target="status.100"/>: Continue
    581      / "101"  ; <xref target="status.101"/>: Switching Protocols
    582      / "200"  ; <xref target="status.200"/>: OK
    583      / "201"  ; <xref target="status.201"/>: Created
    584      / "202"  ; <xref target="status.202"/>: Accepted
    585      / "203"  ; <xref target="status.203"/>: Non-Authoritative Information
    586      / "204"  ; <xref target="status.204"/>: No Content
    587      / "205"  ; <xref target="status.205"/>: Reset Content
    588      / "206"  ; &status-206;: Partial Content
    589      / "300"  ; <xref target="status.300"/>: Multiple Choices
    590      / "301"  ; <xref target="status.301"/>: Moved Permanently
    591      / "302"  ; <xref target="status.302"/>: Found
    592      / "303"  ; <xref target="status.303"/>: See Other
    593      / "304"  ; &status-304;: Not Modified
    594      / "305"  ; <xref target="status.305"/>: Use Proxy
    595      / "307"  ; <xref target="status.307"/>: Temporary Redirect
    596      / "400"  ; <xref target="status.400"/>: Bad Request
    597      / "401"  ; &status-401;: Unauthorized
    598      / "402"  ; <xref target="status.402"/>: Payment Required
    599      / "403"  ; <xref target="status.403"/>: Forbidden
    600      / "404"  ; <xref target="status.404"/>: Not Found
    601      / "405"  ; <xref target="status.405"/>: Method Not Allowed
    602      / "406"  ; <xref target="status.406"/>: Not Acceptable
    603      / "407"  ; &status-407;: Proxy Authentication Required
    604      / "408"  ; <xref target="status.408"/>: Request Time-out
    605      / "409"  ; <xref target="status.409"/>: Conflict
    606      / "410"  ; <xref target="status.410"/>: Gone
    607      / "411"  ; <xref target="status.411"/>: Length Required
    608      / "412"  ; &status-412;: Precondition Failed
    609      / "413"  ; <xref target="status.413"/>: Request Entity Too Large
    610      / "414"  ; <xref target="status.414"/>: URI Too Long
    611      / "415"  ; <xref target="status.415"/>: Unsupported Media Type
    612      / "416"  ; &status-416;: Requested range not satisfiable
    613      / "417"  ; <xref target="status.417"/>: Expectation Failed
    614      / "426"  ; <xref target="status.426"/>: Upgrade Required
    615      / "500"  ; <xref target="status.500"/>: Internal Server Error
    616      / "501"  ; <xref target="status.501"/>: Not Implemented
    617      / "502"  ; <xref target="status.502"/>: Bad Gateway
    618      / "503"  ; <xref target="status.503"/>: Service Unavailable
    619      / "504"  ; <xref target="status.504"/>: Gateway Time-out
    620      / "505"  ; <xref target="status.505"/>: HTTP Version not supported
    621      / <x:ref>extension-code</x:ref>
    622 
    623   <x:ref>extension-code</x:ref> = 3<x:ref>DIGIT</x:ref>
     569  <x:ref>Status-Code</x:ref>    = 3<x:ref>DIGIT</x:ref>
    624570  <x:ref>Reason-Phrase</x:ref>  = *( <x:ref>WSP</x:ref> / <x:ref>VCHAR</x:ref> / <x:ref>obs-text</x:ref> )
    625571</artwork></figure>
    … …  
    639585   information which will explain the unusual status.
    640586</t>
     587
     588<section title="Overview of Status Codes" anchor="overview.of.status.codes">
     589<t> 
     590   The status codes listed below are defined in <xref target="status.codes"/>,
     591   &p4-status-codes;, &p5-status-codes;, and &p7-status-codes;. The reason
     592   phrases listed here are only recommendations &mdash; they can be replaced
     593   by local equivalents without affecting the protocol.
     594</t>
     595<texttable align="left">
     596  <ttcol>Status-Code</ttcol>
     597  <ttcol>Reason-Phrase</ttcol>
     598  <ttcol>Defined in...</ttcol>
     599 
     600  <c>100</c> <c>Continue</c> <c><xref target="status.100"/></c>
     601  <c>101</c> <c>Switching Protocols</c> <c><xref target="status.101"/></c>
     602
     603  <c>200</c> <c>OK</c> <c><xref target="status.200"/></c>
     604  <c>201</c> <c>Created</c> <c><xref target="status.201"/></c>
     605  <c>202</c> <c>Accepted</c> <c><xref target="status.202"/></c>
     606  <c>203</c> <c>Non-Authoritative Information</c> <c><xref target="status.203"/></c>
     607  <c>204</c> <c>No Content</c> <c><xref target="status.204"/></c>
     608  <c>205</c> <c>Reset Content</c> <c><xref target="status.205"/></c>
     609  <c>206</c> <c>Partial Content</c> <c>&status-206;</c>
     610
     611  <c>300</c> <c>Multiple Choices</c> <c><xref target="status.300"/></c>
     612  <c>301</c> <c>Moved Permanently</c> <c><xref target="status.301"/></c>
     613  <c>302</c> <c>Found</c> <c><xref target="status.302"/></c>
     614  <c>303</c> <c>See Other</c> <c><xref target="status.303"/></c>
     615  <c>304</c> <c>Not Modified</c> <c>&status-304;</c>
     616  <c>305</c> <c>Use Proxy</c> <c><xref target="status.305"/></c>
     617  <c>307</c> <c>Temporary Redirect</c> <c><xref target="status.307"/></c>
     618
     619  <c>400</c> <c>Bad Request</c> <c><xref target="status.400"/></c>
     620  <c>401</c> <c>Unauthorized</c> <c>&status-401;</c>
     621  <c>402</c> <c>Payment Required</c> <c><xref target="status.402"/></c>
     622  <c>403</c> <c>Forbidden</c> <c><xref target="status.403"/></c>
     623  <c>404</c> <c>Not Found</c> <c><xref target="status.404"/></c>
     624  <c>405</c> <c>Method Not Allowed</c> <c><xref target="status.405"/></c>
     625  <c>406</c> <c>Not Acceptable</c> <c><xref target="status.406"/></c>
     626  <c>407</c> <c>Proxy Authentication Required</c> <c>&status-407;</c>
     627  <c>408</c> <c>Request Time-out</c> <c><xref target="status.408"/></c>
     628  <c>409</c> <c>Conflict</c> <c><xref target="status.409"/></c>
     629  <c>410</c> <c>Gone</c> <c><xref target="status.410"/></c>
     630  <c>411</c> <c>Length Required</c> <c><xref target="status.411"/></c>
     631  <c>412</c> <c>Precondition Failed</c> <c>&status-412;</c>
     632  <c>413</c> <c>Request Entity Too Large</c> <c><xref target="status.413"/></c>
     633  <c>414</c> <c>URI Too Long</c> <c><xref target="status.414"/></c>
     634  <c>415</c> <c>Unsupported Media Type</c> <c><xref target="status.415"/></c>
     635  <c>416</c> <c>Requested range not satisfiable</c> <c>&status-416;</c>
     636  <c>417</c> <c>Expectation Failed</c> <c><xref target="status.417"/></c>
     637  <c>426</c> <c>Upgrade Required</c> <c><xref target="status.426"/></c>
     638
     639  <c>500</c> <c>Internal Server Error</c> <c><xref target="status.500"/></c>
     640  <c>501</c> <c>Not Implemented</c> <c><xref target="status.501"/></c>
     641  <c>502</c> <c>Bad Gateway</c> <c><xref target="status.502"/></c>
     642  <c>503</c> <c>Service Unavailable</c> <c><xref target="status.503"/></c>
     643  <c>504</c> <c>Gateway Time-out</c> <c><xref target="status.504"/></c>
     644  <c>505</c> <c>HTTP Version not supported</c> <c><xref target="status.505"/></c>
     645</texttable>
     646<t>
     647   Note that this list is not exhaustive &mdash; it does not include
     648   extension status codes defined in other specifications.
     649</t>
     650</section>
    641651
    642652<section title="Status Code Registry" anchor="status.code.registry">
    … …  
    35783588<x:ref>Server</x:ref> = "Server:" OWS Server-v
    35793589<x:ref>Server-v</x:ref> = product *( RWS ( product / comment ) )
    3580 <x:ref>Status-Code</x:ref> = "100" / "101" / "200" / "201" / "202" / "203" / "204" /
    3581  "205" / "206" / "300" / "301" / "302" / "303" / "304" / "305" /
    3582  "307" / "400" / "401" / "402" / "403" / "404" / "405" / "406" /
    3583  "407" / "408" / "409" / "410" / "411" / "412" / "413" / "414" /
    3584  "415" / "416" / "417" / "426" / "500" / "501" / "502" / "503" /
    3585  "504" / "505" / extension-code
     3590<x:ref>Status-Code</x:ref> = 3DIGIT
    35863591
    35873592<x:ref>TE</x:ref> = &lt;TE, defined in [Part1], Section 9.5&gt;
    … …  
    36063611<x:ref>expectation-extension</x:ref> = token [ "=" ( token / quoted-string )
    36073612 *expect-params ]
    3608 <x:ref>extension-code</x:ref> = 3DIGIT
    36093613<x:ref>extension-method</x:ref> = token
    36103614
    … …  
    40404044    </t>
    40414045    <t>
     4046      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/137"/>:
     4047      "duplicate ABNF for Reason-Phrase"
     4048    </t>
     4049    <t>
    40424050      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/226"/>:
    40434051      "proxies not supporting certain methods"
    … …  
    40554063      "PUT side effect: invalidation or just stale?"
    40564064    </t>
    4057      
    40584065  </list>
    40594066</t>
Note: See TracChangeset for help on using the changeset viewer.