Submitted By: Matt Burgess Date: 2011-10-10 Initial Package Version: 3.16 Upstream Status: Not submitted Origin: Matt Burgess Description: This patch contains generated man pages that were mistakenly omitted from the released tarball. diff -Naur module-init-tools-3.16.orig/build/depmod.8 module-init-tools-3.16/build/depmod.8 --- module-init-tools-3.16.orig/build/depmod.8 1970-01-01 00:00:00.000000000 +0000 +++ module-init-tools-3.16/build/depmod.8 2011-10-10 20:51:22.103492175 +0000 @@ -0,0 +1,132 @@ +.\\" auto-generated by docbook2man-spec $Revision: 1.2 $ +.TH "DEPMOD" "8" "2011-05-31" "" "" +.SH NAME +depmod \- program to generate modules.dep and map files. +.SH SYNOPSIS +.sp +\fBdepmod\fR [ \fB-b \fIbasedir\fB\fR ] [ \fB-e\fR ] [ \fB-E \fIModule.symvers\fB\fR ] [ \fB-F \fISystem.map\fB\fR ] [ \fB-m\fR ] [ \fB-n\fR ] [ \fB-v\fR ] [ \fB-A\fR ] [ \fB-P \fIprefix\fB\fR ] [ \fB-w\fR ] [ \fB\fIversion\fB\fR ] +.sp +\fBdepmod\fR [ \fB-e\fR ] [ \fB-E \fIModule.symvers\fB\fR ] [ \fB-F \fISystem.map\fB\fR ] [ \fB-m\fR ] [ \fB-n\fR ] [ \fB-v\fR ] [ \fB-P \fIprefix\fB\fR ] [ \fB-w [ [ \fIversion\fB ] + [ \fIfilename\fB\fI...\fB ] + ] \fR ] +.SH "DESCRIPTION" +.PP +Linux kernel modules can provide services (called "symbols") for +other modules to use (using one of the EXPORT_SYMBOL variants in the +code). If a second module uses this symbol, that second module clearly +depends on the first module. These dependencies can get quite complex. +.PP +\fBdepmod\fR creates a list of module dependencies +by reading each module under +\fI/lib/modules/\fR\fIversion\fR +and determining what symbols it exports and what symbols it +needs. By default, this list is written to +\fImodules.dep\fR, and a binary hashed version named +\fImodules.dep.bin\fR, in the same directory. If +filenames are given on the command line, only those modules are +examined (which is rarely useful unless all modules are listed). +\fBdepmod\fR also creates a list of symbols provided +by modules in the file named \fImodules.symbols\fR +and its binary hashed version, \fImodules.symbols.bin\fR\&. +Finally, \fBdepmod\fR will output a file named +\fImodules.devname\fR if modules supply special +device names (devname) that should be populated in /dev on boot +(by a utility such as udev). +.PP +If a \fIversion\fR is provided, then that +kernel version's module directory is used rather than the +current kernel version (as returned by \fBuname -r\fR). +.PP +\fBdepmod\fR will also generate various legacy map +files in the output directory for use by the older hotplug +infrastructure. These map files are largely deprecated. +.SH "OPTIONS" +.TP +\fB-a --all\fR +Probe all modules. This option is enabled by default if no +file names are given in the command-line. +.TP +\fB-A --quick\fR +This option scans to see if any modules are newer than the +\fImodules.dep\fR file before any work is done: +if not, it silently exits rather than regenerating the files. +.TP +\fB-b \fIbasedir\fB --basedir \fIbasedir\fB\fR +If your modules are not currently in the (normal) +directory +\fI/lib/modules/\fR\fIversion\fR, +but in a staging area, you can specify a +\fIbasedir\fR which is prepended to +the directory name. This +\fIbasedir\fR is stripped from the +resulting \fImodules.dep\fR file, so it +is ready to be moved into the normal location. Use this option +if you are a distribution vendor who needs to pre-generate the +meta-data files rather than running depmod again later. +.TP +\fB-C --config \fIfile or directory\fB\fR +This option overrides the default configuration file at +\fI/etc/depmod.conf\fR (or the +\fI/etc/depmod.d/\fR directory if that is not found). +.TP +\fB-e --errsyms\fR +When combined with the \fB-F\fR option, this +reports any symbols which a module needs which are not +supplied by other modules or the kernel. Normally, any +symbols not provided by modules are assumed to be +provided by the kernel (which should be true in a +perfect world), but this assumption can break espencially +when additionally updated third party drivers are not +correctly installed or were built incorrectly. +.TP +\fB-E --symvers\fR +When combined with the \fB-e\fR option, this +reports any symbol versions supplied by modules that do +not match with the symbol versions provided by the +kernel in its \fIModule.symvers\fR\&. +This option is mutually incompatible with \fB-F\fR\&. +.TP +\fB-F --filesyms \fISystem.map\fB\fR +Supplied with the \fISystem.map\fR produced +when the kernel was built, this allows the +\fB-e\fR option to report unresolved symbols. +This option is mutually incompatible with \fB-E\fR\&. +.TP +\fB-h --help\fR +Print the help message and exit. +.TP +\fB-m\fR +This overrides any possible configuration file setting of +\fBmake_map_files\fR and forces the generation +of legacy map files, such as \fImodules.pcimap\fR\&. +.TP +\fB-n --dry-run\fR +This sends the resulting modules.dep and the various +map files to standard output rather than writing them into +the module directory. +.TP +\fB-P\fR +Some architectures prefix symbols with an extraneous character. +This specifies a prefix character (for example '_') to ignore. +.TP +\fB-v --verbose\fR +In verbose mode, \fBdepmod\fR will print (to stdout) +all the symbols each module depends on and the module's file name +which provides that symbol. +.TP +\fB-V --version\fR +Show version of program and exit. See below for caveats when +run on older kernels. +.TP +\fB-w\fR +Warn on duplicate dependencies, aliases, symbol versions, etc. +.SH "COPYRIGHT" +.PP +This manual page originally Copyright 2002, Rusty Russell, +IBM Corporation. Portions Copyright Jon Masters, and others. +.SH "SEE ALSO" +.PP +\fBdepmod.conf\fR(5), +\fBdepmod.d\fR(5), +\fBmodprobe\fR(8), +\fBmodules.dep\fR(5) diff -Naur module-init-tools-3.16.orig/build/depmod.conf.5 module-init-tools-3.16/build/depmod.conf.5 --- module-init-tools-3.16.orig/build/depmod.conf.5 1970-01-01 00:00:00.000000000 +0000 +++ module-init-tools-3.16/build/depmod.conf.5 2011-10-10 20:51:22.103492175 +0000 @@ -0,0 +1,58 @@ +.\\" auto-generated by docbook2man-spec $Revision: 1.2 $ +.TH "DEPMOD.CONF" "5" "2010-03-01" "" "" +.SH NAME +depmod.conf, depmod.d \- Configuration file/directory for depmod +.SH "DESCRIPTION" +.PP +The order in which modules are processed by the +\fBdepmod\fR command can be altered on a global or +per-module basis. This is typically useful in cases where built-in +kernel modules are complemented by custom built versions of the +same and the user wishes to affect the priority of processing in +order to override the module version supplied by the kernel. +.PP +The format of \fIdepmod.conf\fR and files under \fIdepmod.d\fR is simple: one +command per line, with blank lines and lines starting with '#' +ignored (useful for adding comments). A '\\' at the end of a line +causes it to continue on the next line, which makes the file a +bit neater. +.SH "COMMANDS" +.TP +\fBsearch \fIsubdirectory...\fB\fR +This allows you to specify the order in which /lib/modules +(or other configured module location) subdirectories will +be processed by \fBdepmod\fR\&. Directories are +listed in order, with the highest priority given to the +first listed directory and the lowest priority given to the last +directory listed. The special keyword \fBbuilt-in\fR +refers to the standard module directories installed by the kernel. + +By default, depmod will give a higher priority to +a directory with the name \fBupdates\fR +using this built-in search string: "updates built-in" +but more complex arrangements are possible and are +used in several popular distributions. +.TP +\fBoverride \fImodulename\fB \fIkernelversion\fB \fImodulesubdirectory\fB\fR +This command allows you to override which version of a +specific module will be used when more than one module +sharing the same name is processed by the +\fBdepmod\fR command. It is possible to +specify one kernel or all kernels using the * wildcard. +\fImodulesubdirectory\fR is the +name of the subdirectory under /lib/modules (or other +module location) where the target module is installed. + +For example, it is possible to override the priority of +an updated test module called \fBkmod\fR by +specifying the following command: "override kmod * extra". +This will ensure that any matching module name installed +under the \fBextra\fR subdirectory within +/lib/modules (or other module location) will take priority +over any likenamed module already provided by the kernel. +.SH "COPYRIGHT" +.PP +This manual page Copyright 2006-2010, Jon Masters, Red Hat, Inc. +.SH "SEE ALSO" +.PP +\fBdepmod\fR(8) diff -Naur module-init-tools-3.16.orig/build/depmod.d.5 module-init-tools-3.16/build/depmod.d.5 --- module-init-tools-3.16.orig/build/depmod.d.5 1970-01-01 00:00:00.000000000 +0000 +++ module-init-tools-3.16/build/depmod.d.5 2011-10-10 20:51:22.103492175 +0000 @@ -0,0 +1,58 @@ +.\\" auto-generated by docbook2man-spec $Revision: 1.2 $ +.TH "DEPMOD.CONF" "5" "2010-03-01" "" "" +.SH NAME +depmod.conf, depmod.d \- Configuration file/directory for depmod +.SH "DESCRIPTION" +.PP +The order in which modules are processed by the +\fBdepmod\fR command can be altered on a global or +per-module basis. This is typically useful in cases where built-in +kernel modules are complemented by custom built versions of the +same and the user wishes to affect the priority of processing in +order to override the module version supplied by the kernel. +.PP +The format of \fIdepmod.conf\fR and files under \fIdepmod.d\fR is simple: one +command per line, with blank lines and lines starting with '#' +ignored (useful for adding comments). A '\\' at the end of a line +causes it to continue on the next line, which makes the file a +bit neater. +.SH "COMMANDS" +.TP +\fBsearch \fIsubdirectory...\fB\fR +This allows you to specify the order in which /lib/modules +(or other configured module location) subdirectories will +be processed by \fBdepmod\fR\&. Directories are +listed in order, with the highest priority given to the +first listed directory and the lowest priority given to the last +directory listed. The special keyword \fBbuilt-in\fR +refers to the standard module directories installed by the kernel. + +By default, depmod will give a higher priority to +a directory with the name \fBupdates\fR +using this built-in search string: "updates built-in" +but more complex arrangements are possible and are +used in several popular distributions. +.TP +\fBoverride \fImodulename\fB \fIkernelversion\fB \fImodulesubdirectory\fB\fR +This command allows you to override which version of a +specific module will be used when more than one module +sharing the same name is processed by the +\fBdepmod\fR command. It is possible to +specify one kernel or all kernels using the * wildcard. +\fImodulesubdirectory\fR is the +name of the subdirectory under /lib/modules (or other +module location) where the target module is installed. + +For example, it is possible to override the priority of +an updated test module called \fBkmod\fR by +specifying the following command: "override kmod * extra". +This will ensure that any matching module name installed +under the \fBextra\fR subdirectory within +/lib/modules (or other module location) will take priority +over any likenamed module already provided by the kernel. +.SH "COPYRIGHT" +.PP +This manual page Copyright 2006-2010, Jon Masters, Red Hat, Inc. +.SH "SEE ALSO" +.PP +\fBdepmod\fR(8) diff -Naur module-init-tools-3.16.orig/build/insmod.8 module-init-tools-3.16/build/insmod.8 --- module-init-tools-3.16.orig/build/insmod.8 1970-01-01 00:00:00.000000000 +0000 +++ module-init-tools-3.16/build/insmod.8 2011-10-10 20:51:22.103492175 +0000 @@ -0,0 +1,30 @@ +.\\" auto-generated by docbook2man-spec $Revision: 1.2 $ +.TH "INSMOD" "8" "2010-03-01" "" "" +.SH NAME +insmod \- simple program to insert a module into the Linux Kernel +.SH SYNOPSIS +.sp +\fBinsmod\fR [ \fB\fIfilename\fB\fR ] [ \fB\fImodule options\fB\fR\fI...\fR ] +.SH "DESCRIPTION" +.PP +\fBinsmod\fR is a trivial program to insert a +module into the kernel: if the +\fIfilename\fR is a hyphen, the module is +taken from standard input. Most users will want to use +\fBmodprobe\fR(8) instead, which is +more clever and can handle module dependencies. +.PP +Only the most general of error messages are reported: as the +work of trying to link the module is now done inside the kernel, +the \fBdmesg\fR usually gives more information +about errors. +.SH "COPYRIGHT" +.PP +This manual page originally Copyright 2002, Rusty Russell, IBM +Corporation. Maintained by Jon Masters and others. +.SH "SEE ALSO" +.PP +\fBmodprobe\fR(8), +\fBrmmod\fR(8), +\fBlsmod\fR(8) +\fBmodinfo\fR(8) diff -Naur module-init-tools-3.16.orig/build/lsmod.8 module-init-tools-3.16/build/lsmod.8 --- module-init-tools-3.16.orig/build/lsmod.8 1970-01-01 00:00:00.000000000 +0000 +++ module-init-tools-3.16/build/lsmod.8 2011-10-10 20:51:22.103492175 +0000 @@ -0,0 +1,21 @@ +.\\" auto-generated by docbook2man-spec $Revision: 1.2 $ +.TH "LSMOD" "8" "2010-03-01" "" "" +.SH NAME +lsmod \- program to show the status of modules in the Linux Kernel +.SH SYNOPSIS +.sp +\fBlsmod\fR +.SH "DESCRIPTION" +.PP +\fBlsmod\fR is a trivial program which nicely +formats the contents of the \fI/proc/modules\fR, +showing what kernel modules are currently loaded. +.SH "COPYRIGHT" +.PP +This manual page originally Copyright 2002, Rusty Russell, IBM +Corporation. Maintained by Jon Masters and others. +.SH "SEE ALSO" +.PP +\fBinsmod\fR(8), +\fBmodprobe\fR(8), +\fBmodinfo\fR(8) diff -Naur module-init-tools-3.16.orig/build/modinfo.8 module-init-tools-3.16/build/modinfo.8 --- module-init-tools-3.16.orig/build/modinfo.8 1970-01-01 00:00:00.000000000 +0000 +++ module-init-tools-3.16/build/modinfo.8 2011-10-10 20:51:22.103492175 +0000 @@ -0,0 +1,72 @@ +.\\" auto-generated by docbook2man-spec $Revision: 1.2 $ +.TH "MODINFO" "8" "2010-03-01" "" "" +.SH NAME +modinfo \- program to show information about a Linux Kernel module +.SH SYNOPSIS +.sp +\fBmodinfo\fR [ \fB-0\fR ] [ \fB-F \fIfield\fB\fR ] [ \fB-k \fIkernel\fB\fR ] [ \fBmodulename|filename\fR\fI...\fR ] +.sp +\fBmodinfo -V\fR +.sp +\fBmodinfo -h\fR +.SH "DESCRIPTION" +.PP +\fBmodinfo\fR extracts information from the Linux +Kernel modules given on the command line. If the module name is +not a filename, then the +\fI/lib/modules/\fR\fIversion\fR +directory is searched, as is also done by +\fBmodprobe\fR(8) when loading kernel modules. +.PP +\fBmodinfo\fR by default lists each attribute +of the module in form \fIfieldname\fR : +\fIvalue\fR, for easy reading. The +filename is listed the same way (although it's not really an +attribute). +.PP +This version of \fBmodinfo\fR can understand +modules of any Linux Kernel architecture. +.SH "OPTIONS" +.TP +\fB-V --version\fR +Print the modinfo version. +.TP +\fB-F --field\fR +Only print this field value, one per line. This is most +useful for scripts. Field names are case-insenitive. +Common fields (which may not be in every module) include +author, description, +license, parm, +depends, and alias\&. +There are often multiple parm, +alias and depends +fields. The special field filename +lists the filename of the module. +.TP +\fB-k \fIkernel\fB\fR +Provide information about a kernel other than the running one. This +is particularly useful for distributions needing to extract +information from a newly installed (but not yet running) set of +kernel modules. For example, you wish to find which firmware files +are needed by various modules in a new kernel for which you must +make an initrd/initramfs image prior to booting. +.TP +\fB-0 --null\fR +Use the ASCII zero character to separate field values, +instead of a new line. This is useful for scripts, since +a new line can theoretically appear inside a field. +.TP +\fB-a -d -l -p -n\fR +These are shortcuts for author, +description, +license\&. parm and +filename respectively, to ease the +transition from the old modutils +\fBmodinfo\fR\&. +.SH "COPYRIGHT" +.PP +This manual page originally Copyright 2003, Rusty Russell, IBM +Corporation. Maintained by Jon Masters and others. +.SH "SEE ALSO" +.PP +\fBmodprobe\fR(8) diff -Naur module-init-tools-3.16.orig/build/modprobe.8 module-init-tools-3.16/build/modprobe.8 --- module-init-tools-3.16.orig/build/modprobe.8 1970-01-01 00:00:00.000000000 +0000 +++ module-init-tools-3.16/build/modprobe.8 2011-10-10 20:51:22.103492175 +0000 @@ -0,0 +1,252 @@ +.\\" auto-generated by docbook2man-spec $Revision: 1.2 $ +.TH "MODPROBE" "8" "2010-03-01" "" "" +.SH NAME +modprobe \- program to add and remove modules from the Linux Kernel +.SH SYNOPSIS +.sp +\fBmodprobe\fR [ \fB-v\fR ] [ \fB-V\fR ] [ \fB-C \fIconfig-file\fB\fR ] [ \fB-n\fR ] [ \fB-i\fR ] [ \fB-q\fR ] [ \fB-b\fR ] [ \fB\fImodulename\fB\fR ] [ \fB\fImodule parameters\fB\fR\fI...\fR ] +.sp +\fBmodprobe\fR [ \fB-r\fR ] [ \fB-v\fR ] [ \fB-n\fR ] [ \fB-i\fR ] [ \fB\fImodulename\fB\fR\fI...\fR ] +.sp +\fBmodprobe\fR [ \fB-l\fR ] [ \fB-t \fIdirname\fB\fR ] [ \fB\fIwildcard\fB\fR ] +.sp +\fBmodprobe\fR [ \fB-c\fR ] +.sp +\fBmodprobe\fR [ \fB--dump-modversions\fR ] [ \fB\fIfilename\fB\fR ] +.SH "DESCRIPTION" +.PP +\fBmodprobe\fR intelligently adds or removes a +module from the Linux kernel: note that for convenience, there +is no difference between _ and - in module names (automatic +underscore conversion is performed). +\fBmodprobe\fR looks in the module directory +\fI/lib/modules/`uname -r`\fR for all +the modules and other files, except for the optional +\fI/etc/modprobe.conf\fR configuration file and +\fI/etc/modprobe.d\fR directory +(see \fBmodprobe.conf\fR(5)). \fBmodprobe\fR will also use module +options specified on the kernel command line in the form of +\&.