~ubuntu-branches/ubuntu/trusty/maradns/trusty-proposed

« back to all changes in this revision

Viewing changes to deadwood-3.2.05/doc/compile.options

  • Committer: Package Import Robot
  • Author(s): Dariusz Dwornikowski
  • Date: 2014-02-16 19:36:04 UTC
  • mfrom: (1.2.11) (21.1.11 experimental)
  • Revision ID: package-import@ubuntu.com-20140216193604-xtmcopn9pilzszae
Tags: 2.0.09-1
* New maintainer (Closes: #739084)
* New upstream release to unstable
* Several security bugs (Closes: #739755)
   - security bugfix for CVE-2011-5055, CVE-2011-5056, CVE-2012-0024,
   CVE-2012-1570
   - security bugfix agains blind spoofing attack (no CVE number)
   - security bugfix for packet of death attack (no CVE number)
* Bump standards to 3.9.5
* Updated d/postinst to no longer modify conffiles (Closes: #710903)
* Init script fixed (Closes: #709826)
* --reinstall no longer kills the process (Closes: #701657)
* Updated old d/changelog entries, added information when the CVEs were
  fixed: 2.0.06-1, 2.0.04-1, 1.4.11-1, 1.2.12.06-1, 1.2.12.05-1, 1.0.28-1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
There are a number of different possible compile-time options for
 
2
Deadwood.  It can be compiled as follows:
 
3
 
 
4
* CentOS 5, no IPV6
 
5
 
 
6
* CentOS 5, IPV6
 
7
 
 
8
* Windows XP, no IPV6
 
9
 
 
10
The default compile gives no IPv6
 
11
 
 
12
To compile Deadwood with IPv6 support, add '-DIPV6' to the compile-time
 
13
flags, e.g. 'cd src/ ; export FLAGS='-O3 -DIPV6'; make'
 
14
 
 
15
The reason why one may wish IPv6 is to use Deadwood on an IPv6 network.
 
16
 
 
17
---
 
18
 
 
19
Full list of compile flags Deadwood has:
 
20
 
 
21
IPV6 (-DIPV6): Adds IPv6 support to Deadwood
 
22
 
 
23
STRICT_RFC2671_COMPLIANCE (-DSTRICT_RFC2671_COMPLIANCE): Normally, Deadwood
 
24
        handles EDNS (RFC2671) packets by acting like the packet was an
 
25
        ordinary RFC1035 DNS request.  This flag conforms to section 5.3 of
 
26
        RFC2671 by having Deadwood instead reply to ENDS packets with a
 
27
        "not implemented" error.
 
28
 
 
29
MINGW (use the correct Makefile): Used to replace *NIX sockets with Windows 
 
30
        sockets and make other changes to make the program a native Windows 
 
31
        service.  This  flag should not be invoked by the end-user compiling 
 
32
        Deadwood; instead use the 'Makefile.mingw' file: 
 
33
        make -f Makefile.mingw342
 
34
 
 
35
__CYGWIN__ (no flag to set; Cygwin sets this): It is also possible to 
 
36
        compile this program using Cygwin, an environment that fully
 
37
        emulates a *NIX development environment in Windows.
 
38
 
 
39
Note: The following compile-time flags will only be of interest to developers
 
40
        debugging Deadwood
 
41
 
 
42
VALGRIND_NOERRORS (-DVALGRIND_NOERRORS): Normally, Deadwood uses the contents
 
43
        of uninitialized memory as an entropy source for the random number
 
44
        generator.  This compile-time flag disables that behavior so that
 
45
        Valgrind (a debugging tool for C programs) does not complain about      
 
46
        program behavior affected by uninitizlized data.
 
47
 
 
48
XTRA_STUFF (-DXTRA_STUFF): Add some routines that allow the printing of
 
49
        debug information to standard output.  
 
50
 
 
51
OTHER_STUFF (-DOTHER_STUFF): Add some routines that aren't actually used 
 
52
        by Deadwood
 
53
 
 
54
HASH_DEBUG (-DHASH_DEBUG): Add information used by the 
 
55
        dwood2rc_n_hash_magic_number SQA regression
 
56
 
 
57
HAVE_MAIN (-DHAVE_MAIN): DwCompress.c, DwHash.c, DwMararc.c, and
 
58
        DwRadioGatun.c all have main() routines that can be enabled with
 
59
        this compile-time flag.  This is mainly used for debugging.
 
60
        DwRadioGatun.c, when compiled with 
 
61
        'gcc -g -DHAVE_MAIN -o RadioGatun DwRadioGatun.c' makes a program
 
62
        that will output on standard output the RadioGatun[32] sum of the
 
63
        first argument given to the program.  We use this in the SQA test
 
64
        (sqa_rg32) to ensure that DwRadioGatun.c makes a RadioGatun[32]
 
65
        implementation that passes all official RadioGatun[32] test vectors.
 
66
 
 
67
HSCK (-DHSCK): Adds some routines to ensure that DwHash.c is correctly
 
68
        creating a doubly linked list hash and queue.  Used with the
 
69
        debug-only Makefile.hsck make file.
 
70
 
 
71
INFLIGHT_VERBOSE (-DINFLIGHT_VERBOSE): Used by the dwood2rc_n_max_inflights 
 
72
        SQA test to ensure multiple inflight merging works
 
73
 
 
74
MARARC_C: Used internally by DwMararc.c to ensure that it sees some data
 
75
        in DwMararc.h that other program files should not see.  Not used
 
76
        as a compile-time flag.  We do things this way so a new dwood3rc
 
77
        parameter can be added by only modifying one file (however, we 
 
78
        still need to modify DwMararc.c to give said parameter a default
 
79
        value)
 
80
 
 
81
NO_INET_PTON: Deadwood uses inet_pton() to convert human-readable IP
 
82
        addresses like "10.1.2.3" in to binary IPs.  If a given system
 
83
        doesn't have inet_pton() (Windows doesn't), this creates
 
84
        a inet_pton() using inet_addr() to convert the actual IP (since
 
85
        Windows does have inet_addr() )
 
86