| 1 | #ifndef CURLINC_WEBSOCKETS_H
|
|---|
| 2 | #define CURLINC_WEBSOCKETS_H
|
|---|
| 3 | /***************************************************************************
|
|---|
| 4 | * _ _ ____ _
|
|---|
| 5 | * Project ___| | | | _ \| |
|
|---|
| 6 | * / __| | | | |_) | |
|
|---|
| 7 | * | (__| |_| | _ <| |___
|
|---|
| 8 | * \___|\___/|_| \_\_____|
|
|---|
| 9 | *
|
|---|
| 10 | * Copyright (C) Daniel Stenberg, <[email protected]>, et al.
|
|---|
| 11 | *
|
|---|
| 12 | * This software is licensed as described in the file COPYING, which
|
|---|
| 13 | * you should have received as part of this distribution. The terms
|
|---|
| 14 | * are also available at https://curl.se/docs/copyright.html.
|
|---|
| 15 | *
|
|---|
| 16 | * You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
|---|
| 17 | * copies of the Software, and permit persons to whom the Software is
|
|---|
| 18 | * furnished to do so, under the terms of the COPYING file.
|
|---|
| 19 | *
|
|---|
| 20 | * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|---|
| 21 | * KIND, either express or implied.
|
|---|
| 22 | *
|
|---|
| 23 | * SPDX-License-Identifier: curl
|
|---|
| 24 | *
|
|---|
| 25 | ***************************************************************************/
|
|---|
| 26 |
|
|---|
| 27 | #ifdef __cplusplus
|
|---|
| 28 | extern "C" {
|
|---|
| 29 | #endif
|
|---|
| 30 |
|
|---|
| 31 | struct curl_ws_frame {
|
|---|
| 32 | int age; /* zero */
|
|---|
| 33 | int flags; /* See the CURLWS_* defines */
|
|---|
| 34 | curl_off_t offset; /* the offset of this data into the frame */
|
|---|
| 35 | curl_off_t bytesleft; /* number of pending bytes left of the payload */
|
|---|
| 36 | size_t len; /* size of the current data chunk */
|
|---|
| 37 | };
|
|---|
| 38 |
|
|---|
| 39 | /* flag bits */
|
|---|
| 40 | #define CURLWS_TEXT (1<<0)
|
|---|
| 41 | #define CURLWS_BINARY (1<<1)
|
|---|
| 42 | #define CURLWS_CONT (1<<2)
|
|---|
| 43 | #define CURLWS_CLOSE (1<<3)
|
|---|
| 44 | #define CURLWS_PING (1<<4)
|
|---|
| 45 | #define CURLWS_OFFSET (1<<5)
|
|---|
| 46 |
|
|---|
| 47 | /*
|
|---|
| 48 | * NAME curl_ws_recv()
|
|---|
| 49 | *
|
|---|
| 50 | * DESCRIPTION
|
|---|
| 51 | *
|
|---|
| 52 | * Receives data from the websocket connection. Use after successful
|
|---|
| 53 | * curl_easy_perform() with CURLOPT_CONNECT_ONLY option.
|
|---|
| 54 | */
|
|---|
| 55 | CURL_EXTERN CURLcode curl_ws_recv(CURL *curl, void *buffer, size_t buflen,
|
|---|
| 56 | size_t *recv,
|
|---|
| 57 | const struct curl_ws_frame **metap);
|
|---|
| 58 |
|
|---|
| 59 | /* flags for curl_ws_send() */
|
|---|
| 60 | #define CURLWS_PONG (1<<6)
|
|---|
| 61 |
|
|---|
| 62 | /*
|
|---|
| 63 | * NAME curl_ws_send()
|
|---|
| 64 | *
|
|---|
| 65 | * DESCRIPTION
|
|---|
| 66 | *
|
|---|
| 67 | * Sends data over the websocket connection. Use after successful
|
|---|
| 68 | * curl_easy_perform() with CURLOPT_CONNECT_ONLY option.
|
|---|
| 69 | */
|
|---|
| 70 | CURL_EXTERN CURLcode curl_ws_send(CURL *curl, const void *buffer,
|
|---|
| 71 | size_t buflen, size_t *sent,
|
|---|
| 72 | curl_off_t fragsize,
|
|---|
| 73 | unsigned int flags);
|
|---|
| 74 |
|
|---|
| 75 | /* bits for the CURLOPT_WS_OPTIONS bitmask: */
|
|---|
| 76 | #define CURLWS_RAW_MODE (1<<0)
|
|---|
| 77 |
|
|---|
| 78 | CURL_EXTERN const struct curl_ws_frame *curl_ws_meta(CURL *curl);
|
|---|
| 79 |
|
|---|
| 80 | #ifdef __cplusplus
|
|---|
| 81 | }
|
|---|
| 82 | #endif
|
|---|
| 83 |
|
|---|
| 84 | #endif /* CURLINC_WEBSOCKETS_H */
|
|---|
