/usr/share/gtk-doc/html/farstream-plugins-0.1/farstream-plugins-FsShmStreamTransmitter.html is in libfarstream-0.1-doc 0.1.2-0ubuntu1.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>FsShmStreamTransmitter</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="Farstream Plugins Manual">
<link rel="up" href="pt02.html" title="Part II. Transmitters">
<link rel="prev" href="farstream-plugins-FsNiceStreamTransmitter.html" title="FsNiceStreamTransmitter">
<link rel="next" href="pt03.html" title="Part III. Utility elements">
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="farstream-plugins-FsNiceStreamTransmitter.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="pt02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Farstream Plugins Manual</th>
<td><a accesskey="n" href="pt03.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#farstream-plugins-FsShmStreamTransmitter.synopsis" class="shortcut">Top</a>
|
<a href="#farstream-plugins-FsShmStreamTransmitter.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="farstream-plugins-FsShmStreamTransmitter"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="farstream-plugins-FsShmStreamTransmitter.top_of_page"></a>FsShmStreamTransmitter</span></h2>
<p>FsShmStreamTransmitter — A stream transmitter object for Shared Memory</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="farstream-plugins-FsShmStreamTransmitter.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis"> <a class="link" href="farstream-plugins-FsShmStreamTransmitter.html#FsShmStreamTransmitter" title="FsShmStreamTransmitter">FsShmStreamTransmitter</a>;
</pre>
</div>
<div class="refsect1">
<a name="farstream-plugins-FsShmStreamTransmitter.description"></a><h2>Description</h2>
<p>
The name of this transmitter is "shm".
</p>
<p>
This transmitter is meant to send and received the data from another process
on the same system while minimizing the memory pressure associated with the
use of sockets.
</p>
<p>
Two sockets are used to control the shared memory areas. One is used to
send data and one to receive data. The receiver always connects to the
sender. The sender socket must exist before the receiver connects to it.
</p>
<p>
Negotiating the paths of the sockets can happen in two ways. If the
create-local-candidates is True then the transmitter will generate the
path of the local candidate and us it as the ip filed in <a href="../farstream-libs-0.10/farstream-libs-FsCandidate.html#FsCandidate"><span class="type">FsCandidate</span></a>. The
transmitter will expect the path of the applications sender socket to be in
the "ip" field of the remote candidates <a href="../farstream-libs-0.10/farstream-libs-FsCandidate.html#FsCandidate"><span class="type">FsCandidate</span></a> as well.
</p>
<p>
Or alternatively, if create-local-candidates is false then
the sender socket can be created by giving the transmitter a candidate
with the path of the socket in the "ip" field of the <a href="../farstream-libs-0.10/farstream-libs-FsCandidate.html#FsCandidate"><span class="type">FsCandidate</span></a>. This
<a href="../farstream-libs-0.10/farstream-libs-FsCandidate.html#FsCandidate"><span class="type">FsCandidate</span></a> can be given to the <a href="../farstream-libs-0.10/FsStreamTransmitter.html"><span class="type">FsStreamTransmitter</span></a> in two ways, either
by setting the <a href="../farstream-libs-0.10/FsStreamTransmitter.html#FsStreamTransmitter--preferred-local-candidates"><span class="type">"preferred-local-candidates"</span></a> property
or by calling the <a href="../farstream-libs-0.10/FsStreamTransmitter.html#fs-stream-transmitter-force-remote-candidates"><code class="function">fs_stream_transmitter_force_remote_candidates()</code></a> function.
There can be only one single send socket per stream. When the send socket
is ready to be connected to, <a href="../farstream-libs-0.10/FsStreamTransmitter.html#FsStreamTransmitter-new-local-candidate"><span class="type">"new-local-candidate"</span></a> signal
will be emitted.
</p>
<p>
To connect the receive side to the other application, one must create a
<a href="../farstream-libs-0.10/farstream-libs-FsCandidate.html#FsCandidate"><span class="type">FsCandidate</span></a> with the path of the sender's socket in the "username" field.
If the receiver can not connect to the sender,
the <a href="../farstream-libs-0.10/FsStreamTransmitter.html#fs-stream-transmitter-force-remote-candidates"><code class="function">fs_stream_transmitter_force_remote_candidates()</code></a> call will fail.
</p>
</div>
<div class="refsect1">
<a name="farstream-plugins-FsShmStreamTransmitter.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="FsShmStreamTransmitter"></a><h3>FsShmStreamTransmitter</h3>
<pre class="programlisting">typedef struct _FsShmStreamTransmitter FsShmStreamTransmitter;</pre>
<p>
All members are private, access them using methods and properties
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody></tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.18.1</div>
</body>
</html>
|