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.man.txt
          +++ new/usr/src/man/man1m/zfs.1m.man.txt
↓ open down ↓ 30 lines elided ↑ open up ↑
  31   31       zfs userspace [-Hinp] [-o field[,field]...] [-s field]... [-S field]...
  32   32           [-t type[,type]...] filesystem|snapshot
  33   33       zfs groupspace [-Hinp] [-o field[,field]...] [-s field]... [-S field]...
  34   34           [-t type[,type]...] filesystem|snapshot
  35   35       zfs mount
  36   36       zfs mount [-Ov] [-o options] -a | filesystem
  37   37       zfs unmount [-f] -a | filesystem|mountpoint
  38   38       zfs share -a | filesystem
  39   39       zfs unshare -a | filesystem|mountpoint
  40   40       zfs bookmark snapshot bookmark
  41      -     zfs send [-DLPRenpv] [[-I|-i] snapshot] snapshot
  42      -     zfs send [-Le] [-i snapshot|bookmark] filesystem|volume|snapshot
       41 +     zfs send [-DFLPRenpv] [[-I|-i] snapshot] snapshot
       42 +     zfs send [-FLe] [-i snapshot|bookmark] filesystem|volume|snapshot
  43   43       zfs send [-Penv] -t receive_resume_token
  44   44       zfs receive [-Fnsuv] [-o origin=snapshot] filesystem|volume|snapshot
  45   45       zfs receive [-Fnsuv] [-d|-e] [-o origin=snapshot] filesystem
  46   46       zfs receive -A filesystem|volume
  47   47       zfs allow filesystem|volume
  48   48       zfs allow [-dglu] user|group[,user|group]...
  49   49           perm|@setname[,perm|@setname]... filesystem|volume
  50   50       zfs allow [-dl] -e|everyone perm|@setname[,perm|@setname]...
  51   51           filesystem|volume
  52   52       zfs allow -c perm|@setname[,perm|@setname]... filesystem|volume
↓ open down ↓ 1422 lines elided ↑ open up ↑
1475 1475             path to a ZFS file system shared on the system.
1476 1476  
1477 1477       zfs bookmark snapshot bookmark
1478 1478         Creates a bookmark of the given snapshot. Bookmarks mark the point in
1479 1479         time when the snapshot was created, and can be used as the incremental
1480 1480         source for a zfs send command.
1481 1481  
1482 1482         This feature must be enabled to be used. See zpool-features(5) for
1483 1483         details on ZFS feature flags and the bookmarks feature.
1484 1484  
1485      -     zfs send [-DLPRenpv] [[-I|-i] snapshot] snapshot
     1485 +     zfs send [-DFLPRenpv] [[-I|-i] snapshot] snapshot
1486 1486         Creates a stream representation of the second snapshot, which is
1487 1487         written to standard output. The output can be redirected to a file or
1488 1488         to a different system (for example, using ssh(1)).  By default, a full
1489 1489         stream is generated.
1490 1490  
1491 1491         -D  Generate a deduplicated stream. Blocks which would have been sent
1492 1492             multiple times in the send stream will only be sent once. The
1493 1493             receiving system must also support this feature to recieve a
1494 1494             deduplicated stream. This flag can be used regardless of the
1495 1495             dataset's dedup property, but performance will be much better if
↓ open down ↓ 29 lines elided ↑ open up ↑
1525 1525  
1526 1526         -e  Generate a more compact stream by using WRITE_EMBEDDED records for
1527 1527             blocks which are stored more compactly on disk by the embedded_data
1528 1528             pool feature. This flag has no effect if the embedded_data feature
1529 1529             is disabled. The receiving system must have the embedded_data
1530 1530             feature enabled. If the lz4_compress feature is active on the
1531 1531             sending system, then the receiving system must have that feature
1532 1532             enabled as well. See zpool-features(5) for details on ZFS feature
1533 1533             flags and the embedded_data feature.
1534 1534  
     1535 +       -F  Generate a stream which omits free records.  The stream will be
     1536 +           more compact but the receiving system will not be able to receive
     1537 +           the stream as a clone.
     1538 +
