How can I lock a file?

Perl's built-in flock function (see the perlfunc manpage for details) will call flock if that exists, fcntl if it doesn't, and lockf if neither of the two previous system calls exists. On some systems, it may even use native locking. Some gotchas with Perl's flock:

  1. Produces a fatal error if none of the three system calls (or their equivalent) exists.

  2. lockf does not provide shared locking, and requires that the filehandle be open for writing (or appending, or read/writing).

  3. Some versions of flock can't lock files over a network (e.g. on NFS file systems), so you'd need to force the use of fcntl when you build Perl (see the flock entry of the perlfunc manpage, and the INSTALL file in the source distribution for information on building Perl to do this).

The CPAN module File::Lock offers similar functionality and (if you have dynamic loading) won't require you to rebuild perl if your flock can't lock network files.