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>

Unix                                               27 Mar 2005                                       AND.CONF(5)