pidtree
🚸 Cross platform children list of a PID.
Coded with ❤️ by Simone Primarosa.
Motivation
The only package that does this simple but tricky job is ps-tree
but the project is unmaintained and furthermore the logic is wrong.
Usage
var pidtree = require('pidtree')
pidtree(process.pid, function (err, pids) {
console.log(pids)
})
pidtree(process.pid, {root: true}, function (err, pids) {
console.log(pids)
})
pidtree(1, function (err, pids) {
console.log(pids)
})
const pids = await pidtree(1)
console.log(pids)
Compatibility
Linux | FreeBSD | NetBSD | SunOS | macOS | Win | AIX |
---|
✅ | ❓ | ❓ | ❓ | ✅ | ✅ | ❓ |
✅ = Working
❓ = Not tested but should work
Please if your platform is not supported file an issue.
CLI
This package behave similarly to pgrep -P
on *unix
npx pidtree $PPID
Just replace $PPID
with one of the pids inside your system.
Or don't pass anything if you want all the pids inside your system.
npx pidtree
API
pidtree(pid, [options], [callback]) ⇒ Promise.<Object>
Get the list of child pids of the given pid.
Kind: global function
Returns: Promise.<Object>
- Only when the callback is not provided.
Access: public
Param | Type | Default | Description |
---|
pid | Number | String | | A pid. |
[options] | Object | | Optional options object. |
[options.root] | Boolean | false | Include the provided pid in the list. |
[callback] | function | | Called when the list is ready. If not provided a promise is returned instead. |
Related
- pidusage -
Cross-platform process cpu % and memory usage of a PID
Authors
See also the list of contributors who participated in this project.
License
This project is licensed under the MIT License - see the license file for details.