Author image Marvin Humphrey
and 1 contributors

NAME

KinoSearch::Store::SharedLock - Shared (read) lock.

SYNOPSIS

    my $lock_factory = KinoSearch::Store::LockFactory->new(
        folder    => $folder,
        agent_id  => $hostname,
    );
    my $lock = $lock_factory->make_shared_lock(
        lock_name => 'segments_6r',
        timeout   => 5000,
    );

DESCRIPTION

SharedLock's interface is nearly identical to that of its parent class KinoSearch::Store::Lock, taking the same constructor arguments and implementing the same list of methods. It differs from Lock only in the semantics of two methods:

  • obtain() will not fail if another lock is held against lock_name (though it might fail for other reasons).

  • is_locked() returns true so long as some lock, somewhere is holding a lock on the resource identified by lock_name. That lock could be this instance, or it could be another. So this sequence is entirely possible:

        $lock->release; # works this time
        $lock->release; # doesn't do anything
        print "Still locked!" if $lock->is_locked; # prints "Still locked!"

COPYRIGHT

Copyright 2007 Marvin Humphrey

LICENSE, DISCLAIMER, BUGS, etc.

See KinoSearch version 0.20.