


      GGGGEEEETTTTOOOOPPPPTTTT((((1111))))                   ((((UUUUNNNNIIIIXXXX 5555....0000))))                  GGGGEEEETTTTOOOOPPPPTTTT((((1111))))



      NNNNAAAAMMMMEEEE
           getopt - parse command options

      SSSSYYYYNNNNTTTTAAAAXXXX
           sssseeeetttt -------- ````ggggeeeettttoooopppptttt optstring $$$$****````

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           _G_e_t_o_p_t breaks up options in command lines for easy parsing
           and option-checking by shell procedures.  _O_p_t_s_t_r_i_n_g is a
           string of recognized option letters (see _g_e_t_o_p_t(3C)); 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.  The special option -------- delimits the end of
           the options.  If it is used explicitly, _g_e_t_o_p_t will
           recognize it; otherwise, _g_e_t_o_p_t will generate it; in either
           case, _g_e_t_o_p_t will place it at the end of the options.  The
           shell's positional parameters ($1 $2 ...) 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.

      EEEEXXXXAAAAMMMMPPPPLLLLEEEE
           The following code fragment shows how one might process the
           arguments for a command that can take the options aaaa or bbbb, as
           well as the option oooo, 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

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           sh(1), getopt(3C).

      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS



      PPPPaaaaggggeeee 1111                                                   ((((9999000011110000----EEEE))))






      GGGGEEEETTTTOOOOPPPPTTTT((((1111))))                   ((((UUUUNNNNIIIIXXXX 5555....0000))))                  GGGGEEEETTTTOOOOPPPPTTTT((((1111))))



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





















































      Page 2                                                   (9010-E)



