Mon Oct 8 12:39:22 2012

Asterisk developer's documentation


file.h File Reference

Generic File Format Support. Should be included by clients of the file handling routines. File service providers should instead include mod_format.h. More...

#include <fcntl.h>
#include <sys/mman.h>

Go to the source code of this file.

Defines

#define AST_DIGIT_ANY   "0123456789#*ABCD"
#define AST_DIGIT_ANYNUM   "0123456789"
#define AST_MAX_FORMATS   10
#define AST_RESERVED_POINTERS   20
#define SEEK_FORCECUR   10

Functions

int ast_applystream (struct ast_channel *chan, struct ast_filestream *s)
 Applys a open stream to a channel.
int ast_closestream (struct ast_filestream *f)
 Closes a stream.
int ast_file_init (void)
int ast_filecopy (const char *oldname, const char *newname, const char *fmt)
 Copies a file.
int ast_filedelete (const char *filename, const char *fmt)
 Deletes a file.
int ast_fileexists (const char *filename, const char *fmt, const char *preflang)
 Checks for the existence of a given file.
int ast_filerename (const char *oldname, const char *newname, const char *fmt)
 Renames a file.
char * ast_format_str_reduce (char *fmts)
ast_filestreamast_openstream (struct ast_channel *chan, const char *filename, const char *preflang)
 Opens stream for use in seeking, playing.
ast_filestreamast_openstream_full (struct ast_channel *chan, const char *filename, const char *preflang, int asis)
 Opens stream for use in seeking, playing.
ast_filestreamast_openvstream (struct ast_channel *chan, const char *filename, const char *preflang)
 Opens stream for use in seeking, playing.
int ast_playstream (struct ast_filestream *s)
 Play a open stream on a channel.
ast_filestreamast_readfile (const char *filename, const char *type, const char *comment, int flags, int check, mode_t mode)
 Starts reading from a file.
ast_frameast_readframe (struct ast_filestream *s)
 Read a frame from a filestream.
int ast_seekstream (struct ast_filestream *fs, off_t sample_offset, int whence)
 Seeks into stream.
int ast_stopstream (struct ast_channel *c)
 Stops a stream.
int ast_stream_and_wait (struct ast_channel *chan, const char *file, const char *digits)
 stream file until digit If the file name is non-empty, try to play it.
int ast_stream_fastforward (struct ast_filestream *fs, off_t ms)
 Fast forward stream ms.
int ast_stream_rewind (struct ast_filestream *fs, off_t ms)
 Rewind stream ms.
int ast_streamfile (struct ast_channel *c, const char *filename, const char *preflang)
 Streams a file.
off_t ast_tellstream (struct ast_filestream *fs)
 Tell where we are in a stream.
int ast_truncstream (struct ast_filestream *fs)
 Trunc stream at current location.
int ast_waitstream (struct ast_channel *c, const char *breakon)
 Waits for a stream to stop or digit to be pressed.
int ast_waitstream_exten (struct ast_channel *c, const char *context)
 Waits for a stream to stop or digit matching a valid one digit exten to be pressed.
int ast_waitstream_fr (struct ast_channel *c, const char *breakon, const char *forward, const char *rewind, int ms)
 Same as waitstream but allows stream to be forwarded or rewound.
int ast_waitstream_full (struct ast_channel *c, const char *breakon, int audiofd, int monfd)
ast_filestreamast_writefile (const char *filename, const char *type, const char *comment, int flags, int check, mode_t mode)
 Starts writing a file.
int ast_writestream (struct ast_filestream *fs, struct ast_frame *f)
 Writes a frame to a stream.


Detailed Description

Generic File Format Support. Should be included by clients of the file handling routines. File service providers should instead include mod_format.h.

Definition in file file.h.


Define Documentation

#define AST_DIGIT_ANY   "0123456789#*ABCD"

Convenient for waiting

Definition at line 47 of file file.h.

Referenced by ast_ivr_menu_run_internal(), ast_play_and_wait(), ast_readstring_full(), ast_record_review(), bridge_playfile(), builtin_atxfer(), builtin_blindtransfer(), conf_exec(), conf_run(), dial_exec_full(), dictate_exec(), directory_exec(), feature_attended_transfer(), feature_blind_transfer(), festival_exec(), get_folder(), grab_transfer(), ivr_dispatch(), menu_callback(), 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(), sayname(), sayunixtime_exec(), select_item_menu(), select_item_seq(), vm_intro_gr(), vm_intro_he(), vm_intro_multilang(), vm_intro_pt(), vm_intro_pt_BR(), vmsayname_exec(), and wait_file2().

#define AST_DIGIT_ANYNUM   "0123456789"

Definition at line 48 of file file.h.

Referenced by initreqprep().

#define AST_MAX_FORMATS   10

The maximum number of formats we expect to see in a format string

Definition at line 44 of file file.h.

Referenced by __ast_play_and_record(), and ast_format_str_reduce().

#define AST_RESERVED_POINTERS   20

Definition at line 329 of file file.h.

#define SEEK_FORCECUR   10

Definition at line 50 of file file.h.

Referenced by __ast_read(), ast_write(), au_seek(), g719seek(), g729_seek(), gsm_seek(), ilbc_seek(), pcm_seek(), siren14seek(), siren7seek(), slinear_seek(), vox_seek(), and wav_seek().


Function Documentation

int ast_applystream ( struct ast_channel chan,
struct ast_filestream s 
)

Applys a open stream to a channel.

Parameters:
chan channel to work
s ast_filestream to apply
Return values:
0 on success.
-1 on failure.

Definition at line 864 of file file.c.

References ast_filestream::owner.

Referenced by ast_streamfile(), handle_getoption(), handle_recordfile(), handle_streamfile(), and speech_streamfile().

