Chapter 2. Writing a New Superservice
Prev | Part II. Using the Lire Framework | Next

## Chapter 2. Writing a New Superservice

Writing a new superservice involves several things:

1. Making new directories in CVS:

   - `/service/<superservice>/`

   - `/service/<superservice>/script/`

   - `/service/<superservice>/reports/`

2. Adding several files:

   - `/service/<superservice>/Makefile.am`

   - `/service/<superservice>/reports/Makefile.am`

   - `/service/<superservice>/script/Makefile.am`

   - `/service/<superservice>/<superservice>.cfg`

   - `/service/<superservice>/<superservice>.xml` This file specifies the DLF format of the superservice. Ideally, it should offer a place for each and every snippet of information which will ever be found in a logfile from a program which offers functionality defined by the superservice. This file should have documentation embedded; this will show up in this manual.

3. Writing service plugins (2dlf scripts):

   - `/service/<superservice>/script/<service>2dlf.in`

4. Adapting several files:

   - `/service/configure.in` (add the Makefiles and 2dlf script to AC_OUTPUT, to get them converted from <service>2dlf.in to <service>2dlf.)

   - `/service/Makefile.am` (add the superservice directory to SUBDIRS, so that make gets run there too, when called from the root source directory.)

   - `/service/all/etc/address.cf` (to make the new service known as a member of a superservice.)

5. Update Documentation:

   - User Manual: Chapter "Supported Applications".

   - Add manpages for scripts

   - This document: add a referal to the superservice-schemas.dbx file, which gets build from superservice.xml.

   - The User Manual: add referals to superservice-reports-infos.dbx and superservice-filters-infos.dbx.

6. Update lr_config

## DLF Design

Prev | Up | Next
Part II. Using the Lire Framework | Home | The DLF Schema