Installing Prelude-LML

This section explains how to install the Prelude-LML log analyzer from the tarball available from the Prelude website. However, Prelude-LML might be included with your distribution as a package and it would be easier to install it this way.

Table of Contents

Install Dependencies

Ensure that you have the Prelude Library installed. Instructions on installing libprelude can be found on the PreludeDB Library Installation Page

Get the sources

Download the latest Prelude-LML


The first step of the installation procedure is to configure the source tree for your system and choose the options you would like. This is done by running the configure script. For a default installation simply enter


This script will run a number of tests to guess values for various system dependent variables and detect some quirks of your operating system, and finally will create several files in the build tree to record what it found. (You can also run configure in a directory outside the source tree if you want to keep the build directory separate.)

You can customize the build and installation process by supplying one or more of the following command line options to configure:

Installation directories

  • --prefix=PREFIX
    Install all files under the directory PREFIX instead of /usr/local. The actual files will be installed into various subdirectories; no files will ever be installed directly into the PREFIX directory.

    If you have special needs, you can also customize the individual subdirectories with the following options.

  • --exec-prefix=EXEC-PREFIX

    You can install architecture-dependent files under a different prefix, EXEC-PREFIX, than what PREFIX was set to. This can be useful to share architecture-independent files between hosts. If you omit this, then EXEC-PREFIX is set equal to PREFIX and both architecture-dependent and independent files will be installed under the same tree, which is probably what you want.

  • --bindir=DIRECTORY

    Specifies the directory for executable programs. The default is EXEC-PREFIX/bin, which normally means /usr/local/bin.

  • --datadir=DIRECTORY

    Sets the directory for read-only data files used by the installed programs. The default is PREFIX/share.

  • --sysconfdir=DIRECTORY

    The directory for various configuration files, PREFIX/etc by default.

  • --libdir=DIRECTORY

    The location to install libraries and dynamically loadable modules. The default is EXEC-PREFIX/lib.

  • --includedir=DIRECTORY

    The directory for installing C and C++ header files. The default is PREFIX/include.

  • --mandir=DIRECTORY

    The man pages that come with Prelude-LML will be installed under this directory, in their respective man_N_ subdirectories. The default is PREFIX/man.

Path to dependencies

  • --with-libprelude-prefix=PFX

    Prelude-LML require the Prelude Library in order to build. Using this option you can tell the configure script in which prefix libprelude has been installed.

  • --with-fam-prefix=PFX

    Prelude-LML can make use of FAM (or Gamin) to get real time notification for files changes. Using this option you can tell the configure script in which prefix FAM has been installed.

Once finished, the configure script will dump a summary of the enabled features:

*** Dumping configuration ***
    - Enable FAM support                  : yes
    - Enable unsupported rulesets:        : yes


To start the build, type


The build will take a few minutes depending on your hardware.

Regression Tests

If you want to test the newly built program before you install it, you can run the regression tests at this point. The regression tests are a test suite to verify that Prelude-LML runs on your machine in the way the developers expected it to. Type

make check


To install Prelude-LML enter

make install

This will install files into the directories that were specified in step 1. Make sure that you have appropriate permissions to write into that area. Normally you need to do this step as root. Alternatively, you could create the target directories in advance and arrange for appropriate permissions to be granted.

You can use make install-strip instead of make install to strip the executable files and libraries as they are installed. This will save some space. If you built with debugging support, stripping will effectively remove the debugging support, so it should only be done if debugging is no longer needed. install-strip tries to do a reasonable job saving space, but it does not have perfect knowledge of how to strip every unneeded byte from an executable file, so if you want to save all the disk space you possibly can, you will have to do manual work.

The standard installation provides all the header files needed for Prelude-LML plugin development, such as custom functions or data types written in C.