xref: /freebsd-src/sys/contrib/openzfs/man/man8/zfs-diff.8 (revision eda14cbc264d6969b02f2b1994cef11148e914f1)
1*eda14cbcSMatt Macy.\"
2*eda14cbcSMatt Macy.\" CDDL HEADER START
3*eda14cbcSMatt Macy.\"
4*eda14cbcSMatt Macy.\" The contents of this file are subject to the terms of the
5*eda14cbcSMatt Macy.\" Common Development and Distribution License (the "License").
6*eda14cbcSMatt Macy.\" You may not use this file except in compliance with the License.
7*eda14cbcSMatt Macy.\"
8*eda14cbcSMatt Macy.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9*eda14cbcSMatt Macy.\" or http://www.opensolaris.org/os/licensing.
10*eda14cbcSMatt Macy.\" See the License for the specific language governing permissions
11*eda14cbcSMatt Macy.\" and limitations under the License.
12*eda14cbcSMatt Macy.\"
13*eda14cbcSMatt Macy.\" When distributing Covered Code, include this CDDL HEADER in each
14*eda14cbcSMatt Macy.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15*eda14cbcSMatt Macy.\" If applicable, add the following below this CDDL HEADER, with the
16*eda14cbcSMatt Macy.\" fields enclosed by brackets "[]" replaced with your own identifying
17*eda14cbcSMatt Macy.\" information: Portions Copyright [yyyy] [name of copyright owner]
18*eda14cbcSMatt Macy.\"
19*eda14cbcSMatt Macy.\" CDDL HEADER END
20*eda14cbcSMatt Macy.\"
21*eda14cbcSMatt Macy.\"
22*eda14cbcSMatt Macy.\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved.
23*eda14cbcSMatt Macy.\" Copyright 2011 Joshua M. Clulow <josh@sysmgr.org>
24*eda14cbcSMatt Macy.\" Copyright (c) 2011, 2019 by Delphix. All rights reserved.
25*eda14cbcSMatt Macy.\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved.
26*eda14cbcSMatt Macy.\" Copyright (c) 2014, Joyent, Inc. All rights reserved.
27*eda14cbcSMatt Macy.\" Copyright (c) 2014 by Adam Stevko. All rights reserved.
28*eda14cbcSMatt Macy.\" Copyright (c) 2014 Integros [integros.com]
29*eda14cbcSMatt Macy.\" Copyright 2019 Richard Laager. All rights reserved.
30*eda14cbcSMatt Macy.\" Copyright 2018 Nexenta Systems, Inc.
31*eda14cbcSMatt Macy.\" Copyright 2019 Joyent, Inc.
32*eda14cbcSMatt Macy.\"
33*eda14cbcSMatt Macy.Dd June 30, 2019
34*eda14cbcSMatt Macy.Dt ZFS-DIFF 8
35*eda14cbcSMatt Macy.Os
36*eda14cbcSMatt Macy.Sh NAME
37*eda14cbcSMatt Macy.Nm zfs Ns Pf - Cm diff
38*eda14cbcSMatt Macy.Nd Display the difference between two snapshots of a given filesystem.
39*eda14cbcSMatt Macy.Sh SYNOPSIS
40*eda14cbcSMatt Macy.Nm
41*eda14cbcSMatt Macy.Cm diff
42*eda14cbcSMatt Macy.Op Fl FHt
43*eda14cbcSMatt Macy.Ar snapshot Ar snapshot Ns | Ns Ar filesystem
44*eda14cbcSMatt Macy.Sh DESCRIPTION
45*eda14cbcSMatt Macy.Bl -tag -width ""
46*eda14cbcSMatt Macy.It Xo
47*eda14cbcSMatt Macy.Nm
48*eda14cbcSMatt Macy.Cm diff
49*eda14cbcSMatt Macy.Op Fl FHt
50*eda14cbcSMatt Macy.Ar snapshot Ar snapshot Ns | Ns Ar filesystem
51*eda14cbcSMatt Macy.Xc
52*eda14cbcSMatt MacyDisplay the difference between a snapshot of a given filesystem and another
53*eda14cbcSMatt Macysnapshot of that filesystem from a later time or the current contents of the
54*eda14cbcSMatt Macyfilesystem.
55*eda14cbcSMatt MacyThe first column is a character indicating the type of change, the other columns
56*eda14cbcSMatt Macyindicate pathname, new pathname
57*eda14cbcSMatt Macy.Pq in case of rename ,
58*eda14cbcSMatt Macychange in link count, and optionally file type and/or change time.
59*eda14cbcSMatt MacyThe types of change are:
60*eda14cbcSMatt Macy.Bd -literal
61*eda14cbcSMatt Macy-       The path has been removed
62*eda14cbcSMatt Macy+       The path has been created
63*eda14cbcSMatt MacyM       The path has been modified
64*eda14cbcSMatt MacyR       The path has been renamed
65*eda14cbcSMatt Macy.Ed
66*eda14cbcSMatt Macy.Bl -tag -width "-F"
67*eda14cbcSMatt Macy.It Fl F
68*eda14cbcSMatt MacyDisplay an indication of the type of file, in a manner similar to the
69*eda14cbcSMatt Macy.Fl
70*eda14cbcSMatt Macyoption of
71*eda14cbcSMatt Macy.Xr ls 1 .
72*eda14cbcSMatt Macy.Bd -literal
73*eda14cbcSMatt MacyB       Block device
74*eda14cbcSMatt MacyC       Character device
75*eda14cbcSMatt Macy/       Directory
76*eda14cbcSMatt Macy>       Door
77*eda14cbcSMatt Macy|       Named pipe
78*eda14cbcSMatt Macy@       Symbolic link
79*eda14cbcSMatt MacyP       Event port
80*eda14cbcSMatt Macy=       Socket
81*eda14cbcSMatt MacyF       Regular file
82*eda14cbcSMatt Macy.Ed
83*eda14cbcSMatt Macy.It Fl H
84*eda14cbcSMatt MacyGive more parsable tab-separated output, without header lines and without
85*eda14cbcSMatt Macyarrows.
86*eda14cbcSMatt Macy.It Fl t
87*eda14cbcSMatt MacyDisplay the path's inode change time as the first column of output.
88*eda14cbcSMatt Macy.El
89*eda14cbcSMatt Macy.El
90*eda14cbcSMatt Macy.Sh SEE ALSO
91*eda14cbcSMatt Macy.Xr zfs-snapshot 8
92