DragonFly On-Line Manual Pages

BIGFILE(1)             DragonFly General Commands Manual            BIGFILE(1)

NAME
     bigfile - kill (or signal) a process when a file grows too big

SYNOPSIS
     bigfile [-v] [-S signal] [-w interval] -p pid -s maxsize filename

DESCRIPTION
     The bigfile utility examines a file periodically and sends a signal to a
     process when the file reaches the specified size.

     Options:

     -p      The process ID to signal.

     -S      The signal number or name to send; default: TERM.

     -s      The file size limit.

     -w      The wait interval in seconds; default: 5.

     -v      Verbose operation; display diagnostic messages.

RETURN VALUES
     The bigfile utility exits 0 on success, and >0 if an error occurs.

ENVIRONMENT
     The operation of the bigfile utility is currently not affected by
     environment variables.

FILES
     The operation of the bigfile utility is currently not affected by any
     files.

EXAMPLES
     Kill a tcpdump process when its output goes over 100 KB:

           bigfile -p `pgrep tcpdump` -s 102400 traffic.tcp

     Send a hangup signal to a daemon as soon as possible if it's been too
     verbose:

           bigfile -S HUP -w 1 -p `cat /var/run/d.pid` -s 8000 /var/log/d.log

SEE ALSO
     kill(1), sleep(1), stat(1)

HISTORY
     The bigfile utility was written by Peter Pentchev in 2010.

AUTHORS
     Peter Penchev <roam@ringlet.net>

BUGS
     No, thanks!  Still, if you should find any, please report them to the
     author :)

TODO
     *       Parse file size suffixes (k, m, ...)

     *       Add subsecond precision for OS's that support it.

     *       Periodic operation - a poor man's logrotate(8)? :)

DragonFly 6.5-DEVELOPMENT      December 20, 2010     DragonFly 6.5-DEVELOPMENT