#include "asterisk/channel.h"
#include "asterisk/frame.h"
#include <fcntl.h>
Include dependency graph for file.h:
This graph shows which files directly or indirectly include this file:
Go to the source code of this file.
Data Structures | |
struct | ast_filestream |
struct | ast_format |
struct | ast_format_lock |
Defines | |
#define | AST_DIGIT_ANY "0123456789#*ABCD" |
#define | AST_DIGIT_ANYNUM "0123456789" |
#define | ast_format_register(f) __ast_format_register(f, ast_module_info->self) |
#define | AST_RESERVED_POINTERS 20 |
#define | SEEK_FORCECUR 10 |
Functions | |
int | __ast_format_register (const struct ast_format *f, struct ast_module *mod) |
int | ast_applystream (struct ast_channel *chan, struct ast_filestream *s) |
int | ast_closestream (struct ast_filestream *f) |
int | ast_file_init (void) |
int | ast_filecopy (const char *oldname, const char *newname, const char *fmt) |
int | ast_filedelete (const char *filename, const char *fmt) |
int | ast_fileexists (const char *filename, const char *fmt, const char *preflang) |
int | ast_filerename (const char *oldname, const char *newname, const char *fmt) |
int | ast_format_unregister (const char *name) |
ast_filestream * | ast_openstream (struct ast_channel *chan, const char *filename, const char *preflang) |
ast_filestream * | ast_openstream_full (struct ast_channel *chan, const char *filename, const char *preflang, int asis) |
ast_filestream * | ast_openvstream (struct ast_channel *chan, const char *filename, const char *preflang) |
int | ast_playstream (struct ast_filestream *s) |
ast_filestream * | ast_readfile (const char *filename, const char *type, const char *comment, int flags, int check, mode_t mode) |
ast_frame * | ast_readframe (struct ast_filestream *s) |
int | ast_seekstream (struct ast_filestream *fs, off_t sample_offset, int whence) |
int | ast_stopstream (struct ast_channel *c) |
int | ast_stream_and_wait (struct ast_channel *chan, const char *file, const char *language, const char *digits) |
int | ast_stream_fastforward (struct ast_filestream *fs, off_t ms) |
int | ast_stream_rewind (struct ast_filestream *fs, off_t ms) |
int | ast_streamfile (struct ast_channel *c, const char *filename, const char *preflang) |
off_t | ast_tellstream (struct ast_filestream *fs) |
int | ast_truncstream (struct ast_filestream *fs) |
int | ast_waitstream (struct ast_channel *c, const char *breakon) |
int | ast_waitstream_exten (struct ast_channel *c, const char *context) |
int | ast_waitstream_fr (struct ast_channel *c, const char *breakon, const char *forward, const char *rewind, int ms) |
int | ast_waitstream_full (struct ast_channel *c, const char *breakon, int audiofd, int monfd) |
ast_filestream * | ast_writefile (const char *filename, const char *type, const char *comment, int flags, int check, mode_t mode) |
int | ast_writestream (struct ast_filestream *fs, struct ast_frame *f) |
Definition in file file.h.
#define AST_DIGIT_ANY "0123456789#*ABCD" |
Convenient for waiting
Definition at line 40 of file file.h.
Referenced by __login_exec(), ast_app_getdata(), ast_ivr_menu_run_internal(), ast_play_and_wait(), ast_readstring_full(), ast_record_review(), background_file(), bridge_playfile(), builtin_atxfer(), builtin_blindtransfer(), conf_exec(), conf_run(), dictate_exec(), directory_exec(), festival_exec(), get_folder(), ivr_dispatch(), pbx_builtin_background(), play_file(), play_mailbox_owner(), play_message(), play_message_callerid(), play_message_datetime(), play_message_duration(), play_record_review(), retrydial_exec(), say_and_wait(), say_position(), sayunixtime_exec(), try_calling(), vm_intro_gr(), vm_intro_pt(), vm_intro_pt_BR(), and wait_file2().
#define AST_DIGIT_ANYNUM "0123456789" |
#define ast_format_register | ( | f | ) | __ast_format_register(f, ast_module_info->self) |
#define SEEK_FORCECUR 10 |
Definition at line 138 of file file.h.
Referenced by __ast_read(), ast_write(), au_seek(), g729_seek(), gsm_seek(), ilbc_seek(), mp3_seek(), pcm_seek(), slinear_seek(), vox_seek(), and wav_seek().
int __ast_format_register | ( | const struct ast_format * | f, | |
struct ast_module * | mod | |||
) |
Register a new file format capability Adds a format to Asterisk's format abilities. returns 0 on success, -1 on failure
Definition at line 68 of file file.c.
References ast_calloc, ast_log(), AST_RWLIST_INSERT_HEAD, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verbose(), ast_format::buf_size, ast_format::exts, f, LOG_WARNING, ast_format::module, ast_format::name, option_verbose, and VERBOSE_PREFIX_2.
00069 { 00070 struct ast_format *tmp; 00071 00072 AST_RWLIST_WRLOCK(&formats); 00073 AST_RWLIST_TRAVERSE(&formats, tmp, list) { 00074 if (!strcasecmp(f->name, tmp->name)) { 00075 AST_RWLIST_UNLOCK(&formats); 00076 ast_log(LOG_WARNING, "Tried to register '%s' format, already registered\n", f->name); 00077 return -1; 00078 } 00079 } 00080 if (!(tmp = ast_calloc(1, sizeof(*tmp)))) { 00081 AST_RWLIST_UNLOCK(&formats); 00082 return -1; 00083 } 00084 *tmp = *f; 00085 tmp->module = mod; 00086 if (tmp->buf_size) { 00087 /* 00088 * Align buf_size properly, rounding up to the machine-specific 00089 * alignment for pointers. 00090 */ 00091 struct _test_align { void *a, *b; } p; 00092 int align = (char *)&p.b - (char *)&p.a; 00093 tmp->buf_size = ((f->buf_size + align - 1)/align)*align; 00094 } 00095 00096 memset(&tmp->list, 0, sizeof(tmp->list)); 00097 00098 AST_RWLIST_INSERT_HEAD(&formats, tmp, list); 00099 AST_RWLIST_UNLOCK(&formats); 00100 if (option_verbose > 1) 00101 ast_verbose( VERBOSE_PREFIX_2 "Registered file format %s, extension(s) %s\n", f->name, f->exts); 00102 00103 return 0; 00104 }
int ast_applystream | ( | struct ast_channel * | chan, | |
struct ast_filestream * | s | |||
) |
chan | channel to work | |
s | ast_filestream to apply Returns 0 for success, -1 on failure |
Definition at line 660 of file file.c.
References s.
Referenced by ast_streamfile(), handle_getoption(), handle_recordfile(), handle_streamfile(), and speech_streamfile().
00661 { 00662 s->owner = chan; 00663 return 0; 00664 }
int ast_closestream | ( | struct ast_filestream * | f | ) |
f | filestream to close Close a playback or recording stream Returns 0 on success, -1 on failure |
Definition at line 700 of file file.c.
References ast_closestream(), AST_FORMAT_MAX_AUDIO, ast_module_unref(), ast_safe_system(), ast_sched_del(), ast_settimeout(), ast_translator_free_path(), ast_format::close, f, ast_format::format, free, and ast_format::module.
Referenced by __ast_play_and_record(), ast_closestream(), ast_filehelper(), ast_hangup(), ast_moh_files_next(), ast_monitor_start(), ast_monitor_stop(), ast_stopstream(), channel_spy(), cli_audio_convert(), cli_audio_convert_deprecated(), dictate_exec(), gen_closestream(), handle_recordfile(), local_ast_moh_stop(), mixmonitor_thread(), and moh_files_release().
00701 { 00702 char *cmd = NULL; 00703 size_t size = 0; 00704 /* Stop a running stream if there is one */ 00705 if (f->owner) { 00706 if (f->fmt->format < AST_FORMAT_MAX_AUDIO) { 00707 f->owner->stream = NULL; 00708 if (f->owner->streamid > -1) 00709 ast_sched_del(f->owner->sched, f->owner->streamid); 00710 f->owner->streamid = -1; 00711 #ifdef HAVE_ZAPTEL 00712 ast_settimeout(f->owner, 0, NULL, NULL); 00713 #endif 00714 } else { 00715 f->owner->vstream = NULL; 00716 if (f->owner->vstreamid > -1) 00717 ast_sched_del(f->owner->sched, f->owner->vstreamid); 00718 f->owner->vstreamid = -1; 00719 } 00720 } 00721 /* destroy the translator on exit */ 00722 if (f->trans) 00723 ast_translator_free_path(f->trans); 00724 00725 if (f->realfilename && f->filename) { 00726 size = strlen(f->filename) + strlen(f->realfilename) + 15; 00727 cmd = alloca(size); 00728 memset(cmd,0,size); 00729 snprintf(cmd,size,"/bin/mv -f %s %s",f->filename,f->realfilename); 00730 ast_safe_system(cmd); 00731 } 00732 00733 if (f->filename) 00734 free(f->filename); 00735 if (f->realfilename) 00736 free(f->realfilename); 00737 if (f->fmt->close) 00738 f->fmt->close(f); 00739 fclose(f->f); 00740 if (f->vfs) 00741 ast_closestream(f->vfs); 00742 ast_module_unref(f->fmt->module); 00743 free(f); 00744 return 0; 00745 }
int ast_file_init | ( | void | ) |
Initializes all the various file stuff. Basically just registers the cli stuff Returns 0 all the time
Definition at line 1190 of file file.c.
References ast_cli_register_multiple(), and cli_file.
Referenced by main().
01191 { 01192 ast_cli_register_multiple(cli_file, sizeof(cli_file) / sizeof(struct ast_cli_entry)); 01193 return 0; 01194 }
int ast_filecopy | ( | const char * | oldname, | |
const char * | newname, | |||
const char * | fmt | |||
) |
oldname | name of the file you wish to copy (minus extension) | |
newname | name you wish the file to be copied to (minus extension) | |
fmt | the format of the file Copy a given file in a given format, or if fmt is NULL, then do so for all |
Definition at line 775 of file file.c.
References ast_filehelper().
Referenced by copy_file().
00776 { 00777 return ast_filehelper(filename, filename2, fmt, ACTION_COPY); 00778 }
int ast_filedelete | ( | const char * | filename, | |
const char * | fmt | |||
) |
filename | name of the file you wish to delete (minus the extension) | |
fmt | of the file Delete a given file in a given format, or if fmt is NULL, then do so for all |
Definition at line 765 of file file.c.
References ACTION_DELETE, and ast_filehelper().
Referenced by __ast_play_and_record(), ast_monitor_start(), ast_monitor_stop(), cli_audio_convert(), cli_audio_convert_deprecated(), leave_voicemail(), play_mailbox_owner(), and vm_delete().
00766 { 00767 return ast_filehelper(filename, NULL, fmt, ACTION_DELETE); 00768 }
int ast_fileexists | ( | const char * | filename, | |
const char * | fmt, | |||
const char * | preflang | |||
) |
filename | name of the file you wish to check, minus the extension | |
fmt | the format you wish to check (the extension) | |
preflang | (the preferred language you wisht to find the file in) See if a given file exists in a given format. If fmt is NULL, any format is accepted. Returns -1 if file does not exist, non-zero positive otherwise. |
Definition at line 751 of file file.c.
References fileexists_core().
Referenced by app_exec(), ast_moh_files_next(), ast_monitor_start(), ast_monitor_stop(), common_exec(), conf_run(), invent_message(), last_message_index(), leave_voicemail(), play_mailbox_owner(), play_message_callerid(), record_exec(), rxfax_exec(), vm_intro(), vm_newuser(), and vm_tempgreeting().
00752 { 00753 char *buf; 00754 int buflen; 00755 00756 if (preflang == NULL) 00757 preflang = ""; 00758 buflen = strlen(preflang) + strlen(filename) + 2; /* room for everything */ 00759 buf = alloca(buflen); 00760 if (buf == NULL) 00761 return 0; 00762 return fileexists_core(filename, fmt, preflang, buf, buflen); 00763 }
int ast_filerename | ( | const char * | oldname, | |
const char * | newname, | |||
const char * | fmt | |||
) |
oldname | the name of the file you wish to act upon (minus the extension) | |
newname | the name you wish to rename the file to (minus the extension) | |
fmt | the format of the file Rename a given file in a given format, or if fmt is NULL, then do so for all Returns -1 on failure |
Definition at line 770 of file file.c.
References ACTION_RENAME, and ast_filehelper().
Referenced by __ast_play_and_record(), ast_monitor_stop(), leave_voicemail(), and rename_file().
00771 { 00772 return ast_filehelper(filename, filename2, fmt, ACTION_RENAME); 00773 }
int ast_format_unregister | ( | const char * | name | ) |
name | the name of the format you wish to unregister Unregisters a format based on the name of the format. Returns 0 on success, -1 on failure to unregister |
Definition at line 106 of file file.c.
References ast_log(), AST_RWLIST_REMOVE_CURRENT, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verbose(), free, LOG_WARNING, ast_format::name, option_verbose, and VERBOSE_PREFIX_2.
Referenced by unload_module().
00107 { 00108 struct ast_format *tmp; 00109 int res = -1; 00110 00111 AST_RWLIST_WRLOCK(&formats); 00112 AST_RWLIST_TRAVERSE_SAFE_BEGIN(&formats, tmp, list) { 00113 if (!strcasecmp(name, tmp->name)) { 00114 AST_RWLIST_REMOVE_CURRENT(&formats, list); 00115 free(tmp); 00116 res = 0; 00117 } 00118 } 00119 AST_RWLIST_TRAVERSE_SAFE_END 00120 AST_RWLIST_UNLOCK(&formats); 00121 00122 if (!res) { 00123 if (option_verbose > 1) 00124 ast_verbose( VERBOSE_PREFIX_2 "Unregistered format %s\n", name); 00125 } else 00126 ast_log(LOG_WARNING, "Tried to unregister format %s, already unregistered\n", name); 00127 00128 return res; 00129 }
struct ast_filestream* ast_openstream | ( | struct ast_channel * | chan, | |
const char * | filename, | |||
const char * | preflang | |||
) |
chan | channel to work with | |
filename | to use | |
preflang | prefered language to use Returns a ast_filestream pointer if it opens the file, NULL on error |
Definition at line 523 of file file.c.
References ast_openstream_full().
Referenced by ast_streamfile(), dictate_exec(), handle_getoption(), handle_streamfile(), and speech_streamfile().
00524 { 00525 return ast_openstream_full(chan, filename, preflang, 0); 00526 }
struct ast_filestream* ast_openstream_full | ( | struct ast_channel * | chan, | |
const char * | filename, | |||
const char * | preflang, | |||
int | asis | |||
) |
chan | channel to work with | |
filename | to use | |
preflang | prefered language to use | |
asis | if set, don't clear generators Returns a ast_filestream pointer if it opens the file, NULL on error |
Definition at line 528 of file file.c.
References ACTION_OPEN, ast_deactivate_generator(), ast_filehelper(), AST_FORMAT_AUDIO_MASK, ast_log(), ast_set_write_format(), ast_stopstream(), ast_filestream::buf, fileexists_core(), LOG_WARNING, ast_channel::oldwriteformat, ast_channel::stream, and ast_channel::writeformat.
Referenced by ast_moh_files_next(), ast_openstream(), channel_spy(), and gen_nextfile().
00529 { 00530 /* 00531 * Use fileexists_core() to find a file in a compatible 00532 * language and format, set up a suitable translator, 00533 * and open the stream. 00534 */ 00535 int fmts, res, buflen; 00536 char *buf; 00537 00538 if (!asis) { 00539 /* do this first, otherwise we detect the wrong writeformat */ 00540 ast_stopstream(chan); 00541 if (chan->generator) 00542 ast_deactivate_generator(chan); 00543 } 00544 if (preflang == NULL) 00545 preflang = ""; 00546 buflen = strlen(preflang) + strlen(filename) + 2; 00547 buf = alloca(buflen); 00548 if (buf == NULL) 00549 return NULL; 00550 fmts = fileexists_core(filename, NULL, preflang, buf, buflen); 00551 if (fmts > 0) 00552 fmts &= AST_FORMAT_AUDIO_MASK; 00553 if (fmts < 1) { 00554 ast_log(LOG_WARNING, "File %s does not exist in any format\n", filename); 00555 return NULL; 00556 } 00557 chan->oldwriteformat = chan->writeformat; 00558 /* Set the channel to a format we can work with */ 00559 res = ast_set_write_format(chan, fmts); 00560 res = ast_filehelper(buf, chan, NULL, ACTION_OPEN); 00561 if (res >= 0) 00562 return chan->stream; 00563 return NULL; 00564 }
struct ast_filestream* ast_openvstream | ( | struct ast_channel * | chan, | |
const char * | filename, | |||
const char * | preflang | |||
) |
chan | channel to work with | |
filename | to use | |
preflang | prefered language to use Returns a ast_filestream pointer if it opens the file, NULL on error |
Definition at line 566 of file file.c.
References ACTION_OPEN, ast_filehelper(), AST_FORMAT_MAX_AUDIO, AST_FORMAT_MAX_VIDEO, ast_getformatname(), ast_log(), ast_filestream::buf, fileexists_core(), fmt, format, LOG_WARNING, ast_channel::nativeformats, and ast_channel::vstream.
Referenced by ast_streamfile(), handle_getoption(), and handle_streamfile().
00567 { 00568 /* As above, but for video. But here we don't have translators 00569 * so we must enforce a format. 00570 */ 00571 unsigned int format; 00572 char *buf; 00573 int buflen; 00574 00575 if (preflang == NULL) 00576 preflang = ""; 00577 buflen = strlen(preflang) + strlen(filename) + 2; 00578 buf = alloca(buflen); 00579 if (buf == NULL) 00580 return NULL; 00581 00582 for (format = AST_FORMAT_MAX_AUDIO << 1; format <= AST_FORMAT_MAX_VIDEO; format = format << 1) { 00583 int fd; 00584 const char *fmt; 00585 00586 if (!(chan->nativeformats & format)) 00587 continue; 00588 fmt = ast_getformatname(format); 00589 if ( fileexists_core(filename, fmt, preflang, buf, buflen) < 1) /* no valid format */ 00590 continue; 00591 fd = ast_filehelper(buf, chan, fmt, ACTION_OPEN); 00592 if (fd >= 0) 00593 return chan->vstream; 00594 ast_log(LOG_WARNING, "File %s has video but couldn't be opened\n", filename); 00595 } 00596 return NULL; 00597 }
int ast_playstream | ( | struct ast_filestream * | s | ) |
s | filestream to play Returns 0 for success, -1 on failure |
Definition at line 666 of file file.c.
References AST_FORMAT_MAX_AUDIO, ast_readaudio_callback(), ast_readvideo_callback(), and s.
Referenced by ast_streamfile(), handle_getoption(), handle_streamfile(), and speech_streamfile().
00667 { 00668 if (s->fmt->format < AST_FORMAT_MAX_AUDIO) 00669 ast_readaudio_callback(s); 00670 else 00671 ast_readvideo_callback(s); 00672 return 0; 00673 }
struct ast_filestream* ast_readfile | ( | const char * | filename, | |
const char * | type, | |||
const char * | comment, | |||
int | flags, | |||
int | check, | |||
mode_t | mode | |||
) |
filename | the name of the file to read from | |
type | format of file you wish to read from | |
comment | comment to go with | |
flags | file flags | |
check | (unimplemented, hence negligible) | |
mode | Open mode Open an incoming file stream. flags are flags for the open() command, and if check is non-zero, then it will not read a file if there are any files that start with that name and have an extension Please note, this is a blocking function. Program execution will not return until ast_waitstream completes it's execution. Returns a struct ast_filestream on success, NULL on failure |
Definition at line 809 of file file.c.
References ast_free, ast_log(), AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, build_filename(), ast_format::exts, exts_compare(), f, ast_filestream::filename, ast_filestream::flags, ast_filestream::fmt, free, get_filestream(), LOG_WARNING, ast_filestream::mode, open_wrapper(), strdup, ast_filestream::trans, and ast_filestream::vfs.
Referenced by __ast_play_and_record(), cli_audio_convert(), and cli_audio_convert_deprecated().
00810 { 00811 FILE *bfile; 00812 struct ast_format *f; 00813 struct ast_filestream *fs = NULL; 00814 char *fn; 00815 00816 AST_RWLIST_RDLOCK(&formats); 00817 00818 AST_RWLIST_TRAVERSE(&formats, f, list) { 00819 fs = NULL; 00820 if (!exts_compare(f->exts, type)) 00821 continue; 00822 00823 fn = build_filename(filename, type); 00824 errno = 0; 00825 bfile = fopen(fn, "r"); 00826 if (!bfile || (fs = get_filestream(f, bfile)) == NULL || 00827 open_wrapper(fs) ) { 00828 ast_log(LOG_WARNING, "Unable to open %s\n", fn); 00829 if (fs) 00830 ast_free(fs); 00831 if (bfile) 00832 fclose(bfile); 00833 free(fn); 00834 continue; 00835 } 00836 /* found it */ 00837 fs->trans = NULL; 00838 fs->fmt = f; 00839 fs->flags = flags; 00840 fs->mode = mode; 00841 fs->filename = strdup(filename); 00842 fs->vfs = NULL; 00843 break; 00844 } 00845 00846 AST_RWLIST_UNLOCK(&formats); 00847 if (!fs) 00848 ast_log(LOG_WARNING, "No such format '%s'\n", type); 00849 00850 return fs; 00851 }
struct ast_frame* ast_readframe | ( | struct ast_filestream * | s | ) |
s | ast_filestream to act on Returns a frame or NULL if read failed |
Definition at line 599 of file file.c.
Referenced by __ast_play_and_record(), channel_spy(), cli_audio_convert(), cli_audio_convert_deprecated(), dictate_exec(), gen_readframe(), and moh_files_readframe().
00600 { 00601 struct ast_frame *f = NULL; 00602 int whennext = 0; 00603 if (s && s->fmt) 00604 f = s->fmt->read(s, &whennext); 00605 return f; 00606 }
int ast_seekstream | ( | struct ast_filestream * | fs, | |
off_t | sample_offset, | |||
int | whence | |||
) |
fs | ast_filestream to perform seek on | |
sample_offset | numbers of samples to seek | |
whence | SEEK_SET, SEEK_CUR, SEEK_END Returns 0 for success, or -1 for error |
Definition at line 675 of file file.c.
References ast_filestream::fmt, and ast_format::seek.
Referenced by __ast_read(), ast_control_streamfile(), ast_stream_fastforward(), ast_stream_rewind(), ast_write(), dictate_exec(), handle_getoption(), handle_recordfile(), and handle_streamfile().
int ast_stopstream | ( | struct ast_channel * | c | ) |
c | The channel you wish to stop playback on Stop playback of a stream Returns 0 regardless |
Definition at line 131 of file file.c.
References ast_closestream(), ast_log(), ast_set_write_format(), LOG_WARNING, ast_channel::oldwriteformat, ast_channel::stream, and ast_channel::vstream.
Referenced by app_exec(), ast_adsi_transmit_message_full(), ast_app_getdata(), ast_control_streamfile(), ast_openstream_full(), ast_play_and_wait(), ast_readstring_full(), ast_say_enumeration_full_da(), ast_say_enumeration_full_de(), ast_say_enumeration_full_en(), ast_say_number_full_cz(), ast_say_number_full_da(), ast_say_number_full_de(), ast_say_number_full_en(), ast_say_number_full_en_GB(), ast_say_number_full_es(), ast_say_number_full_fr(), ast_say_number_full_ge(), ast_say_number_full_gr(), ast_say_number_full_he(), ast_say_number_full_it(), ast_say_number_full_nl(), ast_say_number_full_no(), ast_say_number_full_pt(), ast_say_number_full_ru(), ast_say_number_full_se(), ast_say_number_full_tw(), background_detect_exec(), background_file(), builtin_blindtransfer(), conf_exec(), conf_run(), directory_exec(), handle_getoption(), handle_streamfile(), ices_exec(), ivr_dispatch(), leave_voicemail(), mp3_exec(), NBScat_exec(), nv_background_detect_exec(), parkandannounce_exec(), pbx_builtin_background(), pl_odtworz_plik(), play_file(), play_mailbox_owner(), playback_exec(), queue_exec(), read_exec(), recordthread(), rpt_tele_thread(), s_streamwait3(), say_character_str_full(), say_digit_str_full(), say_phonetic_str_full(), saycharstr(), sayfile(), saynum(), send_morse(), send_tone_telemetry(), send_waveform_to_channel(), speech_background(), vm_authenticate(), vm_execmain(), wait_for_winner(), waitstream_core(), and zapateller_exec().
00132 { 00133 /* Stop a running stream if there is one */ 00134 if (tmp->stream) { 00135 ast_closestream(tmp->stream); 00136 tmp->stream = NULL; 00137 if (tmp->oldwriteformat && ast_set_write_format(tmp, tmp->oldwriteformat)) 00138 ast_log(LOG_WARNING, "Unable to restore format back to %d\n", tmp->oldwriteformat); 00139 } 00140 /* Stop the video stream too */ 00141 if (tmp->vstream != NULL) { 00142 ast_closestream(tmp->vstream); 00143 tmp->vstream = NULL; 00144 } 00145 return 0; 00146 }
int ast_stream_and_wait | ( | struct ast_channel * | chan, | |
const char * | file, | |||
const char * | language, | |||
const char * | digits | |||
) |
Definition at line 1113 of file file.c.
References ast_streamfile(), ast_strlen_zero(), and ast_waitstream().
Referenced by __ast_play_and_record(), app_exec(), ast_record_review(), bridge_playfile(), builtin_atxfer(), builtin_automonitor(), builtin_blindtransfer(), directory_exec(), invent_message(), ivr_dispatch(), leave_voicemail(), park_exec(), play_mailbox_owner(), play_message_callerid(), play_record_review(), and wait_file2().
01115 { 01116 int res = 0; 01117 if (!ast_strlen_zero(file)) { 01118 res = ast_streamfile(chan, file, language); 01119 if (!res) 01120 res = ast_waitstream(chan, digits); 01121 } 01122 return res; 01123 }
int ast_stream_fastforward | ( | struct ast_filestream * | fs, | |
off_t | ms | |||
) |
fs | filestream to act on | |
ms | milliseconds to move Returns 0 for success, or -1 for error |
Definition at line 690 of file file.c.
References ast_seekstream(), and DEFAULT_SAMPLES_PER_MS.
Referenced by waitstream_core().
00691 { 00692 return ast_seekstream(fs, ms * DEFAULT_SAMPLES_PER_MS, SEEK_CUR); 00693 }
int ast_stream_rewind | ( | struct ast_filestream * | fs, | |
off_t | ms | |||
) |
fs | filestream to act on | |
ms | milliseconds to move Returns 0 for success, or -1 for error |
Definition at line 695 of file file.c.
References ast_seekstream(), and DEFAULT_SAMPLES_PER_MS.
Referenced by __ast_play_and_record(), handle_recordfile(), and waitstream_core().
00696 { 00697 return ast_seekstream(fs, -ms * DEFAULT_SAMPLES_PER_MS, SEEK_CUR); 00698 }
int ast_streamfile | ( | struct ast_channel * | c, | |
const char * | filename, | |||
const char * | preflang | |||
) |
c | channel to stream the file to | |
filename | the name of the file you wish to stream, minus the extension | |
preflang | the preferred language you wish to have the file streamed to you in Prepares a channel for the streaming of a file. To start the stream, afterward do a ast_waitstream() on the channel Also, it will stop any existing streams on the channel. Returns 0 on success, or -1 on failure. |
Definition at line 780 of file file.c.
References ast_applystream(), ast_getformatname(), ast_getformatname_multiple(), ast_log(), ast_openstream(), ast_openvstream(), ast_playstream(), ast_verbose(), ast_filestream::fmt, fmt, ast_format::format, LOG_DEBUG, LOG_WARNING, ast_channel::nativeformats, option_verbose, VERBOSE_PREFIX_3, and ast_filestream::vfs.
Referenced by __login_exec(), agent_call(), app_exec(), ast_app_getdata(), ast_app_getdata_full(), ast_control_streamfile(), ast_play_and_wait(), ast_say_date_da(), ast_say_date_de(), ast_say_date_en(), ast_say_date_fr(), ast_say_date_ge(), ast_say_date_gr(), ast_say_date_nl(), ast_say_date_with_format_gr(), ast_say_datetime_en(), ast_say_datetime_fr(), ast_say_datetime_from_now_en(), ast_say_datetime_from_now_fr(), ast_say_datetime_from_now_ge(), ast_say_datetime_gr(), ast_say_datetime_nl(), ast_say_datetime_pt(), ast_say_datetime_tw(), ast_say_enumeration_full_da(), ast_say_enumeration_full_de(), ast_say_enumeration_full_en(), ast_say_number_full_cz(), ast_say_number_full_da(), ast_say_number_full_de(), ast_say_number_full_en(), ast_say_number_full_en_GB(), ast_say_number_full_es(), ast_say_number_full_fr(), ast_say_number_full_ge(), ast_say_number_full_gr(), ast_say_number_full_he(), ast_say_number_full_it(), ast_say_number_full_nl(), ast_say_number_full_no(), ast_say_number_full_pt(), ast_say_number_full_ru(), ast_say_number_full_se(), ast_say_number_full_tw(), ast_say_time_de(), ast_say_time_en(), ast_say_time_fr(), ast_say_time_ge(), ast_say_time_gr(), ast_say_time_nl(), ast_say_time_tw(), ast_stream_and_wait(), background_detect_exec(), background_file(), check_availability(), check_beep(), common_exec(), conf_exec(), conf_run(), do_directory(), forward_message(), gr_say_number_female(), handle_recordfile(), leave_voicemail(), nv_background_detect_exec(), page_exec(), park_exec(), parkandannounce_exec(), pbx_builtin_background(), pl_odtworz_plik(), play_and_wait(), play_file(), playback_exec(), privacy_exec(), retrydial_exec(), rpt_tele_thread(), s_streamwait3(), say_character_str_full(), say_digit_str_full(), say_phonetic_str_full(), sayfile(), ss_thread(), vm_authenticate(), wait_file(), and wait_for_winner().
00781 { 00782 struct ast_filestream *fs; 00783 struct ast_filestream *vfs=NULL; 00784 char fmt[256]; 00785 00786 fs = ast_openstream(chan, filename, preflang); 00787 if (fs) 00788 vfs = ast_openvstream(chan, filename, preflang); 00789 if (vfs) 00790 ast_log(LOG_DEBUG, "Ooh, found a video stream, too, format %s\n", ast_getformatname(vfs->fmt->format)); 00791 if (fs){ 00792 if (ast_applystream(chan, fs)) 00793 return -1; 00794 if (vfs && ast_applystream(chan, vfs)) 00795 return -1; 00796 if (ast_playstream(fs)) 00797 return -1; 00798 if (vfs && ast_playstream(vfs)) 00799 return -1; 00800 if (option_verbose > 2) 00801 ast_verbose(VERBOSE_PREFIX_3 "<%s> Playing '%s' (language '%s')\n", chan->name, filename, preflang ? preflang : "default"); 00802 00803 return 0; 00804 } 00805 ast_log(LOG_WARNING, "Unable to open %s (format %s): %s\n", filename, ast_getformatname_multiple(fmt, sizeof(fmt), chan->nativeformats), strerror(errno)); 00806 return -1; 00807 }
off_t ast_tellstream | ( | struct ast_filestream * | fs | ) |
fs | fs to act on Returns a long as a sample offset into stream |
Definition at line 685 of file file.c.
References ast_filestream::fmt, and ast_format::tell.
Referenced by ast_control_streamfile(), handle_getoption(), handle_recordfile(), and handle_streamfile().
int ast_truncstream | ( | struct ast_filestream * | fs | ) |
fs | filestream to act on Returns 0 for success, or -1 for error |
Definition at line 680 of file file.c.
References ast_filestream::fmt, and ast_format::trunc.
Referenced by __ast_play_and_record(), and handle_recordfile().
int ast_waitstream | ( | struct ast_channel * | c, | |
const char * | breakon | |||
) |
c | channel to waitstream on | |
breakon | string of DTMF digits to break upon Begins playback of a stream... Wait for a stream to stop or for any one of a given digit to arrive, Returns 0 if the stream finishes, the character if it was interrupted, and -1 on error |
Definition at line 1086 of file file.c.
References waitstream_core().
Referenced by __login_exec(), agent_call(), app_exec(), ast_app_getdata(), ast_play_and_wait(), ast_say_date_da(), ast_say_date_de(), ast_say_date_en(), ast_say_date_fr(), ast_say_date_ge(), ast_say_date_gr(), ast_say_date_nl(), ast_say_date_with_format_gr(), ast_say_datetime_en(), ast_say_datetime_fr(), ast_say_datetime_from_now_en(), ast_say_datetime_from_now_fr(), ast_say_datetime_from_now_ge(), ast_say_datetime_gr(), ast_say_datetime_nl(), ast_say_datetime_pt(), ast_say_datetime_tw(), ast_say_enumeration_full_da(), ast_say_enumeration_full_de(), ast_say_enumeration_full_en(), ast_say_number_full_cz(), ast_say_number_full_da(), ast_say_number_full_de(), ast_say_number_full_en(), ast_say_number_full_en_GB(), ast_say_number_full_es(), ast_say_number_full_fr(), ast_say_number_full_ge(), ast_say_number_full_gr(), ast_say_number_full_he(), ast_say_number_full_it(), ast_say_number_full_nl(), ast_say_number_full_no(), ast_say_number_full_pt(), ast_say_number_full_ru(), ast_say_number_full_se(), ast_say_number_full_tw(), ast_say_time_de(), ast_say_time_en(), ast_say_time_ge(), ast_say_time_gr(), ast_say_time_nl(), ast_say_time_tw(), ast_stream_and_wait(), background_file(), check_availability(), check_beep(), common_exec(), conf_exec(), conf_run(), directory_exec(), gr_say_number_female(), handle_recordfile(), leave_voicemail(), page_exec(), park_exec(), parkandannounce_exec(), pbx_builtin_background(), pl_odtworz_plik(), play_and_wait(), play_file(), playback_exec(), privacy_exec(), retrydial_exec(), rpt_tele_thread(), s_streamwait3(), saycharstr(), sayfile(), saynum(), send_morse(), send_tone_telemetry(), ss_thread(), vm_authenticate(), and wait_file().
01087 { 01088 return waitstream_core(c, breakon, NULL, NULL, 0, -1, -1, NULL); 01089 }
int ast_waitstream_exten | ( | struct ast_channel * | c, | |
const char * | context | |||
) |
c | channel to waitstream on | |
context | string of context to match digits to break upon Begins playback of a stream... Wait for a stream to stop or for any one of a valid extension digit to arrive, Returns 0 if the stream finishes, the character if it was interrupted, and -1 on error |
Definition at line 1097 of file file.c.
References ast_channel::context, and waitstream_core().
Referenced by pbx_builtin_background().
01098 { 01099 /* Waitstream, with return in the case of a valid 1 digit extension */ 01100 /* in the current or specified context being pressed */ 01101 01102 if (!context) 01103 context = c->context; 01104 return waitstream_core(c, NULL, NULL, NULL, 0, 01105 -1, -1, context); 01106 }
int ast_waitstream_fr | ( | struct ast_channel * | c, | |
const char * | breakon, | |||
const char * | forward, | |||
const char * | rewind, | |||
int | ms | |||
) |
c | channel to waitstream on | |
breakon | string of DTMF digits to break upon | |
forward | DTMF digit to fast forward upon | |
rewind | DTMF digit to rewind upon | |
ms | How many miliseconds to skip forward/back Begins playback of a stream... Wait for a stream to stop or for any one of a given digit to arrive, Returns 0 if the stream finishes, the character if it was interrupted, and -1 on error |
Definition at line 1080 of file file.c.
References waitstream_core().
Referenced by ast_control_streamfile().
01081 { 01082 return waitstream_core(c, breakon, forward, rewind, ms, 01083 -1 /* no audiofd */, -1 /* no cmdfd */, NULL /* no context */); 01084 }
int ast_waitstream_full | ( | struct ast_channel * | c, | |
const char * | breakon, | |||
int | audiofd, | |||
int | monfd | |||
) |
Definition at line 1091 of file file.c.
References waitstream_core().
Referenced by ast_readstring_full(), ast_say_enumeration_full_da(), ast_say_enumeration_full_de(), ast_say_enumeration_full_en(), ast_say_number_full_cz(), ast_say_number_full_da(), ast_say_number_full_de(), ast_say_number_full_en(), ast_say_number_full_en_GB(), ast_say_number_full_es(), ast_say_number_full_fr(), ast_say_number_full_ge(), ast_say_number_full_gr(), ast_say_number_full_he(), ast_say_number_full_it(), ast_say_number_full_nl(), ast_say_number_full_no(), ast_say_number_full_pt(), ast_say_number_full_ru(), ast_say_number_full_se(), ast_say_number_full_tw(), handle_getoption(), handle_streamfile(), pl_odtworz_plik(), s_streamwait3(), say_character_str_full(), say_digit_str_full(), and say_phonetic_str_full().
01092 { 01093 return waitstream_core(c, breakon, NULL, NULL, 0, 01094 audiofd, cmdfd, NULL /* no context */); 01095 }
struct ast_filestream* ast_writefile | ( | const char * | filename, | |
const char * | type, | |||
const char * | comment, | |||
int | flags, | |||
int | check, | |||
mode_t | mode | |||
) |
filename | the name of the file to write to | |
type | format of file you wish to write out to | |
comment | comment to go with | |
flags | output file flags | |
check | (unimplemented, hence negligible) | |
mode | Open mode Create an outgoing file stream. oflags are flags for the open() command, and if check is non-zero, then it will not write a file if there are any files that start with that name and have an extension Please note, this is a blocking function. Program execution will not return until ast_waitstream completes it's execution. Returns a struct ast_filestream on success, NULL on failure |
Definition at line 853 of file file.c.
References ast_free, ast_log(), ast_opt_cache_record_files, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_strdupa, ast_filestream::buf, build_filename(), ast_format::exts, exts_compare(), f, ast_filestream::filename, ast_filestream::flags, ast_filestream::fmt, free, get_filestream(), LOG_WARNING, ast_filestream::mode, ast_filestream::realfilename, record_cache_dir, rewrite_wrapper(), ast_format::seek, strdup, ast_filestream::trans, and ast_filestream::vfs.
Referenced by __ast_play_and_record(), ast_monitor_start(), ast_writestream(), cli_audio_convert(), cli_audio_convert_deprecated(), dictate_exec(), handle_recordfile(), mixmonitor_thread(), and recordthread().
00854 { 00855 int fd, myflags = 0; 00856 /* compiler claims this variable can be used before initialization... */ 00857 FILE *bfile = NULL; 00858 struct ast_format *f; 00859 struct ast_filestream *fs = NULL; 00860 char *buf = NULL; 00861 size_t size = 0; 00862 int format_found = 0; 00863 00864 AST_RWLIST_RDLOCK(&formats); 00865 00866 /* set the O_TRUNC flag if and only if there is no O_APPEND specified */ 00867 /* We really can't use O_APPEND as it will break WAV header updates */ 00868 if (flags & O_APPEND) { 00869 flags &= ~O_APPEND; 00870 } else { 00871 myflags = O_TRUNC; 00872 } 00873 00874 myflags |= O_WRONLY | O_CREAT; 00875 00876 /* XXX need to fix this - we should just do the fopen, 00877 * not open followed by fdopen() 00878 */ 00879 AST_RWLIST_TRAVERSE(&formats, f, list) { 00880 char *fn, *orig_fn = NULL; 00881 if (fs) 00882 break; 00883 00884 if (!exts_compare(f->exts, type)) 00885 continue; 00886 else 00887 format_found = 1; 00888 00889 fn = build_filename(filename, type); 00890 fd = open(fn, flags | myflags, mode); 00891 if (fd > -1) { 00892 /* fdopen() the resulting file stream */ 00893 bfile = fdopen(fd, ((flags | myflags) & O_RDWR) ? "w+" : "w"); 00894 if (!bfile) { 00895 ast_log(LOG_WARNING, "Whoa, fdopen failed: %s!\n", strerror(errno)); 00896 close(fd); 00897 fd = -1; 00898 } 00899 } 00900 00901 if (ast_opt_cache_record_files && (fd > -1)) { 00902 char *c; 00903 00904 fclose(bfile); /* this also closes fd */ 00905 /* 00906 We touch orig_fn just as a place-holder so other things (like vmail) see the file is there. 00907 What we are really doing is writing to record_cache_dir until we are done then we will mv the file into place. 00908 */ 00909 orig_fn = ast_strdupa(fn); 00910 for (c = fn; *c; c++) 00911 if (*c == '/') 00912 *c = '_'; 00913 00914 size = strlen(fn) + strlen(record_cache_dir) + 2; 00915 buf = alloca(size); 00916 strcpy(buf, record_cache_dir); 00917 strcat(buf, "/"); 00918 strcat(buf, fn); 00919 free(fn); 00920 fn = buf; 00921 fd = open(fn, flags | myflags, mode); 00922 if (fd > -1) { 00923 /* fdopen() the resulting file stream */ 00924 bfile = fdopen(fd, ((flags | myflags) & O_RDWR) ? "w+" : "w"); 00925 if (!bfile) { 00926 ast_log(LOG_WARNING, "Whoa, fdopen failed: %s!\n", strerror(errno)); 00927 close(fd); 00928 fd = -1; 00929 } 00930 } 00931 } 00932 if (fd > -1) { 00933 errno = 0; 00934 fs = get_filestream(f, bfile); 00935 if (!fs || rewrite_wrapper(fs, comment)) { 00936 ast_log(LOG_WARNING, "Unable to rewrite %s\n", fn); 00937 close(fd); 00938 if (orig_fn) { 00939 unlink(fn); 00940 unlink(orig_fn); 00941 } 00942 if (fs) 00943 ast_free(fs); 00944 } 00945 fs->trans = NULL; 00946 fs->fmt = f; 00947 fs->flags = flags; 00948 fs->mode = mode; 00949 if (orig_fn) { 00950 fs->realfilename = strdup(orig_fn); 00951 fs->filename = strdup(fn); 00952 } else { 00953 fs->realfilename = NULL; 00954 fs->filename = strdup(filename); 00955 } 00956 fs->vfs = NULL; 00957 /* If truncated, we'll be at the beginning; if not truncated, then append */ 00958 f->seek(fs, 0, SEEK_END); 00959 } else if (errno != EEXIST) { 00960 ast_log(LOG_WARNING, "Unable to open file %s: %s\n", fn, strerror(errno)); 00961 if (orig_fn) 00962 unlink(orig_fn); 00963 } 00964 /* if buf != NULL then fn is already free and pointing to it */ 00965 if (!buf) 00966 free(fn); 00967 } 00968 00969 AST_RWLIST_UNLOCK(&formats); 00970 00971 if (!format_found) 00972 ast_log(LOG_WARNING, "No such format '%s'\n", type); 00973 00974 return fs; 00975 }
int ast_writestream | ( | struct ast_filestream * | fs, | |
struct ast_frame * | f | |||
) |
fs | filestream to write to | |
f | frame to write to the filestream Send a frame to a filestream -- note: does NOT free the frame, call ast_frfree manually Returns 0 on success, -1 on failure. |
Definition at line 148 of file file.c.
References AST_FORMAT_MAX_AUDIO, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_getformatname(), ast_log(), ast_translate(), ast_translator_build_path(), ast_translator_free_path(), ast_writefile(), ast_writestream(), f, ast_filestream::filename, ast_filestream::flags, ast_filestream::fmt, ast_format::format, ast_filestream::lastwriteformat, LOG_DEBUG, LOG_WARNING, ast_filestream::mode, ast_format::name, ast_filestream::trans, type, ast_filestream::vfs, and ast_format::write.
Referenced by __ast_play_and_record(), __ast_read(), ast_write(), ast_writestream(), cli_audio_convert(), cli_audio_convert_deprecated(), dictate_exec(), handle_recordfile(), mixmonitor_thread(), and recordthread().
00149 { 00150 int res = -1; 00151 int alt = 0; 00152 if (f->frametype == AST_FRAME_VIDEO) { 00153 if (fs->fmt->format < AST_FORMAT_MAX_AUDIO) { 00154 /* This is the audio portion. Call the video one... */ 00155 if (!fs->vfs && fs->filename) { 00156 const char *type = ast_getformatname(f->subclass & ~0x1); 00157 fs->vfs = ast_writefile(fs->filename, type, NULL, fs->flags, 0, fs->mode); 00158 ast_log(LOG_DEBUG, "Opened video output file\n"); 00159 } 00160 if (fs->vfs) 00161 return ast_writestream(fs->vfs, f); 00162 /* else ignore */ 00163 return 0; 00164 } else { 00165 /* Might / might not have mark set */ 00166 alt = 1; 00167 } 00168 } else if (f->frametype != AST_FRAME_VOICE) { 00169 ast_log(LOG_WARNING, "Tried to write non-voice frame\n"); 00170 return -1; 00171 } 00172 if (((fs->fmt->format | alt) & f->subclass) == f->subclass) { 00173 res = fs->fmt->write(fs, f); 00174 if (res < 0) 00175 ast_log(LOG_WARNING, "Natural write failed\n"); 00176 else if (res > 0) 00177 ast_log(LOG_WARNING, "Huh??\n"); 00178 } else { 00179 /* XXX If they try to send us a type of frame that isn't the normal frame, and isn't 00180 the one we've setup a translator for, we do the "wrong thing" XXX */ 00181 if (fs->trans && f->subclass != fs->lastwriteformat) { 00182 ast_translator_free_path(fs->trans); 00183 fs->trans = NULL; 00184 } 00185 if (!fs->trans) 00186 fs->trans = ast_translator_build_path(fs->fmt->format, f->subclass); 00187 if (!fs->trans) 00188 ast_log(LOG_WARNING, "Unable to translate to format %s, source format %s\n", 00189 fs->fmt->name, ast_getformatname(f->subclass)); 00190 else { 00191 struct ast_frame *trf; 00192 fs->lastwriteformat = f->subclass; 00193 /* Get the translated frame but don't consume the original in case they're using it on another stream */ 00194 trf = ast_translate(fs->trans, f, 0); 00195 if (trf) { 00196 res = fs->fmt->write(fs, trf); 00197 if (res) 00198 ast_log(LOG_WARNING, "Translated frame write failed\n"); 00199 } else 00200 res = 0; 00201 } 00202 } 00203 return res; 00204 }