Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ getopt(1) — DG/UX 4.30

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

sh(1)

getopt(3C)



     getopt(1)                  DG/UX 4.30                   getopt(1)



     NAME
          getopt - parse command options

     SYNOPSIS
          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
               cmd -a -o arg file file
               cmd -oarg -a file file
               cmd -a -oarg -- file file

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

     DIAGNOSTICS



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





     getopt(1)                  DG/UX 4.30                   getopt(1)



          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)         Page 2



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