00865 {
00866    s->owner = chan;
00867    return 0;
00868 }

int ast_closestream ( struct ast_filestream f  ) 

Closes a stream.

Parameters:
f filestream to close Close a playback or recording stream
Return values:
0 on success.
-1 on failure.

Definition at line 907 of file file.c.

References ao2_ref, f, and filestream_close().

Referenced by ast_filehelper(), ast_hangup(), ast_moh_files_next(), ast_monitor_start(), ast_monitor_stop(), ast_readfile(), ast_stopstream(), ast_writefile(), dictate_exec(), filestream_destructor(), gen_closestream(), handle_cli_file_convert(), handle_recordfile(), local_ast_moh_stop(), mixmonitor_ds_close_fs(), and moh_files_release().

00908 {
00909    /* This used to destroy the filestream, but it now just decrements a refcount.
00910     * We close the stream in order to quit queuing frames now, because we might
00911     * change the writeformat, which could result in a subsequent write error, if
00912     * the format is different. */
00913    filestream_close(f);
00914    ao2_ref(f, -1);
00915    return 0;
00916 }

int ast_file_init ( void   ) 

Provided by file.c

Definition at line 1493 of file file.c.

References ARRAY_LEN, ast_cli_register_multiple(), and cli_file.

01494 {
01495    ast_cli_register_multiple(cli_file, ARRAY_LEN(cli_file));
01496    return 0;
01497 }

int ast_filecopy ( const char *  oldname,
const char *  newname,
const char *  fmt 
)

Copies a file.

Parameters:
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 946 of file file.c.

References ast_filehelper().

Referenced by copy_plain_file(), and vm_forwardoptions().

00947 {
00948    return ast_filehelper(filename, filename2, fmt, ACTION_COPY);
00949 }

int ast_filedelete ( const char *  filename,
const char *  fmt 
)

Deletes a file.

Parameters:
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 936 of file file.c.

References ACTION_DELETE, and ast_filehelper().

Referenced by announce_thread(), ast_monitor_start(), ast_monitor_stop(), conf_free(), dial_exec_full(), handle_cli_file_convert(), leave_voicemail(), play_record_review(), setup_privacy_args(), and vm_delete().

00937 {
00938    return ast_filehelper(filename, NULL, fmt, ACTION_DELETE);
00939 }

int ast_fileexists ( const char *  filename,
const char *  fmt,
const char *  preflang 
)

Checks for the existence of a given file.

Parameters:
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:
0 if file does not exist, non-zero positive otherwise.

Definition at line 922 of file file.c.

References ast_filestream::buf, and fileexists_core().

Referenced by announce_thread(), app_exec(), ast_moh_files_next(), ast_monitor_start(), ast_monitor_stop(), common_exec(), conf_run(), dial_exec_full(), eivr_comm(), forward_message(), get_folder(), invent_message(), leave_voicemail(), minivm_delete_exec(), play_file(), play_message(), play_message_callerid(), readexten_exec(), record_exec(), retrydial_exec(), say_character_str_full(), say_digit_str_full(), say_phonetic_str_full(), sayname(), setup_privacy_args(), vm_intro(), vm_newuser(), vm_options(), and vm_tempgreeting().

00923 {
00924    char *buf;
00925    int buflen;
00926 
00927    if (preflang == NULL)
00928       preflang = "";
00929    buflen = strlen(preflang) + strlen(filename) + 4;  /* room for everything */
00930    buf = alloca(buflen);
00931    if (buf == NULL)
00932       return 0;
00933    return fileexists_core(filename, fmt, preflang, buf, buflen);
00934 }

int ast_filerename ( const char *  oldname,
const char *  newname,
const char *  fmt 
)

Renames a file.

Parameters:
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 941 of file file.c.

References ACTION_RENAME, and ast_filehelper().

Referenced by ast_monitor_stop(), forward_message(), play_record_review(), rename_file(), and vm_forwardoptions().

00942 {
00943    return ast_filehelper(filename, filename2, fmt, ACTION_RENAME);
00944 }

char* ast_format_str_reduce ( char *  fmts  ) 

Parameters:
fmts a format string, this string will be modified
Return values:
NULL error
Returns:
a pointer to the reduced format string, this is a pointer to fmts

Definition at line 1377 of file file.c.

References ast_log(), AST_MAX_FORMATS, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_strdupa, ast_format::exts, exts_compare(), f, first, len(), ast_format::list, LOG_WARNING, strsep(), and type.

Referenced by actual_load_config().

01378 {
01379    struct ast_format *f;
01380    struct ast_format *fmts_ptr[AST_MAX_FORMATS];
01381    char *fmts_str[AST_MAX_FORMATS];
01382    char *stringp, *type;
01383    char *orig = fmts;
01384    int i, j, x, first, found = 0;
01385    int len = strlen(fmts) + 1;
01386    int res;
01387 
01388    if (AST_RWLIST_RDLOCK(&formats)) {
01389       ast_log(LOG_WARNING, "Unable to lock format list\n");
01390       return NULL;
01391    }
01392 
01393    stringp = ast_strdupa(fmts);
01394 
01395    for (x = 0; (type = strsep(&stringp, "|")) && x < AST_MAX_FORMATS; x++) {
01396       AST_RWLIST_TRAVERSE(&formats, f, list) {
01397          if (exts_compare(f->exts, type)) {
01398             found = 1;
01399             break;
01400          }
01401       }
01402 
01403       fmts_str[x] = type;
01404       if (found) {
01405          fmts_ptr[x] = f;
01406       } else {
01407          fmts_ptr[x] = NULL;
01408       }
01409    }
01410    AST_RWLIST_UNLOCK(&formats);
01411 
01412    first = 1;
01413    for (i = 0; i < x; i++) {
01414       /* ignore invalid entries */
01415       if (!fmts_ptr[i]) {
01416          ast_log(LOG_WARNING, "ignoring unknown format '%s'\n", fmts_str[i]);
01417          continue;
01418       }
01419 
01420       /* special handling for the first entry */
01421       if (first) {
01422          res = snprintf(fmts, len, "%s", fmts_str[i]);
01423          fmts += res;
01424          len -= res;
01425          first = 0;
01426          continue;
01427       }
01428 
01429       found = 0;
01430       for (j = 0; j < i; j++) {
01431          /* this is a duplicate */
01432          if (fmts_ptr[j] == fmts_ptr[i]) {
01433             found = 1;
01434             break;
01435          }
01436       }
01437 
01438       if (!found) {
01439          res = snprintf(fmts, len, "|%s", fmts_str[i]);
01440          fmts += res;
01441          len -= res;
01442       }
01443    }
01444 
01445    if (first) {
01446       ast_log(LOG_WARNING, "no known formats found in format list (%s)\n", orig);
01447       return NULL;
01448    }
01449 
01450    return orig;
01451 }

