popt/popt.c

ソースコードを見る。

関数
static char *	strerror (int errno)
static void	prtcon (const char *msg, poptContext con)
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, 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, 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, int argInfo, long aLong)
	Save a long, performing logical operation with value.
int	poptSaveInt (int *arg, int argInfo, long aLong)
	Save an integer, performing logical operation with value.
int	poptGetNextOpt (poptContext con)
	Return value of next option found.
const 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, 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.
変数
int	_popt_debug = 0

---

説明

popt.c で定義されています。

---

関数

static char* strerror

(

int

errno

)

[static]

popt.c の 27 行で定義されています。

参照先 sys_errlist.

参照元 _tdb_lockall()・_tdb_unlockall()・ads_errstr()・aixjfs2_get_nfs4_acl()・aixjfs2_get_posix_acl()・aixjfs2_getacl_alloc()・aixjfs2_process_smbacl()・aixjfs2_query_acl_support()・aixjfs2_sys_acl_set_fd()・aixjfs2_sys_acl_set_file()・audit_chmod()・audit_chmod_acl()・audit_close()・audit_fchmod()・audit_fchmod_acl()・audit_mkdir()・audit_open()・audit_opendir()・audit_rename()・audit_rmdir()・audit_unlink()・backup_registry_key()・call_trans2qfilepathinfo()・call_trans2qfsinfo()・call_trans2setfilepathinfo()・cb_itemsignal()・cb_select_child()・cb_wholenet()・change_dir_owner_to_parent()・change_file_owner_to_parent()・check_client_uid()・cifs_resolver()・cli_connect()・cli_errstr()・cli_send_smb()・client_inaddr()・cm_prepare_connection()・cmd_chmod()・cmd_chown()・cmd_close()・cmd_closedir()・cmd_fchmod()・cmd_fchown()・cmd_fstat()・cmd_fsync()・cmd_ftruncate()・cmd_getwd()・cmd_link()・cmd_lock()・cmd_lseek()・cmd_lstat()・cmd_mkdir()・cmd_mknod()・cmd_mput()・cmd_open()・cmd_opendir()・cmd_pathfunc()・cmd_read()・cmd_readlink()・cmd_realpath()・cmd_rename()・cmd_rmdir()・cmd_stat()・cmd_symlink()・cmd_utime()・cmd_write()・copy_file()・count_num_usershares()・create_conn_struct()・create_local_private_krb5_conf_for_domain()・create_msdfs_link()・create_pipe_sock()・create_posix_acl_from_wire()・create_tdb()・cups_connect()・decode_key_description()・delete_memory_creds()・disk_quotas_vxfs()・dns_send_req()・do_cd()・do_daemon_stack_trace()・do_get()・do_global_checks()・do_krb5_kpasswd_request()・do_log()・do_mkdir()・do_put()・dptr_get()・dump_all_namelists()・expect()・fail_readraw()・fcntl_getlock()・fcntl_lock()・fd_open()・fetch_database_to_ldif()・find_new_dc()・fork_child_dc_connect()・fork_domain_child()・fullpath()・get_dir_entry()・get_ea_dos_attribute()・get_lanman2_dir_entry()・get_password_file()・get_password_from_file()・get_peer_addr()・get_server_info()・get_share_list()・get_socket_addr()・get_socket_port()・gpfs_get_nfs4_acl()・gpfs_getacl_alloc()・gpfsacl_get_posix_acl()・gpfsacl_process_smbacl()・handle_aio_read_complete()・handle_aio_write_complete()・hpux_acl_call_present()・hpux_acl_get_file()・hpux_aclsort_call_present()・hpuxacl_sys_acl_get_file()・hpuxacl_sys_acl_set_file()・info_fn()・init_gpfs()・init_mount()・initialise_wins()・initialize_winbindd_cache()・inotify_setup()・inotify_watch()・iprint_cache_reload()・iprint_job_delete()・iprint_job_pause()・iprint_job_resume()・iprint_job_submit()・iprint_queue_get()・irix_init_kernel_oplocks()・irix_oplock_receive_message()・irix_oplocks_available()・irix_release_kernel_oplock()・irix_set_kernel_oplock()・is_msdfs_link()・lang_tdb_init()・ldap_open_with_timeout()・linux_release_kernel_oplock()・linux_set_kernel_oplock()・load_inherited_info()・load_lmhosts_file()・load_usershare_service()・lock_mtab()・main()・make_connection_with_chdir()・make_subnet()・manage_squid_request()・map_file()・map_username()・message_notify()・mkdir_internal()・nb_readx()・nb_writex()・net_time_set()・net_usershare()・net_usershare_add()・net_usershare_delete()・nt_printing_init()・open_file()・open_socket_in()・open_socket_out()・open_sockets_smbd()・open_tdb()・OpenConfFile()・OpenDir()・parse_usershare_file()・pidfile_create()・poptStrerror()・posix_fcntl_getlock()・posix_fcntl_lock()・posixacl_sys_acl_set_file()・preallocate_space()・print_job_start()・print_stack_trace()・process()・process_blocking_lock_queue()・process_file()・process_usershare_file()・profile_setup()・pw_file_lock()・pw_file_unlock()・py_tdb_close()・py_tdb_open()・read_block()・read_data()・read_data_until()・read_socket_with_timeout()・read_target_host()・read_udp_socket()・receive_packet()・recycle_create_dir()・recycle_do_touch()・recycle_get_file_size()・recycle_unlink()・regdb_init()・regdb_open()・regf_hbin_allocate()・regfio_open()・release_posix_lock_windows_flavour()・remove_from_mtab()・remove_posix_acl()・reopen_logs()・reply_checkpath()・reply_getatr()・reply_writebraw()・restore_registry_key()・rmdir_internals()・rpc_share_allowedusers_internals()・schedule_aio_read_and_X()・schedule_aio_write_and_X()・send_cldap_netlogon()・send_file_readbraw()・send_file_readX()・send_message()・send_smb()・send_udp()・set_canon_ace_list()・set_ea_dos_attribute()・set_gpfs_sharemode()・set_maxfiles()・set_nt_acl()・set_posix_lock_posix_flavour()・set_posix_lock_windows_flavour()・set_process_capability()・set_socket_options()・set_unix_posix_acl()・set_unix_posix_default_acl()・setup_out_fd()・share_info_db_init()・smb_acl_to_posix()・smb_acl_to_tru64_acl()・smb_download_dir()・smb_download_file()・smb_nscd_flush_cache()・smb_panic()・smb_permset_to_tru64()・smb_set_file_dosmode()・smb_set_nt_acl_nfs4()・smb_umount()・smbacl4_GetFileOwner()・smbrun_internal()・smbrunsecret()・sock_exec()・solaris_acl_get_fd()・solaris_acl_get_file()・solaris_attropen()・solaris_list_xattr()・solaris_openat()・solarisacl_sys_acl_get_fd()・solarisacl_sys_acl_get_file()・solarisacl_sys_acl_set_fd()・solarisacl_sys_acl_set_file()・start_background_queue()・startlmhosts()・startsmbfilepwent()・store_inheritance_attributes()・store_memory_creds()・sys_disk_free()・sys_fgetxattr()・sys_get_quota()・sys_getxattr()・sys_lgetxattr()・sys_set_quota()・sys_set_vfs_quota()・tdb_alloc_read()・tdb_expand_file()・tdb_mmap()・tdb_nextkey()・tdb_open_ex()・tdb_read()・tdb_reopen()・tdb_write()・tdbsam_new_rid()・test_ftruncate()・test_socketpair()・timeout_processing()・tool_list()・torture_utable()・transaction_sync()・transfer_file_internal()・tru64_ace_to_smb_ace()・tru64_acl_to_smb_acl()・tru64acl_sys_acl_set_file()・umount_check_perm()・umount_ok()・unix_error_packet()・unix_mode()・unmap_file()・user_can_read_file()・vfs_fill_sparse()・vfs_GetWd()・watch_destructor()・wcp_file_size_change()・winbindd_check_cache_size()・winbindd_pam_logoff()・wins_write_database()・write_block()・write_browse_list()・write_data()・write_data_at_offset()・write_socket()・writetarheader().

                                  {
    extern int sys_nerr;
    extern char * sys_errlist[];

    if ((0 <= errno) && (errno < sys_nerr))
        return sys_errlist[errno];
    else
        return POPT_("unknown errno");
}

