Artistic The Artistic Licence
ChangeLog Where changes are recorded
Changes User-visible changes between 2.9 and 3.0
Configure Portability tool
Credits Traditional "thank you" list
FAQ An exerpt from the "Filtering Mail FAQ" posting
Jmakefile Description of the main Makefile
MANIFEST This list of files
Makefile.SH A makefile to run subsidiary makefiles
README Basic instructions
agent/ Where mailagent support files are located
agent/Jmakefile High level description of Makefile
agent/Makefile.SH Makefile which builds and installs mailagent
agent/README Welcome to mailagent
agent/edusers.SH Edits users file with proper locking procedure
agent/examples/ A set of files from my own environment
agent/examples/Jmakefile High level description for Makefile
agent/examples/Makefile.SH Makefile for examples
agent/examples/README Explains what the examples are
agent/examples/daemon Rules for "vacation" emulation
agent/examples/mailfolders A copy of my ~/.mailfolders
agent/examples/mchk Checks for new mail
agent/examples/mhinc Call the MH inc command to incorporate new mail
agent/examples/nocmds Message you currently get if you send me a command
agent/examples/profile What I added to my onw ~/.profile
agent/examples/rules The rules I am currently using
agent/examples/vacation A sample vacation message
agent/files/ Mailagent's configuration files
agent/files/Jmakefile High level description for Makefile
agent/files/Makefile.SH Makefile for subsidiary files
agent/files/README Notes about files found in this directory
agent/files/agenthelp Help file used by mailhelp
agent/files/chkagent.sh Cron script to spot problems in the mailagent system
agent/files/commands Allowed commands for mailagent
agent/files/compressors Default sample compressors available
agent/files/distribs Example of distribution list
agent/files/filter.sh Shell script version of the mail filter
agent/files/help/ Directory holding SERVER help files
agent/files/help/Jmakefile Generic makefile for help directory
agent/files/help/Makefile.SH Generated makefile
agent/files/help/README States what this directory is about
agent/files/help/addauth.SH Help file for addauth
agent/files/help/approve.SH Help file for approve
agent/files/help/delpower.SH Help file for delpower
agent/files/help/end.SH Help file for end
agent/files/help/getauth.SH Help file for getauth
agent/files/help/help.SH Help file for help
agent/files/help/newpower.SH Help file for newpower
agent/files/help/passwd.SH Help file for passwd
agent/files/help/password.SH Help file for password
agent/files/help/power.SH Help file for power
agent/files/help/release.SH Help file for release
agent/files/help/remauth.SH Help file for remauth
agent/files/help/set.SH Help file for set
agent/files/help/setauth.SH Help file for setauth
agent/files/help/user.SH Help file for user
agent/files/mailagent.cf Example of configuration file
agent/files/passwd An example for power password file
agent/files/proglist Example of description file
agent/files/server An example for server command file
agent/files/setup.cf Standard configuration setup definition
agent/filter/ The C version of the mail filter
agent/filter/Jmakefile Generic makefile template
agent/filter/Makefile.SH Makefile for C filter
agent/filter/README Introduction to filter
agent/filter/dup2.c Emulation of the dup2() system call
agent/filter/environ.c Environment management routines
agent/filter/environ.h Declarations for environment management routines
agent/filter/getopt.c Replacement for libc's getopt()
agent/filter/hash.c Symbol table handling
agent/filter/hash.h Declarations for symbol table
agent/filter/io.c I/O routines
agent/filter/io.h Header for I/O routines
agent/filter/lock.c File locking
agent/filter/lock.h Declarations for file locking routines
agent/filter/logfile.c Logging facilities
agent/filter/logfile.h Header for logging routines
agent/filter/main.c The main entry point for filter
agent/filter/misc.c Miscellaneous routines
agent/filter/msg.c Handles fatal messages
agent/filter/msg.h Declarations for user messages
agent/filter/parser.c Parse the config file with variable substitutions
agent/filter/parser.h About config file parsing
agent/filter/portable.h Portable declarations
agent/filter/sysexits.h Standard exit codes
agent/filter/user.c To get login name from user
agent/magent.sh The main processor
agent/maildist.SH Mails a whole distribution
agent/mailhelp.SH Mails some help
agent/maillist.SH Mails a list of available distributions
agent/mailpatch.SH Mails patches for a given distribution
agent/man/ Manual pages for mailagent
agent/man/Jmakefile Makefile description for jmake
agent/man/Makefile.SH Makefile for manual pages extraction
agent/man/edusers.SH Produces a manual page for edusers
agent/man/mailagent.SH Produces a manual page for mailagent
agent/man/maildist.SH Produces a manual page for maildist
agent/man/mailhelp.SH Produces a manual page for mailhelp
agent/man/maillist.SH Produces a manual page for maillist
agent/man/mailpatch.SH Produces a manual page for mailpatch
agent/man/package.SH Produces a manual page for package
agent/package.SH Records users of a PD package (cf dist-3.0)
agent/pl/ Perl files used by mailagent scripts
agent/pl/Jmakefile Generic Makefile for perl library
agent/pl/Makefile.SH Jmake-generated makefile
agent/pl/acs_rqst.pl Perl library to ask for private file access
agent/pl/actions.pl Implementation of mailagent's actions
agent/pl/add_log.pl Perl library to add logs to logfile
agent/pl/addr.pl Approximate address matching and validation
agent/pl/analyze.pl Perl library analyzing the incoming mail
agent/pl/biff.pl Built-in biffing support
agent/pl/builtins.pl Perl library dealing with builtins
agent/pl/callout.pl Perl library to handle callout queue
agent/pl/cdir.pl Perl library to derive path changes ala cd
agent/pl/checklock.pl Perl library to check for long lasting locks
agent/pl/cmdserv.pl Implements generic mail server
agent/pl/compress.pl Folder compression library
agent/pl/context.pl Mailagent context file handling
agent/pl/dbr.pl Internal database management
agent/pl/distribs.pl Perl library to scan the distribs file
agent/pl/dynload.pl Dynamically loads perl code into mailagent
agent/pl/emergency.pl Perl library dealing with emergencies
agent/pl/eval.pl A little expression interpreter
agent/pl/extern.pl Perl library to handle persistent variables
agent/pl/fatal.pl Perl library to deal with fatal errors
agent/pl/file_edit.pl File edition with extensive error checking
agent/pl/filter.pl Running the filtering commands
agent/pl/forward.pl Automatic Command forwarding support routines
agent/pl/free_file.pl Perl library to free file access
agent/pl/gensym.pl Dynamic symbol generator
agent/pl/getdate.pl Richard Ohnemus's getdate package
agent/pl/header.pl Header-related routines
agent/pl/history.pl Perl library to implement history mechanism
agent/pl/hook.pl Mail hook wrapping functions
agent/pl/hostname.pl Perl library to compute hostname
agent/pl/include.pl Processing of "include file" requests
agent/pl/install.pl Dealing with initial ~/.mailagent setup
agent/pl/interface.pl Perl interface with filter commands
agent/pl/jobnum.pl Perl library to compute a job number
agent/pl/lexical.pl Perl library for lexical analysis
agent/pl/listqueue.pl Perl library to list the queue
agent/pl/locate.pl Perl library to locate loaded patterns/addresses
agent/pl/macros.pl Perl library for macros expansion
agent/pl/mailhook.pl Initializing and running hooks
agent/pl/makedir.pl Perl library for making a directory
agent/pl/matching.pl Matching routines used by filter
agent/pl/mbox.pl Getting mails from a mailbox file
agent/pl/mh.pl Handles MH-style folder delivery
agent/pl/mmdf.pl MMDF-style mailbox handling
agent/pl/newcmd.pl Filter command extension driver
agent/pl/once.pl Dealing with once commands
agent/pl/options.pl Generic option processing for filter actions
agent/pl/package.pl Sources dist's .package file into pkg package
agent/pl/parse.pl Perl library to parse a mail message
agent/pl/period.pl Perl library to compute periods
agent/pl/plsave.pl Perl library to handle the plsave cache file
agent/pl/plural.pl Perl library to pluralize words
agent/pl/power.pl Power management for mail server
agent/pl/pqueue.pl Processing the queued mails
agent/pl/q.pl Quote removal function
agent/pl/queue_mail.pl Queuing mails
agent/pl/rangeargs.pl Perl library to expand a list of patches
agent/pl/read_conf.pl Perl library to read configuration file
agent/pl/rfc822.pl Perl library to parse RFC822 addresses
agent/pl/rulenv.pl Handles rule environment with local settings
agent/pl/rules.pl Compiles the filtering rules
agent/pl/runcmd.pl Filter commands ran from here
agent/pl/secure.pl Make sure a file is "secure" and can be trusted
agent/pl/sendfile.pl Perl library to send files in shar / kit mode
agent/pl/signals.pl Installs emergency signal handlers
agent/pl/stats.pl Mailagent's statistics recording and printing
agent/pl/tilde.pl Perl library to perform ~name expansion
agent/pl/unpack.pl Perl library to unpack archive files
agent/pl/usrmac.pl User-defined macros
agent/pl/utmp/Jmakefile Generic Makefile for utmp.pl
agent/pl/utmp/Makefile.SH Produces Makefile for umtp.pl
agent/pl/utmp/utmp_ph.c Generates a perl view of struct utmp
agent/pl/utmp/utmp_pl.sh Produces utmp.pl, to handle utmp file
agent/test/ Regression test suite
agent/test/Jmakefile Generic makefile for test suite
agent/test/Makefile.SH Makefile for test suite
agent/test/README About the regression tests
agent/test/TEST Runs the full test suite
agent/test/actions Rule file for cmd tests
agent/test/atail Active monitoring of the out/agentlog file
agent/test/basic/ Basic tests
agent/test/basic/config.t Main test initialization and sanity checks
agent/test/basic/filter.t Make sure C filter works
agent/test/basic/mailagent.t Make sure mailagent basically works
agent/test/cmd/ Tests of mailagent's filtering commands
agent/test/cmd/abort.t Test ABORT command
agent/test/cmd/after.t Test AFTER command
agent/test/cmd/annotate.t Test ANNOTATE command
agent/test/cmd/apply.t Test APPLY command
agent/test/cmd/assign.t Test ASSIGN command
agent/test/cmd/back.t Test BACK command
agent/test/cmd/beep.t Test BEEP command
agent/test/cmd/begin.t Test BEGIN command
agent/test/cmd/biff.t Test BIFF command
agent/test/cmd/bounce.t Test BOUNCE command
agent/test/cmd/delete.t Test DELETE command
agent/test/cmd/do.t Test DO command
agent/test/cmd/feed.t Test FEED command
agent/test/cmd/forward.t Test FORWARD command
agent/test/cmd/give.t Test GIVE command
agent/test/cmd/keep.t Test KEEP command
agent/test/cmd/leave.t Test LEAVE command
agent/test/cmd/macro.t Test MACRO command
agent/test/cmd/message.t Test MESSAGE command
agent/test/cmd/nop.t Test NOP command
agent/test/cmd/notify.t Test NOTIFY command
agent/test/cmd/on.t Test ON command
agent/test/cmd/once.t Test ONCE command
agent/test/cmd/pass.t Test PASS command
agent/test/cmd/perl.t Test PERL command
agent/test/cmd/pipe.t Test PIPE command
agent/test/cmd/post.t Test POST command
agent/test/cmd/process.t Test PROCESS command
agent/test/cmd/protect.t Test PROTECT command
agent/test/cmd/purify.t Test PURIFY command
agent/test/cmd/queue.t Test QUEUE command
agent/test/cmd/record.t Test RECORD command
agent/test/cmd/reject.t Test REJECT command
agent/test/cmd/require.t Test REQUIRE command
agent/test/cmd/restart.t Test RESTART command
agent/test/cmd/resync.t Test RESYNC command
agent/test/cmd/run.t Test RUN command
agent/test/cmd/save.t Test SAVE command
agent/test/cmd/select.t Test SELECT command
agent/test/cmd/server.t Test SERVER command
agent/test/cmd/split.t Test SPLIT command
agent/test/cmd/store.t Test STORE command
agent/test/cmd/strip.t Test STRIP command
agent/test/cmd/subst.t Test SUBST command
agent/test/cmd/tr.t Test TR command
agent/test/cmd/umask.t Test UMASK command
agent/test/cmd/unique.t Test UNIQUE command
agent/test/cmd/unknown.t Make sure unknown command defaults correctly
agent/test/cmd/vacation.t Test VACATION command
agent/test/cmd/write.t Test WRITE command
agent/test/filter/ Testing the filtering capabilities
agent/test/filter/backref.t Check backreferences
agent/test/filter/case.t Normalized header case tests
agent/test/filter/default.t Check default behaviour when mail not saved
agent/test/filter/escape.t Escape sequences within actions
agent/test/filter/group.t Selector combination tests
agent/test/filter/hook.t Ensure hooks are correctly invoked
agent/test/filter/list.t Check matching on lists like To and Newsgroups
agent/test/filter/loop.t Check loop detection
agent/test/filter/macros.t Check optional macro subsitution in patterns
agent/test/filter/mode.t Make sure mode selection logic works
agent/test/filter/multiple.t Check multiple selectors
agent/test/filter/not.t Negated pattern tests
agent/test/filter/pattern.t Check patterns specification and loading
agent/test/filter/range.t Selector range tests
agent/test/filter/status.t Action status updating tests
agent/test/level Default logging level for tests
agent/test/mail The mail used by testing routines
agent/test/misc/ Directory for miscellaneous tests
agent/test/misc/compress.t Folder compression checks
agent/test/misc/mh.t MH-style folder checks
agent/test/misc/mmdf.t MMDF-style mailbox checks
agent/test/misc/newcmd.t Filter command extension tests
agent/test/misc/usrmac.t User-defined macros checks
agent/test/option/ Tests the options to the mailagent program
agent/test/option/F.t Test -F option
agent/test/option/I.t Test -I option
agent/test/option/L.t Test -L option
agent/test/option/V.t Test -V option
agent/test/option/c.t Test -c option
agent/test/option/d.t Test -d option
agent/test/option/e.t Test -e option
agent/test/option/f.t Test -f option
agent/test/option/h.t Test -h option
agent/test/option/i.t Test -i option
agent/test/option/l.t Test -l option
agent/test/option/o.t Test -o option
agent/test/option/q.t Test -q option
agent/test/option/r.t Test -r option
agent/test/option/s.t Test -s option
agent/test/option/t.t Test -t option
agent/test/option/what.t Ensure good behaviour with unknown option
agent/test/pl/ Perl libraries for the regression test suite
agent/test/pl/cmd.pl Initializes command paths
agent/test/pl/filter.pl Set up environment for filter tests
agent/test/pl/init.pl Variable initializations
agent/test/pl/logfile.pl Logging file checking
agent/test/pl/mail.pl Modifies mail components
agent/test/pl/misc.pl Set up for miscellaneous tests
agent/test/pl/mta.pl Trivial MTA and NTA for tests
agent/test/rules Rules used by filtering tests
bin/ Directory for uninstalled binaries
bin/perload The dataloading/autoloading perl translator
config_h.SH Produces config.h
confmagic.h Magic symbol remapping
install.SH Installation script
misc/ Miscellaneous server commands
misc/README Introduction to the misc directory
misc/fakesend/README Presentation of the FAKESEND command
misc/fakesend/fakesend.pl Implementation of user-defined FAKESEND command
misc/fakesend/freplcomps Sample MH reply components for FAKESEND usage
misc/fakesend/mh_profile Relevant MH profile sample for frepl and freplq
misc/getcost/README Presentation of the spam-filter getcost
misc/getcost/getcost The getcost script
misc/getcost/rules Sample rules to plug getcost in
misc/getcost/spamconfig A sample ~/.spamconfig file
misc/mime/README Introduction to the un-MIME filter
misc/mime/rules Rules that can be used to trigger unmime
misc/mime/unmime The unmime script for MIME message processing
misc/news/README Some notes about the news <=> mail gateway
misc/news/ml.map Example of news -> mail mappings
misc/news/newsgate The news -> mail gateway
misc/news/rules Mailagent rules for the mail -> news gateway
misc/pbounce/README Some notes about the PATBOUNCE command
misc/pbounce/mailagent.cf Template for inclusion into your ~/.mailagent
misc/pbounce/newcmd.cf Configuration for PATBOUNCE plug-in
misc/pbounce/patbounce.pl Implementation of user-defined PATBOUNCE command
misc/pbounce/rules Sample rules shwowing how PATBOUNCE can be used
misc/shell/ Command to run arbitrary shell commands
misc/shell/README Warning, should be read carefully
misc/shell/server.cf Configuration of this server command
misc/shell/shell The shell command itself
misc/unkit/ Command to automatically unkit messages
misc/unkit/README Some notes about the UNKIT command
misc/unkit/kitok.msg An example of message to be sent when kit received
misc/unkit/mailagent.cf Template for inclusion into your ~/.mailagent
misc/unkit/newcmd.cf Configuration of the new command
misc/unkit/rules Rules to be added to handle kit messages
misc/unkit/unkit.pl Implementation of the user-defined UNKIT command
patchlevel.h Current version number and patch level