1/*
2 * libwebsockets - small server side websockets and web server implementation
3 *
4 * Copyright (C) 2010 - 2019 Andy Green <andy@warmcat.com>
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to
8 * deal in the Software without restriction, including without limitation the
9 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
10 * sell copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
21 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
22 * IN THE SOFTWARE.
23 */
24
25/** \defgroup wsstatus Websocket status APIs
26 * ##Websocket connection status APIs
27 *
28 * These provide information about ws connection or message status
29 */
30///@{
31/**
32 * lws_send_pipe_choked() - tests if socket is writable or not
33 * \param wsi: lws connection
34 *
35 * Allows you to check if you can write more on the socket
36 */
37LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
38lws_send_pipe_choked(struct lws *wsi);
39
40/**
41 * lws_is_final_fragment() - tests if last part of ws message
42 *
43 * \param wsi: lws connection
44 */
45LWS_VISIBLE LWS_EXTERN int
46lws_is_final_fragment(struct lws *wsi);
47
48/**
49 * lws_is_first_fragment() - tests if first part of ws message
50 *
51 * \param wsi: lws connection
52 */
53LWS_VISIBLE LWS_EXTERN int
54lws_is_first_fragment(struct lws *wsi);
55
56/**
57 * lws_get_reserved_bits() - access reserved bits of ws frame
58 * \param wsi: lws connection
59 */
60LWS_VISIBLE LWS_EXTERN unsigned char
61lws_get_reserved_bits(struct lws *wsi);
62
63/**
64 * lws_get_opcode() - access opcode of ws frame
65 * \param wsi: lws connection
66 */
67LWS_VISIBLE LWS_EXTERN uint8_t
68lws_get_opcode(struct lws *wsi);
69
70/**
71 * lws_partial_buffered() - find out if lws buffered the last write
72 * \param wsi: websocket connection to check
73 *
74 * Returns 1 if you cannot use lws_write because the last
75 * write on this connection is still buffered, and can't be cleared without
76 * returning to the service loop and waiting for the connection to be
77 * writeable again.
78 *
79 * If you will try to do >1 lws_write call inside a single
80 * WRITEABLE callback, you must check this after every write and bail if
81 * set, ask for a new writeable callback and continue writing from there.
82 *
83 * This is never set at the start of a writeable callback, but any write
84 * may set it.
85 */
86LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
87lws_partial_buffered(struct lws *wsi);
88
89/**
90 * lws_frame_is_binary(): true if the current frame was sent in binary mode
91 *
92 * \param wsi: the connection we are inquiring about
93 *
94 * This is intended to be called from the LWS_CALLBACK_RECEIVE callback if
95 * it's interested to see if the frame it's dealing with was sent in binary
96 * mode.
97 */
98LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
99lws_frame_is_binary(struct lws *wsi);
100///@}
101