nipsu

library0.0.3jsnpmunverified

Crash test case minifier for ASan-instrumented command-line tools. Version 0.0.3 is a CLI tool that reduces input files responsible for crashes detected by AddressSanitizer (ASan) to minimal reproducers. It iteratively removes chunks defined by delimiters and sizes, testing against a target binary. Differentiators: lightweight, Node.js-based, supports real-time mode and customizable delimiters/chunk sizes. Ideal for security researchers and developers minimizing crash reproducers.

testing

npm install nipsu

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · NIPSU

nipsu

testingjavascriptv0.0.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

nipsu

✓ const nipsu = require('nipsu');

✗ import nipsu from 'nipsu';

Package is CommonJS only; no default ESM export.

main

✓ const { main } = require('nipsu');

If exported, use named import via destructuring.

Shows how to call nipsu programmatically via its main function with custom options.

const nipsu = require('nipsu'); const path = require('path'); const inputFile = '/path/to/crash-input'; const tempDir = '/tmp/nipsu-temp'; const outputDir = '/tmp/nipsu-output'; const targetBin = '/usr/bin/target'; nipsu.main({ input: inputFile, temp: tempDir, output: outputDir, target: targetBin, timeout: 2, delimiters: [',', ' ', '\n', '<', '>'], chunksizes: [100, 50, 20, 10, 5, 1], realtime: false });

Debug

Known issues

gotchaRealtime mode can mess up terminal with binary data.

fix

Avoid realtime mode when processing binary inputs, or use with caution.

affects: >=0.0.0

gotchaTarget binary must be ASan-instrumented and accept '@@' as filename placeholder.

fix

Ensure the target binary is compiled with AddressSanitizer (ASan) and supports the @@ syntax (like afl).

affects: >=0.0.0

gotchaTemp directory and output directory must exist before running.

fix

Create directories manually or use a wrapper that ensures they exist.

affects: >=0.0.0

Errors

Common errors & fixes

Error: ENOENT: no such file or directory, open '/tmp/nipsu-temp/test.txt'

Temp directory does not exist.

fix

Create the temp directory before running nipsu.

Error: spawn <target-bin> ENOENT

Target binary not found or not executable.

fix

Provide full path to the ASan-instrumented binary.

Error: Input file not found: /path/to/input

Input file path is incorrect.

fix

Ensure the input file exists at the specified path.

Upgrade

Version history

0.0.3latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

11 hits · last 30 days

node

Resources

githubhttps://github.com/attekett/nipsu ↗

packagenipsu ↗

homepagehttps://github.com/attekett/nipsu#readme ↗