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