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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://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.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>LLFIO: llfio_v2_xxx::io_service Class 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>
<script type="text/javascript">
$(document).ready(initResizable);
</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 alpha</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</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">
$(document).ready(function(){initNavTree('classllfio__v2__xxx_1_1io__service.html','');});
</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-types">Public Types</a> |
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> |
<a href="#friends">Friends</a> |
<a href="classllfio__v2__xxx_1_1io__service-members.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">llfio_v2_xxx::io_service Class Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>An asynchronous i/o multiplexer service.
<a href="classllfio__v2__xxx_1_1io__service.html#details">More...</a></p>
<p><code>#include "io_service.hpp"</code></p>
<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_1io__service_1_1awaitable__post__to__self.html">awaitable_post_to_self</a></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-types"></a>
Public Types</h2></td></tr>
<tr class="memitem:afa88ed41bd1ff94b78a4667e1befb76a"><td class="memItemLeft" align="right" valign="top"><a id="afa88ed41bd1ff94b78a4667e1befb76a"></a>
using </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#afa88ed41bd1ff94b78a4667e1befb76a">extent_type</a> = io_handle::extent_type</td></tr>
<tr class="memdesc:afa88ed41bd1ff94b78a4667e1befb76a"><td class="mdescLeft"> </td><td class="mdescRight">The file extent type used by this i/o service. <br /></td></tr>
<tr class="separator:afa88ed41bd1ff94b78a4667e1befb76a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af156201cfa97bea20529bde7a67db405"><td class="memItemLeft" align="right" valign="top"><a id="af156201cfa97bea20529bde7a67db405"></a>
using </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#af156201cfa97bea20529bde7a67db405">size_type</a> = io_handle::size_type</td></tr>
<tr class="memdesc:af156201cfa97bea20529bde7a67db405"><td class="mdescLeft"> </td><td class="mdescRight">The memory extent type used by this i/o service. <br /></td></tr>
<tr class="separator:af156201cfa97bea20529bde7a67db405"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6f63a89a90f60ad8076dcaedb23c17d8"><td class="memItemLeft" align="right" valign="top"><a id="a6f63a89a90f60ad8076dcaedb23c17d8"></a>
using </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#a6f63a89a90f60ad8076dcaedb23c17d8">buffer_type</a> = <a class="el" href="structllfio__v2__xxx_1_1io__handle_1_1buffer__type.html">io_handle::buffer_type</a></td></tr>
<tr class="memdesc:a6f63a89a90f60ad8076dcaedb23c17d8"><td class="mdescLeft"> </td><td class="mdescRight">The scatter buffer type used by this i/o service. <br /></td></tr>
<tr class="separator:a6f63a89a90f60ad8076dcaedb23c17d8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a46ae106f20af58f24d11cbfc099b874a"><td class="memItemLeft" align="right" valign="top"><a id="a46ae106f20af58f24d11cbfc099b874a"></a>
using </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#a46ae106f20af58f24d11cbfc099b874a">const_buffer_type</a> = <a class="el" href="structllfio__v2__xxx_1_1io__handle_1_1const__buffer__type.html">io_handle::const_buffer_type</a></td></tr>
<tr class="memdesc:a46ae106f20af58f24d11cbfc099b874a"><td class="mdescLeft"> </td><td class="mdescRight">The gather buffer type used by this i/o service. <br /></td></tr>
<tr class="separator:a46ae106f20af58f24d11cbfc099b874a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ac50a0165e9e9093d859a7a57422bc93a"><td class="memItemLeft" align="right" valign="top"><a id="ac50a0165e9e9093d859a7a57422bc93a"></a>
using </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#ac50a0165e9e9093d859a7a57422bc93a">buffers_type</a> = <a class="el" href="classllfio__v2__xxx_1_1io__handle.html#a8f525d9665b524442b46cd55678817ed">io_handle::buffers_type</a></td></tr>
<tr class="memdesc:ac50a0165e9e9093d859a7a57422bc93a"><td class="mdescLeft"> </td><td class="mdescRight">The scatter buffers type used by this i/o service. <br /></td></tr>
<tr class="separator:ac50a0165e9e9093d859a7a57422bc93a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2710d9a96e0aded48977f224b46f14fe"><td class="memItemLeft" align="right" valign="top"><a id="a2710d9a96e0aded48977f224b46f14fe"></a>
using </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#a2710d9a96e0aded48977f224b46f14fe">const_buffers_type</a> = <a class="el" href="classllfio__v2__xxx_1_1io__handle.html#a693a8c64bb7de1a6835d6a151e37aa0e">io_handle::const_buffers_type</a></td></tr>
<tr class="memdesc:a2710d9a96e0aded48977f224b46f14fe"><td class="mdescLeft"> </td><td class="mdescRight">The gather buffers type used by this i/o service. <br /></td></tr>
<tr class="separator:a2710d9a96e0aded48977f224b46f14fe"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0ea83f90b912f0a776aa0a4e657db78e"><td class="memTemplParams" colspan="2"><a id="a0ea83f90b912f0a776aa0a4e657db78e"></a>
template<class T > </td></tr>
<tr class="memitem:a0ea83f90b912f0a776aa0a4e657db78e"><td class="memTemplItemLeft" align="right" valign="top">using </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#a0ea83f90b912f0a776aa0a4e657db78e">io_request</a> = <a class="el" href="structllfio__v2__xxx_1_1io__handle_1_1io__request.html">io_handle::io_request</a>< T ></td></tr>
<tr class="memdesc:a0ea83f90b912f0a776aa0a4e657db78e"><td class="mdescLeft"> </td><td class="mdescRight">The i/o request type used by this i/o service. <br /></td></tr>
<tr class="separator:a0ea83f90b912f0a776aa0a4e657db78e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7db8542d0bb76eb78a40adb48cf9f96e"><td class="memTemplParams" colspan="2"><a id="a7db8542d0bb76eb78a40adb48cf9f96e"></a>
template<class T > </td></tr>
<tr class="memitem:a7db8542d0bb76eb78a40adb48cf9f96e"><td class="memTemplItemLeft" align="right" valign="top">using </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#a7db8542d0bb76eb78a40adb48cf9f96e">io_result</a> = <a class="el" href="structllfio__v2__xxx_1_1io__handle_1_1io__result.html">io_handle::io_result</a>< T ></td></tr>
<tr class="memdesc:a7db8542d0bb76eb78a40adb48cf9f96e"><td class="mdescLeft"> </td><td class="mdescRight">The i/o result type used by this i/o service. <br /></td></tr>
<tr class="separator:a7db8542d0bb76eb78a40adb48cf9f96e"><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:a0b81486e5e967201edc296b102f369c5"><td class="memItemLeft" align="right" valign="top"><a id="a0b81486e5e967201edc296b102f369c5"></a>
void </td><td class="memItemRight" valign="bottom"><b>__post_done</b> (post_info *pi)</td></tr>
<tr class="separator:a0b81486e5e967201edc296b102f369c5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6e1ce022fbbc99e4ee205abe812f3cdc"><td class="memItemLeft" align="right" valign="top"><a id="a6e1ce022fbbc99e4ee205abe812f3cdc"></a>
void </td><td class="memItemRight" valign="bottom"><b>_post_done</b> (post_info *pi)</td></tr>
<tr class="separator:a6e1ce022fbbc99e4ee205abe812f3cdc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6fefd8a0aa3141f9883e1f0b0434ee2e"><td class="memItemLeft" align="right" valign="top"><a id="a6fefd8a0aa3141f9883e1f0b0434ee2e"></a>
void </td><td class="memItemRight" valign="bottom"><b>_work_enqueued</b> (<a class="el" href="classllfio__v2__xxx_1_1io__service.html#af156201cfa97bea20529bde7a67db405">size_type</a> i=1)</td></tr>
<tr class="separator:a6fefd8a0aa3141f9883e1f0b0434ee2e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a60bcd5c5ef80239131759e159b19b902"><td class="memItemLeft" align="right" valign="top"><a id="a60bcd5c5ef80239131759e159b19b902"></a>
void </td><td class="memItemRight" valign="bottom"><b>_work_done</b> ()</td></tr>
<tr class="separator:a60bcd5c5ef80239131759e159b19b902"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6a00c11cd49640dffc2bae95f13b6835"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#a6a00c11cd49640dffc2bae95f13b6835">io_service</a> ()</td></tr>
<tr class="separator:a6a00c11cd49640dffc2bae95f13b6835"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a16a6eef79a26e1cd3596c3843c06569c"><td class="memItemLeft" align="right" valign="top"><a id="a16a6eef79a26e1cd3596c3843c06569c"></a>
 </td><td class="memItemRight" valign="bottom"><b>io_service</b> (<a class="el" href="classllfio__v2__xxx_1_1io__service.html">io_service</a> &&)=delete</td></tr>
