annotate core/rc/rc.7 @ 630:58211c615a8c

core/rc: add basic rc.networking support
author David Demelier <markand@malikania.fr>
date Tue, 23 Jul 2019 23:00:00 +0200
parents b8fa19b6a221
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
585
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 .\"
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 .\" Copyright (c) 2019 David Demelier <markand@malikania.fr>
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 .\"
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
4 .\" Permission to use, copy, modify, and/or distribute this software for any
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 .\" purpose with or without fee is hereby granted, provided that the above
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 .\" copyright notice and this permission notice appear in all copies.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 .\"
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 .\"
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 .Dd July 08, 2019
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 .Dt RC 7
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
18 .Os
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 .Sh NAME
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
20 .Nm rc
595
b8fa19b6a221 vanilla: fix naming style
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
21 .Nd Vanilla Linux init scripts
585
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
22 .Sh DESCRIPTION
630
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 595
diff changeset
23 Vanilla Linux runs either
585
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
24 .Ar busybox
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
25 or
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
26 .Ar sysvinit
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
27 init daemons. The former one is more minimalistic and does not support runlevels
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
28 while sysvinit is more traditional.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
29 .Sh FILES AND DIRECTORIES
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 All files specified here are user editable and protected by
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
31 .Nm vpk .
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
32 Therefore, you can safely edit them for your own purposes.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
33 .Pp
630
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 595
diff changeset
34 The following files and directories are understood by Vanilla Linux init
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 595
diff changeset
35 process:
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 595
diff changeset
36 .Bl -tag -width 18n
585
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
37 .It Pa /etc/rc.conf
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 The global configuration file for system initialization and basic configuration.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
39 See
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 .Xr rc.conf 5
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
41 for more details.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
42 .It Pa /etc/rc.init
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
43 File executed early by boot process to perform the machine initialization. It
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
44 mounts filesystem, checks devices sets configuration from
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
45 .Pa /etc/rc.conf
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
46 file.
630
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 595
diff changeset
47 .It Pa /etc/rc.networking
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 595
diff changeset
48 Enable network interfaces and configure them. Called just before starting user
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 595
diff changeset
49 services and mostly used for static address scenarios.
585
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
50 .It Pa /etc/rc.start
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 This script is executed after the initialization and start users services. It
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
52 takes a runlevel number as argument which is in the range 0-6.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
53 .It Pa /etc/rc.shutdown
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
54 This file is executed when the machine is going off. Its purpose is to shutdown
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
55 all processed, unmount filesystem and halts the machine.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 .El
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 .Sh SEE ALSO
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 .Xr rc.conf 5