]> code.delx.au - refind/blob - docs/refind/using.html
0.3.1 release. Fixed bug that caused bogus error message on Macs.
[refind] / docs / refind / using.html
1 <?xml version="1.0" encoding="utf-8" standalone="no"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
3 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
4
5 <html xmlns="http://www.w3.org/1999/xhtml">
6 <head>
7 <title>The rEFInd Boot Manager: Using rEFInd</title>
8 <link href="../Styles/styles.css" rel="stylesheet" type="text/css" />
9 </head>
10
11 <body>
12 <h1>The rEFInd Boot Manager:<br />Using rEFInd</h1>
13
14 <p class="subhead">by Roderick W. Smith, <a
15 href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
16
17 <p>Originally written: 3/14/2012; last Web page update:
18 4/27/2012, referencing rEFInd 0.3.1</p>
19
20
21 <p>I'm a technical writer and consultant specializing in Linux technologies. This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!</p>
22
23 <table border="1">
24 <tr>
25 <td>Donate $1.00</td>
26 <td>Donate $2.50</td>
27 <td>Donate $5.00</td>
28 <td>Donate $10.00</td>
29 <td>Donate another value</td>
30 </tr>
31 <tr>
32 <td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
33 <input type="hidden" name="cmd" value="_xclick">
34 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
35 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
36 <input type="hidden" name="currency_code" value="USD">
37 <input type="hidden" name="amount" value="1.00">
38 <input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
39 </form>
40
41 </td>
42 <td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
43 <input type="hidden" name="cmd" value="_xclick">
44 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
45 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
46 <input type="hidden" name="currency_code" value="USD">
47 <input type="hidden" name="amount" value="2.50">
48 <input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
49 </form>
50
51 </td>
52 <td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
53 <input type="hidden" name="cmd" value="_xclick">
54 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
55 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
56 <input type="hidden" name="currency_code" value="USD">
57 <input type="hidden" name="amount" value="5.00">
58 <input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
59 </form>
60
61 </td>
62 <td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
63 <input type="hidden" name="cmd" value="_xclick">
64 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
65 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
66 <input type="hidden" name="currency_code" value="USD">
67 <input type="hidden" name="amount" value="10.00">
68 <input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
69 </form>
70
71 </td>
72 <td>
73 <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
74 <input type="hidden" name="cmd" value="_donations">
75 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
76 <input type="hidden" name="lc" value="US">
77 <input type="hidden" name="no_note" value="0">
78 <input type="hidden" name="currency_code" value="USD">
79 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
80 <input type="hidden" name="bn" value="PP-DonationsBF:btn_donate_LG.gif:NonHostedGuest">
81 <input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
82 <img alt="Donate with PayPal" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
83 </form>
84 </td></tr>
85 </table>
86
87 <hr />
88
89 <p>This page is part of the documentation for the rEFInd boot manager. If a Web search has brought you here, you may want to start at the <a href="index.html">main page.</a></p>
90
91 <hr />
92
93 <h2>Using Basic rEFInd Features</h2>
94
95 <p>With rEFInd in place and added to your firmware's list of boot utilities, you can reboot your computer. Depending on your configuration, rEFInd may come up immediately or you may need to select it from your firmware's boot options or reconfigure your firmware to present rEFInd automatically. Unfortunately, I can't offer much specific advice on this score, since EFI implementations differ so much in their user interfaces.</p>
96
97 <p>Assuming rEFInd starts up correctly, you should see its main screen, which resembles the following:</p>
98
99 <br /><center><img src="refind.png" align="center" width="905"
100 height="389" alt="rEFInd presents a GUI menu for selecting your boot
101 OS." border=2 /></center> <br />
102
103 <p>If you don't press any key before the timeout (shown on the last line) expires, the default boot loader will launch. This is normally the first item in the menu, but you can adjust the default by editing the configuration file. (In this example, it's the SUSE loader, which is further identified by text above the timeout as <i>Linux 3.3.0-rc7 from ESP.</i>)</p>
104
105 <p>This display is dominated by the central set of icons, which in this example includes icons for OS X, Windows, Ubuntu, a generic Linux installation (ELILO, in fact), SUSE, and an unkown boot loader. All but the last of these are on hard disks, but the unknown boot loader is on an optical disc, as revealed by the small icons (known as <i>badges</i>) in the lower-right corner of the OS icons.</p>
106
107 <p>In this example, the SUSE tag is selected. You can move the selection left by pressing the left or down arrow key and right by pressing the right or up arrow key. If your system has many boot loaders, an arrow icon will appear to the right of the boot loader list, indicating that the boot loader list will scroll when you move off the right edge. If you do this, an arrow icon will appear to the left of the icon list, indicating that you can scroll back in a similar manner. Moving past the final selection or using the Page Down key moves the selection to the second row of small icons, which launch ancillary programs or perform special actions. In this figure, these five icons are present:</p>
108
109 <ul>
110
111 <li>Launch the EFI shell</li>
112
113 <p class="sidebar">As noted on the <a href="installing.html">Installing rEFInd</a> page, the <tt>gptsync</tt> utility is dangerous, but it's useful on some Mac systems that dual-boot with Windows. If you're using a UEFI-based PC, it's best to <i>not</i> install this utility!</p>
114
115 <li>Launch the <tt>gptsync</tt> utility</li>
116
117 <li>Produce an information page</li>
118
119 <li>Shut down the computer</li>
120
121 <li>Reboot the computer</li>
122
123 </ul>
124
125 <p>The last three of these options are always available by default, but the first depends on the presence of the EFI shell program file, as described earlier. To get the <tt>gptsync</tt> icon, you must install <tt>gptsync.efi</tt> and adjust the <tt>showtools</tt> option in <tt>refind.conf</tt>, as well.</p>
126
127 <p>To launch an OS or utility, you should select its icon and then press the Enter key. If you press the Insert key, rEFInd will show a menu that may hold additional options, depending on the OS type. The following figure shows the submenu for Mac OS X. You can use this menu much like the main menu; move the cursor to select the option you want to use, then press the Enter key to launch the boot loader with the selected options. Press the Esc key or select <tt>Return to Main Menu</tt> to return to the main menu.</p>
128
129 <br /><center><img src="submenu.png" align="center" width="442"
130 height="269" alt="rEFInd submenus enable you to set session-specific
131 options." border=2></center> <br />
132
133
134 <h2>Using Keyboard Shortcuts</h2>
135
136 <p>Although most rEFInd features can be activated via fairly obvious keyboard actions, some are not obvious. <a href="#table1">Table 1</a> summarizes the keystrokes that rEFInd accepts, and the action that each keystroke invokes.</p>
137
138 <table border="1" cellpadding="1" cellspacing="2" summary="Table 1: rEFInd Keyboard Shortcuts"><a name="table1"><caption><b>Table 1: rEFInd Keyboard Shortcuts</b></caption></a>
139 <tr>
140 <th>Keystroke</th>
141 <th>Explanation</th>
142 </tr>
143 <tr>
144 <td><i>left arrow</i> or <i>up arrow</i></td>
145 <td>Moves the selection one icon to the left (or up the list in text mode)</td>
146 </tr>
147 <tr>
148 <td><i>right arrow</i> or <i>down arrow</i></td>
149 <td>Moves the selection one icon to the right (or down the list in text mode)</td>
150 </tr>
151 <tr>
152 <td><i>Page Up</i> or <i>Home</i></td>
153 <td>Moves the selection to the first item on the OS row</td>
154 </tr>
155 <tr>
156 <td><i>Page Down</i> or <i>End</i></td>
157 <td>Moves the selection to the last item on the utilities row</td>
158 </tr>
159 <tr>
160 <td><i>Esc</i></td>
161 <td>Returns from a sub-menu or redraws the screen</td>
162 </tr>
163 <tr>
164 <td><i>Insert</i>, <i>F2</i>, or <i>+</i></td>
165 <td>Opens the selection's submenu, which is most useful for Mac OS X and ELILO</td>
166 </tr>
167 <tr>
168 <td><i>F10</i></td>
169 <td>Saves an image of the current screen in the file <tt>screenshot.bmp</tt> in the ESP's root directory</td>
170 </tr>
171 <tr>
172 <td><i>Enter</i> or <i>spacebar</i></td>
173 <td>Launches the currently-selected OS, utility, or built-in feature</td>
174 </tr>
175 <tr>
176 <td><i>0</i></td>
177 <td>Launches the Linux rescue entry</td>
178 </tr>
179 <tr>
180 <td><i>1</i> through <i>9</i></td>
181 <td>Launches the specified boot loader by number</td>
182 </tr>
183 <tr>
184 <td><i>E</i></td>
185 <td>Launches the EFI shell</td>
186 </tr>
187 <tr>
188 <td><i>L</i></td>
189 <td>Launches the first Linux ELILO boot loader</td>
190 </tr>
191 <tr>
192 <td><i>M</i></td>
193 <td>Launches the first Mac OS boot loader</td>
194 </tr>
195 <tr>
196 <td><i>P</i></td>
197 <td>Launches <tt>gptsync</tt></td>
198 </tr>
199 <tr>
200 <td><i>U</i></td>
201 <td>Shuts down the computer (but note that this is buggy and reboots most UEFI-based PCs)</td>
202 </tr>
203 <tr>
204 <td><i>W</i></td>
205 <td>Launches the first Windows boot loader</td>
206 </tr>
207 <tr>
208 <td>Other letters</td>
209 <td>Launch OSes whose names begin with those letters, as described below</td>
210 </tr>
211 </table>
212
213 <p>rEFInd assigns shortcut letters to most OS entries based on the first letter of the directory in which the OS's boot loader is stored. For instance, if you have a boot loader called <tt>/EFI/debian/elilo.efi</tt>, rEFInd attempts to assign it a shortcut letter of <i>D</i>. rEFInd overrides this default for Mac OS X, Windows, and for Linux ELILO boot loaders if the distribution can't be more precisely identified, as noted in the preceding table. This method works well for many installations, but it can produce conflicts. For instance, if you have a Macintosh that holds both Mac OS X and Mandriva, both OSes would normally use the <tt>M</tt> shortcut key. In practice, which works depends on the order in which rEFInd detects the OSes.</p>
214
215 <hr />
216
217 <p>copyright &copy; 2012 by Roderick W. Smith</p>
218
219 <p>This document is licensed under the terms of the <a href="FDL-1.3.txt">GNU Free Documentation License (FDL), version 1.3.</a></p>
220
221 <p>If you have problems with or comments about this Web page, please e-mail me at <a href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com.</a> Thanks.</p>
222
223 <p><a href="index.html">Go to the main rEFInd page</a></p>
224
225 <p><a href="configfile.html">Learn how to Configure rEFInd</a></p>
226
227 <p><a href="http://www.rodsbooks.com/">Return</a> to my main Web page.</p>
228 </body>
229 </html>