shadow_copy2: add comment header describing shadow_copy2_strip_snapshot()
[Samba.git] / source3 / modules / vfs_shadow_copy2.c
blob8bbb7b824c29f125fb01b674b818790c95145011
1 /*
2 * Third attempt at a shadow copy module
4 * Copyright (C) Andrew Tridgell 2007 (portions taken from shadow_copy2)
5 * Copyright (C) Ed Plese 2009
6 * Copyright (C) Volker Lendecke 2011
7 * Copyright (C) Christian Ambach 2011
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 This is a 3rd implemetation of a shadow copy module for exposing
27 snapshots to windows clients as shadow copies. This version has the
28 following features:
30 1) you don't need to populate your shares with symlinks to the
31 snapshots. This can be very important when you have thousands of
32 shares, or use [homes]
34 2) the inode number of the files is altered so it is different
35 from the original. This allows the 'restore' button to work
36 without a sharing violation
38 3) shadow copy results can be sorted before being sent to the
39 client. This is beneficial for filesystems that don't read
40 directories alphabetically (the default unix).
42 4) vanity naming for snapshots. Snapshots can be named in any
43 format compatible with str[fp]time conversions.
45 5) time stamps in snapshot names can be represented in localtime
46 rather than UTC.
48 Module options:
50 shadow:snapdir = <directory where snapshots are kept>
52 This is the directory containing the @GMT-* snapshot directories. If it is an absolute
53 path it is used as-is. If it is a relative path, then it is taken relative to the mount
54 point of the filesystem that the root of this share is on
56 shadow:basedir = <base directory that snapshots are from>
58 This is an optional parameter that specifies the directory that
59 the snapshots are relative to. It defaults to the filesystem
60 mount point
62 shadow:fixinodes = yes/no
64 If you enable shadow:fixinodes then this module will modify the
65 apparent inode number of files in the snapshot directories using
66 a hash of the files path. This is needed for snapshot systems
67 where the snapshots have the same device:inode number as the
68 original files (such as happens with GPFS snapshots). If you
69 don't set this option then the 'restore' button in the shadow
70 copy UI will fail with a sharing violation.
72 shadow:sort = asc/desc, or not specified for unsorted (default)
74 This is an optional parameter that specifies that the shadow
75 copy directories should be sorted before sending them to the
76 client. This can be beneficial as unix filesystems are usually
77 not listed alphabetically sorted. If enabled, you typically
78 want to specify descending order.
80 shadow:format = <format specification for snapshot names>
82 This is an optional parameter that specifies the format
83 specification for the naming of snapshots. The format must
84 be compatible with the conversion specifications recognized
85 by str[fp]time. The default value is "@GMT-%Y.%m.%d-%H.%M.%S".
87 shadow:sscanf = yes/no (default is no)
89 The time is the unsigned long integer (%lu) in the format string
90 rather than a time strptime() can parse. The result must be a unix time_t
91 time.
93 shadow:localtime = yes/no (default is no)
95 This is an optional parameter that indicates whether the
96 snapshot names are in UTC/GMT or the local time.
99 The following command would generate a correctly formatted directory name
100 for use with the default parameters:
101 date -u +@GMT-%Y.%m.%d-%H.%M.%S
104 #include "includes.h"
105 #include "system/filesys.h"
106 #include "include/ntioctl.h"
107 #include <ccan/hash/hash.h>
108 #include "util_tdb.h"
110 static bool shadow_copy2_find_slashes(TALLOC_CTX *mem_ctx, const char *str,
111 size_t **poffsets,
112 unsigned *pnum_offsets)
114 unsigned num_offsets;
115 size_t *offsets;
116 const char *p;
118 num_offsets = 0;
120 p = str;
121 while ((p = strchr(p, '/')) != NULL) {
122 num_offsets += 1;
123 p += 1;
126 offsets = talloc_array(mem_ctx, size_t, num_offsets);
127 if (offsets == NULL) {
128 return false;
131 p = str;
132 num_offsets = 0;
133 while ((p = strchr(p, '/')) != NULL) {
134 offsets[num_offsets] = p-str;
135 num_offsets += 1;
136 p += 1;
139 *poffsets = offsets;
140 *pnum_offsets = num_offsets;
141 return true;
144 static char *shadow_copy2_insert_string(TALLOC_CTX *mem_ctx,
145 struct vfs_handle_struct *handle,
146 time_t snapshot)
148 const char *fmt;
149 struct tm snap_tm;
150 fstring snaptime_string;
151 size_t snaptime_len;
153 fmt = lp_parm_const_string(SNUM(handle->conn), "shadow",
154 "format", GMT_FORMAT);
156 if (lp_parm_bool(SNUM(handle->conn), "shadow", "sscanf", false)) {
157 snaptime_len = snprintf(snaptime_string, sizeof(snaptime_string), fmt,
158 (unsigned long)snapshot);
159 if (snaptime_len <= 0) {
160 DEBUG(10, ("snprintf failed\n"));
161 return NULL;
163 } else {
164 if (lp_parm_bool(SNUM(handle->conn), "shadow", "localtime", false)) {
165 if (localtime_r(&snapshot, &snap_tm) == 0) {
166 DEBUG(10, ("gmtime_r failed\n"));
167 return NULL;
169 } else {
170 if (gmtime_r(&snapshot, &snap_tm) == 0) {
171 DEBUG(10, ("gmtime_r failed\n"));
172 return NULL;
175 snaptime_len = strftime(snaptime_string, sizeof(snaptime_string), fmt,
176 &snap_tm);
177 if (snaptime_len == 0) {
178 DEBUG(10, ("strftime failed\n"));
179 return NULL;
182 return talloc_asprintf(mem_ctx, "/%s/%s",
183 lp_parm_const_string(
184 SNUM(handle->conn), "shadow", "snapdir",
185 ".snapshots"),
186 snaptime_string);
190 * Strip a snapshot component from an filename as
191 * handed in via the smb layer.
192 * Returns the parsed timestamp and the stripped filename.
194 static bool shadow_copy2_strip_snapshot(TALLOC_CTX *mem_ctx,
195 struct vfs_handle_struct *handle,
196 const char *name,
197 time_t *ptimestamp,
198 char **pstripped)
200 struct tm tm;
201 time_t timestamp;
202 const char *p;
203 char *q;
204 char *stripped;
205 size_t rest_len, dst_len;
207 p = strstr_m(name, "@GMT-");
208 if (p == NULL) {
209 goto no_snapshot;
211 if ((p > name) && (p[-1] != '/')) {
212 goto no_snapshot;
214 q = strptime(p, GMT_FORMAT, &tm);
215 if (q == NULL) {
216 goto no_snapshot;
218 tm.tm_isdst = -1;
219 timestamp = timegm(&tm);
220 if (timestamp == (time_t)-1) {
221 goto no_snapshot;
223 if ((p == name) && (q[0] == '\0')) {
224 if (pstripped != NULL) {
225 stripped = talloc_strdup(mem_ctx, "");
226 if (stripped == NULL) {
227 return false;
229 *pstripped = stripped;
231 *ptimestamp = timestamp;
232 return true;
234 if (q[0] != '/') {
235 goto no_snapshot;
237 q += 1;
239 rest_len = strlen(q);
240 dst_len = (p-name) + rest_len;
242 if (lp_parm_bool(SNUM(handle->conn), "shadow", "snapdirseverywhere",
243 false)) {
244 char *insert;
245 bool have_insert;
246 insert = shadow_copy2_insert_string(talloc_tos(), handle,
247 timestamp);
248 if (insert == NULL) {
249 errno = ENOMEM;
250 return false;
253 have_insert = (strstr(name, insert+1) != NULL);
254 TALLOC_FREE(insert);
255 if (have_insert) {
256 goto no_snapshot;
260 if (pstripped != NULL) {
261 stripped = talloc_array(mem_ctx, char, dst_len+1);
262 if (stripped == NULL) {
263 errno = ENOMEM;
264 return false;
266 if (p > name) {
267 memcpy(stripped, name, p-name);
269 if (rest_len > 0) {
270 memcpy(stripped + (p-name), q, rest_len);
272 stripped[dst_len] = '\0';
273 *pstripped = stripped;
275 *ptimestamp = timestamp;
276 return true;
277 no_snapshot:
278 *ptimestamp = 0;
279 return true;
282 static char *shadow_copy2_find_mount_point(TALLOC_CTX *mem_ctx,
283 vfs_handle_struct *handle)
285 char *path = talloc_strdup(mem_ctx, handle->conn->connectpath);
286 dev_t dev;
287 struct stat st;
288 char *p;
290 if (stat(path, &st) != 0) {
291 talloc_free(path);
292 return NULL;
295 dev = st.st_dev;
297 while ((p = strrchr(path, '/')) && p > path) {
298 *p = 0;
299 if (stat(path, &st) != 0) {
300 talloc_free(path);
301 return NULL;
303 if (st.st_dev != dev) {
304 *p = '/';
305 break;
309 return path;
312 static char *shadow_copy2_convert(TALLOC_CTX *mem_ctx,
313 struct vfs_handle_struct *handle,
314 const char *name, time_t timestamp)
316 struct smb_filename converted_fname;
317 char *result = NULL;
318 size_t *slashes = NULL;
319 unsigned num_slashes;
320 char *path = NULL;
321 size_t pathlen;
322 char *insert = NULL;
323 char *converted = NULL;
324 size_t insertlen;
325 int i, saved_errno;
326 size_t min_offset;
328 path = talloc_asprintf(mem_ctx, "%s/%s", handle->conn->connectpath,
329 name);
330 if (path == NULL) {
331 errno = ENOMEM;
332 goto fail;
334 pathlen = talloc_get_size(path)-1;
336 DEBUG(10, ("converting %s\n", path));
338 if (!shadow_copy2_find_slashes(talloc_tos(), path,
339 &slashes, &num_slashes)) {
340 goto fail;
342 insert = shadow_copy2_insert_string(talloc_tos(), handle, timestamp);
343 if (insert == NULL) {
344 goto fail;
346 insertlen = talloc_get_size(insert)-1;
347 converted = talloc_array(mem_ctx, char, pathlen + insertlen + 1);
348 if (converted == NULL) {
349 goto fail;
352 if (path[pathlen-1] != '/') {
354 * Append a fake slash to find the snapshot root
356 size_t *tmp;
357 tmp = talloc_realloc(talloc_tos(), slashes,
358 size_t, num_slashes+1);
359 if (tmp == NULL) {
360 goto fail;
362 slashes = tmp;
363 slashes[num_slashes] = pathlen;
364 num_slashes += 1;
367 min_offset = 0;
369 if (!lp_parm_bool(SNUM(handle->conn), "shadow", "crossmountpoints",
370 false)) {
371 char *mount_point;
373 mount_point = shadow_copy2_find_mount_point(talloc_tos(),
374 handle);
375 if (mount_point == NULL) {
376 goto fail;
378 min_offset = strlen(mount_point);
379 TALLOC_FREE(mount_point);
382 memcpy(converted, path, pathlen+1);
383 converted[pathlen+insertlen] = '\0';
385 ZERO_STRUCT(converted_fname);
386 converted_fname.base_name = converted;
388 for (i = num_slashes-1; i>=0; i--) {
389 int ret;
390 size_t offset;
392 offset = slashes[i];
394 if (offset < min_offset) {
395 errno = ENOENT;
396 goto fail;
399 memcpy(converted+offset, insert, insertlen);
401 offset += insertlen;
402 memcpy(converted+offset, path + slashes[i],
403 pathlen - slashes[i]);
405 ret = SMB_VFS_NEXT_LSTAT(handle, &converted_fname);
407 DEBUG(10, ("Trying %s: %d (%s)\n", converted,
408 ret, ret == 0 ? "ok" : strerror(errno)));
409 if (ret == 0) {
410 /* success */
411 break;
413 if (errno == ENOTDIR) {
415 * This is a valid condition: We appended the
416 * .snaphots/@GMT.. to a file name. Just try
417 * with the upper levels.
419 continue;
421 if (errno != ENOENT) {
422 /* Other problem than "not found" */
423 goto fail;
427 if (i >= 0) {
429 * Found something
431 DEBUG(10, ("Found %s\n", converted));
432 result = converted;
433 converted = NULL;
434 } else {
435 errno = ENOENT;
437 fail:
438 saved_errno = errno;
439 TALLOC_FREE(converted);
440 TALLOC_FREE(insert);
441 TALLOC_FREE(slashes);
442 TALLOC_FREE(path);
443 errno = saved_errno;
444 return result;
448 modify a sbuf return to ensure that inodes in the shadow directory
449 are different from those in the main directory
451 static void convert_sbuf(vfs_handle_struct *handle, const char *fname,
452 SMB_STRUCT_STAT *sbuf)
454 if (lp_parm_bool(SNUM(handle->conn), "shadow", "fixinodes", False)) {
455 /* some snapshot systems, like GPFS, return the name
456 device:inode for the snapshot files as the current
457 files. That breaks the 'restore' button in the shadow copy
458 GUI, as the client gets a sharing violation.
460 This is a crude way of allowing both files to be
461 open at once. It has a slight chance of inode
462 number collision, but I can't see a better approach
463 without significant VFS changes
465 uint32_t shash;
467 shash = hash(fname, strlen(fname), 0) & 0xFF000000;
468 if (shash == 0) {
469 shash = 1;
471 sbuf->st_ex_ino ^= shash;
475 static DIR *shadow_copy2_opendir(vfs_handle_struct *handle,
476 const char *fname,
477 const char *mask,
478 uint32 attr)
480 time_t timestamp;
481 char *stripped;
482 DIR *ret;
483 int saved_errno;
484 char *conv;
486 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
487 &timestamp, &stripped)) {
488 return NULL;
490 if (timestamp == 0) {
491 return SMB_VFS_NEXT_OPENDIR(handle, fname, mask, attr);
493 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
494 TALLOC_FREE(stripped);
495 if (conv == NULL) {
496 return NULL;
498 ret = SMB_VFS_NEXT_OPENDIR(handle, conv, mask, attr);
499 saved_errno = errno;
500 TALLOC_FREE(conv);
501 errno = saved_errno;
502 return ret;
505 static int shadow_copy2_rename(vfs_handle_struct *handle,
506 const struct smb_filename *smb_fname_src,
507 const struct smb_filename *smb_fname_dst)
509 time_t timestamp_src, timestamp_dst;
511 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle,
512 smb_fname_src->base_name,
513 &timestamp_src, NULL)) {
514 return -1;
516 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle,
517 smb_fname_dst->base_name,
518 &timestamp_dst, NULL)) {
519 return -1;
521 if (timestamp_src != 0) {
522 errno = EXDEV;
523 return -1;
525 if (timestamp_dst != 0) {
526 errno = EROFS;
527 return -1;
529 return SMB_VFS_NEXT_RENAME(handle, smb_fname_src, smb_fname_dst);
532 static int shadow_copy2_symlink(vfs_handle_struct *handle,
533 const char *oldname, const char *newname)
535 time_t timestamp_old, timestamp_new;
537 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, oldname,
538 &timestamp_old, NULL)) {
539 return -1;
541 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, newname,
542 &timestamp_new, NULL)) {
543 return -1;
545 if ((timestamp_old != 0) || (timestamp_new != 0)) {
546 errno = EROFS;
547 return -1;
549 return SMB_VFS_NEXT_SYMLINK(handle, oldname, newname);
552 static int shadow_copy2_link(vfs_handle_struct *handle,
553 const char *oldname, const char *newname)
555 time_t timestamp_old, timestamp_new;
557 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, oldname,
558 &timestamp_old, NULL)) {
559 return -1;
561 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, newname,
562 &timestamp_new, NULL)) {
563 return -1;
565 if ((timestamp_old != 0) || (timestamp_new != 0)) {
566 errno = EROFS;
567 return -1;
569 return SMB_VFS_NEXT_LINK(handle, oldname, newname);
572 static int shadow_copy2_stat(vfs_handle_struct *handle,
573 struct smb_filename *smb_fname)
575 time_t timestamp;
576 char *stripped, *tmp;
577 int ret, saved_errno;
579 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle,
580 smb_fname->base_name,
581 &timestamp, &stripped)) {
582 return -1;
584 if (timestamp == 0) {
585 return SMB_VFS_NEXT_STAT(handle, smb_fname);
588 tmp = smb_fname->base_name;
589 smb_fname->base_name = shadow_copy2_convert(
590 talloc_tos(), handle, stripped, timestamp);
591 TALLOC_FREE(stripped);
593 if (smb_fname->base_name == NULL) {
594 smb_fname->base_name = tmp;
595 return -1;
598 ret = SMB_VFS_NEXT_STAT(handle, smb_fname);
599 saved_errno = errno;
601 TALLOC_FREE(smb_fname->base_name);
602 smb_fname->base_name = tmp;
604 if (ret == 0) {
605 convert_sbuf(handle, smb_fname->base_name, &smb_fname->st);
607 errno = saved_errno;
608 return ret;
611 static int shadow_copy2_lstat(vfs_handle_struct *handle,
612 struct smb_filename *smb_fname)
614 time_t timestamp;
615 char *stripped, *tmp;
616 int ret, saved_errno;
618 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle,
619 smb_fname->base_name,
620 &timestamp, &stripped)) {
621 return -1;
623 if (timestamp == 0) {
624 return SMB_VFS_NEXT_LSTAT(handle, smb_fname);
627 tmp = smb_fname->base_name;
628 smb_fname->base_name = shadow_copy2_convert(
629 talloc_tos(), handle, stripped, timestamp);
630 TALLOC_FREE(stripped);
632 if (smb_fname->base_name == NULL) {
633 smb_fname->base_name = tmp;
634 return -1;
637 ret = SMB_VFS_NEXT_LSTAT(handle, smb_fname);
638 saved_errno = errno;
640 TALLOC_FREE(smb_fname->base_name);
641 smb_fname->base_name = tmp;
643 if (ret == 0) {
644 convert_sbuf(handle, smb_fname->base_name, &smb_fname->st);
646 errno = saved_errno;
647 return ret;
650 static int shadow_copy2_fstat(vfs_handle_struct *handle, files_struct *fsp,
651 SMB_STRUCT_STAT *sbuf)
653 time_t timestamp;
654 int ret;
656 ret = SMB_VFS_NEXT_FSTAT(handle, fsp, sbuf);
657 if (ret == -1) {
658 return ret;
660 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle,
661 fsp->fsp_name->base_name,
662 &timestamp, NULL)) {
663 return 0;
665 if (timestamp != 0) {
666 convert_sbuf(handle, fsp->fsp_name->base_name, sbuf);
668 return 0;
671 static int shadow_copy2_open(vfs_handle_struct *handle,
672 struct smb_filename *smb_fname, files_struct *fsp,
673 int flags, mode_t mode)
675 time_t timestamp;
676 char *stripped, *tmp;
677 int ret, saved_errno;
679 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle,
680 smb_fname->base_name,
681 &timestamp, &stripped)) {
682 return -1;
684 if (timestamp == 0) {
685 return SMB_VFS_NEXT_OPEN(handle, smb_fname, fsp, flags, mode);
688 tmp = smb_fname->base_name;
689 smb_fname->base_name = shadow_copy2_convert(
690 talloc_tos(), handle, stripped, timestamp);
691 TALLOC_FREE(stripped);
693 if (smb_fname->base_name == NULL) {
694 smb_fname->base_name = tmp;
695 return -1;
698 ret = SMB_VFS_NEXT_OPEN(handle, smb_fname, fsp, flags, mode);
699 saved_errno = errno;
701 TALLOC_FREE(smb_fname->base_name);
702 smb_fname->base_name = tmp;
704 errno = saved_errno;
705 return ret;
708 static int shadow_copy2_unlink(vfs_handle_struct *handle,
709 const struct smb_filename *smb_fname)
711 time_t timestamp;
712 char *stripped;
713 int ret, saved_errno;
714 struct smb_filename *conv;
716 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle,
717 smb_fname->base_name,
718 &timestamp, &stripped)) {
719 return -1;
721 if (timestamp == 0) {
722 return SMB_VFS_NEXT_UNLINK(handle, smb_fname);
724 conv = cp_smb_filename(talloc_tos(), smb_fname);
725 if (conv == NULL) {
726 errno = ENOMEM;
727 return -1;
729 conv->base_name = shadow_copy2_convert(
730 conv, handle, stripped, timestamp);
731 TALLOC_FREE(stripped);
732 if (conv->base_name == NULL) {
733 return -1;
735 ret = SMB_VFS_NEXT_UNLINK(handle, conv);
736 saved_errno = errno;
737 TALLOC_FREE(conv);
738 errno = saved_errno;
739 return ret;
742 static int shadow_copy2_chmod(vfs_handle_struct *handle, const char *fname,
743 mode_t mode)
745 time_t timestamp;
746 char *stripped;
747 int ret, saved_errno;
748 char *conv;
750 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
751 &timestamp, &stripped)) {
752 return -1;
754 if (timestamp == 0) {
755 return SMB_VFS_NEXT_CHMOD(handle, fname, mode);
757 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
758 TALLOC_FREE(stripped);
759 if (conv == NULL) {
760 return -1;
762 ret = SMB_VFS_NEXT_CHMOD(handle, conv, mode);
763 saved_errno = errno;
764 TALLOC_FREE(conv);
765 errno = saved_errno;
766 return ret;
769 static int shadow_copy2_chown(vfs_handle_struct *handle, const char *fname,
770 uid_t uid, gid_t gid)
772 time_t timestamp;
773 char *stripped;
774 int ret, saved_errno;
775 char *conv;
777 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
778 &timestamp, &stripped)) {
779 return -1;
781 if (timestamp == 0) {
782 return SMB_VFS_NEXT_CHOWN(handle, fname, uid, gid);
784 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
785 TALLOC_FREE(stripped);
786 if (conv == NULL) {
787 return -1;
789 ret = SMB_VFS_NEXT_CHOWN(handle, conv, uid, gid);
790 saved_errno = errno;
791 TALLOC_FREE(conv);
792 errno = saved_errno;
793 return ret;
796 static int shadow_copy2_chdir(vfs_handle_struct *handle,
797 const char *fname)
799 time_t timestamp;
800 char *stripped;
801 int ret, saved_errno;
802 char *conv;
804 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
805 &timestamp, &stripped)) {
806 return -1;
808 if (timestamp == 0) {
809 return SMB_VFS_NEXT_CHDIR(handle, fname);
811 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
812 TALLOC_FREE(stripped);
813 if (conv == NULL) {
814 return -1;
816 ret = SMB_VFS_NEXT_CHDIR(handle, conv);
817 saved_errno = errno;
818 TALLOC_FREE(conv);
819 errno = saved_errno;
820 return ret;
823 static int shadow_copy2_ntimes(vfs_handle_struct *handle,
824 const struct smb_filename *smb_fname,
825 struct smb_file_time *ft)
827 time_t timestamp;
828 char *stripped;
829 int ret, saved_errno;
830 struct smb_filename *conv;
832 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle,
833 smb_fname->base_name,
834 &timestamp, &stripped)) {
835 return -1;
837 if (timestamp == 0) {
838 return SMB_VFS_NEXT_NTIMES(handle, smb_fname, ft);
840 conv = cp_smb_filename(talloc_tos(), smb_fname);
841 if (conv == NULL) {
842 errno = ENOMEM;
843 return -1;
845 conv->base_name = shadow_copy2_convert(
846 conv, handle, stripped, timestamp);
847 TALLOC_FREE(stripped);
848 if (conv->base_name == NULL) {
849 return -1;
851 ret = SMB_VFS_NEXT_NTIMES(handle, conv, ft);
852 saved_errno = errno;
853 TALLOC_FREE(conv);
854 errno = saved_errno;
855 return ret;
858 static int shadow_copy2_readlink(vfs_handle_struct *handle,
859 const char *fname, char *buf, size_t bufsiz)
861 time_t timestamp;
862 char *stripped;
863 int ret, saved_errno;
864 char *conv;
866 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
867 &timestamp, &stripped)) {
868 return -1;
870 if (timestamp == 0) {
871 return SMB_VFS_NEXT_READLINK(handle, fname, buf, bufsiz);
873 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
874 TALLOC_FREE(stripped);
875 if (conv == NULL) {
876 return -1;
878 ret = SMB_VFS_NEXT_READLINK(handle, conv, buf, bufsiz);
879 saved_errno = errno;
880 TALLOC_FREE(conv);
881 errno = saved_errno;
882 return ret;
885 static int shadow_copy2_mknod(vfs_handle_struct *handle,
886 const char *fname, mode_t mode, SMB_DEV_T dev)
888 time_t timestamp;
889 char *stripped;
890 int ret, saved_errno;
891 char *conv;
893 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
894 &timestamp, &stripped)) {
895 return -1;
897 if (timestamp == 0) {
898 return SMB_VFS_NEXT_MKNOD(handle, fname, mode, dev);
900 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
901 TALLOC_FREE(stripped);
902 if (conv == NULL) {
903 return -1;
905 ret = SMB_VFS_NEXT_MKNOD(handle, conv, mode, dev);
906 saved_errno = errno;
907 TALLOC_FREE(conv);
908 errno = saved_errno;
909 return ret;
912 static char *shadow_copy2_realpath(vfs_handle_struct *handle,
913 const char *fname)
915 time_t timestamp;
916 char *stripped = NULL;
917 char *tmp = NULL;
918 char *result = NULL;
919 char *inserted = NULL;
920 char *inserted_to, *inserted_end;
921 int saved_errno;
923 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
924 &timestamp, &stripped)) {
925 goto done;
927 if (timestamp == 0) {
928 return SMB_VFS_NEXT_REALPATH(handle, fname);
931 tmp = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
932 if (tmp == NULL) {
933 goto done;
936 result = SMB_VFS_NEXT_REALPATH(handle, tmp);
937 if (result == NULL) {
938 goto done;
942 * Take away what we've inserted. This removes the @GMT-thingy
943 * completely, but will give a path under the share root.
945 inserted = shadow_copy2_insert_string(talloc_tos(), handle, timestamp);
946 if (inserted == NULL) {
947 goto done;
949 inserted_to = strstr_m(result, inserted);
950 if (inserted_to == NULL) {
951 DEBUG(2, ("SMB_VFS_NEXT_REALPATH removed %s\n", inserted));
952 goto done;
954 inserted_end = inserted_to + talloc_get_size(inserted) - 1;
955 memmove(inserted_to, inserted_end, strlen(inserted_end)+1);
957 done:
958 saved_errno = errno;
959 TALLOC_FREE(inserted);
960 TALLOC_FREE(tmp);
961 TALLOC_FREE(stripped);
962 errno = saved_errno;
963 return result;
966 static char *have_snapdir(struct vfs_handle_struct *handle,
967 const char *path)
969 struct smb_filename smb_fname;
970 int ret;
972 ZERO_STRUCT(smb_fname);
973 smb_fname.base_name = talloc_asprintf(
974 talloc_tos(), "%s/%s", path,
975 lp_parm_const_string(SNUM(handle->conn), "shadow", "snapdir",
976 ".snapshots"));
977 if (smb_fname.base_name == NULL) {
978 return NULL;
981 ret = SMB_VFS_NEXT_STAT(handle, &smb_fname);
982 if ((ret == 0) && (S_ISDIR(smb_fname.st.st_ex_mode))) {
983 return smb_fname.base_name;
985 TALLOC_FREE(smb_fname.base_name);
986 return NULL;
989 static char *shadow_copy2_find_snapdir(TALLOC_CTX *mem_ctx,
990 struct vfs_handle_struct *handle,
991 struct smb_filename *smb_fname)
993 char *path, *p;
994 char *snapdir;
996 path = talloc_asprintf(mem_ctx, "%s/%s",
997 handle->conn->connectpath,
998 smb_fname->base_name);
999 if (path == NULL) {
1000 return NULL;
1003 snapdir = have_snapdir(handle, path);
1004 if (snapdir != NULL) {
1005 TALLOC_FREE(path);
1006 return snapdir;
1009 while ((p = strrchr(path, '/')) && (p > path)) {
1011 p[0] = '\0';
1013 snapdir = have_snapdir(handle, path);
1014 if (snapdir != NULL) {
1015 TALLOC_FREE(path);
1016 return snapdir;
1019 TALLOC_FREE(path);
1020 return NULL;
1023 static bool shadow_copy2_snapshot_to_gmt(vfs_handle_struct *handle,
1024 const char *name,
1025 char *gmt, size_t gmt_len)
1027 struct tm timestamp;
1028 time_t timestamp_t;
1029 unsigned long int timestamp_long;
1030 const char *fmt;
1032 fmt = lp_parm_const_string(SNUM(handle->conn), "shadow",
1033 "format", GMT_FORMAT);
1035 ZERO_STRUCT(timestamp);
1036 if (lp_parm_bool(SNUM(handle->conn), "shadow", "sscanf", false)) {
1037 if (sscanf(name, fmt, &timestamp_long) != 1) {
1038 DEBUG(10, ("shadow_copy2_snapshot_to_gmt: "
1039 "no sscanf match %s: %s\n",
1040 fmt, name));
1041 return false;
1043 timestamp_t = timestamp_long;
1044 gmtime_r(&timestamp_t, &timestamp);
1045 } else {
1046 if (strptime(name, fmt, &timestamp) == NULL) {
1047 DEBUG(10, ("shadow_copy2_snapshot_to_gmt: "
1048 "no match %s: %s\n",
1049 fmt, name));
1050 return false;
1052 DEBUG(10, ("shadow_copy2_snapshot_to_gmt: match %s: %s\n",
1053 fmt, name));
1055 if (lp_parm_bool(SNUM(handle->conn), "shadow", "localtime", false)) {
1056 timestamp.tm_isdst = -1;
1057 timestamp_t = mktime(&timestamp);
1058 gmtime_r(&timestamp_t, &timestamp);
1062 strftime(gmt, gmt_len, GMT_FORMAT, &timestamp);
1063 return true;
1066 static int shadow_copy2_label_cmp_asc(const void *x, const void *y)
1068 return strncmp((const char *)x, (const char *)y, sizeof(SHADOW_COPY_LABEL));
1071 static int shadow_copy2_label_cmp_desc(const void *x, const void *y)
1073 return -strncmp((const char *)x, (const char *)y, sizeof(SHADOW_COPY_LABEL));
1077 sort the shadow copy data in ascending or descending order
1079 static void shadow_copy2_sort_data(vfs_handle_struct *handle,
1080 struct shadow_copy_data *shadow_copy2_data)
1082 int (*cmpfunc)(const void *, const void *);
1083 const char *sort;
1085 sort = lp_parm_const_string(SNUM(handle->conn), "shadow",
1086 "sort", "desc");
1087 if (sort == NULL) {
1088 return;
1091 if (strcmp(sort, "asc") == 0) {
1092 cmpfunc = shadow_copy2_label_cmp_asc;
1093 } else if (strcmp(sort, "desc") == 0) {
1094 cmpfunc = shadow_copy2_label_cmp_desc;
1095 } else {
1096 return;
1099 if (shadow_copy2_data && shadow_copy2_data->num_volumes > 0 &&
1100 shadow_copy2_data->labels)
1102 TYPESAFE_QSORT(shadow_copy2_data->labels,
1103 shadow_copy2_data->num_volumes,
1104 cmpfunc);
1108 static int shadow_copy2_get_shadow_copy_data(
1109 vfs_handle_struct *handle, files_struct *fsp,
1110 struct shadow_copy_data *shadow_copy2_data,
1111 bool labels)
1113 DIR *p;
1114 const char *snapdir;
1115 struct dirent *d;
1116 TALLOC_CTX *tmp_ctx = talloc_stackframe();
1118 snapdir = shadow_copy2_find_snapdir(tmp_ctx, handle, fsp->fsp_name);
1119 if (snapdir == NULL) {
1120 DEBUG(0,("shadow:snapdir not found for %s in get_shadow_copy_data\n",
1121 handle->conn->connectpath));
1122 errno = EINVAL;
1123 talloc_free(tmp_ctx);
1124 return -1;
1127 p = SMB_VFS_NEXT_OPENDIR(handle, snapdir, NULL, 0);
1129 if (!p) {
1130 DEBUG(2,("shadow_copy2: SMB_VFS_NEXT_OPENDIR() failed for '%s'"
1131 " - %s\n", snapdir, strerror(errno)));
1132 talloc_free(tmp_ctx);
1133 errno = ENOSYS;
1134 return -1;
1137 shadow_copy2_data->num_volumes = 0;
1138 shadow_copy2_data->labels = NULL;
1140 while ((d = SMB_VFS_NEXT_READDIR(handle, p, NULL))) {
1141 char snapshot[GMT_NAME_LEN+1];
1142 SHADOW_COPY_LABEL *tlabels;
1145 * ignore names not of the right form in the snapshot
1146 * directory
1148 if (!shadow_copy2_snapshot_to_gmt(
1149 handle, d->d_name,
1150 snapshot, sizeof(snapshot))) {
1152 DEBUG(6, ("shadow_copy2_get_shadow_copy_data: "
1153 "ignoring %s\n", d->d_name));
1154 continue;
1156 DEBUG(6,("shadow_copy2_get_shadow_copy_data: %s -> %s\n",
1157 d->d_name, snapshot));
1159 if (!labels) {
1160 /* the caller doesn't want the labels */
1161 shadow_copy2_data->num_volumes++;
1162 continue;
1165 tlabels = talloc_realloc(shadow_copy2_data,
1166 shadow_copy2_data->labels,
1167 SHADOW_COPY_LABEL,
1168 shadow_copy2_data->num_volumes+1);
1169 if (tlabels == NULL) {
1170 DEBUG(0,("shadow_copy2: out of memory\n"));
1171 SMB_VFS_NEXT_CLOSEDIR(handle, p);
1172 talloc_free(tmp_ctx);
1173 return -1;
1176 strlcpy(tlabels[shadow_copy2_data->num_volumes], snapshot,
1177 sizeof(*tlabels));
1179 shadow_copy2_data->num_volumes++;
1180 shadow_copy2_data->labels = tlabels;
1183 SMB_VFS_NEXT_CLOSEDIR(handle,p);
1185 shadow_copy2_sort_data(handle, shadow_copy2_data);
1187 talloc_free(tmp_ctx);
1188 return 0;
1191 static NTSTATUS shadow_copy2_fget_nt_acl(vfs_handle_struct *handle,
1192 struct files_struct *fsp,
1193 uint32 security_info,
1194 TALLOC_CTX *mem_ctx,
1195 struct security_descriptor **ppdesc)
1197 time_t timestamp;
1198 char *stripped;
1199 NTSTATUS status;
1200 char *conv;
1202 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle,
1203 fsp->fsp_name->base_name,
1204 &timestamp, &stripped)) {
1205 return map_nt_error_from_unix(errno);
1207 if (timestamp == 0) {
1208 return SMB_VFS_NEXT_FGET_NT_ACL(handle, fsp, security_info,
1209 mem_ctx,
1210 ppdesc);
1212 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1213 TALLOC_FREE(stripped);
1214 if (conv == NULL) {
1215 return map_nt_error_from_unix(errno);
1217 status = SMB_VFS_NEXT_GET_NT_ACL(handle, conv, security_info,
1218 mem_ctx, ppdesc);
1219 TALLOC_FREE(conv);
1220 return status;
1223 static NTSTATUS shadow_copy2_get_nt_acl(vfs_handle_struct *handle,
1224 const char *fname,
1225 uint32 security_info,
1226 TALLOC_CTX *mem_ctx,
1227 struct security_descriptor **ppdesc)
1229 time_t timestamp;
1230 char *stripped;
1231 NTSTATUS status;
1232 char *conv;
1234 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
1235 &timestamp, &stripped)) {
1236 return map_nt_error_from_unix(errno);
1238 if (timestamp == 0) {
1239 return SMB_VFS_NEXT_GET_NT_ACL(handle, fname, security_info,
1240 mem_ctx, ppdesc);
1242 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1243 TALLOC_FREE(stripped);
1244 if (conv == NULL) {
1245 return map_nt_error_from_unix(errno);
1247 status = SMB_VFS_NEXT_GET_NT_ACL(handle, conv, security_info,
1248 mem_ctx, ppdesc);
1249 TALLOC_FREE(conv);
1250 return status;
1253 static int shadow_copy2_mkdir(vfs_handle_struct *handle,
1254 const char *fname, mode_t mode)
1256 time_t timestamp;
1257 char *stripped;
1258 int ret, saved_errno;
1259 char *conv;
1261 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
1262 &timestamp, &stripped)) {
1263 return -1;
1265 if (timestamp == 0) {
1266 return SMB_VFS_NEXT_MKDIR(handle, fname, mode);
1268 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1269 TALLOC_FREE(stripped);
1270 if (conv == NULL) {
1271 return -1;
1273 ret = SMB_VFS_NEXT_MKDIR(handle, conv, mode);
1274 saved_errno = errno;
1275 TALLOC_FREE(conv);
1276 errno = saved_errno;
1277 return ret;
1280 static int shadow_copy2_rmdir(vfs_handle_struct *handle, const char *fname)
1282 time_t timestamp;
1283 char *stripped;
1284 int ret, saved_errno;
1285 char *conv;
1287 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
1288 &timestamp, &stripped)) {
1289 return -1;
1291 if (timestamp == 0) {
1292 return SMB_VFS_NEXT_RMDIR(handle, fname);
1294 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1295 TALLOC_FREE(stripped);
1296 if (conv == NULL) {
1297 return -1;
1299 ret = SMB_VFS_NEXT_RMDIR(handle, conv);
1300 saved_errno = errno;
1301 TALLOC_FREE(conv);
1302 errno = saved_errno;
1303 return ret;
1306 static int shadow_copy2_chflags(vfs_handle_struct *handle, const char *fname,
1307 unsigned int flags)
1309 time_t timestamp;
1310 char *stripped;
1311 int ret, saved_errno;
1312 char *conv;
1314 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
1315 &timestamp, &stripped)) {
1316 return -1;
1318 if (timestamp == 0) {
1319 return SMB_VFS_NEXT_CHFLAGS(handle, fname, flags);
1321 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1322 TALLOC_FREE(stripped);
1323 if (conv == NULL) {
1324 return -1;
1326 ret = SMB_VFS_NEXT_CHFLAGS(handle, conv, flags);
1327 saved_errno = errno;
1328 TALLOC_FREE(conv);
1329 errno = saved_errno;
1330 return ret;
1333 static ssize_t shadow_copy2_getxattr(vfs_handle_struct *handle,
1334 const char *fname, const char *aname,
1335 void *value, size_t size)
1337 time_t timestamp;
1338 char *stripped;
1339 ssize_t ret;
1340 int saved_errno;
1341 char *conv;
1343 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
1344 &timestamp, &stripped)) {
1345 return -1;
1347 if (timestamp == 0) {
1348 return SMB_VFS_NEXT_GETXATTR(handle, fname, aname, value,
1349 size);
1351 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1352 TALLOC_FREE(stripped);
1353 if (conv == NULL) {
1354 return -1;
1356 ret = SMB_VFS_NEXT_GETXATTR(handle, conv, aname, value, size);
1357 saved_errno = errno;
1358 TALLOC_FREE(conv);
1359 errno = saved_errno;
1360 return ret;
1363 static ssize_t shadow_copy2_listxattr(struct vfs_handle_struct *handle,
1364 const char *fname,
1365 char *list, size_t size)
1367 time_t timestamp;
1368 char *stripped;
1369 ssize_t ret;
1370 int saved_errno;
1371 char *conv;
1373 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
1374 &timestamp, &stripped)) {
1375 return -1;
1377 if (timestamp == 0) {
1378 return SMB_VFS_NEXT_LISTXATTR(handle, fname, list, size);
1380 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1381 TALLOC_FREE(stripped);
1382 if (conv == NULL) {
1383 return -1;
1385 ret = SMB_VFS_NEXT_LISTXATTR(handle, conv, list, size);
1386 saved_errno = errno;
1387 TALLOC_FREE(conv);
1388 errno = saved_errno;
1389 return ret;
1392 static int shadow_copy2_removexattr(vfs_handle_struct *handle,
1393 const char *fname, const char *aname)
1395 time_t timestamp;
1396 char *stripped;
1397 int ret, saved_errno;
1398 char *conv;
1400 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
1401 &timestamp, &stripped)) {
1402 return -1;
1404 if (timestamp == 0) {
1405 return SMB_VFS_NEXT_REMOVEXATTR(handle, fname, aname);
1407 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1408 TALLOC_FREE(stripped);
1409 if (conv == NULL) {
1410 return -1;
1412 ret = SMB_VFS_NEXT_REMOVEXATTR(handle, conv, aname);
1413 saved_errno = errno;
1414 TALLOC_FREE(conv);
1415 errno = saved_errno;
1416 return ret;
1419 static int shadow_copy2_setxattr(struct vfs_handle_struct *handle,
1420 const char *fname,
1421 const char *aname, const void *value,
1422 size_t size, int flags)
1424 time_t timestamp;
1425 char *stripped;
1426 ssize_t ret;
1427 int saved_errno;
1428 char *conv;
1430 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
1431 &timestamp, &stripped)) {
1432 return -1;
1434 if (timestamp == 0) {
1435 return SMB_VFS_NEXT_SETXATTR(handle, fname, aname, value, size,
1436 flags);
1438 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1439 TALLOC_FREE(stripped);
1440 if (conv == NULL) {
1441 return -1;
1443 ret = SMB_VFS_NEXT_SETXATTR(handle, conv, aname, value, size, flags);
1444 saved_errno = errno;
1445 TALLOC_FREE(conv);
1446 errno = saved_errno;
1447 return ret;
1450 static int shadow_copy2_chmod_acl(vfs_handle_struct *handle,
1451 const char *fname, mode_t mode)
1453 time_t timestamp;
1454 char *stripped;
1455 ssize_t ret;
1456 int saved_errno;
1457 char *conv;
1459 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, fname,
1460 &timestamp, &stripped)) {
1461 return -1;
1463 if (timestamp == 0) {
1464 return SMB_VFS_NEXT_CHMOD_ACL(handle, fname, mode);
1466 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1467 TALLOC_FREE(stripped);
1468 if (conv == NULL) {
1469 return -1;
1471 ret = SMB_VFS_NEXT_CHMOD_ACL(handle, conv, mode);
1472 saved_errno = errno;
1473 TALLOC_FREE(conv);
1474 errno = saved_errno;
1475 return ret;
1478 static int shadow_copy2_get_real_filename(struct vfs_handle_struct *handle,
1479 const char *path,
1480 const char *name,
1481 TALLOC_CTX *mem_ctx,
1482 char **found_name)
1484 time_t timestamp;
1485 char *stripped;
1486 ssize_t ret;
1487 int saved_errno;
1488 char *conv;
1490 if (!shadow_copy2_strip_snapshot(talloc_tos(), handle, path,
1491 &timestamp, &stripped)) {
1492 return -1;
1494 if (timestamp == 0) {
1495 return SMB_VFS_NEXT_GET_REAL_FILENAME(handle, path, name,
1496 mem_ctx, found_name);
1498 if (stripped[0] == '\0') {
1499 *found_name = talloc_strdup(mem_ctx, name);
1500 if (*found_name == NULL) {
1501 errno = ENOMEM;
1502 return -1;
1504 return 0;
1506 conv = shadow_copy2_convert(talloc_tos(), handle, stripped, timestamp);
1507 TALLOC_FREE(stripped);
1508 if (conv == NULL) {
1509 return -1;
1511 ret = SMB_VFS_NEXT_GET_REAL_FILENAME(handle, conv, name,
1512 mem_ctx, found_name);
1513 saved_errno = errno;
1514 TALLOC_FREE(conv);
1515 errno = saved_errno;
1516 return ret;
1520 static struct vfs_fn_pointers vfs_shadow_copy2_fns = {
1521 .opendir_fn = shadow_copy2_opendir,
1522 .rename_fn = shadow_copy2_rename,
1523 .link_fn = shadow_copy2_link,
1524 .symlink_fn = shadow_copy2_symlink,
1525 .stat_fn = shadow_copy2_stat,
1526 .lstat_fn = shadow_copy2_lstat,
1527 .fstat_fn = shadow_copy2_fstat,
1528 .open_fn = shadow_copy2_open,
1529 .unlink_fn = shadow_copy2_unlink,
1530 .chmod_fn = shadow_copy2_chmod,
1531 .chown_fn = shadow_copy2_chown,
1532 .chdir_fn = shadow_copy2_chdir,
1533 .ntimes_fn = shadow_copy2_ntimes,
1534 .readlink_fn = shadow_copy2_readlink,
1535 .mknod_fn = shadow_copy2_mknod,
1536 .realpath_fn = shadow_copy2_realpath,
1537 .get_nt_acl_fn = shadow_copy2_get_nt_acl,
1538 .fget_nt_acl_fn = shadow_copy2_fget_nt_acl,
1539 .get_shadow_copy_data_fn = shadow_copy2_get_shadow_copy_data,
1540 .mkdir_fn = shadow_copy2_mkdir,
1541 .rmdir_fn = shadow_copy2_rmdir,
1542 .getxattr_fn = shadow_copy2_getxattr,
1543 .listxattr_fn = shadow_copy2_listxattr,
1544 .removexattr_fn = shadow_copy2_removexattr,
1545 .setxattr_fn = shadow_copy2_setxattr,
1546 .chmod_acl_fn = shadow_copy2_chmod_acl,
1547 .chflags_fn = shadow_copy2_chflags,
1548 .get_real_filename_fn = shadow_copy2_get_real_filename,
1551 NTSTATUS vfs_shadow_copy2_init(void);
1552 NTSTATUS vfs_shadow_copy2_init(void)
1554 return smb_register_vfs(SMB_VFS_INTERFACE_VERSION,
1555 "shadow_copy2", &vfs_shadow_copy2_fns);