bionic (5) autolog.conf.5.gz

Provided by: autolog_0.40+debian-2_amd64 bug

NAME

       autolog.conf - Configuration file for the autolog command

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".

       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.

       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.

       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.

ENTRIES

       name=  A regular expression specifying which username(s) to match.

       group= A regular expression specifying which group(s) to match.

       line=  A regular expression specifying which tty line(s) to match.  Omit the "/dev/" part of the  special
              name.

       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.

       grace= An integer specifying the number of --seconds-- from the initial warning to killing the process.

       ban=   An integer specifying the number of --minutes-- from killing the process to the moment,  the  user
              may login again. (after exceeding his session).

       hard   A boolean value indicating total connect time will be considered rather than idle time.

       mail   A boolean value indicating that mail will be sent to the user explaining that he was killed.

       clear  A boolean value indicating that the screen will be cleared before a warning message is sent.

       warn   A  boolean  value  indicating  that a warning message will be sent at the beginning of the "grace"
              period.

       log    A boolean value indicating that activities will be logged to the logfile (if it exists).

FURTHER ENTRIES

       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.

       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.

       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

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

AUTHOR

       Kyle Bateman <kyle@actarg.com> (autolog 0.35),
       Carsten Juerges <juerges@cip-bau.uni-hannover.de>
                                         (autolog 0.40)

       This manual page was modified for Debian by Paul Telford <pxt@debian.org>