xref: /openbmc/qemu/ui/vnc-ws.h (revision a2bebfd6)
17536ee4bSTim Hardeck /*
27536ee4bSTim Hardeck  * QEMU VNC display driver: Websockets support
37536ee4bSTim Hardeck  *
47536ee4bSTim Hardeck  * Copyright (C) 2010 Joel Martin
57536ee4bSTim Hardeck  * Copyright (C) 2012 Tim Hardeck
67536ee4bSTim Hardeck  *
77536ee4bSTim Hardeck  * This is free software; you can redistribute it and/or modify
87536ee4bSTim Hardeck  * it under the terms of the GNU General Public License as published by
97536ee4bSTim Hardeck  * the Free Software Foundation; either version 2 of the License, or
107536ee4bSTim Hardeck  * (at your option) any later version.
117536ee4bSTim Hardeck  *
127536ee4bSTim Hardeck  * This software is distributed in the hope that it will be useful,
137536ee4bSTim Hardeck  * but WITHOUT ANY WARRANTY; without even the implied warranty of
147536ee4bSTim Hardeck  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
157536ee4bSTim Hardeck  * GNU General Public License for more details.
167536ee4bSTim Hardeck  *
177536ee4bSTim Hardeck  * You should have received a copy of the GNU General Public License
187536ee4bSTim Hardeck  * along with this software; if not, see <http://www.gnu.org/licenses/>.
197536ee4bSTim Hardeck  */
207536ee4bSTim Hardeck 
217536ee4bSTim Hardeck #ifndef __QEMU_UI_VNC_WS_H
227536ee4bSTim Hardeck #define __QEMU_UI_VNC_WS_H
237536ee4bSTim Hardeck 
247536ee4bSTim Hardeck #include <gnutls/gnutls.h>
257536ee4bSTim Hardeck 
267536ee4bSTim Hardeck #define B64LEN(__x) (((__x + 2) / 3) * 12 / 3)
277536ee4bSTim Hardeck #define SHA1_DIGEST_LEN 20
287536ee4bSTim Hardeck 
297536ee4bSTim Hardeck #define WS_ACCEPT_LEN (B64LEN(SHA1_DIGEST_LEN) + 1)
307536ee4bSTim Hardeck #define WS_CLIENT_KEY_LEN 24
317536ee4bSTim Hardeck #define WS_GUID "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"
327536ee4bSTim Hardeck #define WS_GUID_LEN strlen(WS_GUID)
337536ee4bSTim Hardeck 
347536ee4bSTim Hardeck #define WS_HANDSHAKE "HTTP/1.1 101 Switching Protocols\r\n\
357536ee4bSTim Hardeck Upgrade: websocket\r\n\
367536ee4bSTim Hardeck Connection: Upgrade\r\n\
377536ee4bSTim Hardeck Sec-WebSocket-Accept: %s\r\n\
387536ee4bSTim Hardeck Sec-WebSocket-Protocol: binary\r\n\
397536ee4bSTim Hardeck \r\n"
407536ee4bSTim Hardeck #define WS_HANDSHAKE_DELIM "\r\n"
417536ee4bSTim Hardeck #define WS_HANDSHAKE_END "\r\n\r\n"
427536ee4bSTim Hardeck #define WS_SUPPORTED_VERSION "13"
437536ee4bSTim Hardeck 
447536ee4bSTim Hardeck #define WS_HEAD_MIN_LEN sizeof(uint16_t)
457536ee4bSTim Hardeck #define WS_HEAD_MAX_LEN (WS_HEAD_MIN_LEN + sizeof(uint64_t) + sizeof(uint32_t))
467536ee4bSTim Hardeck 
477536ee4bSTim Hardeck typedef union WsMask {
487536ee4bSTim Hardeck     char c[4];
497536ee4bSTim Hardeck     uint32_t u;
507536ee4bSTim Hardeck } WsMask;
517536ee4bSTim Hardeck 
527536ee4bSTim Hardeck typedef struct QEMU_PACKED WsHeader {
537536ee4bSTim Hardeck     unsigned char b0;
547536ee4bSTim Hardeck     unsigned char b1;
557536ee4bSTim Hardeck     union {
567536ee4bSTim Hardeck         struct QEMU_PACKED {
577536ee4bSTim Hardeck             uint16_t l16;
587536ee4bSTim Hardeck             WsMask m16;
597536ee4bSTim Hardeck         } s16;
607536ee4bSTim Hardeck         struct QEMU_PACKED {
617536ee4bSTim Hardeck             uint64_t l64;
627536ee4bSTim Hardeck             WsMask m64;
637536ee4bSTim Hardeck         } s64;
647536ee4bSTim Hardeck         WsMask m;
657536ee4bSTim Hardeck     } u;
667536ee4bSTim Hardeck } WsHeader;
677536ee4bSTim Hardeck 
687536ee4bSTim Hardeck enum {
697536ee4bSTim Hardeck     WS_OPCODE_CONTINUATION = 0x0,
707536ee4bSTim Hardeck     WS_OPCODE_TEXT_FRAME = 0x1,
717536ee4bSTim Hardeck     WS_OPCODE_BINARY_FRAME = 0x2,
727536ee4bSTim Hardeck     WS_OPCODE_CLOSE = 0x8,
737536ee4bSTim Hardeck     WS_OPCODE_PING = 0x9,
747536ee4bSTim Hardeck     WS_OPCODE_PONG = 0xA
757536ee4bSTim Hardeck };
767536ee4bSTim Hardeck 
770057a0d5STim Hardeck #ifdef CONFIG_VNC_TLS
7851941e46SDaniel P. Berrange void vncws_tls_handshake_io(void *opaque);
790057a0d5STim Hardeck #endif /* CONFIG_VNC_TLS */
807536ee4bSTim Hardeck void vncws_handshake_read(void *opaque);
817536ee4bSTim Hardeck long vnc_client_write_ws(VncState *vs);
827536ee4bSTim Hardeck long vnc_client_read_ws(VncState *vs);
837536ee4bSTim Hardeck void vncws_process_handshake(VncState *vs, uint8_t *line, size_t size);
847536ee4bSTim Hardeck void vncws_encode_frame(Buffer *output, const void *payload,
857536ee4bSTim Hardeck             const size_t payload_size);
86*a2bebfd6SDaniel P. Berrange int vncws_decode_frame_header(Buffer *input,
87*a2bebfd6SDaniel P. Berrange                               size_t *header_size,
88*a2bebfd6SDaniel P. Berrange                               size_t *payload_remain,
89*a2bebfd6SDaniel P. Berrange                               WsMask *payload_mask);
90*a2bebfd6SDaniel P. Berrange int vncws_decode_frame_payload(Buffer *input,
91*a2bebfd6SDaniel P. Berrange                                size_t *payload_remain, WsMask *payload_mask,
92*a2bebfd6SDaniel P. Berrange                                uint8_t **payload, size_t *payload_size);
937536ee4bSTim Hardeck 
947536ee4bSTim Hardeck #endif /* __QEMU_UI_VNC_WS_H */
95