From 3848a2381929a105f4c7ab1043999ac102f01e5e Mon Sep 17 00:00:00 2001 From: Brandon Philips Date: Wed, 9 Sep 2015 09:36:30 -0700 Subject: [PATCH] config-linux: specify the default devices/filesystems available Fixes #95 Signed-off-by: Brandon Philips --- config-linux.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/config-linux.md b/config-linux.md index 8d4873f11..3d2e08841 100644 --- a/config-linux.md +++ b/config-linux.md @@ -49,3 +49,25 @@ uid/gid mappings describe the user namespace mappings from the host to the conta The mappings represent how the bundle `rootfs` expects the user namespace to be setup and the runtime SHOULD NOT modify the permissions on the rootfs to realize the mapping. *hostID* is the starting uid/gid on the host to be mapped to *containerID* which is the starting uid/gid in the container and *size* refers to the number of ids to be mapped. There is a limit of 5 mappings which is the Linux kernel hard limit. + +## Default Devices and File Systems + +The Linux ABI includes both syscalls and several special file paths. +Applications expecting a Linux environment will very likely expect these files paths to be setup correctly. + +The following devices and filesystems MUST be made available in each application's filesystem + +| Path | Type | Notes | +| ------------ | ------ | ------- | +| /proc | [procfs](https://www.kernel.org/doc/Documentation/filesystems/proc.txt) | | +| /sys | [sysfs](https://www.kernel.org/doc/Documentation/filesystems/sysfs.txt) | | +| /dev/null | [device](http://man7.org/linux/man-pages/man4/null.4.html) | | +| /dev/zero | [device](http://man7.org/linux/man-pages/man4/zero.4.html) | | +| /dev/full | [device](http://man7.org/linux/man-pages/man4/full.4.html) | | +| /dev/random | [device](http://man7.org/linux/man-pages/man4/random.4.html) | | +| /dev/urandom | [device](http://man7.org/linux/man-pages/man4/random.4.html) | | +| /dev/tty | [device](http://man7.org/linux/man-pages/man4/tty.4.html) | | +| /dev/console | [device](http://man7.org/linux/man-pages/man4/console.4.html) | | +| /dev/pts | [devpts](https://www.kernel.org/doc/Documentation/filesystems/devpts.txt) | | +| /dev/ptmx | [device](https://www.kernel.org/doc/Documentation/filesystems/devpts.txt) | Bind-mount or symlink of /dev/pts/ptmx | +| /dev/shm | [tmpfs](https://www.kernel.org/doc/Documentation/filesystems/tmpfs.txt) | |