src/lockmanager/README

   1 The lockmanager service serves as a global locker for other gnunet
   2 programs. This service eliminates the need for programs to maintain their own
   3 checks upon a resource which should be protected from concurrent access.
   4
   5 Locking is managed through locking-domains. A locking-domain is a string which
   6 uniquely identifies a group of locks. Locks are represented as unsigned 32-bit
   7 integers. When a critical resource has to be protected against simulataneous
   8 access by 2 programs, both of them should connect to the lockmanager using the
   9 same locking-domain and try to acquire a lock with the same number. Since only
  10 one of them can acquire the lock the other will be denied locking until the
  11 it the lock is released.