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
 307 struct tevent_req *smb2cli_req_create(TALLOC_CTX *mem_ctx,
 308                                       struct tevent_context *ev,
 309                                       struct smbXcli_conn *conn,
 310                                       uint16_t cmd,
 311                                       uint32_t additional_flags,
 312                                       uint32_t clear_flags,
 313                                       uint32_t timeout_msec,
 314                                       struct smbXcli_tcon *tcon,
 315                                       struct smbXcli_session *session,
 316                                       const uint8_t *fixed,
 317                                       uint16_t fixed_len,
 318                                       const uint8_t *dyn,
 319                                       uint32_t dyn_len,
 320                                       uint32_t max_dyn_len);
 321 void smb2cli_req_set_notify_async(struct tevent_req *req);
 322 NTSTATUS smb2cli_req_compound_submit(struct tevent_req **reqs,
 323                                      int num_reqs);
 324 void smb2cli_req_set_credit_charge(struct tevent_req *req, uint16_t charge);
 325
 326 struct smb2cli_req_expected_response {
 327         NTSTATUS status;
 328         uint16_t body_size;
 329 };
 330
 331 struct tevent_req *smb2cli_req_send(TALLOC_CTX *mem_ctx,
 332                                     struct tevent_context *ev,
 333                                     struct smbXcli_conn *conn,
 334                                     uint16_t cmd,
 335                                     uint32_t additional_flags,
 336                                     uint32_t clear_flags,
 337                                     uint32_t timeout_msec,
 338                                     struct smbXcli_tcon *tcon,
 339                                     struct smbXcli_session *session,
 340                                     const uint8_t *fixed,
 341                                     uint16_t fixed_len,
 342                                     const uint8_t *dyn,
 343                                     uint32_t dyn_len,
 344                                     uint32_t max_dyn_len);
 345 NTSTATUS smb2cli_req_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
 346                           struct iovec **piov,
 347                           const struct smb2cli_req_expected_response *expected,
 348                           size_t num_expected);
 349
 350 struct tevent_req *smbXcli_negprot_send(TALLOC_CTX *mem_ctx,
 351                                         struct tevent_context *ev,
 352                                         struct smbXcli_conn *conn,
 353                                         uint32_t timeout_msec,
 354                                         enum protocol_types min_protocol,
 355                                         enum protocol_types max_protocol);
 356 NTSTATUS smbXcli_negprot_recv(struct tevent_req *req);
 357 NTSTATUS smbXcli_negprot(struct smbXcli_conn *conn,
 358                          uint32_t timeout_msec,
 359                          enum protocol_types min_protocol,
 360                          enum protocol_types max_protocol);
 361
 362 struct tevent_req *smb2cli_validate_negotiate_info_send(TALLOC_CTX *mem_ctx,
 363                                                 struct tevent_context *ev,
 364                                                 struct smbXcli_conn *conn,
 365                                                 uint32_t timeout_msec,
 366                                                 struct smbXcli_session *session,
 367                                                 struct smbXcli_tcon *tcon);
 368 NTSTATUS smb2cli_validate_negotiate_info_recv(struct tevent_req *req);
 369
 370 struct smbXcli_session *smbXcli_session_create(TALLOC_CTX *mem_ctx,
 371                                                struct smbXcli_conn *conn);
 372 struct smbXcli_session *smbXcli_session_copy(TALLOC_CTX *mem_ctx,
 373                                                struct smbXcli_session *src);
 374 bool smbXcli_session_is_authenticated(struct smbXcli_session *session);
 375 NTSTATUS smbXcli_session_application_key(struct smbXcli_session *session,
 376                                          TALLOC_CTX *mem_ctx,
 377                                          DATA_BLOB *key);
 378 void smbXcli_session_set_disconnect_expired(struct smbXcli_session *session);
 379 uint16_t smb1cli_session_current_id(struct smbXcli_session* session);
 380 void smb1cli_session_set_id(struct smbXcli_session* session,
 381                             uint16_t session_id);
 382 NTSTATUS smb1cli_session_set_session_key(struct smbXcli_session *session,
 383                                          const DATA_BLOB _session_key);
 384 NTSTATUS smb1cli_session_protect_session_key(struct smbXcli_session *session);
 385 uint8_t smb2cli_session_security_mode(struct smbXcli_session *session);
 386 uint64_t smb2cli_session_current_id(struct smbXcli_session *session);
 387 uint16_t smb2cli_session_get_flags(struct smbXcli_session *session);
 388 void smb2cli_session_set_id_and_flags(struct smbXcli_session *session,
 389                                       uint64_t session_id,
 390                                       uint16_t session_flags);
 391 void smb2cli_session_increment_channel_sequence(struct smbXcli_session *session);
 392 uint16_t smb2cli_session_reset_channel_sequence(struct smbXcli_session *session,
 393                                                 uint16_t channel_sequence);
 394 void smb2cli_session_start_replay(struct smbXcli_session *session);
 395 void smb2cli_session_stop_replay(struct smbXcli_session *session);
 396 NTSTATUS smb2cli_session_set_session_key(struct smbXcli_session *session,
 397                                          const DATA_BLOB session_key,
 398                                          const struct iovec *recv_iov);
 399 NTSTATUS smb2cli_session_create_channel(TALLOC_CTX *mem_ctx,
 400                                         struct smbXcli_session *session1,
 401                                         struct smbXcli_conn *conn,
 402                                         struct smbXcli_session **_session2);
 403 NTSTATUS smb2cli_session_set_channel_key(struct smbXcli_session *session,
 404                                          const DATA_BLOB channel_key,
 405                                          const struct iovec *recv_iov);
 406 NTSTATUS smb2cli_session_encryption_on(struct smbXcli_session *session);
 407
 408 struct smbXcli_tcon *smbXcli_tcon_create(TALLOC_CTX *mem_ctx);
 409 void smbXcli_tcon_set_fs_attributes(struct smbXcli_tcon *tcon,
 410                                     uint32_t fs_attributes);
 411 uint32_t smbXcli_tcon_get_fs_attributes(struct smbXcli_tcon *tcon);
 412 bool smbXcli_tcon_is_dfs_share(struct smbXcli_tcon *tcon);
 413 uint16_t smb1cli_tcon_current_id(struct smbXcli_tcon *tcon);
 414 void smb1cli_tcon_set_id(struct smbXcli_tcon *tcon, uint16_t tcon_id);
 415 bool smb1cli_tcon_set_values(struct smbXcli_tcon *tcon,
 416                              uint16_t tcon_id,
 417                              uint16_t optional_support,
 418                              uint32_t maximal_access,
 419                              uint32_t guest_maximal_access,
 420                              const char *service,
 421                              const char *fs_type);
 422 uint32_t smb2cli_tcon_current_id(struct smbXcli_tcon *tcon);
 423 uint32_t smb2cli_tcon_capabilities(struct smbXcli_tcon *tcon);
 424 void smb2cli_tcon_set_values(struct smbXcli_tcon *tcon,
 425                              struct smbXcli_session *session,
 426                              uint32_t tcon_id,
 427                              uint8_t type,
 428                              uint32_t flags,
 429                              uint32_t capabilities,
 430                              uint32_t maximal_access);
 431 void smb2cli_tcon_should_sign(struct smbXcli_tcon *tcon,
 432                               bool should_sign);
 433 bool smb2cli_tcon_is_signing_on(struct smbXcli_tcon *tcon);
 434 void smb2cli_tcon_should_encrypt(struct smbXcli_tcon *tcon,
 435                                  bool should_encrypt);
 436 bool smb2cli_tcon_is_encryption_on(struct smbXcli_tcon *tcon);
 437
 438 struct tevent_req *smb2cli_session_setup_send(TALLOC_CTX *mem_ctx,
 439                                 struct tevent_context *ev,
 440                                 struct smbXcli_conn *conn,
 441                                 uint32_t timeout_msec,
 442                                 struct smbXcli_session *session,
 443                                 uint8_t in_flags,
 444                                 uint32_t in_capabilities,
 445                                 uint32_t in_channel,
 446                                 uint64_t in_previous_session_id,
 447                                 const DATA_BLOB *in_security_buffer);
 448 NTSTATUS smb2cli_session_setup_recv(struct tevent_req *req,
 449                                     TALLOC_CTX *mem_ctx,
 450                                     struct iovec **recv_iov,
 451                                     DATA_BLOB *out_security_buffer);
 452
 453 struct tevent_req *smb2cli_logoff_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 NTSTATUS smb2cli_logoff_recv(struct tevent_req *req);
 459 NTSTATUS smb2cli_logoff(struct smbXcli_conn *conn,
 460                         uint32_t timeout_msec,
 461                         struct smbXcli_session *session);
 462
 463 struct tevent_req *smb2cli_tcon_send(TALLOC_CTX *mem_ctx,
 464                                      struct tevent_context *ev,
 465                                      struct smbXcli_conn *conn,
 466                                      uint32_t timeout_msec,
 467                                      struct smbXcli_session *session,
 468                                      struct smbXcli_tcon *tcon,
 469                                      uint16_t flags,
 470                                      const char *unc);
 471 NTSTATUS smb2cli_tcon_recv(struct tevent_req *req);
 472 NTSTATUS smb2cli_tcon(struct smbXcli_conn *conn,
 473                       uint32_t timeout_msec,
 474                       struct smbXcli_session *session,
 475                       struct smbXcli_tcon *tcon,
 476                       uint16_t flags,
 477                       const char *unc);
 478
 479 struct tevent_req *smb2cli_tdis_send(TALLOC_CTX *mem_ctx,
 480                                      struct tevent_context *ev,
 481                                      struct smbXcli_conn *conn,
 482                                      uint32_t timeout_msec,
 483                                      struct smbXcli_session *session,
 484                                      struct smbXcli_tcon *tcon);
 485 NTSTATUS smb2cli_tdis_recv(struct tevent_req *req);
 486 NTSTATUS smb2cli_tdis(struct smbXcli_conn *conn,
 487                       uint32_t timeout_msec,
 488                       struct smbXcli_session *session,
 489                       struct smbXcli_tcon *tcon);
 490
 491 struct tevent_req *smb2cli_create_send(
 492         TALLOC_CTX *mem_ctx,
 493         struct tevent_context *ev,
 494         struct smbXcli_conn *conn,
 495         uint32_t timeout_msec,
 496         struct smbXcli_session *session,
 497         struct smbXcli_tcon *tcon,
 498         const char *filename,
 499         uint8_t  oplock_level,          /* SMB2_OPLOCK_LEVEL_* */
 500         uint32_t impersonation_level,   /* SMB2_IMPERSONATION_* */
 501         uint32_t desired_access,
 502         uint32_t file_attributes,
 503         uint32_t share_access,
 504         uint32_t create_disposition,
 505         uint32_t create_options,
 506         struct smb2_create_blobs *blobs);
 507 NTSTATUS smb2cli_create_recv(struct tevent_req *req,
 508                              uint64_t *fid_persistent,
 509                              uint64_t *fid_volatile,
 510                              struct smb_create_returns *cr,
 511                              TALLOC_CTX *mem_ctx,
 512                              struct smb2_create_blobs *blobs);
 513 NTSTATUS smb2cli_create(struct smbXcli_conn *conn,
 514                         uint32_t timeout_msec,
 515                         struct smbXcli_session *session,
 516                         struct smbXcli_tcon *tcon,
 517                         const char *filename,
 518                         uint8_t  oplock_level,       /* SMB2_OPLOCK_LEVEL_* */
 519                         uint32_t impersonation_level, /* SMB2_IMPERSONATION_* */
 520                         uint32_t desired_access,
 521                         uint32_t file_attributes,
 522                         uint32_t share_access,
 523                         uint32_t create_disposition,
 524                         uint32_t create_options,
 525                         struct smb2_create_blobs *blobs,
 526                         uint64_t *fid_persistent,
 527                         uint64_t *fid_volatile,
 528                         struct smb_create_returns *cr,
 529                         TALLOC_CTX *mem_ctx,
 530                         struct smb2_create_blobs *ret_blobs);
 531
 532 struct tevent_req *smb2cli_close_send(TALLOC_CTX *mem_ctx,
 533                                       struct tevent_context *ev,
 534                                       struct smbXcli_conn *conn,
 535                                       uint32_t timeout_msec,
 536                                       struct smbXcli_session *session,
 537                                       struct smbXcli_tcon *tcon,
 538                                       uint16_t flags,
 539                                       uint64_t fid_persistent,
 540                                       uint64_t fid_volatile);
 541 NTSTATUS smb2cli_close_recv(struct tevent_req *req);
 542 NTSTATUS smb2cli_close(struct smbXcli_conn *conn,
 543                        uint32_t timeout_msec,
 544                        struct smbXcli_session *session,
 545                        struct smbXcli_tcon *tcon,
 546                        uint16_t flags,
 547                        uint64_t fid_persistent,
 548                        uint64_t fid_volatile);
 549
 550 struct tevent_req *smb2cli_read_send(TALLOC_CTX *mem_ctx,
 551                                      struct tevent_context *ev,
 552                                      struct smbXcli_conn *conn,
 553                                      uint32_t timeout_msec,
 554                                      struct smbXcli_session *session,
 555                                      struct smbXcli_tcon *tcon,
 556                                      uint32_t length,
 557                                      uint64_t offset,
 558                                      uint64_t fid_persistent,
 559                                      uint64_t fid_volatile,
 560                                      uint64_t minimum_count,
 561                                      uint64_t remaining_bytes);
 562 NTSTATUS smb2cli_read_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
 563                            uint8_t **data, uint32_t *data_length);
 564 NTSTATUS smb2cli_read(struct smbXcli_conn *conn,
 565                       uint32_t timeout_msec,
 566                       struct smbXcli_session *session,
 567                       struct smbXcli_tcon *tcon,
 568                       uint32_t length,
 569                       uint64_t offset,
 570                       uint64_t fid_persistent,
 571                       uint64_t fid_volatile,
 572                       uint64_t minimum_count,
 573                       uint64_t remaining_bytes,
 574                       TALLOC_CTX *mem_ctx,
 575                       uint8_t **data,
 576                       uint32_t *data_length);
 577
 578 struct tevent_req *smb2cli_write_send(TALLOC_CTX *mem_ctx,
 579                                       struct tevent_context *ev,
 580                                       struct smbXcli_conn *conn,
 581                                       uint32_t timeout_msec,
 582                                       struct smbXcli_session *session,
 583                                       struct smbXcli_tcon *tcon,
 584                                       uint32_t length,
 585                                       uint64_t offset,
 586                                       uint64_t fid_persistent,
 587                                       uint64_t fid_volatile,
 588                                       uint32_t remaining_bytes,
 589                                       uint32_t flags,
 590                                       const uint8_t *data);
 591 NTSTATUS smb2cli_write_recv(struct tevent_req *req,
 592                         uint32_t *written);
 593 NTSTATUS smb2cli_write(struct smbXcli_conn *conn,
 594                        uint32_t timeout_msec,
 595                        struct smbXcli_session *session,
 596                        struct smbXcli_tcon *tcon,
 597                        uint32_t length,
 598                        uint64_t offset,
 599                        uint64_t fid_persistent,
 600                        uint64_t fid_volatile,
 601                        uint32_t remaining_bytes,
 602                        uint32_t flags,
 603                        const uint8_t *data,
 604                        uint32_t *written);
 605
 606 struct tevent_req *smb2cli_flush_send(TALLOC_CTX *mem_ctx,
 607                                       struct tevent_context *ev,
 608                                       struct smbXcli_conn *conn,
 609                                       uint32_t timeout_msec,
 610                                       struct smbXcli_session *session,
 611                                       struct smbXcli_tcon *tcon,
 612                                       uint64_t fid_persistent,
 613                                       uint64_t fid_volatile);
 614 NTSTATUS smb2cli_flush_recv(struct tevent_req *req);
 615 NTSTATUS smb2cli_flush(struct smbXcli_conn *conn,
 616                        uint32_t timeout_msec,
 617                        struct smbXcli_session *session,
 618                        struct smbXcli_tcon *tcon,
 619                        uint64_t fid_persistent,
 620                        uint64_t fid_volatile);
 621
 622 struct tevent_req *smb2cli_set_info_send(TALLOC_CTX *mem_ctx,
 623                                          struct tevent_context *ev,
 624                                          struct smbXcli_conn *conn,
 625                                          uint32_t timeout_msec,
 626                                          struct smbXcli_session *session,
 627                                          struct smbXcli_tcon *tcon,
 628                                          uint8_t in_info_type,
 629                                          uint8_t in_file_info_class,
 630                                          const DATA_BLOB *in_input_buffer,
 631                                          uint32_t in_additional_info,
 632                                          uint64_t in_fid_persistent,
 633                                          uint64_t in_fid_volatile);
 634 NTSTATUS smb2cli_set_info_recv(struct tevent_req *req);
 635 NTSTATUS smb2cli_set_info(struct smbXcli_conn *conn,
 636                           uint32_t timeout_msec,
 637                           struct smbXcli_session *session,
 638                           struct smbXcli_tcon *tcon,
 639                           uint8_t in_info_type,
 640                           uint8_t in_file_info_class,
 641                           const DATA_BLOB *in_input_buffer,
 642                           uint32_t in_additional_info,
 643                           uint64_t in_fid_persistent,
 644                           uint64_t in_fid_volatile);
 645
 646 struct tevent_req *smb2cli_query_info_send(TALLOC_CTX *mem_ctx,
 647                                            struct tevent_context *ev,
 648                                            struct smbXcli_conn *conn,
 649                                            uint32_t timeout_msec,
 650                                            struct smbXcli_session *session,
 651                                            struct smbXcli_tcon *tcon,
 652                                            uint8_t in_info_type,
 653                                            uint8_t in_file_info_class,
 654                                            uint32_t in_max_output_length,
 655                                            const DATA_BLOB *in_input_buffer,
 656                                            uint32_t in_additional_info,
 657                                            uint32_t in_flags,
 658                                            uint64_t in_fid_persistent,
 659                                            uint64_t in_fid_volatile);
 660 NTSTATUS smb2cli_query_info_recv(struct tevent_req *req,
 661                                  TALLOC_CTX *mem_ctx,
 662                                  DATA_BLOB *out_output_buffer);
 663 NTSTATUS smb2cli_query_info(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                             TALLOC_CTX *mem_ctx,
 676                             DATA_BLOB *out_output_buffer);
 677
 678 struct tevent_req *smb2cli_query_directory_send(TALLOC_CTX *mem_ctx,
 679                                                 struct tevent_context *ev,
 680                                                 struct smbXcli_conn *conn,
 681                                                 uint32_t timeout_msec,
 682                                                 struct smbXcli_session *session,
 683                                                 struct smbXcli_tcon *tcon,
 684                                                 uint8_t level,
 685                                                 uint8_t flags,
 686                                                 uint32_t file_index,
 687                                                 uint64_t fid_persistent,
 688                                                 uint64_t fid_volatile,
 689                                                 const char *mask,
 690                                                 uint32_t outbuf_len);
 691 NTSTATUS smb2cli_query_directory_recv(struct tevent_req *req,
 692                                       TALLOC_CTX *mem_ctx,
 693                                       uint8_t **data,
 694                                       uint32_t *data_length);
 695 NTSTATUS smb2cli_query_directory(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                                  TALLOC_CTX *mem_ctx,
 707                                  uint8_t **data,
 708                                  uint32_t *data_length);
 709
 710 struct tevent_req *smb2cli_ioctl_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,
 716                                       uint64_t in_fid_persistent,
 717                                       uint64_t in_fid_volatile,
 718                                       uint32_t in_ctl_code,
 719                                       uint32_t in_max_input_length,
 720                                       const DATA_BLOB *in_input_buffer,
 721                                       uint32_t in_max_output_length,
 722                                       const DATA_BLOB *in_output_buffer,
 723                                       uint32_t in_flags);
 724 NTSTATUS smb2cli_ioctl_recv(struct tevent_req *req,
 725                             TALLOC_CTX *mem_ctx,
 726                             DATA_BLOB *out_input_buffer,
 727                             DATA_BLOB *out_output_buffer);
 728 NTSTATUS smb2cli_ioctl(struct smbXcli_conn *conn,
 729                        uint32_t timeout_msec,
 730                        struct smbXcli_session *session,
 731                        struct smbXcli_tcon *tcon,
 732                        uint64_t in_fid_persistent,
 733                        uint64_t in_fid_volatile,
 734                        uint32_t in_ctl_code,
 735                        uint32_t in_max_input_length,
 736                        const DATA_BLOB *in_input_buffer,
 737                        uint32_t in_max_output_length,
 738                        const DATA_BLOB *in_output_buffer,
 739                        uint32_t in_flags,
 740                        TALLOC_CTX *mem_ctx,
 741                        DATA_BLOB *out_input_buffer,
 742                        DATA_BLOB *out_output_buffer);
 743
 744 struct tevent_req *smb2cli_echo_send(TALLOC_CTX *mem_ctx,
 745                                      struct tevent_context *ev,
 746                                      struct smbXcli_conn *conn,
 747                                      uint32_t timeout_msec);
 748 NTSTATUS smb2cli_echo_recv(struct tevent_req *req);
 749 NTSTATUS smb2cli_echo(struct smbXcli_conn *conn,
 750                       uint32_t timeout_msec);
 751
 752 #endif /* _SMBXCLI_BASE_H_ */