-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathautolog.conf.5
87 lines (85 loc) · 3.07 KB
/
autolog.conf.5
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
.TH autolog.conf 1L "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 ENTRYS
.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 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 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 SEE ALSO
.BR autolog (8)
.SH AUTHOR
.PD 0
Kyle Bateman <[email protected]>
.PP
Alexander Bergmann <[email protected]>
.PD