1 /* Command line parsing.
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. */
27 #endif /* HAVE_UNISTD_H */
28 #include <sys/types.h>
33 #endif /* HAVE_STRING_H */
40 #endif /* HAVE_LOCALE_H */
43 #define OPTIONS_DEFINED_HERE /* for options.h */
53 #ifndef PATH_SEPARATOR
54 # define PATH_SEPARATOR '/'
57 extern char *version_string;
66 void log_init PARAMS ((const char *, int));
67 void log_close PARAMS ((void));
68 void redirect_output PARAMS ((const char *));
70 static RETSIGTYPE redirect_output_signal PARAMS ((int));
72 const char *exec_name;
74 /* Initialize I18N. The initialization amounts to invoking
75 setlocale(), bindtextdomain() and textdomain().
76 Does nothing if NLS is disabled or missing. */
78 i18n_initialize (void)
80 /* If HAVE_NLS is defined, assume the existence of the three
81 functions invoked here. */
83 /* Set the current locale. */
84 /* Here we use LC_MESSAGES instead of LC_ALL, for two reasons.
85 First, message catalogs are all of I18N Wget uses anyway.
86 Second, setting LC_ALL has a dangerous potential of messing
87 things up. For example, when in a foreign locale, Solaris
88 strptime() fails to handle international dates correctly, which
89 makes http_atotm() malfunction. */
91 setlocale (LC_MESSAGES, "");
93 setlocale (LC_ALL, "");
95 /* Set the text message domain. */
96 bindtextdomain ("wget", LOCALEDIR);
101 /* Print the usage message. */
105 printf (_("Usage: %s [OPTION]... [URL]...\n"), exec_name);
108 /* Print the help message, describing all the available options. If
109 you add an option, be sure to update this list. */
113 printf (_("GNU Wget %s, a non-interactive network retriever.\n"),
116 /* Had to split this in parts, so the #@@#%# Ultrix compiler and cpp
117 don't bitch. Also, it makes translation much easier. */
118 printf ("%s%s%s%s%s%s%s%s%s%s", _("\
120 Mandatory arguments to long options are mandatory for short options too.\n\
123 -V, --version display the version of Wget and exit.\n\
124 -h, --help print this help.\n\
125 -b, --background go to background after startup.\n\
126 -e, --execute=COMMAND execute a `.wgetrc\'-style command.\n\
128 Logging and input file:\n\
129 -o, --output-file=FILE log messages to FILE.\n\
130 -a, --append-output=FILE append messages to FILE.\n\
131 -d, --debug print debug output.\n\
132 -q, --quiet quiet (no output).\n\
133 -v, --verbose be verbose (this is the default).\n\
134 -nv, --non-verbose turn off verboseness, without being quiet.\n\
135 -i, --input-file=FILE download URLs found in FILE.\n\
136 -F, --force-html treat input file as HTML.\n\
137 -B, --base=URL prepends URL to relative links in -F -i file.\n\
140 -t, --tries=NUMBER set number of retries to NUMBER (0 unlimits).\n\
141 -O --output-document=FILE write documents to FILE.\n\
142 -nc, --no-clobber don\'t clobber existing files or use .# suffixes.\n\
143 -c, --continue restart getting an existing file.\n\
144 --dot-style=STYLE set retrieval display style.\n\
145 -N, --timestamping don\'t retrieve files if older than local.\n\
146 -S, --server-response print server response.\n\
147 --spider don\'t download anything.\n\
148 -T, --timeout=SECONDS set the read timeout to SECONDS.\n\
149 -w, --wait=SECONDS wait SECONDS between retrievals.\n\
150 --waitretry=SECONDS wait 1...SECONDS between retries of a retrieval.\n\
151 -Y, --proxy=on/off turn proxy on or off.\n\
152 -Q, --quota=NUMBER set retrieval quota to NUMBER.\n\
155 -nd --no-directories don\'t create directories.\n\
156 -x, --force-directories force creation of directories.\n\
157 -nH, --no-host-directories don\'t create host directories.\n\
158 -P, --directory-prefix=PREFIX save files to PREFIX/...\n\
159 --cut-dirs=NUMBER ignore NUMBER remote directory components.\n\
162 --http-user=USER set http user to USER.\n\
163 --http-passwd=PASS set http password to PASS.\n\
164 -C, --cache=on/off (dis)allow server-cached data (normally allowed).\n\
165 --ignore-length ignore `Content-Length\' header field.\n\
166 --header=STRING insert STRING among the headers.\n\
167 --proxy-user=USER set USER as proxy username.\n\
168 --proxy-passwd=PASS set PASS as proxy password.\n\
169 --referer=URL include `Referer: URL\' header in HTTP request.\n\
170 -s, --save-headers save the HTTP headers to file.\n\
171 -U, --user-agent=AGENT identify as AGENT instead of Wget/VERSION.\n\
174 --retr-symlinks retrieve FTP symbolic links.\n\
175 -g, --glob=on/off turn file name globbing on or off.\n\
176 --passive-ftp use the \"passive\" transfer mode.\n\
178 Recursive retrieval:\n\
179 -r, --recursive recursive web-suck -- use with care!.\n\
180 -l, --level=NUMBER maximum recursion depth (inf or 0 for infinite).\n\
181 --delete-after delete downloaded files.\n\
182 -k, --convert-links convert non-relative links to relative.\n\
183 -K, --backup-converted before converting file X, back up as X.orig.\n\
184 -m, --mirror shortcut option equivalent to -r -N -l inf -nr.\n\
185 -nr, --dont-remove-listing don\'t remove `.listing\' files.\n\
186 -p, --page-requisites get all images, etc. needed to display HTML page.\n\
188 Recursive accept/reject:\n\
189 -A, --accept=LIST comma-separated list of accepted extensions.\n\
190 -R, --reject=LIST comma-separated list of rejected extensions.\n\
191 -D, --domains=LIST comma-separated list of accepted domains.\n\
192 --exclude-domains=LIST comma-separated list of rejected domains.\n\
193 --follow-ftp follow FTP links from HTML documents.\n\
194 --follow-tags=LIST comma-separated list of followed HTML tags.\n\
195 -G, --ignore-tags=LIST comma-separated list of ignored HTML tags.\n\
196 -H, --span-hosts go to foreign hosts when recursive.\n\
197 -L, --relative follow relative links only.\n\
198 -I, --include-directories=LIST list of allowed directories.\n\
199 -X, --exclude-directories=LIST list of excluded directories.\n\
200 -nh, --no-host-lookup don\'t DNS-lookup hosts.\n\
201 -np, --no-parent don\'t ascend to the parent directory.\n\
202 \n"), _("Mail bug reports and suggestions to <bug-wget@gnu.org>.\n"));
206 main (int argc, char *const *argv)
209 int i, c, nurl, status, append_to_log;
212 static struct option long_options[] =
214 /* Options without arguments: */
215 { "background", no_argument, NULL, 'b' },
216 { "continue", no_argument, NULL, 'c' },
217 { "convert-links", no_argument, NULL, 'k' },
218 { "backup-converted", no_argument, NULL, 'K' },
219 { "debug", no_argument, NULL, 'd' },
220 { "dont-remove-listing", no_argument, NULL, 21 },
221 { "email-address", no_argument, NULL, 'E' }, /* undocumented (debug) */
222 { "follow-ftp", no_argument, NULL, 14 },
223 { "force-directories", no_argument, NULL, 'x' },
224 { "force-hier", no_argument, NULL, 'x' }, /* obsolete */
225 { "force-html", no_argument, NULL, 'F'},
226 { "help", no_argument, NULL, 'h' },
227 { "ignore-length", no_argument, NULL, 10 },
228 { "mirror", no_argument, NULL, 'm' },
229 { "no-clobber", no_argument, NULL, 13 },
230 { "no-directories", no_argument, NULL, 19 },
231 { "no-host-directories", no_argument, NULL, 20 },
232 { "no-host-lookup", no_argument, NULL, 22 },
233 { "no-parent", no_argument, NULL, 5 },
234 { "non-verbose", no_argument, NULL, 18 },
235 { "passive-ftp", no_argument, NULL, 11 },
236 { "page-requisites", no_argument, NULL, 'p' },
237 { "quiet", no_argument, NULL, 'q' },
238 { "recursive", no_argument, NULL, 'r' },
239 { "relative", no_argument, NULL, 'L' },
240 { "retr-symlinks", no_argument, NULL, 9 },
241 { "save-headers", no_argument, NULL, 's' },
242 { "server-response", no_argument, NULL, 'S' },
243 { "span-hosts", no_argument, NULL, 'H' },
244 { "spider", no_argument, NULL, 4 },
245 { "timestamping", no_argument, NULL, 'N' },
246 { "verbose", no_argument, NULL, 'v' },
247 { "version", no_argument, NULL, 'V' },
249 /* Options accepting an argument: */
250 { "accept", required_argument, NULL, 'A' },
251 { "append-output", required_argument, NULL, 'a' },
252 { "backups", required_argument, NULL, 23 }, /* undocumented */
253 { "base", required_argument, NULL, 'B' },
254 { "cache", required_argument, NULL, 'C' },
255 { "cut-dirs", required_argument, NULL, 17 },
256 { "delete-after", no_argument, NULL, 8 },
257 { "directory-prefix", required_argument, NULL, 'P' },
258 { "domains", required_argument, NULL, 'D' },
259 { "dot-style", required_argument, NULL, 6 },
260 { "execute", required_argument, NULL, 'e' },
261 { "exclude-directories", required_argument, NULL, 'X' },
262 { "exclude-domains", required_argument, NULL, 12 },
263 { "follow-tags", required_argument, NULL, 25 },
264 { "glob", required_argument, NULL, 'g' },
265 { "header", required_argument, NULL, 3 },
266 { "htmlify", required_argument, NULL, 7 },
267 { "http-passwd", required_argument, NULL, 2 },
268 { "http-user", required_argument, NULL, 1 },
269 { "ignore-tags", required_argument, NULL, 'G' },
270 { "include-directories", required_argument, NULL, 'I' },
271 { "input-file", required_argument, NULL, 'i' },
272 { "level", required_argument, NULL, 'l' },
273 { "no", required_argument, NULL, 'n' },
274 { "output-document", required_argument, NULL, 'O' },
275 { "output-file", required_argument, NULL, 'o' },
276 { "proxy", required_argument, NULL, 'Y' },
277 { "proxy-passwd", required_argument, NULL, 16 },
278 { "proxy-user", required_argument, NULL, 15 },
279 { "quota", required_argument, NULL, 'Q' },
280 { "reject", required_argument, NULL, 'R' },
281 { "timeout", required_argument, NULL, 'T' },
282 { "tries", required_argument, NULL, 't' },
283 { "user-agent", required_argument, NULL, 'U' },
284 { "referer", required_argument, NULL, 129 },
285 { "use-proxy", required_argument, NULL, 'Y' },
286 { "wait", required_argument, NULL, 'w' },
287 { "waitretry", required_argument, NULL, 24 },
295 /* Construct the name of the executable, without the directory part. */
296 exec_name = strrchr (argv[0], PATH_SEPARATOR);
303 windows_main_junk (&argc, (char **) argv, (char **) &exec_name);
306 initialize (); /* sets option defaults; reads the system.wgetrc and .wgetrc */
308 /* [Is the order of the option letters significant? If not, they should be
309 alphabetized, like the long_options. The only thing I know for sure is
310 that the options with required arguments must be followed by a ':'.
311 -- Dan Harkless <dan-wget@dilvish.speed.net>] */
312 while ((c = getopt_long (argc, argv, "\
313 hpVqvdkKsxmNWrHSLcFbEY:G:g:T:U:O:l:n:i:o:a:t:D:A:R:P:B:e:Q:X:I:w:",
314 long_options, (int *)0)) != EOF)
318 /* Options without arguments: */
320 setval ("spider", "on");
323 setval ("noparent", "on");
326 setval ("deleteafter", "on");
329 setval ("retrsymlinks", "on");
332 setval ("ignorelength", "on");
335 setval ("passiveftp", "on");
338 setval ("noclobber", "on");
341 setval ("followftp", "on");
344 setval ("cutdirs", optarg);
347 setval ("verbose", "off");
350 setval ("dirstruct", "off");
353 setval ("addhostdir", "off");
356 setval ("removelisting", "off");
359 setval ("simplehostcheck", "on");
362 setval ("background", "on");
365 setval ("continue", "on");
369 setval ("debug", "on");
370 #else /* not DEBUG */
371 fprintf (stderr, _("%s: debug support not compiled in.\n"),
373 #endif /* not DEBUG */
376 /* For debugging purposes. */
377 printf ("%s\n", ftp_getaddress ());
381 setval ("forcehtml", "on");
384 setval ("spanhosts", "on");
394 setval ("backupconverted", "on");
397 setval ("convertlinks", "on");
400 setval ("relativeonly", "on");
403 setval ("mirror", "on");
406 setval ("timestamping", "on");
409 setval ("pagerequisites", "on");
412 setval ("serverresponse", "on");
415 setval ("saveheaders", "on");
418 setval ("quiet", "on");
421 setval ("recursive", "on");
424 printf ("GNU Wget %s\n\n", version_string);
426 Copyright (C) 1995, 1996, 1997, 1998 Free Software Foundation, Inc.\n\
427 This program is distributed in the hope that it will be useful,\n\
428 but WITHOUT ANY WARRANTY; without even the implied warranty of\n\
429 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n\
430 GNU General Public License for more details.\n"));
431 printf (_("\nOriginally written by Hrvoje Niksic <hniksic@iskon.hr>.\n"));
435 setval ("verbose", "on");
438 setval ("dirstruct", "on");
441 /* Options accepting an argument: */
443 setval ("httpuser", optarg);
446 setval ("httppasswd", optarg);
449 setval ("header", optarg);
452 setval ("dotstyle", optarg);
455 setval ("htmlify", optarg);
458 setval ("excludedomains", optarg);
461 setval ("proxyuser", optarg);
464 setval ("proxypasswd", optarg);
467 setval ("backups", optarg);
470 setval ("waitretry", optarg);
474 setval ("followtags", optarg);
477 setval ("referer", optarg);
480 setval ("accept", optarg);
483 setval ("logfile", optarg);
487 setval ("base", optarg);
490 setval ("cache", optarg);
493 setval ("domains", optarg);
498 if (parse_line (optarg, &com, &val))
500 if (!setval (com, val))
505 fprintf (stderr, _("%s: %s: invalid command\n"), exec_name,
514 setval ("ignoretags", optarg);
517 setval ("glob", optarg);
520 setval ("includedirectories", optarg);
523 setval ("input", optarg);
526 setval ("reclevel", optarg);
530 /* #### The n? options are utter crock! */
533 for (p = optarg; *p; p++)
537 setval ("verbose", "off");
540 setval ("simplehostcheck", "on");
543 setval ("addhostdir", "off");
546 setval ("dirstruct", "off");
549 setval ("noclobber", "on");
552 setval ("removelisting", "off");
555 setval ("noparent", "on");
558 printf (_("%s: illegal option -- `-n%c'\n"), exec_name, *p);
561 printf (_("Try `%s --help\' for more options.\n"), exec_name);
567 setval ("outputdocument", optarg);
570 setval ("logfile", optarg);
573 setval ("dirprefix", optarg);
576 setval ("quota", optarg);
579 setval ("reject", optarg);
582 setval ("timeout", optarg);
585 setval ("tries", optarg);
588 setval ("useragent", optarg);
591 setval ("wait", optarg);
594 setval ("excludedirectories", optarg);
597 setval ("useproxy", optarg);
603 printf (_("Try `%s --help' for more options.\n"), exec_name);
609 /* All user options have now been processed, so it's now safe to do
610 interoption dependency checks. */
612 if (opt.reclevel == 0)
613 opt.reclevel = INFINITE_RECURSION; /* see wget.h for commentary on this */
615 if (opt.page_requisites && !opt.recursive)
617 opt.recursive = TRUE;
619 if (!opt.no_dirstruct)
620 opt.dirstruct = TRUE; /* usually handled by cmd_spec_recursive() */
623 if (opt.verbose == -1)
624 opt.verbose = !opt.quiet;
626 /* Retain compatibility with previous scripts.
627 if wait has been set, but waitretry has not, give it the wait value.
628 A simple check on the values is not enough, I could have set
629 wait to n>0 and waitretry to 0 - HEH */
632 char opt_wait_str[256]; /* bigger than needed buf to prevent overflow */
634 sprintf(opt_wait_str, "%ld", opt.wait);
635 setval ("waitretry", opt_wait_str);
639 if (opt.verbose && opt.quiet)
641 printf (_("Can't be verbose and quiet at the same time.\n"));
645 if (opt.timestamping && opt.noclobber)
648 Can't timestamp and not clobber old files at the same time.\n"));
652 nurl = argc - optind;
653 if (!nurl && !opt.input_filename)
655 /* No URL specified. */
656 printf (_("%s: missing URL\n"), exec_name);
659 /* #### Something nicer should be printed here -- similar to the
660 pre-1.5 `--help' page. */
661 printf (_("Try `%s --help' for more options.\n"), exec_name);
666 fork_to_background ();
668 /* Allocate basic pointer. */
669 url = ALLOCA_ARRAY (char *, nurl + 1);
670 /* Fill in the arguments. */
671 for (i = 0; i < nurl; i++, optind++)
673 char *irix4_cc_needs_this;
674 STRDUP_ALLOCA (irix4_cc_needs_this, argv[optind]);
675 url[i] = irix4_cc_needs_this;
679 /* Change the title of console window on Windows. #### I think this
680 statement should belong to retrieve_url(). --hniksic. */
682 ws_changetitle (*url, nurl);
685 /* Initialize logging. */
686 log_init (opt.lfilename, append_to_log);
688 DEBUGP (("DEBUG output created by Wget %s on %s.\n\n", version_string,
690 /* Open the output filename if necessary. */
691 if (opt.output_document)
693 if (HYPHENP (opt.output_document))
697 opt.dfp = fopen (opt.output_document, "wb");
700 perror (opt.output_document);
710 /* Setup the signal handler to redirect output when hangup is
713 if (signal(SIGHUP, SIG_IGN) != SIG_IGN)
714 signal(SIGHUP, redirect_output_signal);
715 /* ...and do the same for SIGUSR1. */
716 signal (SIGUSR1, redirect_output_signal);
717 /* Writing to a closed socket normally signals SIGPIPE, and the
718 process exits. What we want is to ignore SIGPIPE and just check
719 for the return value of write(). */
720 signal (SIGPIPE, SIG_IGN);
721 #endif /* HAVE_SIGNAL */
723 status = RETROK; /* initialize it, just-in-case */
725 /* Retrieve the URLs from argument list. */
726 for (t = url; *t; t++)
728 char *filename, *new_file;
731 status = retrieve_url (*t, &filename, &new_file, NULL, &dt);
732 if (opt.recursive && status == RETROK && (dt & TEXTHTML))
733 status = recursive_retrieve (filename, new_file ? new_file : *t);
734 FREE_MAYBE (new_file);
735 FREE_MAYBE (filename);
738 /* And then from the input file, if any. */
739 if (opt.input_filename)
742 status = retrieve_from_file (opt.input_filename, opt.force_html, &count);
744 logprintf (LOG_NOTQUIET, _("No URLs found in %s.\n"),
747 /* Print the downloaded sum. */
750 || (opt.input_filename && opt.downloaded != 0))
752 logprintf (LOG_NOTQUIET,
753 _("\nFINISHED --%s--\nDownloaded: %s bytes in %d files\n"),
754 time_str (NULL), legible (opt.downloaded), opt.numurls);
755 /* Print quota warning, if exceeded. */
756 if (opt.quota && opt.downloaded > opt.quota)
757 logprintf (LOG_NOTQUIET,
758 _("Download quota (%s bytes) EXCEEDED!\n"),
759 legible (opt.quota));
761 if (opt.convert_links)
763 convert_all_links ();
767 if (status == RETROK)
773 /* Hangup signal handler. When wget receives SIGHUP or SIGUSR1, it
774 will proceed operation as usual, trying to write into a log file.
775 If that is impossible, the output will be turned off. */
779 redirect_output_signal (int sig)
782 signal (sig, redirect_output_signal);
783 /* Please note that the double `%' in `%%s' is intentional, because
784 redirect_output passes tmp through printf. */
785 sprintf (tmp, _("%s received, redirecting output to `%%s'.\n"),
786 (sig == SIGHUP ? "SIGHUP" :
787 (sig == SIGUSR1 ? "SIGUSR1" :
789 redirect_output (tmp);
791 #endif /* HAVE_SIGNAL */