summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man5/autolog.conf.5
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:43:11 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:43:11 +0000
commitfc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch)
treece1e3bce06471410239a6f41282e328770aa404a /upstream/debian-unstable/man5/autolog.conf.5
parentInitial commit. (diff)
downloadmanpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz
manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/debian-unstable/man5/autolog.conf.5')
-rw-r--r--upstream/debian-unstable/man5/autolog.conf.5114
1 files changed, 114 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man5/autolog.conf.5 b/upstream/debian-unstable/man5/autolog.conf.5
new file mode 100644
index 00000000..75da4a7c
--- /dev/null
+++ b/upstream/debian-unstable/man5/autolog.conf.5
@@ -0,0 +1,114 @@
+.TH autolog.conf 5 "Configuration Files" "Linux" \" -*- nroff -*-
+.SH NAME
+autolog.conf \- Configuration file for the autolog command
+.SH DESCRIPTION
+The configuration file consists of multiple lines, each of which describes
+a class of processes subject (or not subject) to a certain auto logout
+procedure. A line consists of any number of switches. Value switches are
+of the form: "name=value". Boolean switches are of the form: "name" or
+"noname".
+.PP
+Using these switches, you can define a username, a group, and a tty line.
+These descriptions can contain wildcard characters (regular expressions).
+You can also define an idle time, a grace period and a few other options.
+When reading the configuration file, the program creates a record for each
+configuration line. A value is assigned to each variable in the record
+regardless of whether or not you specify one explicitly. Values for
+missing variables are provided by defaults which are compiled in and can
+be modified from the command line.
+.PP
+If no entries are found matching a given process, that process will be
+spared from an untimely demise. Therefore, it is a good idea to always
+have a "cleanup" line at the end of the configuration file to catch
+anything that might have been missed by the more explicit definitions.
+Since the default name, group, and line are all ".+", a simple line like:
+
+ idle=30
+
+will do. Actually, any one switch can be specified on the line and all the
+others will get the default values.
+.PP
+If no configuration file is found, the program will create a single
+entry which has all values set from the defaults. This entry will match
+any process on any port (name=.+ line=.+ group=.+). Therefore, the default
+action is to kill all processes.
+.SH ENTRIES
+.TP
+.B name=
+A regular expression specifying which username(s) to match.
+.TP
+.B group=
+A regular expression specifying which group(s) to match.
+.TP
+.B line=
+A regular expression specifying which tty line(s) to match.
+Omit the "/dev/" part of the special name.
+.TP
+.B idle=
+An integer specifying the number of \-\-minutes\-\- of idle
+(or connect) time to allow before beginning automatic logoff.
+An idle time of 0 exempts the process from automatic logoff.
+.TP
+.B grace=
+An integer specifying the number of \-\-seconds\-\- from the initial
+warning to killing the process.
+.TP
+.B ban=
+An integer specifying the number of \-\-minutes\-\- from killing the process
+to the moment, the user may login again. (after exceeding his session).
+
+.TP
+.B hard
+A boolean value indicating total connect time will be
+considered rather than idle time.
+.TP
+.B mail
+A boolean value indicating that mail will be sent to the
+user explaining that he was killed.
+.TP
+.B clear
+A boolean value indicating that the screen will be cleared
+before a warning message is sent.
+.TP
+.B warn
+A boolean value indicating that a warning message will be
+sent at the beginning of the "grace" period.
+.TP
+.B log
+A boolean value indicating that activities will be logged
+to the logfile (if it exists).
+
+.SH FURTHER ENTRIES
+.PP
+There is another group of entries, which allows one to set some
+general options. Each of them takes a whole line.
+Don't mix them with the other entries from before.
+.TP
+.B nolostkill
+A boolean value indicating whether lost processes should be killed.
+If there is a process with uid between 500 and 60000 and the owner
+is not logged in, it is assumed as lost and will be killed.
+
+.TP
+.B ps=command
+on some strange or old systems the ps-command has different parameters.
+This makes it possible to set a completely different command. It is only
+important, that this command delivers one heading line and then lines
+with usernames and process-ids (pid). e.g.: ps=ps aux
+
+.SH EXAMPLE
+ name=root line=tty[1-7] idle=0
+ name=guest idle=5 grace=60 nomail hard warn
+ group=lynx-.* idle=10 grace=60 clear
+ idle=60 grace=30
+
+.SH AUTHOR
+Kyle Bateman <kyle@actarg.com> (autolog 0.35),
+.PD 0
+.TP
+James Dingwall <james.dingwall@zynstra.com>
+.TP
+ (autolog 0.41)
+.PD
+.PP
+This manual page was modified for \fBDebian\fP by Paul Telford <pxt@debian.org>