NAME

       exiwhat - Finding out what Exim processes are doing

SYNOPSIS

       exiwhat

DESCRIPTION

       On  operating systems that can restart a system call after receiving a signal (most modern
       OS), an Exim process responds to the SIGUSR1 signal by writing a line describing  what  it
       is  doing  to  the file exim-process.info in the Exim spool directory.  The exiwhat script
       sends the signal to all Exim processes it can find, having first  emptied  the  file.   It
       then  waits  for  one  second  to  allow the Exim processes to react before displaying the
       results.  In order to run exiwhat successfully you have to have  sufficient  privilege  to
       send the signal to the Exim processes, so it is normally run as root.

       Unfortunately,  the  ps  command  which  exiwhat  uses  to  find  Exim processes varies in
       different operating systems.  Not only are different options used, but the format  of  the
       output  is  different.   For this reason, there are some system configuration options that
       configure exactly how exiwhat works.  If it doesn't seem to be working for you, check  the
       following compile-time options:

       EXIWHAT_PS_CMD
              the command for running “ps”

       EXIWHAT_PS_ARG
              the argument for “ps”

       EXIWHAT_EGREP_ARG
              the argument for “egrep” to select from “ps” output

       EXIWHAT_KILL_ARG
              the argument for the “kill” command

       An example of typical output from exiwhat is

         164 daemon: -q1h, listening on port 25
       10483 running queue: waiting for 0tAycK-0002ij-00 (10492)
       10492 delivering 0tAycK-0002ij-00 to mail.ref.example [10.19.42.42]
         (editor@ref.example)
       10592 handling incoming call from [192.168.243.242]
       10628 accepting a local non-SMTP message

       The  first number in the output line is the process number.  The third line has been split
       here, in order to fit it on the page.

BUGS

       This manual page needs a major re-work. If somebody knows better groff  than  us  and  has
       more experience in writing manual pages, any patches would be greatly appreciated.

SEE ALSO

       exim(8), /usr/share/doc/exim4-base/

AUTHOR

       This  manual  page  was  stitched  together  from spec.txt by Andreas Metzler <ametzler at
       downhill.at.eu.org>, for the Debian GNU/Linux system (but may be used by others).

                                          March 26, 2003                               EXIWHAT(8)