Skip to content

Utility module to print pretty messages on SIGINFO/SIGUSR1

License

Notifications You must be signed in to change notification settings

emilbayes/siginfo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

siginfo

Build Status

Utility module to print pretty messages on SIGINFO/SIGUSR1

SIGINFO on BSD / macOS and SIGUSR1 on Linux, usually triggered by Ctrl + T, are by convention used to print information about a long running process internal state. Eg. dd will tell you how many blocks it has written and at what speed, while xz will tell you progress, compression ratio and estimated time remaining.

This module wraps both signals, checks if the process is connected to TTY and lets you do whatever you want.

Usage

var siginfo = require('siginfo')
var pkg = require('./package.json')

siginfo(function () {
  console.dir({
    version: pkg.version,
    uptime: process.uptime()
  })
})

API

var removeListener = siginfo(queryFn, [force])

queryFn can be used for whatever you want (logging, sending a UDP message, etc.). Setting force = true will attach the event handlers whether a TTY is present or not.

Install

npm install siginfo

License

ISC

About

Utility module to print pretty messages on SIGINFO/SIGUSR1

Resources

License

Stars

Watchers

Forks

Packages

No packages published