hwlocality_api_version.3 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. .TH "hwlocality_api_version" 3 "Thu Sep 7 2023" "Version 2.9.3" "Hardware Locality (hwloc)" \" -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. hwlocality_api_version \- API version
  6. .SH SYNOPSIS
  7. .br
  8. .PP
  9. .SS "Macros"
  10. .in +1c
  11. .ti -1c
  12. .RI "#define \fBHWLOC_API_VERSION\fP 0x00020800"
  13. .br
  14. .ti -1c
  15. .RI "#define \fBHWLOC_COMPONENT_ABI\fP 7"
  16. .br
  17. .in -1c
  18. .SS "Functions"
  19. .in +1c
  20. .ti -1c
  21. .RI "unsigned \fBhwloc_get_api_version\fP (void)"
  22. .br
  23. .in -1c
  24. .SH "Detailed Description"
  25. .PP
  26. .SH "Macro Definition Documentation"
  27. .PP
  28. .SS "#define HWLOC_API_VERSION 0x00020800"
  29. .PP
  30. Indicate at build time which hwloc API version is being used\&. This number is updated to (X<<16)+(Y<<8)+Z when a new release X\&.Y\&.Z actually modifies the API\&.
  31. .PP
  32. Users may check for available features at build time using this number (see \fBHow do I handle API changes?\fP)\&.
  33. .PP
  34. \fBNote\fP
  35. .RS 4
  36. This should not be confused with HWLOC_VERSION, the library version\&. Two stable releases of the same series usually have the same \fBHWLOC_API_VERSION\fP even if their HWLOC_VERSION are different\&.
  37. .RE
  38. .PP
  39. .SS "#define HWLOC_COMPONENT_ABI 7"
  40. .PP
  41. Current component and plugin ABI version (see \fBhwloc/plugins\&.h\fP)
  42. .SH "Function Documentation"
  43. .PP
  44. .SS "unsigned hwloc_get_api_version (void)"
  45. .PP
  46. Indicate at runtime which hwloc API version was used at build time\&. Should be \fBHWLOC_API_VERSION\fP if running on the same version\&.
  47. .PP
  48. \fBReturns\fP
  49. .RS 4
  50. the build-time version number\&.
  51. .RE
  52. .PP
  53. .SH "Author"
  54. .PP
  55. Generated automatically by Doxygen for Hardware Locality (hwloc) from the source code\&.