From owner-freebsd-doc@FreeBSD.ORG Sun Aug 19 08:40:04 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8EB071065675 for ; Sun, 19 Aug 2012 08:40:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 4EC4F8FC16 for ; Sun, 19 Aug 2012 08:40:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7J8e44s006015 for ; Sun, 19 Aug 2012 08:40:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7J8e4rj006014; Sun, 19 Aug 2012 08:40:04 GMT (envelope-from gnats) Resent-Date: Sun, 19 Aug 2012 08:40:04 GMT Resent-Message-Id: <201208190840.q7J8e4rj006014@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Marcelo Araujo Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DC4AC1065670 for ; Sun, 19 Aug 2012 08:39:02 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id C7A1D8FC0C for ; Sun, 19 Aug 2012 08:39:02 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q7J8d2Tu035494 for ; Sun, 19 Aug 2012 08:39:02 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q7J8d2ko035493; Sun, 19 Aug 2012 08:39:02 GMT (envelope-from nobody) Message-Id: <201208190839.q7J8d2ko035493@red.freebsd.org> Date: Sun, 19 Aug 2012 08:39:02 GMT From: Marcelo Araujo To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/170764: [zfs] 2399 zfs manual page does not document use of "zfs diff" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 19 Aug 2012 08:40:04 -0000 >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: