Print this page 
NEX-15425 rework share man pages
Reviewed by: Roman Strashkin <roman.strashkin@nexenta.com>
Reviewed by: Matt Barden <matt.barden@nexenta.com>
Reviewed by: Evan Layton <evan.layton@nexenta.com>
NEX-15425 rework share man pages
Reviewed by: Roman Strashkin <roman.strashkin@nexenta.com>
Reviewed by: Matt Barden <matt.barden@nexenta.com>
Reviewed by: Evan Layton <evan.layton@nexenta.com>
NEX-9406 Add a property to show that a dataset has been modified since a snapshot
Reviewed by: Alexey Komarov <alexey.komarov@nexenta.com>
Reviewed by: Sanjay Nadkarni <sanjay.nadkarni@nexenta.com>
NEX-5728 Autosync Destination retention policy not being honoured
Reviewed by: Roman Strashkin <roman.strashkin@nexenta.com>
Reviewed by: Sanjay Nadkarni <sanjay.nadkarni@nexenta.com>
NEX-5795 Rename 'wrc' as 'wbc' in the source and in the tech docs
Reviewed by: Alex Aizman <alex.aizman@nexenta.com>
Reviewed by: Sanjay Nadkarni <sanjay.nadkarni@nexenta.com>
Reviewed by: Alek Pinchuk <alek.pinchuk@nexenta.com>
NEX-5060 WBC: Writecache and deduplication should not be used together
Reviewed by: Alex Aizman <alex.aizman@nexenta.com>
Reviewed by: Saso Kiselkov <saso.kiselkov@nexenta.com>
NEX-5058 WBC: Race between the purging of window and opening new one
Reviewed by: Alek Pinchuk <alek.pinchuk@nexenta.com>
Reviewed by: Alex Aizman <alex.aizman@nexenta.com>
NEX-2830 ZFS smart compression
Reviewed by: Alek Pinchuk <alek.pinchuk@nexenta.com>
Reviewed by: Roman Strashkin <roman.strashkin@nexenta.com>
6358 A faulted pool with only unavailable vdevs triggers assertion failure in libzfs
Reviewed by: Matthew Ahrens <mahrens@delphix.com>
Reviewed by: Andrew Stormont <andyjstormont@gmail.com>
Reviewed by: Serban Maduta <serban.maduta@gmail.com>
Approved by: Dan McDonald <danmcd@omniti.com>
6393 zfs receive a full send as a clone
Reviewed by: Matthew Ahrens <mahrens@delphix.com>
Reviewed by: Prakash Surya <prakash.surya@delphix.com>
Reviewed by: Richard Elling <Richard.Elling@RichardElling.com>
Approved by: Dan McDonald <danmcd@omniti.com>
6434 sa_find_sizes() may compute wrong SA header size
Reviewed-by: Ned Bass <bass6@llnl.gov>
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed by: Andriy Gapon <avg@freebsd.org>
Reviewed by: Matthew Ahrens <mahrens@delphix.com>
Approved by: Robert Mustacchi <rm@joyent.com>
6346 zfs(1M) has spurious comma
Reviewed by: Garrett D'Amore <garrett@damore.org>
Reviewed by: Igor Kozhukhov <ikozhukhov@gmail.com>
Reviewed by: Robert Mustacchi <rm@joyent.com>
Approved by: Gordon Ross <gwr@nexenta.com>
2605 want to resume interrupted zfs send
Reviewed by: George Wilson <george.wilson@delphix.com>
Reviewed by: Paul Dagnelie <pcd@delphix.com>
Reviewed by: Richard Elling <Richard.Elling@RichardElling.com>
Reviewed by: Xin Li <delphij@freebsd.org>
Reviewed by: Arne Jansen <sensille@gmx.net>
Approved by: Dan McDonald <danmcd@omniti.com>
4185 add new cryptographic checksums to ZFS: SHA-512, Skein, Edon-R (fix studio build)
4185 add new cryptographic checksums to ZFS: SHA-512, Skein, Edon-R
Reviewed by: George Wilson <george.wilson@delphix.com>
Reviewed by: Prakash Surya <prakash.surya@delphix.com>
Reviewed by: Saso Kiselkov <saso.kiselkov@nexenta.com>
Reviewed by: Richard Lowe <richlowe@richlowe.net>
Approved by: Garrett D'Amore <garrett@damore.org>
NEX-4582 update wrc test cases for allow to use write back cache per tree of datasets
Reviewed by: Steve Peng <steve.peng@nexenta.com>
Reviewed by: Alex Aizman <alex.aizman@nexenta.com>
5960 zfs recv should prefetch indirect blocks
5925 zfs receive -o origin=
Reviewed by: Prakash Surya <prakash.surya@delphix.com>
Reviewed by: Matthew Ahrens <mahrens@delphix.com>
5409 Remove shareiscsi description and example from zfs(1M)
5988 zfs(1M) diff is excessively indented
Reviewed by: Matthew Ahrens <mahrens@delphix.com>
Approved by: Gordon Ross <gwr@nexenta.com>
5745 zfs set allows only one dataset property to be set at a time
Reviewed by: Christopher Siden <christopher.siden@delphix.com>
Reviewed by: George Wilson <george@delphix.com>
Reviewed by: Matthew Ahrens <mahrens@delphix.com>
Reviewed by: Bayard Bell <buffer.g.overflow@gmail.com>
Reviewed by: Richard PALO <richard@NetBSD.org>
Reviewed by: Steven Hartland <killing@multiplay.co.uk>
Approved by: Rich Lowe <richlowe@richlowe.net>
5764 "zfs send -nv" directs output to stderr
Reviewed by: Matthew Ahrens <mahrens@delphix.com>
Reviewed by: Paul Dagnelie <paul.dagnelie@delphix.com>
Reviewed by: Basil Crow <basil.crow@delphix.com>
Reviewed by: Steven Hartland <killing@multiplay.co.uk>
Reviewed by: Bayard Bell <buffer.g.overflow@gmail.com>
Approved by: Dan McDonald <danmcd@omniti.com>
NEX-4476 WRC: Allow to use write back cache per tree of datasets
Reviewed by: Alek Pinchuk <alek.pinchuk@nexenta.com>
Reviewed by: Alex Aizman <alex.aizman@nexenta.com>
Revert "NEX-4476 WRC: Allow to use write back cache per tree of datasets"
This reverts commit fe97b74444278a6f36fec93179133641296312da.
NEX-4476 WRC: Allow to use write back cache per tree of datasets
Reviewed by: Alek Pinchuk <alek.pinchuk@nexenta.com>
Reviewed by: Alex Aizman <alex.aizman@nexenta.com>
NEX-4028 use lz4 by default
Reviewed by: Saso Kiselkov <saso.kiselkov@nexenta.com>
Reviewed by: Alek Pinchuk <alek.pinchuk@nexenta.com>
NEX-1456 Part 2, port FreeBSD patch - new zfs recv options support
SUP-817 Further clean-up of zfs manpage
OS-123 aclinherit=restricted masks inherited permissions by group perms (groupmask)
OS-102 add man page info and tests for vdev/CoS properties and ZFS meta features
re #11781 rb3701 Update man related tools (add missed files)
re #11781 rb3701 Update man related tools
--HG--
rename : usr/src/cmd/man/src/THIRDPARTYLICENSE => usr/src/cmd/man/THIRDPARTYLICENSE
rename : usr/src/cmd/man/src/THIRDPARTYLICENSE.descrip => usr/src/cmd/man/THIRDPARTYLICENSE.descrip
rename : usr/src/cmd/man/src/man.c => usr/src/cmd/man/man.c
Bug 10481 - Dry run option in 'zfs send' isn't the same as in NexentaStor 3.1
Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/zfs.1m
          +++ new/usr/src/man/man1m/zfs.1m
