-/* Getopt for GNU.\r
-\r
- $Id: getopt.c,v 1.2 2000/04/12 21:51:28 gram Exp $\r
-\r
- NOTE: getopt is now part of the C library, so if you don't know what\r
- "Keep this file name-space clean" means, talk to roland@gnu.ai.mit.edu\r
- before changing it!\r
-\r
- Copyright (C) 1987, 88, 89, 90, 91, 92, 1993\r
- Free Software Foundation, Inc.\r
-\r
- This program is free software; you can redistribute it and/or modify it\r
- under the terms of the GNU General Public License as published by the\r
- Free Software Foundation; either version 2, or (at your option) any\r
- later version.\r
-\r
- This program is distributed in the hope that it will be useful,\r
- but WITHOUT ANY WARRANTY; without even the implied warranty of\r
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\r
- GNU General Public License for more details.\r
-\r
- You should have received a copy of the GNU General Public License\r
- along with this program; if not, write to the Free Software\r
- Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */\r
-\r
-\r
-#ifdef HAVE_CONFIG_H\r
-#include "config.h"\r
-#endif\r
-\r
-#ifndef __STDC__\r
-/* This is a separate conditional since some stdc systems\r
- reject `defined (const)'. */\r
-#ifndef const\r
-#define const\r
-#endif\r
-#endif\r
-\r
-/* This tells Alpha OSF/1 not to define a getopt prototype in <stdio.h>. */\r
-#ifndef _NO_PROTO\r
-#define _NO_PROTO\r
-#endif\r
-\r
-#include <stdio.h>\r
-\r
-/* Comment out all this code if we are using the GNU C Library, and are not\r
- actually compiling the library itself. This code is part of the GNU C\r
- Library, but also included in many other GNU distributions. Compiling\r
- and linking in this code is a waste when using the GNU C library\r
- (especially if it is a shared library). Rather than having every GNU\r
- program understand `configure --with-gnu-libc' and omit the object files,\r
- it is simpler to just do this in the source for each such file. */\r
-\r
-#if defined (_LIBC) || !defined (__GNU_LIBRARY__)\r
-\r
-\r
-/* This needs to come after some library #include\r
- to get __GNU_LIBRARY__ defined. */\r
-#ifdef __GNU_LIBRARY__\r
-/* Don't include stdlib.h for non-GNU C libraries because some of them\r
- contain conflicting prototypes for getopt. */\r
-#include <stdlib.h>\r
-#endif /* GNU C library. */\r
-\r
-/* If GETOPT_COMPAT is defined, `+' as well as `--' can introduce a\r
- long-named option. Because this is not POSIX.2 compliant, it is\r
- being phased out. */\r
-/* #define GETOPT_COMPAT */\r
-\r
-/* This version of `getopt' appears to the caller like standard Unix `getopt'\r
- but it behaves differently for the user, since it allows the user\r
- to intersperse the options with the other arguments.\r
-\r
- As `getopt' works, it permutes the elements of ARGV so that,\r
- when it is done, all the options precede everything else. Thus\r
- all application programs are extended to handle flexible argument order.\r
-\r
- Setting the environment variable POSIXLY_CORRECT disables permutation.\r
- Then the behavior is completely standard.\r
-\r
- GNU application programs can use a third alternative mode in which\r
- they can distinguish the relative order of options and other arguments. */\r
-\r
-#include "getopt.h"\r
-\r
-/* For communication from `getopt' to the caller.\r
- When `getopt' finds an option that takes an argument,\r
- the argument value is returned here.\r
- Also, when `ordering' is RETURN_IN_ORDER,\r
- each non-option ARGV-element is returned here. */\r
-\r
-char *optarg = 0;\r
-\r
-/* Index in ARGV of the next element to be scanned.\r
- This is used for communication to and from the caller\r
- and for communication between successive calls to `getopt'.\r
-\r
- On entry to `getopt', zero means this is the first call; initialize.\r
-\r
- When `getopt' returns EOF, this is the index of the first of the\r
- non-option elements that the caller should itself scan.\r
-\r
- Otherwise, `optind' communicates from one call to the next\r
- how much of ARGV has been scanned so far. */\r
-\r
-/* XXX 1003.2 says this must be 1 before any call. */\r
-int optind = 0;\r
-\r
-/* The next char to be scanned in the option-element\r
- in which the last option character we returned was found.\r
- This allows us to pick up the scan where we left off.\r
-\r
- If this is zero, or a null string, it means resume the scan\r
- by advancing to the next ARGV-element. */\r
-\r
-static char *nextchar;\r
-\r
-/* Callers store zero here to inhibit the error message\r
- for unrecognized options. */\r
-\r
-int opterr = 1;\r
-\r
-/* Set to an option character which was unrecognized.\r
- This must be initialized on some systems to avoid linking in the\r
- system's own getopt implementation. */\r
-\r
-int optopt = '?';\r
-\r
-/* Describe how to deal with options that follow non-option ARGV-elements.\r
-\r
- If the caller did not specify anything,\r
- the default is REQUIRE_ORDER if the environment variable\r
- POSIXLY_CORRECT is defined, PERMUTE otherwise.\r
-\r
- REQUIRE_ORDER means don't recognize them as options;\r
- stop option processing when the first non-option is seen.\r
- This is what Unix does.\r
- This mode of operation is selected by either setting the environment\r
- variable POSIXLY_CORRECT, or using `+' as the first character\r
- of the list of option characters.\r
-\r
- PERMUTE is the default. We permute the contents of ARGV as we scan,\r
- so that eventually all the non-options are at the end. This allows options\r
- to be given in any order, even with programs that were not written to\r
- expect this.\r
-\r
- RETURN_IN_ORDER is an option available to programs that were written\r
- to expect options and other ARGV-elements in any order and that care about\r
- the ordering of the two. We describe each non-option ARGV-element\r
- as if it were the argument of an option with character code 1.\r
- Using `-' as the first character of the list of option characters\r
- selects this mode of operation.\r
-\r
- The special argument `--' forces an end of option-scanning regardless\r
- of the value of `ordering'. In the case of RETURN_IN_ORDER, only\r
- `--' can cause `getopt' to return EOF with `optind' != ARGC. */\r
-\r
-static enum\r
-{\r
- REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER\r
-} ordering;\r
-\f\r
-#ifdef __GNU_LIBRARY__\r
-/* We want to avoid inclusion of string.h with non-GNU libraries\r
- because there are many ways it can cause trouble.\r
- On some systems, it contains special magic macros that don't work\r
- in GCC. */\r
-#include <string.h>\r
-#define my_index strchr\r
-#else\r
-\r
-/* Avoid depending on library functions or files\r
- whose names are inconsistent. */\r
-\r
-char *getenv ();\r
-\r
-static char *\r
-my_index (str, chr)\r
- const char *str;\r
- int chr;\r
-{\r
- while (*str)\r
- {\r
- if (*str == chr)\r
- return (char *) str;\r
- str++;\r
- }\r
- return 0;\r
-}\r
-\r
-/* If using GCC, we can safely declare strlen this way.\r
- If not using GCC, it is ok not to declare it.\r
- (Supposedly there are some machines where it might get a warning,\r
- but changing this conditional to __STDC__ is too risky.) */\r
-#ifdef __GNUC__\r
-#ifdef IN_GCC\r
-#include "gstddef.h"\r
-#else\r
-#include <stddef.h>\r
-#endif\r
-extern size_t strlen (const char *);\r
-#endif\r
-\r
-#endif /* GNU C library. */\r
-\f\r
-/* Handle permutation of arguments. */\r
-\r
-/* Describe the part of ARGV that contains non-options that have\r
- been skipped. `first_nonopt' is the index in ARGV of the first of them;\r
- `last_nonopt' is the index after the last of them. */\r
-\r
-static int first_nonopt;\r
-static int last_nonopt;\r
-\r
-/* Exchange two adjacent subsequences of ARGV.\r
- One subsequence is elements [first_nonopt,last_nonopt)\r
- which contains all the non-options that have been skipped so far.\r
- The other is elements [last_nonopt,optind), which contains all\r
- the options processed since those non-options were skipped.\r
-\r
- `first_nonopt' and `last_nonopt' are relocated so that they describe\r
- the new indices of the non-options in ARGV after they are moved. */\r
-\r
-static void\r
-exchange (argv)\r
- char **argv;\r
-{\r
- int bottom = first_nonopt;\r
- int middle = last_nonopt;\r
- int top = optind;\r
- char *tem;\r
-\r
- /* Exchange the shorter segment with the far end of the longer segment.\r
- That puts the shorter segment into the right place.\r
- It leaves the longer segment in the right place overall,\r
- but it consists of two parts that need to be swapped next. */\r
-\r
- while (top > middle && middle > bottom)\r
- {\r
- if (top - middle > middle - bottom)\r
- {\r
- /* Bottom segment is the short one. */\r
- int len = middle - bottom;\r
- register int i;\r
-\r
- /* Swap it with the top part of the top segment. */\r
- for (i = 0; i < len; i++)\r
- {\r
- tem = argv[bottom + i];\r
- argv[bottom + i] = argv[top - (middle - bottom) + i];\r
- argv[top - (middle - bottom) + i] = tem;\r
- }\r
- /* Exclude the moved bottom segment from further swapping. */\r
- top -= len;\r
- }\r
- else\r
- {\r
- /* Top segment is the short one. */\r
- int len = top - middle;\r
- register int i;\r
-\r
- /* Swap it with the bottom part of the bottom segment. */\r
- for (i = 0; i < len; i++)\r
- {\r
- tem = argv[bottom + i];\r
- argv[bottom + i] = argv[middle + i];\r
- argv[middle + i] = tem;\r
- }\r
- /* Exclude the moved top segment from further swapping. */\r
- bottom += len;\r
- }\r
- }\r
-\r
- /* Update records for the slots the non-options now occupy. */\r
-\r
- first_nonopt += (optind - last_nonopt);\r
- last_nonopt = optind;\r
-}\r
-\f\r
-/* Scan elements of ARGV (whose length is ARGC) for option characters\r
- given in OPTSTRING.\r
-\r
- If an element of ARGV starts with '-', and is not exactly "-" or "--",\r
- then it is an option element. The characters of this element\r
- (aside from the initial '-') are option characters. If `getopt'\r
- is called repeatedly, it returns successively each of the option characters\r
- from each of the option elements.\r
-\r
- If `getopt' finds another option character, it returns that character,\r
- updating `optind' and `nextchar' so that the next call to `getopt' can\r
- resume the scan with the following option character or ARGV-element.\r
-\r
- If there are no more option characters, `getopt' returns `EOF'.\r
- Then `optind' is the index in ARGV of the first ARGV-element\r
- that is not an option. (The ARGV-elements have been permuted\r
- so that those that are not options now come last.)\r
-\r
- OPTSTRING is a string containing the legitimate option characters.\r
- If an option character is seen that is not listed in OPTSTRING,\r
- return '?' after printing an error message. If you set `opterr' to\r
- zero, the error message is suppressed but we still return '?'.\r
-\r
- If a char in OPTSTRING is followed by a colon, that means it wants an arg,\r
- so the following text in the same ARGV-element, or the text of the following\r
- ARGV-element, is returned in `optarg'. Two colons mean an option that\r
- wants an optional arg; if there is text in the current ARGV-element,\r
- it is returned in `optarg', otherwise `optarg' is set to zero.\r
-\r
- If OPTSTRING starts with `-' or `+', it requests different methods of\r
- handling the non-option ARGV-elements.\r
- See the comments about RETURN_IN_ORDER and REQUIRE_ORDER, above.\r
-\r
- Long-named options begin with `--' instead of `-'.\r
- Their names may be abbreviated as long as the abbreviation is unique\r
- or is an exact match for some defined option. If they have an\r
- argument, it follows the option name in the same ARGV-element, separated\r
- from the option name by a `=', or else the in next ARGV-element.\r
- When `getopt' finds a long-named option, it returns 0 if that option's\r
- `flag' field is nonzero, the value of the option's `val' field\r
- if the `flag' field is zero.\r
-\r
- The elements of ARGV aren't really const, because we permute them.\r
- But we pretend they're const in the prototype to be compatible\r
- with other systems.\r
-\r
- LONGOPTS is a vector of `struct option' terminated by an\r
- element containing a name which is zero.\r
-\r
- LONGIND returns the index in LONGOPT of the long-named option found.\r
- It is only valid when a long-named option has been found by the most\r
- recent call.\r
-\r
- If LONG_ONLY is nonzero, '-' as well as '--' can introduce\r
- long-named options. */\r
-\r
-int\r
-_getopt_internal (argc, argv, optstring, longopts, longind, long_only)\r
- int argc;\r
- char *const *argv;\r
- const char *optstring;\r
- const struct option *longopts;\r
- int *longind;\r
- int long_only;\r
-{\r
- int option_index;\r
-\r
- optarg = 0;\r
-\r
- /* Initialize the internal data when the first call is made.\r
- Start processing options with ARGV-element 1 (since ARGV-element 0\r
- is the program name); the sequence of previously skipped\r
- non-option ARGV-elements is empty. */\r
-\r
- if (optind == 0)\r
- {\r
- first_nonopt = last_nonopt = optind = 1;\r
-\r
- nextchar = NULL;\r
-\r
- /* Determine how to handle the ordering of options and nonoptions. */\r
-\r
- if (optstring[0] == '-')\r
- {\r
- ordering = RETURN_IN_ORDER;\r
- ++optstring;\r
- }\r
- else if (optstring[0] == '+')\r
- {\r
- ordering = REQUIRE_ORDER;\r
- ++optstring;\r
- }\r
- else if (getenv ("POSIXLY_CORRECT") != NULL)\r
- ordering = REQUIRE_ORDER;\r
- else\r
- ordering = PERMUTE;\r
- }\r
-\r
- if (nextchar == NULL || *nextchar == '\0')\r
- {\r
- if (ordering == PERMUTE)\r
- {\r
- /* If we have just processed some options following some non-options,\r
- exchange them so that the options come first. */\r
-\r
- if (first_nonopt != last_nonopt && last_nonopt != optind)\r
- exchange ((char **) argv);\r
- else if (last_nonopt != optind)\r
- first_nonopt = optind;\r
-\r
- /* Now skip any additional non-options\r
- and extend the range of non-options previously skipped. */\r
-\r
- while (optind < argc\r
- && (argv[optind][0] != '-' || argv[optind][1] == '\0')\r
-#ifdef GETOPT_COMPAT\r
- && (longopts == NULL\r
- || argv[optind][0] != '+' || argv[optind][1] == '\0')\r
-#endif /* GETOPT_COMPAT */\r
- )\r
- optind++;\r
- last_nonopt = optind;\r
- }\r
-\r
- /* Special ARGV-element `--' means premature end of options.\r
- Skip it like a null option,\r
- then exchange with previous non-options as if it were an option,\r
- then skip everything else like a non-option. */\r
-\r
- if (optind != argc && !strcmp (argv[optind], "--"))\r
- {\r
- optind++;\r
-\r
- if (first_nonopt != last_nonopt && last_nonopt != optind)\r
- exchange ((char **) argv);\r
- else if (first_nonopt == last_nonopt)\r
- first_nonopt = optind;\r
- last_nonopt = argc;\r
-\r
- optind = argc;\r
- }\r
-\r
- /* If we have done all the ARGV-elements, stop the scan\r
- and back over any non-options that we skipped and permuted. */\r
-\r
- if (optind == argc)\r
- {\r
- /* Set the next-arg-index to point at the non-options\r
- that we previously skipped, so the caller will digest them. */\r
- if (first_nonopt != last_nonopt)\r
- optind = first_nonopt;\r
- return EOF;\r
- }\r
-\r
- /* If we have come to a non-option and did not permute it,\r
- either stop the scan or describe it to the caller and pass it by. */\r
-\r
- if ((argv[optind][0] != '-' || argv[optind][1] == '\0')\r
-#ifdef GETOPT_COMPAT\r
- && (longopts == NULL\r
- || argv[optind][0] != '+' || argv[optind][1] == '\0')\r
-#endif /* GETOPT_COMPAT */\r
- )\r
- {\r
- if (ordering == REQUIRE_ORDER)\r
- return EOF;\r
- optarg = argv[optind++];\r
- return 1;\r
- }\r
-\r
- /* We have found another option-ARGV-element.\r
- Start decoding its characters. */\r
-\r
- nextchar = (argv[optind] + 1\r
- + (longopts != NULL && argv[optind][1] == '-'));\r
- }\r
-\r
- if (longopts != NULL\r
- && ((argv[optind][0] == '-'\r
- && (argv[optind][1] == '-' || long_only))\r
-#ifdef GETOPT_COMPAT\r
- || argv[optind][0] == '+'\r
-#endif /* GETOPT_COMPAT */\r
- ))\r
- {\r
- const struct option *p;\r
- char *s = nextchar;\r
- int exact = 0;\r
- int ambig = 0;\r
- const struct option *pfound = NULL;\r
- int indfound;\r
-\r
- while (*s && *s != '=')\r
- s++;\r
-\r
- /* Test all options for either exact match or abbreviated matches. */\r
- for (p = longopts, option_index = 0; p->name;\r
- p++, option_index++)\r
- if (!strncmp (p->name, nextchar, s - nextchar))\r
- {\r
- if (s - nextchar == strlen (p->name))\r
- {\r
- /* Exact match found. */\r
- pfound = p;\r
- indfound = option_index;\r
- exact = 1;\r
- break;\r
- }\r
- else if (pfound == NULL)\r
- {\r
- /* First nonexact match found. */\r
- pfound = p;\r
- indfound = option_index;\r
- }\r
- else\r
- /* Second nonexact match found. */\r
- ambig = 1;\r
- }\r
-\r
- if (ambig && !exact)\r
- {\r
- if (opterr)\r
- fprintf (stderr, "%s: option `%s' is ambiguous\n",\r
- argv[0], argv[optind]);\r
- nextchar += strlen (nextchar);\r
- optind++;\r
- return '?';\r
- }\r
-\r
- if (pfound != NULL)\r
- {\r
- option_index = indfound;\r
- optind++;\r
- if (*s)\r
- {\r
- /* Don't test has_arg with >, because some C compilers don't\r
- allow it to be used on enums. */\r
- if (pfound->has_arg)\r
- optarg = s + 1;\r
- else\r
- {\r
- if (opterr)\r
- {\r
- if (argv[optind - 1][1] == '-')\r
- /* --option */\r
- fprintf (stderr,\r
- "%s: option `--%s' doesn't allow an argument\n",\r
- argv[0], pfound->name);\r
- else\r
- /* +option or -option */\r
- fprintf (stderr,\r
- "%s: option `%c%s' doesn't allow an argument\n",\r
- argv[0], argv[optind - 1][0], pfound->name);\r
- }\r
- nextchar += strlen (nextchar);\r
- return '?';\r
- }\r
- }\r
- else if (pfound->has_arg == 1)\r
- {\r
- if (optind < argc)\r
- optarg = argv[optind++];\r
- else\r
- {\r
- if (opterr)\r
- fprintf (stderr, "%s: option `%s' requires an argument\n",\r
- argv[0], argv[optind - 1]);\r
- nextchar += strlen (nextchar);\r
- return optstring[0] == ':' ? ':' : '?';\r
- }\r
- }\r
- nextchar += strlen (nextchar);\r
- if (longind != NULL)\r
- *longind = option_index;\r
- if (pfound->flag)\r
- {\r
- *(pfound->flag) = pfound->val;\r
- return 0;\r
- }\r
- return pfound->val;\r
- }\r
- /* Can't find it as a long option. If this is not getopt_long_only,\r
- or the option starts with '--' or is not a valid short\r
- option, then it's an error.\r
- Otherwise interpret it as a short option. */\r
- if (!long_only || argv[optind][1] == '-'\r
-#ifdef GETOPT_COMPAT\r
- || argv[optind][0] == '+'\r
-#endif /* GETOPT_COMPAT */\r
- || my_index (optstring, *nextchar) == NULL)\r
- {\r
- if (opterr)\r
- {\r
- if (argv[optind][1] == '-')\r
- /* --option */\r
- fprintf (stderr, "%s: unrecognized option `--%s'\n",\r
- argv[0], nextchar);\r
- else\r
- /* +option or -option */\r
- fprintf (stderr, "%s: unrecognized option `%c%s'\n",\r
- argv[0], argv[optind][0], nextchar);\r
- }\r
- nextchar = (char *) "";\r
- optind++;\r
- return '?';\r
- }\r
- }\r
-\r
- /* Look at and handle the next option-character. */\r
-\r
- {\r
- char c = *nextchar++;\r
- char *temp = my_index (optstring, c);\r
-\r
- /* Increment `optind' when we start to process its last character. */\r
- if (*nextchar == '\0')\r
- ++optind;\r
-\r
- if (temp == NULL || c == ':')\r
- {\r
- if (opterr)\r
- {\r
-#if 0\r
- if (c < 040 || c >= 0177)\r
- fprintf (stderr, "%s: unrecognized option, character code 0%o\n",\r
- argv[0], c);\r
- else\r
- fprintf (stderr, "%s: unrecognized option `-%c'\n", argv[0], c);\r
-#else\r
- /* 1003.2 specifies the format of this message. */\r
- fprintf (stderr, "%s: illegal option -- %c\n", argv[0], c);\r
-#endif\r
- }\r
- optopt = c;\r
- return '?';\r
- }\r
- if (temp[1] == ':')\r
- {\r
- if (temp[2] == ':')\r
- {\r
- /* This is an option that accepts an argument optionally. */\r
- if (*nextchar != '\0')\r
- {\r
- optarg = nextchar;\r
- optind++;\r
- }\r
- else\r
- optarg = 0;\r
- nextchar = NULL;\r
- }\r
- else\r
- {\r
- /* This is an option that requires an argument. */\r
- if (*nextchar != '\0')\r
- {\r
- optarg = nextchar;\r
- /* If we end this ARGV-element by taking the rest as an arg,\r
- we must advance to the next element now. */\r
- optind++;\r
- }\r
- else if (optind == argc)\r
- {\r
- if (opterr)\r
- {\r
-#if 0\r
- fprintf (stderr, "%s: option `-%c' requires an argument\n",\r
- argv[0], c);\r
-#else\r
- /* 1003.2 specifies the format of this message. */\r
- fprintf (stderr, "%s: option requires an argument -- %c\n",\r
- argv[0], c);\r
-#endif\r
- }\r
- optopt = c;\r
- if (optstring[0] == ':')\r
- c = ':';\r
- else\r
- c = '?';\r
- }\r
- else\r
- /* We already incremented `optind' once;\r
- increment it again when taking next ARGV-elt as argument. */\r
- optarg = argv[optind++];\r
- nextchar = NULL;\r
- }\r
- }\r
- return c;\r
- }\r
-}\r
-\r
-int\r
-getopt (argc, argv, optstring)\r
- int argc;\r
- char *const *argv;\r
- const char *optstring;\r
-{\r
- return _getopt_internal (argc, argv, optstring,\r
- (const struct option *) 0,\r
- (int *) 0,\r
- 0);\r
-}\r
-\r
-#endif /* _LIBC or not __GNU_LIBRARY__. */\r
-\f\r
-#ifdef TEST\r
-\r
-/* Compile with -DTEST to make an executable for use in testing\r
- the above definition of `getopt'. */\r
-\r
-int\r
-main (argc, argv)\r
- int argc;\r
- char **argv;\r
-{\r
- int c;\r
- int digit_optind = 0;\r
-\r
- while (1)\r
- {\r
- int this_option_optind = optind ? optind : 1;\r
-\r
- c = getopt (argc, argv, "abc:d:0123456789");\r
- if (c == EOF)\r
- break;\r
-\r
- switch (c)\r
- {\r
- case '0':\r
- case '1':\r
- case '2':\r
- case '3':\r
- case '4':\r
- case '5':\r
- case '6':\r
- case '7':\r
- case '8':\r
- case '9':\r
- if (digit_optind != 0 && digit_optind != this_option_optind)\r
- printf ("digits occur in two different argv-elements.\n");\r
- digit_optind = this_option_optind;\r
- printf ("option %c\n", c);\r
- break;\r
-\r
- case 'a':\r
- printf ("option a\n");\r
- break;\r
-\r
- case 'b':\r
- printf ("option b\n");\r
- break;\r
-\r
- case 'c':\r
- printf ("option c with value `%s'\n", optarg);\r
- break;\r
-\r
- case '?':\r
- break;\r
-\r
- default:\r
- printf ("?? getopt returned character code 0%o ??\n", c);\r
- }\r
- }\r
-\r
- if (optind < argc)\r
- {\r
- printf ("non-option ARGV-elements: ");\r
- while (optind < argc)\r
- printf ("%s ", argv[optind++]);\r
- printf ("\n");\r
- }\r
-\r
- exit (0);\r
-}\r
-\r
-#endif /* TEST */\r
+/* Getopt for GNU.
+
+ $Id$
+
+ NOTE: getopt is now part of the C library, so if you don't know what
+ "Keep this file name-space clean" means, talk to roland@gnu.ai.mit.edu
+ before changing it!
+
+ Copyright (C) 1987, 88, 89, 90, 91, 92, 1993
+ Free Software Foundation, Inc.
+
+ This program is free software; you can redistribute it and/or modify it
+ under the terms of the GNU General Public License as published by the
+ Free Software Foundation; either version 2, or (at your option) any
+ later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
+
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#ifndef __STDC__
+/* This is a separate conditional since some stdc systems
+ reject `defined (const)'. */
+#ifndef const
+#define const
+#endif
+#endif
+
+/* This tells Alpha OSF/1 not to define a getopt prototype in <stdio.h>. */
+#ifndef _NO_PROTO
+#define _NO_PROTO
+#endif
+
+#include <stdio.h>
+
+/* Comment out all this code if we are using the GNU C Library, and are not
+ actually compiling the library itself. This code is part of the GNU C
+ Library, but also included in many other GNU distributions. Compiling
+ and linking in this code is a waste when using the GNU C library
+ (especially if it is a shared library). Rather than having every GNU
+ program understand `configure --with-gnu-libc' and omit the object files,
+ it is simpler to just do this in the source for each such file. */
+
+#if defined (_LIBC) || !defined (__GNU_LIBRARY__)
+
+
+/* This needs to come after some library #include
+ to get __GNU_LIBRARY__ defined. */
+#ifdef __GNU_LIBRARY__
+/* Don't include stdlib.h for non-GNU C libraries because some of them
+ contain conflicting prototypes for getopt. */
+#include <stdlib.h>
+#endif /* GNU C library. */
+
+/* If GETOPT_COMPAT is defined, `+' as well as `--' can introduce a
+ long-named option. Because this is not POSIX.2 compliant, it is
+ being phased out. */
+/* #define GETOPT_COMPAT */
+
+/* This version of `getopt' appears to the caller like standard Unix `getopt'
+ but it behaves differently for the user, since it allows the user
+ to intersperse the options with the other arguments.
+
+ As `getopt' works, it permutes the elements of ARGV so that,
+ when it is done, all the options precede everything else. Thus
+ all application programs are extended to handle flexible argument order.
+
+ Setting the environment variable POSIXLY_CORRECT disables permutation.
+ Then the behavior is completely standard.
+
+ GNU application programs can use a third alternative mode in which
+ they can distinguish the relative order of options and other arguments. */
+
+#include "getopt.h"
+
+/* For communication from `getopt' to the caller.
+ When `getopt' finds an option that takes an argument,
+ the argument value is returned here.
+ Also, when `ordering' is RETURN_IN_ORDER,
+ each non-option ARGV-element is returned here. */
+
+char *optarg = 0;
+
+/* Index in ARGV of the next element to be scanned.
+ This is used for communication to and from the caller
+ and for communication between successive calls to `getopt'.
+
+ On entry to `getopt', zero means this is the first call; initialize.
+
+ When `getopt' returns EOF, this is the index of the first of the
+ non-option elements that the caller should itself scan.
+
+ Otherwise, `optind' communicates from one call to the next
+ how much of ARGV has been scanned so far. */
+
+/* XXX 1003.2 says this must be 1 before any call. */
+int optind = 0;
+
+/* The next char to be scanned in the option-element
+ in which the last option character we returned was found.
+ This allows us to pick up the scan where we left off.
+
+ If this is zero, or a null string, it means resume the scan
+ by advancing to the next ARGV-element. */
+
+static char *nextchar;
+
+/* Callers store zero here to inhibit the error message
+ for unrecognized options. */
+
+int opterr = 1;
+
+/* Set to an option character which was unrecognized.
+ This must be initialized on some systems to avoid linking in the
+ system's own getopt implementation. */
+
+int optopt = '?';
+
+/* Describe how to deal with options that follow non-option ARGV-elements.
+
+ If the caller did not specify anything,
+ the default is REQUIRE_ORDER if the environment variable
+ POSIXLY_CORRECT is defined, PERMUTE otherwise.
+
+ REQUIRE_ORDER means don't recognize them as options;
+ stop option processing when the first non-option is seen.
+ This is what Unix does.
+ This mode of operation is selected by either setting the environment
+ variable POSIXLY_CORRECT, or using `+' as the first character
+ of the list of option characters.
+
+ PERMUTE is the default. We permute the contents of ARGV as we scan,
+ so that eventually all the non-options are at the end. This allows options
+ to be given in any order, even with programs that were not written to
+ expect this.
+
+ RETURN_IN_ORDER is an option available to programs that were written
+ to expect options and other ARGV-elements in any order and that care about
+ the ordering of the two. We describe each non-option ARGV-element
+ as if it were the argument of an option with character code 1.
+ Using `-' as the first character of the list of option characters
+ selects this mode of operation.
+
+ The special argument `--' forces an end of option-scanning regardless
+ of the value of `ordering'. In the case of RETURN_IN_ORDER, only
+ `--' can cause `getopt' to return EOF with `optind' != ARGC. */
+
+static enum
+{
+ REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER
+} ordering;
+
+#ifdef __GNU_LIBRARY__
+/* We want to avoid inclusion of string.h with non-GNU libraries
+ because there are many ways it can cause trouble.
+ On some systems, it contains special magic macros that don't work
+ in GCC. */
+#include <string.h>
+#define my_index strchr
+#else
+
+/* Avoid depending on library functions or files
+ whose names are inconsistent. */
+
+char *getenv ();
+
+static char *
+my_index (str, chr)
+ const char *str;
+ int chr;
+{
+ while (*str)
+ {
+ if (*str == chr)
+ return (char *) str;
+ str++;
+ }
+ return 0;
+}
+
+/* If using GCC, we can safely declare strlen this way.
+ If not using GCC, it is ok not to declare it.
+ (Supposedly there are some machines where it might get a warning,
+ but changing this conditional to __STDC__ is too risky.) */
+#ifdef __GNUC__
+#ifdef IN_GCC
+#include "gstddef.h"
+#else
+#include <stddef.h>
+#endif
+extern size_t strlen (const char *);
+#endif
+
+#endif /* GNU C library. */
+
+/* Handle permutation of arguments. */
+
+/* Describe the part of ARGV that contains non-options that have
+ been skipped. `first_nonopt' is the index in ARGV of the first of them;
+ `last_nonopt' is the index after the last of them. */
+
+static int first_nonopt;
+static int last_nonopt;
+
+/* Exchange two adjacent subsequences of ARGV.
+ One subsequence is elements [first_nonopt,last_nonopt)
+ which contains all the non-options that have been skipped so far.
+ The other is elements [last_nonopt,optind), which contains all
+ the options processed since those non-options were skipped.
+
+ `first_nonopt' and `last_nonopt' are relocated so that they describe
+ the new indices of the non-options in ARGV after they are moved. */
+
+static void
+exchange (argv)
+ char **argv;
+{
+ int bottom = first_nonopt;
+ int middle = last_nonopt;
+ int top = optind;
+ char *tem;
+
+ /* Exchange the shorter segment with the far end of the longer segment.
+ That puts the shorter segment into the right place.
+ It leaves the longer segment in the right place overall,
+ but it consists of two parts that need to be swapped next. */
+
+ while (top > middle && middle > bottom)
+ {
+ if (top - middle > middle - bottom)
+ {
+ /* Bottom segment is the short one. */
+ int len = middle - bottom;
+ register int i;
+
+ /* Swap it with the top part of the top segment. */
+ for (i = 0; i < len; i++)
+ {
+ tem = argv[bottom + i];
+ argv[bottom + i] = argv[top - (middle - bottom) + i];
+ argv[top - (middle - bottom) + i] = tem;
+ }
+ /* Exclude the moved bottom segment from further swapping. */
+ top -= len;
+ }
+ else
+ {
+ /* Top segment is the short one. */
+ int len = top - middle;
+ register int i;
+
+ /* Swap it with the bottom part of the bottom segment. */
+ for (i = 0; i < len; i++)
+ {
+ tem = argv[bottom + i];
+ argv[bottom + i] = argv[middle + i];
+ argv[middle + i] = tem;
+ }
+ /* Exclude the moved top segment from further swapping. */
+ bottom += len;
+ }
+ }
+
+ /* Update records for the slots the non-options now occupy. */
+
+ first_nonopt += (optind - last_nonopt);
+ last_nonopt = optind;
+}
+
+/* Scan elements of ARGV (whose length is ARGC) for option characters
+ given in OPTSTRING.
+
+ If an element of ARGV starts with '-', and is not exactly "-" or "--",
+ then it is an option element. The characters of this element
+ (aside from the initial '-') are option characters. If `getopt'
+ is called repeatedly, it returns successively each of the option characters
+ from each of the option elements.
+
+ If `getopt' finds another option character, it returns that character,
+ updating `optind' and `nextchar' so that the next call to `getopt' can
+ resume the scan with the following option character or ARGV-element.
+
+ If there are no more option characters, `getopt' returns `EOF'.
+ Then `optind' is the index in ARGV of the first ARGV-element
+ that is not an option. (The ARGV-elements have been permuted
+ so that those that are not options now come last.)
+
+ OPTSTRING is a string containing the legitimate option characters.
+ If an option character is seen that is not listed in OPTSTRING,
+ return '?' after printing an error message. If you set `opterr' to
+ zero, the error message is suppressed but we still return '?'.
+
+ If a char in OPTSTRING is followed by a colon, that means it wants an arg,
+ so the following text in the same ARGV-element, or the text of the following
+ ARGV-element, is returned in `optarg'. Two colons mean an option that
+ wants an optional arg; if there is text in the current ARGV-element,
+ it is returned in `optarg', otherwise `optarg' is set to zero.
+
+ If OPTSTRING starts with `-' or `+', it requests different methods of
+ handling the non-option ARGV-elements.
+ See the comments about RETURN_IN_ORDER and REQUIRE_ORDER, above.
+
+ Long-named options begin with `--' instead of `-'.
+ Their names may be abbreviated as long as the abbreviation is unique
+ or is an exact match for some defined option. If they have an
+ argument, it follows the option name in the same ARGV-element, separated
+ from the option name by a `=', or else the in next ARGV-element.
+ When `getopt' finds a long-named option, it returns 0 if that option's
+ `flag' field is nonzero, the value of the option's `val' field
+ if the `flag' field is zero.
+
+ The elements of ARGV aren't really const, because we permute them.
+ But we pretend they're const in the prototype to be compatible
+ with other systems.
+
+ LONGOPTS is a vector of `struct option' terminated by an
+ element containing a name which is zero.
+
+ LONGIND returns the index in LONGOPT of the long-named option found.
+ It is only valid when a long-named option has been found by the most
+ recent call.
+
+ If LONG_ONLY is nonzero, '-' as well as '--' can introduce
+ long-named options. */
+
+int
+_getopt_internal (argc, argv, optstring, longopts, longind, long_only)
+ int argc;
+ char *const *argv;
+ const char *optstring;
+ const struct option *longopts;
+ int *longind;
+ int long_only;
+{
+ int option_index;
+
+ optarg = 0;
+
+ /* Initialize the internal data when the first call is made.
+ Start processing options with ARGV-element 1 (since ARGV-element 0
+ is the program name); the sequence of previously skipped
+ non-option ARGV-elements is empty. */
+
+ if (optind == 0)
+ {
+ first_nonopt = last_nonopt = optind = 1;
+
+ nextchar = NULL;
+
+ /* Determine how to handle the ordering of options and nonoptions. */
+
+ if (optstring[0] == '-')
+ {
+ ordering = RETURN_IN_ORDER;
+ ++optstring;
+ }
+ else if (optstring[0] == '+')
+ {
+ ordering = REQUIRE_ORDER;
+ ++optstring;
+ }
+ else if (getenv ("POSIXLY_CORRECT") != NULL)
+ ordering = REQUIRE_ORDER;
+ else
+ ordering = PERMUTE;
+ }
+
+ if (nextchar == NULL || *nextchar == '\0')
+ {
+ if (ordering == PERMUTE)
+ {
+ /* If we have just processed some options following some non-options,
+ exchange them so that the options come first. */
+
+ if (first_nonopt != last_nonopt && last_nonopt != optind)
+ exchange ((char **) argv);
+ else if (last_nonopt != optind)
+ first_nonopt = optind;
+
+ /* Now skip any additional non-options
+ and extend the range of non-options previously skipped. */
+
+ while (optind < argc
+ && (argv[optind][0] != '-' || argv[optind][1] == '\0')
+#ifdef GETOPT_COMPAT
+ && (longopts == NULL
+ || argv[optind][0] != '+' || argv[optind][1] == '\0')
+#endif /* GETOPT_COMPAT */
+ )
+ optind++;
+ last_nonopt = optind;
+ }
+
+ /* Special ARGV-element `--' means premature end of options.
+ Skip it like a null option,
+ then exchange with previous non-options as if it were an option,
+ then skip everything else like a non-option. */
+
+ if (optind != argc && !strcmp (argv[optind], "--"))
+ {
+ optind++;
+
+ if (first_nonopt != last_nonopt && last_nonopt != optind)
+ exchange ((char **) argv);
+ else if (first_nonopt == last_nonopt)
+ first_nonopt = optind;
+ last_nonopt = argc;
+
+ optind = argc;
+ }
+
+ /* If we have done all the ARGV-elements, stop the scan
+ and back over any non-options that we skipped and permuted. */
+
+ if (optind == argc)
+ {
+ /* Set the next-arg-index to point at the non-options
+ that we previously skipped, so the caller will digest them. */
+ if (first_nonopt != last_nonopt)
+ optind = first_nonopt;
+ return EOF;
+ }
+
+ /* If we have come to a non-option and did not permute it,
+ either stop the scan or describe it to the caller and pass it by. */
+
+ if ((argv[optind][0] != '-' || argv[optind][1] == '\0')
+#ifdef GETOPT_COMPAT
+ && (longopts == NULL
+ || argv[optind][0] != '+' || argv[optind][1] == '\0')
+#endif /* GETOPT_COMPAT */
+ )
+ {
+ if (ordering == REQUIRE_ORDER)
+ return EOF;
+ optarg = argv[optind++];
+ return 1;
+ }
+
+ /* We have found another option-ARGV-element.
+ Start decoding its characters. */
+
+ nextchar = (argv[optind] + 1
+ + (longopts != NULL && argv[optind][1] == '-'));
+ }
+
+ if (longopts != NULL
+ && ((argv[optind][0] == '-'
+ && (argv[optind][1] == '-' || long_only))
+#ifdef GETOPT_COMPAT
+ || argv[optind][0] == '+'
+#endif /* GETOPT_COMPAT */
+ ))
+ {
+ const struct option *p;
+ char *s = nextchar;
+ int exact = 0;
+ int ambig = 0;
+ const struct option *pfound = NULL;
+ int indfound;
+
+ while (*s && *s != '=')
+ s++;
+
+ /* Test all options for either exact match or abbreviated matches. */
+ for (p = longopts, option_index = 0; p->name;
+ p++, option_index++)
+ if (!strncmp (p->name, nextchar, s - nextchar))
+ {
+ if (s - nextchar == strlen (p->name))
+ {
+ /* Exact match found. */
+ pfound = p;
+ indfound = option_index;
+ exact = 1;
+ break;
+ }
+ else if (pfound == NULL)
+ {
+ /* First nonexact match found. */
+ pfound = p;
+ indfound = option_index;
+ }
+ else
+ /* Second nonexact match found. */
+ ambig = 1;
+ }
+
+ if (ambig && !exact)
+ {
+ if (opterr)
+ fprintf (stderr, "%s: option `%s' is ambiguous\n",
+ argv[0], argv[optind]);
+ nextchar += strlen (nextchar);
+ optind++;
+ return '?';
+ }
+
+ if (pfound != NULL)
+ {
+ option_index = indfound;
+ optind++;
+ if (*s)
+ {
+ /* Don't test has_arg with >, because some C compilers don't
+ allow it to be used on enums. */
+ if (pfound->has_arg)
+ optarg = s + 1;
+ else
+ {
+ if (opterr)
+ {
+ if (argv[optind - 1][1] == '-')
+ /* --option */
+ fprintf (stderr,
+ "%s: option `--%s' doesn't allow an argument\n",
+ argv[0], pfound->name);
+ else
+ /* +option or -option */
+ fprintf (stderr,
+ "%s: option `%c%s' doesn't allow an argument\n",
+ argv[0], argv[optind - 1][0], pfound->name);
+ }
+ nextchar += strlen (nextchar);
+ return '?';
+ }
+ }
+ else if (pfound->has_arg == 1)
+ {
+ if (optind < argc)
+ optarg = argv[optind++];
+ else
+ {
+ if (opterr)
+ fprintf (stderr, "%s: option `%s' requires an argument\n",
+ argv[0], argv[optind - 1]);
+ nextchar += strlen (nextchar);
+ return optstring[0] == ':' ? ':' : '?';
+ }
+ }
+ nextchar += strlen (nextchar);
+ if (longind != NULL)
+ *longind = option_index;
+ if (pfound->flag)
+ {
+ *(pfound->flag) = pfound->val;
+ return 0;
+ }
+ return pfound->val;
+ }
+ /* Can't find it as a long option. If this is not getopt_long_only,
+ or the option starts with '--' or is not a valid short
+ option, then it's an error.
+ Otherwise interpret it as a short option. */
+ if (!long_only || argv[optind][1] == '-'
+#ifdef GETOPT_COMPAT
+ || argv[optind][0] == '+'
+#endif /* GETOPT_COMPAT */
+ || my_index (optstring, *nextchar) == NULL)
+ {
+ if (opterr)
+ {
+ if (argv[optind][1] == '-')
+ /* --option */
+ fprintf (stderr, "%s: unrecognized option `--%s'\n",
+ argv[0], nextchar);
+ else
+ /* +option or -option */
+ fprintf (stderr, "%s: unrecognized option `%c%s'\n",
+ argv[0], argv[optind][0], nextchar);
+ }
+ nextchar = (char *) "";
+ optind++;
+ return '?';
+ }
+ }
+
+ /* Look at and handle the next option-character. */
+
+ {
+ char c = *nextchar++;
+ char *temp = my_index (optstring, c);
+
+ /* Increment `optind' when we start to process its last character. */
+ if (*nextchar == '\0')
+ ++optind;
+
+ if (temp == NULL || c == ':')
+ {
+ if (opterr)
+ {
+#if 0
+ if (c < 040 || c >= 0177)
+ fprintf (stderr, "%s: unrecognized option, character code 0%o\n",
+ argv[0], c);
+ else
+ fprintf (stderr, "%s: unrecognized option `-%c'\n", argv[0], c);
+#else
+ /* 1003.2 specifies the format of this message. */
+ fprintf (stderr, "%s: illegal option -- %c\n", argv[0], c);
+#endif
+ }
+ optopt = c;
+ return '?';
+ }
+ if (temp[1] == ':')
+ {
+ if (temp[2] == ':')
+ {
+ /* This is an option that accepts an argument optionally. */
+ if (*nextchar != '\0')
+ {
+ optarg = nextchar;
+ optind++;
+ }
+ else
+ optarg = 0;
+ nextchar = NULL;
+ }
+ else
+ {
+ /* This is an option that requires an argument. */
+ if (*nextchar != '\0')
+ {
+ optarg = nextchar;
+ /* If we end this ARGV-element by taking the rest as an arg,
+ we must advance to the next element now. */
+ optind++;
+ }
+ else if (optind == argc)
+ {
+ if (opterr)
+ {
+#if 0
+ fprintf (stderr, "%s: option `-%c' requires an argument\n",
+ argv[0], c);
+#else
+ /* 1003.2 specifies the format of this message. */
+ fprintf (stderr, "%s: option requires an argument -- %c\n",
+ argv[0], c);
+#endif
+ }
+ optopt = c;
+ if (optstring[0] == ':')
+ c = ':';
+ else
+ c = '?';
+ }
+ else
+ /* We already incremented `optind' once;
+ increment it again when taking next ARGV-elt as argument. */
+ optarg = argv[optind++];
+ nextchar = NULL;
+ }
+ }
+ return c;
+ }
+}
+
+int
+getopt (argc, argv, optstring)
+ int argc;
+ char *const *argv;
+ const char *optstring;
+{
+ return _getopt_internal (argc, argv, optstring,
+ (const struct option *) 0,
+ (int *) 0,
+ 0);
+}
+
+#endif /* _LIBC or not __GNU_LIBRARY__. */
+
+#ifdef TEST
+
+/* Compile with -DTEST to make an executable for use in testing
+ the above definition of `getopt'. */
+
+int
+main (argc, argv)
+ int argc;
+ char **argv;
+{
+ int c;
+ int digit_optind = 0;
+
+ while (1)
+ {
+ int this_option_optind = optind ? optind : 1;
+
+ c = getopt (argc, argv, "abc:d:0123456789");
+ if (c == EOF)
+ break;
+
+ switch (c)
+ {
+ case '0':
+ case '1':
+ case '2':
+ case '3':
+ case '4':
+ case '5':
+ case '6':
+ case '7':
+ case '8':
+ case '9':
+ if (digit_optind != 0 && digit_optind != this_option_optind)
+ printf ("digits occur in two different argv-elements.\n");
+ digit_optind = this_option_optind;
+ printf ("option %c\n", c);
+ break;
+
+ case 'a':
+ printf ("option a\n");
+ break;
+
+ case 'b':
+ printf ("option b\n");
+ break;
+
+ case 'c':
+ printf ("option c with value `%s'\n", optarg);
+ break;
+
+ case '?':
+ break;
+
+ default:
+ printf ("?? getopt returned character code 0%o ??\n", c);
+ }
+ }
+
+ if (optind < argc)
+ {
+ printf ("non-option ARGV-elements: ");
+ while (optind < argc)
+ printf ("%s ", argv[optind++]);
+ printf ("\n");
+ }
+
+ exit (0);
+}
+
+#endif /* TEST */