Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AND.CONF(5)			  File Formats			     AND.CONF(5)

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. Un-
     like 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	process-
     ing  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 aster-
	  isks	as (user, group, command) tuple in /etc/and.priorities.  The de-
	  fault 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  sec-
	  onds	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 privilegued 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  inter-
	  val,	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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=and.conf&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help