↓ open down ↓ 93 lines elided ↑ open up ↑ 
  94   94  .Nm
  95   95  .Cm list
  96   96  .Op Fl r Ns | Ns Fl d Ar depth
  97   97  .Op Fl Hp
  98   98  .Oo Fl o Ar property Ns Oo , Ns Ar property Oc Ns ... Oc
  99   99  .Oo Fl s Ar property Oc Ns ...
 100  100  .Oo Fl S Ar property Oc Ns ...
 101  101  .Oo Fl t Ar type Ns Oo , Ns Ar type Oc Ns ... Oc
 102  102  .Oo Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot Oc Ns ...
 103  103  .Nm
 104      -.Cm remap
 105      -.Ar filesystem Ns | Ns Ar volume
 106      -.Nm
 107  104  .Cm set
 108  105  .Ar property Ns = Ns Ar value Oo Ar property Ns = Ns Ar value Oc Ns ...
 109  106  .Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot Ns ...
 110  107  .Nm
 111  108  .Cm get
 112  109  .Op Fl r Ns | Ns Fl d Ar depth
 113  110  .Op Fl Hp
 114  111  .Oo Fl o Ar field Ns Oo , Ns Ar field Oc Ns ... Oc
 115  112  .Oo Fl s Ar source Ns Oo , Ns Ar source Oc Ns ... Oc
 116  113  .Oo Fl t Ar type Ns Oo , Ns Ar type Oc Ns ... Oc
