send_dada_mail.pl - Send Mailing List Messages from the command line easily

- NAME
- VERSION
- USAGE
- REQUIRED ARGUMENTS
- OPTIONS
- DIAGNOSTICS
- CONFIGURATION AND ENVIRONMENT
- DEPENDENCIES
- CAVEATS

- Dada Mail 3.x support
- SECURITY

- INCOMPATIBILITIES
- BUGS AND LIMITATIONS
- AUTHOR
- LICENCE AND COPYRIGHT

# NAME

send_dada_mail.pl - a small extension that allows you to send a mailing list message out from the command line.

# VERSION

Refer to the version of Dada Mail you're using - NEVER use a version of this proggy with an earlier or later version of Dada Mail.

Saying that, this extension is a work in progress, and probably breaks all over the place.

# USAGE

This program is supposed to be used similar to how the sendmail utility is to be used - although it's not (in no way, shape or form) a sendmail command replacement. No.

Anyways, you can use it via the command line by calling it up:

        prompt:] /home/account/cgi-bin/dada/extensions/send_dada_mail.pl --list mylist

And type out your message:

     Subject: This is my subject!

     This is my message!

     -- Justin
     ^D

The, message part of this should be a full on email message, headers and all. As the above example shows, you can just place in the headers you'd like to have and any missing fields will be filled in intelligently for you. One header I'd make sure to put in is the Subject: header.

Skip two new lines and start entering your actual message.

Like the sendmail command, it's real use is when you call it in another script. In Perl, that would look like this:

     #!/usr/bin/perl

            open( DADA, "|/home/youraccount/cgi-bin/dada/extensions/send_dada_mail.pl --list mylist") or die $!;
            print DADA "Subject: This is my subject!\n\n";
            print DADA "This is my message!\n\n";
            print DADA "-- Justin";
            close DADA or die $!;

# REQUIRED ARGUMENTS

As you'll notice from these examples, the, --list flag is being passed, and the paramater is set to a valid list short name

If this paramater is missing, or the list short name is not valid the script will exit with an `exit` status of, `1` and you won't be sending anything.

# OPTIONS

Currently, the only flag that's accepted is the --list flag.

# DIAGNOSTICS

# CONFIGURATION AND ENVIRONMENT

You probably want to set the explict paths to your Dada Mail libraries.

For example, if your Dada Mail installation is at:

     /home/account/cgi-bin/dada

    Your Dada Mail libraries would be at:

     /home/account/cgi-bin/dada

    and:

     /home/account/cgi-bin/dada/DADA/perllib

    The following lines on top of this script would be changed from:

use lib qw(

../ ../DADA ../DADA/perllib

);

to:

use lib qw(

../ ../DADA ../DADA/perllib

     /home/account/cgi-bin/dada
     /home/account/cgi-bin/dada/DADA/perllib

    );

# DEPENDENCIES

# CAVEATS

## Dada Mail 3.x support

I haven't tested this with Dada Mail 3.x yet. Does it work well?

## SECURITY

Currently, there's not much security in this script - only the check for a valid list short name. Normally, you'd have to either log into the List Control Panel to send a message out, which requires a password, or, use the Dada Bridge Plugin, which has it's own slew of checks.

Because of that, I'd only use this script where you're mighty sure that abuse will not happen (ha.). Abuse of this extension is quite possible and very easy, as you're giving the option of any program to send to any Dada Mail-administrated list as much as it would like. You see where I'm going here with this. OK? Ok.

Future versions will most likely have some semblance of security and feedback (general) about this extension is more than welcome.

# INCOMPATIBILITIES

# BUGS AND LIMITATIONS

Please, let me know if you find any bugs.

# AUTHOR

Justin Simoni

See: http://mojo.skazat.com/contact

# LICENCE AND COPYRIGHT

Copyright (c) 2007-2008 Justin Simoni All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.