Re: [PATCH v2 08/10] fs/ntfs3: Add Kconfig, Makefile and doc

[Randy Dunlap]

On 8/21/20 9:25 AM, Konstantin Komarov wrote:
> This adds fs/ntfs3 Kconfig, Makefile and Documentation file
> 
> Signed-off-by: Konstantin Komarov <almaz.alexandrovich@xxxxxxxxxxxxxxxxxxxx>
> ---
>  Documentation/filesystems/ntfs3.rst | 93 +++++++++++++++++++++++++++++
>  fs/ntfs3/Kconfig                    | 23 +++++++
>  fs/ntfs3/Makefile                   | 11 ++++
>  3 files changed, 127 insertions(+)
>  create mode 100644 Documentation/filesystems/ntfs3.rst
>  create mode 100644 fs/ntfs3/Kconfig
>  create mode 100644 fs/ntfs3/Makefile
> 
> diff --git a/Documentation/filesystems/ntfs3.rst b/Documentation/filesystems/ntfs3.rst
> new file mode 100644
> index 000000000000..4a510a6cdaee
> --- /dev/null
> +++ b/Documentation/filesystems/ntfs3.rst
> @@ -0,0 +1,93 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +=====
> +NTFS3
> +=====
> +
> +
> +Summary and Features
> +====================
> +
> +NTFS3 is fully functional NTFS Read-Write driver. The driver works with
> +NTFS versions up to 3.1, normal/compressed/sparse files
> +and journal replaying. File system type to use on mount is 'ntfs3'.
> +
> +- This driver implements NTFS read/write support for normal, sparsed and

                                                                sparse

> +  compressed files.
> +  NOTE: Operations with compressed files require increased memory consumption;
> +- Supports native journal replaying;
> +- Supports extended attributes;
> +- Supports NFS export of mounted NTFS volumes.
> +
> +Mount Options
> +=============
> +
> +The list below describes mount options supported by NTFS3 driver in addtion to

                                                                       addition

> +generic ones.
> +
> +===============================================================================
> +
> +nls=name		These options inform the driver how to interpret path
> +			strings and translate them to Unicode and back. In case
> +			none of these options are set, or if specified codepage
> +			doesn't exist on the system, the default codepage will be
> +			used (CONFIG_NLS_DEFAULT).
> +			Examples:
> +				'nls=utf8'
> +
> +uid=
> +gid=
> +umask=			Controls the default permissions for files/directories created
> +			after the NTFS volume is mounted.
> +
> +fmask=
> +dmask=			Instead of specifying umask which applies both to
> +			files and directories, fmask applies only to files and
> +			dmask only to directories.
> +
> +nohidden		Files with the Windows-specific HIDDEN (FILE_ATTRIBUTE_HIDDEN)
> +			attribute will not be shown under Linux.

Without this mount option, will HIDDEN files be shown by default?

> +
> +sys_immutable		Files with the Windows-specific SYSTEM
> +			(FILE_ATTRIBUTE_SYSTEM) attribute will be marked as system
> +			immutable files.
> +
> +discard			Enable support of the TRIM command for improved performance
> +			on delete operations, which is recommended for use with the
> +			solid-state drives (SSD).
> +
> +force			Forces the driver to mount partitions even if 'dirty' flag
> +			(volume dirty) is set. Not recommended for use.
> +
> +sparse			Create new files as "sparse".
> +
> +showmeta		Use this parameter to show all meta-files (System Files) on
> +			a mounted NTFS partition.
> +			By default, all meta-files are hidden.
> +
> +no_acs_rules		"No access rules" mount option sets access rights for
> +			files/folders to 777 and owner/group to root. This mount
> +			option absorbs all other permissions:
> +			- permissions change for files/folders will be reported
> +				as successful, but they will remain 777;
> +			- owner/group change will be reported as successful, but
> +				they will stay as root
> +
> +===============================================================================
> +
> +
> +ToDo list
> +=========
> +
> +- Full journaling support (currently journal replaying is supported) over JBD.

          journalling
seems to be preferred.

> +
> +
> +References
> +==========
> +https://www.paragon-software.com/home/ntfs-linux-professional/
> +	- Commercial version of the NTFS driver for Linux.
> +
> +almaz.alexandrovich@xxxxxxxxxxxxxxxxxxxx
> +	- Direct e-mail address for feedback and requests on the NTFS3 implementation.
> +
> +

thanks.
-- 
~Randy