1
Copyright (C) 2003 GraphicsMagick Group
2
Copyright (C) 2002 ImageMagick Studio
3
Copyright (C) 1999 E. I. du Pont de Nemours and Company
5
This program is covered by multiple licenses, which are described in
6
Copyright.txt. You should have received a copy of Copyright.txt with this
7
package; otherwise see http://www.graphicsmagick.org/www/Copyright.html.
8
---------------------------------------------------------------------------
10
This file provides platform specific portability notes which don't
11
belong in README.txt. Usually GraphicsMagick compiles fine according to the
12
procedures described in README.txt, but sometimes a platform related
13
oddity causes a failure.
20
PerlMagick fails to link.
24
libperl.a is not found.
30
./configure --enable-shared
34
./configure --enable-shared --with-modules
36
Cygwin doesn't normally come with a libperl.a but it does come with the
37
equivalent DLL. Using a shared build gets PerlMagick over the hurdle.
45
How to successfully configure GraphicsMagick using SGI's commercial
46
compiler (e.g. IRIX C/C++ v7.3.1.X)?
50
Compiling C++ code fails with the error:
51
#error directive: This header file requires the -LANG:std option
57
CC=cc CFLAGS="-O2 -OPT:Olimit=0" CXX=CC \
58
CXXFLAGS="-LANG:std -Wl,-woff,84 -O2" CXXCPP="CC -LANG:std -E" \
59
./configure --with-modules --with-threads ...
61
with the following in /etc/compiler.defaults
63
-DEFAULT:abi=n32:isa=mips3
70
When '-rpath /somedir' is added to LDFLAGS in order to tell the
71
linker to apply a run-time linker path, configure fails.
75
The configure script prints the error message
77
checking for executable suffix...
78
configure: error: cannot compute EXEEXT:
82
gcc: unrecognized option `-rpath'
84
is written to config.log
88
Use 'LDFLAGS=-Wl,-rpath,/somedir' instead to pass the options through
96
GraphicsMagick does not run after it is installed. The system does not
97
see an installed shared library until the 'ldconfig' command has
98
been executed (as root) using the correct options.
102
System fails to find shared library needed by GraphicsMagick.
106
Either reboot the system (which automatically runs ldconfig) or
109
/sbin/ldconfig -m ${PREFIX}/lib
111
where ${PREFIX} is the prefix used when configuring GraphicsMagick
112
(default /usr/local).
114
Digital Unix and OSF/1
115
======================
119
Digital Unix provides an outdated JPEG shared library as part of the
124
GraphicsMagick fails to link.
128
Ensure that the JPEG library you installed is used. Be sure to
129
install the JPEG library as a shared library.
136
An outdated delegate library is used rather than the one just
141
o Failure to link due to unresolved symbols
142
o Failure to run properly
143
o The command 'ldd `which convert`' lists the wrong library.
147
If the problem library is a shared library (.so extension) then
148
install your own library as a shared library. Then add the required
149
-L and -R options to find your shared library at both link and run
150
time. For example, if your library is is installed in /usr/local/lib:
152
configure LDFLAGS='-L/usr/local/lib -R/usr/local/lib'
156
An outdated libtiff.so (libtiff.so.3) is installed in
157
/usr/openwin/lib. This library may be used by accident rather than
158
the intended libtiff.so, or libtiff.a. In particular, the linker
159
generally considers linking against a shared library before it
160
considers static libraries, so the system libtiff.so may be used
161
even though there is an installed libtiff.a earlier in the linker
166
GraphicsMagick fails to link or load TIFF files.
170
o Install libtiff as a shared library, and make sure that LDFLAGS
171
contains the required -L and -R options to find your shared
172
library at both link and run time. For example, if libtiff.so is
173
installed in /usr/local/lib:
175
configure LDFLAGS='-L/usr/local/lib -R/usr/local/lib'
179
o Remove /usr/openwin/lib/libtiff.so.3. Note that if you take this
180
step, some tools like 'imagetool' and 'pageview' will stop working.
184
When using gcc 3.0.X, configure decides that the compiler is insufficient
193
The problem is due to gcc provided headers undefining
194
Solaris-provided defines for 64-bit versions of stdio functions. The
195
solution is to either configure with --disable-largefile or edit the
196
installed g++-v3/bits/std_cstdio.h to bracket the offending undefs
197
(for fgetpos, fopen, freopen, fsetpos, & tmpfile) like:
199
#if _FILE_OFFSET_BITS != 64
205
Install gcc 3.1 (or later) instead.
209
A static library was used in a shared library build.
213
Linker prints a warning similar to:
215
"ld: fatal: relocations remain against allocatable but non-writable
220
All libraries used in a shared library build *must* also be shared
221
libraries. Check all libraries referenced in the libtool link
222
command line and verify that all of the referenced libraries are
223
indeed shared libraries. All system libraries are available as
224
shared libraries so it is likely that any static library is locally