Perl5 module for file locking (flock,fcntl) Maintained by:demon@FreeBSD.org Port Added: unknown Also Listed In:perl5 License: not specified in port
This is my first alpha release of File::Lock, my version of the code
greatfully provided by Jarrko. I've mucked about with it quite a bit,
and there are a few policy decisions you might not agree with:
All of the locking functions (see t/* for full details),
File::lock::(lockf/flock/fcntl) are not exported from File::Lock. They all
take the same set of arguments: FileHandle, mode, pos, whence, length.
(Except for lockf, which doesn't take the position arguments.) Mode is two
characters, and can be "wb" for write-lock/non-blocking, or "rn", for
read-lock/blocking. Most other characters will work fine. (Look in typemap)
pos, whence, and length default to "the whole file". Use "u" to unlock a
handle.
The only OO interface is via "new File::Lock()" which uses
File::Lock::fcntl. If it were working properly, then the lock would be
unlocked on destruction. But it isn't.
File::Lock::lockfile isn't written yet, but will be.
You can use a mode of "t" or "i" to get info/test a lock. fcntl in array
context will return an array consisting of all the usual fcntl data.
In any other case, a single letter is returned, "u", "w", or "r",
for the detected locking mode. (or unlocked.)
All calls return true if successful. Currently no mucking about with errno
is done, so it might not be the same for the same condition on all systems.
If you need real fcntl() and it's constants, use Fcntl. File::Lock does
optionally export SEEK_*, and LOCK_EX|UN|SH, though. (I don't remember why,
though, on the latter.)
Any comments, complaints, or bug patches would be greatly appreciated.
- Take advantage of CPAN macro from bsd.sites.mk, change
${MASTER_SITE_PERL_CPAN} to CPAN.
PR: ports/122674
Submitted by: Philip M. Gollucci <pgollucci@p6m7g8.com>
Reworked by: araujo (myself)
Approved by: portmgr (pav)
Move inclusion of bsd.port.pre.mk later in the file for conditional BROKEN
tag. Early inclusion caused problems for some ports, so to be safe I'm
updating all of them.
Pointy hat to: kris
Lots and lots of cleanups. Teach p5-* in general about PKGNAMEPREFIX. Add
some missing/wrong dependencies. Show how to respect CC/CFLAGS. Many
miscellaneous modifications. I used more excessive hacks to force p5-Jcode
and p5-WWW-Search to respect CC/CFLAGS.
If you buy from Amazon USA, please support us by using this link.
