RepoMirrors/libabigail
1
0
Fork 0
mirror of git://sourceware.org/git/libabigail.git synced 2024-12-17 15:34:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

Introduce the --kmi-whitelist option to abidiff

Browse Source 
abidiff had an --linux-kernel-abi-whitelist option.  Rename it
--kmi-whitelist.

	* doc/manuals/abidiff.rst: Add documentation for the
	--kmi-whitelist option.
	* tools/abidiff.cc (display_usage): Emit help string for the
	--kmi-whitelist option
	(parse_command_line): Parse the new --kmi-whitelist option, of the
	-w shortcut.

Signed-off-by: Dodji Seketeli <dodji@redhat.com>
This commit is contained in:
Dodji Seketeli 2017-06-12 15:19:01 +02:00
parent c15eecc9a0
commit eae7ca0426
2 changed files with 21 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/manuals/abidiff.rst
View File

@ -107,6 +107,24 @@ Options
ELF binary. It thus considers functions and variables which are
defined and exported in the ELF sense.
* ``--kmi-whitelist | -kaw`` <*path-to-whitelist*>
When analyzing a Linux kernel binary, this option points to the
white list of names of ELF symbols of functions and variables
which ABI must be considered. That white list is called a "Kernel
Module Interface white list". This is because for the Kernel, we
don't talk about ``ABI``; we rather talk about the interface
between the Kernel and its module. Hence the term ``KMI`` rather
than ``ABI``.
Any other function or variable which ELF symbol are not present in
that white list will not be considered by this tool.
If this option is not provided -- thus if no white list is
provided -- then the entire KMI, that is, the set of all publicly
defined and exported functions and global variables by the Linux
Kernel binaries, is considered.
* ``--drop-private-types``
This option is to be used with the ``--headers-dir1`` and

6
tools/abidiff.cc
View File

@ -155,7 +155,7 @@ display_usage(const string& prog_name, ostream& out)
"internal representation\n"
<< " --no-linux-kernel-mode don't consider the input binaries as "
"linux kernel binaries\n"
<< " --linux-kernel-abi-whitelist|--lkaw path to a "
<< " --kmi-whitelist|-w path to a "
"linux kernel abi whitelist\n"
<< " --stat only display the diff stats\n"
<< " --symtabs only display the symbol tables of the corpora\n"
@ -287,8 +287,8 @@ parse_command_line(int argc, char* argv[], options& opts)
opts.headers_dir2 = argv[j];
++i;
}
else if (!strcmp(argv[i], "--linux-kernel-abi-whitelist")
|| !strcmp(argv[i], "--lkaw"))
else if (!strcmp(argv[i], "--kmi-whitelist")
|| !strcmp(argv[i], "-w"))
{
int j = i + 1;
if (j >= argc)