shlock man page on 4.4BSD

Man page or keyword search:  
man Server   1065 pages
apropos Keyword Search (all sections)
Output format
4.4BSD logo
[printable version]

SHLOCK(1)							     SHLOCK(1)

NAME
       shlock - create lock files for use in shell scripts

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

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 if the process is currently running.
       If the process exists, then the file will not be created.

       Shlock exits with a zero status if it was able to create the lock file,
       or non-zero if the file refers to currently-active process.

       Process IDs are normally read and written in ASCII.  If the ``-b'' flag
       is used, then they will be written as a binary int.  For	 compatibility
       with other systems, the ``-u'' flag is accepted as a synonym for ``-b''
       since binary locks are used by many UUCP packages.

       The following example shows how shlock would be	used  within  a	 shell
       script:
	      LOCK=/var/spool/news/data/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

       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  be  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 sta‐
       tus.

HISTORY
       Written by Rich $alz <rsalz@uunet.uu.net> after a  description  of  HDB
       UUCP  locking  given  by	 Peter	Honeyman.  This is revision 1.7, dated
       1993/01/29.

								     SHLOCK(1)
[top]

List of man pages available for 4.4BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net