Commit | Line | Data |
642e522c |
1 | |
25f0751f |
2 | Compress::Zlib |
f4c6fd49 |
3 | |
63ad731d |
4 | Version 2.001 |
25f0751f |
5 | |
63ad731d |
6 | 1st November 2006 |
642e522c |
7 | |
f4c6fd49 |
8 | |
1a6a8453 |
9 | Copyright (c) 1995-2006 Paul Marquess. All rights reserved. |
25f0751f |
10 | This program is free software; you can redistribute it |
11 | and/or modify it under the same terms as Perl itself. |
f4c6fd49 |
12 | |
f4c6fd49 |
13 | |
f4c6fd49 |
14 | |
15 | |
16 | DESCRIPTION |
17 | ----------- |
18 | |
f4c6fd49 |
19 | |
25f0751f |
20 | This module provides a Perl interface to the zlib compression library. |
f4c6fd49 |
21 | |
f4c6fd49 |
22 | |
23 | |
642e522c |
24 | |
25 | |
f4c6fd49 |
26 | PREREQUISITES |
27 | ------------- |
28 | |
29 | Before you can build Compress::Zlib you need to have the following |
30 | installed on your system: |
31 | |
f4c6fd49 |
32 | |
33 | * Perl 5.004 or better. |
25f0751f |
34 | * Compress::Raw::Zlib |
35 | * IO::Compress::Gzip |
36 | |
37 | |
f4c6fd49 |
38 | |
f4c6fd49 |
39 | |
40 | |
41 | BUILDING THE MODULE |
42 | ------------------- |
43 | |
44 | Assuming you have met all the prerequisites, the module can now be built |
45 | using this sequence of commands: |
46 | |
47 | perl Makefile.PL |
48 | make |
49 | make test |
50 | |
51 | |
52 | |
53 | INSTALLATION |
54 | ------------ |
55 | |
56 | To install Compress::Zlib, run the command below: |
57 | |
58 | make install |
59 | |
25f0751f |
60 | |
61 | |
f4c6fd49 |
62 | |
63 | |
64 | TROUBLESHOOTING |
65 | --------------- |
66 | |
25f0751f |
67 | |
f4c6fd49 |
68 | Undefined Symbol gzsetparams |
69 | ---------------------------- |
70 | |
71 | If you get the error shown below when you run the Compress::Zlib test |
25f0751f |
72 | harness it probably means you are running a copy of zlib that is |
73 | version 1.0.5 or older. |
f4c6fd49 |
74 | |
75 | t/01version.........Can't load 'blib/arch/auto/Compress/Zlib/Zlib.so' for |
25f0751f |
76 | module Compress::Raw::Zlib: blib/arch/auto/Compress/Raw/Zlib/Zlib.so: |
f4c6fd49 |
77 | undefined symbol: gzsetparams at ... |
78 | |
79 | There are two ways to fix this problem: |
80 | |
81 | 1. Upgrade to the latest version of zlib. |
82 | |
83 | 2. Edit config.in and set the OLD_ZLIB variable to True. |
84 | |
85 | |
86 | |
87 | Test Harness 01version fails |
88 | ---------------------------- |
25f0751f |
89 | If the 01version test harness fails, and the problem isn't covered by the |
90 | scenario above, it probably means that you have two versions of |
91 | zlib installed on your system. |
f4c6fd49 |
92 | |
93 | Run the command below to see if this is indeed the case |
94 | |
95 | make test TEST_VERBOSE=1 TEST_FILES=t/01version.t |
96 | |
97 | Try removing the one you don't want to use and rebuild. |
98 | |
99 | |
100 | |
f4c6fd49 |
101 | |
642e522c |
102 | |
642e522c |
103 | |
f4c6fd49 |
104 | |
105 | |
106 | |
f4c6fd49 |
107 | FEEDBACK |
108 | -------- |
109 | |
110 | How to report a problem with Compress::Zlib. |
111 | |
112 | To help me help you, I need all of the following information: |
113 | |
25f0751f |
114 | 1. The Versions of everything relevant. |
115 | This includes: |
116 | |
117 | a. The *complete* output from running this |
118 | |
119 | perl -V |
120 | |
121 | Do not edit the output in any way. |
122 | Note, I want you to run "perl -V" and NOT "perl -v". |
123 | |
124 | If your perl does not understand the "-V" option it is too |
125 | old. This module needs Perl version 5.004 or better. |
126 | |
127 | b. The version of Compress::Zlib you have. |
128 | If you have successfully installed Compress::Zlib, this one-liner |
129 | will tell you: |
f4c6fd49 |
130 | |
25f0751f |
131 | perl -MCompress::Zlib -e 'print qq[ver $Compress::Zlib::VERSION\n]' |
f4c6fd49 |
132 | |
25f0751f |
133 | If you areplete* output from running this |
134 | |
135 | perl -V |
136 | |
137 | Do not edit the output in any way. |
138 | Note, I want you to run "perl -V" and NOT "perl -v". |
139 | |
140 | If your perl does not understand the "-V" option it is too |
141 | old. This module needs Perl version 5.004 or better. |
f4c6fd49 |
142 | |
25f0751f |
143 | b. The version of Compress::Zlib you have. |
144 | If you have successfully installed Compress::Zlib, this one-liner |
145 | will tell you: |
f4c6fd49 |
146 | |
25f0751f |
147 | perl -MCompress::Zlib -e 'print qq[ver $Compress::Zlib::VERSION\n]' |
f4c6fd49 |
148 | |
25f0751f |
149 | If you are running windows use this |
f4c6fd49 |
150 | |
25f0751f |
151 | perl -MCompress::Zlib -e "print qq[ver $Compress::Zlib::VERSION\n]" |
f4c6fd49 |
152 | |
25f0751f |
153 | If you haven't installed Compress::Zlib then search Compress::Zlib.pm |
154 | for a line like this: |
f4c6fd49 |
155 | |
25f0751f |
156 | $VERSION = "1.05" ; |
f4c6fd49 |
157 | |
158 | |
f4c6fd49 |
159 | |
25f0751f |
160 | 2. If you are having problems building Compress::Zlib, send me a |
161 | complete log of what happened. Start by unpacking the Compress::Zlib |
f4c6fd49 |
162 | module into a fresh directory and keep a log of all the steps |
163 | |
164 | [edit config.in, if necessary] |
165 | perl Makefile.PL |
166 | make |
167 | make test TEST_VERBOSE=1 |
168 | |
169 | |
170 | Paul Marquess <pmqs@cpan.org> |