Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
genksyms(8)
Edit
PageHistory
Diff
Info
LikePages
GENKSYMS !!!GENKSYMS NAME SYNOPSIS DESCRIPTION OPTIONS SEE ALSO BUGS HISTORY ---- !!NAME genksyms - generate symbol version information !!SYNOPSIS __genksyms__ [[-wq] [[-dD] [[-V] [[-k ''version''] [[-p string] [[''output directory''] !!DESCRIPTION __Genksyms__ reads (on standard input) the output from __gcc -E source.c__ __ Depending on the output format indicated by the __-k__ option, the output will either be written to a __.ver__ file in the named output directory, or to the standard output. __Genksyms__ normally looks for explicit symbol table definitions in the source file. All definitions and declarations of __typedef__, __struct__, __union__ and __enum__ will be saved for later expansion. Every global symbol will also be saved, together with pointers that will enable a full expansion later on. When a symbol table is found in the source, the symbol will be expanded to its full definition, where all structs, unions, enums and typedefs will be expanded down to their basic part, recursively. This final string will then be used as input to a CRC algorithm that will give an integer that will change as soon as any of the included definitions changes, for this symbol. The version information in the kernel normally looks like: __symbol_R12345678__, where 12345678 is the hexadecimal representation of the CRC. !!OPTIONS __-d__, __--debug__ Output debugging information; repeating this option increases the verbosity. Debug level 1 generates moderate information about the actions being taken; debug level 2 enables parser recognition output; debug level 3 enables lexical analysis output. __-D__, __--dump__ Dump expanded symbol definitions to stderr. For debugging use only. __-h__, __--help__ Display a summary of options and immediately exit. __-k__ ''version'', __--kernel__ ''version'' Select the version of the kernel for which to generate output. Omitting this option assumes a version below 2.1.0. Versions below 2.1.18 use checksum version 1, and produce their output in the directory given on the command line. Versions 2.1.18 and above use checksum version 2 and produce their output on stdout. __-p__ ''string'', __--prefix__ ''string'' Prepend the given string to the CRCs generated for all symbols. This is intended for use with, e.g., SMP kernels, wherein the modules are not compatible at a level below that described by the data types. This is primarily caused by inline function expansions in the module code itself. __-q__, __--quiet__ Quiet warnings, i.e. reverse the __-w__ option. __-V__, __--version__ Display the version of __genksyms__. __-w__, __--warnings__ Enable warnings due to unrecognized syntax and declared but undefined structures. These warnings are normally suppressed. !!SEE ALSO insmod(8), modprobe(8) !!BUGS The __-h__ option is broken; __--help__ is fine.__ genksyms__ [[__-V__ | __--version__] should display version information and then exit immediately. Instead, it prints the version information and behaves as if no options were given. !!HISTORY This versioning concept is a result from discussions, not at least on the KERNEL-channel, with a lot of people. The genksyms utility was created in 1994 by Bjorn Ekwall It was rewritten in 1996 by Richard Henderson to use a proper lexer and parser. ----
2 pages link to
genksyms(8)
:
Man8g
insmod(8)
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
