plugins.h
/*
* Copyright © 2013-2014 Inria. All rights reserved.
* See COPYING in top-level directory.
*/
#ifndef HWLOC_PLUGINS_H
#define HWLOC_PLUGINS_H
struct hwloc_backend;
#include <hwloc.h>
#ifdef HWLOC_INSIDE_PLUGIN
/* needed for hwloc_plugin_check_namespace() */
#include <ltdl.h>
#endif
typedef enum hwloc_disc_component_type_e {
HWLOC_DISC_COMPONENT_TYPE_CPU = (1<<0),
HWLOC_DISC_COMPONENT_TYPE_GLOBAL = (1<<1),
HWLOC_DISC_COMPONENT_TYPE_MISC = (1<<2)
} hwloc_disc_component_type_t;
struct hwloc_disc_component {
hwloc_disc_component_type_t type;
const char *name;
unsigned excludes;
struct hwloc_backend * (*instantiate)(struct hwloc_disc_component *component, const void *data1, const void *data2, const void *data3);
unsigned priority;
struct hwloc_disc_component * next;
};
struct hwloc_backend {
struct hwloc_disc_component * component;
struct hwloc_topology * topology;
int envvar_forced;
struct hwloc_backend * next;
unsigned long flags;
int is_custom;
int is_thissystem;
void * private_data;
void (*disable)(struct hwloc_backend *backend);
int (*discover)(struct hwloc_backend *backend);
int (*get_obj_cpuset)(struct hwloc_backend *backend, struct hwloc_backend *caller, struct hwloc_obj *obj, hwloc_bitmap_t cpuset);
int (*notify_new_object)(struct hwloc_backend *backend, struct hwloc_backend *caller, struct hwloc_obj *obj);
};
enum hwloc_backend_flag_e {
HWLOC_BACKEND_FLAG_NEED_LEVELS = (1UL<<0)
};
HWLOC_DECLSPEC struct hwloc_backend * hwloc_backend_alloc(struct hwloc_disc_component *component);
HWLOC_DECLSPEC int hwloc_backend_enable(struct hwloc_topology *topology, struct hwloc_backend *backend);
HWLOC_DECLSPEC int hwloc_backends_get_obj_cpuset(struct hwloc_backend *caller, struct hwloc_obj *obj, hwloc_bitmap_t cpuset);
HWLOC_DECLSPEC int hwloc_backends_notify_new_object(struct hwloc_backend *caller, struct hwloc_obj *obj);
typedef enum hwloc_component_type_e {
HWLOC_COMPONENT_TYPE_DISC,
HWLOC_COMPONENT_TYPE_XML
} hwloc_component_type_t;
struct hwloc_component {
unsigned abi;
hwloc_component_type_t type;
unsigned long flags;
void * data;
};
HWLOC_DECLSPEC struct hwloc_obj *hwloc_insert_object_by_cpuset(struct hwloc_topology *topology, hwloc_obj_t obj);
typedef void (*hwloc_report_error_t)(const char * msg, int line);
HWLOC_DECLSPEC void hwloc_report_os_error(const char * msg, int line);
HWLOC_DECLSPEC int hwloc_hide_errors(void);
HWLOC_DECLSPEC struct hwloc_obj *hwloc__insert_object_by_cpuset(struct hwloc_topology *topology, hwloc_obj_t obj, hwloc_report_error_t report_error);
HWLOC_DECLSPEC void hwloc_insert_object_by_parent(struct hwloc_topology *topology, hwloc_obj_t parent, hwloc_obj_t obj);
static __hwloc_inline struct hwloc_obj *
hwloc_alloc_setup_object(hwloc_obj_type_t type, signed os_index)
{
struct hwloc_obj *obj = malloc(sizeof(*obj));
memset(obj, 0, sizeof(*obj));
obj->type = type;
obj->os_index = os_index;
obj->os_level = -1;
obj->attr = malloc(sizeof(*obj->attr));
memset(obj->attr, 0, sizeof(*obj->attr));
/* do not allocate the cpuset here, let the caller do it */
return obj;
}
HWLOC_DECLSPEC int hwloc_fill_object_sets(hwloc_obj_t obj);
static __hwloc_inline int
hwloc_plugin_check_namespace(const char *pluginname __hwloc_attribute_unused, const char *symbol __hwloc_attribute_unused)
{
#ifdef HWLOC_INSIDE_PLUGIN
lt_dlhandle handle;
void *sym;
handle = lt_dlopen(NULL);
if (!handle)
/* cannot check, assume things will work */
return 0;
sym = lt_dlsym(handle, symbol);
lt_dlclose(handle);
if (!sym) {
static int verboseenv_checked = 0;
static int verboseenv_value = 0;
if (!verboseenv_checked) {
char *verboseenv = getenv("HWLOC_PLUGINS_VERBOSE");
verboseenv_value = atoi(verboseenv);
verboseenv_checked = 1;
}
if (verboseenv_value)
fprintf(stderr, "Plugin `%s' disabling itself because it cannot find the `%s' core symbol.\n",
pluginname, symbol);
return -1;
}
#endif /* HWLOC_INSIDE_PLUGIN */
return 0;
}
HWLOC_DECLSPEC int hwloc_insert_pci_device_list(struct hwloc_backend *backend, struct hwloc_obj *first_obj);
HWLOC_DECLSPEC unsigned hwloc_pci_find_cap(const unsigned char *config, unsigned cap);
HWLOC_DECLSPEC int hwloc_pci_find_linkspeed(const unsigned char *config, unsigned offset, float *linkspeed);
HWLOC_DECLSPEC int hwloc_pci_prepare_bridge(hwloc_obj_t obj, const unsigned char *config);
#endif /* HWLOC_PLUGINS_H */
hwloc_component::flags
unsigned long flags
Component flags, unused for now.
Definition: plugins.h:223
hwloc_hide_errors
int hwloc_hide_errors(void)
Check whether insertion errors are hidden.
hwloc_disc_component::priority
unsigned priority
Component priority. Used to sort topology->components, higher priority first. Also used to decide bet...
Definition: plugins.h:86
hwloc_backends_notify_new_object
int hwloc_backends_notify_new_object(struct hwloc_backend *caller, struct hwloc_obj *obj)
Used by backends discovery callbacks to notify other backends of new objects.
hwloc_backend_flag_e
hwloc_backend_flag_e
Backend flags.
Definition: plugins.h:160
hwloc_obj::os_level
signed os_level
OS-provided physical level, -1 if unknown or meaningless.
Definition: hwloc.h:350
hwloc_obj::parent
struct hwloc_obj * parent
Parent, NULL if root (system object)
Definition: hwloc.h:357
hwloc_obj_type_t
hwloc_obj_type_t
Type of topology object.
Definition: hwloc.h:152
hwloc_component::abi
unsigned abi
Component ABI version, set to HWLOC_COMPONENT_ABI.
Definition: plugins.h:217
hwloc_component_type_e
hwloc_component_type_e
Generic component type.
Definition: plugins.h:202
HWLOC_DISC_COMPONENT_TYPE_GLOBAL
xml, synthetic or custom, platform-specific components such as bgq. Anything the discovers CPU and ev...
Definition: plugins.h:38
hwloc_backend::is_thissystem
int is_thissystem
Backend-specific 'is_thissystem' property. Set to 0 or 1 if the backend should enforce the thissystem...
Definition: plugins.h:135
hwloc_insert_pci_device_list
int hwloc_insert_pci_device_list(struct hwloc_backend *backend, struct hwloc_obj *first_obj)
Insert a list of PCI devices and bridges in the backend topology.
hwloc_fill_object_sets
int hwloc_fill_object_sets(hwloc_obj_t obj)
Setup object cpusets/nodesets by OR'ing its children.
hwloc_backend::disable
void(* disable)(struct hwloc_backend *backend)
Callback for freeing the private_data. May be NULL.
Definition: plugins.h:142
hwloc_insert_object_by_cpuset
struct hwloc_obj * hwloc_insert_object_by_cpuset(struct hwloc_topology *topology, hwloc_obj_t obj)
Add an object to the topology.
hwloc_disc_component_type_e
hwloc_disc_component_type_e
Discovery component type.
Definition: plugins.h:28
hwloc_disc_component_type_t
enum hwloc_disc_component_type_e hwloc_disc_component_type_t
Discovery component type.
hwloc_bitmap_t
struct hwloc_bitmap_s * hwloc_bitmap_t
Set of bits represented as an opaque pointer to an internal bitmap.
Definition: bitmap.h:45
hwloc_backend::flags
unsigned long flags
Backend flags, as an OR'ed set of HWLOC_BACKEND_FLAG_*.
Definition: plugins.h:125
hwloc_disc_component::type
hwloc_disc_component_type_t type
Discovery component type.
Definition: plugins.h:52
HWLOC_COMPONENT_TYPE_DISC
The data field must point to a struct hwloc_disc_component.
Definition: plugins.h:204
HWLOC_BACKEND_FLAG_NEED_LEVELS
Levels should be reconnected before this backend discover() is used.
Definition: plugins.h:163
hwloc_plugin_check_namespace
static int hwloc_plugin_check_namespace(const char *pluginname, const char *symbol)
Make sure that plugins can lookup core symbols.
Definition: plugins.h:323
hwloc_backend_alloc
struct hwloc_backend * hwloc_backend_alloc(struct hwloc_disc_component *component)
Allocate a backend structure, set good default values, initialize backend->component and topology...
hwloc_insert_object_by_parent
void hwloc_insert_object_by_parent(struct hwloc_topology *topology, hwloc_obj_t parent, hwloc_obj_t obj)
Insert an object somewhere in the topology.
HWLOC_DISC_COMPONENT_TYPE_CPU
CPU-only discovery through the OS, or generic no-OS support.
Definition: plugins.h:31
hwloc_obj::attr
union hwloc_obj_attr_u * attr
Object type-specific Attributes, may be NULL if no attribute value was found.
Definition: hwloc.h:339
hwloc_obj::cpuset
hwloc_cpuset_t cpuset
CPUs covered by this object.
Definition: hwloc.h:375
hwloc_disc_component::name
const char * name
Name. If this component is built as a plugin, this name does not have to match the plugin filename...
Definition: plugins.h:57
hwloc_report_os_error
void hwloc_report_os_error(const char *msg, int line)
Report an insertion error from a backend.
hwloc_backend
Discovery backend structure.
Definition: plugins.h:114
hwloc_report_error_t
void(* hwloc_report_error_t)(const char *msg, int line)
Type of error callbacks during object insertion.
Definition: plugins.h:261
hwloc_backend::private_data
void * private_data
Backend private data, or NULL if none.
Definition: plugins.h:138
hwloc_component::data
void * data
Component data, pointing to a struct hwloc_disc_component or struct hwloc_xml_component.
Definition: plugins.h:226
hwloc_component
Generic component structure.
Definition: plugins.h:215
hwloc_backend::is_custom
int is_custom
Backend-specific 'is_custom' property. Shortcut on !strcmp(..->component->name, "custom"). Only the custom component should touch this.
Definition: plugins.h:130
hwloc__insert_object_by_cpuset
struct hwloc_obj * hwloc__insert_object_by_cpuset(struct hwloc_topology *topology, hwloc_obj_t obj, hwloc_report_error_t report_error)
Add an object to the topology and specify which error callback to use.
hwloc_backend::notify_new_object
int(* notify_new_object)(struct hwloc_backend *backend, struct hwloc_backend *caller, struct hwloc_obj *obj)
Callback called by backends to notify this backend that a new object was added. returns > 0 if it mod...
Definition: plugins.h:156
hwloc_pci_find_cap
unsigned hwloc_pci_find_cap(const unsigned char *config, unsigned cap)
Return the offset of the given capability in the PCI config space buffer.
hwloc_backends_get_obj_cpuset
int hwloc_backends_get_obj_cpuset(struct hwloc_backend *caller, struct hwloc_obj *obj, hwloc_bitmap_t cpuset)
Used by backends discovery callbacks to request locality information from others. ...
hwloc_backend::get_obj_cpuset
int(* get_obj_cpuset)(struct hwloc_backend *backend, struct hwloc_backend *caller, struct hwloc_obj *obj, hwloc_bitmap_t cpuset)
Callback used by the PCI backend to retrieve the locality of a PCI object from the OS/cpu backend...
Definition: plugins.h:151
hwloc_disc_component
Discovery component structure.
Definition: plugins.h:50
hwloc_pci_prepare_bridge
int hwloc_pci_prepare_bridge(hwloc_obj_t obj, const unsigned char *config)
Modify the PCI device object into a bridge and fill its attribute if a bridge is found in the PCI con...
hwloc_component_type_t
enum hwloc_component_type_e hwloc_component_type_t
Generic component type.
hwloc_component::type
hwloc_component_type_t type
Component type.
Definition: plugins.h:220
HWLOC_DISC_COMPONENT_TYPE_MISC
OpenCL, Cuda, etc.
Definition: plugins.h:42
hwloc_pci_find_linkspeed
int hwloc_pci_find_linkspeed(const unsigned char *config, unsigned offset, float *linkspeed)
Fill linkspeed by reading the PCI config space where PCI_CAP_ID_EXP is at position offset...
hwloc_obj::os_index
unsigned os_index
OS-provided physical index number.
Definition: hwloc.h:334
HWLOC_COMPONENT_TYPE_XML
The data field must point to a struct hwloc_xml_component.
Definition: plugins.h:207
hwloc_obj::type
hwloc_obj_type_t type
Type of object.
Definition: hwloc.h:333
hwloc_backend_enable
int hwloc_backend_enable(struct hwloc_topology *topology, struct hwloc_backend *backend)
Enable a previously allocated and setup backend.
hwloc_alloc_setup_object
static struct hwloc_obj * hwloc_alloc_setup_object(hwloc_obj_type_t type, signed os_index)
Allocate and initialize an object of the given type and physical index.
Definition: plugins.h:287
hwloc_obj
Structure of a topology object.
Definition: hwloc.h:331
hwloc_disc_component::excludes
unsigned excludes
Component types to exclude, as an OR'ed set of HWLOC_DISC_COMPONENT_TYPE_*.
Definition: plugins.h:67
hwloc_backend::discover
int(* discover)(struct hwloc_backend *backend)
Main discovery callback. returns > 0 if it modified the topology tree, -1 on error, 0 otherwise. May be NULL if type is HWLOC_DISC_COMPONENT_TYPE_MISC.
Definition: plugins.h:147