Skip to content
The standard lockfile library. Debian packaging is at
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
licenses update license and copyright information Nov 21, 2016
.gitignore ignore .nfsxxxxx files Dec 7, 2016
acconfig.h version 1.01 Jun 21, 1999 version 1.01 Jun 21, 1999
configure autoconf update Nov 28, 2016
dotlockfile.1 reinstate -m option when exec'ing command Jan 17, 2017
lockfile_create.3 document L_PPID Jan 5, 2017
maillock.3 version 1.03 Apr 6, 2001


			README for liblockfile

This library implements a number of functions found in -lmail on SysV
systems. These functions are designed to lock the standard mailboxes in
/var/mail (or wherever the system puts them).

In additions, this library adds a number of functions to create,
manage and remove generic lockfiles.

The lockfiles are created by this library in an NFS-safe manner, that
is by using a tempfile and using link(2) to create the lockfile. It
works around several defects in NFS servers to make sure the lockfile
is created atomically.

The locking strategy is compatible with other well-written NFS-safe
programs that create lockfiles - such as procmail, exim and mutt.

If you are trying to lock a mailbox in a directory writable for group
mail, the locking functions will call a helper application which runs
setgid to do the actual locking. The helper application "dotlockfile"
can also be used directly, for example for use in shellscripts.

This means a program such as a MUA doesn't need to be setgid mail anymore
to be able to lock the mailbox.

See the included manualpages for more info:

Function			Manpage
========			=======
touchlock -			maillock.3

lockfile_check -		lockfile_create.3

    README  1.00  17-Apr-1999  Miquel van Smoorenburg <>

You can’t perform that action at this time.