---
name: "cr_run"
section: "1"
platform: "linux"
package: "blcr-util"
version: "0.8.5-2.3+b1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/cr_run"
---

# cr\_run(1)

runs a subprocess with checkpoint library loaded.

## 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_checkpoint/1.md).

**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_checkpoint/1.md), [**cr\_restart**(1)](/cr_restart/1.md),