svn commit: r323794 - vendor-sys/illumos/dist/uts/common/fs/zfs vendor/illumos/dist/man/man1m

[Andriy Gapon]

Author: avg
Date: Wed Sep 20 07:27:45 2017
New Revision: 323794
URL: https://svnweb.freebsd.org/changeset/base/323794

Log:
  8605 zfs channel programs: zfs.exists undocumented and non-working
  
  illumos/illumos-gate at 5f39f884e2035d671ec02148fc4d8420c670bcb4
  https://github.com/illumos/illumos-gate/commit/5f39f884e2035d671ec02148fc4d8420c670bcb4
  
  https://www.illumos.org/issues/8605
    zfs.exists() in channel programs doesn't return any result, and should have a
    man page entry.
  
  Reviewed by: Paul Dagnelie <pcd at delphix.com>
  Reviewed by: Dan Kimmel <dan.kimmel at delphix.com>
  Reviewed by: Matt Ahrens <mahrens at delphix.com>
  Approved by: Robert Mustacchi <rm at joyent.com>
  Author: Chris Williamson <chris.williamson at delphix.com>

Modified:
  vendor/illumos/dist/man/man1m/zfs-program.1m

Changes in other areas also in this revision:
Modified:
  vendor-sys/illumos/dist/uts/common/fs/zfs/zcp.c

Modified: vendor/illumos/dist/man/man1m/zfs-program.1m
==============================================================================
--- vendor/illumos/dist/man/man1m/zfs-program.1m	Wed Sep 20 07:26:52 2017	(r323793)
+++ vendor/illumos/dist/man/man1m/zfs-program.1m	Wed Sep 20 07:27:45 2017	(r323794)
@@ -289,6 +289,18 @@ msg (string)
 .Bd -ragged -compact -offset "xxxx"
 Debug message to be printed.
 .Ed
+.It Em zfs.exists(dataset)
+Returns true if the given dataset exists, or false if it doesn't.
+A fatal error will be thrown if the dataset is not in the target pool.
+That is, in a channel program running on rpool,
+zfs.exists("rpool/nonexistent_fs") returns false, but
+zfs.exists("somepool/fs_that_may_exist") will error.
+.Pp
+dataset (string)
+.Bd -ragged -compact -offset "xxxx"
+Dataset to check for existence.
+Must be in the target pool.
+.Ed
 .It Em zfs.get_prop(dataset, property)
 Returns two values.
 First, a string, number or table containing the property value for the given