CR_RUN(1)							   User Commands							 CR_RUN(1)

NAME

       cr_run - runs a subprocess with checkpoint library loaded.

SYNOPSIS

       cr_run [OPTIONS] COMMAND [ARGS]

DESCRIPTION

       cr_run  takes  an  arbitrary  command  and  runs it with the "LD_PRELOAD" environment variable set so that an appropriate shared library is
       loaded at program startup.  Such a library must be loaded if you wish to take a checkpoint of the process with cr_checkpoint(1).

       cr_run assumes that BLCR's libraries (libcr*.so) can be found in the default library search path or via the  "LD_LIBRARY_PATH"  environment
       variable.

       You do not need to use cr_run if you explicitly link your application with -lcr (you may also need to modify your linker's search path with
       a -L directive, depending on the library's location), or if libcr.so or a related library is loaded by other libraries you have linked with
       (such  as  a  checkpoint-ready  MPI  library),  or  by your system's parallel job startup script, etc.  Check your system documentation for
       details.

OPTIONS

       -?,--help
	      print a usage message and exit.

       --version
	      print version information and exit.

       --     ends options processing.

       --omit causes executed process(es) to be omitted (rather than included) in any checkpoint taken.

       --run  overrides any occurance of --omit earlier in the options (restoring the default behavior).

BUGS

       Because cr_run relies on the "LD_PRELOAD" environment variable, it is ineffective for statically-linked	executables,  and  for	setuid/gid
       programs.

AUTHORS

       Jason Duell, Paul Hargrove, and Eric Roman, Lawrence Berkeley National Laboratory.

REPORTING BUGS

       Bug reports may be filed on the web at http://mantis.lbl.gov/bugzilla.

SEE ALSO

       cr_checkpoint(1), cr_restart(1),

Berkeley Lab Checkpoint/Restart 				     May 2008								 CR_RUN(1)