API: add hwloc_get_info_by_name()

It takes a struct hwloc_infos_s
(while hwloc_obj_get_info_by_name() takes an object).

Signed-off-by: Brice Goglin <[email protected]>

Author: bgoglin

doc/Makefile.am

@@ -349,6 +349,7 @@ man3_object_info_attrsdir = $(man3dir)
 man3_object_info_attrs_DATA = \
         $(DOX_MAN_DIR)/man3/hwlocality_info_attr.3 \
         $(DOX_MAN_DIR)/man3/hwloc_obj_get_info_by_name.3 \
+        $(DOX_MAN_DIR)/man3/hwloc_get_info_by_name.3 \
         $(DOX_MAN_DIR)/man3/hwloc_obj_add_info.3
 
 man3_cpubindingdir = $(man3dir)

include/hwloc.h

@@ -1135,7 +1135,14 @@ HWLOC_DECLSPEC int hwloc_type_sscanf(const char *string,
  * @{
  */
 
-/** \brief Search the given name in object infos and return the corresponding value.
+/** \brief Search the given name in the object array of infos and return the corresponding value.
+ *
+ * Identical to hwloc_get_info_by_name() but operates on the infos of the given object.
+ */
+static __hwloc_inline const char *
+hwloc_obj_get_info_by_name(hwloc_obj_t obj, const char *name) __hwloc_attribute_pure;
+
+/** \brief Search the given name in the array of infos and return the corresponding value.
  *
  * If multiple info attributes match the given name, only the first one is returned.
  *
@@ -1145,7 +1152,7 @@ HWLOC_DECLSPEC int hwloc_type_sscanf(const char *string,
  * \note The string should not be freed by the caller, it belongs to the hwloc library.
  */
 static __hwloc_inline const char *
-hwloc_obj_get_info_by_name(hwloc_obj_t obj, const char *name) __hwloc_attribute_pure;
+hwloc_get_info_by_name(struct hwloc_infos_s *infos, const char *name) __hwloc_attribute_pure;
 
 /** \brief Add the given name and value pair to the given object info attributes.
  *

include/hwloc/inlines.h

@@ -1,6 +1,6 @@
 /*
  * Copyright © 2009 CNRS
- * Copyright © 2009-2022 Inria.  All rights reserved.
+ * Copyright © 2009-2023 Inria.  All rights reserved.
  * Copyright © 2009-2012 Université Bordeaux
  * Copyright © 2009-2010 Cisco Systems, Inc.  All rights reserved.
  * See COPYING in top-level directory.
@@ -108,18 +108,23 @@ hwloc_get_root_obj (hwloc_topology_t topology)
 }
 
 static __hwloc_inline const char *
-hwloc_obj_get_info_by_name(hwloc_obj_t obj, const char *name)
+hwloc_get_info_by_name(struct hwloc_infos_s *infos, const char *name)
 {
   unsigned i;
-  struct hwloc_infos_s *infos = &obj->infos;
-  for(i=0; i<obj->infos.count; i++) {
+  for(i=0; i<infos->count; i++) {
     struct hwloc_info_s *info = &infos->array[i];
     if (!strcmp(info->name, name))
       return info->value;
   }
   return NULL;
 }
 
+static __hwloc_inline const char *
+hwloc_obj_get_info_by_name(hwloc_obj_t obj, const char *name)
+{
+  return hwloc_get_info_by_name(&obj->infos, name);
+}
+
 static __hwloc_inline void *
 hwloc_alloc_membind_policy(hwloc_topology_t topology, size_t len, hwloc_const_cpuset_t set, hwloc_membind_policy_t policy, int flags)
 {

include/hwloc/rename.h

@@ -216,6 +216,7 @@ extern "C" {
 #define hwloc_type_sscanf HWLOC_NAME(type_sscanf)
 
 #define hwloc_obj_get_info_by_name HWLOC_NAME(obj_get_info_by_name)
+#define hwloc_get_info_by_name HWLOC_NAME(get_info_by_name)
 #define hwloc_obj_add_info HWLOC_NAME(obj_add_info)
 
 #define HWLOC_CPUBIND_PROCESS HWLOC_NAME_CAPS(CPUBIND_PROCESS)