/usr/share/doc/libio-lockedfile-perl/README is in libio-lockedfile-perl 0.23+d030220-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 | IO::LockedFile
Copyright (c) 2001-2002 Ockham Technology N.V. & Rani Pinchuk.
All rights reserved.
This package is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
DESCRIPTION
In its simplistic use, the IO::LockedFile class gives us the same
interface of the IO::File class to files with the unique difference
that those files are locked using the flock mechanism. Yet, the
class provides us with the ability to use other schemes then flock.
Example for the use of the class:
use IO::LockedFile;
# create new locked file object. $file will hold a file handle.
# if the file is already locked, the method will not return until the
# file is unlocked
my $file = new IO::LockedFile(">locked1.txt");
# when we close the file - it become unlocked.
$file->close();
PREREQUISITES
IO::File
Fcntl
INSTALLATION
Follow the standard installation procedure for Perl modules, which is to
type the following commands:
perl Makefile.PL
make
make test
make install
You'll probably need to do the last as root.
AUTHOR NOTES
After I wrote the first version of this module that was extremely simple,
I found out that actually my knowledge in locking files was quite poor.
Yet, with the help of some great people, the module became (hopefully)
better.
This is why I would like to ask you for help when you see bugs, mistakes
or just if you have any suggestions or comments - please email me.
Rani Pinchuk
rani@cpan.org
|