toolbox-run - Run a command in an existing toolbox container

       Runs  a  command  inside  an existing toolbox container. The container should have been created using the
       toolboxcreate command.

       On Fedora, the default container is known as fedora-toolbox-N, where N is the  release  of  the  host.  A
       specific container can be selected using the --container option.

       A  toolbox  container is an OCI container. Therefore, toolboxrun is analogous to a podmanstart followed
       by a podmanexec.

RunlsinsideatoolboxcontainerusingthedefaultimagematchingthehostOS
       $ toolbox run ls -la

   RunemacsinsideatoolboxcontainerusingthedefaultimageforFedora36
       $ toolbox run --distro fedora --release f36 emacs

   Runuptimeinsideacustomtoolboxcontainerusingacustomimage
       $ toolbox run --container foo uptime

       The exit code gives information about why the command within the  container  failed  to  run  or  why  it
       exited.

       1 There was an internal error in Toolbox

       125 There was an internal error in Podman

       126 The run command could not be invoked

       $ toolbox run /etc; echo $?
       /bin/sh: line 1: /etc: Is a directory
       /bin/sh: line 1: exec: /etc: cannot execute: Is a directory
       Error: failed to invoke command /etc in container fedora-toolbox-36
       126

       127 The run command cannot be found or the working directory does not exist

       $ toolbox run foo; echo $?
       /bin/sh: line 1: exec: foo: not found
       Error: command foo not found in container fedora-toolbox-36
       127

       Exitcode The run command exit code

       $ toolbox run false; echo $?
       1

       toolbox-run - Run a command in an existing toolbox container

       The following options are understood:

       --container NAME, -c NAME

       Run command inside a toolbox container with the given NAME.  This  is  useful  when  there  are  multiple
       toolbox  containers  created  from the same image, or entirely customized containers created from custom-
       built images.

       --distro DISTRO, -d DISTRO

       Run command inside a toolbox container for a different operating system DISTRO than the host. Has  to  be
       coupled with --release unless the selected DISTRO matches the host system.

       --preserve-fds N

       Pass  down  to  command  N additional file descriptors (in addition to 0, 1, 2). The total number of file
       descriptors will be 3+N.

       --release RELEASE, -r RELEASE

       Run command inside a toolbox container for a different operating system RELEASE than the host.

toolbox(1), podman(1), podman-exec(1), podman-start(1)toolbox-run(1)

toolboxrun [--containerNAME | -cNAME]
                   [--distroDISTRO | -dDISTRO]
                   [--preserve-fdsN]
                   [--releaseRELEASE | -rRELEASE]
                   [COMMAND]