↓ open down ↓ 44 lines elided ↑ open up ↑ 
 161  158  .Cm share
 162  159  .Fl a | Ar filesystem
 163  160  .Nm
 164  161  .Cm unshare
 165  162  .Fl a | Ar filesystem Ns | Ns Ar mountpoint
 166  163  .Nm
 167  164  .Cm bookmark
 168  165  .Ar snapshot bookmark
 169  166  .Nm
 170  167  .Cm send
 171      -.Op Fl DLPRcenpv
      168 +.Op Fl DLPRcenpsv
 172  169  .Op Oo Fl I Ns | Ns Fl i Oc Ar snapshot
 173  170  .Ar snapshot
 174  171  .Nm
 175  172  .Cm send
 176  173  .Op Fl Lce
 177  174  .Op Fl i Ar snapshot Ns | Ns Ar bookmark
 178  175  .Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
 179  176  .Nm
 180  177  .Cm send
 181  178  .Op Fl Penv
 182  179  .Fl t Ar receive_resume_token
 183  180  .Nm
 184  181  .Cm receive
 185      -.Op Fl Fnsuv
 186      -.Op Fl o Sy origin Ns = Ns Ar snapshot
      182 +.Op Fl FKnsuv
      183 +.Oo Fl l Ar filesystem Ns | Ns Ar volume Oc Ns ...
      184 +.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
      185 +.Oo Fl x Ar property Oc Ns ...
 187  186  .Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
 188  187  .Nm
 189  188  .Cm receive
 190      -.Op Fl Fnsuv
      189 +.Op Fl FKnsuv
 191  190  .Op Fl d Ns | Ns Fl e
 192      -.Op Fl o Sy origin Ns = Ns Ar snapshot
      191 +.Oo Fl l Ar filesystem Ns | Ns Ar volume Oc Ns ...
      192 +.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
      193 +.Oo Fl x Ar property Oc Ns ...
 193  194  .Ar filesystem
 194  195  .Nm
 195  196  .Cm receive
 196  197  .Fl A
 197  198  .Ar filesystem Ns | Ns Ar volume
 198  199  .Nm
 199  200  .Cm allow
 200  201  .Ar filesystem Ns | Ns Ar volume
 201  202  .Nm
 202  203  .Cm allow
↓ open down ↓ 403 lines elided ↑ open up ↑ 
 606  607  The logical space ignores the effect of the
 607  608  .Sy compression
 608  609  and
 609  610  .Sy copies
 610  611  properties, giving a quantity closer to the amount of data that applications
 611  612  see.
 612  613  However, it does include space consumed by metadata.
 613  614  .Pp
 614  615  This property can also be referred to by its shortened column name,
 615  616  .Sy lused .
      617 +.It Sy modified
      618 +For a snapshot, indicates whether the parent filesystem or volume has
      619 +been modified since the snapshot.
      620 +This property can be either
      621 +.Sy yes
      622 +or
      623 +.Sy no .
 616  624  .It Sy mounted
 617  625  For file systems, indicates whether the file system is currently mounted.
 618  626  This property can be either
 619  627  .Sy yes
 620  628  or
 621  629  .Sy no .
 622  630  .It Sy origin
 623  631  For cloned file systems or volumes, the snapshot from which the clone was
 624  632  created.
 625  633  See also the
