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
);