2 * Unix SMB/CIFS implementation.
3 * Main SMB server routines
5 * Copyright (C) Andrew Tridgell 1992-2002,2006
6 * Copyright (C) Jeremy Allison 1992-2010
7 * Copyright (C) Volker Lendecke 1993-2009
8 * Copyright (C) John H Terpstra 1995-1998
9 * Copyright (C) Luke Kenneth Casson Leighton 1996-1998
10 * Copyright (C) Paul Ashton 1997-1998
11 * Copyright (C) Tim Potter 1999-2000
12 * Copyright (C) T.D.Lee@durham.ac.uk 1999
13 * Copyright (C) Ying Chen 2000
14 * Copyright (C) Shirish Kalele 2000
15 * Copyright (C) Andrew Bartlett 2001-2003
16 * Copyright (C) Alexander Bokovoy 2002,2005
17 * Copyright (C) Simo Sorce 2001-2002,2009
18 * Copyright (C) Andreas Gruenbacher 2002
19 * Copyright (C) Jim McDonough <jmcd@us.ibm.com> 2002
20 * Copyright (C) Martin Pool 2002
21 * Copyright (C) Luke Howard 2003
22 * Copyright (C) Stefan (metze) Metzmacher 2003,2009
23 * Copyright (C) Steve French 2005
24 * Copyright (C) Gerald (Jerry) Carter 2006
25 * Copyright (C) James Peach 2006-2007
26 * Copyright (C) Jelmer Vernooij 2002-2003
27 * Copyright (C) Michael Adam 2007
28 * Copyright (C) Rishi Srivatsavai 2007
29 * Copyright (C) Tim Prouty 2009
30 * Copyright (C) Gregor Beck 2011
32 * This program is free software; you can redistribute it and/or modify
33 * it under the terms of the GNU General Public License as published by
34 * the Free Software Foundation; either version 3 of the License, or
35 * (at your option) any later version.
37 * This program is distributed in the hope that it will be useful,
38 * but WITHOUT ANY WARRANTY; without even the implied warranty of
39 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
40 * GNU General Public License for more details.
42 * You should have received a copy of the GNU General Public License
43 * along with this program. If not, see <http://www.gnu.org/licenses/>.
46 #ifndef _SMBD_PROTO_H_
47 #define _SMBD_PROTO_H_
49 struct smbXsrv_client;
50 struct smbXsrv_connection;
51 struct dcesrv_context;
53 /* The following definitions come from smbd/smb2_signing.c */
55 bool smb2_srv_init_signing(struct smbXsrv_connection *conn);
56 bool srv_init_signing(struct smbXsrv_connection *conn);
58 /* The following definitions come from smbd/aio.c */
61 bool aio_write_through_requested(struct aio_extra *aio_ex);
62 NTSTATUS schedule_smb2_aio_read(connection_struct *conn,
63 struct smb_request *smbreq,
69 NTSTATUS schedule_aio_smb2_write(connection_struct *conn,
70 struct smb_request *smbreq,
75 bool cancel_smb2_aio(struct smb_request *smbreq);
76 bool aio_add_req_to_fsp(files_struct *fsp, struct tevent_req *req);
77 struct aio_extra *create_aio_extra(TALLOC_CTX *mem_ctx,
80 struct tevent_req *pwrite_fsync_send(TALLOC_CTX *mem_ctx,
81 struct tevent_context *ev,
82 struct files_struct *fsp,
84 size_t n, off_t offset,
86 ssize_t pwrite_fsync_recv(struct tevent_req *req, int *perr);
88 /* The following definitions come from smbd/blocking.c */
90 NTSTATUS smbd_do_locks_try(
91 struct files_struct *fsp,
93 struct smbd_lock_element *locks,
94 uint16_t *blocker_idx,
95 struct server_id *blocking_pid,
96 uint64_t *blocking_smblctx);
97 struct tevent_req *smbd_smb1_do_locks_send(
99 struct tevent_context *ev,
100 struct smb_request **smbreq, /* talloc_move()d into our state */
101 struct files_struct *fsp,
102 uint32_t lock_timeout,
105 struct smbd_lock_element *locks);
106 NTSTATUS smbd_smb1_do_locks_recv(struct tevent_req *req);
107 bool smbd_smb1_do_locks_extract_smbreq(
108 struct tevent_req *req,
110 struct smb_request **psmbreq);
111 void smbd_smb1_brl_finish_by_req(struct tevent_req *req, NTSTATUS status);
112 bool smbd_smb1_brl_finish_by_lock(
113 struct files_struct *fsp,
115 struct smbd_lock_element lock,
116 NTSTATUS finish_status);
117 bool smbd_smb1_brl_finish_by_mid(
118 struct smbd_server_connection *sconn, uint64_t mid);
120 /* The following definitions come from smbd/close.c */
122 void set_close_write_time(struct files_struct *fsp, struct timespec ts);
123 NTSTATUS close_file_smb(struct smb_request *req,
124 struct files_struct *fsp,
125 enum file_close_type close_type);
126 NTSTATUS close_file_free(struct smb_request *req,
127 struct files_struct **_fsp,
128 enum file_close_type close_type);
129 void msg_close_file(struct messaging_context *msg_ctx,
132 struct server_id server_id,
134 NTSTATUS delete_all_streams(connection_struct *conn,
135 const struct smb_filename *smb_fname);
136 NTSTATUS recursive_rmdir(TALLOC_CTX *ctx,
137 connection_struct *conn,
138 struct smb_filename *smb_dname);
139 bool has_other_nonposix_opens(struct share_mode_lock *lck,
140 struct files_struct *fsp);
142 /* The following definitions come from smbd/conn.c */
144 int conn_num_open(struct smbd_server_connection *sconn);
145 bool conn_snum_used(struct smbd_server_connection *sconn, int snum);
146 connection_struct *conn_new(struct smbd_server_connection *sconn);
147 bool conn_idle_all(struct smbd_server_connection *sconn, time_t t);
148 void conn_clear_vuid_caches(struct smbd_server_connection *sconn, uint64_t vuid);
149 void conn_free(connection_struct *conn);
150 void conn_setup_case_options(connection_struct *conn);
151 void conn_force_tdis(
152 struct smbd_server_connection *sconn,
153 bool (*check_fn)(struct connection_struct *conn,
156 void msg_force_tdis(struct messaging_context *msg,
159 struct server_id server_id,
161 void msg_force_tdis_denied(
162 struct messaging_context *msg,
165 struct server_id server_id,
168 /* The following definitions come from smbd/connection.c */
170 int count_current_connections(const char *sharename, bool verify);
171 bool connections_snum_used(struct smbd_server_connection *unused, int snum);
173 /* The following definitions come from smbd/dfree.c */
175 uint64_t get_dfree_info(connection_struct *conn, struct smb_filename *fname,
176 uint64_t *bsize, uint64_t *dfree, uint64_t *dsize);
177 void flush_dfree_cache(void);
179 /* The following definitions come from smbd/dir.c */
181 bool init_dptrs(struct smbd_server_connection *sconn);
182 const char *dptr_path(struct smbd_server_connection *sconn, int key);
183 const char *dptr_wcard(struct smbd_server_connection *sconn, int key);
184 uint16_t dptr_attr(struct smbd_server_connection *sconn, int key);
185 void dptr_closecnum(connection_struct *conn);
186 NTSTATUS dptr_create(connection_struct *conn,
187 struct smb_request *req,
192 struct dptr_struct **dptr_ret);
193 void dptr_CloseDir(files_struct *fsp);
194 void dptr_SeekDir(struct dptr_struct *dptr, long offset);
195 void dptr_RewindDir(struct dptr_struct *dptr);
196 long dptr_TellDir(struct dptr_struct *dptr);
197 unsigned int dptr_FileNumber(struct dptr_struct *dptr);
198 bool dptr_has_wild(struct dptr_struct *dptr);
199 int dptr_dnum(struct dptr_struct *dptr);
200 bool dptr_get_priv(struct dptr_struct *dptr);
201 void dptr_set_priv(struct dptr_struct *dptr);
202 bool dptr_case_sensitive(struct dptr_struct *dptr);
203 bool dptr_SearchDir(struct dptr_struct *dptr, const char *name);
205 struct files_struct *dir_hnd_fetch_fsp(struct smb_Dir *dir_hnd);
206 files_struct *dptr_fetch_lanman2_fsp(struct smbd_server_connection *sconn,
208 bool get_dir_entry(TALLOC_CTX *ctx,
209 struct dptr_struct *dirptr,
215 struct timespec *date,
219 bool is_visible_fsp(files_struct *fsp);
220 NTSTATUS OpenDir(TALLOC_CTX *mem_ctx,
221 connection_struct *conn,
222 const struct smb_filename *smb_dname,
225 struct smb_Dir **_dir_hnd);
226 NTSTATUS OpenDir_from_pathref(TALLOC_CTX *mem_ctx,
227 struct files_struct *dirfsp,
230 struct smb_Dir **_dir_hnd);
231 const char *ReadDirName(struct smb_Dir *dir_hnd, long *poffset,
232 SMB_STRUCT_STAT *sbuf, char **talloced);
233 void RewindDir(struct smb_Dir *dir_hnd, long *poffset);
234 NTSTATUS can_delete_directory(struct connection_struct *conn,
235 const char *dirname);
236 bool have_file_open_below(connection_struct *conn,
237 const struct smb_filename *name);
239 /* The following definitions come from smbd/dmapi.c */
241 const void *dmapi_get_current_session(void);
242 bool dmapi_have_session(void);
243 bool dmapi_new_session(void);
244 bool dmapi_destroy_session(void);
245 uint32_t dmapi_file_flags(const char * const path);
247 /* The following definitions come from smbd/dnsregister.c */
249 bool smbd_setup_mdns_registration(struct tevent_context *ev,
253 /* The following definitions come from smbd/dosmode.c */
255 mode_t unix_mode(connection_struct *conn, int dosmode,
256 const struct smb_filename *smb_fname,
257 struct files_struct *parent_dirfsp);
258 uint32_t dos_mode_msdfs(connection_struct *conn,
259 const struct smb_filename *smb_fname);
260 uint32_t fdos_mode(struct files_struct *fsp);
261 struct tevent_req *dos_mode_at_send(TALLOC_CTX *mem_ctx,
262 struct tevent_context *ev,
263 files_struct *dir_fsp,
264 struct smb_filename *smb_fname);
265 NTSTATUS dos_mode_at_recv(struct tevent_req *req, uint32_t *dosmode);
266 int file_set_dosmode(connection_struct *conn,
267 struct smb_filename *smb_fname,
269 struct smb_filename *parent_dir,
271 NTSTATUS file_set_sparse(connection_struct *conn,
272 struct files_struct *fsp,
274 int file_ntimes(connection_struct *conn,
276 struct smb_file_time *ft);
277 bool set_sticky_write_time_path(struct file_id fileid, struct timespec mtime);
278 bool set_sticky_write_time_fsp(struct files_struct *fsp,
279 struct timespec mtime);
281 NTSTATUS fget_ea_dos_attribute(struct files_struct *fsp,
283 NTSTATUS set_ea_dos_attribute(connection_struct *conn,
284 struct smb_filename *smb_fname,
287 NTSTATUS set_create_timespec_ea(struct files_struct *fsp,
288 struct timespec create_time);
290 struct timespec get_create_timespec(connection_struct *conn,
291 struct files_struct *fsp,
292 const struct smb_filename *smb_fname);
294 struct timespec get_change_timespec(connection_struct *conn,
295 struct files_struct *fsp,
296 const struct smb_filename *smb_fname);
298 NTSTATUS parse_dos_attribute_blob(struct smb_filename *smb_fname,
302 /* The following definitions come from smbd/error.c */
304 bool use_nt_status(void);
305 void error_packet_set(char *outbuf, uint8_t eclass, uint32_t ecode, NTSTATUS ntstatus, int line, const char *file);
306 size_t error_packet(char *outbuf,
312 void reply_nt_error(struct smb_request *req, NTSTATUS ntstatus,
313 int line, const char *file);
314 void reply_force_dos_error(struct smb_request *req, uint8_t eclass, uint32_t ecode,
315 int line, const char *file);
316 void reply_both_error(struct smb_request *req, uint8_t eclass, uint32_t ecode,
317 NTSTATUS status, int line, const char *file);
318 void reply_openerror(struct smb_request *req, NTSTATUS status);
320 /* The following definitions come from smbd/file_access.c */
322 bool can_delete_file_in_directory(connection_struct *conn,
323 struct files_struct *dirfsp,
324 const struct smb_filename *smb_fname);
325 bool can_write_to_fsp(struct files_struct *fsp);
326 bool directory_has_default_acl_fsp(struct files_struct *fsp);
327 NTSTATUS can_set_delete_on_close(files_struct *fsp, uint32_t dosmode);
329 /* The following definitions come from smbd/fileio.c */
331 ssize_t read_file(files_struct *fsp,char *data,off_t pos,size_t n);
332 void fsp_flush_write_time_update(struct files_struct *fsp);
333 void trigger_write_time_update(struct files_struct *fsp);
334 void trigger_write_time_update_immediate(struct files_struct *fsp);
335 void mark_file_modified(files_struct *fsp);
336 ssize_t write_file(struct smb_request *req,
341 NTSTATUS sync_file(connection_struct *conn, files_struct *fsp, bool write_through);
343 /* The following definitions come from smbd/filename.c */
345 uint32_t ucf_flags_from_smb_request(struct smb_request *req);
346 uint32_t filename_create_ucf_flags(struct smb_request *req, uint32_t create_disposition);
347 NTSTATUS canonicalize_snapshot_path(struct smb_filename *smb_fname,
350 NTSTATUS get_real_filename_full_scan_at(struct files_struct *dirfsp,
355 char *get_original_lcomp(TALLOC_CTX *ctx,
356 connection_struct *conn,
357 const char *filename_in,
359 NTSTATUS filename_convert_smb1_search_path(TALLOC_CTX *ctx,
360 connection_struct *conn,
363 struct files_struct **_dirfsp,
364 struct smb_filename **_smb_fname_out,
366 NTSTATUS get_real_filename_at(struct files_struct *dirfsp,
371 /* The following definitions come from smbd/files.c */
373 NTSTATUS fsp_new(struct connection_struct *conn, TALLOC_CTX *mem_ctx,
374 files_struct **result);
375 void fsp_set_gen_id(files_struct *fsp);
376 NTSTATUS file_new(struct smb_request *req, connection_struct *conn,
377 files_struct **result);
378 NTSTATUS fsp_bind_smb(struct files_struct *fsp, struct smb_request *req);
379 void file_close_conn(connection_struct *conn, enum file_close_type close_type);
380 bool file_init_global(void);
381 bool file_init(struct smbd_server_connection *sconn);
382 void file_close_user(struct smbd_server_connection *sconn, uint64_t vuid);
383 struct files_struct *files_forall(
384 struct smbd_server_connection *sconn,
385 struct files_struct *(*fn)(struct files_struct *fsp,
388 files_struct *file_find_fd(struct smbd_server_connection *sconn, int fd);
389 files_struct *file_find_dif(struct smbd_server_connection *sconn,
390 struct file_id id, unsigned long gen_id);
391 files_struct *file_find_di_first(struct smbd_server_connection *sconn,
394 files_struct *file_find_di_next(files_struct *start_fsp,
396 struct files_struct *file_find_one_fsp_from_lease_key(
397 struct smbd_server_connection *sconn,
398 const struct smb2_lease_key *lease_key);
399 bool file_find_subpath(files_struct *dir_fsp);
400 void fsp_unbind_smb(struct smb_request *req, files_struct *fsp);
401 void file_free(struct smb_request *req, files_struct *fsp);
402 files_struct *file_fsp(struct smb_request *req, uint16_t fid);
403 struct files_struct *file_fsp_get(struct smbd_smb2_request *smb2req,
404 uint64_t persistent_id,
405 uint64_t volatile_id);
406 struct files_struct *file_fsp_smb2(struct smbd_smb2_request *smb2req,
407 uint64_t persistent_id,
408 uint64_t volatile_id);
409 NTSTATUS dup_file_fsp(
411 uint32_t access_mask,
413 NTSTATUS file_name_hash(connection_struct *conn,
414 const char *name, uint32_t *p_name_hash);
415 NTSTATUS fsp_set_smb_fname(struct files_struct *fsp,
416 const struct smb_filename *smb_fname_in);
417 size_t fsp_fullbasepath(struct files_struct *fsp, char *buf, size_t buflen);
418 void fsp_set_base_fsp(struct files_struct *fsp, struct files_struct *base_fsp);
419 bool fsp_is_alternate_stream(const struct files_struct *fsp);
420 struct files_struct *metadata_fsp(struct files_struct *fsp);
421 bool fsp_search_ask_sharemode(struct files_struct *fsp);
422 bool fsp_getinfo_ask_sharemode(struct files_struct *fsp);
424 NTSTATUS create_internal_fsp(connection_struct *conn,
425 const struct smb_filename *smb_fname,
426 struct files_struct **_fsp);
427 NTSTATUS create_internal_dirfsp(connection_struct *conn,
428 const struct smb_filename *smb_dname,
429 struct files_struct **_fsp);
431 NTSTATUS open_internal_dirfsp(connection_struct *conn,
432 const struct smb_filename *smb_dname,
434 struct files_struct **_fsp);
435 NTSTATUS openat_internal_dir_from_pathref(
436 struct files_struct *dirfsp,
438 struct files_struct **_fsp);
440 NTSTATUS openat_pathref_fsp(const struct files_struct *dirfsp,
441 struct smb_filename *smb_fname);
442 NTSTATUS open_stream_pathref_fsp(
443 struct files_struct **_base_fsp,
444 struct smb_filename *smb_fname);
445 NTSTATUS openat_pathref_dirfsp_nosymlink(
447 struct connection_struct *conn,
451 struct smb_filename **_smb_fname,
454 NTSTATUS readlink_talloc(
456 struct files_struct *dirfsp,
457 struct smb_filename *smb_relname,
460 void smb_fname_fsp_unlink(struct smb_filename *smb_fname);
462 NTSTATUS move_smb_fname_fsp_link(struct smb_filename *smb_fname_dst,
463 struct smb_filename *smb_fname_src);
465 NTSTATUS reference_smb_fname_fsp_link(struct smb_filename *smb_fname_dst,
466 const struct smb_filename *smb_fname_src);
468 NTSTATUS synthetic_pathref(TALLOC_CTX *mem_ctx,
469 struct files_struct *dirfsp,
470 const char *base_name,
471 const char *stream_name,
472 const SMB_STRUCT_STAT *psbuf,
475 struct smb_filename **_smb_fname);
477 NTSTATUS parent_pathref(TALLOC_CTX *mem_ctx,
478 struct files_struct *dirfsp,
479 const struct smb_filename *smb_fname,
480 struct smb_filename **_parent,
481 struct smb_filename **_atname);
483 /* The following definitions come from smbd/smb2_ipc.c */
485 NTSTATUS nt_status_np_pipe(NTSTATUS status);
487 /* The following definitions come from smbd/mangle.c */
489 void mangle_reset_cache(void);
490 void mangle_change_to_posix(void);
491 bool mangle_is_mangled(const char *s, const struct share_params *p);
492 bool mangle_is_8_3(const char *fname, bool check_case,
493 const struct share_params *p);
494 bool mangle_is_8_3_wildcards(const char *fname, bool check_case,
495 const struct share_params *p);
496 bool mangle_must_mangle(const char *fname,
497 const struct share_params *p);
498 bool mangle_lookup_name_from_8_3(TALLOC_CTX *ctx,
500 char **out, /* talloced on the given context. */
501 const struct share_params *p);
502 bool name_to_8_3(const char *in,
505 const struct share_params *p);
507 /* The following definitions come from smbd/mangle_hash.c */
509 const struct mangle_fns *mangle_hash_init(void);
511 /* The following definitions come from smbd/mangle_hash2.c */
513 const struct mangle_fns *mangle_hash2_init(void);
514 const struct mangle_fns *posix_mangle_init(void);
516 /* The following definitions come from smbd/msdfs.c */
518 bool parse_msdfs_symlink(TALLOC_CTX *ctx,
519 bool shuffle_referrals,
521 struct referral **preflist,
523 bool is_msdfs_link(struct files_struct *dirfsp,
524 struct smb_filename *smb_fname);
526 NTSTATUS get_referred_path(TALLOC_CTX *ctx,
527 struct auth_session_info *session_info,
528 const char *dfs_path,
529 const struct tsocket_address *remote_address,
530 const struct tsocket_address *local_address,
531 struct junction_map *jucn,
532 size_t *consumedcntp,
533 bool *self_referralp);
534 int setup_dfs_referral(connection_struct *orig_conn,
535 const char *dfs_path,
536 int max_referral_level,
537 char **ppdata, NTSTATUS *pstatus);
538 bool create_junction(TALLOC_CTX *ctx,
539 const char *dfs_path,
540 struct junction_map *jucn);
542 char *msdfs_link_string(TALLOC_CTX *ctx,
543 const struct referral *reflist,
544 size_t referral_count);
545 bool create_msdfs_link(const struct junction_map *jucn,
546 struct auth_session_info *session_info);
547 bool remove_msdfs_link(const struct junction_map *jucn,
548 struct auth_session_info *session_info);
550 struct junction_map *enum_msdfs_links(TALLOC_CTX *ctx,
551 struct auth_session_info *session_info,
553 struct connection_struct;
556 NTSTATUS create_conn_struct_cwd(TALLOC_CTX *mem_ctx,
557 struct tevent_context *ev,
558 struct messaging_context *msg,
559 const struct auth_session_info *session_info,
562 struct connection_struct **c);
563 struct conn_struct_tos {
564 struct connection_struct *conn;
565 struct smb_filename *oldcwd_fname;
567 NTSTATUS create_conn_struct_tos(struct messaging_context *msg,
570 const struct auth_session_info *session_info,
571 struct conn_struct_tos **_c);
572 NTSTATUS create_conn_struct_tos_cwd(struct messaging_context *msg,
575 const struct auth_session_info *session_info,
576 struct conn_struct_tos **_c);
578 /* The following definitions come from smbd/notify.c */
580 bool change_notify_fsp_has_changes(struct files_struct *fsp);
581 void change_notify_reply(struct smb_request *req,
584 struct notify_change_buf *notify_buf,
585 void (*reply_fn)(struct smb_request *req,
587 uint8_t *buf, size_t len));
588 void notify_callback(struct smbd_server_connection *sconn,
589 void *private_data, struct timespec when,
590 const struct notify_event *e);
591 NTSTATUS change_notify_create(struct files_struct *fsp,
592 uint32_t max_buffer_size,
595 NTSTATUS change_notify_add_request(struct smb_request *req,
597 uint32_t filter, bool recursive,
598 struct files_struct *fsp,
599 void (*reply_fn)(struct smb_request *req,
601 uint8_t *buf, size_t len));
602 void smbd_notify_cancel_deleted(struct messaging_context *msg,
603 void *private_data, uint32_t msg_type,
604 struct server_id server_id, DATA_BLOB *data);
605 void smbd_notifyd_restarted(struct messaging_context *msg,
606 void *private_data, uint32_t msg_type,
607 struct server_id server_id, DATA_BLOB *data);
608 bool remove_pending_change_notify_requests_by_mid(
609 struct smbd_server_connection *sconn, uint64_t mid);
610 void remove_pending_change_notify_requests_by_fid(files_struct *fsp,
612 void notify_fname(connection_struct *conn, uint32_t action, uint32_t filter,
614 char *notify_filter_string(TALLOC_CTX *mem_ctx, uint32_t filter);
615 struct sys_notify_context *sys_notify_context_create(TALLOC_CTX *mem_ctx,
616 struct tevent_context *ev);
618 /* The following definitions come from smbd/notify_inotify.c */
620 int inotify_watch(TALLOC_CTX *mem_ctx,
621 struct sys_notify_context *ctx,
624 uint32_t *subdir_filter,
625 void (*callback)(struct sys_notify_context *ctx,
627 struct notify_event *ev,
632 int fam_watch(TALLOC_CTX *mem_ctx,
633 struct sys_notify_context *ctx,
636 uint32_t *subdir_filter,
637 void (*callback)(struct sys_notify_context *ctx,
639 struct notify_event *ev,
645 /* The following definitions come from smbd/notify_internal.c */
647 struct notify_context *notify_init(
648 TALLOC_CTX *mem_ctx, struct messaging_context *msg,
649 struct smbd_server_connection *sconn,
650 void (*callback)(struct smbd_server_connection *sconn,
651 void *, struct timespec,
652 const struct notify_event *));
653 NTSTATUS notify_add(struct notify_context *ctx,
654 const char *path, uint32_t filter, uint32_t subdir_filter,
656 NTSTATUS notify_remove(struct notify_context *ctx, void *private_data,
658 void notify_trigger(struct notify_context *notify,
659 uint32_t action, uint32_t filter,
660 const char *dir, const char *path);
662 /* The following definitions come from smbd/ntquotas.c */
664 NTSTATUS vfs_get_ntquota(files_struct *fsp, enum SMB_QUOTA_TYPE qtype,
665 struct dom_sid *psid, SMB_NTQUOTA_STRUCT *qt);
666 int vfs_set_ntquota(files_struct *fsp, enum SMB_QUOTA_TYPE qtype, struct dom_sid *psid, SMB_NTQUOTA_STRUCT *qt);
667 int vfs_get_user_ntquota_list(files_struct *fsp, SMB_NTQUOTA_LIST **qt_list);
668 void *init_quota_handle(TALLOC_CTX *mem_ctx);
670 /* The following definitions come from smbd/smb2_nttrans.c */
672 NTSTATUS set_sd(files_struct *fsp, struct security_descriptor *psd,
673 uint32_t security_info_sent);
674 NTSTATUS set_sd_blob(files_struct *fsp, uint8_t *data, uint32_t sd_len,
675 uint32_t security_info_sent);
676 NTSTATUS copy_internals(TALLOC_CTX *ctx,
677 connection_struct *conn,
678 struct smb_request *req,
679 struct files_struct *src_dirfsp,
680 struct smb_filename *smb_fname_src,
681 struct files_struct *dst_dirfsp,
682 struct smb_filename *smb_fname_dst,
684 NTSTATUS smbd_do_query_security_desc(connection_struct *conn,
687 uint32_t security_info_wanted,
688 uint32_t max_data_count,
689 uint8_t **ppmarshalled_sd,
691 #ifdef HAVE_SYS_QUOTAS
693 struct smb2_query_quota_info;
695 NTSTATUS smbd_do_query_getinfo_quota(TALLOC_CTX *mem_ctx,
699 uint32_t sid_list_length,
700 DATA_BLOB *sidbuffer,
701 uint32_t max_data_count,
703 uint32_t *p_data_size);
706 /* The following definitions come from smbd/open.c */
708 NTSTATUS smbd_check_access_rights_fsp(struct files_struct *dirfsp,
709 struct files_struct *fsp,
711 uint32_t access_mask);
712 NTSTATUS check_parent_access_fsp(struct files_struct *fsp,
713 uint32_t access_mask);
714 NTSTATUS fd_openat(const struct files_struct *dirfsp,
715 struct smb_filename *smb_fname,
717 const struct vfs_open_how *how);
718 NTSTATUS fd_close(files_struct *fsp);
719 bool is_oplock_stat_open(uint32_t access_mask);
720 bool is_lease_stat_open(uint32_t access_mask);
721 NTSTATUS send_break_message(struct messaging_context *msg_ctx,
722 const struct file_id *id,
723 const struct share_mode_entry *exclusive,
725 struct deferred_open_record;
726 bool is_deferred_open_async(const struct deferred_open_record *rec);
727 bool defer_smb1_sharing_violation(struct smb_request *req);
728 NTSTATUS create_directory(connection_struct *conn,
729 struct smb_request *req,
730 struct files_struct *dirfsp,
731 struct smb_filename *smb_dname);
732 void msg_file_was_renamed(struct messaging_context *msg,
735 struct server_id server_id,
737 struct fsp_lease *find_fsp_lease(struct files_struct *new_fsp,
738 const struct smb2_lease_key *key,
739 uint32_t current_state,
740 uint16_t lease_version,
741 uint16_t lease_epoch);
742 NTSTATUS create_file_default(connection_struct *conn,
743 struct smb_request *req,
744 struct files_struct *dirfsp,
745 struct smb_filename * smb_fname,
746 uint32_t access_mask,
747 uint32_t share_access,
748 uint32_t create_disposition,
749 uint32_t create_options,
750 uint32_t file_attributes,
751 uint32_t oplock_request,
752 const struct smb2_lease *lease,
753 uint64_t allocation_size,
754 uint32_t private_flags,
755 struct security_descriptor *sd,
756 struct ea_list *ea_list,
757 files_struct **result,
759 const struct smb2_create_blobs *in_context_blobs,
760 struct smb2_create_blobs *out_context_blobs);
762 /* The following definitions come from smbd/oplock.c */
764 uint32_t get_lease_type(struct share_mode_entry *e, struct file_id id);
766 void break_kernel_oplock(struct messaging_context *msg_ctx, files_struct *fsp);
767 NTSTATUS set_file_oplock(files_struct *fsp);
768 void release_file_oplock(files_struct *fsp);
769 bool remove_oplock(files_struct *fsp);
770 bool downgrade_oplock(files_struct *fsp);
771 bool fsp_lease_update(struct files_struct *fsp);
772 NTSTATUS downgrade_lease(struct smbXsrv_client *client,
773 uint32_t num_file_ids,
774 const struct file_id *ids,
775 const struct smb2_lease_key *key,
776 uint32_t lease_state);
777 void contend_level2_oplocks_begin(files_struct *fsp,
778 enum level2_contention_type type);
779 void contend_level2_oplocks_end(files_struct *fsp,
780 enum level2_contention_type type);
781 void smbd_contend_level2_oplocks_begin(files_struct *fsp,
782 enum level2_contention_type type);
783 void smbd_contend_level2_oplocks_end(files_struct *fsp,
784 enum level2_contention_type type);
785 void share_mode_entry_to_message(char *msg, const struct file_id *id,
786 const struct share_mode_entry *e);
787 void message_to_share_mode_entry(struct file_id *id,
788 struct share_mode_entry *e,
790 bool init_oplocks(struct smbd_server_connection *sconn);
791 void init_kernel_oplocks(struct smbd_server_connection *sconn);
793 /* The following definitions come from smbd/oplock_linux.c */
795 int linux_set_lease_sighandler(int fd);
796 int linux_setlease(int fd, int leasetype);
797 struct kernel_oplocks *linux_init_kernel_oplocks(struct smbd_server_connection *sconn);
799 /* The following definitions come from smbd/password.c */
801 void invalidate_vuid(struct smbd_server_connection *sconn, uint64_t vuid);
802 int register_homes_share(const char *username);
804 /* The following definitions come from smbd/pipes.c */
806 NTSTATUS open_np_file(struct smb_request *smb_req, const char *name,
807 struct files_struct **pfsp);
809 /* The following definitions come from smbd/posix_acls.c */
811 mode_t unix_perms_to_acl_perms(mode_t mode, int r_mask, int w_mask, int x_mask);
812 int map_acl_perms_to_permset(mode_t mode, SMB_ACL_PERMSET_T *p_permset);
813 uint32_t map_canon_ace_perms(int snum,
814 enum security_ace_type *pacl_type,
817 bool current_user_in_group(connection_struct *conn, gid_t gid);
818 SMB_ACL_T free_empty_sys_acl(connection_struct *conn, SMB_ACL_T the_acl);
819 NTSTATUS posix_fget_nt_acl(struct files_struct *fsp, uint32_t security_info,
821 struct security_descriptor **ppdesc);
822 NTSTATUS chown_if_needed(files_struct *fsp, uint32_t security_info_sent,
823 const struct security_descriptor *psd,
825 NTSTATUS set_nt_acl(files_struct *fsp, uint32_t security_info_sent, const struct security_descriptor *psd);
826 int get_acl_group_bits(connection_struct *conn,
827 struct files_struct *fsp,
829 int inherit_access_posix_acl(connection_struct *conn,
830 struct files_struct *inherit_from_dirfsp,
831 const struct smb_filename *smb_fname,
833 NTSTATUS set_unix_posix_default_acl(connection_struct *conn,
835 uint16_t num_def_acls, const char *pdata);
836 NTSTATUS set_unix_posix_acl(connection_struct *conn, files_struct *fsp,
839 int posix_sys_acl_blob_get_file(vfs_handle_struct *handle,
840 const struct smb_filename *smb_fname,
842 char **blob_description,
844 int posix_sys_acl_blob_get_fd(vfs_handle_struct *handle,
847 char **blob_description,
850 enum default_acl_style {DEFAULT_ACL_POSIX, DEFAULT_ACL_WINDOWS, DEFAULT_ACL_EVERYONE};
852 const struct enum_list *get_default_acl_style_list(void);
854 NTSTATUS make_default_filesystem_acl(
856 enum default_acl_style acl_style,
858 const SMB_STRUCT_STAT *psbuf,
859 struct security_descriptor **ppdesc);
861 /* The following definitions come from smbd/smb2_process.c */
863 #if !defined(WITH_SMB1SERVER)
864 bool smb1_srv_send(struct smbXsrv_connection *xconn,
870 size_t srv_smb1_set_message(char *buf,
874 NTSTATUS read_packet_remainder(int fd, char *buffer,
875 unsigned int timeout, ssize_t len);
876 NTSTATUS receive_smb_talloc(TALLOC_CTX *mem_ctx,
877 struct smbXsrv_connection *xconn,
879 char **buffer, unsigned int timeout,
880 size_t *p_unread, bool *p_encrypted,
883 bool trusted_channel);
884 void remove_deferred_open_message_smb(struct smbXsrv_connection *xconn,
886 bool schedule_deferred_open_message_smb(struct smbXsrv_connection *xconn,
888 bool open_was_deferred(struct smbXsrv_connection *xconn, uint64_t mid);
889 bool get_deferred_open_message_state(struct smb_request *smbreq,
890 struct timeval *p_request_time,
891 struct deferred_open_record **open_rec);
892 bool push_deferred_open_message_smb(struct smb_request *req,
893 struct timeval timeout,
895 struct deferred_open_record *open_rec);
896 bool create_smb1_outbuf(TALLOC_CTX *mem_ctx, struct smb_request *req,
897 const uint8_t *inbuf, char **outbuf,
898 uint8_t num_words, uint32_t num_bytes);
899 void construct_smb1_reply_common_req(struct smb_request *req, char *outbuf);
900 void reply_smb1_outbuf(struct smb_request *req, uint8_t num_words, uint32_t num_bytes);
901 void process_smb(struct smbXsrv_connection *xconn,
907 void smbd_process(struct tevent_context *ev_ctx,
908 struct messaging_context *msg_ctx,
911 bool valid_smb1_header(const uint8_t *inbuf);
912 bool init_smb1_request(struct smb_request *req,
913 struct smbd_server_connection *sconn,
914 struct smbXsrv_connection *xconn,
915 const uint8_t *inbuf,
916 size_t unread_bytes, bool encrypted,
919 /* The following definitions come from smbd/quotas.c */
921 bool disk_quotas(connection_struct *conn, struct smb_filename *fname,
922 uint64_t *bsize, uint64_t *dfree, uint64_t *dsize);
924 /* The following definitions come from smbd/smb2_reply.c */
926 NTSTATUS check_path_syntax(char *path, bool posix);
927 NTSTATUS smb1_strip_dfs_path(TALLOC_CTX *mem_ctx,
930 NTSTATUS smb2_strip_dfs_path(const char *in_path, const char **out_path);
931 size_t srvstr_get_path(TALLOC_CTX *ctx,
939 size_t srvstr_get_path_posix(TALLOC_CTX *ctx,
947 size_t srvstr_get_path_req(TALLOC_CTX *mem_ctx, struct smb_request *req,
948 char **pp_dest, const char *src, int flags,
950 size_t srvstr_pull_req_talloc(TALLOC_CTX *ctx, struct smb_request *req,
951 char **dest, const uint8_t *src, int flags);
952 bool check_fsp_open(connection_struct *conn, struct smb_request *req,
954 bool check_fsp(connection_struct *conn, struct smb_request *req,
956 bool check_fsp_ntquota_handle(connection_struct *conn, struct smb_request *req,
958 void reply_special(struct smbXsrv_connection *xconn, char *inbuf, size_t inbuf_size);
959 NTSTATUS unlink_internals(connection_struct *conn,
960 struct smb_request *req,
962 struct files_struct *dirfsp,
963 struct smb_filename *smb_fname);
964 ssize_t fake_sendfile(struct smbXsrv_connection *xconn, files_struct *fsp,
965 off_t startpos, size_t nread);
966 ssize_t sendfile_short_send(struct smbXsrv_connection *xconn,
971 NTSTATUS rename_internals_fsp(connection_struct *conn,
973 struct files_struct *dst_dirfsp,
974 struct smb_filename *smb_fname_dst_in,
975 const char *dst_original_lcomp,
977 bool replace_if_exists);
978 NTSTATUS rename_internals(TALLOC_CTX *ctx,
979 connection_struct *conn,
980 struct smb_request *req,
981 struct files_struct *src_dirfsp,
982 struct smb_filename *smb_fname_src,
983 struct files_struct *dst_dirfsp,
984 struct smb_filename *smb_fname_dst,
985 const char *dst_original_lcomp,
987 bool replace_if_exists,
988 uint32_t access_mask);
989 NTSTATUS copy_file(TALLOC_CTX *ctx,
990 connection_struct *conn,
991 struct smb_filename *smb_fname_src,
992 struct smb_filename *smb_fname_dst,
993 uint32_t new_create_disposition);
994 uint64_t get_lock_offset(const uint8_t *data, int data_offset,
995 bool large_file_format);
997 /* The following definitions come from smbd/seal.c */
999 bool is_encrypted_packet(const uint8_t *inbuf);
1000 void srv_free_enc_buffer(struct smbXsrv_connection *xconn, char *buf);
1001 NTSTATUS srv_decrypt_buffer(struct smbXsrv_connection *xconn, char *buf);
1002 NTSTATUS srv_encrypt_buffer(struct smbXsrv_connection *xconn, char *buf,
1004 NTSTATUS srv_request_encryption_setup(connection_struct *conn,
1005 unsigned char **ppdata,
1006 size_t *p_data_size,
1007 unsigned char **pparam,
1008 size_t *p_param_size);
1009 NTSTATUS srv_encryption_start(connection_struct *conn);
1010 void server_encryption_shutdown(struct smbXsrv_connection *xconn);
1012 /* The following definitions come from smbd/sec_ctx.c */
1014 bool unix_token_equal(const struct security_unix_token *t1, const struct security_unix_token *t2);
1015 bool push_sec_ctx(void);
1016 void set_sec_ctx(uid_t uid, gid_t gid, int ngroups, gid_t *groups, const struct security_token *token);
1017 void set_root_sec_ctx(void);
1018 bool pop_sec_ctx(void);
1019 void init_sec_ctx(void);
1020 const struct security_token *sec_ctx_active_token(void);
1022 /* The following definitions come from smbd/server.c */
1024 struct memcache *smbd_memcache(void);
1025 bool snum_is_shared_printer(int snum);
1026 void delete_and_reload_printers(void);
1027 bool reload_services(struct smbd_server_connection *sconn,
1028 bool (*snumused) (struct smbd_server_connection *, int),
1031 /* The following definitions come from smbd/server_exit.c */
1033 void smbd_exit_server(const char *reason) _NORETURN_;
1034 void smbd_exit_server_cleanly(const char *const reason) _NORETURN_;
1036 /* The following definitions come from smbd/smb2_service.c */
1038 bool set_conn_connectpath(connection_struct *conn, const char *connectpath);
1039 bool canonicalize_connect_path(connection_struct *conn);
1040 NTSTATUS set_conn_force_user_group(connection_struct *conn, int snum);
1041 bool chdir_current_service(connection_struct *conn);
1042 void load_registry_shares(void);
1043 int add_home_service(const char *service, const char *username, const char *homedir);
1044 int find_service(TALLOC_CTX *ctx, const char *service, char **p_service_out);
1045 connection_struct *make_connection_smb2(struct smbd_smb2_request *req,
1046 struct smbXsrv_tcon *tcon,
1050 NTSTATUS make_connection_snum(struct smbXsrv_connection *xconn,
1051 connection_struct *conn,
1053 struct smbXsrv_session *session,
1055 void close_cnum(connection_struct *conn,
1057 enum file_close_type close_type);
1059 /* The following definitions come from smbd/session.c */
1061 struct smbXsrv_session;
1062 bool session_init(void);
1063 bool session_claim(struct smbXsrv_session *session);
1064 void session_yield(struct smbXsrv_session *session);
1065 int list_sessions(TALLOC_CTX *mem_ctx, struct sessionid **session_list);
1066 int find_sessions(TALLOC_CTX *mem_ctx, const char *username,
1067 const char *machine, struct sessionid **session_list);
1069 /* The following definitions come from smbd/share_access.c */
1071 bool token_contains_name_in_list(const char *username,
1073 const char *sharename,
1074 const struct security_token *token,
1076 bool user_ok_token(const char *username, const char *domain,
1077 const struct security_token *token, int snum);
1078 bool is_share_read_only_for_token(const char *username,
1080 const struct security_token *token,
1081 connection_struct *conn);
1083 /* The following definitions come from smbd/srvstr.c */
1085 NTSTATUS srvstr_push_fn(const char *base_ptr, uint16_t smb_flags2, void *dest,
1086 const char *src, int dest_len, int flags, size_t *ret_len);
1088 /* The following definitions come from smbd/statvfs.c */
1090 int sys_statvfs(const char *path, struct vfs_statvfs_struct *statbuf);
1092 /* The following definitions come from smbd/trans2.c */
1094 char *store_file_unix_basic(connection_struct *conn,
1097 const SMB_STRUCT_STAT *psbuf);
1098 char *store_file_unix_basic_info2(connection_struct *conn,
1101 const SMB_STRUCT_STAT *psbuf);
1102 NTSTATUS smb_set_file_disposition_info(connection_struct *conn,
1106 struct smb_filename *smb_fname);
1107 NTSTATUS refuse_symlink_fsp(const struct files_struct *fsp);
1108 NTSTATUS check_access_fsp(struct files_struct *fsp,
1109 uint32_t access_mask);
1110 uint64_t smb_roundup(connection_struct *conn, uint64_t val);
1111 bool samba_private_attr_name(const char *unix_ea_name);
1112 NTSTATUS get_ea_value_fsp(TALLOC_CTX *mem_ctx,
1114 const char *ea_name,
1115 struct ea_struct *pea);
1116 NTSTATUS get_ea_names_from_fsp(TALLOC_CTX *mem_ctx,
1119 size_t *pnum_names);
1120 NTSTATUS set_ea(connection_struct *conn, files_struct *fsp,
1121 struct ea_list *ea_list);
1122 unsigned char *create_volume_objectid(connection_struct *conn, unsigned char objid[16]);
1123 NTSTATUS hardlink_internals(TALLOC_CTX *ctx,
1124 connection_struct *conn,
1125 struct smb_request *req,
1126 bool overwrite_if_exists,
1127 struct files_struct *old_dirfsp,
1128 const struct smb_filename *smb_fname_old,
1129 struct files_struct *new_dirfsp,
1130 struct smb_filename *smb_fname_new);
1131 NTSTATUS smb_set_file_time(connection_struct *conn,
1133 struct smb_filename *smb_fname,
1134 struct smb_file_time *ft,
1135 bool setting_write_time);
1136 NTSTATUS smb_set_file_size(connection_struct *conn,
1137 struct smb_request *req,
1139 struct smb_filename *smb_fname,
1140 const SMB_STRUCT_STAT *psbuf,
1142 bool fail_after_createfile);
1144 bool map_info2_flags_to_sbuf(const SMB_STRUCT_STAT *psbuf,
1145 const uint32_t smb_fflags,
1146 const uint32_t smb_fmask,
1156 NTSTATUS unix_perms_from_wire(connection_struct *conn,
1157 const SMB_STRUCT_STAT *psbuf,
1159 enum perm_type ptype,
1161 struct ea_list *read_ea_list(TALLOC_CTX *ctx, const char *pdata,
1163 unsigned int estimate_ea_size(files_struct *fsp);
1164 NTSTATUS smb_set_fsquota(connection_struct *conn,
1165 struct smb_request *req,
1167 const DATA_BLOB *qdata);
1169 /* The following definitions come from smbd/uid.c */
1171 bool change_to_guest(void);
1172 NTSTATUS check_user_share_access(connection_struct *conn,
1173 const struct auth_session_info *session_info,
1174 uint32_t *p_share_access,
1175 bool *p_readonly_share);
1176 bool change_to_user_and_service(connection_struct *conn, uint64_t vuid);
1177 bool change_to_user_and_service_by_fsp(struct files_struct *fsp);
1178 bool smbd_change_to_root_user(void);
1179 bool smbd_become_authenticated_pipe_user(struct auth_session_info *session_info);
1180 bool smbd_unbecome_authenticated_pipe_user(void);
1181 void become_root(void);
1182 void unbecome_root(void);
1183 void smbd_become_root(void);
1184 void smbd_unbecome_root(void);
1185 bool become_user_without_service(connection_struct *conn, uint64_t vuid);
1186 bool become_user_without_service_by_fsp(struct files_struct *fsp);
1187 bool become_user_without_service_by_session(connection_struct *conn,
1188 const struct auth_session_info *session_info);
1189 bool unbecome_user_without_service(void);
1190 uid_t get_current_uid(connection_struct *conn);
1191 gid_t get_current_gid(connection_struct *conn);
1192 const struct security_unix_token *get_current_utok(connection_struct *conn);
1193 const struct security_token *get_current_nttok(connection_struct *conn);
1195 /* The following definitions come from smbd/utmp.c */
1197 void sys_utmp_claim(const char *username, const char *hostname,
1198 const char *id_str, int id_num);
1199 void sys_utmp_yield(const char *username, const char *hostname,
1200 const char *id_str, int id_num);
1202 /* The following definitions come from smbd/vfs.c */
1204 bool vfs_init_custom(connection_struct *conn, const char *vfs_object);
1205 bool smbd_vfs_init(connection_struct *conn);
1206 NTSTATUS vfs_file_exist(connection_struct *conn, struct smb_filename *smb_fname);
1207 bool vfs_valid_pread_range(off_t offset, size_t length);
1208 bool vfs_valid_pwrite_range(off_t offset, size_t length);
1209 ssize_t vfs_pwrite_data(struct smb_request *req,
1214 int vfs_allocate_file_space(files_struct *fsp, uint64_t len);
1215 int vfs_set_filelen(files_struct *fsp, off_t len);
1216 int vfs_slow_fallocate(files_struct *fsp, off_t offset, off_t len);
1217 int vfs_fill_sparse(files_struct *fsp, off_t len);
1218 int vfs_set_blocking(files_struct *fsp, bool set);
1219 off_t vfs_transfer_file(files_struct *in, files_struct *out, off_t n);
1220 const char *vfs_readdirname(connection_struct *conn,
1221 struct files_struct *dirfsp,
1223 SMB_STRUCT_STAT *sbuf,
1225 int vfs_ChDir(connection_struct *conn,
1226 const struct smb_filename *smb_fname);
1227 struct smb_filename *vfs_GetWd(TALLOC_CTX *ctx, connection_struct *conn);
1228 int vfs_stat(struct connection_struct *conn,
1229 struct smb_filename *smb_fname);
1230 int vfs_stat_smb_basename(struct connection_struct *conn,
1231 const struct smb_filename *smb_fname_in,
1232 SMB_STRUCT_STAT *psbuf);
1233 NTSTATUS vfs_stat_fsp(files_struct *fsp);
1234 NTSTATUS vfs_fstreaminfo(struct files_struct *fsp,
1235 TALLOC_CTX *mem_ctx,
1236 unsigned int *num_streams,
1237 struct stream_struct **streams);
1238 void init_smb_file_time(struct smb_file_time *ft);
1239 int vfs_fake_fd(void);
1240 int vfs_fake_fd_close(int fd);
1242 /* The following definitions come from smbd/avahi_register.c */
1244 void *avahi_start_register(TALLOC_CTX *mem_ctx, struct tevent_context *ev,
1247 /* The following definitions come from smbd/smb2_create.c */
1249 NTSTATUS vfs_default_durable_cookie(struct files_struct *fsp,
1250 TALLOC_CTX *mem_ctx,
1251 DATA_BLOB *cookie_blob);
1252 NTSTATUS vfs_default_durable_disconnect(struct files_struct *fsp,
1253 const DATA_BLOB old_cookie,
1254 TALLOC_CTX *mem_ctx,
1255 DATA_BLOB *new_cookie);
1256 NTSTATUS vfs_default_durable_reconnect(struct connection_struct *conn,
1257 struct smb_request *smb1req,
1258 struct smbXsrv_open *op,
1259 const DATA_BLOB old_cookie,
1260 TALLOC_CTX *mem_ctx,
1261 files_struct **result,
1262 DATA_BLOB *new_cookie);
1264 /* The following definitions come from smbd/smb2_posix.c */
1265 ssize_t smb2_posix_cc_info(
1266 connection_struct *conn,
1267 uint32_t reparse_tag,
1268 const SMB_STRUCT_STAT *psbuf,
1269 const struct dom_sid *owner,
1270 const struct dom_sid *group,
1273 ssize_t store_smb2_posix_info(
1274 connection_struct *conn,
1275 const SMB_STRUCT_STAT *psbuf,
1276 uint32_t reparse_tag,
1277 uint32_t dos_attributes,
1281 #endif /* _SMBD_PROTO_H_ */