struct ast_filestream* ast_openstream ( struct ast_channel chan,
const char *  filename,
const char *  preflang 
)

Opens stream for use in seeking, playing.

Parameters:
chan channel to work with
filename to use
preflang prefered language to use
Return values:
a ast_filestream pointer if it opens the file.
NULL on error.

Definition at line 635 of file file.c.

References ast_openstream_full().

Referenced by ast_streamfile(), dictate_exec(), handle_getoption(), handle_streamfile(), and speech_streamfile().

00636 {
00637    return ast_openstream_full(chan, filename, preflang, 0);
00638 }

struct ast_filestream* ast_openstream_full ( struct ast_channel chan,
const char *  filename,
const char *  preflang,
int  asis 
)

Opens stream for use in seeking, playing.

Parameters:
chan channel to work with
filename to use
preflang prefered language to use
asis if set, don't clear generators
Return values:
a ast_filestream pointer if it opens the file.
NULL on error.

Definition at line 640 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_openstream(), and gen_nextfile().

00641 {
00642    /* 
00643     * Use fileexists_core() to find a file in a compatible
00644     * language and format, set up a suitable translator,
00645     * and open the stream.
00646     */
00647    format_t fmts, res;
00648    int buflen;
00649    char *buf;
00650 
00651    if (!asis) {
00652       /* do this first, otherwise we detect the wrong writeformat */
00653       ast_stopstream(chan);
00654       if (chan->generator)
00655          ast_deactivate_generator(chan);
00656    }
00657    if (preflang == NULL)
00658       preflang = "";
00659    buflen = strlen(preflang) + strlen(filename) + 4;
00660    buf = alloca(buflen);
00661    if (buf == NULL)
00662       return NULL;
00663    fmts = fileexists_core(filename, NULL, preflang, buf, buflen);
00664    if (fmts > 0)
00665       fmts &= AST_FORMAT_AUDIO_MASK;
00666    if (fmts < 1) {
00667       ast_log(LOG_WARNING, "File %s does not exist in any format\n", filename);
00668       return NULL;
00669    }
00670    chan->oldwriteformat = chan->writeformat;
00671    /* Set the channel to a format we can work with */
00672    res = ast_set_write_format(chan, fmts);
00673    if (res == -1) {  /* No format available that works with this channel */
00674       return NULL;
00675    }
00676    res = ast_filehelper(buf, chan, NULL, ACTION_OPEN);
00677    if (res >= 0)
00678       return chan->stream;
00679    return NULL;
00680 }

struct ast_filestream* ast_openvstream ( struct ast_channel chan,
const char *  filename,
const char *  preflang 
)

Opens stream for use in seeking, playing.

Parameters:
chan channel to work with
filename to use
preflang prefered language to use
Return values:
a ast_filestream pointer if it opens the file.
NULL on error.

Definition at line 682 of file file.c.

References ACTION_OPEN, ast_filehelper(), AST_FORMAT_FIRST_VIDEO_BIT, AST_FORMAT_VIDEO_MASK, ast_getformatname(), ast_log(), ast_filestream::buf, fileexists_core(), ast_filestream::fmt, format, LOG_WARNING, ast_channel::nativeformats, and ast_channel::vstream.

Referenced by ast_streamfile(), handle_getoption(), and handle_streamfile().

00683 {
00684    /* As above, but for video. But here we don't have translators
00685     * so we must enforce a format.
00686     */
00687    format_t format;
00688    char *buf;
00689    int buflen;
00690 
00691    if (preflang == NULL)
00692       preflang = "";
00693    buflen = strlen(preflang) + strlen(filename) + 4;
00694    buf = alloca(buflen);
00695    if (buf == NULL)
00696       return NULL;
00697 
00698    for (format = AST_FORMAT_FIRST_VIDEO_BIT; format <= AST_FORMAT_VIDEO_MASK; format = format << 1) {
00699       int fd;
00700       const char *fmt;
00701 
00702       if (!(chan->nativeformats & format))
00703          continue;
00704       fmt = ast_getformatname(format);
00705       if ( fileexists_core(filename, fmt, preflang, buf, buflen) < 1)   /* no valid format */
00706          continue;
00707       fd = ast_filehelper(buf, chan, fmt, ACTION_OPEN);
00708       if (fd >= 0)
00709          return chan->vstream;
00710       ast_log(LOG_WARNING, "File %s has video but couldn't be opened\n", filename);
00711    }
00712    return NULL;
00713 }

int ast_playstream ( struct ast_filestream s  ) 

Play a open stream on a channel.

Parameters:
s filestream to play
Return values:
0 on success.
-1 on failure.

Definition at line 870 of file file.c.

