4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
23 * Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
24 * Copyright 2015 Nexenta Systems, Inc. All rights reserved.
25 * Copyright (c) 2015 by Delphix. All rights reserved.
26 * Copyright 2016 Joyent, Inc.
27 * Copyright 2016 Igor Kozhukhov <ikozhukhov@gmail.com>
37 #include <sys/types.h>
47 #include <sys/zfs_ioctl.h>
49 #include "libzfs_impl.h"
51 #define ZDIFF_SNAPDIR "/.zfs/snapshot/"
52 #define ZDIFF_SHARESDIR "/.zfs/shares/"
53 #define ZDIFF_PREFIX "zfs-diff-%d"
55 #define ZDIFF_ADDED '+'
56 #define ZDIFF_MODIFIED 'M'
57 #define ZDIFF_REMOVED '-'
58 #define ZDIFF_RENAMED 'R'
60 typedef struct differ_info
{
73 boolean_t timestamped
;
82 * Given a {dsname, object id}, get the object path
85 get_stats_for_obj(differ_info_t
*di
, const char *dsname
, uint64_t obj
,
86 char *pn
, int maxlen
, zfs_stat_t
*sb
)
88 zfs_cmd_t zc
= {"\0"};
91 (void) strlcpy(zc
.zc_name
, dsname
, sizeof (zc
.zc_name
));
95 error
= ioctl(di
->zhp
->zfs_hdl
->libzfs_fd
, ZFS_IOC_OBJ_TO_STATS
, &zc
);
98 /* we can get stats even if we failed to get a path */
99 (void) memcpy(sb
, &zc
.zc_stat
, sizeof (zfs_stat_t
));
101 ASSERT(di
->zerr
== 0);
102 (void) strlcpy(pn
, zc
.zc_value
, maxlen
);
106 if (di
->zerr
== EPERM
) {
107 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
108 dgettext(TEXT_DOMAIN
,
109 "The sys_config privilege or diff delegated permission "
110 "is needed\nto discover path names"));
113 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
114 dgettext(TEXT_DOMAIN
,
115 "Unable to determine path or stats for "
116 "object %lld in %s"), (longlong_t
)obj
, dsname
);
124 * Prints a file name out a character at a time. If the character is
125 * not in the range of what we consider "printable" ASCII, display it
126 * as an escaped 4-digit octal value. ASCII values less than a space
127 * are all control characters and we declare the upper end as the
128 * DELete character. This also is the last 7-bit ASCII character.
129 * We choose to treat all 8-bit ASCII as not printable for this
133 stream_bytes(FILE *fp
, const char *string
)
137 while ((c
= *string
++) != '\0') {
138 if (c
> ' ' && c
!= '\\' && c
< '\177') {
139 (void) fprintf(fp
, "%c", c
);
141 (void) fprintf(fp
, "\\%04o", (uint8_t)c
);
147 print_what(FILE *fp
, mode_t what
)
151 switch (what
& S_IFMT
) {
187 (void) fprintf(fp
, "%c", symbol
);
191 print_cmn(FILE *fp
, differ_info_t
*di
, const char *file
)
193 stream_bytes(fp
, di
->dsmnt
);
194 stream_bytes(fp
, file
);
198 print_rename(FILE *fp
, differ_info_t
*di
, const char *old
, const char *new,
202 (void) fprintf(fp
, "%10lld.%09lld\t",
203 (longlong_t
)isb
->zs_ctime
[0],
204 (longlong_t
)isb
->zs_ctime
[1]);
205 (void) fprintf(fp
, "%c\t", ZDIFF_RENAMED
);
207 print_what(fp
, isb
->zs_mode
);
208 (void) fprintf(fp
, "\t");
210 print_cmn(fp
, di
, old
);
212 (void) fprintf(fp
, "\t");
214 (void) fprintf(fp
, " -> ");
215 print_cmn(fp
, di
, new);
216 (void) fprintf(fp
, "\n");
220 print_link_change(FILE *fp
, differ_info_t
*di
, int delta
, const char *file
,
224 (void) fprintf(fp
, "%10lld.%09lld\t",
225 (longlong_t
)isb
->zs_ctime
[0],
226 (longlong_t
)isb
->zs_ctime
[1]);
227 (void) fprintf(fp
, "%c\t", ZDIFF_MODIFIED
);
229 print_what(fp
, isb
->zs_mode
);
230 (void) fprintf(fp
, "\t");
232 print_cmn(fp
, di
, file
);
233 (void) fprintf(fp
, "\t(%+d)", delta
);
234 (void) fprintf(fp
, "\n");
238 print_file(FILE *fp
, differ_info_t
*di
, char type
, const char *file
,
242 (void) fprintf(fp
, "%10lld.%09lld\t",
243 (longlong_t
)isb
->zs_ctime
[0],
244 (longlong_t
)isb
->zs_ctime
[1]);
245 (void) fprintf(fp
, "%c\t", type
);
247 print_what(fp
, isb
->zs_mode
);
248 (void) fprintf(fp
, "\t");
250 print_cmn(fp
, di
, file
);
251 (void) fprintf(fp
, "\n");
255 write_inuse_diffs_one(FILE *fp
, differ_info_t
*di
, uint64_t dobj
)
257 struct zfs_stat fsb
, tsb
;
259 char fobjname
[MAXPATHLEN
], tobjname
[MAXPATHLEN
];
260 int fobjerr
, tobjerr
;
263 if (dobj
== di
->shares
)
267 * Check the from and to snapshots for info on the object. If
268 * we get ENOENT, then the object just didn't exist in that
269 * snapshot. If we get ENOTSUP, then we tried to get
270 * info on a non-ZPL object, which we don't care about anyway.
272 fobjerr
= get_stats_for_obj(di
, di
->fromsnap
, dobj
, fobjname
,
274 if (fobjerr
&& di
->zerr
!= ENOENT
&& di
->zerr
!= ENOTSUP
)
277 tobjerr
= get_stats_for_obj(di
, di
->tosnap
, dobj
, tobjname
,
279 if (tobjerr
&& di
->zerr
!= ENOENT
&& di
->zerr
!= ENOTSUP
)
283 * Unallocated object sharing the same meta dnode block
285 if (fobjerr
&& tobjerr
) {
286 ASSERT(di
->zerr
== ENOENT
|| di
->zerr
== ENOTSUP
);
291 di
->zerr
= 0; /* negate get_stats_for_obj() from side that failed */
292 fmode
= fsb
.zs_mode
& S_IFMT
;
293 tmode
= tsb
.zs_mode
& S_IFMT
;
294 if (fmode
== S_IFDIR
|| tmode
== S_IFDIR
|| fsb
.zs_links
== 0 ||
298 change
= tsb
.zs_links
- fsb
.zs_links
;
302 print_link_change(fp
, di
, change
, tobjname
, &tsb
);
305 print_file(fp
, di
, ZDIFF_ADDED
, tobjname
, &tsb
);
307 } else if (tobjerr
) {
309 print_link_change(fp
, di
, change
, fobjname
, &fsb
);
312 print_file(fp
, di
, ZDIFF_REMOVED
, fobjname
, &fsb
);
316 if (fmode
!= tmode
&& fsb
.zs_gen
== tsb
.zs_gen
)
317 tsb
.zs_gen
++; /* Force a generational difference */
319 /* Simple modification or no change */
320 if (fsb
.zs_gen
== tsb
.zs_gen
) {
321 /* No apparent changes. Could we assert !this? */
322 if (fsb
.zs_ctime
[0] == tsb
.zs_ctime
[0] &&
323 fsb
.zs_ctime
[1] == tsb
.zs_ctime
[1])
326 print_link_change(fp
, di
, change
,
327 change
> 0 ? fobjname
: tobjname
, &tsb
);
328 } else if (strcmp(fobjname
, tobjname
) == 0) {
329 print_file(fp
, di
, ZDIFF_MODIFIED
, fobjname
, &tsb
);
331 print_rename(fp
, di
, fobjname
, tobjname
, &tsb
);
335 /* file re-created or object re-used */
336 print_file(fp
, di
, ZDIFF_REMOVED
, fobjname
, &fsb
);
337 print_file(fp
, di
, ZDIFF_ADDED
, tobjname
, &tsb
);
343 write_inuse_diffs(FILE *fp
, differ_info_t
*di
, dmu_diff_record_t
*dr
)
348 for (o
= dr
->ddr_first
; o
<= dr
->ddr_last
; o
++) {
349 if ((err
= write_inuse_diffs_one(fp
, di
, o
)) != 0)
356 describe_free(FILE *fp
, differ_info_t
*di
, uint64_t object
, char *namebuf
,
361 if (get_stats_for_obj(di
, di
->fromsnap
, object
, namebuf
,
363 /* Let it slide, if in the delete queue on from side */
364 if (di
->zerr
== ENOENT
&& sb
.zs_links
== 0) {
371 print_file(fp
, di
, ZDIFF_REMOVED
, namebuf
, &sb
);
376 write_free_diffs(FILE *fp
, differ_info_t
*di
, dmu_diff_record_t
*dr
)
378 zfs_cmd_t zc
= {"\0"};
379 libzfs_handle_t
*lhdl
= di
->zhp
->zfs_hdl
;
380 char fobjname
[MAXPATHLEN
];
382 (void) strlcpy(zc
.zc_name
, di
->fromsnap
, sizeof (zc
.zc_name
));
383 zc
.zc_obj
= dr
->ddr_first
- 1;
385 ASSERT(di
->zerr
== 0);
387 while (zc
.zc_obj
< dr
->ddr_last
) {
390 err
= ioctl(lhdl
->libzfs_fd
, ZFS_IOC_NEXT_OBJ
, &zc
);
392 if (zc
.zc_obj
== di
->shares
) {
396 if (zc
.zc_obj
> dr
->ddr_last
) {
399 err
= describe_free(fp
, di
, zc
.zc_obj
, fobjname
,
403 } else if (errno
== ESRCH
) {
406 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
407 dgettext(TEXT_DOMAIN
,
408 "next allocated object (> %lld) find failure"),
409 (longlong_t
)zc
.zc_obj
);
422 differ_info_t
*di
= arg
;
423 dmu_diff_record_t dr
;
427 if ((ofp
= fdopen(di
->outputfd
, "w")) == NULL
) {
429 strlcpy(di
->errbuf
, strerror(errno
), sizeof (di
->errbuf
));
430 (void) close(di
->datafd
);
435 char *cp
= (char *)&dr
;
436 int len
= sizeof (dr
);
440 rv
= read(di
->datafd
, cp
, len
);
443 } while (len
> 0 && rv
> 0);
445 if (rv
< 0 || (rv
== 0 && len
!= sizeof (dr
))) {
448 } else if (rv
== 0) {
449 /* end of file at a natural breaking point */
453 switch (dr
.ddr_type
) {
455 err
= write_free_diffs(ofp
, di
, &dr
);
458 err
= write_inuse_diffs(ofp
, di
, &dr
);
470 (void) close(di
->datafd
);
474 ASSERT(di
->zerr
== EINVAL
);
475 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
476 dgettext(TEXT_DOMAIN
,
477 "Internal error: bad data from diff IOCTL"));
484 find_shares_object(differ_info_t
*di
)
486 char fullpath
[MAXPATHLEN
];
487 struct stat64 sb
= { 0 };
489 (void) strlcpy(fullpath
, di
->dsmnt
, MAXPATHLEN
);
490 (void) strlcat(fullpath
, ZDIFF_SHARESDIR
, MAXPATHLEN
);
492 if (stat64(fullpath
, &sb
) != 0) {
493 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
494 dgettext(TEXT_DOMAIN
, "Cannot stat %s"), fullpath
);
495 return (zfs_error(di
->zhp
->zfs_hdl
, EZFS_DIFF
, di
->errbuf
));
498 di
->shares
= (uint64_t)sb
.st_ino
;
503 make_temp_snapshot(differ_info_t
*di
)
505 libzfs_handle_t
*hdl
= di
->zhp
->zfs_hdl
;
506 zfs_cmd_t zc
= {"\0"};
508 (void) snprintf(zc
.zc_value
, sizeof (zc
.zc_value
),
509 ZDIFF_PREFIX
, getpid());
510 (void) strlcpy(zc
.zc_name
, di
->ds
, sizeof (zc
.zc_name
));
511 zc
.zc_cleanup_fd
= di
->cleanupfd
;
513 if (ioctl(hdl
->libzfs_fd
, ZFS_IOC_TMP_SNAPSHOT
, &zc
) != 0) {
516 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
517 dgettext(TEXT_DOMAIN
, "The diff delegated "
518 "permission is needed in order\nto create a "
519 "just-in-time snapshot for diffing\n"));
520 return (zfs_error(hdl
, EZFS_DIFF
, di
->errbuf
));
522 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
523 dgettext(TEXT_DOMAIN
, "Cannot create just-in-time "
524 "snapshot of '%s'"), zc
.zc_name
);
525 return (zfs_standard_error(hdl
, err
, di
->errbuf
));
529 di
->tmpsnap
= zfs_strdup(hdl
, zc
.zc_value
);
530 di
->tosnap
= zfs_asprintf(hdl
, "%s@%s", di
->ds
, di
->tmpsnap
);
535 teardown_differ_info(differ_info_t
*di
)
544 (void) close(di
->cleanupfd
);
548 get_snapshot_names(differ_info_t
*di
, const char *fromsnap
,
551 libzfs_handle_t
*hdl
= di
->zhp
->zfs_hdl
;
559 * fdslen fsnlen tdslen tsnlen
561 * 0. dataset@snap1 dataset@snap2 >0 >1 >0 >1
562 * 1. dataset@snap1 @snap2 >0 >1 ==0 >1
563 * 2. dataset@snap1 dataset >0 >1 >0 ==0
564 * 3. @snap1 dataset@snap2 ==0 >1 >0 >1
565 * 4. @snap1 dataset ==0 >1 >0 ==0
567 if (tosnap
== NULL
) {
568 /* only a from snapshot given, must be valid */
569 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
570 dgettext(TEXT_DOMAIN
,
571 "Badly formed snapshot name %s"), fromsnap
);
573 if (!zfs_validate_name(hdl
, fromsnap
, ZFS_TYPE_SNAPSHOT
,
575 return (zfs_error(hdl
, EZFS_INVALIDNAME
,
579 atptrf
= strchr(fromsnap
, '@');
580 ASSERT(atptrf
!= NULL
);
581 fdslen
= atptrf
- fromsnap
;
583 di
->fromsnap
= zfs_strdup(hdl
, fromsnap
);
584 di
->ds
= zfs_strdup(hdl
, fromsnap
);
585 di
->ds
[fdslen
] = '\0';
587 /* the to snap will be a just-in-time snap of the head */
588 return (make_temp_snapshot(di
));
591 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
592 dgettext(TEXT_DOMAIN
,
593 "Unable to determine which snapshots to compare"));
595 atptrf
= strchr(fromsnap
, '@');
596 atptrt
= strchr(tosnap
, '@');
597 fdslen
= atptrf
? atptrf
- fromsnap
: strlen(fromsnap
);
598 tdslen
= atptrt
? atptrt
- tosnap
: strlen(tosnap
);
599 fsnlen
= strlen(fromsnap
) - fdslen
; /* includes @ sign */
600 tsnlen
= strlen(tosnap
) - tdslen
; /* includes @ sign */
602 if (fsnlen
<= 1 || tsnlen
== 1 || (fdslen
== 0 && tdslen
== 0)) {
603 return (zfs_error(hdl
, EZFS_INVALIDNAME
, di
->errbuf
));
604 } else if ((fdslen
> 0 && tdslen
> 0) &&
605 ((tdslen
!= fdslen
|| strncmp(fromsnap
, tosnap
, fdslen
) != 0))) {
607 * not the same dataset name, might be okay if
608 * tosnap is a clone of a fromsnap descendant.
610 char origin
[ZFS_MAX_DATASET_NAME_LEN
];
614 di
->ds
= zfs_alloc(di
->zhp
->zfs_hdl
, tdslen
+ 1);
615 (void) strncpy(di
->ds
, tosnap
, tdslen
);
616 di
->ds
[tdslen
] = '\0';
618 zhp
= zfs_open(hdl
, di
->ds
, ZFS_TYPE_FILESYSTEM
);
619 while (zhp
!= NULL
) {
620 if (zfs_prop_get(zhp
, ZFS_PROP_ORIGIN
, origin
,
621 sizeof (origin
), &src
, NULL
, 0, B_FALSE
) != 0) {
622 (void) zfs_close(zhp
);
626 if (strncmp(origin
, fromsnap
, fsnlen
) == 0)
629 (void) zfs_close(zhp
);
630 zhp
= zfs_open(hdl
, origin
, ZFS_TYPE_FILESYSTEM
);
634 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
635 dgettext(TEXT_DOMAIN
,
636 "Not an earlier snapshot from the same fs"));
637 return (zfs_error(hdl
, EZFS_INVALIDNAME
, di
->errbuf
));
639 (void) zfs_close(zhp
);
642 di
->isclone
= B_TRUE
;
643 di
->fromsnap
= zfs_strdup(hdl
, fromsnap
);
645 di
->tosnap
= zfs_strdup(hdl
, tosnap
);
647 return (make_temp_snapshot(di
));
650 int dslen
= fdslen
? fdslen
: tdslen
;
652 di
->ds
= zfs_alloc(hdl
, dslen
+ 1);
653 (void) strncpy(di
->ds
, fdslen
? fromsnap
: tosnap
, dslen
);
654 di
->ds
[dslen
] = '\0';
656 di
->fromsnap
= zfs_asprintf(hdl
, "%s%s", di
->ds
, atptrf
);
658 di
->tosnap
= zfs_asprintf(hdl
, "%s%s", di
->ds
, atptrt
);
660 return (make_temp_snapshot(di
));
667 get_mountpoint(differ_info_t
*di
, char *dsnm
, char **mntpt
)
671 mounted
= is_mounted(di
->zhp
->zfs_hdl
, dsnm
, mntpt
);
672 if (mounted
== B_FALSE
) {
673 (void) snprintf(di
->errbuf
, sizeof (di
->errbuf
),
674 dgettext(TEXT_DOMAIN
,
675 "Cannot diff an unmounted snapshot"));
676 return (zfs_error(di
->zhp
->zfs_hdl
, EZFS_BADTYPE
, di
->errbuf
));
679 /* Avoid a double slash at the beginning of root-mounted datasets */
680 if (**mntpt
== '/' && *(*mntpt
+ 1) == '\0')
686 get_mountpoints(differ_info_t
*di
)
692 * first get the mountpoint for the parent dataset
694 if (get_mountpoint(di
, di
->ds
, &di
->dsmnt
) != 0)
697 strptr
= strchr(di
->tosnap
, '@');
698 ASSERT3P(strptr
, !=, NULL
);
699 di
->tomnt
= zfs_asprintf(di
->zhp
->zfs_hdl
, "%s%s%s", di
->dsmnt
,
700 ZDIFF_SNAPDIR
, ++strptr
);
702 strptr
= strchr(di
->fromsnap
, '@');
703 ASSERT3P(strptr
, !=, NULL
);
705 frommntpt
= di
->dsmnt
;
711 err
= get_mountpoint(di
, di
->fromsnap
, &mntpt
);
718 di
->frommnt
= zfs_asprintf(di
->zhp
->zfs_hdl
, "%s%s%s", frommntpt
,
719 ZDIFF_SNAPDIR
, ++strptr
);
728 setup_differ_info(zfs_handle_t
*zhp
, const char *fromsnap
,
729 const char *tosnap
, differ_info_t
*di
)
733 di
->cleanupfd
= open(ZFS_DEV
, O_RDWR
);
734 VERIFY(di
->cleanupfd
>= 0);
736 if (get_snapshot_names(di
, fromsnap
, tosnap
) != 0)
739 if (get_mountpoints(di
) != 0)
742 if (find_shares_object(di
) != 0)
749 zfs_show_diffs(zfs_handle_t
*zhp
, int outfd
, const char *fromsnap
,
750 const char *tosnap
, int flags
)
752 zfs_cmd_t zc
= {"\0"};
754 differ_info_t di
= { 0 };
759 (void) snprintf(errbuf
, sizeof (errbuf
),
760 dgettext(TEXT_DOMAIN
, "zfs diff failed"));
762 if (setup_differ_info(zhp
, fromsnap
, tosnap
, &di
)) {
763 teardown_differ_info(&di
);
768 zfs_error_aux(zhp
->zfs_hdl
, strerror(errno
));
769 teardown_differ_info(&di
);
770 return (zfs_error(zhp
->zfs_hdl
, EZFS_PIPEFAILED
, errbuf
));
773 di
.scripted
= (flags
& ZFS_DIFF_PARSEABLE
);
774 di
.classify
= (flags
& ZFS_DIFF_CLASSIFY
);
775 di
.timestamped
= (flags
& ZFS_DIFF_TIMESTAMP
);
778 di
.datafd
= pipefd
[0];
780 if (pthread_create(&tid
, NULL
, differ
, &di
)) {
781 zfs_error_aux(zhp
->zfs_hdl
, strerror(errno
));
782 (void) close(pipefd
[0]);
783 (void) close(pipefd
[1]);
784 teardown_differ_info(&di
);
785 return (zfs_error(zhp
->zfs_hdl
,
786 EZFS_THREADCREATEFAILED
, errbuf
));
790 (void) strlcpy(zc
.zc_value
, di
.fromsnap
, strlen(di
.fromsnap
) + 1);
791 (void) strlcpy(zc
.zc_name
, di
.tosnap
, strlen(di
.tosnap
) + 1);
792 zc
.zc_cookie
= pipefd
[1];
794 iocerr
= ioctl(zhp
->zfs_hdl
->libzfs_fd
, ZFS_IOC_DIFF
, &zc
);
796 (void) snprintf(errbuf
, sizeof (errbuf
),
797 dgettext(TEXT_DOMAIN
, "Unable to obtain diffs"));
798 if (errno
== EPERM
) {
799 zfs_error_aux(zhp
->zfs_hdl
, dgettext(TEXT_DOMAIN
,
800 "\n The sys_mount privilege or diff delegated "
801 "permission is needed\n to execute the "
803 } else if (errno
== EXDEV
) {
804 zfs_error_aux(zhp
->zfs_hdl
, dgettext(TEXT_DOMAIN
,
805 "\n Not an earlier snapshot from the same fs"));
806 } else if (errno
!= EPIPE
|| di
.zerr
== 0) {
807 zfs_error_aux(zhp
->zfs_hdl
, strerror(errno
));
809 (void) close(pipefd
[1]);
810 (void) pthread_cancel(tid
);
811 (void) pthread_join(tid
, NULL
);
812 teardown_differ_info(&di
);
813 if (di
.zerr
!= 0 && di
.zerr
!= EPIPE
) {
814 zfs_error_aux(zhp
->zfs_hdl
, strerror(di
.zerr
));
815 return (zfs_error(zhp
->zfs_hdl
, EZFS_DIFF
, di
.errbuf
));
817 return (zfs_error(zhp
->zfs_hdl
, EZFS_DIFFDATA
, errbuf
));
821 (void) close(pipefd
[1]);
822 (void) pthread_join(tid
, NULL
);
825 zfs_error_aux(zhp
->zfs_hdl
, strerror(di
.zerr
));
826 return (zfs_error(zhp
->zfs_hdl
, EZFS_DIFF
, di
.errbuf
));
828 teardown_differ_info(&di
);