Centaur 0.1

The immediate email notification tool.
Centaur is a small program intended to Immediately notify an user when its mail arrives. To do so IMAP IDLE command is used. Thus, if you have no IMAP account, or your IMAP server does not support IDLE, you're out of luck.


To install centaur, put the python files in some place. Usually, I keep them
in $HOME/.centaur (surprise).


Centaurd uses a configuration file 'config' which is checked under
/etc/centaur, and $HOME/.centaur. Note, this file contains passwords, so its
permissions should be as tight as possible. I think executing

# chmod 600 config

is a mandatory thing.

Keywords used in the configuration file:

hostname - string, hostname of the IMAP server. This string may contain
           the server port, eg 'imap.server.com:8888'
username - string, username used to login to the server
password - string, password used to login to the server
timeout  - integer, timeout in seconds when DONE should be issued. If you
           don't know what this means, don't modify it. The default timeout
           should suit most people.
fetchcmd - string, shell command which will be executed on mail arrival, eg
           'fetchmail -s'.
logger   - string, type of logger. Allowed values are syslog and stdout.
userid   - integer, valid user ID. Used to drop privileges when centaurd
           is started as root.
groupid  - integer, valid group ID. Used to drop privileges when centaurd
           is started as root.
process  - string, how to start centaurd. Allowed values are 'daemon' and
           'foreground'. The latter is default.


To start centaurd just type its name (with full path, if that matters) and
press Enter:

# $HOME/.centaur/centaurd

To stop it, kill the process using TERM or KILL signal:

# kill -TERM `cat /var/run/centaurd.pid`

If you started centaurd not as root, the pid file may be missing. Find
the process among other processes and kill it:

# ps ax | grep centaurd
 2711 ?        S      0:00 /usr/bin/python /home/user/.centaur/centaurd
 8458 pts/7    S+     0:00 grep centaurd
# kill -TERM 2711

Also, you can make centaurd to re-read its configuration by sending HUP signal to it:

# kill -HUP `cat /var/run/centaurd.pid`

last updated on:
September 10th, 2008, 13:50 GMT
license type:
GPL (GNU General Public License) 
developed by:
Vladimir Popov
ROOT \ Communications \ Email
Download Button

In a hurry? Add it to your Download Basket!

user rating



Rate it!

Add your review!