http://git-wip-us.apache.org/repos/asf/qpid-site/blob/bc75d075/content/releases/qpid-proton-0.22.0/proton/c/api/group__messenger.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-proton-0.22.0/proton/c/api/group__messenger.html b/content/releases/qpid-proton-0.22.0/proton/c/api/group__messenger.html new file mode 100755 index 0000000..c742367 --- /dev/null +++ b/content/releases/qpid-proton-0.22.0/proton/c/api/group__messenger.html @@ -0,0 +1,2617 @@ +<!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.13"/> +<meta name="viewport" content="width=device-width, initial-scale=1"/> +<title>Qpid Proton C API: Messenger</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="navtree.css" rel="stylesheet" type="text/css"/> +<script type="text/javascript" src="resize.js"></script> +<script type="text/javascript" src="navtreedata.js"></script> +<script type="text/javascript" src="navtree.js"></script> +<script type="text/javascript"> + $(document).ready(initResizable); +</script> +<link href="search/search.css" rel="stylesheet" type="text/css"/> +<script type="text/javascript" src="search/searchdata.js"></script> +<script type="text/javascript" src="search/search.js"></script> +<script type="text/javascript"> + $(document).ready(function() { init_search(); }); +</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">Qpid Proton C API +  <span id="projectnumber">0.22.0</span> + </div> + </td> + <td> <div id="MSearchBox" class="MSearchBoxInactive"> + <span class="left"> + <img id="MSearchSelect" src="search/mag_sel.png" + onmouseover="return searchBox.OnSearchSelectShow()" + onmouseout="return searchBox.OnSearchSelectHide()" + alt=""/> + <input type="text" id="MSearchField" value="Search" accesskey="S" + onfocus="searchBox.OnSearchFieldFocus(true)" + onblur="searchBox.OnSearchFieldFocus(false)" + onkeyup="searchBox.OnSearchFieldChange(event)"/> + </span><span class="right"> + <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a> + </span> + </div> +</td> + </tr> + </tbody> +</table> +</div> +<!-- end header part --> +<!-- Generated by Doxygen 1.8.13 --> +<script type="text/javascript"> +var searchBox = new SearchBox("searchBox", "search",false,'Search'); +</script> +</div><!-- top --> +<div id="side-nav" class="ui-resizable side-nav-resizable"> + <div id="nav-tree"> + <div id="nav-tree-contents"> + <div id="nav-sync" class="sync"></div> + </div> + </div> + <div id="splitbar" style="-moz-user-select:none;" + class="ui-resizable-handle"> + </div> +</div> +<script type="text/javascript"> +$(document).ready(function(){initNavTree('group__messenger.html','');}); +</script> +<div id="doc-content"> +<!-- window showing the filter options --> +<div id="MSearchSelectWindow" + onmouseover="return searchBox.OnSearchSelectShow()" + onmouseout="return searchBox.OnSearchSelectHide()" + onkeydown="return searchBox.OnSearchSelectKey(event)"> +</div> + +<!-- iframe showing the search results (closed by default) --> +<div id="MSearchResultsWindow"> +<iframe src="javascript:void(0)" frameborder="0" + name="MSearchResults" id="MSearchResults"> +</iframe> +</div> + +<div class="header"> + <div class="summary"> +<a href="#define-members">Macros</a> | +<a href="#typedef-members">Typedefs</a> | +<a href="#enum-members">Enumerations</a> | +<a href="#func-members">Functions</a> </div> + <div class="headertitle"> +<div class="title">Messenger</div> </div> +</div><!--header--> +<div class="contents"> + +<p><b>Deprecated</b> - Use the <a class="el" href="group__proactor.html">Proactor</a> API or Qpid Proton C++. +<a href="#details">More...</a></p> +<table class="memberdecls"> +<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a> +Macros</h2></td></tr> +<tr class="memitem:ga6c2e8d006ec05b913fa1e6dc510d23b9"><td class="memItemLeft" align="right" valign="top"><a id="ga6c2e8d006ec05b913fa1e6dc510d23b9"></a> +#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga6c2e8d006ec05b913fa1e6dc510d23b9">PN_CUMULATIVE</a></td></tr> +<tr class="memdesc:ga6c2e8d006ec05b913fa1e6dc510d23b9"><td class="mdescLeft"> </td><td class="mdescRight">Indicates that an accept or reject should operate cumulatively. <br /></td></tr> +<tr class="separator:ga6c2e8d006ec05b913fa1e6dc510d23b9"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gad5ad0b67fef0e761dc0138b9621ffa14"><td class="memItemLeft" align="right" valign="top"><a id="gad5ad0b67fef0e761dc0138b9621ffa14"></a> +#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gad5ad0b67fef0e761dc0138b9621ffa14">PN_FLAGS_CHECK_ROUTES</a></td></tr> +<tr class="memdesc:gad5ad0b67fef0e761dc0138b9621ffa14"><td class="mdescLeft"> </td><td class="mdescRight">Messenger flag to indicate that a call \ to pn_messenger_start should check that \ any defined routes are valid. <br /></td></tr> +<tr class="separator:gad5ad0b67fef0e761dc0138b9621ffa14"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga118fb0c2384257dff5d72eea787e4a0c"><td class="memItemLeft" align="right" valign="top"><a id="ga118fb0c2384257dff5d72eea787e4a0c"></a> +#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga118fb0c2384257dff5d72eea787e4a0c">PN_FLAGS_ALLOW_INSECURE_MECHS</a></td></tr> +<tr class="memdesc:ga118fb0c2384257dff5d72eea787e4a0c"><td class="mdescLeft"> </td><td class="mdescRight">Messenger flag to indicate that the PLAIN \ mechanism is allowed on an unencrypted \ connection. <br /></td></tr> +<tr class="separator:ga118fb0c2384257dff5d72eea787e4a0c"><td class="memSeparator" colspan="2"> </td></tr> +</table><table class="memberdecls"> +<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a> +Typedefs</h2></td></tr> +<tr class="memitem:ga0d342bb795d48591ad6b3f867766b8b1"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a></td></tr> +<tr class="memdesc:ga0d342bb795d48591ad6b3f867766b8b1"><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1" title="A pn_messenger_t provides a high level interface for sending and receiving messages (See pn_message_t...">pn_messenger_t</a> provides a high level interface for sending and receiving messages (See <a class="el" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2" title="An AMQP Message object. ">pn_message_t</a>). <a href="#ga0d342bb795d48591ad6b3f867766b8b1">More...</a><br /></td></tr> +<tr class="separator:ga0d342bb795d48591ad6b3f867766b8b1"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gabd73703511b9dae193765e9e57864291"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="group__messenger.html#gabd73703511b9dae193765e9e57864291">pn_subscription_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gabd73703511b9dae193765e9e57864291">pn_subscription_t</a></td></tr> +<tr class="memdesc:gabd73703511b9dae193765e9e57864291"><td class="mdescLeft"> </td><td class="mdescRight">A subscription is a request for incoming messages. <a href="#gabd73703511b9dae193765e9e57864291">More...</a><br /></td></tr> +<tr class="separator:gabd73703511b9dae193765e9e57864291"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gab1173cfe4bcaa0a530c8035dc75f42c7"><td class="memItemLeft" align="right" valign="top"><a id="gab1173cfe4bcaa0a530c8035dc75f42c7"></a> +typedef int64_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gab1173cfe4bcaa0a530c8035dc75f42c7">pn_tracker_t</a></td></tr> +<tr class="memdesc:gab1173cfe4bcaa0a530c8035dc75f42c7"><td class="mdescLeft"> </td><td class="mdescRight">Trackers provide a lightweight handle used to track the status of incoming and outgoing deliveries. <br /></td></tr> +<tr class="separator:gab1173cfe4bcaa0a530c8035dc75f42c7"><td class="memSeparator" colspan="2"> </td></tr> +</table><table class="memberdecls"> +<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a> +Enumerations</h2></td></tr> +<tr class="memitem:ga242e4ee54b9c0a416443c7da5f6e045b"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga242e4ee54b9c0a416443c7da5f6e045b">pn_status_t</a> { <br /> +  <a class="el" href="group__messenger.html#gga242e4ee54b9c0a416443c7da5f6e045ba0b46b1041679460baaba2ddcdb2173f2">PN_STATUS_UNKNOWN</a>, +<a class="el" href="group__messenger.html#gga242e4ee54b9c0a416443c7da5f6e045ba4b0354a77173cd75c69159e15c23f611">PN_STATUS_PENDING</a>, +<a class="el" href="group__messenger.html#gga242e4ee54b9c0a416443c7da5f6e045ba693fd9044a50a4f02e842d04a4bf1467">PN_STATUS_ACCEPTED</a>, +<a class="el" href="group__messenger.html#gga242e4ee54b9c0a416443c7da5f6e045baf109df703952744009b3547f3b8f32bf">PN_STATUS_REJECTED</a>, +<br /> +  <a class="el" href="group__messenger.html#gga242e4ee54b9c0a416443c7da5f6e045ba67079750477effb7935df83381c47852">PN_STATUS_RELEASED</a>, +<a class="el" href="group__messenger.html#gga242e4ee54b9c0a416443c7da5f6e045ba77d94a6b6b745eef9307f144b57e81e8">PN_STATUS_MODIFIED</a>, +<a class="el" href="group__messenger.html#gga242e4ee54b9c0a416443c7da5f6e045ba1239e8ada7eabe2aeab98f2c881cd2ee">PN_STATUS_ABORTED</a>, +<a class="el" href="group__messenger.html#gga242e4ee54b9c0a416443c7da5f6e045ba1181bc7f51502ae11ed240866cd64583">PN_STATUS_SETTLED</a> +<br /> + }<tr class="memdesc:ga242e4ee54b9c0a416443c7da5f6e045b"><td class="mdescLeft"> </td><td class="mdescRight">Describes all the possible states for a message associated with a given tracker. <a href="group__messenger.html#ga242e4ee54b9c0a416443c7da5f6e045b">More...</a><br /></td></tr> +</td></tr> +<tr class="separator:ga242e4ee54b9c0a416443c7da5f6e045b"><td class="memSeparator" colspan="2"> </td></tr> +</table><table class="memberdecls"> +<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a> +Functions</h2></td></tr> +<tr class="memitem:gabe045d16ca8eb1e3cc87387e2ae82433"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gabe045d16ca8eb1e3cc87387e2ae82433">pn_messenger</a> (const char *name)</td></tr> +<tr class="memdesc:gabe045d16ca8eb1e3cc87387e2ae82433"><td class="mdescLeft"> </td><td class="mdescRight">Construct a new <a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1" title="A pn_messenger_t provides a high level interface for sending and receiving messages (See pn_message_t...">pn_messenger_t</a> with the given name. <a href="#gabe045d16ca8eb1e3cc87387e2ae82433">More...</a><br /></td></tr> +<tr class="separator:gabe045d16ca8eb1e3cc87387e2ae82433"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga71197163a69770575df74e3cee617429"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga71197163a69770575df74e3cee617429">pn_messenger_name</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga71197163a69770575df74e3cee617429"><td class="mdescLeft"> </td><td class="mdescRight">Get the name of a messenger. <a href="#ga71197163a69770575df74e3cee617429">More...</a><br /></td></tr> +<tr class="separator:ga71197163a69770575df74e3cee617429"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gad61fff52c28501171ecbb0b21bbde954"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gad61fff52c28501171ecbb0b21bbde954">pn_messenger_set_certificate</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const char *certificate)</td></tr> +<tr class="memdesc:gad61fff52c28501171ecbb0b21bbde954"><td class="mdescLeft"> </td><td class="mdescRight">Sets the path that will be used to get the certificate that will be used to identify this messenger to its peers. <a href="#gad61fff52c28501171ecbb0b21bbde954">More...</a><br /></td></tr> +<tr class="separator:gad61fff52c28501171ecbb0b21bbde954"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga1d0c003a1fb5e20b894e2deb8b43118b"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga1d0c003a1fb5e20b894e2deb8b43118b">pn_messenger_get_certificate</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga1d0c003a1fb5e20b894e2deb8b43118b"><td class="mdescLeft"> </td><td class="mdescRight">Get the certificate path. <a href="#ga1d0c003a1fb5e20b894e2deb8b43118b">More...</a><br /></td></tr> +<tr class="separator:ga1d0c003a1fb5e20b894e2deb8b43118b"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga05f059a2fe93e0acbcf76e494e6bf958"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga05f059a2fe93e0acbcf76e494e6bf958">pn_messenger_set_private_key</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const char *private_key)</td></tr> +<tr class="memdesc:ga05f059a2fe93e0acbcf76e494e6bf958"><td class="mdescLeft"> </td><td class="mdescRight">Set path to the private key that was used to sign the certificate. <a href="#ga05f059a2fe93e0acbcf76e494e6bf958">More...</a><br /></td></tr> +<tr class="separator:ga05f059a2fe93e0acbcf76e494e6bf958"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gab692f989aed2aa83bd71b7fa7196aeb1"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gab692f989aed2aa83bd71b7fa7196aeb1">pn_messenger_get_private_key</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:gab692f989aed2aa83bd71b7fa7196aeb1"><td class="mdescLeft"> </td><td class="mdescRight">Gets the private key file for a messenger. <a href="#gab692f989aed2aa83bd71b7fa7196aeb1">More...</a><br /></td></tr> +<tr class="separator:gab692f989aed2aa83bd71b7fa7196aeb1"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga6b04f7dea2ed8752b8672b4cfe0330f2"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga6b04f7dea2ed8752b8672b4cfe0330f2">pn_messenger_set_password</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const char *password)</td></tr> +<tr class="memdesc:ga6b04f7dea2ed8752b8672b4cfe0330f2"><td class="mdescLeft"> </td><td class="mdescRight">Sets the private key password for a messenger. <a href="#ga6b04f7dea2ed8752b8672b4cfe0330f2">More...</a><br /></td></tr> +<tr class="separator:ga6b04f7dea2ed8752b8672b4cfe0330f2"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga3f02ad7340a59c5982e6223aaeea803a"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga3f02ad7340a59c5982e6223aaeea803a">pn_messenger_get_password</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga3f02ad7340a59c5982e6223aaeea803a"><td class="mdescLeft"> </td><td class="mdescRight">Gets the private key file password for a messenger. <a href="#ga3f02ad7340a59c5982e6223aaeea803a">More...</a><br /></td></tr> +<tr class="separator:ga3f02ad7340a59c5982e6223aaeea803a"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gad901e92e2bee6d5371dcd3b1c8fe2c3b"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gad901e92e2bee6d5371dcd3b1c8fe2c3b">pn_messenger_set_trusted_certificates</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const char *cert_db)</td></tr> +<tr class="memdesc:gad901e92e2bee6d5371dcd3b1c8fe2c3b"><td class="mdescLeft"> </td><td class="mdescRight">Sets the trusted certificates database for a messenger. <a href="#gad901e92e2bee6d5371dcd3b1c8fe2c3b">More...</a><br /></td></tr> +<tr class="separator:gad901e92e2bee6d5371dcd3b1c8fe2c3b"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga955b218a8f58560e9e228ca14fba21f2"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga955b218a8f58560e9e228ca14fba21f2">pn_messenger_get_trusted_certificates</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga955b218a8f58560e9e228ca14fba21f2"><td class="mdescLeft"> </td><td class="mdescRight">Gets the trusted certificates database for a messenger. <a href="#ga955b218a8f58560e9e228ca14fba21f2">More...</a><br /></td></tr> +<tr class="separator:ga955b218a8f58560e9e228ca14fba21f2"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga04119bb2b16bb0f657f1dbcf73827d74"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga04119bb2b16bb0f657f1dbcf73827d74">pn_messenger_set_timeout</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, int timeout)</td></tr> +<tr class="memdesc:ga04119bb2b16bb0f657f1dbcf73827d74"><td class="mdescLeft"> </td><td class="mdescRight">Set the default timeout for a messenger. <a href="#ga04119bb2b16bb0f657f1dbcf73827d74">More...</a><br /></td></tr> +<tr class="separator:ga04119bb2b16bb0f657f1dbcf73827d74"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga083ba6296a1ae1dfe45c0fb82da823eb"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga083ba6296a1ae1dfe45c0fb82da823eb">pn_messenger_get_timeout</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga083ba6296a1ae1dfe45c0fb82da823eb"><td class="mdescLeft"> </td><td class="mdescRight">Gets the timeout for a messenger object. <a href="#ga083ba6296a1ae1dfe45c0fb82da823eb">More...</a><br /></td></tr> +<tr class="separator:ga083ba6296a1ae1dfe45c0fb82da823eb"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gaf572cbf224105d08898d2906336712f7"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gaf572cbf224105d08898d2906336712f7">pn_messenger_is_blocking</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:gaf572cbf224105d08898d2906336712f7"><td class="mdescLeft"> </td><td class="mdescRight">Check if a messenger is in blocking mode. <a href="#gaf572cbf224105d08898d2906336712f7">More...</a><br /></td></tr> +<tr class="separator:gaf572cbf224105d08898d2906336712f7"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gae9d7f1aec6e2cf3ef1ee326a4ae15981"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gae9d7f1aec6e2cf3ef1ee326a4ae15981">pn_messenger_set_blocking</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, bool blocking)</td></tr> +<tr class="memdesc:gae9d7f1aec6e2cf3ef1ee326a4ae15981"><td class="mdescLeft"> </td><td class="mdescRight">Enable or disable blocking behavior for a messenger during calls to <a class="el" href="group__messenger.html#gae31f9a99dcbedffe83588cf25b805325" title="Send messages from a messenger's outgoing queue. ">pn_messenger_send</a> and <a class="el" href="group__messenger.html#ga16c945185e4eb5dcb9aac2be2fcab0d6" title="Retrieve messages into a messenger's incoming queue. ">pn_messenger_recv</a>. <a href="#gae9d7f1aec6e2cf3ef1ee326a4ae15981">More...</a><br /></td></tr> +<tr class="separator:gae9d7f1aec6e2cf3ef1ee326a4ae15981"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga63805c35f18ef041c69a14564dc1bce4"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga63805c35f18ef041c69a14564dc1bce4">pn_messenger_is_passive</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga63805c35f18ef041c69a14564dc1bce4"><td class="mdescLeft"> </td><td class="mdescRight">Check if a messenger is in passive mode. <a href="#ga63805c35f18ef041c69a14564dc1bce4">More...</a><br /></td></tr> +<tr class="separator:ga63805c35f18ef041c69a14564dc1bce4"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gac7df7c92396f10f105ec74d35310a7c0"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gac7df7c92396f10f105ec74d35310a7c0">pn_messenger_set_passive</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, bool passive)</td></tr> +<tr class="memdesc:gac7df7c92396f10f105ec74d35310a7c0"><td class="mdescLeft"> </td><td class="mdescRight">Set the passive mode for a messenger. <a href="#gac7df7c92396f10f105ec74d35310a7c0">More...</a><br /></td></tr> +<tr class="separator:gac7df7c92396f10f105ec74d35310a7c0"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga530295575eda95e3c19316d41bd1baa7"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga530295575eda95e3c19316d41bd1baa7">pn_messenger_free</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga530295575eda95e3c19316d41bd1baa7"><td class="mdescLeft"> </td><td class="mdescRight">Frees a Messenger. <a href="#ga530295575eda95e3c19316d41bd1baa7">More...</a><br /></td></tr> +<tr class="separator:ga530295575eda95e3c19316d41bd1baa7"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gacfd10311abca28521fe7aa9cabfff61c"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gacfd10311abca28521fe7aa9cabfff61c">pn_messenger_errno</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:gacfd10311abca28521fe7aa9cabfff61c"><td class="mdescLeft"> </td><td class="mdescRight">Get the code for a messenger's most recent error. <a href="#gacfd10311abca28521fe7aa9cabfff61c">More...</a><br /></td></tr> +<tr class="separator:gacfd10311abca28521fe7aa9cabfff61c"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga0301664be9c54b3a573578776ad2a5d2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#ga24a289d5b32c9bd8a775600a5af83d52">pn_error_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga0301664be9c54b3a573578776ad2a5d2">pn_messenger_error</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga0301664be9c54b3a573578776ad2a5d2"><td class="mdescLeft"> </td><td class="mdescRight">Get a messenger's error object. <a href="#ga0301664be9c54b3a573578776ad2a5d2">More...</a><br /></td></tr> +<tr class="separator:ga0301664be9c54b3a573578776ad2a5d2"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gac191bdb410b7839d6306a0d8e5ac19e1"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gac191bdb410b7839d6306a0d8e5ac19e1">pn_messenger_get_outgoing_window</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:gac191bdb410b7839d6306a0d8e5ac19e1"><td class="mdescLeft"> </td><td class="mdescRight">Get the size of a messenger's outgoing window. <a href="#gac191bdb410b7839d6306a0d8e5ac19e1">More...</a><br /></td></tr> +<tr class="separator:gac191bdb410b7839d6306a0d8e5ac19e1"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga96487581bd8348f8bc9bacef25042cfc"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga96487581bd8348f8bc9bacef25042cfc">pn_messenger_set_outgoing_window</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, int window)</td></tr> +<tr class="memdesc:ga96487581bd8348f8bc9bacef25042cfc"><td class="mdescLeft"> </td><td class="mdescRight">Set the size of a messenger's outgoing window. <a href="#ga96487581bd8348f8bc9bacef25042cfc">More...</a><br /></td></tr> +<tr class="separator:ga96487581bd8348f8bc9bacef25042cfc"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga45d578f39673ad59ca65d2042054abee"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga45d578f39673ad59ca65d2042054abee">pn_messenger_get_incoming_window</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga45d578f39673ad59ca65d2042054abee"><td class="mdescLeft"> </td><td class="mdescRight">Get the size of a messenger's incoming window. <a href="#ga45d578f39673ad59ca65d2042054abee">More...</a><br /></td></tr> +<tr class="separator:ga45d578f39673ad59ca65d2042054abee"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gadf8a9cf14bf8d519026ea8c4eeb275c3"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gadf8a9cf14bf8d519026ea8c4eeb275c3">pn_messenger_set_incoming_window</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, int window)</td></tr> +<tr class="memdesc:gadf8a9cf14bf8d519026ea8c4eeb275c3"><td class="mdescLeft"> </td><td class="mdescRight">Set the size of a messenger's incoming window. <a href="#gadf8a9cf14bf8d519026ea8c4eeb275c3">More...</a><br /></td></tr> +<tr class="separator:gadf8a9cf14bf8d519026ea8c4eeb275c3"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga6fa594235e316cd2a04b44b283194a43"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga6fa594235e316cd2a04b44b283194a43">pn_messenger_start</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga6fa594235e316cd2a04b44b283194a43"><td class="mdescLeft"> </td><td class="mdescRight">Currently a no-op placeholder. <a href="#ga6fa594235e316cd2a04b44b283194a43">More...</a><br /></td></tr> +<tr class="separator:ga6fa594235e316cd2a04b44b283194a43"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gad95ab6daf6b2a61b79d5128a7d1d9f5c"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gad95ab6daf6b2a61b79d5128a7d1d9f5c">pn_messenger_stop</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:gad95ab6daf6b2a61b79d5128a7d1d9f5c"><td class="mdescLeft"> </td><td class="mdescRight">Stops a messenger. <a href="#gad95ab6daf6b2a61b79d5128a7d1d9f5c">More...</a><br /></td></tr> +<tr class="separator:gad95ab6daf6b2a61b79d5128a7d1d9f5c"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gae2c4765839c8fd09c0e01d05a118b6d4"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gae2c4765839c8fd09c0e01d05a118b6d4">pn_messenger_stopped</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:gae2c4765839c8fd09c0e01d05a118b6d4"><td class="mdescLeft"> </td><td class="mdescRight">Returns true if a messenger is in the stopped state. <a href="#gae2c4765839c8fd09c0e01d05a118b6d4">More...</a><br /></td></tr> +<tr class="separator:gae2c4765839c8fd09c0e01d05a118b6d4"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gac36589fe5dc0378cf62558e40060a26f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__messenger.html#gabd73703511b9dae193765e9e57864291">pn_subscription_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gac36589fe5dc0378cf62558e40060a26f">pn_messenger_subscribe</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const char *source)</td></tr> +<tr class="memdesc:gac36589fe5dc0378cf62558e40060a26f"><td class="mdescLeft"> </td><td class="mdescRight">Subscribes a messenger to messages from the specified source. <a href="#gac36589fe5dc0378cf62558e40060a26f">More...</a><br /></td></tr> +<tr class="separator:gac36589fe5dc0378cf62558e40060a26f"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga480a8623fab904690218c0c67493232f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__messenger.html#gabd73703511b9dae193765e9e57864291">pn_subscription_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga480a8623fab904690218c0c67493232f">pn_messenger_subscribe_ttl</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const char *source, <a class="el" href="group__api__types.html#gafdede9be0526a8d0b9ab5d3149069af1">pn_seconds_t</a> timeout)</td></tr> +<tr class="memdesc:ga480a8623fab904690218c0c67493232f"><td class="mdescLeft"> </td><td class="mdescRight">Subscribes a messenger to messages from the specified source with the given timeout for the subscription's lifetime. <a href="#ga480a8623fab904690218c0c67493232f">More...</a><br /></td></tr> +<tr class="separator:ga480a8623fab904690218c0c67493232f"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga757aeef23d47ecc2a9a461b882686417"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__link.html#ga89dad3aa7934329a7ff467c636687bc0">pn_link_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga757aeef23d47ecc2a9a461b882686417">pn_messenger_get_link</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const char *address, bool sender)</td></tr> +<tr class="memdesc:ga757aeef23d47ecc2a9a461b882686417"><td class="mdescLeft"> </td><td class="mdescRight">Get a link based on link name and whether the link is a sender or receiver. <a href="#ga757aeef23d47ecc2a9a461b882686417">More...</a><br /></td></tr> +<tr class="separator:ga757aeef23d47ecc2a9a461b882686417"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga8ad0f0db6d7cfe0e95d44d433843d787"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga8ad0f0db6d7cfe0e95d44d433843d787">pn_subscription_get_context</a> (<a class="el" href="group__messenger.html#gabd73703511b9dae193765e9e57864291">pn_subscription_t</a> *sub)</td></tr> +<tr class="memdesc:ga8ad0f0db6d7cfe0e95d44d433843d787"><td class="mdescLeft"> </td><td class="mdescRight">Get a subscription's application context. <a href="#ga8ad0f0db6d7cfe0e95d44d433843d787">More...</a><br /></td></tr> +<tr class="separator:ga8ad0f0db6d7cfe0e95d44d433843d787"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga3a7f95a2a86f64babe692d21ffe9cd10"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga3a7f95a2a86f64babe692d21ffe9cd10">pn_subscription_set_context</a> (<a class="el" href="group__messenger.html#gabd73703511b9dae193765e9e57864291">pn_subscription_t</a> *sub, void *context)</td></tr> +<tr class="memdesc:ga3a7f95a2a86f64babe692d21ffe9cd10"><td class="mdescLeft"> </td><td class="mdescRight">Set an application context for a subscription. <a href="#ga3a7f95a2a86f64babe692d21ffe9cd10">More...</a><br /></td></tr> +<tr class="separator:ga3a7f95a2a86f64babe692d21ffe9cd10"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga8e87c040776f1941f21d2c15f24b835e"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga8e87c040776f1941f21d2c15f24b835e">pn_subscription_address</a> (<a class="el" href="group__messenger.html#gabd73703511b9dae193765e9e57864291">pn_subscription_t</a> *sub)</td></tr> +<tr class="memdesc:ga8e87c040776f1941f21d2c15f24b835e"><td class="mdescLeft"> </td><td class="mdescRight">Get the source address of a subscription. <a href="#ga8e87c040776f1941f21d2c15f24b835e">More...</a><br /></td></tr> +<tr class="separator:ga8e87c040776f1941f21d2c15f24b835e"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gafede68af29484d50d531cc48ab0d3d4a"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gafede68af29484d50d531cc48ab0d3d4a">pn_messenger_put</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, <a class="el" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg)</td></tr> +<tr class="memdesc:gafede68af29484d50d531cc48ab0d3d4a"><td class="mdescLeft"> </td><td class="mdescRight">Puts a message onto the messenger's outgoing queue. <a href="#gafede68af29484d50d531cc48ab0d3d4a">More...</a><br /></td></tr> +<tr class="separator:gafede68af29484d50d531cc48ab0d3d4a"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gad398544ad1374f67c922115ae1cceacc"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__messenger.html#ga242e4ee54b9c0a416443c7da5f6e045b">pn_status_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gad398544ad1374f67c922115ae1cceacc">pn_messenger_status</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, <a class="el" href="group__messenger.html#gab1173cfe4bcaa0a530c8035dc75f42c7">pn_tracker_t</a> tracker)</td></tr> +<tr class="memdesc:gad398544ad1374f67c922115ae1cceacc"><td class="mdescLeft"> </td><td class="mdescRight">Track the status of a delivery. <a href="#gad398544ad1374f67c922115ae1cceacc">More...</a><br /></td></tr> +<tr class="separator:gad398544ad1374f67c922115ae1cceacc"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga65f22122f08bc93de2bfe155aa12d0b0"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__delivery.html#gacdfce854066c0a4ff4db9f9a0478f340">pn_delivery_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga65f22122f08bc93de2bfe155aa12d0b0">pn_messenger_delivery</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, <a class="el" href="group__messenger.html#gab1173cfe4bcaa0a530c8035dc75f42c7">pn_tracker_t</a> tracker)</td></tr> +<tr class="memdesc:ga65f22122f08bc93de2bfe155aa12d0b0"><td class="mdescLeft"> </td><td class="mdescRight">Get delivery information about a delivery. <a href="#ga65f22122f08bc93de2bfe155aa12d0b0">More...</a><br /></td></tr> +<tr class="separator:ga65f22122f08bc93de2bfe155aa12d0b0"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga15adeb707f15b86df1e5486c34a060e6"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga15adeb707f15b86df1e5486c34a060e6">pn_messenger_buffered</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, <a class="el" href="group__messenger.html#gab1173cfe4bcaa0a530c8035dc75f42c7">pn_tracker_t</a> tracker)</td></tr> +<tr class="memdesc:ga15adeb707f15b86df1e5486c34a060e6"><td class="mdescLeft"> </td><td class="mdescRight">Check if the delivery associated with a given tracker is still waiting to be sent. <a href="#ga15adeb707f15b86df1e5486c34a060e6">More...</a><br /></td></tr> +<tr class="separator:ga15adeb707f15b86df1e5486c34a060e6"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga475ce593f6b0c6025516ae48360dee4d"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga475ce593f6b0c6025516ae48360dee4d">pn_messenger_settle</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, <a class="el" href="group__messenger.html#gab1173cfe4bcaa0a530c8035dc75f42c7">pn_tracker_t</a> tracker, int flags)</td></tr> +<tr class="memdesc:ga475ce593f6b0c6025516ae48360dee4d"><td class="mdescLeft"> </td><td class="mdescRight">Frees a Messenger from tracking the status associated with a given tracker. <a href="#ga475ce593f6b0c6025516ae48360dee4d">More...</a><br /></td></tr> +<tr class="separator:ga475ce593f6b0c6025516ae48360dee4d"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga0212b5cfe07a7f758ec472d67d0f56e1"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__messenger.html#gab1173cfe4bcaa0a530c8035dc75f42c7">pn_tracker_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga0212b5cfe07a7f758ec472d67d0f56e1">pn_messenger_outgoing_tracker</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga0212b5cfe07a7f758ec472d67d0f56e1"><td class="mdescLeft"> </td><td class="mdescRight">Get a tracker for the outgoing message most recently given to pn_messenger_put. <a href="#ga0212b5cfe07a7f758ec472d67d0f56e1">More...</a><br /></td></tr> +<tr class="separator:ga0212b5cfe07a7f758ec472d67d0f56e1"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga47d60cec6a55e0675b8f073067eff9c4"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga47d60cec6a55e0675b8f073067eff9c4">pn_messenger_work</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, int timeout)</td></tr> +<tr class="memdesc:ga47d60cec6a55e0675b8f073067eff9c4"><td class="mdescLeft"> </td><td class="mdescRight">Sends or receives any outstanding messages queued for a messenger. <a href="#ga47d60cec6a55e0675b8f073067eff9c4">More...</a><br /></td></tr> +<tr class="separator:ga47d60cec6a55e0675b8f073067eff9c4"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga9da14c67acc17bc5fec6f34e2749534f"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga9da14c67acc17bc5fec6f34e2749534f">pn_messenger_interrupt</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga9da14c67acc17bc5fec6f34e2749534f"><td class="mdescLeft"> </td><td class="mdescRight">Interrupt a messenger object that may be blocking in another thread. <a href="#ga9da14c67acc17bc5fec6f34e2749534f">More...</a><br /></td></tr> +<tr class="separator:ga9da14c67acc17bc5fec6f34e2749534f"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gae31f9a99dcbedffe83588cf25b805325"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gae31f9a99dcbedffe83588cf25b805325">pn_messenger_send</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, int n)</td></tr> +<tr class="memdesc:gae31f9a99dcbedffe83588cf25b805325"><td class="mdescLeft"> </td><td class="mdescRight">Send messages from a messenger's outgoing queue. <a href="#gae31f9a99dcbedffe83588cf25b805325">More...</a><br /></td></tr> +<tr class="separator:gae31f9a99dcbedffe83588cf25b805325"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga16c945185e4eb5dcb9aac2be2fcab0d6"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga16c945185e4eb5dcb9aac2be2fcab0d6">pn_messenger_recv</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, int limit)</td></tr> +<tr class="memdesc:ga16c945185e4eb5dcb9aac2be2fcab0d6"><td class="mdescLeft"> </td><td class="mdescRight">Retrieve messages into a messenger's incoming queue. <a href="#ga16c945185e4eb5dcb9aac2be2fcab0d6">More...</a><br /></td></tr> +<tr class="separator:ga16c945185e4eb5dcb9aac2be2fcab0d6"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gaf4e22c8cb1436891d42ca0a658fca9c5"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gaf4e22c8cb1436891d42ca0a658fca9c5">pn_messenger_receiving</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:gaf4e22c8cb1436891d42ca0a658fca9c5"><td class="mdescLeft"> </td><td class="mdescRight">Get the capacity of the incoming message queue of a messenger. <a href="#gaf4e22c8cb1436891d42ca0a658fca9c5">More...</a><br /></td></tr> +<tr class="separator:gaf4e22c8cb1436891d42ca0a658fca9c5"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gaa6d85929e4b4b574690927ddde00c540"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gaa6d85929e4b4b574690927ddde00c540">pn_messenger_get</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, <a class="el" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *message)</td></tr> +<tr class="memdesc:gaa6d85929e4b4b574690927ddde00c540"><td class="mdescLeft"> </td><td class="mdescRight">Get the next message from the head of a messenger's incoming queue. <a href="#gaa6d85929e4b4b574690927ddde00c540">More...</a><br /></td></tr> +<tr class="separator:gaa6d85929e4b4b574690927ddde00c540"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gafe31e771826f8107d93fc276c9715aab"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__messenger.html#gab1173cfe4bcaa0a530c8035dc75f42c7">pn_tracker_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gafe31e771826f8107d93fc276c9715aab">pn_messenger_incoming_tracker</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:gafe31e771826f8107d93fc276c9715aab"><td class="mdescLeft"> </td><td class="mdescRight">Get a tracker for the message most recently retrieved by <a class="el" href="group__messenger.html#gaa6d85929e4b4b574690927ddde00c540" title="Get the next message from the head of a messenger's incoming queue. ">pn_messenger_get()</a>. <a href="#gafe31e771826f8107d93fc276c9715aab">More...</a><br /></td></tr> +<tr class="separator:gafe31e771826f8107d93fc276c9715aab"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gae351d031d2ef29bdb137a59d461c4253"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__messenger.html#gabd73703511b9dae193765e9e57864291">pn_subscription_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gae351d031d2ef29bdb137a59d461c4253">pn_messenger_incoming_subscription</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:gae351d031d2ef29bdb137a59d461c4253"><td class="mdescLeft"> </td><td class="mdescRight">Get the subscription of the message most recently retrieved by <a class="el" href="group__messenger.html#gaa6d85929e4b4b574690927ddde00c540" title="Get the next message from the head of a messenger's incoming queue. ">pn_messenger_get()</a>. <a href="#gae351d031d2ef29bdb137a59d461c4253">More...</a><br /></td></tr> +<tr class="separator:gae351d031d2ef29bdb137a59d461c4253"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga11cd0d3423482e1ddda7a8b0cbb581c7"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga11cd0d3423482e1ddda7a8b0cbb581c7">pn_messenger_accept</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, <a class="el" href="group__messenger.html#gab1173cfe4bcaa0a530c8035dc75f42c7">pn_tracker_t</a> tracker, int flags)</td></tr> +<tr class="memdesc:ga11cd0d3423482e1ddda7a8b0cbb581c7"><td class="mdescLeft"> </td><td class="mdescRight">Signal successful processing of message(s). <a href="#ga11cd0d3423482e1ddda7a8b0cbb581c7">More...</a><br /></td></tr> +<tr class="separator:ga11cd0d3423482e1ddda7a8b0cbb581c7"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga22d6de108fa967a43ab2473d6a915e9c"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga22d6de108fa967a43ab2473d6a915e9c">pn_messenger_reject</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, <a class="el" href="group__messenger.html#gab1173cfe4bcaa0a530c8035dc75f42c7">pn_tracker_t</a> tracker, int flags)</td></tr> +<tr class="memdesc:ga22d6de108fa967a43ab2473d6a915e9c"><td class="mdescLeft"> </td><td class="mdescRight">Signal unsuccessful processing of message(s). <a href="#ga22d6de108fa967a43ab2473d6a915e9c">More...</a><br /></td></tr> +<tr class="separator:ga22d6de108fa967a43ab2473d6a915e9c"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gae4e5e89c6ea2a820a221af61cc741c7d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__link.html#ga89dad3aa7934329a7ff467c636687bc0">pn_link_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gae4e5e89c6ea2a820a221af61cc741c7d">pn_messenger_tracker_link</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, <a class="el" href="group__messenger.html#gab1173cfe4bcaa0a530c8035dc75f42c7">pn_tracker_t</a> tracker)</td></tr> +<tr class="memdesc:gae4e5e89c6ea2a820a221af61cc741c7d"><td class="mdescLeft"> </td><td class="mdescRight">Get link for the message referenced by the given tracker. <a href="#gae4e5e89c6ea2a820a221af61cc741c7d">More...</a><br /></td></tr> +<tr class="separator:gae4e5e89c6ea2a820a221af61cc741c7d"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga06c3a066422f8a966523b43a61f62eb9"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga06c3a066422f8a966523b43a61f62eb9">pn_messenger_outgoing</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga06c3a066422f8a966523b43a61f62eb9"><td class="mdescLeft"> </td><td class="mdescRight">Get the number of messages in the outgoing message queue of a messenger. <a href="#ga06c3a066422f8a966523b43a61f62eb9">More...</a><br /></td></tr> +<tr class="separator:ga06c3a066422f8a966523b43a61f62eb9"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga43cf91b5528c2729b3ff9ae1d2a7d257"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga43cf91b5528c2729b3ff9ae1d2a7d257">pn_messenger_incoming</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga43cf91b5528c2729b3ff9ae1d2a7d257"><td class="mdescLeft"> </td><td class="mdescRight">Get the number of messages in the incoming message queue of a messenger. <a href="#ga43cf91b5528c2729b3ff9ae1d2a7d257">More...</a><br /></td></tr> +<tr class="separator:ga43cf91b5528c2729b3ff9ae1d2a7d257"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga6c85a08d72ae73a18f9fb64ccf0c470e"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga6c85a08d72ae73a18f9fb64ccf0c470e">pn_messenger_route</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const char *pattern, const char *address)</td></tr> +<tr class="memdesc:ga6c85a08d72ae73a18f9fb64ccf0c470e"><td class="mdescLeft"> </td><td class="mdescRight">Adds a routing rule to a Messenger's internal routing table. <a href="#ga6c85a08d72ae73a18f9fb64ccf0c470e">More...</a><br /></td></tr> +<tr class="separator:ga6c85a08d72ae73a18f9fb64ccf0c470e"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gac7dc5d9b82f9e015fd2c7d9743099eff"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gac7dc5d9b82f9e015fd2c7d9743099eff">pn_messenger_rewrite</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const char *pattern, const char *address)</td></tr> +<tr class="memdesc:gac7dc5d9b82f9e015fd2c7d9743099eff"><td class="mdescLeft"> </td><td class="mdescRight">Rewrite message addresses prior to transmission. <a href="#gac7dc5d9b82f9e015fd2c7d9743099eff">More...</a><br /></td></tr> +<tr class="separator:gac7dc5d9b82f9e015fd2c7d9743099eff"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga8521b0999200c076bf12568ac10fe925"><td class="memItemLeft" align="right" valign="top">pn_selectable_t * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga8521b0999200c076bf12568ac10fe925">pn_messenger_selectable</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga8521b0999200c076bf12568ac10fe925"><td class="mdescLeft"> </td><td class="mdescRight">Extract selectables from a passive messenger. <a href="#ga8521b0999200c076bf12568ac10fe925">More...</a><br /></td></tr> +<tr class="separator:ga8521b0999200c076bf12568ac10fe925"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga223e7c16f3e84f4e573864c3881b3b4b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__amqp__types.html#gad337c365b498106064ec28e00e5fb6dd">pn_timestamp_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga223e7c16f3e84f4e573864c3881b3b4b">pn_messenger_deadline</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga223e7c16f3e84f4e573864c3881b3b4b"><td class="mdescLeft"> </td><td class="mdescRight">Get the nearest deadline for selectables associated with a messenger. <a href="#ga223e7c16f3e84f4e573864c3881b3b4b">More...</a><br /></td></tr> +<tr class="separator:ga223e7c16f3e84f4e573864c3881b3b4b"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gacf39b77df62750343e2f4e90dbcacc75"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gacf39b77df62750343e2f4e90dbcacc75">pn_messenger_set_flags</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const int flags)</td></tr> +<tr class="memdesc:gacf39b77df62750343e2f4e90dbcacc75"><td class="mdescLeft"> </td><td class="mdescRight">Sets control flags to enable additional function for the Messenger. <a href="#gacf39b77df62750343e2f4e90dbcacc75">More...</a><br /></td></tr> +<tr class="separator:gacf39b77df62750343e2f4e90dbcacc75"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga9f4e2fbfb7eb7bfd9acd7ad758d24085"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga9f4e2fbfb7eb7bfd9acd7ad758d24085">pn_messenger_get_flags</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger)</td></tr> +<tr class="memdesc:ga9f4e2fbfb7eb7bfd9acd7ad758d24085"><td class="mdescLeft"> </td><td class="mdescRight">Gets the flags for a Messenger. <a href="#ga9f4e2fbfb7eb7bfd9acd7ad758d24085">More...</a><br /></td></tr> +<tr class="separator:ga9f4e2fbfb7eb7bfd9acd7ad758d24085"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga7b0872d6712c53e307bf2babfd91bf6e"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga7b0872d6712c53e307bf2babfd91bf6e">pn_messenger_set_snd_settle_mode</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const <a class="el" href="group__link.html#ga3fb58bd0b88d37407ebb615c2630e608">pn_snd_settle_mode_t</a> mode)</td></tr> +<tr class="memdesc:ga7b0872d6712c53e307bf2babfd91bf6e"><td class="mdescLeft"> </td><td class="mdescRight">Set the local sender settle mode for the underlying link. <a href="#ga7b0872d6712c53e307bf2babfd91bf6e">More...</a><br /></td></tr> +<tr class="separator:ga7b0872d6712c53e307bf2babfd91bf6e"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:gae9f2d3ab15602b27f1b87a4f6349a9f1"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#gae9f2d3ab15602b27f1b87a4f6349a9f1">pn_messenger_set_rcv_settle_mode</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const <a class="el" href="group__link.html#gad1c2388cdae687be26222a5d66fd2d58">pn_rcv_settle_mode_t</a> mode)</td></tr> +<tr class="memdesc:gae9f2d3ab15602b27f1b87a4f6349a9f1"><td class="mdescLeft"> </td><td class="mdescRight">Set the local receiver settle mode for the underlying link. <a href="#gae9f2d3ab15602b27f1b87a4f6349a9f1">More...</a><br /></td></tr> +<tr class="separator:gae9f2d3ab15602b27f1b87a4f6349a9f1"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga6c2cfb88f59980bb13821a6f25cf30f6"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga6c2cfb88f59980bb13821a6f25cf30f6">pn_messenger_set_tracer</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, <a class="el" href="group__transport.html#gae9b49fcbf6397e6916eb4e1357c90ff3">pn_tracer_t</a> tracer)</td></tr> +<tr class="memdesc:ga6c2cfb88f59980bb13821a6f25cf30f6"><td class="mdescLeft"> </td><td class="mdescRight">Set the tracer associated with a messenger. <a href="#ga6c2cfb88f59980bb13821a6f25cf30f6">More...</a><br /></td></tr> +<tr class="separator:ga6c2cfb88f59980bb13821a6f25cf30f6"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga9be25d57cda5a6e1c5658b0f362c41c7"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__api__types.html#ga9a701bc6dc9af9f42c3f4679172a723c">pn_millis_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga9be25d57cda5a6e1c5658b0f362c41c7">pn_messenger_get_remote_idle_timeout</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const char *address)</td></tr> +<tr class="memdesc:ga9be25d57cda5a6e1c5658b0f362c41c7"><td class="mdescLeft"> </td><td class="mdescRight">Gets the remote idle timeout for the specified remote service address. <a href="#ga9be25d57cda5a6e1c5658b0f362c41c7">More...</a><br /></td></tr> +<tr class="separator:ga9be25d57cda5a6e1c5658b0f362c41c7"><td class="memSeparator" colspan="2"> </td></tr> +<tr class="memitem:ga59ebaf21eaafaa4b1c359e4284564ff6"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__messenger.html#ga59ebaf21eaafaa4b1c359e4284564ff6">pn_messenger_set_ssl_peer_authentication_mode</a> (<a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> *messenger, const <a class="el" href="group__ssl.html#gae5e33024ed6af3432d4c76d1484d7ecb">pn_ssl_verify_mode_t</a> mode)</td></tr> +<tr class="memdesc:ga59ebaf21eaafaa4b1c359e4284564ff6"><td class="mdescLeft"> </td><td class="mdescRight">Sets the SSL peer authentication mode required when a trust certificate is used. <a href="#ga59ebaf21eaafaa4b1c359e4284564ff6">More...</a><br /></td></tr> +<tr class="separator:ga59ebaf21eaafaa4b1c359e4284564ff6"><td class="memSeparator" colspan="2"> </td></tr> +</table> +<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> +<p><b>Deprecated</b> - Use the <a class="el" href="group__proactor.html">Proactor</a> API or Qpid Proton C++. </p> +<h2 class="groupheader">Typedef Documentation</h2> +<a id="ga0d342bb795d48591ad6b3f867766b8b1"></a> +<h2 class="memtitle"><span class="permalink"><a href="#ga0d342bb795d48591ad6b3f867766b8b1">◆ </a></span>pn_messenger_t</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">typedef struct <a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> <a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>A <a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1" title="A pn_messenger_t provides a high level interface for sending and receiving messages (See pn_message_t...">pn_messenger_t</a> provides a high level interface for sending and receiving messages (See <a class="el" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2" title="An AMQP Message object. ">pn_message_t</a>). </p> +<p>Every messenger contains a single logical queue of incoming messages and a single logical queue of outgoing messages. The messages in these queues may be destined for, or originate from, a variety of addresses.</p> +<p>The messenger interface is single-threaded. All methods except one (<a class="el" href="group__messenger.html#ga9da14c67acc17bc5fec6f34e2749534f" title="Interrupt a messenger object that may be blocking in another thread. ">pn_messenger_interrupt()</a>) are intended to be used by one thread at a time.</p> +<h1>Address Syntax </h1> +<p>An address has the following form::</p> +<p>[ amqp[s]:// ] [user[:password]@] domain [/[name]]</p> +<p>Where domain can be one of::</p> +<p>host | host:port | ip | ip:port | name</p> +<p>The following are valid examples of addresses:</p> +<ul> +<li>example.org</li> +<li>example.org:1234</li> +<li>amqp://example.org</li> +<li>amqps://example.org</li> +<li>example.org/incoming</li> +<li>amqps://example.org/outgoing</li> +<li>amqps://fred:<a href="#" onclick="location.href='mai'+'lto:'+'tru'+'st'+'no1'+'@e'+'xam'+'pl'+'e.o'+'rg'; return false;">trust<span style="display: none;">.nosp@m.</span>no1@<span style="display: none;">.nosp@m.</span>examp<span style="display: none;">.nosp@m.</span>le.o<span style="display: none;">.nosp@m.</span>rg</a></li> +<li>127.0.0.1:1234</li> +<li>amqps://127.0.0.1:1234</li> +</ul> +<h1>Sending & Receiving Messages </h1> +<p>The messenger API works in conjunction with the <a class="el" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2" title="An AMQP Message object. ">pn_message_t</a> API. A <a class="el" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2" title="An AMQP Message object. ">pn_message_t</a> is a mutable holder of message content.</p> +<p>The <a class="el" href="group__messenger.html#gafede68af29484d50d531cc48ab0d3d4a" title="Puts a message onto the messenger's outgoing queue. ">pn_messenger_put()</a> operation copies content from the supplied <a class="el" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2" title="An AMQP Message object. ">pn_message_t</a> to the outgoing queue, and may send queued messages if it can do so without blocking. The <a class="el" href="group__messenger.html#gae31f9a99dcbedffe83588cf25b805325" title="Send messages from a messenger's outgoing queue. ">pn_messenger_send()</a> operation blocks until it has sent the requested number of messages, or until a timeout interrupts the attempt.</p> +<p>pn_messenger_t *messenger = pn_messenger(NULL); pn_message_t *message = <a class="el" href="group__message.html#gaaf98d84b9ddc1c6537dddd4c9c5b979e" title="Construct a new pn_message_t. ">pn_message()</a>; char subject[1024]; for (int i = 0; i < 3; i++) { pn_message_set_address(message, "amqp://host/queue"); sprintf(subject, "Hello World! %i", i); pn_message_set_subject(message, subject); pn_messenger_put(messenger, message) pn_messenger_send(messenger);</p> +<p>Similarly, the <a class="el" href="group__messenger.html#ga16c945185e4eb5dcb9aac2be2fcab0d6" title="Retrieve messages into a messenger's incoming queue. ">pn_messenger_recv()</a> method receives messages into the incoming queue, and may block as it attempts to receive up to the requested number of messages, or until the timeout is reached. It may receive fewer than the requested number. The <a class="el" href="group__messenger.html#gaa6d85929e4b4b574690927ddde00c540" title="Get the next message from the head of a messenger's incoming queue. ">pn_messenger_get()</a> method pops the eldest message off the incoming queue and copies its content into the supplied <a class="el" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2" title="An AMQP Message object. ">pn_message_t</a> object. It will not block.</p> +<p>pn_messenger_t *messenger = pn_messenger(NULL); pn_message_t *message = <a class="el" href="group__message.html#gaaf98d84b9ddc1c6537dddd4c9c5b979e" title="Construct a new pn_message_t. ">pn_message()</a> pn_messenger_recv(messenger): while (pn_messenger_incoming(messenger) > 0) { pn_messenger_get(messenger, message); printf("%s", message.subject); }</p> +<p>Output: Hello World 0 Hello World 1 Hello World 2</p> +<p>The blocking flag allows you to turn off blocking behavior entirely, in which case <a class="el" href="group__messenger.html#gae31f9a99dcbedffe83588cf25b805325" title="Send messages from a messenger's outgoing queue. ">pn_messenger_send()</a> and <a class="el" href="group__messenger.html#ga16c945185e4eb5dcb9aac2be2fcab0d6" title="Retrieve messages into a messenger's incoming queue. ">pn_messenger_recv()</a> will do whatever they can without blocking, and then return. You can then look at the number of incoming and outgoing messages to see how much outstanding work still remains.</p> +<h1>Authentication Mechanisms </h1> +<p>The messenger API authenticates using some specific mechanisms. In prior versions of Proton the only authentication mechanism available was the PLAIN mechanism which transports the user's password over the network unencrypted. The Proton versions 0.10 and newer support other more secure mechanisms which avoid sending the users's password over the network unencrypted. For backwards compatibility the 0.10 version of the messenger API will also allow the use of the unencrypted PLAIN mechanism. From the 0.11 version and onwards you will need to set the flag PN_FLAGS_ALLOW_INSECURE_MECHS to carry on using the unencrypted PLAIN mechanism.</p> +<p>The code for this looks like:</p> +<p>... pn_messenger_set_flags(messenger, PN_FLAGS_ALLOW_INSECURE_MECHS); ...</p> +<p>Note that the use of the PLAIN mechanism over an SSL connection is allowed as the password is not sent unencrypted. </p> + +</div> +</div> +<a id="gabd73703511b9dae193765e9e57864291"></a> +<h2 class="memtitle"><span class="permalink"><a href="#gabd73703511b9dae193765e9e57864291">◆ </a></span>pn_subscription_t</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">typedef struct <a class="el" href="group__messenger.html#gabd73703511b9dae193765e9e57864291">pn_subscription_t</a> <a class="el" href="group__messenger.html#gabd73703511b9dae193765e9e57864291">pn_subscription_t</a></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>A subscription is a request for incoming messages. </p> + +</div> +</div> +<h2 class="groupheader">Enumeration Type Documentation</h2> +<a id="ga242e4ee54b9c0a416443c7da5f6e045b"></a> +<h2 class="memtitle"><span class="permalink"><a href="#ga242e4ee54b9c0a416443c7da5f6e045b">◆ </a></span>pn_status_t</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">enum <a class="el" href="group__messenger.html#ga242e4ee54b9c0a416443c7da5f6e045b">pn_status_t</a></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Describes all the possible states for a message associated with a given tracker. </p> +<table class="fieldtable"> +<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="gga242e4ee54b9c0a416443c7da5f6e045ba0b46b1041679460baaba2ddcdb2173f2"></a>PN_STATUS_UNKNOWN </td><td class="fielddoc"><p>The tracker is unknown. </p> +</td></tr> +<tr><td class="fieldname"><a id="gga242e4ee54b9c0a416443c7da5f6e045ba4b0354a77173cd75c69159e15c23f611"></a>PN_STATUS_PENDING </td><td class="fielddoc"><p>The message is in flight. </p> +<p>For outgoing messages, use <a class="el" href="group__messenger.html#ga15adeb707f15b86df1e5486c34a060e6" title="Check if the delivery associated with a given tracker is still waiting to be sent. ">pn_messenger_buffered</a> to see if it has been sent or not. </p> +</td></tr> +<tr><td class="fieldname"><a id="gga242e4ee54b9c0a416443c7da5f6e045ba693fd9044a50a4f02e842d04a4bf1467"></a>PN_STATUS_ACCEPTED </td><td class="fielddoc"><p>The message was accepted. </p> +</td></tr> +<tr><td class="fieldname"><a id="gga242e4ee54b9c0a416443c7da5f6e045baf109df703952744009b3547f3b8f32bf"></a>PN_STATUS_REJECTED </td><td class="fielddoc"><p>The message was rejected. </p> +</td></tr> +<tr><td class="fieldname"><a id="gga242e4ee54b9c0a416443c7da5f6e045ba67079750477effb7935df83381c47852"></a>PN_STATUS_RELEASED </td><td class="fielddoc"><p>The message was released. </p> +</td></tr> +<tr><td class="fieldname"><a id="gga242e4ee54b9c0a416443c7da5f6e045ba77d94a6b6b745eef9307f144b57e81e8"></a>PN_STATUS_MODIFIED </td><td class="fielddoc"><p>The message was modified. </p> +</td></tr> +<tr><td class="fieldname"><a id="gga242e4ee54b9c0a416443c7da5f6e045ba1239e8ada7eabe2aeab98f2c881cd2ee"></a>PN_STATUS_ABORTED </td><td class="fielddoc"><p>The message was aborted. </p> +</td></tr> +<tr><td class="fieldname"><a id="gga242e4ee54b9c0a416443c7da5f6e045ba1181bc7f51502ae11ed240866cd64583"></a>PN_STATUS_SETTLED </td><td class="fielddoc"><p>The remote party has settled the message. </p> +</td></tr> +</table> + +</div> +</div> +<h2 class="groupheader">Function Documentation</h2> +<a id="gabe045d16ca8eb1e3cc87387e2ae82433"></a> +<h2 class="memtitle"><span class="permalink"><a href="#gabe045d16ca8eb1e3cc87387e2ae82433">◆ </a></span>pn_messenger()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a>* pn_messenger </td> + <td>(</td> + <td class="paramtype">const char * </td> + <td class="paramname"><em>name</em></td><td>)</td> + <td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Construct a new <a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1" title="A pn_messenger_t provides a high level interface for sending and receiving messages (See pn_message_t...">pn_messenger_t</a> with the given name. </p> +<p>The name is global. If a NULL name is supplied, a UUID based name will be chosen.</p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">name</td><td>the name of the messenger or NULL</td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>pointer to a new <a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1" title="A pn_messenger_t provides a high level interface for sending and receiving messages (See pn_message_t...">pn_messenger_t</a> </dd></dl> + +</div> +</div> +<a id="ga71197163a69770575df74e3cee617429"></a> +<h2 class="memtitle"><span class="permalink"><a href="#ga71197163a69770575df74e3cee617429">◆ </a></span>pn_messenger_name()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">const char* pn_messenger_name </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em></td><td>)</td> + <td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Get the name of a messenger. </p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>a messenger object </td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>the name of the messenger </dd></dl> + +</div> +</div> +<a id="gad61fff52c28501171ecbb0b21bbde954"></a> +<h2 class="memtitle"><span class="permalink"><a href="#gad61fff52c28501171ecbb0b21bbde954">◆ </a></span>pn_messenger_set_certificate()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">int pn_messenger_set_certificate </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">const char * </td> + <td class="paramname"><em>certificate</em> </td> + </tr> + <tr> + <td></td> + <td>)</td> + <td></td><td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Sets the path that will be used to get the certificate that will be used to identify this messenger to its peers. </p> +<p>The validity of the path is not checked by this function.</p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>the messenger </td></tr> + <tr><td class="paramdir">[in]</td><td class="paramname">certificate</td><td>a path to a certificate file </td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>an error code of zero if there is no error </dd></dl> + +</div> +</div> +<a id="ga1d0c003a1fb5e20b894e2deb8b43118b"></a> +<h2 class="memtitle"><span class="permalink"><a href="#ga1d0c003a1fb5e20b894e2deb8b43118b">◆ </a></span>pn_messenger_get_certificate()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">const char* pn_messenger_get_certificate </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em></td><td>)</td> + <td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Get the certificate path. </p> +<p>This value may be set by pn_messenger_set_certificate. The default certificate path is null.</p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>the messenger </td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>the certificate file path </dd></dl> + +</div> +</div> +<a id="ga05f059a2fe93e0acbcf76e494e6bf958"></a> +<h2 class="memtitle"><span class="permalink"><a href="#ga05f059a2fe93e0acbcf76e494e6bf958">◆ </a></span>pn_messenger_set_private_key()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">int pn_messenger_set_private_key </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">const char * </td> + <td class="paramname"><em>private_key</em> </td> + </tr> + <tr> + <td></td> + <td>)</td> + <td></td><td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Set path to the private key that was used to sign the certificate. </p> +<p>See <a class="el" href="group__messenger.html#gad61fff52c28501171ecbb0b21bbde954" title="Sets the path that will be used to get the certificate that will be used to identify this messenger t...">pn_messenger_set_certificate</a></p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>a messenger object </td></tr> + <tr><td class="paramdir">[in]</td><td class="paramname">private_key</td><td>a path to a private key file </td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>an error code of zero if there is no error </dd></dl> + +</div> +</div> +<a id="gab692f989aed2aa83bd71b7fa7196aeb1"></a> +<h2 class="memtitle"><span class="permalink"><a href="#gab692f989aed2aa83bd71b7fa7196aeb1">◆ </a></span>pn_messenger_get_private_key()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">const char* pn_messenger_get_private_key </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em></td><td>)</td> + <td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Gets the private key file for a messenger. </p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>a messenger object </td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>the messenger's private key file path </dd></dl> + +</div> +</div> +<a id="ga6b04f7dea2ed8752b8672b4cfe0330f2"></a> +<h2 class="memtitle"><span class="permalink"><a href="#ga6b04f7dea2ed8752b8672b4cfe0330f2">◆ </a></span>pn_messenger_set_password()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">int pn_messenger_set_password </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">const char * </td> + <td class="paramname"><em>password</em> </td> + </tr> + <tr> + <td></td> + <td>)</td> + <td></td><td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Sets the private key password for a messenger. </p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>a messenger object </td></tr> + <tr><td class="paramdir">[in]</td><td class="paramname">password</td><td>the password for the private key file</td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>an error code of zero if there is no error </dd></dl> + +</div> +</div> +<a id="ga3f02ad7340a59c5982e6223aaeea803a"></a> +<h2 class="memtitle"><span class="permalink"><a href="#ga3f02ad7340a59c5982e6223aaeea803a">◆ </a></span>pn_messenger_get_password()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">const char* pn_messenger_get_password </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em></td><td>)</td> + <td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Gets the private key file password for a messenger. </p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>a messenger object </td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>password for the private key file </dd></dl> + +</div> +</div> +<a id="gad901e92e2bee6d5371dcd3b1c8fe2c3b"></a> +<h2 class="memtitle"><span class="permalink"><a href="#gad901e92e2bee6d5371dcd3b1c8fe2c3b">◆ </a></span>pn_messenger_set_trusted_certificates()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">int pn_messenger_set_trusted_certificates </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">const char * </td> + <td class="paramname"><em>cert_db</em> </td> + </tr> + <tr> + <td></td> + <td>)</td> + <td></td><td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Sets the trusted certificates database for a messenger. </p> +<p>The messenger will use this database to validate the certificate provided by the peer.</p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>a messenger object </td></tr> + <tr><td class="paramdir">[in]</td><td class="paramname">cert_db</td><td>a path to the certificates database</td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>an error code of zero if there is no error </dd></dl> + +</div> +</div> +<a id="ga955b218a8f58560e9e228ca14fba21f2"></a> +<h2 class="memtitle"><span class="permalink"><a href="#ga955b218a8f58560e9e228ca14fba21f2">◆ </a></span>pn_messenger_get_trusted_certificates()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">const char* pn_messenger_get_trusted_certificates </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em></td><td>)</td> + <td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Gets the trusted certificates database for a messenger. </p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>a messenger object </td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>path to the trusted certificates database </dd></dl> + +</div> +</div> +<a id="ga04119bb2b16bb0f657f1dbcf73827d74"></a> +<h2 class="memtitle"><span class="permalink"><a href="#ga04119bb2b16bb0f657f1dbcf73827d74">◆ </a></span>pn_messenger_set_timeout()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">int pn_messenger_set_timeout </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em>, </td> + </tr> + <tr> + <td class="paramkey"></td> + <td></td> + <td class="paramtype">int </td> + <td class="paramname"><em>timeout</em> </td> + </tr> + <tr> + <td></td> + <td>)</td> + <td></td><td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Set the default timeout for a messenger. </p> +<p>Any messenger call that blocks during execution will stop blocking and return control when this timeout is reached, if you have set it to a value greater than zero. The timeout is expressed in milliseconds.</p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>a messenger object </td></tr> + <tr><td class="paramdir">[in]</td><td class="paramname">timeout</td><td>a new timeout for the messenger, in milliseconds </td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>an error code or zero if there is no error </dd></dl> + +</div> +</div> +<a id="ga083ba6296a1ae1dfe45c0fb82da823eb"></a> +<h2 class="memtitle"><span class="permalink"><a href="#ga083ba6296a1ae1dfe45c0fb82da823eb">◆ </a></span>pn_messenger_get_timeout()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">int pn_messenger_get_timeout </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em></td><td>)</td> + <td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Gets the timeout for a messenger object. </p> +<p>See <a class="el" href="group__messenger.html#ga04119bb2b16bb0f657f1dbcf73827d74" title="Set the default timeout for a messenger. ">pn_messenger_set_timeout()</a> for details.</p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>a messenger object </td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>the timeout for the messenger, in milliseconds </dd></dl> + +</div> +</div> +<a id="gaf572cbf224105d08898d2906336712f7"></a> +<h2 class="memtitle"><span class="permalink"><a href="#gaf572cbf224105d08898d2906336712f7">◆ </a></span>pn_messenger_is_blocking()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class="memname">bool pn_messenger_is_blocking </td> + <td>(</td> + <td class="paramtype"><a class="el" href="group__messenger.html#ga0d342bb795d48591ad6b3f867766b8b1">pn_messenger_t</a> * </td> + <td class="paramname"><em>messenger</em></td><td>)</td> + <td></td> + </tr> + </table> +</div><div class="memdoc"> + +<p>Check if a messenger is in blocking mode. </p> +<dl class="params"><dt>Parameters</dt><dd> + <table class="params"> + <tr><td class="paramdir">[in]</td><td class="paramname">messenger</td><td>a messenger object </td></tr> + </table> + </dd> +</dl> +<dl class="section return"><dt>Returns</dt><dd>true if blocking has been enabled, false otherwise </dd></dl> + +</div> +</div> +<a id="gae9d7f1aec6e2cf3ef1ee326a4ae15981"></a> +<h2 class="memtitle"><span class="permalink"><a href="#gae9d7f1aec6e2cf3ef1ee326a4ae15981">◆ </a></span>pn_messenger_set_blocking()</h2> + +<div class="memitem"> +<div class="memproto"> + <table class="memname"> + <tr> + <td class=
<TRUNCATED> --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@qpid.apache.org For additional commands, e-mail: commits-h...@qpid.apache.org
