games/hunt/huntd/huntd.6

   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 .Os
  37 .Sh NAME
  38 .Nm huntd
  39 .Nd hunt daemon, back-end for hunt game
  40 .Sh SYNOPSIS
  41 .Nm
  42 .Op Fl s
  43 .Op Fl p Ar port
  44 .Sh DESCRIPTION
  45 .Nm
  46 controls the multi-player
  47 .Xr hunt 6
  48 game.
  49 When it starts up, it tries to notify all members of the
  50 .Em hunt-players
  51 mailing list (see
  52 .Xr sendmail 8 )
  53 by faking a
  54 .Xr talk 1
  55 request from user
  56 .Dq Hunt Game .
  57 .Pp
  58 The
  59 .Fl s
  60 option is for running
  61 .Nm
  62 forever (server mode).
  63 This is similar to running it under the control of
  64 .Xr inetd 8
  65 (see below), but it consumes a process table entry when no one is playing.
  66 .Pp
  67 The
  68 .Fl p
  69 option changes the UDP port number used to rendezvous with the player
  70 process and thus allows for private games of hunt.
  71 This option turns off the notification of players on the
  72 .Em hunt-players
  73 mailing list.
  74 .Ss INETD
  75 To run
  76 .Nm
  77 from
  78 .Xr inetd 8 ,
  79 you'll need to
  80 .\"put the
  81 .\".Nm hunt
  82 .\"service in
  83 .\".Pa /etc/services :
  84 .\".Bd -literal
  85 .\"hunt 26740/udp               # multi-player/multi-host mazewars
  86 .\".Ed
  87 .\"and
  88 uncomment the following line in
  89 .Pa /etc/inetd.conf :
  90 .Bd -literal -offset indent -compact
  91 hunt dgram udp wait nobody /usr/games/huntd huntd
  92 .Ed
  93 Do not use any of the command line options; if you want
  94 .Xr inetd 8
  95 to start up
  96 .Nm
  97 on a private port, change the port listed for
  98 .Nm hunt
  99 in
 100 .Pa /etc/services .
 101 .Sh NETWORK RENDEZVOUS
 102 When
 103 .Xr hunt 6
 104 starts up, it broadcasts on the local area net
 105 (using the broadcast address for each interface) to find a
 106 .Nm hunt
 107 game in progress.
 108 If a
 109 .Nm
 110 hears the request, it sends back the port number for the
 111 .Nm hunt
 112 process to connect to.
 113 Otherwise, the
 114 .Nm hunt
 115 process starts up a
 116 .Nm
 117 on the local machine and tries to rendezvous with it.
 118 .Sh SEE ALSO
 119 .Xr talk 1 ,
 120 .Xr hunt 6 ,
 121 .Xr sendmail 8
 122 .Sh AUTHORS
 123 Conrad Huang, Ken Arnold, and Greg Couch;
 124 .br
 125 University of California, San Francisco, Computer Graphics Lab