On 12/22/2010 02:36 AM, Brice Goglin wrote:
I'll backport this in 1.1 later, in case somebody wants to fix the
English speaking.
Brice
For the benefit of the Perl and Python bindings efforts, it would be good if
we could query the runtime library for it's API version.
--Guy
Le 22/12/2010 09:28, bgog...@osl.iu.edu a écrit :
Author: bgoglin
Date: 2010-12-22 03:28:55 EST (Wed, 22 Dec 2010)
New Revision: 2975
URL: https://svn.open-mpi.org/trac/hwloc/changeset/2975
Log:
Add a FAQ entry about HWLOC_API_VERSION
Text files modified:
trunk/doc/hwloc.doxy | 36 ++++++++++++++++++++++++++++++++++++
1 files changed, 36 insertions(+), 0 deletions(-)
Modified: trunk/doc/hwloc.doxy
==============================================================================
--- trunk/doc/hwloc.doxy (original)
+++ trunk/doc/hwloc.doxy 2010-12-22 03:28:55 EST (Wed, 22 Dec 2010)
@@ -1294,5 +1294,41 @@
(that may for instance be transmitted between applications through a socket).
+\section faq_upgrade How do I handle API upgrades?
+
+The hwloc interface is extended with every new major release.
+Any application using the hwloc API should be prepared to check at
+compile-time whether some features are available in the currently
+installed hwloc distribution.
+
+To check whether hwloc is at least 1.1, you should use:
+\verbatim
+#include<hwloc.h>
+#if HWLOC_API_VERSION>= 0x00010100
+...
+#endif
+\endverbatim
