From 7682a9dfd8d97835780568cb829960a352344a55 Mon Sep 17 00:00:00 2001 From: Mrt134 Date: Fri, 15 Mar 2019 14:16:25 -0400 Subject: [PATCH 1/4] Doc queue #56: expand description of a few VFS modules HTML build test: no issues. --- userguide/sharing.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/userguide/sharing.rst b/userguide/sharing.rst index fd2b69d69..3cd7ed515 100644 --- a/userguide/sharing.rst +++ b/userguide/sharing.rst @@ -915,7 +915,7 @@ provides more details for each configurable option. | Setting | Value | Advanced | Description | | | | Mode | | +================================+===============+==========+======================================================================================================================================================+ - | Path | browse | | Select the volume, dataset, or directory to share. The same path can be used by more than one share. | + | Path | browse | | Select the volume, dataset, or directory to share. The same path can be used by more than one share. | | | button | | | +--------------------------------+---------------+----------+------------------------------------------------------------------------------------------------------------------------------------------------------+ | Name | string | | Enter a name for this share. An existing SMB share name can not be reused. | @@ -1072,10 +1072,10 @@ for more details. | commit | Tracks the amount of data written to a file and synchronizes it to disk when a specified amount accumulates. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | crossrename | Allows server side rename operations even if source and target are on different physical devices. | - | | | + | crossrename | Allows server side rename operations even if source and target are on different physical devices. Required for the recycle bin | + | | to work across dataset boundaries. Automatically added when :guilabel:`Export Recycle Bin` is enabled. | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | default_quota | Stores the default quotas that are reported to a windows client in the quota record of a user. | + | default_quota | **Deprecated: use ixnas module** Stores the default quotas that are reported to a windows client in the quota record of a user. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ | dfs_samba4 | Distributed file system for providing an alternative name space, load balancing, and automatic failover. | @@ -1169,8 +1169,8 @@ for more details. | unityed_media | Allows multiple Avid clients to share a network drive. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | winmsa | Emulate Microsoft's MoveSecurityAttributes=0 registry option, setting the ACL for file and directory hierarchies | - | | to inherit from the parent directory into which they are moved. | + | winmsa | Emulates the Microsoft *MoveSecurityAttributes=0* registry option. Moving files or directories sets the ACL for file and | + | | directory hierarchies to inherit from the destination directory. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ | worm | Controls the writability of files and folders depending on their change time and an adjustable grace period. | From c5ba760ace58ff49ed25f8e3957bfa8dc10f203c Mon Sep 17 00:00:00 2001 From: Mrt134 Date: Fri, 22 Mar 2019 07:00:04 -0400 Subject: [PATCH 2/4] Update VFS Modules table from feedback. HTML build test: no issues. --- userguide/sharing.rst | 62 +++++++++++++++++++++---------------------- 1 file changed, 31 insertions(+), 31 deletions(-) diff --git a/userguide/sharing.rst b/userguide/sharing.rst index 43de22d96..9338a34e4 100644 --- a/userguide/sharing.rst +++ b/userguide/sharing.rst @@ -1047,50 +1047,50 @@ for more details. | Value | Description | | | | +=====================+=================================================================================================================================+ - | acl_tdb | Stores NTFS ACLs in a tdb file to enable full mapping of Windows ACLs. | + | acl_tdb | Store NTFS ACLs in a tdb file to enable full mapping of Windows ACLs. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | acl_xattr | Stores NTFS ACLs in Extended Attributes (EAs) to enable the full mapping of Windows ACLs. | + | acl_xattr | Store NTFS ACLs in Extended Attributes (EAs) to enable the full mapping of Windows ACLs. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | aio_fork | Enables async I/O. | + | aio_fork | Enable async I/O. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | audit | Logs share access, connects/disconnects, directory opens/creates/removes, | + | audit | Log share access, connects/disconnects, directory opens/creates/removes, | | | and file opens/closes/renames/unlinks/chmods to syslog. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | cacheprime | Primes the kernel file data cache. | + | cacheprime | Prime the kernel file data cache. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | cap | Translates filenames to and from the CAP encoding format, commonly used in Japanese language environments. | + | cap | Translate filenames to and from the CAP encoding format, commonly used in Japanese language environments. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | catia | Improves Mac interoperability by translating characters that are unsupported by Windows. | + | catia | Improve Mac interoperability by translating characters that are unsupported by Windows. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | commit | Tracks the amount of data written to a file and synchronizes it to disk when a specified amount accumulates. | + | commit | Track the amount of data written to a file and synchronizes it to disk when a specified amount accumulates. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | crossrename | Allows server side rename operations even if source and target are on different physical devices. Required for the recycle bin | + | crossrename | Allow server side rename operations even if source and target are on different physical devices. Required for the recycle bin | | | to work across dataset boundaries. Automatically added when :guilabel:`Export Recycle Bin` is enabled. | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | default_quota | **Deprecated: use ixnas module** Stores the default quotas that are reported to a windows client in the quota record of a user. | - | | | + | default_quota | **Deprecated: use the ixnas module instead.** Store the default quotas that are reported to a Windows client in the quota | + | | record of a user. | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | dirsort | Sorts directory entries alphabetically before sending them to the client. | + | dirsort | Sort directory entries alphabetically before sending them to the client. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | expand_msdfs | Enables support for Microsoft Distributed File System (DFS). | + | expand_msdfs | Enable support for Microsoft Distributed File System (DFS). | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | extd_audit | Sends :guilabel:`audit` logs to both syslog and the Samba log files. | + | extd_audit | Send :guilabel:`audit` logs to both syslog and the Samba log files. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | fake_perms | Allows roaming profile files and directories to be set as read-only. | + | fake_perms | Allow roaming profile files and directories to be set as read-only. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | fruit | Enhances macOS support by providing the SMB2 AAPL extension and Netatalk interoperability. | + | fruit | Enhance macOS support by providing the SMB2 AAPL extension and Netatalk interoperability. | | | Automatically loads *catia* and *streams_xattr* but read the caveat in NOTE below table. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ @@ -1104,17 +1104,17 @@ for more details. | linux_xfs_sgid | Used to work around an old Linux XFS bug. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | media_harmony | Allows Avid editorial workstations to share a network drive. | + | media_harmony | Allow Avid editorial workstations to share a network drive. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | netatalk | Eases the co-existence of SMB and AFP shares. | + | netatalk | Ease the co-existence of SMB and AFP shares. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | offline | Marks all files in the share with the DOS *offline* attribute. | + | offline | Mark all files in the share with the DOS *offline* attribute. | | | This can prevent Windows Explorer from reading files just to make thumbnail images. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | posix_eadb | Provides Extended Attributes (EAs) support so they can be used on filesystems which do not provide native support for EAs. | + | posix_eadb | Provide Extended Attributes (EAs) support so they can be used on filesystems which do not provide native support for EAs. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ | preopen | Useful for video streaming applications that want to read one file per frame. | @@ -1123,17 +1123,17 @@ for more details. | readahead | Useful for Windows Vista clients reading data using Windows Explorer. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | readonly | Marks a share as read-only for all clients connecting within the configured time period. | + | readonly | Mark a share as read-only for all clients connecting within the configured time period. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | shadow_copy | Allows Microsoft shadow copy clients to browse shadow copies on Windows shares. | + | shadow_copy | Allow Microsoft shadow copy clients to browse shadow copies on Windows shares. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ | shadow_copy_zfs | Allow Microsoft shadow copy clients to browse shadow copies on Windows shares. This object uses | | | :ref:`ZFS snapshots ` of the shared pool or dataset to create the shadow copies. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | shell_snap | Provides shell-script callouts for snapshot creation and deletion operations issued | + | shell_snap | Provide shell-script callouts for snapshot creation and deletion operations issued | | | by remote clients using the File Server Remote VSS Protocol (FSRVP). | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ @@ -1142,30 +1142,30 @@ for more details. | | (see ``__). | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | streams_xattr | Enabled by default. Enables storing of NTFS alternate data streams in the file system. | + | streams_xattr | Enabled by default. Enable storing NTFS alternate data streams in the file system. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | syncops | Ensures metadata operations are performed synchronously. | + | syncops | Ensure metadata operations are performed synchronously. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | time_audit | Logs system calls that take longer than the number of defined milliseconds. | + | time_audit | Log system calls that take longer than the number of defined milliseconds. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | unityed_media | Allows multiple Avid clients to share a network drive. | + | unityed_media | Allow multiple Avid clients to share a network drive. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ | virusfilter | This extremely **experimental** module is still under development and does not work at this time. | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | winmsa | Emulates the Microsoft *MoveSecurityAttributes=0* registry option. Moving files or directories sets the ACL for file and | + | winmsa | Emulate the Microsoft *MoveSecurityAttributes=0* registry option. Moving files or directories sets the ACL for file and | | | directory hierarchies to inherit from the destination directory. | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | worm | Controls the writability of files and folders depending on their change time and an adjustable grace period. | + | worm | Control the writability of files and folders depending on their change time and an adjustable grace period. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | xattr_tdb | Stores Extended Attributes (EAs) in a tdb file so they can be used on filesystems which do not provide support for EAs. | + | xattr_tdb | Store Extended Attributes (EAs) in a tdb file so they can be used on filesystems which do not provide support for EAs. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | zfs_space | Correctly calculates ZFS space used by the share, including space used by ZFS snapshots, quotas, and resevations. | + | zfs_space | Correctly calculate ZFS space used by the share, including space used by ZFS snapshots, quotas, and resevations. | | | Enabled by default. | | | | +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ From 994879a945d1e27d736fa498ed5d442e8bdb0723 Mon Sep 17 00:00:00 2001 From: Mrt134 Date: Mon, 8 Apr 2019 08:01:08 -0400 Subject: [PATCH 3/4] Update from Warren review. HTML build test: no issues. --- userguide/sharing.rst | 270 +++++++++++++++++++++--------------------- 1 file changed, 136 insertions(+), 134 deletions(-) diff --git a/userguide/sharing.rst b/userguide/sharing.rst index 9338a34e4..5e6b96382 100644 --- a/userguide/sharing.rst +++ b/userguide/sharing.rst @@ -1043,140 +1043,142 @@ for more details. .. table:: Available VFS Modules - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | Value | Description | - | | | - +=====================+=================================================================================================================================+ - | acl_tdb | Store NTFS ACLs in a tdb file to enable full mapping of Windows ACLs. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | acl_xattr | Store NTFS ACLs in Extended Attributes (EAs) to enable the full mapping of Windows ACLs. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | aio_fork | Enable async I/O. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | audit | Log share access, connects/disconnects, directory opens/creates/removes, | - | | and file opens/closes/renames/unlinks/chmods to syslog. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | cacheprime | Prime the kernel file data cache. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | cap | Translate filenames to and from the CAP encoding format, commonly used in Japanese language environments. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | catia | Improve Mac interoperability by translating characters that are unsupported by Windows. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | commit | Track the amount of data written to a file and synchronizes it to disk when a specified amount accumulates. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | crossrename | Allow server side rename operations even if source and target are on different physical devices. Required for the recycle bin | - | | to work across dataset boundaries. Automatically added when :guilabel:`Export Recycle Bin` is enabled. | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | default_quota | **Deprecated: use the ixnas module instead.** Store the default quotas that are reported to a Windows client in the quota | - | | record of a user. | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | dirsort | Sort directory entries alphabetically before sending them to the client. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | expand_msdfs | Enable support for Microsoft Distributed File System (DFS). | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | extd_audit | Send :guilabel:`audit` logs to both syslog and the Samba log files. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | fake_perms | Allow roaming profile files and directories to be set as read-only. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | fruit | Enhance macOS support by providing the SMB2 AAPL extension and Netatalk interoperability. | - | | Automatically loads *catia* and *streams_xattr* but read the caveat in NOTE below table. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | full_audit | Record selected client operations to the system log. | - | | | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | ixnas | Experimental module to improve ACL compatibility with Windows and store DOS attributes as file flags. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | linux_xfs_sgid | Used to work around an old Linux XFS bug. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | media_harmony | Allow Avid editorial workstations to share a network drive. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | netatalk | Ease the co-existence of SMB and AFP shares. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | offline | Mark all files in the share with the DOS *offline* attribute. | - | | This can prevent Windows Explorer from reading files just to make thumbnail images. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | posix_eadb | Provide Extended Attributes (EAs) support so they can be used on filesystems which do not provide native support for EAs. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | preopen | Useful for video streaming applications that want to read one file per frame. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | readahead | Useful for Windows Vista clients reading data using Windows Explorer. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | readonly | Mark a share as read-only for all clients connecting within the configured time period. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | shadow_copy | Allow Microsoft shadow copy clients to browse shadow copies on Windows shares. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | shadow_copy_zfs | Allow Microsoft shadow copy clients to browse shadow copies on Windows shares. This object uses | - | | :ref:`ZFS snapshots ` of the shared pool or dataset to create the shadow copies. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | shell_snap | Provide shell-script callouts for snapshot creation and deletion operations issued | - | | by remote clients using the File Server Remote VSS Protocol (FSRVP). | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | streams_depot | **Experimental** module to store alternate data streams in a central directory. | - | | The association with the primary file can be lost due to inode numbers changing when a directory is copied to a new location | - | | (see ``__). | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | streams_xattr | Enabled by default. Enable storing NTFS alternate data streams in the file system. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | syncops | Ensure metadata operations are performed synchronously. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | time_audit | Log system calls that take longer than the number of defined milliseconds. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | unityed_media | Allow multiple Avid clients to share a network drive. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | virusfilter | This extremely **experimental** module is still under development and does not work at this time. | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | winmsa | Emulate the Microsoft *MoveSecurityAttributes=0* registry option. Moving files or directories sets the ACL for file and | - | | directory hierarchies to inherit from the destination directory. | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | worm | Control the writability of files and folders depending on their change time and an adjustable grace period. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | xattr_tdb | Store Extended Attributes (EAs) in a tdb file so they can be used on filesystems which do not provide support for EAs. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | zfs_space | Correctly calculate ZFS space used by the share, including space used by ZFS snapshots, quotas, and resevations. | - | | Enabled by default. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | zfsacl | Provide ACL extensions for proper integration with ZFS. | - | | Enabled by default. | - | | | - +---------------------+---------------------------------------------------------------------------------------------------------------------------------+ - - -.. note:: Be careful when using multiple SMB shares, some with and some - without *fruit*. macOS clients negotiate SMB2 AAPL protocol + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | Value | Description | + | | | + +======================+=================================================================================================================================+ + | acl\_\ :file:`tdb` | Store NTFS ACLs in a tdb file to enable full mapping of Windows ACLs. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | acl_xattr | Store NTFS ACLs in Extended Attributes (EAs) to enable the full mapping of Windows ACLs. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | aio_fork | Enable async I/O. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | audit | Log share access, connects/disconnects, directory opens/creates/removes, | + | | and file opens/closes/renames/unlinks/chmods to syslog. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | cacheprime | Prime the kernel file data cache. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | cap | Translate filenames to and from the CAP encoding format, commonly used in Japanese language environments. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | catia | Improve Mac interoperability by translating characters that are unsupported by Windows. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | commit | Track the amount of data written to a file and synchronize it to disk when a specified amount accumulates. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | crossrename | Allow server side rename operations even if source and target are on different physical devices. Required for the recycle bin | + | | to work across dataset boundaries. Automatically added when :guilabel:`Export Recycle Bin` is enabled. | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | default_quota | **Deprecated: use the ixnas module instead.** Store the default quotas that are reported to a Windows client in the quota | + | | record of a user. | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dirsort | Sort directory entries alphabetically before sending them to the client. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | expand_msdfs | Enable support for Microsoft Distributed File System (DFS). | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | extd_audit | Send audit logs to both syslog and the Samba log files. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | fake_perms | Allow roaming profile files and directories to be set to read-only. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | fruit | Enhance macOS support by providing the SMB2 AAPL extension and Netatalk interoperability. | + | | Automatically loads *catia* and *streams_xattr*, but see the :ref:`warning ` below. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | full_audit | Record selected client operations to the system log. | + | | | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | ixnas | Experimental module to improve ACL compatibility with Windows and store DOS attributes as file flags. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | linux_xfs_sgid | Used to work around an old Linux XFS bug. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | media_harmony | Allow Avid editing workstations to share a network drive. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | netatalk | Ease the co-existence of SMB and AFP shares. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | offline | Mark all files in the share with the DOS *offline* attribute. | + | | This can prevent Windows Explorer from reading files just to make thumbnail images. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | posix_eadb | Provide Extended Attributes (EAs) support so they can be used on filesystems which do not provide native support for EAs. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | preopen | Useful for video streaming applications that want to read one file per frame. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | readahead | Useful for Windows Vista clients reading data using Windows Explorer. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | readonly | Mark a share as read-only for all clients connecting within the configured time period. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | shadow_copy | Allow Microsoft shadow copy clients to browse shadow copies on Windows shares. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | shadow_copy_zfs | Allow Microsoft shadow copy clients to browse shadow copies on Windows shares. This object uses | + | | :ref:`ZFS snapshots ` of the shared pool or dataset to create the shadow copies. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | shell_snap | Provide shell-script callouts for snapshot creation and deletion operations issued | + | | by remote clients using the File Server Remote VSS Protocol (FSRVP). | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | streams_depot | **Experimental** module to store alternate data streams in a central directory. | + | | The association with the primary file can be lost due to inode numbers changing when a directory is copied to a new location | + | | See ``__. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | streams_xattr | Enable storing NTFS alternate data streams in the file system. Enabled by default. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | syncops | Ensure metadata operations are performed synchronously. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | time_audit | Log system calls that take longer than the defined number of milliseconds. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | unityed_media | Allow multiple Avid clients to share a network drive. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | virusfilter | This extremely **experimental** module is still under development and does not work at this time. | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | winmsa | Emulate the Microsoft *MoveSecurityAttributes=0* registry option. Moving files or directories sets the ACL for file and | + | | directory hierarchies to inherit from the destination directory. | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | worm | Control the writability of files and folders depending on their change time and an adjustable grace period. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | xattr\_\ :file:`tdb` | Store Extended Attributes (EAs) in a tdb file so they can be used on filesystems which do not provide support for EAs. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | zfs_space | Correctly calculate ZFS space used by the share, including space used by ZFS snapshots, quotas, and resevations. | + | | Enabled by default. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | zfsacl | Provide ACL extensions for proper integration with ZFS. | + | | Enabled by default. | + | | | + +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ + + +.. _fruit-warning: + +.. warning:: Be careful when using multiple SMB shares, some with and + some without *fruit*. macOS clients negotiate SMB2 AAPL protocol extensions on the first connection to the server, so mixing shares with and without fruit will globally disable AAPL if the first connection occurs without fruit. To resolve this, all macOS clients From c1f8a3b3092247dabf7d2084f4208cb387f414c1 Mon Sep 17 00:00:00 2001 From: Mrt134 Date: Tue, 9 Apr 2019 13:30:48 -0400 Subject: [PATCH 4/4] remove :file: attribute changes --- userguide/sharing.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/userguide/sharing.rst b/userguide/sharing.rst index 5e6b96382..f5818340a 100644 --- a/userguide/sharing.rst +++ b/userguide/sharing.rst @@ -1047,7 +1047,7 @@ for more details. | Value | Description | | | | +======================+=================================================================================================================================+ - | acl\_\ :file:`tdb` | Store NTFS ACLs in a tdb file to enable full mapping of Windows ACLs. | + | acl_tdb | Store NTFS ACLs in a tdb file to enable full mapping of Windows ACLs. | | | | +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ | acl_xattr | Store NTFS ACLs in Extended Attributes (EAs) to enable the full mapping of Windows ACLs. | @@ -1162,7 +1162,7 @@ for more details. | worm | Control the writability of files and folders depending on their change time and an adjustable grace period. | | | | +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ - | xattr\_\ :file:`tdb` | Store Extended Attributes (EAs) in a tdb file so they can be used on filesystems which do not provide support for EAs. | + | xattr_tdb | Store Extended Attributes (EAs) in a tdb file so they can be used on filesystems which do not provide support for EAs. | | | | +----------------------+---------------------------------------------------------------------------------------------------------------------------------+ | zfs_space | Correctly calculate ZFS space used by the share, including space used by ZFS snapshots, quotas, and resevations. |