popt.c File Reference

#include "system.h"
#include <math.h>
#include "findme.h"
#include "poptint.h"

Include dependency graph for popt.c:

Go to the source code of this file.

Defines

#define _ABS(a) ((((a) - 0.0) < DBL_EPSILON) ? -(a) : (a))

Functions

static char * strerror (int errno)

void poptSetExecPath (poptContext con, const char *path, int allowAbsolute)

Limit search for executables.

static void invokeCallbacksPRE (poptContext con, const struct poptOption *opt)

static void invokeCallbacksPOST (poptContext con, const struct poptOption *opt)

static void invokeCallbacksOPTION (poptContext con, const struct poptOption *opt, const struct poptOption *myOpt, const void *myData, int shorty)

poptContext poptGetContext (const char *name, int argc, const char **argv, const struct poptOption *options, unsigned int flags)

Initialize popt context.

static void cleanOSE (struct optionStackEntry *os)

void poptResetContext (poptContext con)

Reinitialize popt context.

static int handleExec (poptContext con, const char *longName, char shortName)

static int handleAlias (poptContext con, const char *longName, char shortName, const char *nextCharArg)

static int execCommand (poptContext con)

static struct poptOption * findOption (const struct poptOption *opt, const char *longName, int longNameLen, char shortName, poptCallbackType *callback, const void **callbackData, int singleDash)

static const char * findNextArg (poptContext con, unsigned argx, int delete_arg)

static const char * expandNextArg (poptContext con, const char *s)

static void poptStripArg (poptContext con, int which)

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.

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.

poptContext poptFreeContext (poptContext con)

Destroy 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.

const char * poptBadOption (poptContext con, unsigned int flags)

Return the option which caused the most recent error.

const char * poptStrerror (const int error)

Return formatted error string for popt failure.

int poptStuffArgs (poptContext con, const char **argv)

Add arguments to context.

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.

Variables

static unsigned int seed = 0

Define Documentation

#define _ABS ( a ) ((((a) - 0.0) < DBL_EPSILON) ? -(a) : (a))

Function Documentation

static void cleanOSE ( struct optionStackEntry * os ) [static]

Definition at line 218 of file popt.c.

References optionStackEntry::argb, poptContext_s::optionStack, poptContext_s::os, and PBM_FREE.

Referenced by poptGetNextOpt().

static int execCommand ( poptContext con ) [static]

< errno set, use strerror(errno)

< missing argument

< memory allocation failed

< missing argument

Definition at line 371 of file popt.c.

static const char* expandNextArg	(	poptContext	con,
		const char *	s
	)			`[static]`

Definition at line 582 of file popt.c.

References findNextArg().

static const char* findNextArg	(	poptContext	con,
		unsigned	argx,
		int	delete_arg
	)			`[static]`

Definition at line 544 of file popt.c.

References optionStackEntry::argb, optionStackEntry::argc, optionStackEntry::argv, PBM_ALLOC, PBM_ISSET, and PBM_SET.

Referenced by expandNextArg().

static struct poptOption* findOption	(	const struct poptOption *	opt,
		const char *	longName,
		int	longNameLen,
		char	shortName,
		poptCallbackType *	callback,
		const void **	callbackData,
		int	singleDash
	)			`[static, read]`

< arg points to table

< table-wide callback... must be set first in table; arg points to callback, descrip points to callback data to pass

< allow -longoption

< use data from the include line, not the subtable

Definition at line 472 of file popt.c.

References poptOption::arg, poptOption::argInfo, poptOption::descrip, poptOption::longName, POPT_ARG_CALLBACK, POPT_ARG_INCLUDE_TABLE, POPT_ARG_MASK, POPT_ARGFLAG_ONEDASH, poptHelpOptions, poptHelpOptionsI18N, and poptOption::shortName.

static int handleAlias	(	poptContext	con,
		const char *	longName,
		char	shortName,
		const char *	nextCharArg
	)			`[static]`

< aliases nested too deeply

Definition at line 319 of file popt.c.

References poptOption::longName, poptItem_s::option, and poptOption::shortName.

static int handleExec	(	poptContext	con,
		const char *	longName,
		char	shortName
	)			`[static]`

< ignore exec expansions

Definition at line 262 of file popt.c.

References poptContext_s::execs, poptOption::longName, poptItem_s::option, and poptOption::shortName.

static void invokeCallbacksOPTION	(	poptContext	con,
		const struct poptOption *	opt,
		const struct poptOption *	myOpt,
		const void *	myData,
		int	shorty
	)			`[static]`

< arg points to table

< table-wide callback... must be set first in table; arg points to callback, descrip points to callback data to pass

< don't callback with option

< continue callbacks with option

Definition at line 122 of file popt.c.

References poptOption::arg, poptOption::argInfo, poptOption::descrip, poptOption::longName, optionStackEntry::nextArg, poptContext_s::os, POPT_ARG_CALLBACK, POPT_ARG_INCLUDE_TABLE, POPT_ARG_MASK, POPT_CALLBACK_REASON_OPTION, POPT_CBFLAG_CONTINUE, POPT_CBFLAG_SKIPOPTION, poptHelpOptions, poptHelpOptionsI18N, and poptOption::shortName.

static void invokeCallbacksPOST	(	poptContext	con,
		const struct poptOption *	opt
	)			`[static]`

< arg points to table

< table-wide callback... must be set first in table; arg points to callback, descrip points to callback data to pass

< call the callback after parse

Definition at line 93 of file popt.c.

References poptOption::arg, poptOption::argInfo, poptOption::descrip, poptOption::longName, POPT_ARG_CALLBACK, POPT_ARG_INCLUDE_TABLE, POPT_ARG_MASK, POPT_CALLBACK_REASON_POST, POPT_CBFLAG_POST, poptHelpOptions, poptHelpOptionsI18N, and poptOption::shortName.

static void invokeCallbacksPRE	(	poptContext	con,
		const struct poptOption *	opt
	)			`[static]`

< arg points to table

< table-wide callback... must be set first in table; arg points to callback, descrip points to callback data to pass

< call the callback before parse

Definition at line 64 of file popt.c.

References poptOption::arg, poptOption::argInfo, poptOption::descrip, poptOption::longName, POPT_ARG_CALLBACK, POPT_ARG_INCLUDE_TABLE, POPT_ARG_MASK, POPT_CALLBACK_REASON_PRE, POPT_CBFLAG_PRE, poptHelpOptions, poptHelpOptionsI18N, and poptOption::shortName.

int poptAddAlias	(	poptContext	con,
		struct poptAlias	alias,
		int	flags
	)

Add alias to context.

Todo:: Pass alias by reference, not value.

Deprecated:: Use poptAddItem instead.

Parameters:

	con	context
	alias	alias to add
	flags	(unused)

Returns:: 0 on success

< don't show in help/usage

Definition at line 1125 of file popt.c.

int poptAddItem	(	poptContext	con,
		poptItem	newItem,
		int	flags
	)

Add alias/exec item to context.

Parameters:

	con	context
	newItem	alias/exec item to add
	flags	0 for alias, 1 for exec

Returns:: 0 on success

Definition at line 1143 of file popt.c.

Referenced by configLine().

const char* poptBadOption	(	poptContext	con,
		unsigned int	flags
	)

Return the option which caused the most recent error.

Parameters:

	con	context
	flags

Returns:: offending option

< don't go into an alias

Definition at line 1186 of file popt.c.

poptContext poptFreeContext ( poptContext con )

Destroy context.

Parameters:

con

context

Returns:: NULL always

Definition at line 1081 of file popt.c.

Referenced by displayArgs().

const char* poptGetArg ( poptContext con )

Return next argument.

Parameters:

con

context

Returns:: next argument, NULL if no argument is available

Definition at line 1051 of file popt.c.

const char** poptGetArgs ( poptContext con )

Return remaining arguments.

Parameters:

con

context

Returns:: argument array, NULL terminated

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.

Parameters:

	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

Returns:: initialized popt context

< pay attention to argv[0]

< options can't follow args

Definition at line 171 of file popt.c.

const char* poptGetInvocationName ( poptContext con )

Return argv[0] from context.

Parameters:

con

context

Returns:: argv[0]

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.

Parameters:

con

context

Returns:: next option val, -1 on last item, POPT_ERROR_* on error

< unknown option

< options can't follow args

< return args as options with value 0

< unknown option

< strip this arg from argv(only applies to long args)

< 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

< 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 )

Return next option argument (if any).

Parameters:

con

context

Returns:: option argument, NULL if no argument is available

