lib: add bt_version_get_name() and bt_version_get_name_description()

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Change-Id: If080c93994ac5869e29061b21d7b5c35387985d3
Reviewed-on: https://review.lttng.org/c/babeltrace/+/2834
Reviewed-by: Francis Deslauriers <francis.deslauriers@efficios.com>
Tested-by: jenkins <jenkins@lttng.org>

diff --git a/include/babeltrace2/version.h b/include/babeltrace2/version.h
index 875fa2a71c89c3d800c35b488badc611fd118b87..dc2604bff20bea1e7ec513d5242f3f0c551328f0 100644 (file)
--- a/include/babeltrace2/version.h
+++ b/include/babeltrace2/version.h
@@ -53,6 +53,9 @@ library's version:
   <dt>Extra information</dt>
   <dd>bt_version_get_extra()</dd>
 </dl>
+
+You can also get the version's name and description if available with
+bt_version_get_name() and bt_version_get_name_description().
 */
 
 /*! @{ */
@@ -96,6 +99,36 @@ This extra information can contain a version suffix such as
 */
 extern const char *bt_version_get_extra(void);
 
+/*!
+@brief
+    Returns libbabeltrace2's version name.
+
+If the version name is not available, which can be the case for a
+development build, this function returns \c NULL.
+
+@returns
+    Library's version name, or \c NULL if not available.
+
+@sa bt_version_get_name_description() &mdash;
+    Returns the description of libbabeltrace2's version name.
+*/
+extern const char *bt_version_get_name(void);
+
+/*!
+@brief
+    Returns libbabeltrace2's version name's description.
+
+If the version name's description is not available, which can be the
+case for a development build, this function returns \c NULL.
+
+@returns
+    Library's version name's description, or \c NULL if not available.
+
+@sa bt_version_get_name() &mdash;
+    Returns libbabeltrace2's version name.
+*/
+extern const char *bt_version_get_name_description(void);
+
 /*! @} */
 
 #ifdef __cplusplus

diff --git a/src/lib/babeltrace2.c b/src/lib/babeltrace2.c
index 8216cd11ad05a29a5baa66f917734eaa0445a639..a951c65d03c0a92510dc334eaffe07f827cb47b8 100644 (file)
--- a/src/lib/babeltrace2.c
+++ b/src/lib/babeltrace2.c
@@ -44,3 +44,14 @@ const char *bt_version_get_extra(void)
 {
        return strlen(BT_VERSION_EXTRA) == 0 ? NULL : BT_VERSION_EXTRA;
 }
+
+const char *bt_version_get_name(void)
+{
+       return strlen(BT_VERSION_NAME) == 0 ? NULL : BT_VERSION_NAME;
+}
+
+const char *bt_version_get_name_description(void)
+{
+       return strlen(BT_VERSION_DESCRIPTION) == 0 ? NULL :
+               BT_VERSION_DESCRIPTION;
+}