Latest revision |
Your text |
Line 1: |
Line 1: |
| {{welcome}} | | {{welcome}} |
| + | {{maintenance}} |
| {{Navbar OpenRC}} | | {{Navbar OpenRC}} |
| | | |
Line 6: |
Line 7: |
| ''/etc/rc.conf'' | | ''/etc/rc.conf'' |
| | | |
− | The global [[OpenRC]] configuration file.<br/> | + | The global [[OpenRC]] configuration file. |
| | | |
− | ==Description==
| |
− |
| |
− | The file [https://www.freebsd.org/cgi/man.cgi?query=rc.conf&apropos=0&sektion=0&manpath=FreeBSD+12.1-RELEASE+and+Ports&arch=default&format=html '''rc.conf(5)'''] contains descriptive information about the local host name, configuration details for any potential network interfaces and which services should be started up at system initial boot time. In new installations, the '''rc.conf''' file is generally initialized by the system installation utility.
| |
− |
| |
− | The purpose of [https://www.freebsd.org/cgi/man.cgi?query=rc.conf&apropos=0&sektion=0&manpath=FreeBSD+12.1-RELEASE+and+Ports&arch=default&format=html '''rc.conf(5)'''] is not to run commands or perform system startup actions directly. Instead, it is included by the various generic startup scripts in '''[[/etc/]]''' which conditionalize their internal actions according to the settings found there.
| |
− |
| |
− | The '''/etc/[[Rc.conf|rc.conf]]''' file is included from the file '''/etc/[[Defaults/rc.conf|defaults/rc.conf]],''' which specifies the default settings for all the available options. Options need only be specified in '''/etc/rc.conf''' when the system administrator wishes to override these defaults. The file '''/etc/rc.conf.local''' is used to override settings in '''/etc/rc.conf''' for historical reasons.
| |
− |
| |
− | The [https://www.freebsd.org/cgi/man.cgi?query=sysrc&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports sysrc(8)] command provides a scripting interface to modify system config files.
| |
− | The /usr/sbin/[https://www.freebsd.org/cgi/man.cgi?query=sysrc&apropos=0&sektion=0&manpath=FreeBSD+12.1-RELEASE+and+Ports&arch=default&format=html sysrc] utility retrieves [[Rc.conf|rc.conf(5)]] variables from the collection of system rc files and allows processes with appropriate privilege to change values in a safe and effective manner.
| |
− |
| |
− |
| |
− | In addition to '''/etc/rc.conf.local''' you can also place smaller configuration files for each [https://www.freebsd.org/cgi/man.cgi?query=rc&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports rc(8)] script in the '''/etc/[[Rc.conf.d|rc.conf.d]]''' directory.
| |
− |
| |
− | The [https://www.freebsd.org/cgi/man.cgi?query=timed&apropos=0&sektion=0&manpath=FreeBSD+12.1-RELEASE+and+Ports&arch=default&format=html timed] utility is a time server daemon which is normally invoked at boot time from the [[Rc.conf|rc.conf]](5) file. It synchronizes the host's time with the time of other machines, which are also running timed, in a local area network.
| |
| | | |
| ==Example== | | ==Example== |
− |
| |
− | The command <code> cat /etc/rc.conf</code> will show you somthing like this:
| |
| | | |
| {|class="wikitable" style="width:96.5%;background:#FFFFFF; border:2px solid #008000;text-align:left;padding: 10px" | | {|class="wikitable" style="width:96.5%;background:#FFFFFF; border:2px solid #008000;text-align:left;padding: 10px" |
Line 33: |
Line 17: |
| ! scope="col" style="width: 350px;"|'''Description''' | | ! scope="col" style="width: 350px;"|'''Description''' |
| |- | | |- |
− | |root_rw_mount="NO"||Set to "YES" by default. After the file systems are checked at boot time, the root file system is remounted as read-write if this is set to "YES". Diskless systems that mount their root file system from a read-only remote NFS share should set this to "NO" in their ''rc.conf''. | + | |root_rw_mount="NO"|| |
| |- | | |- |
− | |sendmail_enable="NONE"||If set to "YES", run the [https://www.freebsd.org/cgi/man.cgi?query=sendmail&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports sendmail(8)] daemon at system boot time. If set to "NO", do not run a [https://www.freebsd.org/cgi/man.cgi?query=sendmail&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports sendmail(8)] daemon to listen for incoming network mail. This does not preclude a [https://www.freebsd.org/cgi/man.cgi?query=sendmail&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports sendmail(8)] daemon listening on the SMTP port of the loopback interface. The "NONE" option is deprecated and should not be used. It will be removed in a future release. | + | |sendmail_enable="NONE"|| |
| |- | | |- |
− | |sendmail_submit_enable="NO"||If set to "YES" and sendmail_enable is set to "NO", run [https://www.freebsd.org/cgi/man.cgi?query=sendmail&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports sendmail(8)] using sendmail_submit_flags instead of sendmail_flags. This is intended to allow local mail submission via a localhost-only listening SMTP service required for running [https://www.freebsd.org/cgi/man.cgi?query=sendmail&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports sendmail(8)] as a non-set-user-ID binary. Note that this does not work inside [https://www.freebsd.org/cgi/man.cgi?query=jail&sektion=2&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports jail(2)] systems, as jails do not allow binding to just the localhost interface. | + | |sendmail_submit_enable="NO"|| |
− | | + | |
| |- | | |- |
− | |sendmail_outbound_enable="NO"||If set to "YES" and both sendmail_enable and sendmail_submit_enable are set to "NO", run [[https://www.freebsd.org/cgi/man.cgi?query=sendmail&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports sendmail(8)] using sendmail_outbound_flags instead of sendmail_flags. This is intended to allow local mail queue management for systems that do not offer a listening SMTP service. | + | |sendmail_outbound_enable="NO"|| |
− | | + | |
| |- | | |- |
− | |sendmail_msp_queue_enable="NO"||If set to "YES", start a client (MSP) queue runner sendmail(8) daemon at system boot time. As of sendmail 8.12, a separate queue is used for command line submissions. The client queue runner ensures that nothing is left behind in the submission queue. | + | |sendmail_msp_queue_enable="NO"|| |
| |- | | |- |
− | |devfs_system_ruleset="devfsrules_common"||Rule name(s) to apply to the system ''/dev'' itself. | + | |devfs_system_ruleset="devfsrules_common"|| |
| |- | | |- |
− | |kld_list="linux linux64 cuse"||kld_list: A list of kernel modules to load right after the local disks are mounted. Loading modules at this point in the boot process is much faster than doing it via /boot/loader.conf for those modules not necessary for mounting local disk. | + | |kld_list="linux linux64 cuse"|| |
− | |-
| + | |
− | |ntpd_sync_on_start="YES"||If set to "YES", [https://www.freebsd.org/cgi/man.cgi?query=ntpd&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports ntpd(8)] is run with the -g flag, which syncs the system's clock on startup. See [https://www.freebsd.org/cgi/man.cgi?query=ntpd&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports ntpd(8)] for more information regarding the -g option. This is a preferred alternative to using [https://www.freebsd.org/cgi/man.cgi?query=ntpdate&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports ntpdate(8)] or specifying the '' ntpdate_enable ''variable.
| + | |
− | | + | |
| |- | | |- |
− | |ifconfig_nfe0="DHCP"||[https://www.freebsd.org/cgi/man.cgi?query=ifconfig&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports ifconfig(8)], It is possible to bring up an interface with DHCP by adding "DHCP" to the ifconfig_<interface> variable. | + | |ntpd_sync_on_start="YES"|| |
| |- | | |- |
− | |keymap="de.kbd"||If set to "NO", no keymap is installed, otherwise the value is used to install the keymap file found in /usr/share/syscons/keymaps/<value>.kbd (if using [https://www.freebsd.org/cgi/man.cgi?query=syscons&apropos=0&sektion=0&manpath=FreeBSD+12.1-RELEASE+and+Ports&arch=default&format=html syscons(4))] or /usr/share/vt/keymaps/<value>.kbd (if using [https://www.freebsd.org/cgi/man.cgi?query=vt&apropos=0&sektion=0&manpath=FreeBSD+12.1-RELEASE+and+Ports&arch=default&format=html vt(4)]). | + | |ifconfig_nfe0="DHCP"|| |
| |- | | |- |
− | |hostname="yourname.ghostbsd-pc.home"||Your host name | + | |keymap="de.kbd"|| |
| |- | | |- |
− | |kldload_nvidia="nvidia-modeset nvidia"||kldload -- load a file into the kernel | + | |hostname="slughorn.ghostbsd-pc.home"|| |
| |- | | |- |
− | |kldload_nvidia="nvidia-modeset nvidia"||kldload -- load a file into the kernel | + | |kldload_nvidia="nvidia-modeset nvidia"|| |
| |- | | |- |
− | |autofs_enable="YES"||If set to "YES", start the [https://www.freebsd.org/cgi/man.cgi?query=automountd&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports automount(8)] utility and the [https://www.freebsd.org/cgi/man.cgi?query=automountd&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports automountd(8)] and [https://www.freebsd.org/cgi/man.cgi?query=autounmountd&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports autounmountd(8)] daemons at boot time. | + | |kldload_nvidia="nvidia-modeset nvidia"|| |
| |- | | |- |
− | |lpd_enable="NO"||If set to "YES", run the [https://www.freebsd.org/cgi/man.cgi?query=lpd&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports lpd(8)] daemon at system boot time. | + | |autofs_enable="YES"|| |
| |- | | |- |
− | |cupsd_enable="YES"||[https://www.freebsd.org/cgi/man.cgi?query=cups&apropos=0&sektion=0&manpath=FreeBSD+12.1-RELEASE+and+Ports&arch=default&format=html cups] - a standards-based, open source printing system | + | |lpd_enable="NO"|| |
| |- | | |- |
− | |dsbmd_enable="NO"||DSBMD - a media mounting daemon/automounter for FreeBS, [https://www.freshports.org/sysutils/dsbmd DSBMD] is a media/filesystem type detecting daemon that allows clients to mount storage devices. | + | |cupsd_enable="YES"|| |
| |- | | |- |
− | |kldload_vbox="vboxdrv"||kldload -- load the ''vboxdrv'' kernel module into the kernel, to use VirtualBox | + | |dsbmd_enable="NO"|| |
| |- | | |- |
− | |vboxnet_enable="YES"||VirtualBox network adapter | + | |hald_enable="YES"|| |
| |- | | |- |
− | |vboxguest_enable="YES"||[https://www.freebsd.org/doc/handbook/virtualization-guest-virtualbox.html Guest on VirtualBox] | + | |kldload_vbox="vboxdrv"|| |
| |- | | |- |
− | |vboxservice_enable="YES"||[https://www.freebsd.org/doc/handbook/virtualization-guest-virtualbox.html Guest on VirtualBox] | + | |vboxnet_enable="YES"|| |
| |- | | |- |
− | |ifconfig_em0="DHCP"||[https://www.freebsd.org/cgi/man.cgi?query=ifconfig&sektion=8&apropos=0&manpath=FreeBSD+12.1-RELEASE+and+Ports ifconfig] -- configure network interface parameters | + | |vboxguest_enable="YES"|| |
| |- | | |- |
− | |webcamd_enable="YES"||# enable use of the webcam daemon software | + | |vboxservice_enable="YES"|| |
| |- | | |- |
− | |rc_debug="YES" | + | |ifconfig_em0="DHCP"|| |
− | rc_info="YES"
| + | |} |
− | || Add either or both entries to debug rc.conf startup when booting. Displays messages for you to see where boot fails. You can check output from dmesg or view file /var/log/messages | + | |
− | |-} | + | |
| | | |
| | | |