Definition at line 1041 of file popt.c.

const char* poptPeekArg ( poptContext con )

Peek at current argument.

Parameters:

con

context

Returns:: current argument, NULL if no argument is available

Definition at line 1059 of file popt.c.

void poptResetContext ( poptContext con )

Reinitialize popt context.

Parameters:

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.

Warning:: Alignment check may be too strict on certain platorms.

Parameters:

	arg	integer pointer, aligned on int boundary.
	argInfo	logical operation (see POPT_ARGFLAG_*)
	aLong	value to use

Returns:: 0 on success, POPT_ERROR_NULLARG/POPT_ERROR_BADOPERATION

< 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

Definition at line 688 of file popt.c.

int poptSaveLong	(	long *	arg,
		unsigned int	argInfo,
		long	aLong
	)

Save a long, performing logical operation with value.

Warning:: Alignment check may be too strict on certain platorms.

Parameters:

	arg	integer pointer, aligned on int boundary.
	argInfo	logical operation (see POPT_ARGFLAG_*)
	aLong	value to use

Returns:: 0 on success, POPT_ERROR_NULLARG/POPT_ERROR_BADOPERATION

< 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

Definition at line 650 of file popt.c.

void poptSetExecPath	(	poptContext	con,
		const char *	path,
		int	allowAbsolute
	)

Limit search for executables.

Parameters:

	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.

const char* poptStrerror ( const int error )

Return formatted error string for popt failure.

Parameters:

error

popt error

Returns:: error string

< 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)

Definition at line 1196 of file popt.c.

static void poptStripArg	(	poptContext	con,
		int	which
	)			`[static]`

Definition at line 630 of file popt.c.

int poptStrippedArgv	(	poptContext	con,
		int	argc,
		char **	argv
	)

Shuffle argv pointers to remove stripped args, returns new argc.

Parameters:

	con	context
	argc	no. of args
	argv	arg vector

Returns:: new argc

Definition at line 1252 of file popt.c.

References poptContext_s::arg_strip, and PBM_ISSET.

int poptStuffArgs	(	poptContext	con,
		const char **	argv
	)

Add arguments to context.

Parameters:

	con	context
	argv	argument array, NULL terminated

Returns:: 0 on success, POPT_ERROR_OPTSTOODEEP on failure

< aliases nested too deeply

Definition at line 1224 of file popt.c.

static char* strerror ( int errno ) [static]

Definition at line 27 of file popt.c.

References POPT_.

Variable Documentation

unsigned int seed = 0 [static]

Definition at line 647 of file popt.c.


Defines
#define	_ABS(a) ((((a) - 0.0) < DBL_EPSILON) ? -(a) : (a))
Functions
static char *	strerror (int errno)
void	poptSetExecPath (poptContext con, const char *path, int allowAbsolute)
	Limit search for executables.
static void	invokeCallbacksPRE (poptContext con, const struct poptOption *opt)
static void	invokeCallbacksPOST (poptContext con, const struct poptOption *opt)
static void	invokeCallbacksOPTION (poptContext con, const struct poptOption opt, const struct poptOption myOpt, const void *myData, int shorty)
poptContext	poptGetContext (const char name, int argc, const char argv, const struct poptOption options, unsigned int flags)
	Initialize popt context.
static void	cleanOSE (struct optionStackEntry *os)
void	poptResetContext (poptContext con)
	Reinitialize popt context.
static int	handleExec (poptContext con, const char *longName, char shortName)
static int	handleAlias (poptContext con, const char longName, char shortName, const char nextCharArg)
static int	execCommand (poptContext con)
static struct poptOption *	findOption (const struct poptOption opt, const char longName, int longNameLen, char shortName, poptCallbackType callback, const void *callbackData, int singleDash)
static const char *	findNextArg (poptContext con, unsigned argx, int delete_arg)
static const char *	expandNextArg (poptContext con, const char *s)
static void	poptStripArg (poptContext con, int which)
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.
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.
poptContext	poptFreeContext (poptContext con)
	Destroy 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.
const char *	poptBadOption (poptContext con, unsigned int flags)
	Return the option which caused the most recent error.
const char *	poptStrerror (const int error)
	Return formatted error string for popt failure.
int	poptStuffArgs (poptContext con, const char **argv)
	Add arguments to context.
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.
Variables
static unsigned int	seed = 0