↓ open down ↓ 447 lines elided ↑ open up ↑ 
1073 1081  .Xr gzip 1
1074 1082  .Pc .
1075 1083  .Pp
1076 1084  The
1077 1085  .Sy zle
1078 1086  compression algorithm compresses runs of zeros.
1079 1087  .Pp
1080 1088  This property can also be referred to by its shortened column name
1081 1089  .Sy compress .
1082 1090  Changing this property affects only newly-written data.
     1091 +.It Sy smartcompression Ns = Ns Sy on Ns | Ns Sy off
     1092 +Smart compression is a feature which optimizes compression performance
     1093 +on filesystems which contain a mixture of compressible and
     1094 +incompressible data.
     1095 +When
     1096 +.Sy compression
     1097 +is enabled on a filesystem, smart compression dynamically tracks per-file
     1098 +compression ratios to determine if a file is compressible or not.
     1099 +When the compression ratio being achieved is too low, smart compression
     1100 +progressively backs off attempting to compress the file.
     1101 +.Pp
     1102 +The algorithm periodically checks whether new data written to a file
     1103 +previously deemed incompressible is still not compressible and adjusts
     1104 +behavior accordingly.
     1105 +Certain types of files, such as virtual machine disk files or large database
     1106 +files, can contain a mixture of both types of data.
     1107 +Although smart compression tries to detect these situations, in marginal cases
     1108 +it can be too pessimistic, which results in a reduction of the overall
     1109 +compression ratio.
     1110 +In this case, setting the
     1111 +.Sy smartcompression
     1112 +property to
     1113 +.Sy off
     1114 +turns off smart compression
     1115 +on a filesystem, so that data is always compressed regardless of the
     1116 +compression ratio achieved.
     1117 +.Pp
     1118 +The default value is
     1119 +.Sy on .
1083 1120  .It Sy copies Ns = Ns Sy 1 Ns | Ns Sy 2 Ns | Ns Sy 3
1084 1121  Controls the number of copies of data stored for this dataset.
1085 1122  These copies are in addition to any redundancy provided by the pool, for
1086 1123  example, mirroring or RAID-Z.
1087 1124  The copies are stored on different disks, if possible.
1088 1125  The space used by multiple copies is charged to the associated file and dataset,
1089 1126  changing the
1090 1127  .Sy used
1091 1128  property and counting against quotas and reservations.
1092 1129  .Pp
↓ open down ↓ 306 lines elided ↑ open up ↑ 
1399 1436  .Sy sharesmb
1400 1437  property set to
1401 1438  .Sy off
1402 1439  is managed through traditional tools such as
1403 1440  .Xr sharemgr 1M .
1404 1441  Otherwise, the file system is automatically shared and unshared with the
1405 1442  .Nm zfs Cm share
1406 1443  and
1407 1444  .Nm zfs Cm unshare
1408 1445  commands.
1409      -If the property is set to
1410      -.Sy on ,
1411      -the
1412      -.Xr sharemgr 1M
1413      -command is invoked with no options.
1414      -Otherwise, the
1415      -.Xr sharemgr 1M
1416      -command is invoked with options equivalent to the contents of this property.
     1446 +See
     1447 +.Xr sharesmb 5
     1448 +for the share options description.
1417 1449  .Pp
1418 1450  Because SMB shares requires a resource name, a unique resource name is
1419 1451  constructed from the dataset name.
1420 1452  The constructed name is a copy of the dataset name except that the characters in
1421 1453  the dataset name, which would be invalid in the resource name, are replaced with
1422 1454  underscore
1423 1455  .Pq Sy _
1424 1456  characters.
1425 1457  A pseudo property
1426 1458  .Qq name
↓ open down ↓ 43 lines elided ↑ open up ↑ 
1470 1502  is managed through traditional tools such as
1471 1503  .Xr share 1M ,
1472 1504  .Xr unshare 1M ,
1473 1505  and
1474 1506  .Xr dfstab 4 .
1475 1507  Otherwise, the file system is automatically shared and unshared with the
1476 1508  .Nm zfs Cm share
1477 1509  and
1478 1510  .Nm zfs Cm unshare
1479 1511  commands.
1480      -If the property is set to
1481      -.Sy on ,
1482      -.Xr share 1M
1483      -command is invoked with no options.
1484      -Otherwise, the
1485      -.Xr share 1M
1486      -command is invoked with options equivalent to the contents of this property.
     1512 +See
     1513 +.Xr sharenfs 5
     1514 +for the share options description.
