1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187
|
/*++
/* NAME
/* bounce 3
/* SUMMARY
/* bounce service client
/* SYNOPSIS
/* #include <bounce.h>
/*
/* int bounce_append(flags, id, recipient, relay, entry, format, ...)
/* int flags;
/* const char *id;
/* const char *recipient;
/* const char *relay;
/* time_t entry;
/* const char *format;
/*
/* int vbounce_append(flags, id, recipient, relay, entry, format, ap)
/* int flags;
/* const char *id;
/* const char *recipient;
/* const char *relay;
/* time_t entry;
/* const char *format;
/* va_list ap;
/*
/* int bounce_flush(flags, queue, id, sender)
/* int flags;
/* const char *queue;
/* const char *id;
/* const char *sender;
/* DESCRIPTION
/* This module implements the client interface to the message
/* bounce service, which maintains a per-message log of status
/* records with recipients that were bounced, and the reason why.
/*
/* bounce_append() appends a reason for non-delivery to the
/* bounce log for the named recipient.
/*
/* vbounce_append() implements an alternative interface.
/*
/* bounce_flush() actually bounces the specified message to
/* the specified sender, including the bounce log that was
/* built with bounce_append().
/*
/* Arguments:
/* .IP flags
/* The bitwise OR of zero or mor of the following (specify
/* BOUNCE_FLAG_NONE to request no special processing):
/* .RS
/* .IP BOUNCE_FLAG_CLEAN
/* Delete the bounce log in case of an error (as in: pretend
/* that we never even tried to bounce this message).
/* .IP BOUNCE_FLAG_COPY
/* Request that a postmaster copy is sent (bounce_flush() only).
/* .RE
/* .IP queue
/* The message queue name of the original message file.
/* .IP id
/* The message queue id if the original message file. The bounce log
/* file has the same name as the original message file.
/* .IP sender
/* The sender envelope address.
/* .IP relay
/* Name of the host that the message could not be delivered to.
/* This information is used for syslogging only.
/* .IP entry
/* Message arrival time.
/* .IP recipient
/* Recipient address that the message could not be delivered to.
/* This information is used for syslogging only.
/* .IP format
/* The reason for non-delivery.
/* .IP ap
/* Variable-length argument list.
/* DIAGNOSTICS
/* In case of success, these functions log the action, and return a
/* zero value. Otherwise, the functions return a non-zero result,
/* and when BOUNCE_FLAG_CLEAN is disabled, log that message
/* delivery is deferred.
/* BUGS
/* Should be replaced by routines with an attribute-value based
/* interface instead of an interface that uses a rigid argument list.
/* LICENSE
/* .ad
/* .fi
/* The Secure Mailer license must be distributed with this software.
/* AUTHOR(S)
/* Wietse Venema
/* IBM T.J. Watson Research
/* P.O. Box 704
/* Yorktown Heights, NY 10598, USA
/*--*/
/* System library. */
#include <sys_defs.h>
#include <stdlib.h> /* 44BSD stdarg.h uses abort() */
#include <time.h>
#include <stdarg.h>
/* Utility library. */
#include <msg.h>
#include <vstring.h>
/* Global library. */
#include "mail_params.h"
#include "mail_proto.h"
#include "defer.h"
#include "bounce.h"
/* bounce_append - append reason to per-message bounce log */
int bounce_append(int flags, const char *id, const char *recipient,
const char *relay, time_t entry, const char *fmt,...)
{
va_list ap;
int status;
va_start(ap, fmt);
status = vbounce_append(flags, id, recipient, relay, entry, fmt, ap);
va_end(ap);
return (status);
}
/* vbounce_append - append bounce reason to per-message log */
int vbounce_append(int flags, const char *id, const char *recipient,
const char *relay, time_t entry, const char *fmt, va_list ap)
{
VSTRING *why;
int status;
int delay;
/*
* When we're pretending that we can't bounce, don't create a defer log
* file when we wouldn't keep the bounce log file. That's a lot of
* negatives in one sentence.
*/
if (var_soft_bounce && (flags & BOUNCE_FLAG_CLEAN))
return (-1);
why = vstring_alloc(100);
delay = time((time_t *) 0) - entry;
vstring_vsprintf(why, fmt, ap);
if (mail_command_write(MAIL_CLASS_PRIVATE, var_soft_bounce ?
MAIL_SERVICE_DEFER : MAIL_SERVICE_BOUNCE,
"%d %d %s %s %s", BOUNCE_CMD_APPEND,
flags, id, recipient, vstring_str(why)) == 0) {
msg_info("%s: to=<%s>, relay=%s, delay=%d, status=%s (%s)",
id, recipient, relay, delay, var_soft_bounce ? "deferred" :
"bounced", vstring_str(why));
status = (var_soft_bounce ? -1 : 0);
} else if ((flags & BOUNCE_FLAG_CLEAN) == 0) {
status = defer_append(flags, id, recipient, "bounce", delay,
"bounce failed");
} else {
status = -1;
}
vstring_free(why);
return (status);
}
/* bounce_flush - flush the bounce log and deliver to the sender */
int bounce_flush(int flags, const char *queue, const char *id,
const char *sender)
{
/*
* When we're pretending that we can't bounce, don't send a bounce
* message.
*/
if (var_soft_bounce)
return (-1);
if (mail_command_write(MAIL_CLASS_PRIVATE, MAIL_SERVICE_BOUNCE,
"%d %d %s %s %s", BOUNCE_CMD_FLUSH,
flags, queue, id, sender) == 0) {
return (0);
} else if ((flags & BOUNCE_FLAG_CLEAN) == 0) {
msg_info("%s: status=deferred (bounce failed)", id);
return (-1);
} else {
return (-1);
}
}
|