/usr/share/libdashel/docs/html/index.html is in libdashel-dev 1.3.3-5.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <!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.11"/>
<title>dashel: Dashel</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="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">dashel
 <span id="projectnumber">1.3.3</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.11 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li class="current"><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title"><a class="el" href="namespaceDashel.html" title="Dashel, a cross-platform stream abstraction library. ">Dashel</a> </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p><a href="https://github.com/aseba-community/dashel">github.com/aseba-community/dashel</a></p>
<h1><a class="anchor" id="IntroSec"></a>
Introduction</h1>
<p><a class="el" href="namespaceDashel.html" title="Dashel, a cross-platform stream abstraction library. ">Dashel</a> is a cross-platform data stream helper encapsulation library. It provides a unified access to TCP/UDP sockets, serial ports, console, and files streams. It also allows a server application to wait for any activity on any combination of these streams.</p>
<p><a class="el" href="namespaceDashel.html" title="Dashel, a cross-platform stream abstraction library. ">Dashel</a> was originally designed by <a href="http://stephane.magnenat.net">Stéphane Magnenat</a> and Sebastian Gerlach. A full list of contributors is available in the <a href="https://github.com/aseba-community/dashel/blob/master/readme.md">README file</a>. <a class="el" href="namespaceDashel.html" title="Dashel, a cross-platform stream abstraction library. ">Dashel</a> is licensed under a <a href="http://en.wikipedia.org/wiki/BSD_licenses">modified BSD open-source license</a>. Source code, compilation instructions, authors and license information are available on <a href="https://github.com/aseba-community/dashel">github</a>. Feel free to <a href="https://github.com/aseba-community/dashel/issues/new">report bugs</a>, fork <a class="el" href="namespaceDashel.html" title="Dashel, a cross-platform stream abstraction library. ">Dashel</a> and submit <a href="https://github.com/aseba-community/dashel/pulls">pull requests</a>.</p>
<h1><a class="anchor" id="Usage"></a>
Usage</h1>
<p>To use <a class="el" href="namespaceDashel.html" title="Dashel, a cross-platform stream abstraction library. ">Dashel</a>, you have to instantiate a <a class="el" href="classDashel_1_1Hub.html" title="The central place where to create, destroy, and synchronize streams. ">Dashel::Hub</a>. The Hub is your connection with the data streams. It is the place where you create, destroy, and synchronize them.</p>
<p>The <a href="https://github.com/aseba-community/dashel/tree/master/examples"><code>example</code> directory</a> in <a class="el" href="namespaceDashel.html" title="Dashel, a cross-platform stream abstraction library. ">Dashel</a> distribution provides several working examples that you can read to learn to use <a class="el" href="namespaceDashel.html" title="Dashel, a cross-platform stream abstraction library. ">Dashel</a>.</p>
<h1><a class="anchor" id="TargetNamingSec"></a>
Targets naming</h1>
<p>In <a class="el" href="namespaceDashel.html" title="Dashel, a cross-platform stream abstraction library. ">Dashel</a>, streams connect to targets. A target is a string that describes a file, a TCP/UDP address/port, or a serial port. This string consists of the type of the target, a colon, followed by a semicolon separated list of parameters. This list contains key-values pairs, with a predifined order such that keys can be omitted (but if a key is present, all subsequent entries must have an explicit key). Its general syntax is thus <code>"protocol:[param1key=]param1value;...;[paramNkey=]paramNvalue"</code>.</p>
<p>The following protocols are available: </p><ul>
<li><code>file</code> : local files </li>
<li><code>tcp</code> : TCP/IP client </li>
<li><code>tcpin</code> : TCP/IP server </li>
<li><code>tcppoll</code> : TCP/IP polling </li>
<li><code>udp</code> : UDP/IP </li>
<li><code>ser</code> : serial port </li>
<li><code>stdin</code> : standard input </li>
<li><code>stdout</code> : standard output</li>
</ul>
<p>The file protocol accepts the following parameters, in this implicit order: </p><ul>
<li><code>name</code> : name of the file, including the path </li>
<li><code>mode</code> : mode (read, write)</li>
</ul>
<p>The tcp protocol accepts the following parameters, in this implicit order: </p><ul>
<li><code>host</code> : remote host </li>
<li><code>port</code> : remote port </li>
<li><code>socket</code> : local socket; if a nonegative value is given, host and port are ignored</li>
</ul>
<p>The tcpin protocol accepts the following parameters, in this implicit order: </p><ul>
<li><code>port</code> : port </li>
<li><code>address</code> : if the computer possesses multiple network addresses, the one to listen on, default 0.0.0.0 (any)</li>
</ul>
<p>The tcppoll protocol accepts the following parameters, in this implicit order: </p><ul>
<li><code>host</code> : remote host </li>
<li><code>port</code> : remote port </li>
<li><code>socket</code> : local socket; if a nonegative value is given, host and port are ignored</li>
</ul>
<p>The udp protocol accepts the following parameters, in this implicit order: </p><ul>
<li><code>port</code> : port </li>
<li><code>address</code> : if the computer possesses multiple network addresses, the one to connect to, default 0.0.0.0 (any)</li>
</ul>
<p>The ser protocol accepts the following parameters, in this implicit order: </p><ul>
<li><code>device</code> : serial port device name, system specific; either port or device must be given, device has priority if both are given. </li>
<li><code>name</code> : select the port by matching part of the serial port "user-friendly" description. The match is case-sensitive. Works on Linux and Windows (note: on Linux, this feature requires libudev). </li>
<li><code>port</code> : serial port number, starting from 1, default 1 </li>
<li><code>baud</code> : baud rate, default 115200 </li>
<li><code>stop</code> : stop bits count (1 or 2), default 1 </li>
<li><code>parity</code> : parity type (none, even, odd), default none </li>
<li><code>fc</code> : flow control type, (none, hard), default none </li>
<li><code>bits</code> : number of bits per character, default 8 </li>
<li><code>dtr</code> : whether DTR line is enabled, default true Note that either device, name (on supported platforms), or port must be given. If more than one is given, device has priority, then name, and port has the lowest priority.</li>
</ul>
<p>Protocols <code>stdin</code> and <code>stdout</code> do not take any parameter. </p>
</div></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.11
</small></address>
</body>
</html>
|