ACE/ace/Based_Pointer_Repository.h

   1 // -*- C++ -*-
   2
   3 //=============================================================================
   4 /**
   5  *  @file    Based_Pointer_Repository.h
   6  *
   7  *  @author Dietrich Quehl <Dietrich.Quehl@med.siemens.de>
   8  *  @author Douglas C. Schmidt <schmidt@.cs.wustl.edu>
   9  */
  10 //=============================================================================
  11
  12 #ifndef ACE_BASED_POINTER_REPOSITORY_H
  13 #define ACE_BASED_POINTER_REPOSITORY_H
  14
  15 #include /**/ "ace/pre.h"
  16
  17 #include /**/ "ace/ACE_export.h"
  18
  19 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  20 # pragma once
  21 #endif /* ACE_LACKS_PRAGMA_ONCE */
  22
  23 #include "ace/Singleton.h"
  24 #include "ace/Synch_Traits.h"
  25 #include "ace/os_include/os_stddef.h"
  26
  27
  28 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
  29
  30 // Forward decl., using the "Cheshire Cat" technique.
  31 class ACE_Based_Pointer_Repository_Rep;
  32
  33 /**
  34  * @class ACE_Based_Pointer_Repository
  35  *
  36  * @brief Maps pointers to the base address of the region to which each
  37  * pointer belongs.
  38  */
  39 class ACE_Export ACE_Based_Pointer_Repository
  40 {
  41 public:
  42   // = Use ACE_Null_Mutex to allow locking while iterating.
  43
  44   ACE_Based_Pointer_Repository ();
  45   ~ACE_Based_Pointer_Repository ();
  46
  47   // = Search structure methods.
  48   /**
  49    * Return the appropriate @a base_addr region that contains @a addr.
  50    * Returns 1 on success and 0 if the @a addr isn't contained in any
  51    * @a base_addr region.
  52    */
  53   int find (void *addr,
  54             void *&base_addr);
  55
  56   /// Bind a new entry to the repository or update the size of an
  57   /// existing entry.  Returns 0 on success and -1 on failure.
  58   int bind (void *addr,
  59             size_t size);
  60
  61   /// Unbind from the repository the <base_addr> that @a addr is
  62   /// contained within.
  63   int unbind (void *addr);
  64
  65 private:
  66   /// Use the "Cheshire-Cat" technique to hide the implementation in
  67   /// order to avoid circular #include dependencies.
  68   ACE_Based_Pointer_Repository_Rep *rep_;
  69
  70 private:
  71   void operator= (const ACE_Based_Pointer_Repository &) = delete;
  72   ACE_Based_Pointer_Repository (const ACE_Based_Pointer_Repository &) = delete;
  73 };
  74
  75 // ----------------------------------
  76
  77 /// Declare a process wide singleton
  78 ACE_SINGLETON_DECLARE (ACE_Singleton, ACE_Based_Pointer_Repository, ACE_SYNCH_RW_MUTEX)
  79
  80 /// Provide a Singleton access point to the based pointer repository.
  81 typedef ACE_Singleton<ACE_Based_Pointer_Repository, ACE_SYNCH_RW_MUTEX> ACE_BASED_POINTER_REPOSITORY;
  82
  83 ACE_END_VERSIONED_NAMESPACE_DECL
  84
  85 #include /**/ "ace/post.h"
  86
  87 #endif /* ACE_BASED_POINTER_REPOSITORY_H */