/** @file\r
- Hypertext Transfer Protocol -- HTTP/1.1 Standard definitions, from RFC 2616 \r
+ Hypertext Transfer Protocol -- HTTP/1.1 Standard definitions, from RFC 2616\r
+\r
+ This file contains common HTTP 1.1 definitions from RFC 2616\r
\r
- This file contains common HTTP 1.1 definitions from RFC 2616 \r
- \r
(C) Copyright 2015-2016 Hewlett Packard Enterprise Development LP<BR>\r
This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
\r
///\r
/// HTTP Version (currently HTTP 1.1)\r
-/// \r
+///\r
/// The version of an HTTP message is indicated by an HTTP-Version field\r
/// in the first line of the message.\r
///\r
\r
///\r
/// HTTP Request Method definitions\r
-/// \r
+///\r
/// The Method token indicates the method to be performed on the\r
/// resource identified by the Request-URI. The method is case-sensitive.\r
///\r
\r
///\r
/// Accept Request Header\r
-/// The Accept request-header field can be used to specify certain media types which are \r
-/// acceptable for the response. Accept headers can be used to indicate that the request \r
-/// is specifically limited to a small set of desired types, as in the case of a request \r
+/// The Accept request-header field can be used to specify certain media types which are\r
+/// acceptable for the response. Accept headers can be used to indicate that the request\r
+/// is specifically limited to a small set of desired types, as in the case of a request\r
/// for an in-line image.\r
///\r
#define HTTP_HEADER_ACCEPT "Accept"\r
\r
\r
-/// \r
+///\r
/// Accept-Charset Request Header\r
-/// The Accept-Charset request-header field can be used to indicate what character sets \r
-/// are acceptable for the response. This field allows clients capable of understanding \r
-/// more comprehensive or special-purpose character sets to signal that capability to a \r
+/// The Accept-Charset request-header field can be used to indicate what character sets\r
+/// are acceptable for the response. This field allows clients capable of understanding\r
+/// more comprehensive or special-purpose character sets to signal that capability to a\r
/// server which is capable of representing documents in those character sets.\r
///\r
#define HTTP_HEADER_ACCEPT_CHARSET "Accept-Charset"\r
\r
-/// \r
+///\r
/// Accept-Language Request Header\r
-/// The Accept-Language request-header field is similar to Accept, \r
-/// but restricts the set of natural languages that are preferred \r
+/// The Accept-Language request-header field is similar to Accept,\r
+/// but restricts the set of natural languages that are preferred\r
/// as a response to the request.\r
///\r
#define HTTP_HEADER_ACCEPT_LANGUAGE "Accept-Language"\r
#define HTTP_HEADER_ACCEPT_RANGES "Accept-Ranges"\r
\r
\r
-/// \r
+///\r
/// Accept-Encoding Request Header\r
-/// The Accept-Encoding request-header field is similar to Accept, \r
+/// The Accept-Encoding request-header field is similar to Accept,\r
/// but restricts the content-codings that are acceptable in the response.\r
///\r
#define HTTP_HEADER_ACCEPT_ENCODING "Accept-Encoding"\r
\r
///\r
/// Content-Encoding Header\r
-/// The Content-Encoding entity-header field is used as a modifier to the media-type. \r
-/// When present, its value indicates what additional content codings have been applied \r
-/// to the entity-body, and thus what decoding mechanisms must be applied in order to \r
-/// obtain the media-type referenced by the Content-Type header field. Content-Encoding \r
-/// is primarily used to allow a document to be compressed without losing the identity \r
+/// The Content-Encoding entity-header field is used as a modifier to the media-type.\r
+/// When present, its value indicates what additional content codings have been applied\r
+/// to the entity-body, and thus what decoding mechanisms must be applied in order to\r
+/// obtain the media-type referenced by the Content-Type header field. Content-Encoding\r
+/// is primarily used to allow a document to be compressed without losing the identity\r
/// of its underlying media type.\r
///\r
#define HTTP_HEADER_CONTENT_ENCODING "Content-Encoding"\r
\r
-/// \r
+///\r
/// HTTP Content-Encoding Compression types\r
///\r
\r
#define HTTP_CONTENT_ENCODING_IDENTITY "identity" /// No transformation is used. This is the default value for content coding.\r
#define HTTP_CONTENT_ENCODING_GZIP "gzip" /// Content-Encoding: GNU zip format (described in RFC 1952).\r
-#define HTTP_CONTENT_ENCODING_COMPRESS "compress" /// encoding format produced by the common UNIX file compression program "compress". \r
-#define HTTP_CONTENT_ENCODING_DEFLATE "deflate" /// The "zlib" format defined in RFC 1950 in combination with the "deflate" \r
+#define HTTP_CONTENT_ENCODING_COMPRESS "compress" /// encoding format produced by the common UNIX file compression program "compress".\r
+#define HTTP_CONTENT_ENCODING_DEFLATE "deflate" /// The "zlib" format defined in RFC 1950 in combination with the "deflate"\r
/// compression mechanism described in RFC 1951.\r
\r
\r
///\r
/// Content-Type Header\r
-/// The Content-Type entity-header field indicates the media type of the entity-body sent to \r
-/// the recipient or, in the case of the HEAD method, the media type that would have been sent \r
+/// The Content-Type entity-header field indicates the media type of the entity-body sent to\r
+/// the recipient or, in the case of the HEAD method, the media type that would have been sent\r
/// had the request been a GET.\r
///\r
#define HTTP_HEADER_CONTENT_TYPE "Content-Type"\r
//\r
#define HTTP_CONTENT_TYPE_APP_JSON "application/json"\r
#define HTTP_CONTENT_TYPE_APP_OCTET_STREAM "application/octet-stream"\r
- \r
+\r
#define HTTP_CONTENT_TYPE_TEXT_HTML "text/html"\r
#define HTTP_CONTENT_TYPE_TEXT_PLAIN "text/plain"\r
#define HTTP_CONTENT_TYPE_TEXT_CSS "text/css"\r
#define HTTP_CONTENT_TYPE_TEXT_XML "text/xml"\r
- \r
+\r
#define HTTP_CONTENT_TYPE_IMAGE_GIF "image/gif"\r
#define HTTP_CONTENT_TYPE_IMAGE_JPEG "image/jpeg"\r
#define HTTP_CONTENT_TYPE_IMAGE_PNG "image/png"\r
\r
///\r
/// Content-Length Header\r
-/// The Content-Length entity-header field indicates the size of the entity-body, \r
-/// in decimal number of OCTETs, sent to the recipient or, in the case of the HEAD \r
+/// The Content-Length entity-header field indicates the size of the entity-body,\r
+/// in decimal number of OCTETs, sent to the recipient or, in the case of the HEAD\r
/// method, the size of the entity-body that would have been sent had the request been a GET.\r
///\r
#define HTTP_HEADER_CONTENT_LENGTH "Content-Length"\r
- \r
+\r
///\r
/// Transfer-Encoding Header\r
-/// The Transfer-Encoding general-header field indicates what (if any) type of transformation \r
-/// has been applied to the message body in order to safely transfer it between the sender \r
-/// and the recipient. This differs from the content-coding in that the transfer-coding \r
+/// The Transfer-Encoding general-header field indicates what (if any) type of transformation\r
+/// has been applied to the message body in order to safely transfer it between the sender\r
+/// and the recipient. This differs from the content-coding in that the transfer-coding\r
/// is a property of the message, not of the entity.\r
///\r
#define HTTP_HEADER_TRANSFER_ENCODING "Transfer-Encoding"\r
\r
///\r
/// User Agent Request Header\r
-/// \r
-/// The User-Agent request-header field contains information about the user agent originating \r
-/// the request. This is for statistical purposes, the tracing of protocol violations, and \r
-/// automated recognition of user agents for the sake of tailoring responses to avoid \r
-/// particular user agent limitations. User agents SHOULD include this field with requests. \r
-/// The field can contain multiple product tokens and comments identifying the agent and any \r
-/// subproducts which form a significant part of the user agent. \r
-/// By convention, the product tokens are listed in order of their significance for \r
+///\r
+/// The User-Agent request-header field contains information about the user agent originating\r
+/// the request. This is for statistical purposes, the tracing of protocol violations, and\r
+/// automated recognition of user agents for the sake of tailoring responses to avoid\r
+/// particular user agent limitations. User agents SHOULD include this field with requests.\r
+/// The field can contain multiple product tokens and comments identifying the agent and any\r
+/// subproducts which form a significant part of the user agent.\r
+/// By convention, the product tokens are listed in order of their significance for\r
/// identifying the application.\r
///\r
#define HTTP_HEADER_USER_AGENT "User-Agent"\r
///\r
/// Host Request Header\r
///\r
-/// The Host request-header field specifies the Internet host and port number of the resource \r
-/// being requested, as obtained from the original URI given by the user or referring resource \r
+/// The Host request-header field specifies the Internet host and port number of the resource\r
+/// being requested, as obtained from the original URI given by the user or referring resource\r
///\r
#define HTTP_HEADER_HOST "Host"\r
\r
///\r
/// Location Response Header\r
-/// \r
-/// The Location response-header field is used to redirect the recipient to a location other than \r
-/// the Request-URI for completion of the request or identification of a new resource. \r
-/// For 201 (Created) responses, the Location is that of the new resource which was created by \r
-/// the request. For 3xx responses, the location SHOULD indicate the server's preferred URI for \r
+///\r
+/// The Location response-header field is used to redirect the recipient to a location other than\r
+/// the Request-URI for completion of the request or identification of a new resource.\r
+/// For 201 (Created) responses, the Location is that of the new resource which was created by\r
+/// the request. For 3xx responses, the location SHOULD indicate the server's preferred URI for\r
/// automatic redirection to the resource. The field value consists of a single absolute URI.\r
///\r
#define HTTP_HEADER_LOCATION "Location"\r
\r
///\r
/// The If-Match request-header field is used with a method to make it conditional.\r
-/// A client that has one or more entities previously obtained from the resource \r
-/// can verify that one of those entities is current by including a list of their \r
-/// associated entity tags in the If-Match header field. \r
-/// The purpose of this feature is to allow efficient updates of cached information \r
-/// with a minimum amount of transaction overhead. It is also used, on updating requests, \r
-/// to prevent inadvertent modification of the wrong version of a resource. \r
+/// A client that has one or more entities previously obtained from the resource\r
+/// can verify that one of those entities is current by including a list of their\r
+/// associated entity tags in the If-Match header field.\r
+/// The purpose of this feature is to allow efficient updates of cached information\r
+/// with a minimum amount of transaction overhead. It is also used, on updating requests,\r
+/// to prevent inadvertent modification of the wrong version of a resource.\r
/// As a special case, the value "*" matches any current entity of the resource.\r
///\r
#define HTTP_HEADER_IF_MATCH "If-Match"\r
\r
\r
///\r
-/// The If-None-Match request-header field is used with a method to make it conditional. \r
-/// A client that has one or more entities previously obtained from the resource can verify \r
-/// that none of those entities is current by including a list of their associated entity \r
-/// tags in the If-None-Match header field. The purpose of this feature is to allow efficient \r
-/// updates of cached information with a minimum amount of transaction overhead. It is also used \r
-/// to prevent a method (e.g. PUT) from inadvertently modifying an existing resource when the \r
+/// The If-None-Match request-header field is used with a method to make it conditional.\r
+/// A client that has one or more entities previously obtained from the resource can verify\r
+/// that none of those entities is current by including a list of their associated entity\r
+/// tags in the If-None-Match header field. The purpose of this feature is to allow efficient\r
+/// updates of cached information with a minimum amount of transaction overhead. It is also used\r
+/// to prevent a method (e.g. PUT) from inadvertently modifying an existing resource when the\r
/// client believes that the resource does not exist.\r
///\r
#define HTTP_HEADER_IF_NONE_MATCH "If-None-Match"\r
\r
\r
\r
-/// \r
+///\r
/// Authorization Request Header\r
/// The Authorization field value consists of credentials\r
/// containing the authentication information of the user agent for\r
\r
///\r
/// ETAG Response Header\r
-/// The ETag response-header field provides the current value of the entity tag \r
-/// for the requested variant. \r
+/// The ETag response-header field provides the current value of the entity tag\r
+/// for the requested variant.\r
///\r
#define HTTP_HEADER_ETAG "ETag"\r
\r