NAME

       parrot_package_create  -  generate  a  package  based on the accessed files and the preserved environment
       variables

SYNOPSIS

       parrot_package_create [options]

DESCRIPTION

       After recording the accessed files and environment variables of one program with the help of the  --name-
       list  parameter and the --env-list of parrot_run, parrot_package_create can generate a package containing
       all the accessed files. You can also add the dependencies  recorded  in  a  new  namelist  file  into  an
       existing package.

OPTIONS

       -a, --add=<path>
              The path of an existing package.

       -e, --env-list=<path>
              The path of the environment variables.

         --new-env
              The relative path of the environment variable file under the package.

       -n, --name-list=<path>
              The path of the namelist list.

       -p, --package-path=<path>
              The path of the package.

       -d, --debug=<flag>
              Enable debugging for this sub-system.

       -o, --debug-file=<file>
              Write  debugging output to this file. By default, debugging is sent to stderr (":stderr"). You may
              specify logs be sent to stdout (":stdout"), to the system syslog (":syslog"), or  to  the  systemd
              journal (":journal").

        -h, --help
              Show the help info.

EXIT STATUS

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

EXAMPLES

       To generate the package corresponding to namelist and envlist:

               % parrot_package_create --name-list namelist --env-list envlist --package-path /tmp/package

       After executing this command, one package with the path of /tmp/package will be generated.

       Here   is   a  short  instruction  about  how  to  make  use  of  parrot_run,  parrot_package_create  and
       parrot_package_run to generate one package for your experiment and repeat  your  experiment  within  your
       package.

       Step  1:  Run your program under parrot_run 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 parrot_run. 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 parrot_run:

               % exit

       Step 2: Using parrot_package_create 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 --shell-type bash ...

       After the execution of this command, one shell will be returned,  where  you  can  repeat  your  original
       program  (Please  replace --shell-type parameter with the shell type you actually used). After everything
       is done, exit parrot_package_run:

               % exit

       You can also add the dependencies recorded in a new namelist file, namelist1, into an existing package:

               % parrot_package_create --name-list namelist1 --env-list envlist1 --new-env envlist1  --add /tmp/package

       After executing this command, all the  new  dependencies  mentioned  in  namelist1  will  be  added  into
       /tmp/package,  the new envlist, envlist1, will also be added into /tmp/package with the name specified by
       the --new-env option.

COPYRIGHT

       The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2015 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_hdfs(1) parrot_cp(1) parrot_getacl(1)   parrot_setacl(1)   parrot_mkalloc(1)
           parrot_lsalloc(1)     parrot_locate(1)     parrot_timeout(1)     parrot_whoami(1)     parrot_mount(1)
           parrot_md5(1)  parrot_package_create(1)  parrot_package_run(1)  chroot_package_run(1)