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),