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>