xref: /original-bsd/games/dm/dm.8 (revision 93152bbe)
1.\" Copyright (c) 1987, 1991 Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)dm.8	5.11 (Berkeley) 07/23/91
7.\"
8.Dd
9.Dt DM 8
10.Os
11.Sh NAME
12.Nm dm
13.Nd dungeon master
14.Sh SYNOPSIS
15.Nm ln
16.Fl s Cm dm Ar game
17.Sh DESCRIPTION
18.Nm Dm
19is a program used to regulate game playing.
20.Nm Dm
21expects to be invoked with the name of a game that a user wishes to play.
22This is done by creating symbolic links to
23.Nm dm ,
24in the directory
25.Pa /usr/games
26for all of the regulated games.
27The actual binaries for these games should be placed in a
28.Dq hidden
29directory,
30.Pa /usr/games/hide ,
31that may only be accessed by the
32.Nm dm
33program.
34.Nm Dm
35determines if the requested game is available and, if so, runs it.
36The file
37.Pa /etc/dm.conf
38controls the conditions under which games may
39be run.
40.Pp
41The file
42.Pa /etc/nogames
43may be used to
44.Dq turn off
45game playing.
46If the file exists, no game playing is allowed; the contents of the file
47will be displayed to any user requesting a game.
48.Sh FILES
49.Bl -tag -width /var/log/games.log -compact
50.It Pa /etc/dm.conf
51configuration file
52.It Pa /etc/nogames
53turns off game playing
54.It Pa /usr/games/hide
55directory of ``real'' binaries
56.It Pa /var/log/games.log
57game logging file
58.El
59.Sh SEE ALSO
60.Xr dm.conf 5
61.Sh BUGS
62Two problems result from
63.Nm dm
64running the games setuid
65.Dq games .
66First, all games that allow users to run
67.Tn UNIX
68commands should carefully
69set both the real and effective user id's immediately before executing
70those commands.  Probably more important is that
71.Nm dm
72never be setuid
73anything but
74.Dq games
75so that compromising a game will result only in
76the user's ability to play games at will.  Secondly, games which previously
77had no reason to run setuid and which accessed user files may have to
78be modified.
79.Sh HISTORY
80The
81.Nm dm
82command appeared in
83.Bx 4.3 tahoe .
84