Document xattr support

[wimlib] / doc / man1 / wimlib-imagex-mount.1

diff --git a/doc/man1/wimlib-imagex-mount.1 b/doc/man1/wimlib-imagex-mount.1
index b5b6c6307b865c03b15bdcb7523e350add48fc61..da952eb25fd16d4cc06d516e4f8857ba44d84665 100644 (file)
--- a/doc/man1/wimlib-imagex-mount.1
+++ b/doc/man1/wimlib-imagex-mount.1
@@ -25,11 +25,10 @@ The WIM image can be unmounted using the \fBwimlib-imagex unmount\fR
 command.  Changes made to a WIM mounted read-write will be discarded unless the
 \fB--commit\fR flag is provided to \fBwimlib-imagex unmount\fR.
 .SH DATA AND METADATA SUPPORT
-This section documents which WIM features are exposed via the mount support and
-which are not.
-.PP
-The following features are \fIsupported\fR (read/write unless otherwise
-specified):
+WIM images can contain a variety of types of files and file metadata, some of
+which is Windows-specific.  Currently, the mount commands can translate some,
+but not all, Windows concepts to Linux equivalents.  Briefly, the following
+features are \fIsupported\fR (read/write):
 .IP \[bu] 4
 Hard links
 .IP \[bu]
@@ -40,29 +39,30 @@ directory.  UNIX symbolic links created in a read-write mounted WIM image will
 automatically be translated into native Windows symbolic links.
 .IP \[bu]
 Named data streams (mostly).  See the \fB--streams-interface\fR option.
-.IP \[bu]
-Standard UNIX permission bits and UNIX special files are supported if the
-\fB--unix-data\fR option is used.
 .PP
-The following features are \fIunsupported\fR:
+In addition, standard UNIX owners, groups, modes, and special files are
+supported if the \fB--unix-data\fR option is used.
+.PP
+However, the following features are \fIunsupported\fR (not exposed in mounted
+images; existing values are preserved on commit):
 .IP \[bu] 4
-Windows security descriptors.  These are not exposed in the mounted filesystem,
-although existing values will be preserved on commit.  New files are not given
-security descriptors.
+Windows security descriptors.  New files are not given security descriptors.
 .IP \[bu]
-DOS names (8.3 names) (short names).  These are not exposed in the mounted
-filesystem, although existing values will be preserved on commit.  New files are
-not given DOS names.
+DOS names (8.3 names) (short names).  New files are not given DOS names.
 .IP \[bu]
-Windows file attributes.  These are not exposed in the mounted filesystem,
-although existing values will be preserved on commit.  New files are assigned
-default attributes based on the UNIX file mode bits.
+Windows file attributes.  New files are assigned default attributes based on the
+UNIX file mode bits.
 .IP \[bu]
-Object IDs.  These are not exposed in the mounted filesystem, although existing
-values will be preserved on commit.  New files are not given object IDs.
+Object IDs.  New files are not given object IDs.
 .IP \[bu]
 EFS-encrypted files.  The files themselves will be visible in mounted WIM images
 but their data will not be available.
+.IP \[bu]
+Extended attributes.  Although wimlib now supports creating a WIM image
+containing Linux-style extended attributes, these are not yet exposed in mounted
+WIM images.  (This may be implemented in the future, though it would potentially
+conflict with the use of extended attributes to expose Windows concepts like
+named data streams.)
 .SH SPLIT WIMS
 You may use \fBwimlib-imagex mount\fR to mount an image from a split WIM
 read-only.  However, you may not mount an image from a split WIM read-write.