xref: /netbsd-src/games/hunt/huntd/huntd.6 (revision f81322cf185a4db50f71fcf7701f20198272620e)
1.\"	$NetBSD: huntd.6,v 1.8 2005/09/15 02:10:37 wiz Exp $
2.\"
3.\" huntd
4.\"
5.\" Copyright (c) 1983-2003, Regents of the University of California.
6.\" All rights reserved.
7.\"
8.\" Redistribution and use in source and binary forms, with or without
9.\" modification, are permitted provided that the following conditions are
10.\" met:
11.\"
12.\" + Redistributions of source code must retain the above copyright
13.\"   notice, this list of conditions and the following disclaimer.
14.\" + Redistributions in binary form must reproduce the above copyright
15.\"   notice, this list of conditions and the following disclaimer in the
16.\"   documentation and/or other materials provided with the distribution.
17.\" + Neither the name of the University of California, San Francisco nor
18.\"   the names of its contributors may be used to endorse or promote
19.\"   products derived from this software without specific prior written
20.\"   permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
23.\" IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
24.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
25.\" PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
26.\" OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
27.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
28.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
32.\" OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33.\"
34.Dd April 4, 2001
35.Dt HUNTD 6
36.Sh NAME
37.Nm huntd
38.Nd hunt daemon, back-end for hunt game
39.Sh SYNOPSIS
40.Nm
41.Op Fl s
42.Op Fl p Ar port
43.Sh DESCRIPTION
44.Nm
45controls the multi-player
46.Xr hunt 6
47game.
48When it starts up, it tries to notify all members of the
49.Em hunt-players
50mailing list (see
51.Xr sendmail 8 )
52by faking a
53.Xr talk 1
54request from user
55.Dq Hunt Game .
56.Pp
57The
58.Fl s
59option is for running
60.Nm
61forever (server mode).
62This is similar to running it under the control of
63.Xr inetd 8
64(see below), but it consumes a process table entry when no one is playing.
65.Pp
66The
67.Fl p
68option changes the UDP port number used to rendezvous with the player
69process and thus allows for private games of hunt.
70This option turns off the notification of players on the
71.Em hunt-players
72mailing list.
73.Ss INETD
74To run
75.Nm
76from
77.Xr inetd 8 ,
78you'll need to
79.\"put the
80.\".Nm hunt
81.\"service in
82.\".Pa /etc/services :
83.\".Bd -literal
84.\"hunt 26740/udp		# multi-player/multi-host mazewars
85.\".Ed
86.\"and
87uncomment the following line in
88.Pa /etc/inetd.conf :
89.Bd -literal -offset indent -compact
90hunt dgram udp wait nobody /usr/games/huntd huntd
91.Ed
92Do not use any of the command line options; if you want
93.Xr inetd 8
94to start up
95.Nm
96on a private port, change the port listed for
97.Nm hunt
98in
99.Pa /etc/services .
100.Sh NETWORK RENDEZVOUS
101When
102.Xr hunt 6
103starts up, it broadcasts on the local area net
104(using the broadcast address for each interface) to find a
105.Nm hunt
106game in progress.
107If a
108.Nm
109hears the request, it sends back the port number for the
110.Nm hunt
111process to connect to.
112Otherwise, the
113.Nm hunt
114process starts up a
115.Nm
116on the local machine and tries to rendezvous with it.
117.Sh SEE ALSO
118.Xr talk 1 ,
119.Xr hunt 6 ,
120.Xr sendmail 8
121.Sh AUTHORS
122Conrad Huang, Ken Arnold, and Greg Couch;
123.br
124University of California, San Francisco, Computer Graphics Lab
125