static void prtcon	(	const char *	msg,
		poptContext	con
	)			[static]

popt.c の 39 行で定義されています。

参照先 optionStackEntry::argv・fprintf()・optionStackEntry::next・optionStackEntry::nextArg・optionStackEntry::nextCharArg・poptContext_s::os.

{
    if (msg) fprintf(stderr, "%s", msg);
    fprintf(stderr, "\tcon %p os %p nextCharArg \"%s\" nextArg \"%s\" argv[%d] \"%s\"\n",
        con, con->os,
        (con->os->nextCharArg ? con->os->nextCharArg : ""),
        (con->os->nextArg ? con->os->nextArg : ""),
        con->os->next,
        (con->os->argv && con->os->argv[con->os->next]
                ? con->os->argv[con->os->next] : ""));
}

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?

popt.c の 52 行で定義されています。

参照先 _free()・poptContext_s::execAbsolute・poptContext_s::execPath・xstrdup().

{
    con->execPath = (const char *)_free(con->execPath);
    con->execPath = xstrdup(path);
    con->execAbsolute = allowAbsolute;
    /*@-nullstate@*/ /* LCL: con->execPath can be NULL? */
    return;
    /*@=nullstate@*/
}

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

popt.c の 62 行で定義されています。

参照先 poptOption::arg・poptOption::argInfo・poptOption::descrip・poptOption::longName・POPT_CALLBACK_REASON_PRE・poptOption::shortName.

参照元 poptGetContext().

{
    if (opt != NULL)
    for (; opt->longName || opt->shortName || opt->arg; opt++) {
        if (opt->arg == NULL) continue;         /* XXX program error. */
        if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_INCLUDE_TABLE) {
            /* Recurse on included sub-tables. */
            invokeCallbacksPRE(con, (const struct poptOption *)opt->arg);
        } else if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_CALLBACK &&
                   (opt->argInfo & POPT_CBFLAG_PRE))
        {   /*@-castfcnptr@*/
            poptCallbackType cb = (poptCallbackType)opt->arg;
            /*@=castfcnptr@*/
            /* Perform callback. */
            /*@-moduncon -noeffectuncon @*/
            cb(con, POPT_CALLBACK_REASON_PRE, NULL, NULL, opt->descrip);
            /*@=moduncon =noeffectuncon @*/
        }
    }
}

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

popt.c の 85 行で定義されています。

参照先 poptOption::arg・poptOption::argInfo・poptOption::descrip・poptOption::longName・POPT_CALLBACK_REASON_POST・poptOption::shortName.

参照元 poptGetNextOpt().

{
    if (opt != NULL)
    for (; opt->longName || opt->shortName || opt->arg; opt++) {
        if (opt->arg == NULL) continue;         /* XXX program error. */
        if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_INCLUDE_TABLE) {
            /* Recurse on included sub-tables. */
            invokeCallbacksPOST(con, (const struct poptOption *)opt->arg);
        } else if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_CALLBACK &&
                   (opt->argInfo & POPT_CBFLAG_POST))
        {   /*@-castfcnptr@*/
            poptCallbackType cb = (poptCallbackType)opt->arg;
            /*@=castfcnptr@*/
            /* Perform callback. */
            /*@-moduncon -noeffectuncon @*/
            cb(con, POPT_CALLBACK_REASON_POST, NULL, NULL, opt->descrip);
            /*@=moduncon =noeffectuncon @*/
        }
    }
}

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

popt.c の 108 行で定義されています。

参照先 poptOption::arg・poptOption::argInfo・poptOption::longName・poptOption::shortName.

参照元 poptGetNextOpt().

{
    const struct poptOption * cbopt = NULL;

    if (opt != NULL)
    for (; opt->longName || opt->shortName || opt->arg; opt++) {
        if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_INCLUDE_TABLE) {
            /* Recurse on included sub-tables. */
            if (opt->arg != NULL)       /* XXX program error */
                invokeCallbacksOPTION(con, (const struct poptOption *)opt->arg,
                                      myOpt, myData, shorty);
        } else if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_CALLBACK &&
                  !(opt->argInfo & POPT_CBFLAG_SKIPOPTION)) {
            /* Save callback info. */
            cbopt = opt;
        } else if (cbopt != NULL &&
                   ((myOpt->shortName && opt->shortName && shorty &&
                        myOpt->shortName == opt->shortName) ||
                    (myOpt->longName && opt->longName &&
                /*@-nullpass@*/         /* LCL: opt->longName != NULL */
                        !strcmp(myOpt->longName, opt->longName)))
                /*@=nullpass@*/
                   )
        {   /*@-castfcnptr@*/
            poptCallbackType cb = (poptCallbackType)cbopt->arg;
            /*@=castfcnptr@*/
            const void * cbData = (cbopt->descrip ? cbopt->descrip : myData);
            /* Perform callback. */
            if (cb != NULL) {   /* XXX program error */
                /*@-moduncon -noeffectuncon @*/
                cb(con, POPT_CALLBACK_REASON_OPTION, myOpt,
                        con->os->nextArg, cbData);
                /*@=moduncon =noeffectuncon @*/
            }
            /* Terminate (unless explcitly continuing). */
            if (!(cbopt->argInfo & POPT_CBFLAG_CONTINUE))
                return;
        }
    }
}

