s3-docs: Fix typo.
[Samba/gebeck_regimport.git] / source3 / smbd / globals.h
blob4d954534dc393d254a49b915fcc79615c87c49b5
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 extern pid_t background_lpq_updater_pid;
71 /****************************************************************************
72 structure to hold a linked list of queued messages.
73 for processing.
74 ****************************************************************************/
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 smbd_do_locking(struct smb_request *req,
137 files_struct *fsp,
138 uint8_t type,
139 int32_t timeout,
140 uint16_t num_ulocks,
141 struct smbd_lock_element *ulocks,
142 uint16_t num_locks,
143 struct smbd_lock_element *locks,
144 bool *async);
146 NTSTATUS smbd_do_qfilepathinfo(connection_struct *conn,
147 TALLOC_CTX *mem_ctx,
148 uint16_t info_level,
149 files_struct *fsp,
150 struct smb_filename *smb_fname,
151 bool delete_pending,
152 struct timespec write_time_ts,
153 struct ea_list *ea_list,
154 int lock_data_count,
155 char *lock_data,
156 uint16_t flags2,
157 unsigned int max_data_bytes,
158 char **ppdata,
159 unsigned int *pdata_size);
161 NTSTATUS smbd_do_setfilepathinfo(connection_struct *conn,
162 struct smb_request *req,
163 TALLOC_CTX *mem_ctx,
164 uint16_t info_level,
165 files_struct *fsp,
166 struct smb_filename *smb_fname,
167 char **ppdata, int total_data,
168 int *ret_data_size);
170 NTSTATUS smbd_do_qfsinfo(connection_struct *conn,
171 TALLOC_CTX *mem_ctx,
172 uint16_t info_level,
173 uint16_t flags2,
174 unsigned int max_data_bytes,
175 char **ppdata,
176 int *ret_data_len);
178 bool smbd_dirptr_get_entry(TALLOC_CTX *ctx,
179 struct dptr_struct *dirptr,
180 const char *mask,
181 uint32_t dirtype,
182 bool dont_descend,
183 bool ask_sharemode,
184 bool (*match_fn)(TALLOC_CTX *ctx,
185 void *private_data,
186 const char *dname,
187 const char *mask,
188 char **_fname),
189 bool (*mode_fn)(TALLOC_CTX *ctx,
190 void *private_data,
191 struct smb_filename *smb_fname,
192 uint32_t *_mode),
193 void *private_data,
194 char **_fname,
195 struct smb_filename **_smb_fname,
196 uint32_t *_mode,
197 long *_prev_offset);
199 bool smbd_dirptr_lanman2_entry(TALLOC_CTX *ctx,
200 connection_struct *conn,
201 struct dptr_struct *dirptr,
202 uint16 flags2,
203 const char *path_mask,
204 uint32 dirtype,
205 int info_level,
206 int requires_resume_key,
207 bool dont_descend,
208 bool ask_sharemode,
209 uint8_t align,
210 bool do_pad,
211 char **ppdata,
212 char *base_data,
213 char *end_data,
214 int space_remaining,
215 bool *out_of_space,
216 bool *got_exact_match,
217 int *_last_entry_off,
218 struct ea_list *name_list);
220 NTSTATUS smbd_calculate_access_mask(connection_struct *conn,
221 const struct smb_filename *smb_fname,
222 bool file_existed,
223 uint32_t access_mask,
224 uint32_t *access_mask_out);
225 NTSTATUS smbd_check_open_rights(struct connection_struct *conn,
226 const struct smb_filename *smb_fname,
227 uint32_t access_mask,
228 uint32_t *access_granted);
230 void smbd_notify_cancel_by_smbreq(const struct smb_request *smbreq);
232 void smbd_server_connection_terminate_ex(struct smbd_server_connection *sconn,
233 const char *reason,
234 const char *location);
235 #define smbd_server_connection_terminate(sconn, reason) \
236 smbd_server_connection_terminate_ex(sconn, reason, __location__)
238 struct server_id sconn_server_id(const struct smbd_server_connection *sconn);
240 const char *smb2_opcode_name(uint16_t opcode);
241 bool smbd_is_smb2_header(const uint8_t *inbuf, size_t size);
243 void reply_smb2002(struct smb_request *req, uint16_t choice);
244 void reply_smb20ff(struct smb_request *req, uint16_t choice);
245 void smbd_smb2_first_negprot(struct smbd_server_connection *sconn,
246 const uint8_t *inbuf, size_t size);
248 NTSTATUS smbd_smb2_request_error_ex(struct smbd_smb2_request *req,
249 NTSTATUS status,
250 DATA_BLOB *info,
251 const char *location);
252 #define smbd_smb2_request_error(req, status) \
253 smbd_smb2_request_error_ex(req, status, NULL, __location__)
254 NTSTATUS smbd_smb2_request_done_ex(struct smbd_smb2_request *req,
255 NTSTATUS status,
256 DATA_BLOB body, DATA_BLOB *dyn,
257 const char *location);
258 #define smbd_smb2_request_done(req, body, dyn) \
259 smbd_smb2_request_done_ex(req, NT_STATUS_OK, body, dyn, __location__)
261 NTSTATUS smbd_smb2_send_oplock_break(struct smbd_server_connection *sconn,
262 uint64_t file_id_persistent,
263 uint64_t file_id_volatile,
264 uint8_t oplock_level);
266 NTSTATUS smbd_smb2_request_pending_queue(struct smbd_smb2_request *req,
267 struct tevent_req *subreq);
269 struct smb_request *smbd_smb2_fake_smb_request(struct smbd_smb2_request *req);
270 void remove_smb2_chained_fsp(files_struct *fsp);
272 NTSTATUS smbd_smb2_request_verify_sizes(struct smbd_smb2_request *req,
273 size_t expected_body_size);
275 NTSTATUS smbd_smb2_request_process_negprot(struct smbd_smb2_request *req);
276 NTSTATUS smbd_smb2_request_process_sesssetup(struct smbd_smb2_request *req);
277 NTSTATUS smbd_smb2_request_process_logoff(struct smbd_smb2_request *req);
278 NTSTATUS smbd_smb2_request_process_tcon(struct smbd_smb2_request *req);
279 NTSTATUS smbd_smb2_request_process_tdis(struct smbd_smb2_request *req);
280 NTSTATUS smbd_smb2_request_process_create(struct smbd_smb2_request *req);
281 NTSTATUS smbd_smb2_request_process_close(struct smbd_smb2_request *req);
282 NTSTATUS smbd_smb2_request_process_flush(struct smbd_smb2_request *req);
283 NTSTATUS smbd_smb2_request_process_read(struct smbd_smb2_request *req);
284 NTSTATUS smb2_read_complete(struct tevent_req *req, ssize_t nread, int err);
285 NTSTATUS smbd_smb2_request_process_write(struct smbd_smb2_request *req);
286 NTSTATUS smb2_write_complete(struct tevent_req *req, ssize_t nwritten, int err);
287 NTSTATUS smbd_smb2_request_process_lock(struct smbd_smb2_request *req);
288 NTSTATUS smbd_smb2_request_process_ioctl(struct smbd_smb2_request *req);
289 NTSTATUS smbd_smb2_request_process_keepalive(struct smbd_smb2_request *req);
290 NTSTATUS smbd_smb2_request_process_find(struct smbd_smb2_request *req);
291 NTSTATUS smbd_smb2_request_process_notify(struct smbd_smb2_request *req);
292 NTSTATUS smbd_smb2_request_process_getinfo(struct smbd_smb2_request *req);
293 NTSTATUS smbd_smb2_request_process_setinfo(struct smbd_smb2_request *req);
294 NTSTATUS smbd_smb2_request_process_break(struct smbd_smb2_request *req);
295 NTSTATUS smbd_smb2_request_dispatch(struct smbd_smb2_request *req);
296 void smbd_smb2_request_dispatch_immediate(struct tevent_context *ctx,
297 struct tevent_immediate *im,
298 void *private_data);
300 /* SMB1 -> SMB2 glue. */
301 void send_break_message_smb2(files_struct *fsp, int level);
302 struct blocking_lock_record *get_pending_smb2req_blr(struct smbd_smb2_request *smb2req);
303 bool push_blocking_lock_request_smb2( struct byte_range_lock *br_lck,
304 struct smb_request *req,
305 files_struct *fsp,
306 int lock_timeout,
307 int lock_num,
308 uint64_t smblctx,
309 enum brl_type lock_type,
310 enum brl_flavour lock_flav,
311 uint64_t offset,
312 uint64_t count,
313 uint64_t blocking_smblctx);
314 void process_blocking_lock_queue_smb2(
315 struct smbd_server_connection *sconn, struct timeval tv_curr);
316 void cancel_pending_lock_requests_by_fid_smb2(files_struct *fsp,
317 struct byte_range_lock *br_lck,
318 enum file_close_type close_type);
319 /* From smbd/smb2_create.c */
320 int map_smb2_oplock_levels_to_samba(uint8_t in_oplock_level);
321 bool get_deferred_open_message_state_smb2(struct smbd_smb2_request *smb2req,
322 struct timeval *p_request_time,
323 void **pp_state);
324 bool open_was_deferred_smb2(struct smbd_server_connection *sconn,
325 uint64_t mid);
326 void remove_deferred_open_message_smb2(
327 struct smbd_server_connection *sconn, uint64_t mid);
328 void schedule_deferred_open_message_smb2(
329 struct smbd_server_connection *sconn, uint64_t mid);
330 bool push_deferred_open_message_smb2(struct smbd_smb2_request *smb2req,
331 struct timeval request_time,
332 struct timeval timeout,
333 struct file_id id,
334 char *private_data,
335 size_t priv_len);
337 struct smbd_smb2_request {
338 struct smbd_smb2_request *prev, *next;
340 TALLOC_CTX *mem_pool;
341 struct smbd_smb2_request **parent;
343 struct smbd_server_connection *sconn;
345 /* the session the request operates on, maybe NULL */
346 struct smbd_smb2_session *session;
348 /* the tcon the request operates on, maybe NULL */
349 struct smbd_smb2_tcon *tcon;
351 int current_idx;
352 bool do_signing;
353 bool async;
354 bool cancelled;
355 bool compound_related;
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_session_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_message_list;
449 struct pending_auth_data;
451 struct smbd_server_connection {
452 int sock;
453 const struct tsocket_address *local_address;
454 const struct tsocket_address *remote_address;
455 const char *remote_hostname;
456 struct messaging_context *msg_ctx;
457 struct {
458 bool got_session;
459 } nbt;
460 bool using_smb2;
461 int trans_num;
464 * Cache for calling poll(2) to avoid allocations in our
465 * central event loop
467 struct pollfd *pfds;
469 struct files_struct *files;
470 struct bitmap *file_bmap;
471 int real_max_open_files;
472 int files_used;
473 struct fsp_singleton_cache fsp_fi_cache;
474 unsigned long file_gen_counter;
475 int first_file;
477 /* Try GENSEC hook */
478 bool use_gensec_hook;
480 /* number of open connections (tcons) */
481 int num_tcons_open;
483 struct pending_message_list *deferred_open_queue;
486 /* open directory handles. */
487 struct {
488 struct bitmap *dptr_bmap;
489 struct dptr_struct *dirptrs;
490 int dirhandles_open;
491 } searches;
493 uint64_t num_requests;
495 struct {
496 struct fd_event *fde;
498 struct {
500 * fd for the fcntl lock mutexing access to our sock
502 int socket_lock_fd;
505 * fd for the trusted pipe from
506 * echo handler child
508 int trusted_fd;
511 * fde for the trusted_fd
513 struct fd_event *trusted_fde;
516 * Reference count for the fcntl lock to
517 * allow recursive locks.
519 int ref_count;
520 } echo_handler;
522 struct {
523 bool encrypted_passwords;
524 bool spnego;
525 struct auth_context *auth_context;
526 bool done;
528 * Size of the data we can receive. Set by us.
529 * Can be modified by the max xmit parameter.
531 int max_recv;
532 } negprot;
534 struct {
535 uint16_t client_major;
536 uint16_t client_minor;
537 uint32_t client_cap_low;
538 uint32_t client_cap_high;
539 } unix_info;
541 struct {
542 bool done_sesssetup;
544 * Size of data we can send to client. Set
545 * by the client for all protocols above CORE.
546 * Set by us for CORE protocol.
548 int max_send;
549 uint16_t last_session_tag;
551 /* users from session setup */
552 char *session_userlist;
553 /* workgroup from session setup. */
554 char *session_workgroup;
556 * this holds info on user ids that are already
557 * validated for this VC
559 user_struct *validated_users;
560 uint16_t next_vuid;
561 int num_validated_vuids;
562 } sessions;
563 struct {
564 connection_struct *Connections;
565 /* number of open connections */
566 struct bitmap *bmap;
567 } tcons;
568 struct smb_signing_state *signing_state;
569 /* List to store partial SPNEGO auth fragments. */
570 struct pending_auth_data *pd_list;
572 struct notify_mid_map *notify_mid_maps;
574 struct {
575 /* dlink list we store pending lock records on. */
576 struct blocking_lock_record *blocking_lock_queue;
577 /* dlink list we move cancelled lock records onto. */
578 struct blocking_lock_record *blocking_lock_cancelled_queue;
580 /* The event that makes us process our blocking lock queue */
581 struct timed_event *brl_timeout;
583 bool blocking_lock_unlock_state;
584 bool blocking_lock_cancel_state;
585 } locks;
586 } smb1;
587 struct {
588 struct tevent_context *event_ctx;
589 struct tevent_queue *recv_queue;
590 struct tevent_queue *send_queue;
591 struct tstream_context *stream;
592 bool negprot_2ff;
593 struct {
594 /* an id tree used to allocate vuids */
595 /* this holds info on session vuids that are already
596 * validated for this VC */
597 struct idr_context *idtree;
599 /* this is the limit of vuid values for this connection */
600 uint64_t limit;
602 struct smbd_smb2_session *list;
603 } sessions;
604 struct {
605 /* The event that makes us process our blocking lock queue */
606 struct timed_event *brl_timeout;
607 bool blocking_lock_unlock_state;
608 } locks;
609 struct smbd_smb2_request *requests;
610 uint64_t seqnum_low;
611 uint32_t credits_granted;
612 uint32_t max_credits;
613 struct bitmap *credits_bitmap;
614 bool compound_related_in_progress;
615 } smb2;
618 extern struct smbd_server_connection *smbd_server_conn;
620 struct smbd_server_connection *msg_ctx_to_sconn(struct messaging_context *msg_ctx);
622 void smbd_init_globals(void);