]> code.delx.au - refind/blob - refind.conf-sample
Added max_tags option; new shell filenames; new rEFIt icon
[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 # Disable menu options for increased security. These are intended for a lab
12 # environment where the administrator doesn't want users to mess with the
13 # operating system. List the names for the options you want to hide from
14 # the boot menu. Currently supported:
15 # shell - remove the EFI shell
16 # tools - remove all EFI tools (shell and gptsync)
17 # singleuser - remove the submenu options to boot Mac OS X in single-user
18 # or verbose modes
19 # hwtest - remove the submenu option to run Apple Hardware Test
20 # all - all of the above
21 #
22 #disable shell singleuser
23 #disable all
24
25 # Use a custom title banner instead of the rEFInd icon and name. The file
26 # path is relative to the directory where refind.efi is located. The color
27 # in the top left corner of the image is used as the background color
28 # for the menu screens. Currently uncompressed BMP images with color
29 # depths of 24, 8, 4 or 1 bits are supported.
30 #
31 #banner hostname.bmp
32
33 # Custom images for the selection background. There is a big one (144 x 144)
34 # for the OS icons, and a small one (64 x 64) for the function icons in the
35 # second row. If only a small image is given, that one is also used for
36 # the big icons by stretching it in the middle. If only a big one is given,
37 # the built-in default will be used for the small icons.
38 #
39 # Like the banner option above, these options take a filename of
40 # an uncompressed BMP image file.
41 #
42 #selection_big selection-big.bmp
43 #selection_small selection-small.bmp
44
45 # Hide various user interface elements. Here you can list the names of
46 # interface elements to hide. Currently supported:
47 # banner - the rEFInd title banner
48 # shell - the EFI shell icon
49 # tools - all EFI tools (shell and gptsync)
50 # funcs - built-in functions (about, restart)
51 # ('tools' and 'funcs' together hide the complete second row of icons.)
52 # label - text label in the menu
53 # badges - all volume badges (same as 'hidebadges all'); this setting
54 # is not recommended because it won't let you distinguish
55 # installed OSes and bootable CDs/DVDs.
56 # all - all of the above, except for 'badges'
57 #
58 # Note: The 'shell' and 'tools' options are equivalent to the 'disable'
59 # options with the same names.
60 #
61 #hideui tools funcs hdbadges
62 #hideui all
63
64 # Use text mode only. When enabled, this option forces rEFInd into text mode.
65 #
66 #textonly
67
68 # Which types of boot loaders to search:
69 # internal - internal EFI disk-based boot loaders
70 # external - external EFI disk-based boot loaders
71 # optical - EFI optical discs (CD, DVD, etc.)
72 # hdbios - BIOS disk-based boot loaders
73 # biosexternal - BIOS external boot loaders (USB, eSATA, etc.)
74 # cd - BIOS optical-disc boot loaders
75 # manual - use stanzas later in this configuration file
76 # Default is internal,external,optical
77 scanfor internal,external,optical
78
79 # Set the maximum number of tags that can be displayed on the screen at
80 # any time. If more loaders are discovered than this value, rEFInd shows
81 # a subset in a scrolling list. If this value is set too high for the
82 # screen to handle, it's reduced to the value that the screen can manage.
83 # If this value is set to 0 (the default), it's adjusted to the number
84 # that the screen can handle.
85 #
86 #max_tags 0
87
88 # Set the default menu selection. The available arguments match the
89 # keyboard accelerators available within rEFInd. You may select the default
90 # loader using a one-character abbreviation for the OS name ("M" = Mac OS X,
91 # "L" = Linux, "W" = Windows). You may also specify a digit between 1 and
92 # 9, in which case the Nth loader in the menu will be the default. You can
93 # also select a rEFInd tool entry ("S" = EFI Shell, "P" = Partitioning Tool,
94 # "U" = shutdown). This is intended as a quick fix to change the default
95 # boot choice until full configurability arrives.
96 #
97 #default_selection 1
98
99 # Sample manual configuration stanzas. Each begins with the "menuentry"
100 # keyword followed by a name that's to appear in the menu (use quotes
101 # if you want the name to contain a space) and an open curly brace
102 # ("{"). Each entry ends with a close curly brace ("}"). Common
103 # keywords within each stanza include:
104 #
105 # loader - identifies the boot loader file
106 # initrd - Specifies an initial RAM disk file
107 # icon - specifies a custom boot loader icon
108 # ostype - OS type code to determine boot options available by
109 # pressing Insert. Valid values are "MacOS", "Linux",
110 # "Windows", and "XOM". Case-sensitive.
111 # graphics - set to "on" to enable graphics-mode boot (useful
112 # mainly for MacOS) or "off" for text-mode boot.
113 # Default is auto-detected from loader filename.
114 # options - sets options to be passed to the boot loader; use
115 # quotes if more than one option should be passed or
116 # if any options use characters that might be changed
117 # by rEFInd parsing procedures (=, /, #, or tab).
118 # disabled - use alone or set to "yes" to disable this entry.
119 #
120 # Note that you can use either DOS/Windows/EFI-style backslashes (\)
121 # or Unix-style forward slashes (/) as directory separators. Either
122 # way, all file references are on the ESP from which rEFInd was
123 # launched.
124 # Use of quotes around parameters causes them to be interpreted as
125 # one keyword, and for parsing of special characters (spaces, =, /,
126 # and #) to be disabled. This is useful mainly with the "options"
127 # keyword. Use of quotes around parameters that specify filenames is
128 # permissible, but you must then use backslashes instead of slashes,
129 # except when you must pass a forward slash to the loader, as when
130 # passing a root= option to a Linux kernel.
131
132 # Below are several sample boot stanzas. All are disabled by default.
133 # Find one similar to what you need, copy it, remove the "disabled" line,
134 # and adjust the entries to suit your needs.
135
136 # A sample entry for a Linux 3.3 kernel with its new EFI boot stub
137 # support. This includes Linux-specific boot options and specification
138 # of an initial RAM disk. Note uses of Linux-style forward slashes,
139 # even in the initrd specification. Also note that a leading slash is
140 # optional in file specifications.
141 menuentry Linux {
142 loader EFI/Linux/bzImage-3.3.0-rc7
143 initrd EFI/Linux/initrd-3.3.0.img
144 icon EFI/refind/icons/os_linux.icns
145 options "ro root=UUID=5f96cafa-e0a7-4057-b18f-fa709db5b837"
146 disabled
147 }
148
149 # A sample entry for loading Ubuntu using its standard name for
150 # its GRUB 2 boot loader. Note uses of Linux-style forward slashes
151 menuentry Ubuntu {
152 loader /EFI/ubuntu/grubx64.efi
153 icon /EFI/refined/icons/os_linux.icns
154 disabled
155 }
156
157 # A minimal ELILO entry, which probably offers nothing that
158 # auto-detection can't accomplish.
159 menuentry "ELILO" {
160 loader \EFI\elilo\elilo.efi
161 disabled
162 }
163
164 # Like the ELILO entry, this one offers nothing that auto-detection
165 # can't do; but you might use it if you want to disable auto-detection
166 # but still boot Windows....
167 menuentry "Windows 7" {
168 loader \EFI\Microsoft\Boot\bootmgfw.efi
169 disabled
170 }
171
172 # EOF