2 Unix SMB/CIFS implementation.
3 Infrastructure for async SMB client requests
4 Copyright (C) Volker Lendecke 2008
5 Copyright (C) Stefan Metzmacher 2011
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>.
21 #ifndef _SMBXCLI_BASE_H_
22 #define _SMBXCLI_BASE_H_
24 #define SMB_SUICIDE_PACKET 0x74697865
28 #include "libcli/smb/smb_constants.h"
29 #include "libcli/util/ntstatus.h"
30 #include "lib/util/time.h"
31 #include "lib/util/data_blob.h"
34 struct smbXcli_session
;
36 struct smb_trans_enc_state
;
39 struct smb2_create_blobs
;
40 struct smb_create_returns
;
41 struct smb311_capabilities
;
43 struct smbXcli_conn
*smbXcli_conn_create(TALLOC_CTX
*mem_ctx
,
45 const char *remote_name
,
46 enum smb_signing_setting signing_state
,
47 uint32_t smb1_capabilities
,
48 struct GUID
*client_guid
,
49 uint32_t smb2_capabilities
,
50 const struct smb311_capabilities
*smb3_capabilities
);
52 bool smbXcli_conn_is_connected(struct smbXcli_conn
*conn
);
53 void smbXcli_conn_disconnect(struct smbXcli_conn
*conn
, NTSTATUS status
);
55 struct tevent_queue
*smbXcli_conn_send_queue(struct smbXcli_conn
*conn
);
56 bool smbXcli_conn_has_async_calls(struct smbXcli_conn
*conn
);
58 bool smbXcli_conn_dfs_supported(struct smbXcli_conn
*conn
);
60 enum protocol_types
smbXcli_conn_protocol(struct smbXcli_conn
*conn
);
61 bool smbXcli_conn_use_unicode(struct smbXcli_conn
*conn
);
62 bool smbXcli_conn_signing_mandatory(struct smbXcli_conn
*conn
);
63 bool smbXcli_conn_have_posix(struct smbXcli_conn
*conn
);
64 bool smbXcli_conn_support_passthrough(struct smbXcli_conn
*conn
);
66 void smbXcli_conn_set_sockopt(struct smbXcli_conn
*conn
, const char *options
);
67 const struct sockaddr_storage
*smbXcli_conn_local_sockaddr(struct smbXcli_conn
*conn
);
68 const struct sockaddr_storage
*smbXcli_conn_remote_sockaddr(struct smbXcli_conn
*conn
);
69 const char *smbXcli_conn_remote_name(struct smbXcli_conn
*conn
);
71 uint16_t smbXcli_conn_max_requests(struct smbXcli_conn
*conn
);
72 NTTIME
smbXcli_conn_server_system_time(struct smbXcli_conn
*conn
);
73 const DATA_BLOB
*smbXcli_conn_server_gss_blob(struct smbXcli_conn
*conn
);
74 const struct GUID
*smbXcli_conn_server_guid(struct smbXcli_conn
*conn
);
75 bool smbXcli_conn_get_force_channel_sequence(struct smbXcli_conn
*conn
);
76 void smbXcli_conn_set_force_channel_sequence(struct smbXcli_conn
*conn
,
80 struct tevent_req
*smbXcli_conn_samba_suicide_send(TALLOC_CTX
*mem_ctx
,
81 struct tevent_context
*ev
,
82 struct smbXcli_conn
*conn
,
84 NTSTATUS
smbXcli_conn_samba_suicide_recv(struct tevent_req
*req
);
85 NTSTATUS
smbXcli_conn_samba_suicide(struct smbXcli_conn
*conn
,
88 void smbXcli_req_unset_pending(struct tevent_req
*req
);
89 bool smbXcli_req_set_pending(struct tevent_req
*req
);
90 struct timeval
smbXcli_req_endtime(struct tevent_req
*req
);
92 uint32_t smb1cli_conn_capabilities(struct smbXcli_conn
*conn
);
93 uint32_t smb1cli_conn_max_xmit(struct smbXcli_conn
*conn
);
94 bool smb1cli_conn_req_possible(struct smbXcli_conn
*conn
);
95 uint32_t smb1cli_conn_server_session_key(struct smbXcli_conn
*conn
);
96 const uint8_t *smb1cli_conn_server_challenge(struct smbXcli_conn
*conn
);
97 uint16_t smb1cli_conn_server_security_mode(struct smbXcli_conn
*conn
);
98 bool smb1cli_conn_server_readbraw(struct smbXcli_conn
*conn
);
99 bool smb1cli_conn_server_writebraw(struct smbXcli_conn
*conn
);
100 bool smb1cli_conn_server_lockread(struct smbXcli_conn
*conn
);
101 bool smb1cli_conn_server_writeunlock(struct smbXcli_conn
*conn
);
102 int smb1cli_conn_server_time_zone(struct smbXcli_conn
*conn
);
104 bool smb1cli_conn_activate_signing(struct smbXcli_conn
*conn
,
105 const DATA_BLOB user_session_key
,
106 const DATA_BLOB response
);
107 bool smb1cli_conn_check_signing(struct smbXcli_conn
*conn
,
108 const uint8_t *buf
, uint32_t seqnum
);
109 bool smb1cli_conn_signing_is_active(struct smbXcli_conn
*conn
);
111 void smb1cli_conn_set_encryption(struct smbXcli_conn
*conn
,
112 struct smb_trans_enc_state
*es
);
113 bool smb1cli_conn_encryption_on(struct smbXcli_conn
*conn
);
115 bool smb1cli_is_andx_req(uint8_t cmd
);
116 size_t smb1cli_req_wct_ofs(struct tevent_req
**reqs
, int num_reqs
);
118 uint16_t smb1cli_req_mid(struct tevent_req
*req
);
119 void smb1cli_req_set_mid(struct tevent_req
*req
, uint16_t mid
);
121 uint32_t smb1cli_req_seqnum(struct tevent_req
*req
);
122 void smb1cli_req_set_seqnum(struct tevent_req
*req
, uint32_t seqnum
);
124 struct smb1cli_req_expected_response
{
129 struct tevent_req
*smb1cli_req_create(TALLOC_CTX
*mem_ctx
,
130 struct tevent_context
*ev
,
131 struct smbXcli_conn
*conn
,
133 uint8_t additional_flags
,
135 uint16_t additional_flags2
,
136 uint16_t clear_flags2
,
137 uint32_t timeout_msec
,
139 struct smbXcli_tcon
*tcon
,
140 struct smbXcli_session
*session
,
141 uint8_t wct
, uint16_t *vwv
,
143 struct iovec
*bytes_iov
);
144 NTSTATUS
smb1cli_req_chain_submit(struct tevent_req
**reqs
, int num_reqs
);
146 struct tevent_req
*smb1cli_req_send(TALLOC_CTX
*mem_ctx
,
147 struct tevent_context
*ev
,
148 struct smbXcli_conn
*conn
,
150 uint8_t additional_flags
,
152 uint16_t additional_flags2
,
153 uint16_t clear_flags2
,
154 uint32_t timeout_msec
,
156 struct smbXcli_tcon
*tcon
,
157 struct smbXcli_session
*session
,
158 uint8_t wct
, uint16_t *vwv
,
160 const uint8_t *bytes
);
161 NTSTATUS
smb1cli_req_recv(struct tevent_req
*req
,
167 uint32_t *pvwv_offset
,
168 uint32_t *pnum_bytes
,
170 uint32_t *pbytes_offset
,
172 const struct smb1cli_req_expected_response
*expected
,
173 size_t num_expected
);
175 struct tevent_req
*smb1cli_trans_send(
176 TALLOC_CTX
*mem_ctx
, struct tevent_context
*ev
,
177 struct smbXcli_conn
*conn
, uint8_t cmd
,
178 uint8_t additional_flags
, uint8_t clear_flags
,
179 uint16_t additional_flags2
, uint16_t clear_flags2
,
180 uint32_t timeout_msec
,
182 struct smbXcli_tcon
*tcon
,
183 struct smbXcli_session
*session
,
184 const char *pipe_name
, uint16_t fid
, uint16_t function
, int flags
,
185 uint16_t *setup
, uint8_t num_setup
, uint8_t max_setup
,
186 uint8_t *param
, uint32_t num_param
, uint32_t max_param
,
187 uint8_t *data
, uint32_t num_data
, uint32_t max_data
);
188 NTSTATUS
smb1cli_trans_recv(struct tevent_req
*req
, TALLOC_CTX
*mem_ctx
,
189 uint16_t *recv_flags2
,
190 uint16_t **setup
, uint8_t min_setup
,
192 uint8_t **param
, uint32_t min_param
,
194 uint8_t **data
, uint32_t min_data
,
196 NTSTATUS
smb1cli_trans(TALLOC_CTX
*mem_ctx
, struct smbXcli_conn
*conn
,
198 uint8_t additional_flags
, uint8_t clear_flags
,
199 uint16_t additional_flags2
, uint16_t clear_flags2
,
200 uint32_t timeout_msec
,
202 struct smbXcli_tcon
*tcon
,
203 struct smbXcli_session
*session
,
204 const char *pipe_name
, uint16_t fid
, uint16_t function
,
206 uint16_t *setup
, uint8_t num_setup
, uint8_t max_setup
,
207 uint8_t *param
, uint32_t num_param
, uint32_t max_param
,
208 uint8_t *data
, uint32_t num_data
, uint32_t max_data
,
209 uint16_t *recv_flags2
,
210 uint16_t **rsetup
, uint8_t min_rsetup
, uint8_t *num_rsetup
,
211 uint8_t **rparam
, uint32_t min_rparam
, uint32_t *num_rparam
,
212 uint8_t **rdata
, uint32_t min_rdata
, uint32_t *num_rdata
);
214 struct tevent_req
*smb1cli_echo_send(TALLOC_CTX
*mem_ctx
,
215 struct tevent_context
*ev
,
216 struct smbXcli_conn
*conn
,
217 uint32_t timeout_msec
,
220 NTSTATUS
smb1cli_echo_recv(struct tevent_req
*req
);
221 NTSTATUS
smb1cli_echo(struct smbXcli_conn
*conn
, uint32_t timeout_msec
,
222 uint16_t num_echos
, DATA_BLOB data
);
224 struct tevent_req
*smb1cli_session_setup_lm21_send(TALLOC_CTX
*mem_ctx
,
225 struct tevent_context
*ev
,
226 struct smbXcli_conn
*conn
,
227 uint32_t timeout_msec
,
229 struct smbXcli_session
*session
,
230 uint16_t in_buf_size
,
233 uint32_t in_sess_key
,
235 const char *in_domain
,
236 const DATA_BLOB in_password
,
237 const char *in_native_os
,
238 const char *in_native_lm
);
239 NTSTATUS
smb1cli_session_setup_lm21_recv(struct tevent_req
*req
,
241 char **out_native_os
,
242 char **out_native_lm
);
243 struct tevent_req
*smb1cli_session_setup_nt1_send(TALLOC_CTX
*mem_ctx
,
244 struct tevent_context
*ev
,
245 struct smbXcli_conn
*conn
,
246 uint32_t timeout_msec
,
248 struct smbXcli_session
*session
,
249 uint16_t in_buf_size
,
252 uint32_t in_sess_key
,
254 const char *in_domain
,
255 const DATA_BLOB in_apassword
,
256 const DATA_BLOB in_upassword
,
257 uint32_t in_capabilities
,
258 const char *in_native_os
,
259 const char *in_native_lm
);
260 NTSTATUS
smb1cli_session_setup_nt1_recv(struct tevent_req
*req
,
262 struct iovec
**precv_iov
,
263 const uint8_t **precv_inbuf
,
264 char **out_native_os
,
265 char **out_native_lm
,
266 char **out_primary_domain
);
267 struct tevent_req
*smb1cli_session_setup_ext_send(TALLOC_CTX
*mem_ctx
,
268 struct tevent_context
*ev
,
269 struct smbXcli_conn
*conn
,
270 uint32_t timeout_msec
,
272 struct smbXcli_session
*session
,
273 uint16_t in_buf_size
,
276 uint32_t in_sess_key
,
277 const DATA_BLOB in_security_blob
,
278 uint32_t in_capabilities
,
279 const char *in_native_os
,
280 const char *in_native_lm
);
281 NTSTATUS
smb1cli_session_setup_ext_recv(struct tevent_req
*req
,
283 struct iovec
**precv_iov
,
284 const uint8_t **precv_inbuf
,
285 DATA_BLOB
*out_security_blob
,
286 char **out_native_os
,
287 char **out_native_lm
);
289 struct tevent_req
*smb1cli_ntcreatex_send(TALLOC_CTX
*mem_ctx
,
290 struct tevent_context
*ev
,
291 struct smbXcli_conn
*conn
,
292 uint32_t timeout_msec
,
294 struct smbXcli_tcon
*tcon
,
295 struct smbXcli_session
*session
,
298 uint32_t RootDirectoryFid
,
299 uint32_t DesiredAccess
,
300 uint64_t AllocationSize
,
301 uint32_t FileAttributes
,
302 uint32_t ShareAccess
,
303 uint32_t CreateDisposition
,
304 uint32_t CreateOptions
,
305 uint32_t ImpersonationLevel
,
306 uint8_t SecurityFlags
);
307 NTSTATUS
smb1cli_ntcreatex_recv(struct tevent_req
*req
, uint16_t *pfnum
);
308 NTSTATUS
smb1cli_ntcreatex(struct smbXcli_conn
*conn
,
309 uint32_t timeout_msec
,
311 struct smbXcli_tcon
*tcon
,
312 struct smbXcli_session
*session
,
315 uint32_t RootDirectoryFid
,
316 uint32_t DesiredAccess
,
317 uint64_t AllocationSize
,
318 uint32_t FileAttributes
,
319 uint32_t ShareAccess
,
320 uint32_t CreateDisposition
,
321 uint32_t CreateOptions
,
322 uint32_t ImpersonationLevel
,
323 uint8_t SecurityFlags
,
325 struct tevent_req
*smb1cli_close_send(TALLOC_CTX
*mem_ctx
,
326 struct tevent_context
*ev
,
327 struct smbXcli_conn
*conn
,
328 uint32_t timeout_msec
,
330 struct smbXcli_tcon
*tcon
,
331 struct smbXcli_session
*session
,
333 uint32_t last_modified
);
334 NTSTATUS
smb1cli_close_recv(struct tevent_req
*req
);
335 NTSTATUS
smb1cli_close(struct smbXcli_conn
*conn
,
336 uint32_t timeout_msec
,
338 struct smbXcli_tcon
*tcon
,
339 struct smbXcli_session
*session
,
341 uint32_t last_modified
);
342 struct tevent_req
*smb1cli_writex_send(TALLOC_CTX
*mem_ctx
,
343 struct tevent_context
*ev
,
344 struct smbXcli_conn
*conn
,
345 uint32_t timeout_msec
,
347 struct smbXcli_tcon
*tcon
,
348 struct smbXcli_session
*session
,
354 NTSTATUS
smb1cli_writex_recv(struct tevent_req
*req
,
356 uint16_t *pavailable
);
357 NTSTATUS
smb1cli_writex(struct smbXcli_conn
*conn
,
358 uint32_t timeout_msec
,
360 struct smbXcli_tcon
*tcon
,
361 struct smbXcli_session
*session
,
368 uint16_t *pavailable
);
369 struct tevent_req
*smb1cli_readx_send(TALLOC_CTX
*mem_ctx
,
370 struct tevent_context
*ev
,
371 struct smbXcli_conn
*conn
,
372 uint32_t timeout_msec
,
374 struct smbXcli_tcon
*tcon
,
375 struct smbXcli_session
*session
,
379 NTSTATUS
smb1cli_readx_recv(struct tevent_req
*req
,
383 bool smb2cli_conn_req_possible(struct smbXcli_conn
*conn
, uint32_t *max_dyn_len
);
384 uint32_t smb2cli_conn_server_capabilities(struct smbXcli_conn
*conn
);
385 uint16_t smb2cli_conn_server_security_mode(struct smbXcli_conn
*conn
);
386 uint16_t smb2cli_conn_server_signing_algo(struct smbXcli_conn
*conn
);
387 uint16_t smb2cli_conn_server_encryption_algo(struct smbXcli_conn
*conn
);
388 uint32_t smb2cli_conn_max_trans_size(struct smbXcli_conn
*conn
);
389 uint32_t smb2cli_conn_max_read_size(struct smbXcli_conn
*conn
);
390 uint32_t smb2cli_conn_max_write_size(struct smbXcli_conn
*conn
);
391 void smb2cli_conn_set_max_credits(struct smbXcli_conn
*conn
,
392 uint16_t max_credits
);
393 uint16_t smb2cli_conn_get_cur_credits(struct smbXcli_conn
*conn
);
394 uint8_t smb2cli_conn_get_io_priority(struct smbXcli_conn
*conn
);
395 void smb2cli_conn_set_io_priority(struct smbXcli_conn
*conn
,
396 uint8_t io_priority
);
397 uint32_t smb2cli_conn_cc_chunk_len(struct smbXcli_conn
*conn
);
398 void smb2cli_conn_set_cc_chunk_len(struct smbXcli_conn
*conn
,
400 uint32_t smb2cli_conn_cc_max_chunks(struct smbXcli_conn
*conn
);
401 void smb2cli_conn_set_cc_max_chunks(struct smbXcli_conn
*conn
,
402 uint32_t max_chunks
);
403 void smb2cli_conn_set_mid(struct smbXcli_conn
*conn
, uint64_t mid
);
404 uint64_t smb2cli_conn_get_mid(struct smbXcli_conn
*conn
);
406 NTSTATUS
smb2cli_parse_dyn_buffer(uint32_t dyn_offset
,
407 const DATA_BLOB dyn_buffer
,
409 uint32_t buffer_offset
,
410 uint32_t buffer_length
,
412 uint32_t *next_offset
,
415 struct tevent_req
*smb2cli_req_create(TALLOC_CTX
*mem_ctx
,
416 struct tevent_context
*ev
,
417 struct smbXcli_conn
*conn
,
419 uint32_t additional_flags
,
420 uint32_t clear_flags
,
421 uint32_t timeout_msec
,
422 struct smbXcli_tcon
*tcon
,
423 struct smbXcli_session
*session
,
424 const uint8_t *fixed
,
428 uint32_t max_dyn_len
);
429 void smb2cli_req_set_notify_async(struct tevent_req
*req
);
430 NTSTATUS
smb2cli_req_compound_submit(struct tevent_req
**reqs
,
432 void smb2cli_req_set_credit_charge(struct tevent_req
*req
, uint16_t charge
);
434 struct smb2cli_req_expected_response
{
439 struct tevent_req
*smb2cli_req_send(TALLOC_CTX
*mem_ctx
,
440 struct tevent_context
*ev
,
441 struct smbXcli_conn
*conn
,
443 uint32_t additional_flags
,
444 uint32_t clear_flags
,
445 uint32_t timeout_msec
,
446 struct smbXcli_tcon
*tcon
,
447 struct smbXcli_session
*session
,
448 const uint8_t *fixed
,
452 uint32_t max_dyn_len
);
453 NTSTATUS
smb2cli_req_recv(struct tevent_req
*req
, TALLOC_CTX
*mem_ctx
,
455 const struct smb2cli_req_expected_response
*expected
,
456 size_t num_expected
);
459 * This expects an iov[3] array, that is filled with references to
460 * the buffers used for the sending the requests into the socket.
462 * This can only be called after smb2cli_req_recv(subreq) before
463 * the TALLOC_FREE(subreq).
465 NTSTATUS
smb2cli_req_get_sent_iov(struct tevent_req
*req
,
466 struct iovec
*sent_iov
);
468 struct smb2_negotiate_contexts
;
469 struct tevent_req
*smbXcli_negprot_send(TALLOC_CTX
*mem_ctx
,
470 struct tevent_context
*ev
,
471 struct smbXcli_conn
*conn
,
472 uint32_t timeout_msec
,
473 enum protocol_types min_protocol
,
474 enum protocol_types max_protocol
,
475 uint16_t max_credits
,
476 struct smb2_negotiate_contexts
*in_ctx
);
477 NTSTATUS
smbXcli_negprot_recv(
478 struct tevent_req
*req
,
480 struct smb2_negotiate_contexts
**out_ctx
);
481 NTSTATUS
smbXcli_negprot(struct smbXcli_conn
*conn
,
482 uint32_t timeout_msec
,
483 enum protocol_types min_protocol
,
484 enum protocol_types max_protocol
,
485 struct smb2_negotiate_contexts
*in_ctx
,
487 struct smb2_negotiate_contexts
**out_ctx
);
489 struct tevent_req
*smb2cli_validate_negotiate_info_send(TALLOC_CTX
*mem_ctx
,
490 struct tevent_context
*ev
,
491 struct smbXcli_conn
*conn
,
492 uint32_t timeout_msec
,
493 struct smbXcli_session
*session
,
494 struct smbXcli_tcon
*tcon
);
495 NTSTATUS
smb2cli_validate_negotiate_info_recv(struct tevent_req
*req
);
497 struct smbXcli_session
*smbXcli_session_create(TALLOC_CTX
*mem_ctx
,
498 struct smbXcli_conn
*conn
);
499 struct smbXcli_session
*smbXcli_session_shallow_copy(TALLOC_CTX
*mem_ctx
,
500 struct smbXcli_session
*src
);
501 bool smbXcli_session_is_guest(struct smbXcli_session
*session
);
502 bool smbXcli_session_is_authenticated(struct smbXcli_session
*session
);
503 NTSTATUS
smb2cli_session_signing_key(struct smbXcli_session
*session
,
506 NTSTATUS
smb2cli_session_encryption_key(struct smbXcli_session
*session
,
509 NTSTATUS
smb2cli_session_decryption_key(struct smbXcli_session
*session
,
512 NTSTATUS
smbXcli_session_application_key(struct smbXcli_session
*session
,
515 void smbXcli_session_set_disconnect_expired(struct smbXcli_session
*session
);
516 uint16_t smb1cli_session_current_id(struct smbXcli_session
* session
);
517 void smb1cli_session_set_id(struct smbXcli_session
* session
,
518 uint16_t session_id
);
519 void smb1cli_session_set_action(struct smbXcli_session
*session
,
521 NTSTATUS
smb1cli_session_set_session_key(struct smbXcli_session
*session
,
522 const DATA_BLOB _session_key
);
523 NTSTATUS
smb1cli_session_protect_session_key(struct smbXcli_session
*session
);
524 uint8_t smb2cli_session_security_mode(struct smbXcli_session
*session
);
525 uint64_t smb2cli_session_current_id(struct smbXcli_session
*session
);
526 uint16_t smb2cli_session_get_flags(struct smbXcli_session
*session
);
527 void smb2cli_session_set_id_and_flags(struct smbXcli_session
*session
,
529 uint16_t session_flags
);
530 void smb2cli_session_increment_channel_sequence(struct smbXcli_session
*session
);
531 uint16_t smb2cli_session_reset_channel_sequence(struct smbXcli_session
*session
,
532 uint16_t channel_sequence
);
533 uint16_t smb2cli_session_current_channel_sequence(struct smbXcli_session
*session
);
534 void smb2cli_session_start_replay(struct smbXcli_session
*session
);
535 void smb2cli_session_stop_replay(struct smbXcli_session
*session
);
536 void smb2cli_session_require_signed_response(struct smbXcli_session
*session
,
537 bool require_signed_response
);
538 void smb2cli_session_torture_anonymous_signing(struct smbXcli_session
*session
,
539 bool anonymous_signing
);
540 void smb2cli_session_torture_anonymous_encryption(struct smbXcli_session
*session
,
541 bool anonymous_encryption
);
542 void smb2cli_session_torture_no_signing_disconnect(struct smbXcli_session
*session
);
543 NTSTATUS
smb2cli_session_update_preauth(struct smbXcli_session
*session
,
544 const struct iovec
*iov
);
545 NTSTATUS
smb2cli_session_set_session_key(struct smbXcli_session
*session
,
546 const DATA_BLOB session_key
,
547 const struct iovec
*recv_iov
);
548 NTSTATUS
smb2cli_session_create_channel(TALLOC_CTX
*mem_ctx
,
549 struct smbXcli_session
*session1
,
550 struct smbXcli_conn
*conn
,
551 struct smbXcli_session
**_session2
);
552 NTSTATUS
smb2cli_session_set_channel_key(struct smbXcli_session
*session
,
553 const DATA_BLOB channel_key
,
554 const struct iovec
*recv_iov
);
555 NTSTATUS
smb2cli_session_encryption_on(struct smbXcli_session
*session
);
556 uint16_t smb2cli_session_get_encryption_cipher(struct smbXcli_session
*session
);
558 struct smbXcli_tcon
*smbXcli_tcon_create(TALLOC_CTX
*mem_ctx
);
559 struct smbXcli_tcon
*smbXcli_tcon_copy(TALLOC_CTX
*mem_ctx
,
560 const struct smbXcli_tcon
*tcon_in
);
561 void smbXcli_tcon_set_fs_attributes(struct smbXcli_tcon
*tcon
,
562 uint32_t fs_attributes
);
563 uint32_t smbXcli_tcon_get_fs_attributes(struct smbXcli_tcon
*tcon
);
564 bool smbXcli_tcon_is_dfs_share(struct smbXcli_tcon
*tcon
);
565 uint16_t smb1cli_tcon_current_id(struct smbXcli_tcon
*tcon
);
566 void smb1cli_tcon_set_id(struct smbXcli_tcon
*tcon
, uint16_t tcon_id
);
567 bool smb1cli_tcon_set_values(struct smbXcli_tcon
*tcon
,
569 uint16_t optional_support
,
570 uint32_t maximal_access
,
571 uint32_t guest_maximal_access
,
573 const char *fs_type
);
574 uint32_t smb2cli_tcon_current_id(struct smbXcli_tcon
*tcon
);
575 void smb2cli_tcon_set_id(struct smbXcli_tcon
*tcon
, uint32_t tcon_id
);
576 uint32_t smb2cli_tcon_capabilities(struct smbXcli_tcon
*tcon
);
577 uint32_t smb2cli_tcon_flags(struct smbXcli_tcon
*tcon
);
578 void smb2cli_tcon_set_values(struct smbXcli_tcon
*tcon
,
579 struct smbXcli_session
*session
,
583 uint32_t capabilities
,
584 uint32_t maximal_access
);
585 void smb2cli_tcon_should_sign(struct smbXcli_tcon
*tcon
,
587 bool smb2cli_tcon_is_signing_on(struct smbXcli_tcon
*tcon
);
588 void smb2cli_tcon_should_encrypt(struct smbXcli_tcon
*tcon
,
589 bool should_encrypt
);
590 bool smb2cli_tcon_is_encryption_on(struct smbXcli_tcon
*tcon
);
592 struct tevent_req
*smb2cli_session_setup_send(TALLOC_CTX
*mem_ctx
,
593 struct tevent_context
*ev
,
594 struct smbXcli_conn
*conn
,
595 uint32_t timeout_msec
,
596 struct smbXcli_session
*session
,
598 uint32_t in_capabilities
,
600 uint64_t in_previous_session_id
,
601 const DATA_BLOB
*in_security_buffer
);
602 NTSTATUS
smb2cli_session_setup_recv(struct tevent_req
*req
,
604 struct iovec
**recv_iov
,
605 DATA_BLOB
*out_security_buffer
);
607 struct tevent_req
*smb2cli_logoff_send(TALLOC_CTX
*mem_ctx
,
608 struct tevent_context
*ev
,
609 struct smbXcli_conn
*conn
,
610 uint32_t timeout_msec
,
611 struct smbXcli_session
*session
);
612 NTSTATUS
smb2cli_logoff_recv(struct tevent_req
*req
);
613 NTSTATUS
smb2cli_logoff(struct smbXcli_conn
*conn
,
614 uint32_t timeout_msec
,
615 struct smbXcli_session
*session
);
617 /* smb2cli_raw_tcon* should only be used in tests! */
618 struct tevent_req
*smb2cli_raw_tcon_send(TALLOC_CTX
*mem_ctx
,
619 struct tevent_context
*ev
,
620 struct smbXcli_conn
*conn
,
621 uint32_t additional_flags
,
622 uint32_t clear_flags
,
623 uint32_t timeout_msec
,
624 struct smbXcli_session
*session
,
625 struct smbXcli_tcon
*tcon
,
628 NTSTATUS
smb2cli_raw_tcon_recv(struct tevent_req
*req
);
629 NTSTATUS
smb2cli_raw_tcon(struct smbXcli_conn
*conn
,
630 uint32_t additional_flags
,
631 uint32_t clear_flags
,
632 uint32_t timeout_msec
,
633 struct smbXcli_session
*session
,
634 struct smbXcli_tcon
*tcon
,
637 struct tevent_req
*smb2cli_tcon_send(TALLOC_CTX
*mem_ctx
,
638 struct tevent_context
*ev
,
639 struct smbXcli_conn
*conn
,
640 uint32_t timeout_msec
,
641 struct smbXcli_session
*session
,
642 struct smbXcli_tcon
*tcon
,
645 NTSTATUS
smb2cli_tcon_recv(struct tevent_req
*req
);
646 NTSTATUS
smb2cli_tcon(struct smbXcli_conn
*conn
,
647 uint32_t timeout_msec
,
648 struct smbXcli_session
*session
,
649 struct smbXcli_tcon
*tcon
,
653 struct tevent_req
*smb2cli_tdis_send(TALLOC_CTX
*mem_ctx
,
654 struct tevent_context
*ev
,
655 struct smbXcli_conn
*conn
,
656 uint32_t timeout_msec
,
657 struct smbXcli_session
*session
,
658 struct smbXcli_tcon
*tcon
);
659 NTSTATUS
smb2cli_tdis_recv(struct tevent_req
*req
);
660 NTSTATUS
smb2cli_tdis(struct smbXcli_conn
*conn
,
661 uint32_t timeout_msec
,
662 struct smbXcli_session
*session
,
663 struct smbXcli_tcon
*tcon
);
665 struct symlink_reparse_struct
;
667 struct tevent_req
*smb2cli_create_send(
669 struct tevent_context
*ev
,
670 struct smbXcli_conn
*conn
,
671 uint32_t timeout_msec
,
672 struct smbXcli_session
*session
,
673 struct smbXcli_tcon
*tcon
,
674 const char *filename
,
675 uint8_t oplock_level
, /* SMB2_OPLOCK_LEVEL_* */
676 uint32_t impersonation_level
, /* SMB2_IMPERSONATION_* */
677 uint32_t desired_access
,
678 uint32_t file_attributes
,
679 uint32_t share_access
,
680 uint32_t create_disposition
,
681 uint32_t create_options
,
682 struct smb2_create_blobs
*blobs
);
683 NTSTATUS
smb2cli_create_recv(struct tevent_req
*req
,
684 uint64_t *fid_persistent
,
685 uint64_t *fid_volatile
,
686 struct smb_create_returns
*cr
,
688 struct smb2_create_blobs
*blobs
,
689 struct symlink_reparse_struct
**psymlink
);
690 NTSTATUS
smb2cli_create(struct smbXcli_conn
*conn
,
691 uint32_t timeout_msec
,
692 struct smbXcli_session
*session
,
693 struct smbXcli_tcon
*tcon
,
694 const char *filename
,
695 uint8_t oplock_level
, /* SMB2_OPLOCK_LEVEL_* */
696 uint32_t impersonation_level
, /* SMB2_IMPERSONATION_* */
697 uint32_t desired_access
,
698 uint32_t file_attributes
,
699 uint32_t share_access
,
700 uint32_t create_disposition
,
701 uint32_t create_options
,
702 struct smb2_create_blobs
*blobs
,
703 uint64_t *fid_persistent
,
704 uint64_t *fid_volatile
,
705 struct smb_create_returns
*cr
,
707 struct smb2_create_blobs
*ret_blobs
,
708 struct symlink_reparse_struct
**psymlink
);
710 struct tevent_req
*smb2cli_close_send(TALLOC_CTX
*mem_ctx
,
711 struct tevent_context
*ev
,
712 struct smbXcli_conn
*conn
,
713 uint32_t timeout_msec
,
714 struct smbXcli_session
*session
,
715 struct smbXcli_tcon
*tcon
,
717 uint64_t fid_persistent
,
718 uint64_t fid_volatile
);
719 NTSTATUS
smb2cli_close_recv(struct tevent_req
*req
);
720 NTSTATUS
smb2cli_close(struct smbXcli_conn
*conn
,
721 uint32_t timeout_msec
,
722 struct smbXcli_session
*session
,
723 struct smbXcli_tcon
*tcon
,
725 uint64_t fid_persistent
,
726 uint64_t fid_volatile
);
728 struct tevent_req
*smb2cli_read_send(TALLOC_CTX
*mem_ctx
,
729 struct tevent_context
*ev
,
730 struct smbXcli_conn
*conn
,
731 uint32_t timeout_msec
,
732 struct smbXcli_session
*session
,
733 struct smbXcli_tcon
*tcon
,
736 uint64_t fid_persistent
,
737 uint64_t fid_volatile
,
738 uint64_t minimum_count
,
739 uint64_t remaining_bytes
);
740 NTSTATUS
smb2cli_read_recv(struct tevent_req
*req
, TALLOC_CTX
*mem_ctx
,
741 uint8_t **data
, uint32_t *data_length
);
742 NTSTATUS
smb2cli_read(struct smbXcli_conn
*conn
,
743 uint32_t timeout_msec
,
744 struct smbXcli_session
*session
,
745 struct smbXcli_tcon
*tcon
,
748 uint64_t fid_persistent
,
749 uint64_t fid_volatile
,
750 uint64_t minimum_count
,
751 uint64_t remaining_bytes
,
754 uint32_t *data_length
);
756 struct tevent_req
*smb2cli_write_send(TALLOC_CTX
*mem_ctx
,
757 struct tevent_context
*ev
,
758 struct smbXcli_conn
*conn
,
759 uint32_t timeout_msec
,
760 struct smbXcli_session
*session
,
761 struct smbXcli_tcon
*tcon
,
764 uint64_t fid_persistent
,
765 uint64_t fid_volatile
,
766 uint32_t remaining_bytes
,
768 const uint8_t *data
);
769 NTSTATUS
smb2cli_write_recv(struct tevent_req
*req
,
771 NTSTATUS
smb2cli_write(struct smbXcli_conn
*conn
,
772 uint32_t timeout_msec
,
773 struct smbXcli_session
*session
,
774 struct smbXcli_tcon
*tcon
,
777 uint64_t fid_persistent
,
778 uint64_t fid_volatile
,
779 uint32_t remaining_bytes
,
784 struct tevent_req
*smb2cli_flush_send(TALLOC_CTX
*mem_ctx
,
785 struct tevent_context
*ev
,
786 struct smbXcli_conn
*conn
,
787 uint32_t timeout_msec
,
788 struct smbXcli_session
*session
,
789 struct smbXcli_tcon
*tcon
,
790 uint64_t fid_persistent
,
791 uint64_t fid_volatile
);
792 NTSTATUS
smb2cli_flush_recv(struct tevent_req
*req
);
793 NTSTATUS
smb2cli_flush(struct smbXcli_conn
*conn
,
794 uint32_t timeout_msec
,
795 struct smbXcli_session
*session
,
796 struct smbXcli_tcon
*tcon
,
797 uint64_t fid_persistent
,
798 uint64_t fid_volatile
);
800 struct tevent_req
*smb2cli_set_info_send(TALLOC_CTX
*mem_ctx
,
801 struct tevent_context
*ev
,
802 struct smbXcli_conn
*conn
,
803 uint32_t timeout_msec
,
804 struct smbXcli_session
*session
,
805 struct smbXcli_tcon
*tcon
,
806 uint8_t in_info_type
,
807 uint8_t in_file_info_class
,
808 const DATA_BLOB
*in_input_buffer
,
809 uint32_t in_additional_info
,
810 uint64_t in_fid_persistent
,
811 uint64_t in_fid_volatile
);
812 NTSTATUS
smb2cli_set_info_recv(struct tevent_req
*req
);
813 NTSTATUS
smb2cli_set_info(struct smbXcli_conn
*conn
,
814 uint32_t timeout_msec
,
815 struct smbXcli_session
*session
,
816 struct smbXcli_tcon
*tcon
,
817 uint8_t in_info_type
,
818 uint8_t in_file_info_class
,
819 const DATA_BLOB
*in_input_buffer
,
820 uint32_t in_additional_info
,
821 uint64_t in_fid_persistent
,
822 uint64_t in_fid_volatile
);
824 struct tevent_req
*smb2cli_query_info_send(TALLOC_CTX
*mem_ctx
,
825 struct tevent_context
*ev
,
826 struct smbXcli_conn
*conn
,
827 uint32_t timeout_msec
,
828 struct smbXcli_session
*session
,
829 struct smbXcli_tcon
*tcon
,
830 uint8_t in_info_type
,
831 uint8_t in_file_info_class
,
832 uint32_t in_max_output_length
,
833 const DATA_BLOB
*in_input_buffer
,
834 uint32_t in_additional_info
,
836 uint64_t in_fid_persistent
,
837 uint64_t in_fid_volatile
);
838 NTSTATUS
smb2cli_query_info_recv(struct tevent_req
*req
,
840 DATA_BLOB
*out_output_buffer
);
841 NTSTATUS
smb2cli_query_info(struct smbXcli_conn
*conn
,
842 uint32_t timeout_msec
,
843 struct smbXcli_session
*session
,
844 struct smbXcli_tcon
*tcon
,
845 uint8_t in_info_type
,
846 uint8_t in_file_info_class
,
847 uint32_t in_max_output_length
,
848 const DATA_BLOB
*in_input_buffer
,
849 uint32_t in_additional_info
,
851 uint64_t in_fid_persistent
,
852 uint64_t in_fid_volatile
,
854 DATA_BLOB
*out_output_buffer
);
856 struct tevent_req
*smb2cli_query_directory_send(TALLOC_CTX
*mem_ctx
,
857 struct tevent_context
*ev
,
858 struct smbXcli_conn
*conn
,
859 uint32_t timeout_msec
,
860 struct smbXcli_session
*session
,
861 struct smbXcli_tcon
*tcon
,
865 uint64_t fid_persistent
,
866 uint64_t fid_volatile
,
868 uint32_t outbuf_len
);
869 NTSTATUS
smb2cli_query_directory_recv(struct tevent_req
*req
,
872 uint32_t *data_length
);
873 NTSTATUS
smb2cli_query_directory(struct smbXcli_conn
*conn
,
874 uint32_t timeout_msec
,
875 struct smbXcli_session
*session
,
876 struct smbXcli_tcon
*tcon
,
880 uint64_t fid_persistent
,
881 uint64_t fid_volatile
,
886 uint32_t *data_length
);
888 struct tevent_req
*smb2cli_notify_send(TALLOC_CTX
*mem_ctx
,
889 struct tevent_context
*ev
,
890 struct smbXcli_conn
*conn
,
891 uint32_t timeout_msec
,
892 struct smbXcli_session
*session
,
893 struct smbXcli_tcon
*tcon
,
894 uint32_t output_buffer_length
,
895 uint64_t fid_persistent
,
896 uint64_t fid_volatile
,
897 uint32_t completion_filter
,
899 NTSTATUS
smb2cli_notify_recv(struct tevent_req
*req
, TALLOC_CTX
*mem_ctx
,
900 uint8_t **data
, uint32_t *data_length
);
901 NTSTATUS
smb2cli_notify(struct smbXcli_conn
*conn
,
902 uint32_t timeout_msec
,
903 struct smbXcli_session
*session
,
904 struct smbXcli_tcon
*tcon
,
905 uint32_t output_buffer_length
,
906 uint64_t fid_persistent
,
907 uint64_t fid_volatile
,
908 uint32_t completion_filter
,
912 uint32_t *data_length
);
914 struct tevent_req
*smb2cli_ioctl_send(TALLOC_CTX
*mem_ctx
,
915 struct tevent_context
*ev
,
916 struct smbXcli_conn
*conn
,
917 uint32_t timeout_msec
,
918 struct smbXcli_session
*session
,
919 struct smbXcli_tcon
*tcon
,
920 uint64_t in_fid_persistent
,
921 uint64_t in_fid_volatile
,
922 uint32_t in_ctl_code
,
923 uint32_t in_max_input_length
,
924 const DATA_BLOB
*in_input_buffer
,
925 uint32_t in_max_output_length
,
926 const DATA_BLOB
*in_output_buffer
,
928 NTSTATUS
smb2cli_ioctl_recv(struct tevent_req
*req
,
930 DATA_BLOB
*out_input_buffer
,
931 DATA_BLOB
*out_output_buffer
);
932 NTSTATUS
smb2cli_ioctl(struct smbXcli_conn
*conn
,
933 uint32_t timeout_msec
,
934 struct smbXcli_session
*session
,
935 struct smbXcli_tcon
*tcon
,
936 uint64_t in_fid_persistent
,
937 uint64_t in_fid_volatile
,
938 uint32_t in_ctl_code
,
939 uint32_t in_max_input_length
,
940 const DATA_BLOB
*in_input_buffer
,
941 uint32_t in_max_output_length
,
942 const DATA_BLOB
*in_output_buffer
,
945 DATA_BLOB
*out_input_buffer
,
946 DATA_BLOB
*out_output_buffer
);
948 struct tevent_req
*smb2cli_echo_send(TALLOC_CTX
*mem_ctx
,
949 struct tevent_context
*ev
,
950 struct smbXcli_conn
*conn
,
951 uint32_t timeout_msec
);
952 NTSTATUS
smb2cli_echo_recv(struct tevent_req
*req
);
953 NTSTATUS
smb2cli_echo(struct smbXcli_conn
*conn
,
954 uint32_t timeout_msec
);
956 struct tevent_req
*smb2cli_ioctl_pipe_wait_send(TALLOC_CTX
*mem_ctx
,
957 struct tevent_context
*ev
,
958 struct smbXcli_conn
*conn
,
959 uint32_t timeout_msec
,
960 struct smbXcli_session
*session
,
961 struct smbXcli_tcon
*tcon
,
962 const char *pipe_name
,
963 uint64_t pipe_wait_timeout
);
965 NTSTATUS
smb2cli_ioctl_pipe_wait_recv(struct tevent_req
*req
);
967 NTSTATUS
smb2cli_ioctl_pipe_wait(struct smbXcli_conn
*conn
,
968 uint32_t timeout_msec
,
969 struct smbXcli_session
*session
,
970 struct smbXcli_tcon
*tcon
,
971 const char *pipe_name
,
972 uint64_t pipe_wait_timeout
);
974 #endif /* _SMBXCLI_BASE_H_ */