toolbox-run(1)              General Commands Manual             toolbox-run(1)

<?><?><?> (NAME)
       toolbox-run - <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> Toolbx


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       toolbox run [--container NAME | -c NAME]
                   [--distro DISTRO | -d DISTRO]
                   [--preserve-fds N]
                   [--release RELEASE | -r RELEASE]
                   [COMMAND]


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> Toolbx <?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> toolbox create
       <?><?><?><?><?> <?><?><?> <?><?><?><?>.


       <?><?> Fedora<?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?> fedora-toolbox-N <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?> N <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> --container
       <?><?><?><?><?><?> <?><?><?>.


       <?><?> <?><?><?><?><?><?><?> Toolbx <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> OCI <?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> toolbox run <?><?><?><?><?> <?><?> podman start
       <?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?> podman exec <?><?><?><?>
       <?><?><?><?><?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>:


       --container NAME, -c NAME


       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> Toolbx <?><?> NAME <?><?><?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> Toolbx <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?>.


       --distro DISTRO, -d DISTRO


       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> Toolbx <?><?><?><?> <?><?><?><?><?> (DISTRO)
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       --release <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> DISTRO
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.


       --preserve-fds N


       <?><?><?><?><?> <?><?><?><?> N <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> (file descriptor) <?><?><?><?><?> (<?><?><?><?><?> <?><?>
       0<?> 1 <?> 2) <?><?> <?><?><?><?><?>. <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> 3+N
       <?><?><?><?><?> <?><?><?>.


       --release RELEASE, -r RELEASE


       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> Toolbx <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> (RELEASE) <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>.


<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.


       1 <?><?><?><?> <?><?><?><?><?> <?><?> Toolbx <?><?> <?><?><?><?>
       <?><?><?>


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


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

       $ 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 <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>

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


       Exit code <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>

       $ toolbox run false; echo $?
       1


<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?><?> ls <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       Toolbx <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>
       $ toolbox run ls -la


   <?><?><?><?><?> emacs <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> Toolbx <?><?><?><?> Fedora 36
       $ toolbox run --distro fedora --release f36 emacs


   <?><?><?><?><?> uptime <?><?><?><?> <?><?> <?><?><?><?><?><?><?> Toolbx
       <?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       $ toolbox run --container foo uptime


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       toolbox(1), podman(1), podman-exec(1), podman-start(1)

                                                                toolbox-run(1)