Changeset View
Changeset View
Standalone View
Standalone View
share/man/man5/rc.conf.5
Show All 18 Lines | |||||||||||||
.\" 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. | ||||||||||||
.\" | .\" | ||||||||||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||||||||||
.\" | .\" | ||||||||||||
.Dd Sep 21, 2020 | .Dd January 8, 2021 | ||||||||||||
.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 1,336 Lines • ▼ Show 20 Lines | ifconfig_em0_aliases="\\ | ||||||||||||
inet 127.0.0.252 netmask 0xffffffff \\ | inet 127.0.0.252 netmask 0xffffffff \\ | ||||||||||||
inet 127.0.0.253 netmask 0xffffffff \\ | inet 127.0.0.253 netmask 0xffffffff \\ | ||||||||||||
inet 127.0.0.254 netmask 0xffffffff" | inet 127.0.0.254 netmask 0xffffffff" | ||||||||||||
.Ed | .Ed | ||||||||||||
.Pp | .Pp | ||||||||||||
It also supports CIDR notation. | It also supports CIDR notation. | ||||||||||||
.Pp | .Pp | ||||||||||||
If the | If the | ||||||||||||
.Pa /etc/start_if. Ns Aq Ar interface | .Pa /etc/start_if. Ns Aq Ar interface | ||||||||||||
yuripv: i think you want `Ns` before `.` (might need to escape it as `\&.` if mandoc lint whines). | |||||||||||||
file is present, it is read and executed by the | file is present, it is read and executed by the | ||||||||||||
.Xr sh 1 | .Xr sh 1 | ||||||||||||
interpreter | interpreter | ||||||||||||
before configuring the interface as specified in the | before configuring the interface as specified in the | ||||||||||||
.Va ifconfig_ Ns Aq Ar interface | .Va ifconfig_ Ns Aq Ar interface | ||||||||||||
and | and | ||||||||||||
.Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n | .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n | ||||||||||||
variables. | variables. | ||||||||||||
▲ Show 20 Lines • Show All 109 Lines • ▼ Show 20 Lines | |||||||||||||
variable. | variable. | ||||||||||||
.Xr hostapd 8 | .Xr hostapd 8 | ||||||||||||
will use the settings from | will use the settings from | ||||||||||||
.Pa /etc/hostapd- Ns Ao Ar interface Ac Ns .conf | .Pa /etc/hostapd- Ns Ao Ar interface Ac Ns .conf | ||||||||||||
.Pp | .Pp | ||||||||||||
Finally, you can add | Finally, you can add | ||||||||||||
.Xr ifconfig 8 | .Xr ifconfig 8 | ||||||||||||
options in this variable, in addition to the | options in this variable, in addition to the | ||||||||||||
.Pa /etc/start_if. Ns Aq Ar interface | .Pa /etc/start_if. Ns Aq Ar interface | ||||||||||||
Done Inline Actionsi think you want Ns before . (might need to escape it as \&. if mandoc lint whines). yuripv: i think you want `Ns` before `.` (might need to escape it as `\&.` if mandoc lint whines). | |||||||||||||
file. | file. | ||||||||||||
For instance, to configure an | For instance, to configure an | ||||||||||||
.Xr ath 4 | .Xr ath 4 | ||||||||||||
wireless device in station mode with an address obtained | wireless device in station mode with an address obtained | ||||||||||||
via DHCP, using WPA authentication and 802.11b mode, it is | via DHCP, using WPA authentication and 802.11b mode, it is | ||||||||||||
possible to use something like: | possible to use something like: | ||||||||||||
.Bd -literal | .Bd -literal | ||||||||||||
wlans_ath0="wlan0" | wlans_ath0="wlan0" | ||||||||||||
▲ Show 20 Lines • Show All 635 Lines • ▼ Show 20 Lines | |||||||||||||
a whitespace-separated list of network file system descriptor pairs, | a whitespace-separated list of network file system descriptor pairs, | ||||||||||||
each consisting of a file system type as passed to | each consisting of a file system type as passed to | ||||||||||||
.Xr mount 8 | .Xr mount 8 | ||||||||||||
and a human-readable, one-word description, | and a human-readable, one-word description, | ||||||||||||
joined with a colon | joined with a colon | ||||||||||||
.Pq Ql \&: . | .Pq Ql \&: . | ||||||||||||
Extending the default list in this way is only necessary | Extending the default list in this way is only necessary | ||||||||||||
when third party file system types are used. | when third party file system types are used. | ||||||||||||
.It Va syslogd_enable | .It Va syslogd_enable | ||||||||||||
Done Inline ActionsI think this line is unnecessary in this patch. We may think about adding section separators like this in a separate commit for all the other sections we have in this file. 0mp: I think this line is unnecessary in this patch. We may think about adding section separators… | |||||||||||||
.Pq Vt bool | .Pq Vt bool | ||||||||||||
If set to | If set to | ||||||||||||
.Dq Li YES , | .Dq Li YES , | ||||||||||||
run the | run the | ||||||||||||
.Xr syslogd 8 | .Xr syslogd 8 | ||||||||||||
daemon. | daemon. | ||||||||||||
.It Va syslogd_program | .It Va syslogd_program | ||||||||||||
.Pq Vt str | .Pq Vt str | ||||||||||||
Path to | Path to | ||||||||||||
.Xr syslogd 8 | .Xr syslogd 8 | ||||||||||||
(default | (default | ||||||||||||
.Pa /usr/sbin/syslogd ) . | .Pa /usr/sbin/syslogd ) . | ||||||||||||
.It Va syslogd_flags | .It Va syslogd_flags | ||||||||||||
.Pq Vt str | .Pq Vt str | ||||||||||||
If | If | ||||||||||||
.Va syslogd_enable | .Va syslogd_enable | ||||||||||||
is set to | is set to | ||||||||||||
.Dq Li YES , | .Dq Li YES , | ||||||||||||
these are the flags to pass to | these are the flags to pass to | ||||||||||||
.Xr syslogd 8 . | .Xr syslogd 8 . | ||||||||||||
Defaults to | |||||||||||||
.Dq Li -s . | |||||||||||||
.It Va altlog_proglist | |||||||||||||
.Pq Vt list | |||||||||||||
List of chrooted applications which will have a log socket placed in their | |||||||||||||
.Pa var/run . | |||||||||||||
.It Va altlog_jaillist | |||||||||||||
.Pq Vt list | |||||||||||||
List of jails which will have log sockets placed in their | |||||||||||||
.Pa var/run . | |||||||||||||
To make this actually useful, it is recommend to add | |||||||||||||
.Dq Li -H | |||||||||||||
to | |||||||||||||
.Va syslogd_flags . | |||||||||||||
pauamma_gundo.comUnsubmitted Done Inline Actions
If you don't go for this, you still need to s/recommend/recommended/. And maybe "add ..." instead of "adding .... is recommended", but that's arguably taste. pauamma_gundo.com: If you don't go for this, you still need to s/recommend/recommended/.
And maybe "add ..."… | |||||||||||||
This way, the log lines will carry the jail's | |||||||||||||
pauamma_gundo.comUnsubmitted Not Done Inline Actions
pauamma_gundo.com: | |||||||||||||
.Va host.hostname . | |||||||||||||
.It Va inetd_enable | .It Va inetd_enable | ||||||||||||
.Pq Vt bool | .Pq Vt bool | ||||||||||||
If set to | If set to | ||||||||||||
.Dq Li YES , | .Dq Li YES , | ||||||||||||
run the | run the | ||||||||||||
.Xr inetd 8 | .Xr inetd 8 | ||||||||||||
daemon. | daemon. | ||||||||||||
.It Va inetd_program | .It Va inetd_program | ||||||||||||
▲ Show 20 Lines • Show All 1,704 Lines • ▼ Show 20 Lines | |||||||||||||
.Li jail_vjail_hostname . | .Li jail_vjail_hostname . | ||||||||||||
These per-jail configuration variables are now obsolete in favor of | These per-jail configuration variables are now obsolete in favor of | ||||||||||||
.Xr jail 8 | .Xr jail 8 | ||||||||||||
configuration file. | configuration file. | ||||||||||||
For backward compatibility, | For backward compatibility, | ||||||||||||
when per-jail configuration variables are defined, | when per-jail configuration variables are defined, | ||||||||||||
.Xr jail 8 | .Xr jail 8 | ||||||||||||
configuration files are created as | configuration files are created as | ||||||||||||
.Pa /var/run/jail. Ns Ao Ar jname Ac Ns Pa .conf | .Pa /var/run/jail. Ns Ao Ar jname Ac Ns Pa .conf | ||||||||||||
Done Inline Actionssame Ns note, so you don't break the path in parts. yuripv: same `Ns` note, so you don't break the path in parts. | |||||||||||||
and used. | and used. | ||||||||||||
.Pp | .Pp | ||||||||||||
The following per-jail parameters are handled by | The following per-jail parameters are handled by | ||||||||||||
.Pa rc.d/jail | .Pa rc.d/jail | ||||||||||||
script out of their corresponding | script out of their corresponding | ||||||||||||
.Nm | .Nm | ||||||||||||
variables. | variables. | ||||||||||||
In addition to them, parameters in | In addition to them, parameters in | ||||||||||||
▲ Show 20 Lines • Show All 679 Lines • ▼ Show 20 Lines | |||||||||||||
.It Pa /etc/defaults/vendor.conf | .It Pa /etc/defaults/vendor.conf | ||||||||||||
.It Pa /etc/rc.conf | .It Pa /etc/rc.conf | ||||||||||||
.It Pa /etc/rc.conf.local | .It Pa /etc/rc.conf.local | ||||||||||||
.El | .El | ||||||||||||
.Sh SEE ALSO | .Sh SEE ALSO | ||||||||||||
.Xr chmod 1 , | .Xr chmod 1 , | ||||||||||||
.Xr gdb 1 , | .Xr gdb 1 , | ||||||||||||
.Xr info 1 , | .Xr info 1 , | ||||||||||||
.Xr kbdcontrol 1 , | .Xr kbdcontrol 1 , | ||||||||||||
.Xr makewhatis 1 , | |||||||||||||
.Xr sh 1 , | .Xr sh 1 , | ||||||||||||
Done Inline ActionsSEE ALSO is sorted by section first, move it below. yuripv: SEE ALSO is sorted by section first, move it below. | |||||||||||||
.Xr vi 1 , | .Xr vi 1 , | ||||||||||||
.Xr vidcontrol 1 , | .Xr vidcontrol 1 , | ||||||||||||
.Xr bridge 4 , | .Xr bridge 4 , | ||||||||||||
.Xr dummynet 4 , | .Xr dummynet 4 , | ||||||||||||
.Xr ip 4 , | .Xr ip 4 , | ||||||||||||
.Xr ipf 4 , | .Xr ipf 4 , | ||||||||||||
.Xr ipfw 4 , | .Xr ipfw 4 , | ||||||||||||
.Xr ipnat 4 , | .Xr ipnat 4 , | ||||||||||||
Show All 31 Lines | |||||||||||||
.Xr iovctl 8 , | .Xr iovctl 8 , | ||||||||||||
.Xr ipf 8 , | .Xr ipf 8 , | ||||||||||||
.Xr ipfw 8 , | .Xr ipfw 8 , | ||||||||||||
.Xr ipnat 8 , | .Xr ipnat 8 , | ||||||||||||
.Xr jail 8 , | .Xr jail 8 , | ||||||||||||
.Xr kldxref 8 , | .Xr kldxref 8 , | ||||||||||||
.Xr loader 8 , | .Xr loader 8 , | ||||||||||||
.Xr lpd 8 , | .Xr lpd 8 , | ||||||||||||
.Xr makewhatis 8 , | |||||||||||||
.Xr mdconfig 8 , | .Xr mdconfig 8 , | ||||||||||||
.Xr mdmfs 8 , | .Xr mdmfs 8 , | ||||||||||||
.Xr mixer 8 , | .Xr mixer 8 , | ||||||||||||
.Xr mountd 8 , | .Xr mountd 8 , | ||||||||||||
.Xr moused 8 , | .Xr moused 8 , | ||||||||||||
.Xr newfs 8 , | .Xr newfs 8 , | ||||||||||||
.Xr newsyslog 8 , | .Xr newsyslog 8 , | ||||||||||||
.Xr nfsd 8 , | .Xr nfsd 8 , | ||||||||||||
Show All 40 Lines |
i think you want Ns before . (might need to escape it as \&. if mandoc lint whines).