NAME

        GAH - Glist Archive Handler

WHAT SHOULD GAH BE?

Archiving functionality for glist

        Gah should store glist mails in a archive for each list,
        through it's own command line utility and internal
        API. Any program should be able to use gah though,
        it should not just be restricted to glist.

It should be able to save files to the archive

It should be able to fetch files from the archive

It should be able to expire messages in the archive

It should be able to store non-text attachments to it's own space, so the attachements in the mails are replaced with an URL or path location to the files.

WHAT SHOULD GAH *NOT* BE?

Web interface for the archive

        Though new programs can use the interface to create
        a web interface.

...another os ;)

SYNOPSIS

        use Gah;
        my $gah = new Gah;
        $gah->select_list('glist-list@glist.org);
        $gah->store($file);
        my $mid = $gah->mid;
        my $gah_header = $gah->genheader;
        my $message = $gah->fetch($mid);
        $gah->flush_list;

DESCRIPTION

CONSTRUCTORS

new

        Create a new gah object.

ACCESSORS

list

        The current/last mailinglist we are/were working with.

        Name: Gah::{LIST}

mid

        The current/last message id we are/were working with.

        Name: Gah::{MID}

METHODS

select_list

        Select the current list we should start working on.
        Changes Gah::{LIST}

select_mid

        Select the current message id we should start working on.
        Changes Gah::{MID}

get_next_mid

        Get the next message id availible

store

        Store a message in the current mailing list archive.

fetch

        Fetch a message in the current mailing list archive.

destroy

        Kill a message in the current mailing list archive.

genheader

        The genheader function is for generating the List-Archive header.

        genheader should return something like:
        http://www.glist.org/gah/glist-list@glist.org/20010419000001

        if there is a url for this list, else it will return something like:
        glist-list@glist.org/20010419000001

FILES

PREFIX/etc/glist.config

        The glist configuration file.

PREFIX/var/gah/archive/

        The archive directory for storing messages.

PREFIX/var/gah/data/<listname>.dat

        Index of the archive for fast searching.

PREFIX/var/gah/data/mid.dat

        Index of the message id's

DOCUMENT AUTHORS

        Ask Solem Hoel <ask@unixmonks.net>