Provided by: module-init-tools_3.16-1ubuntu2_amd64 bug

NAME

       depmod — program to generate modules.dep and map files.

SYNOPSIS

       depmod  [-b  basedir]   [-e]  [-E Module.symvers]  [-F System.map]  [-m]  [-n]  [-v]  [-A]
       [-P prefix]  [-w]  [version]

       depmod [-e]  [-E Module.symvers]  [-F System.map]  [-m]  [-n]  [-v]  [-P  prefix]   [-w  [
       [version]         [filename ...]      ] ]

DESCRIPTION

       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.

       depmod  creates  a  list  of  module   dependencies   by   reading   each   module   under
       /lib/modules/version  and  determining  what symbols it exports and what symbols it needs.
       By default, this list is written  to  modules.dep,  and  a  binary  hashed  version  named
       modules.dep.bin,  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).  depmod
       also  creates  a  list  of  symbols  provided by modules in the file named modules.symbols
       and its binary hashed version, modules.symbols.bin.  Finally, depmod will  output  a  file
       named  modules.devname  if  modules  supply  special device names (devname) that should be
       populated in /dev on boot (by a utility such as udev).

       If a version is provided, then that kernel version's module directory is used rather  than
       the current kernel version (as returned by uname -r).

       depmod  will also generate various legacy map files in the output directory for use by the
       older hotplug infrastructure. These map files are largely deprecated.

OPTIONS

       -a --all  Probe all modules. This option is enabled by default if no file names are  given
                 in the command-line.

       -A --quick
                 This  option  scans  to  see  if any modules are newer than the modules.dep file
                 before any work is done: if not, it silently exits rather than regenerating  the
                 files.

       -b basedir --basedir basedir
                 If    your    modules    are   not   currently   in   the   (normal)   directory
                 /lib/modules/version, but in a staging area, you can specify a basedir which  is
                 prepended  to  the  directory name.  This basedir is stripped from the resulting
                 modules.dep 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.

       -C --config file or directory
                 This option overrides the default configuration file at /etc/depmod.conf (or the
                 /etc/depmod.d/ directory if that is not found).

       -e --errsyms
                 When  combined with the -F 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.

       -E --symvers
                 When combined with the -e option, this reports any symbol versions  supplied  by
                 modules that do not match with the symbol versions provided by the kernel in its
                 Module.symvers.  This option is mutually incompatible with -F.

       -F --filesyms System.map
                 Supplied with the System.map produced when the kernel was built, this allows the
                 -e  option  to  report unresolved symbols.  This option is mutually incompatible
                 with -E.

       -h --help Print the help message and exit.

       -m        This overrides any possible configuration file  setting  of  make_map_files  and
                 forces the generation of legacy map files, such as modules.pcimap.

       -n --dry-run
                 This  sends  the  resulting  modules.dep  and  the various map files to standard
                 output rather than writing them into the module directory.

       -P        Some architectures prefix symbols with an extraneous character.  This  specifies
                 a prefix character (for example '_') to ignore.

       -v --verbose
                 In  verbose  mode,  depmod  will  print  (to stdout) all the symbols each module
                 depends on and the module's file name which provides that symbol.

       -V --version
                 Show version of program and exit. See  below  for  caveats  when  run  on  older
                 kernels.

       -w        Warn on duplicate dependencies, aliases, symbol versions, etc.

COPYRIGHT

       This  manual  page  originally  Copyright  2002,  Rusty Russell, IBM Corporation. Portions
       Copyright Jon Masters, and others.

SEE ALSO

       depmod.conf(5), depmod.d(5), modprobe(8), modules.dep(5)

                                                                                        depmod(8)