Provided by: xtide_2.13.2-1build2_amd64 
NAME
xttpd - Harmonic tide clock and tide predictor (web server)
SYNOPSIS
xttpd [port] [-dc color] [-Dc color] [-df ``format-string''] [-ec color] [-el y|n] [-em
pSsMm] [-fc color] [-fg color] [-ga aspect] [-gh pixels] [-gs d|l|s] [-gt y|n] [-gw
pixels] [-hf ``format-string''] [-in y|n] [-lw pixels] [-mc color] [-Mc color] [-nc color]
[-pi days] [-tf ``format-string''] [-tl y|n] [-u ft|m] [-v] [-z y|n]
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
Once the port is established, xttpd will try to set its UID and GID to values that were
specified at compile time. If it is unable to do this, it will log failure messages to
syslog and then exit. Consequently, if it is to be started by someone other than root,
that user's UID and GID must be configured at compile time. Instructions for doing this
are available at http://www.flaterco.com/xtide/installation.html.
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.
OPTIONS
-dc color
Daytime background color in tide graphs (default SkyBlue).
-Dc color
Color of datum line in tide graphs (default white).
-df ``format-string''
strftime(3) style format string for printing dates (default %Y-%m-%d). Ignored in
calendar mode.
-ec color
Foreground in tide graphs during outgoing tide (default SeaGreen).
-el y|n
Select whether or not to draw datum and middle-level lines in tide graphs (default
n).
The National Ocean Service (NOS) defines both Mean Sea Level (MSL) and Mean Tide
Level (MTL) in terms of averages taken over observations. The middle-level line is
drawn at the midpoint of the theoretical tidal range, which usually corresponds to
the mathematical mean level of the predictions. This approximates both MSL and
MTL, but, strictly speaking, is equivalent to neither. Moreover, subordinate
station offsets may shift the actual mean so that it no longer falls at the
midpoint of the tidal range. The datum line is drawn at the zero level of the
predictions, which usually corresponds to the station's benchmark, but this too can
be rendered inaccurate by subordinate station offsets.
-em pSsMm
Events to suppress (p = phase of moon, S = sunrise, s = sunset, M = moonrise, m =
moonset), or x to suppress none. E.g, to suppress all sun and moon events, set
eventmask to the value pSsMm.
-fc color
Foreground in tide graphs during incoming tide (default Blue).
-fg color
Color of text and other notations (default black).
-ga aspect
Aspect for tide graphs (default 1.0). This controls not the width or height of the
window but rather the relative scaling of the X and Y axes in the plot of the tide
curve.
-gh pixels
Height for tide graphs (default 312 pixels).
-gs d|l|s
Style of graphs and clocks. Valid values: d (default), l (line), s
(semitransparent).
-gt y|n
Select whether or not to label tenths of units in tide graphs (default n).
-gw pixels
Width for tide graphs (default 960 pixels).
-hf ``format-string''
strftime(3) style format string for printing hour labels on time axis (default %l).
-in y|n
Select whether or not to use inferred values for some constituents (default n).
For expert use only.
-lw pixels
Width of line in graph styles l and s (default 2.5 pixels).
-mc color
Color of mark line in graphs (default red).
-Mc color
Color of middle-level line in tide graphs (default yellow).
-nc color
Nighttime background color in tide graphs (default DeepSkyBlue).
-pi days
Number of days of predictions to generate when no end time is specified (default
4).
-tf ``format-string''
strftime(3) style format string for printing times (default %l:%M %p %Z).
-tl y|n
Select whether or not to draw depth lines on top of the tide graph (default n).
-u ft|m
Preferred units of length (default no preference).
-v Print version string and exit.
-z y|n Select whether or not to coerce all time zones to UTC (default n).
SEE ALSO
tide(1), xtide(1), http://www.flaterco.com/xtide/.