File: README

package info (click to toggle)
pound 1.8.2-1sarge1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 688 kB
  • ctags: 286
  • sloc: ansic: 2,877; sh: 2,826; python: 830; makefile: 144
file content (756 lines) | stat: -rw-r--r-- 31,664 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
POUND - REVERSE-PROXY AND LOAD-BALANCER

    The *Pound* program is a reverse proxy, load balancer and
    HTTPS front-end for Web server(s). *Pound* was developed
    to enable distributing the load among several Web-servers
    and to allow for a convenient SSL wrapper for those Web
    servers that do not offer it natively. *Pound* is distributed
    under the GPL - no warranty, it's free to use, copy and
    give away.


WHAT POUND IS:

    1.  a reverse-proxy: it passes requests from client
        browsers to one or more back-end servers.

    2.  a load balancer: it will distribute the requests from
        the client browsers among several back-end servers,
        while keeping session information.

    3.  an SSL wrapper: *Pound* will decrypt HTTPS requests
        from client browsers and pass them as plain HTTP
        to the back-end servers.

    4.  an HTTP/HTTPS sanitizer: *Pound* will verify requests
        for correctness and accept only well-formed ones.

    5.  a fail over-server: should a back-end server fail,
        *Pound* will take note of the fact and stop passing
        requests to it until it recovers.

    6.  a request redirector: requests may be distributed
        among servers according to the requested URL.

    *Pound* is a very small program, easily audited for security
    problems. It can run as setuid/setgid and/or in a chroot
    jail. *Pound* does not access the hard-disk at all (except
    for reading the certificate file on start, if required)
    and should thus pose no security threat to any machine.


WHAT POUND IS NOT:

    1.  *Pound* is not a Web server: by itself, *Pound* serves no
        content - it contacts the back-end server(s) for that
        purpose.

    2.  *Pound* is not a Web accelerator: no caching is done -
        every request is passed "as is" to a back-end server.


STATUS

    As of release 1.0 *Pound* is declared to be production-quality code.

    Quite a few people have reported using *Pound* successfully in production
    environments. The largest volume reported to date is a site with an
    average of about 5M requests per day, peaking at over 400 requests/sec.

    *Pound* was successfully used in production with a variety of Web servers,
    including Apache, IIS, Zope, WebLogic, Jakarta/Tomcat, iPlanet, etc. In
    general *Pound* passes requests and responses back and forth unchanged,
    so we have no reason to think that any web server would be incompatible.

    Client browsers that were tested:

    - IE 5.0/5.5 (Windows) HTTP/HTTPS

    - Netscape 4.7 (Windows/Linux) HTTP/HTTPS

    - Mozilla (Windows/Linux) HTTP/HTTPS

    - Konqueror (Linux) HTTP/HTTPS

    - Galleon (Linux) HTTP/HTTPS

    - Opera (Linux/Windows) HTTP/HTTPS

    - Lynx (Linux) HTTP

    Given that *Pound* is in production and no problems were reported, we have
    no reason to believe that other browsers would present a problem. A few
    issues were observed with problematic SSL implementations, most notably
    with Opera 6, but these should be OK in the present version.


