Added getopt(1) from NetBSD
This commit is contained in:
parent
0f8495d03c
commit
b37b9a6d2d
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=194
7
usr.bin/getopt/Makefile
Normal file
7
usr.bin/getopt/Makefile
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
# $Header: /b/source/CVS/src/usr.bin/getopt/Makefile,v 1.1 1993/06/21 12:43:58 brezak Exp $
|
||||||
|
#
|
||||||
|
|
||||||
|
PROG = getopt
|
||||||
|
MAN1 = getopt.1
|
||||||
|
|
||||||
|
.include <bsd.prog.mk>
|
104
usr.bin/getopt/getopt.1
Normal file
104
usr.bin/getopt/getopt.1
Normal file
@ -0,0 +1,104 @@
|
|||||||
|
.Dd June 21, 1993
|
||||||
|
.Dt GETOPT 1
|
||||||
|
.Os
|
||||||
|
.Sh NAME
|
||||||
|
.Nm getopt
|
||||||
|
.Nd parse command options
|
||||||
|
.Sh SYNOPSIS
|
||||||
|
.Nm set \-\- \`getopt optstring $*\`
|
||||||
|
.Sh DESCRIPTION
|
||||||
|
.Nm Getopt
|
||||||
|
is used to break up options in command lines for easy parsing by
|
||||||
|
shell procedures, and to check for legal options.
|
||||||
|
.Op Optstring
|
||||||
|
is a string of recognized option letters (see
|
||||||
|
.Xr getopt 3
|
||||||
|
);
|
||||||
|
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
|
||||||
|
.B \-\-
|
||||||
|
is used to delimit the end of the options.
|
||||||
|
.Nm Getopt
|
||||||
|
will place
|
||||||
|
.B \-\-
|
||||||
|
in the arguments at the end of the options,
|
||||||
|
or recognize it if used explicitly.
|
||||||
|
The shell arguments
|
||||||
|
(\fB$1 $2\fR ...) are reset so that each option is
|
||||||
|
preceded by a
|
||||||
|
.B \-
|
||||||
|
and in its own shell argument;
|
||||||
|
each option argument is also in its own shell argument.
|
||||||
|
.Sh EXAMPLE
|
||||||
|
The following code fragment shows how one might process the arguments
|
||||||
|
for a command that can take the options
|
||||||
|
.Op a
|
||||||
|
and
|
||||||
|
.Op b ,
|
||||||
|
and the option
|
||||||
|
.Op o ,
|
||||||
|
which requires an argument.
|
||||||
|
.Pp
|
||||||
|
.Bd -literal -offset indent
|
||||||
|
set \-\- \`getopt abo: $*\`
|
||||||
|
if test $? != 0
|
||||||
|
then
|
||||||
|
echo 'Usage: ...'
|
||||||
|
exit 2
|
||||||
|
fi
|
||||||
|
for i
|
||||||
|
do
|
||||||
|
case "$i"
|
||||||
|
in
|
||||||
|
\-a|\-b)
|
||||||
|
flag=$i; shift;;
|
||||||
|
\-o)
|
||||||
|
oarg=$2; shift; shift;;
|
||||||
|
\-\-)
|
||||||
|
shift; break;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
.Ed
|
||||||
|
.Pp
|
||||||
|
This code will accept any of the following as equivalent:
|
||||||
|
.Pp
|
||||||
|
.Bd -literal -offset indent
|
||||||
|
cmd \-aoarg file file
|
||||||
|
cmd \-a \-o arg file file
|
||||||
|
cmd \-oarg -a file file
|
||||||
|
cmd \-a \-oarg \-\- file file
|
||||||
|
.Ed
|
||||||
|
.Sh SEE ALSO
|
||||||
|
.Xr sh 1 ,
|
||||||
|
.Xr getopt 3
|
||||||
|
.Sh DIAGNOSTICS
|
||||||
|
.Nm Getopt
|
||||||
|
prints an error message on the standard error output when it
|
||||||
|
encounters an option letter not included in
|
||||||
|
.Op optstring .
|
||||||
|
.Sh HISTORY
|
||||||
|
Written by Henry Spencer, working from a Bell Labs manual page.
|
||||||
|
Behavior believed identical to the Bell version.
|
||||||
|
.Sh BUGS
|
||||||
|
Whatever
|
||||||
|
.Xr getopt 3
|
||||||
|
has.
|
||||||
|
.Pp
|
||||||
|
Arguments containing white space or imbedded shell metacharacters
|
||||||
|
generally will not survive intact; this looks easy to fix but isn't.
|
||||||
|
.Pp
|
||||||
|
The error message for an invalid option is identified as coming
|
||||||
|
from
|
||||||
|
.Nm getopt
|
||||||
|
rather than from the shell procedure containing the invocation
|
||||||
|
of
|
||||||
|
.Nm getopt ;
|
||||||
|
this again is hard to fix.
|
||||||
|
.Pp
|
||||||
|
The precise best way to use the
|
||||||
|
.Nm set
|
||||||
|
command to set the arguments without disrupting the value(s) of
|
||||||
|
shell options varies from one shell version to another.
|
||||||
|
varies from one shell version to another.
|
30
usr.bin/getopt/getopt.c
Normal file
30
usr.bin/getopt/getopt.c
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
#include <stdio.h>
|
||||||
|
|
||||||
|
main(argc, argv)
|
||||||
|
int argc;
|
||||||
|
char *argv[];
|
||||||
|
{
|
||||||
|
extern int optind;
|
||||||
|
extern char *optarg;
|
||||||
|
int c;
|
||||||
|
int status = 0;
|
||||||
|
|
||||||
|
optind = 2; /* Past the program name and the option letters. */
|
||||||
|
while ((c = getopt(argc, argv, argv[1])) != EOF)
|
||||||
|
switch (c) {
|
||||||
|
case '?':
|
||||||
|
status = 1; /* getopt routine gave message */
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
if (optarg != NULL)
|
||||||
|
printf(" -%c %s", c, optarg);
|
||||||
|
else
|
||||||
|
printf(" -%c", c);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
printf(" --");
|
||||||
|
for (; optind < argc; optind++)
|
||||||
|
printf(" %s", argv[optind]);
|
||||||
|
printf("\n");
|
||||||
|
exit(status);
|
||||||
|
}
|
Loading…
Reference in New Issue
Block a user