X-Git-Url: https://git.rrq.au/?a=blobdiff_plain;f=fuse_xattrs.1.in;h=f8da2650c58bd713b42b46696e913ac2e5c2175f;hb=HEAD;hp=67e36493675da412ae1d35a748e1527ee6462f9a;hpb=b0063ac38ae833b543d7301f34ed19e559f7fe49;p=rrq%2Ffuse_xattrs.git

diff --git a/fuse_xattrs.1.in b/fuse_xattrs.1.in
index 67e3649..f8da265 100644
--- a/fuse_xattrs.1.in
+++ b/fuse_xattrs.1.in
@@ -1,18 +1,71 @@
-.TH FUSE_XATTRS "1" "February 2017" "FUSE_XATTRS version 0.2" "User Commands"
+.TH FUSE_XATTRS "1" "February 2017" "FUSE_XATTRS version @FUSE_XATTRS_VERSION_MAJOR@.@FUSE_XATTRS_VERSION_MINOR@" "User Commands"
 .SH NAME
-FUSE_XATTRS \- Add xattrs support using sidecar files
+fuse_xattrs \- Filesystem that adds xattrs support using sidecar files.
 .SH SYNOPSIS
-.SS mounting
+.SS \fRmounting
 .TP
-\fBfuse_xattrs\fP \fBsource_dir\fP \fBmountpoint\fP
-.SS unmounting
+\fBfuse_xattrs\fP \fBsource_dir\fP \fBmountpoint\fP [ options ]
+.SS \fRunmounting
 .TP
-\fB__UNMOUNT_COMMAND__ mountpoint\fP
+\fBfusermount -u mountpoint\fP
 .SH DESCRIPTION
-FUSE_XATTRS is a way to add xattrs support to any filesystem. The attributes are stored in sidecar files.
+\fBfuse_xattrs\fR is a way to add extended attribute support (xattrs)
+to any filesystem. The attributes are stored in "sidecar files" which
+by default are held as siblings to the attributed pathnames with the
+addition of the \fB.xattr\fR extension.
 .PP
 .PD
+.SH OPTIONS
+.TP
+\fB-o\ show_sidecar\fR
+.br
+Don't hide sidecar files. By default the sidecar files are kept as
+siblings to the attributed pathnames plus extension ".xattr", but
+hidden from access through the mountpoint. With this option the
+sidecar files will show up as files.
+.TP
+\fB-o\ enable_namespaces\fR
+.br
+Enable namespaces checks. Restricts attribute setting to the "user"
+namespace.
+.TP
+\fB-o\ sroot=path\fR
+.br
+Use other sidecar root path. By default the sidecar files are kept as
+siblings to the attributed pathnames plus extension ".xattr". By this
+option, the sidecar files are instead held as a nominated directory
+tree which typically is different from the source directory.
+.TP
+\fB-o \fIfuse option\fR
+.br
+See \fBman fuse\fR for details about additional \fBfuse\fR options.
+.PP
+.SH "EXAMPLES"
+.SS
+\fBfuse_xattrs /mnt/nfs/data /mnt/xdata\fP
+
+Adds xattrs support for an existing mount, \fB/mnt/nfs/data\fR, at
+\fB/mnt/xdata\fP.
+
+.SS
+\fBfuse_xattrs /mnt/nfs/data /mnt/xdata -o sroot=/mnt/xattrs\fP
+
+Adds xattrs support for an existing mount, \fB/mnt/nfs/data\fR, at
+\fB/mnt/xdata\fP with the sidecar files held under \fB/mnt/xattrs\fR.
+
+.SS
+\fBfuse_xattrs /mnt/nfs/data /mnt/xdata \\
+    \fB-o sroot=/mnt/xattrs -o allow_other\fP
+.br
+The fuse option \fBallow_other\fR must be enabled in the fuse
+configuration, and when so, the \fBfuse_xattr\fR mountpoint will be
+available to all users (depending on file permissions).
+
 .SH "AUTHORS"
-.LP
-FUSE_XATTRS has been written by Felipe Barriga Richards <felipe {at} felipebarriga.cl>.
-.LP
+
+
+2021-11-11 - Forked and extended by Ralph Ronnquist
+<ralph.ronnquist@gmail.com>.
+.br
+FUSE_XATTRS version 0.4 written by Felipe Barriga Richards <felipe
+{at} felipebarriga.cl>.