Blame lib/getopt.c

Packit Service fdd496
/* Getopt for GNU.
Packit Service fdd496
   Copyright (C) 1987-2017 Free Software Foundation, Inc.
Packit Service fdd496
   This file is part of the GNU C Library and is also part of gnulib.
Packit Service fdd496
   Patches to this file should be submitted to both projects.
Packit Service fdd496
Packit Service fdd496
   The GNU C Library is free software; you can redistribute it and/or
Packit Service fdd496
   modify it under the terms of the GNU General Public
Packit Service fdd496
   License as published by the Free Software Foundation; either
Packit Service fdd496
   version 3 of the License, or (at your option) any later version.
Packit Service fdd496
Packit Service fdd496
   The GNU C Library is distributed in the hope that it will be useful,
Packit Service fdd496
   but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit Service fdd496
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit Service fdd496
   General Public License for more details.
Packit Service fdd496
Packit Service fdd496
   You should have received a copy of the GNU General Public
Packit Service fdd496
   License along with the GNU C Library; if not, see
Packit Service fdd496
   <http://www.gnu.org/licenses/>.  */
Packit Service fdd496

Packit Service fdd496
#ifndef _LIBC
Packit Service fdd496
# include <config.h>
Packit Service fdd496
#endif
Packit Service fdd496
Packit Service fdd496
#include "getopt.h"
Packit Service fdd496
Packit Service fdd496
#include <stdio.h>
Packit Service fdd496
#include <stdlib.h>
Packit Service fdd496
#include <string.h>
Packit Service fdd496
#include <unistd.h>
Packit Service fdd496
Packit Service fdd496
#ifdef _LIBC
Packit Service fdd496
/* When used as part of glibc, error printing must be done differently
Packit Service fdd496
   for standards compliance.  getopt is not a cancellation point, so
Packit Service fdd496
   it must not call functions that are, and it is specified by an
Packit Service fdd496
   older standard than stdio locking, so it must not refer to
Packit Service fdd496
   functions in the "user namespace" related to stdio locking.
Packit Service fdd496
   Finally, it must use glibc's internal message translation so that
Packit Service fdd496
   the messages are looked up in the proper text domain.  */
Packit Service fdd496
# include <libintl.h>
Packit Service fdd496
# define fprintf __fxprintf_nocancel
Packit Service fdd496
# define flockfile(fp) _IO_flockfile (fp)
Packit Service fdd496
# define funlockfile(fp) _IO_funlockfile (fp)
Packit Service fdd496
#else
Packit Service fdd496
# include "gettext.h"
Packit Service fdd496
# define _(msgid) gettext (msgid)
Packit Service fdd496
/* When used standalone, flockfile and funlockfile might not be
Packit Service fdd496
   available.  */
Packit Service fdd496
# if (!defined _POSIX_THREAD_SAFE_FUNCTIONS \
Packit Service fdd496
      || ((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__))
Packit Service fdd496
#  define flockfile(fp) /* nop */
Packit Service fdd496
#  define funlockfile(fp) /* nop */
Packit Service fdd496
# endif
Packit Service fdd496
/* When used standalone, do not attempt to use alloca.  */
Packit Service fdd496
# define __libc_use_alloca(size) 0
Packit Service fdd496
# undef alloca
Packit Service fdd496
# define alloca(size) (abort (), (void *)0)
Packit Service fdd496
#endif
Packit Service fdd496
Packit Service fdd496
/* This implementation of 'getopt' has three modes for handling
Packit Service fdd496
   options interspersed with non-option arguments.  It can stop
Packit Service fdd496
   scanning for options at the first non-option argument encountered,
Packit Service fdd496
   as POSIX specifies.  It can continue scanning for options after the
Packit Service fdd496
   first non-option argument, but permute 'argv' as it goes so that,
Packit Service fdd496
   after 'getopt' is done, all the options precede all the non-option
Packit Service fdd496
   arguments and 'optind' points to the first non-option argument.
Packit Service fdd496
   Or, it can report non-option arguments as if they were arguments to
Packit Service fdd496
   the option character '\x01'.
Packit Service fdd496
Packit Service fdd496
   The default behavior of 'getopt_long' is to permute the argument list.
Packit Service fdd496
   When this implementation is used standalone, the default behavior of
Packit Service fdd496
   'getopt' is to stop at the first non-option argument, but when it is
Packit Service fdd496
   used as part of GNU libc it also permutes the argument list.  In both
Packit Service fdd496
   cases, setting the environment variable POSIXLY_CORRECT to any value
Packit Service fdd496
   disables permutation.
Packit Service fdd496
Packit Service fdd496
   If the first character of the OPTSTRING argument to 'getopt' or
Packit Service fdd496
   'getopt_long' is '+', both functions will stop at the first
Packit Service fdd496
   non-option argument.  If it is '-', both functions will report
Packit Service fdd496
   non-option arguments as arguments to the option character '\x01'.  */
Packit Service fdd496
Packit Service fdd496
#include "getopt_int.h"
Packit Service fdd496
Packit Service fdd496
/* For communication from 'getopt' to the caller.
Packit Service fdd496
   When 'getopt' finds an option that takes an argument,
Packit Service fdd496
   the argument value is returned here.
Packit Service fdd496
   Also, when 'ordering' is RETURN_IN_ORDER,
Packit Service fdd496
   each non-option ARGV-element is returned here.  */
