s3-smbd: longer explanation of smbd_shim code
[samba/gbeck.git] / source3 / smbd / globals.h
blob97d75fd4137e46bb7de4e92c4ff575890b37019d
1 /*
2 Unix SMB/Netbios implementation.
3 smbd globals
4 Copyright (C) Stefan Metzmacher 2009
5 Copyright (C) Jeremy Allison 2010
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/>.
21 #include "system/select.h"
23 #if defined(WITH_AIO)
24 struct aio_extra;
25 extern struct aio_extra *aio_list_head;
26 extern struct tevent_signal *aio_signal_event;
27 extern int aio_pending_size;
28 extern int outstanding_aio_calls;
29 #endif
31 #ifdef USE_DMAPI
32 struct smbd_dmapi_context;
33 extern struct smbd_dmapi_context *dmapi_ctx;
34 #endif
36 extern bool dfree_broken;
38 /* how many write cache buffers have been allocated */
39 extern unsigned int allocated_write_caches;
41 /* A singleton cache to speed up searching by dev/inode. */
42 struct fsp_singleton_cache {
43 files_struct *fsp;
44 struct file_id id;
47 extern const struct mangle_fns *mangle_fns;
49 extern unsigned char *chartest;
50 struct tdb_context;
51 extern struct tdb_context *tdb_mangled_cache;
54 this determines how many characters are used from the original filename
55 in the 8.3 mangled name. A larger value leads to a weaker hash and more collisions.
56 The largest possible value is 6.
58 extern unsigned mangle_prefix;
60 struct msg_state;
61 extern struct msg_state *smbd_msg_state;
63 extern bool logged_ioctl_message;
65 extern int trans_num;
67 extern time_t last_smb_conf_reload_time;
68 extern time_t last_printer_reload_time;
69 /****************************************************************************
70 structure to hold a linked list of queued messages.
71 for processing.
72 ****************************************************************************/
73 struct pending_message_list;
74 extern struct pending_message_list *deferred_open_queue;
75 extern uint32_t common_flags2;
77 struct smb_srv_trans_enc_ctx;
78 extern struct smb_srv_trans_enc_ctx *partial_srv_trans_enc_ctx;
79 extern struct smb_srv_trans_enc_ctx *srv_trans_enc_ctx;
81 struct sec_ctx {
82 struct security_unix_token ut;
83 struct security_token *token;
85 /* A stack of security contexts. We include the current context as being
86 the first one, so there is room for another MAX_SEC_CTX_DEPTH more. */
87 extern struct sec_ctx sec_ctx_stack[MAX_SEC_CTX_DEPTH + 1];
88 extern int sec_ctx_stack_ndx;
89 extern bool become_uid_done;
90 extern bool become_gid_done;
92 extern connection_struct *last_conn;
93 extern uint16_t last_flags;
95 extern uint32_t global_client_caps;
97 extern uint16_t fnf_handle;
99 struct conn_ctx {
100 connection_struct *conn;
101 uint16 vuid;
103 /* A stack of current_user connection contexts. */
104 extern struct conn_ctx conn_ctx_stack[MAX_SEC_CTX_DEPTH];
105 extern int conn_ctx_stack_ndx;
107 struct vfs_init_function_entry;
108 extern struct vfs_init_function_entry *backends;
109 extern char *sparse_buf;
110 extern char *LastDir;
112 /* Current number of oplocks we have outstanding. */
113 extern int32_t exclusive_oplocks_open;
114 extern int32_t level_II_oplocks_open;
115 extern struct kernel_oplocks *koplocks;
117 extern int am_parent;
118 extern struct event_context *smbd_event_ctx;
119 extern struct messaging_context *smbd_msg_ctx;
120 extern struct memcache *smbd_memcache_ctx;
121 extern bool exit_firsttime;
122 struct child_pid;
123 extern struct child_pid *children;
124 extern int num_children;
126 struct tstream_context;
127 struct smbd_smb2_request;
128 struct smbd_smb2_session;
129 struct smbd_smb2_tcon;
131 DATA_BLOB negprot_spnego(TALLOC_CTX *ctx, struct smbd_server_connection *sconn);
133 void smbd_lock_socket(struct smbd_server_connection *sconn);
134 void smbd_unlock_socket(struct smbd_server_connection *sconn);
136 NTSTATUS smb2_signing_sign_pdu(DATA_BLOB session_key,
137 struct iovec *vector,
138 int count);
139 NTSTATUS smb2_signing_check_pdu(DATA_BLOB session_key,
140 const struct iovec *vector,
141 int count);
143 NTSTATUS smbd_do_locking(struct smb_request *req,
144 files_struct *fsp,
145 uint8_t type,
146 int32_t timeout,
147 uint16_t num_ulocks,
148 struct smbd_lock_element *ulocks,
149 uint16_t num_locks,
150 struct smbd_lock_element *locks,
151 bool *async);
153 NTSTATUS smbd_do_qfilepathinfo(connection_struct *conn,
154 TALLOC_CTX *mem_ctx,
155 uint16_t info_level,
156 files_struct *fsp,
157 struct smb_filename *smb_fname,
158 bool delete_pending,
159 struct timespec write_time_ts,
160 struct ea_list *ea_list,
161 int lock_data_count,
162 char *lock_data,
163 uint16_t flags2,
164 unsigned int max_data_bytes,
165 char **ppdata,
166 unsigned int *pdata_size);
168 NTSTATUS smbd_do_setfilepathinfo(connection_struct *conn,
169 struct smb_request *req,
170 TALLOC_CTX *mem_ctx,
171 uint16_t info_level,
172 files_struct *fsp,
173 struct smb_filename *smb_fname,
174 char **ppdata, int total_data,
175 int *ret_data_size);
177 NTSTATUS smbd_do_qfsinfo(connection_struct *conn,
178 TALLOC_CTX *mem_ctx,
179 uint16_t info_level,
180 uint16_t flags2,
181 unsigned int max_data_bytes,
182 char **ppdata,
183 int *ret_data_len);
185 bool smbd_dirptr_get_entry(TALLOC_CTX *ctx,
186 struct dptr_struct *dirptr,
187 const char *mask,
188 uint32_t dirtype,
189 bool dont_descend,
190 bool ask_sharemode,
191 bool (*match_fn)(TALLOC_CTX *ctx,
192 void *private_data,
193 const char *dname,
194 const char *mask,
195 char **_fname),
196 bool (*mode_fn)(TALLOC_CTX *ctx,
197 void *private_data,
198 struct smb_filename *smb_fname,
199 uint32_t *_mode),
200 void *private_data,
201 char **_fname,
202 struct smb_filename **_smb_fname,
203 uint32_t *_mode,
204 long *_prev_offset);
206 bool smbd_dirptr_lanman2_entry(TALLOC_CTX *ctx,
207 connection_struct *conn,
208 struct dptr_struct *dirptr,
209 uint16 flags2,
210 const char *path_mask,
211 uint32 dirtype,
212 int info_level,
213 int requires_resume_key,
214 bool dont_descend,
215 bool ask_sharemode,
216 uint8_t align,
217 bool do_pad,
218 char **ppdata,
219 char *base_data,
220 char *end_data,
221 int space_remaining,
222 bool *out_of_space,
223 bool *got_exact_match,
224 int *_last_entry_off,
225 struct ea_list *name_list);
227 NTSTATUS smbd_check_open_rights(struct connection_struct *conn,
228 const struct smb_filename *smb_fname,
229 uint32_t access_mask,
230 uint32_t *access_granted);
232 void smbd_notify_cancel_by_smbreq(const struct smb_request *smbreq);
234 void smbd_server_connection_terminate_ex(struct smbd_server_connection *sconn,
235 const char *reason,
236 const char *location);
237 #define smbd_server_connection_terminate(sconn, reason) \
238 smbd_server_connection_terminate_ex(sconn, reason, __location__)
240 struct server_id sconn_server_id(const struct smbd_server_connection *sconn);
242 const char *smb2_opcode_name(uint16_t opcode);
243 bool smbd_is_smb2_header(const uint8_t *inbuf, size_t size);
245 void reply_smb2002(struct smb_request *req, uint16_t choice);
246 void smbd_smb2_first_negprot(struct smbd_server_connection *sconn,
247 const uint8_t *inbuf, size_t size);
249 NTSTATUS smbd_smb2_request_error_ex(struct smbd_smb2_request *req,
250 NTSTATUS status,
251 DATA_BLOB *info,
252 const char *location);
253 #define smbd_smb2_request_error(req, status) \
254 smbd_smb2_request_error_ex(req, status, NULL, __location__)
255 NTSTATUS smbd_smb2_request_done_ex(struct smbd_smb2_request *req,
256 NTSTATUS status,
257 DATA_BLOB body, DATA_BLOB *dyn,
258 const char *location);
259 #define smbd_smb2_request_done(req, body, dyn) \
260 smbd_smb2_request_done_ex(req, NT_STATUS_OK, body, dyn, __location__)
262 NTSTATUS smbd_smb2_send_oplock_break(struct smbd_server_connection *sconn,
263 uint64_t file_id_persistent,
264 uint64_t file_id_volatile,
265 uint8_t oplock_level);
267 NTSTATUS smbd_smb2_request_pending_queue(struct smbd_smb2_request *req,
268 struct tevent_req *subreq);
270 NTSTATUS smbd_smb2_request_check_session(struct smbd_smb2_request *req);
271 NTSTATUS smbd_smb2_request_check_tcon(struct smbd_smb2_request *req);
273 struct smb_request *smbd_smb2_fake_smb_request(struct smbd_smb2_request *req);
274 void remove_smb2_chained_fsp(files_struct *fsp);
276 NTSTATUS smbd_smb2_request_process_negprot(struct smbd_smb2_request *req);
277 NTSTATUS smbd_smb2_request_process_sesssetup(struct smbd_smb2_request *req);
278 NTSTATUS smbd_smb2_request_process_logoff(struct smbd_smb2_request *req);
279 NTSTATUS smbd_smb2_request_process_tcon(struct smbd_smb2_request *req);
280 NTSTATUS smbd_smb2_request_process_tdis(struct smbd_smb2_request *req);
281 NTSTATUS smbd_smb2_request_process_create(struct smbd_smb2_request *req);
282 NTSTATUS smbd_smb2_request_process_close(struct smbd_smb2_request *req);
283 NTSTATUS smbd_smb2_request_process_flush(struct smbd_smb2_request *req);
284 NTSTATUS smbd_smb2_request_process_read(struct smbd_smb2_request *req);
285 NTSTATUS smb2_read_complete(struct tevent_req *req, ssize_t nread, int err);
286 NTSTATUS smbd_smb2_request_process_write(struct smbd_smb2_request *req);
287 NTSTATUS smb2_write_complete(struct tevent_req *req, ssize_t nwritten, int err);
288 NTSTATUS smbd_smb2_request_process_lock(struct smbd_smb2_request *req);
289 NTSTATUS smbd_smb2_request_process_ioctl(struct smbd_smb2_request *req);
290 NTSTATUS smbd_smb2_request_process_keepalive(struct smbd_smb2_request *req);
291 NTSTATUS smbd_smb2_request_process_find(struct smbd_smb2_request *req);
292 NTSTATUS smbd_smb2_request_process_notify(struct smbd_smb2_request *req);
293 NTSTATUS smbd_smb2_request_process_getinfo(struct smbd_smb2_request *req);
294 NTSTATUS smbd_smb2_request_process_setinfo(struct smbd_smb2_request *req);
295 NTSTATUS smbd_smb2_request_process_break(struct smbd_smb2_request *req);
296 NTSTATUS smbd_smb2_request_dispatch(struct smbd_smb2_request *req);
297 void smbd_smb2_request_dispatch_immediate(struct tevent_context *ctx,
298 struct tevent_immediate *im,
299 void *private_data);
301 /* SMB1 -> SMB2 glue. */
302 void send_break_message_smb2(files_struct *fsp, int level);
303 struct blocking_lock_record *get_pending_smb2req_blr(struct smbd_smb2_request *smb2req);
304 bool push_blocking_lock_request_smb2( struct byte_range_lock *br_lck,
305 struct smb_request *req,
306 files_struct *fsp,
307 int lock_timeout,
308 int lock_num,
309 uint64_t smblctx,
310 enum brl_type lock_type,
311 enum brl_flavour lock_flav,
312 uint64_t offset,
313 uint64_t count,
314 uint64_t blocking_smblctx);
315 void process_blocking_lock_queue_smb2(
316 struct smbd_server_connection *sconn, struct timeval tv_curr);
317 void cancel_pending_lock_requests_by_fid_smb2(files_struct *fsp,
318 struct byte_range_lock *br_lck,
319 enum file_close_type close_type);
320 /* From smbd/smb2_create.c */
321 int map_smb2_oplock_levels_to_samba(uint8_t in_oplock_level);
322 bool get_deferred_open_message_state_smb2(struct smbd_smb2_request *smb2req,
323 struct timeval *p_request_time,
324 void **pp_state);
325 bool open_was_deferred_smb2(struct smbd_server_connection *sconn,
326 uint64_t mid);
327 void remove_deferred_open_message_smb2(
328 struct smbd_server_connection *sconn, uint64_t mid);
329 void schedule_deferred_open_message_smb2(
330 struct smbd_server_connection *sconn, uint64_t mid);
331 bool push_deferred_open_message_smb2(struct smbd_smb2_request *smb2req,
332 struct timeval request_time,
333 struct timeval timeout,
334 struct file_id id,
335 char *private_data,
336 size_t priv_len);
338 struct smbd_smb2_request {
339 struct smbd_smb2_request *prev, *next;
341 TALLOC_CTX *mem_pool;
342 struct smbd_smb2_request **parent;
344 struct smbd_server_connection *sconn;
346 /* the session the request operates on, maybe NULL */
347 struct smbd_smb2_session *session;
349 /* the tcon the request operates on, maybe NULL */
350 struct smbd_smb2_tcon *tcon;
352 int current_idx;
353 bool do_signing;
354 bool async;
355 bool cancelled;
357 /* fake smb1 request. */
358 struct smb_request *smb1req;
359 struct files_struct *compat_chain_fsp;
361 NTSTATUS next_status;
364 * The sub request for async backend calls.
365 * This is used for SMB2 Cancel.
367 struct tevent_req *subreq;
369 struct {
370 /* the NBT header is not allocated */
371 uint8_t nbt_hdr[4];
373 * vector[0] NBT
375 * vector[1] SMB2
376 * vector[2] fixed body
377 * vector[3] dynamic body
381 * vector[4] SMB2
382 * vector[5] fixed body
383 * vector[6] dynamic body
388 struct iovec *vector;
389 int vector_count;
390 } in;
391 struct {
392 /* the NBT header is not allocated */
393 uint8_t nbt_hdr[4];
395 * vector[0] NBT
397 * vector[1] SMB2
398 * vector[2] fixed body
399 * vector[3] dynamic body
403 * vector[4] SMB2
404 * vector[5] fixed body
405 * vector[6] dynamic body
410 struct iovec *vector;
411 int vector_count;
412 } out;
415 struct smbd_server_connection;
417 struct smbd_smb2_session {
418 struct smbd_smb2_session *prev, *next;
419 struct smbd_server_connection *sconn;
420 NTSTATUS status;
421 uint64_t vuid;
422 struct auth_ntlmssp_state *auth_ntlmssp_state;
423 struct auth_serversupplied_info *session_info;
424 DATA_BLOB session_key;
425 bool do_signing;
427 user_struct *compat_vuser;
429 struct {
430 /* an id tree used to allocate tids */
431 struct idr_context *idtree;
433 /* this is the limit of tid values for this connection */
434 uint32_t limit;
436 struct smbd_smb2_tcon *list;
437 } tcons;
440 struct smbd_smb2_tcon {
441 struct smbd_smb2_tcon *prev, *next;
442 struct smbd_smb2_session *session;
443 uint32_t tid;
444 int snum;
445 connection_struct *compat_conn;
448 struct pending_auth_data;
450 struct smbd_server_connection {
451 int sock;
452 struct client_address client_id;
453 const struct tsocket_address *local_address;
454 const struct tsocket_address *remote_address;
455 struct messaging_context *msg_ctx;
456 struct {
457 bool got_session;
458 } nbt;
459 bool using_smb2;
460 int trans_num;
463 * Cache for calling poll(2) to avoid allocations in our
464 * central event loop
466 struct pollfd *pfds;
468 struct files_struct *files;
469 struct bitmap *file_bmap;
470 int real_max_open_files;
471 int files_used;
472 struct fsp_singleton_cache fsp_fi_cache;
473 unsigned long file_gen_counter;
474 int first_file;
476 /* number of open connections (tcons) */
477 int num_tcons_open;
479 /* open directory handles. */
480 struct {
481 struct bitmap *dptr_bmap;
482 struct dptr_struct *dirptrs;
483 int dirhandles_open;
484 } searches;
486 struct {
487 struct fd_event *fde;
489 struct {
491 * fd for the fcntl lock mutexing access to our sock
493 int socket_lock_fd;
496 * fd for the trusted pipe from
497 * echo handler child
499 int trusted_fd;
502 * fde for the trusted_fd
504 struct fd_event *trusted_fde;
507 * Reference count for the fcntl lock to
508 * allow recursive locks.
510 int ref_count;
511 } echo_handler;
513 uint64_t num_requests;
514 struct {
515 bool encrypted_passwords;
516 bool spnego;
517 struct auth_context *auth_context;
518 bool done;
520 * Size of the data we can receive. Set by us.
521 * Can be modified by the max xmit parameter.
523 int max_recv;
524 } negprot;
526 struct {
527 bool done_sesssetup;
529 * Size of data we can send to client. Set
530 * by the client for all protocols above CORE.
531 * Set by us for CORE protocol.
533 int max_send;
534 uint16_t last_session_tag;
536 /* users from session setup */
537 char *session_userlist;
538 /* workgroup from session setup. */
539 char *session_workgroup;
541 * this holds info on user ids that are already
542 * validated for this VC
544 user_struct *validated_users;
545 uint16_t next_vuid;
546 int num_validated_vuids;
547 } sessions;
548 struct {
549 connection_struct *Connections;
550 /* number of open connections */
551 struct bitmap *bmap;
552 } tcons;
553 struct smb_signing_state *signing_state;
554 /* List to store partial SPNEGO auth fragments. */
555 struct pending_auth_data *pd_list;
557 struct notify_mid_map *notify_mid_maps;
559 struct {
560 /* dlink list we store pending lock records on. */
561 struct blocking_lock_record *blocking_lock_queue;
562 /* dlink list we move cancelled lock records onto. */
563 struct blocking_lock_record *blocking_lock_cancelled_queue;
565 /* The event that makes us process our blocking lock queue */
566 struct timed_event *brl_timeout;
568 bool blocking_lock_unlock_state;
569 bool blocking_lock_cancel_state;
570 } locks;
571 } smb1;
572 struct {
573 struct tevent_context *event_ctx;
574 struct tevent_queue *recv_queue;
575 struct tevent_queue *send_queue;
576 struct tstream_context *stream;
577 struct {
578 /* an id tree used to allocate vuids */
579 /* this holds info on session vuids that are already
580 * validated for this VC */
581 struct idr_context *idtree;
583 /* this is the limit of vuid values for this connection */
584 uint64_t limit;
586 struct smbd_smb2_session *list;
587 } sessions;
588 struct {
589 /* The event that makes us process our blocking lock queue */
590 struct timed_event *brl_timeout;
591 bool blocking_lock_unlock_state;
592 } locks;
593 struct smbd_smb2_request *requests;
594 uint64_t seqnum_low;
595 uint32_t credits_granted;
596 uint32_t max_credits;
597 struct bitmap *credits_bitmap;
598 } smb2;
601 extern struct smbd_server_connection *smbd_server_conn;
603 struct smbd_server_connection *msg_ctx_to_sconn(struct messaging_context *msg_ctx);
605 void smbd_init_globals(void);