NAME

        Glist Queue Tracking and Spool Priority

WHAT

        You should be able to track where a spool file is in the queue.  
        You should also be able to put it on hold, remove it and 
        raise/lower the priority.

        A spool file can have any name and it's sorted first by 
        alphanumeric characters then by ascending numbers.

        New spool files are created with a name built up by a 
        concatenated string of the localtime and <= 8 random digits.
        This means that all we have to do to raise/lower
        priority is to raise/lower the values of the filename
        until it's the first file sorted in the list.

        Sendd should check if the spoolentry is still in the
        spooldb after each sent chunk, if not it should stop sending.

WHERE

        The queue information should be stored in a dbm file.
        This file should be in var/run/queue.db.

        The key in this db is the filename, and the value
        is split up by pipes ('|') and has the following syntax:

string spool|int prio|bool hold|string pointer

        If the pointer field exists this means that this file
        has moved and we should fetch the new filename instead.

HOW

        This is the list of functions we need to implement      
        queue tracking and priorities in glist.

bool gtr_introduce(string filename)

        Introduce a new file in the queue. Returns true if 
        successful and false if there is already a file with 
        this name in the queue.

string gtr_setpos(string filename, string spool)

        Move the file to a new queue.
        Returns the new queuename.

string gtr_rename(string old, string new)

        Rename a file. Should also be used by gtr_raise and gtr_lower
        as well. The old queuedb entry is not deleted, but we make a pointer
        to the new one instad.
        Returns the new filename.

string gtr_getpos(string filename);

        Get the current position of a spoolfile, should follow
        pointers as well.

string gtr_raise(string filename);

        Raise the priority of a file by renaming it so it
        will be the first in the sort algo.

string gtr_lower(string filename);

        Lower the priority of a file by renaming it so it
        will be the last in the sort algo.

bool gtr_delete(string filename);

        Delete a file in the queue.

bool gtr_stop(string filename);

        Put a file on hold. That means moving it to the hold queue,
        and setting the hold flag.

bool gtr_restart(string filename);

        Move the file out of the hold queue into it's previous queue
        and unset the hold flag.
=back

AUTHOR

        Ask Solem Hoel <ask@unixmonks.net>