1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
/*
Unix SMB/CIFS implementation.
Infrastructure for async SMB client requests
Copyright (C) Volker Lendecke 2008
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef __ASYNC_SMB_H__
#define __ASYNC_SMB_H__
#include "includes.h"
/**
* struct cli_request is the state holder for an async client request we sent
* to the server. It can consist of more than one struct async_req that we
* have to server if the application did a cli_chain_cork() and
* cli_chain_uncork()
*/
struct cli_request {
/**
* "prev" and "next" form the doubly linked list in
* cli_state->outstanding_requests
*/
struct cli_request *prev, *next;
/**
* num_async: How many chained requests do we serve?
*/
int num_async;
/**
* async: This is the list of chained requests that were queued up by
* cli_request_chain before we sent out this request
*/
struct async_req **async;
/**
* The client connection for this request
*/
struct cli_state *cli;
/**
* The enc_state to decrypt the reply
*/
struct smb_trans_enc_state *enc_state;
/**
* The mid we used for this request. Mainly used to demultiplex on
* receiving replies.
*/
uint16_t mid;
/**
* The bytes we have to ship to the server
*/
char *outbuf;
/**
* How much from "outbuf" did we already send
*/
size_t sent;
/**
* The reply comes in here. Its intended size is implicit by
* smb_len(), its current size can be read via talloc_get_size()
*/
char *inbuf;
/**
* Specific requests might add stuff here. Maybe convert this to a
* private_pointer at some point.
*/
union {
struct {
off_t ofs;
size_t size;
ssize_t received;
uint8_t *rcvbuf;
} read;
struct {
DATA_BLOB data;
uint16_t num_echos;
} echo;
} data;
/**
* For requests that don't follow the strict request/reply pattern
* such as the transaction request family and echo requests it is
* necessary to break the standard procedure in
* handle_incoming_pdu(). For a simple example look at
* cli_echo_recv_helper().
*/
struct {
void (*fn)(struct async_req *req);
void *priv;
} recv_helper;
};
/*
* Ship a new smb request to the server
*/
struct async_req *cli_request_send(TALLOC_CTX *mem_ctx,
struct event_context *ev,
struct cli_state *cli,
uint8_t smb_command,
uint8_t additional_flags,
uint8_t wct, const uint16_t *vwv,
uint16_t num_bytes, const uint8_t *bytes);
bool cli_chain_cork(struct cli_state *cli, struct event_context *ev,
size_t size_hint);
void cli_chain_uncork(struct cli_state *cli);
NTSTATUS cli_pull_reply(struct async_req *req,
uint8_t *pwct, uint16_t **pvwv,
uint16_t *pnum_bytes, uint8_t **pbytes);
/*
* Fetch an error out of a NBT packet
*/
NTSTATUS cli_pull_error(char *buf);
/*
* Compatibility helper for the sync APIs: Fake NTSTATUS in cli->inbuf
*/
void cli_set_error(struct cli_state *cli, NTSTATUS status);
#endif
|
