]> code.delx.au - refind/blobdiff - refind.conf-sample
New config file option: "also_scan_dirs".
[refind] / refind.conf-sample
index 06ecaa98bffaff3739e0c44331d0916b10562b3b..97a01df15f6f0e137858c391c0bc8d6a6d785ce7 100644 (file)
@@ -8,19 +8,18 @@
 #
 timeout 20
 
-# Disable menu options for increased security. These are intended for a lab
-# environment where the administrator doesn't want users to mess with the
-# operating system. List the names for the options you want to hide from
-# the boot menu. Currently supported:
-#  shell       - remove the EFI shell
-#  tools       - remove all EFI tools (shell and gptsync)
+# Hide user interface elements for personal preference or to increase
+# security:
+#  banner      - the rEFInd title banner
+#  label       - text label in the menu
 #  singleuser  - remove the submenu options to boot Mac OS X in single-user
-#                 or verbose modes
-#  hwtest      - remove the submenu option to run Apple Hardware Test
+#                or verbose modes; affects ONLY MacOS X
+#  hwtest      - the submenu option to run Apple's hardware test
+#  arrows      - scroll arrows on the OS selection tag line
 #  all         - all of the above
 #
-#disable shell singleuser
-#disable all
+#hideui singleuser
+#hideui all
 
 # Use a custom title banner instead of the rEFInd icon and name. The file
 # path is relative to the directory where refind.efi is located. The color
@@ -42,30 +41,24 @@ timeout 20
 #selection_big   selection-big.bmp
 #selection_small selection-small.bmp
 
-# Hide various user interface elements. Here you can list the names of
-# interface elements to hide. Currently supported:
-#  banner    - the rEFInd title banner
-#  shell     - the EFI shell icon
-#  tools     - all EFI tools (shell and gptsync)
-#  funcs     - built-in functions (about, restart)
-#    ('tools' and 'funcs' together hide the complete second row of icons.)
-#  label     - text label in the menu
-#  badges    - all volume badges (same as 'hidebadges all'); this setting
-#               is not recommended because it won't let you distinguish
-#               installed OSes and bootable CDs/DVDs.
-#  all       - all of the above, except for 'badges'
-#
-# Note: The 'shell' and 'tools' options are equivalent to the 'disable'
-# options with the same names.
-#
-#hideui tools funcs hdbadges
-#hideui all
-
 # Use text mode only. When enabled, this option forces rEFInd into text mode.
 #
 #textonly
 
-# Which types of boot loaders to search:
+# Which non-bootloader tools to show on the tools line, and in what
+# order to display them:
+#  shell     - the EFI shell
+#  gptsync   - the (dangerous) gptsync.efi utility
+#  about     - an "about this program" option
+#  exit      - a tag to exit from rEFInd
+#  shutdown  - shuts down the computer (a bug causes this to reboot EFI
+#              systems)
+#  reboot    - a tag to reboot the computer
+# Default is shell,about,shutdown,reboot
+#
+#showtools shell, about, reboot
+
+# Which types of boot loaders to search, and in what order to display them:
 #  internal      - internal EFI disk-based boot loaders
 #  external      - external EFI disk-based boot loaders
 #  optical       - EFI optical discs (CD, DVD, etc.)
@@ -74,16 +67,37 @@ timeout 20
 #  cd            - BIOS optical-disc boot loaders
 #  manual        - use stanzas later in this configuration file
 # Default is internal,external,optical
-scanfor internal,external,optical
+#
+#scanfor internal,external,optical
+
+# When scanning volumes for EFI boot loaders, rEFInd always looks for
+# Mac OS X's and Microsoft Windows' boot loaders in their normal locations,
+# and scans the root directory and every subdirectory of the /EFI directory
+# for additional boot loaders, but it doesn't recurse into these directories.
+# The also_scan_dirs token adds more directories to the scan list.
+# Directories are specified relative to the volume's root directory. This
+# option applies to ALL the volumes that rEFInd scans. If a specified
+# directory doesn't exist, it's ignored (no error condition results).
+# The default is to scan no additional directories.
+#
+#also_scan_dirs boot,EFI/linux/kernels
+
+# Set the maximum number of tags that can be displayed on the screen at
+# any time. If more loaders are discovered than this value, rEFInd shows
+# a subset in a scrolling list. If this value is set too high for the
+# screen to handle, it's reduced to the value that the screen can manage.
+# If this value is set to 0 (the default), it's adjusted to the number
+# that the screen can handle.
+#
+#max_tags 0
 
 # Set the default menu selection.  The available arguments match the
-# keyboard accelerators available within rEFInd.  You may select the default
-# loader using a one-character abbreviation for the OS name ("M" = Mac OS X,
-# "L" = Linux, "W" = Windows).  You may also specify a digit between 1 and
-# 9, in which case the Nth loader in the menu will be the default.  You can
-# also select a rEFInd tool entry ("S" = EFI Shell, "P" = Partitioning Tool,
-# "U" = shutdown).  This is intended as a quick fix to change the default
-# boot choice until full configurability arrives.
+# keyboard accelerators available within rEFInd.  You may select the
+# default loader using:
+#  - A digit between 1 and 9, in which case the Nth loader in the menu
+#    will be the default. 
+#  - Any substring that corresponds to a portion of the loader's title
+#    (usually the OS's name or boot loader's path).
 #
 #default_selection 1
 
@@ -93,6 +107,10 @@ scanfor internal,external,optical
 # ("{"). Each entry ends with a close curly brace ("}"). Common
 # keywords within each stanza include:
 #
+#  volume    - identifies the filesystem from which subsequent files
+#              are loaded. You can specify the volume by label or by
+#              a number followed by a colon (as in "0:" for the first
+#              filesystem or "1:" for the second).
 #  loader    - identifies the boot loader file
 #  initrd    - Specifies an initial RAM disk file
 #  icon      - specifies a custom boot loader icon
@@ -125,14 +143,16 @@ scanfor internal,external,optical
 # and adjust the entries to suit your needs.
 
 # A sample entry for a Linux 3.3 kernel with its new EFI boot stub
-# support. This includes Linux-specific boot options and specification
-# of an initial RAM disk. Note uses of Linux-style forward slashes,
-# even in the initrd specification. Also note that a leading slash is
-# optional in file specifications.
+# support on a filesystem called "KERNELS". This entry includes
+# Linux-specific boot options and specification of an initial RAM disk.
+# Note uses of Linux-style forward slashes, even in the initrd
+# specification. Also note that a leading slash is optional in file
+# specifications.
 menuentry Linux {
-       loader EFI/Linux/bzImage-3.3.0-rc7
-       initrd EFI/Linux/initrd-3.3.0.img
        icon EFI/refind/icons/os_linux.icns
+       volume KERNELS
+       loader bzImage-3.3.0-rc7
+       initrd initrd-3.3.0.img
        options "ro root=UUID=5f96cafa-e0a7-4057-b18f-fa709db5b837"
        disabled
 }
@@ -160,4 +180,3 @@ menuentry "Windows 7" {
        disabled
 }
 
-# EOF