.TH HEARTBEAT 8 "12th May 2004"
.SH NAME
heartbeat \- Heartbeat subsystem for High-Availability Linux
.SH SYNOPSIS
.B heartbeat
.nh
.SH DESCRIPTION
\fBheartbeat\fP is a basic heartbeat subsystem for Linux-HA.
It will run scripts at initialisation, and when machines go up or down.
This version will also perform IP address takeover using gratuitous ARPs.
It works correctly for a 2-node configuration, and is extensible to larger
configurations.
.PP
It implements the following kinds of heartbeats:
   * Bidirectional Serial Rings ("raw" serial ports)
   * UDP/IP broadcast (ethernet, etc.)
   * UDP/IP multicast (ethernet, etc.)
   * special "ping" heartbeats for routers, etc.
.PP
Comprehensive documentation on the configuration and running of
\fBheartbeat\fP can is supplied in HTML format with the distribution 
of the code. If this documentation is not installed on your system
it can be found, with the latest distribution of heartbeat
on http://www.linux-ha.org/
.SH OPTIONS
.TP
\fB-d\fP
Increment debugging level. Higher levels are more verbose.
.TP
\fB-r\fP
Restart heartbeat. May not be used with -R.
.TP
\fB-k\fP
Kill (stop) heartbeat.
.TP
\fB-s\fP
Report heartbeat status.
.TP
\fB-R\fP
Heartbeat restart exec flag (internal use only).
May not be used with -r.
.TP
\fB-C\fP
Heartbeat current resource state for restart (internal use only).
Only valid with -R. 
.PP
Note that most of these options are used for supporting the heartbeat
\fIinit script\fP, which provides the conventional start,
stop, status and restart options (among others). It is recommended
to use this rather than invoking the heartbeat command directly.

.SH SEE ALSO
cl_status(1), apphbd(8)

.SH DOCUMENTATION
More information may be found at http://www.linux-ha.org.

.SH FILES
.TP
/etc/ha.cf, /etc/haresources, /etc/authkeys

.SH AUTHORS
.nf
heartbeat - Alan Robertson <alanr@unix.sh> et al.
man page - Juan Pedro Paredes Caballero <juampe@retemail.es>
           Horms <horms@verge.net.au>
.fi