poptContext poptGetContext	(	const char *	name,
		int	argc,
		const char **	argv,
		const struct poptOption *	options,
		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

戻り値:

initialized popt context

popt.c の 154 行で定義されています。

参照先 invokeCallbacksPRE()・options・t.

参照元 main()・parse_quota_set()・rpc_reg_shutdown_internals().

{
    poptContext con = (poptContext)malloc(sizeof(*con));

    if (con == NULL) return NULL;       /* XXX can't happen */
    memset(con, 0, sizeof(*con));

    con->os = con->optionStack;
    con->os->argc = argc;
    /*@-dependenttrans -assignexpose@*/ /* FIX: W2DO? */
    con->os->argv = argv;
    /*@=dependenttrans =assignexpose@*/
    con->os->argb = NULL;

    if (!(flags & POPT_CONTEXT_KEEP_FIRST))
        con->os->next = 1;                      /* skip argv[0] */

    con->leftovers = (const char **)calloc( (argc + 1),
                                            sizeof(*con->leftovers) );
    /*@-dependenttrans -assignexpose@*/ /* FIX: W2DO? */
    con->options = options;
    /*@=dependenttrans =assignexpose@*/
    con->aliases = NULL;
    con->numAliases = 0;
    con->flags = flags;
    con->execs = NULL;
    con->numExecs = 0;
    con->finalArgvAlloced = argc * 2;
    con->finalArgv = (const char **)calloc( con->finalArgvAlloced,
                                            sizeof(*con->finalArgv) );
    con->execAbsolute = 1;
    con->arg_strip = NULL;

    if (getenv("POSIXLY_CORRECT") || getenv("POSIX_ME_HARDER"))
        con->flags |= POPT_CONTEXT_POSIXMEHARDER;

    if (name) {
        char * t = (char *)malloc(strlen(name) + 1);
        if (t) con->appName = strcpy(t, name);
    }

    /*@-internalglobs@*/
    invokeCallbacksPRE(con, con->options);
    /*@=internalglobs@*/

    return con;
}

static void cleanOSE

(

struct optionStackEntry *

os

)

[static]

popt.c の 203 行で定義されています。

参照先 _free()・optionStackEntry::argb・optionStackEntry::argv・optionStackEntry::nextArg.

参照元 poptGetNextOpt()・poptResetContext().

{
    os->nextArg = (const char *)_free(os->nextArg);
    os->argv = (const char **)_free(os->argv);
    os->argb = (pbm_set *)PBM_FREE(os->argb);
}

void poptResetContext

(

poptContext

con

)

Reinitialize popt context.

引数:

con

context

popt.c の 214 行で定義されています。

参照先 _free()・poptContext_s::arg_strip・optionStackEntry::argb・cleanOSE()・optionStackEntry::currAlias・poptContext_s::doExec・poptContext_s::finalArgv・poptContext_s::finalArgvCount・optionStackEntry::next・optionStackEntry::nextArg・optionStackEntry::nextCharArg・poptContext_s::nextLeftover・poptContext_s::numLeftovers・poptContext_s::optionStack・poptContext_s::os・poptContext_s::restLeftover.

参照元 poptFreeContext().

{
    int i;

    if (con == NULL) return;
    while (con->os > con->optionStack) {
        cleanOSE(con->os--);
    }
    con->os->argb = (pbm_set *)PBM_FREE(con->os->argb);
    con->os->currAlias = NULL;
    con->os->nextCharArg = NULL;
    con->os->nextArg = NULL;
    con->os->next = 1;                  /* skip argv[0] */

    con->numLeftovers = 0;
    con->nextLeftover = 0;
    con->restLeftover = 0;
    con->doExec = NULL;

    if (con->finalArgv != NULL)
    for (i = 0; i < con->finalArgvCount; i++) {
        /*@-unqualifiedtrans@*/         /* FIX: typedef double indirection. */
        con->finalArgv[i] = (const char *)_free(con->finalArgv[i]);
        /*@=unqualifiedtrans@*/
    }

    con->finalArgvCount = 0;
    con->arg_strip = ( pbm_set *)PBM_FREE(con->arg_strip);
    /*@-nullstate@*/    /* FIX: con->finalArgv != NULL */
    return;
    /*@=nullstate@*/
}

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

popt.c の 250 行で定義されています。

参照先 poptContext_s::doExec・poptContext_s::execs・poptContext_s::finalArgv・poptContext_s::finalArgvAlloced・poptContext_s::finalArgvCount・poptContext_s::flags・poptOption::longName・poptContext_s::numExecs・poptItem_s::option・poptOption::shortName・sprintf().

参照元 poptGetNextOpt().

{
    poptItem item;
    int i;

    if (con->execs == NULL || con->numExecs <= 0) /* XXX can't happen */
        return 0;

    for (i = con->numExecs - 1; i >= 0; i--) {
        item = con->execs + i;
        if (longName && !(item->option.longName &&
                        !strcmp(longName, item->option.longName)))
            continue;
        else if (shortName != item->option.shortName)
            continue;
        break;
    }
    if (i < 0) return 0;


    if (con->flags & POPT_CONTEXT_NO_EXEC)
        return 1;

    if (con->doExec == NULL) {
        con->doExec = con->execs + i;
        return 1;
    }

    /* We already have an exec to do; remember this option for next
       time 'round */
    if ((con->finalArgvCount + 1) >= (con->finalArgvAlloced)) {
        con->finalArgvAlloced += 10;
        con->finalArgv = (const char **)realloc(con->finalArgv,
                        sizeof(*con->finalArgv) * con->finalArgvAlloced);
    }

    i = con->finalArgvCount++;
    if (con->finalArgv != NULL) /* XXX can't happen */
    {   char *s  = (char *)malloc((longName ? strlen(longName) : 0) + 3);
        if (s != NULL) {        /* XXX can't happen */
            if (longName)
                sprintf(s, "--%s", longName);
            else
                sprintf(s, "-%c", shortName);
            con->finalArgv[i] = s;
        } else
            con->finalArgv[i] = NULL;
    }

    /*@-nullstate@*/    /* FIX: con->finalArgv[] == NULL */
    return 1;
    /*@=nullstate@*/
}

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

popt.c の 310 行で定義されています。

参照先 poptContext_s::aliases・optionStackEntry::argb・optionStackEntry::argc・poptItem_s::argc・optionStackEntry::argv・poptItem_s::argv・optionStackEntry::currAlias・poptOption::longName・optionStackEntry::next・optionStackEntry::nextArg・optionStackEntry::nextCharArg・poptContext_s::numAliases・poptItem_s::option・poptContext_s::optionStack・poptContext_s::os・poptDupArgv()・poptOption::shortName・optionStackEntry::stuffed.

参照元 poptGetNextOpt().

{
    poptItem item = con->os->currAlias;
    int rc;
    int i;

    if (item) {
        if (longName && (item->option.longName &&
                !strcmp(longName, item->option.longName)))
            return 0;
        if (shortName && shortName == item->option.shortName)
            return 0;
    }

    if (con->aliases == NULL || con->numAliases <= 0) /* XXX can't happen */
        return 0;

    for (i = con->numAliases - 1; i >= 0; i--) {
        item = con->aliases + i;
        if (longName && !(item->option.longName &&
                        !strcmp(longName, item->option.longName)))
            continue;
        else if (shortName != item->option.shortName)
            continue;
        break;
    }
    if (i < 0) return 0;

    if ((con->os - con->optionStack + 1) == POPT_OPTION_DEPTH)
        return POPT_ERROR_OPTSTOODEEP;

/*@-boundsread@*/
    if (nextCharArg && *nextCharArg)
        con->os->nextCharArg = nextCharArg;
/*@=boundsread@*/

    con->os++;
    con->os->next = 0;
    con->os->stuffed = 0;
    con->os->nextArg = NULL;
    con->os->nextCharArg = NULL;
    con->os->currAlias = con->aliases + i;
    rc = poptDupArgv(con->os->currAlias->argc, con->os->currAlias->argv,
                &con->os->argc, &con->os->argv);
    con->os->argb = NULL;

    return (rc ? rc : 1);
}

static int execCommand

(

poptContext

con

)

[static]

popt.c の 365 行で定義されています。

参照先 _popt_debug・alloca()・poptItem_s::argc・poptItem_s::argv・poptContext_s::doExec・poptContext_s::execAbsolute・poptContext_s::execPath・poptContext_s::finalArgv・poptContext_s::finalArgvCount・findProgramPath()・fprintf()・poptContext_s::leftovers・poptContext_s::numLeftovers・sprintf().

参照元 poptGetNextOpt().

{
    poptItem item = con->doExec;
    const char ** argv;
    int argc = 0;
    int rc;

    if (item == NULL) /*XXX can't happen*/
        return POPT_ERROR_NOARG;

    if (item->argv == NULL || item->argc < 1 ||
        (!con->execAbsolute && strchr(item->argv[0], '/')))
            return POPT_ERROR_NOARG;

    argv = (const char **)malloc(
            sizeof(*argv) * (6 + item->argc + con->numLeftovers + con->finalArgvCount));
    if (argv == NULL) return POPT_ERROR_MALLOC; /* XXX can't happen */

    if (!strchr(item->argv[0], '/') && con->execPath) {
        char *s = (char *)alloca(
                strlen(con->execPath) + strlen(item->argv[0]) + sizeof("/"));
        sprintf(s, "%s/%s", con->execPath, item->argv[0]);
        argv[argc] = s;
    } else {
        argv[argc] = findProgramPath(item->argv[0]);
    }
    if (argv[argc++] == NULL) return POPT_ERROR_NOARG;

    if (item->argc > 1) {
        memcpy(argv + argc, item->argv + 1, sizeof(*argv) * (item->argc - 1));
        argc += (item->argc - 1);
    }

    if (con->finalArgv != NULL && con->finalArgvCount > 0) {
        memcpy(argv + argc, con->finalArgv,
                sizeof(*argv) * con->finalArgvCount);
        argc += con->finalArgvCount;
    }

    if (con->leftovers != NULL && con->numLeftovers > 0) {
#if 0
        argv[argc++] = "--";
#endif
        memcpy(argv + argc, con->leftovers, sizeof(*argv) * con->numLeftovers);
        argc += con->numLeftovers;
    }

    argv[argc] = NULL;

#ifdef __hpux
    rc = setresuid(getuid(), getuid(),-1);
    if (rc) return POPT_ERROR_ERRNO;
#else
/*
 * XXX " ... on BSD systems setuid() should be preferred over setreuid()"
 * XXX  sez' Timur Bakeyev <mc@bat.ru>
 * XXX  from Norbert Warmuth <nwarmuth@privat.circular.de>
 */
#if defined(HAVE_SETUID)
    rc = setuid(getuid());
    if (rc) return POPT_ERROR_ERRNO;
#elif defined (HAVE_SETREUID)
    rc = setreuid(getuid(), getuid()); /*hlauer: not portable to hpux9.01 */
    if (rc) return POPT_ERROR_ERRNO;
#else
    ; /* Can't drop privileges */
#endif
#endif

    if (argv[0] == NULL)
        return POPT_ERROR_NOARG;

#ifdef  MYDEBUG
if (_popt_debug)
    {   const char ** avp;
        fprintf(stderr, "==> execvp(%s) argv[%d]:", argv[0], argc);
        for (avp = argv; *avp; avp++)
            fprintf(stderr, " '%s'", *avp);
        fprintf(stderr, "\n");
    }
#endif

    rc = execvp(argv[0], (char *const *)argv);
    /* notreached */
    if (rc) {
        return POPT_ERROR_ERRNO;
    }
 
    return 0;
}

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

popt.c の 461 行で定義されています。

参照先 poptOption::arg・poptOption::argInfo・poptOption::descrip・poptOption::longName・poptOption::shortName.

参照元 poptGetNextOpt().

{
    const struct poptOption * cb = NULL;

    /* This happens when a single - is given */
    if (singleDash && !shortName && (longName && *longName == '\0'))
        shortName = '-';

    for (; opt->longName || opt->shortName || opt->arg; opt++) {

        if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_INCLUDE_TABLE) {
            const struct poptOption * opt2;

            /* Recurse on included sub-tables. */
            if (opt->arg == NULL) continue;     /* XXX program error */
            opt2 = findOption((const struct poptOption *)opt->arg, longName,
                              shortName, callback,
                              callbackData, singleDash);
            if (opt2 == NULL) continue;
            /* Sub-table data will be inheirited if no data yet. */
            if (!(callback && *callback)) return opt2;
            if (!(callbackData && *callbackData == NULL)) return opt2;
            /*@-observertrans -dependenttrans @*/
            *callbackData = opt->descrip;
            /*@=observertrans =dependenttrans @*/
            return opt2;
        } else if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_CALLBACK) {
            cb = opt;
        } else if (longName && opt->longName &&
                   (!singleDash || (opt->argInfo & POPT_ARGFLAG_ONEDASH)) &&
                /*@-nullpass@*/         /* LCL: opt->longName != NULL */
                   !strcmp(longName, opt->longName))
                /*@=nullpass@*/
        {
            break;
        } else if (shortName && shortName == opt->shortName) {
            break;
        }
    }

    if (!opt->longName && !opt->shortName)
        return NULL;
    /*@-modobserver -mods @*/
    if (callback) *callback = NULL;
    if (callbackData) *callbackData = NULL;
    if (cb) {
        if (callback)
        /*@-castfcnptr@*/
            *callback = (poptCallbackType)cb->arg;
        /*@=castfcnptr@*/
        if (!(cb->argInfo & POPT_CBFLAG_INC_DATA)) {
            if (callbackData)
                /*@-observertrans@*/    /* FIX: typedef double indirection. */
                *callbackData = cb->descrip;
                /*@=observertrans@*/
        }
    }
    /*@=modobserver =mods @*/

    return opt;
}

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

