Differential D27411 Diff 80308 share/man/man5/rc.conf.5

Changeset View

Standalone View

share/man/man5/rc.conf.5

.\" 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 December 2, 2020

.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

yuripvUnsubmitted

Done

i 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 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

yuripvUnsubmitted

Done

i 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 353 Lines • ▼ Show 20 Lines

A A

.Va gifconfig_ Ns Aq Ar interface .Va gifconfig_ Ns Aq Ar interface

variable is assumed to exist for each value of variable is assumed to exist for each value of

.Ar interface . .Ar interface .

The value of this variable is used to configure the link layer of the The value of this variable is used to configure the link layer of the

tunnel using the tunnel using the

.Cm tunnel .Cm tunnel

option to option to

.Xr ifconfig . .Xr ifconfig 8 .

Additionally, this option ensures that each listed interface is created Additionally, this option ensures that each listed interface is created

via the via the

.Cm create .Cm create

option to option to

.Xr ifconfig .Xr ifconfig 8

before attempting to configure it. before attempting to configure it.

.Pp .Pp

For example, configure two For example, configure two

.Xr gif .Xr gif 4

interfaces with: interfaces with:

.Bd -literal .Bd -literal

gif_interfaces="gif0 gif1" gif_interfaces="gif0 gif1"

gifconfig_gif0="100.64.0.1 100.64.0.2" gifconfig_gif0="100.64.0.1 100.64.0.2"

ifconfig_gif0="inet 10.0.0.1 10.0.0.2 netmask 255.255.255.252" ifconfig_gif0="inet 10.0.0.1 10.0.0.2 netmask 255.255.255.252"

gifconfig_gif1="inet6 2a00::1 2a01::1" gifconfig_gif1="inet6 2a00::1 2a01::1"

ifconfig_gif1="inet 10.1.0.1 10.1.0.2 netmask 255.255.255.252" ifconfig_gif1="inet 10.1.0.1 10.1.0.2 netmask 255.255.255.252"

.Ed .Ed

▲ Show 20 Lines • Show All 256 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.

.\" ----- syslogd setting -----------------------------------

0mpUnsubmitted

Done

I 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…

.It Va syslogd_enable .It Va syslogd_enable

.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

.Va syslogd_flags .

pauamma_gundo.comUnsubmitted

Done

.Pa var/run .

- To make this actually useful, it is recommend to add

+ For this to be useful, adding

.Dq Li -H

- .Va syslogd_flags .

+ .Va syslogd_flags is recommended.

This way, the log lines will carry the jail's

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

.Va syslogd_flags .

- This way, the log lines will carry the jail's

+ This way, the log lines will include the jail's

.Va host.hostname .

pauamma_gundo.com:

.Va host.hostname .

.\" ----- inetd setting -----------------------------------

.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

yuripvUnsubmitted

Done

same 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 680 Lines • ▼ Show 20 Lines

.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 makewhatis 8 ,

yuripvUnsubmitted

Done

SEE ALSO is sorted by section first, move it below.

yuripv: SEE ALSO is sorted by section first, move it below.

.Xr sh 1 , .Xr sh 1 ,

.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 ,

▲ Show 20 Lines • Show All 88 Lines • Show Last 20 Lines