2 Unix SMB/CIFS implementation.
5 Copyright (C) Stefan Metzmacher 2009
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.
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.
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/>.
22 #include "smbd/smbd.h"
23 #include "smbd/globals.h"
24 #include "../libcli/smb/smb_common.h"
25 #include "../lib/util/tevent_ntstatus.h"
26 #include "include/ntioctl.h"
27 #include "smb2_ioctl_private.h"
28 #include "librpc/gen_ndr/ioctl.h"
31 #define DBGC_CLASS DBGC_SMB2
33 static struct tevent_req
*smbd_smb2_ioctl_send(TALLOC_CTX
*mem_ctx
,
34 struct tevent_context
*ev
,
35 struct smbd_smb2_request
*smb2req
,
36 struct files_struct
*in_fsp
,
39 uint32_t in_max_output
,
41 static NTSTATUS
smbd_smb2_ioctl_recv(struct tevent_req
*req
,
43 DATA_BLOB
*out_output
,
44 uint8_t *body_padding
,
47 static void smbd_smb2_request_ioctl_done(struct tevent_req
*subreq
);
48 NTSTATUS
smbd_smb2_request_process_ioctl(struct smbd_smb2_request
*req
)
51 const uint8_t *inbody
;
52 uint32_t min_buffer_offset
;
53 uint32_t max_buffer_offset
;
54 uint32_t min_output_offset
;
55 uint32_t allowed_length_in
;
56 uint32_t allowed_length_out
;
58 uint64_t in_file_id_persistent
;
59 uint64_t in_file_id_volatile
;
60 struct files_struct
*in_fsp
= NULL
;
61 uint32_t in_input_offset
;
62 uint32_t in_input_length
;
63 DATA_BLOB in_input_buffer
= data_blob_null
;
64 uint32_t in_max_input_length
;
65 uint32_t in_output_offset
;
66 uint32_t in_output_length
;
67 DATA_BLOB in_output_buffer
= data_blob_null
;
68 uint32_t in_max_output_length
;
70 uint32_t data_length_in
;
71 uint32_t data_length_out
;
72 uint32_t data_length_tmp
;
73 uint32_t data_length_max
;
74 struct tevent_req
*subreq
;
76 status
= smbd_smb2_request_verify_sizes(req
, 0x39);
77 if (!NT_STATUS_IS_OK(status
)) {
78 return smbd_smb2_request_error(req
, status
);
80 inbody
= SMBD_SMB2_IN_BODY_PTR(req
);
82 in_ctl_code
= IVAL(inbody
, 0x04);
83 in_file_id_persistent
= BVAL(inbody
, 0x08);
84 in_file_id_volatile
= BVAL(inbody
, 0x10);
85 in_input_offset
= IVAL(inbody
, 0x18);
86 in_input_length
= IVAL(inbody
, 0x1C);
87 in_max_input_length
= IVAL(inbody
, 0x20);
88 in_output_offset
= IVAL(inbody
, 0x24);
89 in_output_length
= IVAL(inbody
, 0x28);
90 in_max_output_length
= IVAL(inbody
, 0x2C);
91 in_flags
= IVAL(inbody
, 0x30);
93 min_buffer_offset
= SMB2_HDR_BODY
+ SMBD_SMB2_IN_BODY_LEN(req
);
94 max_buffer_offset
= min_buffer_offset
+ SMBD_SMB2_IN_DYN_LEN(req
);
95 min_output_offset
= min_buffer_offset
;
98 * InputOffset (4 bytes): The offset, in bytes, from the beginning of
99 * the SMB2 header to the input data buffer. If no input data is
100 * required for the FSCTL/IOCTL command being issued, the client SHOULD
101 * set this value to 0.<49>
102 * <49> If no input data is required for the FSCTL/IOCTL command being
103 * issued, Windows-based clients set this field to any value.
105 allowed_length_in
= 0;
106 if ((in_input_offset
> 0) && (in_input_length
> 0)) {
109 if (in_input_offset
< min_buffer_offset
) {
110 return smbd_smb2_request_error(req
,
111 NT_STATUS_INVALID_PARAMETER
);
113 if (in_input_offset
> max_buffer_offset
) {
114 return smbd_smb2_request_error(req
,
115 NT_STATUS_INVALID_PARAMETER
);
117 allowed_length_in
= max_buffer_offset
- in_input_offset
;
119 tmp_ofs
= in_input_offset
- min_buffer_offset
;
120 in_input_buffer
.data
= SMBD_SMB2_IN_DYN_PTR(req
);
121 in_input_buffer
.data
+= tmp_ofs
;
122 in_input_buffer
.length
= in_input_length
;
123 min_output_offset
+= tmp_ofs
;
124 min_output_offset
+= in_input_length
;
127 if (in_input_length
> allowed_length_in
) {
128 return smbd_smb2_request_error(req
, NT_STATUS_INVALID_PARAMETER
);
131 allowed_length_out
= 0;
132 if (in_output_offset
> 0) {
133 if (in_output_offset
< min_buffer_offset
) {
134 return smbd_smb2_request_error(req
,
135 NT_STATUS_INVALID_PARAMETER
);
137 if (in_output_offset
> max_buffer_offset
) {
138 return smbd_smb2_request_error(req
,
139 NT_STATUS_INVALID_PARAMETER
);
141 allowed_length_out
= max_buffer_offset
- in_output_offset
;
144 if (in_output_length
> allowed_length_out
) {
145 return smbd_smb2_request_error(req
, NT_STATUS_INVALID_PARAMETER
);
148 if (in_output_length
> 0) {
151 if (in_output_offset
< min_output_offset
) {
152 return smbd_smb2_request_error(req
,
153 NT_STATUS_INVALID_PARAMETER
);
156 tmp_ofs
= in_output_offset
- min_buffer_offset
;
157 in_output_buffer
.data
= SMBD_SMB2_IN_DYN_PTR(req
);
158 in_output_buffer
.data
+= tmp_ofs
;
159 in_output_buffer
.length
= in_output_length
;
163 * verify the credits and avoid overflows
164 * in_input_buffer.length and in_output_buffer.length
165 * are already verified.
167 data_length_in
= in_input_buffer
.length
+ in_output_buffer
.length
;
169 data_length_out
= in_max_input_length
;
170 data_length_tmp
= UINT32_MAX
- data_length_out
;
171 if (data_length_tmp
< in_max_output_length
) {
172 return smbd_smb2_request_error(req
, NT_STATUS_INVALID_PARAMETER
);
174 data_length_out
+= in_max_output_length
;
176 data_length_max
= MAX(data_length_in
, data_length_out
);
178 status
= smbd_smb2_request_verify_creditcharge(req
, data_length_max
);
179 if (!NT_STATUS_IS_OK(status
)) {
180 return smbd_smb2_request_error(req
, status
);
184 * If the Flags field of the request is not SMB2_0_IOCTL_IS_FSCTL the
185 * server MUST fail the request with STATUS_NOT_SUPPORTED.
187 if (in_flags
!= SMB2_IOCTL_FLAG_IS_FSCTL
) {
188 return smbd_smb2_request_error(req
, NT_STATUS_NOT_SUPPORTED
);
191 switch (in_ctl_code
) {
192 case FSCTL_DFS_GET_REFERRALS
:
193 case FSCTL_DFS_GET_REFERRALS_EX
:
194 case FSCTL_PIPE_WAIT
:
195 case FSCTL_VALIDATE_NEGOTIATE_INFO_224
:
196 case FSCTL_VALIDATE_NEGOTIATE_INFO
:
197 case FSCTL_QUERY_NETWORK_INTERFACE_INFO
:
198 case FSCTL_SMBTORTURE_FORCE_UNACKED_TIMEOUT
:
199 case FSCTL_SMBTORTURE_IOCTL_RESPONSE_BODY_PADDING8
:
200 case FSCTL_SMBTORTURE_GLOBAL_READ_RESPONSE_BODY_PADDING8
:
202 * Some SMB2 specific CtlCodes like FSCTL_DFS_GET_REFERRALS or
203 * FSCTL_PIPE_WAIT does not take a file handle.
205 * If FileId in the SMB2 Header of the request is not
206 * 0xFFFFFFFFFFFFFFFF, then the server MUST fail the request
207 * with STATUS_INVALID_PARAMETER.
209 if (in_file_id_persistent
!= UINT64_MAX
||
210 in_file_id_volatile
!= UINT64_MAX
) {
211 return smbd_smb2_request_error(req
,
212 NT_STATUS_INVALID_PARAMETER
);
216 in_fsp
= file_fsp_smb2(req
, in_file_id_persistent
,
217 in_file_id_volatile
);
218 if (in_fsp
== NULL
) {
219 return smbd_smb2_request_error(req
, NT_STATUS_FILE_CLOSED
);
224 subreq
= smbd_smb2_ioctl_send(req
, req
->sconn
->ev_ctx
,
228 in_max_output_length
,
230 if (subreq
== NULL
) {
231 return smbd_smb2_request_error(req
, NT_STATUS_NO_MEMORY
);
235 * If the FSCTL has gone async on a file handle, remember
236 * to add it to the list of async requests we need to wait
237 * for on file handle close.
239 if (in_fsp
!= NULL
&& tevent_req_is_in_progress(subreq
)) {
242 ok
= aio_add_req_to_fsp(in_fsp
, subreq
);
244 return smbd_smb2_request_error(req
, NT_STATUS_NO_MEMORY
);
248 tevent_req_set_callback(subreq
, smbd_smb2_request_ioctl_done
, req
);
250 return smbd_smb2_request_pending_queue(req
, subreq
, 1000);
254 * 3.3.4.4 Sending an Error Response
255 * An error code other than one of the following indicates a failure:
257 static bool smbd_smb2_ioctl_is_failure(uint32_t ctl_code
, NTSTATUS status
,
260 if (NT_STATUS_IS_OK(status
)) {
265 * STATUS_BUFFER_OVERFLOW in a FSCTL_PIPE_TRANSCEIVE, FSCTL_PIPE_PEEK or
266 * FSCTL_DFS_GET_REFERRALS Response specified in section 2.2.32.<153>
268 if (NT_STATUS_EQUAL(status
, STATUS_BUFFER_OVERFLOW
)
269 && ((ctl_code
== FSCTL_PIPE_TRANSCEIVE
)
270 || (ctl_code
== FSCTL_PIPE_PEEK
)
271 || (ctl_code
== FSCTL_DFS_GET_REFERRALS
))) {
276 * Any status other than STATUS_SUCCESS in a FSCTL_SRV_COPYCHUNK or
277 * FSCTL_SRV_COPYCHUNK_WRITE Response, when returning an
278 * SRV_COPYCHUNK_RESPONSE as described in section 2.2.32.1.
280 if (((ctl_code
== FSCTL_SRV_COPYCHUNK
)
281 || (ctl_code
== FSCTL_SRV_COPYCHUNK_WRITE
))
282 && (data_size
== sizeof(struct srv_copychunk_rsp
))) {
289 static void smbd_smb2_request_ioctl_done(struct tevent_req
*subreq
)
291 struct smbd_smb2_request
*req
= tevent_req_callback_data(subreq
,
292 struct smbd_smb2_request
);
293 const uint8_t *inbody
;
296 uint32_t in_ctl_code
;
297 uint64_t in_file_id_persistent
;
298 uint64_t in_file_id_volatile
;
299 uint32_t in_max_output_length
;
300 uint32_t out_input_offset
;
301 uint32_t out_output_offset
;
302 DATA_BLOB out_output_buffer
= data_blob_null
;
304 NTSTATUS error
; /* transport error */
305 bool disconnect
= false;
307 uint8_t body_padding
= 0;
309 status
= smbd_smb2_ioctl_recv(subreq
, req
,
314 DEBUG(10,("smbd_smb2_request_ioctl_done: smbd_smb2_ioctl_recv returned "
316 (unsigned int)out_output_buffer
.length
,
317 nt_errstr(status
) ));
322 smbd_server_connection_terminate(req
->xconn
,
327 inbody
= SMBD_SMB2_IN_BODY_PTR(req
);
329 in_ctl_code
= IVAL(inbody
, 0x04);
330 in_file_id_persistent
= BVAL(inbody
, 0x08);
331 in_file_id_volatile
= BVAL(inbody
, 0x10);
332 in_max_output_length
= IVAL(inbody
, 0x2C);
334 if (out_output_buffer
.length
> in_max_output_length
) {
336 * Return NT_STATUS_BUFFER_TOO_SMALL by
337 * default if the provided buffer doesn't
340 * If someone wants truncated data
341 * together with STATUS_BUFFER_OVERFLOW
342 * it needs to be done explicitly in
343 * the backends. We currently do that
345 * - fsctl_dfs_get_refers()
346 * - smbd_smb2_ioctl_pipe_read_done()
348 status
= NT_STATUS_BUFFER_TOO_SMALL
;
351 if (smbd_smb2_ioctl_is_failure(in_ctl_code
, status
,
352 out_output_buffer
.length
)) {
353 error
= smbd_smb2_request_error(req
, status
);
354 if (!NT_STATUS_IS_OK(error
)) {
355 smbd_server_connection_terminate(req
->xconn
,
363 * Only FSCTL_SMBTORTURE_IOCTL_RESPONSE_BODY_PADDING8
364 * sets body_padding to a value different from 0.
366 body_size
= 0x30 + body_padding
;
367 out_input_offset
= SMB2_HDR_BODY
+ body_size
;
368 out_output_offset
= SMB2_HDR_BODY
+ body_size
;
370 outbody
= smbd_smb2_generate_outbody(req
, body_size
);
371 if (outbody
.data
== NULL
) {
372 error
= smbd_smb2_request_error(req
, NT_STATUS_NO_MEMORY
);
373 if (!NT_STATUS_IS_OK(error
)) {
374 smbd_server_connection_terminate(req
->xconn
,
381 SSVAL(outbody
.data
, 0x00, 0x30 + 1); /* struct size */
382 SSVAL(outbody
.data
, 0x02, 0); /* reserved */
383 SIVAL(outbody
.data
, 0x04,
384 in_ctl_code
); /* ctl code */
385 SBVAL(outbody
.data
, 0x08,
386 in_file_id_persistent
); /* file id (persistent) */
387 SBVAL(outbody
.data
, 0x10,
388 in_file_id_volatile
); /* file id (volatile) */
389 SIVAL(outbody
.data
, 0x18,
390 out_input_offset
); /* input offset */
391 SIVAL(outbody
.data
, 0x1C, 0); /* input count */
392 SIVAL(outbody
.data
, 0x20,
393 out_output_offset
); /* output offset */
394 SIVAL(outbody
.data
, 0x24,
395 out_output_buffer
.length
); /* output count */
396 SIVAL(outbody
.data
, 0x28, 0); /* flags */
397 SIVAL(outbody
.data
, 0x2C, 0); /* reserved */
398 if (body_padding
!= 0) {
399 memset(outbody
.data
+ 0x30, 0, body_padding
);
403 * Note: Windows Vista and 2008 send back also the
404 * input from the request. But it was fixed in
407 outdyn
= out_output_buffer
;
409 error
= smbd_smb2_request_done_ex(req
, status
, outbody
, &outdyn
,
411 if (!NT_STATUS_IS_OK(error
)) {
412 smbd_server_connection_terminate(req
->xconn
,
418 static struct tevent_req
*smbd_smb2_ioctl_send(TALLOC_CTX
*mem_ctx
,
419 struct tevent_context
*ev
,
420 struct smbd_smb2_request
*smb2req
,
421 struct files_struct
*fsp
,
422 uint32_t in_ctl_code
,
424 uint32_t in_max_output
,
427 struct tevent_req
*req
;
428 struct smbd_smb2_ioctl_state
*state
;
429 struct smb_request
*smbreq
;
431 req
= tevent_req_create(mem_ctx
, &state
,
432 struct smbd_smb2_ioctl_state
);
436 state
->smb2req
= smb2req
;
437 state
->smbreq
= NULL
;
439 state
->in_input
= in_input
;
440 state
->in_max_output
= in_max_output
;
441 state
->out_output
= data_blob_null
;
443 DEBUG(10, ("smbd_smb2_ioctl: ctl_code[0x%08x] %s, %s\n",
444 (unsigned)in_ctl_code
,
445 fsp
? fsp_str_dbg(fsp
) : "<no handle>",
448 smbreq
= smbd_smb2_fake_smb_request(smb2req
, fsp
);
449 if (tevent_req_nomem(smbreq
, req
)) {
450 return tevent_req_post(req
, ev
);
452 state
->smbreq
= smbreq
;
454 switch (in_ctl_code
& IOCTL_DEV_TYPE_MASK
) {
456 return smb2_ioctl_dfs(in_ctl_code
, ev
, req
, state
);
458 case FSCTL_FILESYSTEM
:
459 return smb2_ioctl_filesys(in_ctl_code
, ev
, req
, state
);
461 case FSCTL_NAMED_PIPE
:
462 return smb2_ioctl_named_pipe(in_ctl_code
, ev
, req
, state
);
464 case FSCTL_NETWORK_FILESYSTEM
:
465 return smb2_ioctl_network_fs(in_ctl_code
, ev
, req
, state
);
467 case FSCTL_SMBTORTURE
:
468 return smb2_ioctl_smbtorture(in_ctl_code
, ev
, req
, state
);
471 if (IS_IPC(smbreq
->conn
)) {
472 tevent_req_nterror(req
, NT_STATUS_FS_DRIVER_REQUIRED
);
474 tevent_req_nterror(req
, NT_STATUS_INVALID_DEVICE_REQUEST
);
477 return tevent_req_post(req
, ev
);
481 tevent_req_nterror(req
, NT_STATUS_INTERNAL_ERROR
);
482 return tevent_req_post(req
, ev
);
485 static NTSTATUS
smbd_smb2_ioctl_recv(struct tevent_req
*req
,
487 DATA_BLOB
*out_output
,
488 uint8_t *body_padding
,
491 NTSTATUS status
= NT_STATUS_OK
;
492 struct smbd_smb2_ioctl_state
*state
= tevent_req_data(req
,
493 struct smbd_smb2_ioctl_state
);
494 enum tevent_req_state req_state
;
497 *body_padding
= state
->body_padding
;
498 *disconnect
= state
->disconnect
;
500 if ((tevent_req_is_error(req
, &req_state
, &err
) == false)
501 || (req_state
== TEVENT_REQ_USER_ERROR
)) {
503 * Return output buffer to caller if the ioctl was successfully
504 * processed, even if a user error occurred. Some ioctls return
507 *out_output
= state
->out_output
;
508 talloc_steal(mem_ctx
, out_output
->data
);
511 tevent_req_is_nterror(req
, &status
);
512 tevent_req_received(req
);