Wed Jan 8 2020 09:50:13

Asterisk developer's documentation


func_version.c File Reference

Return the current Version strings. More...

#include "asterisk.h"
#include "asterisk/module.h"
#include "asterisk/channel.h"
#include "asterisk/pbx.h"
#include "asterisk/utils.h"
#include "asterisk/app.h"
#include "asterisk/ast_version.h"
#include "asterisk/build.h"

Go to the source code of this file.

Functions

static void __reg_module (void)
 
static void __unreg_module (void)
 
static int acf_version_exec (struct ast_channel *chan, const char *cmd, char *parse, char *buffer, size_t buflen)
 
static int load_module (void)
 
static int unload_module (void)
 

Variables

static struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "Get Asterisk Version/Build Info" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = "ac1f6a56484a8820659555499174e588" , .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_DEFAULT, }
 
static struct ast_custom_function acf_version
 
static struct ast_module_infoast_module_info = &__mod_info
 

Detailed Description

Return the current Version strings.

Author
Steve Murphy (murf@.nosp@m.digi.nosp@m.um.co.nosp@m.m)

Definition in file func_version.c.

Function Documentation

static void __reg_module ( void  )
static

Definition at line 136 of file func_version.c.

static void __unreg_module ( void  )
static

Definition at line 136 of file func_version.c.

static int acf_version_exec ( struct ast_channel chan,
const char *  cmd,
char *  parse,
char *  buffer,
size_t  buflen 
)
static

Definition at line 85 of file func_version.c.

References args, AST_APP_ARG, ast_copy_string(), ast_debug, AST_DECLARE_APP_ARGS, ast_get_version(), ast_get_version_num(), AST_STANDARD_APP_ARGS, ast_strlen_zero(), BUILD_DATE, BUILD_HOSTNAME, BUILD_KERNEL, BUILD_MACHINE, BUILD_OS, and BUILD_USER.

87 {
88  const char *response_char = ast_get_version();
90  AST_APP_ARG(info);
91  );
92 
94 
95  if (!ast_strlen_zero(args.info) ) {
96  if (!strcasecmp(args.info,"ASTERISK_VERSION_NUM"))
97  response_char = ast_get_version_num();
98  else if (!strcasecmp(args.info,"BUILD_USER"))
99  response_char = BUILD_USER;
100  else if (!strcasecmp(args.info,"BUILD_HOSTNAME"))
101  response_char = BUILD_HOSTNAME;
102  else if (!strcasecmp(args.info,"BUILD_MACHINE"))
103  response_char = BUILD_MACHINE;
104  else if (!strcasecmp(args.info,"BUILD_KERNEL"))
105  response_char = BUILD_KERNEL;
106  else if (!strcasecmp(args.info,"BUILD_OS"))
107  response_char = BUILD_OS;
108  else if (!strcasecmp(args.info,"BUILD_DATE"))
109  response_char = BUILD_DATE;
110  }
111 
112  ast_debug(1, "VERSION returns %s result, given %s argument\n", response_char, args.info);
113 
114  ast_copy_string(buffer, response_char, buflen);
115 
116  return 0;
117 }
#define BUILD_KERNEL
Definition: build.h:6
#define BUILD_MACHINE
Definition: build.h:7
const char * ast_get_version(void)
Retrieve the Asterisk version string.
Definition: version.c:14
#define AST_DECLARE_APP_ARGS(name, arglist)
Declare a structure to hold an application's arguments.
Definition: app.h:572
#define BUILD_USER
Definition: build.h:10
#define BUILD_DATE
Definition: build.h:9
#define ast_debug(level,...)
Log a DEBUG message.
Definition: logger.h:236
static force_inline int attribute_pure ast_strlen_zero(const char *s)
Definition: strings.h:63
static struct @350 args
static void parse(struct mgcp_request *req)
Definition: chan_mgcp.c:1858
const char * ast_get_version_num(void)
Retrieve the numeric Asterisk version.
Definition: version.c:19
#define BUILD_HOSTNAME
Definition: build.h:5
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:223
#define BUILD_OS
Definition: build.h:8
#define AST_APP_ARG(name)
Define an application argument.
Definition: app.h:555
#define AST_STANDARD_APP_ARGS(args, parse)
Performs the 'standard' argument separation process for an application.
Definition: app.h:604
static int load_module ( void  )
static

Definition at line 131 of file func_version.c.

References ast_custom_function_register.

132 {
134 }
static struct ast_custom_function acf_version
Definition: func_version.c:119
#define ast_custom_function_register(acf)
Register a custom function.
Definition: pbx.h:1164
static int unload_module ( void  )
static

Definition at line 124 of file func_version.c.

References ast_custom_function_unregister().

125 {
127 
128  return 0;
129 }
int ast_custom_function_unregister(struct ast_custom_function *acf)
Unregister a custom function.
Definition: pbx.c:3814
static struct ast_custom_function acf_version
Definition: func_version.c:119

Variable Documentation

struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "Get Asterisk Version/Build Info" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = "ac1f6a56484a8820659555499174e588" , .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_DEFAULT, }
static

Definition at line 136 of file func_version.c.

struct ast_custom_function acf_version
static
Initial value:
= {
.name = "VERSION",
}
static int acf_version_exec(struct ast_channel *chan, const char *cmd, char *parse, char *buffer, size_t buflen)
Definition: func_version.c:85

Definition at line 119 of file func_version.c.

Definition at line 136 of file func_version.c.