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.
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 $