NAME

Genezzo::Contrib::Clustered::GLock::GLock - Generic locking for Genezzo

SYNOPSIS

$curLock = new GLock(lock => $lockName, block => 1);
$curLock->lock(shared => 0);
$curLock->promote();
$curLock->unlock();

DESCRIPTION

Basic locking for Genezzo. Available implementations include NONE and OpenDLM.

FUNCTIONS

new (lock => NAME, block => BLOCKING)

Creates new lock with name NAME. Blocking if BLOCKING=1 (default). Depending on implementation, new or following lock() may be blocking.

lock (shared => SHARED)

Locks lock. Shared if SHARED=1, otherwise Exclusive (default). Returns undef for failure.

promote

Promotes lock from Shared to Exclusive. Returns undef for failure.

unlock

Unlocks lock.

LIMITATIONS

Edit $IMPL to choose implementation. This will eventually be configured from somewhere else.

AUTHOR

Eric Rollins, rollins@acm.org

Copyright (c) 2005 Eric Rollins. All rights reserved.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
any later version.

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.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

Address bug reports and comments to rollins@acm.org

For more information, please visit the Genezzo homepage at http://www.genezzo.com