References AST_FORMAT_AUDIO_MASK, ast_readaudio_callback(), ast_readvideo_callback(), ast_filestream::fmt, ast_format::format, and FSREAD_FAILURE.

Referenced by ast_streamfile(), handle_getoption(), handle_streamfile(), and speech_streamfile().

00871 {
00872    enum fsread_res res;
00873 
00874    if (s->fmt->format & AST_FORMAT_AUDIO_MASK)
00875       res = ast_readaudio_callback(s);
00876    else
00877       res = ast_readvideo_callback(s);
00878 
00879    return (res == FSREAD_FAILURE) ? -1 : 0;
00880 }

struct ast_filestream* ast_readfile ( const char *  filename,
const char *  type,
const char *  comment,
int  flags,
int  check,
mode_t  mode 
)

Starts reading from a file.

Parameters:
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.
Return values:
a struct ast_filestream on success.
NULL on failure.

Definition at line 1001 of file file.c.

References ast_closestream(), ast_free, ast_log(), AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_strdup, build_filename(), errno, ast_format::exts, exts_compare(), f, ast_filestream::filename, ast_filestream::flags, ast_filestream::fmt, get_filestream(), LOG_WARNING, ast_filestream::mode, open_wrapper(), ast_filestream::trans, and ast_filestream::vfs.

Referenced by handle_cli_file_convert().

01002 {
01003    FILE *bfile;
01004    struct ast_format *f;
01005    struct ast_filestream *fs = NULL;
01006    char *fn;
01007    int format_found = 0;   
01008 
01009    AST_RWLIST_RDLOCK(&formats);
01010 
01011    AST_RWLIST_TRAVERSE(&formats, f, list) {
01012       fs = NULL;
01013       if (!exts_compare(f->exts, type))
01014          continue;
01015       else 
01016          format_found = 1;
01017 
01018       fn = build_filename(filename, type);
01019       errno = 0;
01020       bfile = fopen(fn, "r");
01021 
01022       if (!bfile || (fs = get_filestream(f, bfile)) == NULL || open_wrapper(fs) ) {
01023          ast_log(LOG_WARNING, "Unable to open %s\n", fn);
01024          if (fs) {
01025             ast_closestream(fs);
01026          }
01027          fs = NULL;
01028          bfile = NULL;
01029          ast_free(fn);
01030          break;            
01031       }
01032       /* found it */
01033       fs->trans = NULL;
01034       fs->fmt = f;
01035       fs->flags = flags;
01036       fs->mode = mode;
01037       fs->filename = ast_strdup(filename);
01038       fs->vfs = NULL;
01039       break;
01040    }
01041 
01042    AST_RWLIST_UNLOCK(&formats);
01043    if (!format_found)
01044       ast_log(LOG_WARNING, "No such format '%s'\n", type);
01045 
01046    return fs;
01047 }

struct ast_frame* ast_readframe ( struct ast_filestream s  ) 

Read a frame from a filestream.

Parameters:
s ast_filestream to act on
Returns:
a frame.
Return values:
NULL if read failed.

Definition at line 740 of file file.c.

References read_frame().

Referenced by dictate_exec(), gen_readframe(), handle_cli_file_convert(), and moh_files_readframe().

00741 {
00742    int whennext = 0;
00743 
00744    return read_frame(s, &whennext);
00745 }

int ast_seekstream ( struct ast_filestream fs,
off_t  sample_offset,
int  whence 
)

Seeks into stream.

Parameters:
fs ast_filestream to perform seek on
sample_offset numbers of samples to seek
whence SEEK_SET, SEEK_CUR, SEEK_END
Return values:
0 on success.
-1 on failure.

Definition at line 882 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_streamfile(), ast_write(), dictate_exec(), handle_getoption(), handle_recordfile(), handle_streamfile(), and speech_streamfile().

00883 {
00884    return fs->fmt->seek(fs, sample_offset, whence);
00885 }

int ast_stopstream ( struct ast_channel c  ) 

Stops a stream.

Parameters:
c The channel you wish to stop playback on
Stop playback of a stream

Return values:
0 always
Note:
The channel does not need to be locked before calling this function.

Definition at line 128 of file file.c.

References ast_channel_lock, ast_channel_unlock, ast_closestream(), ast_getformatname(), ast_log(), ast_set_write_format(), LOG_WARNING, ast_channel::oldwriteformat, ast_channel::stream, and ast_channel::vstream.

Referenced by adsi_transmit_message_full(), 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_enumeration_full_he(), ast_say_enumeration_full_vi(), ast_say_number_full_cs(), 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_gr(), ast_say_number_full_he(), ast_say_number_full_hu(), ast_say_number_full_it(), ast_say_number_full_ka(), 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_th(), ast_say_number_full_ur(), ast_say_number_full_vi(), ast_say_number_full_zh(), background_detect_exec(), conf_exec(), conf_run(), dial_exec_full(), directory_exec(), grab_transfer(), handle_getoption(), handle_speechrecognize(), handle_streamfile(), ices_exec(), ivr_dispatch(), menu_callback(), minivm_greet_exec(), mp3_exec(), NBScat_exec(), parkandannounce_exec(), pbx_builtin_background(), pl_odtworz_plik(), play_file(), play_mailbox_owner(), playback_exec(), read_exec(), readexten_exec(), recordthread(), s_streamwait3(), say_character_str_full(), say_digit_str_full(), say_phonetic_str_full(), select_item_seq(), send_waveform_to_channel(), speech_background(), vm_authenticate(), vm_execmain(), wait_for_winner(), waitstream_core(), and zapateller_exec().

