/usr/include/asterisk/cel.h is in asterisk-dev 1:13.1.0~dfsg-1.1ubuntu4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 | /*
* Asterisk -- An open source telephony toolkit.
*
* Copyright (C) 2008 - 2009, Digium, Inc.
*
* 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 Call Event Logging API
*
* \todo TODO: There some event types that have been defined here, but are not
* yet used anywhere in the code. It would be really awesome if someone
* went through and had Asterisk generate these events where it is
* appropriate to do so. The defined, but unused events are:
* CONF_ENTER, CONF_EXIT, CONF_START, CONF_END, 3WAY_START, 3WAY_END,
* TRANSFER, and HOOKFLASH.
*/
#ifndef __AST_CEL_H__
#define __AST_CEL_H__
#if defined(__cplusplus) || defined(c_plusplus)
extern "C" {
#endif
#include "asterisk/event.h"
/*!
* \brief CEL event types
*/
enum ast_cel_event_type {
/*! \brief channel birth */
AST_CEL_CHANNEL_START = 1,
/*! \brief channel end */
AST_CEL_CHANNEL_END = 2,
/*! \brief hangup terminates connection */
AST_CEL_HANGUP = 3,
/*! \brief A ringing phone is answered */
AST_CEL_ANSWER = 4,
/*! \brief an app starts */
AST_CEL_APP_START = 5,
/*! \brief an app ends */
AST_CEL_APP_END = 6,
/*! \brief channel enters a bridge */
AST_CEL_BRIDGE_ENTER = 7,
/*! \brief channel exits a bridge */
AST_CEL_BRIDGE_EXIT = 8,
/*! \brief a channel is parked */
AST_CEL_PARK_START = 9,
/*! \brief channel out of the park */
AST_CEL_PARK_END = 10,
/*! \brief a transfer occurs */
AST_CEL_BLINDTRANSFER = 11,
/*! \brief a transfer occurs */
AST_CEL_ATTENDEDTRANSFER = 12,
/*! \brief a user-defined event, the event name field should be set */
AST_CEL_USER_DEFINED = 13,
/*! \brief the last channel with the given linkedid is retired */
AST_CEL_LINKEDID_END = 14,
/*! \brief a directed pickup was performed on this channel */
AST_CEL_PICKUP = 15,
/*! \brief this call was forwarded somewhere else */
AST_CEL_FORWARD = 16,
/*! \brief A local channel optimization occurred */
AST_CEL_LOCAL_OPTIMIZE = 17,
};
/*!
* \brief Check to see if CEL is enabled
*
* \since 1.8
*
* \retval zero not enabled
* \retval non-zero enabled
*/
unsigned int ast_cel_check_enabled(void);
/*!
* \brief Allocate a CEL record
*
* \since 1.8
*
* \note The CEL record must be destroyed with ast_cel_destroy().
*
* \retval non-NULL an allocated ast_cel structure
* \retval NULL error
*/
struct ast_cel *ast_cel_alloc(void);
/*!
* \brief Destroy a CEL record.
*
* \param cel the record to destroy
*
* \since 1.8
*
* \return nothing.
*/
void ast_cel_destroy(struct ast_cel *cel);
/*!
* \brief Get the name of a CEL event type
*
* \param type the type to get the name of
*
* \since 1.8
*
* \return the string representation of the type
*/
const char *ast_cel_get_type_name(enum ast_cel_event_type type);
/*!
* \brief Get the event type from a string
*
* \param name the event type name as a string
*
* \since 1.8
*
* \return the ast_cel_event_type given by the string
*/
enum ast_cel_event_type ast_cel_str_to_event_type(const char *name);
/*!
* \brief Create a fake channel from data in a CEL event
*
* \note
* This function creates a fake channel containing the
* serialized channel data in the given cel event. It should be
* released with ast_channel_unref() but could be released with
* ast_channel_release().
*
* \param event the CEL event
*
* \since 1.8
*
* \return a channel with the data filled in, or NULL on error
*
* \todo This function is \b very expensive, especially given that some CEL backends
* use it on \b every CEL event. This function really needs to go away at
* some point.
*/
struct ast_channel *ast_cel_fabricate_channel_from_event(const struct ast_event *event);
/*!
* \brief Helper struct for getting the fields out of a CEL event
*/
struct ast_cel_event_record {
/*!
* \brief struct ABI version
* \note This \b must be incremented when the struct changes.
*/
#define AST_CEL_EVENT_RECORD_VERSION 2
/*!
* \brief struct ABI version
* \note This \b must stay as the first member.
*/
uint32_t version;
enum ast_cel_event_type event_type;
struct timeval event_time;
const char *event_name;
const char *user_defined_name;
const char *caller_id_name;
const char *caller_id_num;
const char *caller_id_ani;
const char *caller_id_rdnis;
const char *caller_id_dnid;
const char *extension;
const char *context;
const char *channel_name;
const char *application_name;
const char *application_data;
const char *account_code;
const char *peer_account;
const char *unique_id;
const char *linked_id;
uint amaflag;
const char *user_field;
const char *peer;
const char *extra;
};
/*!
* \brief Fill in an ast_cel_event_record from a CEL event
*
* \param[in] event the CEL event
* \param[out] r the ast_cel_event_record to fill in
*
* \since 1.8
*
* \retval 0 success
* \retval non-zero failure
*/
int ast_cel_fill_record(const struct ast_event *event, struct ast_cel_event_record *r);
/*!
* \brief Publish a CEL event
* \since 12
*
* \param chan This is the primary channel associated with this channel event.
* \param event_type This is the type of call event being reported.
* \param blob This contains any additional parameters that need to be conveyed for this event.
*/
void ast_cel_publish_event(struct ast_channel *chan,
enum ast_cel_event_type event_type,
struct ast_json *blob);
/*!
* \brief Get the CEL topic
*
* \retval The CEL topic
* \retval NULL if not allocated
*/
struct stasis_topic *ast_cel_topic(void);
/*! \brief A structure to hold CEL global configuration options */
struct ast_cel_general_config {
AST_DECLARE_STRING_FIELDS(
AST_STRING_FIELD(date_format); /*!< The desired date format for logging */
);
int enable; /*!< Whether CEL is enabled */
int64_t events; /*!< The events to be logged */
/*! The apps for which to log app start and end events. This is
* ast_str_container_alloc()ed and filled with ao2-allocated
* char* which are all-lowercase application names. */
struct ao2_container *apps;
};
/*!
* \brief Allocate a CEL configuration object
*
* \retval NULL on error
* \retval The new CEL configuration object
*/
void *ast_cel_general_config_alloc(void);
/*!
* \since 12
* \brief Obtain the current CEL configuration
*
* The configuration is a ref counted object. The caller of this function must
* decrement the ref count when finished with the configuration.
*
* \retval NULL on error
* \retval The current CEL configuration
*/
struct ast_cel_general_config *ast_cel_get_config(void);
/*!
* \since 12
* \brief Set the current CEL configuration
*
* \param config The new CEL configuration
*/
void ast_cel_set_config(struct ast_cel_general_config *config);
struct ast_channel_snapshot;
/*!
* \brief Allocate and populate a CEL event structure
*
* \param snapshot An ast_channel_snapshot of the primary channel associated
* with this channel event.
* \param event_type The type of call event being reported.
* \param userdefevname Custom name for the call event. (optional)
* \param extra An event-specific opaque JSON blob to be rendered and placed
* in the "CEL_EXTRA" information element of the call event. (optional)
* \param peer_str A list of comma-separated peer channel names. (optional)
*
* \since 12
*
* \retval The created ast_event structure
* \retval NULL on failure
*/
struct ast_event *ast_cel_create_event(struct ast_channel_snapshot *snapshot,
enum ast_cel_event_type event_type, const char *userdefevname,
struct ast_json *extra, const char *peer_str);
/*!
* \brief CEL backend callback
*/
/*typedef int (*ast_cel_backend_cb)(struct ast_cel_event_record *cel);*/
typedef void (*ast_cel_backend_cb)(struct ast_event *event);
/*!
* \brief Register a CEL backend
*
* \param name Name of backend to register
* \param backend_callback Callback to register
*
* \retval zero on success
* \retval non-zero on failure
* \since 12
*/
int ast_cel_backend_register(const char *name, ast_cel_backend_cb backend_callback);
/*!
* \brief Unregister a CEL backend
*
* \param name Name of backend to unregister
*
* \retval zero on success
* \retval non-zero on failure
* \since 12
*/
int ast_cel_backend_unregister(const char *name);
#if defined(__cplusplus) || defined(c_plusplus)
}
#endif
#endif /* __AST_CEL_H__ */
|