![]() |
![]() |
![]() |
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
|