bubbros-server(6)						   Games Manual 						 bubbros-server(6)

NAME

       bubbros-server - the bub-n-bros server.

SYNOPSIS

       bubbros-server [ level-file.bin ] [options]

DESCRIPTION

       bubbros-server  starts  an http server that acts as a control panel for the server. The server listens on port 8000 by default. The url for
       the control panel is http://server:port/0xN where 0xN is a random hex number (acts as minimal protection). This url  is	printed  when  the
       server  starts.	You can start and view games and kill the server from this panel. The control panel also allows you to type in the address
       of a server to connect to, the script will then open a client to that server. The http server also servers java applet  clients	for  those
       players who wish to use one.

       When  a	game  is  started the script opens a port for the game server. This port can then be connected to by a client.	Clients autodetect
       servers running on the local network with UDP ping on port 8056.

   Connection forming
       The client forms a tcp connection to the server. Or, when using the metaserver, the server forms a connection to the client. If this fails,
       the  client  and server try a simultaneous SYN connect. This sometimes works if the server and client are behind firewalls. The server then
       tries to transmit the data over udp. If it gets no response from the client it will fall back to the existing tcp connection.

OPTIONS

       -b N, --begin N, --start N
	      Start at board (level) number N.	The default is 1. See also the -s option.

       -h, --help
	      Display help.

       -i, --infinite
	      Restart the server at the end of the game. Normally the server quits after a certain period of inactivity. This is useful when  used
	      with the -m option to make a public server that is available for a long time.

       -l N, --lives N
	      Limit number of lives to N.  If this option is not specified the number of lives will be infinite.

       -m, --metaserver
	      Register server with the Metaserver (currently) at codespeak.net:8050.  This makes your server visible to everybody, and also facil-
	      itates joining through a fascistic firewall.

       --port TYPE=N Sets default listening ports. If type is LISTEN , sets the game server port to N.	The game server port is chosen randomly by
	      default.	If the type is HTTP , sets the http server port to N.  The http server port defaults to 8000.  Another port will be chosen
	      if none was specified and 8000 is already in use. The server also listens to UDP ping on port 8056.

       -s N, --step N
	      Increase board number with N when a board is completed. Defaults to 1. see also the -b option.

OUTPUT

       The server outputs helpful debug information concerning the http and game servers.

SEE ALSO

       bubbros(6) bubbros-client(6)

								 December 7, 2007						 bubbros-server(6)