eric kustarz wrote:
> Can we add an example to the manpage?
>
> Something to match the already existing example for NFS ("Example 18
> Setting sharenfs Property Options on a ZFS File System").
>
> eric
>
>
Sure, I've updated the manpage section.
OVERVIEW:
ZFS needs a way to handle "smb" shares. ZFS already has the
sharenfs
property, we need to create a "sharesmb" to handle smb shares.
PROPOSED SOLUTION:
Create a property "sharesmb" that will allow for datasets to be
shared via "smb".
Manpage changes:
348c348,349
< must be lowercase, except for "mountpoint" and "sharenfs".
---
> must be lowercase, except for "mountpoint", "sharenfs" and
> "sharesmb".
650a652
> sharesmb=on | off | opts
651a654,683
> Controls whether the file system is shared via SMB, and
> what options are used. A file system with a sharesmb
> property of "off" is managed through traditional tools
> such as sharemgr(1M). Otherwise, the file system is
> automatically shared and unshared with the "zfs share"
> and "zfs unshare" commands. If the property is set to "on",
> the sharemgr(1M) command is invoked with no options.
> Otherwise, the sharemgr(1M) command is invoked with options
> equivalent to the contents of this property.
>
> Due to the requirement that SMB shares must have a resource
name,
> a unique resource name will be constructed from the data set
name.
> The constructed name will be a copy of the dataset name
except that
> characters in the dataset name which would be illegal in the
> resource name are replaced with underscore (_) characters.
A pseudo
> property "name" is also supported that allows the
administrator to
> replace the data set name with a specified name. The
specified name
> is then used to replace the prefix dataset in the case of
> inheritance. For example, if the dataset "data/home/john" is
set
> with name=john, then data/home/john will have a resource
name of
> john . If there is a sub dataset of data/home/john/backups, it
> will then have a resource name of john_backups.
>
> When the "sharesmb" property is changed for a dataset,
> the dataset and any children inheriting the property are
> re-shared with the new options, only if the property was
> previously "off", or if they were shared before the pro-
> perty was changed. If the new property is "off", the
> file systems are unshared.
>
>
1491,1492c1523,1524
< "sharenfs" property. File systems are shared when the
< "sharenfs" property is set.
---
> "sharenfs" and "sharesmb" properties. File systems are
> shared when the "sharenfs" or "sharesmb" property is set.
1739a1772
> pool/home/bob sharesmb off default
...
> Example 19 Setting sharesmb property option on a ZFS file System
>
> The following will share the file system over SMB with the resource
> name of tank_home
>
> # zfs set sharesmb=on tank/home
>
> The following will share the file system over SMB with the resource
> name of "share1"
>
> # zfs set sharesmb=name=share1 tank/home
>
