FreeRDP
rdp.h
1 
21 #ifndef FREERDP_LIB_CORE_RDP_H
22 #define FREERDP_LIB_CORE_RDP_H
23 
24 #include <freerdp/config.h>
25 
26 #include "nla.h"
27 #include "aad.h"
28 #include "mcs.h"
29 #include "tpkt.h"
30 #include "../codec/bulk.h"
31 #include "fastpath.h"
32 #include "tpdu.h"
33 #include "nego.h"
34 #include "input.h"
35 #include "update.h"
36 #include "license.h"
37 #include "errinfo.h"
38 #include "autodetect.h"
39 #include "heartbeat.h"
40 #include "multitransport.h"
41 #include "security.h"
42 #include "transport.h"
43 #include "connection.h"
44 #include "redirection.h"
45 #include "capabilities.h"
46 #include "channels.h"
47 
48 #include <freerdp/freerdp.h>
49 #include <freerdp/settings.h>
50 #include <freerdp/log.h>
51 #include <freerdp/api.h>
52 
53 #include <winpr/stream.h>
54 #include <winpr/crypto.h>
55 
56 /* Security Header Flags */
57 #define SEC_EXCHANGE_PKT 0x0001
58 #define SEC_TRANSPORT_REQ 0x0002
59 #define SEC_TRANSPORT_RSP 0x0004
60 #define SEC_ENCRYPT 0x0008
61 #define SEC_RESET_SEQNO 0x0010
62 #define SEC_IGNORE_SEQNO 0x0020
63 #define SEC_INFO_PKT 0x0040
64 #define SEC_LICENSE_PKT 0x0080
65 #define SEC_LICENSE_ENCRYPT_CS 0x0200
66 #define SEC_LICENSE_ENCRYPT_SC 0x0200
67 #define SEC_REDIRECTION_PKT 0x0400
68 #define SEC_SECURE_CHECKSUM 0x0800
69 #define SEC_AUTODETECT_REQ 0x1000
70 #define SEC_AUTODETECT_RSP 0x2000
71 #define SEC_HEARTBEAT 0x4000
72 #define SEC_FLAGSHI_VALID 0x8000
73 
74 #define SEC_PKT_CS_MASK (SEC_EXCHANGE_PKT | SEC_INFO_PKT)
75 #define SEC_PKT_SC_MASK (SEC_LICENSE_PKT | SEC_REDIRECTION_PKT)
76 #define SEC_PKT_MASK (SEC_PKT_CS_MASK | SEC_PKT_SC_MASK)
77 
78 #define RDP_SECURITY_HEADER_LENGTH 4
79 #define RDP_SHARE_CONTROL_HEADER_LENGTH 6
80 #define RDP_SHARE_DATA_HEADER_LENGTH 12
81 #define RDP_PACKET_HEADER_MAX_LENGTH (TPDU_DATA_LENGTH + MCS_SEND_DATA_HEADER_MAX_LENGTH)
82 
83 #define PDU_TYPE_DEMAND_ACTIVE 0x1
84 #define PDU_TYPE_CONFIRM_ACTIVE 0x3
85 #define PDU_TYPE_DEACTIVATE_ALL 0x6
86 #define PDU_TYPE_DATA 0x7
87 #define PDU_TYPE_SERVER_REDIRECTION 0xA
88 
89 #define PDU_TYPE_FLOW_TEST 0x41
90 #define PDU_TYPE_FLOW_RESPONSE 0x42
91 #define PDU_TYPE_FLOW_STOP 0x43
92 
93 typedef enum
94 {
95  FINALIZE_SC_SYNCHRONIZE_PDU = 0x01,
96  FINALIZE_SC_CONTROL_COOPERATE_PDU = 0x02,
97  FINALIZE_SC_CONTROL_GRANTED_PDU = 0x04,
98  FINALIZE_SC_FONT_MAP_PDU = 0x08,
99 
100  FINALIZE_CS_SYNCHRONIZE_PDU = 0x10,
101  FINALIZE_CS_CONTROL_COOPERATE_PDU = 0x20,
102  FINALIZE_CS_CONTROL_REQUEST_PDU = 0x40,
103  FINALIZE_CS_PERSISTENT_KEY_LIST_PDU = 0x80,
104  FINALIZE_CS_FONT_LIST_PDU = 0x100,
105 
106  FINALIZE_DEACTIVATE_REACTIVATE = 0x200
107 } rdpFinalizePduType;
108 
109 /* Data PDU Types */
110 typedef enum
111 {
112  DATA_PDU_TYPE_UPDATE = 0x02,
113  DATA_PDU_TYPE_CONTROL = 0x14,
114  DATA_PDU_TYPE_POINTER = 0x1B,
115  DATA_PDU_TYPE_INPUT = 0x1C,
116  DATA_PDU_TYPE_SYNCHRONIZE = 0x1F,
117  DATA_PDU_TYPE_REFRESH_RECT = 0x21,
118  DATA_PDU_TYPE_PLAY_SOUND = 0x22,
119  DATA_PDU_TYPE_SUPPRESS_OUTPUT = 0x23,
120  DATA_PDU_TYPE_SHUTDOWN_REQUEST = 0x24,
121  DATA_PDU_TYPE_SHUTDOWN_DENIED = 0x25,
122  DATA_PDU_TYPE_SAVE_SESSION_INFO = 0x26,
123  DATA_PDU_TYPE_FONT_LIST = 0x27,
124  DATA_PDU_TYPE_FONT_MAP = 0x28,
125  DATA_PDU_TYPE_SET_KEYBOARD_INDICATORS = 0x29,
126  DATA_PDU_TYPE_BITMAP_CACHE_PERSISTENT_LIST = 0x2B,
127  DATA_PDU_TYPE_BITMAP_CACHE_ERROR = 0x2C,
128  DATA_PDU_TYPE_SET_KEYBOARD_IME_STATUS = 0x2D,
129  DATA_PDU_TYPE_OFFSCREEN_CACHE_ERROR = 0x2E,
130  DATA_PDU_TYPE_SET_ERROR_INFO = 0x2F,
131  DATA_PDU_TYPE_DRAW_NINEGRID_ERROR = 0x30,
132  DATA_PDU_TYPE_DRAW_GDIPLUS_ERROR = 0x31,
133  DATA_PDU_TYPE_ARC_STATUS = 0x32,
134  DATA_PDU_TYPE_STATUS_INFO = 0x36,
135  DATA_PDU_TYPE_MONITOR_LAYOUT = 0x37,
136  DATA_PDU_TYPE_FRAME_ACKNOWLEDGE = 0x38
137 } rdpPduType;
138 
139 /* Stream Identifiers */
140 #define STREAM_UNDEFINED 0x00
141 #define STREAM_LOW 0x01
142 #define STREAM_MED 0x02
143 #define STREAM_HI 0x04
144 
145 struct rdp_rdp
146 {
147  CONNECTION_STATE state;
148  rdpContext* context;
149  rdpNla* nla;
150  rdpAad* aad;
151  rdpMcs* mcs;
152  rdpNego* nego;
153  rdpBulk* bulk;
154  rdpInput* input;
155  rdpUpdate* update;
156  rdpFastPath* fastpath;
157  rdpLicense* license;
158  rdpRedirection* redirection;
159  rdpSettings* settings;
160  rdpSettings* originalSettings;
161  rdpSettings* remoteSettings;
162  rdpTransport* transport;
163  rdpAutoDetect* autodetect;
164  rdpHeartbeat* heartbeat;
165  rdpMultitransport* multitransport;
166  WINPR_RC4_CTX* rc4_decrypt_key;
167  UINT32 decrypt_use_count;
168  UINT32 decrypt_checksum_use_count;
169  WINPR_RC4_CTX* rc4_encrypt_key;
170  UINT32 encrypt_use_count;
171  UINT32 encrypt_checksum_use_count;
172  WINPR_CIPHER_CTX* fips_encrypt;
173  WINPR_CIPHER_CTX* fips_decrypt;
174  UINT32 sec_flags;
175  BOOL do_crypt;
176  BOOL do_crypt_license;
177  BOOL do_secure_checksum;
178  BYTE sign_key[16];
179  BYTE decrypt_key[16];
180  BYTE encrypt_key[16];
181  BYTE decrypt_update_key[16];
182  BYTE encrypt_update_key[16];
183  size_t rc4_key_len;
184  BYTE fips_sign_key[20];
185  BYTE fips_encrypt_key[24];
186  BYTE fips_decrypt_key[24];
187  UINT32 errorInfo;
188  UINT32 finalize_sc_pdus;
189  BOOL resendFocus;
190 
191  UINT64 inBytes;
192  UINT64 inPackets;
193  UINT64 outBytes;
194  UINT64 outPackets;
195  CRITICAL_SECTION critical;
196  rdpTransportIo* io;
197  void* ioContext;
198  HANDLE abortEvent;
199 
200  wPubSub* pubSub;
201 
202  BOOL monitor_layout_pdu;
203  BOOL was_deactivated;
204  UINT32 deactivated_width;
205  UINT32 deactivated_height;
206 
207  wLog* log;
208  char log_context[64];
209 };
210 
211 FREERDP_LOCAL BOOL rdp_read_security_header(rdpRdp* rdp, wStream* s, UINT16* flags, UINT16* length);
212 FREERDP_LOCAL BOOL rdp_write_security_header(rdpRdp* rdp, wStream* s, UINT16 flags);
213 
214 FREERDP_LOCAL BOOL rdp_read_share_control_header(rdpRdp* rdp, wStream* s, UINT16* tpktLength,
215  UINT16* remainingLength, UINT16* type,
216  UINT16* channel_id);
217 
218 FREERDP_LOCAL BOOL rdp_read_share_data_header(rdpRdp* rdp, wStream* s, UINT16* length, BYTE* type,
219  UINT32* share_id, BYTE* compressed_type,
220  UINT16* compressed_len);
221 
222 FREERDP_LOCAL wStream* rdp_send_stream_init(rdpRdp* rdp);
223 FREERDP_LOCAL wStream* rdp_send_stream_pdu_init(rdpRdp* rdp);
224 
225 FREERDP_LOCAL BOOL rdp_read_header(rdpRdp* rdp, wStream* s, UINT16* length, UINT16* channel_id);
226 FREERDP_LOCAL BOOL rdp_write_header(rdpRdp* rdp, wStream* s, size_t length, UINT16 channel_id);
227 
228 FREERDP_LOCAL BOOL rdp_send_pdu(rdpRdp* rdp, wStream* s, UINT16 type, UINT16 channel_id);
229 
230 FREERDP_LOCAL wStream* rdp_data_pdu_init(rdpRdp* rdp);
231 FREERDP_LOCAL BOOL rdp_send_data_pdu(rdpRdp* rdp, wStream* s, BYTE type, UINT16 channel_id);
232 FREERDP_LOCAL state_run_t rdp_recv_data_pdu(rdpRdp* rdp, wStream* s);
233 
234 FREERDP_LOCAL BOOL rdp_send(rdpRdp* rdp, wStream* s, UINT16 channelId);
235 
236 FREERDP_LOCAL BOOL rdp_send_channel_data(rdpRdp* rdp, UINT16 channelId, const BYTE* data,
237  size_t size);
238 FREERDP_LOCAL BOOL rdp_channel_send_packet(rdpRdp* rdp, UINT16 channelId, size_t totalSize,
239  UINT32 flags, const BYTE* data, size_t chunkSize);
240 
241 FREERDP_LOCAL wStream* rdp_message_channel_pdu_init(rdpRdp* rdp);
242 FREERDP_LOCAL BOOL rdp_send_message_channel_pdu(rdpRdp* rdp, wStream* s, UINT16 sec_flags);
243 FREERDP_LOCAL state_run_t rdp_recv_message_channel_pdu(rdpRdp* rdp, wStream* s,
244  UINT16 securityFlags);
245 
246 FREERDP_LOCAL state_run_t rdp_recv_out_of_sequence_pdu(rdpRdp* rdp, wStream* s, UINT16 pduType,
247  UINT16 length);
248 
249 FREERDP_LOCAL state_run_t rdp_recv_callback(rdpTransport* transport, wStream* s, void* extra);
250 
251 FREERDP_LOCAL int rdp_check_fds(rdpRdp* rdp);
252 
253 FREERDP_LOCAL void rdp_free(rdpRdp* rdp);
254 
255 WINPR_ATTR_MALLOC(rdp_free, 1)
256 FREERDP_LOCAL rdpRdp* rdp_new(rdpContext* context);
257 FREERDP_LOCAL BOOL rdp_reset(rdpRdp* rdp);
258 
259 FREERDP_LOCAL BOOL rdp_io_callback_set_event(rdpRdp* rdp, BOOL reset);
260 
261 FREERDP_LOCAL const rdpTransportIo* rdp_get_io_callbacks(rdpRdp* rdp);
262 FREERDP_LOCAL BOOL rdp_set_io_callbacks(rdpRdp* rdp, const rdpTransportIo* io_callbacks);
263 
264 FREERDP_LOCAL BOOL rdp_set_io_callback_context(rdpRdp* rdp, void* usercontext);
265 FREERDP_LOCAL void* rdp_get_io_callback_context(rdpRdp* rdp);
266 
267 #define RDP_TAG FREERDP_TAG("core.rdp")
268 #ifdef WITH_DEBUG_RDP
269 #define DEBUG_RDP(rdp, ...) WLog_Print(rdp->log, WLOG_DEBUG, __VA_ARGS__)
270 #else
271 #define DEBUG_RDP(rdp, ...) \
272  do \
273  { \
274  } while (0)
275 #endif
276 
277 const char* data_pdu_type_to_string(UINT8 type);
278 const char* pdu_type_to_str(UINT16 pduType, char* buffer, size_t length);
279 
280 BOOL rdp_finalize_reset_flags(rdpRdp* rdp, BOOL clearAll);
281 BOOL rdp_finalize_set_flag(rdpRdp* rdp, UINT32 flag);
282 BOOL rdp_finalize_is_flag_set(rdpRdp* rdp, UINT32 flag);
283 const char* rdp_finalize_flags_to_str(UINT32 flags, char* buffer, size_t size);
284 
285 BOOL rdp_decrypt(rdpRdp* rdp, wStream* s, UINT16* pLength, UINT16 securityFlags);
286 
287 BOOL rdp_set_error_info(rdpRdp* rdp, UINT32 errorInfo);
288 BOOL rdp_send_error_info(rdpRdp* rdp);
289 
290 void rdp_free_rc4_encrypt_keys(rdpRdp* rdp);
291 BOOL rdp_reset_rc4_encrypt_keys(rdpRdp* rdp);
292 
293 void rdp_free_rc4_decrypt_keys(rdpRdp* rdp);
294 BOOL rdp_reset_rc4_decrypt_keys(rdpRdp* rdp);
295 
296 const char* rdp_security_flag_string(UINT32 securityFlags, char* buffer, size_t size);
297 
298 BOOL rdp_set_backup_settings(rdpRdp* rdp);
299 BOOL rdp_reset_runtime_settings(rdpRdp* rdp);
300 
301 void rdp_log_build_warnings(rdpRdp* rdp);
302 
303 #endif /* FREERDP_LIB_CORE_RDP_H */
RTL_CRITICAL_SECTION
Definition: include/winpr/synch.h:158
rdp_rdp
Definition: rdp.h:146