fakewww(8)                                                          fakewww(8)

NAME

       fakewww - Simple web server for the NDT system.

SYNOPSIS

       fakewww [options]

DESCRIPTION

       The  Network  Diagnostic  Tester  (NDT) tool is a client/server program
       that provides network configuration and performance testing to a  users
       desktop  or  laptop computers.  The system is composed of a client pro-
       gram (command line or java applet) and a pair  of  server  programs  (a
       webserver and a testing/analysis engine).

       The  fakewww  server provides a simple web server program to handle Web
       based Java clients.  This program eliminated the need  to  install  and
       configure a full-fledged web server.  It also provides server discovery
       functions when operated in federated mode (see options).   By  default,
       the  server  listens  for incoming Web client requests on TCP port 7123
       (see options to change this port number).  Once  a  TCP  connection  is
       received,  the  fakewww  server fork(2)'s a child process off to handle
       the request and the parent process returns to the listen(2) state.

       The fakewww server only responds to the HTTP GET  command.   All  other
       commands  results  in  the  connection being closed and, if enabled, an
       error message is logged.  The server contains a list of html  and  java
       class/jar  files  that  can be returned to the client.  If a request is
       received for an unlisted file, a "404 no file found" error is  returned
       to  the  client and, if enabled, an error message is logged.  Otherwise
       the requested file(s) is(are) returned to the client.

OPTIONS

       -d     Print debugging information.  This option increments the  inter-
              nal  debugging  flag allowing the display of run time diagnostic
              messages.  Repeated use of this option increases the  amount  of
              debugging  information that will be displayed.  Note: the debug-
              ging information prints to the stderr.

       -h     Print a simple usage page and exit.

       -F     Operate in federated mode.  In this mode several servers operate
              together  to handle client requests.  The federated servers form
              a Measurement Domain that clients can connect to.   Each  server
              contains  a  traceroute  map  to  all servers in the federation.
              When a client connects  to  a  server,  the  server  performs  a
              traceroute back to the client.  The server then dynamically cre-
              ates a new web page that redirects the client to the appropriate
              server.   By  default,  this  will  be  the server closet to the
              ingress point of the measurement domain.

       -l log_file
              Create a log file and log client activity.  Set the TCP send and
              receive buffer size.  This option uses the

       -p port number
              Specify  a  different  TCP  port  number  to  listen  for client
              requests.

       -t number
              Specify the maximum number of hops that traceroute  should  fol-
              low.   This number needs to be larger than the maximum number of
              hops between servers in the federation.

LIMITATIONS

       The NDT service is continuing to undergo testing and upgrading.  Better
       diagnostic  algorithms  are being developed to improve the accuracy and
       reliability of this service.

EXAMPLES

       fakewww -l /var/log/fakewww.log >& /dev/null &

              Run a fakewww server on TCP port 7123 and log the results in the
              /fB/var/log/fakewww.log log file.

       fakewww -p80 >& /dev/null fR

              Run a fakewww server on the standard TCP web services port.

SEE ALSO

       The    http://e2epi.internet2.edu/ndt/    web    site,    web100srv(8),
       web100clt(1), and setsockopt(2).

ACKNOWLEDGMENTS

       This material is based in part on work supported by the  National  Sci-
       ence  Foundation (NSF) under Grant No. ANI-0314723. Any opinions, find-
       ings and conclusions or recommendations expressed in this material  are
       those  of the author(s) and do not necessarily reflect the views of the
       NSF.

                         $Date: 2004/05/20 21:49:12 $               fakewww(8)