Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ getopt(1) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                                getopt(1)



        _________________________________________________________________
        getopt                                                    Command
        parse command options
        _________________________________________________________________


        SYNTAX

        set -- `getopt optstring $*`


        DESCRIPTION

        Getopt organizes options in command lines for easy parsing by
        shell procedures and to check for legal options.  Optstring is 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.  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



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                                getopt(1)



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


        SEE ALSO

        sh(1), getopt(3C).


        DIAGNOSTICS

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








































        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026