code.delx.au - refind/blob - 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 #showtools shell, about, reboot
  59
  60 # Which types of boot loaders to search, and in what order to display them:
  61 #  internal      - internal EFI disk-based boot loaders
  62 #  external      - external EFI disk-based boot loaders
  63 #  optical       - EFI optical discs (CD, DVD, etc.)
  64 #  hdbios        - BIOS disk-based boot loaders
  65 #  biosexternal  - BIOS external boot loaders (USB, eSATA, etc.)
  66 #  cd            - BIOS optical-disc boot loaders
  67 #  manual        - use stanzas later in this configuration file
  68 # Default is internal,external,optical
  69 scanfor internal,external,optical
  70
  71 # Set the maximum number of tags that can be displayed on the screen at
  72 # any time. If more loaders are discovered than this value, rEFInd shows
  73 # a subset in a scrolling list. If this value is set too high for the
  74 # screen to handle, it's reduced to the value that the screen can manage.
  75 # If this value is set to 0 (the default), it's adjusted to the number
  76 # that the screen can handle.
  77 #
  78 #max_tags 0
  79
  80 # Set the default menu selection.  The available arguments match the
  81 # keyboard accelerators available within rEFInd.  You may select the
  82 # default loader using:
  83 #  - A digit between 1 and 9, in which case the Nth loader in the menu
  84 #    will be the default.
  85 #  - Any substring that corresponds to a portion of the loader's title
  86 #    (usually the OS's name or boot loader's path).
  87 #
  88 #default_selection 1
  89
  90 # Sample manual configuration stanzas. Each begins with the "menuentry"
  91 # keyword followed by a name that's to appear in the menu (use quotes
  92 # if you want the name to contain a space) and an open curly brace
  93 # ("{"). Each entry ends with a close curly brace ("}"). Common
  94 # keywords within each stanza include:
  95 #
  96 #  volume    - identifies the filesystem from which subsequent files
  97 #              are loaded. You can specify the volume by label or by
  98 #              a number followed by a colon (as in "0:" for the first
  99 #              filesystem or "1:" for the second).
 100 #  loader    - identifies the boot loader file
 101 #  initrd    - Specifies an initial RAM disk file
 102 #  icon      - specifies a custom boot loader icon
 103 #  ostype    - OS type code to determine boot options available by
 104 #              pressing Insert. Valid values are "MacOS", "Linux",
 105 #              "Windows", and "XOM". Case-sensitive.
 106 #  graphics  - set to "on" to enable graphics-mode boot (useful
 107 #              mainly for MacOS) or "off" for text-mode boot.
 108 #              Default is auto-detected from loader filename.
 109 #  options   - sets options to be passed to the boot loader; use
 110 #              quotes if more than one option should be passed or
 111 #              if any options use characters that might be changed
 112 #              by rEFInd parsing procedures (=, /, #, or tab).
 113 #  disabled  - use alone or set to "yes" to disable this entry.
 114 #
 115 # Note that you can use either DOS/Windows/EFI-style backslashes (\)
 116 # or Unix-style forward slashes (/) as directory separators. Either
 117 # way, all file references are on the ESP from which rEFInd was
 118 # launched.
 119 # Use of quotes around parameters causes them to be interpreted as
 120 # one keyword, and for parsing of special characters (spaces, =, /,
 121 # and #) to be disabled. This is useful mainly with the "options"
 122 # keyword. Use of quotes around parameters that specify filenames is
 123 # permissible, but you must then use backslashes instead of slashes,
 124 # except when you must pass a forward slash to the loader, as when
 125 # passing a root= option to a Linux kernel.
 126
 127 # Below are several sample boot stanzas. All are disabled by default.
 128 # Find one similar to what you need, copy it, remove the "disabled" line,
 129 # and adjust the entries to suit your needs.
 130
 131 # A sample entry for a Linux 3.3 kernel with its new EFI boot stub
 132 # support on a filesystem called "KERNELS". This entry includes
 133 # Linux-specific boot options and specification of an initial RAM disk.
 134 # Note uses of Linux-style forward slashes, even in the initrd
 135 # specification. Also note that a leading slash is optional in file
 136 # specifications.
 137 menuentry Linux {
 138         icon EFI/refind/icons/os_linux.icns
 139         volume KERNELS
 140         loader bzImage-3.3.0-rc7
 141         initrd initrd-3.3.0.img
 142         options "ro root=UUID=5f96cafa-e0a7-4057-b18f-fa709db5b837"
 143         disabled
 144 }
 145
 146 # A sample entry for loading Ubuntu using its standard name for
 147 # its GRUB 2 boot loader. Note uses of Linux-style forward slashes
 148 menuentry Ubuntu {
 149         loader /EFI/ubuntu/grubx64.efi
 150         icon /EFI/refined/icons/os_linux.icns
 151         disabled
 152 }
 153
 154 # A minimal ELILO entry, which probably offers nothing that
 155 # auto-detection can't accomplish.
 156 menuentry "ELILO" {
 157         loader \EFI\elilo\elilo.efi
 158         disabled
 159 }
 160
 161 # Like the ELILO entry, this one offers nothing that auto-detection
 162 # can't do; but you might use it if you want to disable auto-detection
 163 # but still boot Windows....
 164 menuentry "Windows 7" {
 165         loader \EFI\Microsoft\Boot\bootmgfw.efi
 166         disabled
 167 }
 168