This program generates a C function that uses getopt_long function to parse the command line options, to validate them and fills a struct .
Thus your program can now handle options such as:
myprog --input foo.c -o foo.o --no-tabs -i 100 *.classAnd both long options (those that start with --) and short options (start with - and consist of only one character) can be handled. For standards about short and long options you may want to take a look at the GNU Coding Standards .
Gengetopt can also generate a function to save the command line options into a file, and a function to read the command line options from a file. Of course, these two kinds of files are compliant.
Generated code is commented with Doxygen comments.
gengetopt is free
software.
Please see the file LICENSE
and COPYING
for details.
Notice that: Use of gengetopt does not impose any particular
license on the generated code: the code generated is not under any
license.
For documentation, please read this file.
gengetopt is perfect if you don't want to write all stuff required to call getopt_long, and when you have a program and wish it took options.
Generated code works if you use GNU Autoconf or GNU Automake.
Gengetopt has originally been written by Roberto Arturo Tena Sanchez and currently maintained by Lorenzo Bettini http://www.lorenzobettini.it.
Gengetopt is a GNU
program and its
main home page is at GNU site:
http://www.gnu.org/software/gengetopt
I do not distribute Windows binaries anymore; since, they can
be
easily built by using Cygwin C/C++ compiler,
available at http://www.cygwin.com/.
However, if
you don't feel like downloading such compiler, you can request such
binaries directly to me, by e-mail (please find my e-mail address at my
home page) and I can send them to you.
This project's git repository can be checked out through the following clone instruction:
git clone git://git.savannah.gnu.org/gengetopt.git
Further instructions can be found at the address:
http://savannah.gnu.org/projects/gengetopt.
And the git repository can also browsed on-line at
http://git.savannah.gnu.org/cgit/gengetopt.git.
Since version 2.22.4 of Gengetopt the CVS repository was dismissed in favor of Git (http://git-scm.com/).
Please note that this way you will get the latest development sources of Gengetopt, which may also be unstable. This solution is the best if you intend to correct/extend this program: you should send me patches against the latest git repository sources.
If, on the contrary, you want to get the sources of a given release,
through git, say, e.g., version X.Y.Z, you must specify the tag
rel_X_Y_Z
.
When you compile the sources that you get from the git repository,
before running the configure
and make
commands, for the
first time, you must run the command:
autoreconf -i
This will run the autotools commands in the correct order, and also copy
possibly missing files. You should have installed recent versions of
automake
, autoconf
and libtool
in order for this to
succeed.
http://savannah.gnu.org/bugs/?group=gengetopt
Return to GNU's home page.
Please send FSF & GNU inquiries & questions to gnu@gnu.org . There are also other ways to contact the FSF.
Please send comments on these web pages to webmasters@gnu.org , send other questions to gnu@gnu.org .
Copyright (C) 2001 Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA
Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.
Updated:9 Jan 2001 mhw