lockfile-progs(1)              Lockfile programs             lockfile-progs(1)

<?><?><?> (NAME)
       lockfile-progs - <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       (<?><?> <?><?><?><?> liblockfile)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       mail-lock [--use-pid] [--retry retry-count]
       mail-unlock
       mail-touchlock [--oneshot]

       lockfile-create [--use-pid] [--retry retry-count] [--lock-name] filename
       lockfile-remove [--lock-name] filename
       lockfile-touch [--oneshot] [--lock-name] filename
       lockfile-check [--use-pid] [--lock-name] filename

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> lockfile-progs <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?>
       <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?><?> (<?><?> <?><?><?><?>
       liblockfile) <?><?><?><?><?><?><?> <?><?><?><?>:

           mail-lock - <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           mail-unlock - <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           mail-touchlock - <?><?><?><?><?> (touch) <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>

           lockfile-create - <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           lockfile-remove - <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           lockfile-touch - <?><?><?><?><?> (touch) <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           lockfile-check - <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>


       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       filename <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?> <?><?><?> <?> <?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?> filename.lock <?><?><?><?><?>
       <?><?><?>. <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       --lock-name <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
       filename <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.


       <?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> /var/spool/mail/<user> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?> <user> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> (effective user ID)
       <?><?><?> <?> <?><?> <?><?><?><?> geteuid(2) <?><?><?><?><?>
       <?><?><?><?><?><?>.


       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> (touch) <?><?><?><?> <?><?>
       <?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> (stale)
       <?><?><?><?> <?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?>
       --use-pid <?> <?><?><?><?> <?><?><?><?><?><?><?> lockfile_create(3)
       <?><?> <?><?><?><?><?><?>.


       <?><?><?><?><?> lockfile-check <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
       --version
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?><?><?>.

       -q, --quiet
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>.
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?>.

       -v, --verbose
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           (<?><?> <?><?><?><?><?><?>).

       -l, --lock-name
           <?><?><?><?><?> .lock <?><?> <?><?> filename <?><?><?><?><?>
           <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> lockfile-create<?> lockfile-remove<?>
           lockfile-touch <?><?> lockfile-check <?><?><?><?><?><?>
           <?><?><?><?>.

       -p, --use-pid
           <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> (PPID) <?><?> <?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?> PID
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> lockfile_create(3) <?><?> <?><?><?><?><?><?>.
           <?><?><?> <?><?><?><?><?> <?><?><?><?> lockfile-create <?>
           lockfile-check <?><?><?><?><?><?> <?><?><?><?>.  <?><?><?><?>:
           <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?>.

       -o, --oneshot
           <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> lockfile-touch
           <?> mail-touchlock <?><?><?><?><?><?> <?><?><?><?>. <?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       -r retry-count, --retry retry-count
           <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           retry-count <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> filename
           <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?> <?><?><?><?> <?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?> (<?><?> <?><?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?>) <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.
           <?><?><?> retry-count <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?> <?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?>
           <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?>.


<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>:

         lockfile-create /some/file
         lockfile-touch /some/file &
         # <?><?><?><?><?> PID <?><?><?><?><?><?> lockfile-touch
         BADGER="$!"
         do-something-important-with /some/file
         kill "${BADGER}"
         lockfile-remove /some/file


<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       0
           <?><?><?><?> lockfile-check <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?>.

       <?><?><?> <?><?> 0
           <?><?><?><?> lockfile-check <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?>. <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?>.


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       maillock(3)
       touchlock(3)
       mailunlock(3)
       lockfile_create(3)
       lockfile_remove(3)
       lockfile_touch(3)
       lockfile_check(3)


<?><?><?><?><?><?><?> (AUTHOR)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> Rob Browning
       <rlb@defaultvalue.org>

0.2.0                             2024-12-10                 lockfile-progs(1)