-## process
+# process
+
+<!-- type=global -->
The `process` object is a global object and can be accessed from anywhere.
It is an instance of `EventEmitter`.
-### Event: 'exit'
-
-`function () {}`
+## Event: 'exit'
Emitted when the process is about to exit. This is a good hook to perform
constant time checks of the module's state (like for unit tests). The main
console.log('About to exit.');
});
-### Event: 'uncaughtException'
-
-`function (err) { }`
+## Event: 'uncaughtException'
Emitted when an exception bubbles all the way back to the event loop. If a
listener is added for this exception, the default action (which is to print
stay running forever, `uncaughtException` can be a useful safety mechanism.
-### Signal Events
+## Signal Events
-`function () {}`
+<!--type=event-->
+<!--name=SIGINT, SIGUSR1, etc.-->
Emitted when the processes receives a signal. See sigaction(2) for a list of
standard POSIX signal names such as SIGINT, SIGUSR1, etc.
programs.
-### process.stdout
+## process.stdout
A `Writable Stream` to `stdout`.
refer to pipes, they are non-blocking like other streams.
-### process.stderr
+## process.stderr
A writable stream to stderr.
refer to pipes, they are non-blocking like other streams.
-### process.stdin
+## process.stdin
A `Readable Stream` for stdin. The stdin stream is paused by default, so one
must call `process.stdin.resume()` to read from it.
});
-### process.argv
+## process.argv
An array containing the command line arguments. The first element will be
'node', the second element will be the name of the JavaScript file. The
4: four
-### process.execPath
+## process.execPath
This is the absolute pathname of the executable that started the process.
/usr/local/bin/node
-### process.chdir(directory)
+## process.chdir(directory)
Changes the current working directory of the process or throws an exception if that fails.
-### process.cwd()
+## process.cwd()
Returns the current working directory of the process.
console.log('Current directory: ' + process.cwd());
-### process.env
+## process.env
An object containing the user environment. See environ(7).
-### process.exit([code])
+## process.exit([code])
Ends the process with the specified `code`. If omitted, exit uses the
'success' code `0`.
The shell that executed node should see the exit code as 1.
-### process.getgid()
+## process.getgid()
Gets the group identity of the process. (See getgid(2).)
This is the numerical group id, not the group name.
console.log('Current gid: ' + process.getgid());
-### process.setgid(id)
+## process.setgid(id)
Sets the group identity of the process. (See setgid(2).) This accepts either
a numerical ID or a groupname string. If a groupname is specified, this method
}
-### process.getuid()
+## process.getuid()
Gets the user identity of the process. (See getuid(2).)
This is the numerical userid, not the username.
console.log('Current uid: ' + process.getuid());
-### process.setuid(id)
+## process.setuid(id)
Sets the user identity of the process. (See setuid(2).) This accepts either
a numerical ID or a username string. If a username is specified, this method
}
-### process.version
+## process.version
A compiled-in property that exposes `NODE_VERSION`.
console.log('Version: ' + process.version);
-### process.versions
+## process.versions
A property exposing version strings of node and its dependencies.
openssl: '1.0.0e-fips' }
-### process.installPrefix
+## process.installPrefix
A compiled-in property that exposes `NODE_PREFIX`.
console.log('Prefix: ' + process.installPrefix);
-### process.kill(pid, [signal])
+## process.kill(pid, [signal])
Send a signal to a process. `pid` is the process id and `signal` is the
string describing the signal to send. Signal names are strings like
process.kill(process.pid, 'SIGHUP');
-### process.pid
+## process.pid
The PID of the process.
console.log('This process is pid ' + process.pid);
-### process.title
+## process.title
Getter/setter to set what is displayed in 'ps'.
-### process.arch
+## process.arch
What processor architecture you're running on: `'arm'`, `'ia32'`, or `'x64'`.
console.log('This processor architecture is ' + process.arch);
-### process.platform
+## process.platform
What platform you're running on. `'linux2'`, `'darwin'`, etc.
console.log('This platform is ' + process.platform);
-### process.memoryUsage()
+## process.memoryUsage()
Returns an object describing the memory usage of the Node process
measured in bytes.
`heapTotal` and `heapUsed` refer to V8's memory usage.
-### process.nextTick(callback)
+## process.nextTick(callback)
On the next loop around the event loop call this callback.
This is *not* a simple alias to `setTimeout(fn, 0)`, it's much more
});
-### process.umask([mask])
+## process.umask([mask])
Sets or reads the process's file mode creation mask. Child processes inherit
the mask from the parent process. Returns the old mask if `mask` argument is
' to ' + newmask.toString(8));
-### process.uptime()
+## process.uptime()
Number of seconds Node has been running.