src: add process.ppid

Fixes: #14957 PR-URL: #16839 Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl> Reviewed-By: Gireesh Punathil <gpunathi@in.ibm.com> Reviewed-By: James M Snell <jasnell@gmail.com>

Author: cjihrig

doc/api/process.md

@@ -1326,6 +1326,19 @@ system platform on which the Node.js process is running. For instance
 console.log(`This platform is ${process.platform}`);
 ```
 
+## process.ppid
+<!-- YAML
+added: REPLACEME
+-->
+
+* {integer}
+
+The `process.ppid` property returns the PID of the current parent process.
+
+```js
+console.log(`The parent process is pid ${process.ppid}`);
+```
+
 ## process.release
 <!-- YAML
 added: v3.0.0

src/node.cc

@@ -2950,6 +2950,12 @@ static void EnvEnumerator(const PropertyCallbackInfo<Array>& info) {
 }
 
 
+static void GetParentProcessId(Local<Name> property,
+ const PropertyCallbackInfo<Value>& info) {
+ info.GetReturnValue().Set(Integer::New(info.GetIsolate(), uv_os_getppid()));
+}
+
+
 static Local<Object> GetFeatures(Environment* env) {
  EscapableHandleScope scope(env->isolate());
 
@@ -3305,6 +3311,9 @@ void SetupProcessObject(Environment* env,
  READONLY_PROPERTY(process, "pid", Integer::New(env->isolate(), getpid()));
  READONLY_PROPERTY(process, "features", GetFeatures(env));
 
+ process->SetAccessor(FIXED_ONE_BYTE_STRING(env->isolate(), "ppid"),
+ GetParentProcessId);
+
  auto need_immediate_callback_string =
  FIXED_ONE_BYTE_STRING(env->isolate(), "_needImmediateCallback");
  CHECK(process->SetAccessor(env->context(), need_immediate_callback_string,

test/parallel/test-process-ppid.js

@@ -0,0 +1,16 @@
+'use strict';
+require('../common');
+const assert = require('assert');
+const cp = require('child_process');
+
+if (process.argv[2] === 'child') {
+ // The following console.log() call is part of the test's functionality.
+ console.log(process.ppid);
+} else {
+ const child = cp.spawnSync(process.execPath, [__filename, 'child']);
+
+ assert.strictEqual(child.status, 0);
+ assert.strictEqual(child.signal, null);
+ assert.strictEqual(+child.stdout.toString().trim(), process.pid);
+ assert.strictEqual(child.stderr.toString().trim(), '');
+}