From 978e33ba253a997b41b331b449b474a5cee7bccc Mon Sep 17 00:00:00 2001 From: Martin Lucina <martin@lucina.net> Date: Mon, 23 Jan 2012 08:54:31 +0100 Subject: Imported Upstream version 2.1.10 --- doc/zmq_setsockopt.html | 188 +++++++++++++++++++++--------------------------- 1 file changed, 81 insertions(+), 107 deletions(-) (limited to 'doc/zmq_setsockopt.html') diff --git a/doc/zmq_setsockopt.html b/doc/zmq_setsockopt.html index 6686dc3..d3b17ca 100644 --- a/doc/zmq_setsockopt.html +++ b/doc/zmq_setsockopt.html @@ -2,28 +2,15 @@ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> -<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 8.6.3" /> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> +<meta name="generator" content="AsciiDoc 8.5.2" /> <title>zmq_setsockopt(3)</title> <style type="text/css"> -/* Sans-serif font. */ -h1, h2, h3, h4, h5, h6, -div.title, caption.title, -thead, p.table.header, -div#toctitle, -span#author, span#revnumber, span#revdate, span#revremark, -div#footer { - font-family: Arial,Helvetica,sans-serif; -} - -/* Serif font. */ -div.sectionbody { - font-family: Georgia,"Times New Roman",Times,serif; -} - -/* Monospace font. */ -tt { - font-size: inherit; +/* Debug borders */ +p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { +/* + border: 1px solid red; +*/ } body { @@ -49,12 +36,12 @@ strong { } tt { - font-size: inherit; color: navy; } h1, h2, h3, h4, h5, h6 { color: #527bbd; + font-family: sans-serif; margin-top: 1.2em; margin-bottom: 0.5em; line-height: 1.3; @@ -74,6 +61,7 @@ h3 + * { } div.sectionbody { + font-family: serif; margin-left: 0; } @@ -89,8 +77,6 @@ p { ul, ol, li > p { margin-top: 0; } -ul > li { color: #aaa; } -ul > li > * { color: black; } pre { padding: 0; @@ -99,15 +85,18 @@ pre { span#author { color: #527bbd; + font-family: sans-serif; font-weight: bold; font-size: 1.1em; } span#email { } span#revnumber, span#revdate, span#revremark { + font-family: sans-serif; } div#footer { + font-family: sans-serif; font-size: small; border-top: 2px solid silver; padding-top: 0.5em; @@ -146,6 +135,7 @@ div.content { /* Block element content. */ /* Block element titles. */ div.title, caption.title { color: #527bbd; + font-family: sans-serif; font-weight: bold; text-align: left; margin-top: 1.0em; @@ -167,15 +157,13 @@ div.content + div.title { div.sidebarblock > div.content { background: #ffffee; - border: 1px solid #dddddd; - border-left: 4px solid #f0f0f0; + border: 1px solid silver; padding: 0.5em; } div.listingblock > div.content { - border: 1px solid #dddddd; - border-left: 5px solid #f0f0f0; - background: #f8f8f8; + border: 1px solid silver; + background: #f4f4f4; padding: 0.5em; } @@ -183,7 +171,7 @@ div.quoteblock, div.verseblock { padding-left: 1.0em; margin-left: 1.0em; margin-right: 10%; - border-left: 5px solid #f0f0f0; + border-left: 5px solid #dddddd; color: #777777; } @@ -192,9 +180,8 @@ div.quoteblock > div.attribution { text-align: right; } -div.verseblock > pre.content { - font-family: inherit; - font-size: inherit; +div.verseblock > div.content { + white-space: pre; } div.verseblock > div.attribution { padding-top: 0.75em; @@ -271,8 +258,8 @@ div.tableblock > table { border: 3px solid #527bbd; } thead, p.table.header { + font-family: sans-serif; font-weight: bold; - color: #527bbd; } tfoot { font-weight: bold; @@ -352,14 +339,6 @@ span.footnote, span.footnoteref { min-width: 100px; } -div.colist td { - padding-right: 0.5em; - padding-bottom: 0.3em; - vertical-align: top; -} -div.colist td img { - margin-top: 0.3em; -} @media print { div#footer-badges { display: none; } @@ -371,6 +350,7 @@ div#toc { div#toctitle { color: #527bbd; + font-family: sans-serif; font-size: 1.1em; font-weight: bold; margin-top: 1.0em; @@ -393,7 +373,6 @@ div.toclevel4 { margin-left: 6em; font-size: 0.9em; } - /* Overrides for manpage documents */ h1 { padding-top: 0.5em; @@ -412,6 +391,47 @@ div.sectionbody { div#toc { display: none; } } +/* Workarounds for IE6's broken and incomplete CSS2. */ + +div.sidebar-content { + background: #ffffee; + border: 1px solid silver; + padding: 0.5em; +} +div.sidebar-title, div.image-title { + color: #527bbd; + font-family: sans-serif; + font-weight: bold; + margin-top: 0.0em; + margin-bottom: 0.5em; +} + +div.listingblock div.content { + border: 1px solid silver; + background: #f4f4f4; + padding: 0.5em; +} + +div.quoteblock-attribution { + padding-top: 0.5em; + text-align: right; +} + +div.verseblock-content { + white-space: pre; +} +div.verseblock-attribution { + padding-top: 0.75em; + text-align: left; +} + +div.exampleblock-content { + border-left: 3px solid #dddddd; + padding-left: 0.5em; +} + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <script type="text/javascript"> /*<![CDATA[*/ @@ -547,7 +567,7 @@ footnotes: function () { /*]]>*/ </script> </head> -<body class="manpage"> +<body> <div id="header"> <h1> zmq_setsockopt(3) Manual Page @@ -560,15 +580,12 @@ zmq_setsockopt(3) Manual Page </div> </div> <div id="content"> -<div class="sect1"> <h2 id="_synopsis">SYNOPSIS</h2> <div class="sectionbody"> <div class="paragraph"><p><strong>int zmq_setsockopt (void <em>*socket</em>, int <em>option_name</em>, const void <em>*option_value</em>, size_t <em>option_len</em>);</strong></p></div> <div class="paragraph"><p>Caution: All options, with the exception of ZMQ_SUBSCRIBE, ZMQ_UNSUBSCRIBE and ZMQ_LINGER, only take effect for subsequent socket bind/connects.</p></div> </div> -</div> -<div class="sect1"> <h2 id="_description">DESCRIPTION</h2> <div class="sectionbody"> <div class="paragraph"><p>The <em>zmq_setsockopt()</em> function shall set the option specified by the @@ -576,8 +593,7 @@ ZMQ_LINGER, only take effect for subsequent socket bind/connects.</p></div> for the ØMQ socket pointed to by the <em>socket</em> argument. The <em>option_len</em> argument is the size of the option value in bytes.</p></div> <div class="paragraph"><p>The following socket options can be set with the <em>zmq_setsockopt()</em> function:</p></div> -<div class="sect2"> -<h3 id="_zmq_hwm_set_high_water_mark">ZMQ_HWM: Set high water mark</h3> +<h3 id="_zmq_hwm_set_high_water_mark">ZMQ_HWM: Set high water mark</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_HWM</em> option shall set the high water mark for the specified <em>socket</em>. The high water mark is a hard limit on the maximum number of outstanding messages ØMQ shall queue in memory for any single peer that the specified @@ -634,9 +650,7 @@ all </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_swap_set_disk_offload_size">ZMQ_SWAP: Set disk offload size</h3> +<h3 id="_zmq_swap_set_disk_offload_size">ZMQ_SWAP: Set disk offload size</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_SWAP</em> option shall set the disk offload (swap) size for the specified <em>socket</em>. A socket which has <em>ZMQ_SWAP</em> set to a non-zero value may exceed its high water mark; in this case outstanding messages shall be offloaded to @@ -688,9 +702,7 @@ all </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_affinity_set_i_o_thread_affinity">ZMQ_AFFINITY: Set I/O thread affinity</h3> +<h3 id="_zmq_affinity_set_i_o_thread_affinity">ZMQ_AFFINITY: Set I/O thread affinity</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_AFFINITY</em> option shall set the I/O thread affinity for newly created connections on the specified <em>socket</em>.</p></div> <div class="paragraph"><p>Affinity determines which threads from the ØMQ I/O thread pool associated with @@ -748,9 +760,7 @@ N/A </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_identity_set_socket_identity">ZMQ_IDENTITY: Set socket identity</h3> +<h3 id="_zmq_identity_set_socket_identity">ZMQ_IDENTITY: Set socket identity</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_IDENTITY</em> option shall set the identity of the specified <em>socket</em>. Socket identity determines if existing ØMQ infrastructure (<em>message queues</em>, <em>forwarding devices</em>) shall be identified with a specific application and @@ -808,9 +818,7 @@ all </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_subscribe_establish_message_filter">ZMQ_SUBSCRIBE: Establish message filter</h3> +<h3 id="_zmq_subscribe_establish_message_filter">ZMQ_SUBSCRIBE: Establish message filter</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_SUBSCRIBE</em> option shall establish a new message filter on a <em>ZMQ_SUB</em> socket. Newly created <em>ZMQ_SUB</em> sockets shall filter out all incoming messages, therefore you should call this option to establish an initial message filter.</p></div> @@ -865,9 +873,7 @@ ZMQ_SUB </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_unsubscribe_remove_message_filter">ZMQ_UNSUBSCRIBE: Remove message filter</h3> +<h3 id="_zmq_unsubscribe_remove_message_filter">ZMQ_UNSUBSCRIBE: Remove message filter</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_UNSUBSCRIBE</em> option shall remove an existing message filter on a <em>ZMQ_SUB</em> socket. The filter specified must match an existing filter previously established with the <em>ZMQ_SUBSCRIBE</em> option. If the socket has several @@ -919,9 +925,7 @@ ZMQ_SUB </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_rate_set_multicast_data_rate">ZMQ_RATE: Set multicast data rate</h3> +<h3 id="_zmq_rate_set_multicast_data_rate">ZMQ_RATE: Set multicast data rate</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_RATE</em> option shall set the maximum send or receive data rate for multicast transports such as <a href="zmq_pgm.html">zmq_pgm(7)</a> using the specified <em>socket</em>.</p></div> <div class="hdlist"><table> @@ -970,9 +974,7 @@ all, when using multicast transports </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_recovery_ivl_set_multicast_recovery_interval">ZMQ_RECOVERY_IVL: Set multicast recovery interval</h3> +<h3 id="_zmq_recovery_ivl_set_multicast_recovery_interval">ZMQ_RECOVERY_IVL: Set multicast recovery interval</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_RECOVERY_IVL</em> option shall set the recovery interval for multicast transports using the specified <em>socket</em>. The recovery interval determines the maximum time in seconds that a receiver can be absent from a multicast group @@ -1033,9 +1035,7 @@ all, when using multicast transports </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_recovery_ivl_msec_set_multicast_recovery_interval_in_milliseconds">ZMQ_RECOVERY_IVL_MSEC: Set multicast recovery interval in milliseconds</h3> +<h3 id="_zmq_recovery_ivl_msec_set_multicast_recovery_interval_in_milliseconds">ZMQ_RECOVERY_IVL_MSEC: Set multicast recovery interval in milliseconds</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_RECOVERY_IVL_MSEC</em> option shall set the recovery interval, specified in milliseconds (ms) for multicast transports using the specified <em>socket</em>. The recovery interval determines the maximum time in milliseconds that a @@ -1101,9 +1101,7 @@ all, when using multicast transports </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_mcast_loop_control_multicast_loop_back">ZMQ_MCAST_LOOP: Control multicast loop-back</h3> +<h3 id="_zmq_mcast_loop_control_multicast_loop_back">ZMQ_MCAST_LOOP: Control multicast loop-back</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_MCAST_LOOP</em> option shall control whether data sent via multicast transports using the specified <em>socket</em> can also be received by the sending host via loop-back. A value of zero disables the loop-back functionality, while @@ -1157,9 +1155,7 @@ all, when using multicast transports </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_sndbuf_set_kernel_transmit_buffer_size">ZMQ_SNDBUF: Set kernel transmit buffer size</h3> +<h3 id="_zmq_sndbuf_set_kernel_transmit_buffer_size">ZMQ_SNDBUF: Set kernel transmit buffer size</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_SNDBUF</em> option shall set the underlying kernel transmit buffer size for the <em>socket</em> to the specified size in bytes. A value of zero means leave the OS default unchanged. For details please refer to your operating system @@ -1210,9 +1206,7 @@ all </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_rcvbuf_set_kernel_receive_buffer_size">ZMQ_RCVBUF: Set kernel receive buffer size</h3> +<h3 id="_zmq_rcvbuf_set_kernel_receive_buffer_size">ZMQ_RCVBUF: Set kernel receive buffer size</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_RCVBUF</em> option shall set the underlying kernel receive buffer size for the <em>socket</em> to the specified size in bytes. A value of zero means leave the OS default unchanged. For details refer to your operating system documentation @@ -1263,9 +1257,7 @@ all </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_linger_set_linger_period_for_socket_shutdown">ZMQ_LINGER: Set linger period for socket shutdown</h3> +<h3 id="_zmq_linger_set_linger_period_for_socket_shutdown">ZMQ_LINGER: Set linger period for socket shutdown</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_LINGER</em> option shall set the linger period for the specified <em>socket</em>. The linger period determines how long pending messages which have yet to be sent to a peer shall linger in memory after a socket is closed with @@ -1343,9 +1335,7 @@ all </table></div> </li> </ul></div> -</div> -<div class="sect2"> -<h3 id="_zmq_reconnect_ivl_set_reconnection_interval">ZMQ_RECONNECT_IVL: Set reconnection interval</h3> +<h3 id="_zmq_reconnect_ivl_set_reconnection_interval">ZMQ_RECONNECT_IVL: Set reconnection interval</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_RECONNECT_IVL</em> option shall set the initial reconnection interval for the specified <em>socket</em>. The reconnection interval is the period ØMQ shall wait between attempts to reconnect disconnected peers when using @@ -1405,9 +1395,7 @@ all, only for connection-oriented transports </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_reconnect_ivl_max_set_maximum_reconnection_interval">ZMQ_RECONNECT_IVL_MAX: Set maximum reconnection interval</h3> +<h3 id="_zmq_reconnect_ivl_max_set_maximum_reconnection_interval">ZMQ_RECONNECT_IVL_MAX: Set maximum reconnection interval</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_RECONNECT_IVL_MAX</em> option shall set the maximum reconnection interval for the specified <em>socket</em>. This is the maximum period ØMQ shall wait between attempts to reconnect. On each reconnect attempt, the previous interval shall be @@ -1468,9 +1456,7 @@ all, only for connection-oriented transports </td> </tr> </table></div> -</div> -<div class="sect2"> -<h3 id="_zmq_backlog_set_maximum_length_of_the_queue_of_outstanding_connections">ZMQ_BACKLOG: Set maximum length of the queue of outstanding connections</h3> +<h3 id="_zmq_backlog_set_maximum_length_of_the_queue_of_outstanding_connections">ZMQ_BACKLOG: Set maximum length of the queue of outstanding connections</h3><div style="clear:left"></div> <div class="paragraph"><p>The <em>ZMQ_BACKLOG</em> option shall set the maximum length of the queue of outstanding peer connections for the specified <em>socket</em>; this only applies to connection-oriented transports. For details refer to your operating system @@ -1522,16 +1508,11 @@ all, only for connection-oriented transports. </tr> </table></div> </div> -</div> -</div> -<div class="sect1"> <h2 id="_return_value">RETURN VALUE</h2> <div class="sectionbody"> <div class="paragraph"><p>The <em>zmq_setsockopt()</em> function shall return zero if successful. Otherwise it shall return <tt>-1</tt> and set <em>errno</em> to one of the values defined below.</p></div> </div> -</div> -<div class="sect1"> <h2 id="_errors">ERRORS</h2> <div class="sectionbody"> <div class="dlist"><dl> @@ -1570,8 +1551,6 @@ The operation was interrupted by delivery of a signal. </dd> </dl></div> </div> -</div> -<div class="sect1"> <h2 id="_example">EXAMPLE</h2> <div class="sectionbody"> <div class="listingblock"> @@ -1601,28 +1580,23 @@ rc = zmq_bind (socket, "tcp://lo:5556"); assert (rc);</tt></pre> </div></div> </div> -</div> -<div class="sect1"> <h2 id="_see_also">SEE ALSO</h2> <div class="sectionbody"> <div class="paragraph"><p><a href="zmq_getsockopt.html">zmq_getsockopt(3)</a> <a href="zmq_socket.html">zmq_socket(3)</a> <a href="zmq.html">zmq(7)</a></p></div> </div> -</div> -<div class="sect1"> <h2 id="_authors">AUTHORS</h2> <div class="sectionbody"> <div class="paragraph"><p>This ØMQ manual page was written by Martin Sustrik <<a href="mailto:sustrik@250bpm.com">sustrik@250bpm.com</a>> and Martin Lucina <<a href="mailto:mato@kotelna.sk">mato@kotelna.sk</a>>.</p></div> </div> </div> -</div> <div id="footnotes"><hr /></div> <div id="footer"> <div id="footer-text"> -ØMQ 2.1.9<br /> -Last updated 2011-07-30 17:22:16 CEST +ØMQ 2.1.10<br /> +Last updated 2011-08-23 16:01:49 CDT </div> </div> </body> -- cgit v1.2.3