summaryrefslogtreecommitdiff
path: root/ext/Compress/Zlib/README
blob: e5291ad4daf95514a2d30860c9616d687c0a0b81 (plain)
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

                             Compress::Zlib

                             Version 2.001

                             1st November 2006


       Copyright (c) 1995-2006 Paul Marquess. All rights reserved.
          This program is free software; you can redistribute it
           and/or modify it under the same terms as Perl itself.




DESCRIPTION
-----------


This module provides a Perl interface to the zlib compression library.  





PREREQUISITES
-------------

Before you can build Compress::Zlib you need to have the following
installed on your system:


    * Perl 5.004 or better. 
    * Compress::Raw::Zlib
    * IO::Compress::Gzip





BUILDING THE MODULE
-------------------

Assuming you have met all the prerequisites, the module can now be built
using this sequence of commands:

    perl Makefile.PL
    make
    make test



INSTALLATION
------------

To install Compress::Zlib, run the command below:

    make install





TROUBLESHOOTING
---------------


Undefined Symbol gzsetparams
----------------------------

If you get the error shown below when you run the Compress::Zlib test
harness it probably means you are running a copy of zlib that is
version 1.0.5 or older.

t/01version.........Can't load 'blib/arch/auto/Compress/Zlib/Zlib.so' for 
                    module Compress::Raw::Zlib: blib/arch/auto/Compress/Raw/Zlib/Zlib.so:
                    undefined symbol: gzsetparams at ...

There are two ways to fix this problem:

    1. Upgrade to the latest version of zlib.

    2. Edit config.in and set the OLD_ZLIB variable to True.



Test Harness 01version fails
----------------------------
If the 01version test harness fails, and the problem isn't covered by the
scenario above, it probably means that you have two versions of 
zlib installed on your system.

Run the command below to see if this is indeed the case

    make test TEST_VERBOSE=1 TEST_FILES=t/01version.t 

Try removing the one you don't want to use and rebuild.   









FEEDBACK
--------

How to report a problem with Compress::Zlib.

To help me help you, I need all of the following information:

 1. The Versions of everything relevant.
    This includes:

     a. The *complete* output from running this
     
            perl -V
     
        Do not edit the output in any way.
        Note, I want you to run "perl -V" and NOT "perl -v".
     
        If your perl does not understand the "-V" option it is too
        old. This module needs Perl version 5.004 or better.     

     b. The version of Compress::Zlib you have. 
        If you have successfully installed Compress::Zlib, this one-liner
        will tell you:

           perl -MCompress::Zlib -e 'print qq[ver $Compress::Zlib::VERSION\n]'

        If you areplete* output from running this
     
            perl -V
     
        Do not edit the output in any way.
        Note, I want you to run "perl -V" and NOT "perl -v".
     
        If your perl does not understand the "-V" option it is too
        old. This module needs Perl version 5.004 or better.     

     b. The version of Compress::Zlib you have. 
        If you have successfully installed Compress::Zlib, this one-liner
        will tell you:

           perl -MCompress::Zlib -e 'print qq[ver $Compress::Zlib::VERSION\n]'

        If you are  running windows use this

           perl -MCompress::Zlib -e "print qq[ver $Compress::Zlib::VERSION\n]"

        If you haven't installed Compress::Zlib then search Compress::Zlib.pm
        for a line like this:

          $VERSION = "1.05" ;



 2. If you are having problems building Compress::Zlib, send me a
    complete log of what happened. Start by unpacking the Compress::Zlib
    module into a fresh directory and keep a log of all the steps

        [edit config.in, if necessary]
        perl Makefile.PL
        make
        make test TEST_VERBOSE=1          


Paul Marquess <pmqs@cpan.org>