share/man/man8/kernel.8

   1 '\" te
   2 .\" Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved
   3 .\" Copyright 1989 AT&T
   4 .\" 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.
   5 .\" 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.
   6 .\" 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]
   7 .TH KERNEL 8 "Nov 27, 2007"
   8 .SH NAME
   9 kernel \- UNIX system executable file containing basic operating system
  10 services
  11 .SH SYNOPSIS
  12 .LP
  13 .nf
  14 \fBkernel-name\fR [\fB-asrvx\fR] [\fB-m \fIsmf_options\fR\fR] [\fB-i \fIaltinit\fR\fR]
  15 .fi
  16
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 The operating system image, or kernel, is the collection of software comprising
  21 the image files (\fBunix\fR and \fBgenunix\fR) and the modules loaded at any
  22 instant in time. The system will not function without a kernel to control it.
  23 .sp
  24 .LP
  25 The kernel is loaded by the \fBboot\fR(8) command in a machine-specific way.
  26 The kernel may be loaded from disk, \fBCD-ROM\fR, or DVD (\fBdiskfull boot\fR)
  27 or over the network (\fBdiskless boot\fR). In either case, the directories
  28 under \fB/platform\fR and \fB/kernel\fR must be readable and must contain
  29 executable code which is able to perform the required kernel service. If the
  30 \fB-a\fR flag is given, the user is able to supply different pathnames for the
  31 default locations of the kernel and modules. See \fBboot\fR(8) for more
  32 information on loading a specific kernel.
  33 .sp
  34 .LP
  35 The \fBmoddir\fR variable contains a list of module directories separated by
  36 whitespace. moddir can be set in the \fB/etc/system\fR file. The minimal
  37 default is:
  38 .sp
  39 .in +2
  40 .nf
  41 /platform/platform-name/kernel /kernel /usr/kernel
  42 .fi
  43 .in -2
  44
  45 .LP
  46 This default can be supplemented by a specific platform.
  47
  48 .sp
  49 .LP
  50 The kernel configuration can be controlled using the \fB/etc/system\fR file
  51 (see \fBsystem\fR(4)).
  52 .sp
  53 .LP
  54 \fBgenunix\fR is the platform-independent component of the base kernel.
  55 .SH OPTIONS
  56 .sp
  57 .LP
  58 The following options are supported:
  59 .sp
  60 .ne 2
  61 .na
  62 \fB\fB-a\fR\fR
  63 .ad
  64 .sp .6
  65 .RS 4n
  66 Asks the user for configuration information, such as where to find the system
  67 file, where to mount \fBroot\fR, and even override the name of the kernel
  68 itself. Default responses will be contained in square brackets ([ ]), and the
  69 user may simply enter RETURN to use the default response (note that RETURN is
  70 labeled ENTER on some keyboards). To help repair a damaged \fB/etc/system\fR
  71 file, enter \fB/dev/null\fR at the prompt that asks for the pathname of the
  72 system configuration file. See \fBsystem\fR(4).
  73 .RE
  74
  75 .sp
  76 .ne 2
  77 .na
  78 \fB\fB-i\fR \fIaltinit\fR\fR
  79 .ad
  80 .sp .6
  81 .RS 4n
  82 Select an alternative executable to be the primordial process. \fIaltinit\fR
  83 must be a valid path to an executable. The default primordial process is
  84 \fBinit\fR(8).
  85 .RE
  86
  87 .sp
  88 .ne 2
  89 .na
  90 \fB\fB-m\fR \fIsmf_options\fR\fR
  91 .ad
  92 .sp .6
  93 .RS 4n
  94 The \fIsmf_options\fR include two categories of options to control booting
  95 behavior of the service management facility: recovery options and messages
  96 options.
  97 .sp
  98 Message options determine the type and amount of messages that \fBsmf\fR(5)
  99 displays during boot. Service options determine the services which are used to
 100 boot the system.
 101 .sp
 102 Recovery options
 103 .sp
 104 .ne 2
 105 .na
 106 \fB\fIdebug\fR\fR
 107 .ad
 108 .sp .6
 109 .RS 4n
 110 Prints standard per-service output and all \fBsvc.startd\fR messages to log.
 111 .RE
 112
 113 .sp
 114 .ne 2
 115 .na
 116 \fB\fImilestone=[milestone]\fR\fR
 117 .ad
 118 .sp .6
 119 .RS 4n
 120 Boot with some SMF services temporarily disabled, as indicated by
 121 \fImilestone\fR. \fImilestone\fR can be "none", "single-user", "multi-user",
 122 "multi-user-server", or "all". See the \fBmilestone\fR subcommand of
 123 \fBsvcadm\fR(8).
 124 .RE
 125
 126 Messages options
 127 .sp
 128 .ne 2
 129 .na
 130 \fB\fIquiet\fR\fR
 131 .ad
 132 .sp .6
 133 .RS 4n
 134 Prints standard per-service output and error messages requiring administrative
 135 intervention.
 136 .RE
 137
 138 .sp
 139 .ne 2
 140 .na
 141 \fB\fIverbose\fR\fR
 142 .ad
 143 .sp .6
 144 .RS 4n
 145 Prints standard per-service output with more informational messages.
 146 .RE
 147
 148 .RE
 149
 150 .sp
 151 .ne 2
 152 .na
 153 \fB\fB-r\fR\fR
 154 .ad
 155 .sp .6
 156 .RS 4n
 157 Reconfiguration boot. The system will probe all attached hardware devices and
 158 configure the logical namespace in \fB/dev\fR. See \fBadd_drv\fR(8) and
 159 \fBrem_drv\fR(8) for additional information about maintaining device drivers.
 160 .RE
 161
 162 .sp
 163 .ne 2
 164 .na
 165 \fB\fB-s\fR\fR
 166 .ad
 167 .sp .6
 168 .RS 4n
 169 Boots only to init level 's'. See \fBinit\fR(8).
 170 .RE
 171
 172 .sp
 173 .ne 2
 174 .na
 175 \fB\fB-v\fR\fR
 176 .ad
 177 .sp .6
 178 .RS 4n
 179 Boots with verbose messages enabled. If this flag is not given, the messages
 180 are still printed, but the output is directed to the system logfile. See
 181 \fBsyslogd\fR(8).
 182 .RE
 183
 184 .SH EXAMPLES
 185 .sp
 186 .LP
 187 See \fBboot\fR(8) for examples and instructions on how to boot.
 188 .SH FILES
 189 .sp
 190 .ne 2
 191 .na
 192 \fB\fB/kernel\fR\fR
 193 .ad
 194 .sp .6
 195 .RS 4n
 196 Contains kernel components common to all platforms within a particular
 197 instruction set that are needed for booting the system. of the core image file.
 198 .RE
 199
 200 .sp
 201 .ne 2
 202 .na
 203 \fB\fB/platform/\fIplatform-name\fR/kernel\fR\fR
 204 .ad
 205 .sp .6
 206 .RS 4n
 207 The platform-specific kernel components.
 208 .RE
 209
 210 .sp
 211 .ne 2
 212 .na
 213 \fB\fB/platform/\fIhardware-class-name\fR\fR\fB/kernel\fR\fR
 214 .ad
 215 .sp .6
 216 .RS 4n
 217 The kernel components specific to this hardware class.
 218 .RE
 219
 220 .sp
 221 .ne 2
 222 .na
 223 \fB\fB/usr/kernel\fR\fR
 224 .ad
 225 .sp .6
 226 .RS 4n
 227 Contains kernel components common to all platforms within a particular
 228 instruction set.
 229 .RE
 230
 231 .sp
 232 .LP
 233 The directories in this section can potentially contain the following
 234 subdirectories:
 235 .sp
 236 .ne 2
 237 .na
 238 \fBdrv\fR
 239 .ad
 240 .sp .6
 241 .RS 4n
 242 Loadable device drivers
 243 .RE
 244
 245 .sp
 246 .ne 2
 247 .na
 248 \fBexec\fR
 249 .ad
 250 .sp .6
 251 .RS 4n
 252 The modules that execute programs stored in various file formats.
 253 .RE
 254
 255 .sp
 256 .ne 2
 257 .na
 258 \fBfs\fR
 259 .ad
 260 .sp .6
 261 .RS 4n
 262 File system modules
 263 .RE
 264
 265 .sp
 266 .ne 2
 267 .na
 268 \fBmisc\fR
 269 .ad
 270 .sp .6
 271 .RS 4n
 272 Miscellaneous system-related modules
 273 .RE
 274
 275 .sp
 276 .ne 2
 277 .na
 278 \fBsched\fR
 279 .ad
 280 .sp .6
 281 .RS 4n
 282 Operating system schedulers
 283 .RE
 284
 285 .sp
 286 .ne 2
 287 .na
 288 \fBstrmod\fR
 289 .ad
 290 .sp .6
 291 .RS 4n
 292 System V STREAMS loadable modules
 293 .RE
 294
 295 .sp
 296 .ne 2
 297 .na
 298 \fBsys\fR
 299 .ad
 300 .sp .6
 301 .RS 4n
 302 Loadable system calls
 303 .RE
 304
 305 .SS "x86"
 306 .sp
 307 .ne 2
 308 .na
 309 \fBmach\fR
 310 .ad
 311 .sp .6
 312 .RS 4n
 313 x86 hardware support
 314 .RE
 315
 316 .SH SEE ALSO
 317 .sp
 318 .LP
 319 \fBuname\fR(1), \fBisainfo\fR(1), \fBadd_drv\fR(8), \fBboot\fR(8),
 320 \fBinit\fR(8), \fBkadb\fR(8), \fBrem_drv\fR(8), \fBsavecore\fR(8),
 321 \fBsvc.startd\fR(8), \fBsvcadm\fR(8), \fBsyslogd\fR(8), \fBsystem\fR(4),
 322 \fBattributes\fR(5), \fBsmf\fR(5), \fBdevfs\fR(7FS)
 323 .SH DIAGNOSTICS
 324 .sp
 325 .LP
 326 The kernel gives various warnings and error messages. If the kernel detects an
 327 unrecoverable fault, it will panic or halt.
 328 .SH NOTES
 329 .sp
 330 .LP
 331 Reconfiguration boot will, by design, not remove \fB/dev\fR entries for some
 332 classes of devices that have been physically removed from the system.