You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fuse-overlayfs - combine directory trees in userspace
7
7
8
8
# SYNOPSIS
9
9
@@ -15,9 +15,7 @@ unmounting
15
15
16
16
# DESCRIPTION
17
17
18
-
fuse-overlayfs provides an overlayfs FUSE implementation so that it
19
-
can be used since Linux 4.18 by unprivileged users in an user
20
-
namespace.
18
+
**fuse-overlayfs** combines (overlays) two or more directory trees into one. It can be used by unprivileged users in an user namespace. It is built with FUSE and works with Linux 4.18 or newer.
21
19
22
20
# OPTIONS
23
21
@@ -67,31 +65,31 @@ The fuse-overlayfs dynamic mapping is an alternative and cheaper way to chown'in
67
65
68
66
It is useful to share the same storage among different user namespaces and counter effect the mapping done by the user namespace itself, and without requiring to chown the files.
69
67
70
-
For example, given on the host two files like:
68
+
Take, for example, two files with the following user and group IDs:
71
69
72
70
```
73
71
$ stat -c %u:%g lower/a lower/b
74
72
0:0
75
73
1:1
76
74
```
77
75
78
-
When we run in a user namespace with the following configuration:
76
+
Also take note of the following user namespace configuration:
79
77
80
78
```
81
79
$ cat /proc/self/uid_map
82
80
0 1000 1
83
81
1 110000 65536
84
82
```
85
83
86
-
We would see:
84
+
After mounting with fuse-overlayfs, the ownership would change:
87
85
88
86
```
89
87
$ stat -c %u:%g merged/a merged/b
90
88
65534:65534
91
89
65534:65534
92
90
```
93
91
94
-
65534 is the overflow ID used when the UID/GID is not known inside the user namespace. This happens because both users 0:0 and 1:1 are not mapped.
92
+
65534 is the overflow ID used when the UID/GID is not known inside the user namespace. This happens because neither user IDs 0 nor 1 are mapped.
95
93
96
94
To map them, we'd mount the fuse-overlayfs file system using the following namespace configuration:
0 commit comments