ACE/ace/Init_ACE.h

   1 // -*- C++ -*-
   2
   3 //=============================================================================
   4 /**
   5  *  @file   Init_ACE.h
   6  *
   7  *  Initialize and finalize the ACE library services.  You can
   8  *  generally execute the @a ACE::init() and @a ACE::fini() sequence
   9  *  multiple times, but be aware that nothing that ACE controls (e.g.,
  10  *  singletons, thread-specific services, loaded services, etc.)  will
  11  *  survive the @a ACE::fini().
  12  */
  13 //=============================================================================
  14
  15
  16 #ifndef ACE_INIT_ACE_H
  17 #define ACE_INIT_ACE_H
  18
  19 #include /**/ "ace/pre.h"
  20
  21 #include /**/ "ace/ACE_export.h"
  22
  23 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  24 # pragma once
  25 #endif /* ACE_LACKS_PRAGMA_ONCE */
  26
  27 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
  28
  29 namespace ACE
  30 {
  31   /**
  32    * This method initializes the ACE library services and initializes
  33    * ACE's internal resources.  Applications should not instantiate
  34    * ACE classes or call methods on objects of these classes until @a
  35    * ACE::init() returns successfully.
  36
  37    * @return Returns 0 on success, -1 on failure, and 1 if it had
  38    * already been called.
  39    */
  40   extern ACE_Export int init ();
  41
  42   /**
  43    * Finalize the ACE library services and releases ACE's internal
  44    * resources.  In general, do not instantiate ACE classes or call
  45    * methods on objects of these classes after @a ACE::fini() has been
  46    * called.
  47    *
  48    * @return Returns 0 on success, -1 on failure, and 1 if it had already been
  49    * called.
  50    */
  51   extern ACE_Export int fini ();
  52
  53   // private:
  54   //  Used internally, so not exported.
  55
  56   /**
  57    * Counter to match init()/fini() calls.  init() must increment it;
  58    * fini() must decrement it.  fini() then does nothing until it
  59    * reaches 0.
  60    */
  61   extern unsigned int init_fini_count_;
  62 }
  63
  64 ACE_END_VERSIONED_NAMESPACE_DECL
  65
  66 #include /**/ "ace/post.h"
  67
  68 #endif  /* ACE_INIT_ACE_H */