00129 {
00130    ast_channel_lock(tmp);
00131 
00132    /* Stop a running stream if there is one */
00133    if (tmp->stream) {
00134       ast_closestream(tmp->stream);
00135       tmp->stream = NULL;
00136       if (tmp->oldwriteformat && ast_set_write_format(tmp, tmp->oldwriteformat))
00137          ast_log(LOG_WARNING, "Unable to restore format back to %s\n", ast_getformatname(tmp->oldwriteformat));
00138    }
00139    /* Stop the video stream too */
00140    if (tmp->vstream != NULL) {
00141       ast_closestream(tmp->vstream);
00142       tmp->vstream = NULL;
00143    }
00144 
00145    ast_channel_unlock(tmp);
00146 
00147    return 0;
00148 }

int ast_stream_and_wait ( struct ast_channel chan,
const char *  file,
const char *  digits 
)

stream file until digit If the file name is non-empty, try to play it.

Note:
If digits == "" then we can simply check for non-zero.
Returns:
0 if success.
Return values:
-1 if error.
digit if interrupted by a digit.

Definition at line 1364 of file file.c.

References ast_streamfile(), ast_strlen_zero(), ast_test_suite_event_notify, ast_waitstream(), and ast_channel::language.

Referenced by __ast_play_and_record(), announce_user_count(), app_exec(), ast_pickup_call(), ast_record_review(), bridge_playfile(), builtin_atxfer(), builtin_automixmonitor(), builtin_blindtransfer(), confbridge_exec(), directory_exec(), feature_attended_transfer(), feature_blind_transfer(), forward_message(), grab_transfer(), invent_message(), ivr_dispatch(), join_conference_bridge(), masq_park_call(), menu_callback(), park_call_exec(), parked_call_exec(), play_mailbox_owner(), play_message_callerid(), play_message_on_chan(), play_prompt_to_channel(), play_record_review(), play_sound_file(), sayname(), select_item_seq(), vm_forwardoptions(), vmsayname_exec(), wait_file2(), and xfer_park_call_helper().

01365 {
01366    int res = 0;
01367    if (!ast_strlen_zero(file)) {
01368       ast_test_suite_event_notify("PLAYBACK", "Message: %s", file);
01369       res = ast_streamfile(chan, file, chan->language);
01370       if (!res) {
01371          res = ast_waitstream(chan, digits);
01372       }
01373    }
01374    return res;
01375 } 

int ast_stream_fastforward ( struct ast_filestream fs,
off_t  ms 
)

Fast forward stream ms.

Parameters:
fs filestream to act on
ms milliseconds to move
Return values:
0 on success.
-1 on failure.

Definition at line 897 of file file.c.

References ast_seekstream(), and DEFAULT_SAMPLES_PER_MS.

Referenced by waitstream_core().

00898 {
00899    return ast_seekstream(fs, ms * DEFAULT_SAMPLES_PER_MS, SEEK_CUR);
00900 }

int ast_stream_rewind ( struct ast_filestream fs,
off_t  ms 
)

Rewind stream ms.

Parameters:
fs filestream to act on
ms milliseconds to move
Return values:
0 on success.
-1 on failure.

Definition at line 902 of file file.c.

References ast_seekstream(), and DEFAULT_SAMPLES_PER_MS.

Referenced by handle_recordfile(), and waitstream_core().

00903 {
00904    return ast_seekstream(fs, -ms * DEFAULT_SAMPLES_PER_MS, SEEK_CUR);
00905 }

int ast_streamfile ( struct ast_channel c,
const char *  filename,
const char *  preflang 
)

Streams a file.

Parameters:
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.
Return values:
0 on success.
-1 on failure.

Definition at line 951 of file file.c.

References ast_applystream(), ast_debug, AST_FLAG_MASQ_NOSTREAM, ast_getformatname(), ast_getformatname_multiple(), ast_log(), ast_openstream(), ast_openvstream(), ast_playstream(), ast_seekstream(), ast_strdup, ast_test_flag, ast_verb, errno, ast_filestream::f, ast_filestream::fmt, ast_format::format, LOG_WARNING, ast_channel::name, ast_channel::nativeformats, ast_filestream::orig_chan_name, ast_filestream::vfs, and ast_channel::writeformat.

Referenced by __analog_ss_thread(), action_bridge(), agent_call(), analog_ss_thread(), announce_thread(), 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_gr(), ast_say_date_he(), ast_say_date_hu(), ast_say_date_ka(), ast_say_date_nl(), ast_say_date_th(), 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_he(), ast_say_datetime_from_now_ka(), ast_say_datetime_gr(), ast_say_datetime_he(), ast_say_datetime_nl(), ast_say_datetime_pt(), ast_say_datetime_th(), ast_say_datetime_zh(), ast_say_enumeration_full_da(), ast_say_enumeration_full_de(), ast_say_enumeration_full_en(), ast_say_enumeration_full_he(), ast_say_enumeration_full_vi(), ast_say_number_full_cs(), 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_gr(), ast_say_number_full_he(), ast_say_number_full_hu(), ast_say_number_full_it(), ast_say_number_full_ka(), 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_th(), ast_say_number_full_ur(), ast_say_number_full_vi(), ast_say_number_full_zh(), ast_say_time_de(), ast_say_time_en(), ast_say_time_fr(), ast_say_time_gr(), ast_say_time_hu(), ast_say_time_ka(), ast_say_time_nl(), ast_say_time_zh(), ast_stream_and_wait(), background_detect_exec(), bridge_exec(), check_availability(), check_beep(), common_exec(), conf_exec(), conf_run(), dial_exec_full(), do_directory(), find_conf_realtime(), forward_message(), gr_say_number_female(), handle_recordfile(), invent_message(), leave_voicemail(), local_attended_transfer(), login_exec(), menu_callback(), minivm_greet_exec(), parkandannounce_exec(), pbx_builtin_background(), pl_odtworz_plik(), play_and_wait(), play_file(), play_record_review(), playback_exec(), privacy_exec(), readexten_exec(), retrydial_exec(), s_streamwait3(), say_character_str_full(), say_digit_str_full(), say_phonetic_str_full(), select_item_menu(), setup_privacy_args(), vm_authenticate(), wait_file(), and wait_for_winner().