1487 1515  .Pp
1488 1516  When the
1489 1517  .Sy sharenfs
1490 1518  property is changed for a dataset, the dataset and any children inheriting the
1491 1519  property are re-shared with the new options, only if the property was previously
1492 1520  .Sy off ,
1493 1521  or if they were shared before the property was changed.
1494 1522  If the new property is
1495 1523  .Sy off ,
1496 1524  the file systems are unshared.
↓ open down ↓ 96 lines elided ↑ open up ↑ 
1593 1621  For a sparse volume, changes to
1594 1622  .Sy volsize
1595 1623  are not reflected in the reservation.
1596 1624  .It Sy vscan Ns = Ns Sy on Ns | Ns Sy off
1597 1625  Controls whether regular files should be scanned for viruses when a file is
1598 1626  opened and closed.
1599 1627  In addition to enabling this property, the virus scan service must also be
1600 1628  enabled for virus scanning to occur.
1601 1629  The default value is
1602 1630  .Sy off .
     1631 +.It Sy wbc_mode Ns = Ns Sy on Ns | Ns Sy off
     1632 +Controls the mode of write back cache.
     1633 +After the property has been set on a dataset all the child datasets inherit the
     1634 +property.
     1635 +Due to its recursive nature the property will conflict with any child dataset or
     1636 +any parent dataset having this property enabled as well.
     1637 +The property cannot be set if the target pool does not have special device
     1638 +.Pq special vdev .
     1639 +The default value is
     1640 +.Sy off .
     1641 +This property cannot be enabled together with the
     1642 +.Sy dedup
     1643 +property.
1603 1644  .It Sy xattr Ns = Ns Sy on Ns | Ns Sy off
1604 1645  Controls whether extended attributes are enabled for this file system.
1605 1646  The default value is
1606 1647  .Sy on .
1607 1648  .It Sy zoned Ns = Ns Sy on Ns | Ns Sy off
1608 1649  Controls whether the dataset is managed from a non-global zone.
1609 1650  See the
1610 1651  .Sx Zones
1611 1652  section for more information.
1612 1653  The default value is
↓ open down ↓ 777 lines elided ↑ open up ↑ 
2390 2431  .It Fl r
2391 2432  Recursively inherit the given property for all children.
2392 2433  .It Fl S
2393 2434  Revert the property to the received value if one exists; otherwise operate as
2394 2435  if the
2395 2436  .Fl S
2396 2437  option was not specified.
2397 2438  .El
2398 2439  .It Xo
2399 2440  .Nm
2400      -.Cm remap
2401      -.Ar filesystem Ns | Ns Ar volume
2402      -.Xc
2403      -Remap the indirect blocks in the given fileystem or volume so that they no
2404      -longer reference blocks on previously removed vdevs and we can eventually
2405      -shrink the size of the indirect mapping objects for the previously removed
2406      -vdevs. Note that remapping all blocks might not be possible and that
2407      -references from snapshots will still exist and cannot be remapped.
2408      -.It Xo
2409      -.Nm
2410 2441  .Cm upgrade
2411 2442  .Xc
2412 2443  Displays a list of file systems that are not the most recent version.
2413 2444  .It Xo
2414 2445  .Nm
2415 2446  .Cm upgrade
2416 2447  .Fl v
2417 2448  .Xc
2418 2449  Displays a list of currently supported file system versions.
2419 2450  .It Xo
↓ open down ↓ 233 lines elided ↑ open up ↑ 
2653 2684  .Pp
2654 2685  This feature must be enabled to be used.
2655 2686  See
2656 2687  .Xr zpool-features 5
2657 2688  for details on ZFS feature flags and the
2658 2689  .Sy bookmarks
2659 2690  feature.
2660 2691  .It Xo
2661 2692  .Nm
2662 2693  .Cm send
2663      -.Op Fl DLPRcenpv
     2694 +.Op Fl DLPRcenpsv
2664 2695  .Op Oo Fl I Ns | Ns Fl i Oc Ar snapshot
2665 2696  .Ar snapshot
2666 2697  .Xc
2667 2698  Creates a stream representation of the second
2668 2699  .Ar snapshot ,
2669 2700  which is written to standard output.
2670 2701  The output can be redirected to a file or to a different system
2671 2702  .Po for example, using
2672 2703  .Xr ssh 1
2673 2704  .Pc .
↓ open down ↓ 51 lines elided ↑ open up ↑ 
2725 2756  .Fl I
2726 2757  flags are used in conjunction with the
2727 2758  .Fl R
2728 2759  flag, an incremental replication stream is generated.
2729 2760  The current values of properties, and current snapshot and file system names are
2730 2761  set when the stream is received.
2731 2762  If the
2732 2763  .Fl F
2733 2764  flag is specified when this stream is received, snapshots and file systems that
2734 2765  do not exist on the sending side are destroyed.
     2766 +If the
     2767 +.Fl K
     2768 +flag is specified in conjunction with
     2769 +.Fl F
     2770 +flag, then it modifies the conventional force-receive behavior to not destroy
     2771 +destination snapshots that are not present at the replication source.
