]> code.delx.au - refind/blob - refind.conf-sample
Added "scan_all_linux_kernels" refind.conf option & improved case
[refind] / refind.conf-sample
1 #
2 # refind.conf
3 # Configuration file for the rEFInd boot menu
4 #
5
6 # Timeout in seconds for the main menu screen. Setting the timeout to 0
7 # disables automatic booting (i.e., no timeout).
8 #
9 timeout 20
10
11 # Hide user interface elements for personal preference or to increase
12 # security:
13 # banner - the rEFInd title banner
14 # label - text label in the menu
15 # singleuser - remove the submenu options to boot Mac OS X in single-user
16 # or verbose modes; affects ONLY MacOS X
17 # hwtest - the submenu option to run Apple's hardware test
18 # arrows - scroll arrows on the OS selection tag line
19 # all - all of the above
20 #
21 #hideui singleuser
22 #hideui all
23
24 # Use a custom title banner instead of the rEFInd icon and name. The file
25 # path is relative to the directory where refind.efi is located. The color
26 # in the top left corner of the image is used as the background color
27 # for the menu screens. Currently uncompressed BMP images with color
28 # depths of 24, 8, 4 or 1 bits are supported.
29 #
30 #banner hostname.bmp
31
32 # Custom images for the selection background. There is a big one (144 x 144)
33 # for the OS icons, and a small one (64 x 64) for the function icons in the
34 # second row. If only a small image is given, that one is also used for
35 # the big icons by stretching it in the middle. If only a big one is given,
36 # the built-in default will be used for the small icons.
37 #
38 # Like the banner option above, these options take a filename of
39 # an uncompressed BMP image file.
40 #
41 #selection_big selection-big.bmp
42 #selection_small selection-small.bmp
43
44 # Use text mode only. When enabled, this option forces rEFInd into text mode.
45 #
46 #textonly
47
48 # Which non-bootloader tools to show on the tools line, and in what
49 # order to display them:
50 # shell - the EFI shell
51 # gptsync - the (dangerous) gptsync.efi utility
52 # about - an "about this program" option
53 # exit - a tag to exit from rEFInd
54 # shutdown - shuts down the computer (a bug causes this to reboot EFI
55 # systems)
56 # reboot - a tag to reboot the computer
57 # Default is shell,about,shutdown,reboot
58 #
59 #showtools shell, about, reboot
60
61 # Directories in which to search for EFI drivers. These drivers can
62 # provide filesystem support, give access to hard disks on plug-in
63 # controllers, etc. In most cases none are needed, but if you add
64 # EFI drivers and you want rEFInd to automatically load them, you
65 # should specify one or more paths here. rEFInd always scans the
66 # "drivers" subdirectory of its own installation directory; this
67 # option specifies ADDITIONAL directories to scan.
68 # Default is to scan no additional directories for EFI drivers
69 #
70 #scan_driver_dirs EFI/tools/drivers,drivers
71
72 # Which types of boot loaders to search, and in what order to display them:
73 # internal - internal EFI disk-based boot loaders
74 # external - external EFI disk-based boot loaders
75 # optical - EFI optical discs (CD, DVD, etc.)
76 # hdbios - BIOS disk-based boot loaders
77 # biosexternal - BIOS external boot loaders (USB, eSATA, etc.)
78 # cd - BIOS optical-disc boot loaders
79 # manual - use stanzas later in this configuration file
80 # Default is internal,external,optical
81 #
82 #scanfor internal,external,optical
83
84 # When scanning volumes for EFI boot loaders, rEFInd always looks for
85 # Mac OS X's and Microsoft Windows' boot loaders in their normal locations,
86 # and scans the root directory and every subdirectory of the /EFI directory
87 # for additional boot loaders, but it doesn't recurse into these directories.
88 # The also_scan_dirs token adds more directories to the scan list.
89 # Directories are specified relative to the volume's root directory. This
90 # option applies to ALL the volumes that rEFInd scans. If a specified
91 # directory doesn't exist, it's ignored (no error condition results).
92 # The default is to scan no additional directories.
93 #
94 #also_scan_dirs boot,EFI/linux/kernels
95
96 # Scan for Linux kernels that lack a ".efi" filename extension. This is
97 # useful for better integration with Linux distributions that provide
98 # kernels with EFI stub loaders but that don't give those kernels filenames
99 # that end in ".efi", particularly if the kernels are stored on a
100 # filesystem that the EFI can read. When uncommented, this option causes
101 # all files in scanned directories with names that begin with "vmlinuz"
102 # or "bzImage" to be included as loaders, even if they lack ".efi"
103 # extensions. The drawback to this option is that it can pick up kernels
104 # that lack EFI stub loader support and other files. Most notably, if you
105 # want to give a kernel a custom icon by placing an icon with the kernel's
106 # filename but a ".icns" extension in the same directory as the kernel, this
107 # option will cause the icon file to show up as a non-functional loader tag.
108 # Default is to NOT scan for kernels without ".efi" extensions.
109 #
110 #scan_all_linux_kernels
111
112 # Set the maximum number of tags that can be displayed on the screen at
113 # any time. If more loaders are discovered than this value, rEFInd shows
114 # a subset in a scrolling list. If this value is set too high for the
115 # screen to handle, it's reduced to the value that the screen can manage.
116 # If this value is set to 0 (the default), it's adjusted to the number
117 # that the screen can handle.
118 #
119 #max_tags 0
120
121 # Set the default menu selection. The available arguments match the
122 # keyboard accelerators available within rEFInd. You may select the
123 # default loader using:
124 # - A digit between 1 and 9, in which case the Nth loader in the menu
125 # will be the default.
126 # - Any substring that corresponds to a portion of the loader's title
127 # (usually the OS's name or boot loader's path).
128 #
129 #default_selection 1
130
131 # Sample manual configuration stanzas. Each begins with the "menuentry"
132 # keyword followed by a name that's to appear in the menu (use quotes
133 # if you want the name to contain a space) and an open curly brace
134 # ("{"). Each entry ends with a close curly brace ("}"). Common
135 # keywords within each stanza include:
136 #
137 # volume - identifies the filesystem from which subsequent files
138 # are loaded. You can specify the volume by label or by
139 # a number followed by a colon (as in "0:" for the first
140 # filesystem or "1:" for the second).
141 # loader - identifies the boot loader file
142 # initrd - Specifies an initial RAM disk file
143 # icon - specifies a custom boot loader icon
144 # ostype - OS type code to determine boot options available by
145 # pressing Insert. Valid values are "MacOS", "Linux",
146 # "Windows", and "XOM". Case-sensitive.
147 # graphics - set to "on" to enable graphics-mode boot (useful
148 # mainly for MacOS) or "off" for text-mode boot.
149 # Default is auto-detected from loader filename.
150 # options - sets options to be passed to the boot loader; use
151 # quotes if more than one option should be passed or
152 # if any options use characters that might be changed
153 # by rEFInd parsing procedures (=, /, #, or tab).
154 # disabled - use alone or set to "yes" to disable this entry.
155 #
156 # Note that you can use either DOS/Windows/EFI-style backslashes (\)
157 # or Unix-style forward slashes (/) as directory separators. Either
158 # way, all file references are on the ESP from which rEFInd was
159 # launched.
160 # Use of quotes around parameters causes them to be interpreted as
161 # one keyword, and for parsing of special characters (spaces, =, /,
162 # and #) to be disabled. This is useful mainly with the "options"
163 # keyword. Use of quotes around parameters that specify filenames is
164 # permissible, but you must then use backslashes instead of slashes,
165 # except when you must pass a forward slash to the loader, as when
166 # passing a root= option to a Linux kernel.
167
168 # Below are several sample boot stanzas. All are disabled by default.
169 # Find one similar to what you need, copy it, remove the "disabled" line,
170 # and adjust the entries to suit your needs.
171
172 # A sample entry for a Linux 3.3 kernel with its new EFI boot stub
173 # support on a filesystem called "KERNELS". This entry includes
174 # Linux-specific boot options and specification of an initial RAM disk.
175 # Note uses of Linux-style forward slashes, even in the initrd
176 # specification. Also note that a leading slash is optional in file
177 # specifications.
178 menuentry Linux {
179 icon EFI/refind/icons/os_linux.icns
180 volume KERNELS
181 loader bzImage-3.3.0-rc7
182 initrd initrd-3.3.0.img
183 options "ro root=UUID=5f96cafa-e0a7-4057-b18f-fa709db5b837"
184 disabled
185 }
186
187 # A sample entry for loading Ubuntu using its standard name for
188 # its GRUB 2 boot loader. Note uses of Linux-style forward slashes
189 menuentry Ubuntu {
190 loader /EFI/ubuntu/grubx64.efi
191 icon /EFI/refined/icons/os_linux.icns
192 disabled
193 }
194
195 # A minimal ELILO entry, which probably offers nothing that
196 # auto-detection can't accomplish.
197 menuentry "ELILO" {
198 loader \EFI\elilo\elilo.efi
199 disabled
200 }
201
202 # Like the ELILO entry, this one offers nothing that auto-detection
203 # can't do; but you might use it if you want to disable auto-detection
204 # but still boot Windows....
205 menuentry "Windows 7" {
206 loader \EFI\Microsoft\Boot\bootmgfw.efi
207 disabled
208 }
209