Blame posix/getopt.c

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