2 * Copyright (c) 1998-2001, 2003, 2006, 2007 Proofpoint, Inc. and its suppliers.
4 * Copyright (c) 1983, 1995-1997 Eric P. Allman. All rights reserved.
5 * Copyright (c) 1988, 1993
6 * The Regents of the University of California. All rights reserved.
8 * By using this file, you agree to the terms and conditions set
9 * forth in the LICENSE file which can be found at the top level of
10 * the sendmail distribution.
16 SM_RCSID("@(#)$Id: macro.c,v 8.108 2013-11-22 20:51:55 ca Exp $")
18 #include <sm/sendmail.h>
19 #if MAXMACROID != (BITMAPBITS - 1)
20 ERROR Read the comment in conf.h
23 static char *MacroName[MAXMACROID + 1]; /* macro id to name table */
26 ** Codes for long named macros.
27 ** See also macname():
28 * if not ASCII printable, look up the name *
29 if (n <= 0x20 || n > 0x7f)
30 ** First use 1 to NEXTMACROID_L, then use NEXTMACROID_H to MAXMACROID.
33 #define NEXTMACROID_L 037
34 #define NEXTMACROID_H 0240
37 /* table for next id in non-printable ASCII range: disallow some value */
38 static int NextMIdTable[] =
75 #define NEXTMACROID(mid) ( \
76 (mid < NEXTMACROID_L) ? (NextMIdTable[mid]) : \
77 ((mid < NEXTMACROID_H) ? NEXTMACROID_H : (mid + 1)))
79 int NextMacroId = 1; /* codes for long named macros */
80 /* see sendmail.h: Special characters in rewriting rules. */
81 #else /* _FFR_MORE_MACROS */
82 int NextMacroId = 0240; /* codes for long named macros */
83 #define NEXTMACROID(mid) ((mid) + 1)
84 #endif /* _FFR_MORE_MACROS */
88 ** INITMACROS -- initialize the macro system
90 ** This just involves defining some macros that are actually
91 ** used internally as metasymbols to be themselves.
100 ** initializes several macros to be themselves.
103 struct metamac MetaMacros[] =
105 /* LHS pattern matching characters */
106 { '*', MATCHZANY }, { '+', MATCHANY }, { '-', MATCHONE },
107 { '=', MATCHCLASS }, { '~', MATCHNCLASS },
109 /* these are RHS metasymbols */
110 { '#', CANONNET }, { '@', CANONHOST }, { ':', CANONUSER },
113 /* the conditional operations */
114 { '?', CONDIF }, { '|', CONDELSE }, { '.', CONDFI },
116 /* the hostname lookup characters */
117 { '[', HOSTBEGIN }, { ']', HOSTEND },
118 { '(', LOOKUPBEGIN }, { ')', LOOKUPEND },
120 /* miscellaneous control characters */
121 { '&', MACRODEXPAND },
126 #define MACBINDING(name, mid) \
127 stab(name, ST_MACRO, ST_ENTER)->s_macro = mid; \
128 MacroName[mid] = name;
138 for (m = MetaMacros; m->metaname != '\0'; m++)
142 macdefine(&e->e_macro, A_TEMP, m->metaname, buf);
146 for (c = '0'; c <= '9'; c++)
149 macdefine(&e->e_macro, A_TEMP, c, buf);
152 /* set defaults for some macros sendmail will use later */
153 macdefine(&e->e_macro, A_PERM, 'n', "MAILER-DAEMON");
155 /* set up external names for some internal macros */
156 MACBINDING("opMode", MID_OPMODE);
157 /*XXX should probably add equivalents for all short macros here XXX*/
161 ** EXPAND/DOEXPAND -- macro expand a string using $x escapes.
163 ** After expansion, the expansion will be in external form (that is,
164 ** there will be no sendmail metacharacters and METAQUOTEs will have
165 ** been stripped out).
168 ** s -- the string to expand.
169 ** buf -- the place to put the expansion.
170 ** bufsize -- the size of the buffer.
171 ** explevel -- the depth of expansion (doexpand only)
172 ** e -- envelope in which to work.
181 static void doexpand __P(( char *, char *, size_t, int, ENVELOPE *));
184 doexpand(s, buf, bufsize, explevel, e)
193 bool skipping; /* set if conditionally skipping output */
194 bool recurse; /* set if recursion required */
196 int skiplev; /* skipping nesting level */
197 int iflev; /* if nesting level */
198 bool quotenext; /* quote the following character */
199 char xbuf[MACBUFSIZE];
203 sm_dprintf("expand(");
204 xputs(sm_debug_file(), s);
215 for (xp = xbuf; *s != '\0'; s++)
220 ** Check for non-ordinary (special?) character.
221 ** 'q' will be the interpolated quantity.
230 goto simpleinterpolate;
235 case CONDIF: /* see if var set */
245 skipping = (mv == NULL || *mv == '\0');
249 case CONDELSE: /* change state of skipping */
251 break; /* XXX: error */
253 skipping = !skipping;
256 case CONDFI: /* stop skipping */
258 break; /* XXX: error */
266 case MACROEXPAND: /* macro interpolation */
280 /* next octet completely quoted */
286 ** Interpolate q or output one character
290 if (skipping || xp >= &xbuf[sizeof(xbuf) - 1])
296 /* copy to end of q or max space remaining in buf */
297 bool hiderecurse = false;
299 while ((c = *q++) != '\0' &&
300 xp < &xbuf[sizeof(xbuf) - 1])
302 /* check for any sendmail metacharacters */
303 if (!hiderecurse && (c & 0340) == 0200)
307 /* give quoted characters a free ride */
308 hiderecurse = (c & 0377) == METAQUOTE;
316 sm_dprintf("expand(%d) ==> ", explevel);
317 xputs(sm_debug_file(), xbuf);
321 /* recurse as appropriate */
324 if (explevel < MaxMacroRecursion)
326 doexpand(xbuf, buf, bufsize, explevel + 1, e);
329 syserr("expand: recursion too deep (%d max)",
333 /* copy results out */
335 (void) sm_strlcpy(buf, xbuf, bufsize);
338 /* leave in internal form */
342 memmove(buf, xbuf, i);
348 sm_dprintf("expand ==> ");
349 xputs(sm_debug_file(), buf);
355 expand(s, buf, bufsize, e)
361 doexpand(s, buf, bufsize, 0, e);
365 ** MACTABCLEAR -- clear entire macro table
368 ** mac -- Macro table.
374 ** clears entire mac structure including rpool pointer!
383 if (mac->mac_rpool == NULL)
385 for (i = 0; i < MAXMACROID; i++)
386 SM_FREE(mac->mac_table[i]);
388 memset((char *) mac, '\0', sizeof(*mac));
392 ** MACDEFINE -- bind a macro name to a value
394 ** Set a macro to a value, with fancy storage management.
395 ** macdefine will make a copy of the value, if required,
396 ** and will ensure that the storage for the previous value
400 ** mac -- Macro table.
401 ** vclass -- storage class of 'value', ignored if value==NULL.
402 ** A_HEAP means that the value was allocated by
403 ** malloc, and that macdefine owns the storage.
404 ** A_TEMP means that value points to temporary storage,
405 ** and thus macdefine needs to make a copy.
406 ** A_PERM means that value points to storage that
407 ** will remain allocated and unchanged for
408 ** at least the lifetime of mac. Use A_PERM if:
410 ** -- value points to a string literal,
411 ** -- value was allocated from mac->mac_rpool
412 ** or (in the case of an envelope macro)
414 ** -- in the case of an envelope macro,
415 ** value is a string member of the envelope
416 ** such as e->e_sender.
417 ** id -- Macro id. This is a single character macro name
418 ** such as 'g', or a value returned by macid().
419 ** value -- Macro value: either NULL, or a string.
424 macdefine_tagged(mac, vclass, id, value, file, line, grp)
425 #else /* SM_HEAP_CHECK */
426 macdefine(mac, vclass, id, value)
427 #endif /* SM_HEAP_CHECK */
436 #endif /* SM_HEAP_CHECK */
440 if (id < 0 || id > MAXMACROID)
445 sm_dprintf("%sdefine(%s as ",
446 mac->mac_table[id] == NULL ? "" : "re", macname(id));
447 xputs(sm_debug_file(), value);
451 if (mac->mac_rpool == NULL)
455 if (mac->mac_table[id] != NULL &&
456 bitnset(id, mac->mac_allocated))
457 freeit = mac->mac_table[id];
459 if (value == NULL || vclass == A_HEAP)
461 sm_heap_checkptr_tagged(value, file, line);
463 clrbitn(id, mac->mac_allocated);
468 newvalue = sm_strdup_tagged_x(value, file, line, 0);
470 newvalue = sm_strdup_x(value);
472 setbitn(id, mac->mac_allocated);
474 mac->mac_table[id] = newvalue;
480 if (value == NULL || vclass == A_PERM)
483 newvalue = sm_rpool_strdup_x(mac->mac_rpool, value);
484 mac->mac_table[id] = newvalue;
485 if (vclass == A_HEAP)
489 #if _FFR_RESET_MACRO_GLOBALS
493 PSTRSET(MyHostName, value);
496 #endif /* _FFR_RESET_MACRO_GLOBALS */
500 ** MACSET -- set a named macro to a value (low level)
502 ** No fancy storage management; the caller takes full responsibility.
503 ** Often used with macget; see also macdefine.
506 ** mac -- Macro table.
507 ** i -- Macro name, specified as an integer offset.
508 ** value -- Macro value: either NULL, or a string.
512 macset(mac, i, value)
517 if (i < 0 || i > MAXMACROID)
522 sm_dprintf("macset(%s as ", macname(i));
523 xputs(sm_debug_file(), value);
526 mac->mac_table[i] = value;
530 ** MACVALUE -- return uninterpreted value of a macro.
532 ** Does fancy path searching.
533 ** The low level counterpart is macget.
536 ** n -- the name of the macro.
537 ** e -- envelope in which to start looking for the macro.
552 if (e != NULL && e->e_mci != NULL)
554 char *p = e->e_mci->mci_macro.mac_table[n];
561 char *p = e->e_macro.mac_table[n];
565 if (e == e->e_parent)
569 #if _FFR_BLANKENV_MACV
570 if (LOOKUP_MACRO_IN_BLANKENV && e != &BlankEnvelope)
572 char *p = BlankEnvelope.e_macro.mac_table[n];
578 return GlobalMacros.mac_table[n];
582 ** MACNAME -- return the name of a macro given its internal id
585 ** n -- the id of the macro
603 n = (int)(unsigned char)n;
605 return "***OUT OF RANGE MACRO***";
607 /* if not ASCII printable, look up the name */
608 if (n <= 0x20 || n > 0x7f)
610 char *p = MacroName[n];
614 return "***UNDEFINED MACRO***";
617 /* if in the ASCII graphic range, just return the id directly */
624 ** MACID_PARSE -- return id of macro identified by its name
627 ** p -- pointer to name string -- either a single
628 ** character or {name}.
629 ** ep -- filled in with the pointer to the byte
633 ** 0 -- An error was detected.
634 ** 1..MAXMACROID -- The internal id code for this macro.
637 ** If this is a new macro name, a new id is allocated.
638 ** On error, syserr is called.
648 char mbuf[MAXMACNAMELEN + 1];
652 sm_dprintf("macid(");
653 xputs(sm_debug_file(), p);
657 if (*p == '\0' || (p[0] == '{' && p[1] == '}'))
659 syserr("Name required for macro/class");
663 sm_dprintf("NULL\n");
668 /* the macro is its own code */
677 xputs(sm_debug_file(), buf);
683 while (*++p != '\0' && *p != '}' && bp < &mbuf[sizeof(mbuf) - 1])
685 if (isascii(*p) && (isalnum(*p) || *p == '_'))
688 syserr("Invalid macro/class character %c", *p);
694 syserr("Unbalanced { on %s", mbuf); /* missing } */
698 syserr("Macro/class name ({%s}) too long (%d chars max)",
699 mbuf, (int) (sizeof(mbuf) - 1));
701 else if (mbuf[1] == '\0' && mbuf[0] >= 0x20)
704 mid = bitidx(mbuf[0]);
711 s = stab(mbuf, ST_MACRO, ST_ENTER);
716 if (NextMacroId > MAXMACROID)
718 syserr("Macro/class {%s}: too many long names",
724 MacroName[NextMacroId] = s->s_name;
725 s->s_macro = mid = NextMacroId;
726 NextMacroId = NEXTMACROID(NextMacroId);
733 if (mid < 0 || mid > MAXMACROID)
735 syserr("Unable to assign macro/class ID (mid = 0x%x)", mid);
737 sm_dprintf("NULL\n");
741 sm_dprintf("0x%x\n", mid);
746 ** WORDINCLASS -- tell if a word is in a specific class
749 ** str -- the name of the word to look up.
750 ** cl -- the class name.
753 ** true if str can be found in cl.
764 s = stab(str, ST_CLASS, ST_FIND);
765 return s != NULL && bitnset(bitidx(cl), s->s_class);