res_convert.c File Reference

file format conversion CLI command using Asterisk formats and translators More...

#include "asterisk.h"
#include "asterisk/channel.h"
#include "asterisk/module.h"
#include "asterisk/cli.h"
#include "asterisk/file.h"

Include dependency graph for res_convert.c:

Go to the source code of this file.

Functions
static void	__reg_module (void)
static void	__unreg_module (void)
struct ast_module *	AST_MODULE_SELF_SYM (void)
static char *	handle_cli_file_convert (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	Convert a file from one format to another. More...
static int	load_module (void)
static int	split_ext (char *filename, char **name, char **ext)
	Split the filename to basename and extension. More...
static int	unload_module (void)

Variables
static struct ast_module_info	__mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "File format conversion CLI command" , .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 = AST_BUILDOPT_SUM, .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_DEFAULT, .support_level = AST_MODULE_SUPPORT_CORE, }
static const struct ast_module_info *	ast_module_info = &__mod_info
static struct ast_cli_entry	cli_convert []

Detailed Description

file format conversion CLI command using Asterisk formats and translators

Author

redice li redic.nosp@m.e_li.nosp@m.@yaho.nosp@m.o.co.nosp@m.m

Russell Bryant russe.nosp@m.ll@d.nosp@m.igium.nosp@m..com

Definition in file res_convert.c.

Function Documentation

__reg_module()

static void __reg_module ( void  )

static

Definition at line 159 of file res_convert.c.

__unreg_module()

static void __unreg_module ( void  )

static

Definition at line 159 of file res_convert.c.

AST_MODULE_SELF_SYM()

struct ast_module * AST_MODULE_SELF_SYM

(

void

)

Definition at line 159 of file res_convert.c.

handle_cli_file_convert()

static char * handle_cli_file_convert ( struct ast_cli_entry *  e, int  cmd, struct ast_cli_args *  a  )

static

Convert a file from one format to another.

Parameters

e	CLI entry
cmd	command number
a	list of cli arguments

Return values

CLI_SUCCESS	on success.
CLI_SHOWUSAGE	or CLI_FAILURE on failure.

Definition at line 64 of file res_convert.c.

{
    char *ret = CLI_FAILURE;
    struct ast_filestream *fs_in = NULL, *fs_out = NULL;
    struct ast_frame *f;
    struct timeval start;
    int cost;
    char *file_in = NULL, *file_out = NULL;
    char *name_in, *ext_in, *name_out, *ext_out;
 
    switch (cmd) {
    case CLI_INIT:
        e->command = "file convert";
        e->usage =
            "Usage: file convert <file_in> <file_out>\n"
            "       Convert from file_in to file_out. If an absolute path\n"
            "       is not given, the default Asterisk sounds directory\n"
            "       will be used.\n\n"
            "       Example:\n"
            "           file convert tt-weasels.gsm tt-weasels.ulaw\n";
        return NULL;
    case CLI_GENERATE:
        return NULL;
    }
 
    if (a->argc != 4 || ast_strlen_zero(a->argv[2]) || ast_strlen_zero(a->argv[3])) {
        ret = CLI_SHOWUSAGE;
        goto fail_out;
    }
 
    file_in = ast_strdupa(a->argv[2]);
    file_out = ast_strdupa(a->argv[3]);
 
    if (split_ext(file_in, &name_in, &ext_in)) {
        ast_cli(a->fd, "'%s' is an invalid filename!\n", a->argv[2]);
        goto fail_out;
    }
    if (!(fs_in = ast_readfile(name_in, ext_in, NULL, O_RDONLY, 0, 0))) {
        ast_cli(a->fd, "Unable to open input file: %s\n", a->argv[2]);
        goto fail_out;
    }
 
    if (split_ext(file_out, &name_out, &ext_out)) {
        ast_cli(a->fd, "'%s' is an invalid filename!\n", a->argv[3]);
        goto fail_out;
    }
    if (!(fs_out = ast_writefile(name_out, ext_out, NULL, O_CREAT|O_TRUNC|O_WRONLY, 0, AST_FILE_MODE))) {
        ast_cli(a->fd, "Unable to open output file: %s\n", a->argv[3]);
        goto fail_out;
    }
 
    start = ast_tvnow();
 
    while ((f = ast_readframe(fs_in))) {
        if (ast_writestream(fs_out, f)) {
            ast_frfree(f);
            ast_cli(a->fd, "Failed to convert %s.%s to %s.%s!\n", name_in, ext_in, name_out, ext_out);
            goto fail_out;
        }
        ast_frfree(f);
    }
 
    cost = ast_tvdiff_ms(ast_tvnow(), start);
    ast_cli(a->fd, "Converted %s.%s to %s.%s in %dms\n", name_in, ext_in, name_out, ext_out, cost);
    ret = CLI_SUCCESS;
 
fail_out:
    if (fs_out) {
        ast_closestream(fs_out);
        if (ret != CLI_SUCCESS)
            ast_filedelete(name_out, ext_out);
    }
 
    if (fs_in)
        ast_closestream(fs_in);
 
    return ret;
}

References a, ast_cli(), ast_closestream(), AST_FILE_MODE, ast_filedelete(), ast_frfree, ast_readfile(), ast_readframe(), ast_strdupa, ast_strlen_zero(), ast_tvdiff_ms(), ast_tvnow(), ast_writefile(), ast_writestream(), CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, NULL, split_ext(), and ast_cli_entry::usage.

load_module()

static int load_module ( void  )

static

Definition at line 153 of file res_convert.c.

{
    ast_cli_register_multiple(cli_convert, ARRAY_LEN(cli_convert));
    return AST_MODULE_LOAD_SUCCESS;
}

References ARRAY_LEN, ast_cli_register_multiple, AST_MODULE_LOAD_SUCCESS, and cli_convert.

split_ext()

static int split_ext ( char *  filename, char **  name, char **  ext  )

static

Split the filename to basename and extension.

Definition at line 41 of file res_convert.c.

{
    *name = *ext = filename;
 
    if ((*ext = strrchr(filename, '.'))) {
        **ext = '\0';
        (*ext)++;
    }
 
    if (ast_strlen_zero(*name) || ast_strlen_zero(*ext))
        return -1;
 
    return 0;
}

References ast_strlen_zero(), ext, and name.

Referenced by handle_cli_file_convert().

unload_module()

static int unload_module ( void  )

static

Definition at line 147 of file res_convert.c.

{
    ast_cli_unregister_multiple(cli_convert, ARRAY_LEN(cli_convert));
    return 0;
}

References ARRAY_LEN, ast_cli_unregister_multiple(), and cli_convert.

Variable Documentation

__mod_info

struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "File format conversion CLI command" , .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 = AST_BUILDOPT_SUM, .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_DEFAULT, .support_level = AST_MODULE_SUPPORT_CORE, }

static

Definition at line 159 of file res_convert.c.

ast_module_info

const struct ast_module_info* ast_module_info = &__mod_info

static

Definition at line 159 of file res_convert.c.

cli_convert

struct ast_cli_entry cli_convert[]

static

Initial value:

= {
    { .handler =  handle_cli_file_convert , .summary =  "Convert audio file" ,}
}

Definition at line 143 of file res_convert.c.

Referenced by load_module(), and unload_module().