<tr class="separator:a16a6eef79a26e1cd3596c3843c06569c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a831051198c060b368b432f6cbded01fe"><td class="memItemLeft" align="right" valign="top"><a id="a831051198c060b368b432f6cbded01fe"></a>
 </td><td class="memItemRight" valign="bottom"><b>io_service</b> (const <a class="el" href="classllfio__v2__xxx_1_1io__service.html">io_service</a> &)=delete</td></tr>
<tr class="separator:a831051198c060b368b432f6cbded01fe"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2c620e39d24645bd5537587e4115a0ce"><td class="memItemLeft" align="right" valign="top"><a id="a2c620e39d24645bd5537587e4115a0ce"></a>
<a class="el" href="classllfio__v2__xxx_1_1io__service.html">io_service</a> & </td><td class="memItemRight" valign="bottom"><b>operator=</b> (<a class="el" href="classllfio__v2__xxx_1_1io__service.html">io_service</a> &&)=delete</td></tr>
<tr class="separator:a2c620e39d24645bd5537587e4115a0ce"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a26687077915f582a7c6473e8342c1df0"><td class="memItemLeft" align="right" valign="top"><a id="a26687077915f582a7c6473e8342c1df0"></a>
<a class="el" href="classllfio__v2__xxx_1_1io__service.html">io_service</a> & </td><td class="memItemRight" valign="bottom"><b>operator=</b> (const <a class="el" href="classllfio__v2__xxx_1_1io__service.html">io_service</a> &)=delete</td></tr>
<tr class="separator:a26687077915f582a7c6473e8342c1df0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ac4c9dfee053976f4dca0b91cd98caabb"><td class="memItemLeft" align="right" valign="top"><a id="ac4c9dfee053976f4dca0b91cd98caabb"></a>
bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#ac4c9dfee053976f4dca0b91cd98caabb">using_kqueues</a> () const noexcept</td></tr>
<tr class="memdesc:ac4c9dfee053976f4dca0b91cd98caabb"><td class="mdescLeft"> </td><td class="mdescRight">True if this i/o service is using BSD kqueues. <br /></td></tr>
<tr class="separator:ac4c9dfee053976f4dca0b91cd98caabb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aee0e77242d19c62eb68d3bef68e9ea0d"><td class="memItemLeft" align="right" valign="top"><a id="aee0e77242d19c62eb68d3bef68e9ea0d"></a>
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#aee0e77242d19c62eb68d3bef68e9ea0d">disable_kqueues</a> ()</td></tr>
<tr class="memdesc:aee0e77242d19c62eb68d3bef68e9ea0d"><td class="mdescLeft"> </td><td class="mdescRight">Force disable any use of BSD kqueues. <br /></td></tr>
<tr class="separator:aee0e77242d19c62eb68d3bef68e9ea0d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a528acb1c8ec8caa06fc084962f974106"><td class="memItemLeft" align="right" valign="top">virtual result< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#a528acb1c8ec8caa06fc084962f974106">run_until</a> (<a class="el" href="structllfio__v2__xxx_1_1deadline.html">deadline</a> d) noexcept</td></tr>
<tr class="separator:a528acb1c8ec8caa06fc084962f974106"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a5719f4f0779047c202d7fb3cda0dcc28"><td class="memItemLeft" align="right" valign="top">result< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#a5719f4f0779047c202d7fb3cda0dcc28">run</a> () noexcept</td></tr>
<tr class="separator:a5719f4f0779047c202d7fb3cda0dcc28"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ac2666a65a3c6453bc9845261ef684565"><td class="memTemplParams" colspan="2">template<class U > </td></tr>
<tr class="memitem:ac2666a65a3c6453bc9845261ef684565"><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#ac2666a65a3c6453bc9845261ef684565">post</a> (U &&f)</td></tr>
<tr class="separator:ac2666a65a3c6453bc9845261ef684565"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr class="memitem:af8573e0ad8a91f3778867c710f30a914"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#af8573e0ad8a91f3778867c710f30a914">interruption_signal</a> () noexcept</td></tr>
<tr class="separator:af8573e0ad8a91f3778867c710f30a914"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aeacd8d21f956903c204ee49c0d3ab195"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="classllfio__v2__xxx_1_1io__service.html#aeacd8d21f956903c204ee49c0d3ab195">set_interruption_signal</a> (int signo=<a class="el" href="io__service_8hpp.html#af5cfb661784f372559747708772b9106">LLFIO_IO_POST_SIGNAL</a>)</td></tr>
<tr class="separator:aeacd8d21f956903c204ee49c0d3ab195"><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:ae39e3934b1eb85ac91f1993c8886d888"><td class="memItemLeft" align="right" valign="top"><a id="ae39e3934b1eb85ac91f1993c8886d888"></a>
class </td><td class="memItemRight" valign="bottom"><b>async_file_handle</b></td></tr>
<tr class="separator:ae39e3934b1eb85ac91f1993c8886d888"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>An asynchronous i/o multiplexer service. </p>
<p>This service is used in conjunction with <code>async_file_handle</code> to multiplex initating i/o and completing it onto a single kernel thread. Unlike the <code>io_service</code> in ASIO or the Networking TS, this <code>io_service</code> is much simpler, in particular it is single threaded per instance only i.e. you must run a separate <code>io_service</code> instance one per kernel thread if you wish to run i/o processing across multiple threads. LLFIO does not do this for you (and for good reason, unlike socket i/o, it is generally unwise to distribute file i/o across kernel threads due to the much more code executable between user space and physical storage i.e. keeping processing per CPU core hot in cache delivers outsize benefits compared to socket i/o).</p>
<p>Furthermore, you cannot use this i/o service in any way from any thread other than where it was created. You cannot call its <code>run()</code> from any thread other than where it was created. And you cannot initiate i/o on an <code>async_file_handle</code> from any thread other than where its owning i/o service was created.</p>
<p>In other words, keep your i/o service and all associated file handles on their owning thread. The sole function you can call from another thread is <code>post()</code> which lets you execute some callback in the <code>run()</code> of the owning thread. This lets you schedule i/o from other threads if you really must do that.</p>
<div class="fragment"><div class="line"> <span class="keyword">namespace </span><a class="code" href="namespacellfio__v2__xxx.html">llfio</a> = <a class="code" href="group__config.html#gac9f7f0153adb9034d26c4554728f817a">LLFIO_V2_NAMESPACE</a>;</div><div class="line"></div><div class="line"> <span class="comment">// Create an i/o service for this thread</span></div><div class="line"> <a class="code" href="classllfio__v2__xxx_1_1io__service.html">llfio::io_service</a> service;</div><div class="line"></div><div class="line"> <span class="comment">// Create an async file i/o handle attached to the i/o service for this thread</span></div><div class="line"> <a class="code" href="classllfio__v2__xxx_1_1async__file__handle.html">llfio::async_file_handle</a> h = <a class="code" href="classllfio__v2__xxx_1_1async__file__handle.html#aa7511a8b300c448a5a0eeaea499e665e">llfio::async_file_handle::async_file</a>(service, {}, <span class="stringliteral">"temp"</span>, <a class="code" href="namespacellfio__v2__xxx.html#a5a8908704c9988bbecc69c2359e6fd4a">llfio::file_handle::mode::write</a>, llfio::file_handle::creation::if_needed, llfio::file_handle::caching::only_metadata, llfio::file_handle::flag::unlink_on_first_close).value();</div><div class="line"></div><div class="line"> <span class="comment">// Truncate to 1Mb</span></div><div class="line"> (void) h.<a class="code" href="classllfio__v2__xxx_1_1file__handle.html#a2be41c54aff8578e2d0afbf4ae73049f">truncate</a>(1024 * 4096);</div><div class="line"></div><div class="line"> <span class="comment">// Launch 8 coroutines, each writing 4Kb of chars 0-8 to every 32Kb block</span></div><div class="line"> <span class="keyword">auto</span> coroutine = [&h](<span class="keywordtype">size_t</span> no) -> llfio::eager<void> {</div><div class="line"> std::vector<llfio::byte, llfio::utils::page_allocator<llfio::byte>> buffer(4096);</div><div class="line"> memset(buffer.data(), (int) (<span class="charliteral">'0'</span> + no), 4096);</div><div class="line"> llfio::async_file_handle::const_buffer_type bt{buffer.data(), buffer.size()};</div><div class="line"> <span class="keywordflow">for</span>(<span class="keywordtype">size_t</span> n = 0; n < 128; n++)</div><div class="line"> {</div><div class="line"> <span class="comment">// This will initiate the i/o, and suspend the coroutine until completion.</span></div><div class="line"> <span class="comment">// The caller will thus resume execution with a valid unsignaled future.</span></div><div class="line"> <span class="keyword">auto</span> written = co_await h.<a class="code" href="classllfio__v2__xxx_1_1async__file__handle.html#a3a7030863cef0cdc5646f18e76a43411">co_write</a>({bt, n * 32768 + no * 4096}).value();</div><div class="line"> written.value();</div><div class="line"> }</div><div class="line"> };</div><div class="line"> std::vector<llfio::eager<void>> coroutines;</div><div class="line"> <span class="keywordflow">for</span>(<span class="keywordtype">size_t</span> n = 0; n < 8; n++)</div><div class="line"> {</div><div class="line"> <span class="comment">// Construct each coroutine, initiating the i/o, then suspending.</span></div><div class="line"> coroutines.push_back(coroutine(n));</div><div class="line"> }</div><div class="line"> <span class="comment">// Pump the i/o, multiplexing the coroutines, until no more work remains.</span></div><div class="line"> <span class="keywordflow">while</span>(service.<a class="code" href="classllfio__v2__xxx_1_1io__service.html#a5719f4f0779047c202d7fb3cda0dcc28">run</a>().value())</div><div class="line"> ;</div></div><!-- fragment --></div><h2 class="groupheader">Constructor & Destructor Documentation</h2>
<a id="a6a00c11cd49640dffc2bae95f13b6835"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a6a00c11cd49640dffc2bae95f13b6835">◆ </a></span>io_service()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">llfio_v2_xxx::io_service::io_service </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Creates an i/o service for the calling thread, installing a global signal handler via set_interruption_signal() if not yet installed if on POSIX and BSD kqueues not in use. </p>
</div>
</div>
<h2 class="groupheader">Member Function Documentation</h2>
<a id="af8573e0ad8a91f3778867c710f30a914"></a>
<h2 class="memtitle"><span class="permalink"><a href="#af8573e0ad8a91f3778867c710f30a914">◆ </a></span>interruption_signal()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static int llfio_v2_xxx::io_service::interruption_signal </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">noexcept</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the signal used for interrupting run_until(). Only used on POSIX when BSD kqueues are not used. Defaults to LLFIO_IO_POST_SIGNAL on platforms which use it.</p>
<dl class="section note"><dt>Note</dt><dd>Only present if LLFIO_IO_POST_SIGNAL is defined. </dd></dl>
</div>
</div>
<a id="ac2666a65a3c6453bc9845261ef684565"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ac2666a65a3c6453bc9845261ef684565">◆ </a></span>post()</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<class U > </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">void llfio_v2_xxx::io_service::post </td>
<td>(</td>
<td class="paramtype">U && </td>
<td class="paramname"><em>f</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Schedule the callable to be invoked by the thread owning this object and executing <code>run()</code> at its next available opportunity. Unlike any other function in this API layer, this function is thread safe. </p>
<div class="fragment"><div class="line"><a name="l00268"></a><span class="lineno"> 268</span> { _post(detail::make_function_ptr<<span class="keywordtype">void</span>(<a class="code" href="classllfio__v2__xxx_1_1io__service.html#a6a00c11cd49640dffc2bae95f13b6835">io_service</a> *)>(std::forward<U>(f))); }</div><div class="ttc" id="classllfio__v2__xxx_1_1io__service_html_a6a00c11cd49640dffc2bae95f13b6835"><div class="ttname"><a href="classllfio__v2__xxx_1_1io__service.html#a6a00c11cd49640dffc2bae95f13b6835">llfio_v2_xxx::io_service::io_service</a></div><div class="ttdeci">io_service()</div></div>
</div><!-- fragment -->
</div>
</div>
<a id="a5719f4f0779047c202d7fb3cda0dcc28"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a5719f4f0779047c202d7fb3cda0dcc28">◆ </a></span>run()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">result<bool> llfio_v2_xxx::io_service::run </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">noexcept</span></span> </td>
</tr>
</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="l00259"></a><span class="lineno"> 259</span> { <span class="keywordflow">return</span> <a class="code" href="classllfio__v2__xxx_1_1io__service.html#a528acb1c8ec8caa06fc084962f974106">run_until</a>(deadline()); }</div><div class="ttc" id="classllfio__v2__xxx_1_1io__service_html_a528acb1c8ec8caa06fc084962f974106"><div class="ttname"><a href="classllfio__v2__xxx_1_1io__service.html#a528acb1c8ec8caa06fc084962f974106">llfio_v2_xxx::io_service::run_until</a></div><div class="ttdeci">virtual result< bool > run_until(deadline d) noexcept</div></div>
</div><!-- fragment -->
</div>
</div>
<a id="a528acb1c8ec8caa06fc084962f974106"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a528acb1c8ec8caa06fc084962f974106">◆ </a></span>run_until()</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::io_service::run_until </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structllfio__v2__xxx_1_1deadline.html">deadline</a> </td>
<td class="paramname"><em>d</em></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> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Runs the i/o service for the thread owning this i/o service. Returns true if more work remains and we just handled an i/o or post; false if there is no more work; <code>errc::timed_out</code> if the deadline passed; <code>errc::operation_not_supported</code> if you try to call it from a non-owning thread; <code>errc::invalid_argument</code> if deadline is invalid. </p>
</div>
</div>
<a id="aeacd8d21f956903c204ee49c0d3ab195"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aeacd8d21f956903c204ee49c0d3ab195">◆ </a></span>set_interruption_signal()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static int llfio_v2_xxx::io_service::set_interruption_signal </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>signo</em> = <code><a class="el" href="io__service_8hpp.html#af5cfb661784f372559747708772b9106">LLFIO_IO_POST_SIGNAL</a></code></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Sets the signal used for interrupting run_until(), returning the former signal setting. Only used on POSIX when BSD kqueues are not used. Special values are 0 for deinstall global signal handler, and -1 for install to first unused signal between SIGRTMIN and SIGRTMAX. Changing this while any io_service instances exist is a bad idea.</p>
<dl class="section note"><dt>Note</dt><dd>Only present if LLFIO_IO_POST_SIGNAL is defined. </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>include/llfio/v2.0/<a class="el" href="io__service_8hpp.html">io_service.hpp</a></li>
</ul>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- 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="classllfio__v2__xxx_1_1io__service.html">io_service</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.13 </li>
</ul>
</div>
</body>
</html>
|
