1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
.TH GRUB-INSTALL "8" "February 2024" "GRUB 2.06" "System Administration Utilities"
.SH NAME
grub-install \- install GRUB to a device
.SH SYNOPSIS
.B grub-install
[\fI\,OPTION\/\fR...] [\fI\,OPTION\/\fR] [\fI\,INSTALL_DEVICE\/\fR]
.SH DESCRIPTION
Install GRUB on your drive.
.TP
\fB\-\-appended\-signature\-size\fR=\fI\,SIZE\/\fR
Add a note segment reserving SIZE bytes for an
appended signature
.TP
\fB\-\-compress\fR=\fI\,no\/\fR|xz|gz|lzo
compress GRUB files [optional]
.TP
\fB\-\-disable\-shim\-lock\fR
disable shim_lock verifier
.TP
\fB\-\-dtb\fR=\fI\,FILE\/\fR
embed a specific DTB
.TP
\fB\-d\fR, \fB\-\-directory\fR=\fI\,DIR\/\fR
use images and modules under DIR
[default=/usr/lib/grub/<platform>]
.TP
\fB\-\-fonts\fR=\fI\,FONTS\/\fR
install FONTS [default=unicode]
.TP
\fB\-\-install\-modules\fR=\fI\,MODULES\/\fR
install only MODULES and their dependencies
[default=all]
.TP
\fB\-k\fR, \fB\-\-pubkey\fR=\fI\,FILE\/\fR
embed FILE as public key for signature checking
.TP
\fB\-\-locale\-directory\fR=\fI\,DIR\/\fR use translations under DIR
[default=/usr/share/locale]
.TP
\fB\-\-locales\fR=\fI\,LOCALES\/\fR
install only LOCALES [default=all]
.TP
\fB\-\-modules\fR=\fI\,MODULES\/\fR
pre\-load specified modules MODULES
.TP
\fB\-\-sbat\fR=\fI\,FILE\/\fR
SBAT metadata
.TP
\fB\-\-themes\fR=\fI\,THEMES\/\fR
install THEMES [default=starfield]
.TP
\fB\-v\fR, \fB\-\-verbose\fR
print verbose messages.
.TP
\fB\-x\fR, \fB\-\-x509key\fR=\fI\,FILE\/\fR
embed FILE as an x509 certificate for signature
checking
.TP
\fB\-\-allow\-floppy\fR
make the drive also bootable as floppy (default
for fdX devices). May break on some BIOSes.
.TP
\fB\-\-boot\-directory\fR=\fI\,DIR\/\fR
install GRUB images under the directory DIR/grub2
instead of the boot/grub2 directory
.TP
\fB\-\-bootloader\-id\fR=\fI\,ID\/\fR
the ID of bootloader. This option is only
available on EFI and Macs.
.TP
\fB\-\-core\-compress\fR=\fI\,xz\/\fR|none|auto
choose the compression to use for core image
.TP
\fB\-\-disk\-module\fR=\fI\,MODULE\/\fR
disk module to use (biosdisk or native). This
option is only available on BIOS target.
.TP
\fB\-\-efi\-directory\fR=\fI\,DIR\/\fR
use DIR as the EFI System Partition root.
.TP
\fB\-\-force\fR
install even if problems are detected
.TP
\fB\-\-force\-file\-id\fR
use identifier file even if UUID is available
.TP
\fB\-\-label\-bgcolor\fR=\fI\,COLOR\/\fR
use COLOR for label background
.TP
\fB\-\-label\-color\fR=\fI\,COLOR\/\fR
use COLOR for label
.TP
\fB\-\-label\-font\fR=\fI\,FILE\/\fR
use FILE as font for label
.HP
\fB\-\-macppc\-directory\fR=\fI\,DIR\/\fR use DIR for PPC MAC install.
.TP
\fB\-\-no\-bootsector\fR
do not install bootsector
.TP
\fB\-\-no\-nvram\fR
don't update the `boot\-device'/`Boot*' NVRAM
variables. This option is only available on EFI
and IEEE1275 targets.
.TP
\fB\-\-no\-rs\-codes\fR
Do not apply any reed\-solomon codes when
embedding core.img. This option is only available
on x86 BIOS targets.
.TP
\fB\-\-product\-version\fR=\fI\,STRING\/\fR
use STRING as product version
.TP
\fB\-\-recheck\fR
delete device map if it already exists
.TP
\fB\-\-removable\fR
the installation device is removable. This option
is only available on EFI.
.TP
\fB\-s\fR, \fB\-\-skip\-fs\-probe\fR
do not probe for filesystems in DEVICE
.TP
\fB\-\-target\fR=\fI\,TARGET\/\fR
install GRUB for TARGET platform
[default=x86_64\-efi]; available targets:
arm\-coreboot, arm\-efi, arm\-uboot, arm64\-efi,
i386\-coreboot, i386\-efi, i386\-ieee1275,
i386\-multiboot, i386\-pc, i386\-qemu, i386\-xen,
i386\-xen_pvh, ia64\-efi, mips\-arc, mips\-qemu_mips,
mipsel\-arc, mipsel\-loongson, mipsel\-qemu_mips,
powerpc\-ieee1275, riscv32\-efi, riscv64\-efi,
sparc64\-ieee1275, x86_64\-efi, x86_64\-xen
.TP
\-?, \fB\-\-help\fR
give this help list
.TP
\fB\-\-usage\fR
give a short usage message
.TP
\fB\-V\fR, \fB\-\-version\fR
print program version
.PP
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
.PP
INSTALL_DEVICE must be system device filename.
grub\-install copies GRUB images into boot/grub2. On some platforms, it may
also install GRUB into the boot sector.
.SH "REPORTING BUGS"
Report bugs to <bug\-grub@gnu.org>.
.SH "SEE ALSO"
.BR grub-mkconfig (8),
.BR grub-mkimage (1),
.BR grub-mkrescue (1)
.PP
The full documentation for
.B grub-install
is maintained as a Texinfo manual. If the
.B info
and
.B grub-install
programs are properly installed at your site, the command
.IP
.B info grub-install
.PP
should give you access to the complete manual.
|
