zfs property 'shareiscsi' listed in man page, but not supported.

[Frank Roberts]

The 'shareiscsi' property for ZFS volumes is listed in the manpage for the 'zfs' command, but the property cannot be set on ZFS volumes.

root@monremonda:~# zfs create -V 25g zpt/eridian-zv

root@monremonda:~# zfs set shareiscsi=on zpt/eridian-zv
cannot set property for 'zpt/eridian-zv': invalid property 'shareiscsi'

Here are all of the properties for the ZFS volume eridian-zv:
root@monremonda:~# zfs get all zpt/eridian-zv
NAME PROPERTY VALUE SOURCE
zpt/eridian-zv type volume -
zpt/eridian-zv creation Thu Sep 15 21:13 2016 -
zpt/eridian-zv used 25.8G -
zpt/eridian-zv available 376G -
zpt/eridian-zv referenced 12.0K -
zpt/eridian-zv compressratio 1.00x -
zpt/eridian-zv reservation none default
zpt/eridian-zv volsize 25G local
zpt/eridian-zv volblocksize 8K -
zpt/eridian-zv checksum on default
zpt/eridian-zv compression off inherited from zpt
zpt/eridian-zv readonly off default
zpt/eridian-zv copies 1 default
zpt/eridian-zv refreservation 25.8G local
zpt/eridian-zv primarycache all default
zpt/eridian-zv secondarycache all default
zpt/eridian-zv usedbysnapshots 0 -
zpt/eridian-zv usedbydataset 12.0K -
zpt/eridian-zv usedbychildren 0 -
zpt/eridian-zv usedbyrefreservation 25.8G -
zpt/eridian-zv logbias latency default
zpt/eridian-zv dedup off default
zpt/eridian-zv mlslabel none default
zpt/eridian-zv sync standard default
zpt/eridian-zv refcompressratio 1.00x -
zpt/eridian-zv written 12.0K -
zpt/eridian-zv logicalused 4K -
zpt/eridian-zv logicalreferenced 4K -
zpt/eridian-zv snapshot_limit none default
zpt/eridian-zv snapshot_count none default
zpt/eridian-zv snapdev hidden default
zpt/eridian-zv context none default
zpt/eridian-zv fscontext none default
zpt/eridian-zv defcontext none default
zpt/eridian-zv rootcontext none default
zpt/eridian-zv redundant_metadata all default

From 'man zfs':

       shareiscsi=on | off

           Like the sharenfs property, shareiscsi indicates whether a ZFS volume is exported as
           an iSCSI target. The acceptable values for this property are on, off, and type=disk.
           The default value is off. In the future, other target types might be supported. For
           example, tape.

           You might want to set shareiscsi=on for a file system so that all ZFS volumes within
           the file system are shared by default. However, setting this property on a file system
           has no direct effect.

It is also listed in the permissions section:

       Permissions are generally the ability to use a ZFS subcommand or change a ZFS property.
       The following permissions are available:

       ...

         reservation property
         secondarycache property
         setuid property
         shareiscsi property
         sharenfs property
         sharesmb property

       ...

Finally, it is listed in the examples section:

       Example 7 Listing ZFS Properties

       The following command lists all properties for pool/home/bob.

         # zfs get all pool/home/bob
         NAME PROPERTY VALUE SOURCE

         ...

         pool/home/bob acltype off default
         pool/home/bob aclinherit restricted default
         pool/home/bob canmount on default
         pool/home/bob shareiscsi off default
         pool/home/bob xattr on default
         pool/home/bob copies 1 default
         pool/home/bob version 4 -

         ...

I suspect there is a good reason that the property is not supported, but the documentation should be changed so that it does not suggest that 'shareiscsi' is a valid property.

ProblemType: Bug
DistroRelease: Ubuntu 16.04
Package: zfsutils-linux 0.6.5.6-0ubuntu12
ProcVersionSignature: Ubuntu 4.4.0-36.55-generic 4.4.16
Uname: Linux 4.4.0-36-generic x86_64
NonfreeKernelModules: zfs zunicode zcommon znvpair zavl
ApportVersion: 2.20.1-0ubuntu2.1
Architecture: amd64
Date: Thu Sep 15 21:41:52 2016
InstallationDate: Installed on 2016-07-09 (68 days ago)
InstallationMedia: Ubuntu-Server 16.04 LTS "Xenial Xerus" - Release amd64 (20160420.3)
ProcEnviron:
 TERM=xterm
 SHELL=/bin/bash
 PATH=(custom, user)
 LANG=en_US.UTF-8
 XDG_RUNTIME_DIR=<set>
SourcePackage: zfs-linux
UpgradeStatus: No upgrade log present (probably fresh install)
modified.conffile..etc.default.zfs: [modified]
modified.conffile..etc.sudoers.d.zfs: [inaccessible: [Errno 13] Permission denied: '/etc/sudoers.d/zfs']
mtime.conffile..etc.default.zfs: 2016-07-09T21:54:35.283300

[Colin Ian King (colin-king)]

ZFS has inherited this Solaris iSCSI option from upstream ZFS and it is not relevant for Linux.