Packit Service fdd496
Packit Service fdd496
char *optarg;
Packit Service fdd496
Packit Service fdd496
/* Index in ARGV of the next element to be scanned.
Packit Service fdd496
   This is used for communication to and from the caller
Packit Service fdd496
   and for communication between successive calls to 'getopt'.
Packit Service fdd496
Packit Service fdd496
   On entry to 'getopt', zero means this is the first call; initialize.
Packit Service fdd496
Packit Service fdd496
   When 'getopt' returns -1, this is the index of the first of the
Packit Service fdd496
   non-option elements that the caller should itself scan.
Packit Service fdd496
Packit Service fdd496
   Otherwise, 'optind' communicates from one call to the next
Packit Service fdd496
   how much of ARGV has been scanned so far.  */
Packit Service fdd496
Packit Service fdd496
/* 1003.2 says this must be 1 before any call.  */
Packit Service fdd496
int optind = 1;
Packit Service fdd496
Packit Service fdd496
/* Callers store zero here to inhibit the error message
Packit Service fdd496
   for unrecognized options.  */
Packit Service fdd496
Packit Service fdd496
int opterr = 1;
Packit Service fdd496
Packit Service fdd496
/* Set to an option character which was unrecognized.
Packit Service fdd496
   This must be initialized on some systems to avoid linking in the
Packit Service fdd496
   system's own getopt implementation.  */
Packit Service fdd496
Packit Service fdd496
int optopt = '?';
Packit Service fdd496
Packit Service fdd496
/* Keep a global copy of all internal members of getopt_data.  */
Packit Service fdd496
Packit Service fdd496
static struct _getopt_data getopt_data;
Packit Service fdd496

Packit Service fdd496
/* Exchange two adjacent subsequences of ARGV.
Packit Service fdd496
   One subsequence is elements [first_nonopt,last_nonopt)
Packit Service fdd496
   which contains all the non-options that have been skipped so far.
Packit Service fdd496
   The other is elements [last_nonopt,optind), which contains all
Packit Service fdd496
   the options processed since those non-options were skipped.
Packit Service fdd496
Packit Service fdd496
   'first_nonopt' and 'last_nonopt' are relocated so that they describe
Packit Service fdd496
   the new indices of the non-options in ARGV after they are moved.  */
Packit Service fdd496
Packit Service fdd496
static void
Packit Service fdd496
exchange (char **argv, struct _getopt_data *d)
Packit Service fdd496
{
Packit Service fdd496
  int bottom = d->__first_nonopt;
Packit Service fdd496
  int middle = d->__last_nonopt;
Packit Service fdd496
  int top = d->optind;
Packit Service fdd496
  char *tem;
Packit Service fdd496
Packit Service fdd496
  /* Exchange the shorter segment with the far end of the longer segment.
Packit Service fdd496
     That puts the shorter segment into the right place.
Packit Service fdd496
     It leaves the longer segment in the right place overall,
Packit Service fdd496
     but it consists of two parts that need to be swapped next.  */
Packit Service fdd496
Packit Service fdd496
  while (top > middle && middle > bottom)
Packit Service fdd496
    {
Packit Service fdd496
      if (top - middle > middle - bottom)
Packit Service fdd496
	{
Packit Service fdd496
	  /* Bottom segment is the short one.  */
Packit Service fdd496
	  int len = middle - bottom;
Packit Service fdd496
	  int i;
Packit Service fdd496
Packit Service fdd496
	  /* Swap it with the top part of the top segment.  */
Packit Service fdd496
	  for (i = 0; i < len; i++)
Packit Service fdd496
	    {
Packit Service fdd496
	      tem = argv[bottom + i];
Packit Service fdd496
	      argv[bottom + i] = argv[top - (middle - bottom) + i];
Packit Service fdd496
	      argv[top - (middle - bottom) + i] = tem;
Packit Service fdd496
	    }
Packit Service fdd496
	  /* Exclude the moved bottom segment from further swapping.  */
Packit Service fdd496
	  top -= len;
Packit Service fdd496
	}
Packit Service fdd496
      else
Packit Service fdd496
	{
Packit Service fdd496
	  /* Top segment is the short one.  */
Packit Service fdd496
	  int len = top - middle;
Packit Service fdd496
	  int i;
Packit Service fdd496
Packit Service fdd496
	  /* Swap it with the bottom part of the bottom segment.  */
Packit Service fdd496
	  for (i = 0; i < len; i++)
Packit Service fdd496
	    {
Packit Service fdd496
	      tem = argv[bottom + i];
Packit Service fdd496
	      argv[bottom + i] = argv[middle + i];
Packit Service fdd496
	      argv[middle + i] = tem;
Packit Service fdd496
	    }
Packit Service fdd496
	  /* Exclude the moved top segment from further swapping.  */
Packit Service fdd496
	  bottom += len;
Packit Service fdd496
	}
Packit Service fdd496
    }
Packit Service fdd496
Packit Service fdd496
  /* Update records for the slots the non-options now occupy.  */
Packit Service fdd496
Packit Service fdd496
  d->__first_nonopt += (d->optind - d->__last_nonopt);
Packit Service fdd496
  d->__last_nonopt = d->optind;
Packit Service fdd496
}
Packit Service fdd496
Packit Service fdd496
/* Process the argument starting with d->__nextchar as a long option.
Packit Service fdd496
   d->optind should *not* have been advanced over this argument.
Packit Service fdd496
Packit Service fdd496
   If the value returned is -1, it was not actually a long option, the
Packit Service fdd496
   state is unchanged, and the argument should be processed as a set
Packit Service fdd496
   of short options (this can only happen when long_only is true).
Packit Service fdd496
   Otherwise, the option (and its argument, if any) have been consumed
Packit Service fdd496
   and the return value is the value to return from _getopt_internal_r.  */
