cli.c File Reference

#include <unistd.h>
#include <stdlib.h>
#include <asterisk/logger.h>
#include <asterisk/options.h>
#include <asterisk/cli.h>
#include <asterisk/module.h>
#include <asterisk/channel.h>
#include <asterisk/channel_pvt.h>
#include <asterisk/utils.h>
#include <sys/signal.h>
#include <stdio.h>
#include <signal.h>
#include <string.h>
#include <pthread.h>
#include "editline/readline/readline.h"
#include "asterisk.h"
#include "build.h"
#include "astconf.h"

Include dependency graph for cli.c:

Go to the source code of this file.

Defines
#define	VERSION_INFO
#define	MODLIST_FORMAT   "%-25s %-40.40s %-10d\n"
#define	MODLIST_FORMAT2   "%-25s %-40.40s %-10s\n"
#define	SECOND   (1)
#define	MIN   (SECOND*60)
#define	HOUR   (MIN*60)
#define	DAY   (HOUR*24)
#define	WEEK   (DAY*7)
#define	YEAR   (DAY*365)
#define	FORMAT_STRING   "%15s (%-10s %-12s %-4d) %7s %-12s %-15s\n"
#define	FORMAT_STRING2   "%15s (%-10s %-12s %-4s) %7s %-12s %-15s\n"
Functions
void	ast_cli (int fd, char *fmt,...)
	AST_MUTEX_DEFINE_STATIC (clilock)
	AST_MUTEX_DEFINE_STATIC (climodentrylock)
int	ast_cli_unregister (struct ast_cli_entry *e)
	Unregisters a command.
int	ast_cli_register (struct ast_cli_entry *e)
	Registers a command.
int	ast_cli_generatornummatches (char *text, char *word)
char **	ast_cli_completion_matches (char *text, char *word)
char *	ast_cli_generator (char *text, char *word, int state)
	Readline madness.
int	ast_cli_command (int fd, char *s)
	Interprets a command.
Variables
ast_cli_entry *	helpers = NULL

---

Define Documentation

#define DAY   (HOUR*24)

#define FORMAT_STRING   "%15s (%-10s %-12s %-4d) %7s %-12s %-15s\n"

#define FORMAT_STRING2   "%15s (%-10s %-12s %-4s) %7s %-12s %-15s\n"

#define HOUR   (MIN*60)

#define MIN   (SECOND*60)

#define MODLIST_FORMAT   "%-25s %-40.40s %-10d\n"

Definition at line 156 of file cli.c.

#define MODLIST_FORMAT2   "%-25s %-40.40s %-10s\n"

Definition at line 157 of file cli.c.

#define SECOND   (1)

#define VERSION_INFO

Value: "Asterisk " ASTERISK_VERSION " built by " BUILD_USER "@" BUILD_HOSTNAME \ " on a " BUILD_MACHINE " running " BUILD_OS Definition at line 35 of file cli.c.

#define WEEK   (DAY*7)

#define YEAR   (DAY*365)

---

Function Documentation

void ast_cli (  int  fd, char *  fmt,   ... )

Definition at line 38 of file cli.c. References free, and vasprintf. { char *stuff; va_list ap; va_start(ap, fmt); vasprintf(&stuff, fmt, ap); va_end(ap); write(fd, stuff, strlen(stuff)); free(stuff); }

int ast_cli_command (  int  fd, char *  s )

Interprets a command. Interpret a command s, sending output to fd Returns 0 on succes, -1 on failure Definition at line 1019 of file cli.c. References ast_cli(), ast_log(), AST_MAX_ARGS, ast_mutex_lock, ast_mutex_unlock, free, LOG_WARNING, RESULT_SHOWUSAGE, and s. { char *argv[AST_MAX_ARGS]; struct ast_cli_entry *e; int x; char *dup; x = AST_MAX_ARGS; if ((dup = parse_args(s, &x, argv))) { /* We need at least one entry, or ignore */ if (x > 0) { ast_mutex_lock(&clilock); e = find_cli(argv, 0); if (e) e->inuse++; ast_mutex_unlock(&clilock); if (e) { switch(e->handler(fd, x, argv)) { case RESULT_SHOWUSAGE: ast_cli(fd, e->usage); break; } } else ast_cli(fd, "No such command '%s' (type 'help' for help)\n", find_best(argv)); if (e) { ast_mutex_lock(&clilock); e->inuse--; ast_mutex_unlock(&clilock); } } free(dup); } else { ast_log(LOG_WARNING, "Out of memory\n"); return -1; } return 0; }

