diff options
Diffstat (limited to 'structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html')
| -rw-r--r-- | structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html | 456 |
1 files changed, 456 insertions, 0 deletions
diff --git a/structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html b/structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html new file mode 100644 index 00000000..a77eb0b4 --- /dev/null +++ b/structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html @@ -0,0 +1,456 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> +<head> +<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> +<meta http-equiv="X-UA-Compatible" content="IE=9"/> +<meta name="generator" content="Doxygen 1.8.17"/> +<meta name="viewport" content="width=device-width, initial-scale=1"/> +<title>LLFIO: llfio_v2_xxx::algorithm::contents_visitor Struct Reference</title> +<link href="tabs.css" rel="stylesheet" type="text/css"/> +<script type="text/javascript" src="jquery.js"></script> +<script type="text/javascript" src="dynsections.js"></script> +<link href="navtree.css" rel="stylesheet" type="text/css"/> +<script type="text/javascript" src="resize.js"></script> +<script type="text/javascript" src="navtreedata.js"></script> +<script type="text/javascript" src="navtree.js"></script> +<link href="search/search.css" rel="stylesheet" type="text/css"/> +<script type="text/javascript" src="search/searchdata.js"></script> +<script type="text/javascript" src="search/search.js"></script> +<link href="doxygen.css" rel="stylesheet" type="text/css" /> +</head> +<body> +<div id="top"><!-- do not remove this div, it is closed by doxygen! --> +<div id="titlearea"> +<table cellspacing="0" cellpadding="0"> + <tbody> + <tr style="height: 56px;"> + <td id="projectalign" style="padding-left: 0.5em;"> + <div id="projectname">LLFIO +  <span id="projectnumber">v2.00 late beta</span> + </div> + </td> + </tr> + </tbody> +</table> +</div> +<!-- end header part --> +<!-- Generated by Doxygen 1.8.17 --> +<script type="text/javascript"> +/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ +var searchBox = new SearchBox("searchBox", "search",false,'Search'); +/* @license-end */ +</script> +<script type="text/javascript" src="menudata.js"></script> +<script type="text/javascript" src="menu.js"></script> +<script type="text/javascript"> +/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ +$(function() { + initMenu('',true,false,'search.php','Search'); + $(document).ready(function() { init_search(); }); +}); +/* @license-end */</script> +<div id="main-nav"></div> +</div><!-- top --> +<div id="side-nav" class="ui-resizable side-nav-resizable"> + <div id="nav-tree"> + <div id="nav-tree-contents"> + <div id="nav-sync" class="sync"></div> + </div> + </div> + <div id="splitbar" style="-moz-user-select:none;" + class="ui-resizable-handle"> + </div> +</div> +<script type="text/javascript"> +/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ +$(document).ready(function(){initNavTree('structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html',''); initResizable(); }); +/* @license-end */ +</script> +<div id="doc-content"> +<!-- window showing the filter options --> +<div id="MSearchSelectWindow" + onmouseover="return searchBox.OnSearchSelectShow()" + onmouseout="return searchBox.OnSearchSelectHide()" + onkeydown="return searchBox.OnSearchSelectKey(event)"> +</div> + +<!-- iframe showing the search results (closed by default) --> +<div id="MSearchResultsWindow"> +<iframe src="javascript:void(0)" frameborder="0" + name="MSearchResults" id="MSearchResults"> +</iframe> +</div> + +<div class="header"> + <div class="summary"> +<a href="#nested-classes">Classes</a> | +<a href="#pub-methods">Public Member Functions</a> | +<a href="#pub-attribs">Public Attributes</a> | +<a href="#pro-static-methods">Static Protected Member Functions</a> | +<a href="#friends">Friends</a> | +<a href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor-members.html">List of all members</a> </div> + <div class="headertitle"> +<div class="title">llfio_v2_xxx::algorithm::contents_visitor Struct Reference</div> </div> +</div><!--header--> +<div class="contents"> + +<p>A visitor for the filesystem contents algorithm. + <a href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#details">More...</a></p> + +<p><code>#include "contents.hpp"</code></p> +<div class="dynheader"> +Inheritance diagram for llfio_v2_xxx::algorithm::contents_visitor:</div> +<div class="dyncontent"> + <div class="center"> + <img src="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.png" usemap="#llfio_5Fv2_5Fxxx::algorithm::contents_5Fvisitor_map" alt=""/> + <map id="llfio_5Fv2_5Fxxx::algorithm::contents_5Fvisitor_map" name="llfio_5Fv2_5Fxxx::algorithm::contents_5Fvisitor_map"> +<area href="structllfio__v2__xxx_1_1algorithm_1_1traverse__visitor.html" title="A visitor for the filesystem traversal algorithm." alt="llfio_v2_xxx::algorithm::traverse_visitor" shape="rect" coords="0,0,229,24"/> + </map> +</div></div> +<table class="memberdecls"> +<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a> +Classes</h2></td></tr> +<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor_1_1__state__type.html">_state_type</a></td></tr> +<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor_1_1contents__type.html">contents_type</a></td></tr> +<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Enumerated contents, and what parts of their <code>stat_t</code> is valid. <a href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor_1_1contents__type.html#details">More...</a><br /></td></tr> +<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> +</table><table class="memberdecls"> +<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> +Public Member Functions</h2></td></tr> +<tr class="memitem:af6abea2e039efe9a9cb4169ead10b16c"><td class="memItemLeft" align="right" valign="top"><a id="af6abea2e039efe9a9cb4169ead10b16c"></a> + </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#af6abea2e039efe9a9cb4169ead10b16c">contents_visitor</a> ()=default</td></tr> +<tr class="memdesc:af6abea2e039efe9a9cb4169ead10b16c"><td class="mdescLeft"> </td><td class="mdescRight">Default construtor. <br /></td></tr> +<tr class="separator:af6abea2e039efe9a9cb4169ead10b16c"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:aba01c69fc160f888879cc5c186fca250"><td class="memItemLeft" align="right" valign="top"><a id="aba01c69fc160f888879cc5c186fca250"></a> + </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#aba01c69fc160f888879cc5c186fca250">contents_visitor</a> (stat_t::want _metadata, bool _include_files=true, bool _include_directories=true, bool _include_symlinks=true)</td></tr> +<tr class="memdesc:aba01c69fc160f888879cc5c186fca250"><td class="mdescLeft"> </td><td class="mdescRight">Construct an instance. <br /></td></tr> +<tr class="separator:aba01c69fc160f888879cc5c186fca250"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:a21e87fbd21296205b34cbf375d34d74d"><td class="memItemLeft" align="right" valign="top"><a id="a21e87fbd21296205b34cbf375d34d74d"></a> +virtual result< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#a21e87fbd21296205b34cbf375d34d74d">post_enumeration</a> (void *data, const <a class="el" href="classllfio__v2__xxx_1_1directory__handle.html">directory_handle</a> &dirh, <a class="el" href="structllfio__v2__xxx_1_1directory__handle_1_1buffers__type.html">directory_handle::buffers_type</a> &<a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#a5f02be8e551bc5749757abba8e0d92c9">contents</a>, size_t depth) noexcept</td></tr> +<tr class="memdesc:a21e87fbd21296205b34cbf375d34d74d"><td class="mdescLeft"> </td><td class="mdescRight">The default implementation accumulates the contents into thread local storage. At traverse end, all the thread local storages are coalesced into a single result, the member variable <code>contents</code>. <br /></td></tr> +<tr class="separator:a21e87fbd21296205b34cbf375d34d74d"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:a562fe188c4ec1e2ed1013cdcdbded749"><td class="memItemLeft" align="right" valign="top"><a id="a562fe188c4ec1e2ed1013cdcdbded749"></a> +virtual result< size_t > </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#a562fe188c4ec1e2ed1013cdcdbded749">finished</a> (void *data, result< size_t > result) noexcept</td></tr> +<tr class="memdesc:a562fe188c4ec1e2ed1013cdcdbded749"><td class="mdescLeft"> </td><td class="mdescRight">Called when a traversal finishes, this default implementation merges all the thread local results into <code>contents</code>, and deallocates the thread local results. <br /></td></tr> +<tr class="separator:a562fe188c4ec1e2ed1013cdcdbded749"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:a649d2496caac9dd869eb0ab2e135a0a2"><td class="memItemLeft" align="right" valign="top">virtual result< <a class="el" href="classllfio__v2__xxx_1_1directory__handle.html">directory_handle</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1traverse__visitor.html#a649d2496caac9dd869eb0ab2e135a0a2">directory_open_failed</a> (void *data, result< void >::error_type &&<a class="el" href="classllfio__v2__xxx_1_1error.html">error</a>, const <a class="el" href="classllfio__v2__xxx_1_1directory__handle.html">directory_handle</a> &dirh, <a class="el" href="classllfio__v2__xxx_1_1path__view.html">path_view</a> leaf, size_t depth) noexcept</td></tr> +<tr class="memdesc:a649d2496caac9dd869eb0ab2e135a0a2"><td class="mdescLeft"> </td><td class="mdescRight">Called when we failed to open a directory for enumeration. The default fails the traversal with that error. Return a default constructed instance to ignore the failure. <a href="structllfio__v2__xxx_1_1algorithm_1_1traverse__visitor.html#a649d2496caac9dd869eb0ab2e135a0a2">More...</a><br /></td></tr> +<tr class="separator:a649d2496caac9dd869eb0ab2e135a0a2"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:a4d3c4b226532089d121dc3d96ed88b39"><td class="memItemLeft" align="right" valign="top">virtual result< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1traverse__visitor.html#a4d3c4b226532089d121dc3d96ed88b39">pre_enumeration</a> (void *data, const <a class="el" href="classllfio__v2__xxx_1_1directory__handle.html">directory_handle</a> &dirh, size_t depth) noexcept</td></tr> +<tr class="memdesc:a4d3c4b226532089d121dc3d96ed88b39"><td class="mdescLeft"> </td><td class="mdescRight">Called to decide whether to enumerate a directory. <a href="structllfio__v2__xxx_1_1algorithm_1_1traverse__visitor.html#a4d3c4b226532089d121dc3d96ed88b39">More...</a><br /></td></tr> +<tr class="separator:a4d3c4b226532089d121dc3d96ed88b39"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:a44e3a5ace0aa50d8f6f836c48e510c54"><td class="memItemLeft" align="right" valign="top">virtual result< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1traverse__visitor.html#a44e3a5ace0aa50d8f6f836c48e510c54">stack_updated</a> (void *data, size_t dirs_processed, size_t known_dirs_remaining, size_t depth_processed, size_t known_depth_remaining) noexcept</td></tr> +<tr class="memdesc:a44e3a5ace0aa50d8f6f836c48e510c54"><td class="mdescLeft"> </td><td class="mdescRight">Called whenever the traversed stack of directory hierarchy is updated. This can act as an estimated progress indicator, or to give an accurate progress indicator by matching it against a previous traversal. \data The third party data pointer passed to <code>traverse()</code>. <a href="structllfio__v2__xxx_1_1algorithm_1_1traverse__visitor.html#a44e3a5ace0aa50d8f6f836c48e510c54">More...</a><br /></td></tr> +<tr class="separator:a44e3a5ace0aa50d8f6f836c48e510c54"><td class="memSeparator" colspan="2"> </td></tr> +</table><table class="memberdecls"> +<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a> +Public Attributes</h2></td></tr> +<tr class="memitem:ab18385d61d5aac5d34711a3a12fb45b2"><td class="memItemLeft" align="right" valign="top"><a id="ab18385d61d5aac5d34711a3a12fb45b2"></a> +bool </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#ab18385d61d5aac5d34711a3a12fb45b2">contents_include_files</a> {true}</td></tr> +<tr class="memdesc:ab18385d61d5aac5d34711a3a12fb45b2"><td class="mdescLeft"> </td><td class="mdescRight">Whether to include files in the contents. <br /></td></tr> +<tr class="separator:ab18385d61d5aac5d34711a3a12fb45b2"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:a7c9fa61b7ddf56d958331de2e44cbf1a"><td class="memItemLeft" align="right" valign="top"><a id="a7c9fa61b7ddf56d958331de2e44cbf1a"></a> +bool </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#a7c9fa61b7ddf56d958331de2e44cbf1a">contents_include_directories</a> {true}</td></tr> +<tr class="memdesc:a7c9fa61b7ddf56d958331de2e44cbf1a"><td class="mdescLeft"> </td><td class="mdescRight">Whether to include directories in the contents. <br /></td></tr> +<tr class="separator:a7c9fa61b7ddf56d958331de2e44cbf1a"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:a73ad0141c99d70d09ee6026ac8c19ab5"><td class="memItemLeft" align="right" valign="top"><a id="a73ad0141c99d70d09ee6026ac8c19ab5"></a> +bool </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#a73ad0141c99d70d09ee6026ac8c19ab5">contents_include_symlinks</a> {true}</td></tr> +<tr class="memdesc:a73ad0141c99d70d09ee6026ac8c19ab5"><td class="mdescLeft"> </td><td class="mdescRight">Whether to include symlinks in the contents. <br /></td></tr> +<tr class="separator:a73ad0141c99d70d09ee6026ac8c19ab5"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:a577d4ae1477e1cd9531679b0dff41577"><td class="memItemLeft" align="right" valign="top"><a id="a577d4ae1477e1cd9531679b0dff41577"></a> +stat_t::want </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#a577d4ae1477e1cd9531679b0dff41577">contents_include_metadata</a> {stat_t::want::none}</td></tr> +<tr class="memdesc:a577d4ae1477e1cd9531679b0dff41577"><td class="mdescLeft"> </td><td class="mdescRight">What <code>stat_t::want</code> to include, if enumeration doesn't provide these, they will be additionally fetched. <br /></td></tr> +<tr class="separator:a577d4ae1477e1cd9531679b0dff41577"><td class="memSeparator" colspan="2"> </td></tr> +</table><table class="memberdecls"> +<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-static-methods"></a> +Static Protected Member Functions</h2></td></tr> +<tr class="memitem:a6eb0213e53e6f1acec63f44da8acde49"><td class="memItemLeft" align="right" valign="top"><a id="a6eb0213e53e6f1acec63f44da8acde49"></a> +static std::shared_ptr< <a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor_1_1contents__type.html">contents_type</a> > </td><td class="memItemRight" valign="bottom"><b>_thread_contents</b> (<a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor_1_1__state__type.html">_state_type</a> *state) noexcept</td></tr> +<tr class="separator:a6eb0213e53e6f1acec63f44da8acde49"><td class="memSeparator" colspan="2"> </td></tr> +</table><table class="memberdecls"> +<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="friends"></a> +Friends</h2></td></tr> +<tr class="memitem:a5f02be8e551bc5749757abba8e0d92c9"><td class="memItemLeft" align="right" valign="top">result< <a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor_1_1contents__type.html">contents_type</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#a5f02be8e551bc5749757abba8e0d92c9">contents</a> (const <a class="el" href="classllfio__v2__xxx_1_1path__handle.html">path_handle</a> &dirh, <a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html">contents_visitor</a> *visitor, size_t threads, bool force_slow_path) noexcept</td></tr> +<tr class="memdesc:a5f02be8e551bc5749757abba8e0d92c9"><td class="mdescLeft"> </td><td class="mdescRight">Calculate the contents of everything within and under <code>dirh</code>. What is returned is unordered. <a href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#a5f02be8e551bc5749757abba8e0d92c9">More...</a><br /></td></tr> +<tr class="separator:a5f02be8e551bc5749757abba8e0d92c9"><td class="memSeparator" colspan="2"> </td></tr> +</table> +<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> +<div class="textblock"><p>A visitor for the filesystem contents algorithm. </p> +</div><h2 class="groupheader">Member Function Documentation</h2> +<a id="a649d2496caac9dd869eb0ab2e135a0a2"></a> +<h2 class="memtitle"><span class="permalink"><a href="#a649d2496caac9dd869eb0ab2e135a0a2">◆ </a></span>directory_open_failed()</h2> + +<div class="memitem"> +<div class="memproto"> +<table class="mlabels"> + <tr> + <td class="mlabels-left"> + <table class="memname"> + <tr> + <td class="memname">virtual result<<a class="el" href="classllfio__v2__xxx_1_1directory__handle.html">directory_handle</a>> llfio_v2_xxx::algorithm::traverse_visitor::directory_open_failed </td> + <td>(</td> + <td class="paramtype">void * </td> + <td class="paramname"><em>data</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">result< void >::error_type && </td> + <td class="paramname"><em>error</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">const <a class="el" href="classllfio__v2__xxx_1_1directory__handle.html">directory_handle</a> & </td> + <td class="paramname"><em>dirh</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype"><a class="el" href="classllfio__v2__xxx_1_1path__view.html">path_view</a> </td> + <td class="paramname"><em>leaf</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">size_t </td> + <td class="paramname"><em>depth</em> </td> + </tr> + <tr> + <td></td> + <td>)</td> + <td></td><td></td> + </tr> + </table> + </td> + <td class="mlabels-right"> +<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span><span class="mlabel">noexcept</span><span class="mlabel">inherited</span></span> </td> + </tr> +</table> +</div><div class="memdoc"> + +<p>Called when we failed to open a directory for enumeration. The default fails the traversal with that error. Return a default constructed instance to ignore the failure. </p> +<dl class="section note"><dt>Note</dt><dd>May be called from multiple kernel threads concurrently. </dd></dl> + +<p>Reimplemented in <a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1summarize__visitor.html#a2d6b2c113d9c3fad2318e9d0e5f83c13">llfio_v2_xxx::algorithm::summarize_visitor</a>, <a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1compare__visitor.html#a7ec4aafb16d931783d190cbd8b9c5f7d">llfio_v2_xxx::algorithm::compare_visitor</a>, and <a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1reduce__visitor.html#a5af71cbf83dd3c499898f03405a5e698">llfio_v2_xxx::algorithm::reduce_visitor</a>.</p> +<div class="fragment"><div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  {</div> +<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  (void) data;</div> +<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  (void) dirh;</div> +<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  (void) leaf;</div> +<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  (void) depth;</div> +<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  <span class="keywordflow">return</span> failure(std::move(error));</div> +<div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  }</div> +</div><!-- fragment --> +</div> +</div> +<a id="a4d3c4b226532089d121dc3d96ed88b39"></a> +<h2 class="memtitle"><span class="permalink"><a href="#a4d3c4b226532089d121dc3d96ed88b39">◆ </a></span>pre_enumeration()</h2> + +<div class="memitem"> +<div class="memproto"> +<table class="mlabels"> + <tr> + <td class="mlabels-left"> + <table class="memname"> + <tr> + <td class="memname">virtual result<bool> llfio_v2_xxx::algorithm::traverse_visitor::pre_enumeration </td> + <td>(</td> + <td class="paramtype">void * </td> + <td class="paramname"><em>data</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">const <a class="el" href="classllfio__v2__xxx_1_1directory__handle.html">directory_handle</a> & </td> + <td class="paramname"><em>dirh</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">size_t </td> + <td class="paramname"><em>depth</em> </td> + </tr> + <tr> + <td></td> + <td>)</td> + <td></td><td></td> + </tr> + </table> + </td> + <td class="mlabels-right"> +<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span><span class="mlabel">noexcept</span><span class="mlabel">inherited</span></span> </td> + </tr> +</table> +</div><div class="memdoc"> + +<p>Called to decide whether to enumerate a directory. </p> +<p>Note that it is more efficient to ignore the directory entry in <code>post_enumeration()</code> than to ignore it here, as a handle is opened for the directory before this callback. Equally, if you need that handle to inspect the directory e.g. to check if one is entering a different filesystem from the root, here is best.</p> +<p>The default returns <code>true</code>.</p> +<dl class="section note"><dt>Note</dt><dd>May be called from multiple kernel threads concurrently. </dd></dl> +<div class="fragment"><div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  {</div> +<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  (void) data;</div> +<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  (void) dirh;</div> +<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  (void) depth;</div> +<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> +<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  }</div> +</div><!-- fragment --> +</div> +</div> +<a id="a44e3a5ace0aa50d8f6f836c48e510c54"></a> +<h2 class="memtitle"><span class="permalink"><a href="#a44e3a5ace0aa50d8f6f836c48e510c54">◆ </a></span>stack_updated()</h2> + +<div class="memitem"> +<div class="memproto"> +<table class="mlabels"> + <tr> + <td class="mlabels-left"> + <table class="memname"> + <tr> + <td class="memname">virtual result<void> llfio_v2_xxx::algorithm::traverse_visitor::stack_updated </td> + <td>(</td> + <td class="paramtype">void * </td> + <td class="paramname"><em>data</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">size_t </td> + <td class="paramname"><em>dirs_processed</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">size_t </td> + <td class="paramname"><em>known_dirs_remaining</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">size_t </td> + <td class="paramname"><em>depth_processed</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">size_t </td> + <td class="paramname"><em>known_depth_remaining</em> </td> + </tr> + <tr> + <td></td> + <td>)</td> + <td></td><td></td> + </tr> + </table> + </td> + <td class="mlabels-right"> +<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span><span class="mlabel">noexcept</span><span class="mlabel">inherited</span></span> </td> + </tr> +</table> +</div><div class="memdoc"> + +<p>Called whenever the traversed stack of directory hierarchy is updated. This can act as an estimated progress indicator, or to give an accurate progress indicator by matching it against a previous traversal. \data The third party data pointer passed to <code>traverse()</code>. </p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramname">dirs_processed</td><td>The total number of directories traversed so far. </td></tr> + <tr><td class="paramname">known_dirs_remaining</td><td>The currently known number of directories awaiting traversal. </td></tr> + <tr><td class="paramname">depth_processed</td><td>How many levels deep we have already completely traversed. </td></tr> + <tr><td class="paramname">known_depth_remaining</td><td>The currently known number of levels we shall traverse.</td></tr> + </table> + </dd> +</dl> +<dl class="section note"><dt>Note</dt><dd>May be called from multiple kernel threads concurrently. </dd></dl> +<div class="fragment"><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  {</div> +<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  (void) data;</div> +<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  (void) dirs_processed;</div> +<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  (void) known_dirs_remaining;</div> +<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  (void) depth_processed;</div> +<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  (void) known_depth_remaining;</div> +<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <span class="keywordflow">return</span> success();</div> +<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  }</div> +</div><!-- fragment --> +</div> +</div> +<h2 class="groupheader">Friends And Related Function Documentation</h2> +<a id="a5f02be8e551bc5749757abba8e0d92c9"></a> +<h2 class="memtitle"><span class="permalink"><a href="#a5f02be8e551bc5749757abba8e0d92c9">◆ </a></span>contents</h2> + +<div class="memitem"> +<div class="memproto"> +<table class="mlabels"> + <tr> + <td class="mlabels-left"> + <table class="memname"> + <tr> + <td class="memname">result<<a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor_1_1contents__type.html">contents_type</a>> contents </td> + <td>(</td> + <td class="paramtype">const <a class="el" href="classllfio__v2__xxx_1_1path__handle.html">path_handle</a> & </td> + <td class="paramname"><em>dirh</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html">contents_visitor</a> * </td> + <td class="paramname"><em>visitor</em> = <code>nullptr</code>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">size_t </td> + <td class="paramname"><em>threads</em> = <code>0</code>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">bool </td> + <td class="paramname"><em>force_slow_path</em> = <code>false</code> </td> + </tr> + <tr> + <td></td> + <td>)</td> + <td></td><td></td> + </tr> + </table> + </td> + <td class="mlabels-right"> +<span class="mlabels"><span class="mlabel">friend</span></span> </td> + </tr> +</table> +</div><div class="memdoc"> + +<p>Calculate the contents of everything within and under <code>dirh</code>. What is returned is unordered. </p> +<p>This is a very thin veneer over <code>traverse()</code> which came out of the fact that I kept writing "get me the contents" traversal visitors again and again, so eventually I just wrote a library edition. Its only "clever" bit is that it stores the contents in thread local storage, and merges the contents afterwards.</p> +<p>It is race free to concurrent relocations of <code>dirh</code>. It is entirely implemented in header-only code, as it is very simple. </p> +<div class="fragment"><div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  {</div> +<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  <a class="code" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#af6abea2e039efe9a9cb4169ead10b16c">contents_visitor</a> default_visitor;</div> +<div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  <span class="keywordflow">if</span>(visitor == <span class="keyword">nullptr</span>)</div> +<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  {</div> +<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  visitor = &default_visitor;</div> +<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  }</div> +<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  contents_visitor::_state_type state(dirh);</div> +<div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  OUTCOME_TRY(<span class="keyword">auto</span> &&dirhpath, dirh.current_path());</div> +<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  state.rootdirpathlen.store(dirhpath.native().size() + 1, std::memory_order_relaxed);</div> +<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  OUTCOME_TRY(<a class="code" href="namespacellfio__v2__xxx_1_1algorithm.html#ae068bc16598189811d0ce2b3530f1de7">traverse</a>(dirh, visitor, threads, &state, force_slow_path));</div> +<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  <span class="keywordflow">return</span> {std::move(state.contents)};</div> +<div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  }</div> +</div><!-- fragment --> +</div> +</div> +<hr/>The documentation for this struct was generated from the following file:<ul> +<li>include/llfio/v2.0/algorithm/<a class="el" href="contents_8hpp.html">contents.hpp</a></li> +</ul> +</div><!-- contents --> +</div><!-- doc-content --> +<div class="ttc" id="astructllfio__v2__xxx_1_1algorithm_1_1contents__visitor_html_af6abea2e039efe9a9cb4169ead10b16c"><div class="ttname"><a href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html#af6abea2e039efe9a9cb4169ead10b16c">llfio_v2_xxx::algorithm::contents_visitor::contents_visitor</a></div><div class="ttdeci">contents_visitor()=default</div><div class="ttdoc">Default construtor.</div></div> +<div class="ttc" id="anamespacellfio__v2__xxx_1_1algorithm_html_ae068bc16598189811d0ce2b3530f1de7"><div class="ttname"><a href="namespacellfio__v2__xxx_1_1algorithm.html#ae068bc16598189811d0ce2b3530f1de7">llfio_v2_xxx::algorithm::traverse</a></div><div class="ttdeci">result< size_t > traverse(const path_handle &dirh, traverse_visitor *visitor, size_t threads=0, void *data=nullptr, bool force_slow_path=false) noexcept</div><div class="ttdoc">Traverse everything within and under dirh.</div></div> +<!-- start footer part --> +<div id="nav-path" class="navpath"><!-- id is needed for treeview function! --> + <ul> + <li class="navelem"><a class="el" href="namespacellfio__v2__xxx.html">llfio_v2_xxx</a></li><li class="navelem"><a class="el" href="namespacellfio__v2__xxx_1_1algorithm.html">algorithm</a></li><li class="navelem"><a class="el" href="structllfio__v2__xxx_1_1algorithm_1_1contents__visitor.html">contents_visitor</a></li> + <li class="footer">Generated by + <a href="http://www.doxygen.org/index.html"> + <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.17 </li> + </ul> +</div> +</body> +</html> |