Packit Service fdd496
static int
Packit Service fdd496
process_long_option (int argc, char **argv, const char *optstring,
Packit Service fdd496
		     const struct option *longopts, int *longind,
Packit Service fdd496
		     int long_only, struct _getopt_data *d,
Packit Service fdd496
		     int print_errors, const char *prefix)
Packit Service fdd496
{
Packit Service fdd496
  char *nameend;
Packit Service fdd496
  size_t namelen;
Packit Service fdd496
  const struct option *p;
Packit Service fdd496
  const struct option *pfound = NULL;
Packit Service fdd496
  int n_options;
Packit Service fdd496
  int option_index;
Packit Service fdd496
Packit Service fdd496
  for (nameend = d->__nextchar; *nameend && *nameend != '='; nameend++)
Packit Service fdd496
    /* Do nothing.  */ ;
Packit Service fdd496
  namelen = nameend - d->__nextchar;
Packit Service fdd496
Packit Service fdd496
  /* First look for an exact match, counting the options as a side
Packit Service fdd496
     effect.  */
Packit Service fdd496
  for (p = longopts, n_options = 0; p->name; p++, n_options++)
Packit Service fdd496
    if (!strncmp (p->name, d->__nextchar, namelen)
Packit Service fdd496
	&& namelen == strlen (p->name))
Packit Service fdd496
      {
Packit Service fdd496
	/* Exact match found.  */
Packit Service fdd496
	pfound = p;
Packit Service fdd496
	option_index = n_options;
Packit Service fdd496
	break;
Packit Service fdd496
      }
Packit Service fdd496
Packit Service fdd496
  if (pfound == NULL)
Packit Service fdd496
    {
Packit Service fdd496
      /* Didn't find an exact match, so look for abbreviations.  */
Packit Service fdd496
      unsigned char *ambig_set = NULL;
Packit Service fdd496
      int ambig_malloced = 0;
Packit Service fdd496
      int ambig_fallback = 0;
Packit Service fdd496
      int indfound = -1;
Packit Service fdd496
Packit Service fdd496
      for (p = longopts, option_index = 0; p->name; p++, option_index++)
Packit Service fdd496
	if (!strncmp (p->name, d->__nextchar, namelen))
Packit Service fdd496
	  {
Packit Service fdd496
	    if (pfound == NULL)
Packit Service fdd496
	      {
Packit Service fdd496
		/* First nonexact match found.  */
Packit Service fdd496
		pfound = p;
Packit Service fdd496
		indfound = option_index;
Packit Service fdd496
	      }
Packit Service fdd496
	    else if (long_only
Packit Service fdd496
		     || pfound->has_arg != p->has_arg
Packit Service fdd496
		     || pfound->flag != p->flag
Packit Service fdd496
		     || pfound->val != p->val)
Packit Service fdd496
	      {
Packit Service fdd496
		/* Second or later nonexact match found.  */
Packit Service fdd496
		if (!ambig_fallback)
Packit Service fdd496
		  {
Packit Service fdd496
		    if (!print_errors)
Packit Service fdd496
		      /* Don't waste effort tracking the ambig set if
Packit Service fdd496
			 we're not going to print it anyway.  */
Packit Service fdd496
		      ambig_fallback = 1;
Packit Service fdd496
		    else if (!ambig_set)
Packit Service fdd496
		      {
Packit Service fdd496
			if (__libc_use_alloca (n_options))
Packit Service fdd496
			  ambig_set = alloca (n_options);
Packit Service fdd496
			else if ((ambig_set = malloc (n_options)) == NULL)
Packit Service fdd496
			  /* Fall back to simpler error message.  */
Packit Service fdd496
			  ambig_fallback = 1;
Packit Service fdd496
			else
Packit Service fdd496
			  ambig_malloced = 1;
Packit Service fdd496
Packit Service fdd496
			if (ambig_set)
Packit Service fdd496
			  {
Packit Service fdd496
			    memset (ambig_set, 0, n_options);
Packit Service fdd496
			    ambig_set[indfound] = 1;
Packit Service fdd496
			  }
Packit Service fdd496
		      }
Packit Service fdd496
		    if (ambig_set)
Packit Service fdd496
		      ambig_set[option_index] = 1;
Packit Service fdd496
		  }
Packit Service fdd496
	      }
Packit Service fdd496
	  }
Packit Service fdd496
Packit Service fdd496
      if (ambig_set || ambig_fallback)
Packit Service fdd496
	{
Packit Service fdd496
	  if (print_errors)
Packit Service fdd496
	    {
Packit Service fdd496
	      if (ambig_fallback)
Packit Service fdd496
		fprintf (stderr, _("%s: option '%s%s' is ambiguous\n"),
Packit Service fdd496
			 argv[0], prefix, d->__nextchar);
Packit Service fdd496
	      else
Packit Service fdd496
		{
Packit Service fdd496
		  flockfile (stderr);
Packit Service fdd496
		  fprintf (stderr,
Packit Service fdd496
			   _("%s: option '%s%s' is ambiguous; possibilities:"),
Packit Service fdd496
			   argv[0], prefix, d->__nextchar);
Packit Service fdd496
Packit Service fdd496
		  for (option_index = 0; option_index < n_options; option_index++)
Packit Service fdd496
		    if (ambig_set[option_index])
Packit Service fdd496
		      fprintf (stderr, " '%s%s'",
Packit Service fdd496
			       prefix, longopts[option_index].name);
Packit Service fdd496
Packit Service fdd496
		  /* This must use 'fprintf' even though it's only
Packit Service fdd496
		     printing a single character, so that it goes through
Packit Service fdd496
		     __fxprintf_nocancel when compiled as part of glibc.  */
Packit Service fdd496
		  fprintf (stderr, "\n");
Packit Service fdd496
		  funlockfile (stderr);
Packit Service fdd496
		}
Packit Service fdd496
	    }
Packit Service fdd496
	  if (ambig_malloced)
Packit Service fdd496
	    free (ambig_set);
Packit Service fdd496
	  d->__nextchar += strlen (d->__nextchar);
Packit Service fdd496
	  d->optind++;
Packit Service fdd496
	  d->optopt = 0;
Packit Service fdd496
	  return '?';
Packit Service fdd496
	}
Packit Service fdd496
Packit Service fdd496
      option_index = indfound;
Packit Service fdd496
    }
Packit Service fdd496
Packit Service fdd496
  if (pfound == NULL)
Packit Service fdd496
    {
Packit Service fdd496
      /* Can't find it as a long option.  If this is not getopt_long_only,
Packit Service fdd496
	 or the option starts with '--' or is not a valid short option,
Packit Service fdd496
	 then it's an error.  */
Packit Service fdd496
      if (!long_only || argv[d->optind][1] == '-'
Packit Service fdd496
	  || strchr (optstring, *d->__nextchar) == NULL)
Packit Service fdd496
	{
Packit Service fdd496
	  if (print_errors)
Packit Service fdd496
	    fprintf (stderr, _("%s: unrecognized option '%s%s'\n"),
Packit Service fdd496
		     argv[0], prefix, d->__nextchar);
Packit Service fdd496
Packit Service fdd496
	  d->__nextchar = NULL;
Packit Service fdd496
	  d->optind++;
Packit Service fdd496
	  d->optopt = 0;
Packit Service fdd496
	  return '?';
Packit Service fdd496
	}
Packit Service fdd496
Packit Service fdd496
      /* Otherwise interpret it as a short option.  */
Packit Service fdd496
      return -1;
Packit Service fdd496
    }
Packit Service fdd496
Packit Service fdd496
  /* We have found a matching long option.  Consume it.  */
Packit Service fdd496
  d->optind++;
Packit Service fdd496
  d->__nextchar = NULL;
Packit Service fdd496
  if (*nameend)
Packit Service fdd496
    {
Packit Service fdd496
      /* Don't test has_arg with >, because some C compilers don't
Packit Service fdd496
	 allow it to be used on enums.  */
Packit Service fdd496
      if (pfound->has_arg)
Packit Service fdd496
	d->optarg = nameend + 1;
Packit Service fdd496
      else
Packit Service fdd496
	{
Packit Service fdd496
	  if (print_errors)
Packit Service fdd496
	    fprintf (stderr,
Packit Service fdd496
		     _("%s: option '%s%s' doesn't allow an argument\n"),
Packit Service fdd496
		     argv[0], prefix, pfound->name);
Packit Service fdd496
Packit Service fdd496
	  d->optopt = pfound->val;
Packit Service fdd496
	  return '?';
Packit Service fdd496
	}
Packit Service fdd496
    }
Packit Service fdd496
  else if (pfound->has_arg == 1)
Packit Service fdd496
    {
Packit Service fdd496
      if (d->optind < argc)
Packit Service fdd496
	d->optarg = argv[d->optind++];
Packit Service fdd496
      else
Packit Service fdd496
	{
Packit Service fdd496
	  if (print_errors)
Packit Service fdd496
	    fprintf (stderr,
Packit Service fdd496
		     _("%s: option '%s%s' requires an argument\n"),
Packit Service fdd496
		     argv[0], prefix, pfound->name);
Packit Service fdd496
Packit Service fdd496
	  d->optopt = pfound->val;
Packit Service fdd496
	  return optstring[0] == ':' ? ':' : '?';
Packit Service fdd496
	}
Packit Service fdd496
    }
Packit Service fdd496
Packit Service fdd496
  if (longind != NULL)
Packit Service fdd496
    *longind = option_index;
Packit Service fdd496
  if (pfound->flag)
Packit Service fdd496
    {
Packit Service fdd496
      *(pfound->flag) = pfound->val;
Packit Service fdd496
      return 0;
Packit Service fdd496
    }
Packit Service fdd496
  return pfound->val;
Packit Service fdd496
}
Packit Service fdd496
Packit Service fdd496
/* Initialize internal data upon the first call to getopt.  */
Packit Service fdd496
Packit Service fdd496
static const char *
Packit Service fdd496
_getopt_initialize (int argc _GL_UNUSED,
Packit Service fdd496
		    char **argv _GL_UNUSED, const char *optstring,
Packit Service fdd496
		    struct _getopt_data *d, int posixly_correct)
