Dependencies

• Apache 2.2.x
• Imagemagick 6.6+
• libcurl 7.18.0+

Compiling

./autorun.sh --with-imagemagick=/path/to/imagemagick --with-apache=/path/to/apache

The paths provided above are prefix paths used to install those dependencies. If you installed Imagemagick and Apache (including APR) in /usr/local you would run:

./autorun.sh --with-imagemagick=/usr/local --with-apache=/usr/local

Installation

Add the following to the Apache configuration:

<IfModule !mod_dims.c>
    LoadModule dims_module modules/mod_dims.so
</IfModule>

AddHandler dims-local .gif .jpg

<Location /dims/>
    SetHandler dims
</Location>

<Location /dims3/>
    SetHandler dims3
</Location>

<Location /dims-status/>
    SetHandler dims-status
</Location>

This assumes mod_dims.so has been installed in $HTTP_ROOT/modules.

Errors

There are three classes of errors in mod_dims;

• Errors caused during downloading of a source image. These come directly from libcurl and are logged as-is.

• Errors caused during an ImageMagick operation. These come directly from ImageMagik and are logged as-is.

• Errors caused during processing of a request by mod_dims. These fall into the category of bad input checking, bad config, etc.

ImageMagick Timeout Error Format:

[client Imagemagick operation, '', timed out after 4 ms