BSD Ports

devel/liblockfile 1.17_1 FreeBSD

Standard lockfile library

System
FreeBSD
Repository
FreeBSD ports
Maintainer
[email protected]
License
GPLv2+, LGPL21+
Categories
devel
Package size
36.3 KiB, 104.2 KiB installed

Description

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.

In the other systems

SystemPortVersion
FreeBSDdevel/liblockfile1.17_1
DragonFlydevel/liblockfile1.17_1
MidnightBSDdevel/liblockfile1.16

Install

Binary package:

pkg install liblockfile

From the ports tree:

cd /usr/ports/devel/liblockfile/ && make install clean

To depend on this port in another port's Makefile:

RUN_DEPENDS=	liblockfile>0:devel/liblockfile
LIB_DEPENDS=	liblockfile.so:devel/liblockfile

Packages

The version each package repository carries. “-” means the repository builds no package of it, “n/a” that there is no such repository.

Repositoryaarch64amd64armv6armv7i386
FreeBSD:14:latest1.17_11.17_11.171.17_11.17_1
FreeBSD:14:quarterly1.17_11.17_1n/a1.17_11.17_1
FreeBSD:15:latest1.17_11.17_1n/a1.17_11.17_1
FreeBSD:15:quarterly1.17_11.17_1n/an/an/a
FreeBSD:16:latest1.17_11.17_1n/an/an/a
FreeBSD:16:quarterlyn/an/an/an/an/a

Dependencies

The Makefile names none itself; they come from USES and USE_*.

The full lists below include those, and their dependencies in turn.

Configuration

Options name: devel_liblockfile

OptionDefaultDescription
DOCSoffBuild and/or install documentation
Service scripts
none

Message after installing

===>   NOTICE:

The liblockfile port currently does not have a maintainer. As a result, it is
more likely to have unresolved issues, not be up-to-date, or even be removed in
the future. To volunteer to maintain this port, please create an issue at:

https://bugs.freebsd.org/bugzilla

More information about port maintainership is available at:

https://docs.freebsd.org/en/articles/contributing/#ports-contributing

Files

Manual pages 3
  • dotlockfile(1)
  • lockfile_create(3)
  • maillock(3)
pkg-plist 10
  • @(,mail,2755) bin/dotlockfile
  • include/lockfile.h
  • include/maillock.h
  • lib/liblockfile.a
  • lib/liblockfile.so
  • lib/liblockfile.so.1
  • lib/liblockfile.so.1.0
  • share/man/man1/dotlockfile.1.gz
  • share/man/man3/lockfile_create.3.gz
  • share/man/man3/maillock.3.gz
distinfo 1
FileSizeSHA256
miquels-liblockfile-v1.17_GH0.tar.gz698347d34e4b054f878be492dd782c34bfe2107689414aa82a361202756bbe3ec6ad8

Commit history 0

No commits in the history this site was built from.