~ubuntu-branches/ubuntu/precise/zeromq/precise

« back to all changes in this revision

Viewing changes to doc/zmq_epgm.html

  • Committer: Bazaar Package Importer
  • Author(s): Martin Lucina
  • Date: 2011-05-13 12:43:09 UTC
  • mfrom: (7.2.1 sid)
  • Revision ID: james.westby@ubuntu.com-20110513124309-m3gdt964ga67rcwu
Tags: 2.1.7-1
* New upstream version. (closes: #619374)
* --with-system-pgm is now used instead of the embedded OpenPGM library. 
* Added Debian watch file.

Show diffs side-by-side

added added

removed removed

Lines of Context:
594
594
<div class="paragraph"><p>The <em>pgm</em> and <em>epgm</em> transports can only be used with the <em>ZMQ_PUB</em> and
595
595
<em>ZMQ_SUB</em> socket types.</p></div>
596
596
<div class="paragraph"><p>Further, PGM sockets are rate limited by default and incur a performance
597
 
penalty when used over a loopback interface. For details, refer to the
 
597
penalty when used over a loop-back interface. For details, refer to the
598
598
<em>ZMQ_RATE</em>, <em>ZMQ_RECOVERY_IVL</em> and <em>ZMQ_MCAST_LOOP</em> options documented in
599
599
<a href="zmq_setsockopt.html">zmq_setsockopt(3)</a>.</p></div>
600
600
<div class="admonitionblock">
653
653
</div>
654
654
<h2 id="_wire_format">WIRE FORMAT</h2>
655
655
<div class="sectionbody">
656
 
<div class="paragraph"><p>Consecutive PGM datagrams are interpreted by ØMQ as a single continous stream
 
656
<div class="paragraph"><p>Consecutive PGM datagrams are interpreted by ØMQ as a single continuous stream
657
657
of data where ØMQ messages are not necessarily aligned with PGM datagram
658
658
boundaries and a single ØMQ message may span several PGM datagrams. This stream
659
659
of data consists of ØMQ messages encapsulated in <em>frames</em> as described in
672
672
order specifying either the offset of the first message <em>frame</em> in the datagram
673
673
or containing the value <tt>0xFFFF</tt> if the datagram contains solely an
674
674
intermediate part of a larger message.</p></div>
 
675
<div class="paragraph"><p>Note that offset specifies where the first message begins rather than the first
 
676
message part. Thus, if there are trailing message parts at the beginning of
 
677
the packet the offset ignores them and points to first initial message part
 
678
in the packet.</p></div>
675
679
<div class="paragraph"><p>The following diagram illustrates the layout of a single PGM datagram payload:</p></div>
676
680
<div class="literalblock">
677
681
<div class="content">
708
712
<div class="title">Connecting a socket</div>
709
713
<div class="content">
710
714
<pre><tt>/* Connecting to the multicast address 239.192.1.1, port 5555, */
711
 
/* using the first ethernet network interface on Linux */
 
715
/* using the first Ethernet network interface on Linux */
712
716
/* and the Encapsulated PGM protocol */
713
717
rc = zmq_connect(socket, "epgm://eth0;239.192.1.1:5555");
714
718
assert (rc == 0);
730
734
</div>
731
735
<h2 id="_authors">AUTHORS</h2>
732
736
<div class="sectionbody">
733
 
<div class="paragraph"><p>The ØMQ documentation was written by Martin Sustrik &lt;<a href="mailto:sustrik@250bpm.com">sustrik@250bpm.com</a>&gt; and
 
737
<div class="paragraph"><p>This ØMQ manual page was written by Martin Sustrik &lt;<a href="mailto:sustrik@250bpm.com">sustrik@250bpm.com</a>&gt; and
734
738
Martin Lucina &lt;<a href="mailto:mato@kotelna.sk">mato@kotelna.sk</a>&gt;.</p></div>
735
739
</div>
736
740
</div>
737
741
<div id="footnotes"><hr /></div>
738
742
<div id="footer">
739
743
<div id="footer-text">
740
 
ØMQ 2.0.10<br />
741
 
Last updated 2010-10-15 19:26:37 CEST
 
744
ØMQ 2.1.5<br />
 
745
Last updated 2011-04-16 10:29:20 CEST
742
746
</div>
743
747
</div>
744
748
</body>