DragonFly On-Line Manual Pages

Search: Section:  

LOCKERSH(1)           User Contributed Perl Documentation          LOCKERSH(1)


NAME

       lockersh - Run a command under a global lock


SYNOPSIS

         lockersh [--dhost <host> --port <port>] --lock <name> [args....]


DESCRIPTION

       Obtain a global IPC::Locker lock with the passed name.

       When the lock is granted, run the arguments as a command in the
       foreground.  When the foreground process exits, release the lock, and
       return the executed command's exit status.

       This makes it very easy to insure only one copy of a program executes
       across a clump:

          lockersh --lock one_sleep_runs sleep 10


ARGUMENTS

       --dhost host
           Hostname of lockerd server.  Defaults to IPCLOCKER_HOST environment
           variable.

       --help
           Displays this message and program version and exits.

       --lock lockname
           Name for the lock.  This argument may be passed multiple times or
           with a colon separator to allow one of multiple possible locks to
           be selected.

       --locklist
           Suppress normal operation, and instead print a list of all
           outstanding locks and their owners.

       --port port
           Port of pidstatd server on remote host.  Defaults IPCLOCKER_PORT
           environment variable.

       --timeout
           Set number of seconds before wait for license will timeout.
           Defaults to wait forever.

       --verbose
           Print 'waiting for lock' and similar messages.

       --version
           Displays program version and exits.


ENVIRONMENT

       IPCLOCKER_HOST
           Hostname of lockerd server, or colon separated list including
           backup servers.  Defaults to localhost.

       IPCLOCKER_PORT
           Port number of lockerd server.  Defaults to 1751.


DISTRIBUTION

       The latest version is available from CPAN and from
       <http://www.veripool.org/>.

       Copyright 2006-2013 by Wilson Snyder.  This package is free software;
       you can redistribute it and/or modify it under the terms of either the
       GNU Lesser General Public License Version 3 or the Perl Artistic
       License Version 2.0.


AUTHORS

       Wilson Snyder <wsnyder@wsnyder.org>


SEE ALSO

       IPC::Locker, pidstat, lockersh, uriexec

perl v5.20.2                      2013-01-31                       LOCKERSH(1)

Search: Section: