Genezzo::Contrib::Clustered::GLock::GLockDLM - OpenDLM locking implementation for Genezzo


Genezzo-Contrib-Clustered documentation Contained in the Genezzo-Contrib-Clustered distribution.

Index


Code Index:

NAME

Top

Genezzo::Contrib::Clustered::GLock::GLockDLM - OpenDLM locking implementation for Genezzo

SYNOPSIS

Top

    my $lockid = dlm_lock($name, $shared, $blocking);
    my $success = dlm_promote($name, $lockid, $blocking);
    my $success = dlm_unlock($lockid);

DESCRIPTION

Top

Provides Perl wrappers to basic OpenDLM C functions.

FUNCTIONS

Top

dlm_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.

dlm_promote NAME, LOCKID, BLOCKING

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

dlm_demote NAME, LOCKID, BLOCKING

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

dlm_unlock LOCKID

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

dlm_ast_poll

Returns 1 if recent asyncronous request for lock held by process. 0 otherwise.

EXPORT

dlm_lock, dlm_promote, dlm_unlock

LIMITATIONS

Top

Relies on Perl Inline::C module. Requires OpenDLM be installed. Currently terminates program when deadlock detected.

AUTHOR

Top

Eric Rollins, rollins@acm.org

SEE ALSO

Top

http://opendlm.sourceforge.net/docs.php.

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


Genezzo-Contrib-Clustered documentation Contained in the Genezzo-Contrib-Clustered distribution.

#!/usr/bin/perl
#
# copyright (c) 2005, Eric Rollins, all rights reserved, worldwide
#
#
#

use strict;
use warnings;

package Genezzo::Contrib::Clustered::GLock::GLockDLM;

# Locking for Genezzo using OpenDLM 
use Inline (C => 'DATA',
	    DIRECTORY => '/Inline',  # Apache needs a writeable directory
	    LIBS => '-ldlm');

require Exporter;

Inline->init;  # help for "require GLockDLM"

our @ISA = qw(Exporter);
our @EXPORT = qw(dlm_lock dlm_unlock dlm_promote);

sub dlm_lock()
{
    my ($name, $shared, $blocking) = @_;

    my $ret = return dlm_lock_impl($name, $shared, $blocking);

    if($ret == -1){
      die "DEADLOCK";
    }

    return $ret;
}

sub dlm_unlock()
{
    my ($lockid) = @_;

    return dlm_unlock_impl($lockid);
}

sub dlm_promote()
{
    my ($name, $lockid, $blocking) = @_;

    my $ret = dlm_promote_impl($name, $lockid, $blocking);

    if($ret == -1){
      die "DEADLOCK";
    }

    return $ret;
}

sub dlm_demote()
{
    my ($name, $lockid, $blocking) = @_;

    my $ret = dlm_demote_impl($name, $lockid, $blocking);

    if($ret == -1){
      die "DEADLOCK";
    }

    return $ret;
}

sub dlm_ast_poll()
{
    return dlm_ast_poll_impl();
}

sub dlm_set_notify()
{
    return dlm_set_notify_impl();
}

BEGIN
{
    print STDERR "Genezzo::Contrib::Clustered::GLock::GLockDLM installed\n";
}

1;

__DATA__

__C__

//
#include <opendlm/dlm.h>
#include <sys/types.h>
#include <unistd.h>

static int ast_request = 0;

static void bast_func(void *astargs, int mode){
  char *ch_args = (char*)astargs;

  if(!ch_args) ch_args = "unknown";

/*
  fprintf(stderr,"\nDLM:  blocked lock request for lock (%s) in mode: ",
    ch_args);

  if(mode == LKM_EXMODE){
    fprintf(stderr,"EX\n");
  }else if(mode == LKM_PRMODE){
    fprintf(stderr,"PR\n");
  }else{
    fprintf(stderr,"%d\n",mode);
  }
*/
  if(mode == LKM_EXMODE){  // Ignore PR (SHARED) requests, since we drop
    ast_request = 1;       // to SHARED mode after commit anyway.
  }
}

// Leak lockname on every request!
//#define LEAK 1

static void *ast_arg(char *lockname){
#ifdef LEAK
    return (void*)strdup(lockname);
#else
    return (void*)0;
#endif
}