popt.c の 529 行で定義されています。

参照先 optionStackEntry::argb・optionStackEntry::argc・optionStackEntry::argv・optionStackEntry::next・poptContext_s::optionStack・poptContext_s::os.

参照元 expandNextArg().

{
    struct optionStackEntry * os = con->os;
    const char * arg;

    do {
        int i;
        arg = NULL;
        while (os->next == os->argc && os > con->optionStack) os--;
        if (os->next == os->argc && os == con->optionStack) break;
        if (os->argv != NULL)
        for (i = os->next; i < os->argc; i++) {
            /*@-sizeoftype@*/
            if (os->argb && PBM_ISSET(i, os->argb))
                /*@innercontinue@*/ continue;
            if (*os->argv[i] == '-')
                /*@innercontinue@*/ continue;
            if (--argx > 0)
                /*@innercontinue@*/ continue;
            arg = os->argv[i];
            if (delete_arg) {
                if (os->argb == NULL) os->argb = (pbm_set *)PBM_ALLOC(os->argc);
                if (os->argb != NULL)   /* XXX can't happen */
                PBM_SET(i, os->argb);
            }
            /*@innerbreak@*/ break;
            /*@=sizeoftype@*/
        }
        if (os > con->optionStack) os--;
    } while (arg == NULL);
    return arg;
}

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

popt.c の 568 行で定義されています。

参照先 c・findNextArg()・t.

参照元 poptGetNextOpt().

{
    const char * a = NULL;
    size_t alen;
    char *t, *te;
    size_t tn = strlen(s) + 1;
    char c;

    te = t = (char *)malloc(tn);;
    if (t == NULL) return NULL;         /* XXX can't happen */
    while ((c = *s++) != '\0') {
        switch (c) {
#if 0   /* XXX can't do this */
        case '\\':      /* escape */
            c = *s++;
            /*@switchbreak@*/ break;
#endif
        case '!':
            if (!(s[0] == '#' && s[1] == ':' && s[2] == '+'))
                /*@switchbreak@*/ break;
            /* XXX Make sure that findNextArg deletes only next arg. */
            if (a == NULL) {
                if ((a = findNextArg(con, 1, 1)) == NULL)
                    /*@switchbreak@*/ break;
            }
            s += 3;

            alen = strlen(a);
            tn += alen;
            *te = '\0';
            t = (char *)realloc(t, tn);
            te = t + strlen(t);
            strncpy(te, a, alen); te += alen;
            continue;
            /*@notreached@*/ /*@switchbreak@*/ break;
        default:
            /*@switchbreak@*/ break;
        }
        *te++ = c;
    }
    *te = '\0';
    t = (char *)realloc(t, strlen(t) + 1); /* XXX memory leak, hard to plug */
    return t;
}

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

popt.c の 617 行で定義されています。

参照先 poptContext_s::arg_strip・optionStackEntry::argc・poptContext_s::optionStack.

参照元 poptGetNextOpt().

{
    /*@-sizeoftype@*/
    if (con->arg_strip == NULL)
        con->arg_strip = (pbm_set *)PBM_ALLOC(con->optionStack[0].argc);
    if (con->arg_strip != NULL)         /* XXX can't happen */
    PBM_SET(which, con->arg_strip);
    /*@=sizeoftype@*/
    /*@-compdef@*/ /* LCL: con->arg_strip udefined? */
    return;
    /*@=compdef@*/
}

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

Save a long, performing logical operation with value.

警告:

Alignment check may be too strict on certain platorms.

引数:

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

戻り値:

0 on success, POPT_ERROR_NULLARG/POPT_ERROR_BADOPERATION

popt.c の 633 行で定義されています。

参照元 poptGetNextOpt().

{
    /* XXX Check alignment, may fail on funky platforms. */
    if (arg == NULL || (((unsigned long)arg) & (sizeof(*arg)-1)))
        return POPT_ERROR_NULLARG;

    if (argInfo & POPT_ARGFLAG_NOT)
        aLong = ~aLong;
    switch (argInfo & POPT_ARGFLAG_LOGICALOPS) {
    case 0:
        *arg = aLong;
        break;
    case POPT_ARGFLAG_OR:
        *arg |= aLong;
        break;
    case POPT_ARGFLAG_AND:
        *arg &= aLong;
        break;
    case POPT_ARGFLAG_XOR:
        *arg ^= aLong;
        break;
    default:
        return POPT_ERROR_BADOPERATION;
        /*@notreached@*/ break;
    }
    return 0;
}

int poptSaveInt	(	int *	arg,
		int	argInfo,
		long	aLong
	)

Save an integer, performing logical operation with value.

警告:

Alignment check may be too strict on certain platorms.

引数:

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

戻り値:

0 on success, POPT_ERROR_NULLARG/POPT_ERROR_BADOPERATION

popt.c の 661 行で定義されています。

参照元 poptGetNextOpt().

{
    /* XXX Check alignment, may fail on funky platforms. */
    if (arg == NULL || (((unsigned long)arg) & (sizeof(*arg)-1)))
        return POPT_ERROR_NULLARG;

    if (argInfo & POPT_ARGFLAG_NOT)
        aLong = ~aLong;
    switch (argInfo & POPT_ARGFLAG_LOGICALOPS) {
    case 0:
        *arg = aLong;
        break;
    case POPT_ARGFLAG_OR:
        *arg |= aLong;
        break;
    case POPT_ARGFLAG_AND:
        *arg &= aLong;
        break;
    case POPT_ARGFLAG_XOR:
        *arg ^= aLong;
        break;
    default:
        return POPT_ERROR_BADOPERATION;
        /*@notreached@*/ break;
    }
    return 0;
}

int poptGetNextOpt

(

poptContext

con

)

Return value of next option found.

引数:

con

context

戻り値:

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

popt.c の 691 行で定義されています。

参照先 _free()・alloca()・poptOption::arg・optionStackEntry::argb・optionStackEntry::argc・poptOption::argInfo・optionStackEntry::argv・cleanOSE()・poptContext_s::doExec・errno・execCommand()・expandNextArg()・poptContext_s::finalArgv・poptContext_s::finalArgvAlloced・poptContext_s::finalArgvCount・findOption()・poptContext_s::flags・fprintf()・handleAlias()・handleExec()・invokeCallbacksOPTION()・invokeCallbacksPOST()・poptContext_s::leftovers・poptOption::longName・optionStackEntry::next・optionStackEntry::nextArg・optionStackEntry::nextCharArg・poptContext_s::numLeftovers・poptContext_s::options・poptContext_s::optionStack・poptContext_s::os・poptSaveInt()・poptSaveLong()・poptStripArg()・poptContext_s::restLeftover・poptOption::shortName・sprintf()・poptOption::val・xstrdup().

参照元 main()・parse_quota_set()・rpc_reg_shutdown_internals().