Packit Service fdd496
{
Packit Service fdd496
  /* Start processing options with ARGV-element 1 (since ARGV-element 0
Packit Service fdd496
     is the program name); the sequence of previously skipped
Packit Service fdd496
     non-option ARGV-elements is empty.  */
Packit Service fdd496
  if (d->optind == 0)
Packit Service fdd496
    d->optind = 1;
Packit Service fdd496
Packit Service fdd496
  d->__first_nonopt = d->__last_nonopt = d->optind;
Packit Service fdd496
  d->__nextchar = NULL;
Packit Service fdd496
Packit Service fdd496
  /* Determine how to handle the ordering of options and nonoptions.  */
Packit Service fdd496
  if (optstring[0] == '-')
Packit Service fdd496
    {
Packit Service fdd496
      d->__ordering = RETURN_IN_ORDER;
Packit Service fdd496
      ++optstring;
Packit Service fdd496
    }
Packit Service fdd496
  else if (optstring[0] == '+')
Packit Service fdd496
    {
Packit Service fdd496
      d->__ordering = REQUIRE_ORDER;
Packit Service fdd496
      ++optstring;
Packit Service fdd496
    }
Packit Service fdd496
  else if (posixly_correct || !!getenv ("POSIXLY_CORRECT"))
Packit Service fdd496
    d->__ordering = REQUIRE_ORDER;
Packit Service fdd496
  else
Packit Service fdd496
    d->__ordering = PERMUTE;
Packit Service fdd496
Packit Service fdd496
  d->__initialized = 1;
Packit Service fdd496
  return optstring;
Packit Service fdd496
}
Packit Service fdd496

