aboutsummaryrefslogtreecommitdiffstats
path: root/doc/pingu.txt.in
diff options
context:
space:
mode:
Diffstat (limited to 'doc/pingu.txt.in')
-rw-r--r--doc/pingu.txt.in73
1 files changed, 73 insertions, 0 deletions
diff --git a/doc/pingu.txt.in b/doc/pingu.txt.in
new file mode 100644
index 0000000..7954059
--- /dev/null
+++ b/doc/pingu.txt.in
@@ -0,0 +1,73 @@
+PINGU(8)
+========
+:doctype: manpage
+
+
+NAME
+----
+pingu - Multi ISP policy routing, failover and load-balancing daemon
+
+
+SYNOPSIS
+--------
+*pingu* ['-dhvV'] [*-a* 'SOCKETPATH'] [*-c* 'CONFIG'] [*-p* 'PIDFILE']
+
+
+DESCRIPTION
+-----------
+The pingu utility monitors specified interfaces and sets up an alternate
+route table for each specified interface in which it mirrors all routes
+using that interface. It also sets up a route rule so that this alternate
+route table is looked up for traffic where the source IP address matches
+the primary IP address of the corresponding interface. This guarantees
+that a service bound to the primary address of an interface will always
+use routes from that interface.
+
+It can also ping specified hosts at regular intervals to detect if a
+gateway via a certain interface goes down. It will then remove the default
+gateway(s) via this interface from main route table so that traffic not
+bound to the failed interface will fail over to other configured interfaces.
+
+Pingu can also set up a multipath nexthop defafult route for interfaces
+configured as "load-balance"
+
+
+OPTIONS
+-------
+*-a* 'SOCKETPATH'::
+ Use _SOCKETPATH_ as administration socket instead of the default
+ '@DEFAULT_ADM_SOCKET@'
+
+*-c* 'CONFIG'::
+ Use config file CONFIG instead of the default '@DEFAULT_CONFIG@'
+
+*-d*::
+ Fork to background (daemonize).
+
+*-h*::
+ Show short help text.
+
+*-p* 'PIDFILE'::
+ Use PIDFILE as pidfile instead of the default '@DEFAULT_PIDFILE@'
+
+*-V*::
+ Print version and exit.
+
+*-v*::
+ Run in verbose mode. Will log debug messages,
+
+
+FILES
+-----
+
+'@DEFAULT_CONFIG@'
+
+'@DEFAULT_PIDFILE@'
+
+'@DEFAULT_ADM_SOCKET@'
+
+AUTHORS
+-------
+Natanael Copa
+
+