1 ///////////////////////////////////////////////////////////////////////////////
4 /// \brief Argument parsing
6 /// \note Filter-specific options parsing is in options.c.
8 // Author: Lasse Collin
10 // This file has been put into the public domain.
11 // You can do whatever you want with this file.
13 ///////////////////////////////////////////////////////////////////////////////
21 bool opt_stdout = false;
22 bool opt_force = false;
23 bool opt_keep_original = false;
25 // We don't modify or free() this, but we need to assign it in some
26 // non-const pointers.
27 const char *stdin_filename = "(stdin)";
31 parse_real(args_info *args, int argc, char **argv)
34 OPT_SUBBLOCK = INT_MIN,
49 static const char short_opts[] = "cC:defF:hHlkM:qrS:tT:vVz0123456789";
51 static const struct option long_opts[] = {
53 { "compress", no_argument, NULL, 'z' },
54 { "decompress", no_argument, NULL, 'd' },
55 { "uncompress", no_argument, NULL, 'd' },
56 { "test", no_argument, NULL, 't' },
57 { "list", no_argument, NULL, 'l' },
58 { "info", no_argument, NULL, 'l' },
60 // Operation modifiers
61 { "keep", no_argument, NULL, 'k' },
62 { "force", no_argument, NULL, 'f' },
63 { "stdout", no_argument, NULL, 'c' },
64 { "to-stdout", no_argument, NULL, 'c' },
65 { "suffix", required_argument, NULL, 'S' },
66 // { "recursive", no_argument, NULL, 'r' }, // TODO
67 { "files", optional_argument, NULL, OPT_FILES },
68 { "files0", optional_argument, NULL, OPT_FILES0 },
70 // Basic compression settings
71 { "format", required_argument, NULL, 'F' },
72 { "check", required_argument, NULL, 'C' },
73 { "memory", required_argument, NULL, 'M' },
74 { "threads", required_argument, NULL, 'T' },
76 { "extreme", no_argument, NULL, 'e' },
77 { "fast", no_argument, NULL, '0' },
78 { "best", no_argument, NULL, '9' },
81 { "lzma1", optional_argument, NULL, OPT_LZMA1 },
82 { "lzma2", optional_argument, NULL, OPT_LZMA2 },
83 { "x86", no_argument, NULL, OPT_X86 },
84 { "bcj", no_argument, NULL, OPT_X86 },
85 { "powerpc", no_argument, NULL, OPT_POWERPC },
86 { "ppc", no_argument, NULL, OPT_POWERPC },
87 { "ia64", no_argument, NULL, OPT_IA64 },
88 { "itanium", no_argument, NULL, OPT_IA64 },
89 { "arm", no_argument, NULL, OPT_ARM },
90 { "armthumb", no_argument, NULL, OPT_ARMTHUMB },
91 { "sparc", no_argument, NULL, OPT_SPARC },
92 { "delta", optional_argument, NULL, OPT_DELTA },
93 { "subblock", optional_argument, NULL, OPT_SUBBLOCK },
96 { "quiet", no_argument, NULL, 'q' },
97 { "verbose", no_argument, NULL, 'v' },
98 { "help", no_argument, NULL, 'h' },
99 { "long-help", no_argument, NULL, 'H' },
100 { "version", no_argument, NULL, 'V' },
107 while ((c = getopt_long(argc, argv, short_opts, long_opts, NULL))
110 // Compression preset (also for decompression if --format=raw)
111 case '0': case '1': case '2': case '3': case '4':
112 case '5': case '6': case '7': case '8': case '9':
113 coder_set_preset(c - '0');
118 // Support specifying the limit as a percentage of
119 // installed physical RAM.
120 size_t len = strlen(optarg);
121 if (len > 0 && optarg[len - 1] == '%') {
122 optarg[len - 1] = '\0';
123 hardware_memlimit_set_percentage(
125 "memory%", optarg, 1, 100));
127 // On 32-bit systems, SIZE_MAX would make more
128 // sense than UINT64_MAX. But use UINT64_MAX
129 // still so that scripts that assume > 4 GiB
130 // values don't break.
131 hardware_memlimit_set(str_to_uint64(
145 hardware_threadlimit_set(str_to_uint64(
146 "threads", optarg, 0, UINT32_MAX));
151 // This doesn't return.
161 opt_mode = MODE_DECOMPRESS;
176 // This doesn't return.
181 // This doesn't return.
186 opt_mode = MODE_LIST;
191 opt_keep_original = true;
196 message_verbosity_decrease();
200 opt_mode = MODE_TEST;
205 message_verbosity_increase();
209 opt_mode = MODE_COMPRESS;
215 coder_add_filter(LZMA_FILTER_SUBBLOCK,
216 options_subblock(optarg));
220 coder_add_filter(LZMA_FILTER_X86, NULL);
224 coder_add_filter(LZMA_FILTER_POWERPC, NULL);
228 coder_add_filter(LZMA_FILTER_IA64, NULL);
232 coder_add_filter(LZMA_FILTER_ARM, NULL);
236 coder_add_filter(LZMA_FILTER_ARMTHUMB, NULL);
240 coder_add_filter(LZMA_FILTER_SPARC, NULL);
244 coder_add_filter(LZMA_FILTER_DELTA,
245 options_delta(optarg));
249 coder_add_filter(LZMA_FILTER_LZMA1,
250 options_lzma(optarg));
254 coder_add_filter(LZMA_FILTER_LZMA2,
255 options_lzma(optarg));
262 // Just in case, support both "lzma" and "alone" since
263 // the latter was used for forward compatibility in
264 // LZMA Utils 4.32.x.
265 static const struct {
267 enum format_type format;
269 { "auto", FORMAT_AUTO },
271 { "lzma", FORMAT_LZMA },
272 { "alone", FORMAT_LZMA },
273 // { "gzip", FORMAT_GZIP },
274 // { "gz", FORMAT_GZIP },
275 { "raw", FORMAT_RAW },
279 while (strcmp(types[i].str, optarg) != 0)
280 if (++i == ARRAY_SIZE(types))
281 message_fatal(_("%s: Unknown file "
285 opt_format = types[i].format;
291 static const struct {
295 { "none", LZMA_CHECK_NONE },
296 { "crc32", LZMA_CHECK_CRC32 },
297 { "crc64", LZMA_CHECK_CRC64 },
298 { "sha256", LZMA_CHECK_SHA256 },
302 while (strcmp(types[i].str, optarg) != 0) {
303 if (++i == ARRAY_SIZE(types))
304 message_fatal(_("%s: Unsupported "
306 "check type"), optarg);
309 // Use a separate check in case we are using different
310 // liblzma than what was used to compile us.
311 if (!lzma_check_is_supported(types[i].check))
312 message_fatal(_("%s: Unsupported integrity "
313 "check type"), optarg);
315 coder_set_check(types[i].check);
320 args->files_delim = '\n';
325 if (args->files_name != NULL)
326 message_fatal(_("Only one file can be "
327 "specified with `--files'"
330 if (optarg == NULL) {
331 args->files_name = (char *)stdin_filename;
332 args->files_file = stdin;
334 args->files_name = optarg;
335 args->files_file = fopen(optarg,
336 c == OPT_FILES ? "r" : "rb");
337 if (args->files_file == NULL)
338 message_fatal("%s: %s", optarg,
355 parse_environment(args_info *args, char *argv0)
357 char *env = getenv("XZ_OPT");
361 // We modify the string, so make a copy of it.
364 // Calculate the number of arguments in env. argc stats at one
365 // to include space for the program name.
367 bool prev_was_space = true;
368 for (size_t i = 0; env[i] != '\0'; ++i) {
369 if (isspace(env[i])) {
370 prev_was_space = true;
371 } else if (prev_was_space) {
372 prev_was_space = false;
374 // Keep argc small enough to fit into a singed int
375 // and to keep it usable for memory allocation.
376 if (++argc == MIN(INT_MAX, SIZE_MAX / sizeof(char *)))
377 message_fatal(_("The environment variable "
378 "XZ_OPT contains too many "
383 // Allocate memory to hold pointers to the arguments. Add one to get
384 // space for the terminating NULL (if some systems happen to need it).
385 char **argv = xmalloc(((size_t)(argc) + 1) * sizeof(char *));
389 // Go through the string again. Split the arguments using '\0'
390 // characters and add pointers to the resulting strings to argv.
392 prev_was_space = true;
393 for (size_t i = 0; env[i] != '\0'; ++i) {
394 if (isspace(env[i])) {
395 prev_was_space = true;
397 } else if (prev_was_space) {
398 prev_was_space = false;
399 argv[argc++] = env + i;
403 // Parse the argument list we got from the environment. All non-option
404 // arguments i.e. filenames are ignored.
405 parse_real(args, argc, argv);
407 // Reset the state of the getopt_long() so that we can parse the
408 // command line options too. There are two incompatible ways to
419 // We don't need the argument list from environment anymore.
428 args_parse(args_info *args, int argc, char **argv)
430 // Initialize those parts of *args that we need later.
431 args->files_name = NULL;
432 args->files_file = NULL;
433 args->files_delim = '\0';
435 // Type of the file format to use when --format=auto or no --format
437 enum format_type format_compress_auto = FORMAT_XZ;
439 // Check how we were called.
442 // We adjusted argv[0] in the beginning of main() so we don't
443 // need to do anything here.
444 const char *name = argv[0];
446 // Remove the leading path name, if any.
447 const char *name = strrchr(argv[0], '/');
454 // NOTE: It's possible that name[0] is now '\0' if argv[0]
455 // is weird, but it doesn't matter here.
457 // The default file format is .lzma if the command name
459 if (strstr(name, "lz") != NULL)
460 format_compress_auto = FORMAT_LZMA;
463 if (strstr(name, "cat") != NULL) {
464 // Imply --decompress --stdout
465 opt_mode = MODE_DECOMPRESS;
467 } else if (strstr(name, "un") != NULL) {
468 // Imply --decompress
469 opt_mode = MODE_DECOMPRESS;
473 // First the flags from environment
474 parse_environment(args, argv[0]);
476 // Then from the command line
478 parse_real(args, argc, argv);
480 // Never remove the source file when the destination is not on disk.
481 // In test mode the data is written nowhere, but setting opt_stdout
482 // will make the rest of the code behave well.
483 if (opt_stdout || opt_mode == MODE_TEST) {
484 opt_keep_original = true;
488 // If no --format flag was used, or it was --format=auto, we need to
489 // decide what is the target file format we are going to use. This
490 // depends on how we were called (checked earlier in this function).
491 if (opt_mode == MODE_COMPRESS && opt_format == FORMAT_AUTO)
492 opt_format = format_compress_auto;
494 // Compression settings need to be validated (options themselves and
495 // their memory usage) when compressing to any file format. It has to
496 // be done also when uncompressing raw data, since for raw decoding
497 // the options given on the command line are used to know what kind
498 // of raw data we are supposed to decode.
499 if (opt_mode == MODE_COMPRESS || opt_format == FORMAT_RAW)
500 coder_set_compression_settings();
502 // If no filenames are given, use stdin.
503 if (argv[optind] == NULL && args->files_name == NULL) {
504 // We don't modify or free() the "-" constant. The caller
505 // modifies this so don't make the struct itself const.
506 static char *names_stdin[2] = { (char *)"-", NULL };
507 args->arg_names = names_stdin;
510 // We got at least one filename from the command line, or
511 // --files or --files0 was specified.
512 args->arg_names = argv + optind;
513 args->arg_count = argc - optind;