Ecole des Mines de Paris

SourceForge.net Logo

Running Joe's j-chkmail


Table of Contents

j-chkmail binaries

j-chkmail comes with three binaries : Please check these commands man pages to get more information about options and return codes.
 

j-chkmail daemon control

Main j-chkmail control tasks can be done by the j-chkmail init script which is installed by default at /etc/init.d directory.

This script has the usual behavior of scripts placed inside this directory. So it has answers to the following options :

    /etc/init.d/jchkmail start      - start j-chkmail
    /etc/init.d/jchkmail stop       - stop j-chkmail
    /etc/init.d/jchkmail restart    - stop and start j-chkmail
    /etc/init.d/jchkmail reload     - reload j-chkmail configuration files
    /etc/init.d/jchkmail dumpstats  - dump internal counters
    /etc/init.d/jchkmail clearstats - reset internal counters
restart, reload, dumpstats and clearstats are options added to help sending signals to j-chkmail daemon.

Configuring j-chkmail

You shall take a look at configuration files and modify them to meet your needs before launch j-chkmail the first time. You should read and understand what you do before activating some features as you may lost messages if your filter isn't correctly configured.

In fact, there is one real "configuration file" (j-chkmail.cf), where you'll define global filter behavior enable filtering options, and other "data files" where you'll define data needed by some options.



j-chkmail and signals

j-chkmail answers to signals HUP, USR1 and USR2. Note that signals shall be sent to the father process. It's his job to decide if a signal shall be sent to a child or if it's best to communicate to his children by other means. /etc/init.d/jchkmail script has options to send signals to the daemon.

Monitoring j-chkmail activity

j-chkmail load (units / hour) refused messages (units / hour)


Command line options

You can also get a summary of command line options if you launch j-chkmail j-printstats or j-scanfile with the -h option (or you can check man pages) :
martins@calloway:~> /usr/sbin/j-chkmail -h
Usage : j-chkmail options
  Joe's j-chkmail v1.3
  Compiled at Sep 30 2002 12:15:42
        -p  : socket
              inet:2000@localhost
              local:/var/sock
        -i  : 2000  (AF_INET)
        -u  : /var/sock (AF_UNIX)
        -d  : inet domain
        -h  : help
        -c  : configuration file
        -l  : log level
        -v  : version / runtime configuration
        -vv : version / compile time configuration
        -t tablename, where tablename choosen between : 
                host_access | user_access | users | networks | classw | regex 

Joe's j-chkmail v1.3 - Copyright Ecole des Mines de Paris - (C) 2002


martins@calloway:~> 
martins@calloway:~ /usr/bin/j-printstats -h
Usage : j-printstats options
    j-printstats -a | -p | -g
        -p  : print running process j-chkmail counters
        -g  : print j-chkmail counters from last reset
        -a  : print both counters
    j-printstats -t[td]
        -t  : throttle data (summary)
        -tt : throttle data (detail)
        -d  : resolve IP addresses
    j-printstats -r[rdc]
        -r  : dns resolve data (summary)
        -rr : dns resolve data (detail)
        -d  : resolve IP addresses
        -c  : data presented in cumulative mode (default : histogram)

Joe's j-chkmail v1.3 - Copyright Ecole des Mines de Paris - (C) 2002
  Compiled at Sep 30 2002 12:15:41

martins@calloway:~>
martins@calloway:~> /usr/bin/j-scanfile -h
Usage : j-scanfile [-h] [-c] [-v] file file file...
  Joe's j-chkmail v1.3
  Compiled at Sep 30 2002 12:15:39
        -h : help
        -c : configuration file
        -v : verbose

Joe's j-chkmail v1.3 - Copyright Ecole des Mines de Paris - (C) 2002

martins@calloway:~>


Jose Marcio Martins da Cruz
j-chkmail - © Ecole des Mines de Paris - Centre de Calcul
Last modified Fri Oct 04 11:05:59 MEST 2002