Skip to content
Snippets Groups Projects
cli.c 77.1 KiB
Newer Older
  • Learn to ignore specific revisions
  • 			if (!user_group) {
    				continue;
    			}
    			user_group->uid = (pw ? pw->pw_uid : -1);
    			user_group->gid = (gr ? gr->gr_gid : -1);
    			user_group->perms = ast_calloc(1, sizeof(*user_group->perms));
    			if (!user_group->perms) {
    				ast_free(user_group);
    				continue;
    			}
    		}
    		for (v = ast_variable_browse(cfg, cat); v; v = v->next) {
    			if (ast_strlen_zero(v->value)) {
    				/* we need to check this condition cause it could break security. */
    				ast_log(LOG_WARNING, "Empty permit/deny option in user '%s'\n", cat);
    				continue;
    			}
    			if (!strcasecmp(v->name, "permit")) {
    				perm = ast_calloc(1, sizeof(*perm));
    				if (perm) {
    					perm->permit = 1;
    					perm->command = ast_strdup(v->value);
    				}
    			} else if (!strcasecmp(v->name, "deny")) {
    				perm = ast_calloc(1, sizeof(*perm));
    				if (perm) {
    					perm->permit = 0;
    					perm->command = ast_strdup(v->value);
    				}
    			} else {
    				/* up to now, only 'permit' and 'deny' are possible values. */
    				ast_log(LOG_WARNING, "Unknown '%s' option\n", v->name);
    				continue;
    			}
    			if (perm) {
    				/* Added the permission to the user's list. */
    				AST_LIST_INSERT_TAIL(user_group->perms, perm, list);
    				perm = NULL;
    			}
    		}
    		AST_RWLIST_WRLOCK(&cli_perms);
    		AST_RWLIST_INSERT_TAIL(&cli_perms, user_group, list);
    		AST_RWLIST_UNLOCK(&cli_perms);
    	}
    
    	ast_config_destroy(cfg);
    	ast_mutex_unlock(&permsconfiglock);
    	return 0;
    }
    
    
    static void cli_shutdown(void)
    {
    	ast_cli_unregister_multiple(cli_cli, ARRAY_LEN(cli_cli));
    }
    
    
    /*! \brief initialize the _full_cmd string in * each of the builtins. */
    void ast_builtins_init(void)
    {
    
    	AST_VECTOR_INIT(&shutdown_commands, 0);
    
    	ast_cli_register_multiple(cli_cli, ARRAY_LEN(cli_cli));
    
    	ast_register_cleanup(cli_shutdown);
    
    /*!
     * match a word in the CLI entry.
     * returns -1 on mismatch, 0 on match of an optional word,
     * 1 on match of a full word.
    
     *   any_word           match for equal
     *   [foo|bar|baz]      optionally, one of these words
     *   {foo|bar|baz}      exactly, one of these words
     *   %                  any word
    
     */
    static int word_match(const char *cmd, const char *cli_word)
    {
    	int l;
    	char *pos;
    
    	if (ast_strlen_zero(cmd) || ast_strlen_zero(cli_word))
    		return -1;
    	if (!strchr(cli_rsvd, cli_word[0])) /* normal match */
    		return (strcasecmp(cmd, cli_word) == 0) ? 1 : -1;
    	l = strlen(cmd);
    
    	/* wildcard match - will extend in the future */
    	if (l > 0 && cli_word[0] == '%') {
    		return 1;	/* wildcard */
    	}
    
    
    	/* Start a search for the command entered against the cli word in question */
    
    	pos = strcasestr(cli_word, cmd);
    
    	while (pos) {
    
    		/*
    		 *Check if the word matched with is surrounded by reserved characters on both sides
    		 * and isn't at the beginning of the cli_word since that would make it check in a location we shouldn't know about.
    		 * If it is surrounded by reserved chars and isn't at the beginning, it's a match.
    		 */
    		if (pos != cli_word && strchr(cli_rsvd, pos[-1]) && strchr(cli_rsvd, pos[l])) {
    			return 1;	/* valid match */
    		}
    
    		/* Ok, that one didn't match, strcasestr to the next appearance of the command and start over.*/
    		pos = strcasestr(pos + 1, cmd);
    	}
    	/* If no matches were found over the course of the while loop, we hit the end of the string. It's a mismatch. */
    	return -1;
    
    }
    
    /*! \brief if word is a valid prefix for token, returns the pos-th
     * match as a malloced string, or NULL otherwise.
     * Always tell in *actual how many matches we got.
     */
    static char *is_prefix(const char *word, const char *token,
    	int pos, int *actual)
    {
    	int lw;
    	char *s, *t1;
    
    	*actual = 0;
    	if (ast_strlen_zero(token))
    		return NULL;
    	if (ast_strlen_zero(word))
    		word = "";	/* dummy */
    	lw = strlen(word);
    	if (strcspn(word, cli_rsvd) != lw)
    		return NULL;	/* no match if word has reserved chars */
    	if (strchr(cli_rsvd, token[0]) == NULL) {	/* regular match */
    		if (strncasecmp(token, word, lw))	/* no match */
    			return NULL;
    		*actual = 1;
    
    		return (pos != 0) ? NULL : ast_strdup(token);
    
    	}
    	/* now handle regexp match */
    
    
    	/* Wildcard always matches, so we never do is_prefix on them */
    
    
    	t1 = ast_strdupa(token + 1);	/* copy, skipping first char */
    	while (pos >= 0 && (s = strsep(&t1, cli_rsvd)) && *s) {
    
    		if (*s == '%')	/* wildcard */
    			continue;
    
    		if (strncasecmp(s, word, lw))	/* no match */
    			continue;
    		(*actual)++;
    		if (pos-- == 0)
    
    			return ast_strdup(s);
    
     * \internal
    
     * \brief locate a cli command in the 'helpers' list (which must be locked).
    
     *     The search compares word by word taking care of regexps in e->cmda
     *     This function will return NULL when nothing is matched, or the ast_cli_entry that matched.
     * \param cmds
     * \param match_type has 3 possible values:
    
     *      0       returns if the search key is equal or longer than the entry.
    
     *			    note that trailing optional arguments are skipped.
    
     *      -1      true if the mismatch is on the last word XXX not true!
     *      1       true only on complete, exact match.
    
    static struct ast_cli_entry *find_cli(const char * const cmds[], int match_type)
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    
    	int matchlen = -1;	/* length of longest match so far */
    	struct ast_cli_entry *cand = NULL, *e=NULL;
    
    
    		/* word-by word regexp comparison */
    
    		const char * const *src = cmds;
    		const char * const *dst = e->cmda;
    
    		int n = 0;
    		for (;; dst++, src += n) {
    			n = word_match(*src, *dst);
    			if (n < 0)
    
    		if (ast_strlen_zero(*dst) || ((*dst)[0] == '[' && ast_strlen_zero(dst[1]))) {
    			/* no more words in 'e' */
    			if (ast_strlen_zero(*src))	/* exact match, cannot do better */
    
    			/* Here, cmds has more words than the entry 'e' */
    
    			if (match_type != 0)	/* but we look for almost exact match... */
    				continue;	/* so we skip this one. */
    			/* otherwise we like it (case 0) */
    
    		} else {	/* still words in 'e' */
    			if (ast_strlen_zero(*src))
    				continue; /* cmds is shorter than 'e', not good */
    			/* Here we have leftover words in cmds and 'e',
    			 * but there is a mismatch. We only accept this one if match_type == -1
    			 * and this is the last word for both.
    			 */
    			if (match_type != -1 || !ast_strlen_zero(src[1]) ||
    			    !ast_strlen_zero(dst[1]))	/* not the one we look for */
    
    			/* good, we are in case match_type == -1 and mismatch on last word */
    
    		if (src - cmds > matchlen) {	/* remember the candidate */
    			matchlen = src - cmds;
    
    Mark Spencer's avatar
    Mark Spencer committed
    	}
    
    static char *find_best(const char *argv[])
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    	static char cmdline[80];
    	int x;
    
    	/* See how close we get, then print the candidate */
    
    	const char *myargv[AST_MAX_CMD_LEN] = { NULL, };
    
    
    	AST_RWLIST_RDLOCK(&helpers);
    
    	for (x = 0; argv[x]; x++) {
    
    Mark Spencer's avatar
    Mark Spencer committed
    		myargv[x] = argv[x];
    		if (!find_cli(myargv, -1))
    			break;
    	}
    
    	AST_RWLIST_UNLOCK(&helpers);
    
    	ast_join(cmdline, sizeof(cmdline), myargv);
    
    Mark Spencer's avatar
    Mark Spencer committed
    	return cmdline;
    }
    
    
    static int cli_is_registered(struct ast_cli_entry *e)
    {
    	struct ast_cli_entry *cur = NULL;
    
    	while ((cur = cli_next(cur))) {
    		if (cur == e) {
    			return 1;
    		}
    	}
    	return 0;
    }
    
    
    static void remove_shutdown_command(struct ast_cli_entry *e)
    {
    	ast_rwlock_wrlock(&shutdown_commands_lock);
    	AST_VECTOR_REMOVE_ELEM_UNORDERED(&shutdown_commands, e, AST_VECTOR_ELEM_CLEANUP_NOOP);
    	ast_rwlock_unlock(&shutdown_commands_lock);
    }
    
    
    int ast_cli_unregister(struct ast_cli_entry *e)
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    
    	if (e->inuse) {
    		ast_log(LOG_WARNING, "Can't remove command that is in use\n");
    	} else {
    
    		AST_RWLIST_WRLOCK(&helpers);
    		AST_RWLIST_REMOVE(&helpers, e, list);
    		AST_RWLIST_UNLOCK(&helpers);
    
    		remove_shutdown_command(e);
    
    		e->_full_cmd = NULL;
    
    			/* this is a new-style entry. Reset fields and free memory. */
    
    			char *cmda = (char *) e->cmda;
    			memset(cmda, '\0', sizeof(e->cmda));
    
    			e->command = NULL;
    			e->usage = NULL;
    		}
    
    int __ast_cli_register(struct ast_cli_entry *e, struct ast_module *module)
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    
    	struct ast_cli_args a;	/* fake argument */
    	char **dst = (char **)e->cmda;	/* need to cast as the entry is readonly */
    	char *s;
    
    
    	AST_RWLIST_WRLOCK(&helpers);
    
    	if (cli_is_registered(e)) {
    		ast_log(LOG_WARNING, "Command '%s' already registered (the same ast_cli_entry)\n",
    			S_OR(e->_full_cmd, e->command));
    		ret = 0;  /* report success */
    		goto done;
    	}
    
    
    Steve Murphy's avatar
    Steve Murphy committed
    	memset(&a, '\0', sizeof(a));
    
    
    	e->module = module;
    	/* No module reference needed here, the module called us. */
    
    	e->handler(e, CLI_INIT, &a);
    
    	/* XXX check that usage and command are filled up */
    	s = ast_skip_blanks(e->command);
    	s = e->command = ast_strdup(s);
    	for (i=0; !ast_strlen_zero(s) && i < AST_MAX_CMD_LEN-1; i++) {
    		*dst++ = s;	/* store string */
    		s = ast_skip_nonblanks(s);
    		if (*s == '\0')	/* we are done */
    			break;
    		*s++ = '\0';
    		s = ast_skip_blanks(s);
    
    	if (find_cli(e->cmda, 1)) {
    
    		ast_log(LOG_WARNING, "Command '%s' already registered (or something close enough)\n",
    			S_OR(e->_full_cmd, e->command));
    
    Mark Spencer's avatar
    Mark Spencer committed
    	}
    
    	if (set_full_cmd(e)) {
    		ast_log(LOG_WARNING, "Error registering CLI Command '%s'\n",
    			S_OR(e->_full_cmd, e->command));
    
    	AST_RWLIST_TRAVERSE_SAFE_BEGIN(&helpers, cur, list) {
    
    		if (strncasecmp(e->_full_cmd, cur->_full_cmd, len) < 0) {
    
    			AST_RWLIST_INSERT_BEFORE_CURRENT(e, list);
    
    	AST_RWLIST_TRAVERSE_SAFE_END;
    
    		AST_RWLIST_INSERT_TAIL(&helpers, e, list);
    
    	ret = 0;	/* success */
    
    	AST_RWLIST_UNLOCK(&helpers);
    
    	if (ret) {
    		ast_free(e->command);
    		e->command = NULL;
    	}
    
    /*
     * register/unregister an array of entries.
     */
    
    int __ast_cli_register_multiple(struct ast_cli_entry *e, int len, struct ast_module *module)
    
    	for (i = 0; i < len; i++) {
    		res |= __ast_cli_register(e + i, module);
    	}
    
    int ast_cli_unregister_multiple(struct ast_cli_entry *e, int len)
    
    /*! \brief helper for final part of handle_help
     *  if locked = 1, assume the list is already locked
    
    static char *help1(int fd, const char * const match[], int locked)
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    
    	char matchstr[80] = "";
    
    	int len = 0;
    	int found = 0;
    
    	if (match) {
    		ast_join(matchstr, sizeof(matchstr), match);
    		len = strlen(matchstr);
    	}
    	if (!locked)
    
    		AST_RWLIST_RDLOCK(&helpers);
    
    Mark Spencer's avatar
    Mark Spencer committed
    		/* Hide commands that start with '_' */
    
    		if (e->_full_cmd[0] == '_')
    
    Mark Spencer's avatar
    Mark Spencer committed
    			continue;
    
    		if (match && strncasecmp(matchstr, e->_full_cmd, len))
    			continue;
    
    		ast_cli(fd, "%-30s -- %s\n", e->_full_cmd,
    			S_OR(e->summary, "<no description available>"));
    
    Mark Spencer's avatar
    Mark Spencer committed
    	}
    
    	if (!locked)
    
    		AST_RWLIST_UNLOCK(&helpers);
    
    	if (!found && matchstr[0])
    
    		ast_cli(fd, "No such command '%s'.\n", matchstr);
    
    	return CLI_SUCCESS;
    
    static char *handle_help(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
    
    Mark Spencer's avatar
    Mark Spencer committed
    	char fullcmd[80];
    
    	struct ast_cli_entry *my_e;
    
    	char *res = CLI_SUCCESS;
    
    	if (cmd == CLI_INIT) {
    
    		e->command = "core show help";
    
    		e->usage =
    
    			"Usage: core show help [topic]\n"
    
    			"       When called with a topic as an argument, displays usage\n"
    			"       information on the given command. If called without a\n"
    			"       topic, it provides a list of commands.\n";
    		return NULL;
    
    	} else if (cmd == CLI_GENERATE) {
    
    		/* skip first 14 or 15 chars, "core show help " */
    
    		int l = strlen(a->line);
    
    
    		if (l > 15) {
    			l = 15;
    		}
    
    		/* XXX watch out, should stop to the non-generator parts */
    		return __ast_cli_generator(a->line + l, a->word, a->n, 0);
    	}
    
    	if (a->argc == e->args) {
    
    		return help1(a->fd, NULL, 0);
    
    	AST_RWLIST_RDLOCK(&helpers);
    
    	my_e = find_cli(a->argv + 3, 1);	/* try exact match first */
    
    		res = help1(a->fd, a->argv + 3, 1 /* locked */);
    
    		AST_RWLIST_UNLOCK(&helpers);
    		return res;
    	}
    
    	if (my_e->usage)
    		ast_cli(a->fd, "%s", my_e->usage);
    
    		ast_join(fullcmd, sizeof(fullcmd), a->argv + 3);
    
    		ast_cli(a->fd, "No help text available for '%s'.\n", fullcmd);
    
    Mark Spencer's avatar
    Mark Spencer committed
    	}
    
    	AST_RWLIST_UNLOCK(&helpers);
    
    static char *parse_args(const char *s, int *argc, const char *argv[], int max, int *trailingwhitespace)
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    
    	int x = 0;
    	int quoted = 0;
    	int escaped = 0;
    	int whitespace = 1;
    
    	int dummy = 0;
    
    	if (trailingwhitespace == NULL)
    		trailingwhitespace = &dummy;
    
    	*trailingwhitespace = 0;
    
    	if (s == NULL)	/* invalid, though! */
    		return NULL;
    	/* make a copy to store the parsed string */
    
    	if (!(duplicate = ast_strdup(s)))
    
    
    	/* Remove leading spaces from the command */
    	while (isspace(*s)) {
    		cur++;
    		s++;
    	}
    
    
    	/* scan the original string copying into cur when needed */
    	for (; *s ; s++) {
    		if (x >= max - 1) {
    			ast_log(LOG_WARNING, "Too many arguments, truncating at %s\n", s);
    			break;
    		}
    		if (*s == '"' && !escaped) {
    
    			quoted = !quoted;
    
    			if (quoted && whitespace) {
    				/* start a quoted string from previous whitespace: new argument */
    
    				argv[x++] = cur;
    				whitespace = 0;
    			}
    
    		} else if ((*s == ' ' || *s == '\t') && !(quoted || escaped)) {
    
    			/* If we are not already in whitespace, and not in a quoted string or
    			   processing an escape sequence, and just entered whitespace, then
    			   finalize the previous argument and remember that we are in whitespace
    			*/
    			if (!whitespace) {
    
    		} else if (*s == '\\' && !escaped) {
    
    			escaped = 1;
    		} else {
    			if (whitespace) {
    
    				/* we leave whitespace, and are not quoted. So it's a new argument */
    
    				argv[x++] = cur;
    				whitespace = 0;
    
    Mark Spencer's avatar
    Mark Spencer committed
    			}
    
    	/* Null terminate */
    
    	*cur++ = '\0';
    	/* XXX put a NULL in the last argument, because some functions that take
    	 * the array may want a null-terminated array.
    	 * argc still reflects the number of non-NULL entries.
    	 */
    
    	argv[x] = NULL;
    	*argc = x;
    
    	*trailingwhitespace = whitespace;
    
    /*! \brief Return the number of unique matches for the generator */
    
    int ast_cli_generatornummatches(const char *text, const char *word)
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    	int matches = 0, i = 0;
    
    	char *buf = NULL, *oldbuf = NULL;
    
    	while ((buf = ast_cli_generator(text, word, i++))) {
    
    		if (!oldbuf || strcmp(buf,oldbuf))
    			matches++;
    		if (oldbuf)
    
    Mark Spencer's avatar
    Mark Spencer committed
    		oldbuf = buf;
    	}
    
    	if (oldbuf)
    
    Mark Spencer's avatar
    Mark Spencer committed
    	return matches;
    }
    
    
    static void destroy_match_list(char **match_list, int matches)
    {
    	if (match_list) {
    		int idx;
    
    		for (idx = 1; idx < matches; ++idx) {
    			ast_free(match_list[idx]);
    		}
    		ast_free(match_list);
    	}
    }
    
    
    char **ast_cli_completion_matches(const char *text, const char *word)
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    	char **match_list = NULL, *retstr, *prevstr;
    
    	char **new_list;
    
    Mark Spencer's avatar
    Mark Spencer committed
    	size_t match_list_len, max_equal, which, i;
    	int matches = 0;
    
    
    	/* leave entry 0 free for the longest common substring */
    
    Mark Spencer's avatar
    Mark Spencer committed
    	match_list_len = 1;
    	while ((retstr = ast_cli_generator(text, word, matches)) != NULL) {
    		if (matches + 1 >= match_list_len) {
    			match_list_len <<= 1;
    
    			new_list = ast_realloc(match_list, match_list_len * sizeof(*match_list));
    			if (!new_list) {
    				destroy_match_list(match_list, matches);
    
    			}
    			match_list = new_list;
    
    Mark Spencer's avatar
    Mark Spencer committed
    		}
    		match_list[++matches] = retstr;
    	}
    
    
    	if (!match_list) {
    
    		return match_list; /* NULL */
    
    	/* Find the longest substring that is common to all results
    	 * (it is a candidate for completion), and store a copy in entry 0.
    	 */
    
    Mark Spencer's avatar
    Mark Spencer committed
    	prevstr = match_list[1];
    	max_equal = strlen(prevstr);
    
    	for (which = 2; which <= matches; which++) {
    
    		for (i = 0; i < max_equal && toupper(prevstr[i]) == toupper(match_list[which][i]); i++)
    
    Mark Spencer's avatar
    Mark Spencer committed
    			continue;
    		max_equal = i;
    	}
    
    
    	retstr = ast_malloc(max_equal + 1);
    	if (!retstr) {
    		destroy_match_list(match_list, matches);
    
    	ast_copy_string(retstr, match_list[1], max_equal + 1);
    
    Mark Spencer's avatar
    Mark Spencer committed
    	match_list[0] = retstr;
    
    
    	/* ensure that the array is NULL terminated */
    
    		new_list = ast_realloc(match_list, (match_list_len + 1) * sizeof(*match_list));
    		if (!new_list) {
    
    Matthew Jordan's avatar
    Matthew Jordan committed
    			ast_free(retstr);
    
    			destroy_match_list(match_list, matches);
    
    		match_list = new_list;
    
    /*! \brief returns true if there are more words to match */
    
    static int more_words (const char * const *dst)
    
    {
    	int i;
    	for (i = 0; dst[i]; i++) {
    		if (dst[i][0] != '[')
    			return -1;
    	}
    	return 0;
    }
    
    /*
     * generate the entry at position 'state'
     */
    
    static char *__ast_cli_generator(const char *text, const char *word, int state, int lock)
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    
    	const char *argv[AST_MAX_ARGS];
    
    	int x = 0, argindex, matchlen;
    
    Mark Spencer's avatar
    Mark Spencer committed
    	int matchnum=0;
    
    	char matchstr[80] = "";
    
    	/* Split the argument into an array of words */
    
    	char *duplicate = parse_args(text, &x, argv, ARRAY_LEN(argv), &tws);
    
    	if (!duplicate)	/* malloc error */
    
    
    	/* Compute the index of the last argument (could be an empty string) */
    
    	argindex = (!ast_strlen_zero(word) && x>0) ? x-1 : x;
    
    
    	/* rebuild the command, ignore terminating white space and flatten space */
    
    	ast_join(matchstr, sizeof(matchstr)-1, argv);
    	matchlen = strlen(matchstr);
    
    	if (tws) {
    		strcat(matchstr, " "); /* XXX */
    		if (matchlen)
    			matchlen++;
    	}
    
    		AST_RWLIST_RDLOCK(&helpers);
    
    		/* XXX repeated code */
    		int src = 0, dst = 0, n = 0;
    
    		/*
    		 * Try to match words, up to and excluding the last word, which
    		 * is either a blank or something that we want to extend.
    		 */
    		for (;src < argindex; dst++, src += n) {
    
    			n = word_match(argv[src], e->cmda[dst]);
    			if (n < 0)
    
    		if (src != argindex && more_words(e->cmda + dst))	/* not a match */
    
    			continue;
    		ret = is_prefix(argv[src], e->cmda[dst], state - matchnum, &n);
    		matchnum += n;	/* this many matches here */
    		if (ret) {
    
    			/*
    			 * argv[src] is a valid prefix of the next word in this
    			 * command. If this is also the correct entry, return it.
    			 */
    
    			ret = NULL;
    		} else if (ast_strlen_zero(e->cmda[dst])) {
    
    			/*
    			 * This entry is a prefix of the command string entered
    
    			 * (only one entry in the list should have this property).
    			 * Run the generator if one is available. In any case we are done.
    			 */
    
    			if (e->handler) {	/* new style command */
    
    				struct ast_cli_args a = {
    					.line = matchstr, .word = word,
    					.pos = argindex,
    
    					.n = state - matchnum,
    					.argv = argv,
    					.argc = x};
    
    				ast_module_ref(e->module);
    
    				ret = e->handler(e, CLI_GENERATE, &a);
    
    				ast_module_unref(e->module);
    
    		AST_RWLIST_UNLOCK(&helpers);
    
    char *ast_cli_generator(const char *text, const char *word, int state)
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    	return __ast_cli_generator(text, word, state, 1);
    }
    
    
    static int allowed_on_shutdown(struct ast_cli_entry *e)
    {
    	int found = 0;
    	int i;
    
    	ast_rwlock_rdlock(&shutdown_commands_lock);
    	for (i = 0; i < AST_VECTOR_SIZE(&shutdown_commands); ++i) {
    		if (e == AST_VECTOR_GET(&shutdown_commands, i)) {
    			found = 1;
    			break;
    		}
    	}
    	ast_rwlock_unlock(&shutdown_commands_lock);
    
    	return found;
    }
    
    
    int ast_cli_command_full(int uid, int gid, int fd, const char *s)
    
    Mark Spencer's avatar
    Mark Spencer committed
    {
    
    	const char *args[AST_MAX_ARGS + 1];
    
    	struct ast_cli_entry *e = NULL;
    
    Mark Spencer's avatar
    Mark Spencer committed
    	int x;
    
    	char *duplicate = parse_args(s, &x, args + 1, AST_MAX_ARGS, NULL);
    
    	char tmp[AST_MAX_ARGS + 1];
    
    	char *retval = CLI_FAILURE;
    
    	struct ast_cli_args a = {
    		.fd = fd, .argc = x, .argv = args+1 };
    
    		return RESULT_FAILURE;
    
    	if (x < 1)	/* We need at least one entry, otherwise ignore */
    		goto done;
    
    
    	AST_RWLIST_RDLOCK(&helpers);
    
    	e = find_cli(args + 1, 0);
    	if (e)
    		ast_atomic_fetchadd_int(&e->inuse, 1);
    
    	AST_RWLIST_UNLOCK(&helpers);
    
    	if (e == NULL) {
    
    		ast_cli(fd, "No such command '%s' (type 'core show help %s' for other possible commands)\n", s, find_best(args + 1));
    
    	if (ast_shutting_down() && !allowed_on_shutdown(e)) {
    		ast_cli(fd, "Command '%s' cannot be run during shutdown\n", s);
    		goto done;
    	}
    
    
    	ast_join(tmp, sizeof(tmp), args + 1);
    	/* Check if the user has rights to run this command. */
    	if (!cli_has_permissions(uid, gid, tmp)) {
    		ast_cli(fd, "You don't have permissions to run '%s' command\n", tmp);
    
    		goto done;
    
    	/*
    	 * Within the handler, argv[-1] contains a pointer to the ast_cli_entry.
    	 * Remember that the array returned by parse_args is NULL-terminated.
    	 */
    	args[0] = (char *)e;
    
    
    	ast_module_ref(e->module);
    
    	retval = e->handler(e, CLI_HANDLER, &a);
    
    	ast_module_unref(e->module);
    
    		ast_cli(fd, "%s", S_OR(e->usage, "Invalid usage, but no usage information available.\n"));
    
    	} else if (retval == CLI_FAILURE) {
    		ast_cli(fd, "Command '%s' failed.\n", s);
    
    Mark Spencer's avatar
    Mark Spencer committed
    	}
    
    	if (e) {
    		ast_atomic_fetchadd_int(&e->inuse, -1);
    	}
    
    	return retval == CLI_SUCCESS ? RESULT_SUCCESS : RESULT_FAILURE;
    
    Mark Spencer's avatar
    Mark Spencer committed
    }
    
    int ast_cli_command_multiple_full(int uid, int gid, int fd, size_t size, const char *s)
    
    {
    	char cmd[512];
    	int x, y = 0, count = 0;
    
    	for (x = 0; x < size; x++) {
    		cmd[y] = s[x];
    		y++;
    		if (s[x] == '\0') {
    
    			ast_cli_command_full(uid, gid, fd, cmd);
    
    
    void ast_cli_print_timestr_fromseconds(int fd, int seconds, const char *prefix)
    {
    	print_uptimestr(fd, ast_tv(seconds, 0), prefix, 0);
    }
    
    
    int ast_cli_allow_at_shutdown(struct ast_cli_entry *e)
    {
    	int res;
    
    	ast_rwlock_wrlock(&shutdown_commands_lock);
    	res = AST_VECTOR_APPEND(&shutdown_commands, e);
    	ast_rwlock_unlock(&shutdown_commands_lock);
    
    	return res;
    }