summaryrefslogtreecommitdiff
path: root/ace/DLL.h
diff options
context:
space:
mode:
Diffstat (limited to 'ace/DLL.h')
-rw-r--r--ace/DLL.h149
1 files changed, 0 insertions, 149 deletions
diff --git a/ace/DLL.h b/ace/DLL.h
deleted file mode 100644
index 3554b558542..00000000000
--- a/ace/DLL.h
+++ /dev/null
@@ -1,149 +0,0 @@
-/* -*- C++ -*- */
-
-//=============================================================================
-/**
- * @file DLL.h
- *
- * $Id$
- *
- * @author Kirthika Parameswaran <kirthika@cs.wustl.edu>
- */
-//=============================================================================
-
-
-#ifndef ACE_DLL_H
-#define ACE_DLL_H
-#include /**/ "ace/pre.h"
-
-#include "ace/ACE_export.h"
-
-#if !defined (ACE_LACKS_PRAGMA_ONCE)
-# pragma once
-#endif /* ACE_LACKS_PRAGMA_ONCE */
-
-#include "ace/Global_Macros.h"
-#include "ace/os_include/os_dlfcn.h"
-
-class ACE_DLL_Handle;
-
-/**
- * @class ACE_DLL
- *
- * @brief Provides an abstract interface for handling various DLL
- * operations.
- *
- * This class is an wrapper over the various methods for utilizing
- * a dynamically linked library (DLL), which is called a shared
- * library on some platforms. Operations open(), close(), and
- * symbol() have been implemented to help opening/closing and
- * extracting symbol information from a DLL, respectively.
- */
-class ACE_Export ACE_DLL
-{
-public:
- // = Initialization and termination methods.
-
- /// Default constructor. By default, the close() operation on the
- /// object will be invoked before it is destroyed.
- explicit ACE_DLL (int close_handle_on_destruction = 1);
-
- /**
- * This constructor opens and dynamically links @a dll_name. The
- * default mode is <RTLD_LAZY>, which loads identifier symbols but
- * not the symbols for functions, which are loaded dynamically
- * on-demand. Other supported modes include: <RTLD_NOW>, which
- * performs all necessary relocations when @a dll_name is first
- * loaded and <RTLD_GLOBAL>, which makes symbols available for
- * relocation processing of any other DLLs.
- */
- explicit ACE_DLL (const ACE_TCHAR *dll_name,
- int open_mode = ACE_DEFAULT_SHLIB_MODE,
- int close_handle_on_destruction = 1);
-
- /// Copy constructor.
- ACE_DLL (const ACE_DLL &);
-
- /**
- * This method opens and dynamically links @a dll_name. The default
- * mode is <RTLD_LAZY>, which loads identifier symbols but not the
- * symbols for functions, which are loaded dynamically on-demand.
- * Other supported modes include: <RTLD_NOW>, which performs all
- * necessary relocations when @a dll_name>is first loaded and
- * <RTLD_GLOBAL>, which makes symbols available for relocation
- * processing of any other DLLs.
- * @param dll_name The name of the dll.
- * @param open_mode How the dll is opened.
- * @param close_handle_on_destruction Close the handle when object is destroyed.
- * @retval -1 On failure
- * @retval 0 On success.
- */
- int open (const ACE_TCHAR *dll_name,
- int open_mode = ACE_DEFAULT_SHLIB_MODE,
- int close_handle_on_destruction = 1);
-
- /// Call to close the DLL object.
- int close (void);
-
- /**
- * Called when the DLL object is destroyed -- invokes close() if the
- * <close_handle_on_destruction> flag is set in the constructor or open()
- * method.
- */
- ~ACE_DLL (void);
-
- /// If @a symbol_name is in the symbol table of the DLL a pointer to
- /// the @a symbol_name is returned. Otherwise, returns 0. Setting
- /// ignore_errors = 1 allows you to probe a dll without generating
- /// error messages in the log. Handy for determining the capabilities
- /// of a library.
- void *symbol (const ACE_TCHAR *symbol_name, int ignore_errors = 0);
-
- /// Returns a pointer to a string explaining that an error occured. You
- /// will need to consult the error log for the actual error string
- /// returned by the OS.
- ACE_TCHAR *error (void) const;
-
- /**
- * Return the handle to the caller. If @a become_owner is non-0 then
- * caller assumes ownership of the handle and the ACE_DLL object
- * won't call close() when it goes out of scope, even if
- * <close_handle_on_destruction> is set.
- */
- ACE_SHLIB_HANDLE get_handle (int become_owner = 0) const;
-
- /// Set the handle for the DLL object. By default, the close()
- //operation on / the object will be invoked before it is destroyed.
- int set_handle (ACE_SHLIB_HANDLE handle,
- int close_handle_on_destruction = 1);
-
-private:
-
- int open_i (const ACE_TCHAR *dll_name,
- int open_mode = ACE_DEFAULT_SHLIB_MODE,
- int close_handle_on_destruction = 1,
- ACE_SHLIB_HANDLE handle = 0);
-
-
- /// Open mode.
- int open_mode_;
-
- /// Keep track of the name of the loaded dll, so it can be used
- /// to remove framework components, singletons that live in the dll,
- /// prior to unloading the dll in the close() method.
- ACE_TCHAR *dll_name_;
-
- /// This flag keeps track of whether we should close the handle
- /// automatically when the object is destroyed.
- int close_handle_on_destruction_;
-
- ACE_DLL_Handle *dll_handle_;
-
- /// Flag to record if the last operation had an error.
- int error_;
-
- // = Disallow copying and assignment since we don't handle these.
- ACE_UNIMPLEMENTED_FUNC (void operator= (const ACE_DLL &))
-};
-
-#include /**/ "ace/post.h"
-#endif /* ACE_DLL_H */