1535 1539         -i snapshot
1536 1540             Generate an incremental stream from the first snapshot (the
1537 1541             incremental source) to the second snapshot (the incremental
1538 1542             target).  The incremental source can be specified as the last
1539 1543             component of the snapshot name (the @ character and following) and
1540 1544             it is assumed to be from the same file system as the incremental
1541 1545             target.
1542 1546  
1543 1547             If the destination is a clone, the source may be the origin
1544 1548             snapshot, which must be fully specified (for example,
↓ open down ↓ 10 lines elided ↑ open up ↑
1555 1559             implicit when -R is specified. The receiving system must also
1556 1560             support this feature.
1557 1561  
1558 1562         -v  Print verbose information about the stream package generated. This
1559 1563             information includes a per-second report of how much data has been
1560 1564             sent.
1561 1565  
1562 1566             The format of the stream is committed. You will be able to receive
1563 1567             your streams on future versions of ZFS .
1564 1568  
1565      -     zfs send [-Le] [-i snapshot|bookmark] filesystem|volume|snapshot
     1569 +     zfs send [-FLe] [-i snapshot|bookmark] filesystem|volume|snapshot
1566 1570         Generate a send stream, which may be of a filesystem, and may be
1567 1571         incremental from a bookmark. If the destination is a filesystem or
1568 1572         volume, the pool must be read-only, or the filesystem must not be
1569 1573         mounted. When the stream generated from a filesystem or volume is
1570 1574         received, the default snapshot name will be "--head--".
1571 1575  
1572 1576         -L  Generate a stream which may contain blocks larger than 128KB. This
1573 1577             flag has no effect if the large_blocks pool feature is disabled, or
1574 1578             if the recordsize property of this filesystem has never been set
1575 1579             above 128KB. The receiving system must have the large_blocks pool
↓ open down ↓ 2 lines elided ↑ open up ↑
1578 1582  
1579 1583         -e  Generate a more compact stream by using WRITE_EMBEDDED records for
1580 1584             blocks which are stored more compactly on disk by the embedded_data
1581 1585             pool feature. This flag has no effect if the embedded_data feature
1582 1586             is disabled. The receiving system must have the embedded_data
1583 1587             feature enabled. If the lz4_compress feature is active on the
1584 1588             sending system, then the receiving system must have that feature
1585 1589             enabled as well. See zpool-features(5) for details on ZFS feature
1586 1590             flags and the embedded_data feature.
1587 1591  
     1592 +       -F  Generate a stream which omits free records.  The stream will be
     1593 +           more compact but the receiving system will not be able to receive
     1594 +           the stream as a clone.
     1595 +
1588 1596         -i snapshot|bookmark
1589 1597             Generate an incremental send stream. The incremental source must be
1590 1598             an earlier snapshot in the destination's history. It will commonly
1591 1599             be an earlier snapshot in the destination's file system, in which
1592 1600             case it can be specified as the last component of the name (the #
1593 1601             or @ character and following).
1594 1602  
1595 1603             If the incremental target is a clone, the incremental source can be
1596 1604             the origin snapshot, or an earlier snapshot in the origin's
1597 1605             filesystem, or the origin's origin, etc.
↓ open down ↓ 591 lines elided ↑ open up ↑
2189 2197         M       F       /tank/test/modified
2190 2198  
2191 2199  INTERFACE STABILITY
2192 2200       Commited.
2193 2201  
2194 2202  SEE ALSO
2195 2203       gzip(1), ssh(1), mount(1M), share(1M), sharemgr(1M), unshare(1M),
2196 2204       zonecfg(1M), zpool(1M), chmod(2), stat(2), write(2), fsync(3C),
2197 2205       dfstab(4), acl(5), attributes(5)
2198 2206  
2199      -illumos                          June 8, 2015                          illumos
     2207 +illumos                        December 29, 2015                       illumos
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX