Debian Codegraph @

upstream/debian-unstable/man8/autolog.8

raw
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]>