mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-05 04:11:08 +00:00
7071e9d64c
Testing revealed that the cache added no benefit but that it could consume excessive memory. Two new index related functions were created: ast_sounds_get_index_for_file() and ast_media_index_update_for_file() which restrict index updating to specific sound files. The original ast_sounds_get_index() and ast_media_index_update() calls are still available but since they no longer cache the results internally, developers should re-use an index they may already have instead of calling ast_sounds_get_index() repeatedly. If information for only a single file is needed, ast_sounds_get_index_for_file() should be called instead of ast_sounds_get_index(). The media_index directory scan code was elimininated in favor of using the existing ast_file_read_dirs() function. Since there's no more cache, ast_sounds_index_init now only registers the sounds cli commands instead of generating the initial index and subscribing to stasis format register/unregister messages. "sounds" is no longer a valid target for the "module reload" command. Both the sounds cli commands and the sounds ari resources were refactored to only call ast_sounds_get_index() once per invocation and to use ast_sounds_get_index_for_file() when a specific sound file is requested. Change-Id: I1cef327ba1b0648d85d218b70ce469ad07f4aa8d
61 lines
1.4 KiB
C
61 lines
1.4 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 2013, Digium, Inc.
|
|
*
|
|
* Kinsey Moore <kmoore@digium.com>
|
|
*
|
|
* See http://www.asterisk.org for more information about
|
|
* the Asterisk project. Please do not directly contact
|
|
* any of the maintainers of this project for assistance;
|
|
* the project provides a web site, mailing lists and IRC
|
|
* channels for your use.
|
|
*
|
|
* This program is free software, distributed under the terms of
|
|
* the GNU General Public License Version 2. See the LICENSE file
|
|
* at the top of the source tree.
|
|
*/
|
|
|
|
/*! \file
|
|
* \brief Sound file format and description indexer.
|
|
*/
|
|
|
|
#ifndef _ASTERISK_SOUNDS_INDEX_H
|
|
#define _ASTERISK_SOUNDS_INDEX_H
|
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*!
|
|
* \brief Object representing a media index
|
|
*/
|
|
struct ast_media_index;
|
|
|
|
/*!
|
|
* \brief Get the sounds index
|
|
*
|
|
* \retval sounds index (must be ao2_cleanup()'ed)
|
|
* \retval NULL on failure
|
|
*/
|
|
struct ast_media_index *ast_sounds_get_index(void);
|
|
|
|
/*!
|
|
* \brief Get the index for a specific sound file
|
|
* \since 13.25.0
|
|
* \since 16.2.0
|
|
*
|
|
* \param filename Sound file name without extension
|
|
*
|
|
* \retval sounds index (must be ao2_cleanup()'ed)
|
|
* \retval NULL on failure
|
|
*/
|
|
struct ast_media_index *ast_sounds_get_index_for_file(const char *filename);
|
|
|
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif /* _ASTERISK_SOUNDS_INDEX_H */
|