Packit Service fdd496
/* Scan elements of ARGV (whose length is ARGC) for option characters
Packit Service fdd496
   given in OPTSTRING.
Packit Service fdd496
Packit Service fdd496
   If an element of ARGV starts with '-', and is not exactly "-" or "--",
Packit Service fdd496
   then it is an option element.  The characters of this element
Packit Service fdd496
   (aside from the initial '-') are option characters.  If 'getopt'
Packit Service fdd496
   is called repeatedly, it returns successively each of the option characters
Packit Service fdd496
   from each of the option elements.
Packit Service fdd496
Packit Service fdd496
   If 'getopt' finds another option character, it returns that character,
Packit Service fdd496
   updating 'optind' and 'nextchar' so that the next call to 'getopt' can
Packit Service fdd496
   resume the scan with the following option character or ARGV-element.
Packit Service fdd496
Packit Service fdd496
   If there are no more option characters, 'getopt' returns -1.
Packit Service fdd496
   Then 'optind' is the index in ARGV of the first ARGV-element
Packit Service fdd496
   that is not an option.  (The ARGV-elements have been permuted
Packit Service fdd496
   so that those that are not options now come last.)
Packit Service fdd496
Packit Service fdd496
   OPTSTRING is a string containing the legitimate option characters.
Packit Service fdd496
   If an option character is seen that is not listed in OPTSTRING,
Packit Service fdd496
   return '?' after printing an error message.  If you set 'opterr' to
Packit Service fdd496
   zero, the error message is suppressed but we still return '?'.
Packit Service fdd496
Packit Service fdd496
   If a char in OPTSTRING is followed by a colon, that means it wants an arg,
Packit Service fdd496
   so the following text in the same ARGV-element, or the text of the following
Packit Service fdd496
   ARGV-element, is returned in 'optarg'.  Two colons mean an option that
Packit Service fdd496
   wants an optional arg; if there is text in the current ARGV-element,
Packit Service fdd496
   it is returned in 'optarg', otherwise 'optarg' is set to zero.
Packit Service fdd496
Packit Service fdd496
   If OPTSTRING starts with '-' or '+', it requests different methods of
Packit Service fdd496
   handling the non-option ARGV-elements.
Packit Service fdd496
   See the comments about RETURN_IN_ORDER and REQUIRE_ORDER, above.
Packit Service fdd496
Packit Service fdd496
   Long-named options begin with '--' instead of '-'.
Packit Service fdd496
   Their names may be abbreviated as long as the abbreviation is unique
Packit Service fdd496
   or is an exact match for some defined option.  If they have an
Packit Service fdd496
   argument, it follows the option name in the same ARGV-element, separated
Packit Service fdd496
   from the option name by a '=', or else the in next ARGV-element.
Packit Service fdd496
   When 'getopt' finds a long-named option, it returns 0 if that option's
Packit Service fdd496
   'flag' field is nonzero, the value of the option's 'val' field
Packit Service fdd496
   if the 'flag' field is zero.
Packit Service fdd496
Packit Service fdd496
   The elements of ARGV aren't really const, because we permute them.
Packit Service fdd496
   But we pretend they're const in the prototype to be compatible
Packit Service fdd496
   with other systems.
Packit Service fdd496
Packit Service fdd496
   LONGOPTS is a vector of 'struct option' terminated by an
Packit Service fdd496
   element containing a name which is zero.
Packit Service fdd496
Packit Service fdd496
   LONGIND returns the index in LONGOPT of the long-named option found.
Packit Service fdd496
   It is only valid when a long-named option has been found by the most
Packit Service fdd496
   recent call.
Packit Service fdd496
Packit Service fdd496
   If LONG_ONLY is nonzero, '-' as well as '--' can introduce
Packit Service fdd496
   long-named options.  */
Packit Service fdd496
Packit Service fdd496
int
Packit Service fdd496
_getopt_internal_r (int argc, char **argv, const char *optstring,
Packit Service fdd496
		    const struct option *longopts, int *longind,
Packit Service fdd496
		    int long_only, struct _getopt_data *d, int posixly_correct)