char** ast_cli_completion_matches (  char *  text, char *  word )

Definition at line 903 of file cli.c. References ast_cli_generator(), malloc, and realloc. { char **match_list = NULL, *retstr, *prevstr; size_t match_list_len, max_equal, which, i; int matches = 0; match_list_len = 1; while ((retstr = ast_cli_generator(text, word, matches)) != NULL) { if (matches + 1 >= match_list_len) { match_list_len <<= 1; match_list = realloc(match_list, match_list_len * sizeof(char *)); } match_list[++matches] = retstr; } if (!match_list) return (char **) NULL; which = 2; prevstr = match_list[1]; max_equal = strlen(prevstr); for (; which <= matches; which++) { for (i = 0; i < max_equal && prevstr[i] == match_list[which][i]; i++) continue; max_equal = i; } retstr = malloc(max_equal + 1); (void) strncpy(retstr, match_list[1], max_equal); retstr[max_equal] = '\0'; match_list[0] = retstr; if (matches + 1 >= match_list_len) match_list = realloc(match_list, (match_list_len + 1) * sizeof(char *)); match_list[matches + 1] = (char *) NULL; return (match_list); }

char* ast_cli_generator (  char *  text, char *  word, int  state )

Readline madness. Definition at line 1014 of file cli.c. Referenced by ast_cli_completion_matches(), and ast_cli_generatornummatches(). { return __ast_cli_generator(text, word, state, 1); }

int ast_cli_generatornummatches (  char *  text, char *  word )

Definition at line 886 of file cli.c. References ast_cli_generator(). { int matches = 0, i = 0; char *buf, *oldbuf = NULL; while ( (buf = ast_cli_generator(text, word, i)) ) { if (++i > 1 && strcmp(buf,oldbuf) == 0) { continue; } oldbuf = buf; matches++; } return matches; }

int ast_cli_register (  struct ast_cli_entry *  e  )

Registers a command. Parameters: fd  File descriptor that I/O is done to s  string given at prompt Register your own command Returns 0 on success, -1 on failure Definition at line 709 of file cli.c. References ast_log(), ast_mutex_lock, ast_mutex_unlock, ast_cli_entry::cmda, helpers, LOG_WARNING, and ast_cli_entry::next. Referenced by ast_image_init(), ast_register_translator(), astdb_init(), init_framer(), init_logger(), init_manager(), load_pbx(), and main(). { struct ast_cli_entry *cur, *l=NULL; char fulle[80] ="", fulltst[80] =""; static int len; ast_mutex_lock(&clilock); join2(fulle, sizeof(fulle), e->cmda); if (find_cli(e->cmda, -1)) { ast_mutex_unlock(&clilock); ast_log(LOG_WARNING, "Command '%s' already registered (or something close enough)\n", fulle); return -1; } cur = helpers; while(cur) { join2(fulltst, sizeof(fulltst), cur->cmda); len = strlen(fulltst); if (strlen(fulle) < len) len = strlen(fulle); if (strncasecmp(fulle, fulltst, len) < 0) { if (l) { e->next = l->next; l->next = e; } else { e->next = helpers; helpers = e; } break; } l = cur; cur = cur->next; } if (!cur) { if (l) l->next = e; else helpers = e; e->next = NULL; } ast_mutex_unlock(&clilock); return 0; }

int ast_cli_unregister (  struct ast_cli_entry *  e  )

Unregisters a command. Parameters: e  which cli entry to unregister Unregister your own command. You must pass a completed ast_cli_entry structur Returns 0 on success, -1 on failure Definition at line 683 of file cli.c. References ast_log(), ast_mutex_lock, ast_mutex_unlock, helpers, ast_cli_entry::inuse, LOG_WARNING, and ast_cli_entry::next. { struct ast_cli_entry *cur, *l=NULL; ast_mutex_lock(&clilock); cur = helpers; while(cur) { if (e == cur) { if (e->inuse) { ast_log(LOG_WARNING, "Can't remove command that is in use\n"); } else { /* Rewrite */ if (l) l->next = e->next; else helpers = e->next; e->next = NULL; break; } } l = cur; cur = cur->next; } ast_mutex_unlock(&clilock); return 0; }

AST_MUTEX_DEFINE_STATIC (  climodentrylock   )

AST_MUTEX_DEFINE_STATIC (  clilock   )

---

Variable Documentation

struct ast_cli_entry* helpers = NULL

Definition at line 51 of file cli.c. Referenced by ast_cli_register(), and ast_cli_unregister().

---