| libsoup Reference Manual | ||||
|---|---|---|---|---|
enum SoupStatusClass; #define SOUP_STATUS_IS_INFORMATIONAL (status) #define SOUP_STATUS_IS_SUCCESSFUL (status) #define SOUP_STATUS_IS_REDIRECTION (status) #define SOUP_STATUS_IS_CLIENT_ERROR (status) #define SOUP_STATUS_IS_SERVER_ERROR (status) enum SoupKnownStatusCode; const char* soup_status_get_phrase (guint status_code);
typedef enum {
SOUP_STATUS_CLASS_TRANSPORT_ERROR = 0,
SOUP_STATUS_CLASS_INFORMATIONAL,
SOUP_STATUS_CLASS_SUCCESS,
SOUP_STATUS_CLASS_REDIRECT,
SOUP_STATUS_CLASS_CLIENT_ERROR,
SOUP_STATUS_CLASS_SERVER_ERROR
} SoupStatusClass;
The classes of HTTP and Soup status codes
| Network or Soup-level error | |
| HTTP 1xx response providing partial information about the state of a request | |
| HTTP 2xx successful response | |
| HTTP 3xx redirection response | |
| HTTP 4xx client error response | |
| HTTP 5xx server error response |
#define SOUP_STATUS_IS_INFORMATIONAL(status) ((status) >= 100 && (status) < 200)
Tests if status is an Informational (1xx) response.
#define SOUP_STATUS_IS_SUCCESSFUL(status) ((status) >= 200 && (status) < 300)
Tests if status is a Successful (2xx) response.
#define SOUP_STATUS_IS_REDIRECTION(status) ((status) >= 300 && (status) < 400)
Tests if status is a Redirection (3xx) response.
#define SOUP_STATUS_IS_CLIENT_ERROR(status) ((status) >= 400 && (status) < 500)
Tests if status is a Client Error (4xx) response.
#define SOUP_STATUS_IS_SERVER_ERROR(status) ((status) >= 500 && (status) < 600)
Tests if status is a Server Error (5xx) response.
typedef enum {
SOUP_STATUS_NONE,
/* Transport Errors */
SOUP_STATUS_CANCELLED = 1,
SOUP_STATUS_CANT_RESOLVE,
SOUP_STATUS_CANT_RESOLVE_PROXY,
SOUP_STATUS_CANT_CONNECT,
SOUP_STATUS_CANT_CONNECT_PROXY,
SOUP_STATUS_SSL_FAILED,
SOUP_STATUS_IO_ERROR,
SOUP_STATUS_MALFORMED,
SOUP_STATUS_TRY_AGAIN,
/* HTTP Status Codes */
SOUP_STATUS_CONTINUE = 100,
SOUP_STATUS_SWITCHING_PROTOCOLS = 101,
SOUP_STATUS_PROCESSING = 102, /* WebDAV */
SOUP_STATUS_OK = 200,
SOUP_STATUS_CREATED = 201,
SOUP_STATUS_ACCEPTED = 202,
SOUP_STATUS_NON_AUTHORITATIVE = 203,
SOUP_STATUS_NO_CONTENT = 204,
SOUP_STATUS_RESET_CONTENT = 205,
SOUP_STATUS_PARTIAL_CONTENT = 206,
SOUP_STATUS_MULTI_STATUS = 207, /* WebDAV */
SOUP_STATUS_MULTIPLE_CHOICES = 300,
SOUP_STATUS_MOVED_PERMANENTLY = 301,
SOUP_STATUS_FOUND = 302,
SOUP_STATUS_MOVED_TEMPORARILY = 302, /* RFC 2068 */
SOUP_STATUS_SEE_OTHER = 303,
SOUP_STATUS_NOT_MODIFIED = 304,
SOUP_STATUS_USE_PROXY = 305,
SOUP_STATUS_NOT_APPEARING_IN_THIS_PROTOCOL = 306, /* (reserved) */
SOUP_STATUS_TEMPORARY_REDIRECT = 307,
SOUP_STATUS_BAD_REQUEST = 400,
SOUP_STATUS_UNAUTHORIZED = 401,
SOUP_STATUS_PAYMENT_REQUIRED = 402, /* (reserved) */
SOUP_STATUS_FORBIDDEN = 403,
SOUP_STATUS_NOT_FOUND = 404,
SOUP_STATUS_METHOD_NOT_ALLOWED = 405,
SOUP_STATUS_NOT_ACCEPTABLE = 406,
SOUP_STATUS_PROXY_AUTHENTICATION_REQUIRED = 407,
SOUP_STATUS_PROXY_UNAUTHORIZED = SOUP_STATUS_PROXY_AUTHENTICATION_REQUIRED,
SOUP_STATUS_REQUEST_TIMEOUT = 408,
SOUP_STATUS_CONFLICT = 409,
SOUP_STATUS_GONE = 410,
SOUP_STATUS_LENGTH_REQUIRED = 411,
SOUP_STATUS_PRECONDITION_FAILED = 412,
SOUP_STATUS_REQUEST_ENTITY_TOO_LARGE = 413,
SOUP_STATUS_REQUEST_URI_TOO_LONG = 414,
SOUP_STATUS_UNSUPPORTED_MEDIA_TYPE = 415,
SOUP_STATUS_REQUESTED_RANGE_NOT_SATISFIABLE = 416,
SOUP_STATUS_INVALID_RANGE = SOUP_STATUS_REQUESTED_RANGE_NOT_SATISFIABLE,
SOUP_STATUS_EXPECTATION_FAILED = 417,
SOUP_STATUS_UNPROCESSABLE_ENTITY = 422, /* WebDAV */
SOUP_STATUS_LOCKED = 423, /* WebDAV */
SOUP_STATUS_FAILED_DEPENDENCY = 424, /* WebDAV */
SOUP_STATUS_INTERNAL_SERVER_ERROR = 500,
SOUP_STATUS_NOT_IMPLEMENTED = 501,
SOUP_STATUS_BAD_GATEWAY = 502,
SOUP_STATUS_SERVICE_UNAVAILABLE = 503,
SOUP_STATUS_GATEWAY_TIMEOUT = 504,
SOUP_STATUS_HTTP_VERSION_NOT_SUPPORTED = 505,
SOUP_STATUS_INSUFFICIENT_STORAGE = 507, /* WebDAV search */
SOUP_STATUS_NOT_EXTENDED = 510 /* RFC 2774 */
} SoupKnownStatusCode;
These represent the known HTTP status code values, plus various network and internal errors.
| No status available. (Eg, the message has not been sent yet) | |
| Message was cancelled locally | |
| Unable to resolve destination host name | |
| Unable to resolve proxy host name | |
| Unable to connect to remote host | |
| Unable to connect to proxy | |
| SSL negotiation failed | |
| A network error occurred, or the other end closed the connection unexpectedly | |
| Malformed data (usually a programmer error) | |
| Try again. (Only returned in certain specifically documented cases) | |
| 100 Continue (HTTP) | |
| 101 Switching Protocols (HTTP) | |
| 102 Processing (WebDAV) | |
| 200 Success (HTTP). Also used by many lower-level soup routines to indicate success. | |
| 201 Created (HTTP) | |
| 202 Accepted (HTTP) | |
| 203 Non-Authoritative Information (HTTP) | |
| 204 No Content (HTTP) | |
| 205 Reset Content (HTTP) | |
| 206 Partial Content (HTTP) | |
| 207 Multi-Status (WebDAV) | |
| 300 Multiple Choices (HTTP) | |
| 301 Moved Permanently (HTTP) | |
| 302 Found (HTTP) | |
| 302 Moved Temporarily (old name, RFC 2068) | |
| 303 See Other (HTTP) | |
| 304 Not Modified (HTTP) | |
| 305 Use Proxy (HTTP) | |
| 306 [Unused] (HTTP) | |
| 307 Temporary Redirect (HTTP) | |
| 400 Bad Request (HTTP) | |
| 401 Unauthorized (HTTP) | |
| 402 Payment Required (HTTP) | |
| 403 Forbidden (HTTP) | |
| 404 Not Found (HTTP) | |
| 405 Method Not Allowed (HTTP) | |
| 406 Not Acceptable (HTTP) | |
| 407 Proxy Authentication Required (HTTP) | |
shorter alias for
SOUP_STATUS_PROXY_AUTHENTICATION_REQUIRED
|
|
| 408 Request Timeout (HTTP) | |
| 409 Conflict (HTTP) | |
| 410 Gone (HTTP) | |
| 411 Length Required (HTTP) | |
| 412 Precondition Failed (HTTP) | |
| 413 Request Entity Too Large (HTTP) | |
| 414 Request-URI Too Long (HTTP) | |
| 415 Unsupported Media Type (HTTP) | |
| 416 Requested Range Not Satisfiable (HTTP) | |
shorter alias for
SOUP_STATUS_REQUESTED_RANGE_NOT_SATISFIABLE
|
|
| 417 Expectation Failed (HTTP) | |
| 422 Unprocessable Entity (WebDAV) | |
| 423 Locked (WebDAV) | |
| 424 Failed Dependency (WebDAV) | |
| 500 Internal Server Error (HTTP) | |
| 501 Not Implemented (HTTP) | |
| 502 Bad Gateway (HTTP) | |
| 503 Service Unavailable (HTTP) | |
| 504 Gateway Timeout (HTTP) | |
| 505 HTTP Version Not Supported (HTTP) | |
| 507 Insufficient Storage (WebDAV) | |
| 510 Not Extended (RFC 2774) |
const char* soup_status_get_phrase (guint status_code);
Looks up the stock HTTP description of status_code.
|
an HTTP status code |
Returns : |
the (English) description of status_code
|