git.maemo.org Git - busybox4maemo/blob - util-linux/getopt.c

   1 /* vi: set sw=4 ts=4: */
   2 /*
   3  * getopt.c - Enhanced implementation of BSD getopt(1)
   4  *   Copyright (c) 1997, 1998, 1999, 2000  Frodo Looijaard <frodol@dds.nl>
   5  *
   6  * Licensed under GPLv2 or later, see file LICENSE in this tarball for details.
   7  */
   8
   9 /*
  10  * Version 1.0-b4: Tue Sep 23 1997. First public release.
  11  * Version 1.0: Wed Nov 19 1997.
  12  *   Bumped up the version number to 1.0
  13  *   Fixed minor typo (CSH instead of TCSH)
  14  * Version 1.0.1: Tue Jun 3 1998
  15  *   Fixed sizeof instead of strlen bug
  16  *   Bumped up the version number to 1.0.1
  17  * Version 1.0.2: Thu Jun 11 1998 (not present)
  18  *   Fixed gcc-2.8.1 warnings
  19  *   Fixed --version/-V option (not present)
  20  * Version 1.0.5: Tue Jun 22 1999
  21  *   Make -u option work (not present)
  22  * Version 1.0.6: Tue Jun 27 2000
  23  *   No important changes
  24  * Version 1.1.0: Tue Jun 30 2000
  25  *   Added NLS support (partly written by Arkadiusz Mickiewicz
  26  *     <misiek@misiek.eu.org>)
  27  * Ported to Busybox - Alfred M. Szmidt <ams@trillian.itslinux.org>
  28  *  Removed --version/-V and --help/-h in
  29  *  Removed parse_error(), using bb_error_msg() from Busybox instead
  30  *  Replaced our_malloc with xmalloc and our_realloc with xrealloc
  31  *
  32  */
  33
  34 #include <getopt.h>
  35 #include "libbb.h"
  36
  37 /* NON_OPT is the code that is returned when a non-option is found in '+'
  38    mode */
  39 enum {
  40         NON_OPT = 1,
  41 #if ENABLE_GETOPT_LONG
  42 /* LONG_OPT is the code that is returned when a long option is found. */
  43         LONG_OPT = 2
  44 #endif
  45 };
  46
  47 /* For finding activated option flags. Must match getopt32 call! */
  48 enum {
  49         OPT_o   = 0x1,  // -o
  50         OPT_n   = 0x2,  // -n
  51         OPT_q   = 0x4,  // -q
  52         OPT_Q   = 0x8,  // -Q
  53         OPT_s   = 0x10, // -s
  54         OPT_T   = 0x20, // -T
  55         OPT_u   = 0x40, // -u
  56 #if ENABLE_GETOPT_LONG
  57         OPT_a   = 0x80, // -a
  58         OPT_l   = 0x100, // -l
  59 #endif
  60         SHELL_IS_TCSH = 0x8000, /* hijack this bit for other purposes */
  61 };
  62
  63 /* 0 is getopt_long, 1 is getopt_long_only */
  64 #define alternative  (option_mask32 & OPT_a)
  65
  66 #define quiet_errors (option_mask32 & OPT_q)
  67 #define quiet_output (option_mask32 & OPT_Q)
  68 #define quote        (!(option_mask32 & OPT_u))
  69 #define shell_TCSH   (option_mask32 & SHELL_IS_TCSH)
  70
  71 /*
  72  * This function 'normalizes' a single argument: it puts single quotes around
  73  * it and escapes other special characters. If quote is false, it just
  74  * returns its argument.
  75  * Bash only needs special treatment for single quotes; tcsh also recognizes
  76  * exclamation marks within single quotes, and nukes whitespace.
  77  * This function returns a pointer to a buffer that is overwritten by
  78  * each call.
  79  */
  80 static const char *normalize(const char *arg)
  81 {
  82         char *bufptr;
  83 #if ENABLE_FEATURE_CLEAN_UP
  84         static char *BUFFER = NULL;
  85         free(BUFFER);
  86 #else
  87         char *BUFFER;
  88 #endif
  89
  90         if (!quote) { /* Just copy arg */
  91                 BUFFER = xstrdup(arg);
  92                 return BUFFER;
  93         }
  94
  95         /* Each character in arg may take up to four characters in the result:
  96            For a quote we need a closing quote, a backslash, a quote and an
  97            opening quote! We need also the global opening and closing quote,
  98            and one extra character for '\0'. */
  99         BUFFER = xmalloc(strlen(arg)*4 + 3);
 100
 101         bufptr = BUFFER;
 102         *bufptr ++= '\'';
 103
 104         while (*arg) {
 105                 if (*arg == '\'') {
 106                         /* Quote: replace it with: '\'' */
 107                         *bufptr ++= '\'';
 108                         *bufptr ++= '\\';
 109                         *bufptr ++= '\'';
 110                         *bufptr ++= '\'';
 111                 } else if (shell_TCSH && *arg == '!') {
 112                         /* Exclamation mark: replace it with: \! */
 113                         *bufptr ++= '\'';
 114                         *bufptr ++= '\\';
 115                         *bufptr ++= '!';
 116                         *bufptr ++= '\'';
 117                 } else if (shell_TCSH && *arg == '\n') {
 118                         /* Newline: replace it with: \n */
 119                         *bufptr ++= '\\';
 120                         *bufptr ++= 'n';
 121                 } else if (shell_TCSH && isspace(*arg)) {
 122                         /* Non-newline whitespace: replace it with \<ws> */
 123                         *bufptr ++= '\'';
 124                         *bufptr ++= '\\';
 125                         *bufptr ++= *arg;
 126                         *bufptr ++= '\'';
 127                 } else
 128                         /* Just copy */
 129                         *bufptr ++= *arg;
 130                 arg++;
 131         }
 132         *bufptr ++= '\'';
 133         *bufptr ++= '\0';
 134         return BUFFER;
 135 }
 136
 137 /*
 138  * Generate the output. argv[0] is the program name (used for reporting errors).
 139  * argv[1..] contains the options to be parsed. argc must be the number of
 140  * elements in argv (ie. 1 if there are no options, only the program name),
 141  * optstr must contain the short options, and longopts the long options.
 142  * Other settings are found in global variables.
 143  */
 144 #if !ENABLE_GETOPT_LONG
 145 #define generate_output(argv,argc,optstr,longopts) generate_output(argv,argc,optstr)
 146 #endif
 147 static int generate_output(char **argv, int argc, const char *optstr, const struct option *longopts)
 148 {
 149         int exit_code = 0; /* We assume everything will be OK */
 150         unsigned opt;
 151 #if ENABLE_GETOPT_LONG
 152         int longindex;
 153 #endif
 154         const char *charptr;
 155
 156         if (quiet_errors) /* No error reporting from getopt(3) */
 157                 opterr = 0;
 158
 159         /* Reset getopt(3) (see libbb/getopt32.c for long rant) */
 160 #ifdef __GLIBC__
 161         optind = 0;
 162 #else /* BSD style */
 163         optind = 1;
 164         /* optreset = 1; */
 165 #endif
 166
 167         while (1) {
 168                 opt =
 169 #if ENABLE_GETOPT_LONG
 170                         alternative ?
 171                         getopt_long_only(argc, argv, optstr, longopts, &longindex) :
 172                         getopt_long(argc, argv, optstr, longopts, &longindex);
 173 #else
 174                         getopt(argc, argv, optstr);
 175 #endif
 176                 if (opt == EOF)
 177                         break;
 178                 if (opt == '?' || opt == ':' )
 179                         exit_code = 1;
 180                 else if (!quiet_output) {
 181 #if ENABLE_GETOPT_LONG
 182                         if (opt == LONG_OPT) {
 183                                 printf(" --%s", longopts[longindex].name);
 184                                 if (longopts[longindex].has_arg)
 185                                         printf(" %s",
 186                                                 normalize(optarg ? optarg : ""));
 187                         } else
 188 #endif
 189                         if (opt == NON_OPT)
 190                                 printf(" %s", normalize(optarg));
 191                         else {
 192                                 printf(" -%c", opt);
 193                                 charptr = strchr(optstr,opt);
 194                                 if (charptr != NULL && *++charptr == ':')
 195                                         printf(" %s",
 196                                                 normalize(optarg ? optarg : ""));
 197                         }
 198                 }
 199         }
 200
 201         if (!quiet_output) {
 202                 printf(" --");
 203                 while (optind < argc)
 204                         printf(" %s", normalize(argv[optind++]));
 205                 bb_putchar('\n');
 206         }
 207         return exit_code;
 208 }
 209
 210 #if ENABLE_GETOPT_LONG
 211 /*
 212  * Register several long options. options is a string of long options,
 213  * separated by commas or whitespace.
 214  * This nukes options!
 215  */
 216 static struct option *add_long_options(struct option *long_options, char *options)
 217 {
 218         int long_nr = 0;
 219         int arg_opt, tlen;
 220         char *tokptr = strtok(options, ", \t\n");
 221
 222         if (long_options)
 223                 while (long_options[long_nr].name)
 224                         long_nr++;
 225
 226         while (tokptr) {
 227                 arg_opt = no_argument;
 228                 tlen = strlen(tokptr);
 229                 if (tlen) {
 230                         tlen--;
 231                         if (tokptr[tlen] == ':') {
 232                                 arg_opt = required_argument;
 233                                 if (tlen && tokptr[tlen-1] == ':') {
 234                                         tlen--;
 235                                         arg_opt = optional_argument;
 236                                 }
 237                                 tokptr[tlen] = '\0';
 238                                 if (tlen == 0)
 239                                         bb_error_msg_and_die("empty long option specified");
 240                         }
 241                         long_options = xrealloc(long_options,
 242                                         sizeof(long_options[0]) * (long_nr+2));
 243                         long_options[long_nr].has_arg = arg_opt;
 244                         long_options[long_nr].flag = NULL;
 245                         long_options[long_nr].val = LONG_OPT;
 246                         long_options[long_nr].name = xstrdup(tokptr);
 247                         long_nr++;
 248                         memset(&long_options[long_nr], 0, sizeof(long_options[0]));
 249                 }
 250                 tokptr = strtok(NULL, ", \t\n");
 251         }
 252         return long_options;
 253 }
 254 #endif
 255
 256 static void set_shell(const char *new_shell)
 257 {
 258         if (!strcmp(new_shell,"bash") || !strcmp(new_shell,"sh"))
 259                 return;
 260         if (!strcmp(new_shell,"tcsh") || !strcmp(new_shell,"csh"))
 261                 option_mask32 |= SHELL_IS_TCSH;
 262         else
 263                 bb_error_msg("unknown shell '%s', assuming bash", new_shell);
 264 }
 265
 266
 267 /* Exit codes:
 268  *   0) No errors, successful operation.
 269  *   1) getopt(3) returned an error.
 270  *   2) A problem with parameter parsing for getopt(1).
 271  *   3) Internal error, out of memory
 272  *   4) Returned for -T
 273  */
 274
 275 #if ENABLE_GETOPT_LONG
 276 static const char getopt_longopts[] ALIGN1 =
 277         "options\0"      Required_argument "o"
 278         "longoptions\0"  Required_argument "l"
 279         "quiet\0"        No_argument       "q"
 280         "quiet-output\0" No_argument       "Q"
 281         "shell\0"        Required_argument "s"
 282         "test\0"         No_argument       "T"
 283         "unquoted\0"     No_argument       "u"
 284         "alternative\0"  No_argument       "a"
 285         "name\0"         Required_argument "n"
 286         ;
 287 #endif
 288
 289 int getopt_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 290 int getopt_main(int argc, char **argv)
 291 {
 292         char *optstr = NULL;
 293         char *name = NULL;
 294         unsigned opt;
 295         const char *compatible;
 296         char *s_arg;
 297 #if ENABLE_GETOPT_LONG
 298         struct option *long_options = NULL;
 299         llist_t *l_arg = NULL;
 300 #endif
 301
 302         compatible = getenv("GETOPT_COMPATIBLE"); /* used as yes/no flag */
 303
 304         if (argc == 1) {
 305                 if (compatible) {
 306                         /* For some reason, the original getopt gave no error
 307                            when there were no arguments. */
 308                         printf(" --\n");
 309                         return 0;
 310                 }
 311                 bb_error_msg_and_die("missing optstring argument");
 312         }
 313
 314         if (argv[1][0] != '-' || compatible) {
 315                 char *s;
 316
 317                 option_mask32 |= OPT_u; /* quoting off */
 318                 s = xstrdup(argv[1] + strspn(argv[1], "-+"));
 319                 argv[1] = argv[0];
 320                 return generate_output(argv+1, argc-1, s, long_options);
 321         }
 322
 323 #if !ENABLE_GETOPT_LONG
 324         opt = getopt32(argv, "+o:n:qQs:Tu", &optstr, &name, &s_arg);
 325 #else
 326         applet_long_options = getopt_longopts;
 327         opt_complementary = "l::";
 328         opt = getopt32(argv, "+o:n:qQs:Tual:",
 329                                         &optstr, &name, &s_arg, &l_arg);
 330         /* Effectuate the read options for the applet itself */
 331         while (l_arg) {
 332                 long_options = add_long_options(long_options, l_arg->data);
 333                 l_arg = l_arg->link;
 334         }
 335 #endif
 336
 337         if (opt & OPT_s) {
 338                 set_shell(s_arg);
 339         }
 340
 341         if (opt & OPT_T) {
 342                 return 4;
 343         }
 344
 345         /* All options controlling the applet have now been parsed */
 346         if (!optstr) {
 347                 if (optind >= argc)
 348                         bb_error_msg_and_die("missing optstring argument");
 349                 optstr = argv[optind++];
 350         }
 351
 352         argv[optind-1] = name ? name : argv[0];
 353         return generate_output(argv+optind-1, argc-optind+1, optstr, long_options);
 354 }