callr (version 3.1.0)

rcmd_bg: Run an R CMD command in the background

Description

The child process is started in the background, and the function return immediately.

Usage

rcmd_bg(cmd, cmdargs = character(), libpath = .libPaths(),
  stdout = "|", stderr = "|", poll_connection = TRUE,
  repos = c(getOption("repos"), c(CRAN = "https://cloud.r-project.org")),
  system_profile = FALSE, user_profile = FALSE,
  env = rcmd_safe_env(), wd = ".", supervise = FALSE)

Arguments

cmd

Command to run. See R --help from the command line for the various commands. In the current version of R (3.2.4) these are: BATCH, COMPILE, SHLIB, INSTALL, REMOVE, build, check, LINK, Rprof, Rdconv, Rd2pdf, Rd2txt, Stangle, Sweave, Rdiff, config, javareconf, rtags.

cmdargs

Command line arguments.

libpath

The library path.

stdout

Optionally a file name to send the standard output to.

stderr

Optionally a file name to send the standard error to.

poll_connection

Whether to have a control connection to the process. This is used to transmit messages from the subprocess to the parent.

repos

The repos option. If NULL, then no repos option is set. This options is only used if user_profile or system_profile is set FALSE, as it is set using the system or the user profile.

system_profile

Whether to use the system profile file.

user_profile

Whether to use the user's profile file.

env

Environment variables to set for the child process.

wd

Working directory to use for running the command. Defaults to the current working directory.

supervise

Whether to register the process with a supervisor. If TRUE, the supervisor will ensure that the process is killed when the R process exits.

Value

It returns a process object.

See Also

Other R CMD commands: rcmd_copycat, rcmd