...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
boost::interprocess::basic_managed_shared_memory
// In header: <boost/interprocess/interprocess_fwd.hpp> template<typename CharType, typename MemoryAlgorithm, template< class IndexConfig > class IndexType> class basic_managed_shared_memory { public: // construct/copy/destruct basic_managed_shared_memory(); basic_managed_shared_memory(create_only_t, const char *, size_type, const void * = 0, const permissions & = permissions()); basic_managed_shared_memory(open_or_create_t, const char *, size_type, const void * = 0, const permissions & = permissions()); basic_managed_shared_memory(open_copy_on_write_t, const char *, const void * = 0); basic_managed_shared_memory(open_read_only_t, const char *, const void * = 0); basic_managed_shared_memory(open_only_t, const char *, const void * = 0); basic_managed_shared_memory& operator=(basic_managed_shared_memory &&); ~basic_managed_shared_memory(); // public member functions this swap(moved); tmp swap(moved); void swap(basic_managed_shared_memory &); // public static functions static bool grow(const char *, size_type); static bool shrink_to_fit(const char *); };
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>
basic_managed_shared_memory
public
construct/copy/destructbasic_managed_shared_memory();
Default constructor. Does nothing. Useful in combination with move semantics
basic_managed_shared_memory(create_only_t, const char * name, size_type size, const void * addr = 0, const permissions & perm = permissions());
Creates shared memory and creates and places the segment manager. 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());
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_copy_on_write_t, const char * name, const void * addr = 0);
Connects to a created shared memory and its segment manager. in copy_on_write mode. This can throw.
basic_managed_shared_memory(open_read_only_t, const char * name, const void * addr = 0);
Connects to a created shared memory and its segment manager. in read-only mode. This can throw.
basic_managed_shared_memory(open_only_t, const char * name, const void * addr = 0);
Connects to a created shared memory and its segment manager. This can throw.
basic_managed_shared_memory& operator=(basic_managed_shared_memory && moved);
Moves the ownership of "moved"'s managed memory to *this. Does not throw
~basic_managed_shared_memory();
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
public member functionsthis swap(moved);
Moves the ownership of "moved"'s managed memory to *this. Does not throw
tmp swap(moved);
void swap(basic_managed_shared_memory & other);
Swaps the ownership of the managed shared memories managed by *this and other. Never throws.
basic_managed_shared_memory
public static functionsstatic bool grow(const char * shmname, size_type extra_bytes);
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
static bool shrink_to_fit(const char * shmname);
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