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. IfNULL
, then norepos
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