NAME

       /etc/and.conf - general configuration parameters for the auto nice daemon.

VERSION

       This manual page documents and.conf for and version 1.2.2.

DESCRIPTION

       This  is the general configuration file for and.  It stores settings like the default nice
       level, the renice intervals, the three  stages  of  renicing,  and  the  affinity  of  the
       priority  database,  i.e.  the weight of (user, group, command) when resolving nice levels
       from the database. These settings are described below.

       Comments start with a # in the first column.  Empty lines are ignored. Unlike  with  other
       configuration files, lines cannot be concatenated with a backslash. Furthermore, this file
       is case sensitive.

       and allows for host-specific sections in the configuration file. These work  as  lines  of
       the  form  on  somehost  and  work  as follows: the parser determines if the host name (as
       returned by gethostname) matches the extended  regular  expression  that  follows  the  on
       keyword.  If  it does, it just keeps processing the file as if nothing had happened. If it
       does not match, however, everything up to the next on keyword is skipped. So if  you  want
       to  end a host-specific section, you must write on .*  (which matches all hosts) to switch
       back to normal.

       Don't forget to kill -HUP the auto nice daemon to enable the changes.

SETTINGS

       defaultnice
            The default nice level. A number between 0 and 19. Jobs for which  no  entry  can  be
            found  in  /etc/and.priorities  are reniced to this level, regardless of the CPU time
            they've used so far. If you prefer to renice unknown jobs gradually, you can do so by
            supplying  three  asterisks  as  (user, group, command) tuple in /etc/and.priorities.
            The default nice level is 0

       interval
            The default interval between nice checks of the auto nice daemon,  in  seconds.  This
            value  can  be overridden by the -i command-line option of and.  The default interval
            is 60 seconds.

       lv1time

       lv2time

       lv3time
            Ranges for the nice levels. Jobs with less than lv1time  seconds  CPU  time  are  not
            reniced;  jobs  between lv1time and lv2time seconds are reniced to the first level in
            an.priorities; jobs between lv2time and lv3time seconds to  the  second  level;  jobs
            with  more  than  lv3time seconds are reniced to the third level.  Defaults are 120 ,
            1200 , and 3600 seconds.

       minuid, mingid
            Minimum user id and group id to be considered for renicing.  Processes whose user  id
            is  below  minuid  are  left alone, as are processes with a group id of below mingid.
            (Note that even if you set minuid to zero, root processes are left alone.)

       affinity
            Strategy for picking the right  priority  entry  for  a  user/group/job  triple.  The
            strategy  is  a permutation of "cgu", "c"ommand, "g"roup, "u"ser. The order specifies
            the affinity of the priority lookup method. Suppose you have an entry for all jobs of
            user  foo,  another  entry  for  all jobs of group bar, and yet another entry for the
            command baz.  Furthermore suppose user foo (who happens to  belong  to  group  bar  )
            starts  a  job  named  baz -- which entry should be chosen? This is what the affinity
            setting means, for example "cug" means an exact match of  the  command  has  priority
            over  both  an  exact match of the user and the group. The default affinity is "cug",
            which is probably sensible for most cases, since it's the  job  which  takes  up  CPU
            time, not the user or group ID.

EXAMPLES

       Default Configuration
            # This is the default configuration:
            defaultnice 0
            interval 60
            lv1time 300
            lv2time 1800
            lv3time 3600
            affinity cug
            minuid 0
            mingid 0

       Default Configuration, with terminals
            # Normal default configuration for all
            defaultnice 0
            interval 60
            lv1time 300
            lv2time 1800
            lv3time 3600
            # Hosts foo, bar, baz are terminals and must
            # be more responsive, so earlier renice.
            on (foo|bar)
            lv1time 120
            lv2time 600
            lv3time 1200
            on .*
            # This is for all hosts again
            affinity cug

       Group-specific Hosts
            defaultnice 0
            interval 60
            lv1time 300
            lv2time 1800
            lv3time 3600
            # Normal affinity for all hosts.
            affinity cug
            # Hosts bar, baz belong to group foo, which
            # is privileged on these hosts, so override
            # affinity. (Note regexp!)
            on ba[rz]
            affinity guc
            on .*
            minuid 500
            mingid 100

FILES

       /etc/and.conf
            General  configuration  file.  Stores default nice level, default interval, the "time
            zones" and the database lookup affinity. This is what this manual page is about.

SEE ALSO

       and(8), and.priorities(5), kill(1), regex(7), renice(8)

INTERNET

       http://and.sourceforge.net/

AUTHOR

       The  auto  nice  daemon  and  this  manual  page  were   written   by   Patrick   Schemitz
       <schemitz@users.sourceforge.net>