ZFS Automatic Shares
When an automatic (auto) share is created, a unique resource name is constructed from the file system name. The constructed name is a copy of the file system name except that the characters in the file system name that would be illegal in the resource name, are replaced with underscore (_) characters. For example, the resource name of data/home/john
is data_home_john
.
Setting a share.autoname
property name allows you to replace the file system name with a specific name when creating the auto share. The specific name is also used to replace the prefix file system name in the case of inheritance. For example:
$ zfs create -o share.smb=on -o share.autoname=john data/home/john $ zfs create data/home/john/backups $ grep john /etc/dfs/sharetab /data/home/john john smb /data/home/john/backups john_backups smb
If a legacy share
command or the zfs set share
command is used on a file system that has not yet been shared, its share.auto
value is automatically set to off
. The legacy commands always create named shares. This special rule prevents the auto share from interfering with the named share that is being created.