NAME

IPC::Lockfile - run only one instance of a program at a time using flock

VERSION

version 0.02

SYNOPSIS

Just import the module:

#!/usr/bin/env perl
use IPC::Lockfile;

... # program code here

This will create a lockfile in the same directory as the program. To avoid race conditions, the file will not be deleted when the program ends.

Or do not use this module and just add these two lines to your program:

use Fcntl qw(:flock);
flock DATA, LOCK_EX|LOCK_NB or die "$0 is running!\n";;

No external lockfile is created as it uses _DATA_. An elegant solution for lockfiles proposed by Mark Jason Dominus.

DESCRIPTION

IPC::Lockfile is a module for use with Perl programs when you only want one instance of the script to run at a time. It uses flock and should work if run on an OS that supports flock (e.g. Linux, BSD, OSX and Windows).

SEE ALSO

IPC::Pidfile for a PID-based solution that relies on signals and has a race condition (not recommended).

AUTHOR

David Farrell <dfarrell@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2015 by David Farrell.

This is free software, licensed under:

The (two-clause) FreeBSD License