Packit Service fdd496
{
Packit Service fdd496
  int print_errors = d->opterr;
Packit Service fdd496
Packit Service fdd496
  if (argc < 1)
Packit Service fdd496
    return -1;
Packit Service fdd496
Packit Service fdd496
  d->optarg = NULL;
Packit Service fdd496
Packit Service fdd496
  if (d->optind == 0 || !d->__initialized)
Packit Service fdd496
    optstring = _getopt_initialize (argc, argv, optstring, d, posixly_correct);
Packit Service fdd496
  else if (optstring[0] == '-' || optstring[0] == '+')
Packit Service fdd496
    optstring++;
Packit Service fdd496
Packit Service fdd496
  if (optstring[0] == ':')
Packit Service fdd496
    print_errors = 0;
Packit Service fdd496
Packit Service fdd496
  /* Test whether ARGV[optind] points to a non-option argument.  */
Packit Service fdd496
#define NONOPTION_P (argv[d->optind][0] != '-' || argv[d->optind][1] == '\0')
Packit Service fdd496
Packit Service fdd496
  if (d->__nextchar == NULL || *d->__nextchar == '\0')
Packit Service fdd496
    {
Packit Service fdd496
      /* Advance to the next ARGV-element.  */
Packit Service fdd496
Packit Service fdd496
      /* Give FIRST_NONOPT & LAST_NONOPT rational values if OPTIND has been
Packit Service fdd496
	 moved back by the user (who may also have changed the arguments).  */
Packit Service fdd496
      if (d->__last_nonopt > d->optind)
Packit Service fdd496
	d->__last_nonopt = d->optind;
Packit Service fdd496
      if (d->__first_nonopt > d->optind)
Packit Service fdd496
	d->__first_nonopt = d->optind;
Packit Service fdd496
Packit Service fdd496
      if (d->__ordering == PERMUTE)
Packit Service fdd496
	{
Packit Service fdd496
	  /* If we have just processed some options following some non-options,
Packit Service fdd496
	     exchange them so that the options come first.  */
Packit Service fdd496
Packit Service fdd496
	  if (d->__first_nonopt != d->__last_nonopt
Packit Service fdd496
	      && d->__last_nonopt != d->optind)
Packit Service fdd496
	    exchange (argv, d);
Packit Service fdd496
	  else if (d->__last_nonopt != d->optind)
Packit Service fdd496
	    d->__first_nonopt = d->optind;
Packit Service fdd496
Packit Service fdd496
	  /* Skip any additional non-options
Packit Service fdd496
	     and extend the range of non-options previously skipped.  */
Packit Service fdd496
Packit Service fdd496
	  while (d->optind < argc && NONOPTION_P)
Packit Service fdd496
	    d->optind++;
Packit Service fdd496
	  d->__last_nonopt = d->optind;
Packit Service fdd496
	}
Packit Service fdd496
Packit Service fdd496
      /* The special ARGV-element '--' means premature end of options.
Packit Service fdd496
	 Skip it like a null option,
Packit Service fdd496
	 then exchange with previous non-options as if it were an option,
Packit Service fdd496
	 then skip everything else like a non-option.  */
Packit Service fdd496
Packit Service fdd496
      if (d->optind != argc && !strcmp (argv[d->optind], "--"))
Packit Service fdd496
	{
Packit Service fdd496
	  d->optind++;
Packit Service fdd496
Packit Service fdd496
	  if (d->__first_nonopt != d->__last_nonopt
Packit Service fdd496
	      && d->__last_nonopt != d->optind)
Packit Service fdd496
	    exchange (argv, d);
Packit Service fdd496
	  else if (d->__first_nonopt == d->__last_nonopt)
Packit Service fdd496
	    d->__first_nonopt = d->optind;
Packit Service fdd496
	  d->__last_nonopt = argc;
Packit Service fdd496
Packit Service fdd496
	  d->optind = argc;
Packit Service fdd496
	}
Packit Service fdd496
Packit Service fdd496
      /* If we have done all the ARGV-elements, stop the scan
Packit Service fdd496
	 and back over any non-options that we skipped and permuted.  */
Packit Service fdd496
Packit Service fdd496
      if (d->optind == argc)
Packit Service fdd496
	{
Packit Service fdd496
	  /* Set the next-arg-index to point at the non-options
Packit Service fdd496
	     that we previously skipped, so the caller will digest them.  */
Packit Service fdd496
	  if (d->__first_nonopt != d->__last_nonopt)
Packit Service fdd496
	    d->optind = d->__first_nonopt;
Packit Service fdd496
	  return -1;
Packit Service fdd496
	}
Packit Service fdd496
Packit Service fdd496
      /* If we have come to a non-option and did not permute it,
Packit Service fdd496
	 either stop the scan or describe it to the caller and pass it by.  */
Packit Service fdd496
Packit Service fdd496
      if (NONOPTION_P)
Packit Service fdd496
	{
Packit Service fdd496
	  if (d->__ordering == REQUIRE_ORDER)
Packit Service fdd496
	    return -1;
Packit Service fdd496
	  d->optarg = argv[d->optind++];
Packit Service fdd496
	  return 1;
Packit Service fdd496
	}
Packit Service fdd496
Packit Service fdd496
      /* We have found another option-ARGV-element.
Packit Service fdd496
	 Check whether it might be a long option.  */
Packit Service fdd496
      if (longopts)
Packit Service fdd496
	{
Packit Service fdd496
	  if (argv[d->optind][1] == '-')
Packit Service fdd496
	    {
Packit Service fdd496
	      /* "--foo" is always a long option.  The special option
Packit Service fdd496
		 "--" was handled above.  */
Packit Service fdd496
	      d->__nextchar = argv[d->optind] + 2;
Packit Service fdd496
	      return process_long_option (argc, argv, optstring, longopts,
Packit Service fdd496
					  longind, long_only, d,
Packit Service fdd496
					  print_errors, "--");
Packit Service fdd496
	    }
Packit Service fdd496
Packit Service fdd496
	  /* If long_only and the ARGV-element has the form "-f",
Packit Service fdd496
	     where f is a valid short option, don't consider it an
Packit Service fdd496
	     abbreviated form of a long option that starts with f.
Packit Service fdd496
	     Otherwise there would be no way to give the -f short
Packit Service fdd496
	     option.
Packit Service fdd496
Packit Service fdd496
	     On the other hand, if there's a long option "fubar" and
Packit Service fdd496
	     the ARGV-element is "-fu", do consider that an
Packit Service fdd496
	     abbreviation of the long option, just like "--fu", and
Packit Service fdd496
	     not "-f" with arg "u".
Packit Service fdd496
Packit Service fdd496
	     This distinction seems to be the most useful approach.  */
Packit Service fdd496
	  if (long_only && (argv[d->optind][2]
Packit Service fdd496
			    || !strchr (optstring, argv[d->optind][1])))
Packit Service fdd496
	    {
Packit Service fdd496
	      int code;
Packit Service fdd496
	      d->__nextchar = argv[d->optind] + 1;
Packit Service fdd496
	      code = process_long_option (argc, argv, optstring, longopts,
Packit Service fdd496
					  longind, long_only, d,
Packit Service fdd496
					  print_errors, "-");
Packit Service fdd496
	      if (code != -1)
Packit Service fdd496
		return code;
Packit Service fdd496
	    }
Packit Service fdd496
	}
Packit Service fdd496
Packit Service fdd496
      /* It is not a long option.  Skip the initial punctuation.  */
Packit Service fdd496
      d->__nextchar = argv[d->optind] + 1;
Packit Service fdd496
    }
Packit Service fdd496
Packit Service fdd496
  /* Look at and handle the next short option-character.  */
Packit Service fdd496
Packit Service fdd496
  {
Packit Service fdd496
    char c = *d->__nextchar++;
Packit Service fdd496
    const char *temp = strchr (optstring, c);
Packit Service fdd496
Packit Service fdd496
    /* Increment 'optind' when we start to process its last character.  */
Packit Service fdd496
    if (*d->__nextchar == '\0')
Packit Service fdd496
      ++d->optind;
Packit Service fdd496
Packit Service fdd496
    if (temp == NULL || c == ':' || c == ';')
Packit Service fdd496
      {
Packit Service fdd496
	if (print_errors)
Packit Service fdd496
	  fprintf (stderr, _("%s: invalid option -- '%c'\n"), argv[0], c);
Packit Service fdd496
	d->optopt = c;
Packit Service fdd496
	return '?';
Packit Service fdd496
      }
Packit Service fdd496
Packit Service fdd496
    /* Convenience. Treat POSIX -W foo same as long option --foo */
Packit Service fdd496
    if (temp[0] == 'W' && temp[1] == ';' && longopts != NULL)
Packit Service fdd496
      {
Packit Service fdd496
	/* This is an option that requires an argument.  */
Packit Service fdd496
	if (*d->__nextchar != '\0')
Packit Service fdd496
	  d->optarg = d->__nextchar;
Packit Service fdd496
	else if (d->optind == argc)
Packit Service fdd496
	  {
Packit Service fdd496
	    if (print_errors)
Packit Service fdd496
	      fprintf (stderr,
Packit Service fdd496
		       _("%s: option requires an argument -- '%c'\n"),
Packit Service fdd496
		       argv[0], c);
Packit Service fdd496
Packit Service fdd496
	    d->optopt = c;
Packit Service fdd496
	    if (optstring[0] == ':')
Packit Service fdd496
	      c = ':';
Packit Service fdd496
	    else
Packit Service fdd496
	      c = '?';
Packit Service fdd496
	    return c;
Packit Service fdd496
	  }
Packit Service fdd496
	else
Packit Service fdd496
	  d->optarg = argv[d->optind];
Packit Service fdd496
Packit Service fdd496
	d->__nextchar = d->optarg;
Packit Service fdd496
	d->optarg = NULL;
Packit Service fdd496
	return process_long_option (argc, argv, optstring, longopts, longind,
Packit Service fdd496
				    0 /* long_only */, d, print_errors, "-W ");
Packit Service fdd496
      }
Packit Service fdd496
    if (temp[1] == ':')
Packit Service fdd496
      {
Packit Service fdd496
	if (temp[2] == ':')
Packit Service fdd496
	  {
Packit Service fdd496
	    /* This is an option that accepts an argument optionally.  */
Packit Service fdd496
	    if (*d->__nextchar != '\0')
Packit Service fdd496
	      {
Packit Service fdd496
		d->optarg = d->__nextchar;
Packit Service fdd496
		d->optind++;
Packit Service fdd496
	      }
Packit Service fdd496
	    else
Packit Service fdd496
	      d->optarg = NULL;
Packit Service fdd496
	    d->__nextchar = NULL;
Packit Service fdd496
	  }
Packit Service fdd496
	else
Packit Service fdd496
	  {
Packit Service fdd496
	    /* This is an option that requires an argument.  */
Packit Service fdd496
	    if (*d->__nextchar != '\0')
Packit Service fdd496
	      {
Packit Service fdd496
		d->optarg = d->__nextchar;
Packit Service fdd496
		/* If we end this ARGV-element by taking the rest as an arg,
Packit Service fdd496
		   we must advance to the next element now.  */
Packit Service fdd496
		d->optind++;
Packit Service fdd496
	      }
Packit Service fdd496
	    else if (d->optind == argc)
Packit Service fdd496
	      {
Packit Service fdd496
		if (print_errors)
Packit Service fdd496
		  fprintf (stderr,
Packit Service fdd496
			   _("%s: option requires an argument -- '%c'\n"),
Packit Service fdd496
			   argv[0], c);
Packit Service fdd496
Packit Service fdd496
		d->optopt = c;
Packit Service fdd496
		if (optstring[0] == ':')
Packit Service fdd496
		  c = ':';
Packit Service fdd496
		else
Packit Service fdd496
		  c = '?';
Packit Service fdd496
	      }
Packit Service fdd496
	    else
Packit Service fdd496
	      /* We already incremented 'optind' once;
Packit Service fdd496
		 increment it again when taking next ARGV-elt as argument.  */
Packit Service fdd496
	      d->optarg = argv[d->optind++];
Packit Service fdd496
	    d->__nextchar = NULL;
Packit Service fdd496
	  }
Packit Service fdd496
      }
Packit Service fdd496
    return c;
Packit Service fdd496
  }
Packit Service fdd496
}
Packit Service fdd496
Packit Service fdd496
int
Packit Service fdd496
_getopt_internal (int argc, char **argv, const char *optstring,
Packit Service fdd496
		  const struct option *longopts, int *longind, int long_only,
Packit Service fdd496
		  int posixly_correct)
