ost::Lockfile(3)					     Library Functions Manual						  ost::Lockfile(3)

NAME

       ost::Lockfile -

       This class is used to create a 'named' lock entity that can be used to control access to a resource between multiple processes.

SYNOPSIS

       #include <process.h>

   Public Member Functions
       Lockfile (const char *name)
	   Create a lock under a known name.
       Lockfile ()
	   Create a new lock object that can be used to make locks.
       ~Lockfile ()
	   Destroy the current lock and release it.
       bool lock (const char *name)
	   Lock a system-wide name for this process.
       void unlock (void)
	   Release an acquired lock.
       bool isLocked (void)
	   Flag if the current process has aqcuired a lock.

Detailed Description
       This class is used to create a 'named' lock entity that can be used to control access to a resource between multiple processes.

       The posix implimentation uses a pidfile and the win32 version uses a globally visible mutex.

       Author:
	   David Sugar dyfet@ostel.com System-wide named lock

Constructor &; Destructor Documentation
   ost::Lockfile::Lockfile (const char *name)
       Create a lock under a known name. Parameters:
	   name of system-wide lock to create.

   ost::Lockfile::Lockfile ()
       Create a new lock object that can be used to make locks.

   ost::Lockfile::~Lockfile () [inline]
       Destroy the current lock and release it.

Member Function Documentation
   bool ost::Lockfile::isLocked (void)
       Flag if the current process has aqcuired a lock. Returns:
	   true if we have the lock.

   bool ost::Lockfile::lock (const char *name)
       Lock a system-wide name for this process. If the lock is successful, return true. If an existing lock was already acquired, release it
       first.

       Returns:
	   true if lock successful.

       Parameters:
	   name system-wide lock to use.

   void ost::Lockfile::unlock (void)
       Release an acquired lock.

Author
       Generated automatically by Doxygen for GNU CommonC++ from the source code.

GNU CommonC++							  Sat Jun 23 2012						  ost::Lockfile(3)