BWRAP(1) BWRAP(1) (NAME) bwrap - (SYNOPSIS) bwrap [...] [] (DESCRIPTION) bwrap (sandboxing) (unprivileged) . . tmpfs . . bwrap (mount namespace) . ipc pid uts ( bwrap ). UID GID . ( PID) bwrap (pid 1) (zombie reaping) . (pid 2) . pid 1 . (OPTIONS) . : --help --version --args FD (nul-separated) . . --argv0 VALUE argv[0] VALUE --level-prefix . syslog(3) : <4> LOG_WARNING . . logger --prio-prefix ( logger(1)) systemd-cat --level-prefix=1 ( systemd-cat(1)) . : --unshare-user (user namespace) --unshare-user-try --unshare-ipc ipc --unshare-pid pid --unshare-net (network namespace) --unshare-uts uts --unshare-cgroup cgroup --unshare-cgroup-try cgroup --unshare-all (unshare) . : --unshare-user-try --unshare-ipc --unshare-pid --unshare-net --unshare-uts --unshare-cgroup-try --share-net --unshare-all --unshare-net --userns FD . ()setns . --userns2 FD . userns-- . bubblewrap ( ) userns2-- . --disable-userns . sysctl user.max_user_namespaces . --unshare-user . --assert-userns-disabled . --userns . --pidns FD pid . userns-- pid bwrap . unshare-pid-- pid . --uid UID (UID) ( --unshare-user) --gid GID (GID) ( --unshare-user) --hostname HOSTNAME (hostname) ( --unshare-uts) : --chdir DIR DIR --setenv VAR VALUE --unsetenv VAR --clearenv PWD --setenv : --lock-file DEST DEST . . --sync-fd FD . (mount) . . . 0755 (rwxr-xr-x) . --perms . --size --tmpfs --perms --size . --perms OCTAL . OCTAL . : --perms 0700 --tmpfs /a --tmpfs /b /a 0700 /b . --perms --size : --perms 0700 --size 10485760 --tmpfs /s tmpfs . --size BYTES tmpfs-- . tmpfs . --size 10485760 --tmpfs /tmp tmpfs /tmp . : --size 10485760 --tmpfs /a --tmpfs /b /a /b . --perms --size : --size 10485760 --perms 0700 --tmpfs /s tmpfs . --bind SRC DEST (Bind mount) SRC DEST --bind-try SRC DEST --bind SRC . --dev-bind SRC DEST SRC DEST --dev-bind-try SRC DEST --dev-bind SRC . --ro-bind SRC DEST SRC DEST --ro-bind-try SRC DEST --ro-bind SRC . --remount-ro DEST DEST . . --overlay-src SRC overlay . . . : . ( overlayfs lowerdir .) --overlay RWSRC WORKDIR DEST --tmp-overlay DEST --ro-overlay DEST overlayfs RWSRC --overlay-src DEST. DEST . --overlay RWSRC . RWSRC --overlay-src . WORKDIR RWSRC . --tmp-overlay tmpfs . . --ro-overlay . --overlay-src . --ro-overlay --overlay-src . . overlayfs overlay-src-- overlay-- . overlayfs . Overlay Filesystem https://www.kernel.org/doc/Documentation/filesystems/overlayfs.txt . --proc DEST procfs DEST --dev DEST devtmpfs DEST --tmpfs DEST tmpfs DEST. --perms tmpfs tmpfs 0755 . --size tmpfs tmpfs . --mqueue DEST mqueue DEST --dir DEST DEST. --perms ( --chmod ). --perms 0755 . --file FD DEST FD DEST. --perms 0666 ( --bind-data ). --bind-data FD DEST FD bind- mount DEST . --perms 0600 ( --file ). --ro-bind-data FD DEST FD bind- mount DEST . --perms 0600 ( --file ). --symlink SRC DEST DEST SRC. 0.9.0 DEST SRC . 0.9.0 DEST ( SRC ). --chmod OCTAL PATH PATH ( ) OCTAL. (Lockdown): --seccomp FD seccomp FD. cBPF seccomp_export_bpf . . seccomp --add-seccomp-fd . --add-seccomp-fd FD seccomp FD. cBPF seccomp_export_bpf . seccomp ( bwrap ). prctl PR_SET_SECCOMP . --seccomp . --exec-label LABEL . SELinux (context) SELinux () . --file-label LABEL . SELinux SELinux . --block-fd FD FD . --userns-block-fd FD FD . ( newuidmap/newgidmap) . --info-fd FD JSON FD. --json-status-fd FD JSON FD ( JSON Lines). JSON . bwrap child-pid --json-status-fd ( --info-fd ). (PID) pid bwrap . child-pid --info-fd . bwrap exit-code --json-status-fd . exit-code (n n 128+n n ). bwrap JSON . --new-session ( ()setsid). . : new-session-- seccomp ioctl TIOCSTI ( CVE-2017-5226). --die-with-parent (COMMAND) bwrap. bwrap COMMAND bwrap SIGKILL . prctl, PR_SET_PDEATHSIG. --as-pid-1 PID=1 . --cap-add CAP (capability) CAP CAP_DAC_READ_SEARCH . ALL . --cap-drop CAP . ALL . . --cap-add --cap-drop . . --not-a-security-boundary bwrap . ( automounter) bwrap . bubblewrap . xdg-dbus-proxy Steam bwrap . ( pivot_root ) . (ENVIRONMENT) HOME (cwd) --chdir cwd . --setenv . (EXIT STATUS) bwrap (pid 2 ) . (NOTES) 1. "JSON lines" https://jsonlines.org Containers BWRAP(1)