Lines Matching full:command
28 command from a
114 * Interface:: The menu and the command-line
120 * Invoking grub-terminfo:: How to generate a terminfo command
167 When booting with GRUB, you can use either a command-line interface
168 (@pxref{Command-line interface}), or a menu interface (@pxref{Menu
169 interface}). Using the command-line interface, you type the drive
174 command-line mode, and vice-versa. You can even edit menu entries
183 @command{grub} (@pxref{Invoking the grub shell}) which can be run when
262 command-line. An example configuration file is provided in
270 @item Have a flexible command-line interface
271 A fairly flexible command-line interface, accessible from the menu,
272 is available to edit any preset commands, or write a new boot command
274 the command-line.
278 command-line (@pxref{Command Line Editing, Bash, Command Line Editing,
290 Can decompress files which were compressed by @command{gzip}. This
299 compressed state, so a different module-loading command can be specified
426 need to use the device specification in a command, like @samp{root
428 specifies a partition you want, the GRUB command-line
429 (@pxref{Command-line interface}) options have argument
472 using the utility @command{grub-install} (@pxref{Invoking
485 @command{grub-set-default} (@pxref{Invoking grub-set-default}) if you
549 Once started, GRUB will show the command-line interface
550 (@pxref{Command-line interface}). First, set the GRUB's @dfn{root
553 your OS, add the argument into the command @command{kernel}.} to the
561 command @command{find} (@pxref{find}), like this:
570 Once you've set the root device correctly, run the command
571 @command{setup} (@pxref{setup}):
577 This command will install the GRUB boot loader on the Master Boot
590 After using the setup command, you will boot into GRUB without the
608 as @sc{gnu}), invoke the program @command{grub-install} (@pxref{Invoking
657 @command{grub-install} like this:
664 correctly under a UNIX-like OS. Thus, @command{grub-install} will prompt
670 Note that @command{grub-install} is actually just a shell script and the
671 real task is done by the grub shell @command{grub} (@pxref{Invoking the
672 grub shell}). Therefore, you may run @command{grub} directly to install
673 GRUB, without using @command{grub-install}. Don't do that, however,
783 the command @command{root} (@pxref{root}).
786 Load the kernel image with the command @command{kernel} (@pxref{kernel}).
789 If you need modules, load them with the command @command{module}
790 (@pxref{module}) or @command{modulenounzip} (@pxref{modulenounzip}).
793 Run the command @command{boot} (@pxref{boot}).
797 manner. You load a kernel image with the command @command{kernel} and
798 then run the command @command{boot}. If the kernel requires some
799 parameters, just append the parameters to @command{kernel}, after the
814 Set GRUB's root device to the partition by the command
815 @command{rootnoverify} (@pxref{rootnoverify}):
822 Set the @dfn{active} flag in the partition using the command
823 @command{makeactive}@footnote{This is not necessary for most of the
831 Load the boot loader with the command @command{chainloader}
843 Run the command @command{boot} (@pxref{boot}).
878 command @code{find /boot/gnumach} or similar can help you
892 Run the command @command{boot} (@pxref{boot}).
905 command @code{find /vmlinuz} or similar can help you (@pxref{find}).
915 command. For example, to set @option{vga} to @samp{ext}, do this:
925 If you use an initrd, execute the command @command{initrd}
926 (@pxref{initrd}) after @command{kernel}:
933 Finally, run the command @command{boot} (@pxref{boot}).
939 the size, run the command @command{uppermem} @emph{before} loading the
970 Set GRUB's root device with @command{root} (@pxref{root}).
973 Load the kernel with @command{kernel} (@pxref{kernel}). You should
982 Run @command{boot} (@pxref{boot}).
1008 command @command{map} (@pxref{map}), like this:
1054 @command{chainloader} (@pxref{chainloader}), like this:
1158 time. For this, execute @command{grub-set-default} (@pxref{Invoking
1165 This command sets the saved entry to @samp{1}, that is, to the new
1221 entry, because the command @command{fallback} specifies that @samp{1}
1226 next boot entry, because @command{fallback} specifies @samp{2} as next
1236 However, you need to run @command{grub-set-default} (@pxref{Invoking
1239 entry. You should run this command in a startup script such as
1252 @command{cat} this file. But it is strongly recommended @strong{not to
1255 manner. Therefore, you should use @command{grub-set-default} when you
1273 commands}) before any of the items (starting with @command{title}
1322 begins with a special command, @command{title} (@pxref{title}), and the
1323 action is described after it. Note that there is no command
1324 @command{boot} (@pxref{boot}) at the end of each item. That is because
1325 GRUB automatically executes @command{boot} if it loads other commands
1328 The argument for the command @command{title} is used to display a short
1329 title/description of the entry in the menu. Since @command{title}
1366 hd0s3. It also contains a @command{pause} line (@pxref{pause}), which
1428 In the last entry, the command @command{color} is used (@pxref{color}),
1429 to change the menu colors (try it!). This command is somewhat special,
1430 because it can be used both in the command-line and in the menu. GRUB
1464 server and run @command{bootp} (@pxref{bootp}), @command{dhcp}
1465 (@pxref{dhcp}) or @command{rarp} (@pxref{rarp}) for BOOTP, DHCP or RARP,
1466 respectively. Each command will show an assigned IP address, a netmask,
1471 Otherwise, run @command{ifconfig}, like this:
1477 You can also use @command{ifconfig} in conjuction with @command{bootp},
1478 @command{dhcp} or @command{rarp} (e.g. to reassign the server address
1587 The command @command{serial} initializes the serial unit 0 with the
1590 command accepts many other options, so please refer to @ref{serial},
1593 The command @command{terminal} (@pxref{terminal}) chooses which type of
1595 serial terminal, but you can also pass @code{console} to the command,
1602 the command if your terminal emulator is not VT100-compatible or
1616 is good to run the commands @command{serial} (@pxref{serial}) and
1617 @command{terminal} (@pxref{terminal}) before anything else at the
1649 preset menu to execute the command @command{bootp} (@pxref{bootp})
1680 read @file{/etc/passwd} in the command-line interface by the command
1681 @command{cat} (@pxref{cat}). So it is necessary to disable all the
1686 entering the command-line interface). To use this feature, you need to
1687 run the command @command{password} in your configuration file
1699 You can encrypt your password with the command @command{md5crypt}
1713 Also, you can specify an optional argument to @command{password}. See
1728 GRUB provides the command @command{lock} (@pxref{lock}). This command
1742 You should insert @command{lock} right after @command{title}, because
1744 @command{lock}.
1746 You can also use the command @command{password} instead of
1747 @command{lock}. In this case the boot process will ask for the password
1748 and stop if it was entered incorrectly. Since the @command{password}
1823 you see the files in a device or use the command @command{find}
1892 say, @samp{(hd1,0)} by the command @command{root} (@pxref{root}), then
1922 configuration file, and a highly flexible command-line for performing
1927 entries were found in the file. If you choose the @dfn{command-line} menu
1929 the command-line interface.
1932 * Command-line interface:: The flexible command-line interface
1939 @node Command-line interface
1940 @section The flexible command-line interface
1942 The command-line interface provides a prompt and after it an editable
1943 text area much like a command-line in Unix or DOS. Each command is
1946 way.}. The commands (@pxref{Command-line and menu entry commands}) are a
1997 the first word in the command-line, pressing the @key{TAB} key (or
2002 parenthesis, as @command{root (}.
2021 Commands are available to enter a bare command-line by pressing @key{c}
2042 special version of the GRUB command-line to edit that line. When the
2060 interface explicitly with the command @command{hiddenmenu}
2066 back to the command-line interface (@pxref{Command-line interface}).
2076 of them can be entered on the command-line and can be used either
2082 * Command-line and menu entry commands::
2132 @deffn Command default num
2134 from 0, and the entry number 0 is the default if the command is not
2138 default entry is the entry saved with the command
2139 @command{savedefault}. @xref{savedefault}, for more information.
2146 @deffn Command fallback num...
2150 command (@pxref{default})). This obviously won't help if the machine was
2159 @deffn Command hiddenmenu
2160 Don't display the menu. If the command is used, no menu will be
2171 @deffn Command timeout sec
2180 @deffn Command title name @dots{}
2189 Commands usable anywhere in the menu and in the command-line.
2215 @deffn Command bootp [@option{--with-configfile}]
2216 Initialize a network device via the @dfn{BOOTP} protocol. This command
2220 If you specify @option{--with-configfile} to this command, GRUB will
2229 @deffn Command color normal [highlight]
2295 This command can be used in the configuration file and on the command
2314 @deffn Command device drive file
2316 @sc{bios} drive @var{drive}. You can use this command to create a disk
2327 This command can be used only in the grub shell (@pxref{Invoking the
2335 @deffn Command dhcp [--with-configfile]
2337 this command is just an alias for @command{bootp}, since the two
2338 protocols are very similar. This command is only available if GRUB is
2341 If you specify @option{--with-configfile} to this command, GRUB will
2350 @deffn Command hide partition
2361 @deffn Command ifconfig [@option{--server=server}] [@option{--gateway=gateway}] [@option{--mask=mas…
2365 not important. This command shows current network configuration, if no
2373 @deffn Command pager [flag]
2383 @deffn Command partnew part type from len
2394 @deffn Command parttype part type
2404 @deffn Command password [@option{--md5}] passwd [new-config-file]
2406 editing control (menu entry editor and command-line) and entries
2407 protected by the command @command{lock}. If the password @var{passwd} is
2411 You can also use this command in the script section, in which case it
2414 @command{md5crypt} (@pxref{md5crypt}).
2421 @deffn Command rarp
2422 Initialize a network device via the @dfn{RARP} protocol. This command
2431 @deffn Command serial [@option{--unit=unit}] [@option{--port=port}] [@option{--speed=speed}] [@opti…
2446 @command{terminal} command is used (@pxref{terminal}).
2448 This command is only available if GRUB is compiled with serial
2456 @deffn Command setkey [to_key from_key]
2459 this command @emph{does not} exchange the keys. If you want to exchange
2460 the keys, run this command again with the arguments exchanged, like this:
2587 @deffn Command terminal [@option{--dumb}] [@option{--no-echo}] [@option{--no-edit}] [@option{--time…
2593 reported. This command is only available if GRUB is compiled with serial
2619 @deffn Command terminfo @option{--name=name} @option{--cursor-address=seq} [@option{--clear-screen=…
2620 Define the capabilities of your terminal. Use this command to define
2624 You can use the utility @command{grub-terminfo} to generate
2625 appropriate arguments to this command. @xref{Invoking grub-terminfo}.
2634 @deffn Command tftpserver ipaddr
2635 @strong{Caution:} This command exists only for backward
2636 compatibility. Use @command{ifconfig} (@pxref{ifconfig}) instead.
2640 @samp{192.168.0.15}. This command is only available if GRUB is compiled
2648 @deffn Command unhide partition
2656 @node Command-line and menu entry commands
2657 @section The list of command-line and menu entry commands
2659 These commands are usable in the command-line and in menu entries. If
2660 you forget a command, you can run the command @command{help}
2708 @deffn Command blocklist file
2717 @deffn Command boot
2719 running the fully interactive command-line (it is implicit at the end of
2727 @deffn Command cat file
2728 Display the contents of the file @var{file}. This command may be useful
2740 @deffn Command chainloader [@option{--force}] file
2753 @deffn Command cmp file1 file2
2775 @deffn Command configfile file
2783 @deffn Command debug
2793 @deffn Command displayapm
2801 @deffn Command displaymem
2816 @deffn Command embed stage1_5 device
2823 Usually, you don't need to run this command directly. @xref{setup}.
2830 @deffn Command find filename
2841 @deffn Command fstest
2849 Filesystem test mode is turned off by any use of the @command{install}
2850 (@pxref{install}) or @command{testload} (@pxref{testload}) commands.
2857 @deffn Command geometry drive [cylinder head sector [total_sector]]
2870 @deffn Command halt @option{--no-apm}
2871 The command halts the computer. If the @option{--no-apm} option
2880 @deffn Command help @option{--all} [pattern @dots{}]
2882 specify @var{pattern}, this command shows short descriptions of most of
2884 command, short descriptions of rarely used commands (such as
2895 @deffn Command impsprobe
2898 command can be used only in the Stage 2, but not in the grub shell.
2905 @deffn Command initrd file @dots{}
2915 @deffn Command install [@option{--force-lba}] [@option{--stage2=os_stage2_file}] stage1_file [@opti…
2916 This command is fairly complex, and you should not use this command
2917 unless you are familiar with GRUB. Use @command{setup} (@pxref{setup})
2941 command preserves the DOS BPB (and for hard disks, the partition table)
2972 @deffn Command ioprobe drive
2973 Probe I/O ports used for the drive @var{drive}. This command will list
2982 @deffn Command kernel [@option{--type=type}] [@option{--no-mem-option}] file @dots{}
2986 command-line}. Any modules must be reloaded after using this command.
2988 This command also accepts the option @option{--type} so that you can
3005 @deffn Command lock
3007 the command @command{password} if you really want this command to be
3010 This command is used in a menu, as shown in this example:
3028 @deffn Command makeactive
3030 This command is limited to @emph{primary} PC partitions on a hard disk.
3037 @deffn Command map to_drive from_drive
3057 @deffn Command md5crypt
3059 password can be used with the command @command{password}
3067 @deffn Command module file @dots{}
3070 command must know what the kernel in question expects). The rest of the
3071 line is passed as the @dfn{module command-line}, like the
3072 @command{kernel} command. You must load a Multiboot kernel image before
3080 @deffn Command modulenounzip file @dots{}
3081 The same as @command{module} (@pxref{module}), except that automatic
3089 @deffn Command pause message @dots{}
3100 @deffn Command quit
3101 Exit from the grub shell @command{grub} (@pxref{Invoking the grub
3102 shell}). This command can be used only in the grub shell.
3109 @deffn Command reboot
3117 @deffn Command read addr
3126 @deffn Command root device [hdbias]
3145 @deffn Command rootnoverify device [hdbias]
3146 Similar to @command{root} (@pxref{root}), but don't attempt to mount the
3149 desired. Note that the items mentioned in @command{root} above which
3157 @deffn Command savedefault num
3193 @deffn Command setup [@option{--force-lba}] [@option{--stage2=os_stage2_file}] [@option{--prefix=di…
3194 Set up the installation of GRUB automatically. This command uses the
3195 more flexible command @command{install} (@pxref{install}) in the backend
3199 current @dfn{root device}, which can be set by the command
3200 @command{root}. If @var{install_device} is a hard disk, then embed a
3208 to @command{install} if specified. @xref{install}, for more
3216 @deffn Command testload file
3230 @deffn Command testvbe mode
3231 Test the VESA BIOS EXTENSION mode @var{mode}. This command will switch
3240 @deffn Command uppermem kbytes
3254 @deffn Command vbeprobe [mode]
3257 command lists up available VBE modes on the screen. See also
3355 This error is returned if the install command points to incompatible
3418 This error is returned if the initrd command is used before loading a
3422 This error is returned if the module load command is used before loading
3454 @item 27 : Unrecognized command
3455 This error is returned if an unrecognized command is entered on the
3456 command-line or in a boot sequence section of a configuration file and
3460 This error is returned if a kernel, module, or raw file load command is
3467 install of set active partition command.
3470 This error is returned if an argument specified to a command is invalid.
3474 block-lists (e.g. the command @command{install}). In this case, you
3496 This chapter documents the grub shell @command{grub}. Note that the grub
3505 * Installation under UNIX:: How to install GRUB via @command{grub}
3513 You can use the command @command{grub} for installing GRUB under your
3515 or when fixing a bug. @command{grub} is almost the same as the Stage 2,
3517 the same commands (@pxref{Commands}) in @command{grub}. It is emulated by
3520 The command @command{grub} accepts the following options:
3524 Print a summary of the command-line options and exit.
3579 @section How to install GRUB via @command{grub}
3582 2. @xref{Installation}, for more information. The command
3583 @command{grub}-specific information is described here.
3585 What you should be careful about is @dfn{buffer cache}. @command{grub}
3593 unmount them before running @command{grub}.
3601 activity is being done on it while the command @command{grub} is
3610 In addition, enter the command @command{quit} when you finish the
3611 installation. That is @emph{very important} because @command{quit} makes
3615 option in the command-line. This is a simple example:
3662 The program @command{grub-install} installs GRUB on your drive using the
3673 @command{grub-install} accepts the following options:
3677 Print a summary of the command-line options and exit.
3716 The program @command{grub-md5-crypt} encrypts a password in MD5 format.
3719 command @command{password} (@pxref{password}).
3721 @command{grub-md5-crypt} accepts the following options:
3725 Print a summary of the command-line options and exit.
3738 The program @command{grub-terminfo} generates a terminfo command from
3744 @command{grub-terminfo} accepts the following options:
3748 Print a summary of the command-line options and exit.
3754 You must specify one argument to this command. For example:
3764 The program @command{grub-set-default} sets the default boot entry for
3773 @command{grub-set-default} accepts the following options:
3777 Print a summary of the command-line options and exit.
3788 You must specify a single argument to @command{grub-set-default}. This
3808 may execute this command:
3826 The program @command{mbchk} checks for the format of a Multiboot
3830 @command{mbchk} accepts the following options:
3834 Print a summary of the command-line options and exit.