cprogs/with-lock-ex.1

   1 .TH WITH-LOCK-EX "1" "July 2003" "Debian" "Chiark-utils-bin"
   2 .SH NAME
   3 with-lock-ex \- file locker
   4 .SH SYNOPSIS
   5 .B with-lock-ex
   6 .RB [\| \-w \||\| \-q \||\| \-f \|]
   7 .I lockfile command
   8 .IR args \ \|.\|.\|.
   9 .br
  10 .SH DESCRIPTION
  11 with-lock-ex will open and lock the lockfile for writing and then feed
  12 the remainder of its arguments to
  13 .BR exec (2);
  14 when that process terminates the fd will be closed and the file
  15 unlocked automatically by the kernel.
  16 .SH OPTIONS
  17 .TP
  18 .B \-w
  19 wait for the lock
  20 .TP
  21 .B \-f
  22 fail if the lock cannot be acquired
  23 .TP
  24 .B \-q
  25 silently do nothing if the lock cannot be acquired
  26 .SH AUTHOR
  27 This Manual page was written by Matthew Vernon <matthew@debian.org> but
  28 may be used by anyone.
  29 .SH COPYRIGHT
  30 with-lock-ex was written by Ian Jackons <ian@chiark.greenend.org.uk>
  31 in 1993, 1994, 1995, 1996, 1998, 1999. He has placed it in the public
  32 domain.