1 /* Reading/parsing the initialization file.
2 Copyright (C) 1995, 1996, 1997, 1998 Free Software Foundation, Inc.
4 This file is part of Wget.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
24 #include <sys/types.h>
39 # include <sys/socket.h>
40 # include <netinet/in.h>
41 # include <arpa/inet.h>
60 #define CMD_DECLARE(func) static int func \
61 PARAMS ((const char *, const char *, void *))
63 CMD_DECLARE (cmd_address);
64 CMD_DECLARE (cmd_boolean);
65 CMD_DECLARE (cmd_bytes);
66 CMD_DECLARE (cmd_directory_vector);
67 CMD_DECLARE (cmd_lockable_boolean);
68 CMD_DECLARE (cmd_number);
69 CMD_DECLARE (cmd_number_inf);
70 CMD_DECLARE (cmd_string);
71 CMD_DECLARE (cmd_time);
72 CMD_DECLARE (cmd_vector);
74 CMD_DECLARE (cmd_spec_dirstruct);
75 CMD_DECLARE (cmd_spec_dotstyle);
76 CMD_DECLARE (cmd_spec_header);
77 CMD_DECLARE (cmd_spec_htmlify);
78 CMD_DECLARE (cmd_spec_mirror);
79 CMD_DECLARE (cmd_spec_recursive);
80 CMD_DECLARE (cmd_spec_useragent);
82 /* List of recognized commands, each consisting of name, closure and function.
83 When adding a new command, simply add it to the list, but be sure to keep the
84 list sorted alphabetically, as comind() depends on it. Also, be sure to add
85 any entries that allocate memory (e.g. cmd_string and cmd_vector guys) to the
86 cleanup() function below. */
90 int (*action) PARAMS ((const char *, const char *, void *));
92 { "accept", &opt.accepts, cmd_vector },
93 { "addhostdir", &opt.add_hostdir, cmd_boolean },
94 { "alwaysrest", &opt.always_rest, cmd_boolean }, /* deprecated */
95 { "background", &opt.background, cmd_boolean },
96 { "backupconverted", &opt.backup_converted, cmd_boolean },
97 { "backups", &opt.backups, cmd_number },
98 { "bindaddress", &opt.bind_address, cmd_address },
99 { "base", &opt.base_href, cmd_string },
100 { "cache", &opt.proxy_cache, cmd_boolean },
101 { "continue", &opt.always_rest, cmd_boolean },
102 { "convertlinks", &opt.convert_links, cmd_boolean },
103 { "cutdirs", &opt.cut_dirs, cmd_number },
105 { "debug", &opt.debug, cmd_boolean },
107 { "deleteafter", &opt.delete_after, cmd_boolean },
108 { "dirprefix", &opt.dir_prefix, cmd_string },
109 { "dirstruct", NULL, cmd_spec_dirstruct },
110 { "domains", &opt.domains, cmd_vector },
111 { "dotbytes", &opt.dot_bytes, cmd_bytes },
112 { "dotsinline", &opt.dots_in_line, cmd_number },
113 { "dotspacing", &opt.dot_spacing, cmd_number },
114 { "dotstyle", NULL, cmd_spec_dotstyle },
115 { "excludedirectories", &opt.excludes, cmd_directory_vector },
116 { "excludedomains", &opt.exclude_domains, cmd_vector },
117 { "followftp", &opt.follow_ftp, cmd_boolean },
118 { "followtags", &opt.follow_tags, cmd_vector },
119 { "forcehtml", &opt.force_html, cmd_boolean },
120 { "ftpproxy", &opt.ftp_proxy, cmd_string },
121 { "glob", &opt.ftp_glob, cmd_boolean },
122 { "header", NULL, cmd_spec_header },
123 { "htmlextension", &opt.html_extension, cmd_boolean },
124 { "htmlify", NULL, cmd_spec_htmlify },
125 { "httppasswd", &opt.http_passwd, cmd_string },
126 { "httpproxy", &opt.http_proxy, cmd_string },
127 { "httpuser", &opt.http_user, cmd_string },
128 { "ignorelength", &opt.ignore_length, cmd_boolean },
129 { "ignoretags", &opt.ignore_tags, cmd_vector },
130 { "includedirectories", &opt.includes, cmd_directory_vector },
131 { "input", &opt.input_filename, cmd_string },
132 { "killlonger", &opt.kill_longer, cmd_boolean },
133 { "logfile", &opt.lfilename, cmd_string },
134 { "login", &opt.ftp_acc, cmd_string },
135 { "mirror", NULL, cmd_spec_mirror },
136 { "netrc", &opt.netrc, cmd_boolean },
137 { "noclobber", &opt.noclobber, cmd_boolean },
138 { "noparent", &opt.no_parent, cmd_boolean },
139 { "noproxy", &opt.no_proxy, cmd_vector },
140 { "numtries", &opt.ntry, cmd_number_inf },/* deprecated*/
141 { "outputdocument", &opt.output_document, cmd_string },
142 { "pagerequisites", &opt.page_requisites, cmd_boolean },
143 { "passiveftp", &opt.ftp_pasv, cmd_lockable_boolean },
144 { "passwd", &opt.ftp_pass, cmd_string },
145 { "proxypasswd", &opt.proxy_passwd, cmd_string },
146 { "proxyuser", &opt.proxy_user, cmd_string },
147 { "quiet", &opt.quiet, cmd_boolean },
148 { "quota", &opt.quota, cmd_bytes },
149 { "reclevel", &opt.reclevel, cmd_number_inf },
150 { "recursive", NULL, cmd_spec_recursive },
151 { "referer", &opt.referer, cmd_string },
152 { "reject", &opt.rejects, cmd_vector },
153 { "relativeonly", &opt.relative_only, cmd_boolean },
154 { "removelisting", &opt.remove_listing, cmd_boolean },
155 { "retrsymlinks", &opt.retr_symlinks, cmd_boolean },
156 { "robots", &opt.use_robots, cmd_boolean },
157 { "saveheaders", &opt.save_headers, cmd_boolean },
158 { "serverresponse", &opt.server_response, cmd_boolean },
159 { "simplehostcheck", &opt.simple_check, cmd_boolean },
160 { "spanhosts", &opt.spanhost, cmd_boolean },
161 { "spider", &opt.spider, cmd_boolean },
162 { "timeout", &opt.timeout, cmd_time },
163 { "timestamping", &opt.timestamping, cmd_boolean },
164 { "tries", &opt.ntry, cmd_number_inf },
165 { "useproxy", &opt.use_proxy, cmd_boolean },
166 { "useragent", NULL, cmd_spec_useragent },
167 { "verbose", &opt.verbose, cmd_boolean },
168 { "wait", &opt.wait, cmd_time },
169 { "waitretry", &opt.waitretry, cmd_time }
172 /* Return index of COM if it is a valid command, or -1 otherwise. COM
173 is looked up in `commands' using binary search algorithm. */
175 comind (const char *com)
177 int min = 0, max = ARRAY_SIZE (commands);
181 int i = (min + max) / 2;
182 int cmp = strcasecmp (com, commands[i].name);
194 /* Reset the variables to default values. */
200 /* Most of the default values are 0. Just reset everything, and
201 fill in the non-zero values. Note that initializing pointers to
202 NULL this way is technically illegal, but porting Wget to a
203 machine where NULL is not all-zero bit pattern will be the least
204 of the implementors' worries. */
205 memset (&opt, 0, sizeof (opt));
208 opt.dir_prefix = xstrdup (".");
212 opt.ftp_acc = xstrdup ("anonymous");
213 /*opt.ftp_pass = xstrdup (ftp_getaddress ());*/
218 tmp = getenv ("no_proxy");
220 opt.no_proxy = sepstring (tmp);
228 opt.remove_listing = 1;
230 opt.dot_bytes = 1024;
231 opt.dot_spacing = 10;
232 opt.dots_in_line = 50;
235 /* Return the user's home directory (strdup-ed), or NULL if none is
240 char *home = getenv ("HOME");
245 /* If HOME is not defined, try getting it from the password
247 struct passwd *pwd = getpwuid (getuid ());
248 if (!pwd || !pwd->pw_dir)
253 /* #### Maybe I should grab home_dir from registry, but the best
254 that I could get from there is user's Start menu. It sucks! */
258 return home ? xstrdup (home) : NULL;
261 /* Return the path to the user's .wgetrc. This is either the value of
262 `WGETRC' environment variable, or `$HOME/.wgetrc'.
264 If the `WGETRC' variable exists but the file does not exist, the
265 function will exit(). */
267 wgetrc_file_name (void)
272 /* Try the environment. */
273 env = getenv ("WGETRC");
276 if (!file_exists_p (env))
278 fprintf (stderr, "%s: %s: %s.\n", exec_name, file, strerror (errno));
281 return xstrdup (env);
285 /* If that failed, try $HOME/.wgetrc. */
289 file = (char *)xmalloc (strlen (home) + 1 + strlen (".wgetrc") + 1);
290 sprintf (file, "%s/.wgetrc", home);
294 /* Under Windows, "home" is (for the purposes of this function) the
295 directory where `wget.exe' resides, and `wget.ini' will be used
296 as file name. SYSTEM_WGETRC should not be defined under WINDOWS.
298 It is not as trivial as I assumed, because on 95 argv[0] is full
299 path, but on NT you get what you typed in command line. --dbudor */
303 file = (char *)xmalloc (strlen (home) + strlen ("wget.ini") + 1);
304 sprintf (file, "%swget.ini", home);
310 if (!file_exists_p (file))
318 /* Initialize variables from a wgetrc file */
320 run_wgetrc (const char *file)
326 fp = fopen (file, "rb");
329 fprintf (stderr, _("%s: Cannot read %s (%s).\n"), exec_name,
330 file, strerror (errno));
333 /* Reset line number. */
335 while ((line = read_whole_line (fp)))
339 int length = strlen (line);
341 if (length && line[length - 1] == '\r')
342 line[length - 1] = '\0';
343 /* Parse the line. */
344 status = parse_line (line, &com, &val);
346 /* If everything is OK, set the value. */
349 if (!setval (com, val))
350 fprintf (stderr, _("%s: Error in %s at line %d.\n"), exec_name,
355 else if (status == 0)
356 fprintf (stderr, _("%s: Error in %s at line %d.\n"), exec_name,
363 /* Initialize the defaults and run the system wgetrc and user's own
370 /* Load the hard-coded defaults. */
373 /* If SYSTEM_WGETRC is defined, use it. */
375 if (file_exists_p (SYSTEM_WGETRC))
376 run_wgetrc (SYSTEM_WGETRC);
378 /* Override it with your own, if one exists. */
379 file = wgetrc_file_name ();
382 /* #### We should somehow canonicalize `file' and SYSTEM_WGETRC,
385 if (!strcmp (file, SYSTEM_WGETRC))
387 fprintf (stderr, _("\
388 %s: Warning: Both system and user wgetrc point to `%s'.\n"),
398 /* Parse the line pointed by line, with the syntax:
399 <sp>* command <sp>* = <sp>* value <newline>
400 Uses malloc to allocate space for command and value.
401 If the line is invalid, data is freed and 0 is returned.
408 parse_line (const char *line, char **com, char **val)
410 const char *p = line;
411 const char *orig_comptr, *end;
415 while (*p == ' ' || *p == '\t')
418 /* Don't process empty lines. */
419 if (!*p || *p == '\n' || *p == '#')
422 for (orig_comptr = p; ISALPHA (*p) || *p == '_' || *p == '-'; p++)
424 /* The next char should be space or '='. */
425 if (!ISSPACE (*p) && (*p != '='))
427 *com = (char *)xmalloc (p - orig_comptr + 1);
428 for (new_comptr = *com; orig_comptr < p; orig_comptr++)
430 if (*orig_comptr == '_' || *orig_comptr == '-')
432 *new_comptr++ = *orig_comptr;
435 /* If the command is invalid, exit now. */
436 if (comind (*com) == -1)
442 /* Skip spaces before '='. */
443 for (; ISSPACE (*p); p++);
444 /* If '=' not found, bail out. */
450 /* Skip spaces after '='. */
451 for (++p; ISSPACE (*p); p++);
452 /* Get the ending position. */
453 for (end = p; *end && *end != '\n'; end++);
454 /* Allocate *val, and copy from line. */
455 *val = strdupdelim (p, end);
459 /* Set COM to VAL. This is the meat behind processing `.wgetrc'. No
460 fatals -- error signal prints a warning and resets to default
461 value. All error messages are printed to stderr, *not* to
462 opt.lfile, since opt.lfile wasn't even generated yet. */
464 setval (const char *com, const char *val)
473 /* #### Should I just abort()? */
475 fprintf (stderr, _("%s: BUG: unknown command `%s', value `%s'.\n"),
476 exec_name, com, val);
480 return ((*commands[ind].action) (com, val, commands[ind].closure));
483 /* Generic helper functions, for use with `commands'. */
485 static int myatoi PARAMS ((const char *s));
487 /* Store the address (specified as hostname or dotted-quad IP address) from VAL
488 to CLOSURE. COM is ignored, except for error messages. */
490 cmd_address (const char *com, const char *val, void *closure)
492 struct sockaddr_in *sin;
494 sin = (struct sockaddr_in *) malloc(sizeof *sin);
497 fprintf (stderr, _("%s: Out of memory.\n"), exec_name);
501 if (!store_hostaddress ((unsigned char *)&sin->sin_addr, val))
503 fprintf (stderr, _("%s: %s: Cannot convert `%s' to an IP address.\n"),
504 exec_name, com, val);
508 sin->sin_family = AF_INET;
511 * (struct sockaddr_in **) closure = sin;
516 /* Store the boolean value from VAL to CLOSURE. COM is ignored,
517 except for error messages. */
519 cmd_boolean (const char *com, const char *val, void *closure)
523 if (!strcasecmp (val, "on")
524 || (*val == '1' && !*(val + 1)))
526 else if (!strcasecmp (val, "off")
527 || (*val == '0' && !*(val + 1)))
531 fprintf (stderr, _("%s: %s: Please specify on or off.\n"),
536 *(int *)closure = bool_value;
540 /* Store the lockable_boolean {2, 1, 0, -1} value from VAL to CLOSURE. COM is
541 ignored, except for error messages. Values 2 and -1 indicate that once
542 defined, the value may not be changed by successive wgetrc files or
543 command-line arguments.
545 Values: 2 - Enable a particular option for good ("always")
546 1 - Enable an option ("on")
547 0 - Disable an option ("off")
548 -1 - Disable an option for good ("never") */
550 cmd_lockable_boolean (const char *com, const char *val, void *closure)
552 int lockable_boolean_value;
555 * If a config file said "always" or "never", don't allow command line
556 * arguments to override the config file.
558 if (*(int *)closure == -1 || *(int *)closure == 2)
561 if (!strcasecmp (val, "always")
562 || (*val == '2' && !*(val + 1)))
563 lockable_boolean_value = 2;
564 else if (!strcasecmp (val, "on")
565 || (*val == '1' && !*(val + 1)))
566 lockable_boolean_value = 1;
567 else if (!strcasecmp (val, "off")
568 || (*val == '0' && !*(val + 1)))
569 lockable_boolean_value = 0;
570 else if (!strcasecmp (val, "never")
571 || (*val == '-' && *(val + 1) == '1' && !*(val + 2)))
572 lockable_boolean_value = -1;
575 fprintf (stderr, _("%s: %s: Please specify always, on, off, "
581 *(int *)closure = lockable_boolean_value;
585 /* Set the non-negative integer value from VAL to CLOSURE. With
586 incorrect specification, the number remains unchanged. */
588 cmd_number (const char *com, const char *val, void *closure)
590 int num = myatoi (val);
594 fprintf (stderr, _("%s: %s: Invalid specification `%s'.\n"),
595 exec_name, com, val);
598 *(int *)closure = num;
602 /* Similar to cmd_number(), only accepts `inf' as a synonym for 0. */
604 cmd_number_inf (const char *com, const char *val, void *closure)
606 if (!strcasecmp (val, "inf"))
611 return cmd_number (com, val, closure);
614 /* Copy (strdup) the string at COM to a new location and place a
615 pointer to *CLOSURE. */
617 cmd_string (const char *com, const char *val, void *closure)
619 char **pstring = (char **)closure;
621 FREE_MAYBE (*pstring);
622 *pstring = xstrdup (val);
626 /* Merge the vector (array of strings separated with `,') in COM with
627 the vector (NULL-terminated array of strings) pointed to by
630 cmd_vector (const char *com, const char *val, void *closure)
632 char ***pvec = (char ***)closure;
635 *pvec = merge_vecs (*pvec, sepstring (val));
645 cmd_directory_vector (const char *com, const char *val, void *closure)
647 char ***pvec = (char ***)closure;
651 /* Strip the trailing slashes from directories. */
654 seps = sepstring (val);
655 for (t = seps; t && *t; t++)
657 int len = strlen (*t);
658 /* Skip degenerate case of root directory. */
661 if ((*t)[len - 1] == '/')
662 (*t)[len - 1] = '\0';
665 *pvec = merge_vecs (*pvec, seps);
675 /* Set the value stored in VAL to CLOSURE (which should point to a
676 long int), allowing several postfixes, with the following syntax
680 [0-9]+[kK] -> bytes * 1024
681 [0-9]+[mM] -> bytes * 1024 * 1024
684 Anything else is flagged as incorrect, and CLOSURE is unchanged. */
686 cmd_bytes (const char *com, const char *val, void *closure)
689 long *out = (long *)closure;
694 /* Check for "inf". */
695 if (p[0] == 'i' && p[1] == 'n' && p[2] == 'f' && p[3] == '\0')
700 /* Search for digits and construct result. */
701 for (; *p && ISDIGIT (*p); p++)
702 result = (10 * result) + (*p - '0');
703 /* If no digits were found, or more than one character is following
705 if (p == val || (*p != '\0' && *(p + 1) != '\0'))
707 printf (_("%s: Invalid specification `%s'\n"), com, val);
710 /* Search for a designator. */
711 switch (TOLOWER (*p))
722 result *= (long)1024 * 1024;
726 result *= (long)1024 * 1024 * 1024;
729 printf (_("%s: Invalid specification `%s'\n"), com, val);
736 /* Store the value of VAL to *OUT, allowing suffixes for minutes and
739 cmd_time (const char *com, const char *val, void *closure)
744 /* Search for digits and construct result. */
745 for (; *p && ISDIGIT (*p); p++)
746 result = (10 * result) + (*p - '0');
747 /* If no digits were found, or more than one character is following
749 if (p == val || (*p != '\0' && *(p + 1) != '\0'))
751 printf (_("%s: Invalid specification `%s'\n"), com, val);
754 /* Search for a suffix. */
755 switch (TOLOWER (*p))
769 /* Days (overflow on 16bit machines) */
777 printf (_("%s: Invalid specification `%s'\n"), com, val);
780 *(long *)closure = result;
784 /* Specialized helper functions, used by `commands' to handle some
785 options specially. */
787 static int check_user_specified_header PARAMS ((const char *));
790 cmd_spec_dirstruct (const char *com, const char *val, void *closure)
792 if (!cmd_boolean (com, val, &opt.dirstruct))
794 /* Since dirstruct behaviour is explicitly changed, no_dirstruct
795 must be affected inversely. */
797 opt.no_dirstruct = 0;
799 opt.no_dirstruct = 1;
804 cmd_spec_dotstyle (const char *com, const char *val, void *closure)
806 /* Retrieval styles. */
807 if (!strcasecmp (val, "default"))
809 /* Default style: 1K dots, 10 dots in a cluster, 50 dots in a
811 opt.dot_bytes = 1024;
812 opt.dot_spacing = 10;
813 opt.dots_in_line = 50;
815 else if (!strcasecmp (val, "binary"))
817 /* "Binary" retrieval: 8K dots, 16 dots in a cluster, 48 dots
819 opt.dot_bytes = 8192;
820 opt.dot_spacing = 16;
821 opt.dots_in_line = 48;
823 else if (!strcasecmp (val, "mega"))
825 /* "Mega" retrieval, for retrieving very long files; each dot is
826 64K, 8 dots in a cluster, 6 clusters (3M) in a line. */
827 opt.dot_bytes = 65536L;
829 opt.dots_in_line = 48;
831 else if (!strcasecmp (val, "giga"))
833 /* "Giga" retrieval, for retrieving very very *very* long files;
834 each dot is 1M, 8 dots in a cluster, 4 clusters (32M) in a
836 opt.dot_bytes = (1L << 20);
838 opt.dots_in_line = 32;
840 else if (!strcasecmp (val, "micro"))
842 /* "Micro" retrieval, for retrieving very small files (and/or
843 slow connections); each dot is 128 bytes, 8 dots in a
844 cluster, 6 clusters (6K) in a line. */
847 opt.dots_in_line = 48;
851 fprintf (stderr, _("%s: %s: Invalid specification `%s'.\n"),
852 exec_name, com, val);
859 cmd_spec_header (const char *com, const char *val, void *closure)
863 /* Empty header means reset headers. */
864 FREE_MAYBE (opt.user_header);
865 opt.user_header = NULL;
871 if (!check_user_specified_header (val))
873 fprintf (stderr, _("%s: %s: Invalid specification `%s'.\n"),
874 exec_name, com, val);
877 i = opt.user_header ? strlen (opt.user_header) : 0;
878 opt.user_header = (char *)xrealloc (opt.user_header, i + strlen (val)
880 strcpy (opt.user_header + i, val);
882 opt.user_header[i++] = '\r';
883 opt.user_header[i++] = '\n';
884 opt.user_header[i] = '\0';
890 cmd_spec_htmlify (const char *com, const char *val, void *closure)
892 int flag = cmd_boolean (com, val, &opt.htmlify);
893 if (flag && !opt.htmlify)
894 opt.remove_listing = 0;
899 cmd_spec_mirror (const char *com, const char *val, void *closure)
903 if (!cmd_boolean (com, val, &mirror))
908 if (!opt.no_dirstruct)
910 opt.timestamping = 1;
911 opt.reclevel = INFINITE_RECURSION;
912 opt.remove_listing = 0;
918 cmd_spec_recursive (const char *com, const char *val, void *closure)
920 if (!cmd_boolean (com, val, &opt.recursive))
924 if (opt.recursive && !opt.no_dirstruct)
931 cmd_spec_useragent (const char *com, const char *val, void *closure)
933 /* Just check for empty string and newline, so we don't throw total
934 junk to the server. */
935 if (!*val || strchr (val, '\n'))
937 fprintf (stderr, _("%s: %s: Invalid specification `%s'.\n"),
938 exec_name, com, val);
941 opt.useragent = xstrdup (val);
945 /* Miscellaneous useful routines. */
947 /* Return the integer value of a positive integer written in S, or -1
948 if an error was encountered. */
950 myatoi (const char *s)
953 const char *orig = s;
955 for (res = 0; *s && ISDIGIT (*s); s++)
956 res = 10 * res + (*s - '0');
963 #define ISODIGIT(x) ((x) >= '0' && (x) <= '7')
966 check_user_specified_header (const char *s)
970 for (p = s; *p && *p != ':' && !ISSPACE (*p); p++);
971 /* The header MUST contain `:' preceded by at least one
972 non-whitespace character. */
973 if (*p != ':' || p == s)
975 /* The header MUST NOT contain newlines. */
976 if (strchr (s, '\n'))
981 /* Free the memory allocated by global variables. */
985 extern acc_t *netrc_list;
987 recursive_cleanup ();
989 free_netrc (netrc_list);
992 FREE_MAYBE (opt.lfilename);
993 free (opt.dir_prefix);
994 FREE_MAYBE (opt.input_filename);
995 FREE_MAYBE (opt.output_document);
996 free_vec (opt.accepts);
997 free_vec (opt.rejects);
998 free_vec (opt.excludes);
999 free_vec (opt.includes);
1000 free_vec (opt.domains);
1001 free_vec (opt.follow_tags);
1002 free_vec (opt.ignore_tags);
1004 free (opt.ftp_pass);
1005 FREE_MAYBE (opt.ftp_proxy);
1006 FREE_MAYBE (opt.http_proxy);
1007 free_vec (opt.no_proxy);
1008 FREE_MAYBE (opt.useragent);
1009 FREE_MAYBE (opt.referer);
1010 FREE_MAYBE (opt.http_user);
1011 FREE_MAYBE (opt.http_passwd);
1012 FREE_MAYBE (opt.user_header);