Public bug reported:
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
** Affects: zfs-linux (Ubuntu)
Importance: Undecided
Status: New
** Tags: amd64 apport-bug xenial
--
You received this bug notification because you are a member of Kernel
Packages, which is subscribed to zfs-linux in Ubuntu.
https://bugs.launchpad.net/bugs/1624179
Title:
zfs property 'shareiscsi' listed in man page, but not supported.
Status in zfs-linux package in Ubuntu:
New
Bug description:
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
To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/zfs-linux/+bug/1624179/+subscriptions
--
Mailing list: https://launchpad.net/~kernel-packages
Post to : kernel-packages@lists.launchpad.net
Unsubscribe : https://launchpad.net/~kernel-packages
More help : https://help.launchpad.net/ListHelp