{
    const struct poptOption * opt = NULL;
    int done = 0;

    if (con == NULL)
        return -1;
    while (!done) {
        const char * origOptString = NULL;
        poptCallbackType cb = NULL;
        const void * cbData = NULL;
        const char * longArg = NULL;
        int canstrip = 0;
        int shorty = 0;

        while (!con->os->nextCharArg && con->os->next == con->os->argc
                && con->os > con->optionStack) {
            cleanOSE(con->os--);
        }
        if (!con->os->nextCharArg && con->os->next == con->os->argc) {
            /*@-internalglobs@*/
            invokeCallbacksPOST(con, con->options);
            /*@=internalglobs@*/
            if (con->doExec) return execCommand(con);
            return -1;
        }

        /* Process next long option */
        if (!con->os->nextCharArg) {
            char * localOptString, * optString;
            int thisopt;

            /*@-sizeoftype@*/
            if (con->os->argb && PBM_ISSET(con->os->next, con->os->argb)) {
                con->os->next++;
                continue;
            }
            /*@=sizeoftype@*/
            thisopt = con->os->next;
            if (con->os->argv != NULL)  /* XXX can't happen */
            origOptString = con->os->argv[con->os->next++];

            if (origOptString == NULL)  /* XXX can't happen */
                return POPT_ERROR_BADOPT;

            if (con->restLeftover || *origOptString != '-') {
                if (con->flags & POPT_CONTEXT_POSIXMEHARDER)
                    con->restLeftover = 1;
                if (con->flags & POPT_CONTEXT_ARG_OPTS) {
                    con->os->nextArg = xstrdup(origOptString);
                    return 0;
                }
                if (con->leftovers != NULL)     /* XXX can't happen */
                    con->leftovers[con->numLeftovers++] = origOptString;
                continue;
            }

            /* Make a copy we can hack at */
            localOptString = optString =
                strcpy((char *)alloca(strlen(origOptString) + 1),
                       origOptString);

            if (optString[0] == '\0')
                return POPT_ERROR_BADOPT;

            if (optString[1] == '-' && !optString[2]) {
                con->restLeftover = 1;
                continue;
            } else {
                char *oe;
                int singleDash;

                optString++;
                if (*optString == '-')
                    singleDash = 0, optString++;
                else
                    singleDash = 1;

                /* XXX aliases with arg substitution need "--alias=arg" */
                if (handleAlias(con, optString, '\0', NULL))
                    continue;

                if (handleExec(con, optString, '\0'))
                    continue;

                /* Check for "--long=arg" option. */
                for (oe = optString; *oe && *oe != '='; oe++)
                    {};
                if (*oe == '=') {
                    *oe++ = '\0';
                    /* XXX longArg is mapped back to persistent storage. */
                    longArg = origOptString + (oe - localOptString);
                }

                opt = findOption(con->options, optString, '\0', &cb, &cbData,
                                 singleDash);
                if (!opt && !singleDash)
                    return POPT_ERROR_BADOPT;
            }

            if (!opt) {
                con->os->nextCharArg = origOptString + 1;
            } else {
                if (con->os == con->optionStack &&
                   opt->argInfo & POPT_ARGFLAG_STRIP)
                {
                    canstrip = 1;
                    poptStripArg(con, thisopt);
                }
                shorty = 0;
            }
        }

        /* Process next short option */
        /*@-branchstate@*/              /* FIX: W2DO? */
        if (con->os->nextCharArg) {
            origOptString = con->os->nextCharArg;

            con->os->nextCharArg = NULL;

            if (handleAlias(con, NULL, *origOptString, origOptString + 1))
                continue;

            if (handleExec(con, NULL, *origOptString)) {
                /* Restore rest of short options for further processing */
                origOptString++;
                if (*origOptString != '\0')
                    con->os->nextCharArg = origOptString;
                continue;
            }

            opt = findOption(con->options, NULL, *origOptString, &cb,
                             &cbData, 0);
            if (!opt)
                return POPT_ERROR_BADOPT;
            shorty = 1;

            origOptString++;
            if (*origOptString != '\0')
                con->os->nextCharArg = origOptString;
        }
        /*@=branchstate@*/

        if (opt == NULL) return POPT_ERROR_BADOPT;      /* XXX can't happen */
        if (opt->arg && (opt->argInfo & POPT_ARG_MASK) == POPT_ARG_NONE) {
            if (poptSaveInt((int *)opt->arg, opt->argInfo, 1L))
                return POPT_ERROR_BADOPERATION;
        } else if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_VAL) {
            if (opt->arg) {
                if (poptSaveInt((int *)opt->arg, opt->argInfo, (long)opt->val))
                    return POPT_ERROR_BADOPERATION;
            }
        } else if ((opt->argInfo & POPT_ARG_MASK) != POPT_ARG_NONE) {
            con->os->nextArg = (const char *)_free(con->os->nextArg);
            /*@-usedef@*/       /* FIX: W2DO? */
            if (longArg) {
            /*@=usedef@*/
                longArg = expandNextArg(con, longArg);
                con->os->nextArg = longArg;
            } else if (con->os->nextCharArg) {
                longArg = expandNextArg(con, con->os->nextCharArg);
                con->os->nextArg = longArg;
                con->os->nextCharArg = NULL;
            } else {
                while (con->os->next == con->os->argc &&
                       con->os > con->optionStack) {
                    cleanOSE(con->os--);
                }
                if (con->os->next == con->os->argc) {
                    if (!(opt->argInfo & POPT_ARGFLAG_OPTIONAL))
                        /*@-compdef@*/  /* FIX: con->os->argv not defined */
                        return POPT_ERROR_NOARG;
                        /*@=compdef@*/
                    con->os->nextArg = NULL;
                } else {

                    /*
                     * Make sure this isn't part of a short arg or the
                     * result of an alias expansion.
                     */
                    if (con->os == con->optionStack &&
                        (opt->argInfo & POPT_ARGFLAG_STRIP) &&
                        canstrip) {
                        poptStripArg(con, con->os->next);
                    }
                
                    if (con->os->argv != NULL) {        /* XXX can't happen */
                        /* XXX watchout: subtle side-effects live here. */
                        longArg = con->os->argv[con->os->next++];
                        longArg = expandNextArg(con, longArg);
                        con->os->nextArg = longArg;
                    }
                }
            }
            longArg = NULL;

            if (opt->arg) {
                switch (opt->argInfo & POPT_ARG_MASK) {
                case POPT_ARG_STRING:
                    /* XXX memory leak, hard to plug */
                    *((const char **) opt->arg) = (con->os->nextArg)
                        ? xstrdup(con->os->nextArg) : NULL;
                    /*@switchbreak@*/ break;

                case POPT_ARG_INT:
                case POPT_ARG_LONG:
                {   long aLong = 0;
                    char *end;

                    if (con->os->nextArg) {
                        aLong = strtol(con->os->nextArg, &end, 0);
                        if (!(end && *end == '\0'))
                            return POPT_ERROR_BADNUMBER;
                    }

                    if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_LONG) {
                        if (aLong == LONG_MIN || aLong == LONG_MAX)
                            return POPT_ERROR_OVERFLOW;
                        if (poptSaveLong((long *)opt->arg, opt->argInfo, aLong))
                            return POPT_ERROR_BADOPERATION;
                    } else {
                        if (aLong > INT_MAX || aLong < INT_MIN)
                            return POPT_ERROR_OVERFLOW;
                        if (poptSaveInt((int *)opt->arg, opt->argInfo, aLong))
                            return POPT_ERROR_BADOPERATION;
                    }
                }   /*@switchbreak@*/ break;

                case POPT_ARG_FLOAT:
                case POPT_ARG_DOUBLE:
                {   double aDouble = 0.0;
                    char *end;

                    if (con->os->nextArg) {
                        /*@-mods@*/
                        int saveerrno = errno;
                        errno = 0;
                        aDouble = strtod(con->os->nextArg, &end);
                        if (errno == ERANGE)
                            return POPT_ERROR_OVERFLOW;
                        errno = saveerrno;
                        /*@=mods@*/
                        if (*end != '\0')
                            return POPT_ERROR_BADNUMBER;
                    }

                    if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_DOUBLE) {
                        *((double *) opt->arg) = aDouble;
                    } else {
#ifndef _ABS
#define _ABS(a) ((((a) - 0.0) < DBL_EPSILON) ? -(a) : (a))
#endif
                        if ((_ABS(aDouble) - FLT_MAX) > DBL_EPSILON)
                            return POPT_ERROR_OVERFLOW;
                        if ((FLT_MIN - _ABS(aDouble)) > DBL_EPSILON)
                            return POPT_ERROR_OVERFLOW;
                        *((float *) opt->arg) = aDouble;
                    }
                }   /*@switchbreak@*/ break;
                default:
                    fprintf(stdout,
                        POPT_("option type (%d) not implemented in popt\n"),
                        (opt->argInfo & POPT_ARG_MASK));
                    exit(EXIT_FAILURE);
                    /*@notreached@*/ /*@switchbreak@*/ break;
                }
            }
        }

        if (cb) {
            /*@-internalglobs@*/
            invokeCallbacksOPTION(con, con->options, opt, cbData, shorty);
            /*@=internalglobs@*/
        } else if (opt->val && ((opt->argInfo & POPT_ARG_MASK) != POPT_ARG_VAL))
            done = 1;

        if ((con->finalArgvCount + 2) >= (con->finalArgvAlloced)) {
            con->finalArgvAlloced += 10;
            con->finalArgv = (const char **)realloc(con->finalArgv,
                            sizeof(*con->finalArgv) * con->finalArgvAlloced);
        }

        if (con->finalArgv != NULL)
        {   char *s = (char *)malloc(
                (opt->longName ? strlen(opt->longName) : 0) + 3);
            if (s != NULL) {    /* XXX can't happen */
                if (opt->longName)
                    sprintf(s, "%s%s",
                        ((opt->argInfo & POPT_ARGFLAG_ONEDASH) ? "-" : "--"),
                        opt->longName);
                else
                    sprintf(s, "-%c", opt->shortName);
                con->finalArgv[con->finalArgvCount++] = s;
            } else
                con->finalArgv[con->finalArgvCount++] = NULL;
        }

        if (opt->arg && (opt->argInfo & POPT_ARG_MASK) == POPT_ARG_NONE)
            /*@-ifempty@*/ ; /*@=ifempty@*/
        else if ((opt->argInfo & POPT_ARG_MASK) == POPT_ARG_VAL)
            /*@-ifempty@*/ ; /*@=ifempty@*/
        else if ((opt->argInfo & POPT_ARG_MASK) != POPT_ARG_NONE) {
            if (con->finalArgv != NULL && con->os->nextArg)
                con->finalArgv[con->finalArgvCount++] =
                        /*@-nullpass@*/ /* LCL: con->os->nextArg != NULL */
                        xstrdup(con->os->nextArg);
                        /*@=nullpass@*/
        }
    }

    return (opt ? opt->val : -1);       /* XXX can't happen */
}

const char* poptGetOptArg

(

poptContext

con

)

Return next option argument (if any).

引数:

con

context

戻り値:

option argument, NULL if no argument is available

popt.c の 1005 行で定義されています。

参照先 optionStackEntry::nextArg・poptContext_s::os.

参照元 main()・parse_quota_set().

{
    const char * ret = NULL;
    /*@-branchstate@*/
    if (con) {
        ret = con->os->nextArg;
        con->os->nextArg = NULL;
    }
    /*@=branchstate@*/
    return ret;
}

const char* poptGetArg

(

poptContext

con

)

Return next argument.

引数:

con

context

戻り値:

next argument, NULL if no argument is available

popt.c の 1017 行で定義されています。

参照先 poptContext_s::leftovers・poptContext_s::nextLeftover・poptContext_s::numLeftovers.

参照元 main()・parse_quota_set().

{
    const char * ret = NULL;
    if (con && con->leftovers != NULL && con->nextLeftover < con->numLeftovers)
        ret = con->leftovers[con->nextLeftover++];
    return ret;
}

const char* poptPeekArg

(

poptContext

con

)

Peek at current argument.

引数:

con

context

戻り値:

current argument, NULL if no argument is available

popt.c の 1025 行で定義されています。

参照先 poptContext_s::leftovers・poptContext_s::nextLeftover・poptContext_s::numLeftovers.

参照元 main()・parse_quota_set().

{
    const char * ret = NULL;
    if (con && con->leftovers != NULL && con->nextLeftover < con->numLeftovers)
        ret = con->leftovers[con->nextLeftover];
    return ret;
}

const char** poptGetArgs

(

poptContext

con

)

Return remaining arguments.

引数:

con

context

戻り値:

argument array, NULL terminated

popt.c の 1034 行で定義されています。

参照先 poptContext_s::leftovers・poptContext_s::nextLeftover・poptContext_s::numLeftovers.

参照元 main().

{
    if (con == NULL ||
        con->leftovers == NULL || con->numLeftovers == con->nextLeftover)
        return NULL;

    /* some apps like [like RPM ;-) ] need this NULL terminated */
    con->leftovers[con->numLeftovers] = NULL;

    /*@-nullret -nullstate @*/  /* FIX: typedef double indirection. */
    return (con->leftovers + con->nextLeftover);
    /*@=nullret =nullstate @*/
}

poptContext poptFreeContext

(

poptContext

con

)

Destroy context.

引数:

con

context

戻り値:

NULL always

popt.c の 1049 行で定義されています。

参照先 _free()・poptContext_s::aliases・poptContext_s::appName・poptContext_s::arg_strip・optionStackEntry::argb・poptOption::argDescrip・poptItem_s::argv・poptOption::descrip・poptContext_s::execPath・poptContext_s::execs・poptContext_s::finalArgv・poptContext_s::leftovers・poptOption::longName・poptContext_s::numAliases・poptContext_s::numExecs・poptItem_s::option・poptContext_s::os・poptContext_s::otherHelp・poptResetContext().

参照元 main().

{
    poptItem item;
    int i;

    if (con == NULL) return con;
    poptResetContext(con);
    con->os->argb = (pbm_set *)_free(con->os->argb);

    if (con->aliases != NULL)
    for (i = 0; i < con->numAliases; i++) {
        item = con->aliases + i;
        /*@-modobserver -observertrans -dependenttrans@*/
        item->option.longName = (const char *)_free(item->option.longName);
        item->option.descrip = (const char *)_free(item->option.descrip);
        item->option.argDescrip = (const char *)_free(item->option.argDescrip);
        /*@=modobserver =observertrans =dependenttrans@*/
        item->argv = (const char **)_free(item->argv);
    }
    con->aliases = (poptItem)_free(con->aliases);

    if (con->execs != NULL)
    for (i = 0; i < con->numExecs; i++) {
        item = con->execs + i;
        /*@-modobserver -observertrans -dependenttrans@*/
        item->option.longName = (const char *)_free(item->option.longName);
        item->option.descrip = (const char *)_free(item->option.descrip);
        item->option.argDescrip = (const char *)_free(item->option.argDescrip);
        /*@=modobserver =observertrans =dependenttrans@*/
        item->argv = (const char **)_free(item->argv);
    }
    con->execs = (poptItem)_free(con->execs);

    con->leftovers = (const char **)_free(con->leftovers);
    con->finalArgv = (const char **)_free(con->finalArgv);
    con->appName = (const char *)_free(con->appName);
    con->otherHelp = (const char *)_free(con->otherHelp);
    con->execPath = (const char *)_free(con->execPath);
    con->arg_strip = (pbm_set *)PBM_FREE(con->arg_strip);
    
    con = (poptContext)_free(con);
    return con;
}

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

