How to install protector 1.00.7 for RedHat GNU-Linux or Sun Solaris

   To  compile and install protector-1.00.7 you will need to have the GNU
   make  (gmake)  and GNU C compiler (gcc) Compiler software installed on
   your  machine.  For  RedHat  linux, these are included on the standard
   installation  CDs.  For  Solaris, you can download them free of charge
   from  www.sunfreeware.com. You must then ensure that /usr/local/bin is
   included in your PATH setting before this procedure can be used.

   To install the programs, scripts etc..
        gmake build
        gmake install

   Edit  the  /etc/sendmail.cf  file to replace the references to program
   "procmail"  with  "protector",  the  following  two changes need to be
   made..

================ first edit ===================

Mlocal,         P=/usr/bin/procmail, F=lsDFMAw5:/|@qSPfhn9, S=10/30, R=20/40,
                T=DNS/RFC822/X-Unix,
                A=procmail -Y -a $h -d $u

-- change to -->

Mlocal,         P=/usr/bin/protector, F=lsDFMAw5:/|@qSPfhn9, S=10/30, R=20/40,
                T=DNS/RFC822/X-Unix,
                A=procmail -Y -a $h -d $u


================ second edit ===============
(If your sendmail.cf file doesnt have an Mprocmail section, then ignore this..)

Mprocmail,      P=/usr/bin/procmail, F=DFMSPhnu9, S=11/31, R=21/31,
		T=DNS/RFC822/X-Unix,
                A=procmail -Y -m $h $f $u


-- change to -->

Mprocmail,      P=/usr/bin/protector, F=DFMSPhnu9, S=11/31, R=21/31,
		T=DNS/RFC822/X-Unix,
                A=procmail -Y -m $h $f $u


==================================================

   Note  that  in both the above edits - not all ocurrances of the string
   "procmail"  are changed - only where the name is supplied as part of a
   P= string.

   NB  : If your sendmail.cf is created using the "m4 sendmail.mc" logic,
   you  will  (naturally)  loose  these edits if you run "m4 sendmail.mc"
   again

   Stop and re-start sendmail. On linux you do it like this..
        cd /etc/rc.d/init.d
        sh sendmail stop
        sh sendmail start

   And that should be that.

   If  you  want  to  know  what combination of mime types protector lets
   through,  or  to  add  or  remove  some  - check out the "part_filter"
   script.

Installed files

   /usr/bin/

   protector

   This is the main wrapper script that is called by sendmail in place of
   the more traditional "procmail".

   Revive

   Synmolic link to /usr/lib/protector/bin/rejects

   /usr/lib/

   protector/

   bin/

   auto_reply

   This is work in progress. It will (one day) provide the option to send
   an  automated  reply to the sender of the message to warn him/her that
   it was rejected.

   check_excel

   Checks  an  MS excel document to verify its type, and that is contains
   no  macros.  In  the  current version; this program does not work - it
   always flags them as "bad".

   check_msword

   Checks  an  MS  word  document  to verify it's type, and check that it
   contains  no  viruses.  Designed  to  be  called  by the "part_filter"
   script.

   classify_msoffice< FONT SIZE=2>

   Given an MS office file, this program further classifies it.

   m_file

   Modified  version of the "file" command that outputs mime types rather
   than the more conventional human readable type strings.

   part_filter

   The shell script that processes a mime attachment to verify that it is
   safe to deliver to the recipient. Unsafe attachments are replaced with
   warning messages.

   protector

   The  main protector program. Passes e-mail messages, a part at a time,
   through the "part_filter" for checking.

   qpdecode

   Quoted-printable  decode  program.  Converts  a  mime  part encoded as
   quoted-printable into raw text.

   revive

   Program for reviving rejected attachments

   etc/

   mime.magic

   For use by the m_file command. Provides info to find the mime types of
   files.

   messages/

   This  directory  contains  the  message texts that are used to replace
   rejected attachments.

   bad_encoding.txt

   bad_tar_file.txt

   bad_zip_file.txt

   cant_decode.txt

   cant_read_decoded.txt

   cant_unzip.txt

   disallowed_type.txt

   excel_not_handled.txt

   general.txt

   internal_error.txt

   msword_has_macros.txt

   wrong_type.txt

   zip-file.txt

   /var/protector

   rejects

   The  directory  into  which archive copies of rejected attachments are
   placed.
