lib/internal.h

   1 /*
   2  *      The PCI Library -- Internal Stuff
   3  *
   4  *      Copyright (c) 1997--2022 Martin Mares <mj@ucw.cz>
   5  *
   6  *      Can be freely distributed and used under the terms of the GNU GPL.
   7  */
   8
   9 #include "config.h"
  10
  11 #ifdef PCI_SHARED_LIB
  12 #define PCI_ABI __attribute__((visibility("default")))
  13 // Functions, which are bound to externally visible symbols by the versioning
  14 // mechanism, have to be declared as VERSIONED. Otherwise, GCC with global
  15 // optimizations is happy to optimize them away, leading to linker failures.
  16 #define VERSIONED_ABI __attribute__((used)) PCI_ABI
  17 #ifdef __APPLE__
  18 #define STATIC_ALIAS(_decl, _for) _decl PCI_ABI { return _for; }
  19 #define DEFINE_ALIAS(_decl, _for)
  20 #define SYMBOL_VERSION(_int, _ext)
  21 #else
  22 #define STATIC_ALIAS(_decl, _for)
  23 #define DEFINE_ALIAS(_decl, _for) extern _decl __attribute__((alias(#_for)))
  24 #define SYMBOL_VERSION(_int, _ext) asm(".symver " #_int "," #_ext)
  25 #endif
  26 #else
  27 #define VERSIONED_ABI
  28 #define STATIC_ALIAS(_decl, _for) _decl { return _for; }
  29 #define DEFINE_ALIAS(_decl, _for)
  30 #define SYMBOL_VERSION(_int, _ext)
  31 #endif
  32
  33 #include "pci.h"
  34 #include "sysdep.h"
  35
  36 struct pci_methods {
  37   char *name;
  38   char *help;
  39   void (*config)(struct pci_access *);
  40   int (*detect)(struct pci_access *);
  41   void (*init)(struct pci_access *);
  42   void (*cleanup)(struct pci_access *);
  43   void (*scan)(struct pci_access *);
  44   void (*fill_info)(struct pci_dev *, unsigned int flags);
  45   int (*read)(struct pci_dev *, int pos, byte *buf, int len);
  46   int (*write)(struct pci_dev *, int pos, byte *buf, int len);
  47   int (*read_vpd)(struct pci_dev *, int pos, byte *buf, int len);
  48   void (*init_dev)(struct pci_dev *);
  49   void (*cleanup_dev)(struct pci_dev *);
  50 };
  51
  52 /* generic.c */
  53 void pci_generic_scan_bus(struct pci_access *, byte *busmap, int bus);
  54 void pci_generic_scan(struct pci_access *);
  55 void pci_generic_fill_info(struct pci_dev *, unsigned int flags);
  56 int pci_generic_block_read(struct pci_dev *, int pos, byte *buf, int len);
  57 int pci_generic_block_write(struct pci_dev *, int pos, byte *buf, int len);
  58
  59 /* init.c */
  60 void *pci_malloc(struct pci_access *, int);
  61 void pci_mfree(void *);
  62 char *pci_strdup(struct pci_access *a, const char *s);
  63
  64 void pci_init_v30(struct pci_access *a) VERSIONED_ABI;
  65 void pci_init_v35(struct pci_access *a) VERSIONED_ABI;
  66
  67 /* access.c */
  68 struct pci_dev *pci_alloc_dev(struct pci_access *);
  69 int pci_link_dev(struct pci_access *, struct pci_dev *);
  70
  71 int pci_fill_info_v30(struct pci_dev *, int flags) VERSIONED_ABI;
  72 int pci_fill_info_v31(struct pci_dev *, int flags) VERSIONED_ABI;
  73 int pci_fill_info_v32(struct pci_dev *, int flags) VERSIONED_ABI;
  74 int pci_fill_info_v33(struct pci_dev *, int flags) VERSIONED_ABI;
  75 int pci_fill_info_v34(struct pci_dev *, int flags) VERSIONED_ABI;
  76 int pci_fill_info_v35(struct pci_dev *, int flags) VERSIONED_ABI;
  77 int pci_fill_info_v38(struct pci_dev *, int flags) VERSIONED_ABI;
  78
  79 static inline int want_fill(struct pci_dev *d, unsigned want_fields, unsigned int try_fields)
  80 {
  81   want_fields &= try_fields;
  82   if ((d->known_fields & want_fields) == want_fields)
  83     return 0;
  84   else
  85     {
  86       d->known_fields |= try_fields;
  87       return 1;
  88     }
  89 }
  90
  91 static inline void clear_fill(struct pci_dev *d, unsigned clear_fields)
  92 {
  93   d->known_fields &= ~clear_fields;
  94 }
  95
  96 struct pci_property {
  97   struct pci_property *next;
  98   u32 key;
  99   char value[1];
 100 };
 101
 102 char *pci_set_property(struct pci_dev *d, u32 key, char *value);
 103
 104 /* params.c */
 105 void pci_define_param(struct pci_access *acc, char *param, char *val, char *help);
 106 int pci_set_param_internal(struct pci_access *acc, char *param, char *val, int copy);
 107 void pci_free_params(struct pci_access *acc);
 108
 109 /* caps.c */
 110 void pci_scan_caps(struct pci_dev *, unsigned int want_fields);
 111 void pci_free_caps(struct pci_dev *);
 112
 113 extern struct pci_methods pm_intel_conf1, pm_intel_conf2, pm_linux_proc,
 114         pm_fbsd_device, pm_aix_device, pm_nbsd_libpci, pm_obsd_device,
 115         pm_dump, pm_linux_sysfs, pm_darwin, pm_sylixos_device, pm_hurd;