1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Class file_mapping</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="../../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset">
<link rel="up" href="../../interprocess/indexes_reference.html#header.boost.interprocess.file_mapping_hpp" title="Header <boost/interprocess/file_mapping.hpp>">
<link rel="prev" href="bad_alloc.html" title="Class bad_alloc">
<link rel="next" href="remove_file_on_destroy.html" title="Class remove_file_on_destroy">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
<td align="center"><a href="../../../../index.html">Home</a></td>
<td align="center"><a href="../../../../libs/libraries.htm">Libraries</a></td>
<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
<td align="center"><a href="../../../../more/index.htm">More</a></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="bad_alloc.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../interprocess/indexes_reference.html#header.boost.interprocess.file_mapping_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="remove_file_on_destroy.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="refentry">
<a name="boost.interprocess.file_mapping"></a><div class="titlepage"></div>
<div class="refnamediv">
<h2><span class="refentrytitle">Class file_mapping</span></h2>
<p>boost::interprocess::file_mapping</p>
</div>
<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis"><span class="comment">// In header: <<a class="link" href="../../interprocess/indexes_reference.html#header.boost.interprocess.file_mapping_hpp" title="Header <boost/interprocess/file_mapping.hpp>">boost/interprocess/file_mapping.hpp</a>>
</span>
<span class="keyword">class</span> <a class="link" href="file_mapping.html" title="Class file_mapping">file_mapping</a> <span class="special">{</span>
<span class="keyword">public</span><span class="special">:</span>
<span class="comment">// <a class="link" href="file_mapping.html#boost.interprocess.file_mappingconstruct-copy-destruct">construct/copy/destruct</a></span>
<a class="link" href="file_mapping.html#idp27515976-bb"><span class="identifier">file_mapping</span></a><span class="special">(</span><span class="special">)</span><span class="special">;</span>
<a class="link" href="file_mapping.html#idp27516296-bb"><span class="identifier">file_mapping</span></a><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span> <span class="special">*</span><span class="special">,</span> <span class="identifier">mode_t</span><span class="special">)</span><span class="special">;</span>
file_mapping& <a class="link" href="file_mapping.html#idp27517832-bb"><span class="keyword">operator</span><span class="special">=</span></a><span class="special">(</span><a class="link" href="file_mapping.html" title="Class file_mapping">file_mapping</a> <span class="special">&&</span><span class="special">)</span><span class="special">;</span>
<a class="link" href="file_mapping.html#idp27518840-bb"><span class="special">~</span><span class="identifier">file_mapping</span></a><span class="special">(</span><span class="special">)</span><span class="special">;</span>
<span class="comment">// <a class="link" href="file_mapping.html#idp27511320-bb">public member functions</a></span>
<a class="link" href="file_mapping.html#idp27511528-bb"><span class="identifier">m_mode</span></a><span class="special">(</span><span class="identifier">read_only</span><span class="special">)</span><span class="special">;</span>
<span class="keyword">void</span> <a class="link" href="file_mapping.html#idp27512248-bb"><span class="identifier">swap</span></a><span class="special">(</span><a class="link" href="file_mapping.html" title="Class file_mapping">file_mapping</a> <span class="special">&</span><span class="special">)</span><span class="special">;</span>
<span class="identifier">mode_t</span> <a class="link" href="file_mapping.html#idp27513432-bb"><span class="identifier">get_mode</span></a><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
<span class="identifier">mapping_handle_t</span> <a class="link" href="file_mapping.html#idp27514136-bb"><span class="identifier">get_mapping_handle</span></a><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
<span class="keyword">const</span> <span class="keyword">char</span> <span class="special">*</span> <a class="link" href="file_mapping.html#idp27515256-bb"><span class="identifier">get_name</span></a><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
<span class="comment">// <a class="link" href="file_mapping.html#idp27519208-bb">public static functions</a></span>
<span class="keyword">static</span> <span class="keyword">bool</span> <a class="link" href="file_mapping.html#idp27519416-bb"><span class="identifier">remove</span></a><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span> <span class="special">*</span><span class="special">)</span><span class="special">;</span>
<span class="comment">// <a class="link" href="file_mapping.html#boost.interprocess.file_mappingpublic-data-members">public data members</a></span>
<a class="link" href="file_mapping.html#boost.interprocess.file_mapping.__pad0__"><span class="identifier">__pad0__</span></a><span class="special">;</span>
<span class="special">}</span><span class="special">;</span></pre></div>
<div class="refsect1">
<a name="idp112251112"></a><h2>Description</h2>
<p>A class that wraps a file-mapping that can be used to create mapped regions from the mapped files </p>
<div class="refsect2">
<a name="idp112251560"></a><h3>
<a name="boost.interprocess.file_mappingconstruct-copy-destruct"></a><code class="computeroutput">file_mapping</code>
public
construct/copy/destruct</h3>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
<pre class="literallayout"><a name="idp27515976-bb"></a><span class="identifier">file_mapping</span><span class="special">(</span><span class="special">)</span><span class="special">;</span></pre>
<p>Constructs an empty file mapping. Does not throw </p>
</li>
<li class="listitem">
<pre class="literallayout"><a name="idp27516296-bb"></a><span class="identifier">file_mapping</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span> <span class="special">*</span> filename<span class="special">,</span> <span class="identifier">mode_t</span> mode<span class="special">)</span><span class="special">;</span></pre>
<p>Opens a file mapping of file "filename", starting in offset "file_offset", and the mapping's size will be "size". The mapping can be opened for read-only "read_only" or read-write "read_write" modes. Throws <code class="computeroutput"><a class="link" href="interprocess_exception.html" title="Class interprocess_exception">interprocess_exception</a></code> on error. </p>
</li>
<li class="listitem">
<pre class="literallayout">file_mapping& <a name="idp27517832-bb"></a><span class="keyword">operator</span><span class="special">=</span><span class="special">(</span><a class="link" href="file_mapping.html" title="Class file_mapping">file_mapping</a> <span class="special">&&</span> moved<span class="special">)</span><span class="special">;</span></pre>
<p>Moves the ownership of "moved"'s file mapping to *this. After the call, "moved" does not represent any file mapping. Does not throw </p>
</li>
<li class="listitem">
<pre class="literallayout"><a name="idp27518840-bb"></a><span class="special">~</span><span class="identifier">file_mapping</span><span class="special">(</span><span class="special">)</span><span class="special">;</span></pre>
<p>Destroys the file mapping. All mapped regions created from this are still valid. Does not throw </p>
</li>
</ol></div>
</div>
<div class="refsect2">
<a name="idp112264504"></a><h3>
<a name="idp27511320-bb"></a><code class="computeroutput">file_mapping</code> public member functions</h3>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem"><pre class="literallayout"> <a name="idp27511528-bb"></a><span class="identifier">m_mode</span><span class="special">(</span><span class="identifier">read_only</span><span class="special">)</span><span class="special">;</span></pre></li>
<li class="listitem">
<pre class="literallayout"><span class="keyword">void</span> <a name="idp27512248-bb"></a><span class="identifier">swap</span><span class="special">(</span><a class="link" href="file_mapping.html" title="Class file_mapping">file_mapping</a> <span class="special">&</span> other<span class="special">)</span><span class="special">;</span></pre>
<p>Swaps to file_mappings. Does not throw. </p>
</li>
<li class="listitem">
<pre class="literallayout"><span class="identifier">mode_t</span> <a name="idp27513432-bb"></a><span class="identifier">get_mode</span><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre>
<p>Returns access mode used in the constructor </p>
</li>
<li class="listitem">
<pre class="literallayout"><span class="identifier">mapping_handle_t</span> <a name="idp27514136-bb"></a><span class="identifier">get_mapping_handle</span><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre>
<p>Obtains the mapping handle to be used with <code class="computeroutput"><a class="link" href="mapped_region.html" title="Global mapped_region">mapped_region</a></code> </p>
</li>
<li class="listitem">
<pre class="literallayout"><span class="keyword">const</span> <span class="keyword">char</span> <span class="special">*</span> <a name="idp27515256-bb"></a><span class="identifier">get_name</span><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre>
<p>Returns the name of the file used in the constructor. </p>
</li>
</ol></div>
</div>
<div class="refsect2">
<a name="idp112279736"></a><h3>
<a name="idp27519208-bb"></a><code class="computeroutput">file_mapping</code> public static functions</h3>
<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
<pre class="literallayout"><span class="keyword">static</span> <span class="keyword">bool</span> <a name="idp27519416-bb"></a><span class="identifier">remove</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span> <span class="special">*</span> filename<span class="special">)</span><span class="special">;</span></pre>
<p>Removes the file named "filename" even if it's been memory mapped. Returns true on success. The function might fail in some operating systems if the file is being used other processes and no deletion permission was shared. </p>
</li></ol></div>
</div>
<div class="refsect2">
<a name="idp112284552"></a><h3>
<a name="boost.interprocess.file_mappingpublic-data-members"></a><code class="computeroutput">file_mapping</code>
public
public data members</h3>
<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
<pre class="literallayout"> <a name="boost.interprocess.file_mapping.__pad0__"></a><span class="identifier">__pad0__</span><span class="special">;</span></pre>
<p>Moves the ownership of "moved"'s file mapping object to *this. After the call, "moved" does not represent any file mapping object. Does not throw </p>
</li></ol></div>
</div>
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right"><div class="copyright-footer">Copyright © 2005-2012 Ion Gaztanaga<p>
Distributed under the Boost Software License, Version 1.0. (See accompanying
file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
</p>
</div></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="bad_alloc.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../interprocess/indexes_reference.html#header.boost.interprocess.file_mapping_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="remove_file_on_destroy.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>
|
