glibc/extensions/getopt.c

12    version 2.1 of the License, or (at your option) any later version.
119    When `getopt' finds an option that takes an argument,
122    each non-option ARGV-element is returned here.  */
133    non-option elements that the caller should itself scan.
147 /* The next char to be scanned in the option-element
148    in which the last option character we returned was found.
161 /* Set to an option character which was unrecognized.
167 /* Describe how to deal with options that follow non-option ARGV-elements.
174    stop option processing when the first non-option is seen.
178    of the list of option characters.
185    RETURN_IN_ORDER is an option available to programs that were written
187    the ordering of the two.  We describe each non-option ARGV-element
188    as if it were the argument of an option with character code 1.
189    Using `-' as the first character of the list of option characters
192    The special argument `--' forces an end of option-scanning regardless
404      non-option ARGV-elements is empty.  */
463 /* Scan elements of ARGV (whose length is ARGC) for option characters
467    then it is an option element.  The characters of this element
468    (aside from the initial '-') are option characters.  If `getopt'
469    is called repeatedly, it returns successively each of the option characters
470    from each of the option elements.
472    If `getopt' finds another option character, it returns that character,
474    resume the scan with the following option character or ARGV-element.
476    If there are no more option characters, `getopt' returns -1.
478    that is not an option.  (The ARGV-elements have been permuted
481    OPTSTRING is a string containing the legitimate option characters.
482    If an option character is seen that is not listed in OPTSTRING,
488    ARGV-element, is returned in `optarg'.  Two colons mean an option that
493    handling the non-option ARGV-elements.
498    or is an exact match for some defined option.  If they have an
499    argument, it follows the option name in the same ARGV-element, separated
500    from the option name by a `=', or else the in next ARGV-element.
501    When `getopt' finds a long-named option, it returns 0 if that option's
502    `flag' field is nonzero, the value of the option's `val' field
509    LONGOPTS is a vector of `struct option' terminated by an
512    LONGIND returns the index in LONGOPT of the long-named option found.
513    It is only valid when a long-named option has been found by the most
524      const struct option *longopts;
545   /* Test whether ARGV[optind] points to a non-option argument.
546      Either it does not have option syntax, or there is an environment flag
547      from the shell indicating it is not an option.  The later information
587 	 Skip it like a null option,
588 	 then exchange with previous non-options as if it were an option,
589 	 then skip everything else like a non-option.  */
616       /* If we have come to a non-option and did not permute it,
627       /* We have found another option-ARGV-element.
634   /* Decode the current option-ARGV-element.  */
636   /* Check whether the ARGV-element is a long option.
639      a valid short option, don't consider it an abbreviated form of
640      a long option that starts with f.  Otherwise there would be no
641      way to give the -f short option.
643      On the other hand, if there's a long option "fubar" and
645      the long option, just like "--fu", and not "-f" with arg "u".
654       const struct option *p;
655       const struct option *pfound = NULL;
699 	      if (__asprintf (&buf, _("%s: option `%s' is ambiguous\n"),
711 	      fprintf (stderr, _("%s: option `%s' is ambiguous\n"),
742 			  /* --option */
745 %s: option `--%s' doesn't allow an argument\n"),
749 %s: option `--%s' doesn't allow an argument\n"),
755 			  /* +option or -option */
758 %s: option `%c%s' doesn't allow an argument\n"),
763 %s: option `%c%s' doesn't allow an argument\n"),
799 %s: option `%s' requires an argument\n"),
811 			       _("%s: option `%s' requires an argument\n"),
831       /* Can't find it as a long option.  If this is not getopt_long_only,
832 	 or the option starts with '--' or is not a valid short
833 	 option, then it's an error.
834 	 Otherwise interpret it as a short option.  */
847 		  /* --option */
849 		  n = __asprintf (&buf, _("%s: unrecognized option `--%s'\n"),
852 		  fprintf (stderr, _("%s: unrecognized option `--%s'\n"),
858 		  /* +option or -option */
860 		  n = __asprintf (&buf, _("%s: unrecognized option `%c%s'\n"),
863 		  fprintf (stderr, _("%s: unrecognized option `%c%s'\n"),
887   /* Look at and handle the next short option-character.  */
910 		n = __asprintf (&buf, _("%s: illegal option -- %c\n"),
913 		fprintf (stderr, _("%s: illegal option -- %c\n"), argv[0], c);
919 		n = __asprintf (&buf, _("%s: invalid option -- %c\n"),
922 		fprintf (stderr, _("%s: invalid option -- %c\n"), argv[0], c);
941     /* Convenience. Treat POSIX -W foo same as long option --foo */
945 	const struct option *p;
946 	const struct option *pfound = NULL;
952 	/* This is an option that requires an argument.  */
969 				_("%s: option requires an argument -- %c\n"),
980 		fprintf (stderr, _("%s: option requires an argument -- %c\n"),
1032 		if (__asprintf (&buf, _("%s: option `-W %s' is ambiguous\n"),
1043 		fprintf (stderr, _("%s: option `-W %s' is ambiguous\n"),
1068 %s: option `-W %s' doesn't allow an argument\n"),
1080 %s: option `-W %s' doesn't allow an argument\n"),
1101 %s: option `%s' requires an argument\n"),
1113 				 _("%s: option `%s' requires an argument\n"),
1138 	    /* This is an option that accepts an argument optionally.  */
1150 	    /* This is an option that requires an argument.  */
1167 %s: option requires an argument -- %c\n"),
1179 			     _("%s: option requires an argument -- %c\n"),
1207 			   (const struct option *) 0,
1251 	  printf ("option %c\n", c);
1255 	  printf ("option a\n");
1259 	  printf ("option b\n");
1263 	  printf ("option c with value `%s'\n", optarg);
1276       printf ("non-option ARGV-elements: ");