mirror of
https://github.com/troglobit/finit.git
synced 2026-11-19 19:40:50 +00:00
README: Further updates and corrections to inetd syntax.
Signed-off-by: Joachim Nilsson <troglobit@gmail.com>
This commit is contained in:
1 parent
1f19b50846
commit
54ace1a6cf
1 file changed
+26
-16
@@ -62,7 +62,7 @@ Start, monitor and restart processes (daemons) if they fail.
|
|||||||
|
|
||||||
**Inetd**
|
**Inetd**
|
||||||
|
|
||||||
Finit comes with an `inetd` server built-in. No need to maintain a
|
Finit comes with a built-in `inetd` server. No need to maintain a
|
||||||
separate config file for services that you want to start on demand.
|
separate config file for services that you want to start on demand.
|
||||||
|
|
||||||
All inetd services started can be filtered per port and inbound
|
All inetd services started can be filtered per port and inbound
|
||||||
@@ -75,7 +75,7 @@ Runlevels are optional in Finit, but support for [SysV runlevels][5] is
|
|||||||
available if needed. All services in runlevel S(1) are started first,
|
available if needed. All services in runlevel S(1) are started first,
|
||||||
followed by the desired run-time runlevel. Runlevel S can be started in
|
followed by the desired run-time runlevel. Runlevel S can be started in
|
||||||
sequence by using `run [S] cmd`. Changing runlevels at runtime is done
|
sequence by using `run [S] cmd`. Changing runlevels at runtime is done
|
||||||
like any other init, e.g. <kbd>init 4</kbd>.
|
like any other init, e.g. <kbd>init 4</kbd>
|
||||||
|
|
||||||
|
|
||||||
**Plugins**
|
**Plugins**
|
||||||
@@ -92,7 +92,7 @@ Plugin capabilities:
|
|||||||
* Task/Run callbacks -- a one-shot commands, executed in sequence
|
* Task/Run callbacks -- a one-shot commands, executed in sequence
|
||||||
* Hooks -- hook into the boot at predefined points to extend finit
|
* Hooks -- hook into the boot at predefined points to extend finit
|
||||||
* I/O -- listen to external events and control finit behavior/services
|
* I/O -- listen to external events and control finit behavior/services
|
||||||
* Inetd -- extend with internal inetd services
|
* Inetd -- extend with internal inetd services, see `plugins/time.c`
|
||||||
|
|
||||||
Extensions and functionality not purely related to what an `/sbin/init`
|
Extensions and functionality not purely related to what an `/sbin/init`
|
||||||
needs to start a system are available as a set of plugins that either
|
needs to start a system are available as a set of plugins that either
|
||||||
@@ -150,23 +150,32 @@ Syntax:
|
|||||||
|
|
||||||
Service, or daemon, to be monitored and automatically restarted if it
|
Service, or daemon, to be monitored and automatically restarted if it
|
||||||
exits prematurely. Please note that you often need to provide a
|
exits prematurely. Please note that you often need to provide a
|
||||||
--foreground or --no-background argument to most daemons to prevent
|
`--foreground` or `--no-background` argument to most daemons to
|
||||||
them from forking off to the background.
|
prevent them from forking off a sub-process in the background.
|
||||||
|
|
||||||
* `inetd SVC[@iface[:port]]/PROTO <wait|nowait> [LVLS] /path/to/daemon args`
|
* `inetd service/proto[@iflist] <wait|nowait> [LVLS] /path/to/daemon args`
|
||||||
|
|
||||||
Launch daemon on demand when a client initiates a connection to `SVC`.
|
Launch a daemon when a client initiates a connection on an Internet
|
||||||
Services (SVC) are specified in the standard UNIX `/etc/services`
|
port. Available services are listed in the UNIX `/etc/services` file.
|
||||||
file. With optional filtering for `iface` and possible custom `port`.
|
Finit can filter access to from a list of interfaces, `@iflist`, per
|
||||||
|
inetd service as well as listen to custom ports.
|
||||||
|
|
||||||
The following example opens port 2323 and only allows inbound telnet
|
inetd ftp/tcp nowait @root /usr/sbin/uftpd -i -f
|
||||||
connections from `eth0`:
|
inetd tftp/udp wait @root /usr/sbin/uftpd -i -t
|
||||||
|
|
||||||
inetd telnet@eth0:2323/tcp nowait [2345] /sbin/telnetd -i -F
|
The following example listens to port 2323 for telnet connections and
|
||||||
|
only allows clients connecting from `eth0`:
|
||||||
|
|
||||||
|
inetd 2323/tcp@eth0 nowait [2345] /sbin/telnetd -i -F
|
||||||
|
|
||||||
|
The interface list, `@iflist`, is of the format `@iface,!iface,iface`,
|
||||||
|
where a single `!` means to deny access. Notice how interfaces are
|
||||||
|
comma separated with no spaces.
|
||||||
|
|
||||||
The `inetd` directive can also have ` -- Optional Description`, only
|
The `inetd` directive can also have ` -- Optional Description`, only
|
||||||
Finit does not output this text on the console when launching inetd
|
Finit does not output this text on the console when launching inetd
|
||||||
services. Instead this text is sent to syslog. More on inetd below.
|
services. Instead this text is sent to syslog and also shown by the
|
||||||
|
`initctl` tool. More on inetd below.
|
||||||
|
|
||||||
* `runparts <DIR>`
|
* `runparts <DIR>`
|
||||||
|
|
||||||
@@ -280,10 +289,11 @@ Bootstrap
|
|||||||
12. Set hostname and bring up loopback interface
|
12. Set hostname and bring up loopback interface
|
||||||
13. Call `network` script, if set in `/etc/finit.conf`
|
13. Call `network` script, if set in `/etc/finit.conf`
|
||||||
14. Call 3rd level hooks, `HOOK_NETWORK_UP`
|
14. Call 3rd level hooks, `HOOK_NETWORK_UP`
|
||||||
15. Switch to active runlevel, as set in `/etc/finit.conf`, default 2.
|
15. Load all `*.conf` files in `/etc/finit.d/` and switch to the active
|
||||||
Here is where the rest of all tasks and inetd services are started.
|
active runlevel, as set in `/etc/finit.conf`, default is 2. Here is
|
||||||
|
where the rest of all tasks and inetd services are started.
|
||||||
16. Call 4th level hooks, `HOOK_SVC_UP`
|
16. Call 4th level hooks, `HOOK_SVC_UP`
|
||||||
17. Run-parts in `/etc/finit.d`, if any
|
17. If `runparts <DIR>` is set, [run-parts(8)] is called on `<DIR>`
|
||||||
18. Call 5th level (last) hooks, `HOOK_SYSTEM_UP`
|
18. Call 5th level (last) hooks, `HOOK_SYSTEM_UP`
|
||||||
19. Start TTYs defined in `/etc/finit.conf`, or rescue on `/dev/console`
|
19. Start TTYs defined in `/etc/finit.conf`, or rescue on `/dev/console`
|
||||||
20. Enter main monitor loop
|
20. Enter main monitor loop
|
||||||
|
|||||||
Reference in new issue
Block a user