https://github.com/kuzzleio/dumpme
A NodeJS module generating a coredumping the current process
https://github.com/kuzzleio/dumpme
Last synced: 9 months ago
JSON representation
A NodeJS module generating a coredumping the current process
- Host: GitHub
- URL: https://github.com/kuzzleio/dumpme
- Owner: kuzzleio
- License: apache-2.0
- Created: 2016-12-23T08:54:57.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2020-07-22T09:14:20.000Z (over 5 years ago)
- Last Synced: 2024-04-13T16:13:41.189Z (almost 2 years ago)
- Language: C++
- Size: 24.4 KB
- Stars: 6
- Watchers: 11
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dumpme
Creates a coredump of the current process, without killing it.
Supports Linux Kernel Hardening options.
## Pre-requisites
* [gdb/gcore](http://man7.org/linux/man-pages/man1/gcore.1.html) must be installed on the system
* obviously, works only on *nix systems
## How to use
#### `dumpme([gcore], [coredump])`
Where:
* `gcore` is the path and filename of the gcore binary (default: `gcore`)
* `coredump` is the path + file name of the coredump file to create (default: `core.`)
Returns a `Boolean` as an indicator of success/failure.
```js
const dumpme = require('dumpme');
dumpme();
```
## Why gdb/gcore is needed?
The only alternative to gcore is to use [google-coredumper](https://code.google.com/archive/p/google-coredumper/), which is done by [node-gcore](https://www.npmjs.com/package/gcore).
Using google coredumper programatically is way cleaner than gcore, but it has the following issues:
* coredumps generated by Google coredumper are not compatible with llnode (see https://github.com/nodejs/llnode/issues/61)
* Google coredumper might not work with newer Linux distributions (mainly due to Kernel Hardening features, but [not only](http://www.gossamer-threads.com/lists/linux/kernel/622686)), and it seems unmaintained since 2008