From 36b61dacfcc7ef3b7b3d4596c44eedd3ce744b7b Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 29 Oct 2014 14:51:43 +0100 Subject: doc hooks MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- info/cerberus.texinfo | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) (limited to 'info/cerberus.texinfo') diff --git a/info/cerberus.texinfo b/info/cerberus.texinfo index f2ff587..0428707 100644 --- a/info/cerberus.texinfo +++ b/info/cerberus.texinfo @@ -53,6 +53,7 @@ Texts. A copy of the license is included in the section entitled * Overview:: Brief overview of @command{cerberus}. * Invoking:: Invocation of @command{cerberus}. * Configuring:: Configuration of @command{cerberus}. +* Hooks:: Extending @command{cerberus}. * GNU Free Documentation License:: Copying and sharing this manual. @end menu @@ -114,6 +115,8 @@ make sure it is not parse as an option. Rather than configuring @command{cerberus} via an @file{/etc} file, @command{cerberus} is only configured at compile time. +However, @command{cerberus} is extensible via @file{/etc}, +see @ref{Hooks}. @command{cerberus} can be configured to the authentication method of your choose, this is done by specifing a value @@ -315,6 +318,35 @@ for adding them for non-root users. +@node Hooks +@chapter Hooks + +If @file{/etc/cerberusrc} is an executable file, +@command{cerberus} will spawn @file{/etc/cerberusrc} +on certain events. When @file{/etc/cerberusrc} is +spawned, the first argument is the name of the hook, +and the following arguments are the arguments +@command{cerberus} as started with. For example if +@command{cerberus -- twilight} (login as `twilight') +has been started, it will run +@command{/etc/cerberusrc login -- twilight} when +the user is authenticated. + +The following hooks are defined: + +@table @code +@item login +The user logs in. + +@item logout +The user is logging out. + +@item denied +The user provided an incorrect passphrase. +@end table + + + @node GNU Free Documentation License @appendix GNU Free Documentation License @include fdl.texinfo -- cgit v1.2.3-70-g09d2