SYNTAX

    start [options] <exe-name> [<arguments>]


OPTIONS

-h (--help) bool

Display help.

-r (--rendezvous) bool

Wait for the child process to call RProcess::Rendezvous before exiting. Can not be used with --wait.

-w (--wait) bool

Wait for the child process to exit before exiting. May not be used with --rendezvous.

-t (--timeout) int

Only relevant with either --rendezvous or --wait. Causes the command to abort after the specified number of seconds if the child process hasn't called RProcess::Rendezvous or exited (as appropriate) in that time. If the timeout is zero or not specified, the command will wait indefinitely.

-m (--measure) bool

If specified, measure the time taken for the child process to rendezvous (if --rendezvous is specified) or exit (if --wait is specified). This can be more accurate than using the fshell time command if exe-name is not an fshell command, because start doesn't attempt to parse its arguments as an fshell command line (adding the overhead of variable expansion, pipeline establishment etc) or to set up iosrv connections for the child process.

-q (--quiet) bool

If specified, do not print an error message if the rendezvous or wait return an error. Only applicable if --rendezvous or --wait were specified.


ARGUMENTS

<exe-name>

The executable to start. [string]

[<arguments>]

The arguments to pass to the exe. Any further arguments or options will be coalesced into this one. [string]


DESCRIPTION

Starts the specified process and then completely disowns it.

This is useful in the situation where you want the process to have a longer lifetime than the fshell instance that created it. Note the child process does not inherit fshell's I/O handles or environment variables.

Note that non-fshell-aware programs may still end up connected to the same I/O handles even though the start command has disowned it, because of the necessarily agressive handle-hunting code in TIoHandleSet::OpenExisting(). If it is necessary to be completely detached you can use defcons and the (unsupported, undocumented) --console-flags lazy instanciation flag:

  fshell --console defcons --console-flags 2 --exec '<command>'


SEE ALSO

disown, time


COPYRIGHT

Copyright (c) 2006-2011 Accenture. All rights reserved.