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