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
|
#ifndef DSN_H
#define DSN_H
/*
$Id$
Copyright (C) 2004 Aaron Stone aaron at serendipity dot cx
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., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#include <dbmailtypes.h>
typedef enum {
DSN_CLASS_NONE = 0,
DSN_CLASS_OK = 2,
DSN_CLASS_TEMP = 4,
DSN_CLASS_FAIL = 5
} dsn_class_t;
typedef struct {
dsn_class_t class;
int subject;
int detail;
} delivery_status_t;
typedef struct {
u64_t useridnr; /* Specific user id recipient (from outside). */
const char *address; /* Envelope recipient (from outside). */
const char *mailbox; /* Default mailbox to use for userid deliveries (from outside). */
struct list *userids; /* List of u64_t* -- internal useridnr's to deliver to (internal). */
struct list *forwards; /* List of char* -- external addresses to forward to (internal). */
delivery_status_t dsn; /* Return status of this "delivery basket" (to outside). */
} deliver_to_user_t;
/**
* \brief Turn a numerical delivery status
* structure into a series of English explanations.
* \param dsn delivery_status_t containing status codes.
* \param class filled with a pointer to a Class explanation
* \param subject filled with a pointer to a Subject explanation
* \param detail filled with a pointer to a Detail explanation
* \return
* - 0 on success
* - -1 on failure
*/
int dsn_tostring(delivery_status_t dsn, const char ** const class,
const char ** const subject, const char ** const detail);
/**
* \brief Initialize a dsnuser structure and its lists.
* \param dsnuser Pointer to a dsnuser structure in need of initialization.
* \return
* - 0 on success
* - -1 on failure
*/
int dsnuser_init(deliver_to_user_t * dsnuser);
void dsnuser_free(deliver_to_user_t * dsnuser);
void dsnuser_free_list(struct list *deliveries);
/**
* \brief Loop through the list of delivery addresses
* and resolve them into lists of final delivery useridnr's,
* and external forwarding addresses. Each dsnuser is flagged
* with DSN codes so that successes and failures can be properly
* indicated at the top of the delivery call chain, such as in
* dbmail-smtp and dbmail-lmtpd.
* \param deliveries Pointer to a list of dsnuser structs.
* \return
* - 0 on success
* - -1 on failure
*/
int dsnuser_resolve_list(struct list *deliveries);
/**
* \brief The dsnuser structure should have either a useridnr or
* an address/alias set. It will be resolved to deliveries and
* flagged with a DSN code so that success or failure can be
* properly indicated at the top of the delivery call chain,
* such as in dbmail-smtp and dbmail-lmtpd.
* \param deliveries Pointer to a deliver_to_user_t.
* \return
* - 0 on success
* - -1 on failure
*/
int dsnuser_resolve(deliver_to_user_t *dsnuser);
/**
* \brief Loop through the list of delivery addresses
* and find out what the single worst case scenario was
* for situations where we are limited to returning a single
* status code yet might have had a whole lot of deliveries.
* \param deliveries Pointer to a list of dsnuser structs.
* \return
* - see dsn_class_t for details.
*/
dsn_class_t dsnuser_worstcase_list(struct list *deliveries);
/**
* \brief Given true/false values for each of the three
* delivery classes, find out what the single worst case scenario was
* for situations where we are limited to returning a single
* status code yet might have had a whole lot of deliveries.
* \param has_2 0 if nothing was DSN_CLASS_OK, 1 if there was.
* \param has_4 0 if nothing was DSN_CLASS_TEMP, 1 if there was.
* \param has_5 0 if nothing was DSN_CLASS_FAIL, 1 if there was.
* \return
* - see dsn_class_t for details.
*/
dsn_class_t dsnuser_worstcase_int(int has_2, int has_4, int has_5);
#endif /* DSN_H */
|
