The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

boottool - tool for modifying bootloader configuration

SYNOPSIS

boottool [--bootloader-probe] [--arch-probe] [--add-kernel=<kernel_path>] [--title=<kernel_title>] [--position=<#|start|end>] [--root=<root_path>] [--args=<kernel_args>] [--initrd=<initrd_path>] [--make-default] [--force] [--boot-once] [--install] [--bootloader=<grub|lilo|elilo|yaboot>] [--config-file=</path/to/config>] [--remove-kernel=<#|title|start|end>] [--module=<module>] [--update-kernel=<#|title>] [--remove-args=<args>] [--info=<all|default|#>] [--default] [--help] [--debug=<0..5>] [--set-default=<#>]

DESCRIPTION

Boottool allows scripted modification of bootloader configuration files. Grub, Lilo, Elilo, and Yaboot are currently supported. When adding a kernel, any options not specified are copied from default.

OPTIONS

GENERAL OPTIONS

These can be used with any of the commands to override defaults or autodetection. They are not typically needed.

--bootloader=string

Manually specify the bootloader to use. By default, boottool will automatically try to detect the bootloader being used.

--config_file=string

Specifies the path and name of the bootloader config file, overriding autodetection of this file.

INFORMATIONAL OPERATIONS

These operations return information about the system, without making alterations to any files.

--bootloader-probe

Prints the bootloader in use on the system and exits.

--arch-probe

Prints the arch of the system and exits.

--info=string

Display information about the bootloader entry at the given position number. Also accepts 'all' or 'default'.

--default

Prints the current default kernel for the bootloader.

KERNEL OPERATIONS

These operations result in modifications to system configuration files. Only one of these operations may be called. See KERNEL MODIFICATION PARAMETERS (below) for specifying what the operations should do.

--add-kernel=string

Adds a new kernel with the given path.

--update-kernel=string

Updates an existing kernel with the given position number or title. Used with --args or --remove-args.

--module=string

This option adds modules to the new kernel. It only works with Grub Bootloader. For more module options just add another --module parameter

--remove-kernel=string

Removes the bootloader entry with the given position or title. Also accepts 'start' or 'end'.

--set-default=integer

Updates the bootloader to set the default boot entry to given given position or title.

--boot-once

Causes the bootloader to boot the kernel specified by --title just one time, then fall back to the default. This option doesn't work identically on all architectures.

KERNEL MODIFICATION PARAMETERS

These parameters can be used with the kernel operations listed above, to specify how the operations should work.

--title=string

The title or label to use for the bootloader entry.

--args=string

Arguments to be passed to the kernel at boot.

--remove-args=string

Arguments to be removed from an existing entry. Used with --update-kernel.

--initrd=string

The initrd image path to use in the bootloader entry.

--root=string

The device where the root partition is located.

--savedefault=string

The number to use in the savedefault section

--position=string

Insert bootloader entry at the given position number, counting from 0. Also accepts 'start' or 'end'. This is only useful when using the --add-kernel operation.

--make-default

Specifies that the bootloader entry being added should be set to the default.

--install

Causes bootloader to update and re-install the bootloader file.

OTHER OPTIONS

-V, --version

Prints the version and exits.

-h, --help

Prints a brief help message with option summary.

--man

Prints a manual page (detailed help). Same as `perdoc tgen`

-D, --debug N

Prints debug messages. This expects a numerical argument corresponding to the debug message verbosity.

PREREQUISITES

Linux::Bootloader

Getopt::Long

Pod::Usage

COREQUISITES

boottool works with any bootloader supported by Linux::Bootloader, including the following:

Lilo

Grub

Yaboot

Elilo

Obviously, at least one bootloader must be installed for this to be of any use. ;-)

BUGS

Send bug reports to http://sourceforge.net/projects/crucible/

VERSION

1.0

SEE ALSO

crucible, WWW::PkgFind, Test::Parser, Linux::Distribution

AUTHOR

Jason N.

http://www.osdl.org/

COPYRIGHT

Copyright (C) 2006 Open Source Development Labs All Rights Reserved.

This script is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

REVISION

Revision: $Revision: 1.10 $