xref: /freebsd/stand/defaults/loader.conf (revision aa339f1d5df9e38f36a34eb522355c4eebcae6c4)
1# This is loader.conf - a file full of useful variables that you can
2# set to change the default load behavior of your system. You should
3# not edit this file!  Put any overrides into one of the
4# loader_conf_files instead and you will be able to update these
5# defaults later without spamming your local configuration information.
6#
7# All arguments must be in double quotes.
8#
9
10###  Basic configuration options  ############################
11exec="echo Loading /boot/defaults/loader.conf"
12
13kernel="kernel"		# /boot sub-directory containing kernel and modules
14bootfile="kernel"	# Kernel name (possibly absolute path)
15kernel_options=""	# Flags to be passed to the kernel
16loader_conf_files="/boot/device.hints /boot/loader.conf /boot/loader.conf.local"
17loader_conf_dirs="/boot/loader.conf.d"
18nextboot_conf="/boot/nextboot.conf"
19verbose_loading="NO"		# Set to YES for verbose loader output
20
21###  Splash screen configuration  ############################
22splash_bmp_load="NO"		# Set this to YES for bmp splash screen!
23splash_pcx_load="NO"		# Set this to YES for pcx splash screen!
24splash_txt_load="NO"		# Set this to YES for TheDraw splash screen!
25vesa_load="NO"			# Set this to YES to load the vesa module
26bitmap_load="NO"		# Set this to YES if you want splash screen!
27bitmap_name="splash.bmp"	# Set this to the name of the file
28bitmap_type="splash_image_data" # and place it on the module_path
29
30###  Screen saver modules  ###################################
31# This is best done in rc.conf
32screensave_load="NO"		# Set to YES to load a screensaver module
33screensave_name="green_saver"	# Set to the name of the screensaver module
34
35###  Early hostid configuration ############################
36hostuuid_load="YES"
37hostuuid_name="/etc/hostid"
38hostuuid_type="hostuuid"
39
40###  Random number generator configuration  ##################
41# See rc.conf(5). The entropy_boot_file config variable must agree with the
42# settings below.
43entropy_cache_load="YES"		# Set this to NO to disable loading
44					# cached entropy at boot time
45entropy_cache_name="/boot/entropy"	# Set this to the name of the file
46entropy_cache_type="boot_entropy_cache"	# Required for the kernel to find
47					# the boot-time entropy cache. This
48					# must not change value even if the
49					# _name above does change!
50entropy_efi_seed="YES"		# Set this to NO to disable loading
51					# entropy from the UEFI hardware random number generator API
52
53###  RAM Blacklist configuration  ############################
54ram_blacklist_load="NO"			# Set this to YES to load a file
55					# containing a list of addresses to
56					# exclude from the running system.
57ram_blacklist_name="/boot/blacklist.txt" # Set this to the name of the file
58ram_blacklist_type="ram_blacklist"	# Required for the kernel to find
59					# the blacklist module
60
61###  Microcode loading configuration  ########################
62cpu_microcode_load="NO"			# Set this to YES to load and apply a
63					# microcode update file during boot.
64cpu_microcode_name="/boot/firmware/ucode.bin" # Set this to the microcode
65					      # update file path.
66cpu_microcode_type="cpu_microcode"	# Required for the kernel to find
67					# the microcode update file.
68
69###  ACPI settings  ##########################################
70acpi_dsdt_load="NO"		# DSDT Overriding
71acpi_dsdt_type="acpi_dsdt"	# Don't change this
72acpi_dsdt_name="/boot/acpi_dsdt.aml"
73				# Override DSDT in BIOS by this file
74acpi_video_load="NO"		# Load the ACPI video extension driver
75
76###  Audit settings  #########################################
77audit_event_load="NO"		# Preload audit_event config
78audit_event_name="/etc/security/audit_event"
79audit_event_type="etc_security_audit_event"
80
81###  Initial memory disk settings  ###########################
82#mdroot_load="YES"		# The "mdroot" prefix is arbitrary.
83#mdroot_type="md_image"		# Create md(4) disk at boot.
84#mdroot_name="/boot/root.img"	# Path to a file containing the image.
85#rootdev="ufs:/dev/md0"		# Set the root filesystem to md(4) device.
86
87###  Loader settings  ########################################
88#loader_delay="3"		# Delay in seconds before loading anything.
89				# Default is unset and disabled (no delay).
90#autoboot_delay="10"		# Delay in seconds before autobooting,
91				# -1 for no user interrupts, NO to disable
92#password=""			# Prevent changes to boot options
93#bootlock_password=""		# Prevent booting (see check-password.4th(8))
94#geom_eli_passphrase_prompt="NO" # Prompt for geli(8) passphrase to mount root
95bootenv_autolist="YES"		# Auto populate the list of ZFS Boot Environments
96#beastie_disable="NO"		# Turn the beastie boot menu on and off
97efi_max_resolution="1x1"	# Set the max resolution for EFI loader to use:
98				# 480p, 720p, 1080p, 2160p/4k, 5k, or specify
99				# WidthxHeight (e.g. 1920x1080)
100#kernels="kernel kernel.old"	# Kernels to display in the boot menu
101kernels_autodetect="YES"	# Auto-detect kernel directories in /boot
102#loader_logo="orbbw"		# Desired logo: orbbw, orb, fbsdbw, beastiebw, beastie, none
103#comconsole_speed="115200"	# Set the current serial console speed
104#console="vidconsole"		# A comma separated list of console(s)
105#currdev="disk1s1a"		# Set the current device
106module_path="/boot/modules;/boot/dtb;/boot/dtb/overlays"	# Set the module search path
107module_blacklist="drm drm2 radeonkms i915kms amdgpu"	# Loader module blacklist
108#prompt="\\${interpret}"	# Set the command prompt
109#root_disk_unit="0"		# Force the root disk unit number
110#rootdev="disk1s1a"		# Set the root filesystem
111#dumpdev="disk1s1b"		# Set a dump device early in the boot process
112#tftp.blksize="1428"		# Set the RFC 2348 TFTP block size.
113				# If the TFTP server does not support RFC 2348,
114				# the block size is set to 512. Valid: (8,9007)
115#twiddle_divisor="16"		# >16 slows down the progress indicator;
116				# <16 speeds up the progress indicator.
117
118###  Kernel settings  ########################################
119# The following boot_ variables are enabled by setting them to any value.
120# Their presence in the kernel environment (see kenv(1)) has the same
121# effect as setting the given boot flag (see boot(8)).
122#boot_askname=""	# -a: Prompt the user for the name of the root device
123#boot_cdrom=""		# -C: Attempt to mount root file system from CD-ROM
124#boot_ddb=""		# -d: Instructs the kernel to start in the DDB debugger
125#boot_dfltroot=""	# -r: Use the statically configured root file system
126#boot_gdb=""		# -g: Selects gdb-remote mode for the kernel debugger
127#boot_multicons=""	# -D: Use multiple consoles
128#boot_mute=""		# -m: Mute the console
129#boot_pause=""		# -p: Pause after each line during device probing
130#boot_serial=""		# -h: Use serial console
131#boot_single=""		# -s: Start system in single-user mode
132#boot_verbose=""	# -v: Causes extra debugging information to be printed
133#init_path="/sbin/init:/sbin/oinit:/sbin/init.bak:/rescue/init"
134			# Sets the list of init candidates
135#init_shell="/bin/sh"	# The shell binary used by init(8).
136#init_script=""		# Initial script to run by init(8) before chrooting.
137#init_chroot=""		# Directory for init(8) to chroot into.
138
139###  Kernel tunables  ########################################
140#hw.physmem="1G"		# Limit physical memory. See loader(8)
141#kern.dfldsiz=""		# Set the initial data size limit
142#kern.dflssiz=""		# Set the initial stack size limit
143#kern.hz="100"			# Set the kernel interval timer rate
144#kern.maxbcache=""		# Set the max buffer cache KVA storage
145#kern.maxdsiz=""		# Set the max data size
146#kern.maxfiles=""		# Set the sys. wide open files limit
147#kern.maxproc=""		# Set the maximum # of processes
148#kern.maxssiz=""		# Set the max stack size
149#kern.maxswzone=""		# Set the max swmeta KVA storage
150#kern.maxtsiz=""		# Set the max text size
151#kern.maxusers="32"		# Set size of various static tables
152#kern.msgbufsize="65536"	# Set size of kernel message buffer
153#kern.nbuf=""			# Set the number of buffer headers
154#kern.ncallout=""		# Set the maximum # of timer events
155#kern.ngroups="1023"		# Set the maximum # of supplemental groups
156#kern.sgrowsiz=""		# Set the amount to grow stack
157#kern.cam.boot_delay="10000"	# Delay (in ms) of root mount for CAM bus
158				# registration, useful for USB sticks as root
159#kern.cam.scsi_delay="2000"	# Delay (in ms) before probing SCSI
160#kern.ipc.maxsockets=""		# Set the maximum number of sockets available
161#kern.ipc.nmbclusters=""	# Set the number of mbuf clusters
162#kern.ipc.nsfbufs=""		# Set the number of sendfile(2) bufs
163#net.inet.tcp.tcbhashsize=""	# Set the value of TCBHASHSIZE
164#vfs.root.mountfrom=""		# Specify root partition
165#vm.kmem_size=""		# Sets the size of kernel memory (bytes)
166#debug.kdb.break_to_debugger="0" # Allow console to break into debugger.
167#debug.ktr.cpumask="0xf"	# Bitmask of CPUs to enable KTR on
168#debug.ktr.mask="0x1200"	# Bitmask of KTR events to enable
169#debug.ktr.verbose="1"		# Enable console dump of KTR events
170
171###  Module loading syntax example  ##########################
172#module_load="YES"		# loads module "module"
173#module_name="realname"		# uses "realname" instead of "module"
174#module_type="type"		# passes "-t type" to load
175#module_flags="flags"		# passes "flags" to the module
176#module_before="cmd"		# executes "cmd" before loading the module
177#module_after="cmd"		# executes "cmd" after loading the module
178#module_error="cmd"		# executes "cmd" if load fails
179