xref: /freebsd/contrib/file/src/file_opts.h (revision a812392203d7c4c3f0db9d8a0f3391374c49c71f)
1 /*
2  * Table of command-line options
3  *
4  * The first column specifies the short name, if any, or 0 if none.
5  * The second column specifies the long name.
6  * The third column specifies whether it takes a parameter.
7  * The fourth column is the documentation.
8  *
9  * N.B. The long options' order must correspond to the code in file.c,
10  * and OPTSTRING must be kept up-to-date with the short options.
11  * Pay particular attention to the numbers of long-only options in the
12  * switch statement!
13  */
14 
15 OPT_LONGONLY("help", 0, "                 display this help and exit\n")
16 OPT('v', "version", 0, "              output version information and exit\n")
17 OPT('m', "magic-file", 1, " LIST      use LIST as a colon-separated list of magic\n"
18     "                               number files\n")
19 OPT('z', "uncompress", 0, "           try to look inside compressed files\n")
20 OPT('b', "brief", 0, "                do not prepend filenames to output lines\n")
21 OPT('c', "checking-printout", 0, "    print the parsed form of the magic file, use in\n"
22     "                               conjunction with -m to debug a new magic file\n"
23     "                               before installing it\n")
24 OPT('e', "exclude", 1, " TEST         exclude TEST from the list of test to be\n"
25     "                               performed for file. Valid tests are:\n"
26     "                               %o\n")
27 OPT('f', "files-from", 1, " FILE      read the filenames to be examined from FILE\n")
28 OPT('F', "separator", 1, " STRING     use string as separator instead of `:'\n")
29 OPT('i', "mime", 0, "                 output MIME type strings (--mime-type and\n"
30     "                               --mime-encoding)\n")
31 OPT_LONGONLY("apple", 0, "                output the Apple CREATOR/TYPE\n")
32 OPT_LONGONLY("mime-type", 0, "            output the MIME type\n")
33 OPT_LONGONLY("mime-encoding", 0, "        output the MIME encoding\n")
34 OPT('k', "keep-going", 0, "           don't stop at the first match\n")
35 OPT('l', "list", 0, "                 list magic strength\n")
36 #ifdef S_IFLNK
37 OPT('L', "dereference", 0, "          follow symlinks (default)\n")
38 OPT('h', "no-dereference", 0, "       don't follow symlinks\n")
39 #endif
40 OPT('n', "no-buffer", 0, "            do not buffer output\n")
41 OPT('N', "no-pad", 0, "               do not pad output\n")
42 OPT('0', "print0", 0, "               terminate filenames with ASCII NUL\n")
43 #if defined(HAVE_UTIME) || defined(HAVE_UTIMES)
44 OPT('p', "preserve-date", 0, "        preserve access times on files\n")
45 #endif
46 OPT('P', "parameter", 0, "            set file engine parameter limits\n"
47     "                               indir        15 recursion limit for indirection\n"
48     "                               name         30 use limit for name/use magic\n"
49     "                               elf_notes   256 max ELF notes processed\n"
50     "                               elf_phnum   128 max ELF prog sections processed\n"
51     "                               elf_shnum 32768 max ELF sections processed\n")
52 OPT('r', "raw", 0, "                  don't translate unprintable chars to \\ooo\n")
53 OPT('s', "special-files", 0, "        treat special (block/char devices) files as\n"
54     "                             ordinary ones\n")
55 OPT('C', "compile", 0, "              compile file specified by -m\n")
56 OPT('d', "debug", 0, "                print debugging messages\n")
57