GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SHLOCK (1)

.ds Aq ’

NAME

shlock - Create lock files for use in shell scripts

CONTENTS

SYNOPSIS

shlock [-b|-c|-u] -f name -p pid

DESCRIPTION

shlock tries to create a lock file named name and write the process ID pid into it. If the file already exists, shlock will read the process ID from the file and test to see whether the process is currently running. If the process exists, then the file will not be created. shlock exits with a zero status if it could create the lock file, or non-zero if the file refers to a currently active process.

A Perl wrapper around shlock can be used via the INN::Utils::Shlock module.

OPTIONS

-b Process IDs are normally read and written in ASCII. If the -b flag is used, then they will be written as a binary int.
-c If the -c flag is used, then shlock will not create a lock file, but will instead use the file to see if the lock is held by another program. If the lock is valid, the program will exit with a non-zero status; if the lock is not valid (i.e. invoking shlock without the flag would have succeeded), then the program will exit with a zero status.
-f name name is the name of the lock file shlock attempts to create. If the file already exists, it will read the process ID from the file and exit with a non-zero status if this process is currently active.
-p pid pid is the process ID to write into the file name.
-u For compatibility with other systems, the -u flag is accepted as a synonym for -b since binary locks are used by many UUCP packages.

EXAMPLES

The following example shows how shlock would be used within a shell script:



    LOCK=<pathrun in inn.conf>/LOCK.send
    trap rm -f ${LOCK} ; exit 1 1 2 3 15
    if shlock -p $$ -f ${LOCK} ; then
        # Do appropriate work.
    else
        echo "Locked by `cat ${LOCK}`"
    fi



HISTORY

Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews after a description of HDB UUCP locking given by Peter Honeyman, and improved by Berend Reitsma to solve a race condition. Converted to POD by Julien Elie.

$Id: shlock.pod 9303 2011-08-04 22:09:57Z iulius $

SEE ALSO

INN::Utils::Shlock(3pm).
Search for    or go to Top of page |  Section 1 |  Main Index


INN 2.6.0 SHLOCK (1) 2015-09-12

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.