2 Unix SMB/CIFS implementation.
3 Infrastructure for async SMB client requests
4 Copyright (C) Volker Lendecke 2008
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
20 #ifndef __ASYNC_SMB_H__
21 #define __ASYNC_SMB_H__
26 * struct cli_request is the state holder for an async client request we sent
27 * to the server. It can consist of more than one struct async_req that we
28 * have to server if the application did a cli_chain_cork() and
34 * "prev" and "next" form the doubly linked list in
35 * cli_state->outstanding_requests
37 struct cli_request *prev, *next;
40 * num_async: How many chained requests do we serve?
45 * async: This is the list of chained requests that were queued up by
46 * cli_request_chain before we sent out this request
48 struct async_req **async;
51 * The client connection for this request
53 struct cli_state *cli;
56 * The enc_state to decrypt the reply
58 struct smb_trans_enc_state *enc_state;
61 * The mid we used for this request. Mainly used to demultiplex on
67 * The bytes we have to ship to the server
72 * How much from "outbuf" did we already send
77 * The reply comes in here. Its intended size is implicit by
78 * smb_len(), its current size can be read via talloc_get_size()
83 * Specific requests might add stuff here. Maybe convert this to a
84 * private_pointer at some point.
100 * For requests that don't follow the strict request/reply pattern
101 * such as the transaction request family and echo requests it is
102 * necessary to break the standard procedure in
103 * handle_incoming_pdu(). For a simple example look at
104 * cli_echo_recv_helper().
107 void (*fn)(struct async_req *req);
113 * Ship a new smb request to the server
116 struct async_req *cli_request_send(TALLOC_CTX *mem_ctx,
117 struct event_context *ev,
118 struct cli_state *cli,
120 uint8_t additional_flags,
121 uint8_t wct, const uint16_t *vwv,
122 uint16_t num_bytes, const uint8_t *bytes);
124 bool cli_chain_cork(struct cli_state *cli, struct event_context *ev,
126 void cli_chain_uncork(struct cli_state *cli);
127 bool cli_in_chain(struct cli_state *cli);
129 NTSTATUS cli_pull_reply(struct async_req *req,
130 uint8_t *pwct, uint16_t **pvwv,
131 uint16_t *pnum_bytes, uint8_t **pbytes);
134 * Fetch an error out of a NBT packet
137 NTSTATUS cli_pull_error(char *buf);
140 * Compatibility helper for the sync APIs: Fake NTSTATUS in cli->inbuf
143 void cli_set_error(struct cli_state *cli, NTSTATUS status);