Packit Service fdd496
{
Packit Service fdd496
  int result;
Packit Service fdd496
Packit Service fdd496
  getopt_data.optind = optind;
Packit Service fdd496
  getopt_data.opterr = opterr;
Packit Service fdd496
Packit Service fdd496
  result = _getopt_internal_r (argc, argv, optstring, longopts,
Packit Service fdd496
			       longind, long_only, &getopt_data,
Packit Service fdd496
			       posixly_correct);
Packit Service fdd496
Packit Service fdd496
  optind = getopt_data.optind;
Packit Service fdd496
  optarg = getopt_data.optarg;
Packit Service fdd496
  optopt = getopt_data.optopt;
Packit Service fdd496
Packit Service fdd496
  return result;
Packit Service fdd496
}
Packit Service fdd496
Packit Service fdd496
/* glibc gets a LSB-compliant getopt and a POSIX-complaint __posix_getopt.
Packit Service fdd496
   Standalone applications just get a POSIX-compliant getopt.
Packit Service fdd496
   POSIX and LSB both require these functions to take 'char *const *argv'
Packit Service fdd496
   even though this is incorrect (because of the permutation).  */
Packit Service fdd496
#define GETOPT_ENTRY(NAME, POSIXLY_CORRECT)			\
Packit Service fdd496
  int								\
