|
2 | 2 |
|
3 | 3 | Stability: 3 - Stable |
4 | 4 |
|
5 | | -Node provides a tri-directional `popen(3)` facility through the |
| 5 | +io.js provides a tri-directional `popen(3)` facility through the |
6 | 6 | `child_process` module. |
7 | 7 |
|
8 | 8 | It is possible to stream data through a child's `stdin`, `stdout`, and |
9 | 9 | `stderr` in a fully non-blocking way. (Note that some programs use |
10 | | -line-buffered I/O internally. That doesn't affect node.js but it means |
| 10 | +line-buffered I/O internally. That doesn't affect io.js but it means |
11 | 11 | data you send to the child process may not be immediately consumed.) |
12 | 12 |
|
13 | 13 | To create a child process use `require('child_process').spawn()` or |
@@ -61,8 +61,9 @@ of the signal, otherwise `null`. |
61 | 61 |
|
62 | 62 | Note that the child process stdio streams might still be open. |
63 | 63 |
|
64 | | -Also, note that node establishes signal handlers for `'SIGINT'` and `'SIGTERM`', |
65 | | -so it will not terminate due to receipt of those signals, it will exit. |
| 64 | +Also, note that io.js establishes signal handlers for `'SIGINT'` and |
| 65 | +`'SIGTERM`', so it will not terminate due to receipt of those signals, |
| 66 | +it will exit. |
66 | 67 |
|
67 | 68 | See `waitpid(2)`. |
68 | 69 |
|
@@ -248,7 +249,7 @@ instead, see |
248 | 249 |
|
249 | 250 | There is a special case when sending a `{cmd: 'NODE_foo'}` message. All messages |
250 | 251 | containing a `NODE_` prefix in its `cmd` property will not be emitted in |
251 | | -the `message` event, since they are internal messages used by node core. |
| 252 | +the `message` event, since they are internal messages used by io.js core. |
252 | 253 | Messages containing the prefix are emitted in the `internalMessage` event, you |
253 | 254 | should by all means avoid using this feature, it is subject to change without notice. |
254 | 255 |
|
@@ -458,12 +459,12 @@ index corresponds to a fd in the child. The value is one of the following: |
458 | 459 | between parent and child. A ChildProcess may have at most *one* IPC stdio |
459 | 460 | file descriptor. Setting this option enables the ChildProcess.send() method. |
460 | 461 | If the child writes JSON messages to this file descriptor, then this will |
461 | | - trigger ChildProcess.on('message'). If the child is a Node.js program, then |
| 462 | + trigger ChildProcess.on('message'). If the child is an io.js program, then |
462 | 463 | the presence of an IPC channel will enable process.send() and |
463 | 464 | process.on('message'). |
464 | | -3. `'ignore'` - Do not set this file descriptor in the child. Note that Node |
| 465 | +3. `'ignore'` - Do not set this file descriptor in the child. Note that io.js |
465 | 466 | will always open fd 0 - 2 for the processes it spawns. When any of these is |
466 | | - ignored node will open `/dev/null` and attach it to the child's fd. |
| 467 | + ignored io.js will open `/dev/null` and attach it to the child's fd. |
467 | 468 | 4. `Stream` object - Share a readable or writable stream that refers to a tty, |
468 | 469 | file, socket, or a pipe with the child process. The stream's underlying |
469 | 470 | file descriptor is duplicated in the child process to the fd that |
@@ -625,17 +626,17 @@ leaner than `child_process.exec`. It has the same options. |
625 | 626 | * `gid` {Number} Sets the group identity of the process. (See setgid(2).) |
626 | 627 | * Return: ChildProcess object |
627 | 628 |
|
628 | | -This is a special case of the `spawn()` functionality for spawning Node |
| 629 | +This is a special case of the `spawn()` functionality for spawning io.js |
629 | 630 | processes. In addition to having all the methods in a normal ChildProcess |
630 | 631 | instance, the returned object has a communication channel built-in. See |
631 | 632 | `child.send(message, [sendHandle])` for details. |
632 | 633 |
|
633 | | -These child Nodes are still whole new instances of V8. Assume at least 30ms |
634 | | -startup and 10mb memory for each new Node. That is, you cannot create many |
635 | | -thousands of them. |
| 634 | +These child io.js processes are still whole new instances of V8. Assume at |
| 635 | +least 30ms startup and 10mb memory for each new io.js. That is, you cannot |
| 636 | +create many thousands of them. |
636 | 637 |
|
637 | 638 | The `execPath` property in the `options` object allows for a process to be |
638 | | -created for the child rather than the current `node` executable. This should be |
| 639 | +created for the child rather than the current `iojs` executable. This should be |
639 | 640 | done with care and by default will talk over the fd represented an |
640 | 641 | environmental variable `NODE_CHANNEL_FD` on the child process. The input and |
641 | 642 | output on this fd is expected to be line delimited JSON objects. |
|
0 commit comments