WebSocket++  0.8.0-dev
C++ websocket client/server library
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Pages
Typedefs | Functions | Variables
websocketpp::close::status Namespace Reference

A package of types and methods for manipulating WebSocket close status'. More...

Typedefs

typedef uint16_t value
 The type of a close code value.
 

Functions

bool reserved (value code)
 Test whether a close code is in a reserved range. More...
 
bool invalid (value code)
 Test whether a close code is invalid on the wire. More...
 
bool terminal (value code)
 Determine if the code represents an unrecoverable error. More...
 
std::string get_string (value code)
 Return a human readable interpretation of a WebSocket close code. More...
 

Variables

static value const blank = 0
 A blank value for internal use.
 
static value const omit_handshake = 1
 Close the connection without a WebSocket close handshake. More...
 
static value const force_tcp_drop = 2
 Close the connection with a forced TCP drop. More...
 
static value const normal = 1000
 
static value const going_away = 1001
 
static value const protocol_error = 1002
 A protocol error occurred.
 
static value const unsupported_data = 1003
 
static value const no_status = 1005
 A dummy value to indicate that no status code was received. More...
 
static value const abnormal_close = 1006
 A dummy value to indicate that the connection was closed abnormally. More...
 
static value const invalid_payload = 1007
 An endpoint received message data inconsistent with its type. More...
 
static value const policy_violation = 1008
 An endpoint received a message that violated its policy. More...
 
static value const message_too_big = 1009
 An endpoint received a message too large to process.
 
static value const extension_required = 1010
 A client expected the server to accept a required extension request. More...
 
static value const internal_endpoint_error = 1011
 
static value const service_restart = 1012
 
static value const try_again_later = 1013
 
static value const tls_handshake = 1015
 An endpoint failed to perform a TLS handshake. More...
 
static value const subprotocol_error = 3000
 A generic subprotocol error. More...
 
static value const invalid_subprotocol_data = 3001
 A invalid subprotocol data. More...
 
static value const rsv_start = 1016
 First value in range reserved for future protocol use.
 
static value const rsv_end = 2999
 Last value in range reserved for future protocol use.
 
static value const invalid_low = 999
 First value in range that is always invalid on the wire.
 
static value const invalid_high = 5000
 Last value in range that is always invalid on the wire.
 

Detailed Description

A package of types and methods for manipulating WebSocket close status'.

Function Documentation

std::string websocketpp::close::status::get_string ( value  code)
inline

Return a human readable interpretation of a WebSocket close code.

See https://tools.ietf.org/html/rfc6455#section-7.4 for more details.

Since
0.3.0
Parameters
[in]codeThe code to look up.
Returns
A human readable interpretation of the code.

Definition at line 227 of file close.hpp.

bool websocketpp::close::status::invalid ( value  code)
inline

Test whether a close code is invalid on the wire.

Parameters
[in]codeThe code to test
Returns
Whether or not code is invalid on the wire

Definition at line 194 of file close.hpp.

bool websocketpp::close::status::reserved ( value  code)
inline

Test whether a close code is in a reserved range.

Parameters
[in]codeThe code to test
Returns
Whether or not code is reserved

Definition at line 179 of file close.hpp.

bool websocketpp::close::status::terminal ( value  code)
inline

Determine if the code represents an unrecoverable error.

There is a class of errors for which once they are discovered normal WebSocket functionality can no longer occur. This function determines if a given code is one of these values. This information is used to determine if the system has the capability of waiting for a close acknowledgement or if it should drop the TCP connection immediately after sending its close frame.

Parameters
[in]codeThe value to test.
Returns
True if the code represents an unrecoverable error

Definition at line 212 of file close.hpp.

Variable Documentation

value const websocketpp::close::status::abnormal_close = 1006
static

A dummy value to indicate that the connection was closed abnormally.

In such a case there was no close frame to extract a value from. This value is illegal on the wire.

Definition at line 104 of file close.hpp.

value const websocketpp::close::status::extension_required = 1010
static

A client expected the server to accept a required extension request.

The list of extensions that are needed SHOULD appear in the /reason/ part of the Close frame. Note that this status code is not used by the server, because it can fail the WebSocket handshake instead.

Definition at line 129 of file close.hpp.

value const websocketpp::close::status::force_tcp_drop = 2
static

Close the connection with a forced TCP drop.

This special value requests that the WebSocket connection be closed by forcibly dropping the TCP connection. This will leave the other side of the connection with a broken connection and some expensive timeouts. this should not be done except in extreme cases or in cases of malicious remote endpoints.

Definition at line 72 of file close.hpp.

value const websocketpp::close::status::going_away = 1001
static

The endpoint was "going away", such as a server going down or a browser navigating away from a page.

Definition at line 80 of file close.hpp.

value const websocketpp::close::status::internal_endpoint_error = 1011
static

An endpoint encountered an unexpected condition that prevented it from fulfilling the request.

Definition at line 133 of file close.hpp.

value const websocketpp::close::status::invalid_payload = 1007
static

An endpoint received message data inconsistent with its type.

For example: Invalid UTF8 bytes in a text message.

Definition at line 110 of file close.hpp.

value const websocketpp::close::status::invalid_subprotocol_data = 3001
static

A invalid subprotocol data.

Indicates that data was received that violated the specification of the subprotocol in use.

Definition at line 167 of file close.hpp.

value const websocketpp::close::status::no_status = 1005
static

A dummy value to indicate that no status code was received.

This value is illegal on the wire.

Definition at line 97 of file close.hpp.

value const websocketpp::close::status::normal = 1000
static

Normal closure, meaning that the purpose for which the connection was established has been fulfilled.

Definition at line 76 of file close.hpp.

value const websocketpp::close::status::omit_handshake = 1
static

Close the connection without a WebSocket close handshake.

This special value requests that the WebSocket connection be closed without performing the WebSocket closing handshake. This does not comply with RFC6455, but should be safe to do if necessary. This could be useful for clients that need to disconnect quickly and cannot afford the complete handshake.

Definition at line 62 of file close.hpp.

value const websocketpp::close::status::policy_violation = 1008
static

An endpoint received a message that violated its policy.

This is a generic status code that can be returned when there is no other more suitable status code (e.g., 1003 or 1009) or if there is a need to hide specific details about the policy.

Definition at line 118 of file close.hpp.

value const websocketpp::close::status::service_restart = 1012
static

Indicates that the service is restarted. A client may reconnect and if if it chooses to do so, should reconnect using a randomized delay of 5-30s

Definition at line 138 of file close.hpp.

value const websocketpp::close::status::subprotocol_error = 3000
static

A generic subprotocol error.

Indicates that a subprotocol error occurred. Typically this involves receiving a message that is not formatted as a valid message for the subprotocol in use.

Definition at line 160 of file close.hpp.

value const websocketpp::close::status::tls_handshake = 1015
static

An endpoint failed to perform a TLS handshake.

Designated for use in applications expecting a status code to indicate that the connection was closed due to a failure to perform a TLS handshake (e.g., the server certificate can't be verified). This value is illegal on the wire.

Definition at line 152 of file close.hpp.

value const websocketpp::close::status::try_again_later = 1013
static

Indicates that the service is experiencing overload. A client should only connect to a different IP (when there are multiple for the target) or reconnect to the same IP upon user action.

Definition at line 143 of file close.hpp.

value const websocketpp::close::status::unsupported_data = 1003
static

The connection was terminated because an endpoint received a type of data it cannot accept. (e.g., an endpoint that understands only text data MAY send this if it receives a binary message).

Definition at line 91 of file close.hpp.