From 53c163cd5b2a24a4382b70817b99b501839f228d Mon Sep 17 00:00:00 2001 From: Ryan Dahl Date: Tue, 11 Oct 2011 11:27:58 -0700 Subject: [PATCH] Disable test-child-process-custom-fds.js --- doc/api/child_processes.markdown | 15 +++++++++------ .../test-child-process-custom-fds.js | 0 2 files changed, 9 insertions(+), 6 deletions(-) rename test/{simple => disabled}/test-child-process-custom-fds.js (100%) diff --git a/doc/api/child_processes.markdown b/doc/api/child_processes.markdown index 2af03db5540c67..b61257b031d1f5 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