xref: /original-bsd/games/dm/dm.conf.5 (revision 42c7e7a1)
1.\" Copyright (c) 1988, 1991 Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)dm.conf.5	5.8 (Berkeley) 05/10/91
7.\"
8.Dd
9.Dt DM.CONF 5
10.Os BSD 4.2
11.Sh NAME
12.Nm dm.conf
13.Nd \&dm configuration file
14.Sh DESCRIPTION
15The
16.Xr dm.conf
17file
18is the configuration file for the
19.Xr \&dm 8
20program.
21It consists of lines beginning with one of three keywords, ``badtty'',
22``game'', and ``time''.  All other lines are ignored.
23.Pp
24Any tty listed after the keyword ``badtty'' may not have games played on
25it.
26Entries consist of two white-space separated fields: the string
27``badtty'' and the ttyname as returned by
28.Xr ttyname 3 .
29For example,
30to keep the uucp dialout, ``tty19'', from being used for games, the
31entry would be:
32.Bd -literal -offset indent
33badtty	/dev/tty19
34.Ed
35.Pp
36Any day/hour combination listed after the keyword ``time'' will disallow
37games during those hours.  Entries consist of four white-space separated
38fields: the string ``time'', the unabbreviated day of the week and the
39beginning and ending time of a period of the day when games may not be
40played.  The time fields are in a 0 based, 24-hour clock.  For example,
41the following entry allows games playing before 8AM and after 5PM on
42Mondays.
43.Bd -literal -offset indent
44time		Monday	8	17
45.Ed
46.Pp
47Any game listed after the keyword ``game'' will set parameters for a specific
48game.  Entries consist of five white-space separated fields: the keyword
49``game'', the name of a game, the highest system load average at which the
50game may be played, the maximum users allowed if the game is to be played,
51and the priority at which the game is to be run.  Any of these fields may
52start with a non-numeric character, resulting in no game limitation or
53priority based on that field.  The game "default" controls the settings for
54any game not otherwise listed, and must be the last ``game'' entry in the
55file.  Priorities may not be negative.  For example, the following entries
56limits the game ``hack'' to running only when the system has 10 or less
57users and a load average of 5 or less; all other games may be run any time
58the system has 15 or less users.
59.Bd -literal -offset indent
60game		hack		5	10	*
61game		default	*	15	*
62.Ed
63.Sh FILES
64.Bl -tag -width /etc/dm.conf -compact
65.It Pa /etc/dm.conf
66The
67.Xr \&dm 8
68configuration file.
69.El
70.Sh SEE ALSO
71.Xr setpriority 2 ,
72.Xr ttyname 3 ,
73.Xr dm 8
74