Imported Upstream version 1.57.0
[platform/upstream/boost.git] / doc / html / boost_asio / reference / stream_socket_service.html
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
4 <title>stream_socket_service</title>
5 <link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7 <link rel="home" href="../../boost_asio.html" title="Boost.Asio">
8 <link rel="up" href="../reference.html" title="Reference">
9 <link rel="prev" href="strand.html" title="strand">
10 <link rel="next" href="stream_socket_service/assign.html" title="stream_socket_service::assign">
11 </head>
12 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
13 <table cellpadding="2" width="100%"><tr>
14 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
15 <td align="center"><a href="../../../../index.html">Home</a></td>
16 <td align="center"><a href="../../../../libs/libraries.htm">Libraries</a></td>
17 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
18 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
19 <td align="center"><a href="../../../../more/index.htm">More</a></td>
20 </tr></table>
21 <hr>
22 <div class="spirit-nav">
23 <a accesskey="p" href="strand.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../boost_asio.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="stream_socket_service/assign.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
24 </div>
25 <div class="section">
26 <div class="titlepage"><div><div><h3 class="title">
27 <a name="boost_asio.reference.stream_socket_service"></a><a class="link" href="stream_socket_service.html" title="stream_socket_service">stream_socket_service</a>
28 </h3></div></div></div>
29 <p>
30         Default service implementation for a stream socket.
31       </p>
32 <pre class="programlisting"><span class="keyword">template</span><span class="special">&lt;</span>
33     <span class="keyword">typename</span> <a class="link" href="Protocol.html" title="Protocol requirements">Protocol</a><span class="special">&gt;</span>
34 <span class="keyword">class</span> <span class="identifier">stream_socket_service</span> <span class="special">:</span>
35   <span class="keyword">public</span> <span class="identifier">io_service</span><span class="special">::</span><span class="identifier">service</span>
36 </pre>
37 <h5>
38 <a name="boost_asio.reference.stream_socket_service.h0"></a>
39         <span class="phrase"><a name="boost_asio.reference.stream_socket_service.types"></a></span><a class="link" href="stream_socket_service.html#boost_asio.reference.stream_socket_service.types">Types</a>
40       </h5>
41 <div class="informaltable"><table class="table">
42 <colgroup>
43 <col>
44 <col>
45 </colgroup>
46 <thead><tr>
47 <th>
48                 <p>
49                   Name
50                 </p>
51               </th>
52 <th>
53                 <p>
54                   Description
55                 </p>
56               </th>
57 </tr></thead>
58 <tbody>
59 <tr>
60 <td>
61                 <p>
62                   <a class="link" href="stream_socket_service/endpoint_type.html" title="stream_socket_service::endpoint_type"><span class="bold"><strong>endpoint_type</strong></span></a>
63                 </p>
64               </td>
65 <td>
66                 <p>
67                   The endpoint type.
68                 </p>
69               </td>
70 </tr>
71 <tr>
72 <td>
73                 <p>
74                   <a class="link" href="stream_socket_service/implementation_type.html" title="stream_socket_service::implementation_type"><span class="bold"><strong>implementation_type</strong></span></a>
75                 </p>
76               </td>
77 <td>
78                 <p>
79                   The type of a stream socket implementation.
80                 </p>
81               </td>
82 </tr>
83 <tr>
84 <td>
85                 <p>
86                   <a class="link" href="stream_socket_service/native_handle_type.html" title="stream_socket_service::native_handle_type"><span class="bold"><strong>native_handle_type</strong></span></a>
87                 </p>
88               </td>
89 <td>
90                 <p>
91                   The native socket type.
92                 </p>
93               </td>
94 </tr>
95 <tr>
96 <td>
97                 <p>
98                   <a class="link" href="stream_socket_service/native_type.html" title="stream_socket_service::native_type"><span class="bold"><strong>native_type</strong></span></a>
99                 </p>
100               </td>
101 <td>
102                 <p>
103                   (Deprecated: Use native_handle_type.) The native socket type.
104                 </p>
105               </td>
106 </tr>
107 <tr>
108 <td>
109                 <p>
110                   <a class="link" href="stream_socket_service/protocol_type.html" title="stream_socket_service::protocol_type"><span class="bold"><strong>protocol_type</strong></span></a>
111                 </p>
112               </td>
113 <td>
114                 <p>
115                   The protocol type.
116                 </p>
117               </td>
118 </tr>
119 </tbody>
120 </table></div>
121 <h5>
122 <a name="boost_asio.reference.stream_socket_service.h1"></a>
123         <span class="phrase"><a name="boost_asio.reference.stream_socket_service.member_functions"></a></span><a class="link" href="stream_socket_service.html#boost_asio.reference.stream_socket_service.member_functions">Member
124         Functions</a>
125       </h5>
126 <div class="informaltable"><table class="table">
127 <colgroup>
128 <col>
129 <col>
130 </colgroup>
131 <thead><tr>
132 <th>
133                 <p>
134                   Name
135                 </p>
136               </th>
137 <th>
138                 <p>
139                   Description
140                 </p>
141               </th>
142 </tr></thead>
143 <tbody>
144 <tr>
145 <td>
146                 <p>
147                   <a class="link" href="stream_socket_service/assign.html" title="stream_socket_service::assign"><span class="bold"><strong>assign</strong></span></a>
148                 </p>
149               </td>
150 <td>
151                 <p>
152                   Assign an existing native socket to a stream socket.
153                 </p>
154               </td>
155 </tr>
156 <tr>
157 <td>
158                 <p>
159                   <a class="link" href="stream_socket_service/async_connect.html" title="stream_socket_service::async_connect"><span class="bold"><strong>async_connect</strong></span></a>
160                 </p>
161               </td>
162 <td>
163                 <p>
164                   Start an asynchronous connect.
165                 </p>
166               </td>
167 </tr>
168 <tr>
169 <td>
170                 <p>
171                   <a class="link" href="stream_socket_service/async_receive.html" title="stream_socket_service::async_receive"><span class="bold"><strong>async_receive</strong></span></a>
172                 </p>
173               </td>
174 <td>
175                 <p>
176                   Start an asynchronous receive.
177                 </p>
178               </td>
179 </tr>
180 <tr>
181 <td>
182                 <p>
183                   <a class="link" href="stream_socket_service/async_send.html" title="stream_socket_service::async_send"><span class="bold"><strong>async_send</strong></span></a>
184                 </p>
185               </td>
186 <td>
187                 <p>
188                   Start an asynchronous send.
189                 </p>
190               </td>
191 </tr>
192 <tr>
193 <td>
194                 <p>
195                   <a class="link" href="stream_socket_service/at_mark.html" title="stream_socket_service::at_mark"><span class="bold"><strong>at_mark</strong></span></a>
196                 </p>
197               </td>
198 <td>
199                 <p>
200                   Determine whether the socket is at the out-of-band data mark.
201                 </p>
202               </td>
203 </tr>
204 <tr>
205 <td>
206                 <p>
207                   <a class="link" href="stream_socket_service/available.html" title="stream_socket_service::available"><span class="bold"><strong>available</strong></span></a>
208                 </p>
209               </td>
210 <td>
211                 <p>
212                   Determine the number of bytes available for reading.
213                 </p>
214               </td>
215 </tr>
216 <tr>
217 <td>
218                 <p>
219                   <a class="link" href="stream_socket_service/bind.html" title="stream_socket_service::bind"><span class="bold"><strong>bind</strong></span></a>
220                 </p>
221               </td>
222 <td>
223                 <p>
224                   Bind the stream socket to the specified local endpoint.
225                 </p>
226               </td>
227 </tr>
228 <tr>
229 <td>
230                 <p>
231                   <a class="link" href="stream_socket_service/cancel.html" title="stream_socket_service::cancel"><span class="bold"><strong>cancel</strong></span></a>
232                 </p>
233               </td>
234 <td>
235                 <p>
236                   Cancel all asynchronous operations associated with the socket.
237                 </p>
238               </td>
239 </tr>
240 <tr>
241 <td>
242                 <p>
243                   <a class="link" href="stream_socket_service/close.html" title="stream_socket_service::close"><span class="bold"><strong>close</strong></span></a>
244                 </p>
245               </td>
246 <td>
247                 <p>
248                   Close a stream socket implementation.
249                 </p>
250               </td>
251 </tr>
252 <tr>
253 <td>
254                 <p>
255                   <a class="link" href="stream_socket_service/connect.html" title="stream_socket_service::connect"><span class="bold"><strong>connect</strong></span></a>
256                 </p>
257               </td>
258 <td>
259                 <p>
260                   Connect the stream socket to the specified endpoint.
261                 </p>
262               </td>
263 </tr>
264 <tr>
265 <td>
266                 <p>
267                   <a class="link" href="stream_socket_service/construct.html" title="stream_socket_service::construct"><span class="bold"><strong>construct</strong></span></a>
268                 </p>
269               </td>
270 <td>
271                 <p>
272                   Construct a new stream socket implementation.
273                 </p>
274               </td>
275 </tr>
276 <tr>
277 <td>
278                 <p>
279                   <a class="link" href="stream_socket_service/converting_move_construct.html" title="stream_socket_service::converting_move_construct"><span class="bold"><strong>converting_move_construct</strong></span></a>
280                 </p>
281               </td>
282 <td>
283                 <p>
284                   Move-construct a new stream socket implementation from another
285                   protocol type.
286                 </p>
287               </td>
288 </tr>
289 <tr>
290 <td>
291                 <p>
292                   <a class="link" href="stream_socket_service/destroy.html" title="stream_socket_service::destroy"><span class="bold"><strong>destroy</strong></span></a>
293                 </p>
294               </td>
295 <td>
296                 <p>
297                   Destroy a stream socket implementation.
298                 </p>
299               </td>
300 </tr>
301 <tr>
302 <td>
303                 <p>
304                   <a class="link" href="stream_socket_service/get_io_service.html" title="stream_socket_service::get_io_service"><span class="bold"><strong>get_io_service</strong></span></a>
305                 </p>
306               </td>
307 <td>
308                 <p>
309                   Get the io_service object that owns the service.
310                 </p>
311               </td>
312 </tr>
313 <tr>
314 <td>
315                 <p>
316                   <a class="link" href="stream_socket_service/get_option.html" title="stream_socket_service::get_option"><span class="bold"><strong>get_option</strong></span></a>
317                 </p>
318               </td>
319 <td>
320                 <p>
321                   Get a socket option.
322                 </p>
323               </td>
324 </tr>
325 <tr>
326 <td>
327                 <p>
328                   <a class="link" href="stream_socket_service/io_control.html" title="stream_socket_service::io_control"><span class="bold"><strong>io_control</strong></span></a>
329                 </p>
330               </td>
331 <td>
332                 <p>
333                   Perform an IO control command on the socket.
334                 </p>
335               </td>
336 </tr>
337 <tr>
338 <td>
339                 <p>
340                   <a class="link" href="stream_socket_service/is_open.html" title="stream_socket_service::is_open"><span class="bold"><strong>is_open</strong></span></a>
341                 </p>
342               </td>
343 <td>
344                 <p>
345                   Determine whether the socket is open.
346                 </p>
347               </td>
348 </tr>
349 <tr>
350 <td>
351                 <p>
352                   <a class="link" href="stream_socket_service/local_endpoint.html" title="stream_socket_service::local_endpoint"><span class="bold"><strong>local_endpoint</strong></span></a>
353                 </p>
354               </td>
355 <td>
356                 <p>
357                   Get the local endpoint.
358                 </p>
359               </td>
360 </tr>
361 <tr>
362 <td>
363                 <p>
364                   <a class="link" href="stream_socket_service/move_assign.html" title="stream_socket_service::move_assign"><span class="bold"><strong>move_assign</strong></span></a>
365                 </p>
366               </td>
367 <td>
368                 <p>
369                   Move-assign from another stream socket implementation.
370                 </p>
371               </td>
372 </tr>
373 <tr>
374 <td>
375                 <p>
376                   <a class="link" href="stream_socket_service/move_construct.html" title="stream_socket_service::move_construct"><span class="bold"><strong>move_construct</strong></span></a>
377                 </p>
378               </td>
379 <td>
380                 <p>
381                   Move-construct a new stream socket implementation.
382                 </p>
383               </td>
384 </tr>
385 <tr>
386 <td>
387                 <p>
388                   <a class="link" href="stream_socket_service/native.html" title="stream_socket_service::native"><span class="bold"><strong>native</strong></span></a>
389                 </p>
390               </td>
391 <td>
392                 <p>
393                   (Deprecated: Use native_handle().) Get the native socket implementation.
394                 </p>
395               </td>
396 </tr>
397 <tr>
398 <td>
399                 <p>
400                   <a class="link" href="stream_socket_service/native_handle.html" title="stream_socket_service::native_handle"><span class="bold"><strong>native_handle</strong></span></a>
401                 </p>
402               </td>
403 <td>
404                 <p>
405                   Get the native socket implementation.
406                 </p>
407               </td>
408 </tr>
409 <tr>
410 <td>
411                 <p>
412                   <a class="link" href="stream_socket_service/native_non_blocking.html" title="stream_socket_service::native_non_blocking"><span class="bold"><strong>native_non_blocking</strong></span></a>
413                 </p>
414               </td>
415 <td>
416                 <p>
417                   Gets the non-blocking mode of the native socket implementation.
418                 </p>
419                 <p>
420                   Sets the non-blocking mode of the native socket implementation.
421                 </p>
422               </td>
423 </tr>
424 <tr>
425 <td>
426                 <p>
427                   <a class="link" href="stream_socket_service/non_blocking.html" title="stream_socket_service::non_blocking"><span class="bold"><strong>non_blocking</strong></span></a>
428                 </p>
429               </td>
430 <td>
431                 <p>
432                   Gets the non-blocking mode of the socket.
433                 </p>
434                 <p>
435                   Sets the non-blocking mode of the socket.
436                 </p>
437               </td>
438 </tr>
439 <tr>
440 <td>
441                 <p>
442                   <a class="link" href="stream_socket_service/open.html" title="stream_socket_service::open"><span class="bold"><strong>open</strong></span></a>
443                 </p>
444               </td>
445 <td>
446                 <p>
447                   Open a stream socket.
448                 </p>
449               </td>
450 </tr>
451 <tr>
452 <td>
453                 <p>
454                   <a class="link" href="stream_socket_service/receive.html" title="stream_socket_service::receive"><span class="bold"><strong>receive</strong></span></a>
455                 </p>
456               </td>
457 <td>
458                 <p>
459                   Receive some data from the peer.
460                 </p>
461               </td>
462 </tr>
463 <tr>
464 <td>
465                 <p>
466                   <a class="link" href="stream_socket_service/remote_endpoint.html" title="stream_socket_service::remote_endpoint"><span class="bold"><strong>remote_endpoint</strong></span></a>
467                 </p>
468               </td>
469 <td>
470                 <p>
471                   Get the remote endpoint.
472                 </p>
473               </td>
474 </tr>
475 <tr>
476 <td>
477                 <p>
478                   <a class="link" href="stream_socket_service/send.html" title="stream_socket_service::send"><span class="bold"><strong>send</strong></span></a>
479                 </p>
480               </td>
481 <td>
482                 <p>
483                   Send the given data to the peer.
484                 </p>
485               </td>
486 </tr>
487 <tr>
488 <td>
489                 <p>
490                   <a class="link" href="stream_socket_service/set_option.html" title="stream_socket_service::set_option"><span class="bold"><strong>set_option</strong></span></a>
491                 </p>
492               </td>
493 <td>
494                 <p>
495                   Set a socket option.
496                 </p>
497               </td>
498 </tr>
499 <tr>
500 <td>
501                 <p>
502                   <a class="link" href="stream_socket_service/shutdown.html" title="stream_socket_service::shutdown"><span class="bold"><strong>shutdown</strong></span></a>
503                 </p>
504               </td>
505 <td>
506                 <p>
507                   Disable sends or receives on the socket.
508                 </p>
509               </td>
510 </tr>
511 <tr>
512 <td>
513                 <p>
514                   <a class="link" href="stream_socket_service/stream_socket_service.html" title="stream_socket_service::stream_socket_service"><span class="bold"><strong>stream_socket_service</strong></span></a>
515                 </p>
516               </td>
517 <td>
518                 <p>
519                   Construct a new stream socket service for the specified io_service.
520                 </p>
521               </td>
522 </tr>
523 </tbody>
524 </table></div>
525 <h5>
526 <a name="boost_asio.reference.stream_socket_service.h2"></a>
527         <span class="phrase"><a name="boost_asio.reference.stream_socket_service.data_members"></a></span><a class="link" href="stream_socket_service.html#boost_asio.reference.stream_socket_service.data_members">Data Members</a>
528       </h5>
529 <div class="informaltable"><table class="table">
530 <colgroup>
531 <col>
532 <col>
533 </colgroup>
534 <thead><tr>
535 <th>
536                 <p>
537                   Name
538                 </p>
539               </th>
540 <th>
541                 <p>
542                   Description
543                 </p>
544               </th>
545 </tr></thead>
546 <tbody><tr>
547 <td>
548                 <p>
549                   <a class="link" href="stream_socket_service/id.html" title="stream_socket_service::id"><span class="bold"><strong>id</strong></span></a>
550                 </p>
551               </td>
552 <td>
553                 <p>
554                   The unique service identifier.
555                 </p>
556               </td>
557 </tr></tbody>
558 </table></div>
559 <h5>
560 <a name="boost_asio.reference.stream_socket_service.h3"></a>
561         <span class="phrase"><a name="boost_asio.reference.stream_socket_service.requirements"></a></span><a class="link" href="stream_socket_service.html#boost_asio.reference.stream_socket_service.requirements">Requirements</a>
562       </h5>
563 <p>
564         <span class="emphasis"><em>Header: </em></span><code class="literal">boost/asio/stream_socket_service.hpp</code>
565       </p>
566 <p>
567         <span class="emphasis"><em>Convenience header: </em></span><code class="literal">boost/asio.hpp</code>
568       </p>
569 </div>
570 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
571 <td align="left"></td>
572 <td align="right"><div class="copyright-footer">Copyright &#169; 2003-2014 Christopher M. Kohlhoff<p>
573         Distributed under the Boost Software License, Version 1.0. (See accompanying
574         file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
575       </p>
576 </div></td>
577 </tr></table>
578 <hr>
579 <div class="spirit-nav">
580 <a accesskey="p" href="strand.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../boost_asio.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="stream_socket_service/assign.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
581 </div>
582 </body>
583 </html>