Date: Sun, 19 Aug 2012 08:39:02 GMT From: Marcelo Araujo <araujo@FreeBSD.org> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/170764: [zfs] 2399 zfs manual page does not document use of "zfs diff" Message-ID: <201208190839.q7J8d2ko035493@red.freebsd.org> Resent-Message-ID: <201208190840.q7J8e4rj006014@freefall.freebsd.org>
index | next in thread | raw e-mail
>Number: 170764
>Category: docs
>Synopsis: [zfs] 2399 zfs manual page does not document use of "zfs diff"
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: update
>Submitter-Id: current-users
>Arrival-Date: Sun Aug 19 08:40:04 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator: Marcelo Araujo
>Release: 10-CURRENT
>Organization:
FreeBSD
>Environment:
FreeBSD hostb 10.0-CURRENT FreeBSD 10.0-CURRENT #0 r233530: Tue Apr 3 02:11:40 UTC 2012 araujo@hostb:/usr/obj/usr/src/sys/HOSTB i386
>Description:
- A small manpage update, just to document the use of "zfs diff". This patch os partially obtained from Illumos-gate, changeset: 00c2a08cf1bb
>How-To-Repeat:
>Fix:
Patch attached with submission follows:
Index: zfs.8
===================================================================
--- zfs.8 (revision 233530)
+++ zfs.8 (working copy)
@@ -3158,6 +3158,20 @@
group staff @pset,create,mount
-------------------------------------------------------------
.Ed
+.It Sy Example 22 Showing the differences between a snapshot and a ZFS Dataset
+.Pp
+The following example shows how to see what has changed between a prior
+snapshot of a ZFS Dataset and its current state. The -F option is used
+to indicate type information for the files affected.
+.Bd -literal -offset 2n
+.Li # Ic zfs diff -F tank/test@before tank/test
+ M / /tank/test/
+ M F /tank/test/linked (+1)
+ R F /tank/test/oldname -> /tank/test/newname
+ - F /tank/test/deleted
+ + F /tank/test/created
+ M F /tank/test/modified
+.Ed
.El
.Sh EXIT STATUS
The following exit values are returned:
>Release-Note:
>Audit-Trail:
>Unformatted:
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201208190839.q7J8d2ko035493>