rcmd_bg
Run an R CMD command in the background
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 = default_repos(), 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. It may be the same as
stdout
, in which case standard error is redirected to standard output. It can also be the special string"2>&1"
, in which case standard error will be redirected to standard output.- 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 ifuser_profile
orsystem_profile
is setFALSE
, 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.- ...
Extra arguments are passed to the processx::process constructor.
Value
It returns a process object.
See Also
Other R CMD commands: rcmd_copycat
,
rcmd