AXELQ(1)

NAME
axelq - A queue manager for the popular download accelerator axel

SYNOPSIS
axelq [ -f file ] [ -e url ] [ -r ] [ -c ]

DESCRIPTION
axelq takes care of download queues for axel(1). axel(1) is a small download accelerator. Small as it is, axel(1) does not include support for queues. Queues are not really important to a download accelerator, since its main purpose is to speed up downloads. However it can be very useful to have queues. This is were axelq kicks in. axelq uses a file (the queue-file, by default ~/.axelq) to store URLs. When told, axelq will read a line and give it to axel(1), which will initiate a download. When axel(1) is done, axelq removes the download and fetches the next queue entry and feeds it to the accelerator. It continues to do so, until interrupted. When this happens, axelq detects so and will terminate as well. Note that 'interrupted' does not mean that axel(1) detected an error. If it does, axelq will be notified and will take appropriate action, according to its settings. axelq configuration is stored in two files. /etc/axelq.rc and ~/.axelqrc. These are small sh-shell scripts that axelq runs to get its settings. These settings are described in the Usage-section.

OPTIONS

-f file
    Specifies the queue-file to use. Default is ~/.axelq.

-e url
    Enqueue url. url is put at the end of the queue. If you are not sure if url is in the queue or not, just enqueue it and clean (-c) it later.

-r  Run. This will initiate the downloads in the queue-file and will continue until it either is interrupted or all the downloads are completed.

-c  Clean the queue-file. This will sort the downloads in alphabetical order and then delete the doubles. It is probably not a good idea to use this if you prioritized your queue-file.

-h, --help
    Displays the command-line options.

-v, --version
    Outputs the version number of axelq.

USAGE
The configuration files /etc/axelq.rc and ~/.axelqrc are in fact sh-shell scripts. axelq runs them to parse some settings. The order of importance is as follows (the lower settings override the higher ones):

1.  axelq defaults

2.  system-wide configuration (/etc/axelq.rc)

3.  personal configuration (~/.axelqrc)

4.  command-line parameters

In the configuration files you can use the following settings to make life easier:

qfile=queue
    Where queue is the filename of the queue-file.

failaction=action
    action can be one of the following four words: ask remove move maintain. failaction tells axelq what to do if a download fails. remove deletes the file from the queue. move will put this download to the end of the queue, causing axelq to retry when all other downloads are done. maintain will make axelq leave the download where it is. This means that axelq will retry immediately. You can make axelq ask what to do every time it encounters an error, by specifying ask. IMPORTANT NOTE I highly recommend keeping this to its default, ask. maintain will cause axelq to keep trying until it succeeds. This sucks up unnecessary bandwidth if the download is not available. This is rude towards the maintainer of the server. move will work like maintain if there is only one download in the queue. So, please do NOT specify move or maintain as your default!

command=command
    axelq will run command when it initiates a download. At installation time this is set to wherever axel was or to axel. You can add options to this, but remember to quote it.

FILES
/etc/axelq.rc
~/.axelqrc

COPYRIGHT
axelq is Copyright 2001-2002 Sjoerd Hemminga This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. axel is Copyright 2001-2002 Wilmer van der Gaast
You can download axel at <http://www.lintux.cx/axel.html>

REPORTING BUGS
Please report bugs to <sjoerd@huiswerkservice.nl>

AUTHOR
Sjoerd Hemminga <sjoerd@huiswerkservice.nl>

SEE ALSO
axel(1)