I had already posted this as a RFC and had no comment. Here is the same
man page in patch format against kexec-tools-1.101. Previously the
man page was empty.
Thanks
--
David Wilder
IBM Linux Technology Center
Beaverton, Oregon, USA
[EMAIL PROTECTED]
(503)578-3789
diff --git a/kexec/kexec.8 b/kexec/kexec.8
index 5dcbd80..cd61f3a 100644
--- a/kexec/kexec.8
+++ b/kexec/kexec.8
@@ -1,45 +1,141 @@
-.\" Hey, EMACS: -*- nroff -*-
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.TH KEXEC-TOOLS 8 "October 13, 2004"
-.\" Please adjust this date whenever revising the manpage.
+.\" Process this file with
+.\" groff -man -Tascii kexec.8
.\"
-.\" Some roff macros, for reference:
-.\" .nh disable hyphenation
-.\" .hy enable hyphenation
-.\" .ad l left justify
-.\" .ad b justify to both left and right margins
-.\" .nf disable filling
-.\" .fi enable filling
-.\" .br insert line break
-.\" .sp <n> insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
+.TH kexec 8 "April 2006" Linux "User Manuals"
.SH NAME
-kexec-tools \- Tool to load a kernel for warm reboot and initiate a warm reboot
+kexec \- directly boot into a new kernel
.SH SYNOPSIS
-.B kexec-tools
-.RI [ options ] " files" ...
+.B /sbin/kexec [-v (--version)] [-f (--force)] [-x (--no-ifdown)]
+ [-l (--load)] [-p (--load-panic)] [-u (--unload)] [-e (--exec)] [-t (--type)]
+ --mem-min=<addr>
+ --mem-max=<addr>
+
.SH DESCRIPTION
-.PP
-.\" TeX users may be more comfortable with the \fB<whatever>\fP and
-.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
-.\" respectively.
-\fBkexec-tools\fP does not have a man page yet. Please use "kexec -h" for help.
-.SH OPTIONS
-These programs follow the usual GNU command line syntax, with long
-options starting with two dashes (`-').
-A summary of options is included below.
-For a complete description, see the Info files.
-.TP
-.B \-h, \-\-help
-Show summary of options.
-.TP
-.B \-v, \-\-version
-Show version of program.
-.SH SEE ALSO
-.SH AUTHOR
-kexec-tools was written by Eric Biederman.
-.PP
-This manual page was written by Khalid Aziz <[EMAIL PROTECTED]>,
-for the Debian project (but may be used by others).
+kexec is a set of system calls that enables you to load another kernel from the currently executing Linux kernel.
+
+By default, \-i /sbin/kexec, when presented with a bzImage, avoids all BIOS calls and jumps directly to the kernel's entry point.
+
+The information it would usually get from the BIOS is instead collected from the current kernel.
+
+-----------------------------
+The boot process in Linux has two stages: the bootloader stage and the kernel stage.
+
+The bootloader stage is further subdivided into the hardware stage, the firmware stage, the first-level bootloader, and the second-level bootloader.
+
+Following power-on, initialization control goes to firmware, also referred to as the "bios" in some architectures.
+
+Firmware detects and initalizes devices such as storage, memory, bus bridges, and other devices, and then passes control to a minimal bootloader known as the master boot record (mbr), which can be on a disk, removable media, or over the network.
+
+The second-stage bootloader performs the actual operating system load. It presents the choices of kernels with specific hardware directives and options, or other operating systems.
+
+Once you select a boot option, the second-stage bootloader (typically referred to as the bootloader) loads the kernel and related parameters into memory, initializes the kernel, sets up the necessary environment, and finally executes the kernel.
+
+The next stage of booting is the kernel stage, when the kernel takes control.
+
+The kernel sets up the necessary data structures, probes the devices present on the system, loads the necessary device drivers, and initializes the devices.
+
+The last stage of the booting process involves user-level initialization. In this stage, the kernel checks the integrity of file systems, mounts file systems, sets up swap partitions
+(or swap files), starts system services, sets up system terminals, and the balance of declared hardware and software.
+
+In the boot sequence described above, kexec skips the entire bootloader stage (the first part) and directly jumps into the kernel that you want to boot to.
+-----------------------------------
+There is no hardware reset, no firmware operation, and no bootloader involved. Kexec has two components. The first is the userspace component known as "kexec-tools." The second is the actual kernel patch.
+
+The two parts achieve the two main operations of kexec: loading the new kernel into memory and rebooting to it.
+
+Make sure you have selected the CONFIG_KEXEC option while building the kernel.
+
+Using kexec consists of (1) loading the kernel to be rebooted to into memory, and (2) actually rebooting to it. To load a kernel, the syntax is as follows:
+
+kexec -l <kernel-image> --append="<command-line-options>"
+where <kernel-image> is the kernel file that you intend to reboot to and <command-line-options> contain the command-line parameters that need to be passed to the new kernel.
+
+Because the wrong command-line options can cause problems during the reboot, passing the contents of /proc/cmdline is the safest way to ensure that legal values are passed to the rebooting kernel.
+
+For example, if the kernel image you want to reboot is /boot/bzImage, and the content of /proc/cmdline is "root=/dev/hda1," then the command to load the kernel would be:
+
+kexec -l /boot/bzImage -append="root=/dev/hda1"
+
+.SH Options
+
+-v (--version) Returns the version number of the installed utility
+
+-f (--force) Force an immediate kexec, do no call shutdown
+
+-x (--no-ifdown) Shutdown the running kernel, but restore the interface on reload (if used must be the last option specified)
+
+-l (--load) Load the specified kernel into the current kernel
+
+-p (--load-panic) Load the new kernel for use on panic
+
+-u (--unload) Unload the current kexec target kernel
+
+-e (--exec) Execute a curretnly loaded kernel
+
+-t, --type=TYPE Specify the new kernel is of this type.
+
+--mem-min=<addr> Specify the lowest memory address to load code into.
+
+--mem-max=<addr> Specify the highest memory addres to load code into.
+
+.SH Supported kernel file types and options:
+
+
+multiboot-x86
+
+--command-line=STRING Set the kernel command line to STRING.
+
+--module="MOD arg1 arg2..." Load module MOD with command-line "arg1..." (can be used multiple times).
+
+elf-x86
+
+--command-line=STRING Set the kernel command line to STRING
+
+--append=STRING Set the kernel command line to STRING
+
+--initrd=FILE Use FILE as the kernel's initial ramdisk.
+
+--ramdisk=FILE Use FILE as the kernel's initial ramdisk.
+
+--args-linux Pass linux kernel style options
+
+--args-elf Pass elf boot notes
+
+bzImage
+
+-d, --debug Enable debugging to help spot a failure.
+
+--real-mode Use the kernels real mode entry point.
+
+--command-line=STRING Set the kernel command line to STRING.
+
+--append=STRING Set the kernel command line to STRING.
+
+--initrd=FILE Use FILE as the kernel's initial ramdisk.
+
+--ramdisk=FILE Use FILE as the kernel's initial ramdisk.
+
+beoboot-x86
+
+-d, --debug Enable debugging to help spot a failure.
+
+--real-mode Use the kernel's real mode entry point.
+
+nbi-x86
+
+Architecture options:
+
+--reset-vga Attempt to reset a standard vga device
+
+--serial=<port> Specify the serial port for debug output
+
+--serial-baud=<buad_rate> Specify the serial port baud rate
+
+--console-vga Enable the vga console
+
+--console-serial Enable the serial console
+
+--elf32-core-headers Prepare core headers in ELF32 format
+
+--elf64-core-headers Prepare core headers in ELF64 format
+
_______________________________________________
fastboot mailing list
[email protected]
https://lists.osdl.org/mailman/listinfo/fastboot
