Documentation

Fields

• :: StdStream 'Piped

  Create a new pipe. The returned Handle will use the default encoding and newline translation mode (just like Handles created by openFile).

Fields

• :: StdStream 'NoPipe

  Inherit Handle from parent

Fields

• :: Handle
   
• -> StdStream 'NoPipe

  Use the supplied Handle

Fields

• :: StdStream 'NoPipe

  Close the stream's file descriptor without passing a Handle. On POSIX systems this may lead to strange behavior in the child process because attempting to read or write after the file has been closed throws an error. This should only be used with child processes that don't use the file descriptor at all. If you wish to ignore the child process's output you should either create a pipe and drain it manually or pass a Handle that writes to /dev/null.

Fields

• :: { cmdspec :: CmdSpec

  Executable & arguments, or shell command. If cwd is Nothing, relative paths are resolved with respect to the current working directory. If cwd is provided, it is implementation-dependent whether relative paths are resolved with respect to cwd or the current working directory, so absolute paths should be used to ensure portability.

•    , stdin :: StdStream i

  How to determine stdin

•    , stdout :: StdStream o

  How to determine stdout

•    , stderr :: StdStream e

  How to determine stderr

•    , subprocLifecycle :: LifecycleMode lp

  Whether to kill the subprocess or wait when the scope's computation finishes first.

•    , scopeLifecycle :: LifecycleMode ls

  Whether to cancel the scope's computation or wait when the subprocess finishes first.

•    , cwd :: Maybe FilePath

  Optional path to the working directory for the new process

•    , env :: Maybe [(String, String)]

  Optional environment (otherwise inherit from the current process)

•    , closeFds :: Bool

  Close all file descriptors except stdin, stdout and stderr in the new process (on Windows, only works if std_in, std_out, and std_err are all Inherit). This implementation will call close on every fd from 3 to the maximum of open files, which can be slow for high maximum of open files. XXX verify what happens with fds in nodejs child processes

•    , createGroup :: Bool

  Create a new process group. On JavaScript this also creates a new session.

•    , delegateCtlc :: Bool

  Delegate control-C handling. Use this for interactive console processes to let them handle control-C themselves (see below for details).

•    , detachConsole :: Bool

  Use the windows DETACHED_PROCESS flag when creating the process; does nothing on other platforms.

•    , createNewConsole :: Bool

  Use the windows CREATE_NEW_CONSOLE flag when creating the process; does nothing on other platforms.

•    , newSession :: Bool

  Use posix setsid to start the new process in a new session; starts process in a new session on JavaScript; does nothing on other platforms.

•    , childGroup :: Maybe GroupID

  Use posix setgid to set child process's group id; works for JavaScript when system running nodejs is posix. does nothing on other platforms.

•    , childUser :: Maybe UserID

  Use posix setuid to set child process's user id; works for JavaScript when system running nodejs is posix. does nothing on other platforms.

•    , useProcessJobs :: Bool

  On Windows systems this flag indicates that we should wait for the entire process tree to finish before unblocking. On POSIX systems this flag is ignored. See $exec-on-windows for details.

•    } -> CreateProcess ('SubprocMode i o e lp ls)