DragonFly On-Line Manual Pages

ezmlm-gate(1)          DragonFly General Commands Manual         ezmlm-gate(1)

NAME
       ezmlm-gate - Gate posts depending on message SENDER

SYNOPSIS
       ezmlm-gate [-0cCmMpPrRsSvVyY] [-q file] dir [modsubdir1] [modsubdir2
       ...]

DESCRIPTION
       ezmlm-gate checks if SENDER is in it least one of the subscriber lists
       with base directory dir/modsubdir1, dir/modsubdir2, etc.  If it is, the
       message is posted via ezmlm-send to the list in dir.  If not, the
       message is sent for moderation via ezmlm-store.  The named subscriber
       list directories must be either relative to dir or fall within dir.

       The default is to send the message for moderation.

OPTIONS
       -cCQrR Passed on to ezmlm-send(1) and ezmlm-store(1).

       -mMpPsSyY
              Passed on to ezmlm-store(1).

       -q file
              Execute arbitration programs in file.  Lines in file are
              executed just like in regular .qmail files with the difference
              that all lines are assumed to be program names. See
              dot-qmail(5).  Programs are executed by /bin/sh and the message
              is on stdin of the executed program.  The leading ``|'' is
              optional. Comments and blank lines are allowed. If a program
              exits 111, delivery is deferred. If it exits 99, the message is
              sent to the list. If it exits 0, the next line is executed. If
              it exits with any other exit code, the message is sent for
              moderation. Subscriber status per modsubdir1, modsubdir2, etc,
              is tested only if all the programs have been executed and the
              final exit code is 0. Thus, programs can cause moderation (100),
              posting (99), or defer the decision to the next program and
              ultimately to subscriber status.

       -0     Instead of running ezmlm-store(1) or ezmlm-send(1), print (to
              stdout) the command and arguments that would have been run.

       -v     Display version information.

       -V     Display version information.

USAGE
       ezmlm-gate is best used if you want to restrict posts to a set of
       addresses using SENDER checks. Obviously, this is not secure, but it
       can help quite a bit to keep garbage off the list. For more secure
       setups, see ezmlm-store(1).  For other arbitration such as SPAM
       protection, use the -q option. For instance, invoking ezmlm-reject(1)
       here would cause failing messages to be sent for moderation rather that
       being rejected.

       Set up the list with a ezmlm-gate line in dir/editor and touch
       dir/modpost.  Add the moderator(s) (usually the list owner):

       ezmlm-sub
       dir
       mod
       moderator@host

       This will via ezmlm-send directly distribute all posts from subscriber
       addresses and send out the rest for moderation to the moderator(s) via
       ezmlm-store.  To test several subscriber databases, e.g. the list and
       the list-digest subscribers, add the corresponding list directories to
       the ezmlm-gate command line.

       This can be expanded to include users that post from addresses other
       than the one they are subscribed as: just create another directory
       'addl', and a 'subscribers' subdirectory of it, and add 'addl' to the
       ezmlm-gate command line. Now just add all problem addresses to the
       'addl' address database using ezmlm-sub.  The entire point is that post
       from subscribers of any union of list go through, posts from identified
       'aliases' go through and all others go for approval to the list owner.
       Thus, legitimate users are never rejected and 'aliases' rapidly
       identified by the owner/moderator and their handling automated one by
       one, by simply adding them to 'addl'.

SEE ALSO
       dot-qmail(5), ezmlm(5), ezmlm-issubn(1), ezmlm-reject(1), ezmlmsend(1)
       , ezmlm-store(1)

                                                                 ezmlm-gate(1)