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
1584 The command @command{serial} initializes the serial unit 0 with the
1587 command accepts many other options, so please refer to @ref{serial},
1590 The command @command{terminal} (@pxref{terminal}) chooses which type of
1592 serial terminal, but you can also pass @code{console} to the command,
1599 the command if your terminal emulator is not VT100-compatible or
1613 is good to run the commands @command{serial} (@pxref{serial}) and
1614 @command{terminal} (@pxref{terminal}) before anything else at the
1646 preset menu to execute the command @command{bootp} (@pxref{bootp})
1677 read @file{/etc/passwd} in the command-line interface by the command
1678 @command{cat} (@pxref{cat}). So it is necessary to disable all the
1683 entering the command-line interface). To use this feature, you need to
1684 run the command @command{password} in your configuration file
1696 You can encrypt your password with the command @command{md5crypt}
1710 Also, you can specify an optional argument to @command{password}. See
1725 GRUB provides the command @command{lock} (@pxref{lock}). This command
1739 You should insert @command{lock} right after @command{title}, because
1741 @command{lock}.
1743 You can also use the command @command{password} instead of
1744 @command{lock}. In this case the boot process will ask for the password
1745 and stop if it was entered incorrectly. Since the @command{password}
1820 you see the files in a device or use the command @command{find}
1889 say, @samp{(hd1,0)} by the command @command{root} (@pxref{root}), then
1919 configuration file, and a highly flexible command-line for performing
1924 entries were found in the file. If you choose the @dfn{command-line} menu
1926 the command-line interface.
1929 * Command-line interface:: The flexible command-line interface
1936 @node Command-line interface
1937 @section The flexible command-line interface
1939 The command-line interface provides a prompt and after it an editable
1940 text area much like a command-line in Unix or DOS. Each command is
1943 way.}. The commands (@pxref{Command-line and menu entry commands}) are a
1994 the first word in the command-line, pressing the @key{TAB} key (or
1999 parenthesis, as @command{root (}.
2018 Commands are available to enter a bare command-line by pressing @key{c}
2039 special version of the GRUB command-line to edit that line. When the
2057 interface explicitly with the command @command{hiddenmenu}
2063 back to the command-line interface (@pxref{Command-line interface}).
2073 of them can be entered on the command-line and can be used either
2079 * Command-line and menu entry commands::
2129 @deffn Command default num
2131 from 0, and the entry number 0 is the default if the command is not
2135 default entry is the entry saved with the command
2136 @command{savedefault}. @xref{savedefault}, for more information.
2143 @deffn Command fallback num...
2147 command (@pxref{default})). This obviously won't help if the machine was
2156 @deffn Command hiddenmenu
2157 Don't display the menu. If the command is used, no menu will be
2168 @deffn Command timeout sec
2177 @deffn Command title name @dots{}
2186 Commands usable anywhere in the menu and in the command-line.
2212 @deffn Command bootp [@option{--with-configfile}]
2213 Initialize a network device via the @dfn{BOOTP} protocol. This command
2217 If you specify @option{--with-configfile} to this command, GRUB will
2226 @deffn Command color normal [highlight]
2292 This command can be used in the configuration file and on the command
2311 @deffn Command device drive file
2313 @sc{bios} drive @var{drive}. You can use this command to create a disk
2324 This command can be used only in the grub shell (@pxref{Invoking the
2332 @deffn Command dhcp [--with-configfile]
2334 this command is just an alias for @command{bootp}, since the two
2335 protocols are very similar. This command is only available if GRUB is
2338 If you specify @option{--with-configfile} to this command, GRUB will
2347 @deffn Command hide partition
2358 @deffn Command ifconfig [@option{--server=server}] [@option{--gateway=gateway}] [@option{--mask=mask}] [@option{--address=address}]
2362 not important. This command shows current network configuration, if no
2370 @deffn Command pager [flag]
2380 @deffn Command partnew part type from len
2391 @deffn Command parttype part type
2401 @deffn Command password [@option{--md5}] passwd [new-config-file]
2403 editing control (menu entry editor and command-line) and entries
2404 protected by the command @command{lock}. If the password @var{passwd} is
2408 You can also use this command in the script section, in which case it
2411 @command{md5crypt} (@pxref{md5crypt}).
2418 @deffn Command rarp
2419 Initialize a network device via the @dfn{RARP} protocol. This command
2428 @deffn Command serial [@option{--unit=unit}] [@option{--port=port}] [@option{--speed=speed}] [@option{--word=word}] [@option{--parity=parity}] [@option{--stop=stop}] [@option{--device=dev}]
2443 @command{terminal} command is used (@pxref{terminal}).
2445 This command is only available if GRUB is compiled with serial
2453 @deffn Command setkey [to_key from_key]
2456 this command @emph{does not} exchange the keys. If you want to exchange
2457 the keys, run this command again with the arguments exchanged, like this:
2584 @deffn Command terminal [@option{--dumb}] [@option{--no-echo}] [@option{--no-edit}] [@option{--timeout=secs}] [@option{--lines=lines}] [@option{--silent}] [@option{console}] [@option{serial}] [@option{hercules}]
2590 reported. This command is only available if GRUB is compiled with serial
2616 @deffn Command terminfo @option{--name=name} @option{--cursor-address=seq} [@option{--clear-screen=seq}] [@option{--enter-standout-mode=seq}] [@option{--exit-standout-mode=seq}]
2617 Define the capabilities of your terminal. Use this command to define
2621 You can use the utility @command{grub-terminfo} to generate
2622 appropriate arguments to this command. @xref{Invoking grub-terminfo}.
2631 @deffn Command tftpserver ipaddr
2632 @strong{Caution:} This command exists only for backward
2633 compatibility. Use @command{ifconfig} (@pxref{ifconfig}) instead.
2637 @samp{192.168.0.15}. This command is only available if GRUB is compiled
2645 @deffn Command unhide partition
2653 @node Command-line and menu entry commands
2654 @section The list of command-line and menu entry commands
2656 These commands are usable in the command-line and in menu entries. If
2657 you forget a command, you can run the command @command{help}
2705 @deffn Command blocklist file
2714 @deffn Command boot
2716 running the fully interactive command-line (it is implicit at the end of
2724 @deffn Command cat file
2725 Display the contents of the file @var{file}. This command may be useful
2737 @deffn Command chainloader [@option{--force}] file
2750 @deffn Command cmp file1 file2
2772 @deffn Command configfile file
2780 @deffn Command debug
2790 @deffn Command displayapm
2798 @deffn Command displaymem
2813 @deffn Command embed stage1_5 device
2820 Usually, you don't need to run this command directly. @xref{setup}.
2827 @deffn Command find filename
2838 @deffn Command fstest
2846 Filesystem test mode is turned off by any use of the @command{install}
2847 (@pxref{install}) or @command{testload} (@pxref{testload}) commands.
2854 @deffn Command geometry drive [cylinder head sector [total_sector]]
2867 @deffn Command halt @option{--no-apm}
2868 The command halts the computer. If the @option{--no-apm} option
2877 @deffn Command help @option{--all} [pattern @dots{}]
2879 specify @var{pattern}, this command shows short descriptions of most of
2881 command, short descriptions of rarely used commands (such as
2892 @deffn Command impsprobe
2895 command can be used only in the Stage 2, but not in the grub shell.
2902 @deffn Command initrd file @dots{}
2912 @deffn Command install [@option{--force-lba}] [@option{--stage2=os_stage2_file}] stage1_file [@option{d}] dest_dev stage2_file [addr] [@option{p}] [config_file] [real_config_file]
2913 This command is fairly complex, and you should not use this command
2914 unless you are familiar with GRUB. Use @command{setup} (@pxref{setup})
2938 command preserves the DOS BPB (and for hard disks, the partition table)
2969 @deffn Command ioprobe drive
2970 Probe I/O ports used for the drive @var{drive}. This command will list
2979 @deffn Command kernel [@option{--type=type}] [@option{--no-mem-option}] file @dots{}
2983 command-line}. Any modules must be reloaded after using this command.
2985 This command also accepts the option @option{--type} so that you can
3002 @deffn Command lock
3004 the command @command{password} if you really want this command to be
3007 This command is used in a menu, as shown in this example:
3025 @deffn Command makeactive
3027 This command is limited to @emph{primary} PC partitions on a hard disk.
3034 @deffn Command map to_drive from_drive
3054 @deffn Command md5crypt
3056 password can be used with the command @command{password}
3064 @deffn Command module file @dots{}
3067 command must know what the kernel in question expects). The rest of the
3068 line is passed as the @dfn{module command-line}, like the
3069 @command{kernel} command. You must load a Multiboot kernel image before
3077 @deffn Command modulenounzip file @dots{}
3078 The same as @command{module} (@pxref{module}), except that automatic
3086 @deffn Command pause message @dots{}
3097 @deffn Command quit
3098 Exit from the grub shell @command{grub} (@pxref{Invoking the grub
3099 shell}). This command can be used only in the grub shell.
3106 @deffn Command reboot
3114 @deffn Command read addr
3123 @deffn Command root device [hdbias]
3142 @deffn Command rootnoverify device [hdbias]
3143 Similar to @command{root} (@pxref{root}), but don't attempt to mount the
3146 desired. Note that the items mentioned in @command{root} above which
3154 @deffn Command savedefault num
3190 @deffn Command setup [@option{--force-lba}] [@option{--stage2=os_stage2_file}] [@option{--prefix=dir}] install_device [image_device]
3191 Set up the installation of GRUB automatically. This command uses the
3192 more flexible command @command{install} (@pxref{install}) in the backend
3196 current @dfn{root device}, which can be set by the command
3197 @command{root}. If @var{install_device} is a hard disk, then embed a
3205 to @command{install} if specified. @xref{install}, for more
3213 @deffn Command testload file
3227 @deffn Command testvbe mode
3228 Test the VESA BIOS EXTENSION mode @var{mode}. This command will switch
3237 @deffn Command uppermem kbytes
3251 @deffn Command vbeprobe [mode]
3254 command lists up available VBE modes on the screen. See also
3352 This error is returned if the install command points to incompatible
3415 This error is returned if the initrd command is used before loading a
3419 This error is returned if the module load command is used before loading
3451 @item 27 : Unrecognized command
3452 This error is returned if an unrecognized command is entered on the
3453 command-line or in a boot sequence section of a configuration file and
3457 This error is returned if a kernel, module, or raw file load command is
3464 install of set active partition command.
3467 This error is returned if an argument specified to a command is invalid.
3471 block-lists (e.g. the command @command{install}). In this case, you
3493 This chapter documents the grub shell @command{grub}. Note that the grub
3502 * Installation under UNIX:: How to install GRUB via @command{grub}
3510 You can use the command @command{grub} for installing GRUB under your
3512 or when fixing a bug. @command{grub} is almost the same as the Stage 2,
3514 the same commands (@pxref{Commands}) in @command{grub}. It is emulated by
3517 The command @command{grub} accepts the following options:
3521 Print a summary of the command-line options and exit.
3576 @section How to install GRUB via @command{grub}
3579 2. @xref{Installation}, for more information. The command
3580 @command{grub}-specific information is described here.
3582 What you should be careful about is @dfn{buffer cache}. @command{grub}
3590 unmount them before running @command{grub}.
3598 activity is being done on it while the command @command{grub} is
3607 In addition, enter the command @command{quit} when you finish the
3608 installation. That is @emph{very important} because @command{quit} makes
3612 option in the command-line. This is a simple example:
3659 The program @command{grub-install} installs GRUB on your drive using the
3670 @command{grub-install} accepts the following options:
3674 Print a summary of the command-line options and exit.
3713 The program @command{grub-md5-crypt} encrypts a password in MD5 format.
3716 command @command{password} (@pxref{password}).
3718 @command{grub-md5-crypt} accepts the following options:
3722 Print a summary of the command-line options and exit.
3735 The program @command{grub-terminfo} generates a terminfo command from
3741 @command{grub-terminfo} accepts the following options:
3745 Print a summary of the command-line options and exit.
3751 You must specify one argument to this command. For example:
3761 The program @command{grub-set-default} sets the default boot entry for
3770 @command{grub-set-default} accepts the following options:
3774 Print a summary of the command-line options and exit.
3785 You must specify a single argument to @command{grub-set-default}. This
3805 may execute this command:
3823 The program @command{mbchk} checks for the format of a Multiboot
3827 @command{mbchk} accepts the following options:
3831 Print a summary of the command-line options and exit.
