1 /* Postprocess module symbol versions
3 * Copyright 2003 Kai Germaschewski
4 * Copyright 2002-2004 Rusty Russell, IBM Corporation
5 * Copyright 2006-2008 Sam Ravnborg
6 * Based in part on module-init-tools/depmod.c,file2alias
8 * This software may be used and distributed according to the terms
9 * of the GNU General Public License, incorporated herein by reference.
11 * Usage: modpost vmlinux module1.o module2.o ...
18 #include "../../include/linux/license.h"
20 /* Are we using CONFIG_MODVERSIONS? */
22 /* Warn about undefined symbols? (do so if we have vmlinux) */
24 /* Is CONFIG_MODULE_SRCVERSION_ALL set? */
25 static int all_versions
= 0;
26 /* If we are modposting external module set to 1 */
27 static int external_module
= 0;
28 /* Warn about section mismatch in vmlinux if set to 1 */
29 static int vmlinux_section_warnings
= 1;
30 /* Only warn about unresolved symbols */
31 static int warn_unresolved
= 0;
32 /* How a symbol is exported */
33 static int sec_mismatch_count
= 0;
34 static int sec_mismatch_verbose
= 1;
37 export_plain
, export_unused
, export_gpl
,
38 export_unused_gpl
, export_gpl_future
, export_unknown
41 #define PRINTF __attribute__ ((format (printf, 1, 2)))
43 PRINTF
void fatal(const char *fmt
, ...)
47 fprintf(stderr
, "FATAL: ");
49 va_start(arglist
, fmt
);
50 vfprintf(stderr
, fmt
, arglist
);
56 PRINTF
void warn(const char *fmt
, ...)
60 fprintf(stderr
, "WARNING: ");
62 va_start(arglist
, fmt
);
63 vfprintf(stderr
, fmt
, arglist
);
67 PRINTF
void merror(const char *fmt
, ...)
71 fprintf(stderr
, "ERROR: ");
73 va_start(arglist
, fmt
);
74 vfprintf(stderr
, fmt
, arglist
);
78 static int is_vmlinux(const char *modname
)
82 myname
= strrchr(modname
, '/');
88 return (strcmp(myname
, "vmlinux") == 0) ||
89 (strcmp(myname
, "vmlinux.o") == 0);
92 void *do_nofail(void *ptr
, const char *expr
)
95 fatal("modpost: Memory allocation failure: %s.\n", expr
);
100 /* A list of all modules we processed */
101 static struct module
*modules
;
103 static struct module
*find_module(char *modname
)
107 for (mod
= modules
; mod
; mod
= mod
->next
)
108 if (strcmp(mod
->name
, modname
) == 0)
113 static struct module
*new_module(char *modname
)
118 mod
= NOFAIL(malloc(sizeof(*mod
)));
119 memset(mod
, 0, sizeof(*mod
));
120 p
= NOFAIL(strdup(modname
));
122 /* strip trailing .o */
125 if (strcmp(s
, ".o") == 0)
130 mod
->gpl_compatible
= -1;
137 /* A hash of all exported symbols,
138 * struct symbol is also used for lists of unresolved symbols */
140 #define SYMBOL_HASH_SIZE 1024
144 struct module
*module
;
148 unsigned int vmlinux
:1; /* 1 if symbol is defined in vmlinux */
149 unsigned int kernel
:1; /* 1 if symbol is from kernel
150 * (only for external modules) **/
151 unsigned int preloaded
:1; /* 1 if symbol from Module.symvers */
152 enum export export
; /* Type of export */
156 static struct symbol
*symbolhash
[SYMBOL_HASH_SIZE
];
158 /* This is based on the hash agorithm from gdbm, via tdb */
159 static inline unsigned int tdb_hash(const char *name
)
161 unsigned value
; /* Used to compute the hash value. */
162 unsigned i
; /* Used to cycle through random values. */
164 /* Set the initial value from the key size. */
165 for (value
= 0x238F13AF * strlen(name
), i
= 0; name
[i
]; i
++)
166 value
= (value
+ (((unsigned char *)name
)[i
] << (i
*5 % 24)));
168 return (1103515243 * value
+ 12345);
172 * Allocate a new symbols for use in the hash of exported symbols or
173 * the list of unresolved symbols per module
175 static struct symbol
*alloc_symbol(const char *name
, unsigned int weak
,
178 struct symbol
*s
= NOFAIL(malloc(sizeof(*s
) + strlen(name
) + 1));
180 memset(s
, 0, sizeof(*s
));
181 strcpy(s
->name
, name
);
187 /* For the hash of exported symbols */
188 static struct symbol
*new_symbol(const char *name
, struct module
*module
,
194 hash
= tdb_hash(name
) % SYMBOL_HASH_SIZE
;
195 new = symbolhash
[hash
] = alloc_symbol(name
, 0, symbolhash
[hash
]);
196 new->module
= module
;
197 new->export
= export
;
201 static struct symbol
*find_symbol(const char *name
)
205 /* For our purposes, .foo matches foo. PPC64 needs this. */
209 for (s
= symbolhash
[tdb_hash(name
) % SYMBOL_HASH_SIZE
]; s
; s
= s
->next
) {
210 if (strcmp(s
->name
, name
) == 0)
220 { .str
= "EXPORT_SYMBOL", .export
= export_plain
},
221 { .str
= "EXPORT_UNUSED_SYMBOL", .export
= export_unused
},
222 { .str
= "EXPORT_SYMBOL_GPL", .export
= export_gpl
},
223 { .str
= "EXPORT_UNUSED_SYMBOL_GPL", .export
= export_unused_gpl
},
224 { .str
= "EXPORT_SYMBOL_GPL_FUTURE", .export
= export_gpl_future
},
225 { .str
= "(unknown)", .export
= export_unknown
},
229 static const char *export_str(enum export ex
)
231 return export_list
[ex
].str
;
234 static enum export
export_no(const char *s
)
239 return export_unknown
;
240 for (i
= 0; export_list
[i
].export
!= export_unknown
; i
++) {
241 if (strcmp(export_list
[i
].str
, s
) == 0)
242 return export_list
[i
].export
;
244 return export_unknown
;
247 static enum export
export_from_sec(struct elf_info
*elf
, Elf_Section sec
)
249 if (sec
== elf
->export_sec
)
251 else if (sec
== elf
->export_unused_sec
)
252 return export_unused
;
253 else if (sec
== elf
->export_gpl_sec
)
255 else if (sec
== elf
->export_unused_gpl_sec
)
256 return export_unused_gpl
;
257 else if (sec
== elf
->export_gpl_future_sec
)
258 return export_gpl_future
;
260 return export_unknown
;
264 * Add an exported symbol - it may have already been added without a
265 * CRC, in this case just update the CRC
267 static struct symbol
*sym_add_exported(const char *name
, struct module
*mod
,
270 struct symbol
*s
= find_symbol(name
);
273 s
= new_symbol(name
, mod
, export
);
276 warn("%s: '%s' exported twice. Previous export "
277 "was in %s%s\n", mod
->name
, name
,
279 is_vmlinux(s
->module
->name
) ?"":".ko");
281 /* In case Modules.symvers was out of date */
286 s
->vmlinux
= is_vmlinux(mod
->name
);
292 static void sym_update_crc(const char *name
, struct module
*mod
,
293 unsigned int crc
, enum export export
)
295 struct symbol
*s
= find_symbol(name
);
298 s
= new_symbol(name
, mod
, export
);
303 void *grab_file(const char *filename
, unsigned long *size
)
309 fd
= open(filename
, O_RDONLY
);
310 if (fd
< 0 || fstat(fd
, &st
) != 0)
314 map
= mmap(NULL
, *size
, PROT_READ
|PROT_WRITE
, MAP_PRIVATE
, fd
, 0);
317 if (map
== MAP_FAILED
)
323 * Return a copy of the next line in a mmap'ed file.
324 * spaces in the beginning of the line is trimmed away.
325 * Return a pointer to a static buffer.
327 char *get_next_line(unsigned long *pos
, void *file
, unsigned long size
)
329 static char line
[4096];
332 signed char *p
= (signed char *)file
+ *pos
;
335 for (; *pos
< size
; (*pos
)++) {
336 if (skip
&& isspace(*p
)) {
341 if (*p
!= '\n' && (*pos
< size
)) {
345 break; /* Too long, stop */
356 void release_file(void *file
, unsigned long size
)
361 static int parse_elf(struct elf_info
*info
, const char *filename
)
368 hdr
= grab_file(filename
, &info
->size
);
374 if (info
->size
< sizeof(*hdr
)) {
375 /* file too small, assume this is an empty .o file */
378 /* Is this a valid ELF file? */
379 if ((hdr
->e_ident
[EI_MAG0
] != ELFMAG0
) ||
380 (hdr
->e_ident
[EI_MAG1
] != ELFMAG1
) ||
381 (hdr
->e_ident
[EI_MAG2
] != ELFMAG2
) ||
382 (hdr
->e_ident
[EI_MAG3
] != ELFMAG3
)) {
383 /* Not an ELF file - silently ignore it */
386 /* Fix endianness in ELF header */
387 hdr
->e_shoff
= TO_NATIVE(hdr
->e_shoff
);
388 hdr
->e_shstrndx
= TO_NATIVE(hdr
->e_shstrndx
);
389 hdr
->e_shnum
= TO_NATIVE(hdr
->e_shnum
);
390 hdr
->e_machine
= TO_NATIVE(hdr
->e_machine
);
391 hdr
->e_type
= TO_NATIVE(hdr
->e_type
);
392 sechdrs
= (void *)hdr
+ hdr
->e_shoff
;
393 info
->sechdrs
= sechdrs
;
395 /* Check if file offset is correct */
396 if (hdr
->e_shoff
> info
->size
) {
397 fatal("section header offset=%lu in file '%s' is bigger than "
398 "filesize=%lu\n", (unsigned long)hdr
->e_shoff
,
399 filename
, info
->size
);
403 /* Fix endianness in section headers */
404 for (i
= 0; i
< hdr
->e_shnum
; i
++) {
405 sechdrs
[i
].sh_type
= TO_NATIVE(sechdrs
[i
].sh_type
);
406 sechdrs
[i
].sh_offset
= TO_NATIVE(sechdrs
[i
].sh_offset
);
407 sechdrs
[i
].sh_size
= TO_NATIVE(sechdrs
[i
].sh_size
);
408 sechdrs
[i
].sh_link
= TO_NATIVE(sechdrs
[i
].sh_link
);
409 sechdrs
[i
].sh_name
= TO_NATIVE(sechdrs
[i
].sh_name
);
410 sechdrs
[i
].sh_info
= TO_NATIVE(sechdrs
[i
].sh_info
);
411 sechdrs
[i
].sh_addr
= TO_NATIVE(sechdrs
[i
].sh_addr
);
413 /* Find symbol table. */
414 for (i
= 1; i
< hdr
->e_shnum
; i
++) {
415 const char *secstrings
416 = (void *)hdr
+ sechdrs
[hdr
->e_shstrndx
].sh_offset
;
419 if (sechdrs
[i
].sh_offset
> info
->size
) {
420 fatal("%s is truncated. sechdrs[i].sh_offset=%lu > "
421 "sizeof(*hrd)=%zu\n", filename
,
422 (unsigned long)sechdrs
[i
].sh_offset
,
426 secname
= secstrings
+ sechdrs
[i
].sh_name
;
427 if (strcmp(secname
, ".modinfo") == 0) {
428 info
->modinfo
= (void *)hdr
+ sechdrs
[i
].sh_offset
;
429 info
->modinfo_len
= sechdrs
[i
].sh_size
;
430 } else if (strcmp(secname
, "__ksymtab") == 0)
431 info
->export_sec
= i
;
432 else if (strcmp(secname
, "__ksymtab_unused") == 0)
433 info
->export_unused_sec
= i
;
434 else if (strcmp(secname
, "__ksymtab_gpl") == 0)
435 info
->export_gpl_sec
= i
;
436 else if (strcmp(secname
, "__ksymtab_unused_gpl") == 0)
437 info
->export_unused_gpl_sec
= i
;
438 else if (strcmp(secname
, "__ksymtab_gpl_future") == 0)
439 info
->export_gpl_future_sec
= i
;
440 else if (strcmp(secname
, "__markers_strings") == 0)
441 info
->markers_strings_sec
= i
;
443 if (sechdrs
[i
].sh_type
!= SHT_SYMTAB
)
446 info
->symtab_start
= (void *)hdr
+ sechdrs
[i
].sh_offset
;
447 info
->symtab_stop
= (void *)hdr
+ sechdrs
[i
].sh_offset
448 + sechdrs
[i
].sh_size
;
449 info
->strtab
= (void *)hdr
+
450 sechdrs
[sechdrs
[i
].sh_link
].sh_offset
;
452 if (!info
->symtab_start
)
453 fatal("%s has no symtab?\n", filename
);
455 /* Fix endianness in symbols */
456 for (sym
= info
->symtab_start
; sym
< info
->symtab_stop
; sym
++) {
457 sym
->st_shndx
= TO_NATIVE(sym
->st_shndx
);
458 sym
->st_name
= TO_NATIVE(sym
->st_name
);
459 sym
->st_value
= TO_NATIVE(sym
->st_value
);
460 sym
->st_size
= TO_NATIVE(sym
->st_size
);
465 static void parse_elf_finish(struct elf_info
*info
)
467 release_file(info
->hdr
, info
->size
);
470 #define CRC_PFX MODULE_SYMBOL_PREFIX "__crc_"
471 #define KSYMTAB_PFX MODULE_SYMBOL_PREFIX "__ksymtab_"
473 static void handle_modversions(struct module
*mod
, struct elf_info
*info
,
474 Elf_Sym
*sym
, const char *symname
)
477 enum export export
= export_from_sec(info
, sym
->st_shndx
);
479 switch (sym
->st_shndx
) {
481 warn("\"%s\" [%s] is COMMON symbol\n", symname
, mod
->name
);
485 if (memcmp(symname
, CRC_PFX
, strlen(CRC_PFX
)) == 0) {
486 crc
= (unsigned int) sym
->st_value
;
487 sym_update_crc(symname
+ strlen(CRC_PFX
), mod
, crc
,
492 /* undefined symbol */
493 if (ELF_ST_BIND(sym
->st_info
) != STB_GLOBAL
&&
494 ELF_ST_BIND(sym
->st_info
) != STB_WEAK
)
496 /* ignore global offset table */
497 if (strcmp(symname
, "_GLOBAL_OFFSET_TABLE_") == 0)
499 /* ignore __this_module, it will be resolved shortly */
500 if (strcmp(symname
, MODULE_SYMBOL_PREFIX
"__this_module") == 0)
502 /* cope with newer glibc (2.3.4 or higher) STT_ definition in elf.h */
503 #if defined(STT_REGISTER) || defined(STT_SPARC_REGISTER)
504 /* add compatibility with older glibc */
505 #ifndef STT_SPARC_REGISTER
506 #define STT_SPARC_REGISTER STT_REGISTER
508 if (info
->hdr
->e_machine
== EM_SPARC
||
509 info
->hdr
->e_machine
== EM_SPARCV9
) {
510 /* Ignore register directives. */
511 if (ELF_ST_TYPE(sym
->st_info
) == STT_SPARC_REGISTER
)
513 if (symname
[0] == '.') {
514 char *munged
= strdup(symname
);
516 munged
[1] = toupper(munged
[1]);
522 if (memcmp(symname
, MODULE_SYMBOL_PREFIX
,
523 strlen(MODULE_SYMBOL_PREFIX
)) == 0) {
525 alloc_symbol(symname
+
526 strlen(MODULE_SYMBOL_PREFIX
),
527 ELF_ST_BIND(sym
->st_info
) == STB_WEAK
,
532 /* All exported symbols */
533 if (memcmp(symname
, KSYMTAB_PFX
, strlen(KSYMTAB_PFX
)) == 0) {
534 sym_add_exported(symname
+ strlen(KSYMTAB_PFX
), mod
,
537 if (strcmp(symname
, MODULE_SYMBOL_PREFIX
"init_module") == 0)
539 if (strcmp(symname
, MODULE_SYMBOL_PREFIX
"cleanup_module") == 0)
540 mod
->has_cleanup
= 1;
546 * Parse tag=value strings from .modinfo section
548 static char *next_string(char *string
, unsigned long *secsize
)
550 /* Skip non-zero chars */
553 if ((*secsize
)-- <= 1)
557 /* Skip any zero padding. */
560 if ((*secsize
)-- <= 1)
566 static char *get_next_modinfo(void *modinfo
, unsigned long modinfo_len
,
567 const char *tag
, char *info
)
570 unsigned int taglen
= strlen(tag
);
571 unsigned long size
= modinfo_len
;
574 size
-= info
- (char *)modinfo
;
575 modinfo
= next_string(info
, &size
);
578 for (p
= modinfo
; p
; p
= next_string(p
, &size
)) {
579 if (strncmp(p
, tag
, taglen
) == 0 && p
[taglen
] == '=')
580 return p
+ taglen
+ 1;
585 static char *get_modinfo(void *modinfo
, unsigned long modinfo_len
,
589 return get_next_modinfo(modinfo
, modinfo_len
, tag
, NULL
);
593 * Test if string s ends in string sub
596 static int strrcmp(const char *s
, const char *sub
)
604 sublen
= strlen(sub
);
606 if ((slen
== 0) || (sublen
== 0))
612 return memcmp(s
+ slen
- sublen
, sub
, sublen
);
615 static const char *sym_name(struct elf_info
*elf
, Elf_Sym
*sym
)
618 return elf
->strtab
+ sym
->st_name
;
623 static const char *sec_name(struct elf_info
*elf
, int shndx
)
625 Elf_Shdr
*sechdrs
= elf
->sechdrs
;
626 return (void *)elf
->hdr
+
627 elf
->sechdrs
[elf
->hdr
->e_shstrndx
].sh_offset
+
628 sechdrs
[shndx
].sh_name
;
631 static const char *sech_name(struct elf_info
*elf
, Elf_Shdr
*sechdr
)
633 return (void *)elf
->hdr
+
634 elf
->sechdrs
[elf
->hdr
->e_shstrndx
].sh_offset
+
638 /* if sym is empty or point to a string
639 * like ".[0-9]+" then return 1.
640 * This is the optional prefix added by ld to some sections
642 static int number_prefix(const char *sym
)
650 if (c
< '0' || c
> '9')
656 /* The pattern is an array of simple patterns.
657 * "foo" will match an exact string equal to "foo"
658 * "*foo" will match a string that ends with "foo"
659 * "foo*" will match a string that begins with "foo"
660 * "foo$" will match a string equal to "foo" or "foo.1"
661 * where the '1' can be any number including several digits.
662 * The $ syntax is for sections where ld append a dot number
663 * to make section name unique.
665 int match(const char *sym
, const char * const pat
[])
670 const char *endp
= p
+ strlen(p
) - 1;
674 if (strrcmp(sym
, p
+ 1) == 0)
678 else if (*endp
== '*') {
679 if (strncmp(sym
, p
, strlen(p
) - 1) == 0)
683 else if (*endp
== '$') {
684 if (strncmp(sym
, p
, strlen(p
) - 1) == 0) {
685 if (number_prefix(sym
+ strlen(p
) - 1))
691 if (strcmp(p
, sym
) == 0)
699 /* sections that we do not want to do full section mismatch check on */
700 static const char *section_white_list
[] =
701 { ".debug*", ".stab*", ".note*", ".got*", ".toc*", NULL
};
704 * Is this section one we do not want to check?
705 * This is often debug sections.
706 * If we are going to check this section then
707 * test if section name ends with a dot and a number.
708 * This is used to find sections where the linker have
709 * appended a dot-number to make the name unique.
710 * The cause of this is often a section specified in assembler
711 * without "ax" / "aw" and the same section used in .c
712 * code where gcc add these.
714 static int check_section(const char *modname
, const char *sec
)
716 const char *e
= sec
+ strlen(sec
) - 1;
717 if (match(sec
, section_white_list
))
720 if (*e
&& isdigit(*e
)) {
721 /* consume all digits */
722 while (*e
&& e
!= sec
&& isdigit(*e
))
725 warn("%s (%s): unexpected section name.\n"
726 "The (.[number]+) following section name are "
727 "ld generated and not expected.\n"
728 "Did you forget to use \"ax\"/\"aw\" "
730 "Note that for example <linux/init.h> contains\n"
731 "section definitions for use in .S files.\n\n",
740 #define ALL_INIT_DATA_SECTIONS \
741 ".init.data$", ".devinit.data$", ".cpuinit.data$", ".meminit.data$"
742 #define ALL_EXIT_DATA_SECTIONS \
743 ".exit.data$", ".devexit.data$", ".cpuexit.data$", ".memexit.data$"
745 #define ALL_INIT_TEXT_SECTIONS \
746 ".init.text$", ".devinit.text$", ".cpuinit.text$", ".meminit.text$"
747 #define ALL_EXIT_TEXT_SECTIONS \
748 ".exit.text$", ".devexit.text$", ".cpuexit.text$", ".memexit.text$"
750 #define ALL_INIT_SECTIONS ALL_INIT_DATA_SECTIONS, ALL_INIT_TEXT_SECTIONS
751 #define ALL_EXIT_SECTIONS ALL_EXIT_DATA_SECTIONS, ALL_EXIT_TEXT_SECTIONS
753 #define DATA_SECTIONS ".data$", ".data.rel$"
754 #define TEXT_SECTIONS ".text$"
756 #define INIT_SECTIONS ".init.data$", ".init.text$"
757 #define DEV_INIT_SECTIONS ".devinit.data$", ".devinit.text$"
758 #define CPU_INIT_SECTIONS ".cpuinit.data$", ".cpuinit.text$"
759 #define MEM_INIT_SECTIONS ".meminit.data$", ".meminit.text$"
761 #define EXIT_SECTIONS ".exit.data$", ".exit.text$"
762 #define DEV_EXIT_SECTIONS ".devexit.data$", ".devexit.text$"
763 #define CPU_EXIT_SECTIONS ".cpuexit.data$", ".cpuexit.text$"
764 #define MEM_EXIT_SECTIONS ".memexit.data$", ".memexit.text$"
766 /* init data sections */
767 static const char *init_data_sections
[] = { ALL_INIT_DATA_SECTIONS
, NULL
};
769 /* all init sections */
770 static const char *init_sections
[] = { ALL_INIT_SECTIONS
, NULL
};
772 /* All init and exit sections (code + data) */
773 static const char *init_exit_sections
[] =
774 {ALL_INIT_SECTIONS
, ALL_EXIT_SECTIONS
, NULL
};
777 static const char *data_sections
[] = { DATA_SECTIONS
, NULL
};
779 /* sections that may refer to an init/exit section with no warning */
780 static const char *initref_sections
[] =
789 /* symbols in .data that may refer to init/exit sections */
790 static const char *symbol_white_list
[] =
793 "*_template", /* scsi uses *_template a lot */
794 "*_timer", /* arm uses ops structures named _timer a lot */
795 "*_sht", /* scsi also used *_sht to some extent */
803 static const char *head_sections
[] = { ".head.text*", NULL
};
804 static const char *linker_symbols
[] =
805 { "__init_begin", "_sinittext", "_einittext", NULL
};
820 struct sectioncheck
{
821 const char *fromsec
[20];
822 const char *tosec
[20];
823 enum mismatch mismatch
;
826 const struct sectioncheck sectioncheck
[] = {
827 /* Do not reference init/exit code/data from
828 * normal code and data
831 .fromsec
= { TEXT_SECTIONS
, NULL
},
832 .tosec
= { ALL_INIT_SECTIONS
, NULL
},
833 .mismatch
= TEXT_TO_INIT
,
836 .fromsec
= { DATA_SECTIONS
, NULL
},
837 .tosec
= { ALL_INIT_SECTIONS
, NULL
},
838 .mismatch
= DATA_TO_INIT
,
841 .fromsec
= { TEXT_SECTIONS
, NULL
},
842 .tosec
= { ALL_EXIT_SECTIONS
, NULL
},
843 .mismatch
= TEXT_TO_EXIT
,
846 .fromsec
= { DATA_SECTIONS
, NULL
},
847 .tosec
= { ALL_EXIT_SECTIONS
, NULL
},
848 .mismatch
= DATA_TO_EXIT
,
850 /* Do not reference init code/data from devinit/cpuinit/meminit code/data */
852 .fromsec
= { DEV_INIT_SECTIONS
, CPU_INIT_SECTIONS
, MEM_INIT_SECTIONS
, NULL
},
853 .tosec
= { INIT_SECTIONS
, NULL
},
854 .mismatch
= XXXINIT_TO_INIT
,
856 /* Do not reference exit code/data from devexit/cpuexit/memexit code/data */
858 .fromsec
= { DEV_EXIT_SECTIONS
, CPU_EXIT_SECTIONS
, MEM_EXIT_SECTIONS
, NULL
},
859 .tosec
= { EXIT_SECTIONS
, NULL
},
860 .mismatch
= XXXEXIT_TO_EXIT
,
862 /* Do not use exit code/data from init code */
864 .fromsec
= { ALL_INIT_SECTIONS
, NULL
},
865 .tosec
= { ALL_EXIT_SECTIONS
, NULL
},
866 .mismatch
= INIT_TO_EXIT
,
868 /* Do not use init code/data from exit code */
870 .fromsec
= { ALL_EXIT_SECTIONS
, NULL
},
871 .tosec
= { ALL_INIT_SECTIONS
, NULL
},
872 .mismatch
= EXIT_TO_INIT
,
874 /* Do not export init/exit functions or data */
876 .fromsec
= { "__ksymtab*", NULL
},
877 .tosec
= { INIT_SECTIONS
, EXIT_SECTIONS
, NULL
},
878 .mismatch
= EXPORT_TO_INIT_EXIT
882 static int section_mismatch(const char *fromsec
, const char *tosec
)
885 int elems
= sizeof(sectioncheck
) / sizeof(struct sectioncheck
);
886 const struct sectioncheck
*check
= §ioncheck
[0];
888 for (i
= 0; i
< elems
; i
++) {
889 if (match(fromsec
, check
->fromsec
) &&
890 match(tosec
, check
->tosec
))
891 return check
->mismatch
;
898 * Whitelist to allow certain references to pass with no warning.
901 * Do not warn if funtion/data are marked with __init_refok/__initdata_refok.
902 * The pattern is identified by:
903 * fromsec = .text.init.refok* | .data.init.refok*
906 * If a module parameter is declared __initdata and permissions=0
907 * then this is legal despite the warning generated.
908 * We cannot see value of permissions here, so just ignore
910 * The pattern is identified by:
916 * Many drivers utilise a *driver container with references to
917 * add, remove, probe functions etc.
918 * These functions may often be marked __init and we do not want to
920 * the pattern is identified by:
921 * tosec = init or exit section
922 * fromsec = data section
923 * atsym = *driver, *_template, *_sht, *_ops, *_probe,
924 * *probe_one, *_console, *_timer
927 * Whitelist all refereces from .text.head to .init.data
928 * Whitelist all refereces from .text.head to .init.text
931 * Some symbols belong to init section but still it is ok to reference
932 * these from non-init sections as these symbols don't have any memory
933 * allocated for them and symbol address and value are same. So even
934 * if init section is freed, its ok to reference those symbols.
935 * For ex. symbols marking the init section boundaries.
936 * This pattern is identified by
937 * refsymname = __init_begin, _sinittext, _einittext
940 static int secref_whitelist(const char *fromsec
, const char *fromsym
,
941 const char *tosec
, const char *tosym
)
943 /* Check for pattern 0 */
944 if (match(fromsec
, initref_sections
))
947 /* Check for pattern 1 */
948 if (match(tosec
, init_data_sections
) &&
949 match(fromsec
, data_sections
) &&
950 (strncmp(fromsym
, "__param", strlen("__param")) == 0))
953 /* Check for pattern 2 */
954 if (match(tosec
, init_exit_sections
) &&
955 match(fromsec
, data_sections
) &&
956 match(fromsym
, symbol_white_list
))
959 /* Check for pattern 3 */
960 if (match(fromsec
, head_sections
) &&
961 match(tosec
, init_sections
))
964 /* Check for pattern 4 */
965 if (match(tosym
, linker_symbols
))
972 * Find symbol based on relocation record info.
973 * In some cases the symbol supplied is a valid symbol so
974 * return refsym. If st_name != 0 we assume this is a valid symbol.
975 * In other cases the symbol needs to be looked up in the symbol table
976 * based on section and address.
978 static Elf_Sym
*find_elf_symbol(struct elf_info
*elf
, Elf64_Sword addr
,
982 Elf_Sym
*near
= NULL
;
983 Elf64_Sword distance
= 20;
986 if (relsym
->st_name
!= 0)
988 for (sym
= elf
->symtab_start
; sym
< elf
->symtab_stop
; sym
++) {
989 if (sym
->st_shndx
!= relsym
->st_shndx
)
991 if (ELF_ST_TYPE(sym
->st_info
) == STT_SECTION
)
993 if (sym
->st_value
== addr
)
995 /* Find a symbol nearby - addr are maybe negative */
996 d
= sym
->st_value
- addr
;
998 d
= addr
- sym
->st_value
;
1004 /* We need a close match */
1011 static inline int is_arm_mapping_symbol(const char *str
)
1013 return str
[0] == '$' && strchr("atd", str
[1])
1014 && (str
[2] == '\0' || str
[2] == '.');
1018 * If there's no name there, ignore it; likewise, ignore it if it's
1019 * one of the magic symbols emitted used by current ARM tools.
1021 * Otherwise if find_symbols_between() returns those symbols, they'll
1022 * fail the whitelist tests and cause lots of false alarms ... fixable
1023 * only by merging __exit and __init sections into __text, bloating
1024 * the kernel (which is especially evil on embedded platforms).
1026 static inline int is_valid_name(struct elf_info
*elf
, Elf_Sym
*sym
)
1028 const char *name
= elf
->strtab
+ sym
->st_name
;
1030 if (!name
|| !strlen(name
))
1032 return !is_arm_mapping_symbol(name
);
1036 * Find symbols before or equal addr and after addr - in the section sec.
1037 * If we find two symbols with equal offset prefer one with a valid name.
1038 * The ELF format may have a better way to detect what type of symbol
1039 * it is, but this works for now.
1041 static Elf_Sym
*find_elf_symbol2(struct elf_info
*elf
, Elf_Addr addr
,
1045 Elf_Sym
*near
= NULL
;
1046 Elf_Addr distance
= ~0;
1048 for (sym
= elf
->symtab_start
; sym
< elf
->symtab_stop
; sym
++) {
1051 if (sym
->st_shndx
>= SHN_LORESERVE
)
1053 symsec
= sec_name(elf
, sym
->st_shndx
);
1054 if (strcmp(symsec
, sec
) != 0)
1056 if (!is_valid_name(elf
, sym
))
1058 if (sym
->st_value
<= addr
) {
1059 if ((addr
- sym
->st_value
) < distance
) {
1060 distance
= addr
- sym
->st_value
;
1062 } else if ((addr
- sym
->st_value
) == distance
) {
1071 * Convert a section name to the function/data attribute
1072 * .init.text => __init
1073 * .cpuinit.data => __cpudata
1074 * .memexitconst => __memconst
1077 static char *sec2annotation(const char *s
)
1079 if (match(s
, init_exit_sections
)) {
1080 char *p
= malloc(20);
1087 while (*s
&& *s
!= '.')
1092 if (strstr(s
, "rodata") != NULL
)
1093 strcat(p
, "const ");
1094 else if (strstr(s
, "data") != NULL
)
1098 return r
; /* we leak her but we do not care */
1104 static int is_function(Elf_Sym
*sym
)
1107 return ELF_ST_TYPE(sym
->st_info
) == STT_FUNC
;
1113 * Print a warning about a section mismatch.
1114 * Try to find symbols near it so user can find it.
1115 * Check whitelist before warning - it may be a false positive.
1117 static void report_sec_mismatch(const char *modname
, enum mismatch mismatch
,
1118 const char *fromsec
,
1119 unsigned long long fromaddr
,
1120 const char *fromsym
,
1122 const char *tosec
, const char *tosym
,
1125 const char *from
, *from_p
;
1126 const char *to
, *to_p
;
1128 switch (from_is_func
) {
1129 case 0: from
= "variable"; from_p
= ""; break;
1130 case 1: from
= "function"; from_p
= "()"; break;
1131 default: from
= "(unknown reference)"; from_p
= ""; break;
1133 switch (to_is_func
) {
1134 case 0: to
= "variable"; to_p
= ""; break;
1135 case 1: to
= "function"; to_p
= "()"; break;
1136 default: to
= "(unknown reference)"; to_p
= ""; break;
1139 sec_mismatch_count
++;
1140 if (!sec_mismatch_verbose
)
1143 warn("%s(%s+0x%llx): Section mismatch in reference from the %s %s%s "
1144 "to the %s %s:%s%s\n",
1145 modname
, fromsec
, fromaddr
, from
, fromsym
, from_p
, to
, tosec
,
1151 "The function %s%s() references\n"
1153 "This is often because %s lacks a %s\n"
1154 "annotation or the annotation of %s is wrong.\n",
1155 sec2annotation(fromsec
), fromsym
,
1156 to
, sec2annotation(tosec
), tosym
, to_p
,
1157 fromsym
, sec2annotation(tosec
), tosym
);
1159 case DATA_TO_INIT
: {
1160 const char **s
= symbol_white_list
;
1162 "The variable %s references\n"
1164 "If the reference is valid then annotate the\n"
1165 "variable with __init* (see linux/init.h) "
1166 "or name the variable:\n",
1167 fromsym
, to
, sec2annotation(tosec
), tosym
, to_p
);
1169 fprintf(stderr
, "%s, ", *s
++);
1170 fprintf(stderr
, "\n");
1175 "The function %s() references a %s in an exit section.\n"
1176 "Often the %s %s%s has valid usage outside the exit section\n"
1177 "and the fix is to remove the %sannotation of %s.\n",
1178 fromsym
, to
, to
, tosym
, to_p
, sec2annotation(tosec
), tosym
);
1180 case DATA_TO_EXIT
: {
1181 const char **s
= symbol_white_list
;
1183 "The variable %s references\n"
1185 "If the reference is valid then annotate the\n"
1186 "variable with __exit* (see linux/init.h) or "
1187 "name the variable:\n",
1188 fromsym
, to
, sec2annotation(tosec
), tosym
, to_p
);
1190 fprintf(stderr
, "%s, ", *s
++);
1191 fprintf(stderr
, "\n");
1194 case XXXINIT_TO_INIT
:
1195 case XXXEXIT_TO_EXIT
:
1197 "The %s %s%s%s references\n"
1199 "If %s is only used by %s then\n"
1200 "annotate %s with a matching annotation.\n",
1201 from
, sec2annotation(fromsec
), fromsym
, from_p
,
1202 to
, sec2annotation(tosec
), tosym
, to_p
,
1203 tosym
, fromsym
, tosym
);
1207 "The %s %s%s%s references\n"
1209 "This is often seen when error handling "
1210 "in the init function\n"
1211 "uses functionality in the exit path.\n"
1212 "The fix is often to remove the %sannotation of\n"
1213 "%s%s so it may be used outside an exit section.\n",
1214 from
, sec2annotation(fromsec
), fromsym
, from_p
,
1215 to
, sec2annotation(tosec
), tosym
, to_p
,
1216 sec2annotation(tosec
), tosym
, to_p
);
1220 "The %s %s%s%s references\n"
1222 "This is often seen when error handling "
1223 "in the exit function\n"
1224 "uses functionality in the init path.\n"
1225 "The fix is often to remove the %sannotation of\n"
1226 "%s%s so it may be used outside an init section.\n",
1227 from
, sec2annotation(fromsec
), fromsym
, from_p
,
1228 to
, sec2annotation(tosec
), tosym
, to_p
,
1229 sec2annotation(tosec
), tosym
, to_p
);
1231 case EXPORT_TO_INIT_EXIT
:
1233 "The symbol %s is exported and annotated %s\n"
1234 "Fix this by removing the %sannotation of %s "
1235 "or drop the export.\n",
1236 tosym
, sec2annotation(tosec
), sec2annotation(tosec
), tosym
);
1238 /* To get warnings on missing members */
1241 fprintf(stderr
, "\n");
1244 static void check_section_mismatch(const char *modname
, struct elf_info
*elf
,
1245 Elf_Rela
*r
, Elf_Sym
*sym
, const char *fromsec
)
1248 enum mismatch mismatch
;
1250 tosec
= sec_name(elf
, sym
->st_shndx
);
1251 mismatch
= section_mismatch(fromsec
, tosec
);
1252 if (mismatch
!= NO_MISMATCH
) {
1256 const char *fromsym
;
1258 from
= find_elf_symbol2(elf
, r
->r_offset
, fromsec
);
1259 fromsym
= sym_name(elf
, from
);
1260 to
= find_elf_symbol(elf
, r
->r_addend
, sym
);
1261 tosym
= sym_name(elf
, to
);
1263 /* check whitelist - we may ignore it */
1264 if (secref_whitelist(fromsec
, fromsym
, tosec
, tosym
)) {
1265 report_sec_mismatch(modname
, mismatch
,
1266 fromsec
, r
->r_offset
, fromsym
,
1267 is_function(from
), tosec
, tosym
,
1273 static unsigned int *reloc_location(struct elf_info
*elf
,
1274 Elf_Shdr
*sechdr
, Elf_Rela
*r
)
1276 Elf_Shdr
*sechdrs
= elf
->sechdrs
;
1277 int section
= sechdr
->sh_info
;
1279 return (void *)elf
->hdr
+ sechdrs
[section
].sh_offset
+
1280 (r
->r_offset
- sechdrs
[section
].sh_addr
);
1283 static int addend_386_rel(struct elf_info
*elf
, Elf_Shdr
*sechdr
, Elf_Rela
*r
)
1285 unsigned int r_typ
= ELF_R_TYPE(r
->r_info
);
1286 unsigned int *location
= reloc_location(elf
, sechdr
, r
);
1290 r
->r_addend
= TO_NATIVE(*location
);
1293 r
->r_addend
= TO_NATIVE(*location
) + 4;
1294 /* For CONFIG_RELOCATABLE=y */
1295 if (elf
->hdr
->e_type
== ET_EXEC
)
1296 r
->r_addend
+= r
->r_offset
;
1302 static int addend_arm_rel(struct elf_info
*elf
, Elf_Shdr
*sechdr
, Elf_Rela
*r
)
1304 unsigned int r_typ
= ELF_R_TYPE(r
->r_info
);
1308 /* From ARM ABI: (S + A) | T */
1309 r
->r_addend
= (int)(long)
1310 (elf
->symtab_start
+ ELF_R_SYM(r
->r_info
));
1313 /* From ARM ABI: ((S + A) | T) - P */
1314 r
->r_addend
= (int)(long)(elf
->hdr
+
1316 (r
->r_offset
- sechdr
->sh_addr
));
1324 static int addend_mips_rel(struct elf_info
*elf
, Elf_Shdr
*sechdr
, Elf_Rela
*r
)
1326 unsigned int r_typ
= ELF_R_TYPE(r
->r_info
);
1327 unsigned int *location
= reloc_location(elf
, sechdr
, r
);
1330 if (r_typ
== R_MIPS_HI16
)
1331 return 1; /* skip this */
1332 inst
= TO_NATIVE(*location
);
1335 r
->r_addend
= inst
& 0xffff;
1338 r
->r_addend
= (inst
& 0x03ffffff) << 2;
1347 static void section_rela(const char *modname
, struct elf_info
*elf
,
1354 const char *fromsec
;
1356 Elf_Rela
*start
= (void *)elf
->hdr
+ sechdr
->sh_offset
;
1357 Elf_Rela
*stop
= (void *)start
+ sechdr
->sh_size
;
1359 fromsec
= sech_name(elf
, sechdr
);
1360 fromsec
+= strlen(".rela");
1361 /* if from section (name) is know good then skip it */
1362 if (check_section(modname
, fromsec
))
1365 for (rela
= start
; rela
< stop
; rela
++) {
1366 r
.r_offset
= TO_NATIVE(rela
->r_offset
);
1367 #if KERNEL_ELFCLASS == ELFCLASS64
1368 if (elf
->hdr
->e_machine
== EM_MIPS
) {
1370 r_sym
= ELF64_MIPS_R_SYM(rela
->r_info
);
1371 r_sym
= TO_NATIVE(r_sym
);
1372 r_typ
= ELF64_MIPS_R_TYPE(rela
->r_info
);
1373 r
.r_info
= ELF64_R_INFO(r_sym
, r_typ
);
1375 r
.r_info
= TO_NATIVE(rela
->r_info
);
1376 r_sym
= ELF_R_SYM(r
.r_info
);
1379 r
.r_info
= TO_NATIVE(rela
->r_info
);
1380 r_sym
= ELF_R_SYM(r
.r_info
);
1382 r
.r_addend
= TO_NATIVE(rela
->r_addend
);
1383 sym
= elf
->symtab_start
+ r_sym
;
1384 /* Skip special sections */
1385 if (sym
->st_shndx
>= SHN_LORESERVE
)
1387 check_section_mismatch(modname
, elf
, &r
, sym
, fromsec
);
1391 static void section_rel(const char *modname
, struct elf_info
*elf
,
1398 const char *fromsec
;
1400 Elf_Rel
*start
= (void *)elf
->hdr
+ sechdr
->sh_offset
;
1401 Elf_Rel
*stop
= (void *)start
+ sechdr
->sh_size
;
1403 fromsec
= sech_name(elf
, sechdr
);
1404 fromsec
+= strlen(".rel");
1405 /* if from section (name) is know good then skip it */
1406 if (check_section(modname
, fromsec
))
1409 for (rel
= start
; rel
< stop
; rel
++) {
1410 r
.r_offset
= TO_NATIVE(rel
->r_offset
);
1411 #if KERNEL_ELFCLASS == ELFCLASS64
1412 if (elf
->hdr
->e_machine
== EM_MIPS
) {
1414 r_sym
= ELF64_MIPS_R_SYM(rel
->r_info
);
1415 r_sym
= TO_NATIVE(r_sym
);
1416 r_typ
= ELF64_MIPS_R_TYPE(rel
->r_info
);
1417 r
.r_info
= ELF64_R_INFO(r_sym
, r_typ
);
1419 r
.r_info
= TO_NATIVE(rel
->r_info
);
1420 r_sym
= ELF_R_SYM(r
.r_info
);
1423 r
.r_info
= TO_NATIVE(rel
->r_info
);
1424 r_sym
= ELF_R_SYM(r
.r_info
);
1427 switch (elf
->hdr
->e_machine
) {
1429 if (addend_386_rel(elf
, sechdr
, &r
))
1433 if (addend_arm_rel(elf
, sechdr
, &r
))
1437 if (addend_mips_rel(elf
, sechdr
, &r
))
1441 sym
= elf
->symtab_start
+ r_sym
;
1442 /* Skip special sections */
1443 if (sym
->st_shndx
>= SHN_LORESERVE
)
1445 check_section_mismatch(modname
, elf
, &r
, sym
, fromsec
);
1450 * A module includes a number of sections that are discarded
1451 * either when loaded or when used as built-in.
1452 * For loaded modules all functions marked __init and all data
1453 * marked __initdata will be discarded when the module has been intialized.
1454 * Likewise for modules used built-in the sections marked __exit
1455 * are discarded because __exit marked function are supposed to be called
1456 * only when a moduel is unloaded which never happes for built-in modules.
1457 * The check_sec_ref() function traverses all relocation records
1458 * to find all references to a section that reference a section that will
1459 * be discarded and warns about it.
1461 static void check_sec_ref(struct module
*mod
, const char *modname
,
1462 struct elf_info
*elf
)
1465 Elf_Shdr
*sechdrs
= elf
->sechdrs
;
1467 /* Walk through all sections */
1468 for (i
= 0; i
< elf
->hdr
->e_shnum
; i
++) {
1469 /* We want to process only relocation sections and not .init */
1470 if (sechdrs
[i
].sh_type
== SHT_RELA
)
1471 section_rela(modname
, elf
, &elf
->sechdrs
[i
]);
1472 else if (sechdrs
[i
].sh_type
== SHT_REL
)
1473 section_rel(modname
, elf
, &elf
->sechdrs
[i
]);
1477 static void get_markers(struct elf_info
*info
, struct module
*mod
)
1479 const Elf_Shdr
*sh
= &info
->sechdrs
[info
->markers_strings_sec
];
1480 const char *strings
= (const char *) info
->hdr
+ sh
->sh_offset
;
1481 const Elf_Sym
*sym
, *first_sym
, *last_sym
;
1484 if (!info
->markers_strings_sec
)
1488 * First count the strings. We look for all the symbols defined
1489 * in the __markers_strings section named __mstrtab_*. For
1490 * these local names, the compiler puts a random .NNN suffix on,
1491 * so the names don't correspond exactly.
1493 first_sym
= last_sym
= NULL
;
1495 for (sym
= info
->symtab_start
; sym
< info
->symtab_stop
; sym
++)
1496 if (ELF_ST_TYPE(sym
->st_info
) == STT_OBJECT
&&
1497 sym
->st_shndx
== info
->markers_strings_sec
&&
1498 !strncmp(info
->strtab
+ sym
->st_name
,
1499 "__mstrtab_", sizeof "__mstrtab_" - 1)) {
1500 if (first_sym
== NULL
)
1510 * Now collect each name and format into a line for the output.
1512 * marker_name vmlinux marker %s format %d
1513 * The format string after the second \t can use whitespace.
1515 mod
->markers
= NOFAIL(malloc(sizeof mod
->markers
[0] * n
));
1519 for (sym
= first_sym
; sym
<= last_sym
; sym
++)
1520 if (ELF_ST_TYPE(sym
->st_info
) == STT_OBJECT
&&
1521 sym
->st_shndx
== info
->markers_strings_sec
&&
1522 !strncmp(info
->strtab
+ sym
->st_name
,
1523 "__mstrtab_", sizeof "__mstrtab_" - 1)) {
1524 const char *name
= strings
+ sym
->st_value
;
1525 const char *fmt
= strchr(name
, '\0') + 1;
1527 asprintf(&line
, "%s\t%s\t%s\n", name
, mod
->name
, fmt
);
1529 mod
->markers
[n
++] = line
;
1533 static void read_symbols(char *modname
)
1535 const char *symname
;
1539 struct elf_info info
= { };
1542 if (!parse_elf(&info
, modname
))
1545 mod
= new_module(modname
);
1547 /* When there's no vmlinux, don't print warnings about
1548 * unresolved symbols (since there'll be too many ;) */
1549 if (is_vmlinux(modname
)) {
1554 license
= get_modinfo(info
.modinfo
, info
.modinfo_len
, "license");
1556 if (license_is_gpl_compatible(license
))
1557 mod
->gpl_compatible
= 1;
1559 mod
->gpl_compatible
= 0;
1562 license
= get_next_modinfo(info
.modinfo
, info
.modinfo_len
,
1563 "license", license
);
1566 for (sym
= info
.symtab_start
; sym
< info
.symtab_stop
; sym
++) {
1567 symname
= info
.strtab
+ sym
->st_name
;
1569 handle_modversions(mod
, &info
, sym
, symname
);
1570 handle_moddevtable(mod
, &info
, sym
, symname
);
1572 if (!is_vmlinux(modname
) ||
1573 (is_vmlinux(modname
) && vmlinux_section_warnings
))
1574 check_sec_ref(mod
, modname
, &info
);
1576 version
= get_modinfo(info
.modinfo
, info
.modinfo_len
, "version");
1578 maybe_frob_rcs_version(modname
, version
, info
.modinfo
,
1579 version
- (char *)info
.hdr
);
1580 if (version
|| (all_versions
&& !is_vmlinux(modname
)))
1581 get_src_version(modname
, mod
->srcversion
,
1582 sizeof(mod
->srcversion
)-1);
1584 get_markers(&info
, mod
);
1586 parse_elf_finish(&info
);
1588 /* Our trick to get versioning for struct_module - it's
1589 * never passed as an argument to an exported function, so
1590 * the automatic versioning doesn't pick it up, but it's really
1591 * important anyhow */
1593 mod
->unres
= alloc_symbol("struct_module", 0, mod
->unres
);
1598 /* We first write the generated file into memory using the
1599 * following helper, then compare to the file on disk and
1600 * only update the later if anything changed */
1602 void __attribute__((format(printf
, 2, 3))) buf_printf(struct buffer
*buf
,
1603 const char *fmt
, ...)
1610 len
= vsnprintf(tmp
, SZ
, fmt
, ap
);
1611 buf_write(buf
, tmp
, len
);
1615 void buf_write(struct buffer
*buf
, const char *s
, int len
)
1617 if (buf
->size
- buf
->pos
< len
) {
1618 buf
->size
+= len
+ SZ
;
1619 buf
->p
= realloc(buf
->p
, buf
->size
);
1621 strncpy(buf
->p
+ buf
->pos
, s
, len
);
1625 static void check_for_gpl_usage(enum export exp
, const char *m
, const char *s
)
1627 const char *e
= is_vmlinux(m
) ?"":".ko";
1631 fatal("modpost: GPL-incompatible module %s%s "
1632 "uses GPL-only symbol '%s'\n", m
, e
, s
);
1634 case export_unused_gpl
:
1635 fatal("modpost: GPL-incompatible module %s%s "
1636 "uses GPL-only symbol marked UNUSED '%s'\n", m
, e
, s
);
1638 case export_gpl_future
:
1639 warn("modpost: GPL-incompatible module %s%s "
1640 "uses future GPL-only symbol '%s'\n", m
, e
, s
);
1644 case export_unknown
:
1650 static void check_for_unused(enum export exp
, const char *m
, const char *s
)
1652 const char *e
= is_vmlinux(m
) ?"":".ko";
1656 case export_unused_gpl
:
1657 warn("modpost: module %s%s "
1658 "uses symbol '%s' marked UNUSED\n", m
, e
, s
);
1666 static void check_exports(struct module
*mod
)
1668 struct symbol
*s
, *exp
;
1670 for (s
= mod
->unres
; s
; s
= s
->next
) {
1671 const char *basename
;
1672 exp
= find_symbol(s
->name
);
1673 if (!exp
|| exp
->module
== mod
)
1675 basename
= strrchr(mod
->name
, '/');
1679 basename
= mod
->name
;
1680 if (!mod
->gpl_compatible
)
1681 check_for_gpl_usage(exp
->export
, basename
, exp
->name
);
1682 check_for_unused(exp
->export
, basename
, exp
->name
);
1687 * Header for the generated file
1689 static void add_header(struct buffer
*b
, struct module
*mod
)
1691 buf_printf(b
, "#include <linux/module.h>\n");
1692 buf_printf(b
, "#include <linux/vermagic.h>\n");
1693 buf_printf(b
, "#include <linux/compiler.h>\n");
1694 buf_printf(b
, "\n");
1695 buf_printf(b
, "MODULE_INFO(vermagic, VERMAGIC_STRING);\n");
1696 buf_printf(b
, "\n");
1697 buf_printf(b
, "struct module __this_module\n");
1698 buf_printf(b
, "__attribute__((section(\".gnu.linkonce.this_module\"))) = {\n");
1699 buf_printf(b
, " .name = KBUILD_MODNAME,\n");
1701 buf_printf(b
, " .init = init_module,\n");
1702 if (mod
->has_cleanup
)
1703 buf_printf(b
, "#ifdef CONFIG_MODULE_UNLOAD\n"
1704 " .exit = cleanup_module,\n"
1706 buf_printf(b
, " .arch = MODULE_ARCH_INIT,\n");
1707 buf_printf(b
, "};\n");
1711 * Record CRCs for unresolved symbols
1713 static int add_versions(struct buffer
*b
, struct module
*mod
)
1715 struct symbol
*s
, *exp
;
1718 for (s
= mod
->unres
; s
; s
= s
->next
) {
1719 exp
= find_symbol(s
->name
);
1720 if (!exp
|| exp
->module
== mod
) {
1721 if (have_vmlinux
&& !s
->weak
) {
1722 if (warn_unresolved
) {
1723 warn("\"%s\" [%s.ko] undefined!\n",
1724 s
->name
, mod
->name
);
1726 merror("\"%s\" [%s.ko] undefined!\n",
1727 s
->name
, mod
->name
);
1733 s
->module
= exp
->module
;
1734 s
->crc_valid
= exp
->crc_valid
;
1741 buf_printf(b
, "\n");
1742 buf_printf(b
, "static const struct modversion_info ____versions[]\n");
1743 buf_printf(b
, "__used\n");
1744 buf_printf(b
, "__attribute__((section(\"__versions\"))) = {\n");
1746 for (s
= mod
->unres
; s
; s
= s
->next
) {
1749 if (!s
->crc_valid
) {
1750 warn("\"%s\" [%s.ko] has no CRC!\n",
1751 s
->name
, mod
->name
);
1754 buf_printf(b
, "\t{ %#8x, \"%s\" },\n", s
->crc
, s
->name
);
1757 buf_printf(b
, "};\n");
1762 static void add_depends(struct buffer
*b
, struct module
*mod
,
1763 struct module
*modules
)
1769 for (m
= modules
; m
; m
= m
->next
)
1770 m
->seen
= is_vmlinux(m
->name
);
1772 buf_printf(b
, "\n");
1773 buf_printf(b
, "static const char __module_depends[]\n");
1774 buf_printf(b
, "__used\n");
1775 buf_printf(b
, "__attribute__((section(\".modinfo\"))) =\n");
1776 buf_printf(b
, "\"depends=");
1777 for (s
= mod
->unres
; s
; s
= s
->next
) {
1782 if (s
->module
->seen
)
1785 s
->module
->seen
= 1;
1786 p
= strrchr(s
->module
->name
, '/');
1790 p
= s
->module
->name
;
1791 buf_printf(b
, "%s%s", first
? "" : ",", p
);
1794 buf_printf(b
, "\";\n");
1797 static void add_srcversion(struct buffer
*b
, struct module
*mod
)
1799 if (mod
->srcversion
[0]) {
1800 buf_printf(b
, "\n");
1801 buf_printf(b
, "MODULE_INFO(srcversion, \"%s\");\n",
1806 static void write_if_changed(struct buffer
*b
, const char *fname
)
1812 file
= fopen(fname
, "r");
1816 if (fstat(fileno(file
), &st
) < 0)
1819 if (st
.st_size
!= b
->pos
)
1822 tmp
= NOFAIL(malloc(b
->pos
));
1823 if (fread(tmp
, 1, b
->pos
, file
) != b
->pos
)
1826 if (memcmp(tmp
, b
->p
, b
->pos
) != 0)
1838 file
= fopen(fname
, "w");
1843 if (fwrite(b
->p
, 1, b
->pos
, file
) != b
->pos
) {
1850 /* parse Module.symvers file. line format:
1851 * 0x12345678<tab>symbol<tab>module[[<tab>export]<tab>something]
1853 static void read_dump(const char *fname
, unsigned int kernel
)
1855 unsigned long size
, pos
= 0;
1856 void *file
= grab_file(fname
, &size
);
1860 /* No symbol versions, silently ignore */
1863 while ((line
= get_next_line(&pos
, file
, size
))) {
1864 char *symname
, *modname
, *d
, *export
, *end
;
1869 if (!(symname
= strchr(line
, '\t')))
1872 if (!(modname
= strchr(symname
, '\t')))
1875 if ((export
= strchr(modname
, '\t')) != NULL
)
1877 if (export
&& ((end
= strchr(export
, '\t')) != NULL
))
1879 crc
= strtoul(line
, &d
, 16);
1880 if (*symname
== '\0' || *modname
== '\0' || *d
!= '\0')
1882 mod
= find_module(modname
);
1884 if (is_vmlinux(modname
))
1886 mod
= new_module(NOFAIL(strdup(modname
)));
1889 s
= sym_add_exported(symname
, mod
, export_no(export
));
1892 sym_update_crc(symname
, mod
, crc
, export_no(export
));
1896 fatal("parse error in symbol dump file\n");
1899 /* For normal builds always dump all symbols.
1900 * For external modules only dump symbols
1901 * that are not read from kernel Module.symvers.
1903 static int dump_sym(struct symbol
*sym
)
1905 if (!external_module
)
1907 if (sym
->vmlinux
|| sym
->kernel
)
1912 static void write_dump(const char *fname
)
1914 struct buffer buf
= { };
1915 struct symbol
*symbol
;
1918 for (n
= 0; n
< SYMBOL_HASH_SIZE
; n
++) {
1919 symbol
= symbolhash
[n
];
1921 if (dump_sym(symbol
))
1922 buf_printf(&buf
, "0x%08x\t%s\t%s\t%s\n",
1923 symbol
->crc
, symbol
->name
,
1924 symbol
->module
->name
,
1925 export_str(symbol
->export
));
1926 symbol
= symbol
->next
;
1929 write_if_changed(&buf
, fname
);
1932 static void add_marker(struct module
*mod
, const char *name
, const char *fmt
)
1935 asprintf(&line
, "%s\t%s\t%s\n", name
, mod
->name
, fmt
);
1938 mod
->markers
= NOFAIL(realloc(mod
->markers
, ((mod
->nmarkers
+ 1) *
1939 sizeof mod
->markers
[0])));
1940 mod
->markers
[mod
->nmarkers
++] = line
;
1943 static void read_markers(const char *fname
)
1945 unsigned long size
, pos
= 0;
1946 void *file
= grab_file(fname
, &size
);
1949 if (!file
) /* No old markers, silently ignore */
1952 while ((line
= get_next_line(&pos
, file
, size
))) {
1953 char *marker
, *modname
, *fmt
;
1957 modname
= strchr(marker
, '\t');
1961 fmt
= strchr(modname
, '\t');
1965 if (*marker
== '\0' || *modname
== '\0')
1968 mod
= find_module(modname
);
1970 if (is_vmlinux(modname
))
1972 mod
= new_module(NOFAIL(strdup(modname
)));
1976 add_marker(mod
, marker
, fmt
);
1980 fatal("parse error in markers list file\n");
1983 static int compare_strings(const void *a
, const void *b
)
1985 return strcmp(*(const char **) a
, *(const char **) b
);
1988 static void write_markers(const char *fname
)
1990 struct buffer buf
= { };
1994 for (mod
= modules
; mod
; mod
= mod
->next
)
1995 if ((!external_module
|| !mod
->skip
) && mod
->markers
!= NULL
) {
1997 * Sort the strings so we can skip duplicates when
1998 * we write them out.
2000 qsort(mod
->markers
, mod
->nmarkers
,
2001 sizeof mod
->markers
[0], &compare_strings
);
2002 for (i
= 0; i
< mod
->nmarkers
; ++i
) {
2003 char *line
= mod
->markers
[i
];
2004 buf_write(&buf
, line
, strlen(line
));
2005 while (i
+ 1 < mod
->nmarkers
&&
2006 !strcmp(mod
->markers
[i
],
2007 mod
->markers
[i
+ 1]))
2008 free(mod
->markers
[i
++]);
2009 free(mod
->markers
[i
]);
2012 mod
->markers
= NULL
;
2015 write_if_changed(&buf
, fname
);
2018 int main(int argc
, char **argv
)
2021 struct buffer buf
= { };
2022 char *kernel_read
= NULL
, *module_read
= NULL
;
2023 char *dump_write
= NULL
;
2024 char *markers_read
= NULL
;
2025 char *markers_write
= NULL
;
2029 while ((opt
= getopt(argc
, argv
, "i:I:msSo:awM:K:")) != -1) {
2032 kernel_read
= optarg
;
2035 module_read
= optarg
;
2036 external_module
= 1;
2042 dump_write
= optarg
;
2048 vmlinux_section_warnings
= 0;
2051 sec_mismatch_verbose
= 0;
2054 warn_unresolved
= 1;
2057 markers_write
= optarg
;
2060 markers_read
= optarg
;
2068 read_dump(kernel_read
, 1);
2070 read_dump(module_read
, 0);
2072 while (optind
< argc
)
2073 read_symbols(argv
[optind
++]);
2075 for (mod
= modules
; mod
; mod
= mod
->next
) {
2083 for (mod
= modules
; mod
; mod
= mod
->next
) {
2084 char fname
[strlen(mod
->name
) + 10];
2091 add_header(&buf
, mod
);
2092 err
|= add_versions(&buf
, mod
);
2093 add_depends(&buf
, mod
, modules
);
2094 add_moddevtable(&buf
, mod
);
2095 add_srcversion(&buf
, mod
);
2097 sprintf(fname
, "%s.mod.c", mod
->name
);
2098 write_if_changed(&buf
, fname
);
2102 write_dump(dump_write
);
2103 if (sec_mismatch_count
&& !sec_mismatch_verbose
)
2104 warn("modpost: Found %d section mismatch(es).\n"
2105 "To see full details build your kernel with:\n"
2106 "'make CONFIG_DEBUG_SECTION_MISMATCH=y'\n",
2107 sec_mismatch_count
);
2110 read_markers(markers_read
);
2113 write_markers(markers_write
);