diff options
| author | Jenkins nedprod CI <foo@nowhere> | 2018-06-19 23:23:29 +0300 |
|---|---|---|
| committer | Jenkins nedprod CI <foo@nowhere> | 2018-06-19 23:23:29 +0300 |
| commit | 4f647a8cc0f8d1d114abcf5c9c773c2027c72e24 (patch) | |
| tree | 3429bc1a02d10d5199c522f2d47d78dbb79a2318 | |
| parent | a71b41c90824e14d67a200990d4acdf42c6b6460 (diff) | |
Travis CI updates documentation
| -rw-r--r-- | classafio__v2__xxx_1_1mapped__file__handle.html | 13 | ||||
| -rw-r--r-- | config_8hpp.html | 6 | ||||
| -rw-r--r-- | namespaceafio__v2__xxx.html | 10 |
3 files changed, 15 insertions, 14 deletions
diff --git a/classafio__v2__xxx_1_1mapped__file__handle.html b/classafio__v2__xxx_1_1mapped__file__handle.html index 8206f1c6..a55d9ede 100644 --- a/classafio__v2__xxx_1_1mapped__file__handle.html +++ b/classafio__v2__xxx_1_1mapped__file__handle.html @@ -1562,8 +1562,8 @@ For portability, you can only assume that barriers write order for a single hand </div><div class="memdoc"> <p>Read data from the mapped file. </p> -<dl class="section note"><dt>Note</dt><dd>Because this implementation never copies memory, you can pass in buffers with a null address.</dd></dl> -<dl class="section return"><dt>Returns</dt><dd>The buffers read, which will never be the buffers input because they will point into the mapped view. The size of each scatter-gather buffer is updated with the number of bytes of that buffer transferred. </dd></dl> +<dl class="section note"><dt>Note</dt><dd>Because this implementation never copies memory, you can pass in buffers with a null address. As this function never reads any memory, no attempt to trap signal raises can be made, this falls onto the user of this function. See <code>QUICKCPPLIB_NAMESPACE::signal_guard</code> for a helper function.</dd></dl> +<dl class="section return"><dt>Returns</dt><dd>The buffers read, which will never be the buffers input, because they will point into the mapped view. The size of each scatter-gather buffer is updated with the number of bytes of that buffer transferred. </dd></dl> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">reqs</td><td>A scatter-gather and offset request. </td></tr> @@ -1573,7 +1573,7 @@ For portability, you can only assume that barriers write order for a single hand </dl> <dl class="section user"><dt>Errors returnable</dt><dd>None, though the various signals and structured exception throws common to using memory maps may occur. </dd></dl> <dl class="section user"><dt>Memory Allocations</dt><dd>None. </dd></dl> -<div class="fragment"><div class="line"><a name="l00390"></a><span class="lineno"> 390</span> { <span class="keywordflow">return</span> _mh.<a class="code" href="classafio__v2__xxx_1_1map__handle.html#a4d8c8f3fcecd58b55316d42799abf6f3">read</a>(reqs, d); }</div><div class="ttc" id="classafio__v2__xxx_1_1map__handle_html_a4d8c8f3fcecd58b55316d42799abf6f3"><div class="ttname"><a href="classafio__v2__xxx_1_1map__handle.html#a4d8c8f3fcecd58b55316d42799abf6f3">afio_v2_xxx::map_handle::read</a></div><div class="ttdeci">virtual io_result< buffers_type > read(io_request< buffers_type > reqs, deadline d=deadline()) noexcept override</div><div class="ttdoc">Read data from the mapped view. </div></div> +<div class="fragment"><div class="line"><a name="l00392"></a><span class="lineno"> 392</span> { <span class="keywordflow">return</span> _mh.<a class="code" href="classafio__v2__xxx_1_1map__handle.html#a4d8c8f3fcecd58b55316d42799abf6f3">read</a>(reqs, d); }</div><div class="ttc" id="classafio__v2__xxx_1_1map__handle_html_a4d8c8f3fcecd58b55316d42799abf6f3"><div class="ttname"><a href="classafio__v2__xxx_1_1map__handle.html#a4d8c8f3fcecd58b55316d42799abf6f3">afio_v2_xxx::map_handle::read</a></div><div class="ttdeci">virtual io_result< buffers_type > read(io_request< buffers_type > reqs, deadline d=deadline()) noexcept override</div><div class="ttdoc">Read data from the mapped view. </div></div> </div><!-- fragment --> </div> </div> @@ -2130,6 +2130,7 @@ For portability, you can only assume that barriers write order for a single hand </div><div class="memdoc"> <p>Write data to the mapped file. </p> +<dl class="section note"><dt>Note</dt><dd>This call traps signals and structured exception throws using <code>QUICKCPPLIB_NAMESPACE::signal_guard</code>. Instantiating a <code>QUICKCPPLIB_NAMESPACE::signal_guard_install</code> somewhere much higher up in the call stack will improve performance enormously. The signal guard may cost less than 100 CPU cycles depending on how you configure it. If you don't want the guard, you can write memory directly using <code>address()</code>.</dd></dl> <dl class="section return"><dt>Returns</dt><dd>The buffers written, which will never be the buffers input because they will point at where the data was copied into the mapped view. The size of each scatter-gather buffer is updated with the number of bytes of that buffer transferred. </dd></dl> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> @@ -2138,9 +2139,9 @@ For portability, you can only assume that barriers write order for a single hand </table> </dd> </dl> -<dl class="section user"><dt>Errors returnable</dt><dd>None, though the various signals and structured exception throws common to using memory maps may occur. </dd></dl> -<dl class="section user"><dt>Memory Allocations</dt><dd>None. </dd></dl> -<div class="fragment"><div class="line"><a name="l00400"></a><span class="lineno"> 400</span> { <span class="keywordflow">return</span> _mh.<a class="code" href="classafio__v2__xxx_1_1map__handle.html#a00b7e1e99089c2641c45ee824811ebc1">write</a>(reqs, d); }</div><div class="ttc" id="classafio__v2__xxx_1_1map__handle_html_a00b7e1e99089c2641c45ee824811ebc1"><div class="ttname"><a href="classafio__v2__xxx_1_1map__handle.html#a00b7e1e99089c2641c45ee824811ebc1">afio_v2_xxx::map_handle::write</a></div><div class="ttdeci">virtual io_result< const_buffers_type > write(io_request< const_buffers_type > reqs, deadline d=deadline()) noexcept override</div><div class="ttdoc">Write data to the mapped view. </div></div> +<dl class="section user"><dt>Errors returnable</dt><dd>If during the attempt to write the buffers to the map a <code>SIGBUS</code> or <code>EXCEPTION_IN_PAGE_ERROR</code> is raised, an error code comparing equal to <code>errc::no_space_on_device</code> will be returned. This may not always be the cause of the raised signal, but it is by far the most likely. </dd></dl> +<dl class="section user"><dt>Memory Allocations</dt><dd>None if a <code>QUICKCPPLIB_NAMESPACE::signal_guard_install</code> is already instanced. </dd></dl> +<div class="fragment"><div class="line"><a name="l00409"></a><span class="lineno"> 409</span> { <span class="keywordflow">return</span> _mh.<a class="code" href="classafio__v2__xxx_1_1map__handle.html#a00b7e1e99089c2641c45ee824811ebc1">write</a>(reqs, d); }</div><div class="ttc" id="classafio__v2__xxx_1_1map__handle_html_a00b7e1e99089c2641c45ee824811ebc1"><div class="ttname"><a href="classafio__v2__xxx_1_1map__handle.html#a00b7e1e99089c2641c45ee824811ebc1">afio_v2_xxx::map_handle::write</a></div><div class="ttdeci">virtual io_result< const_buffers_type > write(io_request< const_buffers_type > reqs, deadline d=deadline()) noexcept override</div><div class="ttdoc">Write data to the mapped view. </div></div> </div><!-- fragment --> </div> </div> diff --git a/config_8hpp.html b/config_8hpp.html index f7a2dd54..1c2458c4 100644 --- a/config_8hpp.html +++ b/config_8hpp.html @@ -97,6 +97,8 @@ $(document).ready(function(){initNavTree('config_8hpp.html','');}); <code>#include "quickcpplib/include/cpp_feature.h"</code><br /> <code>#include "quickcpplib/include/import.h"</code><br /> <code>#include "quickcpplib/include/config.hpp"</code><br /> +<code>#include "quickcpplib/include/ringbuffer_log.hpp"</code><br /> +<code>#include "quickcpplib/include/utils/thread.hpp"</code><br /> <code>#include "quickcpplib/include/bitfield.hpp"</code><br /> <code>#include "quickcpplib/include/scoped_undo.hpp"</code><br /> <code>#include "quickcpplib/include/span.hpp"</code><br /> @@ -105,8 +107,6 @@ $(document).ready(function(){initNavTree('config_8hpp.html','');}); <code>#include "quickcpplib/include/string_view.hpp"</code><br /> <code>#include "quickcpplib/include/persistent.hpp"</code><br /> <code>#include "outcome/include/outcome.hpp"</code><br /> -<code>#include "quickcpplib/include/ringbuffer_log.hpp"</code><br /> -<code>#include "quickcpplib/include/utils/thread.hpp"</code><br /> <code>#include <cstdio></code><br /> <code>#include <ctime></code><br /> </div><table class="memberdecls"> @@ -365,7 +365,7 @@ template<class R , class U , class... Args> </td></tr> </tr> </table> </div><div class="memdoc"> -<b>Value:</b><div class="fragment"><div class="line">{ <a class="code" href="namespaceafio__v2__xxx.html#a08363b8572e6a8971a6d236d54fb8287">\</a></div><div class="line"><a class="code" href="namespaceafio__v2__xxx.html#a08363b8572e6a8971a6d236d54fb8287"> AFIO_V2_NAMESPACE::log</a>().emplace_back(QUICKCPPLIB_NAMESPACE::ringbuffer_log::level::fatal, (message), AFIO_V2_NAMESPACE::detail::unsigned_integer_cast<unsigned>(inst), QUICKCPPLIB_NAMESPACE::utils::thread::this_thread_id(), (<a class="code" href="group__config.html#ga98c874cd585103f72c3c8338b491436b">AFIO_LOG_BACKTRACE_LEVELS</a> & (1U << 1U)) ? <span class="keyword">nullptr</span> : __func__, __LINE__); \</div><div class="line"> AFIO_LOG_FATAL_TO_CERR(message); \</div><div class="line"> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_a08363b8572e6a8971a6d236d54fb8287"><div class="ttname"><a href="namespaceafio__v2__xxx.html#a08363b8572e6a8971a6d236d54fb8287">afio_v2_xxx::log</a></div><div class="ttdeci">QUICKCPPLIB_NAMESPACE::ringbuffer_log::simple_ringbuffer_log< AFIO_LOGGING_MEMORY > & log() noexcept</div><div class="ttdoc">The log used by AFIO. </div><div class="ttdef"><b>Definition:</b> config.hpp:752</div></div> +<b>Value:</b><div class="fragment"><div class="line">{ <a class="code" href="namespaceafio__v2__xxx.html#a08363b8572e6a8971a6d236d54fb8287">\</a></div><div class="line"><a class="code" href="namespaceafio__v2__xxx.html#a08363b8572e6a8971a6d236d54fb8287"> AFIO_V2_NAMESPACE::log</a>().emplace_back(QUICKCPPLIB_NAMESPACE::ringbuffer_log::level::fatal, (message), AFIO_V2_NAMESPACE::detail::unsigned_integer_cast<unsigned>(inst), QUICKCPPLIB_NAMESPACE::utils::thread::this_thread_id(), (<a class="code" href="group__config.html#ga98c874cd585103f72c3c8338b491436b">AFIO_LOG_BACKTRACE_LEVELS</a> & (1U << 1U)) ? <span class="keyword">nullptr</span> : __func__, __LINE__); \</div><div class="line"> AFIO_LOG_FATAL_TO_CERR(message); \</div><div class="line"> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_a08363b8572e6a8971a6d236d54fb8287"><div class="ttname"><a href="namespaceafio__v2__xxx.html#a08363b8572e6a8971a6d236d54fb8287">afio_v2_xxx::log</a></div><div class="ttdeci">QUICKCPPLIB_NAMESPACE::ringbuffer_log::simple_ringbuffer_log< AFIO_LOGGING_MEMORY > & log() noexcept</div><div class="ttdoc">The log used by AFIO. </div><div class="ttdef"><b>Definition:</b> config.hpp:754</div></div> <div class="ttc" id="group__config_html_ga98c874cd585103f72c3c8338b491436b"><div class="ttname"><a href="group__config.html#ga98c874cd585103f72c3c8338b491436b">AFIO_LOG_BACKTRACE_LEVELS</a></div><div class="ttdeci">#define AFIO_LOG_BACKTRACE_LEVELS</div><div class="ttdoc">Bit mask of which log levels should be stack backtraced which will slow those logs thirty fold or so...</div><div class="ttdef"><b>Definition:</b> config.hpp:70</div></div> </div><!-- fragment --> </div> diff --git a/namespaceafio__v2__xxx.html b/namespaceafio__v2__xxx.html index 01ea6e9f..91649431 100644 --- a/namespaceafio__v2__xxx.html +++ b/namespaceafio__v2__xxx.html @@ -1620,7 +1620,7 @@ For portability, you can only assume that barriers write order for a single hand </dl> <p>Note that if the file is currently zero sized, no mapping occurs now, but later when <code>truncate()</code> or <code>update_map()</code> is called.</p> <dl class="section user"><dt>Errors returnable</dt><dd>Any of the values which the constructors for <code>file_handle</code>, <code>section_handle</code> and <code>map_handle</code> can return. </dd></dl> -<div class="fragment"><div class="line"><a name="l00439"></a><span class="lineno"> 439</span> {</div><div class="line"><a name="l00440"></a><span class="lineno"> 440</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceafio__v2__xxx.html#a2c44844c18f66950187cb57292d7a676">mapped_file_handle::mapped_file</a>(std::forward<decltype(reservation)>(reservation), std::forward<decltype(base)>(base), std::forward<decltype(_path)>(_path), std::forward<decltype(_mode)>(_mode), std::forward<decltype(_creation)>(_creation), std::forward<decltype(_caching)>(_caching),</div><div class="line"><a name="l00441"></a><span class="lineno"> 441</span>  std::forward<decltype(flags)>(flags));</div><div class="line"><a name="l00442"></a><span class="lineno"> 442</span> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_a2c44844c18f66950187cb57292d7a676"><div class="ttname"><a href="namespaceafio__v2__xxx.html#a2c44844c18f66950187cb57292d7a676">afio_v2_xxx::mapped_file</a></div><div class="ttdeci">result< mapped_file_handle > mapped_file(const path_handle &base, mapped_file_handle::path_view_type _path, mapped_file_handle::mode _mode=mapped_file_handle::mode::read, mapped_file_handle::creation _creation=mapped_file_handle::creation::open_existing, mapped_file_handle::caching _caching=mapped_file_handle::caching::all, mapped_file_handle::flag flags=mapped_file_handle::flag::none) noexcept</div><div class="ttdef"><b>Definition:</b> mapped_file_handle.hpp:444</div></div> +<div class="fragment"><div class="line"><a name="l00448"></a><span class="lineno"> 448</span> {</div><div class="line"><a name="l00449"></a><span class="lineno"> 449</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceafio__v2__xxx.html#a2c44844c18f66950187cb57292d7a676">mapped_file_handle::mapped_file</a>(std::forward<decltype(reservation)>(reservation), std::forward<decltype(base)>(base), std::forward<decltype(_path)>(_path), std::forward<decltype(_mode)>(_mode), std::forward<decltype(_creation)>(_creation), std::forward<decltype(_caching)>(_caching),</div><div class="line"><a name="l00450"></a><span class="lineno"> 450</span>  std::forward<decltype(flags)>(flags));</div><div class="line"><a name="l00451"></a><span class="lineno"> 451</span> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_a2c44844c18f66950187cb57292d7a676"><div class="ttname"><a href="namespaceafio__v2__xxx.html#a2c44844c18f66950187cb57292d7a676">afio_v2_xxx::mapped_file</a></div><div class="ttdeci">result< mapped_file_handle > mapped_file(const path_handle &base, mapped_file_handle::path_view_type _path, mapped_file_handle::mode _mode=mapped_file_handle::mode::read, mapped_file_handle::creation _creation=mapped_file_handle::creation::open_existing, mapped_file_handle::caching _caching=mapped_file_handle::caching::all, mapped_file_handle::flag flags=mapped_file_handle::flag::none) noexcept</div><div class="ttdef"><b>Definition:</b> mapped_file_handle.hpp:453</div></div> </div><!-- fragment --> </div> </div> @@ -1682,7 +1682,7 @@ For portability, you can only assume that barriers write order for a single hand </table> </div><div class="memdoc"> <p>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </p> -<div class="fragment"><div class="line"><a name="l00446"></a><span class="lineno"> 446</span> {</div><div class="line"><a name="l00447"></a><span class="lineno"> 447</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceafio__v2__xxx.html#a2c44844c18f66950187cb57292d7a676">mapped_file_handle::mapped_file</a>(std::forward<decltype(base)>(base), std::forward<decltype(_path)>(_path), std::forward<decltype(_mode)>(_mode), std::forward<decltype(_creation)>(_creation), std::forward<decltype(_caching)>(_caching), std::forward<decltype(flags)>(flags));</div><div class="line"><a name="l00448"></a><span class="lineno"> 448</span> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_a2c44844c18f66950187cb57292d7a676"><div class="ttname"><a href="namespaceafio__v2__xxx.html#a2c44844c18f66950187cb57292d7a676">afio_v2_xxx::mapped_file</a></div><div class="ttdeci">result< mapped_file_handle > mapped_file(const path_handle &base, mapped_file_handle::path_view_type _path, mapped_file_handle::mode _mode=mapped_file_handle::mode::read, mapped_file_handle::creation _creation=mapped_file_handle::creation::open_existing, mapped_file_handle::caching _caching=mapped_file_handle::caching::all, mapped_file_handle::flag flags=mapped_file_handle::flag::none) noexcept</div><div class="ttdef"><b>Definition:</b> mapped_file_handle.hpp:444</div></div> +<div class="fragment"><div class="line"><a name="l00455"></a><span class="lineno"> 455</span> {</div><div class="line"><a name="l00456"></a><span class="lineno"> 456</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceafio__v2__xxx.html#a2c44844c18f66950187cb57292d7a676">mapped_file_handle::mapped_file</a>(std::forward<decltype(base)>(base), std::forward<decltype(_path)>(_path), std::forward<decltype(_mode)>(_mode), std::forward<decltype(_creation)>(_creation), std::forward<decltype(_caching)>(_caching), std::forward<decltype(flags)>(flags));</div><div class="line"><a name="l00457"></a><span class="lineno"> 457</span> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_a2c44844c18f66950187cb57292d7a676"><div class="ttname"><a href="namespaceafio__v2__xxx.html#a2c44844c18f66950187cb57292d7a676">afio_v2_xxx::mapped_file</a></div><div class="ttdeci">result< mapped_file_handle > mapped_file(const path_handle &base, mapped_file_handle::path_view_type _path, mapped_file_handle::mode _mode=mapped_file_handle::mode::read, mapped_file_handle::creation _creation=mapped_file_handle::creation::open_existing, mapped_file_handle::caching _caching=mapped_file_handle::caching::all, mapped_file_handle::flag flags=mapped_file_handle::flag::none) noexcept</div><div class="ttdef"><b>Definition:</b> mapped_file_handle.hpp:453</div></div> </div><!-- fragment --> </div> </div> @@ -1739,7 +1739,7 @@ For portability, you can only assume that barriers write order for a single hand </div><div class="memdoc"> <p>Create an mapped file handle creating a randomly named file on a path. The file is opened exclusively with <code>creation::only_if_not_exist</code> so it will never collide with nor overwrite any existing file. Note also that caching defaults to temporary which hints to the OS to only flush changes to physical storage as lately as possible.</p> <dl class="section user"><dt>Errors returnable</dt><dd>Any of the values POSIX open() or CreateFile() can return. </dd></dl> -<div class="fragment"><div class="line"><a name="l00459"></a><span class="lineno"> 459</span> {</div><div class="line"><a name="l00460"></a><span class="lineno"> 460</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceafio__v2__xxx.html#ac9be648f691d72c9cac6295ea7b3f9c8">mapped_file_handle::mapped_random_file</a>(std::forward<decltype(reservation)>(reservation), std::forward<decltype(dirpath)>(dirpath), std::forward<decltype(_mode)>(_mode), std::forward<decltype(_caching)>(_caching), std::forward<decltype(flags)>(flags));</div><div class="line"><a name="l00461"></a><span class="lineno"> 461</span> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_ac9be648f691d72c9cac6295ea7b3f9c8"><div class="ttname"><a href="namespaceafio__v2__xxx.html#ac9be648f691d72c9cac6295ea7b3f9c8">afio_v2_xxx::mapped_random_file</a></div><div class="ttdeci">result< mapped_file_handle > mapped_random_file(mapped_file_handle::size_type reservation, const path_handle &dirpath, mapped_file_handle::mode _mode=mapped_file_handle::mode::write, mapped_file_handle::caching _caching=mapped_file_handle::caching::temporary, mapped_file_handle::flag flags=mapped_file_handle::flag::none) noexcept</div><div class="ttdef"><b>Definition:</b> mapped_file_handle.hpp:457</div></div> +<div class="fragment"><div class="line"><a name="l00468"></a><span class="lineno"> 468</span> {</div><div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceafio__v2__xxx.html#ac9be648f691d72c9cac6295ea7b3f9c8">mapped_file_handle::mapped_random_file</a>(std::forward<decltype(reservation)>(reservation), std::forward<decltype(dirpath)>(dirpath), std::forward<decltype(_mode)>(_mode), std::forward<decltype(_caching)>(_caching), std::forward<decltype(flags)>(flags));</div><div class="line"><a name="l00470"></a><span class="lineno"> 470</span> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_ac9be648f691d72c9cac6295ea7b3f9c8"><div class="ttname"><a href="namespaceafio__v2__xxx.html#ac9be648f691d72c9cac6295ea7b3f9c8">afio_v2_xxx::mapped_random_file</a></div><div class="ttdeci">result< mapped_file_handle > mapped_random_file(mapped_file_handle::size_type reservation, const path_handle &dirpath, mapped_file_handle::mode _mode=mapped_file_handle::mode::write, mapped_file_handle::caching _caching=mapped_file_handle::caching::temporary, mapped_file_handle::flag flags=mapped_file_handle::flag::none) noexcept</div><div class="ttdef"><b>Definition:</b> mapped_file_handle.hpp:466</div></div> </div><!-- fragment --> </div> </div> @@ -1803,7 +1803,7 @@ For portability, you can only assume that barriers write order for a single hand <p>Create a mapped file handle creating the named file on some path which the OS declares to be suitable for temporary files. Most OSs are very lazy about flushing changes made to these temporary files. Note the default flags are to have the newly created file deleted on first handle close. Note also that an empty name is equivalent to calling <code>mapped_random_file(path_discovery::storage_backed_temporary_files_directory())</code> and the creation parameter is ignored.</p> <dl class="section note"><dt>Note</dt><dd>If the temporary file you are creating is not going to have its path sent to another process for usage, this is the WRONG function to use. Use <code>temp_inode()</code> instead, it is far more secure.</dd></dl> <dl class="section user"><dt>Errors returnable</dt><dd>Any of the values POSIX open() or CreateFile() can return. </dd></dl> -<div class="fragment"><div class="line"><a name="l00479"></a><span class="lineno"> 479</span> {</div><div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceafio__v2__xxx.html#a854bf340650b26894c1f2ae2a6c4c5ab">mapped_file_handle::mapped_temp_file</a>(std::forward<decltype(reservation)>(reservation), std::forward<decltype(name)>(name), std::forward<decltype(_mode)>(_mode), std::forward<decltype(_creation)>(_creation), std::forward<decltype(_caching)>(_caching), std::forward<decltype(flags)>(flags));</div><div class="line"><a name="l00481"></a><span class="lineno"> 481</span> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_a854bf340650b26894c1f2ae2a6c4c5ab"><div class="ttname"><a href="namespaceafio__v2__xxx.html#a854bf340650b26894c1f2ae2a6c4c5ab">afio_v2_xxx::mapped_temp_file</a></div><div class="ttdeci">result< mapped_file_handle > mapped_temp_file(mapped_file_handle::size_type reservation, mapped_file_handle::path_view_type name=mapped_file_handle::path_view_type(), mapped_file_handle::mode _mode=mapped_file_handle::mode::write, mapped_file_handle::creation _creation=mapped_file_handle::creation::if_needed, mapped_file_handle::caching _caching=mapped_file_handle::caching::temporary, mapped_file_handle::flag flags=mapped_file_handle::flag::unlink_on_first_close) noexcept</div><div class="ttdef"><b>Definition:</b> mapped_file_handle.hpp:477</div></div> +<div class="fragment"><div class="line"><a name="l00488"></a><span class="lineno"> 488</span> {</div><div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceafio__v2__xxx.html#a854bf340650b26894c1f2ae2a6c4c5ab">mapped_file_handle::mapped_temp_file</a>(std::forward<decltype(reservation)>(reservation), std::forward<decltype(name)>(name), std::forward<decltype(_mode)>(_mode), std::forward<decltype(_creation)>(_creation), std::forward<decltype(_caching)>(_caching), std::forward<decltype(flags)>(flags));</div><div class="line"><a name="l00490"></a><span class="lineno"> 490</span> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_a854bf340650b26894c1f2ae2a6c4c5ab"><div class="ttname"><a href="namespaceafio__v2__xxx.html#a854bf340650b26894c1f2ae2a6c4c5ab">afio_v2_xxx::mapped_temp_file</a></div><div class="ttdeci">result< mapped_file_handle > mapped_temp_file(mapped_file_handle::size_type reservation, mapped_file_handle::path_view_type name=mapped_file_handle::path_view_type(), mapped_file_handle::mode _mode=mapped_file_handle::mode::write, mapped_file_handle::creation _creation=mapped_file_handle::creation::if_needed, mapped_file_handle::caching _caching=mapped_file_handle::caching::temporary, mapped_file_handle::flag flags=mapped_file_handle::flag::unlink_on_first_close) noexcept</div><div class="ttdef"><b>Definition:</b> mapped_file_handle.hpp:486</div></div> </div><!-- fragment --> </div> </div> @@ -1848,7 +1848,7 @@ For portability, you can only assume that barriers write order for a single hand </div><div class="memdoc"> <p><em>Securely</em> create a mapped file handle creating a temporary anonymous inode in the filesystem referred to by <em>dirpath</em>. The inode created has no name nor accessible path on the filing system and ceases to exist as soon as the last handle is closed, making it ideal for use as a temporary file where other processes do not need to have access to its contents via some path on the filing system (a classic use case is for backing shared memory maps).</p> <dl class="section user"><dt>Errors returnable</dt><dd>Any of the values POSIX open() or CreateFile() can return. </dd></dl> -<div class="fragment"><div class="line"><a name="l00493"></a><span class="lineno"> 493</span> {</div><div class="line"><a name="l00494"></a><span class="lineno"> 494</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceafio__v2__xxx.html#ac021261f7a8696b0f4cbdcfacef1e88a">mapped_file_handle::mapped_temp_inode</a>(std::forward<decltype(dir)>(dir), std::forward<decltype(_mode)>(_mode), std::forward<decltype(flags)>(flags));</div><div class="line"><a name="l00495"></a><span class="lineno"> 495</span> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_ac021261f7a8696b0f4cbdcfacef1e88a"><div class="ttname"><a href="namespaceafio__v2__xxx.html#ac021261f7a8696b0f4cbdcfacef1e88a">afio_v2_xxx::mapped_temp_inode</a></div><div class="ttdeci">result< mapped_file_handle > mapped_temp_inode(const path_handle &dir=path_discovery::storage_backed_temporary_files_directory(), mapped_file_handle::mode _mode=mapped_file_handle::mode::write, mapped_file_handle::flag flags=mapped_file_handle::flag::none) noexcept</div><div class="ttdef"><b>Definition:</b> mapped_file_handle.hpp:492</div></div> +<div class="fragment"><div class="line"><a name="l00502"></a><span class="lineno"> 502</span> {</div><div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceafio__v2__xxx.html#ac021261f7a8696b0f4cbdcfacef1e88a">mapped_file_handle::mapped_temp_inode</a>(std::forward<decltype(dir)>(dir), std::forward<decltype(_mode)>(_mode), std::forward<decltype(flags)>(flags));</div><div class="line"><a name="l00504"></a><span class="lineno"> 504</span> }</div><div class="ttc" id="namespaceafio__v2__xxx_html_ac021261f7a8696b0f4cbdcfacef1e88a"><div class="ttname"><a href="namespaceafio__v2__xxx.html#ac021261f7a8696b0f4cbdcfacef1e88a">afio_v2_xxx::mapped_temp_inode</a></div><div class="ttdeci">result< mapped_file_handle > mapped_temp_inode(const path_handle &dir=path_discovery::storage_backed_temporary_files_directory(), mapped_file_handle::mode _mode=mapped_file_handle::mode::write, mapped_file_handle::flag flags=mapped_file_handle::flag::none) noexcept</div><div class="ttdef"><b>Definition:</b> mapped_file_handle.hpp:501</div></div> </div><!-- fragment --> </div> </div> |