NAME
IPC::ConcurrencyLimit::Lock::NFS - Locking via NFS
SYNOPSIS
use IPC::ConcurrencyLimit;
DESCRIPTION
This locking strategy uses File::SharedNFSLock to implement locking on
NFS shares across multiple hosts. The locking technique employed by
"File::SharedNFSLock" should work on other, local file systems as well.
If in doubt, do your own testing.
Beware: If processes are killed harshly without being able to clean up,
stale lock files may remain that are not recoverable. In principle,
"File::SharedNFSLock" can reclaim them after a timeout, but that feature
does not seem to make a lot of sense in this context. All
"File::SharedNFSLock" gotchas apply.
METHODS
new
Given a hash ref with options, attempts to obtain a lock in the pool. On
success, returns the lock object, otherwise undef.
Required options:
"path"
The directory that will hold the lock files. Created if it does not
exist. It is suggested not to use a directory that may hold other
data.
"max_procs"
The maximum no. of locks (and thus usually processes) to allow at one
time.
lock_file
Returns the full path and name of the lock file.
path
Returns the directory in which the lock files resides.
AUTHOR
Steffen Mueller, "
[email protected]"
COPYRIGHT AND LICENSE
(C) 2011 Steffen Mueller. All rights reserved.
This code is available under the same license as Perl version
5.8.1 or higher.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
