Lines Matching +full:linux +full:- +full:format
6 abidw reads a shared library in `ELF`_ format and emits an XML
8 representation format, named ``ABIXML``, includes all the globally
12 contain associated debug information in `DWARF`_ format.
14 When given the ``--linux-tree`` option, this program can also handle a
15 Linux kernel tree. That is, a directory tree that contains both the
16 vmlinux binary and Linux kernel modules. It analyses those Linux
22 binaries must contain associated debug information in `DWARF`_ format.
29 abidw [options] [<path-to-elf-file>]
34 * ``--help | -h``
38 * `--version | -v`
42 * `--abixml-version`
44 Display the version of the ABIXML format emitted by this program and exit.
46 * ``--debug-info-dir | -d`` <*dir-path*>
48 In cases where the debug info for *path-to-elf-file* is in a
49 separate file that is located in a non-standard place, this tells
52 Note that *dir-path* must point to the root directory under which
53 the debug information is arranged in a tree-like manner. Under
66 * ``--out-file`` <*file-path*>
69 *path-to-elf-file* into the file *file-path*, rather than emitting
72 * ``--noout``
79 * ``--no-corpus-path``
83 * ``--suppressions | suppr`` <*path-to-suppression-specifications-file*>
86 located at *path-to-suppression-specifications-file*. Note that
93 * ``--kmi-whitelist | -kaw`` <*path-to-whitelist*>
95 When analyzing a Linux kernel binary, this option points to the
106 If this option is not provided -- thus if no white list is
107 provided -- then the entire KMI, that is, all publicly defined and
108 exported functions and global variables by the Linux Kernel
111 * ``--linux-tree | --lt``
118 Below is an example of usage of ``abidw`` on a Linux Kernel tree.
120 First, checkout a Linux kernel source tree and build it. Then
125 $ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
126 $ cd linux && git checkout v4.5
128 $ mkdir build-output
129 $ make INSTALL_MOD_PATH=./build-output modules_install
130 $ cp vmlinux build-output/modules/4.5.0
131 $ abidw --linux-tree build-output/modules/4.5.0 > build-output/linux-4.5.0.kmi
133 * ``--headers-dir | --hd`` <headers-directory-path-1>
140 the binary to consider. In that case the ``--header-dir`` option
144 $ abidw --header-dir /some/path \
145 --header-dir /some/other/path \
148 * ``--header-file | --hf`` <header-file-path>
154 * ``--drop-private-types``
156 This option is to be used with the ``--headers-dir`` and/or
157 ``header-file`` options. With this option, types that are *NOT*
162 * ``--no-elf-needed``
167 * ``--drop-undefined-syms``
174 * ``--no-linux-kernel-mode``
177 looking at are Linux Kernel binaries (either vmlinux or modules)
181 With this option, abipkgdiff considers the binary as a non-special
185 * ``--check-alternate-debug-info`` <*elf-path*>
187 If the debug info for the file *elf-path* contains a reference to
188 an `alternate debug info <alt-di-label>`_ file, ``abidw`` checks
194 * ``--no-show-locs``
199 * ``--no-parameter-names``
204 * ``--no-write-default-sizes``
206 In the XML ABI representation, do not write the size-in-bits for
211 a size-in-bits attribute as zero sized.
213 * ``--type-id-style`` <``sequence``|``hash``>
217 ``type-id-`` as prefix) the types in the order they are
222 * ``--check-alternate-debug-info-base-name`` <*elf-path*>
225 Like ``--check-alternate-debug-info``, but in the success message,
228 * ``--load-all-types``
237 * ``--abidiff``
240 libabigail's XML format in a temporary file; read the ABI from the
244 diagnostic and exits with a non-zero code.
248 * ``--debug-abidiff``
250 Same as ``--abidiff`` but in debug mode. In this mode, error
255 the --enable-debug-self-comparison option.
257 * ``--debug-type-canonicalization | --debug-tc``
268 the --enable-debug-type-canonicalization option.
271 * ``--ctf``
276 * ``--annotate``
279 comments are made of the pretty-printed form types, declaration or
281 human-readable for debugging or documenting purposes.
283 * ``--stats``
287 * ``--verbose``
295 .. _alt-di-label:
298 --------------------------