EIC code displayed by LXR master/​include/​boost/​interprocess/​managed_shared_memory.hpp	Source navigation Diff markup Identifier search General search
	Version: master test Revert   Change

File indexing completed on 2025-09-16 08:37:09

 //////////////////////////////////////////////////////////////////////////////
 //
 // (C) Copyright Ion Gaztanaga 2005-2012. Distributed under the Boost
 // Software License, Version 1.0. (See accompanying file
 // LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
 //
 // See http://www.boost.org/libs/interprocess for documentation.
 //
 //////////////////////////////////////////////////////////////////////////////
 
 #ifndef BOOST_INTERPROCESS_MANAGED_SHARED_MEMORY_HPP
 #define BOOST_INTERPROCESS_MANAGED_SHARED_MEMORY_HPP
 
 #ifndef BOOST_CONFIG_HPP
 #  include <boost/config.hpp>
 #endif
 #
 #if defined(BOOST_HAS_PRAGMA_ONCE)
 #  pragma once
 #endif
 
 #include <boost/interprocess/detail/config_begin.hpp>
 #include <boost/interprocess/detail/workaround.hpp>
 
 #include <boost/interprocess/detail/managed_memory_impl.hpp>
 #include <boost/interprocess/detail/managed_open_or_create_impl.hpp>
 #include <boost/interprocess/shared_memory_object.hpp>
 #include <boost/interprocess/creation_tags.hpp>
 #include <boost/interprocess/permissions.hpp>
 //These includes needed to fulfill default template parameters of
 //predeclarations in interprocess_fwd.hpp
 #include <boost/interprocess/mem_algo/rbtree_best_fit.hpp>
 #include <boost/interprocess/sync/mutex_family.hpp>
 
 namespace boost {
 namespace interprocess {
 
 namespace ipcdetail {
 
 template
       <
          class CharType,
          class AllocationAlgorithm,
          template<class IndexConfig> class IndexType
       >
 struct shmem_open_or_create
 {
    static const std::size_t segment_manager_alignment = boost::move_detail::alignment_of
          < segment_manager
                < CharType
                , AllocationAlgorithm
                , IndexType>
          >::value;
    static const std::size_t final_segment_manager_alignment
       = segment_manager_alignment > AllocationAlgorithm::Alignment
       ? segment_manager_alignment : AllocationAlgorithm::Alignment;
 
    typedef ipcdetail::managed_open_or_create_impl
       < shared_memory_object
       , final_segment_manager_alignment
       , true
       , false> type;
 };
 
 }  //namespace ipcdetail {
 
 //!A basic shared memory named object creation class. Initializes the
 //!shared memory segment. Inherits all basic functionality from
 //!basic_managed_memory_impl<CharType, AllocationAlgorithm, IndexType>*/
 template
       <
          class CharType,
          class AllocationAlgorithm,
          template<class IndexConfig> class IndexType
       >
 class basic_managed_shared_memory
    : public ipcdetail::basic_managed_memory_impl
       < CharType, AllocationAlgorithm, IndexType
       , ipcdetail::shmem_open_or_create<CharType, AllocationAlgorithm, IndexType>::type::ManagedOpenOrCreateUserOffset>
    , private ipcdetail::shmem_open_or_create<CharType, AllocationAlgorithm, IndexType>::type
 {
    #if !defined(BOOST_INTERPROCESS_DOXYGEN_INVOKED)
    typedef typename ipcdetail::shmem_open_or_create
       < CharType
       , AllocationAlgorithm
       , IndexType>::type                                 base2_t;
    typedef ipcdetail::basic_managed_memory_impl
       <CharType, AllocationAlgorithm, IndexType,
       base2_t::ManagedOpenOrCreateUserOffset>            base_t;
 
    typedef ipcdetail::create_open_func<base_t>        create_open_func_t;
 
    basic_managed_shared_memory *get_this_pointer()
    {  return this;   }
 
    public:
    typedef shared_memory_object                    device_type;
    typedef typename base_t::size_type              size_type;
 
    private:
    typedef typename base_t::char_ptr_holder_t   char_ptr_holder_t;
    BOOST_MOVABLE_BUT_NOT_COPYABLE(basic_managed_shared_memory)
    #endif   //#ifndef BOOST_INTERPROCESS_DOXYGEN_INVOKED
 
    public: //functions
 
    //!Destroys *this and indicates that the calling process is finished using
    //!the resource. The destructor function will deallocate
    //!any system resources allocated by the system for use by this process for
    //!this resource. The resource can still be opened again calling
    //!the open constructor overload. To erase the resource from the system
    //!use remove().
    ~basic_managed_shared_memory()
    {}
 
    //!Default constructor. Does nothing.
    //!Useful in combination with move semantics
    basic_managed_shared_memory()
    {}
 
    //!Creates shared memory and creates and places the segment manager.
    //!This can throw.
    basic_managed_shared_memory(create_only_t, const char *name,
                              size_type size, const void *addr = 0, const permissions& perm = permissions())
       : base_t()
       , base2_t(create_only, name, size, read_write, addr,
                 create_open_func_t(get_this_pointer(), ipcdetail::DoCreate), perm)
    {}
 
    //!Creates shared memory and creates and places the segment manager if
    //!segment was not created. If segment was created it connects to the
    //!segment.
    //!This can throw.
    basic_managed_shared_memory (open_or_create_t,
                               const char *name, size_type size,
                               const void *addr = 0, const permissions& perm = permissions())
       : base_t()
       , base2_t(open_or_create, name, size, read_write, addr,
                 create_open_func_t(get_this_pointer(),
                 ipcdetail::DoOpenOrCreate), perm)
    {}
 
    //!Connects to a created shared memory and its segment manager.
    //!in copy_on_write mode.
    //!This can throw.
    basic_managed_shared_memory (open_copy_on_write_t, const char* name,
                                 const void *addr = 0)
       : base_t()
       , base2_t(open_only, name, copy_on_write, addr,
                 create_open_func_t(get_this_pointer(),
                 ipcdetail::DoOpen))
    {}
 
    //!Connects to a created shared memory and its segment manager.
    //!in read-only mode.
    //!This can throw.
    basic_managed_shared_memory (open_read_only_t, const char* name,
                                 const void *addr = 0)
       : base_t()
       , base2_t(open_only, name, read_only, addr,
                 create_open_func_t(get_this_pointer(),
                 ipcdetail::DoOpen))
    {}
 
    //!Connects to a created shared memory and its segment manager.
    //!This can throw.
    basic_managed_shared_memory (open_only_t, const char* name,
                                 const void *addr = 0)
       : base_t()
       , base2_t(open_only, name, read_write, addr,
                 create_open_func_t(get_this_pointer(),
                 ipcdetail::DoOpen))
    {}
 
    #if defined(BOOST_INTERPROCESS_WCHAR_NAMED_RESOURCES) || defined(BOOST_INTERPROCESS_DOXYGEN_INVOKED)
 
    //!Creates shared memory and creates and places the segment manager.
    //!This can throw.
    //! 
    //!Note: This function is only available on operating systems with
    //!      native wchar_t APIs (e.g. Windows).
    basic_managed_shared_memory(create_only_t, const wchar_t *name,
                              size_type size, const void *addr = 0, const permissions& perm = permissions())
       : base_t()
       , base2_t(create_only, name, size, read_write, addr,
                 create_open_func_t(get_this_pointer(), ipcdetail::DoCreate), perm)
    {}
 
    //!Creates shared memory and creates and places the segment manager if
    //!segment was not created. If segment was created it connects to the
    //!segment.
    //!This can throw.
    //! 
    //!Note: This function is only available on operating systems with
    //!      native wchar_t APIs (e.g. Windows).
    basic_managed_shared_memory (open_or_create_t,
                               const wchar_t *name, size_type size,
                               const void *addr = 0, const permissions& perm = permissions())
       : base_t()
       , base2_t(open_or_create, name, size, read_write, addr,
                 create_open_func_t(get_this_pointer(),
                 ipcdetail::DoOpenOrCreate), perm)
    {}
 
    //!Connects to a created shared memory and its segment manager.
    //!in copy_on_write mode.
    //!This can throw.
    //! 
    //!Note: This function is only available on operating systems with
    //!      native wchar_t APIs (e.g. Windows).
    basic_managed_shared_memory (open_copy_on_write_t, const wchar_t* name,
                                 const void *addr = 0)
       : base_t()
       , base2_t(open_only, name, copy_on_write, addr,
                 create_open_func_t(get_this_pointer(),
                 ipcdetail::DoOpen))
    {}
 
    //!Connects to a created shared memory and its segment manager.
    //!in read-only mode.
    //!This can throw.
    //! 
    //!Note: This function is only available on operating systems with
    //!      native wchar_t APIs (e.g. Windows).
    basic_managed_shared_memory (open_read_only_t, const wchar_t* name,
                                 const void *addr = 0)
       : base_t()
       , base2_t(open_only, name, read_only, addr,
                 create_open_func_t(get_this_pointer(),
                 ipcdetail::DoOpen))
    {}
 
    //!Connects to a created shared memory and its segment manager.
    //!This can throw.
    //! 
    //!Note: This function is only available on operating systems with
    //!      native wchar_t APIs (e.g. Windows).
    basic_managed_shared_memory (open_only_t, const wchar_t* name,
                                 const void *addr = 0)
       : base_t()
       , base2_t(open_only, name, read_write, addr,
                 create_open_func_t(get_this_pointer(),
                 ipcdetail::DoOpen))
    {}
 
    #endif //defined(BOOST_INTERPROCESS_WCHAR_NAMED_RESOURCES) || defined(BOOST_INTERPROCESS_DOXYGEN_INVOKED)
 
    //!Moves the ownership of "moved"'s managed memory to *this.
    //!Does not throw
    basic_managed_shared_memory(BOOST_RV_REF(basic_managed_shared_memory) moved)
    {
       basic_managed_shared_memory tmp;
       this->swap(moved);
       tmp.swap(moved);
    }
 
    //!Moves the ownership of "moved"'s managed memory to *this.
    //!Does not throw
    basic_managed_shared_memory &operator=(BOOST_RV_REF(basic_managed_shared_memory) moved)
    {
       basic_managed_shared_memory tmp(boost::move(moved));
       this->swap(tmp);
       return *this;
    }
 
    //!Swaps the ownership of the managed shared memories managed by *this and other.
    //!Never throws.
    void swap(basic_managed_shared_memory &other)
    {
       base_t::swap(other);
       base2_t::swap(other);
    }
 
    //!Tries to resize the managed shared memory object so that we have
    //!room for more objects.
    //!
    //!This function is not synchronized so no other thread or process should
    //!be reading or writing the file
    //!
    //!Since the memory will be remapped after the underlying shared memory
    //!is grown, it can't work with segments using raw pointers.
    static bool grow(const char *shmname, size_type extra_bytes)
    {
       return base_t::template grow
          <basic_managed_shared_memory>(shmname, extra_bytes);
    }
 
    //!Tries to resize the managed shared memory to minimized the size of the file.
    //!
    //!This function is not synchronized so no other thread or process should
    //!be reading or writing the file
    static bool shrink_to_fit(const char *shmname)
    {
       return base_t::template shrink_to_fit
          <basic_managed_shared_memory>(shmname);
    }
 
    #if defined(BOOST_INTERPROCESS_WCHAR_NAMED_RESOURCES) || defined(BOOST_INTERPROCESS_DOXYGEN_INVOKED)
 
    //!Tries to resize the managed shared memory object so that we have
    //!room for more objects.
    //!
    //!This function is not synchronized so no other thread or process should
    //!be reading or writing the file
    //! 
    //!Note: This function is only available on operating systems with
    //!      native wchar_t APIs (e.g. Windows).
    static bool grow(const wchar_t *shmname, size_type extra_bytes)
    {
       return base_t::template grow
          <basic_managed_shared_memory>(shmname, extra_bytes);
    }
 
    //!Tries to resize the managed shared memory to minimized the size of the file.
    //!
    //!This function is not synchronized so no other thread or process should
    //!be reading or writing the file
    //! 
    //!Note: This function is only available on operating systems with
    //!      native wchar_t APIs (e.g. Windows).
    static bool shrink_to_fit(const wchar_t *shmname)
    {
       return base_t::template shrink_to_fit
          <basic_managed_shared_memory>(shmname);
    }
 
    #endif //defined(BOOST_INTERPROCESS_WCHAR_NAMED_RESOURCES) || defined(BOOST_INTERPROCESS_DOXYGEN_INVOKED)
 
    #if !defined(BOOST_INTERPROCESS_DOXYGEN_INVOKED)
 
    //!Tries to find a previous named allocation address. Returns a memory
    //!buffer and the object count. If not found returned pointer is 0.
    //!Never throws.
    template <class T>
    std::pair<T*, size_type> find  (char_ptr_holder_t name)
    {
       if(base2_t::get_mapped_region().get_mode() == read_only){
          return base_t::template find_no_lock<T>(name);
       }
       else{
          return base_t::template find<T>(name);
       }
    }
 
    #endif   //#ifndef BOOST_INTERPROCESS_DOXYGEN_INVOKED
 };
 
 #ifdef BOOST_INTERPROCESS_DOXYGEN_INVOKED
 
 //!Typedef for a default basic_managed_shared_memory
 //!of narrow characters
 typedef basic_managed_shared_memory
    <char
    ,rbtree_best_fit<mutex_family>
    ,iset_index>
 managed_shared_memory;
 
 //!Typedef for a default basic_managed_shared_memory
 //!of wide characters
 typedef basic_managed_shared_memory
    <wchar_t
    ,rbtree_best_fit<mutex_family>
    ,iset_index>
 wmanaged_shared_memory;
 
 //!Typedef for a default basic_managed_shared_memory
 //!of narrow characters to be placed in a fixed address
 typedef basic_managed_shared_memory
    <char
    ,rbtree_best_fit<mutex_family, void*>
    ,iset_index>
 fixed_managed_shared_memory;
 
 //!Typedef for a default basic_managed_shared_memory
 //!of narrow characters to be placed in a fixed address
 typedef basic_managed_shared_memory
    <wchar_t
    ,rbtree_best_fit<mutex_family, void*>
    ,iset_index>
 wfixed_managed_shared_memory;
 
 
 #endif   //#ifdef BOOST_INTERPROCESS_DOXYGEN_INVOKED
 
 }  //namespace interprocess {
 }  //namespace boost {
 
 #include <boost/interprocess/detail/config_end.hpp>
 
 #endif   //BOOST_INTERPROCESS_MANAGED_SHARED_MEMORY_HPP
 

This page was automatically generated by the 2.3.7 LXR engine. The LXR team