00952 {
00953    struct ast_filestream *fs;
00954    struct ast_filestream *vfs=NULL;
00955    char fmt[256];
00956    off_t pos;
00957    int seekattempt;
00958    int res;
00959 
00960    fs = ast_openstream(chan, filename, preflang);
00961    if (!fs) {
00962       ast_log(LOG_WARNING, "Unable to open %s (format %s): %s\n", filename, ast_getformatname_multiple(fmt, sizeof(fmt), chan->nativeformats), strerror(errno));
00963       return -1;
00964    }
00965 
00966    /* check to see if there is any data present (not a zero length file),
00967     * done this way because there is no where for ast_openstream_full to
00968     * return the file had no data. */
00969    pos = ftello(fs->f);
00970    seekattempt = fseeko(fs->f, -1, SEEK_END);
00971    if (seekattempt) {
00972       if (errno == EINVAL) {
00973          /* Zero-length file, as opposed to a pipe */
00974          return 0;
00975       } else {
00976          ast_seekstream(fs, 0, SEEK_SET);
00977       }
00978    } else {
00979       fseeko(fs->f, pos, SEEK_SET);
00980    }
00981 
00982    vfs = ast_openvstream(chan, filename, preflang);
00983    if (vfs) {
00984       ast_debug(1, "Ooh, found a video stream, too, format %s\n", ast_getformatname(vfs->fmt->format));
00985    }
00986 
00987    if (ast_test_flag(chan, AST_FLAG_MASQ_NOSTREAM))
00988       fs->orig_chan_name = ast_strdup(chan->name);
00989    if (ast_applystream(chan, fs))
00990       return -1;
00991    if (vfs && ast_applystream(chan, vfs))
00992       return -1;
00993    res = ast_playstream(fs);
00994    if (!res && vfs)
00995       res = ast_playstream(vfs);
00996    ast_verb(3, "<%s> Playing '%s.%s' (language '%s')\n", chan->name, filename, ast_getformatname(chan->writeformat), preflang ? preflang : "default");
00997 
00998    return res;
00999 }

off_t ast_tellstream ( struct ast_filestream fs  ) 

Tell where we are in a stream.

Parameters:
fs fs to act on
Returns:
a long as a sample offset into stream

Definition at line 892 of file file.c.

References ast_filestream::fmt, and ast_format::tell.

Referenced by ast_control_streamfile(), handle_getoption(), handle_recordfile(), handle_speechrecognize(), and handle_streamfile().

00893 {
00894    return fs->fmt->tell(fs);
00895 }

int ast_truncstream ( struct ast_filestream fs  ) 

Trunc stream at current location.

Parameters:
fs filestream to act on
Return values:
0 on success.
-1 on failure.

Definition at line 887 of file file.c.

References ast_filestream::fmt, and ast_format::trunc.

Referenced by handle_recordfile().

00888 {
00889    return fs->fmt->trunc(fs);
00890 }

int ast_waitstream ( struct ast_channel c,
const char *  breakon 
)

Waits for a stream to stop or digit to be pressed.

Parameters:
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,
Return values:
0 if the stream finishes
the character if it was interrupted,
-1 on error

Definition at line 1337 of file file.c.

References waitstream_core().

Referenced by __analog_ss_thread(), action_bridge(), agent_call(), analog_ss_thread(), announce_thread(), app_exec(), ast_play_and_wait(), ast_say_date_da(), ast_say_date_de(), ast_say_date_en(), ast_say_date_fr(), ast_say_date_gr(), ast_say_date_he(), ast_say_date_hu(), ast_say_date_ka(), ast_say_date_nl(), ast_say_date_th(), 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_he(), ast_say_datetime_from_now_ka(), ast_say_datetime_gr(), ast_say_datetime_he(), ast_say_datetime_nl(), ast_say_datetime_pt(), ast_say_datetime_th(), ast_say_datetime_zh(), ast_say_enumeration_full_da(), ast_say_enumeration_full_de(), ast_say_enumeration_full_en(), ast_say_enumeration_full_he(), ast_say_enumeration_full_vi(), ast_say_number_full_cs(), 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_gr(), ast_say_number_full_he(), ast_say_number_full_hu(), ast_say_number_full_it(), ast_say_number_full_ka(), 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_th(), ast_say_number_full_ur(), ast_say_number_full_vi(), ast_say_number_full_zh(), ast_say_time_de(), ast_say_time_en(), ast_say_time_gr(), ast_say_time_he(), ast_say_time_hu(), ast_say_time_ka(), ast_say_time_nl(), ast_say_time_zh(), ast_stream_and_wait(), bridge_exec(), check_availability(), check_beep(), common_exec(), conf_exec(), conf_run(), directory_exec(), find_conf_realtime(), gr_say_number_female(), handle_recordfile(), invent_message(), leave_voicemail(), local_attended_transfer(), login_exec(), menu_callback(), minivm_greet_exec(), parkandannounce_exec(), pbx_builtin_background(), pl_odtworz_plik(), play_and_wait(), play_file(), play_record_review(), playback_exec(), privacy_exec(), retrydial_exec(), s_streamwait3(), say_character_str_full(), say_digit_str_full(), say_phonetic_str_full(), select_item_menu(), setup_privacy_args(), vm_authenticate(), and wait_file().

01338 {
01339    return waitstream_core(c, breakon, NULL, NULL, 0, -1, -1, NULL);
01340 }

int ast_waitstream_exten ( struct ast_channel c,
const char *  context 
)

