1 /* ====================================================================
2 * Copyright (c) 1995-1999 The Apache Group. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in
13 * the documentation and/or other materials provided with the
16 * 3. All advertising materials mentioning features or use of this
17 * software must display the following acknowledgment:
18 * "This product includes software developed by the Apache Group
19 * for use in the Apache HTTP server project (http://www.apache.org/)."
21 * 4. The names "Apache Server" and "Apache Group" must not be used to
22 * endorse or promote products derived from this software without
23 * prior written permission. For written permission, please contact
26 * 5. Products derived from this software may not be called "Apache"
27 * nor may "Apache" appear in their names without prior written
28 * permission of the Apache Group.
30 * 6. Redistributions of any form whatsoever must retain the following
32 * "This product includes software developed by the Apache Group
33 * for use in the Apache HTTP server project (http://www.apache.org/)."
35 * THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS IS'' AND ANY
36 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
37 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
38 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE GROUP OR
39 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
41 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
42 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
44 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
45 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
46 * OF THE POSSIBILITY OF SUCH DAMAGE.
47 * ====================================================================
49 * This software consists of voluntary contributions made by many
50 * individuals on behalf of the Apache Group and was originally based
51 * on public domain software written at the National Center for
52 * Supercomputing Applications, University of Illinois, Urbana-Champaign.
53 * For more information on the Apache Group and the Apache HTTP server
54 * project, please see <http://www.apache.org/>.
59 * util.c: string utility things
62 * 1995-96 Many changes by the Apache Group
67 * #define DEBUG to trace all cfg_open*()/cfg_closefile() calls
68 * #define DEBUG_CFG_LINES to trace every line read from the config files
72 #include "http_main.h"
74 #include "http_protocol.h"
76 /* stdio.h has been read in ap_config.h already. Add missing prototypes here: */
77 extern int fgetc(FILE *);
78 extern char *fgets(char *s, int, FILE*);
79 extern int fclose(FILE *);
82 /* A bunch of functions in util.c scan strings looking for certain characters.
83 * To make that more efficient we encode a lookup table. The test_char_table
84 * is generated automatically by gen_test_char.c.
86 #include "test_char.h"
88 /* we assume the folks using this ensure 0 <= c < 256... which means
89 * you need a cast to (unsigned char) first, you can't just plug a
90 * char in here and get it to work, because if char is signed then it
91 * will first be sign extended.
93 #define TEST_CHAR(c, f) (test_char_table[(unsigned)(c)] & (f))
95 API_VAR_EXPORT const char ap_month_snames[12][4] =
97 "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
99 API_VAR_EXPORT const char ap_day_snames[7][4] =
101 "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"
104 API_EXPORT(char *) ap_get_time()
110 time_string = ctime(&t);
111 time_string[strlen(time_string) - 1] = '\0';
112 return (time_string);
116 * Examine a field value (such as a media-/content-type) string and return
117 * it sans any parameters; e.g., strip off any ';charset=foo' and the like.
119 API_EXPORT(char *) ap_field_noparam(ap_context_t *p, const char *intype)
123 semi = strchr(intype, ';');
125 return ap_pstrdup(p, intype);
128 while ((semi > intype) && ap_isspace(semi[-1])) {
131 return ap_pstrndup(p, intype, semi - intype);
135 API_EXPORT(char *) ap_ht_time(ap_context_t *p, time_t t, const char *fmt, int gmt)
137 char ts[MAX_STRING_LEN];
138 char tf[MAX_STRING_LEN];
141 tms = (gmt ? gmtime(&t) : localtime(&t));
143 /* Convert %Z to "GMT" and %z to "+0000";
144 * on hosts that do not have a time zone string in struct tm,
145 * strftime must assume its argument is local time.
149 for(strp = tf, f = fmt; strp < tf + sizeof(tf) - 6 && (*strp = *f)
151 if (*f != '%') continue;
162 case 'z': /* common extension */
176 /* check return code? */
177 strftime(ts, MAX_STRING_LEN, fmt, tms);
178 ts[MAX_STRING_LEN - 1] = '\0';
179 return ap_pstrdup(p, ts);
182 API_EXPORT(char *) ap_gm_timestr_822(ap_context_t *p, time_t sec)
185 char *date_str = ap_palloc(p, 48 * sizeof(char));
186 char *date_str_ptr = date_str;
191 /* Assumption: this is always 3 */
192 /* i = strlen(ap_day_snames[tms->tm_wday]); */
193 memcpy(date_str_ptr, ap_day_snames[tms->tm_wday], 3);
195 *date_str_ptr++ = ',';
196 *date_str_ptr++ = ' ';
197 *date_str_ptr++ = tms->tm_mday / 10 + '0';
198 *date_str_ptr++ = tms->tm_mday % 10 + '0';
199 *date_str_ptr++ = ' ';
200 /* Assumption: this is also always 3 */
201 /* i = strlen(ap_month_snames[tms->tm_mon]); */
202 memcpy(date_str_ptr, ap_month_snames[tms->tm_mon], 3);
204 *date_str_ptr++ = ' ';
205 real_year = 1900 + tms->tm_year;
206 /* This routine isn't y10k ready. */
207 *date_str_ptr++ = real_year / 1000 + '0';
208 *date_str_ptr++ = real_year % 1000 / 100 + '0';
209 *date_str_ptr++ = real_year % 100 / 10 + '0';
210 *date_str_ptr++ = real_year % 10 + '0';
211 *date_str_ptr++ = ' ';
212 *date_str_ptr++ = tms->tm_hour / 10 + '0';
213 *date_str_ptr++ = tms->tm_hour % 10 + '0';
214 *date_str_ptr++ = ':';
215 *date_str_ptr++ = tms->tm_min / 10 + '0';
216 *date_str_ptr++ = tms->tm_min % 10 + '0';
217 *date_str_ptr++ = ':';
218 *date_str_ptr++ = tms->tm_sec / 10 + '0';
219 *date_str_ptr++ = tms->tm_sec % 10 + '0';
220 *date_str_ptr++ = ' ';
221 *date_str_ptr++ = 'G';
222 *date_str_ptr++ = 'M';
223 *date_str_ptr++ = 'T';
224 *date_str_ptr = '\0';
227 /* RFC date format; as strftime '%a, %d %b %Y %T GMT' */
229 /* The equivalent using sprintf. Use this for more legible but slower code
230 return ap_psprintf(p,
231 "%s, %.2d %s %d %.2d:%.2d:%.2d GMT", ap_day_snames[tms->tm_wday],
232 tms->tm_mday, ap_month_snames[tms->tm_mon], tms->tm_year + 1900,
233 tms->tm_hour, tms->tm_min, tms->tm_sec);
237 /* What a pain in the ass. */
238 #if defined(HAVE_GMTOFF)
239 API_EXPORT(struct tm *) ap_get_gmtoff(int *tz)
241 time_t tt = time(NULL);
245 *tz = (int) (t->tm_gmtoff / 60);
249 API_EXPORT(struct tm *) ap_get_gmtoff(int *tz)
251 time_t tt = time(NULL);
254 int days, hours, minutes;
256 /* Assume we are never more than 24 hours away. */
257 gmt = *gmtime(&tt); /* remember gmtime/localtime return ptr to static */
258 t = localtime(&tt); /* buffer... so be careful */
259 days = t->tm_yday - gmt.tm_yday;
260 hours = ((days < -1 ? 24 : 1 < days ? -24 : days * 24)
261 + t->tm_hour - gmt.tm_hour);
262 minutes = hours * 60 + t->tm_min - gmt.tm_min;
268 /* Roy owes Rob beer. */
269 /* Rob owes Roy dinner. */
271 /* These legacy comments would make a lot more sense if Roy hadn't
272 * replaced the old later_than() routine with util_date.c.
274 * Well, okay, they still wouldn't make any sense.
277 /* Match = 0, NoMatch = 1, Abort = -1
278 * Based loosely on sections of wildmat.c by Rich Salz
279 * Hmmm... shouldn't this really go component by component?
281 API_EXPORT(int) ap_strcmp_match(const char *str, const char *exp)
285 for (x = 0, y = 0; exp[y]; ++y, ++x) {
286 if ((!str[x]) && (exp[y] != '*'))
289 while (exp[++y] == '*');
294 if ((ret = ap_strcmp_match(&str[x++], &exp[y])) != 1)
299 else if ((exp[y] != '?') && (str[x] != exp[y]))
302 return (str[x] != '\0');
305 API_EXPORT(int) ap_strcasecmp_match(const char *str, const char *exp)
309 for (x = 0, y = 0; exp[y]; ++y, ++x) {
310 if ((!str[x]) && (exp[y] != '*'))
313 while (exp[++y] == '*');
318 if ((ret = ap_strcasecmp_match(&str[x++], &exp[y])) != 1)
323 else if ((exp[y] != '?') && (ap_tolower(str[x]) != ap_tolower(exp[y])))
326 return (str[x] != '\0');
329 API_EXPORT(int) ap_is_matchexp(const char *str)
333 for (x = 0; str[x]; x++)
334 if ((str[x] == '*') || (str[x] == '?'))
340 * Here's a pool-based interface to POSIX regex's regcomp().
341 * Note that we return regex_t instead of being passed one.
342 * The reason is that if you use an already-used regex_t structure,
343 * the memory that you've already allocated gets forgotten, and
344 * regfree() doesn't clear it. So we don't allow it.
347 static ap_status_t regex_cleanup(void *preg)
349 regfree((regex_t *) preg);
353 API_EXPORT(regex_t *) ap_pregcomp(ap_context_t *p, const char *pattern,
356 regex_t *preg = ap_palloc(p, sizeof(regex_t));
358 if (regcomp(preg, pattern, cflags)) {
362 ap_register_cleanup(p, (void *) preg, regex_cleanup, regex_cleanup);
367 API_EXPORT(void) ap_pregfree(ap_context_t *p, regex_t * reg)
371 ap_kill_cleanup(p, (void *) reg, regex_cleanup);
376 * Apache stub function for the regex libraries regexec() to make sure the
377 * whole regex(3) API is available through the Apache (exported) namespace.
378 * This is especially important for the DSO situations of modules.
379 * DO NOT MAKE A MACRO OUT OF THIS FUNCTION!
381 API_EXPORT(int) ap_regexec(const regex_t *preg, const char *string,
382 size_t nmatch, regmatch_t pmatch[], int eflags)
384 return regexec(preg, string, nmatch, pmatch, eflags);
387 API_EXPORT(size_t) ap_regerror(int errcode, const regex_t *preg, char *errbuf, size_t errbuf_size)
389 return regerror(errcode, preg, errbuf, errbuf_size);
393 /* This function substitutes for $0-$9, filling in regular expression
394 * submatches. Pass it the same nmatch and pmatch arguments that you
395 * passed ap_regexec(). pmatch should not be greater than the maximum number
396 * of subexpressions - i.e. one more than the re_nsub member of regex_t.
398 * input should be the string with the $-expressions, source should be the
399 * string that was matched against.
401 * It returns the substituted string, or NULL on error.
403 * Parts of this code are based on Henry Spencer's regsub(), from his
404 * AT&T V8 regexp package.
407 API_EXPORT(char *) ap_pregsub(ap_context_t *p, const char *input, const char *source,
408 size_t nmatch, regmatch_t pmatch[])
410 const char *src = input;
419 return ap_pstrdup(p, src);
421 /* First pass, find the size */
425 while ((c = *src++) != '\0') {
428 else if (c == '$' && ap_isdigit(*src))
433 if (no > 9) { /* Ordinary character. */
434 if (c == '\\' && (*src == '$' || *src == '&'))
438 else if (no < nmatch && pmatch[no].rm_so < pmatch[no].rm_eo) {
439 len += pmatch[no].rm_eo - pmatch[no].rm_so;
444 dest = dst = ap_pcalloc(p, len + 1);
446 /* Now actually fill in the string */
450 while ((c = *src++) != '\0') {
453 else if (c == '$' && ap_isdigit(*src))
458 if (no > 9) { /* Ordinary character. */
459 if (c == '\\' && (*src == '$' || *src == '&'))
463 else if (no < nmatch && pmatch[no].rm_so < pmatch[no].rm_eo) {
464 len = pmatch[no].rm_eo - pmatch[no].rm_so;
465 memcpy(dst, source + pmatch[no].rm_so, len);
476 * Parse .. so we don't compromise security
478 API_EXPORT(void) ap_getparents(char *name)
482 /* Four paseses, as per RFC 1808 */
483 /* a) remove ./ path segments */
485 for (l = 0, w = 0; name[l] != '\0';) {
486 if (name[l] == '.' && name[l + 1] == '/' && (l == 0 || name[l - 1] == '/'))
489 name[w++] = name[l++];
492 /* b) remove trailing . path, segment */
493 if (w == 1 && name[0] == '.')
495 else if (w > 1 && name[w - 1] == '.' && name[w - 2] == '/')
499 /* c) remove all xx/../ segments. (including leading ../ and /../) */
502 while (name[l] != '\0') {
503 if (name[l] == '.' && name[l + 1] == '.' && name[l + 2] == '/' &&
504 (l == 0 || name[l - 1] == '/')) {
505 register int m = l + 3, n;
509 while (l >= 0 && name[l] != '/')
516 while ((name[n] = name[m]))
523 /* d) remove trailing xx/.. segment. */
524 if (l == 2 && name[0] == '.' && name[1] == '.')
526 else if (l > 2 && name[l - 1] == '.' && name[l - 2] == '.' && name[l - 3] == '/') {
529 while (l >= 0 && name[l] != '/')
539 API_EXPORT(void) ap_no2slash(char *name)
546 /* Check for UNC names. Leave leading two slashes. */
547 if (s[0] == '/' && s[1] == '/')
552 if ((*d++ = *s) == '/') {
566 * copy at most n leading directories of s into d
567 * d should be at least as large as s plus 1 extra byte
569 * the return value is the ever useful pointer to the trailing \0 of d
577 API_EXPORT(char *) ap_make_dirstr_prefix(char *d, const char *s, int n)
580 if (*s == '\0' || (*s == '/' && (--n) == 0)) {
592 * return the parent directory name including trailing / of the file s
594 API_EXPORT(char *) ap_make_dirstr_parent(ap_context_t *p, const char *s)
596 char *last_slash = strrchr(s, '/');
600 if (last_slash == NULL) {
601 /* XXX: well this is really broken if this happens */
602 return (ap_pstrdup(p, "/"));
604 l = (last_slash - s) + 1;
605 d = ap_palloc(p, l + 1);
613 * This function is deprecated. Use one of the preceeding two functions
616 API_EXPORT(char *) ap_make_dirstr(ap_context_t *p, const char *s, int n)
621 for (x = 0, f = 0; s[x]; x++) {
624 res = ap_palloc(p, x + 2);
632 if (s[strlen(s) - 1] == '/')
633 return ap_pstrdup(p, s);
635 return ap_pstrcat(p, s, "/", NULL);
638 API_EXPORT(int) ap_count_dirs(const char *path)
642 for (x = 0, n = 0; path[x]; x++)
649 API_EXPORT(void) ap_chdir_file(const char *file)
652 char buf[HUGE_STRING_LEN];
654 x = strrchr(file, '/');
658 else if (x - file < sizeof(buf) - 1) {
659 memcpy(buf, file, x - file);
660 buf[x - file] = '\0';
663 /* XXX: well, this is a silly function, no method of reporting an
664 * error... ah well. */
667 API_EXPORT(char *) ap_getword_nc(ap_context_t *atrans, char **line, char stop)
669 return ap_getword(atrans, (const char **) line, stop);
672 API_EXPORT(char *) ap_getword(ap_context_t *atrans, const char **line, char stop)
674 char *pos = strchr(*line, stop);
678 res = ap_pstrdup(atrans, *line);
679 *line += strlen(*line);
683 res = ap_pstrndup(atrans, *line, pos - *line);
685 while (*pos == stop) {
694 API_EXPORT(char *) ap_getword_white_nc(ap_context_t *atrans, char **line)
696 return ap_getword_white(atrans, (const char **) line);
699 API_EXPORT(char *) ap_getword_white(ap_context_t *atrans, const char **line)
704 for (x = 0; (*line)[x]; x++) {
705 if (ap_isspace((*line)[x])) {
712 res = ap_pstrdup(atrans, *line);
713 *line += strlen(*line);
717 res = ap_palloc(atrans, pos + 1);
718 ap_cpystrn(res, *line, pos + 1);
720 while (ap_isspace((*line)[pos]))
728 API_EXPORT(char *) ap_getword_nulls_nc(ap_context_t *atrans, char **line, char stop)
730 return ap_getword_nulls(atrans, (const char **) line, stop);
733 API_EXPORT(char *) ap_getword_nulls(ap_context_t *atrans, const char **line, char stop)
735 char *pos = strchr(*line, stop);
739 res = ap_pstrdup(atrans, *line);
740 *line += strlen(*line);
744 res = ap_pstrndup(atrans, *line, pos - *line);
753 /* Get a word, (new) config-file style --- quoted strings and backslashes
757 static char *substring_conf(ap_context_t *p, const char *start, int len, char quote)
759 char *result = ap_palloc(p, len + 2);
763 for (i = 0; i < len; ++i) {
764 if (start[i] == '\\' && (start[i + 1] == '\\'
765 || (quote && start[i + 1] == quote)))
766 *resp++ = start[++i];
775 API_EXPORT(char *) ap_getword_conf_nc(ap_context_t *p, char **line)
777 return ap_getword_conf(p, (const char **) line);
780 API_EXPORT(char *) ap_getword_conf(ap_context_t *p, const char **line)
782 const char *str = *line, *strend;
786 while (*str && ap_isspace(*str))
794 if ((quote = *str) == '"' || quote == '\'') {
796 while (*strend && *strend != quote) {
797 if (*strend == '\\' && strend[1] && strend[1] == quote)
802 res = substring_conf(p, str + 1, strend - str - 1, quote);
804 if (*strend == quote)
809 while (*strend && !ap_isspace(*strend))
812 res = substring_conf(p, str, strend - str, 0);
815 while (*strend && ap_isspace(*strend))
821 API_EXPORT(int) ap_cfg_closefile(configfile_t *cfp)
824 ap_log_error(APLOG_MARK, APLOG_DEBUG|APLOG_NOERRNO, NULL,
825 "Done with config file %s", cfp->name);
827 return (cfp->close == NULL) ? 0 : cfp->close(cfp->param);
830 static ap_status_t cfg_close(void *param)
832 ap_file_t *cfp = (ap_file_t *) param;
833 return (ap_close(cfp));
836 static int cfg_getch(void *param)
839 ap_file_t *cfp = (ap_file_t *) param;
840 if (ap_getc(&ch, cfp) == APR_SUCCESS)
845 static void *cfg_getstr(void *buf, size_t bufsiz, void *param)
847 ap_file_t *cfp = (ap_file_t *) param;
848 if (ap_fgets(buf, bufsiz, cfp) == APR_SUCCESS)
853 /* Open a configfile_t as FILE, return open configfile_t struct pointer */
854 API_EXPORT(ap_status_t) ap_pcfg_openfile(configfile_t **ret_cfg, ap_context_t *p, const char *name)
856 configfile_t *new_cfg;
862 ap_log_error(APLOG_MARK, APLOG_ERR | APLOG_NOERRNO, 0, NULL,
863 "Internal error: pcfg_openfile() called with NULL filename");
867 if (!ap_os_is_filename_valid(name)) {
868 ap_log_error(APLOG_MARK, APLOG_ERR | APLOG_NOERRNO, 0, NULL,
869 "Access to config file %s denied: not a valid filename",
874 stat = ap_open(&file, name, APR_READ | APR_BUFFERED, APR_OS_DEFAULT, p);
876 ap_log_error(APLOG_MARK, APLOG_DEBUG | APLOG_NOERRNO, NULL,
877 "Opening config file %s (%s)",
878 name, (stat != APR_SUCCESS) ? strerror(errno) : "successful");
880 if (stat != APR_SUCCESS)
883 stat = ap_get_filetype(&type, file);
884 if (stat != APR_SUCCESS)
887 if (type != APR_REG &&
888 #if defined(WIN32) || defined(OS2)
889 !(strcasecmp(name, "nul") == 0 ||
890 (strlen(name) >= 4 &&
891 strcasecmp(name + strlen(name) - 4, "/nul") == 0))) {
893 strcmp(name, "/dev/null") != 0) {
894 #endif /* WIN32 || OS2 */
895 ap_log_error(APLOG_MARK, APLOG_ERR | APLOG_NOERRNO, 0, NULL,
896 "Access to file %s denied by server: not a regular file",
902 new_cfg = ap_palloc(p, sizeof(*new_cfg));
903 new_cfg->param = file;
904 new_cfg->name = ap_pstrdup(p, name);
905 new_cfg->getch = (int (*)(void *)) cfg_getch;
906 new_cfg->getstr = (void *(*)(void *, size_t, void *)) cfg_getstr;
907 new_cfg->close = (int (*)(void *)) cfg_close;
908 new_cfg->line_number = 0;
914 /* Allocate a configfile_t handle with user defined functions and params */
915 API_EXPORT(configfile_t *) ap_pcfg_open_custom(ap_context_t *p, const char *descr,
917 int(*getch)(void *param),
918 void *(*getstr) (void *buf, size_t bufsiz, void *param),
919 int(*close_func)(void *param))
921 configfile_t *new_cfg = ap_palloc(p, sizeof(*new_cfg));
923 ap_log_error(APLOG_MARK, APLOG_DEBUG | APLOG_NOERRNO, NULL, "Opening config handler %s", descr);
925 new_cfg->param = param;
926 new_cfg->name = descr;
927 new_cfg->getch = getch;
928 new_cfg->getstr = getstr;
929 new_cfg->close = close_func;
930 new_cfg->line_number = 0;
935 /* Read one character from a configfile_t */
936 API_EXPORT(int) ap_cfg_getc(configfile_t *cfp)
938 register int ch = cfp->getch(cfp->param);
945 /* Read one line from open configfile_t, strip LF, increase line number */
946 /* If custom handler does not define a getstr() function, read char by char */
947 API_EXPORT(int) ap_cfg_getline(char *buf, size_t bufsize, configfile_t *cfp)
949 /* If a "get string" function is defined, use it */
950 if (cfp->getstr != NULL) {
954 size_t cbufsize = bufsize;
958 if (cfp->getstr(cbuf, cbufsize, cfp->param) == NULL)
962 * check for line continuation,
963 * i.e. match [^\\]\\[\r]\n only
966 while (cp < cbuf+cbufsize && *cp != '\0')
968 if (cp > cbuf && cp[-1] == LF) {
970 if (cp > cbuf && cp[-1] == CR)
972 if (cp > cbuf && cp[-1] == '\\') {
974 if (!(cp > cbuf && cp[-1] == '\\')) {
976 * line continuation requested -
977 * then remove backslash and continue
979 cbufsize -= (cp-cbuf);
985 * no real continuation because escaped -
986 * then just remove escape character
988 for ( ; cp < cbuf+cbufsize && *cp != '\0'; cp++)
997 * Leading and trailing white space is eliminated completely
1000 while (ap_isspace(*src))
1002 /* blast trailing whitespace */
1003 dst = &src[strlen(src)];
1004 while (--dst >= src && ap_isspace(*dst))
1006 /* Zap leading whitespace by shifting */
1008 for (dst = buf; (*dst++ = *src++) != '\0'; )
1011 #ifdef DEBUG_CFG_LINES
1012 ap_log_error(APLOG_MARK, APLOG_DEBUG|APLOG_NOERRNO, NULL, "Read config: %s", buf);
1016 /* No "get string" function defined; read character by character */
1018 register size_t i = 0;
1021 /* skip leading whitespace */
1023 c = cfp->getch(cfp->param);
1024 } while (c == '\t' || c == ' ');
1030 /* too small, assume caller is crazy */
1035 if ((c == '\t') || (c == ' ')) {
1037 while ((c == '\t') || (c == ' '))
1038 c = cfp->getch(cfp->param);
1041 /* silently ignore CR (_assume_ that a LF follows) */
1042 c = cfp->getch(cfp->param);
1045 /* increase line number and return on LF */
1048 if (c == EOF || c == 0x4 || c == LF || i >= (bufsize - 2)) {
1050 * check for line continuation
1052 if (i > 0 && buf[i-1] == '\\') {
1054 if (!(i > 0 && buf[i-1] == '\\')) {
1055 /* line is continued */
1056 c = cfp->getch(cfp->param);
1059 /* else nothing needs be done because
1060 * then the backslash is escaped and
1061 * we just strip to a single one
1064 /* blast trailing whitespace */
1065 while (i > 0 && ap_isspace(buf[i - 1]))
1068 #ifdef DEBUG_CFG_LINES
1069 ap_log_error(APLOG_MARK, APLOG_DEBUG|APLOG_NOERRNO, NULL, "Read config: %s", buf);
1075 c = cfp->getch(cfp->param);
1080 /* Size an HTTP header field list item, as separated by a comma.
1081 * The return value is a pointer to the beginning of the non-empty list item
1082 * within the original string (or NULL if there is none) and the address
1083 * of field is shifted to the next non-comma, non-whitespace character.
1084 * len is the length of the item excluding any beginning whitespace.
1086 API_EXPORT(const char *) ap_size_list_item(const char **field, int *len)
1088 const unsigned char *ptr = (const unsigned char *)*field;
1089 const unsigned char *token;
1090 int in_qpair, in_qstr, in_com;
1092 /* Find first non-comma, non-whitespace byte */
1094 while (*ptr == ',' || ap_isspace(*ptr))
1099 /* Find the end of this item, skipping over dead bits */
1101 for (in_qpair = in_qstr = in_com = 0;
1102 *ptr && (in_qpair || in_qstr || in_com || *ptr != ',');
1110 case '\\': in_qpair = 1; /* quoted-pair */
1112 case '"' : if (!in_com) /* quoted string delim */
1115 case '(' : if (!in_qstr) /* comment (may nest) */
1118 case ')' : if (in_com) /* end comment */
1126 if ((*len = (ptr - token)) == 0) {
1127 *field = (const char *)ptr;
1131 /* Advance field pointer to the next non-comma, non-white byte */
1133 while (*ptr == ',' || ap_isspace(*ptr))
1136 *field = (const char *)ptr;
1137 return (const char *)token;
1140 /* Retrieve an HTTP header field list item, as separated by a comma,
1141 * while stripping insignificant whitespace and lowercasing anything not in
1142 * a quoted string or comment. The return value is a new string containing
1143 * the converted list item (or NULL if none) and the address pointed to by
1144 * field is shifted to the next non-comma, non-whitespace.
1146 API_EXPORT(char *) ap_get_list_item(ap_context_t *p, const char **field)
1148 const char *tok_start;
1149 const unsigned char *ptr;
1152 int addspace = 0, in_qpair = 0, in_qstr = 0, in_com = 0, tok_len = 0;
1154 /* Find the beginning and maximum length of the list item so that
1155 * we can allocate a buffer for the new string and reset the field.
1157 if ((tok_start = ap_size_list_item(field, &tok_len)) == NULL) {
1160 token = ap_palloc(p, tok_len + 1);
1162 /* Scan the token again, but this time copy only the good bytes.
1163 * We skip extra whitespace and any whitespace around a '=', '/',
1164 * or ';' and lowercase normal characters not within a comment,
1165 * quoted-string or quoted-pair.
1167 for (ptr = (const unsigned char *)tok_start, pos = (unsigned char *)token;
1168 *ptr && (in_qpair || in_qstr || in_com || *ptr != ',');
1177 case '\\': in_qpair = 1;
1183 case '"' : if (!in_com)
1190 case '(' : if (!in_qstr)
1197 case ')' : if (in_com)
1203 case '\t': if (addspace)
1205 if (in_com || in_qstr)
1212 case ';' : if (!(in_com || in_qstr))
1216 default : if (addspace == 1)
1218 *pos++ = (in_com || in_qstr) ? *ptr
1230 /* Find an item in canonical form (lowercase, no extra spaces) within
1231 * an HTTP field value list. Returns 1 if found, 0 if not found.
1232 * This would be much more efficient if we stored header fields as
1233 * an array of list items as they are received instead of a plain string.
1235 API_EXPORT(int) ap_find_list_item(ap_context_t *p, const char *line, const char *tok)
1237 const unsigned char *pos;
1238 const unsigned char *ptr = (const unsigned char *)line;
1239 int good = 0, addspace = 0, in_qpair = 0, in_qstr = 0, in_com = 0;
1244 do { /* loop for each item in line's list */
1246 /* Find first non-comma, non-whitespace byte */
1248 while (*ptr == ',' || ap_isspace(*ptr))
1252 good = 1; /* until proven otherwise for this item */
1254 break; /* no items left and nothing good found */
1256 /* We skip extra whitespace and any whitespace around a '=', '/',
1257 * or ';' and lowercase normal characters not within a comment,
1258 * quoted-string or quoted-pair.
1260 for (pos = (const unsigned char *)tok;
1261 *ptr && (in_qpair || in_qstr || in_com || *ptr != ',');
1267 good = (*pos++ == *ptr);
1271 case '\\': in_qpair = 1;
1273 good = good && (*pos++ == ' ');
1274 good = good && (*pos++ == *ptr);
1277 case '"' : if (!in_com)
1280 good = good && (*pos++ == ' ');
1281 good = good && (*pos++ == *ptr);
1284 case '(' : if (!in_qstr)
1287 good = good && (*pos++ == ' ');
1288 good = good && (*pos++ == *ptr);
1291 case ')' : if (in_com)
1293 good = good && (*pos++ == *ptr);
1297 case '\t': if (addspace || !good)
1299 if (in_com || in_qstr)
1300 good = (*pos++ == *ptr);
1306 case ';' : if (!(in_com || in_qstr))
1308 good = good && (*pos++ == *ptr);
1310 default : if (!good)
1313 good = (*pos++ == ' ');
1314 if (in_com || in_qstr)
1315 good = good && (*pos++ == *ptr);
1317 good = good && (*pos++ == ap_tolower(*ptr));
1324 good = 0; /* not good if only a prefix was matched */
1326 } while (*ptr && !good);
1332 /* Retrieve a token, spacing over it and returning a pointer to
1333 * the first non-white byte afterwards. Note that these tokens
1334 * are delimited by semis and commas; and can also be delimited
1335 * by whitespace at the caller's option.
1338 API_EXPORT(char *) ap_get_token(ap_context_t *p, const char **accept_line, int accept_white)
1340 const char *ptr = *accept_line;
1341 const char *tok_start;
1345 /* Find first non-white byte */
1347 while (*ptr && ap_isspace(*ptr))
1352 /* find token end, skipping over quoted strings.
1353 * (comments are already gone).
1356 while (*ptr && (accept_white || !ap_isspace(*ptr))
1357 && *ptr != ';' && *ptr != ',') {
1364 tok_len = ptr - tok_start;
1365 token = ap_pstrndup(p, tok_start, tok_len);
1367 /* Advance accept_line pointer to the next non-white byte */
1369 while (*ptr && ap_isspace(*ptr))
1377 /* find http tokens, see the definition of token from RFC2068 */
1378 API_EXPORT(int) ap_find_token(ap_context_t *p, const char *line, const char *tok)
1380 const unsigned char *start_token;
1381 const unsigned char *s;
1386 s = (const unsigned char *)line;
1388 /* find start of token, skip all stop characters, note NUL
1389 * isn't a token stop, so we don't need to test for it
1391 while (TEST_CHAR(*s, T_HTTP_TOKEN_STOP)) {
1398 /* find end of the token */
1399 while (*s && !TEST_CHAR(*s, T_HTTP_TOKEN_STOP)) {
1402 if (!strncasecmp((const char *)start_token, (const char *)tok, s - start_token)) {
1412 API_EXPORT(int) ap_find_last_token(ap_context_t *p, const char *line, const char *tok)
1414 int llen, tlen, lidx;
1419 llen = strlen(line);
1424 ((lidx > 0) && !(ap_isspace(line[lidx - 1]) || line[lidx - 1] == ',')))
1427 return (strncasecmp(&line[lidx], tok, tlen) == 0);
1430 API_EXPORT(char *) ap_escape_shell_cmd(ap_context_t *p, const char *str)
1434 const unsigned char *s;
1436 cmd = ap_palloc(p, 2 * strlen(str) + 1); /* Be safe */
1437 d = (unsigned char *)cmd;
1438 s = (const unsigned char *)str;
1441 #if defined(OS2) || defined(WIN32)
1442 /* Don't allow '&' in parameters under OS/2. */
1443 /* This can be used to send commands to the shell. */
1450 if (TEST_CHAR(*s, T_ESCAPE_SHELL_CMD)) {
1460 static char x2c(const char *what)
1462 register char digit;
1464 #ifndef CHARSET_EBCDIC
1465 digit = ((what[0] >= 'A') ? ((what[0] & 0xdf) - 'A') + 10 : (what[0] - '0'));
1467 digit += (what[1] >= 'A' ? ((what[1] & 0xdf) - 'A') + 10 : (what[1] - '0'));
1468 #else /*CHARSET_EBCDIC*/
1475 digit = os_toebcdic[0xFF & strtol(xstr, NULL, 16)];
1476 #endif /*CHARSET_EBCDIC*/
1482 * Returns 0 on success, non-zero on error
1484 * bad % escape returns BAD_REQUEST
1486 * decoding %00 -> \0
1487 * decoding %2f -> / (a special character)
1490 API_EXPORT(int) ap_unescape_url(char *url)
1492 register int badesc, badpath;
1497 /* Initial scan for first '%'. Don't bother writing values before
1499 y = strchr(url, '%');
1503 for (x = y; *y; ++x, ++y) {
1507 if (!ap_isxdigit(*(y + 1)) || !ap_isxdigit(*(y + 2))) {
1514 if (*x == '/' || *x == '\0')
1528 API_EXPORT(char *) ap_construct_server(ap_context_t *p, const char *hostname,
1529 unsigned port, const request_rec *r)
1531 if (ap_is_default_port(port, r))
1532 return ap_pstrdup(p, hostname);
1534 return ap_psprintf(p, "%s:%u", hostname, port);
1538 /* c2x takes an unsigned, and expects the caller has guaranteed that
1539 * 0 <= what < 256... which usually means that you have to cast to
1540 * unsigned char first, because (unsigned)(char)(x) fist goes through
1541 * signed extension to an int before the unsigned cast.
1543 * The reason for this assumption is to assist gcc code generation --
1544 * the unsigned char -> unsigned extension is already done earlier in
1545 * both uses of this code, so there's no need to waste time doing it
1548 static const char c2x_table[] = "0123456789abcdef";
1550 static ap_inline unsigned char *c2x(unsigned what, unsigned char *where)
1553 *where++ = c2x_table[what >> 4];
1554 *where++ = c2x_table[what & 0xf];
1559 * escape_path_segment() escapes a path segment, as defined in RFC 1808. This
1560 * routine is (should be) OS independent.
1562 * os_escape_path() converts an OS path to a URL, in an OS dependent way. In all
1563 * cases if a ':' occurs before the first '/' in the URL, the URL should be
1564 * prefixed with "./" (or the ':' escaped). In the case of Unix, this means
1565 * leaving '/' alone, but otherwise doing what escape_path_segment() does. For
1566 * efficiency reasons, we don't use escape_path_segment(), which is provided for
1567 * reference. Again, RFC 1808 is where this stuff is defined.
1569 * If partial is set, os_escape_path() assumes that the path will be appended to
1570 * something with a '/' in it (and thus does not prefix "./").
1573 API_EXPORT(char *) ap_escape_path_segment(ap_context_t *p, const char *segment)
1575 char *copy = ap_palloc(p, 3 * strlen(segment) + 1);
1576 const unsigned char *s = (const unsigned char *)segment;
1577 unsigned char *d = (unsigned char *)copy;
1581 if (TEST_CHAR(c, T_ESCAPE_PATH_SEGMENT)) {
1593 API_EXPORT(char *) ap_os_escape_path(ap_context_t *p, const char *path, int partial)
1595 char *copy = ap_palloc(p, 3 * strlen(path) + 3);
1596 const unsigned char *s = (const unsigned char *)path;
1597 unsigned char *d = (unsigned char *)copy;
1601 char *colon = strchr(path, ':');
1602 char *slash = strchr(path, '/');
1604 if (colon && (!slash || colon < slash)) {
1610 if (TEST_CHAR(c, T_OS_ESCAPE_PATH)) {
1622 /* ap_escape_uri is now a macro for os_escape_path */
1624 API_EXPORT(char *) ap_escape_html(ap_context_t *p, const char *s)
1629 /* first, count the number of extra characters */
1630 for (i = 0, j = 0; s[i] != '\0'; i++)
1631 if (s[i] == '<' || s[i] == '>')
1633 else if (s[i] == '&')
1637 return ap_pstrndup(p, s, i);
1639 x = ap_palloc(p, i + j + 1);
1640 for (i = 0, j = 0; s[i] != '\0'; i++, j++)
1642 memcpy(&x[j], "<", 4);
1645 else if (s[i] == '>') {
1646 memcpy(&x[j], ">", 4);
1649 else if (s[i] == '&') {
1650 memcpy(&x[j], "&", 5);
1660 API_EXPORT(int) ap_is_directory(const char *path)
1664 if (stat(path, &finfo) == -1)
1665 return 0; /* in error condition, just return no */
1667 return (S_ISDIR(finfo.st_mode));
1670 API_EXPORT(char *) ap_make_full_path(ap_context_t *a, const char *src1,
1677 return ap_pstrcat(a, "/", src2, NULL);
1679 if (src1[x - 1] != '/')
1680 return ap_pstrcat(a, src1, "/", src2, NULL);
1682 return ap_pstrcat(a, src1, src2, NULL);
1686 * Check for an absoluteURI syntax (see section 3.2 in RFC2068).
1688 API_EXPORT(int) ap_is_url(const char *u)
1692 for (x = 0; u[x] != ':'; x++) {
1694 ((!ap_isalpha(u[x])) && (!ap_isdigit(u[x])) &&
1695 (u[x] != '+') && (u[x] != '-') && (u[x] != '.'))) {
1700 return (x ? 1 : 0); /* If the first character is ':', it's broken, too */
1704 char *strdup(const char *str)
1708 if (!(sdup = (char *) malloc(strlen(str) + 1))) {
1709 ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, "Ouch! Out of memory in our strdup()!");
1712 sdup = strcpy(sdup, str);
1718 /* The following two routines were donated for SVR4 by Andreas Vogel */
1719 #ifdef NEED_STRCASECMP
1720 int strcasecmp(const char *a, const char *b)
1724 for (p = a, q = b; *p && *q; p++, q++) {
1725 int diff = ap_tolower(*p) - ap_tolower(*q);
1730 return 1; /* p was longer than q */
1732 return -1; /* p was shorter than q */
1733 return 0; /* Exact match */
1738 #ifdef NEED_STRNCASECMP
1739 int strncasecmp(const char *a, const char *b, int n)
1744 for (p = a, q = b; /*NOTHING */ ; p++, q++) {
1747 return 0; /* Match up to n characters */
1750 diff = ap_tolower(*p) - ap_tolower(*q);
1758 /* The following routine was donated for UTS21 by dwd@bell-labs.com */
1760 char *strstr(char *s1, char *s2)
1767 while((s1 = strchr(s1, *s2)) != NULL) {
1768 /* found first character of s2, see if the rest matches */
1771 while (*++p1 == *++p2) {
1773 /* both strings ended together */
1778 /* second string ended, a match */
1781 /* didn't find a match here, try starting at next character in s1 */
1788 #ifdef NEED_INITGROUPS
1789 int initgroups(const char *name, gid_t basegid)
1791 #if defined(QNX) || defined(MPE) || defined(BEOS) || defined(_OSD_POSIX) || defined(TPF) || defined(__TANDEM)
1792 /* QNX, MPE and BeOS do not appear to support supplementary groups. */
1794 #else /* ndef QNX */
1795 gid_t groups[NGROUPS_MAX];
1801 groups[index++] = basegid;
1803 while (index < NGROUPS_MAX && ((g = getgrent()) != NULL))
1804 if (g->gr_gid != basegid) {
1807 for (names = g->gr_mem; *names != NULL; ++names)
1808 if (!strcmp(*names, name))
1809 groups[index++] = g->gr_gid;
1814 return setgroups(index, groups);
1815 #endif /* def QNX */
1817 #endif /* def NEED_INITGROUPS */
1820 /* From ikluft@amdahl.com
1821 * this is not ideal but it works for SVR3 variants
1822 * Modified by dwd@bell-labs.com to call wait3 instead of wait because
1823 * apache started to use the WNOHANG option.
1825 int waitpid(pid_t pid, int *statusp, int options)
1828 if (kill(pid, 0) == -1) {
1832 while (((tmp_pid = wait3(statusp, options, 0)) != pid) &&
1833 (tmp_pid != -1) && (tmp_pid != 0) && (pid != -1))
1839 API_EXPORT(int) ap_ind(const char *s, char c)
1843 for (x = 0; s[x]; x++)
1850 API_EXPORT(int) ap_rind(const char *s, char c)
1854 for (x = strlen(s) - 1; x != -1; x--)
1861 API_EXPORT(void) ap_str_tolower(char *str)
1864 *str = ap_tolower(*str);
1869 API_EXPORT(uid_t) ap_uname2id(const char *name)
1877 return (atoi(&name[1]));
1879 if (!(ent = getpwnam(name))) {
1880 ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, "%s: bad user name %s", ap_server_argv0, name);
1883 return (ent->pw_uid);
1887 API_EXPORT(gid_t) ap_gname2id(const char *name)
1895 return (atoi(&name[1]));
1897 if (!(ent = getgrnam(name))) {
1898 ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, "%s: bad group name %s", ap_server_argv0, name);
1901 return (ent->gr_gid);
1907 * Parses a host of the form <address>[:port]
1908 * :port is permitted if 'port' is not NULL
1910 unsigned long ap_get_virthost_addr(char *w, unsigned short *ports)
1912 struct hostent *hep;
1913 unsigned long my_addr;
1917 if (ports != NULL) {
1919 if (p != NULL && strcmp(p + 1, "*") != 0)
1920 *ports = atoi(p + 1);
1925 if (strcmp(w, "*") == 0) {
1928 return htonl(INADDR_ANY);
1931 my_addr = ap_inet_addr((char *)w);
1932 if (my_addr != INADDR_NONE) {
1938 hep = gethostbyname(w);
1940 if ((!hep) || (hep->h_addrtype != AF_INET || !hep->h_addr_list[0])) {
1941 ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, "Cannot resolve host name %s --- exiting!", w);
1945 if (hep->h_addr_list[1]) {
1946 ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, "Host %s has multiple addresses ---", w);
1947 ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, "you must choose one explicitly for use as");
1948 ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, "a virtual host. Exiting!!!");
1955 return ((struct in_addr *) (hep->h_addr))->s_addr;
1959 static char *find_fqdn(ap_context_t *a, struct hostent *p)
1963 if (!strchr(p->h_name, '.')) {
1964 for (x = 0; p->h_aliases[x]; ++x) {
1965 if (strchr(p->h_aliases[x], '.') &&
1966 (!strncasecmp(p->h_aliases[x], p->h_name, strlen(p->h_name))))
1967 return ap_pstrdup(a, p->h_aliases[x]);
1971 return ap_pstrdup(a, (void *) p->h_name);
1974 char *ap_get_local_host(ap_context_t *a)
1976 #ifndef MAXHOSTNAMELEN
1977 #define MAXHOSTNAMELEN 256
1979 char str[MAXHOSTNAMELEN + 1];
1980 char *server_hostname;
1984 if (gethostname(str, sizeof(str) - 1) == 0)
1986 if (gethostname(str, sizeof(str) - 1) != 0)
1989 perror("Unable to gethostname");
1992 str[MAXHOSTNAMELEN] = '\0';
1993 if ((!(p = gethostbyname(str))) || (!(server_hostname = find_fqdn(a, p)))) {
1994 ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL,
1995 "%s: cannot determine local host name.",
1997 ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL,
1998 "Use the ServerName directive to set it manually.");
2002 return server_hostname;
2005 /* simple 'pool' alloc()ing glue to ap_base64.c
2007 API_EXPORT(char *) ap_pbase64decode(ap_context_t *p, const char *bufcoded)
2012 decoded = (char *) ap_palloc(p, 1 + ap_base64decode_len(bufcoded));
2013 l = ap_base64decode(decoded, bufcoded);
2014 decoded[l] = '\0'; /* make binary sequence into string */
2019 API_EXPORT(char *) ap_pbase64encode(ap_context_t *p, char *string)
2022 int l = strlen(string);
2024 encoded = (char *) ap_palloc(p, 1 + ap_base64encode_len(l));
2025 l = ap_base64encode(encoded, string, l);
2026 encoded[l] = '\0'; /* make binary sequence into string */
2031 /* deprecated names for the above two functions, here for compatibility
2033 API_EXPORT(char *) ap_uudecode(ap_context_t *p, const char *bufcoded)
2035 return ap_pbase64decode(p, bufcoded);
2038 API_EXPORT(char *) ap_uuencode(ap_context_t *p, char *string)
2040 return ap_pbase64encode(p, string);
2044 void os2pathname(char *path)
2046 char newpath[MAX_STRING_LEN];
2051 for (loop = 0; loop < (strlen(path) + 1) && loop < sizeof(newpath) - 1; loop++) {
2052 if (path[loop] == '/') {
2053 newpath[offset] = '\\';
2055 offset = offset + 1;
2056 newpath[offset] = '\\';
2060 newpath[offset] = path[loop];
2061 offset = offset + 1;
2063 /* Debugging code */
2064 /* fprintf(stderr, "%s \n", newpath); */
2066 strcpy(path, newpath);
2069 /* quotes in the string are doubled up.
2070 * Used to escape quotes in args passed to OS/2's cmd.exe
2072 char *ap_double_quotes(ap_context_t *p, char *str)
2076 char *quote_doubled_str, *dest;
2079 num_quotes += str[len++] == '\"';
2082 quote_doubled_str = ap_palloc(p, len + num_quotes + 1);
2083 dest = quote_doubled_str;
2088 *(dest++) = *(str++);
2092 return quote_doubled_str;
2097 #ifdef NEED_STRERROR
2103 extern char *const sys_errlist[];
2105 p = sys_errlist[err];
2110 #if defined(NEED_DIFFTIME)
2111 double difftime(time_t time1, time_t time0)
2113 return (time1 - time0);
2117 /* we want to downcase the type/subtype for comparison purposes
2118 * but nothing else because ;parameter=foo values are case sensitive.
2119 * XXX: in truth we want to downcase parameter names... but really,
2120 * apache has never handled parameters and such correctly. You
2121 * also need to compress spaces and such to be able to compare
2124 API_EXPORT(void) ap_content_type_tolower(char *str)
2128 semi = strchr(str, ';');
2133 *str = ap_tolower(*str);
2142 * Given a string, replace any bare " with \" .
2144 API_EXPORT(char *) ap_escape_quotes (ap_context_t *p, const char *instring)
2147 const char *inchr = instring;
2148 char *outchr, *outstring;
2151 * Look through the input string, jogging the length of the output
2152 * string up by an extra byte each time we find an unescaped ".
2154 while (*inchr != '\0') {
2156 if (*inchr == '"') {
2160 * If we find a slosh, and it's not the last byte in the string,
2161 * it's escaping something - advance past both bytes.
2163 if ((*inchr == '\\') && (inchr[1] != '\0')) {
2169 outstring = ap_palloc(p, newlen + 1);
2173 * Now copy the input string to the output string, inserting a slosh
2174 * in front of every " that doesn't already have one.
2176 while (*inchr != '\0') {
2177 if ((*inchr == '\\') && (inchr[1] != '\0')) {
2178 *outchr++ = *inchr++;
2179 *outchr++ = *inchr++;
2181 if (*inchr == '"') {
2184 if (*inchr != '\0') {
2185 *outchr++ = *inchr++;