2735 2772  .It Fl e, -embed
2736 2773  Generate a more compact stream by using
2737 2774  .Sy WRITE_EMBEDDED
2738 2775  records for blocks which are stored more compactly on disk by the
2739 2776  .Sy embedded_data
2740 2777  pool feature.
2741 2778  This flag has no effect if the
2742 2779  .Sy embedded_data
2743 2780  feature is disabled.
2744 2781  The receiving system must have the
↓ open down ↓ 62 lines elided ↑ open up ↑ 
2807 2844  In this case, the verbose output will be written to standard output
2808 2845  .Po contrast with a non-dry-run, where the stream is written to standard output
2809 2846  and the verbose output goes to standard error
2810 2847  .Pc .
2811 2848  .It Fl p, -props
2812 2849  Include the dataset's properties in the stream.
2813 2850  This flag is implicit when
2814 2851  .Fl R
2815 2852  is specified.
2816 2853  The receiving system must also support this feature.
     2854 +.It Fl s
     2855 +Calculate send stream size.
     2856 +Do not generate any actual send data.
     2857 +This is useful when one needs to know stream size in order to store the stream
     2858 +externally.
     2859 +With
     2860 +.Fl v
     2861 +specified, provides info on stream header and stream data portion sizes, in
     2862 +addition to the total stream size.
2817 2863  .It Fl v, -verbose
2818 2864  Print verbose information about the stream package generated.
2819 2865  This information includes a per-second report of how much data has been sent.
2820 2866  .Pp
2821 2867  The format of the stream is committed.
2822 2868  You will be able to receive your streams on future versions of ZFS .
2823 2869  .El
2824 2870  .It Xo
2825 2871  .Nm
2826 2872  .Cm send
↓ open down ↓ 91 lines elided ↑ open up ↑ 
2918 2964  The
2919 2965  .Ar receive_resume_token
2920 2966  is the value of this property on the filesystem or volume that was being
2921 2967  received into.
2922 2968  See the documentation for
2923 2969  .Sy zfs receive -s
2924 2970  for more details.
2925 2971  .It Xo
2926 2972  .Nm
2927 2973  .Cm receive
2928      -.Op Fl Fnsuv
2929      -.Op Fl o Sy origin Ns = Ns Ar snapshot
     2974 +.Op Fl FKsnuv
     2975 +.Oo Fl l Ar filesystem Ns | Ns Ar volume Oc Ns ...
     2976 +.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
     2977 +.Oo Fl x Ar property Oc Ns ...
2930 2978  .Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
2931 2979  .Xc
2932 2980  .It Xo
2933 2981  .Nm
2934 2982  .Cm receive
2935      -.Op Fl Fnsuv
     2983 +.Op Fl FKnsuv
2936 2984  .Op Fl d Ns | Ns Fl e
2937      -.Op Fl o Sy origin Ns = Ns Ar snapshot
     2985 +.Oo Fl l Ar filesystem Ns | Ns Ar volume Oc Ns ...
     2986 +.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
     2987 +.Oo Fl x Ar property Oc Ns ...
2938 2988  .Ar filesystem
2939 2989  .Xc
2940 2990  Creates a snapshot whose contents are as specified in the stream provided on
2941 2991  standard input.
2942 2992  If a full stream is received, then a new file system is created as well.
2943 2993  Streams are created using the
2944 2994  .Nm zfs Cm send
2945 2995  subcommand, which by default creates a full stream.
2946 2996  .Nm zfs Cm recv
2947 2997  can be used as an alias for
↓ open down ↓ 62 lines elided ↑ open up ↑ 
3010 3060  is used as the target file system name.
3011 3061  .Bl -tag -width "-F"
3012 3062  .It Fl F
3013 3063  Force a rollback of the file system to the most recent snapshot before
3014 3064  performing the receive operation.
3015 3065  If receiving an incremental replication stream
3016 3066  .Po for example, one generated by
3017 3067  .Nm zfs Cm send Fl R Op Fl i Ns | Ns Fl I
3018 3068  .Pc ,
3019 3069  destroy snapshots and file systems that do not exist on the sending side.
     3070 +.It Fl K
     3071 +When force receive is enabled, do not destroy snapshots on the receiving side
     3072 +that do not exist on the sending side.
