wt/finit
1
0 Fork 0
mirror of https://github.com/troglobit/finit.git synced 2026-11-15 19:13:11 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update finit.conf tty documentation

Browse Source 
Signed-off-by: Joachim Nilsson <troglobit@gmail.com>
This commit is contained in:
Joachim Nilsson committed 2017-09-01 06:45:29 +02:00
1 parent 8eea64cebf
commit 3e2b78305d
1 file changed
+26 -7
Download Patch File Download Diff File Expand all files Collapse all files
doc/config.md
+26 -7
View File
@@ -136,32 +136,51 @@ Syntax:
* `include <CONF>` * `include <CONF>`
Include another configuration file. Absolute path required. Include another configuration file. Absolute path required.
* `tty [LVLS] <DEV> [BAUD] [TERM] [noclear]` * `tty [LVLS] <DEV> [BAUD] [noclear] [nowait] [TERM]`
`tty [LVLS] <CMD> <ARGS>` `tty [LVLS] <CMD> <ARGS> [noclear] [nowait]`
The first variant of this option uses the built-in getty on the given The first variant of this option uses the built-in getty on the given
TTY device DEV, in the given runlevels. Default baud rate is `38400`. TTY device DEV, in the given runlevels. Default baud rate is `38400`.
**Example:** **Example:**
```conf ```conf
tty [12345] /dev/ttyAMA0 115200 noclear tty [12345] /dev/ttyAMA0 115200 noclear vt220
``` ```
The second variant is for using an external getty, like agetty or the The second variant is for using an external getty, like agetty or the
BusyBox getty. There are no default settings for this variant. BusyBox getty.
By default both variants *clear* the TTY and *wait* for the user to
press enter before starting getty.
**Example:** **Example:**
```conf ```conf
tty [12345] /sbin/getty -L 115200 /dev/ttyAMA0 vt100 tty [12345] /sbin/getty -L 115200 /dev/ttyAMA0 vt100
tty [12345] /sbin/agetty -L ttyAMA0 115200 vt100 tty [12345] /sbin/agetty -L ttyAMA0 115200 vt100 nowait
``` ```
On really bare bones systems Finit offers a fallback shell, but one The `noclear` option disables clearing the TTY after each session.
can also use the `service` stanza to start a stand-alone shell: Clearing the TTY when a user logs out is usually preferable.
The `nowait` option disables the `press Enter to activate console`
message before actually starting the getty program. On small and
embedded systems running multiple unused getty wastes both memory
and CPU cycles, so `wait` is the preferred default.
Notice the ordering, the `TERM` option to the built-in getty must be
the last argument.
On really bare bones systems Finit offers a fallback shell:
```shell ```shell
configure --enable-fallback-shell configure --enable-fallback-shell
``` ```
One can also use the `service` stanza to start a stand-alone shell:
```conf
service [12345] /bin/sh -l
```
* `console <DEV>` * `console <DEV>`
Use this, along with a matching `tty DEV` line, to mark this TTY as a Use this, along with a matching `tty DEV` line, to mark this TTY as a
special "console" port with `prctl()`. Useful in use-cases when special "console" port with `prctl()`. Useful in use-cases when