diff options
Diffstat (limited to 'ACE/ace/Mem_Map.h')
-rw-r--r-- | ACE/ace/Mem_Map.h | 235 |
1 files changed, 0 insertions, 235 deletions
diff --git a/ACE/ace/Mem_Map.h b/ACE/ace/Mem_Map.h deleted file mode 100644 index 2329722c9cd..00000000000 --- a/ACE/ace/Mem_Map.h +++ /dev/null @@ -1,235 +0,0 @@ -// -*- C++ -*- - -//========================================================================== -/** - * @file Mem_Map.h - * - * $Id$ - * - * @author Douglas C. Schmidt <schmidt@cs.wustl.edu> - */ -//========================================================================== - -#ifndef ACE_MEM_MAP_H -#define ACE_MEM_MAP_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/sys/os_mman.h" -#include "ace/os_include/os_limits.h" -#include "ace/os_include/os_fcntl.h" -#include "ace/Default_Constants.h" - -ACE_BEGIN_VERSIONED_NAMESPACE_DECL - -/** - * @class ACE_Mem_Map - * - * @brief C++ interface OS memory mapping system call. - * - * This class works with both the mmap(2) UNIX system and the - * Win32 family of memory mapping system calls. - */ -class ACE_Export ACE_Mem_Map -{ -public: - // = Initialization and termination methods. - - /// Default constructor. - ACE_Mem_Map (void); - - /// Map a file from an open file descriptor @a handle. This function - /// will lookup the length of the file if it is not given. - ACE_Mem_Map (ACE_HANDLE handle, - size_t length = static_cast<size_t> (-1), - int prot = PROT_RDWR, - int share = ACE_MAP_PRIVATE, - void *addr = 0, - ACE_OFF_T offset = 0, - LPSECURITY_ATTRIBUTES sa = 0); - - /// Map a file specified by @a file_name. - ACE_Mem_Map (const ACE_TCHAR *filename, - size_t length = static_cast<size_t> (-1), - int flags = O_RDWR | O_CREAT, - mode_t mode = ACE_DEFAULT_FILE_PERMS, - int prot = PROT_RDWR, - int share = ACE_MAP_PRIVATE, - void *addr = 0, - ACE_OFF_T offset = 0, - LPSECURITY_ATTRIBUTES sa = 0); - - /// Map a file from an open file descriptor @a handle. This function - /// will lookup the length of the file if it is not given. - int map (ACE_HANDLE handle, - size_t length = static_cast<size_t> (-1), - int prot = PROT_RDWR, - int share = ACE_MAP_PRIVATE, - void *addr = 0, - ACE_OFF_T offset = 0, - LPSECURITY_ATTRIBUTES sa = 0); - - /// Remap the file associated with <handle_>. - int map (size_t length = static_cast<size_t> (-1), - int prot = PROT_RDWR, - int share = ACE_MAP_PRIVATE, - void *addr = 0, - ACE_OFF_T offset = 0, - LPSECURITY_ATTRIBUTES sa = 0); - - /// Map a file specified by @a filename. - int map (const ACE_TCHAR *filename, - size_t length = static_cast<size_t> (-1), - int flags = O_RDWR | O_CREAT, - mode_t mode = ACE_DEFAULT_FILE_PERMS, - int prot = PROT_RDWR, - int share = ACE_MAP_PRIVATE, - void *addr = 0, - ACE_OFF_T offset = 0, - LPSECURITY_ATTRIBUTES sa = 0); - - /// Destructor. - ~ACE_Mem_Map (void); - - /// Open the file without mapping it. - int open (const ACE_TCHAR *filename, - int flags = O_RDWR | O_CREAT, - mode_t perms = ACE_DEFAULT_FILE_PERMS, - LPSECURITY_ATTRIBUTES sa = 0); - - /// Close down the <handle_> if necessary and unmap the mapping. - int close (void); - - /// Close down the <handle_> if necessary. - int close_handle (void); - - /** - * Close down the internal <file_mapping_> if necessary. This is - * mostly necessary on Win32, which has a different handle for - * file-mapping kernel object. - */ - int close_filemapping_handle (void); - - /// This operator passes back the starting address of the mapped - /// file. - int operator () (void *&addr); - - /// Return the base address. - void *addr (void) const; - - /// This function returns the number of bytes currently mapped in the - /// file. - size_t size (void) const; - - /// Unmap the region starting at <base_addr_>. - int unmap (ssize_t len = -1); - - /// Unmap the region starting at <addr_>. - int unmap (void *addr, ssize_t len); - - /** - * Sync @a len bytes of the memory region to the backing store - * starting at <base_addr_>. If @a len == -1 then sync the whole - * region. - */ - int sync (size_t len, int flags = MS_SYNC); - - /** - * Sync the whole memory region to the backing store - * starting at <base_addr_>. - */ - int sync (int flags = MS_SYNC); - - /// Sync @a len bytes of the memory region to the backing store - /// starting at <addr_>. - int sync (void *addr, size_t len, int flags = MS_SYNC); - - /** - * Change the protection of the pages of the mapped region to @a prot - * starting at <base_addr_> up to @a len bytes. - */ - int protect (size_t len, int prot = PROT_RDWR); - - /** - * Change the protection of all the pages of the mapped region to @a prot - * starting at <base_addr_>. - */ - int protect (int prot = PROT_RDWR); - - /// Change the protection of the pages of the mapped region to @a prot - /// starting at @a addr up to @a len bytes. - int protect (void *addr, size_t len, int prot = PROT_RDWR); - - /// Close and remove the file from the file system. - int remove (void); - - /// Hook into the underlying VM system. - int advise (int behavior, int len = -1); - - /// Return the underlying <handle_>. - ACE_HANDLE handle (void) const; - - /// Return the name of file that is mapped (if any). - const ACE_TCHAR *filename (void) const; - - /// Dump the state of an object. - void dump (void) const; - - /// Declare the dynamic allocation hooks. - ACE_ALLOC_HOOK_DECLARE; - -private: - - /// This method does the dirty work of actually calling ::mmap to map - /// the file into memory. - int map_it (ACE_HANDLE handle, - size_t len = static_cast<size_t> (-1), - int prot = PROT_RDWR, - int share = MAP_SHARED, - void *addr = 0, - ACE_OFF_T offset = 0, - LPSECURITY_ATTRIBUTES sa = 0); - - // = Disallow copying and assignment. - ACE_Mem_Map (const ACE_Mem_Map &); - void operator = (const ACE_Mem_Map &); - -private: - - /// Base address of the memory-mapped file. - void *base_addr_; - - /// Name of the file that is mapped. - ACE_TCHAR filename_[MAXPATHLEN + 1]; - - /// Length of the mapping. - size_t length_; - - /// HANDLE for the open file. - ACE_HANDLE handle_; - - /// HANDLE for the open mapping. - ACE_HANDLE file_mapping_; - - /// Keeps track of whether we need to close the handle. This is set - /// if we opened the file. - bool close_handle_; - -}; - -ACE_END_VERSIONED_NAMESPACE_DECL - -#if defined (__ACE_INLINE__) -#include "ace/Mem_Map.inl" -#endif /* __ACE_INLINE__ */ - -#include /**/ "ace/post.h" - -#endif /* ACE_MEM_MAP_H */ |