Update 4.2 Roadmap file
[mat/samba.git] / libcli / smb / smbXcli_base.h
1 /*
2    Unix SMB/CIFS implementation.
3    Infrastructure for async SMB client requests
4    Copyright (C) Volker Lendecke 2008
5    Copyright (C) Stefan Metzmacher 2011
6
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.
11
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.
16
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/>.
19 */
20
21 #ifndef _SMBXCLI_BASE_H_
22 #define _SMBXCLI_BASE_H_
23
24 struct smbXcli_conn;
25 struct smbXcli_session;
26 struct smbXcli_tcon;
27 struct smb_trans_enc_state;
28 struct GUID;
29 struct iovec;
30 struct smb2_create_blobs;
31 struct smb_create_returns;
32
33 struct smbXcli_conn *smbXcli_conn_create(TALLOC_CTX *mem_ctx,
34                                          int fd,
35                                          const char *remote_name,
36                                          enum smb_signing_setting signing_state,
37                                          uint32_t smb1_capabilities,
38                                          struct GUID *client_guid,
39                                          uint32_t smb2_capabilities);
40
41 bool smbXcli_conn_is_connected(struct smbXcli_conn *conn);
42 void smbXcli_conn_disconnect(struct smbXcli_conn *conn, NTSTATUS status);
43
44 bool smbXcli_conn_has_async_calls(struct smbXcli_conn *conn);
45
46 bool smbXcli_conn_dfs_supported(struct smbXcli_conn *conn);
47
48 enum protocol_types smbXcli_conn_protocol(struct smbXcli_conn *conn);
49 bool smbXcli_conn_use_unicode(struct smbXcli_conn *conn);
50
51 void smbXcli_conn_set_sockopt(struct smbXcli_conn *conn, const char *options);
52 const struct sockaddr_storage *smbXcli_conn_local_sockaddr(struct smbXcli_conn *conn);
53 const struct sockaddr_storage *smbXcli_conn_remote_sockaddr(struct smbXcli_conn *conn);
54 const char *smbXcli_conn_remote_name(struct smbXcli_conn *conn);
55
56 uint16_t smbXcli_conn_max_requests(struct smbXcli_conn *conn);
57 NTTIME smbXcli_conn_server_system_time(struct smbXcli_conn *conn);
58 const DATA_BLOB *smbXcli_conn_server_gss_blob(struct smbXcli_conn *conn);
59 const struct GUID *smbXcli_conn_server_guid(struct smbXcli_conn *conn);
60
61 struct tevent_req *smbXcli_conn_samba_suicide_send(TALLOC_CTX *mem_ctx,
62                                                    struct tevent_context *ev,
63                                                    struct smbXcli_conn *conn,
64                                                    uint8_t exitcode);
65 NTSTATUS smbXcli_conn_samba_suicide_recv(struct tevent_req *req);
66 NTSTATUS smbXcli_conn_samba_suicide(struct smbXcli_conn *conn,
67                                     uint8_t exitcode);
68
69 void smbXcli_req_unset_pending(struct tevent_req *req);
70 bool smbXcli_req_set_pending(struct tevent_req *req);
71
72 uint32_t smb1cli_conn_capabilities(struct smbXcli_conn *conn);
73 uint32_t smb1cli_conn_max_xmit(struct smbXcli_conn *conn);
74 bool smb1cli_conn_req_possible(struct smbXcli_conn *conn);
75 uint32_t smb1cli_conn_server_session_key(struct smbXcli_conn *conn);
76 const uint8_t *smb1cli_conn_server_challenge(struct smbXcli_conn *conn);
77 uint16_t smb1cli_conn_server_security_mode(struct smbXcli_conn *conn);
78 bool smb1cli_conn_server_readbraw(struct smbXcli_conn *conn);
79 bool smb1cli_conn_server_writebraw(struct smbXcli_conn *conn);
80 bool smb1cli_conn_server_lockread(struct smbXcli_conn *conn);
81 bool smb1cli_conn_server_writeunlock(struct smbXcli_conn *conn);
82 int smb1cli_conn_server_time_zone(struct smbXcli_conn *conn);
83
84 bool smb1cli_conn_activate_signing(struct smbXcli_conn *conn,
85                                    const DATA_BLOB user_session_key,
86                                    const DATA_BLOB response);
87 bool smb1cli_conn_check_signing(struct smbXcli_conn *conn,
88                                 const uint8_t *buf, uint32_t seqnum);
89 bool smb1cli_conn_signing_is_active(struct smbXcli_conn *conn);
90
91 void smb1cli_conn_set_encryption(struct smbXcli_conn *conn,
92                                  struct smb_trans_enc_state *es);
93 bool smb1cli_conn_encryption_on(struct smbXcli_conn *conn);
94
95 bool smb1cli_is_andx_req(uint8_t cmd);
96 size_t smb1cli_req_wct_ofs(struct tevent_req **reqs, int num_reqs);
97
98 uint16_t smb1cli_req_mid(struct tevent_req *req);
99 void smb1cli_req_set_mid(struct tevent_req *req, uint16_t mid);
100
101 uint32_t smb1cli_req_seqnum(struct tevent_req *req);
102 void smb1cli_req_set_seqnum(struct tevent_req *req, uint32_t seqnum);
103
104 struct smb1cli_req_expected_response {
105         NTSTATUS status;
106         uint8_t wct;
107 };
108
109 struct tevent_req *smb1cli_req_create(TALLOC_CTX *mem_ctx,
110                                       struct tevent_context *ev,
111                                       struct smbXcli_conn *conn,
112                                       uint8_t smb_command,
113                                       uint8_t additional_flags,
114                                       uint8_t clear_flags,
115                                       uint16_t additional_flags2,
116                                       uint16_t clear_flags2,
117                                       uint32_t timeout_msec,
118                                       uint32_t pid,
119                                       struct smbXcli_tcon *tcon,
120                                       struct smbXcli_session *session,
121                                       uint8_t wct, uint16_t *vwv,
122                                       int iov_count,
123                                       struct iovec *bytes_iov);
124 NTSTATUS smb1cli_req_chain_submit(struct tevent_req **reqs, int num_reqs);
125
126 struct tevent_req *smb1cli_req_send(TALLOC_CTX *mem_ctx,
127                                     struct tevent_context *ev,
128                                     struct smbXcli_conn *conn,
129                                     uint8_t smb_command,
130                                     uint8_t additional_flags,
131                                     uint8_t clear_flags,
132                                     uint16_t additional_flags2,
133                                     uint16_t clear_flags2,
134                                     uint32_t timeout_msec,
135                                     uint32_t pid,
136                                     struct smbXcli_tcon *tcon,
137                                     struct smbXcli_session *session,
138                                     uint8_t wct, uint16_t *vwv,
139                                     uint32_t num_bytes,
140                                     const uint8_t *bytes);
141 NTSTATUS smb1cli_req_recv(struct tevent_req *req,
142                           TALLOC_CTX *mem_ctx,
143                           struct iovec **piov,
144                           uint8_t **phdr,
145                           uint8_t *pwct,
146                           uint16_t **pvwv,
147                           uint32_t *pvwv_offset,
148                           uint32_t *pnum_bytes,
149                           uint8_t **pbytes,
150                           uint32_t *pbytes_offset,
151                           uint8_t **pinbuf,
152                           const struct smb1cli_req_expected_response *expected,
153                           size_t num_expected);
154
155 struct tevent_req *smb1cli_trans_send(
156         TALLOC_CTX *mem_ctx, struct tevent_context *ev,
157         struct smbXcli_conn *conn, uint8_t cmd,
158         uint8_t additional_flags, uint8_t clear_flags,
159         uint16_t additional_flags2, uint16_t clear_flags2,
160         uint32_t timeout_msec,
161         uint32_t pid,
162         struct smbXcli_tcon *tcon,
163         struct smbXcli_session *session,
164         const char *pipe_name, uint16_t fid, uint16_t function, int flags,
165         uint16_t *setup, uint8_t num_setup, uint8_t max_setup,
166         uint8_t *param, uint32_t num_param, uint32_t max_param,
167         uint8_t *data, uint32_t num_data, uint32_t max_data);
168 NTSTATUS smb1cli_trans_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
169                             uint16_t *recv_flags2,
170                             uint16_t **setup, uint8_t min_setup,
171                             uint8_t *num_setup,
172                             uint8_t **param, uint32_t min_param,
173                             uint32_t *num_param,
174                             uint8_t **data, uint32_t min_data,
175                             uint32_t *num_data);
176 NTSTATUS smb1cli_trans(TALLOC_CTX *mem_ctx, struct smbXcli_conn *conn,
177                 uint8_t trans_cmd,
178                 uint8_t additional_flags, uint8_t clear_flags,
179                 uint16_t additional_flags2, uint16_t clear_flags2,
180                 uint32_t timeout_msec,
181                 uint32_t pid,
182                 struct smbXcli_tcon *tcon,
183                 struct smbXcli_session *session,
184                 const char *pipe_name, uint16_t fid, uint16_t function,
185                 int flags,
186                 uint16_t *setup, uint8_t num_setup, uint8_t max_setup,
187                 uint8_t *param, uint32_t num_param, uint32_t max_param,
188                 uint8_t *data, uint32_t num_data, uint32_t max_data,
189                 uint16_t *recv_flags2,
190                 uint16_t **rsetup, uint8_t min_rsetup, uint8_t *num_rsetup,
191                 uint8_t **rparam, uint32_t min_rparam, uint32_t *num_rparam,
192                 uint8_t **rdata, uint32_t min_rdata, uint32_t *num_rdata);
193
194 struct tevent_req *smb1cli_echo_send(TALLOC_CTX *mem_ctx,
195                                      struct tevent_context *ev,
196                                      struct smbXcli_conn *conn,
197                                      uint32_t timeout_msec,
198                                      uint16_t num_echos,
199                                      DATA_BLOB data);
200 NTSTATUS smb1cli_echo_recv(struct tevent_req *req);
201 NTSTATUS smb1cli_echo(struct smbXcli_conn *conn, uint32_t timeout_msec,
202                       uint16_t num_echos, DATA_BLOB data);
203
204 struct tevent_req *smb1cli_ntcreatex_send(TALLOC_CTX *mem_ctx,
205                                           struct tevent_context *ev,
206                                           struct smbXcli_conn *conn,
207                                           uint32_t timeout_msec,
208                                           uint32_t pid,
209                                           struct smbXcli_tcon *tcon,
210                                           struct smbXcli_session *session,
211                                           const char *fname,
212                                           uint32_t CreatFlags,
213                                           uint32_t RootDirectoryFid,
214                                           uint32_t DesiredAccess,
215                                           uint64_t AllocationSize,
216                                           uint32_t FileAttributes,
217                                           uint32_t ShareAccess,
218                                           uint32_t CreateDisposition,
219                                           uint32_t CreateOptions,
220                                           uint32_t ImpersonationLevel,
221                                           uint8_t SecurityFlags);
222 NTSTATUS smb1cli_ntcreatex_recv(struct tevent_req *req, uint16_t *pfnum);
223 NTSTATUS smb1cli_ntcreatex(struct smbXcli_conn *conn,
224                            uint32_t timeout_msec,
225                            uint32_t pid,
226                            struct smbXcli_tcon *tcon,
227                            struct smbXcli_session *session,
228                            const char *fname,
229                            uint32_t CreatFlags,
230                            uint32_t RootDirectoryFid,
231                            uint32_t DesiredAccess,
232                            uint64_t AllocationSize,
233                            uint32_t FileAttributes,
234                            uint32_t ShareAccess,
235                            uint32_t CreateDisposition,
236                            uint32_t CreateOptions,
237                            uint32_t ImpersonationLevel,
238                            uint8_t SecurityFlags,
239                            uint16_t *pfnum);
240 struct tevent_req *smb1cli_close_send(TALLOC_CTX *mem_ctx,
241                                       struct tevent_context *ev,
242                                       struct smbXcli_conn *conn,
243                                       uint32_t timeout_msec,
244                                       uint32_t pid,
245                                       struct smbXcli_tcon *tcon,
246                                       struct smbXcli_session *session,
247                                       uint16_t fnum,
248                                       uint32_t last_modified);
249 NTSTATUS smb1cli_close_recv(struct tevent_req *req);
250 NTSTATUS smb1cli_close(struct smbXcli_conn *conn,
251                        uint32_t timeout_msec,
252                        uint32_t pid,
253                        struct smbXcli_tcon *tcon,
254                        struct smbXcli_session *session,
255                        uint16_t fnum,
256                        uint32_t last_modified);
257 struct tevent_req *smb1cli_writex_send(TALLOC_CTX *mem_ctx,
258                                        struct tevent_context *ev,
259                                        struct smbXcli_conn *conn,
260                                        uint32_t timeout_msec,
261                                        uint32_t pid,
262                                        struct smbXcli_tcon *tcon,
263                                        struct smbXcli_session *session,
264                                        uint16_t fnum,
265                                        uint16_t mode,
266                                        const uint8_t *buf,
267                                        uint64_t offset,
268                                        uint32_t size);
269 NTSTATUS smb1cli_writex_recv(struct tevent_req *req,
270                              uint32_t *pwritten,
271                              uint16_t *pavailable);
272 NTSTATUS smb1cli_writex(struct smbXcli_conn *conn,
273                         uint32_t timeout_msec,
274                         uint32_t pid,
275                         struct smbXcli_tcon *tcon,
276                         struct smbXcli_session *session,
277                         uint16_t fnum,
278                         uint16_t mode,
279                         const uint8_t *buf,
280                         uint64_t offset,
281                         uint32_t size,
282                         uint32_t *pwritten,
283                         uint16_t *pavailable);
284 struct tevent_req *smb1cli_readx_send(TALLOC_CTX *mem_ctx,
285                                       struct tevent_context *ev,
286                                       struct smbXcli_conn *conn,
287                                       uint32_t timeout_msec,
288                                       uint32_t pid,
289                                       struct smbXcli_tcon *tcon,
290                                       struct smbXcli_session *session,
291                                       uint16_t fnum,
292                                       uint64_t offset,
293                                       uint32_t size);
294 NTSTATUS smb1cli_readx_recv(struct tevent_req *req,
295                             uint32_t *received,
296                             uint8_t **rcvbuf);
297
298 bool smb2cli_conn_req_possible(struct smbXcli_conn *conn, uint32_t *max_dyn_len);
299 uint32_t smb2cli_conn_server_capabilities(struct smbXcli_conn *conn);
300 uint16_t smb2cli_conn_server_security_mode(struct smbXcli_conn *conn);
301 uint32_t smb2cli_conn_max_trans_size(struct smbXcli_conn *conn);
302 uint32_t smb2cli_conn_max_read_size(struct smbXcli_conn *conn);
303 uint32_t smb2cli_conn_max_write_size(struct smbXcli_conn *conn);
304 void smb2cli_conn_set_max_credits(struct smbXcli_conn *conn,
305                                   uint16_t max_credits);
306 uint8_t smb2cli_conn_get_io_priority(struct smbXcli_conn *conn);
307 void smb2cli_conn_set_io_priority(struct smbXcli_conn *conn,
308                                   uint8_t io_priority);
309
310 struct tevent_req *smb2cli_req_create(TALLOC_CTX *mem_ctx,
311                                       struct tevent_context *ev,
312                                       struct smbXcli_conn *conn,
313                                       uint16_t cmd,
314                                       uint32_t additional_flags,
315                                       uint32_t clear_flags,
316                                       uint32_t timeout_msec,
317                                       struct smbXcli_tcon *tcon,
318                                       struct smbXcli_session *session,
319                                       const uint8_t *fixed,
320                                       uint16_t fixed_len,
321                                       const uint8_t *dyn,
322                                       uint32_t dyn_len,
323                                       uint32_t max_dyn_len);
324 void smb2cli_req_set_notify_async(struct tevent_req *req);
325 NTSTATUS smb2cli_req_compound_submit(struct tevent_req **reqs,
326                                      int num_reqs);
327 void smb2cli_req_set_credit_charge(struct tevent_req *req, uint16_t charge);
328
329 struct smb2cli_req_expected_response {
330         NTSTATUS status;
331         uint16_t body_size;
332 };
333
334 struct tevent_req *smb2cli_req_send(TALLOC_CTX *mem_ctx,
335                                     struct tevent_context *ev,
336                                     struct smbXcli_conn *conn,
337                                     uint16_t cmd,
338                                     uint32_t additional_flags,
339                                     uint32_t clear_flags,
340                                     uint32_t timeout_msec,
341                                     struct smbXcli_tcon *tcon,
342                                     struct smbXcli_session *session,
343                                     const uint8_t *fixed,
344                                     uint16_t fixed_len,
345                                     const uint8_t *dyn,
346                                     uint32_t dyn_len,
347                                     uint32_t max_dyn_len);
348 NTSTATUS smb2cli_req_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
349                           struct iovec **piov,
350                           const struct smb2cli_req_expected_response *expected,
351                           size_t num_expected);
352
353 /*
354  * This expects an iov[3] array, that is filled with references to
355  * the buffers used for the sending the requests into the socket.
356  *
357  * This can only be called after smb2cli_req_recv(subreq) before
358  * the TALLOC_FREE(subreq).
359  */
360 NTSTATUS smb2cli_req_get_sent_iov(struct tevent_req *req,
361                                   struct iovec *sent_iov);
362
363 struct tevent_req *smbXcli_negprot_send(TALLOC_CTX *mem_ctx,
364                                         struct tevent_context *ev,
365                                         struct smbXcli_conn *conn,
366                                         uint32_t timeout_msec,
367                                         enum protocol_types min_protocol,
368                                         enum protocol_types max_protocol);
369 NTSTATUS smbXcli_negprot_recv(struct tevent_req *req);
370 NTSTATUS smbXcli_negprot(struct smbXcli_conn *conn,
371                          uint32_t timeout_msec,
372                          enum protocol_types min_protocol,
373                          enum protocol_types max_protocol);
374
375 struct tevent_req *smb2cli_validate_negotiate_info_send(TALLOC_CTX *mem_ctx,
376                                                 struct tevent_context *ev,
377                                                 struct smbXcli_conn *conn,
378                                                 uint32_t timeout_msec,
379                                                 struct smbXcli_session *session,
380                                                 struct smbXcli_tcon *tcon);
381 NTSTATUS smb2cli_validate_negotiate_info_recv(struct tevent_req *req);
382
383 struct smbXcli_session *smbXcli_session_create(TALLOC_CTX *mem_ctx,
384                                                struct smbXcli_conn *conn);
385 struct smbXcli_session *smbXcli_session_copy(TALLOC_CTX *mem_ctx,
386                                                struct smbXcli_session *src);
387 bool smbXcli_session_is_authenticated(struct smbXcli_session *session);
388 NTSTATUS smbXcli_session_application_key(struct smbXcli_session *session,
389                                          TALLOC_CTX *mem_ctx,
390                                          DATA_BLOB *key);
391 void smbXcli_session_set_disconnect_expired(struct smbXcli_session *session);
392 uint16_t smb1cli_session_current_id(struct smbXcli_session* session);
393 void smb1cli_session_set_id(struct smbXcli_session* session,
394                             uint16_t session_id);
395 NTSTATUS smb1cli_session_set_session_key(struct smbXcli_session *session,
396                                          const DATA_BLOB _session_key);
397 NTSTATUS smb1cli_session_protect_session_key(struct smbXcli_session *session);
398 uint8_t smb2cli_session_security_mode(struct smbXcli_session *session);
399 uint64_t smb2cli_session_current_id(struct smbXcli_session *session);
400 uint16_t smb2cli_session_get_flags(struct smbXcli_session *session);
401 void smb2cli_session_set_id_and_flags(struct smbXcli_session *session,
402                                       uint64_t session_id,
403                                       uint16_t session_flags);
404 void smb2cli_session_increment_channel_sequence(struct smbXcli_session *session);
405 uint16_t smb2cli_session_reset_channel_sequence(struct smbXcli_session *session,
406                                                 uint16_t channel_sequence);
407 void smb2cli_session_start_replay(struct smbXcli_session *session);
408 void smb2cli_session_stop_replay(struct smbXcli_session *session);
409 NTSTATUS smb2cli_session_update_preauth(struct smbXcli_session *session,
410                                         const struct iovec *iov);
411 NTSTATUS smb2cli_session_set_session_key(struct smbXcli_session *session,
412                                          const DATA_BLOB session_key,
413                                          const struct iovec *recv_iov);
414 NTSTATUS smb2cli_session_create_channel(TALLOC_CTX *mem_ctx,
415                                         struct smbXcli_session *session1,
416                                         struct smbXcli_conn *conn,
417                                         struct smbXcli_session **_session2);
418 NTSTATUS smb2cli_session_set_channel_key(struct smbXcli_session *session,
419                                          const DATA_BLOB channel_key,
420                                          const struct iovec *recv_iov);
421 NTSTATUS smb2cli_session_encryption_on(struct smbXcli_session *session);
422
423 struct smbXcli_tcon *smbXcli_tcon_create(TALLOC_CTX *mem_ctx);
424 void smbXcli_tcon_set_fs_attributes(struct smbXcli_tcon *tcon,
425                                     uint32_t fs_attributes);
426 uint32_t smbXcli_tcon_get_fs_attributes(struct smbXcli_tcon *tcon);
427 bool smbXcli_tcon_is_dfs_share(struct smbXcli_tcon *tcon);
428 uint16_t smb1cli_tcon_current_id(struct smbXcli_tcon *tcon);
429 void smb1cli_tcon_set_id(struct smbXcli_tcon *tcon, uint16_t tcon_id);
430 bool smb1cli_tcon_set_values(struct smbXcli_tcon *tcon,
431                              uint16_t tcon_id,
432                              uint16_t optional_support,
433                              uint32_t maximal_access,
434                              uint32_t guest_maximal_access,
435                              const char *service,
436                              const char *fs_type);
437 uint32_t smb2cli_tcon_current_id(struct smbXcli_tcon *tcon);
438 uint32_t smb2cli_tcon_capabilities(struct smbXcli_tcon *tcon);
439 void smb2cli_tcon_set_values(struct smbXcli_tcon *tcon,
440                              struct smbXcli_session *session,
441                              uint32_t tcon_id,
442                              uint8_t type,
443                              uint32_t flags,
444                              uint32_t capabilities,
445                              uint32_t maximal_access);
446 void smb2cli_tcon_should_sign(struct smbXcli_tcon *tcon,
447                               bool should_sign);
448 bool smb2cli_tcon_is_signing_on(struct smbXcli_tcon *tcon);
449 void smb2cli_tcon_should_encrypt(struct smbXcli_tcon *tcon,
450                                  bool should_encrypt);
451 bool smb2cli_tcon_is_encryption_on(struct smbXcli_tcon *tcon);
452
453 struct tevent_req *smb2cli_session_setup_send(TALLOC_CTX *mem_ctx,
454                                 struct tevent_context *ev,
455                                 struct smbXcli_conn *conn,
456                                 uint32_t timeout_msec,
457                                 struct smbXcli_session *session,
458                                 uint8_t in_flags,
459                                 uint32_t in_capabilities,
460                                 uint32_t in_channel,
461                                 uint64_t in_previous_session_id,
462                                 const DATA_BLOB *in_security_buffer);
463 NTSTATUS smb2cli_session_setup_recv(struct tevent_req *req,
464                                     TALLOC_CTX *mem_ctx,
465                                     struct iovec **recv_iov,
466                                     DATA_BLOB *out_security_buffer);
467
468 struct tevent_req *smb2cli_logoff_send(TALLOC_CTX *mem_ctx,
469                                        struct tevent_context *ev,
470                                        struct smbXcli_conn *conn,
471                                        uint32_t timeout_msec,
472                                        struct smbXcli_session *session);
473 NTSTATUS smb2cli_logoff_recv(struct tevent_req *req);
474 NTSTATUS smb2cli_logoff(struct smbXcli_conn *conn,
475                         uint32_t timeout_msec,
476                         struct smbXcli_session *session);
477
478 struct tevent_req *smb2cli_tcon_send(TALLOC_CTX *mem_ctx,
479                                      struct tevent_context *ev,
480                                      struct smbXcli_conn *conn,
481                                      uint32_t timeout_msec,
482                                      struct smbXcli_session *session,
483                                      struct smbXcli_tcon *tcon,
484                                      uint16_t flags,
485                                      const char *unc);
486 NTSTATUS smb2cli_tcon_recv(struct tevent_req *req);
487 NTSTATUS smb2cli_tcon(struct smbXcli_conn *conn,
488                       uint32_t timeout_msec,
489                       struct smbXcli_session *session,
490                       struct smbXcli_tcon *tcon,
491                       uint16_t flags,
492                       const char *unc);
493
494 struct tevent_req *smb2cli_tdis_send(TALLOC_CTX *mem_ctx,
495                                      struct tevent_context *ev,
496                                      struct smbXcli_conn *conn,
497                                      uint32_t timeout_msec,
498                                      struct smbXcli_session *session,
499                                      struct smbXcli_tcon *tcon);
500 NTSTATUS smb2cli_tdis_recv(struct tevent_req *req);
501 NTSTATUS smb2cli_tdis(struct smbXcli_conn *conn,
502                       uint32_t timeout_msec,
503                       struct smbXcli_session *session,
504                       struct smbXcli_tcon *tcon);
505
506 struct tevent_req *smb2cli_create_send(
507         TALLOC_CTX *mem_ctx,
508         struct tevent_context *ev,
509         struct smbXcli_conn *conn,
510         uint32_t timeout_msec,
511         struct smbXcli_session *session,
512         struct smbXcli_tcon *tcon,
513         const char *filename,
514         uint8_t  oplock_level,          /* SMB2_OPLOCK_LEVEL_* */
515         uint32_t impersonation_level,   /* SMB2_IMPERSONATION_* */
516         uint32_t desired_access,
517         uint32_t file_attributes,
518         uint32_t share_access,
519         uint32_t create_disposition,
520         uint32_t create_options,
521         struct smb2_create_blobs *blobs);
522 NTSTATUS smb2cli_create_recv(struct tevent_req *req,
523                              uint64_t *fid_persistent,
524                              uint64_t *fid_volatile,
525                              struct smb_create_returns *cr,
526                              TALLOC_CTX *mem_ctx,
527                              struct smb2_create_blobs *blobs);
528 NTSTATUS smb2cli_create(struct smbXcli_conn *conn,
529                         uint32_t timeout_msec,
530                         struct smbXcli_session *session,
531                         struct smbXcli_tcon *tcon,
532                         const char *filename,
533                         uint8_t  oplock_level,       /* SMB2_OPLOCK_LEVEL_* */
534                         uint32_t impersonation_level, /* SMB2_IMPERSONATION_* */
535                         uint32_t desired_access,
536                         uint32_t file_attributes,
537                         uint32_t share_access,
538                         uint32_t create_disposition,
539                         uint32_t create_options,
540                         struct smb2_create_blobs *blobs,
541                         uint64_t *fid_persistent,
542                         uint64_t *fid_volatile,
543                         struct smb_create_returns *cr,
544                         TALLOC_CTX *mem_ctx,
545                         struct smb2_create_blobs *ret_blobs);
546
547 struct tevent_req *smb2cli_close_send(TALLOC_CTX *mem_ctx,
548                                       struct tevent_context *ev,
549                                       struct smbXcli_conn *conn,
550                                       uint32_t timeout_msec,
551                                       struct smbXcli_session *session,
552                                       struct smbXcli_tcon *tcon,
553                                       uint16_t flags,
554                                       uint64_t fid_persistent,
555                                       uint64_t fid_volatile);
556 NTSTATUS smb2cli_close_recv(struct tevent_req *req);
557 NTSTATUS smb2cli_close(struct smbXcli_conn *conn,
558                        uint32_t timeout_msec,
559                        struct smbXcli_session *session,
560                        struct smbXcli_tcon *tcon,
561                        uint16_t flags,
562                        uint64_t fid_persistent,
563                        uint64_t fid_volatile);
564
565 struct tevent_req *smb2cli_read_send(TALLOC_CTX *mem_ctx,
566                                      struct tevent_context *ev,
567                                      struct smbXcli_conn *conn,
568                                      uint32_t timeout_msec,
569                                      struct smbXcli_session *session,
570                                      struct smbXcli_tcon *tcon,
571                                      uint32_t length,
572                                      uint64_t offset,
573                                      uint64_t fid_persistent,
574                                      uint64_t fid_volatile,
575                                      uint64_t minimum_count,
576                                      uint64_t remaining_bytes);
577 NTSTATUS smb2cli_read_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
578                            uint8_t **data, uint32_t *data_length);
579 NTSTATUS smb2cli_read(struct smbXcli_conn *conn,
580                       uint32_t timeout_msec,
581                       struct smbXcli_session *session,
582                       struct smbXcli_tcon *tcon,
583                       uint32_t length,
584                       uint64_t offset,
585                       uint64_t fid_persistent,
586                       uint64_t fid_volatile,
587                       uint64_t minimum_count,
588                       uint64_t remaining_bytes,
589                       TALLOC_CTX *mem_ctx,
590                       uint8_t **data,
591                       uint32_t *data_length);
592
593 struct tevent_req *smb2cli_write_send(TALLOC_CTX *mem_ctx,
594                                       struct tevent_context *ev,
595                                       struct smbXcli_conn *conn,
596                                       uint32_t timeout_msec,
597                                       struct smbXcli_session *session,
598                                       struct smbXcli_tcon *tcon,
599                                       uint32_t length,
600                                       uint64_t offset,
601                                       uint64_t fid_persistent,
602                                       uint64_t fid_volatile,
603                                       uint32_t remaining_bytes,
604                                       uint32_t flags,
605                                       const uint8_t *data);
606 NTSTATUS smb2cli_write_recv(struct tevent_req *req,
607                         uint32_t *written);
608 NTSTATUS smb2cli_write(struct smbXcli_conn *conn,
609                        uint32_t timeout_msec,
610                        struct smbXcli_session *session,
611                        struct smbXcli_tcon *tcon,
612                        uint32_t length,
613                        uint64_t offset,
614                        uint64_t fid_persistent,
615                        uint64_t fid_volatile,
616                        uint32_t remaining_bytes,
617                        uint32_t flags,
618                        const uint8_t *data,
619                        uint32_t *written);
620
621 struct tevent_req *smb2cli_flush_send(TALLOC_CTX *mem_ctx,
622                                       struct tevent_context *ev,
623                                       struct smbXcli_conn *conn,
624                                       uint32_t timeout_msec,
625                                       struct smbXcli_session *session,
626                                       struct smbXcli_tcon *tcon,
627                                       uint64_t fid_persistent,
628                                       uint64_t fid_volatile);
629 NTSTATUS smb2cli_flush_recv(struct tevent_req *req);
630 NTSTATUS smb2cli_flush(struct smbXcli_conn *conn,
631                        uint32_t timeout_msec,
632                        struct smbXcli_session *session,
633                        struct smbXcli_tcon *tcon,
634                        uint64_t fid_persistent,
635                        uint64_t fid_volatile);
636
637 struct tevent_req *smb2cli_set_info_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,
643                                          uint8_t in_info_type,
644                                          uint8_t in_file_info_class,
645                                          const DATA_BLOB *in_input_buffer,
646                                          uint32_t in_additional_info,
647                                          uint64_t in_fid_persistent,
648                                          uint64_t in_fid_volatile);
649 NTSTATUS smb2cli_set_info_recv(struct tevent_req *req);
650 NTSTATUS smb2cli_set_info(struct smbXcli_conn *conn,
651                           uint32_t timeout_msec,
652                           struct smbXcli_session *session,
653                           struct smbXcli_tcon *tcon,
654                           uint8_t in_info_type,
655                           uint8_t in_file_info_class,
656                           const DATA_BLOB *in_input_buffer,
657                           uint32_t in_additional_info,
658                           uint64_t in_fid_persistent,
659                           uint64_t in_fid_volatile);
660
661 struct tevent_req *smb2cli_query_info_send(TALLOC_CTX *mem_ctx,
662                                            struct tevent_context *ev,
663                                            struct smbXcli_conn *conn,
664                                            uint32_t timeout_msec,
665                                            struct smbXcli_session *session,
666                                            struct smbXcli_tcon *tcon,
667                                            uint8_t in_info_type,
668                                            uint8_t in_file_info_class,
669                                            uint32_t in_max_output_length,
670                                            const DATA_BLOB *in_input_buffer,
671                                            uint32_t in_additional_info,
672                                            uint32_t in_flags,
673                                            uint64_t in_fid_persistent,
674                                            uint64_t in_fid_volatile);
675 NTSTATUS smb2cli_query_info_recv(struct tevent_req *req,
676                                  TALLOC_CTX *mem_ctx,
677                                  DATA_BLOB *out_output_buffer);
678 NTSTATUS smb2cli_query_info(struct smbXcli_conn *conn,
679                             uint32_t timeout_msec,
680                             struct smbXcli_session *session,
681                             struct smbXcli_tcon *tcon,
682                             uint8_t in_info_type,
683                             uint8_t in_file_info_class,
684                             uint32_t in_max_output_length,
685                             const DATA_BLOB *in_input_buffer,
686                             uint32_t in_additional_info,
687                             uint32_t in_flags,
688                             uint64_t in_fid_persistent,
689                             uint64_t in_fid_volatile,
690                             TALLOC_CTX *mem_ctx,
691                             DATA_BLOB *out_output_buffer);
692
693 struct tevent_req *smb2cli_query_directory_send(TALLOC_CTX *mem_ctx,
694                                                 struct tevent_context *ev,
695                                                 struct smbXcli_conn *conn,
696                                                 uint32_t timeout_msec,
697                                                 struct smbXcli_session *session,
698                                                 struct smbXcli_tcon *tcon,
699                                                 uint8_t level,
700                                                 uint8_t flags,
701                                                 uint32_t file_index,
702                                                 uint64_t fid_persistent,
703                                                 uint64_t fid_volatile,
704                                                 const char *mask,
705                                                 uint32_t outbuf_len);
706 NTSTATUS smb2cli_query_directory_recv(struct tevent_req *req,
707                                       TALLOC_CTX *mem_ctx,
708                                       uint8_t **data,
709                                       uint32_t *data_length);
710 NTSTATUS smb2cli_query_directory(struct smbXcli_conn *conn,
711                                  uint32_t timeout_msec,
712                                  struct smbXcli_session *session,
713                                  struct smbXcli_tcon *tcon,
714                                  uint8_t level,
715                                  uint8_t flags,
716                                  uint32_t file_index,
717                                  uint64_t fid_persistent,
718                                  uint64_t fid_volatile,
719                                  const char *mask,
720                                  uint32_t outbuf_len,
721                                  TALLOC_CTX *mem_ctx,
722                                  uint8_t **data,
723                                  uint32_t *data_length);
724
725 struct tevent_req *smb2cli_ioctl_send(TALLOC_CTX *mem_ctx,
726                                       struct tevent_context *ev,
727                                       struct smbXcli_conn *conn,
728                                       uint32_t timeout_msec,
729                                       struct smbXcli_session *session,
730                                       struct smbXcli_tcon *tcon,
731                                       uint64_t in_fid_persistent,
732                                       uint64_t in_fid_volatile,
733                                       uint32_t in_ctl_code,
734                                       uint32_t in_max_input_length,
735                                       const DATA_BLOB *in_input_buffer,
736                                       uint32_t in_max_output_length,
737                                       const DATA_BLOB *in_output_buffer,
738                                       uint32_t in_flags);
739 NTSTATUS smb2cli_ioctl_recv(struct tevent_req *req,
740                             TALLOC_CTX *mem_ctx,
741                             DATA_BLOB *out_input_buffer,
742                             DATA_BLOB *out_output_buffer);
743 NTSTATUS smb2cli_ioctl(struct smbXcli_conn *conn,
744                        uint32_t timeout_msec,
745                        struct smbXcli_session *session,
746                        struct smbXcli_tcon *tcon,
747                        uint64_t in_fid_persistent,
748                        uint64_t in_fid_volatile,
749                        uint32_t in_ctl_code,
750                        uint32_t in_max_input_length,
751                        const DATA_BLOB *in_input_buffer,
752                        uint32_t in_max_output_length,
753                        const DATA_BLOB *in_output_buffer,
754                        uint32_t in_flags,
755                        TALLOC_CTX *mem_ctx,
756                        DATA_BLOB *out_input_buffer,
757                        DATA_BLOB *out_output_buffer);
758
759 struct tevent_req *smb2cli_echo_send(TALLOC_CTX *mem_ctx,
760                                      struct tevent_context *ev,
761                                      struct smbXcli_conn *conn,
762                                      uint32_t timeout_msec);
763 NTSTATUS smb2cli_echo_recv(struct tevent_req *req);
764 NTSTATUS smb2cli_echo(struct smbXcli_conn *conn,
765                       uint32_t timeout_msec);
766
767 #endif /* _SMBXCLI_BASE_H_ */