Print this page
6536 zfs send: want a way to disable sending of free records
Reviewed by: Alexander Stetsenko <astetsenko@racktopsystems.com>
Reviewed by: Kim Shrier <kshrier@racktopsystems.com>

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/zfs.1m
          +++ new/usr/src/man/man1m/zfs.1m
↓ open down ↓ 18 lines elided ↑ open up ↑
  19   19  .\" CDDL HEADER END
  20   20  .\"
  21   21  .\"
  22   22  .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved.
  23   23  .\" Copyright 2011 Joshua M. Clulow <josh@sysmgr.org>
  24   24  .\" Copyright (c) 2011, 2015 by Delphix. All rights reserved.
  25   25  .\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved.
  26   26  .\" Copyright (c) 2014, Joyent, Inc. All rights reserved.
  27   27  .\" Copyright (c) 2014 by Adam Stevko. All rights reserved.
  28   28  .\" Copyright 2015 Nexenta Systems, Inc.  All Rights Reserved.
       29 +.\" Copyright 2015 RackTop Systems.
  29   30  .\"
  30      -.Dd June 8, 2015
       31 +.Dd December 29, 2015
  31   32  .Dt ZFS 1M
  32   33  .Os
  33   34  .Sh NAME
  34   35  .Nm zfs
  35   36  .Nd configures ZFS file systems
  36   37  .Sh SYNOPSIS
  37   38  .Nm
  38   39  .Op Fl \?
  39   40  .Nm
  40   41  .Cm create
↓ open down ↓ 116 lines elided ↑ open up ↑
 157  158  .Cm share
 158  159  .Fl a | Ar filesystem
 159  160  .Nm
 160  161  .Cm unshare
 161  162  .Fl a | Ar filesystem Ns | Ns Ar mountpoint
 162  163  .Nm
 163  164  .Cm bookmark
 164  165  .Ar snapshot bookmark
 165  166  .Nm
 166  167  .Cm send
 167      -.Op Fl DLPRenpv
      168 +.Op Fl DFLPRenpv
 168  169  .Op Oo Fl I Ns | Ns Fl i Oc Ar snapshot
 169  170  .Ar snapshot
 170  171  .Nm
 171  172  .Cm send
 172      -.Op Fl Le
      173 +.Op Fl FLe
 173  174  .Op Fl i Ar snapshot Ns | Ns Ar bookmark
 174  175  .Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
 175  176  .Nm
 176  177  .Cm send
 177  178  .Op Fl Penv
 178  179  .Fl t Ar receive_resume_token
 179  180  .Nm
 180  181  .Cm receive
 181  182  .Op Fl Fnsuv
 182  183  .Op Fl o Sy origin Ns = Ns Ar snapshot
↓ open down ↓ 2279 lines elided ↑ open up ↑
2462 2463  command.
2463 2464  .Pp
2464 2465  This feature must be enabled to be used. See
2465 2466  .Xr zpool-features 5
2466 2467  for details on ZFS feature flags and the
2467 2468  .Sy bookmarks
2468 2469  feature.
2469 2470  .It Xo
2470 2471  .Nm
2471 2472  .Cm send
2472      -.Op Fl DLPRenpv
     2473 +.Op Fl DFLPRenpv
2473 2474  .Op Oo Fl I Ns | Ns Fl i Oc Ar snapshot
2474 2475  .Ar snapshot
2475 2476  .Xc
2476 2477  Creates a stream representation of the second
2477 2478  .Ar snapshot ,
2478 2479  which is written to standard output. The output can be redirected to a file or
2479 2480  to a different system
2480 2481  .Po for example, using
2481 2482  .Xr ssh 1
2482 2483  .Pc .
↓ open down ↓ 63 lines elided ↑ open up ↑
2546 2547  feature is disabled. The receiving system must have the
2547 2548  .Sy embedded_data
2548 2549  feature enabled. If the
2549 2550  .Sy lz4_compress
2550 2551  feature is active on the sending system, then the receiving system must have
2551 2552  that feature enabled as well. See
2552 2553  .Xr zpool-features 5
2553 2554  for details on ZFS feature flags and the
2554 2555  .Sy embedded_data
2555 2556  feature.
     2557 +.It Fl F
     2558 +Generate a stream which omits free records.  The stream will be more compact
     2559 +but the receiving system will not be able to receive the stream as a clone.
2556 2560  .It Fl i Ar snapshot
2557 2561  Generate an incremental stream from the first
2558 2562  .Ar snapshot
2559 2563  .Pq the incremental source
2560 2564  to the second
2561 2565  .Ar snapshot
2562 2566  .Pq the incremental target .
2563 2567  The incremental source can be specified as the last component of the snapshot
2564 2568  name
2565 2569  .Po the
↓ open down ↓ 29 lines elided ↑ open up ↑
2595 2599  .It Fl v
2596 2600  Print verbose information about the stream package generated. This information
2597 2601  includes a per-second report of how much data has been sent.
2598 2602  .Pp
2599 2603  The format of the stream is committed. You will be able to receive your streams
2600 2604  on future versions of ZFS .
2601 2605  .El
2602 2606  .It Xo
2603 2607  .Nm
2604 2608  .Cm send
2605      -.Op Fl Le
     2609 +.Op Fl FLe
2606 2610  .Op Fl i Ar snapshot Ns | Ns Ar bookmark
2607 2611  .Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
2608 2612  .Xc
2609 2613  Generate a send stream, which may be of a filesystem, and may be incremental
2610 2614  from a bookmark. If the destination is a filesystem or volume, the pool must be
2611 2615  read-only, or the filesystem must not be mounted. When the stream generated from
2612 2616  a filesystem or volume is received, the default snapshot name will be
2613 2617  .Qq --head-- .
2614 2618  .Bl -tag -width "-L"
2615 2619  .It Fl L
↓ open down ↓ 20 lines elided ↑ open up ↑
2636 2640  feature is disabled. The receiving system must have the
2637 2641  .Sy embedded_data
2638 2642  feature enabled. If the
2639 2643  .Sy lz4_compress
2640 2644  feature is active on the sending system, then the receiving system must have
2641 2645  that feature enabled as well. See
2642 2646  .Xr zpool-features 5
2643 2647  for details on ZFS feature flags and the
2644 2648  .Sy embedded_data
2645 2649  feature.
     2650 +.It Fl F
     2651 +Generate a stream which omits free records.  The stream will be more compact
     2652 +but the receiving system will not be able to receive the stream as a clone.
2646 2653  .It Fl i Ar snapshot Ns | Ns Ar bookmark
2647 2654  Generate an incremental send stream. The incremental source must be an earlier
2648 2655  snapshot in the destination's history. It will commonly be an earlier snapshot
2649 2656  in the destination's file system, in which case it can be specified as the last
2650 2657  component of the name
2651 2658  .Po the
2652 2659  .Sy #
2653 2660  or
2654 2661  .Sy @
2655 2662  character and following
↓ open down ↓ 892 lines elided ↑ open up ↑
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX