#include <stdio.h>
Go to the source code of this file.
Data Structures | |
struct | poptOption |
struct | poptAlias |
A popt alias argument for poptAddAlias(). More... | |
struct | poptItem_s |
A popt alias or exec argument for poptAddItem(). More... | |
Auto-generated help/usage | |
#define | POPT_AUTOALIAS |
#define | POPT_AUTOHELP |
#define | POPT_TABLEEND { NULL, '\0', 0, NULL, 0, NULL, NULL } |
struct poptOption | poptAliasOptions [] |
Empty table marker to enable displaying popt alias/exec options. | |
struct poptOption | poptHelpOptions [] |
Auto help table options. | |
struct poptOption * | poptHelpOptionsI18N |
Defines | |
#define | POPT_OPTION_DEPTH 10 |
Arg type identifiers | |
#define | POPT_ARG_NONE 0U |
#define | POPT_ARG_STRING 1U |
#define | POPT_ARG_INT 2U |
#define | POPT_ARG_LONG 3U |
#define | POPT_ARG_INCLUDE_TABLE 4U |
#define | POPT_ARG_CALLBACK 5U |
#define | POPT_ARG_INTL_DOMAIN 6U |
#define | POPT_ARG_VAL 7U |
#define | POPT_ARG_FLOAT 8U |
#define | POPT_ARG_DOUBLE 9U |
#define | POPT_ARG_MAINCALL 10U |
#define | POPT_ARG_MASK 0x0000FFFFU |
Arg modifiers | |
#define | POPT_ARGFLAG_ONEDASH 0x80000000U |
#define | POPT_ARGFLAG_DOC_HIDDEN 0x40000000U |
#define | POPT_ARGFLAG_STRIP 0x20000000U |
#define | POPT_ARGFLAG_OPTIONAL 0x10000000U |
#define | POPT_ARGFLAG_OR 0x08000000U |
#define | POPT_ARGFLAG_NOR 0x09000000U |
#define | POPT_ARGFLAG_AND 0x04000000U |
#define | POPT_ARGFLAG_NAND 0x05000000U |
#define | POPT_ARGFLAG_XOR 0x02000000U |
#define | POPT_ARGFLAG_NOT 0x01000000U |
#define | POPT_ARGFLAG_LOGICALOPS (POPT_ARGFLAG_OR|POPT_ARGFLAG_AND|POPT_ARGFLAG_XOR) |
#define | POPT_BIT_SET (POPT_ARG_VAL|POPT_ARGFLAG_OR) |
#define | POPT_BIT_CLR (POPT_ARG_VAL|POPT_ARGFLAG_NAND) |
#define | POPT_ARGFLAG_SHOW_DEFAULT 0x00800000U |
#define | POPT_ARGFLAG_RANDOM 0x00400000U |
Callback modifiers | |
#define | POPT_CBFLAG_PRE 0x80000000U |
#define | POPT_CBFLAG_POST 0x40000000U |
#define | POPT_CBFLAG_INC_DATA 0x20000000U |
#define | POPT_CBFLAG_SKIPOPTION 0x10000000U |
#define | POPT_CBFLAG_CONTINUE 0x08000000U |
Error return values | |
#define | POPT_ERROR_NOARG -10 |
#define | POPT_ERROR_BADOPT -11 |
#define | POPT_ERROR_OPTSTOODEEP -13 |
#define | POPT_ERROR_BADQUOTE -15 |
#define | POPT_ERROR_ERRNO -16 |
#define | POPT_ERROR_BADNUMBER -17 |
#define | POPT_ERROR_OVERFLOW -18 |
#define | POPT_ERROR_BADOPERATION -19 |
#define | POPT_ERROR_NULLARG -20 |
#define | POPT_ERROR_MALLOC -21 |
poptBadOption() flags | |
#define | POPT_BADOPTION_NOALIAS (1U << 0) |
poptGetContext() flags | |
#define | POPT_CONTEXT_NO_EXEC (1U << 0) |
#define | POPT_CONTEXT_KEEP_FIRST (1U << 1) |
#define | POPT_CONTEXT_POSIXMEHARDER (1U << 2) |
#define | POPT_CONTEXT_ARG_OPTS (1U << 4) |
Typedefs | |
typedef struct poptItem_s * | poptItem |
A popt alias or exec argument for poptAddItem(). | |
typedef struct poptContext_s * | poptContext |
typedef struct poptOption * | poptOption |
typedef void(* | poptCallbackType )(poptContext con, enum poptCallbackReason reason, const struct poptOption *opt, const char *arg, const void *data) |
Table callback prototype. | |
Enumerations | |
enum | poptCallbackReason { POPT_CALLBACK_REASON_PRE = 0, POPT_CALLBACK_REASON_POST = 1, POPT_CALLBACK_REASON_OPTION = 2 } |
Functions | |
poptContext | poptGetContext (const char *name, int argc, const char **argv, const struct poptOption *options, unsigned int flags) |
Initialize popt context. | |
void | poptResetContext (poptContext con) |
Reinitialize popt context. | |
int | poptGetNextOpt (poptContext con) |
Return value of next option found. | |
char * | poptGetOptArg (poptContext con) |
Return next option argument (if any). | |
const char * | poptGetArg (poptContext con) |
Return next argument. | |
const char * | poptPeekArg (poptContext con) |
Peek at current argument. | |
const char ** | poptGetArgs (poptContext con) |
Return remaining arguments. | |
const char * | poptBadOption (poptContext con, unsigned int flags) |
Return the option which caused the most recent error. | |
poptContext | poptFreeContext (poptContext con) |
Destroy context. | |
int | poptStuffArgs (poptContext con, const char **argv) |
Add arguments to context. | |
int | poptAddAlias (poptContext con, struct poptAlias alias, int flags) |
Add alias to context. | |
int | poptAddItem (poptContext con, poptItem newItem, int flags) |
Add alias/exec item to context. | |
int | poptReadConfigFile (poptContext con, const char *fn) |
Read configuration file. | |
int | poptReadDefaultConfig (poptContext con, int useEnv) |
Read default configuration from /etc/popt and $HOME/.popt. | |
int | poptDupArgv (int argc, const char **argv, int *argcPtr, const char ***argvPtr) |
Duplicate an argument array. | |
int | poptParseArgvString (const char *s, int *argcPtr, const char ***argvPtr) |
Parse a string into an argument array. | |
int | poptConfigFileToString (FILE *fp, char **argstrp, int flags) |
Parses an input configuration file and returns an string that is a command line. | |
const char * | poptStrerror (const int error) |
Return formatted error string for popt failure. | |
void | poptSetExecPath (poptContext con, const char *path, int allowAbsolute) |
Limit search for executables. | |
void | poptPrintHelp (poptContext con, FILE *fp, int flags) |
Print detailed description of options. | |
void | poptPrintUsage (poptContext con, FILE *fp, int flags) |
Print terse description of options. | |
void | poptSetOtherOptionHelp (poptContext con, const char *text) |
Provide text to replace default "[OPTION...]" in help/usage output. | |
const char * | poptGetInvocationName (poptContext con) |
Return argv[0] from context. | |
int | poptStrippedArgv (poptContext con, int argc, char **argv) |
Shuffle argv pointers to remove stripped args, returns new argc. | |
int | poptSaveLong (long *arg, unsigned int argInfo, long aLong) |
Save a long, performing logical operation with value. | |
int | poptSaveInt (int *arg, unsigned int argInfo, long aLong) |
Save an integer, performing logical operation with value. |
#define POPT_ARG_CALLBACK 5U |
table-wide callback... must be set first in table; arg points to callback, descrip points to callback data to pass
Definition at line 25 of file popt.h.
Referenced by findOption(), invokeCallbacksOPTION(), invokeCallbacksPOST(), and invokeCallbacksPRE().
#define POPT_ARG_INCLUDE_TABLE 4U |
arg points to table
Definition at line 24 of file popt.h.
Referenced by findOption(), invokeCallbacksOPTION(), invokeCallbacksPOST(), and invokeCallbacksPRE().
#define POPT_ARG_INTL_DOMAIN 6U |
#define POPT_ARG_MASK 0x0000FFFFU |
Definition at line 39 of file popt.h.
Referenced by findOption(), invokeCallbacksOPTION(), invokeCallbacksPOST(), and invokeCallbacksPRE().
#define POPT_ARG_STRING 1U |
#define POPT_ARGFLAG_DOC_HIDDEN 0x40000000U |
#define POPT_ARGFLAG_LOGICALOPS (POPT_ARGFLAG_OR|POPT_ARGFLAG_AND|POPT_ARGFLAG_XOR) |
#define POPT_ARGFLAG_ONEDASH 0x80000000U |
allow -longoption
Definition at line 46 of file popt.h.
Referenced by findOption(), and singleOptionUsage().
#define POPT_ARGFLAG_SHOW_DEFAULT 0x00800000U |
#define POPT_ARGFLAG_STRIP 0x20000000U |
#define POPT_AUTOALIAS |
Value:
{ NULL, '\0', POPT_ARG_INCLUDE_TABLE, poptAliasOptions, \ 0, "Options implemented via popt alias/exec:", NULL },
#define POPT_AUTOHELP |
Value:
{ NULL, '\0', POPT_ARG_INCLUDE_TABLE, poptHelpOptions, \ 0, "Help options:", NULL },
#define POPT_BADOPTION_NOALIAS (1U << 0) |
#define POPT_BIT_CLR (POPT_ARG_VAL|POPT_ARGFLAG_NAND) |
#define POPT_BIT_SET (POPT_ARG_VAL|POPT_ARGFLAG_OR) |
#define POPT_CBFLAG_CONTINUE 0x08000000U |
continue callbacks with option
Definition at line 79 of file popt.h.
Referenced by invokeCallbacksOPTION().
#define POPT_CBFLAG_INC_DATA 0x20000000U |
#define POPT_CBFLAG_POST 0x40000000U |
call the callback after parse
Definition at line 75 of file popt.h.
Referenced by invokeCallbacksPOST().
#define POPT_CBFLAG_PRE 0x80000000U |
call the callback before parse
Definition at line 74 of file popt.h.
Referenced by invokeCallbacksPRE().
#define POPT_CBFLAG_SKIPOPTION 0x10000000U |
don't callback with option
Definition at line 78 of file popt.h.
Referenced by invokeCallbacksOPTION().
#define POPT_CONTEXT_ARG_OPTS (1U << 4) |
#define POPT_CONTEXT_KEEP_FIRST (1U << 1) |
#define POPT_CONTEXT_NO_EXEC (1U << 0) |
#define POPT_CONTEXT_POSIXMEHARDER (1U << 2) |
#define POPT_ERROR_BADOPERATION -19 |
#define POPT_ERROR_BADQUOTE -15 |
error in paramter quoting
Definition at line 89 of file popt.h.
Referenced by poptParseArgvString().
#define POPT_ERROR_ERRNO -16 |
errno set, use strerror(errno)
Definition at line 90 of file popt.h.
Referenced by poptReadConfigFile(), and poptReadDefaultConfig().
#define POPT_ERROR_MALLOC -21 |
memory allocation failed
Definition at line 95 of file popt.h.
Referenced by poptConfigFileToString(), poptDupArgv(), and poptParseArgvString().
#define POPT_ERROR_NOARG -10 |
#define POPT_ERROR_NULLARG -20 |
opt->arg should not be NULL
Definition at line 94 of file popt.h.
Referenced by poptConfigFileToString().
#define POPT_ERROR_OVERFLOW -18 |
number too large or too small
Definition at line 92 of file popt.h.
Referenced by poptConfigFileToString().
typedef void(* poptCallbackType)(poptContext con, enum poptCallbackReason reason,const struct poptOption *opt,const char *arg,const void *data) |
typedef struct poptContext_s* poptContext |
typedef struct poptItem_s * poptItem |
A popt alias or exec argument for poptAddItem().
typedef struct poptOption* poptOption |
enum poptCallbackReason |
int poptAddAlias | ( | poptContext | con, | |
struct poptAlias | alias, | |||
int | flags | |||
) |
Add alias to context.
con | context | |
alias | alias to add | |
flags | (unused) |
< don't show in help/usage
int poptAddItem | ( | poptContext | con, | |
poptItem | newItem, | |||
int | flags | |||
) |
Add alias/exec item to context.
con | context | |
newItem | alias/exec item to add | |
flags | 0 for alias, 1 for exec |
Definition at line 1143 of file popt.c.
Referenced by configLine().
const char* poptBadOption | ( | poptContext | con, | |
unsigned int | flags | |||
) |
int poptConfigFileToString | ( | FILE * | fp, | |
char ** | argstrp, | |||
int | flags | |||
) |
Parses an input configuration file and returns an string that is a command line.
For use with popt. You must free the return value when done.
Given the file:
# this line is ignored # this one too aaa bbb ccc bla=bla this_is = fdsafdas bad_line= reall bad line reall bad line = again 5555= 55555 test = with lots of spaces
The result is:
--aaa --bbb --ccc --bla="bla" --this_is="fdsafdas" --5555="55555" --test="with lots of spaces"
Passing this to poptParseArgvString() yields an argv of:
'--aaa' '--bbb' '--ccc' '--bla=bla' '--this_is=fdsafdas' '--5555=55555' '--test=with lots of spaces'
fp | file handle to read | |
*argstrp | return string of options (malloc'd) | |
flags | unused |
< opt->arg should not be NULL
< memory allocation failed
< number too large or too small
< memory allocation failed
< memory allocation failed
Definition at line 129 of file poptparse.c.
References _isspaceptr, POPT_ERROR_MALLOC, POPT_ERROR_NULLARG, and POPT_ERROR_OVERFLOW.
int poptDupArgv | ( | int | argc, | |
const char ** | argv, | |||
int * | argcPtr, | |||
const char *** | argvPtr | |||
) |
Duplicate an argument array.
argc | no. of arguments | |
argv | argument array |
argcPtr | address of returned no. of arguments | |
argvPtr | address of returned argument array |
< missing argument
< missing argument
< memory allocation failed
Definition at line 13 of file poptparse.c.
References POPT_ERROR_MALLOC, and POPT_ERROR_NOARG.
Referenced by poptParseArgvString().
poptContext poptFreeContext | ( | poptContext | con | ) |
Destroy context.
con | context |
Definition at line 1081 of file popt.c.
Referenced by displayArgs().
const char* poptGetArg | ( | poptContext | con | ) |
const char** poptGetArgs | ( | poptContext | con | ) |
Return remaining arguments.
con | context |
Definition at line 1067 of file popt.c.
References _free(), poptContext_s::aliases, optionStackEntry::argb, poptContext_s::numAliases, poptContext_s::os, and poptResetContext().
poptContext poptGetContext | ( | const char * | name, | |
int | argc, | |||
const char ** | argv, | |||
const struct poptOption * | options, | |||
unsigned int | flags | |||
) |
Initialize popt context.
name | context name (usually argv[0] program name) | |
argc | no. of arguments | |
argv | argument array | |
options | address of popt option table | |
flags | or'd POPT_CONTEXT_* bits |
< pay attention to argv[0]
< options can't follow args
const char* poptGetInvocationName | ( | poptContext | con | ) |
Return argv[0] from context.
con | context |
Definition at line 1247 of file popt.c.
References poptContext_s::arg_strip, and PBM_ISSET.
int poptGetNextOpt | ( | poptContext | con | ) |
Return value of next option found.
con | context |
< unknown option
< options can't follow args
< return args as options with value 0
< unknown option
< unknown option
< strip this arg from argv(only applies to long args)
< unknown option
< unknown option
< no arg
< mutually exclusive logical operations requested
< arg should take value val
< mutually exclusive logical operations requested
< no arg
< arg may be missing
< missing argument
< strip this arg from argv(only applies to long args)
< arg may be missing
< arg will be saved as string
< arg will be converted to int
< arg will be converted to long
< invalid numeric value
< arg will be converted to long
< number too large or too small
< mutually exclusive logical operations requested
< number too large or too small
< mutually exclusive logical operations requested
< arg will be converted to float
< arg will be converted to double
< number too large or too small
< invalid numeric value
< arg will be converted to double
< number too large or too small
< number too large or too small
< return (*arg) (argc, argv)
< arg should take value val
< allow -longoption
< no arg
< arg should take value val
< no arg
Definition at line 726 of file popt.c.
References cleanOSE(), and poptContext_s::os.
char* poptGetOptArg | ( | poptContext | con | ) |
int poptParseArgvString | ( | const char * | s, | |
int * | argcPtr, | |||
const char *** | argvPtr | |||
) |
Parse a string into an argument array.
The parse allows ', ", and \ quoting, but ' is treated the same as " and both may include \ quotes.
s | string to parse |
argcPtr | address of returned no. of arguments | |
argvPtr | address of returned argument array |
< memory allocation failed
< error in paramter quoting
< error in paramter quoting
Definition at line 52 of file poptparse.c.
References _isspaceptr, POPT_ARGV_ARRAY_GROW_DELTA, POPT_ERROR_BADQUOTE, POPT_ERROR_MALLOC, and poptDupArgv().
Referenced by configLine().
const char* poptPeekArg | ( | poptContext | con | ) |
void poptPrintHelp | ( | poptContext | con, | |
FILE * | fp, | |||
int | flags | |||
) |
Print detailed description of options.
con | context | |
fp | ouput file handle | |
flags | (unused) |
Definition at line 622 of file popthelp.c.
Referenced by displayArgs().
void poptPrintUsage | ( | poptContext | con, | |
FILE * | fp, | |||
int | flags | |||
) |
Print terse description of options.
con | context | |
fp | ouput file handle | |
flags | (unused) |
Definition at line 855 of file popthelp.c.
Referenced by displayArgs().
int poptReadConfigFile | ( | poptContext | con, | |
const char * | fn | |||
) |
Read configuration file.
con | context | |
fn | file name to read |
< errno set, use strerror(errno)
< errno set, use strerror(errno)
< errno set, use strerror(errno)
< errno set, use strerror(errno)
< errno set, use strerror(errno)
Definition at line 97 of file poptconfig.c.
References _isspaceptr, configLine(), and POPT_ERROR_ERRNO.
Referenced by poptReadDefaultConfig().
int poptReadDefaultConfig | ( | poptContext | con, | |
int | useEnv | |||
) |
Read default configuration from /etc/popt and $HOME/.popt.
con | context | |
useEnv | (unused) |
< errno set, use strerror(errno)
Definition at line 171 of file poptconfig.c.
References poptContext_s::appName, POPT_ERROR_ERRNO, and poptReadConfigFile().
void poptResetContext | ( | poptContext | con | ) |
Reinitialize popt context.
con | context |
Definition at line 228 of file popt.c.
References _free(), and poptContext_s::finalArgv.
Referenced by poptGetArgs().
int poptSaveInt | ( | int * | arg, | |
unsigned int | argInfo, | |||
long | aLong | |||
) |
Save an integer, performing logical operation with value.
arg | integer pointer, aligned on int boundary. | |
argInfo | logical operation (see POPT_ARGFLAG_*) | |
aLong | value to use |
< opt->arg should not be NULL
< arg will be negated
< arg will be or'ed
< arg will be and'ed
< arg will be xor'ed
< arg will be or'ed
< arg will be and'ed
< arg will be xor'ed
< mutually exclusive logical operations requested
int poptSaveLong | ( | long * | arg, | |
unsigned int | argInfo, | |||
long | aLong | |||
) |
Save a long, performing logical operation with value.
arg | integer pointer, aligned on int boundary. | |
argInfo | logical operation (see POPT_ARGFLAG_*) | |
aLong | value to use |
< opt->arg should not be NULL
< arg will be negated
< arg will be or'ed
< arg will be and'ed
< arg will be xor'ed
< arg will be or'ed
< arg will be and'ed
< arg will be xor'ed
< mutually exclusive logical operations requested
void poptSetExecPath | ( | poptContext | con, | |
const char * | path, | |||
int | allowAbsolute | |||
) |
Limit search for executables.
con | context | |
path | single path to search for executables | |
allowAbsolute | absolute paths only? |
Definition at line 54 of file popt.c.
References _free(), poptContext_s::execAbsolute, poptContext_s::execPath, and xstrdup.
void poptSetOtherOptionHelp | ( | poptContext | con, | |
const char * | text | |||
) |
Provide text to replace default "[OPTION...]" in help/usage output.
con | context | |
text | replacement text |
Definition at line 892 of file popthelp.c.
const char* poptStrerror | ( | const int | error | ) |
Return formatted error string for popt failure.
error | popt error |
< missing argument
< unknown option
< mutually exclusive logical operations requested
< opt->arg should not be NULL
< aliases nested too deeply
< error in paramter quoting
< invalid numeric value
< number too large or too small
< memory allocation failed
< errno set, use strerror(errno)
int poptStrippedArgv | ( | poptContext | con, | |
int | argc, | |||
char ** | argv | |||
) |
Shuffle argv pointers to remove stripped args, returns new argc.
con | context | |
argc | no. of args | |
argv | arg vector |
Definition at line 1252 of file popt.c.
References poptContext_s::arg_strip, and PBM_ISSET.
int poptStuffArgs | ( | poptContext | con, | |
const char ** | argv | |||
) |
struct poptOption poptAliasOptions[] |
Empty table marker to enable displaying popt alias/exec options.
Definition at line 63 of file popthelp.c.
struct poptOption poptHelpOptions[] |
Auto help table options.
Definition at line 72 of file popthelp.c.
Referenced by findOption(), invokeCallbacksOPTION(), invokeCallbacksPOST(), and invokeCallbacksPRE().
struct poptOption* poptHelpOptionsI18N |
Definition at line 104 of file popthelp.c.
Referenced by findOption(), invokeCallbacksOPTION(), invokeCallbacksPOST(), and invokeCallbacksPRE().