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)