Waits for a stream to stop or digit matching a valid one digit exten to be pressed.

Parameters:
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,
Return values:
0 if the stream finishes.
the character if it was interrupted.
-1 on error.

Definition at line 1348 of file file.c.

References ast_channel::context, and waitstream_core().

Referenced by pbx_builtin_background().

01349 {
01350    /* Waitstream, with return in the case of a valid 1 digit extension */
01351    /* in the current or specified context being pressed */
01352 
01353    if (!context)
01354       context = c->context;
01355    return waitstream_core(c, NULL, NULL, NULL, 0,
01356       -1, -1, context);
01357 }

int ast_waitstream_fr ( struct ast_channel c,
const char *  breakon,
const char *  forward,
const char *  rewind,
int  ms 
)

Same as waitstream but allows stream to be forwarded or rewound.

Parameters:
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,
Return values:
0 if the stream finishes.
the character if it was interrupted.
-1 on error.

Definition at line 1331 of file file.c.

References waitstream_core().

Referenced by ast_control_streamfile().

01332 {
01333    return waitstream_core(c, breakon, forward, reverse, ms,
01334       -1 /* no audiofd */, -1 /* no cmdfd */, NULL /* no context */);
01335 }

int ast_waitstream_full ( struct ast_channel c,
const char *  breakon,
int  audiofd,
int  monfd 
)

Same as waitstream, but with audio output to fd and monitored fd checking.

Returns:
1 if monfd is ready for reading

Definition at line 1342 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_enumeration_full_he(), ast_say_enumeration_full_vi(), ast_say_number_full_cs(), 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_gr(), ast_say_number_full_he(), ast_say_number_full_hu(), ast_say_number_full_it(), ast_say_number_full_ka(), 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_th(), ast_say_number_full_ur(), ast_say_number_full_vi(), ast_say_number_full_zh(), handle_getoption(), handle_streamfile(), pl_odtworz_plik(), s_streamwait3(), say_character_str_full(), say_digit_str_full(), and say_phonetic_str_full().

01343 {
01344    return waitstream_core(c, breakon, NULL, NULL, 0,
01345       audiofd, cmdfd, NULL /* no context */);
01346 }

struct ast_filestream* ast_writefile ( const char *  filename,
const char *  type,
const char *  comment,
int  flags,
int  check,
mode_t  mode 
)

Starts writing a file.

Parameters:
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.
Return values:
a struct ast_filestream on success.
NULL on failure.

Definition at line 1049 of file file.c.

References ast_closestream(), ast_free, ast_log(), ast_malloc, ast_opt_cache_record_files, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_strdup, ast_strdupa, ast_filestream::buf, build_filename(), errno, ast_format::exts, exts_compare(), f, ast_filestream::f, ast_filestream::filename, ast_filestream::flags, ast_filestream::fmt, get_filestream(), LOG_WARNING, ast_filestream::mode, ast_filestream::realfilename, record_cache_dir, rewrite_wrapper(), ast_format::seek, ast_filestream::trans, ast_filestream::vfs, and ast_filestream::write_buffer.

Referenced by __ast_play_and_record(), ast_monitor_start(), ast_writestream(), dictate_exec(), handle_cli_file_convert(), handle_recordfile(), mixmonitor_thread(), and recordthread().

01050 {
01051    int fd, myflags = 0;
01052    /* compiler claims this variable can be used before initialization... */
01053    FILE *bfile = NULL;
01054    struct ast_format *f;
01055    struct ast_filestream *fs = NULL;
01056    char *buf = NULL;
01057    size_t size = 0;
01058    int format_found = 0;
01059 
01060    AST_RWLIST_RDLOCK(&formats);
01061 
01062    /* set the O_TRUNC flag if and only if there is no O_APPEND specified */
01063    /* We really can't use O_APPEND as it will break WAV header updates */
01064    if (flags & O_APPEND) { 
01065       flags &= ~O_APPEND;
01066    } else {
01067       myflags = O_TRUNC;
01068    }
01069    
01070    myflags |= O_WRONLY | O_CREAT;
01071 
01072    /* XXX need to fix this - we should just do the fopen,
01073     * not open followed by fdopen()
01074     */
01075    AST_RWLIST_TRAVERSE(&formats, f, list) {
01076       char *fn, *orig_fn = NULL;
01077       if (fs)
01078          break;
01079 
01080       if (!exts_compare(f->exts, type))
01081          continue;
01082       else
01083          format_found = 1;
01084 
01085       fn = build_filename(filename, type);
01086       fd = open(fn, flags | myflags, mode);
01087       if (fd > -1) {
01088          /* fdopen() the resulting file stream */
01089          bfile = fdopen(fd, ((flags | myflags) & O_RDWR) ? "w+" : "w");
01090          if (!bfile) {
01091             ast_log(LOG_WARNING, "Whoa, fdopen failed: %s!\n", strerror(errno));
01092             close(fd);
01093             fd = -1;
01094          }
01095       }
01096       
01097       if (ast_opt_cache_record_files && (fd > -1)) {
01098          char *c;
01099 
01100          fclose(bfile); /* this also closes fd */
01101          /*
01102            We touch orig_fn just as a place-holder so other things (like vmail) see the file is there.
01103            What we are really doing is writing to record_cache_dir until we are done then we will mv the file into place.
01104          */
01105          orig_fn = ast_strdupa(fn);
01106          for (c = fn; *c; c++)
01107             if (*c == '/')
01108                *c = '_';
01109 
01110          size = strlen(fn) + strlen(record_cache_dir) + 2;
01111          buf = alloca(size);
01112          strcpy(buf, record_cache_dir);
01113          strcat(buf, "/");
01114          strcat(buf, fn);
01115          ast_free(fn);
01116          fn = buf;
01117          fd = open(fn, flags | myflags, mode);
01118          if (fd > -1) {
01119             /* fdopen() the resulting file stream */
01120             bfile = fdopen(fd, ((flags | myflags) & O_RDWR) ? "w+" : "w");
01121             if (!bfile) {
01122                ast_log(LOG_WARNING, "Whoa, fdopen failed: %s!\n", strerror(errno));
01123                close(fd);
01124                fd = -1;
01125             }
01126          }
01127       }
01128       if (fd > -1) {
01129          errno = 0;
01130          fs = get_filestream(f, bfile);
01131          if (fs) {
01132             if ((fs->write_buffer = ast_malloc(32768))) {
01133                setvbuf(fs->f, fs->write_buffer, _IOFBF, 32768);
01134             }
01135          }
01136          if (!fs || rewrite_wrapper(fs, comment)) {
01137             ast_log(LOG_WARNING, "Unable to rewrite %s\n", fn);
01138             close(fd);
01139             if (orig_fn) {
01140                unlink(fn);
01141                unlink(orig_fn);
01142             }
01143             if (fs) {
01144                ast_closestream(fs);
01145                fs = NULL;
01146             }
01147             continue;
01148          }
01149          fs->trans = NULL;
01150          fs->fmt = f;
01151          fs->flags = flags;
01152          fs->mode = mode;
01153          if (orig_fn) {
01154             fs->realfilename = ast_strdup(orig_fn);
01155             fs->filename = ast_strdup(fn);
01156          } else {
01157             fs->realfilename = NULL;
01158             fs->filename = ast_strdup(filename);
01159          }
01160          fs->vfs = NULL;
01161          /* If truncated, we'll be at the beginning; if not truncated, then append */
01162          f->seek(fs, 0, SEEK_END);
01163       } else if (errno != EEXIST) {
01164          ast_log(LOG_WARNING, "Unable to open file %s: %s\n", fn, strerror(errno));
01165          if (orig_fn)
01166             unlink(orig_fn);
01167       }
01168       /* if buf != NULL then fn is already free and pointing to it */
01169       if (!buf)
01170          ast_free(fn);
01171    }
01172 
01173    AST_RWLIST_UNLOCK(&formats);
01174 
01175    if (!format_found)
01176       ast_log(LOG_WARNING, "No such format '%s'\n", type);
01177 
01178    return fs;
01179 }