3020 3073  .It Fl d
3021 3074  Discard the first element of the sent snapshot's file system name, using the
3022 3075  remaining elements to determine the name of the target file system for the new
3023 3076  snapshot as described in the paragraph above.
3024 3077  .It Fl e
3025 3078  Discard all but the last element of the sent snapshot's file system name, using
3026 3079  that element to determine the name of the target file system for the new
3027 3080  snapshot as described in the paragraph above.
     3081 +.It Fl l Ar filesystem Ns | Ns Ar volume
     3082 +Limits the receive to only the
     3083 +.Ar filesystem
     3084 +or
     3085 +.Ar volume
     3086 +specified.
     3087 +As multiple options may be specified, this can be used to restore specific
     3088 +filesystems or volumes from the received stream.
3028 3089  .It Fl n
3029 3090  Do not actually receive the stream.
3030 3091  This can be useful in conjunction with the
3031 3092  .Fl v
3032 3093  option to verify the name the receive operation would use.
     3094 +.It Fl o Ar property Ns = Ns Ar value
     3095 +Sets the specified
     3096 +.Ar property
     3097 +to
     3098 +.Ar value
     3099 +during receive of the stream.
     3100 +Specifying multiple
     3101 +.Fl o
     3102 +options is allowed.
3033 3103  .It Fl o Sy origin Ns = Ns Ar snapshot
3034 3104  Forces the stream to be received as a clone of the given snapshot.
3035 3105  If the stream is a full send stream, this will create the filesystem
3036 3106  described by the stream as a clone of the specified snapshot.
3037 3107  Which snapshot was specified will not affect the success or failure of the
3038 3108  receive, as long as the snapshot does exist.
3039 3109  If the stream is an incremental send stream, all the normal verification will be
3040 3110  performed.
3041 3111  .It Fl u
3042 3112  File system that is associated with the received stream is not mounted.
3043 3113  .It Fl v
3044 3114  Print verbose information about the stream and the time required to perform the
3045 3115  receive operation.
     3116 +.It Fl x Ar property
     3117 +Excludes the specified property from the received stream as if it was not
     3118 +included in the send stream.
     3119 +Specifying multiple
     3120 +.Fl x
     3121 +options is allowed.
3046 3122  .It Fl s
3047 3123  If the receive is interrupted, save the partially received state, rather
3048 3124  than deleting it.
3049 3125  Interruption may be due to premature termination of the stream
3050 3126  .Po e.g. due to network failure or failure of the remote system
3051 3127  if the stream is being read over a network connection
3052 3128  .Pc ,
3053 3129  a checksum error in the stream, termination of the
3054 3130  .Nm zfs Cm receive
3055 3131  process, or unclean shutdown of the system.
↓ open down ↓ 800 lines elided ↑ open up ↑ 
3856 3932  +       F       /tank/test/created
3857 3933  M       F       /tank/test/modified
3858 3934  .Ed
3859 3935  .El
3860 3936  .Sh INTERFACE STABILITY
3861 3937  .Sy Committed .
3862 3938  .Sh SEE ALSO
3863 3939  .Xr gzip 1 ,
3864 3940  .Xr ssh 1 ,
3865 3941  .Xr mount 1M ,
3866      -.Xr share 1M ,
3867 3942  .Xr sharemgr 1M ,
3868      -.Xr unshare 1M ,
3869 3943  .Xr zonecfg 1M ,
3870 3944  .Xr zpool 1M ,
3871 3945  .Xr chmod 2 ,
3872 3946  .Xr stat 2 ,
3873 3947  .Xr write 2 ,
3874 3948  .Xr fsync 3C ,
3875 3949  .Xr dfstab 4 ,
3876 3950  .Xr acl 5 ,
3877      -.Xr attributes 5
     3951 +.Xr attributes 5 ,
     3952 +.Xr sharenfs 5 ,
     3953 +.Xr sharesmb 5
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX