1 /******************************************************************************/
2 /* pfixtools: a collection of postfix related tools */
4 /* ________________________________________________________________________ */
6 /* Redistribution and use in source and binary forms, with or without */
7 /* modification, are permitted provided that the following conditions */
10 /* 1. Redistributions of source code must retain the above copyright */
11 /* notice, this list of conditions and the following disclaimer. */
12 /* 2. Redistributions in binary form must reproduce the above copyright */
13 /* notice, this list of conditions and the following disclaimer in the */
14 /* documentation and/or other materials provided with the distribution. */
15 /* 3. The names of its contributors may not be used to endorse or promote */
16 /* products derived from this software without specific prior written */
19 /* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND */
20 /* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE */
21 /* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR */
22 /* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS */
23 /* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR */
24 /* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF */
25 /* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS */
26 /* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN */
27 /* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) */
28 /* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF */
29 /* THE POSSIBILITY OF SUCH DAMAGE. */
30 /******************************************************************************/
33 * Copyright © 2007 Pierre Habouzit
34 * Copyright © 2008 Florent Bruneau
37 #ifndef PFIXTOOLS_QUERY_H
38 #define PFIXTOOLS_QUERY_H
42 #include "policy_tokens.h"
47 SMTP_HELO = SMTP_EHLO,
58 /* \see http://www.postfix.org/SMTPD_POLICY_README.html */
59 typedef struct query_t {
63 const char *helo_name;
66 const char *recipient;
67 const char *recipient_count;
68 const char *client_address;
69 const char *client_name;
70 const char *reverse_client_name;
73 /* useful data extracted from previous ones */
74 const char *sender_domain;
75 const char *recipient_domain;
78 const char *sasl_method;
79 const char *sasl_username;
80 const char *sasl_sender;
82 const char *ccert_subject;
83 const char *ccert_issuer;
84 const char *ccert_fingerprint;
87 const char *encryption_protocol;
88 const char *encryption_cipher;
89 const char *encryption_keysize;
90 const char *etrn_domain;
98 /** Parse the content of the text to fill the query.
99 * The text pointed by \p p is segmented (and modified to add
100 * a \0 at the end of each segment) and used to fill the query
103 __attribute__((nonnull(1,2)))
104 bool query_parse(query_t *query, char *p);
106 /** Return the value of the field with the given name.
108 __attribute__((nonnull(1,2)))
109 const char *query_field_for_name(const query_t *query, const char *name);
111 /** Returns the value of the field with the given id.
113 __attribute__((nonnull))
114 const char *query_field_for_id(const query_t *query, postlicyd_token id);
116 /** Formats the given string by replacing ${field_name} with the content
118 * Unknown and empty fields are filled with (null).
120 __attribute__((nonnull(3)))
121 ssize_t query_format(char *dest, size_t len, const char* fmt, const query_t *query);