Home | History | Annotate | Download | only in lib
      1 /* Getopt for GNU.
      2    NOTE: getopt is now part of the C library, so if you don't know what
      3    "Keep this file name-space clean" means, talk to drepper (at) gnu.org
      4    before changing it!
      5 
      6    Copyright (C) 1987, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98
      7    	Free Software Foundation, Inc.
      8 
      9    NOTE: The canonical source of this file is maintained with the GNU C Library.
     10    Bugs can be reported to bug-glibc (at) gnu.org.
     11 
     12    This program is free software; you can redistribute it and/or modify it
     13    under the terms of the GNU General Public License as published by the
     14    Free Software Foundation; either version 2, or (at your option) any
     15    later version.
     16 
     17    This program is distributed in the hope that it will be useful,
     18    but WITHOUT ANY WARRANTY; without even the implied warranty of
     19    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     20    GNU General Public License for more details.
     21 
     22    You should have received a copy of the GNU General Public License
     23    along with this program; if not, write to the Free Software
     24    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
     25    USA.  */
     26 
     27 /* This tells Alpha OSF/1 not to define a getopt prototype in <stdio.h>.
     29    Ditto for AIX 3.2 and <stdlib.h>.  */
     30 #ifndef _NO_PROTO
     31 # define _NO_PROTO
     32 #endif
     33 
     34 #ifdef HAVE_CONFIG_H
     35 # include <config.h>
     36 #endif
     37 
     38 #if !defined __STDC__ || !__STDC__
     39 /* This is a separate conditional since some stdc systems
     40    reject `defined (const)'.  */
     41 # ifndef const
     42 #  define const
     43 # endif
     44 #endif
     45 
     46 #include <stdio.h>
     47 
     48 /* Comment out all this code if we are using the GNU C Library, and are not
     49    actually compiling the library itself.  This code is part of the GNU C
     50    Library, but also included in many other GNU distributions.  Compiling
     51    and linking in this code is a waste when using the GNU C library
     52    (especially if it is a shared library).  Rather than having every GNU
     53    program understand `configure --with-gnu-libc' and omit the object files,
     54    it is simpler to just do this in the source for each such file.  */
     55 
     56 #define GETOPT_INTERFACE_VERSION 2
     57 #if !defined _LIBC && defined __GLIBC__ && __GLIBC__ >= 2
     58 # include <gnu-versions.h>
     59 # if _GNU_GETOPT_INTERFACE_VERSION == GETOPT_INTERFACE_VERSION
     60 #  define ELIDE_CODE
     61 # endif
     62 #endif
     63 
     64 #ifndef ELIDE_CODE
     65 
     66 
     67 /* This needs to come after some library #include
     68    to get __GNU_LIBRARY__ defined.  */
     69 #ifdef	__GNU_LIBRARY__
     70 /* Don't include stdlib.h for non-GNU C libraries because some of them
     71    contain conflicting prototypes for getopt.  */
     72 # include <stdlib.h>
     73 # include <unistd.h>
     74 #endif	/* GNU C library.  */
     75 
     76 #ifdef VMS
     77 # include <unixlib.h>
     78 # if HAVE_STRING_H - 0
     79 #  include <string.h>
     80 # endif
     81 #endif
     82 
     83 #ifndef _
     84 /* This is for other GNU distributions with internationalized messages.
     85    When compiling libc, the _ macro is predefined.  */
     86 # ifdef HAVE_LIBINTL_H
     87 #  include <libintl.h>
     88 #  define _(msgid)	gettext (msgid)
     89 # else
     90 #  define _(msgid)	(msgid)
     91 # endif
     92 #endif
     93 
     94 /* This version of `getopt' appears to the caller like standard Unix `getopt'
     95    but it behaves differently for the user, since it allows the user
     96    to intersperse the options with the other arguments.
     97 
     98    As `getopt' works, it permutes the elements of ARGV so that,
     99    when it is done, all the options precede everything else.  Thus
    100    all application programs are extended to handle flexible argument order.
    101 
    102    Setting the environment variable POSIXLY_CORRECT disables permutation.
    103    Then the behavior is completely standard.
    104 
    105    GNU application programs can use a third alternative mode in which
    106    they can distinguish the relative order of options and other arguments.  */
    107 
    108 #include "getopt.h"
    109 
    110 /* For communication from `getopt' to the caller.
    111    When `getopt' finds an option that takes an argument,
    112    the argument value is returned here.
    113    Also, when `ordering' is RETURN_IN_ORDER,
    114    each non-option ARGV-element is returned here.  */
    115 
    116 char *optarg = NULL;
    117 
    118 /* Index in ARGV of the next element to be scanned.
    119    This is used for communication to and from the caller
    120    and for communication between successive calls to `getopt'.
    121 
    122    On entry to `getopt', zero means this is the first call; initialize.
    123 
    124    When `getopt' returns -1, this is the index of the first of the
    125    non-option elements that the caller should itself scan.
    126 
    127    Otherwise, `optind' communicates from one call to the next
    128    how much of ARGV has been scanned so far.  */
    129 
    130 /* 1003.2 says this must be 1 before any call.  */
    131 int optind = 1;
    132 
    133 /* Formerly, initialization of getopt depended on optind==0, which
    134    causes problems with re-calling getopt as programs generally don't
    135    know that. */
    136 
    137 int __getopt_initialized = 0;
    138 
    139 /* The next char to be scanned in the option-element
    140    in which the last option character we returned was found.
    141    This allows us to pick up the scan where we left off.
    142 
    143    If this is zero, or a null string, it means resume the scan
    144    by advancing to the next ARGV-element.  */
    145 
    146 static char *nextchar;
    147 
    148 /* Callers store zero here to inhibit the error message
    149    for unrecognized options.  */
    150 
    151 int opterr = 1;
    152 
    153 /* Set to an option character which was unrecognized.
    154    This must be initialized on some systems to avoid linking in the
    155    system's own getopt implementation.  */
    156 
    157 int optopt = '?';
    158 
    159 /* Describe how to deal with options that follow non-option ARGV-elements.
    160 
    161    If the caller did not specify anything,
    162    the default is REQUIRE_ORDER if the environment variable
    163    POSIXLY_CORRECT is defined, PERMUTE otherwise.
    164 
    165    REQUIRE_ORDER means don't recognize them as options;
    166    stop option processing when the first non-option is seen.
    167    This is what Unix does.
    168    This mode of operation is selected by either setting the environment
    169    variable POSIXLY_CORRECT, or using `+' as the first character
    170    of the list of option characters.
    171 
    172    PERMUTE is the default.  We permute the contents of ARGV as we scan,
    173    so that eventually all the non-options are at the end.  This allows options
    174    to be given in any order, even with programs that were not written to
    175    expect this.
    176 
    177    RETURN_IN_ORDER is an option available to programs that were written
    178    to expect options and other ARGV-elements in any order and that care about
    179    the ordering of the two.  We describe each non-option ARGV-element
    180    as if it were the argument of an option with character code 1.
    181    Using `-' as the first character of the list of option characters
    182    selects this mode of operation.
    183 
    184    The special argument `--' forces an end of option-scanning regardless
    185    of the value of `ordering'.  In the case of RETURN_IN_ORDER, only
    186    `--' can cause `getopt' to return -1 with `optind' != ARGC.  */
    187 
    188 static enum
    189 {
    190   REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER
    191 } ordering;
    192 
    193 /* Value of POSIXLY_CORRECT environment variable.  */
    194 static char *posixly_correct;
    195 
    196 #ifdef	__GNU_LIBRARY__
    198 /* We want to avoid inclusion of string.h with non-GNU libraries
    199    because there are many ways it can cause trouble.
    200    On some systems, it contains special magic macros that don't work
    201    in GCC.  */
    202 # include <string.h>
    203 # define my_index	strchr
    204 #else
    205 
    206 # if HAVE_STRING_H
    207 #  include <string.h>
    208 # else
    209 #  include <strings.h>
    210 # endif
    211 
    212 /* Avoid depending on library functions or files
    213    whose names are inconsistent.  */
    214 
    215 #ifndef getenv
    216 extern char *getenv ();
    217 #endif
    218 
    219 static char *
    220 my_index (str, chr)
    221      const char *str;
    222      int chr;
    223 {
    224   while (*str)
    225     {
    226       if (*str == chr)
    227 	return (char *) str;
    228       str++;
    229     }
    230   return 0;
    231 }
    232 
    233 /* If using GCC, we can safely declare strlen this way.
    234    If not using GCC, it is ok not to declare it.  */
    235 #ifdef __GNUC__
    236 /* Note that Motorola Delta 68k R3V7 comes with GCC but not stddef.h.
    237    That was relevant to code that was here before.  */
    238 # if (!defined __STDC__ || !__STDC__) && !defined strlen
    239 /* gcc with -traditional declares the built-in strlen to return int,
    240    and has done so at least since version 2.4.5. -- rms.  */
    241 extern int strlen (const char *);
    242 # endif /* not __STDC__ */
    243 #endif /* __GNUC__ */
    244 
    245 #endif /* not __GNU_LIBRARY__ */
    246 
    247 /* Handle permutation of arguments.  */
    249 
    250 /* Describe the part of ARGV that contains non-options that have
    251    been skipped.  `first_nonopt' is the index in ARGV of the first of them;
    252    `last_nonopt' is the index after the last of them.  */
    253 
    254 static int first_nonopt;
    255 static int last_nonopt;
    256 
    257 #ifdef _LIBC
    258 /* Bash 2.0 gives us an environment variable containing flags
    259    indicating ARGV elements that should not be considered arguments.  */
    260 
    261 /* Defined in getopt_init.c  */
    262 extern char *__getopt_nonoption_flags;
    263 
    264 static int nonoption_flags_max_len;
    265 static int nonoption_flags_len;
    266 
    267 static int original_argc;
    268 static char *const *original_argv;
    269 
    270 /* Make sure the environment variable bash 2.0 puts in the environment
    271    is valid for the getopt call we must make sure that the ARGV passed
    272    to getopt is that one passed to the process.  */
    273 static void
    274 __attribute__ ((unused))
    275 store_args_and_env (int argc, char *const *argv)
    276 {
    277   /* XXX This is no good solution.  We should rather copy the args so
    278      that we can compare them later.  But we must not use malloc(3).  */
    279   original_argc = argc;
    280   original_argv = argv;
    281 }
    282 # ifdef text_set_element
    283 text_set_element (__libc_subinit, store_args_and_env);
    284 # endif /* text_set_element */
    285 
    286 # define SWAP_FLAGS(ch1, ch2) \
    287   if (nonoption_flags_len > 0)						      \
    288     {									      \
    289       char __tmp = __getopt_nonoption_flags[ch1];			      \
    290       __getopt_nonoption_flags[ch1] = __getopt_nonoption_flags[ch2];	      \
    291       __getopt_nonoption_flags[ch2] = __tmp;				      \
    292     }
    293 #else	/* !_LIBC */
    294 # define SWAP_FLAGS(ch1, ch2)
    295 #endif	/* _LIBC */
    296 
    297 /* Exchange two adjacent subsequences of ARGV.
    298    One subsequence is elements [first_nonopt,last_nonopt)
    299    which contains all the non-options that have been skipped so far.
    300    The other is elements [last_nonopt,optind), which contains all
    301    the options processed since those non-options were skipped.
    302 
    303    `first_nonopt' and `last_nonopt' are relocated so that they describe
    304    the new indices of the non-options in ARGV after they are moved.  */
    305 
    306 #if defined __STDC__ && __STDC__
    307 static void exchange (char **);
    308 #endif
    309 
    310 static void
    311 exchange (argv)
    312      char **argv;
    313 {
    314   int bottom = first_nonopt;
    315   int middle = last_nonopt;
    316   int top = optind;
    317   char *tem;
    318 
    319   /* Exchange the shorter segment with the far end of the longer segment.
    320      That puts the shorter segment into the right place.
    321      It leaves the longer segment in the right place overall,
    322      but it consists of two parts that need to be swapped next.  */
    323 
    324 #ifdef _LIBC
    325   /* First make sure the handling of the `__getopt_nonoption_flags'
    326      string can work normally.  Our top argument must be in the range
    327      of the string.  */
    328   if (nonoption_flags_len > 0 && top >= nonoption_flags_max_len)
    329     {
    330       /* We must extend the array.  The user plays games with us and
    331 	 presents new arguments.  */
    332       char *new_str = malloc (top + 1);
    333       if (new_str == NULL)
    334 	nonoption_flags_len = nonoption_flags_max_len = 0;
    335       else
    336 	{
    337 	  memset (__mempcpy (new_str, __getopt_nonoption_flags,
    338 			     nonoption_flags_max_len),
    339 		  '\0', top + 1 - nonoption_flags_max_len);
    340 	  nonoption_flags_max_len = top + 1;
    341 	  __getopt_nonoption_flags = new_str;
    342 	}
    343     }
    344 #endif
    345 
    346   while (top > middle && middle > bottom)
    347     {
    348       if (top - middle > middle - bottom)
    349 	{
    350 	  /* Bottom segment is the short one.  */
    351 	  int len = middle - bottom;
    352 	  register int i;
    353 
    354 	  /* Swap it with the top part of the top segment.  */
    355 	  for (i = 0; i < len; i++)
    356 	    {
    357 	      tem = argv[bottom + i];
    358 	      argv[bottom + i] = argv[top - (middle - bottom) + i];
    359 	      argv[top - (middle - bottom) + i] = tem;
    360 	      SWAP_FLAGS (bottom + i, top - (middle - bottom) + i);
    361 	    }
    362 	  /* Exclude the moved bottom segment from further swapping.  */
    363 	  top -= len;
    364 	}
    365       else
    366 	{
    367 	  /* Top segment is the short one.  */
    368 	  int len = top - middle;
    369 	  register int i;
    370 
    371 	  /* Swap it with the bottom part of the bottom segment.  */
    372 	  for (i = 0; i < len; i++)
    373 	    {
    374 	      tem = argv[bottom + i];
    375 	      argv[bottom + i] = argv[middle + i];
    376 	      argv[middle + i] = tem;
    377 	      SWAP_FLAGS (bottom + i, middle + i);
    378 	    }
    379 	  /* Exclude the moved top segment from further swapping.  */
    380 	  bottom += len;
    381 	}
    382     }
    383 
    384   /* Update records for the slots the non-options now occupy.  */
    385 
    386   first_nonopt += (optind - last_nonopt);
    387   last_nonopt = optind;
    388 }
    389 
    390 /* Initialize the internal data when the first call is made.  */
    391 
    392 #if defined __STDC__ && __STDC__
    393 static const char *_getopt_initialize (int, char *const *, const char *);
    394 #endif
    395 static const char *
    396 _getopt_initialize (argc, argv, optstring)
    397      int argc;
    398      char *const *argv;
    399      const char *optstring;
    400 {
    401   /* Start processing options with ARGV-element 1 (since ARGV-element 0
    402      is the program name); the sequence of previously skipped
    403      non-option ARGV-elements is empty.  */
    404 
    405   first_nonopt = last_nonopt = optind;
    406 
    407   nextchar = NULL;
    408 
    409   posixly_correct = getenv ("POSIXLY_CORRECT");
    410 
    411   /* Determine how to handle the ordering of options and nonoptions.  */
    412 
    413   if (optstring[0] == '-')
    414     {
    415       ordering = RETURN_IN_ORDER;
    416       ++optstring;
    417     }
    418   else if (optstring[0] == '+')
    419     {
    420       ordering = REQUIRE_ORDER;
    421       ++optstring;
    422     }
    423   else if (posixly_correct != NULL)
    424     ordering = REQUIRE_ORDER;
    425   else
    426     ordering = PERMUTE;
    427 
    428 #ifdef _LIBC
    429   if (posixly_correct == NULL
    430       && argc == original_argc && argv == original_argv)
    431     {
    432       if (nonoption_flags_max_len == 0)
    433 	{
    434 	  if (__getopt_nonoption_flags == NULL
    435 	      || __getopt_nonoption_flags[0] == '\0')
    436 	    nonoption_flags_max_len = -1;
    437 	  else
    438 	    {
    439 	      const char *orig_str = __getopt_nonoption_flags;
    440 	      int len = nonoption_flags_max_len = strlen (orig_str);
    441 	      if (nonoption_flags_max_len < argc)
    442 		nonoption_flags_max_len = argc;
    443 	      __getopt_nonoption_flags =
    444 		(char *) malloc (nonoption_flags_max_len);
    445 	      if (__getopt_nonoption_flags == NULL)
    446 		nonoption_flags_max_len = -1;
    447 	      else
    448 		memset (__mempcpy (__getopt_nonoption_flags, orig_str, len),
    449 			'\0', nonoption_flags_max_len - len);
    450 	    }
    451 	}
    452       nonoption_flags_len = nonoption_flags_max_len;
    453     }
    454   else
    455     nonoption_flags_len = 0;
    456 #endif
    457 
    458   return optstring;
    459 }
    460 
    461 /* Scan elements of ARGV (whose length is ARGC) for option characters
    463    given in OPTSTRING.
    464 
    465    If an element of ARGV starts with '-', and is not exactly "-" or "--",
    466    then it is an option element.  The characters of this element
    467    (aside from the initial '-') are option characters.  If `getopt'
    468    is called repeatedly, it returns successively each of the option characters
    469    from each of the option elements.
    470 
    471    If `getopt' finds another option character, it returns that character,
    472    updating `optind' and `nextchar' so that the next call to `getopt' can
    473    resume the scan with the following option character or ARGV-element.
    474 
    475    If there are no more option characters, `getopt' returns -1.
    476    Then `optind' is the index in ARGV of the first ARGV-element
    477    that is not an option.  (The ARGV-elements have been permuted
    478    so that those that are not options now come last.)
    479 
    480    OPTSTRING is a string containing the legitimate option characters.
    481    If an option character is seen that is not listed in OPTSTRING,
    482    return '?' after printing an error message.  If you set `opterr' to
    483    zero, the error message is suppressed but we still return '?'.
    484 
    485    If a char in OPTSTRING is followed by a colon, that means it wants an arg,
    486    so the following text in the same ARGV-element, or the text of the following
    487    ARGV-element, is returned in `optarg'.  Two colons mean an option that
    488    wants an optional arg; if there is text in the current ARGV-element,
    489    it is returned in `optarg', otherwise `optarg' is set to zero.
    490 
    491    If OPTSTRING starts with `-' or `+', it requests different methods of
    492    handling the non-option ARGV-elements.
    493    See the comments about RETURN_IN_ORDER and REQUIRE_ORDER, above.
    494 
    495    Long-named options begin with `--' instead of `-'.
    496    Their names may be abbreviated as long as the abbreviation is unique
    497    or is an exact match for some defined option.  If they have an
    498    argument, it follows the option name in the same ARGV-element, separated
    499    from the option name by a `=', or else the in next ARGV-element.
    500    When `getopt' finds a long-named option, it returns 0 if that option's
    501    `flag' field is nonzero, the value of the option's `val' field
    502    if the `flag' field is zero.
    503 
    504    The elements of ARGV aren't really const, because we permute them.
    505    But we pretend they're const in the prototype to be compatible
    506    with other systems.
    507 
    508    LONGOPTS is a vector of `struct option' terminated by an
    509    element containing a name which is zero.
    510 
    511    LONGIND returns the index in LONGOPT of the long-named option found.
    512    It is only valid when a long-named option has been found by the most
    513    recent call.
    514 
    515    If LONG_ONLY is nonzero, '-' as well as '--' can introduce
    516    long-named options.  */
    517 
    518 int
    519 _getopt_internal (argc, argv, optstring, longopts, longind, long_only)
    520      int argc;
    521      char *const *argv;
    522      const char *optstring;
    523      const struct option *longopts;
    524      int *longind;
    525      int long_only;
    526 {
    527   optarg = NULL;
    528 
    529   if (optind == 0 || !__getopt_initialized)
    530     {
    531       if (optind == 0)
    532 	optind = 1;	/* Don't scan ARGV[0], the program name.  */
    533       optstring = _getopt_initialize (argc, argv, optstring);
    534       __getopt_initialized = 1;
    535     }
    536 
    537   /* Test whether ARGV[optind] points to a non-option argument.
    538      Either it does not have option syntax, or there is an environment flag
    539      from the shell indicating it is not an option.  The later information
    540      is only used when the used in the GNU libc.  */
    541 #ifdef _LIBC
    542 # define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0'	      \
    543 		      || (optind < nonoption_flags_len			      \
    544 			  && __getopt_nonoption_flags[optind] == '1'))
    545 #else
    546 # define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0')
    547 #endif
    548 
    549   if (nextchar == NULL || *nextchar == '\0')
    550     {
    551       /* Advance to the next ARGV-element.  */
    552 
    553       /* Give FIRST_NONOPT & LAST_NONOPT rational values if OPTIND has been
    554 	 moved back by the user (who may also have changed the arguments).  */
    555       if (last_nonopt > optind)
    556 	last_nonopt = optind;
    557       if (first_nonopt > optind)
    558 	first_nonopt = optind;
    559 
    560       if (ordering == PERMUTE)
    561 	{
    562 	  /* If we have just processed some options following some non-options,
    563 	     exchange them so that the options come first.  */
    564 
    565 	  if (first_nonopt != last_nonopt && last_nonopt != optind)
    566 	    exchange ((char **) argv);
    567 	  else if (last_nonopt != optind)
    568 	    first_nonopt = optind;
    569 
    570 	  /* Skip any additional non-options
    571 	     and extend the range of non-options previously skipped.  */
    572 
    573 	  while (optind < argc && NONOPTION_P)
    574 	    optind++;
    575 	  last_nonopt = optind;
    576 	}
    577 
    578       /* The special ARGV-element `--' means premature end of options.
    579 	 Skip it like a null option,
    580 	 then exchange with previous non-options as if it were an option,
    581 	 then skip everything else like a non-option.  */
    582 
    583       if (optind != argc && !strcmp (argv[optind], "--"))
    584 	{
    585 	  optind++;
    586 
    587 	  if (first_nonopt != last_nonopt && last_nonopt != optind)
    588 	    exchange ((char **) argv);
    589 	  else if (first_nonopt == last_nonopt)
    590 	    first_nonopt = optind;
    591 	  last_nonopt = argc;
    592 
    593 	  optind = argc;
    594 	}
    595 
    596       /* If we have done all the ARGV-elements, stop the scan
    597 	 and back over any non-options that we skipped and permuted.  */
    598 
    599       if (optind == argc)
    600 	{
    601 	  /* Set the next-arg-index to point at the non-options
    602 	     that we previously skipped, so the caller will digest them.  */
    603 	  if (first_nonopt != last_nonopt)
    604 	    optind = first_nonopt;
    605 	  return -1;
    606 	}
    607 
    608       /* If we have come to a non-option and did not permute it,
    609 	 either stop the scan or describe it to the caller and pass it by.  */
    610 
    611       if (NONOPTION_P)
    612 	{
    613 	  if (ordering == REQUIRE_ORDER)
    614 	    return -1;
    615 	  optarg = argv[optind++];
    616 	  return 1;
    617 	}
    618 
    619       /* We have found another option-ARGV-element.
    620 	 Skip the initial punctuation.  */
    621 
    622       nextchar = (argv[optind] + 1
    623 		  + (longopts != NULL && argv[optind][1] == '-'));
    624     }
    625 
    626   /* Decode the current option-ARGV-element.  */
    627 
    628   /* Check whether the ARGV-element is a long option.
    629 
    630      If long_only and the ARGV-element has the form "-f", where f is
    631      a valid short option, don't consider it an abbreviated form of
    632      a long option that starts with f.  Otherwise there would be no
    633      way to give the -f short option.
    634 
    635      On the other hand, if there's a long option "fubar" and
    636      the ARGV-element is "-fu", do consider that an abbreviation of
    637      the long option, just like "--fu", and not "-f" with arg "u".
    638 
    639      This distinction seems to be the most useful approach.  */
    640 
    641   if (longopts != NULL
    642       && (argv[optind][1] == '-'
    643 	  || (long_only && (argv[optind][2] || !my_index (optstring, argv[optind][1])))))
    644     {
    645       char *nameend;
    646       const struct option *p;
    647       const struct option *pfound = NULL;
    648       int exact = 0;
    649       int ambig = 0;
    650       int indfound = -1;
    651       int option_index;
    652 
    653       for (nameend = nextchar; *nameend && *nameend != '='; nameend++)
    654 	/* Do nothing.  */ ;
    655 
    656       /* Test all long options for either exact match
    657 	 or abbreviated matches.  */
    658       for (p = longopts, option_index = 0; p->name; p++, option_index++)
    659 	if (!strncmp (p->name, nextchar, nameend - nextchar))
    660 	  {
    661 	    if ((unsigned int) (nameend - nextchar)
    662 		== (unsigned int) strlen (p->name))
    663 	      {
    664 		/* Exact match found.  */
    665 		pfound = p;
    666 		indfound = option_index;
    667 		exact = 1;
    668 		break;
    669 	      }
    670 	    else if (pfound == NULL)
    671 	      {
    672 		/* First nonexact match found.  */
    673 		pfound = p;
    674 		indfound = option_index;
    675 	      }
    676 	    else
    677 	      /* Second or later nonexact match found.  */
    678 	      ambig = 1;
    679 	  }
    680 
    681       if (ambig && !exact)
    682 	{
    683 	  if (opterr)
    684 	    fprintf (stderr, _("%s: option `%s' is ambiguous\n"),
    685 		     argv[0], argv[optind]);
    686 	  nextchar += strlen (nextchar);
    687 	  optind++;
    688 	  optopt = 0;
    689 	  return '?';
    690 	}
    691 
    692       if (pfound != NULL)
    693 	{
    694 	  option_index = indfound;
    695 	  optind++;
    696 	  if (*nameend)
    697 	    {
    698 	      /* Don't test has_arg with >, because some C compilers don't
    699 		 allow it to be used on enums.  */
    700 	      if (pfound->has_arg)
    701 		optarg = nameend + 1;
    702 	      else
    703 		{
    704 		  if (opterr)
    705 		    {
    706 		      if (argv[optind - 1][1] == '-')
    707 			/* --option */
    708 			fprintf (stderr,
    709 				 _("%s: option `--%s' doesn't allow an argument\n"),
    710 				 argv[0], pfound->name);
    711 		      else
    712 			/* +option or -option */
    713 			fprintf (stderr,
    714 				 _("%s: option `%c%s' doesn't allow an argument\n"),
    715 				 argv[0], argv[optind - 1][0], pfound->name);
    716 		    }
    717 		  nextchar += strlen (nextchar);
    718 
    719 		  optopt = pfound->val;
    720 		  return '?';
    721 		}
    722 	    }
    723 	  else if (pfound->has_arg == 1)
    724 	    {
    725 	      if (optind < argc)
    726 		optarg = argv[optind++];
    727 	      else
    728 		{
    729 		  if (opterr)
    730 		    fprintf (stderr,
    731 			   _("%s: option `%s' requires an argument\n"),
    732 			   argv[0], argv[optind - 1]);
    733 		  nextchar += strlen (nextchar);
    734 		  optopt = pfound->val;
    735 		  return optstring[0] == ':' ? ':' : '?';
    736 		}
    737 	    }
    738 	  nextchar += strlen (nextchar);
    739 	  if (longind != NULL)
    740 	    *longind = option_index;
    741 	  if (pfound->flag)
    742 	    {
    743 	      *(pfound->flag) = pfound->val;
    744 	      return 0;
    745 	    }
    746 	  return pfound->val;
    747 	}
    748 
    749       /* Can't find it as a long option.  If this is not getopt_long_only,
    750 	 or the option starts with '--' or is not a valid short
    751 	 option, then it's an error.
    752 	 Otherwise interpret it as a short option.  */
    753       if (!long_only || argv[optind][1] == '-'
    754 	  || my_index (optstring, *nextchar) == NULL)
    755 	{
    756 	  if (opterr)
    757 	    {
    758 	      if (argv[optind][1] == '-')
    759 		/* --option */
    760 		fprintf (stderr, _("%s: unrecognized option `--%s'\n"),
    761 			 argv[0], nextchar);
    762 	      else
    763 		/* +option or -option */
    764 		fprintf (stderr, _("%s: unrecognized option `%c%s'\n"),
    765 			 argv[0], argv[optind][0], nextchar);
    766 	    }
    767 	  nextchar = (char *) "";
    768 	  optind++;
    769 	  optopt = 0;
    770 	  return '?';
    771 	}
    772     }
    773 
    774   /* Look at and handle the next short option-character.  */
    775 
    776   {
    777     char c = *nextchar++;
    778     char *temp = my_index (optstring, c);
    779 
    780     /* Increment `optind' when we start to process its last character.  */
    781     if (*nextchar == '\0')
    782       ++optind;
    783 
    784     if (temp == NULL || c == ':')
    785       {
    786 	if (opterr)
    787 	  {
    788 	    if (posixly_correct)
    789 	      /* 1003.2 specifies the format of this message.  */
    790 	      fprintf (stderr, _("%s: illegal option -- %c\n"),
    791 		       argv[0], c);
    792 	    else
    793 	      fprintf (stderr, _("%s: invalid option -- %c\n"),
    794 		       argv[0], c);
    795 	  }
    796 	optopt = c;
    797 	return '?';
    798       }
    799     /* Convenience. Treat POSIX -W foo same as long option --foo */
    800     if (temp[0] == 'W' && temp[1] == ';')
    801       {
    802 	char *nameend;
    803 	const struct option *p;
    804 	const struct option *pfound = NULL;
    805 	int exact = 0;
    806 	int ambig = 0;
    807 	int indfound = 0;
    808 	int option_index;
    809 
    810 	/* This is an option that requires an argument.  */
    811 	if (*nextchar != '\0')
    812 	  {
    813 	    optarg = nextchar;
    814 	    /* If we end this ARGV-element by taking the rest as an arg,
    815 	       we must advance to the next element now.  */
    816 	    optind++;
    817 	  }
    818 	else if (optind == argc)
    819 	  {
    820 	    if (opterr)
    821 	      {
    822 		/* 1003.2 specifies the format of this message.  */
    823 		fprintf (stderr, _("%s: option requires an argument -- %c\n"),
    824 			 argv[0], c);
    825 	      }
    826 	    optopt = c;
    827 	    if (optstring[0] == ':')
    828 	      c = ':';
    829 	    else
    830 	      c = '?';
    831 	    return c;
    832 	  }
    833 	else
    834 	  /* We already incremented `optind' once;
    835 	     increment it again when taking next ARGV-elt as argument.  */
    836 	  optarg = argv[optind++];
    837 
    838 	/* optarg is now the argument, see if it's in the
    839 	   table of longopts.  */
    840 
    841 	for (nextchar = nameend = optarg; *nameend && *nameend != '='; nameend++)
    842 	  /* Do nothing.  */ ;
    843 
    844 	/* Test all long options for either exact match
    845 	   or abbreviated matches.  */
    846 	for (p = longopts, option_index = 0; p->name; p++, option_index++)
    847 	  if (!strncmp (p->name, nextchar, nameend - nextchar))
    848 	    {
    849 	      if ((unsigned int) (nameend - nextchar) == strlen (p->name))
    850 		{
    851 		  /* Exact match found.  */
    852 		  pfound = p;
    853 		  indfound = option_index;
    854 		  exact = 1;
    855 		  break;
    856 		}
    857 	      else if (pfound == NULL)
    858 		{
    859 		  /* First nonexact match found.  */
    860 		  pfound = p;
    861 		  indfound = option_index;
    862 		}
    863 	      else
    864 		/* Second or later nonexact match found.  */
    865 		ambig = 1;
    866 	    }
    867 	if (ambig && !exact)
    868 	  {
    869 	    if (opterr)
    870 	      fprintf (stderr, _("%s: option `-W %s' is ambiguous\n"),
    871 		       argv[0], argv[optind]);
    872 	    nextchar += strlen (nextchar);
    873 	    optind++;
    874 	    return '?';
    875 	  }
    876 	if (pfound != NULL)
    877 	  {
    878 	    option_index = indfound;
    879 	    if (*nameend)
    880 	      {
    881 		/* Don't test has_arg with >, because some C compilers don't
    882 		   allow it to be used on enums.  */
    883 		if (pfound->has_arg)
    884 		  optarg = nameend + 1;
    885 		else
    886 		  {
    887 		    if (opterr)
    888 		      fprintf (stderr, _("\
    889 %s: option `-W %s' doesn't allow an argument\n"),
    890 			       argv[0], pfound->name);
    891 
    892 		    nextchar += strlen (nextchar);
    893 		    return '?';
    894 		  }
    895 	      }
    896 	    else if (pfound->has_arg == 1)
    897 	      {
    898 		if (optind < argc)
    899 		  optarg = argv[optind++];
    900 		else
    901 		  {
    902 		    if (opterr)
    903 		      fprintf (stderr,
    904 			       _("%s: option `%s' requires an argument\n"),
    905 			       argv[0], argv[optind - 1]);
    906 		    nextchar += strlen (nextchar);
    907 		    return optstring[0] == ':' ? ':' : '?';
    908 		  }
    909 	      }
    910 	    nextchar += strlen (nextchar);
    911 	    if (longind != NULL)
    912 	      *longind = option_index;
    913 	    if (pfound->flag)
    914 	      {
    915 		*(pfound->flag) = pfound->val;
    916 		return 0;
    917 	      }
    918 	    return pfound->val;
    919 	  }
    920 	  nextchar = NULL;
    921 	  return 'W';	/* Let the application handle it.   */
    922       }
    923     if (temp[1] == ':')
    924       {
    925 	if (temp[2] == ':')
    926 	  {
    927 	    /* This is an option that accepts an argument optionally.  */
    928 	    if (*nextchar != '\0')
    929 	      {
    930 		optarg = nextchar;
    931 		optind++;
    932 	      }
    933 	    else
    934 	      optarg = NULL;
    935 	    nextchar = NULL;
    936 	  }
    937 	else
    938 	  {
    939 	    /* This is an option that requires an argument.  */
    940 	    if (*nextchar != '\0')
    941 	      {
    942 		optarg = nextchar;
    943 		/* If we end this ARGV-element by taking the rest as an arg,
    944 		   we must advance to the next element now.  */
    945 		optind++;
    946 	      }
    947 	    else if (optind == argc)
    948 	      {
    949 		if (opterr)
    950 		  {
    951 		    /* 1003.2 specifies the format of this message.  */
    952 		    fprintf (stderr,
    953 			   _("%s: option requires an argument -- %c\n"),
    954 			   argv[0], c);
    955 		  }
    956 		optopt = c;
    957 		if (optstring[0] == ':')
    958 		  c = ':';
    959 		else
    960 		  c = '?';
    961 	      }
    962 	    else
    963 	      /* We already incremented `optind' once;
    964 		 increment it again when taking next ARGV-elt as argument.  */
    965 	      optarg = argv[optind++];
    966 	    nextchar = NULL;
    967 	  }
    968       }
    969     return c;
    970   }
    971 }
    972 
    973 int
    974 getopt (argc, argv, optstring)
    975      int argc;
    976      char *const *argv;
    977      const char *optstring;
    978 {
    979   return _getopt_internal (argc, argv, optstring,
    980 			   (const struct option *) 0,
    981 			   (int *) 0,
    982 			   0);
    983 }
    984 
    985 #endif	/* Not ELIDE_CODE.  */
    986 
    987 #ifdef TEST
    989 
    990 /* Compile with -DTEST to make an executable for use in testing
    991    the above definition of `getopt'.  */
    992 
    993 int
    994 main (argc, argv)
    995      int argc;
    996      char **argv;
    997 {
    998   int c;
    999   int digit_optind = 0;
   1000 
   1001   while (1)
   1002     {
   1003       int this_option_optind = optind ? optind : 1;
   1004 
   1005       c = getopt (argc, argv, "abc:d:0123456789");
   1006       if (c == -1)
   1007 	break;
   1008 
   1009       switch (c)
   1010 	{
   1011 	case '0':
   1012 	case '1':
   1013 	case '2':
   1014 	case '3':
   1015 	case '4':
   1016 	case '5':
   1017 	case '6':
   1018 	case '7':
   1019 	case '8':
   1020 	case '9':
   1021 	  if (digit_optind != 0 && digit_optind != this_option_optind)
   1022 	    printf ("digits occur in two different argv-elements.\n");
   1023 	  digit_optind = this_option_optind;
   1024 	  printf ("option %c\n", c);
   1025 	  break;
   1026 
   1027 	case 'a':
   1028 	  printf ("option a\n");
   1029 	  break;
   1030 
   1031 	case 'b':
   1032 	  printf ("option b\n");
   1033 	  break;
   1034 
   1035 	case 'c':
   1036 	  printf ("option c with value `%s'\n", optarg);
   1037 	  break;
   1038 
   1039 	case '?':
   1040 	  break;
   1041 
   1042 	default:
   1043 	  printf ("?? getopt returned character code 0%o ??\n", c);
   1044 	}
   1045     }
   1046 
   1047   if (optind < argc)
   1048     {
   1049       printf ("non-option ARGV-elements: ");
   1050       while (optind < argc)
   1051 	printf ("%s ", argv[optind++]);
   1052       printf ("\n");
   1053     }
   1054 
   1055   exit (0);
   1056 }
   1057 
   1058 #endif /* TEST */
   1059