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 dae-
       mon.

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 pre-
	    fer	to renice unknown jobs gradually, you can do so	 by  supplying
	    three asterisks as (user, group, command) tuple in /etc/and.prior-
	    ities.  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.  Pro-
	    cesses whose user id is below minuid are left alone, as  are  pro-
	    cesses  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 be-
	    long 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 in-
	    terval, 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)

NAME | VERSION | DESCRIPTION | SETTINGS | EXAMPLES | FILES | SEE ALSO | INTERNET | AUTHOR

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

home | help