Add alias to context.

TODO:

Pass alias by reference, not value.

非推奨:

Use poptAddItem instead.

引数:

	con	context
	alias	alias to add
	flags	(unused)

戻り値:

0 on success

popt.c の 1093 行で定義されています。

参照先 alloca()・poptAlias::argc・poptAlias::argv・poptAlias::longName・poptAddItem()・poptAlias::shortName.

{
    poptItem item = (poptItem)alloca(sizeof(*item));
    memset(item, 0, sizeof(*item));
    item->option.longName = alias.longName;
    item->option.shortName = alias.shortName;
    item->option.argInfo = POPT_ARGFLAG_DOC_HIDDEN;
    item->option.arg = 0;
    item->option.val = 0;
    item->option.descrip = NULL;
    item->option.argDescrip = NULL;
    item->argc = alias.argc;
    item->argv = alias.argv;
    return poptAddItem(con, item, 0);
}

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

戻り値:

0 on success

popt.c の 1112 行で定義されています。

参照先 poptContext_s::aliases・poptOption::arg・poptItem_s::argc・poptOption::argDescrip・poptOption::argInfo・poptItem_s::argv・poptOption::descrip・poptContext_s::execs・poptOption::longName・poptContext_s::numAliases・poptContext_s::numExecs・poptItem_s::option・poptOption::shortName・poptOption::val・xstrdup().

参照元 poptAddAlias().

{
    poptItem * items, item;
    int * nitems;

    switch (flags) {
    case 1:
        items = &con->execs;
        nitems = &con->numExecs;
        break;
    case 0:
        items = &con->aliases;
        nitems = &con->numAliases;
        break;
    default:
        return 1;
        /*@notreached@*/ break;
    }

    *items = (poptItem)realloc((*items), ((*nitems) + 1) * sizeof(**items));
    if ((*items) == NULL)
        return 1;

    item = (*items) + (*nitems);

    item->option.longName =
        (newItem->option.longName ? xstrdup(newItem->option.longName) : NULL);
    item->option.shortName = newItem->option.shortName;
    item->option.argInfo = newItem->option.argInfo;
    item->option.arg = newItem->option.arg;
    item->option.val = newItem->option.val;
    item->option.descrip =
        (newItem->option.descrip ? xstrdup(newItem->option.descrip) : NULL);
    item->option.argDescrip =
       (newItem->option.argDescrip ? xstrdup(newItem->option.argDescrip) : NULL);
    item->argc = newItem->argc;
    item->argv = newItem->argv;

    (*nitems)++;

    return 0;
}

const char* poptBadOption	(	poptContext	con,
		int	flags
	)

Return the option which caused the most recent error.

引数:

	con	context
	flags

戻り値:

offending option

popt.c の 1157 行で定義されています。

参照先 optionStackEntry::argv・optionStackEntry::next・poptContext_s::optionStack・poptContext_s::os.

参照元 main()・rpc_reg_shutdown_internals().

{
    struct optionStackEntry * os = NULL;

    if (con != NULL)
        os = (flags & POPT_BADOPTION_NOALIAS) ? con->optionStack : con->os;

    /*@-nullderef@*/    /* LCL: os->argv != NULL */
    return (os && os->argv ? os->argv[os->next - 1] : NULL);
    /*@=nullderef@*/
}

const char* poptStrerror

(

const int

error

)

Return formatted error string for popt failure.

引数:

error

popt error

戻り値:

error string

popt.c の 1169 行で定義されています。

参照先 errno・strerror().

参照元 main()・net_rpc_shell()・process_cmd()・rpc_reg_shutdown_internals().

{
    switch (error) {
      case POPT_ERROR_NOARG:
        return POPT_("missing argument");
      case POPT_ERROR_BADOPT:
        return POPT_("unknown option");
      case POPT_ERROR_BADOPERATION:
        return POPT_("mutually exclusive logical operations requested");
      case POPT_ERROR_NULLARG:
        return POPT_("opt->arg should not be NULL");
      case POPT_ERROR_OPTSTOODEEP:
        return POPT_("aliases nested too deeply");
      case POPT_ERROR_BADQUOTE:
        return POPT_("error in parameter quoting");
      case POPT_ERROR_BADNUMBER:
        return POPT_("invalid numeric value");
      case POPT_ERROR_OVERFLOW:
        return POPT_("number too large or too small");
      case POPT_ERROR_MALLOC:
        return POPT_("memory allocation failed");
      case POPT_ERROR_ERRNO:
        return strerror(errno);
      default:
        return POPT_("unknown error");
    }
}

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

Add arguments to context.

引数:

	con	context
	argv	argument array, NULL terminated

戻り値:

0 on success, POPT_ERROR_OPTSTOODEEP on failure

popt.c の 1197 行で定義されています。

参照先 optionStackEntry::argb・optionStackEntry::argc・optionStackEntry::argv・optionStackEntry::currAlias・optionStackEntry::next・optionStackEntry::nextArg・optionStackEntry::nextCharArg・poptContext_s::optionStack・poptContext_s::os・poptDupArgv()・optionStackEntry::stuffed.

{
    int argc;
    int rc;

    if ((con->os - con->optionStack) == POPT_OPTION_DEPTH)
        return POPT_ERROR_OPTSTOODEEP;

    for (argc = 0; argv[argc]; argc++)
        {};

    con->os++;
    con->os->next = 0;
    con->os->nextArg = NULL;
    con->os->nextCharArg = NULL;
    con->os->currAlias = NULL;
    rc = poptDupArgv(argc, argv, &con->os->argc, &con->os->argv);
    con->os->argb = NULL;
    con->os->stuffed = 1;

    return rc;
}

const char* poptGetInvocationName

(

poptContext

con

)

Return argv[0] from context.

引数:

con

context

戻り値:

argv[0]

popt.c の 1220 行で定義されています。

参照先 optionStackEntry::argv・poptContext_s::os.

参照元 set_logfile().

{
    return (con->os->argv ? con->os->argv[0] : "");
}

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

戻り値:

new argc

popt.c の 1226 行で定義されています。

参照先 poptContext_s::arg_strip.

{
    int numargs = argc;
    int j = 1;
    int i;
    
    /*@-sizeoftype@*/
    if (con->arg_strip)
    for (i = 1; i < argc; i++) {
        if (PBM_ISSET(i, con->arg_strip))
            numargs--;
    }
    
    for (i = 1; i < argc; i++) {
        if (con->arg_strip && PBM_ISSET(i, con->arg_strip))
            continue;
        argv[j] = (j < numargs) ? argv[i] : NULL;
        j++;
    }
    /*@=sizeoftype@*/
    
    return numargs;
}

---

変数

int _popt_debug = 0

popt.c の 23 行で定義されています。

参照元 execCommand().

---