Debug: feed startup "whats supported" info through normal debug channel
[exim.git] / src / src / lookups / nisplus.c
1 /*************************************************
2 *     Exim - an Internet mail transport agent    *
3 *************************************************/
4
5 /* Copyright (c) University of Cambridge 1995 - 2018 */
6 /* Copyright (c) The Exim Maintainers 2020 */
7 /* See the file NOTICE for conditions of use and distribution. */
8
9 #include "../exim.h"
10 #include "lf_functions.h"
11
12 #include <rpcsvc/nis.h>
13
14
15 /*************************************************
16 *              Open entry point                  *
17 *************************************************/
18
19 /* See local README for interface description. */
20
21 static void *
22 nisplus_open(const uschar * filename, uschar ** errmsg)
23 {
24 return (void *)(1);    /* Just return something non-null */
25 }
26
27
28
29 /*************************************************
30 *               Find entry point                 *
31 *************************************************/
32
33 /* See local README for interface description. The format of queries for a
34 NIS+ search is
35
36   [field=value,...],table-name
37 or
38   [field=value,...],table-name:result-field-name
39
40 in other words, a normal NIS+ "indexed name", with an optional result field
41 name tagged on the end after a colon. If there is no result-field name, the
42 yield is the concatenation of all the fields, preceded by their names and an
43 equals sign. */
44
45 static int
46 nisplus_find(void * handle, const uschar * filename, const uschar * query,
47   int length, uschar ** result, uschar ** errmsg, uint * do_cache,
48   const uschar * opts)
49 {
50 int error_error = FAIL;
51 const uschar * field_name = NULL;
52 nis_result *nrt = NULL;
53 nis_result *nre = NULL;
54 nis_object *tno, *eno;
55 struct entry_obj *eo;
56 struct table_obj *ta;
57 const uschar * p = query + length;
58 gstring * yield = NULL;
59
60 do_cache = do_cache;   /* Placate picky compilers */
61
62 /* Search backwards for a colon to see if a result field name
63 has been given. */
64
65 while (p > query && p[-1] != ':') p--;
66
67 if (p > query)          /* get the query without the result-field */
68   {
69   uint len = p-1 - query;
70   field_name = p;
71   query = string_copyn(query, len);
72   p = query + len;
73   }
74 else
75   p = query + length;
76
77 /* Now search backwards to find the comma that starts the
78 table name. */
79
80 while (p > query && p[-1] != ',') p--;
81 if (p <= query)
82   {
83   *errmsg = US"NIS+ query malformed";
84   error_error = DEFER;
85   goto NISPLUS_EXIT;
86   }
87
88 /* Look up the data for the table, in order to get the field names,
89 check that we got back a table, and set up pointers so the field
90 names can be scanned. */
91
92 nrt = nis_lookup(CS p, EXPAND_NAME | NO_CACHE);
93 if (nrt->status != NIS_SUCCESS)
94   {
95   *errmsg = string_sprintf("NIS+ error accessing %s table: %s", p,
96     nis_sperrno(nrt->status));
97   if (nrt->status != NIS_NOTFOUND && nrt->status != NIS_NOSUCHTABLE)
98     error_error = DEFER;
99   goto NISPLUS_EXIT;
100   }
101 tno = nrt->objects.objects_val;
102 if (tno->zo_data.zo_type != TABLE_OBJ)
103   {
104   *errmsg = string_sprintf("NIS+ error: %s is not a table", p);
105   goto NISPLUS_EXIT;
106   }
107 ta = &tno->zo_data.objdata_u.ta_data;
108
109 /* Now look up the entry in the table, check that we got precisely one
110 object and that it is a table entry. */
111
112 nre = nis_list(CS query, EXPAND_NAME, NULL, NULL);
113 if (nre->status != NIS_SUCCESS)
114   {
115   *errmsg = string_sprintf("NIS+ error accessing entry %s: %s",
116     query, nis_sperrno(nre->status));
117   goto NISPLUS_EXIT;
118   }
119 if (nre->objects.objects_len > 1)
120   {
121   *errmsg = string_sprintf("NIS+ returned more than one object for %s",
122     query);
123   goto NISPLUS_EXIT;
124   }
125 else if (nre->objects.objects_len < 1)
126   {
127   *errmsg = string_sprintf("NIS+ returned no data for %s", query);
128   goto NISPLUS_EXIT;
129   }
130 eno = nre->objects.objects_val;
131 if (eno->zo_data.zo_type != ENTRY_OBJ)
132   {
133   *errmsg = string_sprintf("NIS+ error: %s is not an entry", query);
134   goto NISPLUS_EXIT;
135   }
136
137 /* Scan the columns in the entry and in the table. If a result field
138 was given, look for that field; otherwise concatenate all the fields
139 with their names. */
140
141 eo = &(eno->zo_data.objdata_u.en_data);
142 for (int i = 0; i < eo->en_cols.en_cols_len; i++)
143   {
144   table_col *tc = ta->ta_cols.ta_cols_val + i;
145   entry_col *ec = eo->en_cols.en_cols_val + i;
146   int len = ec->ec_value.ec_value_len;
147   uschar *value = US ec->ec_value.ec_value_val;
148
149   /* The value may be NULL for a zero-length field. Turn this into an
150   empty string for consistency. Remove trailing whitespace and zero
151   bytes. */
152
153   if (!value) value = US"";
154   else
155     while (len > 0 && (value[len-1] == 0 || isspace(value[len-1])))
156       len--;
157
158   /* Concatenate all fields if no specific one selected */
159
160   if (!field_name)
161     {
162     yield = string_cat (yield, US tc->tc_name);
163     yield = string_catn(yield, US"=", 1);
164
165     /* Quote the value if it contains spaces or is empty */
166
167     if (value[0] == 0 || Ustrchr(value, ' ') != NULL)
168       {
169       yield = string_catn(yield, US"\"", 1);
170       for (int j = 0; j < len; j++)
171         {
172         if (value[j] == '\"' || value[j] == '\\')
173           yield = string_catn(yield, US"\\", 1);
174         yield = string_catn(yield, value+j, 1);
175         }
176       yield = string_catn(yield, US"\"", 1);
177       }
178     else
179       yield = string_catn(yield, value, len);
180
181     yield = string_catn(yield, US" ", 1);
182     }
183
184   /* When the specified field is found, grab its data and finish */
185
186   else if (Ustrcmp(field_name, tc->tc_name) == 0)
187     {
188     yield = string_catn(yield, value, len);
189     goto NISPLUS_EXIT;
190     }
191   }
192
193 /* Error if a field name was specified and we didn't find it; if no
194 field name, ensure the concatenated data is zero-terminated. */
195
196 if (field_name)
197   *errmsg = string_sprintf("NIS+ field %s not found for %s", field_name,
198     query);
199 else
200   gstring_release_unused(yield);
201
202 /* Free result store before finishing. */
203
204 NISPLUS_EXIT:
205 if (nrt) nis_freeresult(nrt);
206 if (nre) nis_freeresult(nre);
207
208 if (yield)
209   {
210   *result = string_from_gstring(yield);
211   return OK;
212   }
213
214 return error_error;      /* FAIL or DEFER */
215 }
216
217
218
219 /*************************************************
220 *               Quote entry point                *
221 *************************************************/
222
223 /* The only quoting that is necessary for NIS+ is to double any doublequote
224 characters. No options are recognized.
225
226 Arguments:
227   s          the string to be quoted
228   opt        additional option text or NULL if none
229
230 Returns:     the processed string or NULL for a bad option
231 */
232
233 static uschar *
234 nisplus_quote(uschar *s, uschar *opt)
235 {
236 int count = 0;
237 uschar *quoted;
238 uschar *t = s;
239
240 if (opt != NULL) return NULL;    /* No options recognized */
241
242 while (*t != 0) if (*t++ == '\"') count++;
243 if (count == 0) return s;
244
245 t = quoted = store_get(Ustrlen(s) + count + 1, is_tainted(s));
246
247 while (*s != 0)
248   {
249   *t++ = *s;
250   if (*s++ == '\"') *t++ = '\"';
251   }
252
253 *t = 0;
254 return quoted;
255 }
256
257
258 /*************************************************
259 *         Version reporting entry point          *
260 *************************************************/
261
262 /* See local README for interface description. */
263
264 #include "../version.h"
265
266 gstring *
267 nisplus_version_report(gstring * g)
268 {
269 #ifdef DYNLOOKUP
270 g = string_fmt_append(g, "Library version: NIS+: Exim version %s\n", EXIM_VERSION_STR);
271 #endif
272 return g;
273 }
274
275
276 static lookup_info _lookup_info = {
277   .name = US"nisplus",                  /* lookup name */
278   .type = lookup_querystyle,            /* query-style lookup */
279   .open = nisplus_open,                 /* open function */
280   .check = NULL,                        /* check function */
281   .find = nisplus_find,                 /* find function */
282   .close = NULL,                        /* no close function */
283   .tidy = NULL,                         /* no tidy function */
284   .quote = nisplus_quote,               /* quoting function */
285   .version_report = nisplus_version_report         /* version reporting */
286 };
287
288 #ifdef DYNLOOKUP
289 #define nisplus_lookup_module_info _lookup_module_info
290 #endif
291
292 static lookup_info *_lookup_list[] = { &_lookup_info };
293 lookup_module_info nisplus_lookup_module_info = { LOOKUP_MODULE_INFO_MAGIC, _lookup_list, 1 };
294
295 /* End of lookups/nisplus.c */