1.\" SPDX-License-Identifier: CDDL-1.0 2.\" 3.\" CDDL HEADER START 4.\" 5.\" The contents of this file are subject to the terms of the 6.\" Common Development and Distribution License (the "License"). 7.\" You may not use this file except in compliance with the License. 8.\" 9.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 10.\" or https://opensource.org/licenses/CDDL-1.0. 11.\" See the License for the specific language governing permissions 12.\" and limitations under the License. 13.\" 14.\" When distributing Covered Code, include this CDDL HEADER in each 15.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE. 16.\" If applicable, add the following below this CDDL HEADER, with the 17.\" fields enclosed by brackets "[]" replaced with your own identifying 18.\" information: Portions Copyright [yyyy] [name of copyright owner] 19.\" 20.\" CDDL HEADER END 21.\" 22.\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved. 23.\" Copyright 2011 Joshua M. Clulow <josh@sysmgr.org> 24.\" Copyright (c) 2011, 2019 by Delphix. All rights reserved. 25.\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved. 26.\" Copyright (c) 2014, Joyent, Inc. All rights reserved. 27.\" Copyright (c) 2014 by Adam Stevko. All rights reserved. 28.\" Copyright (c) 2014 Integros [integros.com] 29.\" Copyright 2019 Richard Laager. All rights reserved. 30.\" Copyright 2018 Nexenta Systems, Inc. 31.\" Copyright 2019 Joyent, Inc. 32.\" 33.Dd March 16, 2022 34.Dt ZFS-DIFF 8 35.Os 36. 37.Sh NAME 38.Nm zfs-diff 39.Nd show difference between ZFS snapshots 40.Sh SYNOPSIS 41.Nm zfs 42.Cm diff 43.Op Fl FHth 44.Ar snapshot Ar snapshot Ns | Ns Ar filesystem 45. 46.Sh DESCRIPTION 47Display the difference between a snapshot of a given filesystem and another 48snapshot of that filesystem from a later time or the current contents of the 49filesystem. 50The first column is a character indicating the type of change, the other columns 51indicate pathname, new pathname 52.Pq in case of rename , 53change in link count, and optionally file type and/or change time. 54The types of change are: 55.Bl -tag -compact -offset Ds -width "M" 56.It Sy - 57The path has been removed 58.It Sy + 59The path has been created 60.It Sy M 61The path has been modified 62.It Sy R 63The path has been renamed 64.El 65.Bl -tag -width "-F" 66.It Fl F 67Display an indication of the type of file, in a manner similar to the 68.Fl F 69option of 70.Xr ls 1 . 71.Bl -tag -compact -offset 2n -width "B" 72.It Sy B 73Block device 74.It Sy C 75Character device 76.It Sy / 77Directory 78.It Sy > 79Door 80.It Sy |\& 81Named pipe 82.It Sy @ 83Symbolic link 84.It Sy P 85Event port 86.It Sy = 87Socket 88.It Sy F 89Regular file 90.El 91.It Fl H 92Give more parsable tab-separated output, without header lines and without 93arrows. 94.It Fl t 95Display the path's inode change time as the first column of output. 96.It Fl h 97Do not 98.Sy \e0 Ns Ar ooo Ns -escape 99non-ASCII paths. 100.El 101. 102.Sh EXAMPLES 103.\" These are, respectively, examples 22 from zfs.8 104.\" Make sure to update them bidirectionally 105.Ss Example 1 : No Showing the differences between a snapshot and a ZFS Dataset 106The following example shows how to see what has changed between a prior 107snapshot of a ZFS dataset and its current state. 108The 109.Fl F 110option is used to indicate type information for the files affected. 111.Bd -literal -compact -offset Ds 112.No # Nm zfs Cm diff Fl F Ar tank/test@before tank/test 113M / /tank/test/ 114M F /tank/test/linked (+1) 115R F /tank/test/oldname -> /tank/test/newname 116- F /tank/test/deleted 117+ F /tank/test/created 118M F /tank/test/modified 119.Ed 120. 121.Sh SEE ALSO 122.Xr zfs-snapshot 8 123