http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a1891eca/content/proton/overview.html ---------------------------------------------------------------------- diff --git a/content/proton/overview.html b/content/proton/overview.html new file mode 100644 index 0000000..525834e --- /dev/null +++ b/content/proton/overview.html @@ -0,0 +1,177 @@ +<!DOCTYPE html> +<!-- + - + - Licensed to the Apache Software Foundation (ASF) under one + - or more contributor license agreements. See the NOTICE file + - distributed with this work for additional information + - regarding copyright ownership. The ASF licenses this file + - to you under the Apache License, Version 2.0 (the + - "License"); you may not use this file except in compliance + - with the License. You may obtain a copy of the License at + - + - http://www.apache.org/licenses/LICENSE-2.0 + - + - Unless required by applicable law or agreed to in writing, + - software distributed under the License is distributed on an + - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + - KIND, either express or implied. See the License for the + - specific language governing permissions and limitations + - under the License. + - +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en"> + <head> + <title>Overview - Apache Qpid™</title> + <meta http-equiv="X-UA-Compatible" content="IE=edge"/> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> + <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> + <script type="text/javascript">var _deferredFunctions = [];</script> + <script type="text/javascript" src="/deferred.js" defer="defer"></script> + <!--[if lte IE 8]> + <link rel="stylesheet" href="/ie.css" type="text/css"/> + <script type="text/javascript" src="/html5shiv.js"></script> + <![endif]--> + + <!-- Redirects for `go get` and godoc.org --> + <meta name="go-import" + content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/> + <meta name="go-source" + content="qpid.apache.org +https://github.com/apache/qpid-proton/blob/go1/README.md +https://github.com/apache/qpid-proton/tree/go1{/dir} +https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/> + </head> + <body> + <div id="-content"> + <div id="-top" class="panel"> + <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a> + + <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a> + + <ul id="-global-navigation"> + <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> + <li><a href="/documentation.html">Documentation</a></li> + <li><a href="/download.html">Download</a></li> + <li><a href="/discussion.html">Discussion</a></li> + </ul> + </div> + + <div id="-menu" class="panel" style="display: none;"> + <div class="flex"> + <section> + <h3>Project</h3> + + <ul> + <li><a href="/overview.html">Overview</a></li> + <li><a href="/components/index.html">Components</a></li> + <li><a href="/releases/index.html">Releases</a></li> + </ul> + </section> + + <section> + <h3>Messaging APIs</h3> + + <ul> + <li><a href="/proton/index.html">Qpid Proton</a></li> + <li><a href="/components/jms/index.html">Qpid JMS</a></li> + <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li> + </ul> + </section> + + <section> + <h3>Servers and tools</h3> + + <ul> + <li><a href="/components/java-broker/index.html">Java broker</a></li> + <li><a href="/components/cpp-broker/index.html">C++ broker</a></li> + <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li> + </ul> + </section> + + <section> + <h3>Resources</h3> + + <ul> + <li><a href="/dashboard.html">Dashboard</a></li> + <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li> + <li><a href="/resources.html">More resources</a></li> + </ul> + </section> + </div> + </div> + + <div id="-search" class="panel" style="display: none;"> + <form action="http://www.google.com/search"; method="get"> + <input type="hidden" name="sitesearch" value="qpid.apache.org"/> + <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> + <button type="submit">Search</button> + <a href="/search.html">More ways to search</a> + </form> + </div> + + <div id="-middle" class="panel"> + <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/proton/index.html">Qpid Proton</a></li><li>Overview</li></ul> + + <div id="-middle-content"> + <h1 id="overview">Overview</h1> + +<p>The goal of Proton is to provide ubiquitous access to a global-scale +interoperable message bus based on AMQP 1.0. At its core Proton +provides three parallel implementations of the AMQP 1.0 protocol, one +in C, one in Java, and one in Javascript. These implementations all +share the same architecture and interface and are rigorously tested +against a single common test suite to guarantee identical +behavior. These three implementations serve as the basis for +delivering protocol access to a wide variety of environments.</p> + +<p>The common architecture used by the protocol engines is designed to be +a suitable basis for both high performance-network servers and simple +clients, and to be usable in both threaded and non-threaded +contexts. In short, with the use of binding tools such as SWIG, it is +the goal of Proton to make it trivial for any application to speak +AMQP 1.0 regardless of language, platform, or environment.</p> + +<ul> +<li><p><em>Universal</em> - Proton is designed to scale both up and down. Equally +suitable for simple clients or high-powered servers, it can be +deployed in simple peer-to-peer configurations or as part of a +global federated messaging network.</p></li> +<li><p><em>Embeddable</em> - Proton is carefully written to be portable and cross +platform. It has minimal dependencies, and it is architected to be +usable with any threading model, as well as with non-threaded +applications. These features make it uniquely suited for embedding +messaging capabilities into existing software.</p></li> +<li><p><em>Standard</em> - Built around the AMQP 1.0 messaging standard, Proton +is not only ideal for building out your own messaging applications +but also for connecting them to the broader ecosystem of AMQP +1.0-based messaging applications.</p></li> +</ul> + + + <hr/> + + <ul id="-apache-navigation"> + <li><a href="http://www.apache.org/";>Apache</a></li> + <li><a href="http://www.apache.org/licenses/";>License</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li> + <li><a href="http://www.apache.org/security/";>Security</a></li> + <li><a href="http://www.apache.org/";><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li> + </ul> + + <p id="-legal"> + Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache + License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners + </p> + </div> + </div> + </div> + </body> +</html>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a1891eca/content/proton/proton-j-proton-c.html ---------------------------------------------------------------------- diff --git a/content/proton/proton-j-proton-c.html b/content/proton/proton-j-proton-c.html new file mode 100644 index 0000000..cde0e30 --- /dev/null +++ b/content/proton/proton-j-proton-c.html @@ -0,0 +1,193 @@ +<!DOCTYPE html> +<!-- + - + - Licensed to the Apache Software Foundation (ASF) under one + - or more contributor license agreements. See the NOTICE file + - distributed with this work for additional information + - regarding copyright ownership. The ASF licenses this file + - to you under the Apache License, Version 2.0 (the + - "License"); you may not use this file except in compliance + - with the License. You may obtain a copy of the License at + - + - http://www.apache.org/licenses/LICENSE-2.0 + - + - Unless required by applicable law or agreed to in writing, + - software distributed under the License is distributed on an + - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + - KIND, either express or implied. See the License for the + - specific language governing permissions and limitations + - under the License. + - +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en"> + <head> + <title>Proton-J/Proton-C - Apache Qpid™</title> + <meta http-equiv="X-UA-Compatible" content="IE=edge"/> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> + <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> + <script type="text/javascript">var _deferredFunctions = [];</script> + <script type="text/javascript" src="/deferred.js" defer="defer"></script> + <!--[if lte IE 8]> + <link rel="stylesheet" href="/ie.css" type="text/css"/> + <script type="text/javascript" src="/html5shiv.js"></script> + <![endif]--> + + <!-- Redirects for `go get` and godoc.org --> + <meta name="go-import" + content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/> + <meta name="go-source" + content="qpid.apache.org +https://github.com/apache/qpid-proton/blob/go1/README.md +https://github.com/apache/qpid-proton/tree/go1{/dir} +https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/> + </head> + <body> + <div id="-content"> + <div id="-top" class="panel"> + <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a> + + <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a> + + <ul id="-global-navigation"> + <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> + <li><a href="/documentation.html">Documentation</a></li> + <li><a href="/download.html">Download</a></li> + <li><a href="/discussion.html">Discussion</a></li> + </ul> + </div> + + <div id="-menu" class="panel" style="display: none;"> + <div class="flex"> + <section> + <h3>Project</h3> + + <ul> + <li><a href="/overview.html">Overview</a></li> + <li><a href="/components/index.html">Components</a></li> + <li><a href="/releases/index.html">Releases</a></li> + </ul> + </section> + + <section> + <h3>Messaging APIs</h3> + + <ul> + <li><a href="/proton/index.html">Qpid Proton</a></li> + <li><a href="/components/jms/index.html">Qpid JMS</a></li> + <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li> + </ul> + </section> + + <section> + <h3>Servers and tools</h3> + + <ul> + <li><a href="/components/java-broker/index.html">Java broker</a></li> + <li><a href="/components/cpp-broker/index.html">C++ broker</a></li> + <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li> + </ul> + </section> + + <section> + <h3>Resources</h3> + + <ul> + <li><a href="/dashboard.html">Dashboard</a></li> + <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li> + <li><a href="/resources.html">More resources</a></li> + </ul> + </section> + </div> + </div> + + <div id="-search" class="panel" style="display: none;"> + <form action="http://www.google.com/search"; method="get"> + <input type="hidden" name="sitesearch" value="qpid.apache.org"/> + <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> + <button type="submit">Search</button> + <a href="/search.html">More ways to search</a> + </form> + </div> + + <div id="-middle" class="panel"> + <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/proton/index.html">Qpid Proton</a></li><li>Proton-J/Proton-C</li></ul> + + <div id="-middle-content"> + <h1 id="proton-jproton-c">Proton-J/Proton-C</h1> + +<p>If you're new to proton development, you might be wondering why there +are two apparently independent projects (proton-c and proton-j) that +share the same git repo and release cycle.</p> + +<p>These projects aren't actually quite as independent as they look. +There is a common test suite that runs against both implementations to +help keep them in sync with each other. This is the python test suite +that lives underneath the top level <a href="https://git-wip-us.apache.org/repos/asf?p=qpid-proton.git;a=tree;f=tests/python";>tests/python</a> +directory. These tests have been integrated into the maven build via +jython so that the whole java build looks like a normal maven build +and java developers don't need to deal with cmake or getting jython +themselves or anything that's outside of the normal java experience.</p> + +<p>Likewise, the cmake build will detect if java is unavailable and opt +out of building the java code, so it's easy for C developers to +pretend that Java doesn't exist. It also does this for all the +different bindings, e.g. if perl or ruby isn't installed it will not +attempt to build them.</p> + +<p>As a core proton developer, it's a good idea to make a point of having +all the optional stuff enabled. This will ensure that you are testing +any of your changes against the widest range of code possible.</p> + +<p>It's also good to be aware of exactly how the common test suite +integrates with both proton-c and proton-j. The python binding +actually consists of a hand written wrapper layer that encapsulates +the raw swig generated API. The raw swig API is actually much lower +level and is available in the 'cproton' module. When you run the +python test suite in jython, the swig generated cproton doesn't +actually exist since it is a C module. Instead, you get the cproton.py +that resides in the java source tree underneath +<a href="https://git-wip-us.apache.org/repos/asf?p=qpid-proton.git;a=tree;f=proton-j/src/main/resources";>proton-j/src/main/resources</a>. +This cproton.py and its dependent files serve as a shim that adapts +between the Java API and the C API. These files can actually be quite +handy as a reference for how to translate a given idiom from proton-j +into proton-c or vice versa.</p> + +<p>You might notice some parts of the shim are stubbed out, e.g. like +this:</p> + +<pre><code>def pn_flowcontroller(window): + raise Skipped() +</code></pre> + +<p>Throwing a Skipped exception will signal to the test runner that +whatever code is being called is not available, and the test will be +reported as "skipped" rather than flagged as an error.</p> + + + <hr/> + + <ul id="-apache-navigation"> + <li><a href="http://www.apache.org/";>Apache</a></li> + <li><a href="http://www.apache.org/licenses/";>License</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li> + <li><a href="http://www.apache.org/security/";>Security</a></li> + <li><a href="http://www.apache.org/";><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li> + </ul> + + <p id="-legal"> + Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache + License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners + </p> + </div> + </div> + </div> + </body> +</html> http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a1891eca/content/proton/submitting-patches.html ---------------------------------------------------------------------- diff --git a/content/proton/submitting-patches.html b/content/proton/submitting-patches.html new file mode 100644 index 0000000..c8a6a30 --- /dev/null +++ b/content/proton/submitting-patches.html @@ -0,0 +1,178 @@ +<!DOCTYPE html> +<!-- + - + - Licensed to the Apache Software Foundation (ASF) under one + - or more contributor license agreements. See the NOTICE file + - distributed with this work for additional information + - regarding copyright ownership. The ASF licenses this file + - to you under the Apache License, Version 2.0 (the + - "License"); you may not use this file except in compliance + - with the License. You may obtain a copy of the License at + - + - http://www.apache.org/licenses/LICENSE-2.0 + - + - Unless required by applicable law or agreed to in writing, + - software distributed under the License is distributed on an + - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + - KIND, either express or implied. See the License for the + - specific language governing permissions and limitations + - under the License. + - +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en"> + <head> + <title>Submitting Patches - Apache Qpid™</title> + <meta http-equiv="X-UA-Compatible" content="IE=edge"/> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> + <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> + <script type="text/javascript">var _deferredFunctions = [];</script> + <script type="text/javascript" src="/deferred.js" defer="defer"></script> + <!--[if lte IE 8]> + <link rel="stylesheet" href="/ie.css" type="text/css"/> + <script type="text/javascript" src="/html5shiv.js"></script> + <![endif]--> + + <!-- Redirects for `go get` and godoc.org --> + <meta name="go-import" + content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/> + <meta name="go-source" + content="qpid.apache.org +https://github.com/apache/qpid-proton/blob/go1/README.md +https://github.com/apache/qpid-proton/tree/go1{/dir} +https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/> + </head> + <body> + <div id="-content"> + <div id="-top" class="panel"> + <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a> + + <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a> + + <ul id="-global-navigation"> + <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> + <li><a href="/documentation.html">Documentation</a></li> + <li><a href="/download.html">Download</a></li> + <li><a href="/discussion.html">Discussion</a></li> + </ul> + </div> + + <div id="-menu" class="panel" style="display: none;"> + <div class="flex"> + <section> + <h3>Project</h3> + + <ul> + <li><a href="/overview.html">Overview</a></li> + <li><a href="/components/index.html">Components</a></li> + <li><a href="/releases/index.html">Releases</a></li> + </ul> + </section> + + <section> + <h3>Messaging APIs</h3> + + <ul> + <li><a href="/proton/index.html">Qpid Proton</a></li> + <li><a href="/components/jms/index.html">Qpid JMS</a></li> + <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li> + </ul> + </section> + + <section> + <h3>Servers and tools</h3> + + <ul> + <li><a href="/components/java-broker/index.html">Java broker</a></li> + <li><a href="/components/cpp-broker/index.html">C++ broker</a></li> + <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li> + </ul> + </section> + + <section> + <h3>Resources</h3> + + <ul> + <li><a href="/dashboard.html">Dashboard</a></li> + <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li> + <li><a href="/resources.html">More resources</a></li> + </ul> + </section> + </div> + </div> + + <div id="-search" class="panel" style="display: none;"> + <form action="http://www.google.com/search"; method="get"> + <input type="hidden" name="sitesearch" value="qpid.apache.org"/> + <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> + <button type="submit">Search</button> + <a href="/search.html">More ways to search</a> + </form> + </div> + + <div id="-middle" class="panel"> + <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/proton/index.html">Qpid Proton</a></li><li>Submitting Patches</li></ul> + + <div id="-middle-content"> + <h1 id="submitting-patches">Submitting Patches</h1> + +<p>All contributions are greatly appreciated, but the process can be +significantly streamlined by taking note of the following guidelines.</p> + +<h2 id="run-the-full-test-suite">Run the full test suite</h2> + +<p>Make sure the full test suite runs with your change in place. Even if +you think your change is very localized, there may be subtle +repurcussions that impact other parts of the code. If your change +causes the test suite to fail, then it can't be accepted until a more +complete fix is prepared.</p> + +<h2 id="keep-it-small">Keep it small</h2> + +<p>Most of the people that work on proton have a day job of some kind. If +reviewing a patch requires carving out multiple hours/days, then it is +much less likely to happen. On the other hand if the patch is neat, +self contained, and just works then it can be reviewed and applied +quite quickly.</p> + +<p>If you happen to have a larger body of work you'd like to contribute +and there is a good reason that it's difficult to break it down into +small pieces, that's ok too, but expect the whole process to take a +bit longer. In this situation you can help things along by providing +an outline/overview in english to make the work easier to digest.</p> + +<h2 id="keep-it-clean">Keep it clean</h2> + +<p>Extraneous whitespace can clutter up diffs and make them more +difficult to read than they need to be. It's generally good practice +to avoid introducing extraneous whitespace into files under source +control. Most editors can be configured to remove and/or display +extraneous whitespace automatically.</p> + + + <hr/> + + <ul id="-apache-navigation"> + <li><a href="http://www.apache.org/";>Apache</a></li> + <li><a href="http://www.apache.org/licenses/";>License</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li> + <li><a href="http://www.apache.org/security/";>Security</a></li> + <li><a href="http://www.apache.org/";><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li> + </ul> + + <p id="-legal"> + Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache + License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners + </p> + </div> + </div> + </div> + </body> +</html> http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a1891eca/content/releases/index.html ---------------------------------------------------------------------- diff --git a/content/releases/index.html b/content/releases/index.html new file mode 100644 index 0000000..b99f7ec --- /dev/null +++ b/content/releases/index.html @@ -0,0 +1,217 @@ +<!DOCTYPE html> +<!-- + - + - Licensed to the Apache Software Foundation (ASF) under one + - or more contributor license agreements. See the NOTICE file + - distributed with this work for additional information + - regarding copyright ownership. The ASF licenses this file + - to you under the Apache License, Version 2.0 (the + - "License"); you may not use this file except in compliance + - with the License. You may obtain a copy of the License at + - + - http://www.apache.org/licenses/LICENSE-2.0 + - + - Unless required by applicable law or agreed to in writing, + - software distributed under the License is distributed on an + - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + - KIND, either express or implied. See the License for the + - specific language governing permissions and limitations + - under the License. + - +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en"> + <head> + <title>Releases - Apache Qpid™</title> + <meta http-equiv="X-UA-Compatible" content="IE=edge"/> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> + <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> + <script type="text/javascript">var _deferredFunctions = [];</script> + <script type="text/javascript" src="/deferred.js" defer="defer"></script> + <!--[if lte IE 8]> + <link rel="stylesheet" href="/ie.css" type="text/css"/> + <script type="text/javascript" src="/html5shiv.js"></script> + <![endif]--> + + <!-- Redirects for `go get` and godoc.org --> + <meta name="go-import" + content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/> + <meta name="go-source" + content="qpid.apache.org +https://github.com/apache/qpid-proton/blob/go1/README.md +https://github.com/apache/qpid-proton/tree/go1{/dir} +https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/> + </head> + <body> + <div id="-content"> + <div id="-top" class="panel"> + <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a> + + <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a> + + <ul id="-global-navigation"> + <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> + <li><a href="/documentation.html">Documentation</a></li> + <li><a href="/download.html">Download</a></li> + <li><a href="/discussion.html">Discussion</a></li> + </ul> + </div> + + <div id="-menu" class="panel" style="display: none;"> + <div class="flex"> + <section> + <h3>Project</h3> + + <ul> + <li><a href="/overview.html">Overview</a></li> + <li><a href="/components/index.html">Components</a></li> + <li><a href="/releases/index.html">Releases</a></li> + </ul> + </section> + + <section> + <h3>Messaging APIs</h3> + + <ul> + <li><a href="/proton/index.html">Qpid Proton</a></li> + <li><a href="/components/jms/index.html">Qpid JMS</a></li> + <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li> + </ul> + </section> + + <section> + <h3>Servers and tools</h3> + + <ul> + <li><a href="/components/java-broker/index.html">Java broker</a></li> + <li><a href="/components/cpp-broker/index.html">C++ broker</a></li> + <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li> + </ul> + </section> + + <section> + <h3>Resources</h3> + + <ul> + <li><a href="/dashboard.html">Dashboard</a></li> + <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li> + <li><a href="/resources.html">More resources</a></li> + </ul> + </section> + </div> + </div> + + <div id="-search" class="panel" style="display: none;"> + <form action="http://www.google.com/search"; method="get"> + <input type="hidden" name="sitesearch" value="qpid.apache.org"/> + <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> + <button type="submit">Search</button> + <a href="/search.html">More ways to search</a> + </form> + </div> + + <div id="-middle" class="panel"> + <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li>Releases</li></ul> + + <div id="-middle-content"> + <h1 id="releases">Releases</h1> + +<p>New Qpid releases are announced on the +<a href="/discussion.html#mailing-lists">Qpid mailing lists</a> and +the +<a href="http://mail-archives.apache.org/mod_mbox/www-announce/";>Apache announce list</a>.</p> + +<h2 id="current-releases">Current releases</h2> + +<ul> +<li><a href="qpid-proton-0.12.2/index.html">Qpid Proton 0.12.2</a>, April 2016</li> +<li><a href="qpid-jms-0.9.0/index.html">Qpid JMS 0.9.0</a>, April 2016</li> +<li><a href="qpid-java-6.0.2/index.html">Qpid Java 6.0.2</a>, February 2016</li> +<li><a href="qpid-dispatch-0.5/index.html">Qpid Dispatch 0.5</a>, September 2015</li> +<li><a href="qpid-cpp-0.34/index.html">Qpid C++ 0.34</a>, June 2015</li> +<li><a href="qpid-0.32/index.html">Qpid 0.32</a>, March 2015</li> +</ul> + +<h2 id="past-releases">Past releases</h2> + +<div class="two-column"> + +<ul> +<li><a href="qpid-proton-0.12.1/index.html">Qpid Proton 0.12.1</a>, March 2016</li> +<li><a href="qpid-jms-0.8.0/index.html">Qpid JMS 0.8.0</a>, February 2016</li> +<li><a href="qpid-proton-0.12.0/index.html">Qpid Proton 0.12.0</a>, February 2016</li> +<li><a href="qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a>, December 2015</li> +<li><a href="qpid-jms-0.7.0/index.html">Qpid JMS 0.7.0</a>, December 2015</li> +<li><a href="qpid-proton-0.11.1/index.html">Qpid Proton 0.11.1</a>, December 2015</li> +<li><a href="qpid-jms-0.6.0/index.html">Qpid JMS 0.6.0</a>, October 2015</li> +<li><a href="qpid-proton-0.11.0/index.html">Qpid Proton 0.11.0</a>, November 2015</li> +<li><a href="qpid-proton-0.10/index.html">Qpid Proton 0.10</a>, August 2015</li> +<li><a href="qpid-jms-0.5.0/index.html">Qpid JMS 0.5.0</a>, August 2015</li> +<li><a href="qpid-dispatch-0.4/index.html">Qpid Dispatch 0.4</a>, April 2015</li> +<li><a href="qpid-jms-0.4.0/index.html">Qpid JMS 0.4.0</a>, August 2015</li> +<li><a href="qpid-jms-0.3.0/index.html">Qpid JMS 0.3.0</a>, June 2015</li> +<li><a href="qpid-proton-0.9.1/index.html">Qpid Proton 0.9.1</a>, May 2015</li> +<li><a href="qpid-jms-0.2.0/index.html">Qpid JMS 0.2.0</a>, May 2015</li> +<li><a href="qpid-jms-0.1.0/index.html">Qpid JMS 0.1.0</a>, March 2015</li> +<li><a href="qpid-proton-0.9/index.html">Qpid Proton 0.9</a>, March 2015</li> +<li><a href="qpid-dispatch-0.3/index.html">Qpid Dispatch 0.3</a>, January 2015</li> +<li><a href="qpid-proton-0.8/index.html">Qpid Proton 0.8</a>, October 2014</li> +<li><a href="qpid-0.30/index.html">Qpid 0.30</a>, September 2014</li> +<li><a href="qpid-dispatch-0.2/index.html">Qpid Dispatch 0.2</a>, April 2014</li> +<li><a href="qpid-proton-0.7/index.html">Qpid Proton 0.7</a>, April 2014</li> +<li><a href="qpid-0.28/index.html">Qpid 0.28</a>, June 2014</li> +<li><a href="qpid-0.26/index.html">Qpid 0.26</a>, February 2014</li> +<li><a href="qpid-proton-0.6/index.html">Qpid Proton 0.6</a>, January 2014</li> +<li><a href="qpid-dispatch-0.1/index.html">Qpid Dispatch 0.1</a>, January 2014</li> +</ul> + +</div> + +<p>Still older releases are available in the +<a href="http://archive.apache.org/dist/qpid/";>Apache archives</a>.</p> + +<h2 id="development-snapshots">Development snapshots</h2> + +<p>Warning! These are snapshots of work in progress.</p> + +<ul> +<li><a href="qpid-cpp-trunk/index.html">Qpid C++ trunk</a></li> +<li><a href="qpid-dispatch-master/index.html">Qpid Dispatch master</a></li> +<li><a href="qpid-java-trunk/index.html">Qpid Java trunk</a></li> +<li><a href="qpid-jms-master/index.html">Qpid JMS master</a></li> +<li><a href="qpid-proton-master/index.html">Qpid Proton master</a></li> +</ul> + +<h2 id="more-information">More information</h2> + +<ul> +<li><a href="https://cwiki.apache.org/confluence/display/qpid/Releases";>Releases on the wiki</a></li> +</ul> + + + <hr/> + + <ul id="-apache-navigation"> + <li><a href="http://www.apache.org/";>Apache</a></li> + <li><a href="http://www.apache.org/licenses/";>License</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li> + <li><a href="http://www.apache.org/security/";>Security</a></li> + <li><a href="http://www.apache.org/";><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li> + </ul> + + <p id="-legal"> + Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache + License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners + </p> + </div> + </div> + </div> + </body> +</html> http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a1891eca/content/releases/qpid-0.26/cpp-broker/book/AMQP-Compatibility.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/cpp-broker/book/AMQP-Compatibility.html b/content/releases/qpid-0.26/cpp-broker/book/AMQP-Compatibility.html new file mode 100644 index 0000000..4aeecbd --- /dev/null +++ b/content/releases/qpid-0.26/cpp-broker/book/AMQP-Compatibility.html @@ -0,0 +1,536 @@ +<!DOCTYPE html> +<!-- + - + - Licensed to the Apache Software Foundation (ASF) under one + - or more contributor license agreements. See the NOTICE file + - distributed with this work for additional information + - regarding copyright ownership. The ASF licenses this file + - to you under the Apache License, Version 2.0 (the + - "License"); you may not use this file except in compliance + - with the License. You may obtain a copy of the License at + - + - http://www.apache.org/licenses/LICENSE-2.0 + - + - Unless required by applicable law or agreed to in writing, + - software distributed under the License is distributed on an + - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + - KIND, either express or implied. See the License for the + - specific language governing permissions and limitations + - under the License. + - +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en"> + <head> + <title>AMQP-Compatibility.html - Apache Qpid™</title> + <meta http-equiv="X-UA-Compatible" content="IE=edge"/> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> + <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> + <script type="text/javascript">var _deferredFunctions = [];</script> + <script type="text/javascript" src="/deferred.js" defer="defer"></script> + <!--[if lte IE 8]> + <link rel="stylesheet" href="/ie.css" type="text/css"/> + <script type="text/javascript" src="/html5shiv.js"></script> + <![endif]--> + + <!-- Redirects for `go get` and godoc.org --> + <meta name="go-import" + content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/> + <meta name="go-source" + content="qpid.apache.org +https://github.com/apache/qpid-proton/blob/go1/README.md +https://github.com/apache/qpid-proton/tree/go1{/dir} +https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/> + </head> + <body> + <div id="-content"> + <div id="-top" class="panel"> + <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a> + + <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a> + + <ul id="-global-navigation"> + <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> + <li><a href="/documentation.html">Documentation</a></li> + <li><a href="/download.html">Download</a></li> + <li><a href="/discussion.html">Discussion</a></li> + </ul> + </div> + + <div id="-menu" class="panel" style="display: none;"> + <div class="flex"> + <section> + <h3>Project</h3> + + <ul> + <li><a href="/overview.html">Overview</a></li> + <li><a href="/components/index.html">Components</a></li> + <li><a href="/releases/index.html">Releases</a></li> + </ul> + </section> + + <section> + <h3>Messaging APIs</h3> + + <ul> + <li><a href="/proton/index.html">Qpid Proton</a></li> + <li><a href="/components/jms/index.html">Qpid JMS</a></li> + <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li> + </ul> + </section> + + <section> + <h3>Servers and tools</h3> + + <ul> + <li><a href="/components/java-broker/index.html">Java broker</a></li> + <li><a href="/components/cpp-broker/index.html">C++ broker</a></li> + <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li> + </ul> + </section> + + <section> + <h3>Resources</h3> + + <ul> + <li><a href="/dashboard.html">Dashboard</a></li> + <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li> + <li><a href="/resources.html">More resources</a></li> + </ul> + </section> + </div> + </div> + + <div id="-search" class="panel" style="display: none;"> + <form action="http://www.google.com/search"; method="get"> + <input type="hidden" name="sitesearch" value="qpid.apache.org"/> + <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> + <button type="submit">Search</button> + <a href="/search.html">More ways to search</a> + </form> + </div> + + <div id="-middle" class="panel"> + <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/cpp-broker/book/index.html">AMQP Messaging Broker (Implemented in C++)</a></li><li>AMQP-Compatibility.html</li></ul> + + <div id="-middle-content"> + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">1.9.  + AMQP compatibility + </th></tr><tr><td align="left" width="20%"><a accesskey="p" href="producer-flow-control.html">Prev</a> </td><th align="center" width="60%">Chapter 1.  + Running the AMQP Messaging Broker + </th><td align="right" width="20%"> <a accesskey="n" href="QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="AMQP-Compatibility"></a>1.9.  + AMQP compatibility + </h2></div></div></div><p> + Qpid provides the most complete and compatible implementation + of AMQP. And is the most aggressive in implementing the latest + version of the specification. + </p><p> + There are two brokers: + </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>C++ with support for AMQP 0-10</p></li><li class="listitem"><p>Java with support for AMQP 0-8 and 0-9 (0-10 planned)</p></li></ul></div><p> + There are client libraries for C++, Java (JMS), .Net (written in + C#), python and ruby. + </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>All clients support 0-10 and interoperate with the C++ + broker. + </p></li></ul></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>The JMS client supports 0-8, 0-9 and 0-10 and interoperates + with both brokers. + </p></li></ul></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>The python and ruby clients will also support all versions, + but the API is dynamically driven by the specification used and + so differs between versions. To work with the Java broker you + must use 0-8 or 0-9, to work with the C++ broker you must use + 0-10. + </p></li></ul></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>There are two separate C# clients, one for 0-8 that + interoperates with the Java broker, one for 0-10 that + inteoperates with the C++ broker. + </p></li></ul></div><p> + QMF Management is supported in Ruby, Python, C++, and via QMan + for Java JMX & WS-DM. + </p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="AMQPcompatibility-AMQPCompatibilityofQpidreleases-3A"></a>1.9.1.  + AMQP + Compatibility of Qpid releases: + </h3></div></div></div><p> + Qpid implements the AMQP Specification, and as the specification + has progressed Qpid is keeping up with the updates. This means + that different Qpid versions support different versions of AMQP. + Here is a simple guide on what use. + </p><p> + Here is a matrix that describes the different versions supported + by each release. The status symbols are interpreted as follows: + </p><div class="variablelist"><dl class="variablelist"><dt><span class="term">Y</span></dt><dd><p>supported</p></dd><dt><span class="term">N</span></dt><dd><p>unsupported</p></dd><dt><span class="term">IP</span></dt><dd><p>in progress</p></dd><dt><span class="term">P</span></dt><dd><p>planned</p></dd></dl></div><div class="table"><a id="idm139836370246480"></a><p class="title"><strong>Table 1.21. AMQP Version Support by Qpid Release</strong></p><div class="table-contents"><table border="1" summary="AMQP Version Support by Qpid Release"><colgroup><col /><col /><col /><col /><col /><col /></colgroup><tbody><tr><td> + Component + </td><td> + Spec + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> +   + </td></tr><tr><td> +   + </td><td> +   + </td><td> + M2.1 + </td><td> + M3 + </td><td> + M4 + </td><td> + 0.5 + </td></tr><tr><td> + java client + </td><td> + 0-10 + </td><td> +   + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> +   + </td><td> + 0-9 + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> +   + </td><td> + 0-8 + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> + java broker + </td><td> + 0-10 + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> + P + </td></tr><tr><td> +   + </td><td> + 0-9 + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> +   + </td><td> + 0-8 + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> + c++ client/broker + </td><td> + 0-10 + </td><td> +   + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> +   + </td><td> + 0-9 + </td><td> + Y + </td><td> +   + </td><td> +   + </td><td> +   + </td></tr><tr><td> + python client + </td><td> + 0-10 + </td><td> +   + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> +   + </td><td> + 0-9 + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> +   + </td><td> + 0-8 + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> + ruby client + </td><td> + 0-10 + </td><td> +   + </td><td> +   + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> +   + </td><td> + 0-8 + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> + C# client + </td><td> + 0-10 + </td><td> +   + </td><td> +   + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> +   + </td><td> + 0-8 + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr></tbody></table></div></div><br class="table-break" /></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="AMQPcompatibility-InteroptablebyAMQPspecificationversion"></a>1.9.2.  + Interop + table by AMQP specification version + </h3></div></div></div><p> + Above table represented in another format. + </p><div class="table"><a id="idm139836367476928"></a><p class="title"><strong>Table 1.22. AMQP Version Support - alternate format</strong></p><div class="table-contents"><table border="1" summary="AMQP Version Support - alternate format"><colgroup><col /><col /><col /><col /><col /></colgroup><tbody><tr><td> +   + </td><td> + release + </td><td> + 0-8 + </td><td> + 0-9 + </td><td> + 0-10 + </td></tr><tr><td> + java client + </td><td> + M3 M4 0.5 + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> + java client + </td><td> + M2.1 + </td><td> + Y + </td><td> + Y + </td><td> + N + </td></tr><tr><td> + java broker + </td><td> + M3 M4 0.5 + </td><td> + Y + </td><td> + Y + </td><td> + N + </td></tr><tr><td> + java broker + </td><td> + trunk + </td><td> + Y + </td><td> + Y + </td><td> + P + </td></tr><tr><td> + java broker + </td><td> + M2.1 + </td><td> + Y + </td><td> + Y + </td><td> + N + </td></tr><tr><td> + c++ client/broker + </td><td> + M3 M4 0.5 + </td><td> + N + </td><td> + N + </td><td> + Y + </td></tr><tr><td> + c++ client/broker + </td><td> + M2.1 + </td><td> + N + </td><td> + Y + </td><td> + N + </td></tr><tr><td> + python client + </td><td> + M3 M4 0.5 + </td><td> + Y + </td><td> + Y + </td><td> + Y + </td></tr><tr><td> + python client + </td><td> + M2.1 + </td><td> + Y + </td><td> + Y + </td><td> + N + </td></tr><tr><td> + ruby client + </td><td> + M3 M4 0.5 + </td><td> + Y + </td><td> + Y + </td><td> + N + </td></tr><tr><td> + ruby client + </td><td> + trunk + </td><td> + Y + </td><td> + Y + </td><td> + P + </td></tr><tr><td> + C# client + </td><td> + M3 M4 0.5 + </td><td> + Y + </td><td> + N + </td><td> + N + </td></tr><tr><td> + C# client + </td><td> + trunk + </td><td> + Y + </td><td> + N + </td><td> + Y + </td></tr></tbody></table></div></div><br class="table-break" /></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="producer-flow-control.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="ch01.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">1.8.  + Producer Flow Control +  </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> 1.10. Qpid Interoperability Documentation</td></tr></table></div></div> + + <hr/> + + <ul id="-apache-navigation"> + <li><a href="http://www.apache.org/";>Apache</a></li> + <li><a href="http://www.apache.org/licenses/";>License</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li> + <li><a href="http://www.apache.org/security/";>Security</a></li> + <li><a href="http://www.apache.org/";><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li> + </ul> + + <p id="-legal"> + Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache + License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners + </p> + </div> + </div> + </div> + </body> +</html> http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a1891eca/content/releases/qpid-0.26/cpp-broker/book/QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/cpp-broker/book/QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html b/content/releases/qpid-0.26/cpp-broker/book/QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html new file mode 100644 index 0000000..2f2cab2 --- /dev/null +++ b/content/releases/qpid-0.26/cpp-broker/book/QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html @@ -0,0 +1,375 @@ +<!DOCTYPE html> +<!-- + - + - Licensed to the Apache Software Foundation (ASF) under one + - or more contributor license agreements. See the NOTICE file + - distributed with this work for additional information + - regarding copyright ownership. The ASF licenses this file + - to you under the Apache License, Version 2.0 (the + - "License"); you may not use this file except in compliance + - with the License. You may obtain a copy of the License at + - + - http://www.apache.org/licenses/LICENSE-2.0 + - + - Unless required by applicable law or agreed to in writing, + - software distributed under the License is distributed on an + - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + - KIND, either express or implied. See the License for the + - specific language governing permissions and limitations + - under the License. + - +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en"> + <head> + <title>1.10. Qpid Interoperability Documentation - Apache Qpid™</title> + <meta http-equiv="X-UA-Compatible" content="IE=edge"/> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> + <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> + <script type="text/javascript">var _deferredFunctions = [];</script> + <script type="text/javascript" src="/deferred.js" defer="defer"></script> + <!--[if lte IE 8]> + <link rel="stylesheet" href="/ie.css" type="text/css"/> + <script type="text/javascript" src="/html5shiv.js"></script> + <![endif]--> + + <!-- Redirects for `go get` and godoc.org --> + <meta name="go-import" + content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/> + <meta name="go-source" + content="qpid.apache.org +https://github.com/apache/qpid-proton/blob/go1/README.md +https://github.com/apache/qpid-proton/tree/go1{/dir} +https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/> + </head> + <body> + <div id="-content"> + <div id="-top" class="panel"> + <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a> + + <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a> + + <ul id="-global-navigation"> + <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> + <li><a href="/documentation.html">Documentation</a></li> + <li><a href="/download.html">Download</a></li> + <li><a href="/discussion.html">Discussion</a></li> + </ul> + </div> + + <div id="-menu" class="panel" style="display: none;"> + <div class="flex"> + <section> + <h3>Project</h3> + + <ul> + <li><a href="/overview.html">Overview</a></li> + <li><a href="/components/index.html">Components</a></li> + <li><a href="/releases/index.html">Releases</a></li> + </ul> + </section> + + <section> + <h3>Messaging APIs</h3> + + <ul> + <li><a href="/proton/index.html">Qpid Proton</a></li> + <li><a href="/components/jms/index.html">Qpid JMS</a></li> + <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li> + </ul> + </section> + + <section> + <h3>Servers and tools</h3> + + <ul> + <li><a href="/components/java-broker/index.html">Java broker</a></li> + <li><a href="/components/cpp-broker/index.html">C++ broker</a></li> + <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li> + </ul> + </section> + + <section> + <h3>Resources</h3> + + <ul> + <li><a href="/dashboard.html">Dashboard</a></li> + <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li> + <li><a href="/resources.html">More resources</a></li> + </ul> + </section> + </div> + </div> + + <div id="-search" class="panel" style="display: none;"> + <form action="http://www.google.com/search"; method="get"> + <input type="hidden" name="sitesearch" value="qpid.apache.org"/> + <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> + <button type="submit">Search</button> + <a href="/search.html">More ways to search</a> + </form> + </div> + + <div id="-middle" class="panel"> + <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/cpp-broker/book/index.html">AMQP Messaging Broker (Implemented in C++)</a></li><li>1.10. Qpid Interoperability Documentation</li></ul> + + <div id="-middle-content"> + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">1.10. Qpid Interoperability Documentation</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="AMQP-Compatibility.html">Prev</a> </td><th align="center" width="60%">Chapter 1.  + Running the AMQP Messaging Broker + </th><td align="right" width="20%"> <a accesskey="n" href="Using-message-groups.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation"></a>1.10. Qpid Interoperability Documentation</h2></div></div></div><p> + This page documents the various interoperable features of the + Qpid clients. + </p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="QpidInteroperabilityDocumentation-SASL"></a>1.10.1.  + SASL + </h3></div></div></div><p> + + </p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="QpidInteroperabilityDocumentation-StandardMechanisms"></a>1.10.1.1.  + Standard + Mechanisms + </h4></div></div></div><p> + <a class="ulink" href="http://en.wikipedia.org/wiki/Simple_Authentication_and_Security_Layer#SASL_mechanisms"; target="_top">http://en.wikipedia.org/wiki/Simple_Authentication_and_Security_Layer#SASL_mechanisms</a> + </p><p> + This table list the various SASL mechanisms that each component + supports. The version listed shows when this + functionality was added to the product. + </p><div class="table"><a id="idm139836369278416"></a><p class="title"><strong>Table 1.23. SASL Mechanism Support</strong></p><div class="table-contents"><table border="1" summary="SASL Mechanism Support"><colgroup><col /><col /><col /><col /><col /><col /><col /></colgroup><tbody><tr><td> + Component + </td><td> + ANONYMOUS + </td><td> + CRAM-MD5 + </td><td> + DIGEST-MD5 + </td><td> + EXTERNAL + </td><td> + GSSAPI/Kerberos + </td><td> + PLAIN + </td></tr><tr><td> + C++ Broker + </td><td> + M3[<a class="xref" href="QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html#QpidInteroperabilityDocumentation-1">Section 1.10.1.1, “ + Standard + Mechanisms + ”</a>] + </td><td> + M3[<a class="xref" href="QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html#QpidInteroperabilityDocumentation-1">Section 1.10.1.1, “ + Standard + Mechanisms + ”</a>,<a class="xref" href="QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html#QpidInteroperabilityDocumentation-2">Section 1.10.1.1, “ + Standard + Mechanisms + ”</a>] + </td><td> +   + </td><td> +   + </td><td> + M3[<a class="xref" href="QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html#QpidInteroperabilityDocumentation-1">Section 1.10.1.1, “ + Standard + Mechanisms + ”</a>,<a class="xref" href="QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html#QpidInteroperabilityDocumentation-2">Section 1.10.1.1, “ + Standard + Mechanisms + ”</a>] + </td><td> + M1 + </td></tr><tr><td> + C++ Client + </td><td> + M3[<a class="xref" href="QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation.html#QpidInteroperabilityDocumentation-1">Section 1.10.1.1, “ + Standard + Mechanisms + ”</a>] + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> + M1 + </td></tr><tr><td> + Java Broker + </td><td> +   + </td><td> + M1 + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> + M1 + </td></tr><tr><td> + Java Client + </td><td> +   + </td><td> + M1 + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> + M1 + </td></tr><tr><td> + .Net Client + </td><td> + M2 + </td><td> + M2 + </td><td> + M2 + </td><td> + M2 + </td><td> +   + </td><td> + M2 + </td></tr><tr><td> + Python Client + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> + ? + </td></tr><tr><td> + Ruby Client + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> +   + </td><td> + ? + </td></tr></tbody></table></div></div><br class="table-break" /><p><a id="QpidInteroperabilityDocumentation-1"></a> + 1: Support for these will be in M3 (currently available on + trunk). + </p><p><a id="QpidInteroperabilityDocumentation-2"></a>2: C++ Broker uses <a class="ulink" href="http://freshmeat.net/projects/cyrussasl/"; target="_top">Cyrus SASL</a> which + supports CRAM-MD5 and GSSAPI but these have not been tested yet + </p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="QpidInteroperabilityDocumentation-CustomMechanisms"></a>1.10.1.2.  + Custom + Mechanisms + </h4></div></div></div><p> + There have been some custom mechanisms added to our + implementations. + </p><div class="table"><a id="idm139836367533552"></a><p class="title"><strong>Table 1.24. SASL Custom Mechanisms</strong></p><div class="table-contents"><table border="1" summary="SASL Custom Mechanisms"><colgroup><col /><col /><col /></colgroup><tbody><tr><td> + Component + </td><td> + AMQPLAIN + </td><td> + CRAM-MD5-HASHED + </td></tr><tr><td> + C++ Broker + </td><td> +   + </td><td> +   + </td></tr><tr><td> + C++ Client + </td><td> +   + </td><td> +   + </td></tr><tr><td> + Java Broker + </td><td> + M1 + </td><td> + M2 + </td></tr><tr><td> + Java Client + </td><td> + M1 + </td><td> + M2 + </td></tr><tr><td> + .Net Client + </td><td> +   + </td><td> +   + </td></tr><tr><td> + Python Client + </td><td> + M2 + </td><td> +   + </td></tr><tr><td> + Ruby Client + </td><td> + M2 + </td><td> +   + </td></tr></tbody></table></div></div><br class="table-break" /><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="idm139836370064768"></a>AMQPLAIN</h5></div></div></div><p /></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="idm139836367739136"></a>CRAM-MD5-HASHED</h5></div></div></div><p> + The Java SASL implementations require that you have the password + of the user to validate the incoming request. This then means + that the user's password must be stored on disk. For this to be + secure either the broker must encrypt the password file or the + need for the password being stored must be removed. + </p><p> + The CRAM-MD5-HASHED SASL plugin removes the need for the plain + text password to be stored on disk. The mechanism defers all + functionality to the build in CRAM-MD5 module the only change is + on the client side where it generates the hash of the password + and uses that value as the password. This means that the Java + Broker only need store the password hash on the file system. + While a one way hash is not very secure compared to other forms + of encryption in environments where the having the password in + plain text is unacceptable this will provide and additional layer + to protect the password. In particular this offers some + protection where the same password may be shared amongst many + systems. It offers no real extra protection against attacks on + the broker (the secret is now the hash rather than the password). + </p></div></div></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="AMQP-Compatibility.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="ch01.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="Using-message-groups.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">1.9.  + AMQP compatibility +  </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> 1.11.  + Using Message Groups + </td></tr></table></div></div> + + <hr/> + + <ul id="-apache-navigation"> + <li><a href="http://www.apache.org/";>Apache</a></li> + <li><a href="http://www.apache.org/licenses/";>License</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li> + <li><a href="http://www.apache.org/security/";>Security</a></li> + <li><a href="http://www.apache.org/";><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li> + </ul> + + <p id="-legal"> + Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache + License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners + </p> + </div> + </div> + </div> + </body> +</html> --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
