---
name: "parrot_package_run"
section: "1"
platform: "linux"
package: "coop-computing-tools"
version: "1:7.14.5-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/parrot_package_run"
---

# parrot\_package\_run(1)

repeat a program within the package with the help of FCparrot\_runFT

## NAME

**parrot\_package\_run** - repeat a program within the package with the help of FCparrot\_runFT

## SYNOPSIS

FCparrot\_package\_run --package-path your-package-path \[command\]FT

## DESCRIPTION

If FCparrot\_runFT is used to repeat one experiment, one mountlist must be created so that the file access request of your program can be redirected into the package. FCparrot\_package\_runFT is used to create the mountlist and repeat your program within the package with the help of FCparrot\_runFT and **mountlist**. If no command is given, a /bin/sh shell will be returned.

## OPTIONS

- **-p,--package-path**

  The path of the package.

- **-e,--env-list**

  The path of the environment file, each line is in the format of *\<key\>*=*\<value\>*. (Default: package-path/env\_list)

- **-e,--env-list**

  The path of the environment file, each line is in the format of *\<key\>*=*\<value\>*. (Default: package-path/env\_list)

- **-h,--help**

  Show this help message.

## EXIT STATUS

On success, returns zero. On failure, returns non-zero.

## EXAMPLES

To repeat one program within one package **/tmp/package** in a **bash** shell:

```

```

-

  % parrot\_package\_run --package-path /tmp/package /bin/bash

After the execution of this command, one shell will be returned, where you can repeat your original program. After everything is done, exit FCparrot\_package\_runFT:

```

```

-

  % exit

You can also directly set your command as the arguments of FCparrot\_package\_runFT. In this case, FCparrot\_package\_runFT will exit automatically after the command is finished, and you do not need to use FCexitFT to exit. However, your command must belong to the original command set executed inside FCparrot\_runFT and preserved by FCparrot\_package\_createFT.

```

```

-

  % parrot\_package\_run --package-path /tmp/package ls -al

Here is a short instruction about how to make use of FCparrot\_runFT, FCparrot\_package\_createFT and FCparrot\_package\_runFT to generate one package for your experiment and repeat your experiment within your package.

Step 1: Run your program under FCparrot\_runFT and using **--name-list** and **--env-list** parameters to record the filename list and environment variables.

```

```

-

  % parrot\_run --name-list namelist --env-list envlist /bin/bash

After the execution of this command, you can run your program inside FCparrot\_runFT. At the end of step 1, one file named **namelist** containing all the accessed file names and one file named **envlist** containing environment variables will be generated. After everything is done, exit FCparrot\_runFT:

```

```

-

  % exit

Step 2: Using FCparrot\_package\_createFT to generate a package.

```

```

-

  % parrot\_package\_create --name-list namelist --env-path envlist --package-path /tmp/package

At the end of step 2, one package with the path of **/tmp/package** will be generated.

Step 3: Repeat your program within your package.

```

```

-

  % parrot\_package\_run --package-path /tmp/package /bin/bash

After the execution of this command, one shell will be returned, where you can repeat your original program. After everything is done, exit FCparrot\_package\_runFT:

```

```

-

  % exit

## COPYRIGHT

The Cooperative Computing Tools are Copyright (C) 2022 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.

## SEE ALSO

- •

  **Cooperative Computing Tools Documentation**

- •

  **Parrot User Manual**

- •

  **[parrot\_run(1)](/parrot_run/1.md)** **[parrot\_cp(1)](/parrot_cp/1.md)** **[parrot\_getacl(1)](/parrot_getacl/1.md)**  **[parrot\_setacl(1)](/parrot_setacl/1.md)**  **[parrot\_mkalloc(1)](/parrot_mkalloc/1.md)**  **[parrot\_lsalloc(1)](/parrot_lsalloc/1.md)**  **[parrot\_locate(1)](/parrot_locate/1.md)**  **[parrot\_timeout(1)](/parrot_timeout/1.md)**  **[parrot\_whoami(1)](/parrot_whoami/1.md)**  **[parrot\_mount(1)](/parrot_mount/1.md)**  **[parrot\_md5(1)](/parrot_md5/1.md)**  **[parrot\_package\_create(1)](/parrot_package_create/1.md)**  **[parrot\_package\_run(1)](/parrot_package_run/1.md)**  **[chroot\_package\_run(1)](/chroot_package_run/1.md)**