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