// returns lockid, 0 for failure, -1 for deadlock
int dlm_lock_impl(char *name, int shared, int block){
  dlm_stats_t status;
  struct lockstatus lksb;
  lksb.timeout = 0;
  int mode = LKM_EXMODE;

  if(shared) mode = LKM_PRMODE;

  int flags = 0;

  if(!block) flags = LKM_NOQUEUE;

  status = dlmlock_sync(mode,
			&lksb,
			flags,
			name,
			strlen(name),
			ast_arg(name),
			bast_func);

  if(status != DLM_NORMAL) {
    if(block || (status != DLM_NOTQUEUED)){
      dlm_perror("dlmlock_sync");
    }

    if(status == DLM_DEADLOCK){
      return -1;
    }else{
      return 0;
    }
  }

  if((!block) && (lksb.status == DLM_NOTQUEUED)){
    return 0;
  } 

  if(lksb.status != DLM_NORMAL){
    dlm_perror("dlmlock_sync(2)");
    return 0;
  }

  return lksb.lockid;
}

// returns 1 for success, or 0 for failure
int dlm_unlock_impl(int lockid){
  dlm_stats_t status;
  struct lockstatus lksb;
  lksb.timeout = 0;

  status = dlmunlock_sync(lockid,
			  &(lksb.value[0]),
			  0);

  if(status != DLM_NORMAL) {
    dlm_perror("dlmunlock_sync");
    return 0;
  }

  return 1;
}

// returns 1 for success, or 0 for failure
int dlm_promote_impl(char *name, int lockid, int block){
  dlm_stats_t status;
  struct lockstatus lksb;
  lksb.timeout = 0;
  lksb.lockid = lockid;
  int mode = LKM_EXMODE;
  int flags = LKM_CONVERT;

  if(!block) flags |= LKM_NOQUEUE;

  status = dlmlock_sync(mode,
			&lksb,
			flags,
			name,
			strlen(name),
			ast_arg(name),
			bast_func);

  if(status != DLM_NORMAL) {
    dlm_perror("dlmlock_sync(3)");

    if(status == DLM_DEADLOCK){
      return -1;
    }else{
      return 0;
    }
  }

  if((!block) && (lksb.status == DLM_NOTQUEUED)){
    return 0;
  } 

  if(lksb.status != DLM_NORMAL){
    dlm_perror("dlmlock_sync(4)");
    return 0;
  }

  return 1;
}

// returns 1 for success, or 0 for failure
int dlm_demote_impl(char *name, int lockid, int block){
  dlm_stats_t status;
  struct lockstatus lksb;
  lksb.timeout = 0;
  lksb.lockid = lockid;
  int mode = LKM_PRMODE;
  int flags = LKM_CONVERT;

  if(!block) flags |= LKM_NOQUEUE;

  status = dlmlock_sync(mode,
			&lksb,
			flags,
			name,
			strlen(name),
			ast_arg(name),
			bast_func);

  if(status != DLM_NORMAL) {
    dlm_perror("dlmlock_sync(5)");

    if(status == DLM_DEADLOCK){
      return -1;
    }else{
      return 0;
    }
  }

  if((!block) && (lksb.status == DLM_NOTQUEUED)){
    return 0;
  } 

  if(lksb.status != DLM_NORMAL){
    dlm_perror("dlmlock_sync(6)");
    return 0;
  }

  return 1;
}

// Returns 1 for recent ast request, 0 for none.
int dlm_ast_poll_impl(){
  ASTpoll(getpid(), 0);
  int ret_ast_request = ast_request;
  ast_request = 0;
  return ret_ast_request;
}

static void sig_func(){
    fprintf(stderr,"\nSIGNAL RECD\n\n");
}

int dlm_set_notify_impl(){
  if(dlm_setnotify(SIGUSR2,0) != DLM_NORMAL){
    dlm_perror("dlm_setnotify");
  }

/*
  sigset_t mask;
  sigemptyset(&mask);
  sigaddset(&mask, SIGUSR2);
  sigprocmask(SIG_UNBLOCK, &mask, 0);
  signal(SIGUSR2, sig_func);
*/

  return 0;
}