optionProcess - this is the main option processing routine


#include <your-opts.h>
cc [...] -o outfile infile.c -lopts [...]

int optionProcess(tOptions* opts, int a_ct, char** a_v);


This is the main entry point for processing options. It is intended that this procedure be called once at the beginning of the execution of a program. Depending on options selected earlier, it is sometimes necessary to stop and restart option processing, or to select completely different sets of options. This can be done easily, but you generally do not want to do this.

The number of arguments processed always includes the program name. If one of the arguments is "--", then it is counted and the processing stops. If an error was encountered and errors are to be tolerated, then the returned value is the index of the argument causing the error. A hyphen by itself ("-") will also cause processing to stop and will not be counted among the processed arguments. A hyphen by itself is treated as an operand. Encountering an operand stops option processing.


program options descriptor


program arg count


program arg vector


the count of the arguments processed


Errors will cause diagnostics to be printed. exit(2) may or may not be called. It depends upon whether or not the options were generated with the "allow-errors" attribute, or if the ERRSKIP_OPTERR or ERRSTOP_OPTERR macros were invoked.


The info documentation for the -lopts library.
ao_string_tokenize(3), configFileLoad(3), optionFileLoad(3), optionFindNextValue(3), optionFindValue(3), optionFree(3), optionGetValue(3), optionLoadLine(3), optionMemberList(3), optionNextValue(3), optionOnlyUsage(3), optionRestore(3), optionSaveFile(3), optionSaveState(3), optionUnloadNested(3), optionVersion(3), strequate(3), streqvcmp(3), streqvmap(3), strneqvcmp(3), strtransform(3),

More Linux Commands

setvtrgb(8) - set the virtual terminal RGB colors (ManPage)
The setvtrgb command takes a single argument, either the string vga , or a path to a file containing the red, green, and blue colors to be used by the Linux vir

dhcpd.leases(5) - DHCP client lease database (Man Page).....
The Internet Systems Consortium DHCP Server keeps a persistent database of leases that it has assigned. This database is a free-form ASCII file containing a ser

pamrgbatopng(1) - convert PAM color/transparency image to PN
This program is part of Netpbm(1) pamrgbatopng reads a PAM image with the RGB_ALPHA tuple type (a color visual image with transparency) and produces an equivale

mitem_opts(3menu) - set and get menu item options (ManPage)
The function set_item_opts sets all the given items option bits (menu option bits may be logically-ORed together). The function item_opts_on turns on the given

Tk_DeleteBindingTable(3) - invoke scripts in response to X e
These procedures provide a general-purpose mechanism for creating and invoking bindings. Bindings are organized in terms of binding tables. A binding table cons

TAP::Parser::Iterator(3pm) - Base class for TAP source itera
This is a simple iterator base class that defines TAP::Parsers iterator API . Iterators are typically created from TAP::Parser::SourceHandlers. METHODS Class Me

keyctl_describe_alloc(3) - Describe a key - Linux man page
keyctl_describe() describes the attributes of a key as a NUL-terminated string. The caller must have view permission on a key to be able to get a description of

ModPerl::RegistryBB(3pm) - Run unaltered CGI scripts persist
ModPerl::RegistryBB is similar to ModPerl::Registry, but does the bare minimum (mnemonic: BB = Bare Bones) to compile a script file once and run it many times,

gnutls_psk_set_server_dh_params(3) - API function (ManPage)
This function will set the Diffie-Hellman parameters for an anonymous server to use. These parameters will be used in Diffie-Hellman exchange with PSK cipher su

rec(1) - Sound eXchange, the Swiss Army knife of audio manip
Introduction SoX reads and writes audio files in most popular formats and can optionally apply effects to them. It can combine multiple input sources, synthesis

glutDialsFunc(3) - sets the dial & button box dials callback
glutDialsFunc sets the dial &amp; button box dials callback for the current window. The dial &amp; button box dials callback for a window is called when the window has

getbkgrnd(3ncurses) - curses window complex background manip
The bkgrndset and wbkgrndset routines manipulate the background of the named window. The window background is a cchar_t consisting of any combination of attribu

We can't live, work or learn in freedom unless the software we use is free.