diff options
Diffstat (limited to 'info/gates-of-tartaros.texinfo')
| -rw-r--r-- | info/gates-of-tartaros.texinfo | 31 |
1 files changed, 15 insertions, 16 deletions
diff --git a/info/gates-of-tartaros.texinfo b/info/gates-of-tartaros.texinfo index 9d1af83..459fd9e 100644 --- a/info/gates-of-tartaros.texinfo +++ b/info/gates-of-tartaros.texinfo @@ -74,19 +74,19 @@ Texts. A copy of the license is included in the section entitled @chapter Overview Gates of Tartaros is a minimal, but extensible, replacement for -agetty written in GNU Bash. The be key feature of Gates of Tartaros -is that it lets you easily login to another computer with SSH. -@c Hence the name Gates of Tartaros, in MLP Kerberos gaurds the +agetty written in GNU Bash. The key feature of Gates of Tartaros +is that it lets you easily log in to another computer with SSH. +@c Hence the name Gates of Tartaros, in MLP Kerberos guards the @c gates of Tartaros (rather than Hades), the place where the -@c worst of pony kind gets after death, which in this analogy +@c worst of pony kind ends up after death, which in this analogy @c is where you are before SSH:ing. When SSH:ing, Kerberos -@c (perhaps more specifically Heimdall) make sure you only get +@c (perhaps more specifically Heimdall) makes sure you only get @c in if you are authorised (getting in being getting out of @c Tartaros.) -To login when Gates of Tartaros is running, just type your +To log in when Gates of Tartaros is running, just type your username, but for an SSH session, type what you would type -as the argments for @command{@value{SSH}}. Normal patterns +as the arguments for @command{@value{SSH}}. Normal patterns for SSH logins include: @itemize @@ -99,7 +99,7 @@ for SSH logins include: @node Setting up @chapter Setting up -To set up your inittab to to use Gates of Tartaros instead +To set up your inittab to use Gates of Tartaros instead of @command{agetty}, in your inittab, use the command @command{@value{SBIN}/@value{GOT}} with the first argument being the tty it should open on (@code{tty1}, @code{tty2}, @@ -123,25 +123,25 @@ c6:345:respawn:@value{SBIN}/@value{GOT} tty6 TERM=linux Extensions are loaded by Gates of Tartaros by sourcing the file @file{@value{ETC}/@value{GOT}rc} if it exists. @file{@value{ETC}/@value{GOT}rc} can change the behaviour -of Gates of Tartaros or source other files that does so. +of Gates of Tartaros or source other files that do so. The variable @code{tty} will be set from the beginning to the TTY file, without @code{@value{DEV}/}, for example @code{tty1}. -Gates of Tartaros as three functions is calls directly after -each other: @code{_display} for printing everying you see, -@code{_read} to accept username input and stores it in the +Gates of Tartaros has three functions it calls directly after +each other: @code{_display} for printing everything you see, +@code{_read} to accept username input and store it in the variable @code{user}, and then @code{_login} to start a login. Password checking is handled by external programs @command{@value{SSH}} and @command{login} that are used -doing the actual user login. You either redefine these +for doing the actual user login. You either redefine these functions, or change the variables @code{display_function}, @code{read_function} or @code{login_function} to contain the name of the functions you want to be called instead. The -latter option can be used to extend rather then replace the +latter option can be used to extend rather than replace the predefined functions. -The file @file{@value{ETC}/os-release} will have been sources +The file @file{@value{ETC}/os-release} will have been sourced before the extensions and @code{NAME} and @code{ANSI_COLOR} will have fallback values. @code{NAME} is the name of the operating system (distribution) and @code{ANSI_COLOR} @@ -154,4 +154,3 @@ is its associated colour. @include fdl.texinfo @bye - |