[Summary view] [Print] [Text view]

   1  .\" This manpage has been automatically generated by docbook2man 
   2  .\" from a DocBook document.  This tool can be found at:
   3  .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
   4  .\" Please send any bug reports, improvements, comments, patches, 
   5  .\" etc. to Steve Cheng <steve@ggi-project.org>.
   6  .TH "DEPMOD" "8" "13 October 2008" "" ""
   7  
   8  .SH NAME
   9  depmod \- program to generate modules.dep and map files.
  10  .SH SYNOPSIS
  11  
  12  \fBdepmod\fR [ \fB-b \fIbasedir\fB\fR ] [ \fB-e\fR ] [ \fB-F \fISystem.map\fB\fR ] [ \fB-n\fR ] [ \fB-v\fR ] [ \fB\fIversion\fB\fR ] [ \fB-A\fR ]
  13  
  14  
  15  \fBdepmod\fR [ \fB-e\fR ] [ \fB-F\fISystem.map\fB\fR ] [ \fB-n\fR ] [ \fB-v\fR ] [ \fB\fIversion\fB\fR ] [ \fB\fIfilename\fB\fR\fI ...\fR ]
  16  
  17  .SH "DESCRIPTION"
  18  .PP
  19  Linux kernel modules can provide services (called "symbols") for
  20  other modules to use (using EXPORT_SYMBOL in the code).  If a
  21  second module uses this symbol, that second module clearly
  22  depends on the first module.  These dependencies can get quite
  23  complex.
  24  .PP
  25  \fBdepmod\fR creates a list of module dependencies,
  26  by reading each module under
  27  \fI/lib/modules/\fR\fIversion\fR 
  28  and determining what symbols it exports, and what symbols it
  29  needs.  By default this list is written to
  30  \fImodules.dep\fR in the same directory.  If
  31  filenames are given on the command line, only those modules are
  32  examined (which is rarely useful, unless all modules are
  33  listed).
  34  .PP
  35  If a \fIversion\fR is provided, then that
  36  kernel version's module directory is used, rather than the
  37  current kernel version (as returned by "uname -r").
  38  .PP
  39  \fBdepmod\fR will also generate various map files
  40  in this directory, for use by the hotplug infrastructure.
  41  .SH "OPTIONS"
  42  .TP
  43  \fB-a --all \fR
  44  Probe all modules. This option is enabled by default if no
  45  file names are given in the command-line.
  46  .TP
  47  \fB-A --quick \fR
  48  This option scans to see if any modules are newer than the
  49  \fImodules.dep\fR file before any work is done:
  50  if not, it silently exits rather than regenerating the files.
  51  .TP
  52  \fB-b \fIbasedir\fB --basedir \fIbasedir\fB \fR
  53  If your modules are not currently in the (normal)
  54  directory
  55  \fI/lib/modules/\fR\fIversion\fR,
  56  but in a staging area, you can specify a
  57  \fIbasedir\fR which is prepended to
  58  the directory name.  This
  59  \fIbasedir\fR is stripped from the
  60  resulting \fImodules.dep\fR file, so it
  61  is ready to be moved into the normal location.
  62  .TP
  63  \fB-C --config \fIfile or directory\fB \fR
  64  This option overrides the default configuration file
  65  (/etc/depmod.conf or /etc/depmod.d/ if that is not found).
  66  .TP
  67  \fB-e --errsyms \fR
  68  When combined with the \fB-F\fR option, this
  69  reports any symbols which a module needs which are not
  70  supplied by other modules or the kernel.  Normally, any
  71  symbols not provided by modules are assumed to be
  72  provided by the kernel (which should be true in a
  73  perfect world).
  74  .TP
  75  \fB-F --filesyms \fISystem.map\fB \fR
  76  Supplied with the \fISystem.map\fR produced
  77  when the kernel was built, this allows the
  78  \fB-e\fR option to report unresolved symbols.
  79  .TP
  80  \fB-h --help \fR
  81  Print the help message, and exit.
  82  .TP
  83  \fB-n --dry-run \fR
  84  This sends the resulting modules.dep, then the various
  85  map files, to standard output, rather than writing them into
  86  the module directory.
  87  .TP
  88  \fB-v --verbose \fR
  89  In verbose mode \fBdepmod\fR will print (to stdout)
  90  all the symbols each module depends on and the module's file name
  91  which provides that symbol.
  92  .TP
  93  \fB-V --version \fR
  94  Show version of program, and exit. See below for caveats when
  95  run on older kernels.
  96  .SH "BACKWARDS COMPATIBILITY"
  97  .PP
  98  This version of \fBdepmod\fR is for kernels
  99  2.5.48 and above.  If it detects a kernel
 100  with support for old-style modules, or the version specified is
 101  before 2.5.48, it will attempt to run
 102  \fBdepmod.old\fR in its place, so it is completely
 103  transparent to the user.
 104  .SH "COPYRIGHT"
 105  .PP
 106  This manual page Copyright 2002, Rusty Russell, IBM Corporation.
 107  .SH "SEE ALSO"
 108  .PP
 109  \fBmodprobe\fR(8),
 110  \fBmodules.dep\fR(5),
 111  \fBdepmod.old\fR(8)