Changeset View
Changeset View
Standalone View
Standalone View
share/man/man5/rc.conf.5
| Show All 16 Lines | |||||||||
| .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | ||||||||
| .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | ||||||||
| .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||||||
| .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||||||
| .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||||||
| .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||||||
| .\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||||||
| .\" | .\" | ||||||||
| .Dd November 14, 2025 | .Dd April 2, 2026 | ||||||||
| .Dt RC.CONF 5 | .Dt RC.CONF 5 | ||||||||
| .Os | .Os | ||||||||
| .Sh NAME | .Sh NAME | ||||||||
| .Nm rc.conf | .Nm rc.conf | ||||||||
| .Nd system configuration information | .Nd system configuration information | ||||||||
| .Sh DESCRIPTION | .Sh DESCRIPTION | ||||||||
| The file | The file | ||||||||
| .Nm | .Nm | ||||||||
| ▲ Show 20 Lines • Show All 4,911 Lines • ▼ Show 20 Lines | |||||||||
| .Dq Li YES , | .Dq Li YES , | ||||||||
| some destructive actions require removal of the action-specific safe-belts | some destructive actions require removal of the action-specific safe-belts | ||||||||
| before being allowed. | before being allowed. | ||||||||
| For instance, the file | For instance, the file | ||||||||
| .Pa /var/run/noshutdown | .Pa /var/run/noshutdown | ||||||||
| is created to prevent | is created to prevent | ||||||||
| .Xr shutdown 8 | .Xr shutdown 8 | ||||||||
| targeted at the wrong machine. | targeted at the wrong machine. | ||||||||
| .It Va virtual_oss_enable | |||||||||
| .Pq Vt bool | |||||||||
| If set to | |||||||||
| .Dq Li YES , | |||||||||
| run one | |||||||||
| .Xr virtual_oss 8 | |||||||||
| instance for each configuration defined in | |||||||||
| .Pa virtual_oss_configs . | |||||||||
| .It Va virtual_oss_configs | |||||||||
| .Pq Vt str | |||||||||
| Space-separated list of | |||||||||
| .Xr virtual_oss 8 | |||||||||
| configurations. | |||||||||
| For example: | |||||||||
| .Bd -literal | |||||||||
| virtual_oss_configs="foo bar" | |||||||||
| .Ed | |||||||||
| .Pp | |||||||||
| Configurations need to be defined in | |||||||||
| .Pa virtual_oss_ Ns Aq Ar config_name . | |||||||||
| By default, there is a | |||||||||
| .Pa dsp | |||||||||
| configuration, which replaces the | |||||||||
markjUnsubmitted Done Inline Actions
markj: | |||||||||
| .Pa /dev/dsp | |||||||||
| device created by | |||||||||
| .Xr sound 4 | |||||||||
| with a | |||||||||
| .Xr virtual_oss 8 | |||||||||
| one. | |||||||||
| It can be redefined by overriding the | |||||||||
| .Pa virtual_oss_dsp | |||||||||
| variable. | |||||||||
| .It Va virtual_oss_ Ns Aq Ar config_name | |||||||||
| .Pq Vt str | |||||||||
| .Xr virtual_oss 8 | |||||||||
| argument list for configuration | |||||||||
| .Aq Ar config_name . | |||||||||
| .It Va virtual_oss_default_control_device | |||||||||
| .Pq Vt str | |||||||||
| The | |||||||||
| .Xr virtual_oss 8 | |||||||||
| control device's name corresponding to the default configuration, | |||||||||
| .Pa virtual_oss_dsp . | |||||||||
| This is set by default to | |||||||||
| .Pa vdsp.ctl . | |||||||||
| When | |||||||||
| .Pa virtual_oss_dsp | |||||||||
| is overridden, it is strongly encouraged to override this variable as well, as | |||||||||
Done Inline ActionsThe use of "override" to mean "set an rc.conf variable" sounds strange. I think these uses of that word should be replaced by plain "set" or "set in rc.conf". markj: The use of "override" to mean "set an rc.conf variable" sounds strange. I think these uses of… | |||||||||
Done Inline ActionsNo objection to this. The reason I used "override" is because these variables are set in rc.conf, but by libexec/rc/rc.d/virtual_oss, so I guess we technically do have to override them. There is similar wording in the "SERVICE JAILS" section: Typically this variable is set inside rc scripts, but it can be overridden in the rc config. christos: No objection to this. The reason I used "override" is because these variables //are// set in rc. | |||||||||
Done Inline ActionsBump. christos: Bump. | |||||||||
Done Inline ActionsI still think "set" is more clear. The documentation describes how to override default configuration by setting rc.conf variables. markj: I still think "set" is more clear. The documentation describes how to override default… | |||||||||
| it is used by other programs and scripts, such as | |||||||||
| .Pa /etc/devd/snd.conf . | |||||||||
| .El | .El | ||||||||
| .Sh SERVICE JAILS | .Sh SERVICE JAILS | ||||||||
| The service jails part of the rc system automatically puts a service | The service jails part of the rc system automatically puts a service | ||||||||
| into a jail. | into a jail. | ||||||||
| This jail inherits the filesystem and various other parts of the | This jail inherits the filesystem and various other parts of the | ||||||||
| parent (if you allow child-jails in your jails, service jails | parent (if you allow child-jails in your jails, service jails | ||||||||
| can be used in jails) depending on the content of the | can be used in jails) depending on the content of the | ||||||||
| .Ao Ar name Ac Ns Va _svcj_options | .Ao Ar name Ac Ns Va _svcj_options | ||||||||
| ▲ Show 20 Lines • Show All 204 Lines • ▼ Show 20 Lines | |||||||||
| .Xr sshd 8 , | .Xr sshd 8 , | ||||||||
| .Xr swapon 8 , | .Xr swapon 8 , | ||||||||
| .Xr sysctl 8 , | .Xr sysctl 8 , | ||||||||
| .Xr syslogd 8 , | .Xr syslogd 8 , | ||||||||
| .Xr sysrc 8 , | .Xr sysrc 8 , | ||||||||
| .Xr unbound 8 , | .Xr unbound 8 , | ||||||||
| .Xr usbconfig 8 , | .Xr usbconfig 8 , | ||||||||
| .Xr utx 8 , | .Xr utx 8 , | ||||||||
| .Xr virtual_oss 8 , | |||||||||
| .Xr wlandebug 8 , | .Xr wlandebug 8 , | ||||||||
| .Xr yp 8 , | .Xr yp 8 , | ||||||||
| .Xr ypbind 8 , | .Xr ypbind 8 , | ||||||||
| .Xr ypserv 8 , | .Xr ypserv 8 , | ||||||||
| .Xr ypset 8 | .Xr ypset 8 | ||||||||
| .Sh HISTORY | .Sh HISTORY | ||||||||
| The | The | ||||||||
| .Nm | .Nm | ||||||||
| file appeared in | file appeared in | ||||||||
| .Fx 2.2.2 . | .Fx 2.2.2 . | ||||||||
| .Sh AUTHORS | .Sh AUTHORS | ||||||||
| .An Jordan K. Hubbard . | .An Jordan K. Hubbard . | ||||||||