usr/src/man/man1m/kernel.1m

   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 1M "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(1M) 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(1M) 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 .sp
  46 .LP
  47 This default can be supplemented by a specific platform. It is common for many
  48 SPARC systems to override the default path with:
  49 .sp
  50 .in +2
  51 .nf
  52 /platform/\fIplatform-name\fR/kernel:/platform/\fIhardware-class-name\fR\e
  53      /kernel:/kernel:/usr/kernel
  54 .fi
  55 .in -2
  56 .sp
  57
  58 .sp
  59 .LP
  60 where \fIplatform-name\fR can be found using the \fB-i\fR option of
  61 \fBuname\fR(1), and \fIhardware-class-name\fR can be found using the \fB-m\fR
  62 option of \fBuname\fR(1).
  63 .sp
  64 .LP
  65 The kernel configuration can be controlled using the \fB/etc/system\fR file
  66 (see \fBsystem\fR(4)).
  67 .sp
  68 .LP
  69 \fBgenunix\fR is the platform-independent component of the base kernel.
  70 .SH OPTIONS
  71 .sp
  72 .LP
  73 The following options are supported:
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fB-a\fR\fR
  78 .ad
  79 .sp .6
  80 .RS 4n
  81 Asks the user for configuration information, such as where to find the system
  82 file, where to mount \fBroot\fR, and even override the name of the kernel
  83 itself. Default responses will be contained in square brackets ([ ]), and the
  84 user may simply enter RETURN to use the default response (note that RETURN is
  85 labeled ENTER on some keyboards). To help repair a damaged \fB/etc/system\fR
  86 file, enter \fB/dev/null\fR at the prompt that asks for the pathname of the
  87 system configuration file. See \fBsystem\fR(4).
  88 .RE
  89
  90 .sp
  91 .ne 2
  92 .na
  93 \fB\fB-i\fR \fIaltinit\fR\fR
  94 .ad
  95 .sp .6
  96 .RS 4n
  97 Select an alternative executable to be the primordial process. \fIaltinit\fR
  98 must be a valid path to an executable. The default primordial process is
  99 \fBinit\fR(1M).
 100 .RE
 101
 102 .sp
 103 .ne 2
 104 .na
 105 \fB\fB-m\fR \fIsmf_options\fR\fR
 106 .ad
 107 .sp .6
 108 .RS 4n
 109 The \fIsmf_options\fR include two categories of options to control booting
 110 behavior of the service management facility: recovery options and messages
 111 options.
 112 .sp
 113 Message options determine the type and amount of messages that \fBsmf\fR(5)
 114 displays during boot. Service options determine the services which are used to
 115 boot the system.
 116 .sp
 117 Recovery options
 118 .sp
 119 .ne 2
 120 .na
 121 \fB\fIdebug\fR\fR
 122 .ad
 123 .sp .6
 124 .RS 4n
 125 Prints standard per-service output and all \fBsvc.startd\fR messages to log.
 126 .RE
 127
 128 .sp
 129 .ne 2
 130 .na
 131 \fB\fImilestone=[milestone]\fR\fR
 132 .ad
 133 .sp .6
 134 .RS 4n
 135 Boot with some SMF services temporarily disabled, as indicated by
 136 \fImilestone\fR. \fImilestone\fR can be "none", "single-user", "multi-user",
 137 "multi-user-server", or "all". See the \fBmilestone\fR subcommand of
 138 \fBsvcadm\fR(1M).
 139 .RE
 140
 141 Messages options
 142 .sp
 143 .ne 2
 144 .na
 145 \fB\fIquiet\fR\fR
 146 .ad
 147 .sp .6
 148 .RS 4n
 149 Prints standard per-service output and error messages requiring administrative
 150 intervention.
 151 .RE
 152
 153 .sp
 154 .ne 2
 155 .na
 156 \fB\fIverbose\fR\fR
 157 .ad
 158 .sp .6
 159 .RS 4n
 160 Prints standard per-service output with more informational messages.
 161 .RE
 162
 163 .RE
 164
 165 .sp
 166 .ne 2
 167 .na
 168 \fB\fB-r\fR\fR
 169 .ad
 170 .sp .6
 171 .RS 4n
 172 Reconfiguration boot. The system will probe all attached hardware devices and
 173 configure the logical namespace in \fB/dev\fR. See \fBadd_drv\fR(1M) and
 174 \fBrem_drv\fR(1M) for additional information about maintaining device drivers.
 175 .RE
 176
 177 .sp
 178 .ne 2
 179 .na
 180 \fB\fB-s\fR\fR
 181 .ad
 182 .sp .6
 183 .RS 4n
 184 Boots only to init level 's'. See \fBinit\fR(1M).
 185 .RE
 186
 187 .sp
 188 .ne 2
 189 .na
 190 \fB\fB-v\fR\fR
 191 .ad
 192 .sp .6
 193 .RS 4n
 194 Boots with verbose messages enabled. If this flag is not given, the messages
 195 are still printed, but the output is directed to the system logfile. See
 196 \fBsyslogd\fR(1M).
 197 .RE
 198
 199 .sp
 200 .ne 2
 201 .na
 202 \fB\fB-x\fR\fR
 203 .ad
 204 .sp .6
 205 .RS 4n
 206 Does not boot in clustered mode. This option only has an effect when a version
 207 of Sun Cluster software that supports this option has been installed.
 208 .RE
 209
 210 .SH EXAMPLES
 211 .sp
 212 .LP
 213 See \fBboot\fR(1M) for examples and instructions on how to boot.
 214 .SH FILES
 215 .sp
 216 .ne 2
 217 .na
 218 \fB\fB/kernel\fR\fR
 219 .ad
 220 .sp .6
 221 .RS 4n
 222 Contains kernel components common to all platforms within a particular
 223 instruction set that are needed for booting the system. of the core image file.
 224 .RE
 225
 226 .sp
 227 .ne 2
 228 .na
 229 \fB\fB/platform/\fIplatform-name\fR/kernel\fR\fR
 230 .ad
 231 .sp .6
 232 .RS 4n
 233 The platform-specific kernel components.
 234 .RE
 235
 236 .sp
 237 .ne 2
 238 .na
 239 \fB\fB/platform/\fIhardware-class-name\fR\fR\fB/kernel\fR\fR
 240 .ad
 241 .sp .6
 242 .RS 4n
 243 The kernel components specific to this hardware class.
 244 .RE
 245
 246 .sp
 247 .ne 2
 248 .na
 249 \fB\fB/usr/kernel\fR\fR
 250 .ad
 251 .sp .6
 252 .RS 4n
 253 Contains kernel components common to all platforms within a particular
 254 instruction set.
 255 .RE
 256
 257 .sp
 258 .LP
 259 The directories in this section can potentially contain the following
 260 subdirectories:
 261 .sp
 262 .ne 2
 263 .na
 264 \fBdrv\fR
 265 .ad
 266 .sp .6
 267 .RS 4n
 268 Loadable device drivers
 269 .RE
 270
 271 .sp
 272 .ne 2
 273 .na
 274 \fBexec\fR
 275 .ad
 276 .sp .6
 277 .RS 4n
 278 The modules that execute programs stored in various file formats.
 279 .RE
 280
 281 .sp
 282 .ne 2
 283 .na
 284 \fBfs\fR
 285 .ad
 286 .sp .6
 287 .RS 4n
 288 File system modules
 289 .RE
 290
 291 .sp
 292 .ne 2
 293 .na
 294 \fBmisc\fR
 295 .ad
 296 .sp .6
 297 .RS 4n
 298 Miscellaneous system-related modules
 299 .RE
 300
 301 .sp
 302 .ne 2
 303 .na
 304 \fBsched\fR
 305 .ad
 306 .sp .6
 307 .RS 4n
 308 Operating system schedulers
 309 .RE
 310
 311 .sp
 312 .ne 2
 313 .na
 314 \fBstrmod\fR
 315 .ad
 316 .sp .6
 317 .RS 4n
 318 System V STREAMS loadable modules
 319 .RE
 320
 321 .sp
 322 .ne 2
 323 .na
 324 \fBsys\fR
 325 .ad
 326 .sp .6
 327 .RS 4n
 328 Loadable system calls
 329 .RE
 330
 331 .SS "SPARC"
 332 .sp
 333 .ne 2
 334 .na
 335 \fBcpu\fR
 336 .ad
 337 .sp .6
 338 .RS 4n
 339 Processor specific modules
 340 .RE
 341
 342 .sp
 343 .ne 2
 344 .na
 345 \fBtod\fR
 346 .ad
 347 .sp .6
 348 .RS 4n
 349 Time-Of-Day hardware interface modules
 350 .RE
 351
 352 .sp
 353 .LP
 354 As only 64-bit SPARC platforms are supported, all SPARC executable modules are
 355 contained within \fBsparcv9\fR directories in the directories listed above.
 356 .SS "x86"
 357 .sp
 358 .ne 2
 359 .na
 360 \fBmach\fR
 361 .ad
 362 .sp .6
 363 .RS 4n
 364 x86 hardware support
 365 .RE
 366
 367 .sp
 368 .LP
 369 Modules comprising the 32-bit x86 kernel are contained in the above
 370 directories, with the 64-bit x86 kernel components contained within \fBamd64\fR
 371 subdirectories.
 372 .SH SEE ALSO
 373 .sp
 374 .LP
 375 \fBuname\fR(1), \fBisainfo\fR(1), \fBadd_drv\fR(1M), \fBboot\fR(1M),
 376 \fBinit\fR(1M), \fBkadb\fR(1M), \fBrem_drv\fR(1M), \fBsavecore\fR(1M),
 377 \fBsvc.startd\fR(1M), \fBsvcadm\fR(1M), \fBsyslogd\fR(1M), \fBsystem\fR(4),
 378 \fBattributes\fR(5), \fBsmf\fR(5), \fBdevfs\fR(7FS)
 379 .SS "SPARC Only"
 380 .sp
 381 .LP
 382 \fBmonitor\fR(1M)
 383 .SH DIAGNOSTICS
 384 .sp
 385 .LP
 386 The kernel gives various warnings and error messages. If the kernel detects an
 387 unrecoverable fault, it will panic or halt.
 388 .SH NOTES
 389 .sp
 390 .LP
 391 Reconfiguration boot will, by design, not remove \fB/dev\fR entries for some
 392 classes of devices that have been physically removed from the system.