aboutsummaryrefslogtreecommitdiffstats
path: root/src/bindfs.1
diff options
context:
space:
mode:
Diffstat (limited to 'src/bindfs.1')
-rw-r--r--src/bindfs.129
1 files changed, 26 insertions, 3 deletions
diff --git a/src/bindfs.1 b/src/bindfs.1
index c71f988..1663cd1 100644
--- a/src/bindfs.1
+++ b/src/bindfs.1
@@ -64,21 +64,44 @@ Currently, the options \fB--force-user\fP, \fB--force-group\fP, \fB--mirror\fP,
the corresponding behavior of this option.
Requires mounting as root.
+
.TP
.B \-\-map-passwd=\fI<passwdfile>\fP, \-o map-passwd=\fI<passwdfile>\fP
.PD 0
.TP
.B \-\-map-group=\fI<groupfile>\fP, \-o map-group=\fI<groupfile>\fP
Like \fB--map=...\fP, but reads the UID/GID mapping from passwd and group
-files (like \fI/etc/passwd\fP and \fI/etc/group\fP). Helpful to restore
-system backups where UIDs/GIDs differ.
+files (like \fI/etc/passwd\fP and \fI/etc/group\fP). Maps UID/GID provided in
+the \fI<passwdfile>\fP or \fI<groupfile>\fP to its corresponding user/group
+name. Helpful to restore system backups where UIDs/GIDs differ.
Example usage:
\& bindfs --map-passwd=/mnt/orig/etc/passwd \\
.br
\& \--map-group=/mnt/orig/etc/group \\
-.br
+.br
+\& /mnt/orig /mnt/mapped
+
+Requires mounting as root.
+
+.TP
+.B \-\-map-passwd-rev=\fI<passwdfile>\fP, \-o map-passwd-rev=\fI<passwdfile>\fP
+.PD 0
+.TP
+.B \-\-map-group-rev=\fI<groupfile>\fP, \-o map-group-rev=\fI<groupfile>\fP
+Reversed variant of \fB--map-passwd\fP and \fB--map-group\fP. Like
+\fB--map=...\fP, but reads the UID/GID mapping from passwd and group files
+(like \fI/etc/passwd\fP and \fI/etc/group\fP). Maps user/group name provided in
+the \fI<passwdfile>\fP or \fI<groupfile>\fP to its corresponding UID/GID.
+Helpful to create compatible chroot environments where UIDs/GIDs differ.
+
+Example usage:
+
+\& bindfs --map-passwd-rev=/mnt/mapped/etc/passwd \\
+.br
+\& \--map-group-rev=/mnt/mapped/etc/group \\
+.br
\& /mnt/orig /mnt/mapped
Requires mounting as root.