| 1 |
.TH AUTOLOG 8 "Administrative Utilities" "Linux" \" -*- nroff -*- |
| 2 |
.SH NAME |
| 3 |
autolog \- Log out idle users |
| 4 |
.SH SYNOPSIS |
| 5 |
\fBautolog\fP [ \fBoptions\fP ] |
| 6 |
.br |
| 7 |
.SH DESCRIPTION |
| 8 |
The program reads the utmp file, entry by entry. The |
| 9 |
username for each 'user process' is compared to the entries in the |
| 10 |
configuration file (see |
| 11 |
.B autolog.conf(5) |
| 12 |
). The first entry to match both the name, the group, |
| 13 |
and the tty line of the process will be used to conduct the automatic |
| 14 |
logout. |
| 15 |
|
| 16 |
.SH CALL |
| 17 |
.TP |
| 18 |
.B /etc/init.d/autolog start |
| 19 |
.PD 0 |
| 20 |
.TP |
| 21 |
or |
| 22 |
.TP |
| 23 |
.B autolog |
| 24 |
to run this program in daemon-mode |
| 25 |
.PD |
| 26 |
.TP |
| 27 |
.B autolog -o |
| 28 |
to run this program as "ordinary" program. |
| 29 |
Keep in mind: Also when running as ordinary program, |
| 30 |
it will stay in memory until all its jobs are done. |
| 31 |
|
| 32 |
.SH OPTIONS |
| 33 |
.TP |
| 34 |
.B -a |
| 35 |
(all processes) Print information on ALL utmp entries--not just user processes. |
| 36 |
.TP |
| 37 |
.B -d |
| 38 |
(debug mode) This is helpful in setting up your configuration file. |
| 39 |
The program runs in foreground rather than forking and it prints |
| 40 |
out verbose messages about what it is doing. |
| 41 |
.TP |
| 42 |
.B -n |
| 43 |
(nokill) Use this to prevent autolog from actually "killing" |
| 44 |
anyone. Use \-d and \-n together when setting up a new |
| 45 |
configuration file. |
| 46 |
( This will not affect killing of lost processes. ) |
| 47 |
.TP |
| 48 |
.B -o |
| 49 |
(ordinary) Use this to run this program as ordinary |
| 50 |
program, not as daemon. Program will end, when its |
| 51 |
job is done. In this case, some data is kept in |
| 52 |
"/var/lib/autolog/autolog.data". This is read, when the program |
| 53 |
is called again. |
| 54 |
.TP |
| 55 |
.B -f config_file_name |
| 56 |
Use this to override the default: "/etc/autolog.conf" |
| 57 |
.TP |
| 58 |
.B -l log_file_name |
| 59 |
Use this to override the default: "/var/log/autolog.log". |
| 60 |
Note that if this file doesn't exist, no logging will happen. |
| 61 |
Create the file (with touch) to enable logging. |
| 62 |
.TP |
| 63 |
.B -t idle_time |
| 64 |
Use this to override the internal default idle time (minutes) |
| 65 |
.TP |
| 66 |
.B -g grace_period |
| 67 |
Use this to override the internal default grace period (seconds) |
| 68 |
.TP |
| 69 |
.B -m yes/no |
| 70 |
Use this to override the internal mailing switch. If "yes" |
| 71 |
the program will send mail to the users right after killing them. |
| 72 |
.TP |
| 73 |
.B -c yes/no |
| 74 |
Use this to override the internal "pre-clear" switch. If "yes" |
| 75 |
the program will clear the terminal screen before warning the user. |
| 76 |
.TP |
| 77 |
.B -w yes/no |
| 78 |
Do timeouts based on total session time--not idle time. (hard) |
| 79 |
.TP |
| 80 |
.B -l yes/no |
| 81 |
If set to "yes" activities will be written to the logfile if |
| 82 |
present. |
| 83 |
|
| 84 |
.SH AUTHOR |
| 85 |
Kyle Bateman <[email protected]> (autolog 0.35), |
| 86 |
.PD 0 |
| 87 |
.TP |
| 88 |
James Dingwall <[email protected]> |
| 89 |
.TP |
| 90 |
(autolog 0.42.2) |
| 91 |
.PD |
| 92 |
.PP |
| 93 |
This manual page was modified for \fBDebian\fP by Paul Telford <[email protected]> |