From 0b551b90bddddfb9e5caa3910f07ddb915f3830c Mon Sep 17 00:00:00 2001 From: Giuseppe Scrivano Date: Tue, 22 Dec 2020 15:58:11 +0100 Subject: [PATCH] man: document squash functionalities Signed-off-by: Giuseppe Scrivano --- fuse-overlayfs.1 | 17 +++++++++++++++++ fuse-overlayfs.1.md | 9 +++++++++ 2 files changed, 26 insertions(+) diff --git a/fuse-overlayfs.1 b/fuse-overlayfs.1 index 8c11fb1..cbf55e2 100644 --- a/fuse-overlayfs.1 +++ b/fuse-overlayfs.1 @@ -42,6 +42,11 @@ done to the file system will be written. A directory used internally by fuse\-overlays, must be on the same file system as the upper dir. +.PP +\fB\-o workdir=workdir\fP +A directory used internally by fuse\-overlays, must be on the same file +system as the upper dir. + .PP \fB\-o uidmapping=UID:MAPPED\-UID:LEN[,UID2:MAPPED\-UID2:LEN2]\fP \fB\-o gidmapping=GID:MAPPED\-GID:LEN[,GID2:MAPPED\-GID2:LEN2]\fP @@ -99,6 +104,18 @@ $ stat \-c %u:%g merged/a merged/b .PP Those are the same IDs visible from outside the user namespace. +.PP +\fB\-o squash\_to\_root\fP +Every file and directory is owned by the root user (0:0). + +.PP +\fB\-o squash\_to\_uid=uid\fP +\fB\-o squash\_to\_gid=gid\fP +Every file and directory is owned by the specified uid or gid. + +.PP +It has higher precedence over \fBsquash\_to\_root\fP\&. + .SH SEE ALSO .PP diff --git a/fuse-overlayfs.1.md b/fuse-overlayfs.1.md index b418de8..61b8418 100644 --- a/fuse-overlayfs.1.md +++ b/fuse-overlayfs.1.md @@ -84,6 +84,15 @@ $ stat -c %u:%g merged/a merged/b Those are the same IDs visible from outside the user namespace. +**-o squash_to_root** +Every file and directory is owned by the root user (0:0). + +**-o squash_to_uid=uid** +**-o squash_to_gid=gid** +Every file and directory is owned by the specified uid or gid. + +It has higher precedence over **squash_to_root**. + # SEE ALSO **fuse**(8), **mount**(8), **user_namespaces**(7)