1: .\"     $NetBSD: huntd.6,v 1.7 2003/06/11 12:00:22 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
   45: controls the multi-player
   46: .Xr hunt 6
   47: game.
   48: When it starts up, it tries to notify all members of the
   49: .Em hunt-players
   50: mailing list (see
   51: .Xr sendmail 8 )
   52: by faking a
   53: .Xr talk 1
   54: request from user
   55: .Dq Hunt Game .
   56: .Pp
   57: The
   58: .Fl s
   59: option is for running
   60: .Nm
   61: forever (server mode).
   62: This 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
   66: The
   67: .Fl p
   68: option changes the UDP port number used to rendezvous with the player
   69: process and thus allows for private games of hunt.
   70: This option turns off the notification of players on the
   71: .Em hunt-players
   72: mailing list.
   73: .Ss INETD
   74: To run
   75: .Nm
   76: from
   77: .Xr inetd 8 ,
   78: you'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
   87: add the following line to
   88: .Pa /etc/inetd.conf :
   89: .Bd -literal -offset indent -compact
   90: hunt dgram udp wait nobody @sbindir@/huntd huntd
   91: .Ed
   92: Do not use any of the command line options; if you want
   93: .Xr inetd 8
   94: to start up
   95: .Nm
   96: on a private port, change the port listed for
   97: .Nm hunt
   98: in
   99: .Pa /etc/services .
  100: .Sh NETWORK RENDEZVOUS
  101: When
  102: .Xr hunt 6
  103: starts up, it broadcasts on the local area net
  104: (using the broadcast address for each interface) to find a
  105: .Nm hunt
  106: game in progress.
  107: If a
  108: .Nm
  109: hears the request, it sends back the port number for the
  110: .Nm hunt
  111: process to connect to.
  112: Otherwise, the
  113: .Nm hunt
  114: process starts up a
  115: .Nm
  116: on 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
  122: Conrad Huang, Ken Arnold, and Greg Couch;
  123: .br
  124: University of California, San Francisco, Computer Graphics Lab