Websocket Close

Enumerations
enum	lws_close_status {   LWS_CLOSE_STATUS_NOSTATUS = 0 , LWS_CLOSE_STATUS_NORMAL = 1000 , LWS_CLOSE_STATUS_GOINGAWAY = 1001 , LWS_CLOSE_STATUS_PROTOCOL_ERR = 1002 ,   LWS_CLOSE_STATUS_UNACCEPTABLE_OPCODE = 1003 , LWS_CLOSE_STATUS_RESERVED = 1004 , LWS_CLOSE_STATUS_NO_STATUS = 1005 , LWS_CLOSE_STATUS_ABNORMAL_CLOSE = 1006 ,   LWS_CLOSE_STATUS_INVALID_PAYLOAD = 1007 , LWS_CLOSE_STATUS_POLICY_VIOLATION = 1008 , LWS_CLOSE_STATUS_MESSAGE_TOO_LARGE = 1009 , LWS_CLOSE_STATUS_EXTENSION_REQUIRED = 1010 ,   LWS_CLOSE_STATUS_UNEXPECTED_CONDITION = 1011 , LWS_CLOSE_STATUS_TLS_FAILURE = 1015 , LWS_CLOSE_STATUS_CLIENT_TRANSACTION_DONE = 2000 , LWS_CLOSE_STATUS_NOSTATUS_CONTEXT_DESTROY = 9999 }

Functions
LWS_VISIBLE LWS_EXTERN void	lws_close_reason (struct lws *wsi, enum lws_close_status status, unsigned char *buf, size_t len)

Detailed Description

Websocket close frame control

When we close a ws connection, we can send a reason code and a short UTF-8 description back with the close packet.

Enumeration Type Documentation

lws_close_status

enum lws_close_status

#include <include/libwebsockets/lws-ws-close.h>

enum lws_close_status - RFC6455 close status codes

Enumerator
LWS_CLOSE_STATUS_NOSTATUS
LWS_CLOSE_STATUS_NORMAL	1000 indicates a normal closure, meaning that the purpose for which the connection was established has been fulfilled.
LWS_CLOSE_STATUS_GOINGAWAY	1001 indicates that an endpoint is "going away", such as a server going down or a browser having navigated away from a page.
LWS_CLOSE_STATUS_PROTOCOL_ERR	1002 indicates that an endpoint is terminating the connection due to a protocol error.
LWS_CLOSE_STATUS_UNACCEPTABLE_OPCODE	1003 indicates that an endpoint is terminating the connection because it has 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).
LWS_CLOSE_STATUS_RESERVED	Reserved. The specific meaning might be defined in the future.
LWS_CLOSE_STATUS_NO_STATUS	1005 is a reserved value and MUST NOT be set as a status code in a Close control frame by an endpoint. It is designated for use in applications expecting a status code to indicate that no status code was actually present.
LWS_CLOSE_STATUS_ABNORMAL_CLOSE	1006 is a reserved value and MUST NOT be set as a status code in a Close control frame by an endpoint. It is designated for use in applications expecting a status code to indicate that the connection was closed abnormally, e.g., without sending or receiving a Close control frame.
LWS_CLOSE_STATUS_INVALID_PAYLOAD	1007 indicates that an endpoint is terminating the connection because it has received data within a message that was not consistent with the type of the message (e.g., non-UTF-8 [RFC3629] data within a text message).
LWS_CLOSE_STATUS_POLICY_VIOLATION	1008 indicates that an endpoint is terminating the connection because it has received a message that violates 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.
LWS_CLOSE_STATUS_MESSAGE_TOO_LARGE	1009 indicates that an endpoint is terminating the connection because it has received a message that is too big for it to process.
LWS_CLOSE_STATUS_EXTENSION_REQUIRED	1010 indicates that an endpoint (client) is terminating the connection because it has expected the server to negotiate one or more extension, but the server didn't return them in the response message of the WebSocket handshake. 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
LWS_CLOSE_STATUS_UNEXPECTED_CONDITION	1011 indicates that a server is terminating the connection because it encountered an unexpected condition that prevented it from fulfilling the request.
LWS_CLOSE_STATUS_TLS_FAILURE	1015 is a reserved value and MUST NOT be set as a status code in a Close control frame by an endpoint. It is 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).
LWS_CLOSE_STATUS_CLIENT_TRANSACTION_DONE
LWS_CLOSE_STATUS_NOSTATUS_CONTEXT_DESTROY

Definition at line 39 of file lws-ws-close.h.

                      {
        LWS_CLOSE_STATUS_NOSTATUS                               =    0,
        LWS_CLOSE_STATUS_NORMAL                                 = 1000,
        LWS_CLOSE_STATUS_GOINGAWAY                              = 1001,
        LWS_CLOSE_STATUS_PROTOCOL_ERR                           = 1002,
        LWS_CLOSE_STATUS_UNACCEPTABLE_OPCODE                    = 1003,
        LWS_CLOSE_STATUS_RESERVED                               = 1004,
        LWS_CLOSE_STATUS_NO_STATUS                              = 1005,
        LWS_CLOSE_STATUS_ABNORMAL_CLOSE                         = 1006,
        LWS_CLOSE_STATUS_INVALID_PAYLOAD                        = 1007,
        LWS_CLOSE_STATUS_POLICY_VIOLATION                       = 1008,
        LWS_CLOSE_STATUS_MESSAGE_TOO_LARGE                      = 1009,
        LWS_CLOSE_STATUS_EXTENSION_REQUIRED                     = 1010,
        LWS_CLOSE_STATUS_UNEXPECTED_CONDITION                   = 1011,
        LWS_CLOSE_STATUS_TLS_FAILURE                            = 1015,
        LWS_CLOSE_STATUS_CLIENT_TRANSACTION_DONE                = 2000,
 
        /****** add new things just above ---^ ******/
 
        LWS_CLOSE_STATUS_NOSTATUS_CONTEXT_DESTROY               = 9999,
};

Function Documentation

lws_close_reason()

LWS_VISIBLE LWS_EXTERN void lws_close_reason	(	struct lws *	wsi,
		enum lws_close_status	status,
		unsigned char *	buf,
		size_t	len
	)

#include <include/libwebsockets/lws-ws-close.h>

lws_close_reason - Set reason and aux data to send with Close packet If you are going to return nonzero from the callback requesting the connection to close, you can optionally call this to set the reason the peer will be told if possible.

Parameters

wsi	The websocket connection to set the close reason on
status	A valid close status from websocket standard
buf	NULL or buffer containing up to 124 bytes of auxiliary data
len	Length of data in buf to send