xref: /linux-6.15/scripts/mod/file2alias.c (revision a5d8d417)
1 /* Simple code to turn various tables in an ELF file into alias definitions.
2  * This deals with kernel datastructures where they should be
3  * dealt with: in the kernel source.
4  *
5  * Copyright 2002-2003  Rusty Russell, IBM Corporation
6  *           2003       Kai Germaschewski
7  *
8  *
9  * This software may be used and distributed according to the terms
10  * of the GNU General Public License, incorporated herein by reference.
11  */
12 
13 #include <stdarg.h>
14 #include <stdio.h>
15 
16 #include "list.h"
17 #include "xalloc.h"
18 
19 #include "modpost.h"
20 #include "devicetable-offsets.h"
21 
22 /* We use the ELF typedefs for kernel_ulong_t but bite the bullet and
23  * use either stdint.h or inttypes.h for the rest. */
24 #if KERNEL_ELFCLASS == ELFCLASS32
25 typedef Elf32_Addr	kernel_ulong_t;
26 #define BITS_PER_LONG 32
27 #else
28 typedef Elf64_Addr	kernel_ulong_t;
29 #define BITS_PER_LONG 64
30 #endif
31 #ifdef __sun__
32 #include <inttypes.h>
33 #else
34 #include <stdint.h>
35 #endif
36 
37 #include <ctype.h>
38 #include <stdbool.h>
39 
40 /**
41  * module_alias_printf - add auto-generated MODULE_ALIAS()
42  *
43  * @mod: module
44  * @append_wildcard: append '*' for future extension if not exist yet
45  * @fmt: printf(3)-like format
46  */
47 static void __attribute__((format (printf, 3, 4)))
48 module_alias_printf(struct module *mod, bool append_wildcard,
49 		    const char *fmt, ...)
50 {
51 	struct module_alias *new, *als;
52 	size_t len;
53 	int n;
54 	va_list ap;
55 
56 	/* Determine required size. */
57 	va_start(ap, fmt);
58 	n = vsnprintf(NULL, 0, fmt, ap);
59 	va_end(ap);
60 
61 	if (n < 0) {
62 		error("vsnprintf failed\n");
63 		return;
64 	}
65 
66 	len = n + 1;	/* extra byte for '\0' */
67 
68 	if (append_wildcard)
69 		len++;	/* extra byte for '*' */
70 
71 	new = xmalloc(sizeof(*new) + len);
72 
73 	/* Now, really print it to the allocated buffer */
74 	va_start(ap, fmt);
75 	n = vsnprintf(new->str, len, fmt, ap);
76 	va_end(ap);
77 
78 	if (n < 0) {
79 		error("vsnprintf failed\n");
80 		free(new);
81 		return;
82 	}
83 
84 	if (append_wildcard && (n == 0 || new->str[n - 1] != '*')) {
85 		new->str[n] = '*';
86 		new->str[n + 1] = '\0';
87 	}
88 
89 	/* avoid duplication */
90 	list_for_each_entry(als, &mod->aliases, node) {
91 		if (!strcmp(als->str, new->str)) {
92 			free(new);
93 			return;
94 		}
95 	}
96 
97 	list_add_tail(&new->node, &mod->aliases);
98 }
99 
100 typedef uint32_t	__u32;
101 typedef uint16_t	__u16;
102 typedef unsigned char	__u8;
103 
104 /* UUID types for backward compatibility, don't use in new code */
105 typedef struct {
106 	__u8 b[16];
107 } guid_t;
108 
109 typedef struct {
110 	__u8 b[16];
111 } uuid_t;
112 
113 #define	UUID_STRING_LEN		36
114 
115 /* MEI UUID type, don't use anywhere else */
116 typedef struct {
117 	__u8 b[16];
118 } uuid_le;
119 
120 /* Big exception to the "don't include kernel headers into userspace, which
121  * even potentially has different endianness and word sizes, since
122  * we handle those differences explicitly below */
123 #include "../../include/linux/mod_devicetable.h"
124 
125 /* This array collects all instances that use the generic do_table */
126 struct devtable {
127 	const char *device_id; /* name of table, __mod_<name>__*_device_table. */
128 	unsigned long id_size;
129 	void (*do_entry)(struct module *mod, void *symval);
130 };
131 
132 /* Define a variable f that holds the value of field f of struct devid
133  * based at address m.
134  */
135 #define DEF_FIELD(m, devid, f) \
136 	typeof(((struct devid *)0)->f) f = TO_NATIVE(*(typeof(f) *)((m) + OFF_##devid##_##f))
137 
138 /* Define a variable f that holds the address of field f of struct devid
139  * based at address m.  Due to the way typeof works, for a field of type
140  * T[N] the variable has type T(*)[N], _not_ T*.
141  */
142 #define DEF_FIELD_ADDR(m, devid, f) \
143 	typeof(((struct devid *)0)->f) *f = ((m) + OFF_##devid##_##f)
144 
145 #define ADD(str, sep, cond, field)                              \
146 do {                                                            \
147         strcat(str, sep);                                       \
148         if (cond)                                               \
149                 sprintf(str + strlen(str),                      \
150                         sizeof(field) == 1 ? "%02X" :           \
151                         sizeof(field) == 2 ? "%04X" :           \
152                         sizeof(field) == 4 ? "%08X" : "",       \
153                         field);                                 \
154         else                                                    \
155                 sprintf(str + strlen(str), "*");                \
156 } while(0)
157 
158 static inline void add_uuid(char *str, uuid_le uuid)
159 {
160 	int len = strlen(str);
161 
162 	sprintf(str + len, "%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x",
163 		uuid.b[3], uuid.b[2], uuid.b[1], uuid.b[0],
164 		uuid.b[5], uuid.b[4], uuid.b[7], uuid.b[6],
165 		uuid.b[8], uuid.b[9], uuid.b[10], uuid.b[11],
166 		uuid.b[12], uuid.b[13], uuid.b[14], uuid.b[15]);
167 }
168 
169 static inline void add_guid(char *str, guid_t guid)
170 {
171 	int len = strlen(str);
172 
173 	sprintf(str + len, "%02X%02X%02X%02X-%02X%02X-%02X%02X-%02X%02X-%02X%02X%02X%02X%02X%02X",
174 		guid.b[3], guid.b[2], guid.b[1], guid.b[0],
175 		guid.b[5], guid.b[4], guid.b[7], guid.b[6],
176 		guid.b[8], guid.b[9], guid.b[10], guid.b[11],
177 		guid.b[12], guid.b[13], guid.b[14], guid.b[15]);
178 }
179 
180 /**
181  * Check that sizeof(device_id type) are consistent with size of section
182  * in .o file. If in-consistent then userspace and kernel does not agree
183  * on actual size which is a bug.
184  * Also verify that the final entry in the table is all zeros.
185  * Ignore both checks if build host differ from target host and size differs.
186  **/
187 static void device_id_check(const char *modname, const char *device_id,
188 			    unsigned long size, unsigned long id_size,
189 			    void *symval)
190 {
191 	int i;
192 
193 	if (size % id_size || size < id_size) {
194 		fatal("%s: sizeof(struct %s_device_id)=%lu is not a modulo of the size of section __mod_%s__<identifier>_device_table=%lu.\n"
195 		      "Fix definition of struct %s_device_id in mod_devicetable.h\n",
196 		      modname, device_id, id_size, device_id, size, device_id);
197 	}
198 	/* Verify last one is a terminator */
199 	for (i = 0; i < id_size; i++ ) {
200 		if (*(uint8_t*)(symval+size-id_size+i)) {
201 			fprintf(stderr,
202 				"%s: struct %s_device_id is %lu bytes.  The last of %lu is:\n",
203 				modname, device_id, id_size, size / id_size);
204 			for (i = 0; i < id_size; i++ )
205 				fprintf(stderr,"0x%02x ",
206 					*(uint8_t*)(symval+size-id_size+i) );
207 			fprintf(stderr,"\n");
208 			fatal("%s: struct %s_device_id is not terminated with a NULL entry!\n",
209 			      modname, device_id);
210 		}
211 	}
212 }
213 
214 /* USB is special because the bcdDevice can be matched against a numeric range */
215 /* Looks like "usb:vNpNdNdcNdscNdpNicNiscNipNinN" */
216 static void do_usb_entry(void *symval,
217 			 unsigned int bcdDevice_initial, int bcdDevice_initial_digits,
218 			 unsigned char range_lo, unsigned char range_hi,
219 			 unsigned char max, struct module *mod)
220 {
221 	char alias[500];
222 	DEF_FIELD(symval, usb_device_id, match_flags);
223 	DEF_FIELD(symval, usb_device_id, idVendor);
224 	DEF_FIELD(symval, usb_device_id, idProduct);
225 	DEF_FIELD(symval, usb_device_id, bcdDevice_lo);
226 	DEF_FIELD(symval, usb_device_id, bDeviceClass);
227 	DEF_FIELD(symval, usb_device_id, bDeviceSubClass);
228 	DEF_FIELD(symval, usb_device_id, bDeviceProtocol);
229 	DEF_FIELD(symval, usb_device_id, bInterfaceClass);
230 	DEF_FIELD(symval, usb_device_id, bInterfaceSubClass);
231 	DEF_FIELD(symval, usb_device_id, bInterfaceProtocol);
232 	DEF_FIELD(symval, usb_device_id, bInterfaceNumber);
233 
234 	strcpy(alias, "usb:");
235 	ADD(alias, "v", match_flags&USB_DEVICE_ID_MATCH_VENDOR,
236 	    idVendor);
237 	ADD(alias, "p", match_flags&USB_DEVICE_ID_MATCH_PRODUCT,
238 	    idProduct);
239 
240 	strcat(alias, "d");
241 	if (bcdDevice_initial_digits)
242 		sprintf(alias + strlen(alias), "%0*X",
243 			bcdDevice_initial_digits, bcdDevice_initial);
244 	if (range_lo == range_hi)
245 		sprintf(alias + strlen(alias), "%X", range_lo);
246 	else if (range_lo > 0 || range_hi < max) {
247 		if (range_lo > 0x9 || range_hi < 0xA)
248 			sprintf(alias + strlen(alias),
249 				"[%X-%X]",
250 				range_lo,
251 				range_hi);
252 		else {
253 			sprintf(alias + strlen(alias),
254 				range_lo < 0x9 ? "[%X-9" : "[%X",
255 				range_lo);
256 			sprintf(alias + strlen(alias),
257 				range_hi > 0xA ? "A-%X]" : "%X]",
258 				range_hi);
259 		}
260 	}
261 	if (bcdDevice_initial_digits < (sizeof(bcdDevice_lo) * 2 - 1))
262 		strcat(alias, "*");
263 
264 	ADD(alias, "dc", match_flags&USB_DEVICE_ID_MATCH_DEV_CLASS,
265 	    bDeviceClass);
266 	ADD(alias, "dsc", match_flags&USB_DEVICE_ID_MATCH_DEV_SUBCLASS,
267 	    bDeviceSubClass);
268 	ADD(alias, "dp", match_flags&USB_DEVICE_ID_MATCH_DEV_PROTOCOL,
269 	    bDeviceProtocol);
270 	ADD(alias, "ic", match_flags&USB_DEVICE_ID_MATCH_INT_CLASS,
271 	    bInterfaceClass);
272 	ADD(alias, "isc", match_flags&USB_DEVICE_ID_MATCH_INT_SUBCLASS,
273 	    bInterfaceSubClass);
274 	ADD(alias, "ip", match_flags&USB_DEVICE_ID_MATCH_INT_PROTOCOL,
275 	    bInterfaceProtocol);
276 	ADD(alias, "in", match_flags&USB_DEVICE_ID_MATCH_INT_NUMBER,
277 	    bInterfaceNumber);
278 
279 	module_alias_printf(mod, true, "%s", alias);
280 }
281 
282 /* Handles increment/decrement of BCD formatted integers */
283 /* Returns the previous value, so it works like i++ or i-- */
284 static unsigned int incbcd(unsigned int *bcd,
285 			   int inc,
286 			   unsigned char max,
287 			   size_t chars)
288 {
289 	unsigned int init = *bcd, i, j;
290 	unsigned long long c, dec = 0;
291 
292 	/* If bcd is not in BCD format, just increment */
293 	if (max > 0x9) {
294 		*bcd += inc;
295 		return init;
296 	}
297 
298 	/* Convert BCD to Decimal */
299 	for (i=0 ; i < chars ; i++) {
300 		c = (*bcd >> (i << 2)) & 0xf;
301 		c = c > 9 ? 9 : c; /* force to bcd just in case */
302 		for (j=0 ; j < i ; j++)
303 			c = c * 10;
304 		dec += c;
305 	}
306 
307 	/* Do our increment/decrement */
308 	dec += inc;
309 	*bcd  = 0;
310 
311 	/* Convert back to BCD */
312 	for (i=0 ; i < chars ; i++) {
313 		for (c=1,j=0 ; j < i ; j++)
314 			c = c * 10;
315 		c = (dec / c) % 10;
316 		*bcd += c << (i << 2);
317 	}
318 	return init;
319 }
320 
321 static void do_usb_entry_multi(void *symval, struct module *mod)
322 {
323 	unsigned int devlo, devhi;
324 	unsigned char chi, clo, max;
325 	int ndigits;
326 
327 	DEF_FIELD(symval, usb_device_id, match_flags);
328 	DEF_FIELD(symval, usb_device_id, idVendor);
329 	DEF_FIELD(symval, usb_device_id, idProduct);
330 	DEF_FIELD(symval, usb_device_id, bcdDevice_lo);
331 	DEF_FIELD(symval, usb_device_id, bcdDevice_hi);
332 	DEF_FIELD(symval, usb_device_id, bDeviceClass);
333 	DEF_FIELD(symval, usb_device_id, bInterfaceClass);
334 
335 	devlo = match_flags & USB_DEVICE_ID_MATCH_DEV_LO ?
336 		bcdDevice_lo : 0x0U;
337 	devhi = match_flags & USB_DEVICE_ID_MATCH_DEV_HI ?
338 		bcdDevice_hi : ~0x0U;
339 
340 	/* Figure out if this entry is in bcd or hex format */
341 	max = 0x9; /* Default to decimal format */
342 	for (ndigits = 0 ; ndigits < sizeof(bcdDevice_lo) * 2 ; ndigits++) {
343 		clo = (devlo >> (ndigits << 2)) & 0xf;
344 		chi = ((devhi > 0x9999 ? 0x9999 : devhi) >> (ndigits << 2)) & 0xf;
345 		if (clo > max || chi > max) {
346 			max = 0xf;
347 			break;
348 		}
349 	}
350 
351 	/*
352 	 * Some modules (visor) have empty slots as placeholder for
353 	 * run-time specification that results in catch-all alias
354 	 */
355 	if (!(idVendor | idProduct | bDeviceClass | bInterfaceClass))
356 		return;
357 
358 	/* Convert numeric bcdDevice range into fnmatch-able pattern(s) */
359 	for (ndigits = sizeof(bcdDevice_lo) * 2 - 1; devlo <= devhi; ndigits--) {
360 		clo = devlo & 0xf;
361 		chi = devhi & 0xf;
362 		if (chi > max)	/* If we are in bcd mode, truncate if necessary */
363 			chi = max;
364 		devlo >>= 4;
365 		devhi >>= 4;
366 
367 		if (devlo == devhi || !ndigits) {
368 			do_usb_entry(symval, devlo, ndigits, clo, chi, max, mod);
369 			break;
370 		}
371 
372 		if (clo > 0x0)
373 			do_usb_entry(symval,
374 				     incbcd(&devlo, 1, max,
375 					    sizeof(bcdDevice_lo) * 2),
376 				     ndigits, clo, max, max, mod);
377 
378 		if (chi < max)
379 			do_usb_entry(symval,
380 				     incbcd(&devhi, -1, max,
381 					    sizeof(bcdDevice_lo) * 2),
382 				     ndigits, 0x0, chi, max, mod);
383 	}
384 }
385 
386 static void do_usb_table(void *symval, unsigned long size,
387 			 struct module *mod)
388 {
389 	unsigned int i;
390 	const unsigned long id_size = SIZE_usb_device_id;
391 
392 	device_id_check(mod->name, "usb", size, id_size, symval);
393 
394 	/* Leave last one: it's the terminator. */
395 	size -= id_size;
396 
397 	for (i = 0; i < size; i += id_size)
398 		do_usb_entry_multi(symval + i, mod);
399 }
400 
401 static void do_of_entry_multi(void *symval, struct module *mod)
402 {
403 	char alias[500];
404 	int len;
405 	char *tmp;
406 
407 	DEF_FIELD_ADDR(symval, of_device_id, name);
408 	DEF_FIELD_ADDR(symval, of_device_id, type);
409 	DEF_FIELD_ADDR(symval, of_device_id, compatible);
410 
411 	len = sprintf(alias, "of:N%sT%s", (*name)[0] ? *name : "*",
412 		      (*type)[0] ? *type : "*");
413 
414 	if ((*compatible)[0])
415 		sprintf(&alias[len], "%sC%s", (*type)[0] ? "*" : "",
416 			*compatible);
417 
418 	/* Replace all whitespace with underscores */
419 	for (tmp = alias; tmp && *tmp; tmp++)
420 		if (isspace(*tmp))
421 			*tmp = '_';
422 
423 	module_alias_printf(mod, false, "%s", alias);
424 	module_alias_printf(mod, false, "%sC*", alias);
425 }
426 
427 static void do_of_table(void *symval, unsigned long size,
428 			struct module *mod)
429 {
430 	unsigned int i;
431 	const unsigned long id_size = SIZE_of_device_id;
432 
433 	device_id_check(mod->name, "of", size, id_size, symval);
434 
435 	/* Leave last one: it's the terminator. */
436 	size -= id_size;
437 
438 	for (i = 0; i < size; i += id_size)
439 		do_of_entry_multi(symval + i, mod);
440 }
441 
442 /* Looks like: hid:bNvNpN */
443 static void do_hid_entry(struct module *mod, void *symval)
444 {
445 	char alias[256] = {};
446 
447 	DEF_FIELD(symval, hid_device_id, bus);
448 	DEF_FIELD(symval, hid_device_id, group);
449 	DEF_FIELD(symval, hid_device_id, vendor);
450 	DEF_FIELD(symval, hid_device_id, product);
451 
452 	ADD(alias, "b", bus != HID_BUS_ANY, bus);
453 	ADD(alias, "g", group != HID_GROUP_ANY, group);
454 	ADD(alias, "v", vendor != HID_ANY_ID, vendor);
455 	ADD(alias, "p", product != HID_ANY_ID, product);
456 
457 	module_alias_printf(mod, false, "hid:%s", alias);
458 }
459 
460 /* Looks like: ieee1394:venNmoNspNverN */
461 static void do_ieee1394_entry(struct module *mod, void *symval)
462 {
463 	char alias[256] = {};
464 
465 	DEF_FIELD(symval, ieee1394_device_id, match_flags);
466 	DEF_FIELD(symval, ieee1394_device_id, vendor_id);
467 	DEF_FIELD(symval, ieee1394_device_id, model_id);
468 	DEF_FIELD(symval, ieee1394_device_id, specifier_id);
469 	DEF_FIELD(symval, ieee1394_device_id, version);
470 
471 	ADD(alias, "ven", match_flags & IEEE1394_MATCH_VENDOR_ID,
472 	    vendor_id);
473 	ADD(alias, "mo", match_flags & IEEE1394_MATCH_MODEL_ID,
474 	    model_id);
475 	ADD(alias, "sp", match_flags & IEEE1394_MATCH_SPECIFIER_ID,
476 	    specifier_id);
477 	ADD(alias, "ver", match_flags & IEEE1394_MATCH_VERSION,
478 	    version);
479 
480 	module_alias_printf(mod, true, "ieee1394:%s", alias);
481 }
482 
483 /* Looks like: pci:vNdNsvNsdNbcNscNiN or <prefix>_pci:vNdNsvNsdNbcNscNiN. */
484 static void do_pci_entry(struct module *mod, void *symval)
485 {
486 	char alias[256];
487 	/* Class field can be divided into these three. */
488 	unsigned char baseclass, subclass, interface,
489 		baseclass_mask, subclass_mask, interface_mask;
490 
491 	DEF_FIELD(symval, pci_device_id, vendor);
492 	DEF_FIELD(symval, pci_device_id, device);
493 	DEF_FIELD(symval, pci_device_id, subvendor);
494 	DEF_FIELD(symval, pci_device_id, subdevice);
495 	DEF_FIELD(symval, pci_device_id, class);
496 	DEF_FIELD(symval, pci_device_id, class_mask);
497 	DEF_FIELD(symval, pci_device_id, override_only);
498 
499 	switch (override_only) {
500 	case 0:
501 		strcpy(alias, "pci:");
502 		break;
503 	case PCI_ID_F_VFIO_DRIVER_OVERRIDE:
504 		strcpy(alias, "vfio_pci:");
505 		break;
506 	default:
507 		warn("Unknown PCI driver_override alias %08X\n",
508 		     override_only);
509 	}
510 
511 	ADD(alias, "v", vendor != PCI_ANY_ID, vendor);
512 	ADD(alias, "d", device != PCI_ANY_ID, device);
513 	ADD(alias, "sv", subvendor != PCI_ANY_ID, subvendor);
514 	ADD(alias, "sd", subdevice != PCI_ANY_ID, subdevice);
515 
516 	baseclass = (class) >> 16;
517 	baseclass_mask = (class_mask) >> 16;
518 	subclass = (class) >> 8;
519 	subclass_mask = (class_mask) >> 8;
520 	interface = class;
521 	interface_mask = class_mask;
522 
523 	if ((baseclass_mask != 0 && baseclass_mask != 0xFF)
524 	    || (subclass_mask != 0 && subclass_mask != 0xFF)
525 	    || (interface_mask != 0 && interface_mask != 0xFF)) {
526 		warn("Can't handle masks in %s:%04X\n",
527 		     mod->name, class_mask);
528 		return;
529 	}
530 
531 	ADD(alias, "bc", baseclass_mask == 0xFF, baseclass);
532 	ADD(alias, "sc", subclass_mask == 0xFF, subclass);
533 	ADD(alias, "i", interface_mask == 0xFF, interface);
534 
535 	module_alias_printf(mod, true, "%s", alias);
536 }
537 
538 /* looks like: "ccw:tNmNdtNdmN" */
539 static void do_ccw_entry(struct module *mod, void *symval)
540 {
541 	char alias[256] = {};
542 
543 	DEF_FIELD(symval, ccw_device_id, match_flags);
544 	DEF_FIELD(symval, ccw_device_id, cu_type);
545 	DEF_FIELD(symval, ccw_device_id, cu_model);
546 	DEF_FIELD(symval, ccw_device_id, dev_type);
547 	DEF_FIELD(symval, ccw_device_id, dev_model);
548 
549 	ADD(alias, "t", match_flags&CCW_DEVICE_ID_MATCH_CU_TYPE,
550 	    cu_type);
551 	ADD(alias, "m", match_flags&CCW_DEVICE_ID_MATCH_CU_MODEL,
552 	    cu_model);
553 	ADD(alias, "dt", match_flags&CCW_DEVICE_ID_MATCH_DEVICE_TYPE,
554 	    dev_type);
555 	ADD(alias, "dm", match_flags&CCW_DEVICE_ID_MATCH_DEVICE_MODEL,
556 	    dev_model);
557 
558 	module_alias_printf(mod, true, "ccw:%s", alias);
559 }
560 
561 /* looks like: "ap:tN" */
562 static void do_ap_entry(struct module *mod, void *symval)
563 {
564 	DEF_FIELD(symval, ap_device_id, dev_type);
565 
566 	module_alias_printf(mod, false, "ap:t%02X*", dev_type);
567 }
568 
569 /* looks like: "css:tN" */
570 static void do_css_entry(struct module *mod, void *symval)
571 {
572 	DEF_FIELD(symval, css_device_id, type);
573 
574 	module_alias_printf(mod, false, "css:t%01X", type);
575 }
576 
577 /* Looks like: "serio:tyNprNidNexN" */
578 static void do_serio_entry(struct module *mod, void *symval)
579 {
580 	char alias[256] = {};
581 
582 	DEF_FIELD(symval, serio_device_id, type);
583 	DEF_FIELD(symval, serio_device_id, proto);
584 	DEF_FIELD(symval, serio_device_id, id);
585 	DEF_FIELD(symval, serio_device_id, extra);
586 
587 	ADD(alias, "ty", type != SERIO_ANY, type);
588 	ADD(alias, "pr", proto != SERIO_ANY, proto);
589 	ADD(alias, "id", id != SERIO_ANY, id);
590 	ADD(alias, "ex", extra != SERIO_ANY, extra);
591 
592 	module_alias_printf(mod, true, "serio:%s", alias);
593 }
594 
595 /* looks like: "acpi:ACPI0003" or "acpi:PNP0C0B" or "acpi:LNXVIDEO" or
596  *             "acpi:bbsspp" (bb=base-class, ss=sub-class, pp=prog-if)
597  *
598  * NOTE: Each driver should use one of the following : _HID, _CIDs
599  *       or _CLS. Also, bb, ss, and pp can be substituted with ??
600  *       as don't care byte.
601  */
602 static void do_acpi_entry(struct module *mod, void *symval)
603 {
604 	DEF_FIELD_ADDR(symval, acpi_device_id, id);
605 	DEF_FIELD(symval, acpi_device_id, cls);
606 	DEF_FIELD(symval, acpi_device_id, cls_msk);
607 
608 	if ((*id)[0])
609 		module_alias_printf(mod, false, "acpi*:%s:*", *id);
610 	else {
611 		char alias[256];
612 		int i, byte_shift, cnt = 0;
613 		unsigned int msk;
614 
615 		for (i = 1; i <= 3; i++) {
616 			byte_shift = 8 * (3-i);
617 			msk = (cls_msk >> byte_shift) & 0xFF;
618 			if (msk)
619 				sprintf(&alias[cnt], "%02x",
620 					(cls >> byte_shift) & 0xFF);
621 			else
622 				sprintf(&alias[cnt], "??");
623 			cnt += 2;
624 		}
625 		module_alias_printf(mod, false, "acpi*:%s:*", alias);
626 	}
627 }
628 
629 /* looks like: "pnp:dD" */
630 static void do_pnp_device_entry(void *symval, unsigned long size,
631 				struct module *mod)
632 {
633 	const unsigned long id_size = SIZE_pnp_device_id;
634 	const unsigned int count = (size / id_size)-1;
635 	unsigned int i;
636 
637 	device_id_check(mod->name, "pnp", size, id_size, symval);
638 
639 	for (i = 0; i < count; i++) {
640 		DEF_FIELD_ADDR(symval + i*id_size, pnp_device_id, id);
641 		char acpi_id[sizeof(*id)];
642 		int j;
643 
644 		module_alias_printf(mod, false, "pnp:d%s*", *id);
645 
646 		/* fix broken pnp bus lowercasing */
647 		for (j = 0; j < sizeof(acpi_id); j++)
648 			acpi_id[j] = toupper((*id)[j]);
649 		module_alias_printf(mod, false, "acpi*:%s:*", acpi_id);
650 	}
651 }
652 
653 /* looks like: "pnp:dD" for every device of the card */
654 static void do_pnp_card_entry(struct module *mod, void *symval)
655 {
656 	DEF_FIELD_ADDR(symval, pnp_card_device_id, devs);
657 
658 	for (unsigned int i = 0; i < PNP_MAX_DEVICES; i++) {
659 		const char *id = (char *)(*devs)[i].id;
660 		char acpi_id[PNP_ID_LEN];
661 
662 		if (!id[0])
663 			break;
664 
665 		/* fix broken pnp bus lowercasing */
666 		for (unsigned int j = 0; j < sizeof(acpi_id); j++)
667 			acpi_id[j] = toupper(id[j]);
668 
669 		/* add an individual alias for every device entry */
670 		module_alias_printf(mod, false, "pnp:d%s*", id);
671 		module_alias_printf(mod, false, "acpi*:%s:*", acpi_id);
672 	}
673 }
674 
675 /* Looks like: pcmcia:mNcNfNfnNpfnNvaNvbNvcNvdN. */
676 static void do_pcmcia_entry(struct module *mod, void *symval)
677 {
678 	char alias[256] = {};
679 	unsigned int i;
680 	DEF_FIELD(symval, pcmcia_device_id, match_flags);
681 	DEF_FIELD(symval, pcmcia_device_id, manf_id);
682 	DEF_FIELD(symval, pcmcia_device_id, card_id);
683 	DEF_FIELD(symval, pcmcia_device_id, func_id);
684 	DEF_FIELD(symval, pcmcia_device_id, function);
685 	DEF_FIELD(symval, pcmcia_device_id, device_no);
686 	DEF_FIELD_ADDR(symval, pcmcia_device_id, prod_id_hash);
687 
688 	for (i=0; i<4; i++) {
689 		(*prod_id_hash)[i] = TO_NATIVE((*prod_id_hash)[i]);
690 	}
691 
692 	ADD(alias, "m", match_flags & PCMCIA_DEV_ID_MATCH_MANF_ID,
693 	    manf_id);
694 	ADD(alias, "c", match_flags & PCMCIA_DEV_ID_MATCH_CARD_ID,
695 	    card_id);
696 	ADD(alias, "f", match_flags & PCMCIA_DEV_ID_MATCH_FUNC_ID,
697 	    func_id);
698 	ADD(alias, "fn", match_flags & PCMCIA_DEV_ID_MATCH_FUNCTION,
699 	    function);
700 	ADD(alias, "pfn", match_flags & PCMCIA_DEV_ID_MATCH_DEVICE_NO,
701 	    device_no);
702 	ADD(alias, "pa", match_flags & PCMCIA_DEV_ID_MATCH_PROD_ID1, (*prod_id_hash)[0]);
703 	ADD(alias, "pb", match_flags & PCMCIA_DEV_ID_MATCH_PROD_ID2, (*prod_id_hash)[1]);
704 	ADD(alias, "pc", match_flags & PCMCIA_DEV_ID_MATCH_PROD_ID3, (*prod_id_hash)[2]);
705 	ADD(alias, "pd", match_flags & PCMCIA_DEV_ID_MATCH_PROD_ID4, (*prod_id_hash)[3]);
706 
707 	module_alias_printf(mod, true, "pcmcia:%s", alias);
708 }
709 
710 static void do_vio_entry(struct module *mod, void *symval)
711 {
712 	char alias[256];
713 	char *tmp;
714 	DEF_FIELD_ADDR(symval, vio_device_id, type);
715 	DEF_FIELD_ADDR(symval, vio_device_id, compat);
716 
717 	sprintf(alias, "vio:T%sS%s", (*type)[0] ? *type : "*",
718 			(*compat)[0] ? *compat : "*");
719 
720 	/* Replace all whitespace with underscores */
721 	for (tmp = alias; tmp && *tmp; tmp++)
722 		if (isspace (*tmp))
723 			*tmp = '_';
724 
725 	module_alias_printf(mod, true, "%s", alias);
726 }
727 
728 static void do_input(char *alias,
729 		     kernel_ulong_t *arr, unsigned int min, unsigned int max)
730 {
731 	unsigned int i;
732 
733 	for (i = min / BITS_PER_LONG; i < max / BITS_PER_LONG + 1; i++)
734 		arr[i] = TO_NATIVE(arr[i]);
735 	for (i = min; i < max; i++)
736 		if (arr[i / BITS_PER_LONG] & (1ULL << (i%BITS_PER_LONG)))
737 			sprintf(alias + strlen(alias), "%X,*", i);
738 }
739 
740 /* input:b0v0p0e0-eXkXrXaXmXlXsXfXwX where X is comma-separated %02X. */
741 static void do_input_entry(struct module *mod, void *symval)
742 {
743 	char alias[256] = {};
744 
745 	DEF_FIELD(symval, input_device_id, flags);
746 	DEF_FIELD(symval, input_device_id, bustype);
747 	DEF_FIELD(symval, input_device_id, vendor);
748 	DEF_FIELD(symval, input_device_id, product);
749 	DEF_FIELD(symval, input_device_id, version);
750 	DEF_FIELD_ADDR(symval, input_device_id, evbit);
751 	DEF_FIELD_ADDR(symval, input_device_id, keybit);
752 	DEF_FIELD_ADDR(symval, input_device_id, relbit);
753 	DEF_FIELD_ADDR(symval, input_device_id, absbit);
754 	DEF_FIELD_ADDR(symval, input_device_id, mscbit);
755 	DEF_FIELD_ADDR(symval, input_device_id, ledbit);
756 	DEF_FIELD_ADDR(symval, input_device_id, sndbit);
757 	DEF_FIELD_ADDR(symval, input_device_id, ffbit);
758 	DEF_FIELD_ADDR(symval, input_device_id, swbit);
759 
760 	ADD(alias, "b", flags & INPUT_DEVICE_ID_MATCH_BUS, bustype);
761 	ADD(alias, "v", flags & INPUT_DEVICE_ID_MATCH_VENDOR, vendor);
762 	ADD(alias, "p", flags & INPUT_DEVICE_ID_MATCH_PRODUCT, product);
763 	ADD(alias, "e", flags & INPUT_DEVICE_ID_MATCH_VERSION, version);
764 
765 	sprintf(alias + strlen(alias), "-e*");
766 	if (flags & INPUT_DEVICE_ID_MATCH_EVBIT)
767 		do_input(alias, *evbit, 0, INPUT_DEVICE_ID_EV_MAX);
768 	sprintf(alias + strlen(alias), "k*");
769 	if (flags & INPUT_DEVICE_ID_MATCH_KEYBIT)
770 		do_input(alias, *keybit,
771 			 INPUT_DEVICE_ID_KEY_MIN_INTERESTING,
772 			 INPUT_DEVICE_ID_KEY_MAX);
773 	sprintf(alias + strlen(alias), "r*");
774 	if (flags & INPUT_DEVICE_ID_MATCH_RELBIT)
775 		do_input(alias, *relbit, 0, INPUT_DEVICE_ID_REL_MAX);
776 	sprintf(alias + strlen(alias), "a*");
777 	if (flags & INPUT_DEVICE_ID_MATCH_ABSBIT)
778 		do_input(alias, *absbit, 0, INPUT_DEVICE_ID_ABS_MAX);
779 	sprintf(alias + strlen(alias), "m*");
780 	if (flags & INPUT_DEVICE_ID_MATCH_MSCIT)
781 		do_input(alias, *mscbit, 0, INPUT_DEVICE_ID_MSC_MAX);
782 	sprintf(alias + strlen(alias), "l*");
783 	if (flags & INPUT_DEVICE_ID_MATCH_LEDBIT)
784 		do_input(alias, *ledbit, 0, INPUT_DEVICE_ID_LED_MAX);
785 	sprintf(alias + strlen(alias), "s*");
786 	if (flags & INPUT_DEVICE_ID_MATCH_SNDBIT)
787 		do_input(alias, *sndbit, 0, INPUT_DEVICE_ID_SND_MAX);
788 	sprintf(alias + strlen(alias), "f*");
789 	if (flags & INPUT_DEVICE_ID_MATCH_FFBIT)
790 		do_input(alias, *ffbit, 0, INPUT_DEVICE_ID_FF_MAX);
791 	sprintf(alias + strlen(alias), "w*");
792 	if (flags & INPUT_DEVICE_ID_MATCH_SWBIT)
793 		do_input(alias, *swbit, 0, INPUT_DEVICE_ID_SW_MAX);
794 
795 	module_alias_printf(mod, false, "input:%s", alias);
796 }
797 
798 static void do_eisa_entry(struct module *mod, void *symval)
799 {
800 	DEF_FIELD_ADDR(symval, eisa_device_id, sig);
801 	module_alias_printf(mod, false, EISA_DEVICE_MODALIAS_FMT "*", *sig);
802 }
803 
804 /* Looks like: parisc:tNhvNrevNsvN */
805 static void do_parisc_entry(struct module *mod, void *symval)
806 {
807 	char alias[256] = {};
808 
809 	DEF_FIELD(symval, parisc_device_id, hw_type);
810 	DEF_FIELD(symval, parisc_device_id, hversion);
811 	DEF_FIELD(symval, parisc_device_id, hversion_rev);
812 	DEF_FIELD(symval, parisc_device_id, sversion);
813 
814 	ADD(alias, "t", hw_type != PA_HWTYPE_ANY_ID, hw_type);
815 	ADD(alias, "hv", hversion != PA_HVERSION_ANY_ID, hversion);
816 	ADD(alias, "rev", hversion_rev != PA_HVERSION_REV_ANY_ID, hversion_rev);
817 	ADD(alias, "sv", sversion != PA_SVERSION_ANY_ID, sversion);
818 
819 	module_alias_printf(mod, true, "parisc:%s", alias);
820 }
821 
822 /* Looks like: sdio:cNvNdN. */
823 static void do_sdio_entry(struct module *mod, void *symval)
824 {
825 	char alias[256] = {};
826 
827 	DEF_FIELD(symval, sdio_device_id, class);
828 	DEF_FIELD(symval, sdio_device_id, vendor);
829 	DEF_FIELD(symval, sdio_device_id, device);
830 
831 	ADD(alias, "c", class != (__u8)SDIO_ANY_ID, class);
832 	ADD(alias, "v", vendor != (__u16)SDIO_ANY_ID, vendor);
833 	ADD(alias, "d", device != (__u16)SDIO_ANY_ID, device);
834 
835 	module_alias_printf(mod, true, "sdio:%s", alias);
836 }
837 
838 /* Looks like: ssb:vNidNrevN. */
839 static void do_ssb_entry(struct module *mod, void *symval)
840 {
841 	char alias[256] = {};
842 
843 	DEF_FIELD(symval, ssb_device_id, vendor);
844 	DEF_FIELD(symval, ssb_device_id, coreid);
845 	DEF_FIELD(symval, ssb_device_id, revision);
846 
847 	ADD(alias, "v", vendor != SSB_ANY_VENDOR, vendor);
848 	ADD(alias, "id", coreid != SSB_ANY_ID, coreid);
849 	ADD(alias, "rev", revision != SSB_ANY_REV, revision);
850 
851 	module_alias_printf(mod, true, "ssb:%s", alias);
852 }
853 
854 /* Looks like: bcma:mNidNrevNclN. */
855 static void do_bcma_entry(struct module *mod, void *symval)
856 {
857 	char alias[256] = {};
858 
859 	DEF_FIELD(symval, bcma_device_id, manuf);
860 	DEF_FIELD(symval, bcma_device_id, id);
861 	DEF_FIELD(symval, bcma_device_id, rev);
862 	DEF_FIELD(symval, bcma_device_id, class);
863 
864 	ADD(alias, "m", manuf != BCMA_ANY_MANUF, manuf);
865 	ADD(alias, "id", id != BCMA_ANY_ID, id);
866 	ADD(alias, "rev", rev != BCMA_ANY_REV, rev);
867 	ADD(alias, "cl", class != BCMA_ANY_CLASS, class);
868 
869 	module_alias_printf(mod, true, "bcma:%s", alias);
870 }
871 
872 /* Looks like: virtio:dNvN */
873 static void do_virtio_entry(struct module *mod, void *symval)
874 {
875 	char alias[256] = {};
876 
877 	DEF_FIELD(symval, virtio_device_id, device);
878 	DEF_FIELD(symval, virtio_device_id, vendor);
879 
880 	ADD(alias, "d", device != VIRTIO_DEV_ANY_ID, device);
881 	ADD(alias, "v", vendor != VIRTIO_DEV_ANY_ID, vendor);
882 
883 	module_alias_printf(mod, true, "virtio:%s", alias);
884 }
885 
886 /*
887  * Looks like: vmbus:guid
888  * Each byte of the guid will be represented by two hex characters
889  * in the name.
890  */
891 
892 static void do_vmbus_entry(struct module *mod, void *symval)
893 {
894 	int i;
895 	DEF_FIELD_ADDR(symval, hv_vmbus_device_id, guid);
896 	char guid_name[(sizeof(*guid) + 1) * 2];
897 
898 	for (i = 0; i < (sizeof(*guid) * 2); i += 2)
899 		sprintf(&guid_name[i], "%02x", TO_NATIVE((guid->b)[i/2]));
900 
901 	module_alias_printf(mod, false, "vmbus:%s", guid_name);
902 }
903 
904 /* Looks like: rpmsg:S */
905 static void do_rpmsg_entry(struct module *mod, void *symval)
906 {
907 	DEF_FIELD_ADDR(symval, rpmsg_device_id, name);
908 
909 	module_alias_printf(mod, false, RPMSG_DEVICE_MODALIAS_FMT, *name);
910 }
911 
912 /* Looks like: i2c:S */
913 static void do_i2c_entry(struct module *mod, void *symval)
914 {
915 	DEF_FIELD_ADDR(symval, i2c_device_id, name);
916 
917 	module_alias_printf(mod, false, I2C_MODULE_PREFIX "%s", *name);
918 }
919 
920 static void do_i3c_entry(struct module *mod, void *symval)
921 {
922 	char alias[256] = {};
923 
924 	DEF_FIELD(symval, i3c_device_id, match_flags);
925 	DEF_FIELD(symval, i3c_device_id, dcr);
926 	DEF_FIELD(symval, i3c_device_id, manuf_id);
927 	DEF_FIELD(symval, i3c_device_id, part_id);
928 	DEF_FIELD(symval, i3c_device_id, extra_info);
929 
930 	ADD(alias, "dcr", match_flags & I3C_MATCH_DCR, dcr);
931 	ADD(alias, "manuf", match_flags & I3C_MATCH_MANUF, manuf_id);
932 	ADD(alias, "part", match_flags & I3C_MATCH_PART, part_id);
933 	ADD(alias, "ext", match_flags & I3C_MATCH_EXTRA_INFO, extra_info);
934 
935 	module_alias_printf(mod, false, "i3c:%s", alias);
936 }
937 
938 static void do_slim_entry(struct module *mod, void *symval)
939 {
940 	DEF_FIELD(symval, slim_device_id, manf_id);
941 	DEF_FIELD(symval, slim_device_id, prod_code);
942 
943 	module_alias_printf(mod, false, "slim:%x:%x:*", manf_id, prod_code);
944 }
945 
946 /* Looks like: spi:S */
947 static void do_spi_entry(struct module *mod, void *symval)
948 {
949 	DEF_FIELD_ADDR(symval, spi_device_id, name);
950 
951 	module_alias_printf(mod, false, SPI_MODULE_PREFIX "%s", *name);
952 }
953 
954 static const struct dmifield {
955 	const char *prefix;
956 	int field;
957 } dmi_fields[] = {
958 	{ "bvn", DMI_BIOS_VENDOR },
959 	{ "bvr", DMI_BIOS_VERSION },
960 	{ "bd",  DMI_BIOS_DATE },
961 	{ "br",  DMI_BIOS_RELEASE },
962 	{ "efr", DMI_EC_FIRMWARE_RELEASE },
963 	{ "svn", DMI_SYS_VENDOR },
964 	{ "pn",  DMI_PRODUCT_NAME },
965 	{ "pvr", DMI_PRODUCT_VERSION },
966 	{ "rvn", DMI_BOARD_VENDOR },
967 	{ "rn",  DMI_BOARD_NAME },
968 	{ "rvr", DMI_BOARD_VERSION },
969 	{ "cvn", DMI_CHASSIS_VENDOR },
970 	{ "ct",  DMI_CHASSIS_TYPE },
971 	{ "cvr", DMI_CHASSIS_VERSION },
972 	{ NULL,  DMI_NONE }
973 };
974 
975 static void dmi_ascii_filter(char *d, const char *s)
976 {
977 	/* Filter out characters we don't want to see in the modalias string */
978 	for (; *s; s++)
979 		if (*s > ' ' && *s < 127 && *s != ':')
980 			*(d++) = *s;
981 
982 	*d = 0;
983 }
984 
985 
986 static void do_dmi_entry(struct module *mod, void *symval)
987 {
988 	char alias[256] = {};
989 	int i, j;
990 	DEF_FIELD_ADDR(symval, dmi_system_id, matches);
991 
992 	for (i = 0; i < ARRAY_SIZE(dmi_fields); i++) {
993 		for (j = 0; j < 4; j++) {
994 			if ((*matches)[j].slot &&
995 			    (*matches)[j].slot == dmi_fields[i].field) {
996 				sprintf(alias + strlen(alias), ":%s*",
997 					dmi_fields[i].prefix);
998 				dmi_ascii_filter(alias + strlen(alias),
999 						 (*matches)[j].substr);
1000 				strcat(alias, "*");
1001 			}
1002 		}
1003 	}
1004 
1005 	module_alias_printf(mod, false, "dmi*%s:", alias);
1006 }
1007 
1008 static void do_platform_entry(struct module *mod, void *symval)
1009 {
1010 	DEF_FIELD_ADDR(symval, platform_device_id, name);
1011 
1012 	module_alias_printf(mod, false, PLATFORM_MODULE_PREFIX "%s", *name);
1013 }
1014 
1015 static void do_mdio_entry(struct module *mod, void *symval)
1016 {
1017 	char id[33];
1018 	int i;
1019 	DEF_FIELD(symval, mdio_device_id, phy_id);
1020 	DEF_FIELD(symval, mdio_device_id, phy_id_mask);
1021 
1022 	for (i = 0; i < 32; i++) {
1023 		if (!((phy_id_mask >> (31-i)) & 1))
1024 			id[i] = '?';
1025 		else if ((phy_id >> (31-i)) & 1)
1026 			id[i] = '1';
1027 		else
1028 			id[i] = '0';
1029 	}
1030 
1031 	/* Terminate the string */
1032 	id[32] = '\0';
1033 
1034 	module_alias_printf(mod, false, MDIO_MODULE_PREFIX "%s", id);
1035 }
1036 
1037 /* Looks like: zorro:iN. */
1038 static void do_zorro_entry(struct module *mod, void *symval)
1039 {
1040 	char alias[256] = {};
1041 	DEF_FIELD(symval, zorro_device_id, id);
1042 
1043 	ADD(alias, "i", id != ZORRO_WILDCARD, id);
1044 
1045 	module_alias_printf(mod, false, "zorro:%s", alias);
1046 }
1047 
1048 /* looks like: "pnp:dD" */
1049 static void do_isapnp_entry(struct module *mod, void *symval)
1050 {
1051 	DEF_FIELD(symval, isapnp_device_id, vendor);
1052 	DEF_FIELD(symval, isapnp_device_id, function);
1053 	module_alias_printf(mod, false, "pnp:d%c%c%c%x%x%x%x*",
1054 		'A' + ((vendor >> 2) & 0x3f) - 1,
1055 		'A' + (((vendor & 3) << 3) | ((vendor >> 13) & 7)) - 1,
1056 		'A' + ((vendor >> 8) & 0x1f) - 1,
1057 		(function >> 4) & 0x0f, function & 0x0f,
1058 		(function >> 12) & 0x0f, (function >> 8) & 0x0f);
1059 }
1060 
1061 /* Looks like: "ipack:fNvNdN". */
1062 static void do_ipack_entry(struct module *mod, void *symval)
1063 {
1064 	char alias[256] = {};
1065 	DEF_FIELD(symval, ipack_device_id, format);
1066 	DEF_FIELD(symval, ipack_device_id, vendor);
1067 	DEF_FIELD(symval, ipack_device_id, device);
1068 
1069 	ADD(alias, "f", format != IPACK_ANY_FORMAT, format);
1070 	ADD(alias, "v", vendor != IPACK_ANY_ID, vendor);
1071 	ADD(alias, "d", device != IPACK_ANY_ID, device);
1072 
1073 	module_alias_printf(mod, true, "ipack:%s", alias);
1074 }
1075 
1076 /*
1077  * Append a match expression for a single masked hex digit.
1078  * outp points to a pointer to the character at which to append.
1079  *	*outp is updated on return to point just after the appended text,
1080  *	to facilitate further appending.
1081  */
1082 static void append_nibble_mask(char **outp,
1083 			       unsigned int nibble, unsigned int mask)
1084 {
1085 	char *p = *outp;
1086 	unsigned int i;
1087 
1088 	switch (mask) {
1089 	case 0:
1090 		*p++ = '?';
1091 		break;
1092 
1093 	case 0xf:
1094 		p += sprintf(p, "%X",  nibble);
1095 		break;
1096 
1097 	default:
1098 		/*
1099 		 * Dumbly emit a match pattern for all possible matching
1100 		 * digits.  This could be improved in some cases using ranges,
1101 		 * but it has the advantage of being trivially correct, and is
1102 		 * often optimal.
1103 		 */
1104 		*p++ = '[';
1105 		for (i = 0; i < 0x10; i++)
1106 			if ((i & mask) == nibble)
1107 				p += sprintf(p, "%X", i);
1108 		*p++ = ']';
1109 	}
1110 
1111 	/* Ensure that the string remains NUL-terminated: */
1112 	*p = '\0';
1113 
1114 	/* Advance the caller's end-of-string pointer: */
1115 	*outp = p;
1116 }
1117 
1118 /*
1119  * looks like: "amba:dN"
1120  *
1121  * N is exactly 8 digits, where each is an upper-case hex digit, or
1122  *	a ? or [] pattern matching exactly one digit.
1123  */
1124 static void do_amba_entry(struct module *mod, void *symval)
1125 {
1126 	char alias[256];
1127 	unsigned int digit;
1128 	char *p = alias;
1129 	DEF_FIELD(symval, amba_id, id);
1130 	DEF_FIELD(symval, amba_id, mask);
1131 
1132 	if ((id & mask) != id)
1133 		fatal("%s: Masked-off bit(s) of AMBA device ID are non-zero: id=0x%08X, mask=0x%08X.  Please fix this driver.\n",
1134 		      mod->name, id, mask);
1135 
1136 	for (digit = 0; digit < 8; digit++)
1137 		append_nibble_mask(&p,
1138 				   (id >> (4 * (7 - digit))) & 0xf,
1139 				   (mask >> (4 * (7 - digit))) & 0xf);
1140 
1141 	module_alias_printf(mod, false, "amba:d%s", alias);
1142 }
1143 
1144 /*
1145  * looks like: "mipscdmm:tN"
1146  *
1147  * N is exactly 2 digits, where each is an upper-case hex digit, or
1148  *	a ? or [] pattern matching exactly one digit.
1149  */
1150 static void do_mips_cdmm_entry(struct module *mod, void *symval)
1151 {
1152 	DEF_FIELD(symval, mips_cdmm_device_id, type);
1153 
1154 	module_alias_printf(mod, false, "mipscdmm:t%02X*", type);
1155 }
1156 
1157 /* LOOKS like cpu:type:x86,venVVVVfamFFFFmodMMMM:feature:*,FEAT,*
1158  * All fields are numbers. It would be nicer to use strings for vendor
1159  * and feature, but getting those out of the build system here is too
1160  * complicated.
1161  */
1162 
1163 static void do_x86cpu_entry(struct module *mod, void *symval)
1164 {
1165 	char alias[256] = {};
1166 
1167 	DEF_FIELD(symval, x86_cpu_id, feature);
1168 	DEF_FIELD(symval, x86_cpu_id, family);
1169 	DEF_FIELD(symval, x86_cpu_id, model);
1170 	DEF_FIELD(symval, x86_cpu_id, vendor);
1171 
1172 	ADD(alias, "ven", vendor != X86_VENDOR_ANY, vendor);
1173 	ADD(alias, "fam", family != X86_FAMILY_ANY, family);
1174 	ADD(alias, "mod", model  != X86_MODEL_ANY,  model);
1175 	strcat(alias, ":feature:*");
1176 	if (feature != X86_FEATURE_ANY)
1177 		sprintf(alias + strlen(alias), "%04X*", feature);
1178 
1179 	module_alias_printf(mod, false, "cpu:type:x86,%s", alias);
1180 }
1181 
1182 /* LOOKS like cpu:type:*:feature:*FEAT* */
1183 static void do_cpu_entry(struct module *mod, void *symval)
1184 {
1185 	DEF_FIELD(symval, cpu_feature, feature);
1186 
1187 	module_alias_printf(mod, false, "cpu:type:*:feature:*%04X*", feature);
1188 }
1189 
1190 /* Looks like: mei:S:uuid:N:* */
1191 static void do_mei_entry(struct module *mod, void *symval)
1192 {
1193 	char alias[256] = {};
1194 
1195 	DEF_FIELD_ADDR(symval, mei_cl_device_id, name);
1196 	DEF_FIELD_ADDR(symval, mei_cl_device_id, uuid);
1197 	DEF_FIELD(symval, mei_cl_device_id, version);
1198 
1199 	add_uuid(alias, *uuid);
1200 	ADD(alias, ":", version != MEI_CL_VERSION_ANY, version);
1201 
1202 	module_alias_printf(mod, false, MEI_CL_MODULE_PREFIX "%s:%s:*",
1203 			    (*name)[0] ? *name : "*", alias);
1204 }
1205 
1206 /* Looks like: rapidio:vNdNavNadN */
1207 static void do_rio_entry(struct module *mod, void *symval)
1208 {
1209 	char alias[256] = {};
1210 
1211 	DEF_FIELD(symval, rio_device_id, did);
1212 	DEF_FIELD(symval, rio_device_id, vid);
1213 	DEF_FIELD(symval, rio_device_id, asm_did);
1214 	DEF_FIELD(symval, rio_device_id, asm_vid);
1215 
1216 	ADD(alias, "v", vid != RIO_ANY_ID, vid);
1217 	ADD(alias, "d", did != RIO_ANY_ID, did);
1218 	ADD(alias, "av", asm_vid != RIO_ANY_ID, asm_vid);
1219 	ADD(alias, "ad", asm_did != RIO_ANY_ID, asm_did);
1220 
1221 	module_alias_printf(mod, true, "rapidio:%s", alias);
1222 }
1223 
1224 /* Looks like: ulpi:vNpN */
1225 static void do_ulpi_entry(struct module *mod, void *symval)
1226 {
1227 	DEF_FIELD(symval, ulpi_device_id, vendor);
1228 	DEF_FIELD(symval, ulpi_device_id, product);
1229 
1230 	module_alias_printf(mod, false, "ulpi:v%04xp%04x", vendor, product);
1231 }
1232 
1233 /* Looks like: hdaudio:vNrNaN */
1234 static void do_hda_entry(struct module *mod, void *symval)
1235 {
1236 	char alias[256] = {};
1237 
1238 	DEF_FIELD(symval, hda_device_id, vendor_id);
1239 	DEF_FIELD(symval, hda_device_id, rev_id);
1240 	DEF_FIELD(symval, hda_device_id, api_version);
1241 
1242 	ADD(alias, "v", vendor_id != 0, vendor_id);
1243 	ADD(alias, "r", rev_id != 0, rev_id);
1244 	ADD(alias, "a", api_version != 0, api_version);
1245 
1246 	module_alias_printf(mod, true, "hdaudio:%s", alias);
1247 }
1248 
1249 /* Looks like: sdw:mNpNvNcN */
1250 static void do_sdw_entry(struct module *mod, void *symval)
1251 {
1252 	char alias[256] = {};
1253 
1254 	DEF_FIELD(symval, sdw_device_id, mfg_id);
1255 	DEF_FIELD(symval, sdw_device_id, part_id);
1256 	DEF_FIELD(symval, sdw_device_id, sdw_version);
1257 	DEF_FIELD(symval, sdw_device_id, class_id);
1258 
1259 	ADD(alias, "m", mfg_id != 0, mfg_id);
1260 	ADD(alias, "p", part_id != 0, part_id);
1261 	ADD(alias, "v", sdw_version != 0, sdw_version);
1262 	ADD(alias, "c", class_id != 0, class_id);
1263 
1264 	module_alias_printf(mod, true, "sdw:%s", alias);
1265 }
1266 
1267 /* Looks like: fsl-mc:vNdN */
1268 static void do_fsl_mc_entry(struct module *mod, void *symval)
1269 {
1270 	DEF_FIELD(symval, fsl_mc_device_id, vendor);
1271 	DEF_FIELD_ADDR(symval, fsl_mc_device_id, obj_type);
1272 
1273 	module_alias_printf(mod, false, "fsl-mc:v%08Xd%s", vendor, *obj_type);
1274 }
1275 
1276 /* Looks like: tbsvc:kSpNvNrN */
1277 static void do_tbsvc_entry(struct module *mod, void *symval)
1278 {
1279 	char alias[256] = {};
1280 
1281 	DEF_FIELD(symval, tb_service_id, match_flags);
1282 	DEF_FIELD_ADDR(symval, tb_service_id, protocol_key);
1283 	DEF_FIELD(symval, tb_service_id, protocol_id);
1284 	DEF_FIELD(symval, tb_service_id, protocol_version);
1285 	DEF_FIELD(symval, tb_service_id, protocol_revision);
1286 
1287 	if (match_flags & TBSVC_MATCH_PROTOCOL_KEY)
1288 		sprintf(alias + strlen(alias), "k%s", *protocol_key);
1289 	else
1290 		strcat(alias + strlen(alias), "k*");
1291 	ADD(alias, "p", match_flags & TBSVC_MATCH_PROTOCOL_ID, protocol_id);
1292 	ADD(alias, "v", match_flags & TBSVC_MATCH_PROTOCOL_VERSION,
1293 	    protocol_version);
1294 	ADD(alias, "r", match_flags & TBSVC_MATCH_PROTOCOL_REVISION,
1295 	    protocol_revision);
1296 
1297 	module_alias_printf(mod, true, "tbsvc:%s", alias);
1298 }
1299 
1300 /* Looks like: typec:idNmN */
1301 static void do_typec_entry(struct module *mod, void *symval)
1302 {
1303 	char alias[256] = {};
1304 
1305 	DEF_FIELD(symval, typec_device_id, svid);
1306 	DEF_FIELD(symval, typec_device_id, mode);
1307 
1308 	ADD(alias, "m", mode != TYPEC_ANY_MODE, mode);
1309 
1310 	module_alias_printf(mod, false, "typec:id%04X%s", svid, alias);
1311 }
1312 
1313 /* Looks like: tee:uuid */
1314 static void do_tee_entry(struct module *mod, void *symval)
1315 {
1316 	DEF_FIELD_ADDR(symval, tee_client_device_id, uuid);
1317 
1318 	module_alias_printf(mod, true,
1319 			    "tee:%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x",
1320 		uuid->b[0], uuid->b[1], uuid->b[2], uuid->b[3], uuid->b[4],
1321 		uuid->b[5], uuid->b[6], uuid->b[7], uuid->b[8], uuid->b[9],
1322 		uuid->b[10], uuid->b[11], uuid->b[12], uuid->b[13], uuid->b[14],
1323 		uuid->b[15]);
1324 }
1325 
1326 /* Looks like: wmi:guid */
1327 static void do_wmi_entry(struct module *mod, void *symval)
1328 {
1329 	DEF_FIELD_ADDR(symval, wmi_device_id, guid_string);
1330 
1331 	if (strlen(*guid_string) != UUID_STRING_LEN) {
1332 		warn("Invalid WMI device id 'wmi:%s' in '%s'\n",
1333 				*guid_string, mod->name);
1334 		return;
1335 	}
1336 
1337 	module_alias_printf(mod, false, WMI_MODULE_PREFIX "%s", *guid_string);
1338 }
1339 
1340 /* Looks like: mhi:S */
1341 static void do_mhi_entry(struct module *mod, void *symval)
1342 {
1343 	DEF_FIELD_ADDR(symval, mhi_device_id, chan);
1344 	module_alias_printf(mod, false, MHI_DEVICE_MODALIAS_FMT, *chan);
1345 }
1346 
1347 /* Looks like: mhi_ep:S */
1348 static void do_mhi_ep_entry(struct module *mod, void *symval)
1349 {
1350 	DEF_FIELD_ADDR(symval, mhi_device_id, chan);
1351 
1352 	module_alias_printf(mod, false, MHI_EP_DEVICE_MODALIAS_FMT, *chan);
1353 }
1354 
1355 /* Looks like: ishtp:{guid} */
1356 static void do_ishtp_entry(struct module *mod, void *symval)
1357 {
1358 	char alias[256] = {};
1359 	DEF_FIELD_ADDR(symval, ishtp_device_id, guid);
1360 
1361 	add_guid(alias, *guid);
1362 
1363 	module_alias_printf(mod, false, ISHTP_MODULE_PREFIX "{%s}", alias);
1364 }
1365 
1366 static void do_auxiliary_entry(struct module *mod, void *symval)
1367 {
1368 	DEF_FIELD_ADDR(symval, auxiliary_device_id, name);
1369 
1370 	module_alias_printf(mod, false, AUXILIARY_MODULE_PREFIX "%s", *name);
1371 }
1372 
1373 /*
1374  * Looks like: ssam:dNcNtNiNfN
1375  *
1376  * N is exactly 2 digits, where each is an upper-case hex digit.
1377  */
1378 static void do_ssam_entry(struct module *mod, void *symval)
1379 {
1380 	char alias[256] = {};
1381 
1382 	DEF_FIELD(symval, ssam_device_id, match_flags);
1383 	DEF_FIELD(symval, ssam_device_id, domain);
1384 	DEF_FIELD(symval, ssam_device_id, category);
1385 	DEF_FIELD(symval, ssam_device_id, target);
1386 	DEF_FIELD(symval, ssam_device_id, instance);
1387 	DEF_FIELD(symval, ssam_device_id, function);
1388 
1389 	ADD(alias, "t", match_flags & SSAM_MATCH_TARGET, target);
1390 	ADD(alias, "i", match_flags & SSAM_MATCH_INSTANCE, instance);
1391 	ADD(alias, "f", match_flags & SSAM_MATCH_FUNCTION, function);
1392 
1393 	module_alias_printf(mod, false, "ssam:d%02Xc%02X%s",
1394 			    domain, category, alias);
1395 }
1396 
1397 /* Looks like: dfl:tNfN */
1398 static void do_dfl_entry(struct module *mod, void *symval)
1399 {
1400 	DEF_FIELD(symval, dfl_device_id, type);
1401 	DEF_FIELD(symval, dfl_device_id, feature_id);
1402 
1403 	module_alias_printf(mod, true, "dfl:t%04Xf%04X", type, feature_id);
1404 }
1405 
1406 /* Looks like: cdx:vNdN */
1407 static void do_cdx_entry(struct module *mod, void *symval)
1408 {
1409 	char alias[256];
1410 
1411 	DEF_FIELD(symval, cdx_device_id, vendor);
1412 	DEF_FIELD(symval, cdx_device_id, device);
1413 	DEF_FIELD(symval, cdx_device_id, subvendor);
1414 	DEF_FIELD(symval, cdx_device_id, subdevice);
1415 	DEF_FIELD(symval, cdx_device_id, class);
1416 	DEF_FIELD(symval, cdx_device_id, class_mask);
1417 	DEF_FIELD(symval, cdx_device_id, override_only);
1418 
1419 	switch (override_only) {
1420 	case 0:
1421 		strcpy(alias, "cdx:");
1422 		break;
1423 	case CDX_ID_F_VFIO_DRIVER_OVERRIDE:
1424 		strcpy(alias, "vfio_cdx:");
1425 		break;
1426 	default:
1427 		warn("Unknown CDX driver_override alias %08X\n",
1428 		     override_only);
1429 		return;
1430 	}
1431 
1432 	ADD(alias, "v", vendor != CDX_ANY_ID, vendor);
1433 	ADD(alias, "d", device != CDX_ANY_ID, device);
1434 	ADD(alias, "sv", subvendor != CDX_ANY_ID, subvendor);
1435 	ADD(alias, "sd", subdevice != CDX_ANY_ID, subdevice);
1436 	ADD(alias, "c", class_mask == 0xFFFFFF, class);
1437 
1438 	module_alias_printf(mod, false, "%s", alias);
1439 }
1440 
1441 static void do_vchiq_entry(struct module *mod, void *symval)
1442 {
1443 	DEF_FIELD_ADDR(symval, vchiq_device_id, name);
1444 
1445 	module_alias_printf(mod, false, "vchiq:%s", *name);
1446 }
1447 
1448 /* Looks like: coreboot:tN */
1449 static void do_coreboot_entry(struct module *mod, void *symval)
1450 {
1451 	DEF_FIELD(symval, coreboot_device_id, tag);
1452 
1453 	module_alias_printf(mod, false, "coreboot:t%08X", tag);
1454 }
1455 
1456 /* Does namelen bytes of name exactly match the symbol? */
1457 static bool sym_is(const char *name, unsigned namelen, const char *symbol)
1458 {
1459 	if (namelen != strlen(symbol))
1460 		return false;
1461 
1462 	return memcmp(name, symbol, namelen) == 0;
1463 }
1464 
1465 static void do_table(void *symval, unsigned long size,
1466 		     unsigned long id_size,
1467 		     const char *device_id,
1468 		     void (*do_entry)(struct module *mod, void *symval),
1469 		     struct module *mod)
1470 {
1471 	unsigned int i;
1472 
1473 	device_id_check(mod->name, device_id, size, id_size, symval);
1474 	/* Leave last one: it's the terminator. */
1475 	size -= id_size;
1476 
1477 	for (i = 0; i < size; i += id_size)
1478 		do_entry(mod, symval + i);
1479 }
1480 
1481 static const struct devtable devtable[] = {
1482 	{"hid", SIZE_hid_device_id, do_hid_entry},
1483 	{"ieee1394", SIZE_ieee1394_device_id, do_ieee1394_entry},
1484 	{"pci", SIZE_pci_device_id, do_pci_entry},
1485 	{"ccw", SIZE_ccw_device_id, do_ccw_entry},
1486 	{"ap", SIZE_ap_device_id, do_ap_entry},
1487 	{"css", SIZE_css_device_id, do_css_entry},
1488 	{"serio", SIZE_serio_device_id, do_serio_entry},
1489 	{"acpi", SIZE_acpi_device_id, do_acpi_entry},
1490 	{"pcmcia", SIZE_pcmcia_device_id, do_pcmcia_entry},
1491 	{"vio", SIZE_vio_device_id, do_vio_entry},
1492 	{"input", SIZE_input_device_id, do_input_entry},
1493 	{"eisa", SIZE_eisa_device_id, do_eisa_entry},
1494 	{"parisc", SIZE_parisc_device_id, do_parisc_entry},
1495 	{"sdio", SIZE_sdio_device_id, do_sdio_entry},
1496 	{"ssb", SIZE_ssb_device_id, do_ssb_entry},
1497 	{"bcma", SIZE_bcma_device_id, do_bcma_entry},
1498 	{"virtio", SIZE_virtio_device_id, do_virtio_entry},
1499 	{"vmbus", SIZE_hv_vmbus_device_id, do_vmbus_entry},
1500 	{"rpmsg", SIZE_rpmsg_device_id, do_rpmsg_entry},
1501 	{"i2c", SIZE_i2c_device_id, do_i2c_entry},
1502 	{"i3c", SIZE_i3c_device_id, do_i3c_entry},
1503 	{"slim", SIZE_slim_device_id, do_slim_entry},
1504 	{"spi", SIZE_spi_device_id, do_spi_entry},
1505 	{"dmi", SIZE_dmi_system_id, do_dmi_entry},
1506 	{"platform", SIZE_platform_device_id, do_platform_entry},
1507 	{"mdio", SIZE_mdio_device_id, do_mdio_entry},
1508 	{"zorro", SIZE_zorro_device_id, do_zorro_entry},
1509 	{"isapnp", SIZE_isapnp_device_id, do_isapnp_entry},
1510 	{"ipack", SIZE_ipack_device_id, do_ipack_entry},
1511 	{"amba", SIZE_amba_id, do_amba_entry},
1512 	{"mipscdmm", SIZE_mips_cdmm_device_id, do_mips_cdmm_entry},
1513 	{"x86cpu", SIZE_x86_cpu_id, do_x86cpu_entry},
1514 	{"cpu", SIZE_cpu_feature, do_cpu_entry},
1515 	{"mei", SIZE_mei_cl_device_id, do_mei_entry},
1516 	{"rapidio", SIZE_rio_device_id, do_rio_entry},
1517 	{"ulpi", SIZE_ulpi_device_id, do_ulpi_entry},
1518 	{"hdaudio", SIZE_hda_device_id, do_hda_entry},
1519 	{"sdw", SIZE_sdw_device_id, do_sdw_entry},
1520 	{"fslmc", SIZE_fsl_mc_device_id, do_fsl_mc_entry},
1521 	{"tbsvc", SIZE_tb_service_id, do_tbsvc_entry},
1522 	{"typec", SIZE_typec_device_id, do_typec_entry},
1523 	{"tee", SIZE_tee_client_device_id, do_tee_entry},
1524 	{"wmi", SIZE_wmi_device_id, do_wmi_entry},
1525 	{"mhi", SIZE_mhi_device_id, do_mhi_entry},
1526 	{"mhi_ep", SIZE_mhi_device_id, do_mhi_ep_entry},
1527 	{"auxiliary", SIZE_auxiliary_device_id, do_auxiliary_entry},
1528 	{"ssam", SIZE_ssam_device_id, do_ssam_entry},
1529 	{"dfl", SIZE_dfl_device_id, do_dfl_entry},
1530 	{"ishtp", SIZE_ishtp_device_id, do_ishtp_entry},
1531 	{"cdx", SIZE_cdx_device_id, do_cdx_entry},
1532 	{"vchiq", SIZE_vchiq_device_id, do_vchiq_entry},
1533 	{"coreboot", SIZE_coreboot_device_id, do_coreboot_entry},
1534 	{"pnp_card", SIZE_pnp_card_device_id, do_pnp_card_entry},
1535 };
1536 
1537 /* Create MODULE_ALIAS() statements.
1538  * At this time, we cannot write the actual output C source yet,
1539  * so we write into the mod->dev_table_buf buffer. */
1540 void handle_moddevtable(struct module *mod, struct elf_info *info,
1541 			Elf_Sym *sym, const char *symname)
1542 {
1543 	void *symval;
1544 	char *zeros = NULL;
1545 	const char *name, *identifier;
1546 	unsigned int namelen;
1547 
1548 	/* We're looking for a section relative symbol */
1549 	if (!sym->st_shndx || get_secindex(info, sym) >= info->num_sections)
1550 		return;
1551 
1552 	/* We're looking for an object */
1553 	if (ELF_ST_TYPE(sym->st_info) != STT_OBJECT)
1554 		return;
1555 
1556 	/* All our symbols are of form __mod_<name>__<identifier>_device_table. */
1557 	if (strncmp(symname, "__mod_", strlen("__mod_")))
1558 		return;
1559 	name = symname + strlen("__mod_");
1560 	namelen = strlen(name);
1561 	if (namelen < strlen("_device_table"))
1562 		return;
1563 	if (strcmp(name + namelen - strlen("_device_table"), "_device_table"))
1564 		return;
1565 	identifier = strstr(name, "__");
1566 	if (!identifier)
1567 		return;
1568 	namelen = identifier - name;
1569 
1570 	/* Handle all-NULL symbols allocated into .bss */
1571 	if (info->sechdrs[get_secindex(info, sym)].sh_type & SHT_NOBITS) {
1572 		zeros = calloc(1, sym->st_size);
1573 		symval = zeros;
1574 	} else {
1575 		symval = sym_get_data(info, sym);
1576 	}
1577 
1578 	/* First handle the "special" cases */
1579 	if (sym_is(name, namelen, "usb"))
1580 		do_usb_table(symval, sym->st_size, mod);
1581 	else if (sym_is(name, namelen, "of"))
1582 		do_of_table(symval, sym->st_size, mod);
1583 	else if (sym_is(name, namelen, "pnp"))
1584 		do_pnp_device_entry(symval, sym->st_size, mod);
1585 	else {
1586 		int i;
1587 
1588 		for (i = 0; i < ARRAY_SIZE(devtable); i++) {
1589 			const struct devtable *p = &devtable[i];
1590 
1591 			if (sym_is(name, namelen, p->device_id)) {
1592 				do_table(symval, sym->st_size, p->id_size,
1593 					 p->device_id, p->do_entry, mod);
1594 				break;
1595 			}
1596 		}
1597 	}
1598 	free(zeros);
1599 }
1600