gkrellmd(1)							   User's Manual						       gkrellmd(1)

NAME

       gkrellmd - The GNU Krell Monitors Server

SYNOPSIS

       gkrellmd [ --help ] [ --verbose ] [ -u | --update-hz N ]

       [ -m | --max-clients N ] [ -P | --port N ] [ -a | --allow-host hostname ]

DESCRIPTION

       gkrellmd  Listens  for  connections from gkrellm clients.  When a gkrellm client connects to a gkrellmd server all builtin monitors collect
       their data from the server.  However, the gkrellm process is running on the local machine, so any enabled plugins will  run  in	the  local
       context	(Flynn	is an example exception to this since it derives its data from the builtin CPU monitor).  Also, any command launching will
       run commands on the local machine.

       There is no support for file system mounting and local mailbox checking on the machine where the gkrellmd server is running.

OPTIONS

       -h --help
	      Displays usage information and exits.

       -v --version
	      Prints gkrellmd version and exits.

       -V --verbose
	      Prints connection progress.

       -u, --update-hz f
	      Sets the data update frequency in samples per second for the server.  This is independent of and should be  less	than  the  gkrellm
	      client  update  rate.   The rate can be from 1 to 10 and should be lower to minimize network traffic.  A value of not much more than
	      1/2 the client update rate is best where it is not important to minimize network traffic.

       -m, --max-clients N
	      Sets the maximum number of simultaneous clients allowed to connect to the server.

       -P, --port server_port
	      Use server_port for the network connection.

       -a, --allow-host hostname
	      Specify hosts which are allowed to connect.  Multiple allow-host arguments may be given.	If no hosts are specified on  the  command
	      line  or	in  a  gkrellmd.conf file, then all hosts are allowed to connect.  Also, if hostname is the keyword ALL then all hosts are
	      allowed.	This option is additive and specified hosts will be added to the  hostnames  listed  in  gkrellmd.conf	files  unless  the
	      --clear-hosts option is given first.

       -c, --clear-hosts
	      Clears  the  current  list  of  allowed hosts.  Use this before any --allow-host arguments if you want command line allowed hosts to
	      override and not be additive to those specified in gkrellmd.conf files.

FILES

       /etc/gkrellmd.conf
	      System server config which is read first.  The config file may contain lines similar to the command line args.  For example:

       allow-host localhost

       allow-host 127.0.0.1

       port 19150

       max-clients 2

       update-hz 2

       /usr/local/etc/gkrellmd.conf
	      Local server config file which is read second.

       ~/.gkrellmd.conf
	      User server config file which is read last.

       With the exception of --allow-hosts, command line args will override options in gkrellmd.conf files.

AUTHOR

       Bill Wilson <bill@gkrellm.net>.	http://www.gkrellm.net/

GNU
/Linux							   July 24, 2002						       gkrellmd(1)