DSMAIL(1)

NAME
dsmail - discuss mail feed program

SYNOPSIS
dsmail [ -dAD ] [ -a regexp ] [ -r regexp ] [ -s subject-match-limit ] meeting-path-name

DESCRIPTION
Dsmail is used to feed incoming mail into the discuss conferencing system. It takes a mail message from standard input, formats it, and inserts it into the proper discuss meeting. The user running dsmail must have ``write'' permission for that meeting. Typically this will be daemon, since sendmail runs as daemon. To enter replies, the user must have ``answer`` permission for that meeting.

To setup a mail feed for a meeting, do the following: Give the user daemon ``answer'', ``status'', and ``write''access using the discuss command set_acl. Then, insert a pipe to dsmail into the sendmail aliases file /usr/lib/aliases. For example:
tytso@charon.LOCAL:"/site/sipb/bin/dsmail -d /usr/spool/discuss/mailtest"@charon.LOCAL
Then, any mail sent to tytso@charon.LOCAL will be entered in the meeting mailtest.

If desired, dsmail will process the mail headers, and remove the unnecessary cruft. If no options are specified, all of the mail headers are stripped. By using the options detailed below, you can have fine control over which headers should be retained:

-x  will cause dsmail to NOT retain the ``default'' fields. These are the to, from, cc, and date fields, the Message-Id field, the MIME-related fields, and any other fields ending in ``-to'' (except for fields beginning with ``d'', such as Delivered-To) or ``-from''.

-A  causes ALL fields to be retained. This can be modified by the -r option.

-a regexp
    causes any fields matching the specified regular expression to be accepted.

-r regexp
    causes any fields matching the specified regular expression to be rejected.

-s subject-match-limit
    specifies that subject matching should be used to chain transactions. If this option is specified, the last subject-match-limit number of transactions are searched backwards to find a matching subject. If found, the transaction is chained to the given transaction. Daemon should have either ``read'' or ``owner'' access to the meeting for this to work.

-D  turns on the debugging mode. In this mode, the mail message is not entered into the discuss meeting. Instead, it is sent to standard output so that the formatting of the mail messages can be checked easily. This option should only be used interactively.

NOTE
Early versions of dsmail treated the -A , -d and -D options as toggles. (That is, specifying an option twice would essentially be a no-op.) This was deemed to be confusing and this feature was removed in 2013. You may still specify options as many times as you like, but they will have the same effect as if the option was specified once.

IN-REPLY-TO
dsmail parses the ``In-reply-to'' field in the mail header for transaction numbers of the form ``[nnnn] in meeting name''. If one is found where the given meeting name matches the short or long name of the meeting, the transaction chained to that transaction number. If a meeting name is not given, or the user does not have access to find out the long name of the meeting, the transaction is automatically chained to that transaction number.

SEE ALSO
discuss(1), aliases(5)

BUGS
Probably lots.