SEND-MAIL-2(1)

NAME
send-mail-2 - ColdSync conduit to send Palm mail

SYNOPSIS
    conduit sync {
        type: mail/DATA;
        path: "<...>/send-mail-2";
                  pref: mail/3;
      arguments:
        Sendmail:       /path/to/sendmail;
        My-Address:     user@my.dom.ain;
        Outbox-name:    Outbox;
                  Sent-name: Sent;
    }

DESCRIPTION
The "send-mail-2" conduit reads the Palm Mail database, finds the outgoing messages in the specified outbox, and passes them on to the "sendmail" program for further processing.

Once each message has been successfully passed along to "sendmail", it is deleted or filed in another category.

Most of the Palm Mail send-related preferences are supported. The signature preference should just plain work. In theory, confirm read and delivery are supported. In practice, confirmations are iffy on the modern Internet.

OPTIONS

"signature"
    The signature is stored in preference "mail/3". Adding the appropriate "pref" line will cause it to be added to all outgoing mail.

"Sendmail"
    Specifies the path to the "sendmail" executable. The default is /usr/sbin/sendmail.

"My-Address"
    Specifies the return address to put on outgoing messages. If omitted, defaults to your username (or, more precisely, the username of the first user with your uid).

    If using Gable Watts' simplified mail application eMail with the sender address correctly configured in the Preferences, that address will be used instead (and My-Address left out). Other mail client apps that allow the user to specify the sender address on the Palm itself might also work correctly.

"Wrap"
    Specifies the column at which to wrap long lines. Defaults to 74. A value of 0 specifies that text should not be wrapped.

"Outbox-name"
    Specifies the category where outgoing messages are found. If omitted, the default Outbox is used. For German use Ausgang.

"Sent-name"
    Specifies the category where sent messages are filed. If omitted, sent messages are just deleted.

BUGS
This conduit will only pull messages from the specified outbox category and send them. It will not perform any other synching of the mail database. You'll want to ensure that a non-default "[generic]" sync is done for the mail/DATA database in order to sync other sections of the database.

Some sendmail implementations (Postfix) don't return a usable exit code if the message couldn't be sent due to local errors (i.e. mail subsystem not running). We can't detect this, so the conduit will assume all is well and delete the original from the Outbox. The lesson being to either use a correct sendmail or keep your mail server running. Filing sent messages under a different category will at least ensure they aren't lost before the next purge.

AUTHOR
Andrew Arensburger <arensb@ooblick.com>

sync and many other options by <christophe.beauregard@sympatico.ca>

SEE ALSO
coldsync(8)

sendmail(1)

ColdSync Conduits, in the ColdSync documentation.

POD ERRORS
Hey! The above document had some coding errors, which are explained below:

Around line 231:
    You forgot a '=back' before '=head1'