podman-unshare(1)           General Commands Manual          podman-unshare(1)

<?><?><?> (NAME)
       podman-unshare - <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?>


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       podman unshare [<?><?><?><?><?><?><?><?>] [<?><?><?><?><?>]


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?> <?><?> (<?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> $SHELL) <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> (user namespace) <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> (UID) <?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (GID) <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> UID 0 <?> GID 0 <?><?> <?><?><?> <?><?><?><?><?>. <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?>
       <?><?><?><?> <?><?> /etc/subuid <?> /etc/subgid <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> newuidmap(1) <?>
       newgidmap(1) <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>.


       <?><?><?><?><?> podman unshare <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> (unprivileged) <?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?>.


       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> podman mount <?><?><?><?><?><?> <?><?><?><?>. <?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?> <?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?> podman unshare <?><?>
       <?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?> podman mount <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> podman unshare <?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?>.


       <?><?><?><?> unshare <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>:

       o CONTAINERS_GRAPHROOT: <?><?><?><?> <?><?><?><?><?><?><?><?>
         <?><?><?><?><?><?> (persistent) <?><?><?><?><?><?><?>.

       o CONTAINERS_RUNROOT: <?><?><?><?> <?><?><?><?><?><?><?><?>
         <?><?><?><?> <?> <?><?><?><?> (volatile) <?><?><?><?><?><?><?>.


       <?><?><?>: <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
   --help, -h
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>


   --rootless-netns
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> (rootless network namespace) <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> netavark <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> IP
       (<?><?><?><?><?><?><?><?><?> bridge) <?><?><?><?><?><?><?> <?><?><?>.
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.


<?><?><?><?><?> <?><?><?><?> (EXIT CODES)
       <?><?> <?><?><?><?> <?><?> podman unshare <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> podman unshare <?><?> <?><?> <?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> chroot <?><?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>):


       125 <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?>

       $ podman unshare --foo; echo $?
       Error: unknown flag: --foo
       125


       126 <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>

       $ podman unshare /etc; echo $?
       Error: fork/exec /etc: permission denied
       126


       127 <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?>

       $ podman unshare foo; echo $?
       Error: fork/exec /usr/bin/bogus: no such file or directory
       127


       <?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>

       $ podman unshare /bin/sh -c 'exit 3'; echo $?
       3


<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>:

       $ podman unshare id
       uid=0(root) gid=0(root) groups=0(root),65534(nobody)


       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?>:

       $ podman unshare cat /proc/self/uid_map /proc/self/gid_map
                0       1000          1
                1      10000      65536
                0       1000          1
                1      10000      65536


       <?><?><?><?><?> <?><?><?><?><?><?><?> netns <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>:

       $ podman unshare --rootless-netns ip addr
       1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
           link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
           inet 127.0.0.1/8 scope host lo
              valid_lft forever preferred_lft forever
           inet6 ::1/128 scope host
              valid_lft forever preferred_lft forever
       2: tap0: <BROADCAST,UP,LOWER_UP> mtu 65520 qdisc fq_codel state UNKNOWN group default qlen 1000
           link/ether aa:8c:0b:73:98:f6 brd ff:ff:ff:ff:ff:ff
           inet 10.0.2.100/24 brd 10.0.2.255 scope global tap0
              valid_lft forever preferred_lft forever
           inet6 fd00::a88c:bff:fe73:98f6/64 scope global dynamic mngtmpaddr
              valid_lft 86389sec preferred_lft 14389sec
           inet6 fe80::a88c:bff:fe73:98f6/64 scope link
              valid_lft forever preferred_lft forever


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       podman(1), podman-mount(1), namespaces(7), newuidmap(1), newgidmap(1),
       user_namespaces(7)

                                                             podman-unshare(1)