2 Unix SMB/CIFS implementation.
3 VFS structures and parameters
4 Copyright (C) Jeremy Allison 1999-2005
5 Copyright (C) Tim Potter 1999
6 Copyright (C) Alexander Bokovoy 2002-2005
7 Copyright (C) Stefan (metze) Metzmacher 2003
8 Copyright (C) Volker Lendecke 2009
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program. If not, see <http://www.gnu.org/licenses/>.
23 This work was sponsored by Optifacio Software Services, Inc.
29 /* Avoid conflict with an AIX include file */
36 * As we're now (thanks Andrew ! :-) using file_structs and connection
37 * structs in the vfs - then anyone writing a vfs must include includes.h...
41 * This next constant specifies the version number of the VFS interface
42 * this smbd will load. Increment this if *ANY* changes are made to the
45 * If you change anything here, please also update modules/vfs_full_audit.c.
49 /* Changed to version 2 for CIFS UNIX extensions (mknod and link added). JRA. */
50 /* Changed to version 3 for POSIX acl extensions. JRA. */
51 /* Changed to version 4 for cascaded VFS interface. Alexander Bokovoy. */
52 /* Changed to version 5 for sendfile addition. JRA. */
53 /* Changed to version 6 for the new module system, fixed cascading and quota functions. --metze */
54 /* Changed to version 7 to include the get_nt_acl info parameter. JRA. */
55 /* Changed to version 8 includes EA calls. JRA. */
56 /* Changed to version 9 to include the get_shadow_data call. --metze */
57 /* Changed to version 10 to include pread/pwrite calls. */
58 /* Changed to version 11 to include seekdir/telldir/rewinddir calls. JRA */
59 /* Changed to version 12 to add mask and attributes to opendir(). JRA
60 Also include aio calls. JRA. */
61 /* Changed to version 13 as the internal structure of files_struct has changed. JRA */
62 /* Changed to version 14 as we had to change DIR to SMB_STRUCT_DIR. JRA */
63 /* Changed to version 15 as we added the statvfs call. JRA */
64 /* Changed to version 16 as we added the getlock call. JRA */
65 /* Changed to version 17 as we removed redundant connection_struct parameters. --jpeach */
66 /* Changed to version 18 to add fsp parameter to the open call -- jpeach
67 Also include kernel_flock call - jmcd */
68 /* Changed to version 19, kernel change notify has been merged
69 Also included linux setlease call - jmcd */
70 /* Changed to version 20, use ntimes call instead of utime (greater
71 * timestamp resolition. JRA. */
72 /* Changed to version21 to add chflags operation -- jpeach */
73 /* Changed to version22 to add lchown operation -- jra */
74 /* Leave at 22 - not yet released. But change set_nt_acl to return an NTSTATUS. jra. */
75 /* Leave at 22 - not yet released. Add file_id_create operation. --metze */
76 /* Leave at 22 - not yet released. Change all BOOL parameters (int) to bool. jra. */
77 /* Leave at 22 - not yet released. Added recvfile. */
78 /* Leave at 22 - not yet released. Change get_nt_acl to return NTSTATUS - vl */
79 /* Leave at 22 - not yet released. Change get_nt_acl to *not* take a
80 * files_struct. - obnox.*/
81 /* Leave at 22 - not yet released. Remove parameter fd from fget_nt_acl. - obnox */
82 /* Leave at 22 - not yet released. Remove parameter fd from gset_nt_acl. - obnox */
83 /* Leave at 22 - not yet released. Remove parameter fd from pread. - obnox */
84 /* Leave at 22 - not yet released. Remove parameter fd from pwrite. - obnox */
85 /* Leave at 22 - not yet released. Remove parameter fd from lseek. - obnox */
86 /* Leave at 22 - not yet released. Remove parameter fd from fsync. - obnox */
87 /* Leave at 22 - not yet released. Remove parameter fd from fstat. - obnox */
88 /* Leave at 22 - not yet released. Remove parameter fd from fchmod. - obnox */
89 /* Leave at 22 - not yet released. Remove parameter fd from fchown. - obnox */
90 /* Leave at 22 - not yet released. Remove parameter fd from ftruncate. - obnox */
91 /* Leave at 22 - not yet released. Remove parameter fd from lock. - obnox */
92 /* Leave at 22 - not yet released. Remove parameter fd from kernel_flock. - obnox */
93 /* Leave at 22 - not yet released. Remove parameter fd from linux_setlease. - obnox */
94 /* Leave at 22 - not yet released. Remove parameter fd from getlock. - obnox */
95 /* Leave at 22 - not yet released. Remove parameter fd from sys_acl_get_fd. - obnox */
96 /* Leave at 22 - not yet released. Remove parameter fd from fchmod_acl. - obnox */
97 /* Leave at 22 - not yet released. Remove parameter fd from sys_acl_set_fd. - obnox */
98 /* Leave at 22 - not yet released. Remove parameter fd from fgetxattr. - obnox */
99 /* Leave at 22 - not yet released. Remove parameter fd from flistxattr. - obnox */
100 /* Leave at 22 - not yet released. Remove parameter fd from fremovexattr. - obnox */
101 /* Leave at 22 - not yet released. Remove parameter fd from fsetxattr. - obnox */
102 /* Leave at 22 - not yet released. Remove parameter fd from aio_cancel. - obnox */
103 /* Leave at 22 - not yet released. Remove parameter fd from read. - obnox */
104 /* Leave at 22 - not yet released. Remove parameter fd from write. - obnox */
105 /* Leave at 22 - not yet released. Remove parameter fromfd from sendfile. - obnox */
106 /* Leave at 22 - not yet released. Remove parameter fromfd from recvfile. - obnox */
107 /* Leave at 22 - not yet released. Additional change: add operations for offline files -- ab */
108 /* Leave at 22 - not yet released. Add the streaminfo call. -- jpeach, vl */
109 /* Leave at 22 - not yet released. Remove parameter fd from close_fn. - obnox */
110 /* Changed to version 23 - remove set_nt_acl call. This can only be done via an
112 /* Changed to version 24 - make security descriptor const in fset_nt_acl. JRA. */
113 /* Changed to version 25 - Jelmer's change from SMB_BIG_UINT to uint64_t. */
114 /* Leave at 25 - not yet released. Add create_file call. -- tprouty. */
115 /* Leave at 25 - not yet released. Add create time to ntimes. -- tstecher. */
116 /* Leave at 25 - not yet released. Add get_alloc_size call. -- tprouty. */
117 /* Leave at 25 - not yet released. Add SMB_STRUCT_STAT to readdir. - sdann */
118 /* Leave at 25 - not yet released. Add init_search_op call. - sdann */
119 /* Leave at 25 - not yet released. Add locking calls. -- zkirsch. */
120 /* Leave at 25 - not yet released. Add strict locking calls. -- drichards. */
121 /* Changed to version 26 - Plumb struct smb_filename to SMB_VFS_CREATE_FILE,
122 SMB_VFS_OPEN, SMB_VFS_STAT, SMB_VFS_LSTAT,
123 SMB_VFS_RENAME, SMB_VFS_UNLINK, SMB_VFS_NTIMES. */
124 /* Changed to version 27 - not yet released. Added enum timestamp_set_resolution
125 * return to fs_capabilities call. JRA. */
126 /* Leave at 27 - not yet released. Add translate_name VFS call to convert
127 UNIX names to Windows supported names -- asrinivasan. */
128 /* Changed to version 28 - Add private_flags uint32_t to CREATE call. */
129 /* Leave at 28 - not yet released. Change realpath to assume NULL and return a
130 malloc'ed path. JRA. */
131 /* Leave at 28 - not yet released. Move posix_fallocate into the VFS
132 where it belongs. JRA. */
133 /* Leave at 28 - not yet released. Rename posix_fallocate to fallocate
134 to split out the two possible uses. JRA. */
135 /* Leave at 28 - not yet released. Add fdopendir. JRA. */
136 /* Leave at 28 - not yet released. Rename open function to open_fn. - gd */
137 /* Leave at 28 - not yet released. Make getwd function always return malloced memory. JRA. */
138 /* Bump to version 29 - Samba 3.6.0 will ship with interface version 28. */
139 /* Leave at 29 - not yet releases. Add fsctl. Richard Sharpe */
140 /* Leave at 29 - not yet released. add SMB_VFS_GET_DFS_REFERRAL() - metze */
141 /* Leave at 29 - not yet released. Remove l{list,get,set,remove}xattr - abartlet */
142 /* Leave at 29 - not yet released. move to plain off_t - abartlet */
143 /* Leave at 29 - not yet released. Remove sys_acl functions other than set and get - abartlet */
144 /* Leave at 29 - not yet released. Added backup_intent bool to files_struct - JRA */
145 /* Leave at 29 - not yet released. Add durable handle functions - metze/obnox */
146 /* Leave at 29 - not yet released. Added sys_acl_blob_get_file and sys_acl_blob_get_fd */
147 /* Bump to version 30 - Samba 4.0.0 will ship with interface version 30 */
148 /* Leave at 30 - not yet released. Added conn->cwd to save vfs_GetWd() calls. */
149 /* Leave at 30 - not yet released. Changed sys_acl_blob_get_file interface to remove type */
150 /* Bump to version 31 - Samba 4.1.0 will ship with interface version 31 */
151 /* Leave at 31 - not yet released. Make struct vuid_cache_entry in
152 connection_struct a pointer. */
153 /* Leave at 31 - not yet released. Add share_access to vuid_cache_entry. */
154 /* Leave at 31 - not yet released. add SMB_VFS_COPY_CHUNK() */
155 /* Leave at 31 - not yet released. Remove the unused
156 fsp->pending_break_messages array */
157 /* Leave at 31 - not yet released. add SMB_VFS_[GET/SET]_COMPRESSION() */
159 /* Bump to version 32 - Samba 4.2 will ship with that. */
160 /* Version 32 - Add "lease" to CREATE_FILE operation */
162 #define SMB_VFS_INTERFACE_VERSION 32
165 All intercepted VFS operations must be declared as static functions inside module source
166 in order to keep smbd namespace unpolluted. See source of audit, extd_audit, fake_perms and recycle
167 example VFS modules for more details.
170 /* VFS operations structure */
172 struct vfs_handle_struct;
173 struct connection_struct;
175 struct security_descriptor;
176 struct vfs_statvfs_struct;
179 struct smb_file_time;
180 struct blocking_lock_record;
182 struct dfs_GetDFSReferral;
184 typedef union unid_t {
192 uint64_t position_information;
194 uint32 private_options; /* NT Create options, but we only look at
195 * NTCREATEX_OPTIONS_PRIVATE_DENY_DOS and
196 * NTCREATEX_OPTIONS_PRIVATE_DENY_FCB and
197 * NTCREATEX_OPTIONS_PRIVATE_DELETE_ON_CLOSE
198 * for print files *only*, where
199 * DELETE_ON_CLOSE is not stored in the share
202 unsigned long gen_id;
205 typedef struct files_struct {
206 struct files_struct *next, *prev;
208 struct smbXsrv_open *op;
209 struct connection_struct *conn;
210 struct fd_handle *fh;
211 unsigned int num_smb_operations;
212 struct file_id file_id;
213 uint64_t initial_allocation_size; /* Faked up initial allocation on disk. */
215 uint64_t vuid; /* SMB2 compat */
216 struct write_cache *wcp;
217 struct timeval open_time;
218 uint32 access_mask; /* NTCreateX access bits (FILE_READ_DATA etc.) */
219 uint32 share_access; /* NTCreateX share constants (FILE_SHARE_READ|FILE_SHARE_WRITE|FILE_SHARE_DELETE). */
221 bool update_write_time_triggered;
222 struct tevent_timer *update_write_time_event;
223 bool update_write_time_on_close;
224 struct timespec close_write_time;
225 bool write_time_forced;
228 int sent_oplock_break;
229 struct tevent_timer *oplock_timeout;
230 struct lock_struct last_lock_failure;
231 int current_lock_count; /* Count the number of outstanding locks and pending locks. */
238 bool aio_write_behind;
240 bool initial_delete_on_close; /* Only set at NTCreateX if file was created. */
241 bool delete_on_close;
244 bool backup_intent; /* Handle was successfully opened with backup intent
245 and opener has privilege to do so. */
246 struct smb_filename *fsp_name;
247 uint32_t name_hash; /* Jenkins hash of full pathname. */
248 uint64_t mid; /* Mid of the operation that created us. */
250 struct vfs_fsp_data *vfs_extension;
251 struct fake_file_handle *fake_file_handle;
253 struct notify_change_buf *notify;
255 struct files_struct *base_fsp; /* placeholder for delete on close */
258 * Read-only cached brlock record, thrown away when the
259 * brlock.tdb seqnum changes. This avoids fetching data from
260 * the brlock.tdb on every read/write call.
263 struct byte_range_lock *brlock_rec;
265 struct dptr_struct *dptr;
267 /* if not NULL, means this is a print file */
268 struct print_file_data *print_file;
270 unsigned num_aio_requests;
271 struct tevent_req **aio_requests;
274 * If a close request comes in while we still have aio_requests
275 * around, we need to hold back the close. When all aio_requests are
276 * done, the aio completion routines need tevent_wait_done() on
277 * this. A bit ugly, but before we have close_file() fully async
278 * possibly the simplest approach. Thanks, Jeremy for the idea.
280 struct tevent_req *deferred_close;
283 struct vuid_cache_entry {
284 struct auth_session_info *session_info;
285 uint64_t vuid; /* SMB2 compat */
287 uint32_t share_access;
291 unsigned int next_entry;
292 struct vuid_cache_entry array[VUID_CACHE_SIZE];
298 } name_compare_entry;
300 struct dfree_cached_info {
301 time_t last_dfree_time;
308 struct share_params {
312 typedef struct connection_struct {
313 struct connection_struct *next, *prev;
314 struct smbd_server_connection *sconn; /* can be NULL */
315 struct smbXsrv_tcon *tcon; /* can be NULL */
316 uint32_t cnum; /* an index passed over the wire */
317 struct share_params *params;
319 struct vuid_cache *vuid_cache;
322 bool read_only; /* Attributes for the current user of the share. */
323 uint32_t share_access;
324 /* Does this filesystem honor
325 sub second timestamps on files
326 and directories when setting time ? */
327 enum timestamp_set_resolution ts_res;
330 char *cwd; /* Working directory. */
332 struct vfs_handle_struct *vfs_handles; /* for the new plugins */
335 * This represents the user information on this connection. Depending
336 * on the vuid using this tid, this might change per SMB request.
338 struct auth_session_info *session_info;
341 * If the "force group" parameter is set, this is the primary gid that
342 * may be used in the users token, depending on the vuid using this tid.
344 gid_t force_group_gid;
346 uint64_t vuid; /* vuid of user who *opened* this connection, or UID_FIELD_INVALID */
349 time_t lastused_count;
351 unsigned int num_smb_operations; /* Count of smb operations on this tree. */
355 /* Semantics requested by the client or forced by the server config. */
358 bool short_case_preserve;
360 /* Semantics provided by the underlying filesystem. */
362 /* Device number of the directory of the share mount.
363 Used to ensure unique FileIndex returns. */
364 SMB_DEV_T base_share_dev;
366 name_compare_entry *hide_list; /* Per-share list of files to return as hidden. */
367 name_compare_entry *veto_list; /* Per-share list of files to veto (never show). */
368 name_compare_entry *veto_oplock_list; /* Per-share list of files to refuse oplocks on. */
369 name_compare_entry *aio_write_behind_list; /* Per-share list of files to use aio write behind on. */
370 struct dfree_cached_info *dfree_info;
371 struct trans_state *pending_trans;
373 struct rpc_pipe_client *spoolss_pipe;
377 struct smbd_smb2_request;
378 struct privilege_paths;
384 uint64_t mid; /* For compatibility with SMB2. */
386 uint64_t vuid; /* For compatibility with SMB2. */
395 * Async handling in the main smb processing loop is directed by
396 * outbuf: reply_xxx routines indicate sync behaviour by putting their
397 * reply into "outbuf". If they leave it as NULL, they take care of it
398 * themselves, possibly later.
400 * If async handling is wanted, the reply_xxx routine must make sure
401 * that it talloc_move()s the smb_req somewhere else.
407 connection_struct *conn;
408 struct smbd_server_connection *sconn;
409 struct smbXsrv_connection *xconn;
410 struct smb_perfcount_data pcd;
413 * Chained request handling
415 struct files_struct *chain_fsp;
418 * state information for async smb handling
423 * Back pointer to smb2 request.
425 struct smbd_smb2_request *smb2req;
428 * Pathnames used if request done
431 struct privilege_paths *priv_paths;
434 * Request list for chained requests, we're part of it.
436 struct smb_request **chain;
438 struct timeval request_time;
442 * Info about an alternate data stream
445 struct stream_struct {
452 struct smb_file_time {
453 struct timespec mtime;
454 struct timespec atime;
455 struct timespec ctime;
456 struct timespec create_time;
462 struct smb_filename {
465 char *original_lcomp;
469 #define VFS_FIND(__fn__) while (handle->fns->__fn__##_fn==NULL) { \
470 handle = handle->next; \
473 enum vfs_translate_direction {
474 vfs_translate_to_unix = 0,
475 vfs_translate_to_windows
478 enum vfs_fallocate_mode {
479 VFS_FALLOCATE_EXTEND_SIZE = 0,
480 VFS_FALLOCATE_KEEP_SIZE = 1
484 Available VFS operations. These values must be in sync with vfs_ops struct
485 (struct vfs_fn_pointers and struct vfs_handle_pointers inside of struct vfs_ops).
486 In particular, if new operations are added to vfs_ops, appropriate constants
487 should be added to vfs_op_type so that order of them kept same as in vfs_ops.
489 struct shadow_copy_data;
491 struct vfs_fn_pointers {
492 /* Disk operations */
494 int (*connect_fn)(struct vfs_handle_struct *handle, const char *service, const char *user);
495 void (*disconnect_fn)(struct vfs_handle_struct *handle);
496 uint64_t (*disk_free_fn)(struct vfs_handle_struct *handle, const char *path, bool small_query, uint64_t *bsize,
497 uint64_t *dfree, uint64_t *dsize);
498 int (*get_quota_fn)(struct vfs_handle_struct *handle, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *qt);
499 int (*set_quota_fn)(struct vfs_handle_struct *handle, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *qt);
500 int (*get_shadow_copy_data_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, struct shadow_copy_data *shadow_copy_data, bool labels);
501 int (*statvfs_fn)(struct vfs_handle_struct *handle, const char *path, struct vfs_statvfs_struct *statbuf);
502 uint32_t (*fs_capabilities_fn)(struct vfs_handle_struct *handle, enum timestamp_set_resolution *p_ts_res);
505 * Note: that "struct dfs_GetDFSReferral *r"
506 * needs to be a valid TALLOC_CTX
508 NTSTATUS (*get_dfs_referrals_fn)(struct vfs_handle_struct *handle,
509 struct dfs_GetDFSReferral *r);
511 /* Directory operations */
513 DIR *(*opendir_fn)(struct vfs_handle_struct *handle, const char *fname, const char *mask, uint32 attributes);
514 DIR *(*fdopendir_fn)(struct vfs_handle_struct *handle, files_struct *fsp, const char *mask, uint32 attributes);
515 struct dirent *(*readdir_fn)(struct vfs_handle_struct *handle,
517 SMB_STRUCT_STAT *sbuf);
518 void (*seekdir_fn)(struct vfs_handle_struct *handle, DIR *dirp, long offset);
519 long (*telldir_fn)(struct vfs_handle_struct *handle, DIR *dirp);
520 void (*rewind_dir_fn)(struct vfs_handle_struct *handle, DIR *dirp);
521 int (*mkdir_fn)(struct vfs_handle_struct *handle, const char *path, mode_t mode);
522 int (*rmdir_fn)(struct vfs_handle_struct *handle, const char *path);
523 int (*closedir_fn)(struct vfs_handle_struct *handle, DIR *dir);
524 void (*init_search_op_fn)(struct vfs_handle_struct *handle, DIR *dirp);
526 /* File operations */
528 int (*open_fn)(struct vfs_handle_struct *handle,
529 struct smb_filename *smb_fname, files_struct *fsp,
530 int flags, mode_t mode);
531 NTSTATUS (*create_file_fn)(struct vfs_handle_struct *handle,
532 struct smb_request *req,
533 uint16_t root_dir_fid,
534 struct smb_filename *smb_fname,
535 uint32_t access_mask,
536 uint32_t share_access,
537 uint32_t create_disposition,
538 uint32_t create_options,
539 uint32_t file_attributes,
540 uint32_t oplock_request,
541 struct smb2_lease *lease,
542 uint64_t allocation_size,
543 uint32_t private_flags,
544 struct security_descriptor *sd,
545 struct ea_list *ea_list,
546 files_struct **result,
548 int (*close_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp);
549 ssize_t (*read_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, void *data, size_t n);
550 ssize_t (*pread_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, void *data, size_t n, off_t offset);
551 struct tevent_req *(*pread_send_fn)(struct vfs_handle_struct *handle,
553 struct tevent_context *ev,
554 struct files_struct *fsp,
556 size_t n, off_t offset);
557 ssize_t (*pread_recv_fn)(struct tevent_req *req, int *err);
558 ssize_t (*write_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, const void *data, size_t n);
559 ssize_t (*pwrite_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, const void *data, size_t n, off_t offset);
560 struct tevent_req *(*pwrite_send_fn)(struct vfs_handle_struct *handle,
562 struct tevent_context *ev,
563 struct files_struct *fsp,
565 size_t n, off_t offset);
566 ssize_t (*pwrite_recv_fn)(struct tevent_req *req, int *err);
567 off_t (*lseek_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, off_t offset, int whence);
568 ssize_t (*sendfile_fn)(struct vfs_handle_struct *handle, int tofd, files_struct *fromfsp, const DATA_BLOB *header, off_t offset, size_t count);
569 ssize_t (*recvfile_fn)(struct vfs_handle_struct *handle, int fromfd, files_struct *tofsp, off_t offset, size_t count);
570 int (*rename_fn)(struct vfs_handle_struct *handle,
571 const struct smb_filename *smb_fname_src,
572 const struct smb_filename *smb_fname_dst);
573 int (*fsync_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp);
574 struct tevent_req *(*fsync_send_fn)(struct vfs_handle_struct *handle,
576 struct tevent_context *ev,
577 struct files_struct *fsp);
578 int (*fsync_recv_fn)(struct tevent_req *req, int *err);
579 int (*stat_fn)(struct vfs_handle_struct *handle, struct smb_filename *smb_fname);
580 int (*fstat_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, SMB_STRUCT_STAT *sbuf);
581 int (*lstat_fn)(struct vfs_handle_struct *handle, struct smb_filename *smb_filename);
582 uint64_t (*get_alloc_size_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, const SMB_STRUCT_STAT *sbuf);
583 int (*unlink_fn)(struct vfs_handle_struct *handle,
584 const struct smb_filename *smb_fname);
585 int (*chmod_fn)(struct vfs_handle_struct *handle, const char *path, mode_t mode);
586 int (*fchmod_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, mode_t mode);
587 int (*chown_fn)(struct vfs_handle_struct *handle, const char *path, uid_t uid, gid_t gid);
588 int (*fchown_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, uid_t uid, gid_t gid);
589 int (*lchown_fn)(struct vfs_handle_struct *handle, const char *path, uid_t uid, gid_t gid);
590 int (*chdir_fn)(struct vfs_handle_struct *handle, const char *path);
591 char *(*getwd_fn)(struct vfs_handle_struct *handle);
592 int (*ntimes_fn)(struct vfs_handle_struct *handle,
593 const struct smb_filename *smb_fname,
594 struct smb_file_time *ft);
595 int (*ftruncate_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, off_t offset);
596 int (*fallocate_fn)(struct vfs_handle_struct *handle,
597 struct files_struct *fsp,
598 enum vfs_fallocate_mode mode,
601 bool (*lock_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, int op, off_t offset, off_t count, int type);
602 int (*kernel_flock_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp,
603 uint32 share_mode, uint32_t access_mask);
604 int (*linux_setlease_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, int leasetype);
605 bool (*getlock_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, off_t *poffset, off_t *pcount, int *ptype, pid_t *ppid);
606 int (*symlink_fn)(struct vfs_handle_struct *handle, const char *oldpath, const char *newpath);
607 int (*readlink_fn)(struct vfs_handle_struct *handle, const char *path, char *buf, size_t bufsiz);
608 int (*link_fn)(struct vfs_handle_struct *handle, const char *oldpath, const char *newpath);
609 int (*mknod_fn)(struct vfs_handle_struct *handle, const char *path, mode_t mode, SMB_DEV_T dev);
610 char *(*realpath_fn)(struct vfs_handle_struct *handle, const char *path);
611 NTSTATUS (*notify_watch_fn)(struct vfs_handle_struct *handle,
612 struct sys_notify_context *ctx,
615 uint32_t *subdir_filter,
616 void (*callback)(struct sys_notify_context *ctx,
618 struct notify_event *ev),
621 int (*chflags_fn)(struct vfs_handle_struct *handle, const char *path, unsigned int flags);
622 struct file_id (*file_id_create_fn)(struct vfs_handle_struct *handle,
623 const SMB_STRUCT_STAT *sbuf);
624 struct tevent_req *(*copy_chunk_send_fn)(struct vfs_handle_struct *handle,
626 struct tevent_context *ev,
627 struct files_struct *src_fsp,
629 struct files_struct *dest_fsp,
632 NTSTATUS (*copy_chunk_recv_fn)(struct vfs_handle_struct *handle,
633 struct tevent_req *req,
635 NTSTATUS (*get_compression_fn)(struct vfs_handle_struct *handle,
637 struct files_struct *fsp,
638 struct smb_filename *smb_fname,
639 uint16_t *_compression_fmt);
640 NTSTATUS (*set_compression_fn)(struct vfs_handle_struct *handle,
642 struct files_struct *fsp,
643 uint16_t compression_fmt);
645 NTSTATUS (*streaminfo_fn)(struct vfs_handle_struct *handle,
646 struct files_struct *fsp,
649 unsigned int *num_streams,
650 struct stream_struct **streams);
652 int (*get_real_filename_fn)(struct vfs_handle_struct *handle,
658 const char *(*connectpath_fn)(struct vfs_handle_struct *handle,
659 const char *filename);
661 NTSTATUS (*brl_lock_windows_fn)(struct vfs_handle_struct *handle,
662 struct byte_range_lock *br_lck,
663 struct lock_struct *plock,
666 bool (*brl_unlock_windows_fn)(struct vfs_handle_struct *handle,
667 struct messaging_context *msg_ctx,
668 struct byte_range_lock *br_lck,
669 const struct lock_struct *plock);
671 bool (*brl_cancel_windows_fn)(struct vfs_handle_struct *handle,
672 struct byte_range_lock *br_lck,
673 struct lock_struct *plock);
675 bool (*strict_lock_fn)(struct vfs_handle_struct *handle,
676 struct files_struct *fsp,
677 struct lock_struct *plock);
679 void (*strict_unlock_fn)(struct vfs_handle_struct *handle,
680 struct files_struct *fsp,
681 struct lock_struct *plock);
683 NTSTATUS (*translate_name_fn)(struct vfs_handle_struct *handle,
685 enum vfs_translate_direction direction,
689 NTSTATUS (*fsctl_fn)(struct vfs_handle_struct *handle,
690 struct files_struct *fsp,
694 const uint8_t *_in_data,
697 uint32_t max_out_len,
700 /* NT ACL operations. */
702 NTSTATUS (*fget_nt_acl_fn)(struct vfs_handle_struct *handle,
703 struct files_struct *fsp,
704 uint32 security_info,
706 struct security_descriptor **ppdesc);
707 NTSTATUS (*get_nt_acl_fn)(struct vfs_handle_struct *handle,
709 uint32 security_info,
711 struct security_descriptor **ppdesc);
712 NTSTATUS (*fset_nt_acl_fn)(struct vfs_handle_struct *handle,
713 struct files_struct *fsp,
714 uint32 security_info_sent,
715 const struct security_descriptor *psd);
717 NTSTATUS (*audit_file_fn)(struct vfs_handle_struct *handle,
718 struct smb_filename *file,
719 struct security_acl *sacl,
720 uint32_t access_requested,
721 uint32_t access_denied);
723 /* POSIX ACL operations. */
725 int (*chmod_acl_fn)(struct vfs_handle_struct *handle, const char *name, mode_t mode);
726 int (*fchmod_acl_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, mode_t mode);
728 SMB_ACL_T (*sys_acl_get_file_fn)(struct vfs_handle_struct *handle,
731 TALLOC_CTX *mem_ctx);
732 SMB_ACL_T (*sys_acl_get_fd_fn)(struct vfs_handle_struct *handle,
733 struct files_struct *fsp,
734 TALLOC_CTX *mem_ctx);
735 int (*sys_acl_blob_get_file_fn)(struct vfs_handle_struct *handle,
738 char **blob_description,
740 int (*sys_acl_blob_get_fd_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp,
741 TALLOC_CTX *mem_ctx, char **blob_description,
743 int (*sys_acl_set_file_fn)(struct vfs_handle_struct *handle, const char *name, SMB_ACL_TYPE_T acltype, SMB_ACL_T theacl);
744 int (*sys_acl_set_fd_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, SMB_ACL_T theacl);
745 int (*sys_acl_delete_def_file_fn)(struct vfs_handle_struct *handle, const char *path);
748 ssize_t (*getxattr_fn)(struct vfs_handle_struct *handle,const char *path, const char *name, void *value, size_t size);
749 ssize_t (*fgetxattr_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, const char *name, void *value, size_t size);
750 ssize_t (*listxattr_fn)(struct vfs_handle_struct *handle, const char *path, char *list, size_t size);
751 ssize_t (*flistxattr_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, char *list, size_t size);
752 int (*removexattr_fn)(struct vfs_handle_struct *handle, const char *path, const char *name);
753 int (*fremovexattr_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, const char *name);
754 int (*setxattr_fn)(struct vfs_handle_struct *handle, const char *path, const char *name, const void *value, size_t size, int flags);
755 int (*fsetxattr_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp, const char *name, const void *value, size_t size, int flags);
758 bool (*aio_force_fn)(struct vfs_handle_struct *handle, struct files_struct *fsp);
760 /* offline operations */
761 bool (*is_offline_fn)(struct vfs_handle_struct *handle,
762 const struct smb_filename *fname,
763 SMB_STRUCT_STAT *sbuf);
764 int (*set_offline_fn)(struct vfs_handle_struct *handle,
765 const struct smb_filename *fname);
767 /* durable handle operations */
768 NTSTATUS (*durable_cookie_fn)(struct vfs_handle_struct *handle,
769 struct files_struct *fsp,
772 NTSTATUS (*durable_disconnect_fn)(struct vfs_handle_struct *handle,
773 struct files_struct *fsp,
774 const DATA_BLOB old_cookie,
776 DATA_BLOB *new_cookie);
777 NTSTATUS (*durable_reconnect_fn)(struct vfs_handle_struct *handle,
778 struct smb_request *smb1req,
779 struct smbXsrv_open *op,
780 const DATA_BLOB old_cookie,
782 struct files_struct **fsp,
783 DATA_BLOB *new_cookie);
787 VFS operation description. Each VFS module registers an array of vfs_op_tuple to VFS subsystem,
788 which describes all operations this module is willing to intercept.
789 VFS subsystem initializes then the conn->vfs_ops and conn->vfs_opaque_ops structs
790 using this information.
793 typedef struct vfs_handle_struct {
794 struct vfs_handle_struct *next, *prev;
796 struct connection_struct *conn;
797 const struct vfs_fn_pointers *fns;
799 void (*free_data)(void **data);
803 typedef struct vfs_statvfs_struct {
804 /* For undefined recommended transfer size return -1 in that field */
805 uint32 OptimalTransferSize; /* bsize on some os, iosize on other os */
809 The next three fields are in terms of the block size.
810 (above). If block size is unknown, 4096 would be a
811 reasonable block size for a server to report.
812 Note that returning the blocks/blocksavail removes need
813 to make a second call (to QFSInfo level 0x103 to get this info.
814 UserBlockAvail is typically less than or equal to BlocksAvail,
815 if no distinction is made return the same value in each.
818 uint64_t TotalBlocks;
819 uint64_t BlocksAvail; /* bfree */
820 uint64_t UserBlocksAvail; /* bavail */
822 /* For undefined Node fields or FSID return -1 */
823 uint64_t TotalFileNodes;
824 uint64_t FreeFileNodes;
825 uint64_t FsIdentifier; /* fsid */
826 /* NB Namelen comes from FILE_SYSTEM_ATTRIBUTE_INFO call */
827 /* NB flags can come from FILE_SYSTEM_DEVICE_INFO call */
830 } vfs_statvfs_struct;
832 /* Add a new FSP extension of the given type. Returns a pointer to the
835 #define VFS_ADD_FSP_EXTENSION(handle, fsp, type, destroy_fn) \
836 vfs_add_fsp_extension_notype(handle, (fsp), sizeof(type), (destroy_fn))
838 /* Return a pointer to the existing FSP extension data. */
839 #define VFS_FETCH_FSP_EXTENSION(handle, fsp) \
840 vfs_fetch_fsp_extension(handle, (fsp))
842 /* Return the talloc context associated with an FSP extension. */
843 #define VFS_MEMCTX_FSP_EXTENSION(handle, fsp) \
844 vfs_memctx_fsp_extension(handle, (fsp))
846 /* Remove and destroy an FSP extension. */
847 #define VFS_REMOVE_FSP_EXTENSION(handle, fsp) \
848 vfs_remove_fsp_extension((handle), (fsp))
850 #define SMB_VFS_HANDLE_GET_DATA(handle, datap, type, ret) { \
851 if (!(handle)||((datap=(type *)(handle)->data)==NULL)) { \
852 DEBUG(0,("%s() failed to get vfs_handle->data!\n",__FUNCTION__)); \
857 #define SMB_VFS_HANDLE_SET_DATA(handle, datap, free_fn, type, ret) { \
859 DEBUG(0,("%s() failed to set handle->data!\n",__FUNCTION__)); \
862 if ((handle)->free_data) { \
863 (handle)->free_data(&(handle)->data); \
865 (handle)->data = (void *)datap; \
866 (handle)->free_data = free_fn; \
870 #define SMB_VFS_HANDLE_FREE_DATA(handle) { \
871 if ((handle) && (handle)->free_data) { \
872 (handle)->free_data(&(handle)->data); \
876 /* Check whether module-specific data handle was already allocated or not */
877 #define SMB_VFS_HANDLE_TEST_DATA(handle) ( !(handle) || !(handle)->data ? False : True )
879 #define SMB_VFS_OP(x) ((void *) x)
881 #define DEFAULT_VFS_MODULE_NAME "/[Default VFS]/"
883 #include "vfs_macros.h"
885 int smb_vfs_call_connect(struct vfs_handle_struct *handle,
886 const char *service, const char *user);
887 void smb_vfs_call_disconnect(struct vfs_handle_struct *handle);
888 uint64_t smb_vfs_call_disk_free(struct vfs_handle_struct *handle,
889 const char *path, bool small_query,
890 uint64_t *bsize, uint64_t *dfree,
892 int smb_vfs_call_get_quota(struct vfs_handle_struct *handle,
893 enum SMB_QUOTA_TYPE qtype, unid_t id,
895 int smb_vfs_call_set_quota(struct vfs_handle_struct *handle,
896 enum SMB_QUOTA_TYPE qtype, unid_t id,
898 int smb_vfs_call_get_shadow_copy_data(struct vfs_handle_struct *handle,
899 struct files_struct *fsp,
900 struct shadow_copy_data *shadow_copy_data,
902 int smb_vfs_call_statvfs(struct vfs_handle_struct *handle, const char *path,
903 struct vfs_statvfs_struct *statbuf);
904 uint32_t smb_vfs_call_fs_capabilities(struct vfs_handle_struct *handle,
905 enum timestamp_set_resolution *p_ts_res);
907 * Note: that "struct dfs_GetDFSReferral *r" needs to be a valid TALLOC_CTX
909 NTSTATUS smb_vfs_call_get_dfs_referrals(struct vfs_handle_struct *handle,
910 struct dfs_GetDFSReferral *r);
911 DIR *smb_vfs_call_opendir(struct vfs_handle_struct *handle,
912 const char *fname, const char *mask,
914 DIR *smb_vfs_call_fdopendir(struct vfs_handle_struct *handle,
915 struct files_struct *fsp,
918 struct dirent *smb_vfs_call_readdir(struct vfs_handle_struct *handle,
920 SMB_STRUCT_STAT *sbuf);
921 void smb_vfs_call_seekdir(struct vfs_handle_struct *handle,
922 DIR *dirp, long offset);
923 long smb_vfs_call_telldir(struct vfs_handle_struct *handle,
925 void smb_vfs_call_rewind_dir(struct vfs_handle_struct *handle,
927 int smb_vfs_call_mkdir(struct vfs_handle_struct *handle, const char *path,
929 int smb_vfs_call_rmdir(struct vfs_handle_struct *handle, const char *path);
930 int smb_vfs_call_closedir(struct vfs_handle_struct *handle,
932 void smb_vfs_call_init_search_op(struct vfs_handle_struct *handle,
934 int smb_vfs_call_open(struct vfs_handle_struct *handle,
935 struct smb_filename *smb_fname, struct files_struct *fsp,
936 int flags, mode_t mode);
937 NTSTATUS smb_vfs_call_create_file(struct vfs_handle_struct *handle,
938 struct smb_request *req,
939 uint16_t root_dir_fid,
940 struct smb_filename *smb_fname,
941 uint32_t access_mask,
942 uint32_t share_access,
943 uint32_t create_disposition,
944 uint32_t create_options,
945 uint32_t file_attributes,
946 uint32_t oplock_request,
947 struct smb2_lease *lease,
948 uint64_t allocation_size,
949 uint32_t private_flags,
950 struct security_descriptor *sd,
951 struct ea_list *ea_list,
952 files_struct **result,
954 int smb_vfs_call_close(struct vfs_handle_struct *handle,
955 struct files_struct *fsp);
956 ssize_t smb_vfs_call_read(struct vfs_handle_struct *handle,
957 struct files_struct *fsp, void *data, size_t n);
958 ssize_t smb_vfs_call_pread(struct vfs_handle_struct *handle,
959 struct files_struct *fsp, void *data, size_t n,
961 struct tevent_req *smb_vfs_call_pread_send(struct vfs_handle_struct *handle,
963 struct tevent_context *ev,
964 struct files_struct *fsp,
966 size_t n, off_t offset);
967 ssize_t SMB_VFS_PREAD_RECV(struct tevent_req *req, int *perrno);
969 ssize_t smb_vfs_call_write(struct vfs_handle_struct *handle,
970 struct files_struct *fsp, const void *data,
972 ssize_t smb_vfs_call_pwrite(struct vfs_handle_struct *handle,
973 struct files_struct *fsp, const void *data,
974 size_t n, off_t offset);
975 struct tevent_req *smb_vfs_call_pwrite_send(struct vfs_handle_struct *handle,
977 struct tevent_context *ev,
978 struct files_struct *fsp,
980 size_t n, off_t offset);
981 ssize_t SMB_VFS_PWRITE_RECV(struct tevent_req *req, int *perrno);
983 off_t smb_vfs_call_lseek(struct vfs_handle_struct *handle,
984 struct files_struct *fsp, off_t offset,
986 ssize_t smb_vfs_call_sendfile(struct vfs_handle_struct *handle, int tofd,
987 files_struct *fromfsp, const DATA_BLOB *header,
988 off_t offset, size_t count);
989 ssize_t smb_vfs_call_recvfile(struct vfs_handle_struct *handle, int fromfd,
990 files_struct *tofsp, off_t offset,
992 int smb_vfs_call_rename(struct vfs_handle_struct *handle,
993 const struct smb_filename *smb_fname_src,
994 const struct smb_filename *smb_fname_dst);
995 int smb_vfs_call_fsync(struct vfs_handle_struct *handle,
996 struct files_struct *fsp);
998 struct tevent_req *smb_vfs_call_fsync_send(struct vfs_handle_struct *handle,
1000 struct tevent_context *ev,
1001 struct files_struct *fsp);
1002 int SMB_VFS_FSYNC_RECV(struct tevent_req *req, int *perrno);
1004 int smb_vfs_call_stat(struct vfs_handle_struct *handle,
1005 struct smb_filename *smb_fname);
1006 int smb_vfs_call_fstat(struct vfs_handle_struct *handle,
1007 struct files_struct *fsp, SMB_STRUCT_STAT *sbuf);
1008 int smb_vfs_call_lstat(struct vfs_handle_struct *handle,
1009 struct smb_filename *smb_filename);
1010 uint64_t smb_vfs_call_get_alloc_size(struct vfs_handle_struct *handle,
1011 struct files_struct *fsp,
1012 const SMB_STRUCT_STAT *sbuf);
1013 int smb_vfs_call_unlink(struct vfs_handle_struct *handle,
1014 const struct smb_filename *smb_fname);
1015 int smb_vfs_call_chmod(struct vfs_handle_struct *handle, const char *path,
1017 int smb_vfs_call_fchmod(struct vfs_handle_struct *handle,
1018 struct files_struct *fsp, mode_t mode);
1019 int smb_vfs_call_chown(struct vfs_handle_struct *handle, const char *path,
1020 uid_t uid, gid_t gid);
1021 int smb_vfs_call_fchown(struct vfs_handle_struct *handle,
1022 struct files_struct *fsp, uid_t uid, gid_t gid);
1023 int smb_vfs_call_lchown(struct vfs_handle_struct *handle, const char *path,
1024 uid_t uid, gid_t gid);
1025 int smb_vfs_call_chdir(struct vfs_handle_struct *handle, const char *path);
1026 char *smb_vfs_call_getwd(struct vfs_handle_struct *handle);
1027 int smb_vfs_call_ntimes(struct vfs_handle_struct *handle,
1028 const struct smb_filename *smb_fname,
1029 struct smb_file_time *ft);
1030 int smb_vfs_call_ftruncate(struct vfs_handle_struct *handle,
1031 struct files_struct *fsp, off_t offset);
1032 int smb_vfs_call_fallocate(struct vfs_handle_struct *handle,
1033 struct files_struct *fsp,
1034 enum vfs_fallocate_mode mode,
1037 bool smb_vfs_call_lock(struct vfs_handle_struct *handle,
1038 struct files_struct *fsp, int op, off_t offset,
1039 off_t count, int type);
1040 int smb_vfs_call_kernel_flock(struct vfs_handle_struct *handle,
1041 struct files_struct *fsp, uint32 share_mode,
1042 uint32_t access_mask);
1043 int smb_vfs_call_linux_setlease(struct vfs_handle_struct *handle,
1044 struct files_struct *fsp, int leasetype);
1045 bool smb_vfs_call_getlock(struct vfs_handle_struct *handle,
1046 struct files_struct *fsp, off_t *poffset,
1047 off_t *pcount, int *ptype, pid_t *ppid);
1048 int smb_vfs_call_symlink(struct vfs_handle_struct *handle, const char *oldpath,
1049 const char *newpath);
1050 int smb_vfs_call_readlink(struct vfs_handle_struct *handle,
1051 const char *path, char *buf, size_t bufsiz);
1052 int smb_vfs_call_link(struct vfs_handle_struct *handle, const char *oldpath,
1053 const char *newpath);
1054 int smb_vfs_call_mknod(struct vfs_handle_struct *handle, const char *path,
1055 mode_t mode, SMB_DEV_T dev);
1056 char *smb_vfs_call_realpath(struct vfs_handle_struct *handle, const char *path);
1057 NTSTATUS smb_vfs_call_notify_watch(struct vfs_handle_struct *handle,
1058 struct sys_notify_context *ctx,
1061 uint32_t *subdir_filter,
1062 void (*callback)(struct sys_notify_context *ctx,
1064 struct notify_event *ev),
1065 void *private_data, void *handle_p);
1066 int smb_vfs_call_chflags(struct vfs_handle_struct *handle, const char *path,
1067 unsigned int flags);
1068 struct file_id smb_vfs_call_file_id_create(struct vfs_handle_struct *handle,
1069 const SMB_STRUCT_STAT *sbuf);
1070 NTSTATUS smb_vfs_call_streaminfo(struct vfs_handle_struct *handle,
1071 struct files_struct *fsp,
1073 TALLOC_CTX *mem_ctx,
1074 unsigned int *num_streams,
1075 struct stream_struct **streams);
1076 int smb_vfs_call_get_real_filename(struct vfs_handle_struct *handle,
1077 const char *path, const char *name,
1078 TALLOC_CTX *mem_ctx, char **found_name);
1079 const char *smb_vfs_call_connectpath(struct vfs_handle_struct *handle,
1080 const char *filename);
1081 NTSTATUS smb_vfs_call_brl_lock_windows(struct vfs_handle_struct *handle,
1082 struct byte_range_lock *br_lck,
1083 struct lock_struct *plock,
1084 bool blocking_lock);
1085 bool smb_vfs_call_brl_unlock_windows(struct vfs_handle_struct *handle,
1086 struct messaging_context *msg_ctx,
1087 struct byte_range_lock *br_lck,
1088 const struct lock_struct *plock);
1089 bool smb_vfs_call_brl_cancel_windows(struct vfs_handle_struct *handle,
1090 struct byte_range_lock *br_lck,
1091 struct lock_struct *plock);
1092 bool smb_vfs_call_strict_lock(struct vfs_handle_struct *handle,
1093 struct files_struct *fsp,
1094 struct lock_struct *plock);
1095 void smb_vfs_call_strict_unlock(struct vfs_handle_struct *handle,
1096 struct files_struct *fsp,
1097 struct lock_struct *plock);
1098 NTSTATUS smb_vfs_call_translate_name(struct vfs_handle_struct *handle,
1100 enum vfs_translate_direction direction,
1101 TALLOC_CTX *mem_ctx,
1102 char **mapped_name);
1103 NTSTATUS smb_vfs_call_fsctl(struct vfs_handle_struct *handle,
1104 struct files_struct *fsp,
1108 const uint8_t *_in_data,
1110 uint8_t **_out_data,
1111 uint32_t max_out_len,
1113 struct tevent_req *smb_vfs_call_copy_chunk_send(struct vfs_handle_struct *handle,
1114 TALLOC_CTX *mem_ctx,
1115 struct tevent_context *ev,
1116 struct files_struct *src_fsp,
1118 struct files_struct *dest_fsp,
1121 NTSTATUS smb_vfs_call_copy_chunk_recv(struct vfs_handle_struct *handle,
1122 struct tevent_req *req,
1124 NTSTATUS smb_vfs_call_get_compression(struct vfs_handle_struct *handle,
1125 TALLOC_CTX *mem_ctx,
1126 struct files_struct *fsp,
1127 struct smb_filename *smb_fname,
1128 uint16_t *_compression_fmt);
1129 NTSTATUS smb_vfs_call_set_compression(struct vfs_handle_struct *handle,
1130 TALLOC_CTX *mem_ctx,
1131 struct files_struct *fsp,
1132 uint16_t compression_fmt);
1133 NTSTATUS smb_vfs_call_fget_nt_acl(struct vfs_handle_struct *handle,
1134 struct files_struct *fsp,
1135 uint32 security_info,
1136 TALLOC_CTX *mem_ctx,
1137 struct security_descriptor **ppdesc);
1138 NTSTATUS smb_vfs_call_get_nt_acl(struct vfs_handle_struct *handle,
1140 uint32 security_info,
1141 TALLOC_CTX *mem_ctx,
1142 struct security_descriptor **ppdesc);
1143 NTSTATUS smb_vfs_call_fset_nt_acl(struct vfs_handle_struct *handle,
1144 struct files_struct *fsp,
1145 uint32 security_info_sent,
1146 const struct security_descriptor *psd);
1147 NTSTATUS smb_vfs_call_audit_file(struct vfs_handle_struct *handle,
1148 struct smb_filename *file,
1149 struct security_acl *sacl,
1150 uint32_t access_requested,
1151 uint32_t access_denied);
1152 int smb_vfs_call_chmod_acl(struct vfs_handle_struct *handle, const char *name,
1154 int smb_vfs_call_fchmod_acl(struct vfs_handle_struct *handle,
1155 struct files_struct *fsp, mode_t mode);
1156 SMB_ACL_T smb_vfs_call_sys_acl_get_file(struct vfs_handle_struct *handle,
1158 SMB_ACL_TYPE_T type,
1159 TALLOC_CTX *mem_ctx);
1160 SMB_ACL_T smb_vfs_call_sys_acl_get_fd(struct vfs_handle_struct *handle,
1161 struct files_struct *fsp,
1162 TALLOC_CTX *mem_ctx);
1163 int smb_vfs_call_sys_acl_blob_get_file(struct vfs_handle_struct *handle,
1165 TALLOC_CTX *mem_ctx,
1166 char **blob_description,
1168 int smb_vfs_call_sys_acl_blob_get_fd(struct vfs_handle_struct *handle,
1169 struct files_struct *fsp,
1170 TALLOC_CTX *mem_ctx,
1171 char **blob_description,
1173 int smb_vfs_call_sys_acl_set_file(struct vfs_handle_struct *handle,
1174 const char *name, SMB_ACL_TYPE_T acltype,
1176 int smb_vfs_call_sys_acl_set_fd(struct vfs_handle_struct *handle,
1177 struct files_struct *fsp, SMB_ACL_T theacl);
1178 int smb_vfs_call_sys_acl_delete_def_file(struct vfs_handle_struct *handle,
1180 ssize_t smb_vfs_call_getxattr(struct vfs_handle_struct *handle,
1181 const char *path, const char *name, void *value,
1183 ssize_t smb_vfs_call_fgetxattr(struct vfs_handle_struct *handle,
1184 struct files_struct *fsp, const char *name,
1185 void *value, size_t size);
1186 ssize_t smb_vfs_call_listxattr(struct vfs_handle_struct *handle,
1187 const char *path, char *list, size_t size);
1188 ssize_t smb_vfs_call_llistxattr(struct vfs_handle_struct *handle,
1189 const char *path, char *list, size_t size);
1190 ssize_t smb_vfs_call_flistxattr(struct vfs_handle_struct *handle,
1191 struct files_struct *fsp, char *list,
1193 int smb_vfs_call_removexattr(struct vfs_handle_struct *handle,
1194 const char *path, const char *name);
1195 int smb_vfs_call_fremovexattr(struct vfs_handle_struct *handle,
1196 struct files_struct *fsp, const char *name);
1197 int smb_vfs_call_setxattr(struct vfs_handle_struct *handle, const char *path,
1198 const char *name, const void *value, size_t size,
1200 int smb_vfs_call_lsetxattr(struct vfs_handle_struct *handle, const char *path,
1201 const char *name, const void *value, size_t size,
1203 int smb_vfs_call_fsetxattr(struct vfs_handle_struct *handle,
1204 struct files_struct *fsp, const char *name,
1205 const void *value, size_t size, int flags);
1206 bool smb_vfs_call_aio_force(struct vfs_handle_struct *handle,
1207 struct files_struct *fsp);
1208 bool smb_vfs_call_is_offline(struct vfs_handle_struct *handle,
1209 const struct smb_filename *fname,
1210 SMB_STRUCT_STAT *sbuf);
1211 int smb_vfs_call_set_offline(struct vfs_handle_struct *handle,
1212 const struct smb_filename *fname);
1213 NTSTATUS smb_vfs_call_durable_cookie(struct vfs_handle_struct *handle,
1214 struct files_struct *fsp,
1215 TALLOC_CTX *mem_ctx,
1217 NTSTATUS smb_vfs_call_durable_disconnect(struct vfs_handle_struct *handle,
1218 struct files_struct *fsp,
1219 const DATA_BLOB old_cookie,
1220 TALLOC_CTX *mem_ctx,
1221 DATA_BLOB *new_cookie);
1222 NTSTATUS smb_vfs_call_durable_reconnect(struct vfs_handle_struct *handle,
1223 struct smb_request *smb1req,
1224 struct smbXsrv_open *op,
1225 const DATA_BLOB old_cookie,
1226 TALLOC_CTX *mem_ctx,
1227 struct files_struct **fsp,
1228 DATA_BLOB *new_cookie);
1230 NTSTATUS smb_register_vfs(int version, const char *name,
1231 const struct vfs_fn_pointers *fns);
1232 void *vfs_add_fsp_extension_notype(vfs_handle_struct *handle,
1233 files_struct *fsp, size_t ext_size,
1234 void (*destroy_fn)(void *p_data));
1235 void vfs_remove_fsp_extension(vfs_handle_struct *handle, files_struct *fsp);
1236 void vfs_remove_all_fsp_extensions(struct files_struct *fsp);
1237 void *vfs_memctx_fsp_extension(vfs_handle_struct *handle, files_struct *fsp);
1238 void *vfs_fetch_fsp_extension(vfs_handle_struct *handle, files_struct *fsp);