int ast_writestream ( struct ast_filestream fs,
struct ast_frame f 
)

Writes a frame to a stream.

Parameters:
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
Return values:
0 on success.
-1 on failure.

Definition at line 150 of file file.c.

References ast_debug, AST_FORMAT_AUDIO_MASK, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_frfree, ast_getformatname(), AST_LIST_NEXT, 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_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(), dictate_exec(), handle_cli_file_convert(), handle_recordfile(), mixmonitor_thread(), and recordthread().

00151 {
00152    int res = -1;
00153    int alt = 0;
00154    if (f->frametype == AST_FRAME_VIDEO) {
00155       if (fs->fmt->format & AST_FORMAT_AUDIO_MASK) {
00156          /* This is the audio portion.  Call the video one... */
00157          if (!fs->vfs && fs->filename) {
00158             const char *type = ast_getformatname(f->subclass.codec & ~0x1);
00159             fs->vfs = ast_writefile(fs->filename, type, NULL, fs->flags, 0, fs->mode);
00160             ast_debug(1, "Opened video output file\n");
00161          }
00162          if (fs->vfs)
00163             return ast_writestream(fs->vfs, f);
00164          /* else ignore */
00165          return 0;            
00166       } else {
00167          /* Might / might not have mark set */
00168          alt = 1;
00169       }
00170    } else if (f->frametype != AST_FRAME_VOICE) {
00171       ast_log(LOG_WARNING, "Tried to write non-voice frame\n");
00172       return -1;
00173    }
00174    if (((fs->fmt->format | alt) & f->subclass.codec) == f->subclass.codec) {
00175       res =  fs->fmt->write(fs, f);
00176       if (res < 0) 
00177          ast_log(LOG_WARNING, "Natural write failed\n");
00178       else if (res > 0)
00179          ast_log(LOG_WARNING, "Huh??\n");
00180    } else {
00181       /* XXX If they try to send us a type of frame that isn't the normal frame, and isn't
00182              the one we've setup a translator for, we do the "wrong thing" XXX */
00183       if (fs->trans && f->subclass.codec != fs->lastwriteformat) {
00184          ast_translator_free_path(fs->trans);
00185          fs->trans = NULL;
00186       }
00187       if (!fs->trans) 
00188          fs->trans = ast_translator_build_path(fs->fmt->format, f->subclass.codec);
00189       if (!fs->trans)
00190          ast_log(LOG_WARNING, "Unable to translate to format %s, source format %s\n",
00191             fs->fmt->name, ast_getformatname(f->subclass.codec));
00192       else {
00193          struct ast_frame *trf;
00194          fs->lastwriteformat = f->subclass.codec;
00195          /* Get the translated frame but don't consume the original in case they're using it on another stream */
00196          if ((trf = ast_translate(fs->trans, f, 0))) {
00197             struct ast_frame *cur;
00198 
00199             /* the translator may have returned multiple frames, so process them */
00200             for (cur = trf; cur; cur = AST_LIST_NEXT(cur, frame_list)) {
00201                if ((res = fs->fmt->write(fs, trf))) {
00202                   ast_log(LOG_WARNING, "Translated frame write failed\n");
00203                   break;
00204                }
00205             }
00206             ast_frfree(trf);
00207          } else {
00208             res = 0;
00209          }
00210       }
00211    }
00212    return res;
00213 }


Generated on Mon Oct 8 12:39:22 2012 for Asterisk - The Open Source Telephony Project by  doxygen 1.4.7