← Back to branch summary

~ubuntu-branches/debian/stretch/haproxy/stretch

« back to all changes in this revision

Viewing changes to doc/haproxy.1

  • Committer: Package Import Robot
  • Author(s): Apollon Oikonomopoulos
  • Date: 2014-06-20 11:05:17 UTC
  • mfrom: (1.1.15) (15.1.12 experimental)
  • Revision ID: package-import@ubuntu.com-20140620110517-u6q5p9kyy2f3ozw9
Tags: 1.5.0-1
* New upstream stable series. Notable changes since the 1.4 series:
  + Native SSL support on both sides with SNI/NPN/ALPN and OCSP stapling.
  + IPv6 and UNIX sockets are supported everywhere
  + End-to-end HTTP keep-alive for better support of NTLM and improved
    efficiency in static farms
  + HTTP/1.1 response compression (deflate, gzip) to save bandwidth
  + PROXY protocol versions 1 and 2 on both sides
  + Data sampling on everything in request or response, including payload
  + ACLs can use any matching method with any input sample
  + Maps and dynamic ACLs updatable from the CLI
  + Stick-tables support counters to track activity on any input sample
  + Custom format for logs, unique-id, header rewriting, and redirects
  + Improved health checks (SSL, scripted TCP, check agent, ...)
  + Much more scalable configuration supports hundreds of thousands of
    backends and certificates without sweating

* Upload to unstable, merge all 1.5 work from experimental. Most important
  packaging changes since 1.4.25-1 include:
  + systemd support.
  + A more sane default config file.
  + Zero-downtime upgrades between 1.5 releases by gracefully reloading
    HAProxy during upgrades.
  + HTML documentation shipped in the haproxy-doc package.
  + kqueue support for kfreebsd.

* Packaging changes since 1.5~dev26-2:
  + Drop patches merged upstream:
    o Fix-reference-location-in-manpage.patch
    o 0001-BUILD-stats-workaround-stupid-and-bogus-Werror-forma.patch
  + d/watch: look for stable 1.5 releases
  + systemd: respect CONFIG and EXTRAOPTS when specified in
    /etc/default/haproxy.
  + initscript: test the configuration before start or reload.
  + initscript: remove the ENABLED flag and logic.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/haproxy.1
6
6
 
7
7
.SH SYNOPSIS
8
8
 
9
 
haproxy \-f <configuration\ file> [\-n\ maxconn] [\-N\ maxconn] [\-d] [\-D] [\-q] [\-V] [\-c] [\-p\ <pidfile>] [\-s] [\-l] [\-dk] [\-ds] [\-de] [\-dp] [\-db] [\-m\ <megs>] [{\-sf|\-st}\ pidlist...] 
 
9
haproxy \-f <configuration\ file> [\-L\ <name>] [\-n\ maxconn] [\-N\ maxconn] [\-C\ <dir>] [\-v|\-vv] [\-d] [\-D] [\-q] [\-V] [\-c] [\-p\ <pidfile>] [\-dk] [\-ds] [\-de] [\-dp] [\-db] [\-dM[<byte>]] [\-m\ <megs>] [{\-sf|\-st}\ pidlist...]
10
10
 
11
11
.SH DESCRIPTION
12
12
 
37
37
Specify configuration file path.
38
38
 
39
39
.TP
 
40
\fB\-L <name>\fP
 
41
Set the local instance's peer name. Peers are defined in the \fBpeers\fP
 
42
configuration section and used for syncing stick tables between different
 
43
instances. If this option is not specified, the local hostname is used as peer
 
44
name.
 
45
 
 
46
.TP
40
47
\fB\-n <maxconn>\fP
41
48
Set the high limit for the total number of simultaneous connections.
42
49
 
45
52
Set the high limit for the per-listener number of simultaneous connections.
46
53
 
47
54
.TP
 
55
\fB\-C <dir>\fP
 
56
Change directory to <\fIdir\fP> before loading any files.
 
57
 
 
58
.TP
 
59
\fB\-v\fP
 
60
Display HAProxy's version.
 
61
 
 
62
.TP
 
63
\fB\-vv\fP
 
64
Display HAProxy's version and all build options.
 
65
 
 
66
.TP
48
67
\fB\-d\fP
49
 
Start in foregreound with debugging mode enabled.
 
68
Start in foreground with debugging mode enabled.
50
69
When the proxy runs in this mode, it dumps every connections,
51
70
disconnections, timestamps, and HTTP headers to stdout. This should
52
71
NEVER be used in an init script since it will prevent the system from
57
76
Start in daemon mode.
58
77
 
59
78
.TP
 
79
\fB\-Ds\fP
 
80
Start in systemd daemon mode, keeping a process in foreground.
 
81
 
 
82
.TP
60
83
\fB\-q\fP
61
84
Disable messages on output.
62
85
 
76
99
in daemon mode.
77
100
 
78
101
.TP
79
 
\fB\-s\fP
80
 
Show statistics (only if compiled in).
81
 
Statistics are only available if compiled in with the 'STATTIME' option.
82
 
It's only used during code optimization phases, and will soon disappear.
83
 
 
84
 
.TP
85
 
\fB\-l\fP
86
 
Show even more statistics (implies '\-s').
87
 
 
88
 
.TP
89
102
\fB\-dk\fP
90
 
Disable use of kqueue(). kqueue() is available only on BSD systems.
 
103
Disable use of \fBkqueue\fP(2). \fBkqueue\fP(2) is available only on BSD systems.
91
104
 
92
105
.TP
93
106
\fB\-ds\fP
94
 
Disable use of speculative epoll(). epoll() is available only on Linux 2.6
95
 
and some custom Linux 2.4 systems.
 
107
Disable use of speculative \fBepoll\fP(7). \fBepoll\fP(7) is available only on
 
108
Linux 2.6 and some custom Linux 2.4 systems.
96
109
 
97
110
.TP
98
111
\fB\-de\fP
99
 
Disable use of epoll(). epoll() is available only on Linux 2.6
 
112
Disable use of \fBepoll\fP(7). \fBepoll\fP(7) is available only on Linux 2.6
100
113
and some custom Linux 2.4 systems.
101
114
 
102
115
.TP
103
116
\fB\-dp\fP
104
 
Disables use of poll(). select() might be used instead.
 
117
Disables use of \fBpoll\fP(2). \fBselect\fP(2) might be used instead.
 
118
 
 
119
.TP
 
120
\fB\-dS\fP
 
121
Disables use of \fBsplice\fP(2), which is broken on older kernels.
105
122
 
106
123
.TP
107
124
\fB\-db\fP
112
129
run full debug.
113
130
 
114
131
.TP
 
132
\fB\-dM[<byte>]\fP
 
133
Initializes all allocated memory areas with the given <\fIbyte\fP>. This makes
 
134
it easier to detect bugs resulting from uninitialized memory accesses, at the
 
135
expense of touching all allocated memory once. If <\fIbyte\fP> is not
 
136
specified, it defaults to 0x50 (ASCII 'P').
 
137
 
 
138
.TP
115
139
\fB\-m <megs>\fP
116
140
Enforce a memory usage limit to a maximum of <megs> megabytes.
117
141
 
165
189
.SH SEE ALSO
166
190
 
167
191
A much better documentation can be found in configuration.txt. On Debian
168
 
systems, you can find this file in
169
 
/usr/share/doc/haproxy/configuration.txt.gz.
 
192
systems, you can find this file in /usr/share/doc/haproxy/configuration.txt.gz.
170
193
 
171
194
.SH AUTHOR
172
195