diff --git a/doc/api/child_processes.markdown b/doc/api/child_processes.markdown index 2af03db5540..b61257b031d 100644 --- a/doc/api/child_processes.markdown +++ b/doc/api/child_processes.markdown @@ -59,15 +59,19 @@ The third argument is used to specify additional options, which defaults to: { cwd: undefined, env: process.env, - customFds: [-1, -1, -1], setsid: false } `cwd` allows you to specify the working directory from which the process is spawned. Use `env` to specify environment variables that will be visible to the new process. -With `customFds` it is possible to hook up the new process' [stdin, stdout, stderr] to -existing streams; `-1` means that a new stream should be created. `setsid`, -if set true, will cause the subprocess to be run in a new session. + +There is a deprecated option called `customFds` which allows one to specify +specific file descriptors for the stdio of the child process. This API is +was not portable to all platforms and therefore removed. +With `customFds` it was possible to hook up the new process' [stdin, stdout, +stderr] to existing streams; `-1` meant that a new stream should be created. + +`setsid`, if set true, will cause the subprocess to be run in a new session. Example of running `ls -lh /usr`, capturing `stdout`, `stderr`, and the exit code: @@ -217,8 +221,7 @@ In the child the `process` object will have a `send()` method, and `process` will emit objects each time it receives a message on its channel. By default the spawned Node process will have the stdin, stdout, stderr -associated with the parent's. This can be overridden by using the -`customFds` option. +associated with the parent's. These child Nodes are still whole new instances of V8. Assume at least 30ms startup and 10mb memory for each new Node. That is, you cannot create many diff --git a/test/simple/test-child-process-custom-fds.js b/test/disabled/test-child-process-custom-fds.js similarity index 100% rename from test/simple/test-child-process-custom-fds.js rename to test/disabled/test-child-process-custom-fds.js