GETOPT(3)                                               GETOPT(3)

     NAME
          getopt - get option letter from argv

     SYNOPSIS
          int getopt (argc, argv, optstring)
          int argc;
          char **argv;
          char *optstring;
          extern char *optarg;
          extern int optind;

     DESCRIPTION
          Getopt returns the next option letter in argv that matches a
          letter in optstring. Optstring is a string of recognized
          option letters; if a letter is followed by a colon, the
          option is expected to have an argument which may or may not
          be separated from it by white space.  Optarg is set to point
          to the start of the option argument on return from getopt.

          Getopt places in optind the argv index of the next argument
          to be processed.  Since optind is external, it is normally
          initialized to zero automatically before the first call to
          getopt.

          Option letters appear in nonempty clusters preceded by `-'.
          When all options have been processed (i.e., up to the first
          non-option argument), getopt returns EOF.  The special
          option `--' may be used to delimit the end of the options;
          EOF will be returned, and `--' will be skipped.

     DIAGNOSTICS
          Getopt prints an error message on stderr and returns a ques-
          tion mark ('?') when it encounters an option letter not
          included in optstring.

     EXAMPLE
          This fragment processes arguments for a command that can
          take option a and option f, which requires an argument.

               main (argc, argv) char **argv;
               {
                    int c;
                    extern int optind;
                    extern char **optarg, **ifile;
                    while ((c = getopt (argc, argv, "af:")) != -1)
                         switch (c) {
                         case 'a': aflg++;
                                   break;
                         case 'f': ifile = optarg;
                                   break;

     GETOPT(3)                                               GETOPT(3)

                         case '?': errflg++;
                         }
                    if (errflg) {
                         fprintf (stderr, "usage: . . . ");
                         exit (2);
                    }
                    for( ; optind < argc; optind++) {
                         if (access (argv[optind], 4)) {
                    ...