getopt(1)                      DG/UX 5.4R3.00                      getopt(1)


NAME
       getopt - parse command options

SYNOPSIS
       set -- `getopt optstring $*`

   where:
       optstring
              A string of recognized option letters (see getopt(3C)); if a
              letter is followed by a colon, the option is expected to have
              an argument which can be separated from it by white space.
              The special option -- delimits the end of the options.  If it
              is used explicitly, getopt recognizes it; otherwise, getopt
              generates it; in either case, getopt places it at the end of
              the options.

DESCRIPTION
       Getopt organizes options in command lines for easy parsing by shell
       procedures and to check for legal options.  The positional parameters
       ($1 $2 ...) of the shell are reset so that each option is preceded by
       a - and is in its own positional parameter; each option argument is
       also parsed into its own positional parameter.

EXAMPLE
       The following code fragment shows how to process the arguments for a
       command that can take the options a, b, or o, which requires an
       argument:

              set -- `getopt abo: $*`
              if [ $? != 0 ]
              then
                   echo $USAGE
                   exit 2
              fi
              for i in $*
              do
                   case $i in
                   -a | -b)  FLAG=$i; shift;;
                   -o)       OARG=$2; shift 2;;
                   --)       shift; break;;
                   esac
              done

       This code will accept any of the following as equivalent:

              cmd -aoarg file file
              cmd -a -o arg file file
              cmd -oarg -a file file
              cmd -a -oarg -- file file

DIAGNOSTICS
       Getopt prints an error message on the standard error when it
       encounters an option letter not included in optstring.




Licensed material--property of copyright holder(s)                         1

getopt(1)                      DG/UX 5.4R3.00                      getopt(1)


SEE ALSO
       sh(1), getopt(3C).























































Licensed material--property of copyright holder(s)                         2