lib/init.c

   1 /*
   2  *      The PCI Library -- Initialization and related things
   3  *
   4  *      Copyright (c) 1997--2018 Martin Mares <mj@ucw.cz>
   5  *
   6  *      Can be freely distributed and used under the terms of the GNU GPL.
   7  */
   8
   9 #include <stdio.h>
  10 #include <stdlib.h>
  11 #include <stdarg.h>
  12 #include <string.h>
  13
  14 #include "internal.h"
  15
  16 static struct pci_methods *pci_methods[PCI_ACCESS_MAX] = {
  17   NULL,
  18 #ifdef PCI_HAVE_PM_LINUX_SYSFS
  19   &pm_linux_sysfs,
  20 #else
  21   NULL,
  22 #endif
  23 #ifdef PCI_HAVE_PM_LINUX_PROC
  24   &pm_linux_proc,
  25 #else
  26   NULL,
  27 #endif
  28 #ifdef PCI_HAVE_PM_INTEL_CONF
  29   &pm_intel_conf1,
  30   &pm_intel_conf2,
  31 #else
  32   NULL,
  33   NULL,
  34 #endif
  35 #ifdef PCI_HAVE_PM_FBSD_DEVICE
  36   &pm_fbsd_device,
  37 #else
  38   NULL,
  39 #endif
  40 #ifdef PCI_HAVE_PM_AIX_DEVICE
  41   &pm_aix_device,
  42 #else
  43   NULL,
  44 #endif
  45 #ifdef PCI_HAVE_PM_NBSD_LIBPCI
  46   &pm_nbsd_libpci,
  47 #else
  48   NULL,
  49 #endif
  50 #ifdef PCI_HAVE_PM_OBSD_DEVICE
  51   &pm_obsd_device,
  52 #else
  53   NULL,
  54 #endif
  55 #ifdef PCI_HAVE_PM_DUMP
  56   &pm_dump,
  57 #else
  58   NULL,
  59 #endif
  60 #ifdef PCI_HAVE_PM_DARWIN_DEVICE
  61   &pm_darwin,
  62 #else
  63   NULL,
  64 #endif
  65 #ifdef PCI_HAVE_PM_SYLIXOS_DEVICE
  66   &pm_sylixos_device,
  67 #else
  68   NULL,
  69 #endif
  70 #ifdef PCI_HAVE_PM_HURD_CONF
  71   &pm_hurd,
  72 #else
  73   NULL,
  74 #endif
  75 };
  76
  77 // If PCI_ACCESS_AUTO is selected, we probe the access methods in this order
  78 static int probe_sequence[] = {
  79   // System-specific methods
  80   PCI_ACCESS_SYS_BUS_PCI,
  81   PCI_ACCESS_PROC_BUS_PCI,
  82   PCI_ACCESS_FBSD_DEVICE,
  83   PCI_ACCESS_AIX_DEVICE,
  84   PCI_ACCESS_NBSD_LIBPCI,
  85   PCI_ACCESS_OBSD_DEVICE,
  86   PCI_ACCESS_DARWIN,
  87   PCI_ACCESS_SYLIXOS_DEVICE,
  88   PCI_ACCESS_HURD,
  89   // Low-level methods poking the hardware directly
  90   PCI_ACCESS_I386_TYPE1,
  91   PCI_ACCESS_I386_TYPE2,
  92   -1,
  93 };
  94
  95 static void
  96 pci_generic_error(char *msg, ...)
  97 {
  98   va_list args;
  99
 100   va_start(args, msg);
 101   fputs("pcilib: ", stderr);
 102   vfprintf(stderr, msg, args);
 103   va_end(args);
 104   fputc('\n', stderr);
 105   exit(1);
 106 }
 107
 108 static void
 109 pci_generic_warn(char *msg, ...)
 110 {
 111   va_list args;
 112
 113   va_start(args, msg);
 114   fputs("pcilib: ", stderr);
 115   vfprintf(stderr, msg, args);
 116   va_end(args);
 117   fputc('\n', stderr);
 118 }
 119
 120 static void
 121 pci_generic_debug(char *msg, ...)
 122 {
 123   va_list args;
 124
 125   va_start(args, msg);
 126   vfprintf(stdout, msg, args);
 127   va_end(args);
 128 }
 129
 130 static void
 131 pci_null_debug(char *msg UNUSED, ...)
 132 {
 133 }
 134
 135 // Memory allocation functions are safe to call if pci_access is not fully initalized or even NULL
 136
 137 void *
 138 pci_malloc(struct pci_access *a, int size)
 139 {
 140   void *x = malloc(size);
 141
 142   if (!x)
 143     (a && a->error ? a->error : pci_generic_error)("Out of memory (allocation of %d bytes failed)", size);
 144   return x;
 145 }
 146
 147 void
 148 pci_mfree(void *x)
 149 {
 150   if (x)
 151     free(x);
 152 }
 153
 154 char *
 155 pci_strdup(struct pci_access *a, const char *s)
 156 {
 157   int len = strlen(s) + 1;
 158   char *t = pci_malloc(a, len);
 159   memcpy(t, s, len);
 160   return t;
 161 }
 162
 163 int
 164 pci_lookup_method(char *name)
 165 {
 166   int i;
 167
 168   for (i=0; i<PCI_ACCESS_MAX; i++)
 169     if (pci_methods[i] && !strcmp(pci_methods[i]->name, name))
 170       return i;
 171   return -1;
 172 }
 173
 174 char *
 175 pci_get_method_name(int index)
 176 {
 177   if (index < 0 || index >= PCI_ACCESS_MAX)
 178     return NULL;
 179   else if (!pci_methods[index])
 180     return "";
 181   else
 182     return pci_methods[index]->name;
 183 }
 184
 185 struct pci_access *
 186 pci_alloc(void)
 187 {
 188   struct pci_access *a = pci_malloc(NULL, sizeof(struct pci_access));
 189   int i;
 190
 191   memset(a, 0, sizeof(*a));
 192   pci_set_name_list_path(a, PCI_PATH_IDS_DIR "/" PCI_IDS, 0);
 193 #ifdef PCI_USE_DNS
 194   pci_define_param(a, "net.domain", PCI_ID_DOMAIN, "DNS domain used for resolving of ID's");
 195   pci_define_param(a, "net.cache_name", "~/.pciids-cache", "Name of the ID cache file");
 196   a->id_lookup_mode = PCI_LOOKUP_CACHE;
 197 #endif
 198 #ifdef PCI_HAVE_HWDB
 199   pci_define_param(a, "hwdb.disable", "0", "Do not look up names in UDEV's HWDB if non-zero");
 200 #endif
 201   for (i=0; i<PCI_ACCESS_MAX; i++)
 202     if (pci_methods[i] && pci_methods[i]->config)
 203       pci_methods[i]->config(a);
 204   return a;
 205 }
 206
 207 void
 208 pci_init_v35(struct pci_access *a)
 209 {
 210   if (!a->error)
 211     a->error = pci_generic_error;
 212   if (!a->warning)
 213     a->warning = pci_generic_warn;
 214   if (!a->debug)
 215     a->debug = pci_generic_debug;
 216   if (!a->debugging)
 217     a->debug = pci_null_debug;
 218
 219   if (a->method)
 220     {
 221       if (a->method >= PCI_ACCESS_MAX || !pci_methods[a->method])
 222         a->error("This access method is not supported.");
 223       a->methods = pci_methods[a->method];
 224     }
 225   else
 226     {
 227       unsigned int i;
 228       for (i=0; probe_sequence[i] >= 0; i++)
 229         {
 230           struct pci_methods *m = pci_methods[probe_sequence[i]];
 231           if (!m)
 232             continue;
 233           a->debug("Trying method %s...", m->name);
 234           if (m->detect(a))
 235             {
 236               a->debug("...OK\n");
 237               a->methods = m;
 238               a->method = probe_sequence[i];
 239               break;
 240             }
 241           a->debug("...No.\n");
 242         }
 243       if (!a->methods)
 244         a->error("Cannot find any working access method.");
 245     }
 246   a->debug("Decided to use %s\n", a->methods->name);
 247   a->methods->init(a);
 248 }
 249
 250 STATIC_ALIAS(void pci_init(struct pci_access *a), pci_init_v35(a));
 251 DEFINE_ALIAS(void pci_init_v30(struct pci_access *a), pci_init_v35);
 252 SYMBOL_VERSION(pci_init_v30, pci_init@LIBPCI_3.0);
 253 SYMBOL_VERSION(pci_init_v35, pci_init@@LIBPCI_3.5);
 254
 255 void
 256 pci_cleanup(struct pci_access *a)
 257 {
 258   struct pci_dev *d, *e;
 259
 260   for (d=a->devices; d; d=e)
 261     {
 262       e = d->next;
 263       pci_free_dev(d);
 264     }
 265   if (a->methods)
 266     a->methods->cleanup(a);
 267   pci_free_name_list(a);
 268   pci_free_params(a);
 269   pci_set_name_list_path(a, NULL, 0);
 270   pci_mfree(a);
 271 }