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