Description:

This module implements a persistent counter class. Each counter is
represented by a separate file in the file system. File locking is applied,
so multiple processes can attempt to access a counter simultaneously
without risk of counter destruction.

You give the file name as the first parameter to the object constructor
('new'). The file is created if it does not exist.

If the file name does not start with "/" or ".", then it is interpreted as
a file relative to '$File::CounterFile::DEFAULT_DIR'. The default value for
this variable is initialized from the environment variable 'TMPDIR', or
_/usr/tmp_ if no environment variable is defined. You may want to assign a
different value to this variable before creating counters.