share/man/man8/modinfo.8

   1 '\" te
   2 .\" Copyright (C) 2002, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH MODINFO 8 "Oct 1, 2002"
   7 .SH NAME
   8 modinfo \- display information about loaded kernel modules
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/modinfo\fR [\fB-c\fR] [\fB-w\fR] [\fB-i\fR \fImodule-id\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBmodinfo\fR utility displays information about the loaded modules. The
  19 format of the information is as follows:
  20 .sp
  21 .in +2
  22 .nf
  23 \fIId\fR \fILoadaddr\fR \fISize\fR \fIInfo\fR \fIRev\fR \fIModule Name\fR
  24 .fi
  25 .in -2
  26
  27 .sp
  28 .LP
  29 where \fIId\fR is the module ID, \fILoadaddr\fR is the starting text address in
  30 hexadecimal, \fISize\fR is the size of text, data, and bss in hexadecimal
  31 bytes, \fIInfo\fR is module specific information, \fIRev\fR is the revision of
  32 the loadable modules system, and \fIModule Name\fR is the filename and
  33 description of the module.
  34 .sp
  35 .LP
  36 The module specific information is the block and character major numbers for
  37 drivers, the system call number for system calls, and unspecified for other
  38 module types.
  39 .SH OPTIONS
  40 .sp
  41 .LP
  42 The following options are supported:
  43 .sp
  44 .ne 2
  45 .na
  46 \fB\fB-c\fR\fR
  47 .ad
  48 .RS 16n
  49 Display the number of instances of the module loaded and the module's current
  50 state.
  51 .RE
  52
  53 .sp
  54 .ne 2
  55 .na
  56 \fB\fB-i\fR\fI module-id\fR\fR
  57 .ad
  58 .RS 16n
  59 Display information about this module only.
  60 .RE
  61
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fB-w\fR\fR
  66 .ad
  67 .RS 16n
  68 Do not truncate module information at \fB80\fR characters.
  69 .RE
  70
  71 .SH EXAMPLES
  72 .LP
  73 \fBExample 1 \fRDisplaying the Status of a Module
  74 .sp
  75 .LP
  76 The following example displays the status of module 2:
  77
  78 .sp
  79 .in +2
  80 .nf
  81 example% \fBmodinfo -i 2\fR
  82 Id   Loadaddr   Size Info Rev Module Name
  83  2    ff08e000   1734   -   1  swapgeneric (root and swap configuration)
  84 .fi
  85 .in -2
  86 .sp
  87
  88 .LP
  89 \fBExample 2 \fRDisplaying the Status of Kernel Modules
  90 .sp
  91 .LP
  92 The following example displays the status of some kernel modules:
  93
  94 .sp
  95 .in +2
  96 .nf
  97 example% \fBmodinfo\fR
  98 Id Loadaddr   Size Info Rev Module Name
  99  2  ff08e000   1734   -   1  swapgeneric
 100  4  ff07a000   3bc0   -   1  specfs (filesystem for specfs)
 101  6  ff07dbc0   2918   -   1  TS (time sharing sched class)
 102  7  ff0804d8    49c   -   1  TS_DPTBL (Time sharing dispatch table)
 103  8  ff04a000  24a30   2   1  ufs (filesystem for ufs)
 104  9  ff080978   c640 226   1  rpcmod (RPC syscall)
 105  9  ff080978   c640   -   1  rpcmod (rpc interface str mod)
 106 10  ff08cfb8  2031c   -   1  ip (IP Streams module)
 107 10  ff08cfb8  2031c   2   1  ip (IP Streams device)
 108
 109 .fi
 110 .in -2
 111 .sp
 112
 113 .LP
 114 \fBExample 3 \fRUsing the \fB-c\fR Option
 115 .sp
 116 .LP
 117 Using the \fBmodinfo\fR command with the \fB-c\fR option displays the number of
 118 instances of the module loaded and the module's current state.
 119
 120 .sp
 121 .in +2
 122 .nf
 123 example% \fBmodinfo -c \fR
 124 Id    Loadcnt Module Name                            State
 125   1          0 krtld                            UNLOADED/UNINSTALLED
 126   2          0 genunix                          UNLOADED/UNINSTALLED
 127   3          0 platmod                          UNLOADED/UNINSTALLED
 128   4          0 SUNW,UltraSPARC-IIi              UNLOADED/UNINSTALLED
 129   5          0 cl_bootstrap                     UNLOADED/UNINSTALLED
 130   6          1 specfs                           LOADED/INSTALLED
 131   7          1 swapgeneric                      UNLOADED/UNINSTALLED
 132   8          1 TS                               LOADED/INSTALLED
 133   9          1 TS_DPTBL                         LOADED/INSTALLED
 134  10          1 ufs                              LOADED/INSTALLED
 135  11          1 fssnap_if                        LOADED/INSTALLED
 136 .fi
 137 .in -2
 138 .sp
 139
 140 .SH ATTRIBUTES
 141 .sp
 142 .LP
 143 See \fBattributes\fR(5) for descriptions of the following attributes:
 144 .sp
 145
 146 .sp
 147 .TS
 148 box;
 149 c | c
 150 l | l .
 151 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 152 _
 153 Interface Stability     Evolving
 154 .TE
 155
 156 .SH SEE ALSO
 157 .sp
 158 .LP
 159 \fBmodload\fR(8), \fBmodunload\fR(8), \fBattributes\fR(5)