APPENDIX - Commands
Use caution when following the built in help information - it is based on GNU GRUB and contains some legacy commands (and information) that do not always apply to Grub4dos. The following example is the output from typing help default -
grub> help default
default: default [NUM 'saved' FILE]
set the default entry to entry number NUM (if not specified, it is 0,
the first entry), or to the entry number saved by savedefault if the
key word 'saved' is specified, or to the entry number previously saved
in the specified file FILE. When FILE is specified, all subsequent
'savedefault' commands will save default entry numbers into FILE.
Although the default [NUM] parameter works within a configuration file, using default saved does not. In addition the default [FILE] command only works with the default file included in the grub4dos download - e.g. default /default.
The following (61) commands are all recognised by Grub4dos - version 0.4.3 (build 2008-03-14)
background
grub> help background
background: background RRGGBB
Sets the background color when in graphics mode. RR is red, GG is green,
and BB blue. Numbers must be in hexadecimal.
blocklist
grub> help blocklist
blocklist: blocklist FILE
Print the blocklist notation of the file FILE.
boot
grub> help boot
boot: boot
Boot the OS/chain-loader which has been loaded.
cat
grub> help cat
cat: cat [--hex] [--skip=S] [--length=L] [--locate=STRING] FILE
Print the contents of the file FILE, or print the locations of the
string STRING in file.
cdrom
grub> help cdrom
cdrom: cdrom --add-io-ports=P --init --stop
Initialise/stop atapi cdroms or set additional I/O ports for a possible
atapi cdrom device. The high word of P specifies the base register of
the control block registers, and the low word of P specifies the base
register of the command block registers.
chainloader
grub> help chainloader
chainloader: chainloader [--force] [--load-segment=LS] [--load offset=LO]
[--load-length=LL] [--skip-length=SL] [--boot-cs=CS] [--boot-ip=IP]
[--ebx=EBX] [--edx=EDX] [--sdi] [--disable-a20] FILE
Load the chain-loader FILE. If --force is specified, then load it
forcibly, whether the boot loader signature is present or not. LS:LO
specifies the load address other than 0000:7C00. LL specifies the
length of the boot image(between 512 and 640k). CS:IP specifies the
address where the boot image will gain control. EBX/EDX specifies the
EBX/EDX register value when the boot image gets control. Use --sdi if
FILE is a System Deployment Image, which is of the Windows XP RAM boot
file format. Use --disable-a20 if you wish to turn off A20 when
transferring control to the boot image. SL specifies length in bytes at
the beginning of the image to be skipped when loading.
clear
grub> help clear
clear: clear
Clear the screen
cmp
grub> help cmp
cmp: cmp FILE1 FILE2
Compare the file FILE1 with the file FILE2 and inform the different values
if any.
color
grub> help color
color: color NORMAL [HIGHLIGHT]
Change the menu colors. The color NORMAL is used for most lines in the
menu, and the color HIGHLIGHT is used to highlight the line where the
cursor points. If you omit HIGHLIGHT, then the inverted color of NORMAL
is used for the highlighted line. The format of a color is "FG/BG". FG
and BG are symbolic color names. A symbolic color name must be one of
these: black, blue, green, cyan, red, magenta, brown, light-grey,
dark-grey, light-blue, light-green, light-cyan, light-red,
light-magenta, yellow and white. But only the first eight names can be
used for BG. You can prefix "blink-" to FG if you want a blinking
foreground color.
commandline
grub> help commandline
commandline: commandline
Enter the command-line prompt mode.
configfile
grub> help configfile
configfile: configfile FILE
Load FILE as the configuration file.
debug
grub> help debug
debug: debug [on off normal status INTERGER]
Turn on/off or display/set the debug level.
default
grub> help default
default: default [NUM 'saved' FILE]
set the default entry to entry number NUM (if not specified, it is 0,
the first entry), or to the entry number saved by savedefault if the
key word 'saved' is specified, or to the entry number previously saved
in the specified file FILE. When FILE is specified, all subsequent
'savedefault' commands will save default entry numbers into FILE.
displaymem
grub> help displaymem
displaymem: displaymem
Display what GRUB thinks the system address space map of the machine
is, including all regions of physical RAM installed.
embed
grub> help embed
embed: embed STAGE1_5 DEVICE
Embed the Stage 1.5 STAGE1_5 in the sectors after MBR if DEVICE is a
drive, or in the "bootloader" area if DEVICE is a FFS partition. Print
the number of sectors which STAGE1_5 occupies if successful.
errnum
grub> help errnum
errnum: errnum
Return the error number.
errorcheck
grub> help errorcheck
errorcheck: errorcheck [on off status]
Turn on/off or display the error check mode, or toggle it if no
argument.
fallback
grub> help fallback
fallback: fallback NUM...
Go into unattended boot mode: if the default boot entry has any errors,
instead of waiting for the user to do anything, it immediately starts
over using the NUM entry (same numbering as the 'default' command).
This obviously won't help if the machine was rebooted by a kernel that
GRUB loaded.
find
grub> help find
find: find [--set-root] [--ignore-floppies] FILENAME
Search for the filename FILENAME in all partitions and print the
list of the devices which contain the file. If the option --set-root is
used and FILENAME is found on a device, then stop the find immediately
and set the sevice as new root. If the option --ignore-floppies is
present, the search will bypass all floppies.
foreground
grub> help foreground
foreground: foreground RRGGBB
Sets the foreground color when in graphics mode. RR is red, GG is green,
and BB blue. Numbers must be in hexadecimal.
fstest
grub> help fstest
fstest: fstest [on off status]
Turn on/off or display the fstest mode, or toggle it if no argument.
geometry
grub> help geometry
geometry: geometry DRIVE [CYLINDER HEAD SECTOR [TOTAL_SECTOR]]
Print the information for a drive DRIVE. In the grub shell, you can set
the geometry of the drive arbitrarily. The number of the cylinders, the
one of the heads, the one of the sectors and the one of the total
sectors are set to CYLINDER, HEAD, SECTOR and TOTAL_SECTOR,
respectively. If you omit TOTAL_SECTOR, then it will be calculated
based on the C/H/S values automatically.
halt
grub> help halt
halt: halt [--no-apm]
Halt your system. If APM is available on it, turn off the power using
the APM BIOS, unless you specify the option '--no-apm'.
help
grub> help help
help: help [--all] [PATTERN...]
Display helpful information about builtin commands. Not all commands
aren't shown without the option '--all'.
hiddenflag
grub> help hiddenflag
hiddenflag: hiddenflag [--set --clear] [PARTITION]
Hide/unhide PARTITION by setting/clearing the "hidden" bit in its
partition type code, or report the hidden status. The default partition
is the current root device.
hide
grub> help hide
hide: hide [PARTITION]
Hide PARTITION by setting the "hidden" bit in its partition type code.
The default partition is the current root device.
initrd
grub> help initrd
initrd: initrd FILE [ARG...]
Load an initial ramdisk FILE for a Linux format boot image and set the
appropriate parameters in the Linux setup area in memory.
install
grub> help install
install: install [--stage2=STAGE2_FILE] [--force-lba] STAGE1 [d] DEVICE
STAGE2 [ADDR] [p] [CONFIG_FILE] [REAL_CONFIG_FILE]
Install STAGE1 on DEVICE and install a blocklist for loading STAGE2 as
a Stage 2. If the option 'd' is present, the Stage 1 will always look
for the disk where the STAGE2 was installed, rather than using the booting
drive. The Stage 2 will be loaded at address ADDR, which will be
determined automatically if you don't specify it. If the option 'p' or
CONFIG_FILE is present, then the first block of Stage 2 is patched with
new values of the partition and name of the configuration file used by
the true Stage 2 (for a Stage 1.5, this is the name of the true Stage
2) at boot time. If STAGE2 is a Stage 1.5 and REAL_CONFIG_FILE is
present, then the Stage 2 CONFIG_FILE is patched with the configuration
filename REAL_CONFIG_FILE. If the option '--force-lba' is specified,
disable some sanity checks for LBA mode. If the option '--stage2' is
specified, rewrite the Stage 2 via your OS's filesystem instead of the
raw device.
is64bit
grub> help is64bit
is64bit: is64bit
Return true if CPU is 64-bit and false if not.
kernel
grub> help kernel
kernel: kernel [--no-mem-option] [--type=TYPE] FILE [ARG...]
Attempt to load the primary boot image from FILE. The rest of the line
is passed verbatim as the "kernel command line". Any modules must be
reloaded after using this command. The option --type is used to suggest
what type of kernel to be loaded. TYPE must be either of "netbsd",
"freebsd", "openbsd", "linux", "biglinux" and "multiboot". The option
--no-mem-option tells GRUB not to pass a Linux's mem option
automatically.
lock
grub> help lock
lock: lock
Break a command execution unless the user is authenticated.
makeactive
grub> help makeactive
makeactive: makeactive [--status]
Set the active partition on the root disk to GRUB's root device. This
command is limited to _primary_ PC partitions on a hard disk.
map
grub> help map
map: map [--status] [--mem[=RESERV]] [--hook] [--unhook] [--rehook]
[--floppies=M] [harddrives=N] [--memdisk-raw=RAW] [--a20-keep-on=AKO]
[--safe-mbr-hook=SMH] [--int13-scheme=SCH] [--ram-drive=RD]
[--rd-base=ADDR] [--rd-size=SIZE] [[--read-only] [--fake-write]
[--unsafe-boot] [--disable-chs-mode] [--disable-lba-mode] [--heads=H]
[--sectors-per-track=S] TO_DRIVE FROM_DRIVE]
Map the drive FROM_DRIVE to the drive TO_DRIVE. This is necessary when
you chain-load some operating systems, such as DOS, if such an OS
resides at a non-first drive. TO_DRIVE can be a disk file, this
indicates a disk emulation. If TO_DRIVE is a disk file, it must be
contiguous(i.e., no holes in it). If --read-only is given, the emulated
drive will be write-protected. If --fake-write is given, any write
operations to the emulated drive are allowed but the data written will
be discarded. The --unsafe-boot switch enables the write to the Master
and DOS boot sectors of the emulated disk. If --disable-chs-mode is
given, CHS access to the emulated drive will be refused. If
--disable-lba-mode is given, LBA access to the emulated drive will be
refused. H and S specify the geometry of the emulated drive. M/N
specify the floppy/harddrive count in the BIOS data area. If RAW=1, all
memdrives will be accessed without using int15/ah=87h. If RAW=0, then
int15/ah=87h will be used to access memdrives. If one of --status,
--hook, --unhook, --rehook, --floppies, --harddrives, memdisk-raw,
--a20-keep-on, --safe-mbr-hook, --int13-scheme, --ram-drive, --rd-base
or --rd-size is given, then any other command-line arguments will be
ignored. They either report or change the int13 status, or change the
floppy or hard drive count byte in the BIOS data area. The --mem option
indicates a drive in memory. if RESERV is used and <= 0, the minimum
memory occupied by the memdrive is (-RESERV) in 512-byte-sectors. if
RESERV is used and > 0, the memdrive will occupy the mem area starting
at absolute physical address RESERV in 512-byte-sectors and ending at
the end of this mem block(usually the end of physical mem). RD
specifies the ramdisk number, and can be a BIOS drive number. ADDR
specifies the base address of the ramdisk image. SIZE specifies the
size in bytes of the ramdisk image.
md5crypt
grub> help md5crypt
md5crypt: md5crypt
Generate a password in MD5 format.
module
grub> help module
module: module FILE [ARG...]
Load a boot module FILE for a Multiboot format boot image (no
interpretation of the file contents is made, so users of this command
must know what the kernel in question expects). The rest of the line is
passed as the "module command line", like the 'kernel' command.
modulenounzip
grub> help modulenounzip
modulenounzip: modulenounzip FILE [ARG...]
The same as 'module', except that automatic decompression is disabled.
outline
grub> help outline
outline: outline [on off status]
Turn on/off or display the outline mode, or toggle it if no argument.
pager
grub> help pager
pager: pager [on off status]
Turn on/off or display the pager mode, or toggle it if no argument.
partnew
grub> help partnew
partnew: partnew [--active] PART TYPE START [LEN]
Create a primary partition at the starting address START with
the length LEN, with the type TYPE. START and LEN are in sector units. If
--active is used, the new partition will be active. START can be a
contiguous file that will be used as the content/data of the new
partition, in which case the LEN parameter is ignored, and TYPE can be
either 0x00 for auto or 0x10 for hidden-auto.
parttype
grub> help parttype
parttype: parttype [PART] [TYPE]
Change the type of the partition PART to TYPE. If TYPE is omitted,
return the partition type of the specified device(instead of changing
it). PART default to the current root device.
password
grub> help password
password: password [--md5] PASSWD [FILE]
If used in the first section of a menu file, disable all interactive
editing control (menu entry editor and command line). If the password
PASSWRD is entered, it loads the FILE as a new config file and restarts
the GRUB Stage 2. If you omit the argument FILE, then GRUB just unlocks
privileged instructions. You can also use it in the script section, in
which case it will ask for the password, before continueing. The option
--md5 tells GRUB that PASSWD is encrypted with md5crypt.
pause
grub> help pause
pause: pause [--wait=T] [MESSAGE...]
Print MESSAGE, then wait until a key is pressed or T seconds has passed.
pxe
grub> help pxe
pxe: pxe [cmd] [parameters]
Call PXE command.
quit
grub> help quit
quit: quit [--disable-a20]
Go back to DOS if GRUB was previously launched from DOS.
read
grub> help read
read: read ADDR
Read a 32-bit value from memory at address ADDR and display it in hex
format.
reboot
grub> help reboot
reboot: reboot
Reboot your system.
root
grub> help root
root: root [DEVICE [HDBIAS]]
Set the current "root device" to the device DEVICE, then attempt to
mount it to get the partition size (for passing the partition
descripter in 'ES:ESI', used by some chain-loaded bootloaders), the BSD
drive type (for booting BSD kernels using their native boot format),
and correctly determine the PC partition where a BSD sub-partition is
located. The optional HDBIAS parameter is a number to tell a BSD kernel
how many BIOS drive numbers are on controllers befor the current one.
For example, if there is an IDE disk and a SCSI disk, and your FreeBSD
root partition is on the SCSI disk, then use a '1' for HDBIAS.
rootnoverify
grub> help rootnoverify
rootnoverify: rootnoverify [DEVICE [HDBIAS]]
similar to 'root', but don't atttempt to mount the partition. This is
useful for when an OS is outside the area of the disk that GRUB can
read, but setting the correct root device is still desired. Note that
the itesm mentioned in 'root' which derived from attempting the mount
will NOT work correctly.
savedefault
grub> help savedefault
savedefault: savedefault[--wait=T] [NUM 'fallback']
Save the current entry as the default boot entry if no argument is
specified. If a number is specified, this number is saved. If
'fallback' is used, next fallback entry is saved. If T is not 0, prompt
the user to confirm the write operation by pressing the Y key, and if
no key-press detected within T seconds, the write will be discarded.
serial
grub> help serial
serial: serial [--unit=UNIT] [--port=PORT] [--speed=SPEED] [--word=WORD]
[parity=PARITY] [--stop=STOP] [--device=DEV]
Initialise a serial device. UNIT is a degit that specifies which serial
device is used (e.g. 0 == COM1). If you need to specify the port
number, set it by --port. SPEED is the DTE-DTE speed. WORD is the word
length, PARITY is the type of parity, which is one of 'no', 'odd' and
'even'. STOP is the length of stop bit(s). The option --device can be
used only in the GRUB shell, which specifies the file name of a tty
device. The default values are COM1, 9600, 8N1.
setkey
grub> help setkey
setkey: setkey [TO_KEY FROM_KEY]
Change the keyboard map. The key FROM_KEY is mapped to the key TO_KEY.
A key must be an alphabet, a digit, or one of these: escape, exclaim,
at, numbersign, dollar, percent, caret, ampersand, asterisk, parenleft,
parenright, minus, underscore, equal, plus, backspace, tab,
bracketleft, braceleft, bracketright, braceright, enter, control,
semicolon, colon, quote, doublequote, backquote, tilde, shift,
backslash, bar, comma, less, period, greater, slash, question, alt,
spcae, capslock, FX (X is a digit), and delete. If no argument is
specified, reset key mappings.
setup
grub> help setup
setup: setup [--prefix=DIR] [--stage2=STAGE2_FILE] [--force-lba]
INSTALL_DEVICE [IMAGE_DEVICE]
Set up the installation of GRUB automatically. This command used the
more flexible command "install" in the backend and installs GRUB into
the device INSTALL_DEVICE. If IMAGE_DEVICE is specified, then find the
GRUB images in the device IMAGE_DEVICE, otherwise use the current "root
device", which can be set by the command "root". If you know that your
BIOS should support LBA but GRUB doesn't work in LBA mode, specify the
option '--force-lba'. If you install GRUB under the grub shell and you
cannot unmount the partition where GRUB images reside, specify the
option '--stage2' to tell GRUB the file name under your OS.
setvbe
grub> help setvbe
setvbe: setvbe MODE_3D
Set the VBE mode MODE_3D(which is of the form 1024x768x32) for each
subsequent kernel command-line.
splashimage
grub> help splashimage
splashimage: splashimage FILE
Load FILE as the background image when in graphics mode.
terminal
grub> help terminal
terminal: terminal [--dumb] [--no-echo] [--no-edit] [--timeout=SECS]
[--lines=LINES] [--silent] [console] [serial] [hercules] [graphics]
Select a terminal. When multiple terminals are specified, wait until
you push any key to continue. If both console and serial are specified,
the terminal to which you input a key first will be selected. If no
argument is specified, print current setting. The option --dumb
specifies that your terminal is dumb, otherwise, vt100-compatibility is
assumed. If you specify --no-echo, input characters won't be echoed. If
you specify --no-edit, the BASH-like deiting feature will be disabled.
If --timeout is present, this command will wait at most for SECS
seconds. The option --lines specifies the maximum number of lines. The
option --silent is used to surpress messages.
terminfo
grub> help terminfo
terminfo: terminfo [--name=NAME --cursor-address=SEQ [--clear-screen=SEQ]
[--enter-standout-mode=SEQ] [--exit-standout-mode=SEQ]
Define the capabilities of your terminal. Use this command to define
escape sequences, if it is not vt100-compatible. You may use \e for ESC
and ^X for a control character. If no option is specified, the current
settings are printed.
testload
grub> help testload
testload: testload FILE
Read the entire contents of FILE in several different ways and campares
them, to thest the filesystem code. The output is somewhat cryptic, but
if no errors are reported and the final 'i=X, filepos=Y' reading had X
and Y equal, then it is definitely consistent, and very likely works
correctly subject to a consistent offset error. If this test succeeds,
then a good next step is to try loading a kernel.
testvbe
grub> help testvbe
testvbe: testvbe MODE
Test the VBE mode MODE. Hit any key to return.
unhide
grub> help unhide
unhide: unhide [PARTITION]
Unhide PARTITION by setting the "hidden" bit in its partition type
code. The default partition is the current root device.
vbeprobe
grub> help vbeprobe
vbeprobe: vbeprobe [MODE]
Probe VBE information. If the mode number MODE is specified, show only
the information about only the mode.
write
grub> help write
write: write ADDR VAL
Write a 32-bit value VAL to memory at address ADDR.
PREVIOUS INDEX NEXT
Сайт создан в системе
uCoz