RunProcess

RunProcess["command"]

runs the specified external command, returning information on the outcome.

RunProcess[{"command",arg1,arg2,…}]

runs the specified command, with command-line arguments argi.

RunProcess[command,"prop"]

returns only the specified property.

RunProcess[command,prop,input]

feeds the specified initial input to the command.

Details

  • RunProcess blocks until the process it starts has finished.
  • In RunProcess[command,prop,input], input is automatically converted to a string using ToString. The same is true for the argi in RunProcess[{command,arg1,…},…].
  • Typical possible properties to return include:
  • "ExitCode"the exit code for the process
    "StandardOutput"data sent to standard output, as a string
    "StandardError"data sent to standard error, as a string
    Allan association of all properties (default)
  • RunProcess has the following options:
  • ProcessDirectoryInheritedinitial working directory
    ProcessEnvironmentInheritedenvironment variables to supply
  • By default, the subprocess will inherit its process directory and environment variables from the Wolfram Engine.

Examples

open allclose all

Basic Examples  (3)

Run a simple external command:

In[1]:=
Click for copyable input
Out[1]=

Run a command, and get back only what it writes to the standard output channel:

In[2]:=
Click for copyable input
Out[2]=

Give a command-line option to the function:

In[1]:=
Click for copyable input
Out[1]=

Run a command, and get back only its exit code:

In[1]:=
Click for copyable input
Out[1]=
In[7]:=
Click for copyable input
Out[7]=

Scope  (2)

Possible Issues  (4)

See Also

ExternalEvaluate  RunThrough  Run  StartProcess  Install  Put  Get  Import  $SystemShell

Introduced in 2014
(10.0)