← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/dansguardian/intrepid-security

« back to all changes in this revision

Viewing changes to INSTALL

  • Committer: Bazaar Package Importer
  • Author(s): Alexander Wirt
  • Date: 2005-04-08 21:02:42 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050408210242-ie5s6v0nbmlinpxn
Tags: 2.8.0.4-2
http://bugs.debian.org/303762
Added --oknodo to start-stop-daemon to get restarting 
working if it isn't started before (Closes: #303762)
Thanks to Kevin Traas for the patch 

Show diffs side-by-side

added added

removed removed

Lines of Context:
INSTALL
12
12
 
13
13
*** OS X / Darwin users, please read the OS X section first. ***
14
14
 
 
15
You need zlib-devel installed in order to build DansGuardian.
 
16
For Red Hat install zlib-devel rpm, for Debian
 
17
apt-get install zlib1g-dev.
 
18
 
 
19
As of DansGuardian 2.7.7-10 zlib 1.2.1 is required for gzip
 
20
support.  This change was to fix a bug that could not be fixed
 
21
with an earlier version.  If you do not want to upgrade zlib on
 
22
your system see the notes at the end about compiling in zlib
 
23
statically.
 
24
 
15
25
 
16
26
1.      Run the configure (./configure --help) script with
17
27
        the help option to see the user selectable settings.
22
32
 
23
33
NOTE:
24
34
----
25
 
        RedHat 6.2 and 7.0 users can run with the default settings.
26
 
        RedHat 7.1 and 7.2 will have to change their cgibin.
 
35
        RedHat 6.2 and 7.0 will have to change their cgibin.
 
36
        RedHat 7.1 and 7.2 users can run with the default settings.
27
37
        OpenBSD and FreeBSD will have to set just about all settings.
28
38
        Others, just find your section in this file.
29
39
 
39
49
 
40
50
 
41
51
** You can often use "make -j" or "make -j 99" to compile faster.
42
 
   With Solaris and possibly others you may need "gmake" instead of "make".
 
52
   With Solaris and FreeBSD possibly others you may need "gmake"
 
53
   instead of "make".
 
54
   
43
55
 
44
56
 
45
57
OPTIONS:
74
86
*** Note in order to do any compiling in OS X you need to install ***
75
87
*   the Developer Tools - an additional pkg called BSDSDK.pkg.      *
76
88
 
77
 
*** Note DG2.7.x does not currently work as it uses poll() which OSX ***
 
89
*** Note DG2.8.x does not currently work as it uses poll() which OSX ***
78
90
*   lacks.  There is a workaround though.  See:                        *
79
91
*** http://groups.yahoo.com/group/dansguardian/message/5027          ***
80
92
 
102
114
NETBSD:
103
115
------
104
116
 
105
 
A standard configure script that should work, provided you have installedNetBSD and the associated programs in their default locations.
 
117
A standard configure script that should work, provided you have installed
 
118
NetBSD and the associated programs in their default locations.
106
119
    ./configure --cgidir=/usr/pkg/www/cgi-bin/ \
107
120
        --sysconfdir=/usr/pkg/etc/dansguardian/ \
108
121
        --sysvdir=/usr/pkg/etc/rc.d/ \
131
144
log files to '--logdir=/usr/local/dansguardian/logs/' and use the
132
145
provided log rotation script.  Alternatively stick with the default
133
146
(/var/log/dansguardian/) and read newsyslog(8).
 
147
Note: You need to run gmake rather than make as of version 2.8.
134
148
 
135
149
 
136
150
OPENBSD:
148
162
 
149
163
REDHAT 6.2/7.0:
150
164
--------------
151
 
It is safe to run the configure (./configure) script with the defaults.
 
165
Here is a configure example for RedHat 6.2 + 7.0:
 
166
 
 
167
    ./configure --sysconfdir=/etc/dansguardian/ \
 
168
        --sysvdir=/etc/rc.d/init.d/ \
 
169
        --cgidir=/home/httpd/cgi-bin/
152
170
 
153
171
 
154
172
 
156
174
--------------------------------
157
175
Here is a configure example for RedHat 7.1 + 7.2 + 8 + 9 + Fedora Core 1:
158
176
        
159
 
    ./configure --sysconfdir=/usr/local/etc/dansguardian/ \
 
177
    ./configure --sysconfdir=/etc/dansguardian/ \
160
178
        --sysvdir=/etc/rc.d/init.d/ \
161
 
        --cgidir=/var/www/cgi-bin/
162
179
 
163
180
 
164
181
 
213
230
 
214
231
 
215
232
Debian 2.2:
216
 
-----------
 
233
----------
217
234
Here is a configure example for Debian 2.2, it is much like Suse 7.3:
218
235
        
219
236
    ./configure --runas_grp=nogroup \
226
243
 
227
244
 
228
245
Debian 3.0 (Woody):
229
 
-----------
 
246
------------------
230
247
It is suggested to install the current debian binary version first:
231
248
 
232
249
     apt-get install dansguardian
233
 
        
 
250
 
 
251
OR
 
252
       
234
253
    ./configure --runas_grp=dansguardian \
235
254
        --runas_usr=dansguardian
236
255
        --sysvdir=/etc/init.d/ \
304
323
from the url above. The mailing list can be found on the url.
305
324
 
306
325
 
 
326
 
 
327
HOT TO COMPILE STATICALLY WITH ZLIB: (Provided by Ernest W. Lessenger)
 
328
-----------------------------------  Tested/Corrected by Daniel Barron
 
329
Step 0:
 
330
Configure DansGuardian as usual
 
331
        <start in the DG source directory>
 
332
        ./configure
 
333
 
 
334
Step 1:
 
335
Download zlib and decompress it as a subdirectory of your DG installation.
 
336
Rename the decompressed folder as "zlib"
 
337
        tar xvzf zlib-1.2.1.tar.gz
 
338
        mv zlib-1.2.1 zlib
 
339
 
 
340
Step 2:
 
341
Configure and compile
 
342
        cd zlib
 
343
        ./configure
 
344
        make (DO NOT 'make install')
 
345
        cd ..
 
346
 
 
347
Step 3:
 
348
Minor tweaks to the DansGuardian source code and Makefile
 
349
        @@@ Makefile
 
350
        - DGCFLAGS = $(OPTIMISE) $(PASSVARS) -lz $(STATIC)
 
351
        + DGCFLAGS = $(OPTIMISE) $(PASSVARS) $(STATIC)
 
352
        - LIBS = /usr/lib/libz.a
 
353
        + LIBS = ./zlib/libz.a
 
354
 
 
355
        @@@ All other files
 
356
        - #include <zlib.h>
 
357
        + #include "zlib/zlib.h"
 
358
 
 
359
Alternate Step3 using proper gcc options suggested by Lawrence and Martin from SmoothWall:
 
360
Minor tweaks to the DansGuardian source code and Makefile
 
361
        @@@ Makefile
 
362
        - DGCFLAGS = $(OPTIMISE) $(PASSVARS) -lz $(STATIC)
 
363
        + DGCFLAGS = $(OPTIMISE) $(PASSVARS) -Wl,-Bstatic -lz -Wl,-Bdynamic $(STATIC)
 
364
 
 
365
        perl -pi.bak -e 's{\<zlib.h\>}{\"zlib/zlib.h\"};' *
 
366
 
 
367
 
 
368
Step 4:
 
369
Make DG
 
370
        make
 
371
 
 
372
That should be it. You shouldn't receive any warnings, and zlib should be
 
373
compiled statically.