Packit Service fdd496
  NAME (int argc, char *const *argv, const char *optstring)	\
Packit Service fdd496
  {								\
Packit Service fdd496
    return _getopt_internal (argc, (char **)argv, optstring,	\
Packit Service fdd496
			     0, 0, 0, POSIXLY_CORRECT);		\
Packit Service fdd496
  }
Packit Service fdd496
Packit Service fdd496
#ifdef _LIBC
Packit Service fdd496
GETOPT_ENTRY(getopt, 0)
Packit Service fdd496
GETOPT_ENTRY(__posix_getopt, 1)
Packit Service fdd496
#else
Packit Service fdd496
GETOPT_ENTRY(getopt, 1)
Packit Service fdd496
#endif
Packit Service fdd496
Packit Service fdd496

Packit Service fdd496
#ifdef TEST
Packit Service fdd496
Packit Service fdd496
/* Compile with -DTEST to make an executable for use in testing
Packit Service fdd496
   the above definition of 'getopt'.  */
Packit Service fdd496
Packit Service fdd496
int
Packit Service fdd496
main (int argc, char **argv)
Packit Service fdd496
{
Packit Service fdd496
  int c;
Packit Service fdd496
  int digit_optind = 0;
Packit Service fdd496
Packit Service fdd496
  while (1)
Packit Service fdd496
    {
Packit Service fdd496
      int this_option_optind = optind ? optind : 1;
Packit Service fdd496
Packit Service fdd496
      c = getopt (argc, argv, "abc:d:0123456789");
Packit Service fdd496
      if (c == -1)
Packit Service fdd496
	break;
Packit Service fdd496
Packit Service fdd496
      switch (c)
Packit Service fdd496
	{
Packit Service fdd496
	case '0':
Packit Service fdd496
	case '1':
Packit Service fdd496
	case '2':
Packit Service fdd496
	case '3':
Packit Service fdd496
	case '4':
Packit Service fdd496
	case '5':
Packit Service fdd496
	case '6':
Packit Service fdd496
	case '7':
Packit Service fdd496
	case '8':
Packit Service fdd496
	case '9':
Packit Service fdd496
	  if (digit_optind != 0 && digit_optind != this_option_optind)
Packit Service fdd496
	    printf ("digits occur in two different argv-elements.\n");
Packit Service fdd496
	  digit_optind = this_option_optind;
Packit Service fdd496
	  printf ("option %c\n", c);
Packit Service fdd496
	  break;
Packit Service fdd496
Packit Service fdd496
	case 'a':
Packit Service fdd496
	  printf ("option a\n");
Packit Service fdd496
	  break;
Packit Service fdd496
Packit Service fdd496
	case 'b':
Packit Service fdd496
	  printf ("option b\n");
Packit Service fdd496
	  break;
Packit Service fdd496
Packit Service fdd496
	case 'c':
Packit Service fdd496
	  printf ("option c with value '%s'\n", optarg);
Packit Service fdd496
	  break;
Packit Service fdd496
Packit Service fdd496
	case '?':
Packit Service fdd496
	  break;
Packit Service fdd496
Packit Service fdd496
	default:
Packit Service fdd496
	  printf ("?? getopt returned character code 0%o ??\n", c);
Packit Service fdd496
	}
Packit Service fdd496
    }
Packit Service fdd496
Packit Service fdd496
  if (optind < argc)
Packit Service fdd496
    {
Packit Service fdd496
      printf ("non-option ARGV-elements: ");
Packit Service fdd496
      while (optind < argc)
Packit Service fdd496
	printf ("%s ", argv[optind++]);
Packit Service fdd496
      printf ("\n");
Packit Service fdd496
    }
Packit Service fdd496
Packit Service fdd496
  exit (0);
Packit Service fdd496
}
Packit Service fdd496
Packit Service fdd496
#endif /* TEST */