INSTALLATION

    1.  *Pound* was tested on Linux, Solaris and OpenBSD, but
        it should work unchanged on just about any modern
        Unix-like system. You will require OpenSSL and
        libpthread.

        Warning: as *Pound* is a multi-threaded program it requires
        a version of OpenSSL with thread support. This is normally
        the case on Linux and Solaris (for example) but not on *BSD.
        If your system has the wrong library please download, compile
        and install OpenSSL (from http://www.openssl.org).

    2.  Download the current version "Pound-current.tgz",
        http://www.apsis.ch/pound/Pound-current.tgz
        file and unpack it. The archive is "signed",
        http://www.apsis.ch/pound/Pound-current.asc.
        My signature is available "here", http://www.apsis.ch/pound/roseg.asc.
        Alternately see below for stable versions.
        Unpack. Do the usual thing::

            ./configure

    3.  The following options are available for the configure script:

        --with-ssl=ssl_dir -- OpenSSL home directory

        --with-log=facility -- log facility to use. By default this
        is LOG_DAEMON, but you may change it to anything you like.
        Use the symbolic names as in openlog(3). Use --without-log
        to send all messages to stderr

        --enable-daemon -- enable or disable running as a daemon.
        By default enabled.

        --enable-msdav -- enable or disable support for the Microsoft
        WebDAV extensions. By default disabled.

        --enable-unsafe -- The characters "{}|\^[]'" will be allowed in
        request URLs. This can be overridden in the configuration file.
        By default disabled.

    4.  Check that the resulting Makefile is correct and possibly
        adjust flags as needed on your system. Compile::

            make

    5.  If it works, you may want to do some testing before installing.

    6.  Install the executable somewhere (it's likely that
        /usr/local/sbin would make a good choice), as well
        as the manual page (pound.8 -> /usr/local/man/man8).
        The supplied Makefile will do it for you.

    7.  Make sure *Pound* gets started on boot. Read the man
        page for available options and examples.


COPYRIGHT

    *Pound* is copyrighted by Apsis GmbH and is distributed under
    the terms of the GNU Public License. Basically, this means
    that you can use it free of charge, copy it, distribute it
    (provided the copyright is maintained and the full package
    is distributed), modify it, or line a bird-cage with it.

    We would be happy to hear from you if you use it and
    suggestions and improvements are gladly accepted.


CONTACT

    "Robert Segall", mailto:roseg@apsis.ch

    "**Apsis GmbH**", http://www.apsis.ch

    P O Box

    CH-8707 Uetikon am See

    Switzerland

    +41-1-920 4904


MAILING LIST

    *Pound* has its own mailing list now: please send a message in order to
    "subscribe", mailto:pound-subscribe@apsis.ch. You will receive
    confirmation and instructions in the reply.

    All messages are available and indexed (searcheable) in the
    "archive", http://www.apsis.ch/pound/pound_list.


ZOPE

    A special note for Zope users: the original intent on
    developing *Pound* was to allow distributing the load
    among several Zope servers running on top of ZEO. This
    it does.

    A special problem arises when you try using *Pound* as an
    SSL wrapper: Zope assumes that the requests are made via
    HTTP and insists on prepending 'http://' to the (correct)
    address in the replies, including in the <base> tag and
    the absolute URLs it generates (for images for example).
    This is clearly an undesirable behavior.

    In order to address this issue, a modified z2.py (as well
    as a patch) is included in the distribution. The main
    difference is that this z2.py allows starting an additional
    HTTP server via the -y flag that sets the environment
    HTTPS variable - thus correcting the problem. That means
    that in order to use *Pound* as an SSL wrapper you need to:

    - start Zope (modify the 'start' file) as::

        python -X -w 8080 -y 8443 ...

    - start _two_ copies of *Pound* on the front-end: one listens
      on port 80 and passes requests to port 8080, the second
      listens on port 443 and passes requests to port 8443.



VIRTUAL HOSTS (IN GENERAL)

    Some people asked about the possibility of redirecting requests to back-ends
    as per some virtual hosts definition. While I believe this is not *Pound*'s
    job, it can be done. As of version 0.10, *Pound* supports filtering requests
    based not only on the request URL, but also on the presence or absence of
    certain headers.

    Let's assume that you have internal server 192.168.0.10 that is supposed to
    serve the needs of virtual host www.server0.com and 192.168.0.11 that serves
    www.server1.com.  You want *Pound* to listen on address 1.2.3.4 and separate
    the requests to each host.  The config file would look something like this::

        ListenHTTP  1.2.3.4,80

        UrlGroup    ".*"
        HeadRequire Host    ".*www.server0.com.*"
        BackEnd     192.168.0.10,80,1
        EndGroup

        UrlGroup    ".*"
        HeadRequire Host    ".*www.server1.com.*"
        BackEnd     192.168.0.11,80,1
        EndGroup

    (add whatever else is necessary) or, if you want even safer filtering::

        ListenHTTP  1.2.3.4,80

        UrlGroup    ".*"
        HeadRequire Host    ".*www.server0.com.*"
        HeadDeny    Host    ".*www.server1.com.*"
        BackEnd     192.168.0.10,80,1
        EndGroup

        UrlGroup    ".*"
        HeadRequire Host    ".*www.server1.com.*"
        HeadDeny    Host    ".*www.server0.com.*"
        BackEnd     192.168.0.11,80,1
        EndGroup

    This is NOT recommended (I personally believe that virtual hosts should be
    implemented in the back-end servers - putting this in a proxy
    is a major security kludge) but it works.



VIRTUAL HOSTS AND HTTPS

    Quite often we get inquiries about *Pound*'s ability to do virtual hosting
    with HTTPS. In order to lay this matter to rest, let me say:

        *HTTPS does not allow virtual hosting*

    This is not a limitation of *Pound*, but of HTTPS - no Web server or proxy
    are able to do it due to the nature of the beast.

    In order to see why this is the case we need to look at the way HTTPS works.
    Basically there are three stages in any HTTPS connection:

    1.  Connection negotiation - the client (your browser) and the server (Web
        server or proxy) negotiate the basic parameters: ciphers to use, session
        key, etc.

    2.  Connection authentication: at the very least the server presents the
        client with a certificate that says "I am server www.encrypted.com - and
        certificate.authority.org will verify that". The client may also present
        a certificate of its own at this stage.

    3.  Request/response cycle: normal HTTP is sent (through the encrypted
        channel) back and forth.

    The vital point to notice here is that connection authentication takes place
    BEFORE any request was issued.

    On the other hand, the way virtual hosting works is for the client to
    specify in the request to which server it would like to talk. This is
    accomplished via a Host header::

        GET /index.html HTTP/1.1
        Host: http://www.virthost.com

    Combining the two we get to an impasse: on connection setup the server will
    reply with the certificate for "www.realhost.com", but the request is really
    for "www.virthost.com" - and most browsers will scream blue murder (as well
    they should) if the two do not match.



VIRTUAL HOSTS IN ZOPE

    For reasons I can't quite grasp, it seems that a lot of Zope
    users are convinced that virtual hosts are only possible through
    the Apache/VHM combination and that it requires some kind of
    magic incantation at midnight in order to work (I won't even
    start on the virgin sacrifices).

    The simple fact is that VHM and the Apache VirtualHost directives
    (as well as various tricks through mod_rewrite and mod_proxy) are
    (almost) mutually exclusive: they perform exactly the same
    functions and, leaving aside the logging issues, are used
    independently of each other.  Let me repeat that: you may use the
    VHM without Apache - just click on the VHM mappings tab and add
    whatever virtual host you wish. From this moment on any request
    to that host will be mapped back and forth by Zope to the required
    URL. This works 8 you access Zope directly or via any number
    of proxies on the way, *Pound* included.

    To test: add a new host name to your /etc/hosts file, making it an
    alias for localhost - something like::

        127.0.0.1 localhost www.testhost.mine

    Add a mapping in VHM from www.testhost.mine to some Zope folder
    (Examples is already there). Point your browser to http://localhost
    and you get the normal Zope start page; point it to
    http://www.testhost.mine and you'll see the Examples starting page.
    All requests are mapped correctly, and the URLs in the pages (such
    as base or absoluteURL) are translated correctly in the response.


SESSIONS

    *Pound* has the ability to keep track of sessions between a client
    browser and a back-end server. Unfortunately, HTTP is defined as
    a stateless protocol, which complicates matters: many schemes have
    been invented to allow keeping track of sessions, none of which works
    perfectly. Even worse, sessions are critical in order to allow
    web-based applications to function correctly - it is vital that once
    a session is established all subsequent requests from the same browser
    be directed to the same back-end server.

    Four possible ways of detecting a session have been implemented in
    *Pound* (hopefully the most useful ones): by client address, by Basic
    authentication, by URL parameter and by cookie.

    - by client address: in this scheme *Pound* directs all requests from
      the same client IP address to the same back-end server. Put the
      line "Session IP 300" in the configuration file to achieve this effect.
      If the timeout value is negative, requests from a given address will
      always be directed to the same back-end server, otherwise the initial
      assignment is random. The value indicates what period of inactivity is
      allowed before the session is discarded.

    - by Basic Authentication: in this scheme *Pound* directs all requests from
      the same user (as identified in the Basic Authentication header ) to the
      same back-end server. Put the line "Session BASIC 300" in the
      configuration file to achieve this effect. The value indicates what
      period of inactivity is allowed before the session is discarded.
      WARNING: given the constraints of the HTTP protocol it may very well be
      that the authenticated request will go to a different back-end server than
      the one originally requesting it. Make sure all your servers support
      the same authentication scheme!

    - by URL parameter: quite often session information is passed through URL
      parameters (the browser is pointed to something like http://xxx?id=123).
      Put the line "Session URL id 120" to support this scheme and the sessions
      will be tracked based on the value of the "id" parameter.

    - by cookie value: applications that use this method pass a certain cookie
      back and forth. Add the line "Session COOKIE sess 180" to your
      configuration file - the sessions will be tracked by the value of the
      "sess" cookie.

    Please note the following restrictions on session tracking:

    - session tracking is always associated with a certain UrlGroup. Thus each
      group may have other methods and parameters.

    - there is no default session: if you have not defined any sessions no
      session tracking will be done.

    - only one session definition is allowed per URL group (this may change in
      a future version). If your application has alternative methods for
      sessions you will have to define a separate UrlGroup for each method.


REQUEST LOGGING

    As a general rule, *Pound* passes all headers as they arrive from the client
    browser to the back-end server(s). There are two exceptions to this rule:
    *Pound* may add information about the SSL client certificate (as described
    below), and it will add an X-Forwarded-For header. The general format is::

        X-Forwarded-for: client-IP-address

    The back-end server(s) may use this extra information in order to create
    their log-files with the real client address (otherwise all requests will
    appear to originate from *Pound* itself, which is rather useless).

    In addition, *Pound* logs requests and replies to the system log. This is
    controlled by the LogLevel configuration variable (0 - no logging,
    1 - normal log, 2 - full log, 3 - Apache combined log format, 4 - Apache
    combined log format without virtual host).

    By default the messages go to the LOG_DAEMON facility, but you can change
    this in the configuration. If you don't want to, you can just do a::

        fgrep pound /var/log/messages

    to get all the messages generated by *Pound*.


HTTPS CERTIFICATES

    If a client browser connects via HTTPS and if it presents a
    certificate and if HTTPSHeaders is set, *Pound* will obtain the
    certificate data and add the following HTTP headers to the
    request it makes to the server:

    - X-SSL-Subject: information about the certificate owner

    - X-SSL-Issuer: information about the certificate issuer (CA)

    - X-SSL-notBefore: begin validity date for the certificate

    - X-SSL-notAfter: end validity date for the certificate

    - X-SSL-serial: certificate serial number (in decimal)

    - X-SSL-cipher: the cipher currently in use

    - X-SSL-certificate: the full client certificate (multi-line)

    It is the application's responsibility to actually use these
    headers - *Pound* just passes this information without checking
    it in any way (except for signature and encryption correctness).

    Please note that this mechanism allows forgeries: a client may
    (maliciously) send these headers to *Pound* in order to masquerade
    as an SSL client with a specific certificate. If this is a problem
    for your application make sure to deny these requests. Add::

        HeadDeny X-SSL-Subject ".*"
        HeadDeny X-SSL-Issuer ".*"
        HeadDeny X-SSL-notBefore ".*"
        HeadDeny X-SSL-notAfter ".*"
        HeadDeny X-SSL-serial ".*"
        HeadDeny X-SSL-cipher ".*"

    within the UrlGroup(s).


THREADS AND LIMITS

    A few people ran into problems when installing *Pound* because of the
    various threading models and how they interact with system-imposed
    limits. Please keep in mind the following requirements:

    - on most System V derived Unices (of which Linux is one), a thread
      is a process. This means that when doing a ps you will see as many
      processes with the name 'pound' as there are active threads. Each
      such process uses only two file descriptors, but the system needs
      to support the required number of processes, both in total and per
      user (possibly also per process group). In bash, this is 'ulimit -u',
      in csh this is 'limit maxproc'.

    - on BSD style systems all threads run in the same process space. Do
      a ps and you see a single 'pound' process. The process needs two
      file descriptors per active request (bash: 'ulimit -n', csh
      'limit maxfiles'/'limit openfiles').

    - on most systems the thread library comes with a built-in limit on the
      maximal number of concurrent threads allowed - usually 1024. In very
      rare cases (very high load and long response times) you may run into
      this limitation - the symptom is log messages saying "can't create
      thread". Your only solution is to recompile the system threads library
      with a higher limit.

    Please note that your kernel needs to be configured to support the
    required resources - the above are just the shell commands.

SIMILAR SYSTEMS

    Quite a few people asked "What is wrong with Apache/Squid/
    stunnel/your_favorite? Do we really need another proxy
    system?". The simple answer is that there is nothing wrong -
    they are all excellent systems that do their jobs very well.
    The reasoning behind *Pound* is however slightly different:

    - In my experience, a load-balancer may easily become a
      bottle-neck in itself. If you have a heavily loaded site,
      there are few things more depressing than seeing your
      "load-balancer" slow down the entire network. This means that
      the load-balancer should be kept as light-weight as possible.

    - Security: auditing a large system for security issues is a
      major undertaking for anybody (ask Bill Gates about it). This
      implies that in order to avoid introducing new vulnerabilities
      into a system (after all, your installation is only as secure
      as its weakest component) the proxy/load-balancer should be
      kept as small as possible.

    - Protection: I assume *Pound* will be the only component exposed
      to the Internet - your back-end servers will run in a protected
      network behind it. This means that *Pound* should filter requests
      and make sure only valid, correctly formed ones are passed to the
      back-end servers, thus protecting them from malicious clients.

    Taking these criteria into consideration, it is easy to see why
    the other systems mentioned above do not fit:

    - Apache (with mod_proxy and mod_backhand): great system, but very
      large. Imposes a significant load on the system, complex set-up
      procedure (and it is so easy to get it wrong: check how many Apache
      servers allow proxying from and to external hosts). While Apache
      has proven remarkably exploit free, I wouldn't wish to go into a
      security audit for the tens of thousands of lines of code involved,
      not to mention all the additional modules.

    - Squid: great caching proxy, but even should load-balancing
      features become available in the future, do you really need
      caching on the load-balancer? After all, *Pound* can easily run on a
      disk-less system, whereas with Squid you'd better prepare a high
      throughput RAID. Squid is still perfectly usable as a caching
      proxy between *Pound* and the actual Web server, should it lack
      its own cache (which Zope happily has).

    - stunnel: probably comes closest to my understanding of software
      design (does one job only and does it very well). However, it
      lacks the load balancing and HTTP filtering features that I
      considered necessary. Using stunnel in front of *Pound* (for HTTPS)
      would have made sense, except that integrating HTTPS into *Pound*
      proved to be so simple that it was not worth the trouble.

    - your favorite system: let me know how it looks in light of the
      above criteria - I am always interested in new ideas.


DEDICATED SERVERS

    Some people asked about the possibility of dedicating specific
    back-end servers to some clients - in other words, if a request
    originates from a certain IP address or group of addresses then
    it should be sent to a specific group of back-end servers.

    Given the ease with which IP addresses can be forged I am personally
    doubtful of the utility of such a feature. Even should you think it
    desirable, it is probably best implemented via the packet filter,
    rather than a proxy server. Assuming that requests from x.com are
    to go to s1.local, requests from y.com to s2.local and everything
    else to s3.local and s4.local, here is how to do it:

    - make sure your firewall blocks requests to port 8080, 8081 and 8082

    - start three instances of *Pound*:

        1. listens on port 8080, passes requests to s1.local port 80

        2. listens on port 8081, passes requests to s2.local port 80

        3. listens on port 8082, passes requests to s3.local port 80
           and s4.local port 80

    - have your packet filter redirect requests to the right local ports
      based on the origin address. In OpenBSD pf syntax this would be
      something like::

        rdr on rl0 from x.com to myhost.com port 80 -> localhost port 8080
        rdr on rl0 from y.com to myhost.com port 80 -> localhost port 8081
        rdr on rl0 from any to myhost.com port 80 -> localhost port 8082

      or in Linux iptables::

        iptables -t nat -A PREROUTING -p tcp -s x.com --dport 80 -i eth0 \
            -j DNAT --to 127.0.0.1:8080
        iptables -t nat -A PREROUTING -p tcp -s y.com --dport 80 -i eth0 \
            -j DNAT --to 127.0.0.1:8081
        iptables -t nat -A PREROUTING -p tcp --dport 80 -i eth0 -j DNAT \
            --to 127.0.0.1:8082

    This would give you the desired effect and probably better
    performance than a purely proxy-based solution (though the
    performance improvement is debatable, at least on Linux).


WebDAV

    As of version 1.0 *Pound* supports the full WebDAV command-set. In
    fact, it has been tested and is known to (almost) work with the
    Microsoft Outlook Web Gateway, which is quite remarkable given that
    Microsoft's own proxy does not.

    Regrettably, Microsoft adherence to standards leaves something to be
    desired: they decided to add some characters to their URLs - thus
    breaking a whole set of RFC's.

    Rather then change *Pound* to accept these characters (which could create
    some serious issues with security on other systems) we have made this
    behavior dependent on a compile-time switch. This is not accessible
    through the config file - you'll have to add -DMSDAV to the CFLAGS in
    the Makefile (or run configure --enable-msdav). You are free to do so,
    but be aware of what the implications are!

    In addition to this flag you must specify 'WebDAV 1' in the config file.
    If you also use the SSL wrapper feature in front of a Microsoft server
    you should probably also add 'HTTPSHeaders 1 "Front-End-Https: on"'.

    These changes are also required to access a Subversion server via
    *Pound*.


OTHER ISSUES

    The following problems were reported by various people who use pound:

    - delays in loading pages when the client browser is IE 5.5 (possibly
      limited to W2K/XP). It seems that IE opens exactly 4 connections (sockets)
      to the server and keeps them open until some time-out or until the server
      closes the connection. This works fine, unless you redirect IE to another
      server - given that all 4 sockets are used IE waits for a while before
      the redirect is actually performed.

      Solution: use the directive "Client 1" to ensure that *Pound* closes
      sockets very early, thus freeing the necessary resources. Experiment with
      the time-out - as it may cause problems with slow connections.

    - *Pound* fails to start; HTTPS is enabled and the message "can't read
      private key from file xxx" appears in the log.

      Solution: make sure that the certificate file includes:

      - (optional) a chain of certificates from a known certificate authority to
        your server certificate

      - the server certificate

      - the private key; the key may NOT be password-protected

      The file should be in PEM format. The OpenSSL command to generate a
      self-signed certificate in the correct format would be something like::

        openssl req -x509 -newkey rs:1024 -keyout test.pem -out test.pem \
            -days 365 -nodes

      Note the '-nodes' flag - it's important!

    - *Pound* fails to operate correctly with SSL when RootJail is specified.
      Solution: OpenSSL requires access to /dev/urandom, so make sure such a device
      is accessible from the root jail directory. Thus if your root jail is
      something like /var/pound:

        mkdir /var/pound/dev
        mknod /var/pound/dev/urandom c 1 9

      or whatever major/minor number are appropriate for your system.

    - In chroot mode logging may stop functioning.
      Solution: make sure /dev and the root jail are on the same filesystem
      and create a hard link in the root jail to /dev/log:

        mkdir /chroot/jail/dev
        ln /dev/log /chroot/jail/dev/log

      Alternately you can have syslog (or syslog-ng) listen on another socket -
      see the man page for details.

    - In chroot mode name resolution (and especially redirects) may stop functioning.
      Solution: make sure either you have a working DNS or that /etc/hosts is available
      in the root jail. Failing that the translation of host names to IP addresses would
      fail, thereby defeating the mechanism *Pound* uses to identify when should a
      Redirect be rewritten.

    - IE 5.x fails to work (correctly or at all) with *Pound* in HTTPS mode.
      Solution: define the supported OpenSSL ciphers for IE compatibility (this
      is really a work-around for a known IE bug):

        ListenHTTPS 1.2.3.4,443 /etc/pound.pem ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP:+eNULL

      (Thanks to Andi Roedl for the tip).


ACKNOWLEDGMENTS

    "Luuk de Boer", mailto:luuk@planet.nl did some serious testing and
    debugging of the WebDAV code for Microsoft servers.

    "David Couture", mailto:dc@intuit.com found some nasty, lurking bugs,
    as well as contributing some serious testing on big hardware.

    "Frank Denis", mailto:j@pureftpd.org contributed a few excellent code
    patches and some good ideas.

    "Abner G. Jacobsen", mailto:abner@integraweb.com.br did a lot of testing
    in a production environment and contributed some very nice ideas.

    "Akira Higuchi", mailto:a-higuti@gray.plala.or.jp found a significant
    security issue in *Pound* and contributed the code to fix it.

    "Ken Lalonde", mailto:ken@torus.ca contributed very useful remarks and
    suggestions, as well as correcting a few code errors.

    "Phil Lodwick", mailto:Phil.Lodwick@EFI.com contributed essential parts
    of the high-availability code and came up with some good ideas. In
    addition, did some serious testing under heavy loads.

    "Jan-Piet Mens", mailto:jpmens@yahoo.de raised some interesting security
    points about the HTTPS implementation and brought the original idea
    for SSL header filtering.

    "Andreas Roedl", mailto:andreas.roedl@native-instruments.de for testing
    and some ideas about logging in root jails.

    "Gurkan Sengun", mailto:gurkan@linuks.mine.nu tested *Pound* on Solaris,
    contributed the Solaris cc flags and makes a Solaris 7 pre-compiled
    version available on his Web-site (www.linuks.mine.nu)

    "Shinji Tanaka", mailto:stanaka@hatena.ne.jp contributed a patch for
    controlling logging to disk files. This is available "here",
    http://www.hatena-inc.co.jp/~stanaka/pound/

    "Jim Washington", mailto:jwashin@vt.edu contributed the code for WebDAV
    and tested it.

    "Maxime Yve", mailto:maxime.yve@free.fr discovered a nasty bug in the session
    tracking code and contributed the patch to fix it.

    All the others who tested *Pound* and told me about their results.

STABLE VERSIONS

    -   "Pound-1.7.tgz", http://www.apsis.ch/pound/Pound-1.7.tgz
        ("signature", http://www.apsis.ch/pound/Pound-1.7.asc)

    -   "Pound-1.6.tgz", http://www.apsis.ch/pound/Pound-1.6.tgz
        ("signature", http://www.apsis.ch/pound/Pound-1.6.asc)

    -   "Pound-1.5.tgz", http://www.apsis.ch/pound/Pound-1.5.tgz
        ("signature", http://www.apsis.ch/pound/Pound-1.5.asc)

    -   "Pound-1.4.tgz", http://www.apsis.ch/pound/Pound-1.4.tgz
        ("signature", http://www.apsis.ch/pound/Pound-1.4.asc)

    -   "Pound-1.3.tgz", http://www.apsis.ch/pound/Pound-1.3.tgz
        ("signature", http://www.apsis.ch/pound/Pound-1.3.asc)

    -   "Pound-1.2.tgz", http://www.apsis.ch/pound/Pound-1.2.tgz
        ("signature", http://www.apsis.ch/pound/Pound-1.2.asc)

    -   "Pound-1.1.tgz", http://www.apsis.ch/pound/Pound-1.1.tgz
        ("signature", http://www.apsis.ch/pound/Pound-1.1.asc)

    -   "Pound-1.0.tgz", http://www.apsis.ch/pound/Pound-1.0.tgz
        ("signature", http://www.apsis.ch/pound/Pound-1.0.asc)