Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

Genezzo::Contrib::Clustered::GLock::GLockUR
Unix record locking implementation for Genezzo

Genezzo::Contrib::Clustered::GLock::GLockUR - Unix record locking implementation for Genezzo


NAME

Genezzo::Contrib::Clustered::GLock::GLockUR - Unix record locking implementation for Genezzo


SYNOPSIS


    my $lockid = ur_lock($name, $shared, $blocking);

    my $success = ur_promote($name, $lockid, $blocking);

    my $success = ur_unlock($lockid);


DESCRIPTION

Provides Perl wrappers to basic Unix record fcntl C functions.


FUNCTIONS

ur_lock NAME, SHARED, BLOCKING
Locks lock with name NAME. Shared if SHARED=1, otherwise exclusive. Blocking if BLOCKING=1, otherwise returns immediately. Returns lockid,or 0 for failure.

ur_promote NAME, LOCKID, BLOCKING
Promotes lock with name NAME and lockid LOCKID to exclusive mode. Returns 1 for success, or 0 for failure.

ur_demote NAME, LOCKID, BLOCKING
Demotes lock with name NAME and lockid LOCKID to shared mode. Returns 1 for success, or 0 for failure.

ur_unlock LOCKID
Releases lock with lockid LOCKID. Returns 1 for success, 0 for failure.

EXPORT

ur_lock, ur_promote, ur_unlock


LIMITATIONS

Relies on Perl Inline::C module. Currently terminates program when deadlock detected.

Inline code is installed in directory /Inline, so it can be used with Apache.

A file /tmp/genezzo.lock is created. It must be writeable by the accessing processes. The undo file should probably be used for locking instead.

All processes must be owned by the same user; otherwise kill SIGUSR2 signals will be blocked.


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

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy