Provided by: xtide_2.8.2-1ubuntu1_i386 bug

NAME

       xttpd - Harmonic tide clock and tide predictor (web server)

SYNOPSIS

       xttpd [port]

DESCRIPTION

       XTide is a package that provides tide and current predictions in a wide
       variety of  formats.  Graphs,  text  listings,  and  calendars  can  be
       generated, or a tide clock can be provided on your desktop.

       XTide  can  work with X-windows, plain text terminals, or the web. This
       is accomplished with three separate programs: the interactive interface
       (xtide),  the non-interactive or command line interface (tide), and the
       web interface (xttpd).

       xttpd is an XTide web server. It provides web-based access  to  XTide’s
       tide  predictions  by  allowing  a web browser to speak directly to the
       XTide program in HTTP.  xttpd can replace httpd or it can co-exist with
       one.

       If you run xttpd with no command line arguments, it will assume that it
       is replacing httpd and try to bind port 80. If you want it to  co-exist
       with  an  existing  server, or if you do not have privilege to get port
       80, give it the port number as the first command line argument:
              % xttpd 8080
       You will then need  to  link  it  up  as  http://www.wherever.org:8080/
       instead  of  just  http://www.wherever.org/,  but  otherwise, no damage
       done.  Similarly, if you wish to  bind  a  specific  address,  you  can
       specify that as the first argument:
              % xttpd 127.0.0.2
       If  you  need to specify both address and port number, separate the two
       with a slash, like this:
              % xttpd 127.0.0.2/8080

       xttpd will try to set its UID to ’nobody’ once the port is established,
       but  will issue a warning and continue with the default user ID if this
       fails.

       For a complete discussion of the command line options  and  a  detailed
       explanation  of the XTide package, please see the verbose documentation
       at http://www.flaterco.com/xtide/.

CONFIGURATION

       Unless a configuration file /etc/xtide.conf is supplied, you  must  set
       the  environment  variable  HFILE_PATH  to point to the harmonics files
       that should have been installed along with the xtide program.  Example:
              export HFILE_PATH=/usr/local/share/xtide/harmonics.tcd
       If  a  configuration file is used, the first line should consist of the
       colon-separated list of harmonics files (e.g. the HFILE_PATH line above
       without the "export HFILE_PATH=" part).  The environment variable takes
       precedence over the configuration file.

CONFIGURATION ON DEBIAN SYSTEMS

       On Debian systems the web server xttpd may  optionally  be  started  at
       boot  time  by editing /etc/init.d/xttpd (setting the PORT variable and
       uncommenting out the line). Set the environment variable XTTPD_FEEDBACK
       in /etc/init.d/xttpd to change the mail feedback address.

       Also,  note  that  on  Debian systems the tidal harmonics data file are
       stored in /usr/share/xtide instead of  /usr/local/share/xtide  as  used
       above.

SEE ALSO

       tide(1), xtide(1), http://www.flaterco.com/xtide/.