Asterisk - The Open Source Telephony Project  18.5.0
Macros
linkedlists.h File Reference

A set of macros to manage forward-linked lists. More...

#include "asterisk/lock.h"
Include dependency graph for linkedlists.h:

Go to the source code of this file.

Macros

#define AST_LIST_APPEND_LIST(head, list, field)
 Appends a whole list to the tail of a list. More...
 
#define AST_LIST_EMPTY(head)   (AST_LIST_FIRST(head) == NULL)
 Checks whether the specified list contains any entries. More...
 
#define AST_LIST_ENTRY(type)
 Declare a forward link structure inside a list entry. More...
 
#define AST_LIST_FIRST(head)   ((head)->first)
 Returns the first entry contained in a list. More...
 
#define AST_LIST_HEAD(name, type)
 Defines a structure to be used to hold a list of specified type. More...
 
#define AST_LIST_HEAD_DESTROY(head)
 Destroys a list head structure. More...
 
#define AST_LIST_HEAD_INIT(head)
 Initializes a list head structure. More...
 
#define AST_LIST_HEAD_INIT_NOLOCK(head)
 Initializes a list head structure. More...
 
#define AST_LIST_HEAD_INIT_VALUE
 Defines initial values for a declaration of AST_LIST_HEAD. More...
 
#define AST_LIST_HEAD_NOLOCK(name, type)
 Defines a structure to be used to hold a list of specified type (with no lock). More...
 
#define AST_LIST_HEAD_NOLOCK_INIT_VALUE
 Defines initial values for a declaration of AST_LIST_HEAD_NOLOCK. More...
 
#define AST_LIST_HEAD_NOLOCK_STATIC(name, type)
 Defines a structure to be used to hold a list of specified type, statically initialized. More...
 
#define AST_LIST_HEAD_SET(head, entry)
 Initializes a list head structure with a specified first entry. More...
 
#define AST_LIST_HEAD_SET_NOLOCK(head, entry)
 Initializes a list head structure with a specified first entry. More...
 
#define AST_LIST_HEAD_STATIC(name, type)
 Defines a structure to be used to hold a list of specified type, statically initialized. More...
 
#define AST_LIST_INSERT_AFTER(head, listelm, elm, field)
 Inserts a list entry after a given entry. More...
 
#define AST_LIST_INSERT_BEFORE_CURRENT(elm, field)
 Inserts a list entry before the current entry during a traversal. More...
 
#define AST_LIST_INSERT_HEAD(head, elm, field)
 Inserts a list entry at the head of a list. More...
 
#define AST_LIST_INSERT_LIST_AFTER(head, list, elm, field)
 Inserts a whole list after a specific entry in a list. More...
 
#define AST_LIST_INSERT_SORTALPHA(head, elm, field, sortfield)
 Inserts a list entry into a alphabetically sorted list. More...
 
#define AST_LIST_INSERT_TAIL(head, elm, field)
 Appends a list entry to the tail of a list. More...
 
#define AST_LIST_LAST(head)   ((head)->last)
 Returns the last entry contained in a list. More...
 
#define AST_LIST_LOCK(head)   ast_mutex_lock(&(head)->lock)
 Locks a list. More...
 
#define AST_LIST_MOVE_CURRENT(newhead, field)
 Move the current list entry to another list. More...
 
#define AST_LIST_NEXT(elm, field)   ((elm)->field.next)
 Returns the next entry in the list after the given entry. More...
 
#define AST_LIST_REMOVE(head, elm, field)
 Removes a specific entry from a list. More...
 
#define AST_LIST_REMOVE_CURRENT(field)
 Removes the current entry from a list during a traversal. More...
 
#define AST_LIST_REMOVE_HEAD(head, field)
 Removes and returns the head entry from a list. More...
 
#define AST_LIST_TRAVERSE(head, var, field)   for((var) = (head)->first; (var); (var) = (var)->field.next)
 Loops over (traverses) the entries in a list. More...
 
#define AST_LIST_TRAVERSE_SAFE_BEGIN(head, var, field)
 Loops safely over (traverses) the entries in a list. More...
 
#define AST_LIST_TRAVERSE_SAFE_END   }
 Closes a safe loop traversal block. More...
 
#define AST_LIST_TRYLOCK(head)   ast_mutex_trylock(&(head)->lock)
 Locks a list, without blocking if the list is locked. More...
 
#define AST_LIST_UNLOCK(head)   ast_mutex_unlock(&(head)->lock)
 Attempts to unlock a list. More...
 
#define AST_RWLIST_APPEND_LIST   AST_LIST_APPEND_LIST
 
#define AST_RWLIST_EMPTY   AST_LIST_EMPTY
 
#define AST_RWLIST_ENTRY   AST_LIST_ENTRY
 
#define AST_RWLIST_FIRST   AST_LIST_FIRST
 
#define AST_RWLIST_HEAD(name, type)
 Defines a structure to be used to hold a read/write list of specified type. More...
 
#define AST_RWLIST_HEAD_DESTROY(head)
 Destroys an rwlist head structure. More...
 
#define AST_RWLIST_HEAD_INIT(head)
 Initializes an rwlist head structure. More...
 
#define AST_RWLIST_HEAD_INIT_VALUE
 Defines initial values for a declaration of AST_RWLIST_HEAD. More...
 
#define AST_RWLIST_HEAD_SET(head, entry)
 Initializes an rwlist head structure with a specified first entry. More...
 
#define AST_RWLIST_HEAD_STATIC(name, type)
 Defines a structure to be used to hold a read/write list of specified type, statically initialized. More...
 
#define AST_RWLIST_INSERT_AFTER   AST_LIST_INSERT_AFTER
 
#define AST_RWLIST_INSERT_BEFORE_CURRENT   AST_LIST_INSERT_BEFORE_CURRENT
 
#define AST_RWLIST_INSERT_HEAD   AST_LIST_INSERT_HEAD
 
#define AST_RWLIST_INSERT_LIST_AFTER   AST_LIST_INSERT_LIST_AFTER
 
#define AST_RWLIST_INSERT_SORTALPHA   AST_LIST_INSERT_SORTALPHA
 
#define AST_RWLIST_INSERT_TAIL   AST_LIST_INSERT_TAIL
 
#define AST_RWLIST_LAST   AST_LIST_LAST
 
#define AST_RWLIST_MOVE_CURRENT   AST_LIST_MOVE_CURRENT
 
#define AST_RWLIST_NEXT   AST_LIST_NEXT
 
#define AST_RWLIST_RDLOCK(head)   ast_rwlock_rdlock(&(head)->lock)
 Read locks a list. More...
 
#define AST_RWLIST_REMOVE   AST_LIST_REMOVE
 
#define AST_RWLIST_REMOVE_CURRENT   AST_LIST_REMOVE_CURRENT
 
#define AST_RWLIST_REMOVE_HEAD   AST_LIST_REMOVE_HEAD
 
#define AST_RWLIST_TIMEDRDLOCK(head, ts)   ast_rwlock_timedrdlock(&(head)->lock, ts)
 Read locks a list, with timeout. More...
 
#define AST_RWLIST_TIMEDWRLOCK(head, ts)   ast_rwlock_timedwrlock(&(head)->lock, ts)
 Write locks a list, with timeout. More...
 
#define AST_RWLIST_TRAVERSE   AST_LIST_TRAVERSE
 
#define AST_RWLIST_TRAVERSE_SAFE_BEGIN   AST_LIST_TRAVERSE_SAFE_BEGIN
 
#define AST_RWLIST_TRAVERSE_SAFE_END   AST_LIST_TRAVERSE_SAFE_END
 
#define AST_RWLIST_TRYRDLOCK(head)   ast_rwlock_tryrdlock(&(head)->lock)
 Read locks a list, without blocking if the list is locked. More...
 
#define AST_RWLIST_TRYWRLOCK(head)   ast_rwlock_trywrlock(&(head)->lock)
 Write locks a list, without blocking if the list is locked. More...
 
#define AST_RWLIST_UNLOCK(head)   ast_rwlock_unlock(&(head)->lock)
 Attempts to unlock a read/write based list. More...
 
#define AST_RWLIST_WRLOCK(head)   ast_rwlock_wrlock(&(head)->lock)
 Write locks a list. More...
 

Detailed Description

A set of macros to manage forward-linked lists.

Definition in file linkedlists.h.

Macro Definition Documentation

◆ AST_LIST_APPEND_LIST

#define AST_LIST_APPEND_LIST (   head,
  list,
  field 
)

Appends a whole list to the tail of a list.

Parameters
headThis is a pointer to the list head structure
listThis is a pointer to the list to be appended.
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.

Note: The source list (the list parameter) will be empty after calling this macro (the list entries are moved to the target list).

Definition at line 782 of file linkedlists.h.

Referenced by __ast_queue_frame(), announce_thread(), ast_autochan_new_channel(), AST_TEST_DEFINE(), channel_do_masquerade(), clone_variables(), dns_srv_sort(), findmeexec(), and process_weights().

◆ AST_LIST_EMPTY

#define AST_LIST_EMPTY (   head)    (AST_LIST_FIRST(head) == NULL)

Checks whether the specified list contains any entries.

Parameters
headThis is a pointer to the list head structure
Returns
zero if the list has entries
non-zero if not.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 449 of file linkedlists.h.

Referenced by __ast_read(), acf_faxopt_read(), acf_jabberreceive_read(), ack_trans(), action_meetmelist(), action_meetmelistrooms(), add_sdp(), announce_thread(), ast_audiohook_write_list_empty(), ast_autoservice_start(), ast_category_get_templates(), ast_channel_snapshot_to_json(), ast_config_text_file_save2(), ast_dial_get_channel(), ast_dial_option_disable(), ast_dial_option_enable(), ast_dial_reason(), ast_dial_run(), ast_framehook_list_contains_no_active_of_type(), ast_framehook_list_fixup(), ast_framehook_list_is_empty(), ast_pbx_hangup_handler_run(), ast_srv_lookup(), AST_TEST_DEFINE(), audio_audiohook_write_list(), autoservice_run(), bridge_channel_handle_write(), bridge_channel_internal_allows_optimization(), build_peer(), cc_generic_monitor_destructor(), channel_get_external_vars(), channel_has_external_vars(), config_device(), dahdi_cc_callback(), destroy_bridge(), destroy_trans(), dial_exec_full(), dial_masquerade_breakdown(), dial_masquerade_fixup(), do_devstate_changes(), dundi_lookup_internal(), dundi_precache_internal(), dundi_query_eid_internal(), dundi_show_peer(), eivr_comm(), external_media_audiosocket_tcp(), external_media_rtp_udp(), find_table(), findmeexec(), forward_message(), generate_filenames_json(), generate_filenames_string(), get_destination(), get_realm(), handle_command_response(), handle_minivm_list_templates(), handle_minivm_show_users(), handle_minivm_show_zones(), handle_request_refer(), handle_request_subscribe(), handle_voicemail_show_users(), handle_voicemail_show_zones(), is_valid_tone_zone(), logger_thread(), manager_list_voicemail_users(), meetme_show_cmd(), mixmonitor_thread(), moh_class_inuse(), monmp3thread(), optimize_lock_chan_stack(), optimize_lock_peer_stack(), queue_file(), register_verify(), reload_config(), remove_dial_masquerade_caller(), remove_handler(), resend_reinvite(), restart_monitor(), scan_thread(), session_inv_on_tsx_state_changed(), set_sched_id(), shaun_of_the_dead(), sip_outbound_publish_callback(), sip_outbound_publish_timer_cb(), sip_session_refresh(), sip_show_domains(), sip_show_settings(), sla_thread(), smdi_load(), transport_state_callback(), and wait_for_empty_queue().

◆ AST_LIST_ENTRY

#define AST_LIST_ENTRY (   type)
Value:
struct { \
struct type *next; \
}
static const char type[]
Definition: chan_ooh323.c:109

Declare a forward link structure inside a list entry.

Parameters
typeThis is the type of each list entry.

This macro declares a structure to be used to link list entries together. It must be used inside the definition of the structure named in type, as follows:

struct list_entry {
...
AST_LIST_ENTRY(list_entry) list;
}

The field name list here is arbitrary, and can be anything you wish.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 409 of file linkedlists.h.

Referenced by AST_TEST_DEFINE(), handle_cli_test_locales(), and threadstorage_init().

◆ AST_LIST_FIRST

#define AST_LIST_FIRST (   head)    ((head)->first)

Returns the first entry contained in a list.

Parameters
headThis is a pointer to the list head structure
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 420 of file linkedlists.h.

Referenced by __ast_queue_frame(), __ast_read(), _skinny_show_line(), abort_request(), acf_faxopt_read(), acl_to_str(), ast_acl_list_is_empty(), ast_append_acl(), ast_cc_agent_set_interfaces_chanvar(), ast_dial_answered(), ast_dial_answered_steal(), ast_dial_join(), ast_dns_result_get_records(), ast_rtp_interpret(), ast_rtp_read(), ast_srv_lookup(), AST_TEST_DEFINE(), ast_xmldoc_build_documentation(), bridge_channel_dissolve_check(), bridge_channel_update_accountcodes_leaving(), bridge_reconfigured_connected_line_update(), build_user_routes(), calendar_join_attendees(), channel_do_masquerade(), cli_next(), conf_handle_second_active(), conf_mute_only_active(), config_device(), config_parse_variables(), contact_acl_to_str(), dial_exec_full(), dns_srv_sort(), do_devstate_changes(), find_subchannel_by_instance_reference(), gen_nextfile(), gen_readframe(), generate_filenames_string(), get_ewscal_ids_for(), get_transfer_party_non_transferer_bridge(), gosub_exec(), gosub_run(), handle_cli_test_locales(), handle_command_response(), handle_gosub(), hook_event_cb(), iax_frame_free(), iax_frame_new(), load_config(), local_read(), local_write(), logger_thread(), main(), msg_queue_head(), native_bridge_join(), native_rtp_bridge_compatible(), native_rtp_bridge_join(), native_rtp_bridge_start(), native_rtp_bridge_stop(), native_rtp_stream_topology_changed(), native_start(), native_stop(), pop_exec(), print_stats_cb(), process_precache(), process_weights(), queue_exec(), rcv_mac_addr(), recall_pull(), refresh_all_favorite(), register_extension(), reschedule_precache(), scan_thread(), set_bridge_peer_vars(), set_file(), setsubstate(), shaun_of_the_dead(), simple_bridge_join(), simple_bridge_stream_topology_changed(), sip_publisher_service_queue(), transfer_pull(), wait_for_answer(), and xmldoc_build_list_responses().

◆ AST_LIST_HEAD

#define AST_LIST_HEAD (   name,
  type 
)
Value:
struct name { \
struct type *first; \
struct type *last; \
ast_mutex_t lock; \
}
static const char type[]
Definition: chan_ooh323.c:109
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
ast_mutex_t lock
Definition: app_meetme.c:1091
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092
static const char name[]
Definition: cdr_mysql.c:74

Defines a structure to be used to hold a list of specified type.

Parameters
nameThis will be the name of the defined structure.
typeThis is the type of each list entry.

This macro creates a structure definition that can be used to hold a list of the entries of type type. It does not actually declare (allocate) a structure; to do that, either follow this macro with the desired name of the instance you wish to declare, or use the specified name to declare instances elsewhere.

Example usage:

static AST_LIST_HEAD(entry_list, entry) entries;

This would define struct entry_list, and declare an instance of it named entries, all intended to hold a list of type struct entry.

Definition at line 172 of file linkedlists.h.

Referenced by acf_curl_helper(), acf_iaxvar_read(), acf_iaxvar_write(), add_agi_cmd(), add_to_agi(), agi_destroy_commands_cb(), ast_iax2_new(), ast_odbc_retrieve_transaction_obj(), authenticate_reply(), cleanup_thread_list(), create_transaction(), curlds_free(), find_transaction(), get_agi_cmd(), get_lock(), iax2_call(), iax2_dup_variable_datastore(), iax2_free_variable_datastore(), lock_fixup(), lock_free(), mark_transaction_active(), odbc_txn_free(), socket_process_helper(), and unlock_read().

◆ AST_LIST_HEAD_DESTROY

#define AST_LIST_HEAD_DESTROY (   head)
Value:
{ \
(head)->first = NULL; \
(head)->last = NULL; \
ast_mutex_destroy(&(head)->lock); \
}
#define NULL
Definition: resample.c:96
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
ast_mutex_t lock
Definition: app_meetme.c:1091
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092

Destroys a list head structure.

Parameters
headThis is a pointer to the list head structure

This macro destroys a list head structure by setting the head entry to NULL (empty list) and destroying the embedded lock. It does not free the structure from memory.

Definition at line 652 of file linkedlists.h.

Referenced by after_bridge_cb_destroy(), agi_destroy_commands_cb(), ast_free_acl_list(), cc_interface_tree_destroy(), control_dtor(), curlds_free(), gosub_free(), iax2_free_variable_datastore(), lock_free(), module_destroy(), odbc_datastore_free(), odbc_txn_free(), session_destructor(), unload_module(), and xmpp_client_destructor().

◆ AST_LIST_HEAD_INIT

#define AST_LIST_HEAD_INIT (   head)
Value:
{ \
(head)->first = NULL; \
(head)->last = NULL; \
ast_mutex_init(&(head)->lock); \
}
#define NULL
Definition: resample.c:96
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
ast_mutex_t lock
Definition: app_meetme.c:1091
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092

Initializes a list head structure.

Parameters
headThis is a pointer to the list head structure

This macro initializes a list head structure by setting the head entry to NULL (empty list) and recreating the embedded lock.

Definition at line 625 of file linkedlists.h.

Referenced by acf_curlopt_write(), acf_iaxvar_write(), acf_odbc_read(), add_to_agi(), after_bridge_cb_setup(), ast_append_acl(), ast_dial_create(), ast_duplicate_acl_list(), ast_iax2_new(), ast_module_register(), ast_sip_session_alloc(), ast_xmldoc_build_documentation(), authenticate_reply(), cc_interfaces_datastore_init(), control_create(), create_transaction(), get_lock(), gosub_exec(), iax2_dup_variable_datastore(), load_module(), socket_process_helper(), spandsp_fax_new(), xmldoc_build_list_responses(), and xmpp_client_alloc().

◆ AST_LIST_HEAD_INIT_NOLOCK

#define AST_LIST_HEAD_INIT_NOLOCK (   head)
Value:
{ \
(head)->first = NULL; \
(head)->last = NULL; \
}
#define NULL
Definition: resample.c:96
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092

Initializes a list head structure.

Parameters
headThis is a pointer to the list head structure

This macro initializes a list head structure by setting the head entry to NULL (empty list). There is no embedded lock handling with this macro.

Definition at line 680 of file linkedlists.h.

Referenced by __ao2_ref(), __ast_answer(), __ast_channel_alloc_ap(), __ast_dummy_channel_alloc(), __ast_queue_frame(), __sip_alloc(), add_header(), alloc_profile(), announce_thread(), app_exec(), ast_audiohook_attach(), ast_calendar_event_alloc(), ast_cdr_dup(), ast_data_buffer_alloc(), ast_pbx_hangup_handler_init(), ast_rtp_interpret(), ast_rtp_read(), ast_sched_context_create(), ast_sip_session_alloc(), ast_sip_session_register_sdp_handler(), ast_srv_lookup(), ast_var_list_create(), auth_http_callback(), bridge_manager_create(), build_profile(), channel_do_masquerade(), conf_run(), copy_menu_entry(), dial_masquerade_datastore_alloc(), do_devstate_changes(), dundi_lookup_local(), extension_monitor_pvt_init(), find_table(), free_numbers(), generic_http_callback(), get_ewscal_ids_for(), gosub_allocate_frame(), hook_event_cb(), incoming_request(), jb_framedata_init(), load_modules(), logger_thread(), loopback_subst(), mbl_load_device(), new_iax(), safe_sleep_conditional(), session_details_new(), session_do(), setup_bridge_role(), and setup_bridge_roles_datastore().

◆ AST_LIST_HEAD_INIT_VALUE

#define AST_LIST_HEAD_INIT_VALUE
Value:
{ \
.first = NULL, \
.last = NULL, \
}
#define NULL
Definition: resample.c:96
#define AST_MUTEX_INIT_VALUE
Definition: lock.h:95

Defines initial values for a declaration of AST_LIST_HEAD.

Definition at line 233 of file linkedlists.h.

Referenced by app_exec().

◆ AST_LIST_HEAD_NOLOCK

#define AST_LIST_HEAD_NOLOCK (   name,
  type 
)
Value:
struct name { \
struct type *first; \
struct type *last; \
}
static const char type[]
Definition: chan_ooh323.c:109
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092
static const char name[]
Definition: cdr_mysql.c:74

Defines a structure to be used to hold a list of specified type (with no lock).

Parameters
nameThis will be the name of the defined structure.
typeThis is the type of each list entry.

This macro creates a structure definition that can be used to hold a list of the entries of type type. It does not actually declare (allocate) a structure; to do that, either follow this macro with the desired name of the instance you wish to declare, or use the specified name to declare instances elsewhere.

Example usage:

This would define struct entry_list, and declare an instance of it named entries, all intended to hold a list of type struct entry.

Definition at line 224 of file linkedlists.h.

◆ AST_LIST_HEAD_NOLOCK_INIT_VALUE

#define AST_LIST_HEAD_NOLOCK_INIT_VALUE
Value:
{ \
.first = NULL, \
.last = NULL, \
}
#define NULL
Definition: resample.c:96

Defines initial values for a declaration of AST_LIST_HEAD_NOLOCK.

Definition at line 251 of file linkedlists.h.

Referenced by ast_get_srv(), ast_merge_contexts_and_delete(), dial_exec_full(), dns_srv_sort(), do_directory(), findmeexec(), and process_weights().

◆ AST_LIST_HEAD_NOLOCK_STATIC

#define AST_LIST_HEAD_NOLOCK_STATIC (   name,
  type 
)
Value:
struct name { \
struct type *first; \
struct type *last; \
static const char type[]
Definition: chan_ooh323.c:109
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092
static const char name[]
Definition: cdr_mysql.c:74
#define AST_LIST_HEAD_NOLOCK_INIT_VALUE
Defines initial values for a declaration of AST_LIST_HEAD_NOLOCK.
Definition: linkedlists.h:251

Defines a structure to be used to hold a list of specified type, statically initialized.

This is the same as AST_LIST_HEAD_STATIC, except without the lock included.

Definition at line 345 of file linkedlists.h.

Referenced by ast_event_new(), forward_message(), and threadstorage_init().

◆ AST_LIST_HEAD_SET

#define AST_LIST_HEAD_SET (   head,
  entry 
)
Value:
do { \
(head)->first = (entry); \
(head)->last = (entry); \
ast_mutex_init(&(head)->lock); \
} while (0)
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
ast_mutex_t lock
Definition: app_meetme.c:1091
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092
Definition: search.h:40

Initializes a list head structure with a specified first entry.

Parameters
headThis is a pointer to the list head structure
entrypointer to the list entry that will become the head of the list

This macro initializes a list head structure by setting the head entry to the supplied value and recreating the embedded lock.

Definition at line 359 of file linkedlists.h.

◆ AST_LIST_HEAD_SET_NOLOCK

#define AST_LIST_HEAD_SET_NOLOCK (   head,
  entry 
)
Value:
do { \
(head)->first = (entry); \
(head)->last = (entry); \
} while (0)
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092
Definition: search.h:40

Initializes a list head structure with a specified first entry.

Parameters
headThis is a pointer to the list head structure
entrypointer to the list entry that will become the head of the list

This macro initializes a list head structure by setting the head entry to the supplied value.

Definition at line 387 of file linkedlists.h.

Referenced by AST_TEST_DEFINE(), handle_cli_test_locales(), and parse_contact_header().

◆ AST_LIST_HEAD_STATIC

#define AST_LIST_HEAD_STATIC (   name,
  type 
)
Value:
struct name { \
struct type *first; \
struct type *last; \
ast_mutex_t lock; \
static const char type[]
Definition: chan_ooh323.c:109
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
ast_mutex_t lock
Definition: app_meetme.c:1091
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092
static const char name[]
Definition: cdr_mysql.c:74
#define AST_LIST_HEAD_INIT_VALUE
Defines initial values for a declaration of AST_LIST_HEAD.
Definition: linkedlists.h:233

Defines a structure to be used to hold a list of specified type, statically initialized.

Parameters
nameThis will be the name of the defined structure.
typeThis is the type of each list entry.

This macro creates a structure definition that can be used to hold a list of the entries of type type, and allocates an instance of it, initialized to be empty.

Example usage:

This would define struct entry_list, intended to hold a list of type struct entry.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 290 of file linkedlists.h.

◆ AST_LIST_INSERT_AFTER

#define AST_LIST_INSERT_AFTER (   head,
  listelm,
  elm,
  field 
)

Inserts a list entry after a given entry.

Parameters
headThis is a pointer to the list head structure
listelmThis is a pointer to the entry after which the new entry should be inserted.
elmThis is a pointer to the entry to be inserted.
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.

Definition at line 694 of file linkedlists.h.

Referenced by AST_TEST_DEFINE(), and reschedule_precache().

◆ AST_LIST_INSERT_BEFORE_CURRENT

#define AST_LIST_INSERT_BEFORE_CURRENT (   elm,
  field 
)

Inserts a list entry before the current entry during a traversal.

Parameters
elmThis is a pointer to the entry to be inserted.
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.
Note
This macro can only be used inside an AST_LIST_TRAVERSE_SAFE_BEGIN() block.

Definition at line 598 of file linkedlists.h.

Referenced by add_event_to_list(), ast_data_buffer_put(), AST_TEST_DEFINE(), defer_full_frame(), insert_penaltychange(), load_realtime_rules(), queue_file(), srv_callback(), and vm_msg_snapshot_create().

◆ AST_LIST_INSERT_HEAD

#define AST_LIST_INSERT_HEAD (   head,
  elm,
  field 
)

Inserts a list entry at the head of a list.

Parameters
headThis is a pointer to the list head structure
elmThis is a pointer to the entry to be inserted.
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.

Definition at line 710 of file linkedlists.h.

Referenced by __ast_answer(), __ast_module_user_add(), __frame_free(), ack_trans(), add_identifier(), add_vm_recipients_from_string(), ao2_weakproxy_subscribe(), append_transaction(), ast_append_acl(), ast_autoservice_start(), ast_calendar_register(), ast_cel_fabricate_channel_from_event(), ast_channel_datastore_add(), ast_loader_register(), ast_merge_contexts_and_delete(), ast_odbc_release_obj(), ast_pbx_hangup_handler_push(), ast_sip_pubsub_register_body_generator(), ast_sip_transport_state_register(), AST_TEST_DEFINE(), AST_VAR_LIST_INSERT_HEAD(), astman_datastore_add(), autoservice_run(), bridge_channel_write_frame(), build_conf(), build_mapping(), build_peer(), config_parse_variables(), cops_gate_cmd(), copy_variables(), create_transaction(), deep_copy_peer(), delay_request(), dns_srv_sort(), do_say(), dundi_lookup_local(), dundi_send(), format_cap_framed_init(), forward_message(), frame_set_var(), get_chan_by_ast_name(), gosub_exec(), handle_command_response(), handle_frame(), iax2_append_register(), iax_frame_free(), iax_process_template(), load_pktccops_config(), load_zonemessages(), loopback_subst(), mohalloc(), my_load_config_string(), parse_config(), pbx_builtin_pushvar_helper(), pbx_builtin_setvar_helper(), pktccops_add_ippool(), queue_file(), queue_ringing_trunk(), register_atexit(), register_request(), register_translator(), reschedule_precache(), rtp_ioqueue_thread_get_or_create(), safe_sleep_conditional(), sched_release(), set_dial_masquerade(), set_variable(), shared_write(), sip_route_add(), skinny_new(), skinny_session(), sla_ring_station(), socket_read(), softmix_process_write_audio(), vm_msg_snapshot_create(), and xmpp_pak_message().

◆ AST_LIST_INSERT_LIST_AFTER

#define AST_LIST_INSERT_LIST_AFTER (   head,
  list,
  elm,
  field 
)

Inserts a whole list after a specific entry in a list.

Parameters
headThis is a pointer to the list head structure
listThis is a pointer to the list to be inserted.
elmThis is a pointer to the entry after which the new list should be inserted.
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of the lists together.

Note: The source list (the list parameter) will be empty after calling this macro (the list entries are moved to the target list).

Definition at line 811 of file linkedlists.h.

Referenced by __ast_queue_frame(), and AST_TEST_DEFINE().

◆ AST_LIST_INSERT_SORTALPHA

#define AST_LIST_INSERT_SORTALPHA (   head,
  elm,
  field,
  sortfield 
)

Inserts a list entry into a alphabetically sorted list.

Parameters
headPointer to the list head structure
elmPointer to the entry to be inserted
fieldName of the list entry field (declared using AST_LIST_ENTRY())
sortfieldName of the field on which the list is sorted
Since
1.6.1

Definition at line 750 of file linkedlists.h.

Referenced by config_cache_attribute(), config_text_file_load(), and test_insert().

◆ AST_LIST_INSERT_TAIL

#define AST_LIST_INSERT_TAIL (   head,
  elm,
  field 
)

Appends a list entry to the tail of a list.

Parameters
headThis is a pointer to the list head structure
elmThis is a pointer to the entry to be appended.
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.

Note: The link field in the appended entry is not modified, so if it is actually the head of a list itself, the entire list will be appended temporarily (until the next AST_LIST_INSERT_TAIL is performed).

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 730 of file linkedlists.h.

Referenced by __ast_queue_frame(), __init_manager(), acf_curlopt_write(), acf_iaxvar_write(), acf_odbc_read(), add_action_to_menu_entry(), add_agi_cmd(), add_event_to_list(), add_header(), add_ids(), add_menu_entry(), add_msg_header(), add_peer_mailboxes(), add_realm_authentication(), add_sip_domain(), add_to_load_order(), app_control_register_rule(), app_exec(), append_history_va(), append_mailbox_mapping(), append_permission(), ast_agi_register(), ast_append_acl(), ast_audiohook_attach(), ast_autochan_setup(), ast_bridge_channel_queue_frame(), ast_bridge_set_after_callback(), ast_category_inherit(), ast_cc_call_init(), ast_cc_extension_monitor_add_dialstring(), ast_channel_datastore_inherit(), ast_channel_get_vars(), ast_channel_inherit_variables(), ast_cli_perms_init(), ast_data_buffer_cache_adjust(), ast_data_buffer_put(), ast_devstate_changed_literal(), ast_dns_resolver_add_record(), ast_duplicate_acl_list(), ast_event_new(), ast_framehook_attach(), ast_handle_cc_control_frame(), ast_iax2_new(), ast_lock_path_flock(), ast_log_full(), ast_merge_contexts_and_delete(), ast_odbc_find_table(), ast_register_indication(), ast_rtp_interpret(), ast_rtp_read(), ast_safe_fork(), ast_setlocale(), ast_sip_session_add_supplements(), ast_sip_session_register_sdp_handler(), ast_slinfactory_feed(), AST_TEST_DEFINE(), ast_tzset(), ast_unreal_call_setup(), AST_VAR_LIST_INSERT_TAIL(), ast_xmldoc_build_documentation(), authenticate_reply(), bridge_channel_impart_add(), bridge_channel_internal_push_full(), bridge_manager_service_req(), bridge_queue_action_nodup(), bridges_scrape_cb(), build_config_docs(), build_device(), build_profile(), caldav_add_event(), cc_generic_monitor_request_cc(), cc_interfaces_datastore_init(), cdr_object_create_public_records(), channel_do_masquerade(), channels_scrape_cb(), clone_variables(), conf_add_post_join_action(), conf_add_user_active(), conf_add_user_marked(), conf_add_user_waiting(), conf_menu_profile_copy(), conf_run(), config_cache_attribute(), config_device(), config_line(), copy_event_data(), copy_menu_entry(), copy_rules(), create_transaction(), create_vmaccount(), data_buffer_free_buffer_payload(), defer_full_frame(), delay_request(), dial_append_common(), dial_exec_full(), dns_naptr_sort(), dns_srv_sort(), dummy_start(), eivr_comm(), endelm(), endpoints_scrape_cb(), find_cache(), find_chan(), find_or_create(), find_realtime(), find_table(), find_table_cb(), find_tpeer(), findmeexec(), gen_readframe(), get_lock(), gmtsub(), handle_cli_test_locales(), hook_event_cb(), iax2_dup_variable_datastore(), iax_frame_free(), icalendar_add_event(), insert_headers(), insert_idle_thread(), insert_penaltychange(), leave_marked(), load_config(), load_realtime_rules(), load_values_config(), logger_thread(), message_template_build(), mock_cdr_backend_cb(), msg_queue_push(), msg_queue_push_data(), my_connect_db(), parse_contact_header(), process_dtmf_rfc2833(), process_sdp(), prometheus_metric_register(), prometheus_metric_unregister(), publisher_client_send(), queue_file(), queue_file_create(), queue_file_open(), queue_reload_request(), queue_signalling(), rcv_mac_addr(), receivefax_exec(), release_doomed_pris(), reload_followme(), reload_queue_rules(), restart_monitor(), sched_release(), search_directory_sub(), sendfax_exec(), setup_bridge_role(), setup_bridge_role_option(), sip_epa_register(), sip_route_add(), sip_tcptls_write(), sla_add_trunk_to_station(), sla_queue_event_full(), sla_stop_ringing_station(), smart_bridge_operation(), socket_process_helper(), srv_callback(), start_network_thread(), startelm(), stasis_app_register_event_source(), stimulate_attended_transfer(), store_by_locale(), t38_tx_packet_handler(), taskprocessor_push(), threadstorage_init(), timezone_add(), transition_to_marked(), transmit_frame(), try_firmware(), unistim_alloc_sub(), vm_allocate_dh(), vm_msg_snapshot_create(), and xmldoc_build_list_responses().

◆ AST_LIST_LAST

#define AST_LIST_LAST (   head)    ((head)->last)

◆ AST_LIST_LOCK

#define AST_LIST_LOCK (   head)    ast_mutex_lock(&(head)->lock)

Locks a list.

Parameters
headThis is a pointer to the list head structure

This macro attempts to place an exclusive lock in the list head structure pointed to by head.

Return values
0on success
non-zeroon failure
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 39 of file linkedlists.h.

Referenced by __ast_module_user_add(), __ast_module_user_hangup_all(), __ast_module_user_remove(), _skinny_message_clear(), _skinny_message_set(), _skinny_show_device(), _skinny_show_devices(), _skinny_show_line(), _skinny_show_lines(), abort_request(), acf_curl_helper(), acf_curlopt_helper(), acf_curlopt_write(), acf_fetch(), acf_iaxvar_read(), acf_iaxvar_write(), acf_jabberreceive_read(), acf_meetme_info(), acl_to_str(), action_meetmelist(), action_meetmelistrooms(), actual_load_config(), add_agi_cmd(), add_identifier(), add_notify(), add_sip_domain(), admin_exec(), after_bridge_cb_fixup(), after_bridge_cb_run_discard(), agi_destroy_commands_cb(), ast_acl_list_is_empty(), ast_acl_output(), ast_append_acl(), ast_apply_acl_internal(), ast_autoservice_ignore(), ast_autoservice_start(), ast_autoservice_stop(), ast_bridge_run_after_callback(), ast_bridge_set_after_callback(), ast_calendar_register(), ast_calendar_unregister(), ast_cc_agent_set_interfaces_chanvar(), ast_cc_call_init(), ast_cc_extension_monitor_add_dialstring(), ast_cc_get_monitor_by_recall_core_id(), ast_cc_is_recall(), ast_devstate_changed_literal(), ast_dial_destroy(), ast_dial_hangup(), ast_dial_join(), ast_dial_prerun(), ast_duplicate_acl_list(), ast_free_acl_list(), ast_handle_cc_control_frame(), ast_loader_register(), ast_loader_unregister(), ast_localtime_wakeup_monitor(), ast_lock_path_flock(), ast_log_full(), ast_odbc_retrieve_transaction_obj(), ast_process_pending_reloads(), ast_run_atexits(), ast_safe_fork(), ast_set_cc_interfaces_chanvar(), ast_setlocale(), AST_TEST_DEFINE(), ast_test_register_cleanup(), ast_test_register_init(), ast_tzset(), ast_unlock_path_flock(), ast_unregister_atexit(), ast_update_use_count(), autoservice_run(), balance_stack(), begin_dial(), build_conf(), build_device(), build_peer(), build_transactions(), build_translators(), cancel_available_timer(), cancel_request(), cb_events(), cc_monitor_failed(), cc_status_response(), channel_admin_exec(), check_request(), check_sip_domain(), clean_time_zones(), cleanup_thread_list(), clear_mock_cdr_backend(), clear_sip_domains(), close_client(), close_logger(), common_startup(), complete_confno(), complete_dpreply(), complete_meetmecmd_mute_kick(), complete_peer_helper(), complete_queue_rule_show(), complete_test_category(), complete_test_name(), conf_exec(), conf_free(), conf_play(), conf_run(), config_cache_attribute(), config_cache_remove(), config_device(), config_line(), config_shutdown(), config_text_file_load(), contact_acl_to_str(), cops_gate_cmd(), copy_rules(), count_monitors_cb(), create_transaction(), create_vmaccount(), dahdi_cc_callback(), dahdi_destroy_channel_range(), del_identifier(), delete_device(), delete_devices(), delete_old_messages(), delete_users(), device_state_engine_cleanup(), discover_transactions(), dispose_conf(), do_devstate_changes(), do_monitor(), do_pktccops(), dundi_flush(), dundi_ie_append_eid_appropriately(), dundi_lookup_thread(), dundi_precache_internal(), dundi_precache_thread(), dundi_query_thread(), dundi_rexmit(), dundi_show_entityid(), dundi_show_mappings(), dundi_show_peer(), dundi_show_peers(), dundi_show_precache(), dundi_show_requests(), dundi_show_trans(), eivr_comm(), find_account(), find_cache(), find_conf(), find_conf_realtime(), find_dial_channel(), find_identifier(), find_idle_thread(), find_line_by_name(), find_line_by_number(), find_relative_dial_channel(), find_rtp_port(), find_static_data(), find_subchannel_by_name(), find_subline_by_name(), find_table(), find_tpeer(), find_transaction(), find_user(), free_strings(), free_vm_users(), free_vm_zones(), gen_nextfile(), gen_readframe(), get_agi_cmd(), get_button_template(), get_chan_by_ast_name(), get_lock(), get_sub(), get_sub_holding(), gmtsub(), gosub_exec(), gosub_free(), handle_clear_alarms(), handle_cli_config_list(), handle_cli_config_reload(), handle_cli_iax2_show_cache(), handle_cli_iax2_show_registry(), handle_cli_iax2_show_threads(), handle_cli_locks_show(), handle_cli_realtime_mysql_cache(), handle_cli_realtime_pgsql_cache(), handle_command_response(), handle_frame(), handle_minivm_list_templates(), handle_minivm_show_users(), handle_minivm_show_zones(), handle_queue_rule_show(), handle_show_calendars_types(), handle_skinny_reset(), handle_voicemail_show_users(), handle_voicemail_show_zones(), iax2_append_register(), iax2_call(), iax2_canmatch(), iax2_dup_variable_datastore(), iax2_exec(), iax2_exists(), iax2_free_variable_datastore(), iax2_matchmore(), iax2_process_thread(), iax_firmware_append(), iax_firmware_get_version(), iax_firmware_reload(), iax_firmware_traverse(), iax_firmware_unload(), inotify_daemon(), insert_idle_thread(), load_module(), load_zonemessages(), local_read(), local_write(), lock_fixup(), lock_free(), logger_thread(), manager_iax2_show_registry(), manager_list_voicemail_users(), manager_queue_rule_show(), mark_mappings(), mark_peers(), mark_transaction_active(), meetme_show_cmd(), meetmemute(), meetmestate(), message_destroy_list(), message_template_build(), message_template_find(), misdn_call(), misdn_facility_ie_handler(), misdn_request(), mock_cdr_backend_cb(), monitor_dial(), my_load_config_string(), mysql_ds_destroy(), mysql_ds_fixup(), network_change_sched_cb(), network_thread(), odbc_datastore_free(), odbc_txn_free(), optimize_transactions(), pktccops_add_ippool(), pktccops_gatedel(), pktccops_gateset(), pktccops_show_cmtses(), pktccops_show_gates(), pktccops_show_pools(), pktccops_unregister_cmtses(), pktccops_unregister_ippools(), play_message_datetime(), pop_exec(), precache_transactions(), print_stats_cb(), process_precache(), prune_mappings(), prune_peers(), query_transactions(), queue_file(), queue_reload_request(), rcv_mac_addr(), recordthread(), register_atexit(), register_request(), release_doomed_pris(), reload(), reload_config(), reload_queue_rules(), remove_from_queue(), request_cc(), reschedule_precache(), reset_user_pw(), restart_monitor(), return_exec(), rtp_ioqueue_thread_get_or_create(), rtp_ioqueue_thread_remove(), scan_thread(), sendmail(), set_config(), setup_dahdi_int(), shaun_of_the_dead(), sip_epa_register(), sip_epa_unregister_all(), sip_show_domains(), skinny_register(), skinny_reload(), skinny_session(), skinny_session_cleanup(), socket_process_helper(), socket_read(), stackpeek_read(), start_network_thread(), store_by_locale(), suspend(), test_cli_execute_registered(), test_cli_show_registered(), test_cli_show_results(), test_execute_multiple(), test_generate_results(), test_insert(), test_remove(), timezone_add(), timezone_destroy_list(), timing_read(), unistim_alloc_sub(), unistim_show_info(), unistim_unalloc_sub(), unload_module(), unload_mysql(), unload_pgsql(), unlock_read(), unregister_request(), unregister_translators(), unsuspend(), verify_mock_cdr_record(), vm_allocate_dh(), vm_test_destroy_user(), vmaccounts_destroy_list(), vmu_tm(), wait_for_digits(), and xmpp_pak_message().

◆ AST_LIST_MOVE_CURRENT

#define AST_LIST_MOVE_CURRENT (   newhead,
  field 
)
Value:
do { \
typeof ((newhead)->first) __extracted = __list_current; \
AST_LIST_REMOVE_CURRENT(field); \
AST_LIST_INSERT_TAIL((newhead), __extracted, field); \
} while (0)
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092

Move the current list entry to another list.

Note
This is a silly macro. It should be done explicitly otherwise the field parameter must be the same for the two lists.

AST_LIST_REMOVE_CURRENT(field); AST_LIST_INSERT_TAIL(newhead, var, other_field);

Definition at line 581 of file linkedlists.h.

Referenced by dahdi_cc_callback(), dns_srv_sort(), handle_clear_alarms(), process_weights(), and restart_monitor().

◆ AST_LIST_NEXT

#define AST_LIST_NEXT (   elm,
  field 
)    ((elm)->field.next)

Returns the next entry in the list after the given entry.

Parameters
elmThis is a pointer to the current entry.
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 438 of file linkedlists.h.

Referenced by __ast_queue_frame(), __ast_read(), add_crypto_to_stream(), ast_dns_record_get_next(), ast_frame_clear(), ast_frame_free(), ast_sdp_srtp_destroy(), ast_slinfactory_feed(), ast_speech_results_free(), ast_srv_lookup(), AST_TEST_DEFINE(), ast_translate(), ast_write_stream(), ast_writestream(), ast_xml_doc_item_destructor(), build_cc_interfaces_chanvar(), cc_cli_print_monitor_stats(), chan_pjsip_read_stream(), cli_next(), cli_show_module_options(), cli_show_module_type(), cli_show_module_types(), complete_config_option(), complete_config_type(), conf_run(), copy_menu_entry(), create_dtmf_frame(), create_video_frame(), crypto_get_attrib(), deep_copy_peer(), do_devstate_changes(), find_result(), find_user(), find_xmldoc_option(), find_xmldoc_type(), group_count_function_read(), group_function_read(), group_list_function_read(), group_show_channels(), handle_keypad_button_message(), handle_manager_show_event(), handle_showmancmd(), handle_speechrecognize(), hook_event_cb(), lintocodec2_frameout(), lintogsm_frameout(), lintoilbc_frameout(), lintolpc10_frameout(), lintospeex_frameout(), logger_thread(), make_silence(), mixmonitor_thread(), peer_mailboxes_to_str(), res_sdp_crypto_parse_offer(), res_sdp_srtp_get_attr(), reschedule_precache(), setsubstate(), skinny_call(), speech_read(), spy_generate(), udptl_rx_packet(), update_ewscal(), update_qe_rule(), and wait_for_answer().

◆ AST_LIST_REMOVE

#define AST_LIST_REMOVE (   head,
  elm,
  field 
)

Removes a specific entry from a list.

Parameters
headThis is a pointer to the list head structure
elmThis is a pointer to the entry to be removed.
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.
Return values
elmif elm was in the list.
NULLif elm was not in the list or elm was NULL.
Warning
The removed entry is not freed.

Definition at line 855 of file linkedlists.h.

Referenced by __ast_module_user_remove(), __ast_queue_frame(), __attempt_transmit(), add_notify(), ast_audiohook_remove(), ast_autoservice_start(), ast_channel_clear_softhangup(), ast_channel_datastore_remove(), ast_sip_transport_state_unregister(), AST_TEST_DEFINE(), astman_datastore_remove(), bridge_channel_internal_pull(), conf_free(), conf_remove_user_active(), conf_remove_user_marked(), conf_remove_user_waiting(), dahdi_destroy_channel_range(), del_identifier(), delete_devices(), destroy_packet(), destroy_trans(), handle_frame(), iax2_process_thread(), iax_frame_new(), lock_info_destroy(), moh_release(), resend_with_token(), rtp_ioqueue_thread_remove(), setsubstate(), skinny_session_cleanup(), and unregister_request().

◆ AST_LIST_REMOVE_CURRENT

#define AST_LIST_REMOVE_CURRENT (   field)

Removes the current entry from a list during a traversal.

Parameters
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.
Note
This macro can only be used inside an AST_LIST_TRAVERSE_SAFE_BEGIN() block; it is used to unlink the current entry from the list without affecting the list traversal (and without having to re-traverse the list to modify the previous entry, if any).
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 556 of file linkedlists.h.

Referenced by __ast_frdup(), __ast_queue_frame(), __ast_read(), __ast_unregister_atexit(), acf_curlopt_write(), acf_iaxvar_write(), acf_jabberreceive_read(), add_menu_entry(), add_notify(), ao2_weakproxy_unsubscribe(), ast_autochan_destroy(), ast_autoservice_stop(), ast_calendar_unregister(), ast_channel_clear_bridge_roles(), ast_channel_remove_bridge_role(), ast_channel_unregister(), ast_data_buffer_remove(), ast_dial_destroy(), ast_event_new(), ast_format_cap_remove(), ast_format_cap_remove_by_type(), ast_framehook_list_destroy(), ast_loader_unregister(), ast_odbc_clear_cache(), ast_register_indication(), ast_sip_pubsub_unregister_body_generator(), ast_sip_pubsub_unregister_body_supplement(), AST_TEST_DEFINE(), ast_unlock_path_flock(), ast_unregister_indication(), audio_audiohook_write_list(), bridge_channel_handle_write(), bridge_sync_cleanup(), build_device(), build_peer(), cancel_available_timer(), cc_generic_monitor_destructor(), cc_monitor_failed(), clearvar_prefix(), close_client(), complete_dpreply(), config_cache_remove(), del_chan(), delete_device(), delete_old_messages(), dial_exec_full(), dial_masquerade_datastore_remove_chan(), dial_masquerade_fixup(), dns_naptr_sort(), dns_srv_sort(), do_pktccops(), dtmf_audiohook_write_list(), find_cache(), findmeexec(), forward_message(), framehook_list_push_event(), get_chan_by_ast_name(), hook_event_cb(), iax_firmware_reload(), iax_firmware_unload(), iax_frame_new(), iax_provision_free_templates(), inotify_daemon(), invite_proceeding(), invite_terminated(), leave_marked(), load_resource_list(), loader_config_init(), mysql_ds_destroy(), mysql_ds_fixup(), pbx_builtin_setvar_helper(), prometheus_metric_unregister(), prune_mappings(), prune_peers(), prune_tone_zone(), queue_created_files(), queue_file_open(), queue_file_write(), rcv_mac_addr(), remove_attended_transfer_stimulus(), remove_from_queue(), remove_handler(), remove_header(), request_cc(), reschedule_precache(), set_variable(), shared_write(), shaun_of_the_dead(), sip_removeheader(), skinny_reload(), sla_calc_station_timeouts(), sla_calc_trunk_timeouts(), sla_check_failed_station(), sla_choose_ringing_trunk(), sla_handle_dial_state_event(), sla_hangup_stations(), sla_station_exec(), sla_station_is_marked(), sla_trunk_exec(), sla_trunk_is_marked(), smart_bridge_operation(), softmix_translate_helper_change_rate(), softmix_translate_helper_cleanup(), suspend(), test_remove(), threadstorage_init(), timing_read(), transition_to_marked(), unistim_unalloc_sub(), unload_mysql(), unload_pgsql(), unsuspend(), vm_allocate_dh(), and vm_test_destroy_user().

◆ AST_LIST_REMOVE_HEAD

#define AST_LIST_REMOVE_HEAD (   head,
  field 
)

Removes and returns the head entry from a list.

Parameters
headThis is a pointer to the list head structure
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.

Removes the head entry from the list, and returns a pointer to it. This macro is safe to call on an empty list.

Definition at line 832 of file linkedlists.h.

Referenced by __ao2_ref(), __ast_answer(), __ast_module_user_hangup_all(), _ast_odbc_request_obj2(), _sip_tcp_helper_thread(), acf_fetch(), add_menu_entry(), add_notify(), after_bridge_cb_run_discard(), agi_destroy_commands_cb(), announce_thread(), app_exec(), append_history_va(), ast_audiohook_detach_list(), ast_autoservice_stop(), ast_bridge_run_after_callback(), ast_cdr_reset(), ast_channel_destructor(), ast_data_buffer_cache_adjust(), ast_data_buffer_free(), ast_data_buffer_put(), ast_data_buffer_remove_head(), ast_data_buffer_resize(), ast_destroy_template_list(), ast_dns_result_free(), ast_dummy_channel_destructor(), ast_frame_header_new(), ast_framehook_list_fixup(), ast_free_acl_list(), ast_get_srv(), ast_merge_contexts_and_delete(), ast_pbx_hangup_handler_destroy(), ast_pbx_hangup_handler_pop(), ast_pbx_hangup_handler_run(), ast_process_pending_reloads(), ast_rtp_interpret(), ast_run_atexits(), ast_sched_context_destroy(), ast_sip_session_remove_supplements(), ast_sip_session_terminate(), ast_slinfactory_destroy(), ast_slinfactory_flush(), ast_slinfactory_read(), ast_srv_lookup(), AST_TEST_DEFINE(), ast_tone_zone_destructor(), ast_var_list_destroy(), balance_stack(), bridge_channel_destroy(), bridge_channel_impart_ds_head_signal(), bridge_channel_queue_deferred_frames(), bridge_handle_actions(), bridge_manager_destroy(), bridge_manager_thread(), bridge_role_datastore_destroy(), bridge_role_destroy(), calendar_event_destructor(), cancel_request(), cc_extension_monitor_destructor(), cc_interface_tree_destroy(), cdr_object_dtor(), chan_cleanup(), channel_do_masquerade(), clean_time_zones(), cleanup_thread_list(), clear_mixmonitor_recipient_list(), clear_mock_cdr_backend(), clear_sip_domains(), clear_stimulus_queue(), close_logger(), conf_free(), conf_menu_entry_destroy(), config_cache_flush_includes(), config_shutdown(), copy_event_data(), curlds_free(), delete_devices(), delete_users(), destroy_all_mailbox_mappings(), destroy_calling_tree(), destroy_msg_headers(), destroy_packets(), destroy_permissions(), destroy_realm_authentication(), destroy_session_details(), destroy_table(), destroy_user_perms(), dial_masquerade_datastore_cleanup(), do_directory(), dundi_lookup_local(), eivr_comm(), eventlist_destructor(), find_idle_thread(), findmeexec(), format_cap_destroy(), forward_message(), frame_cache_cleanup(), free_config(), free_numbers(), free_strings(), free_variables(), free_vm_users(), free_vm_zones(), gen_nextfile(), gen_readframe(), generic_monitor_instance_list_destructor(), get_agi_cmd(), get_chan_by_ast_name(), gosub_free(), gosub_release_frame(), handle_cli_test_locales(), handle_deferred_full_frames(), hanguptree(), hook_event_cb(), iax2_free_variable_datastore(), init_queue(), jb_framedata_destroy(), join_conference_bridge(), leave_conference(), leave_queue(), load_modules(), load_stream_readqueue(), load_values_config(), lock_free(), loopback_subst(), manager_shutdown(), menu_destructor(), menu_hook_destroy(), message_destroy_list(), moh_class_destructor(), msg_queue_pop(), my_load_module(), odbc_class_destructor(), odbc_datastore_free(), odbc_txn_free(), offered_media_list_destroy(), pbx_builtin_clear_globals(), pktccops_unregister_cmtses(), pktccops_unregister_ippools(), pop_exec(), process_precache(), profile_destructor(), prometheus_metric_free(), prometheus_metric_unregister(), pvt_destructor(), queue_reload_request(), release_doomed_pris(), reload_queue_rules(), return_exec(), safe_sleep_conditional(), scan_thread(), sched_alloc(), send_signaling(), session_destroy(), session_destructor(), set_sched_id(), shared_variable_free(), sip_epa_unregister_all(), sip_outbound_publish_callback(), sip_outbound_publisher_destroy(), sip_publisher_service_queue(), sip_pvt_dtor(), sip_route_clear(), sip_threadinfo_destructor(), skinny_reload(), sla_station_release_refs(), sla_stop_ringing_trunk(), sla_thread(), sla_trunk_release_refs(), softmix_translate_helper_destroy(), spandsp_fax_read(), table_configs_free(), timezone_destroy_list(), tps_taskprocessor_dtor(), tps_taskprocessor_pop(), unload_module(), unregister_translators(), user_destructor(), verify_mock_cdr_record(), vm_mailbox_snapshot_destroy(), vmaccounts_destroy_list(), wait_for_stimulus(), and xmpp_client_destructor().

◆ AST_LIST_TRAVERSE

#define AST_LIST_TRAVERSE (   head,
  var,
  field 
)    for((var) = (head)->first; (var); (var) = (var)->field.next)

Loops over (traverses) the entries in a list.

Parameters
headThis is a pointer to the list head structure
varThis is the name of the variable that will hold a pointer to the current list entry on each iteration. It must be declared before calling this macro.
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.

This macro is use to loop over (traverse) the entries in a list. It uses a for loop, and supplies the enclosed code with a pointer to each list entry as it loops. It is typically used as follows:

static AST_LIST_HEAD(entry_list, list_entry) entries;
...
struct list_entry {
...
AST_LIST_ENTRY(list_entry) list;
}
...
struct list_entry *current;
...
AST_LIST_TRAVERSE(&entries, current, list) {
(do something with current here)
}
Warning
If you modify the forward-link pointer contained in the current entry while inside the loop, the behavior will be unpredictable. At a minimum, the following macros will modify the forward-link pointer, and should not be used inside AST_LIST_TRAVERSE() against the entry pointed to by the current pointer without careful consideration of their consequences:

Definition at line 490 of file linkedlists.h.

Referenced by __ast_queue_frame(), __stasis_app_register(), _sip_show_peer(), _skinny_message_clear(), _skinny_message_set(), _skinny_show_device(), _skinny_show_devices(), _skinny_show_line(), _skinny_show_lines(), acf_curl_helper(), acf_curlopt_helper(), acf_iaxvar_read(), acf_meetme_info(), ack_trans(), action_confbridgelist(), action_confbridgesetsinglevideosrc(), action_meetmelist(), action_meetmelistrooms(), action_toggle_mute_participants(), add_headers_to_message(), add_identifier(), add_peer_mailboxes(), add_peer_mwi_subs(), add_sdp(), add_sdp_streams(), add_text(), add_to_load_order(), admin_exec(), app_control_check_rules(), app_event_source_find(), app_event_sources_to_json(), app_exec(), append_channel_vars(), apply_menu_to_user(), ast_acl_output(), ast_append_acl(), ast_apply_acl_internal(), ast_autochan_new_channel(), ast_autoservice_ignore(), ast_autoservice_start(), ast_bridge_channel_establish_roles(), ast_bridge_channel_peer(), ast_bridge_channel_update_linkedids(), ast_bridge_peer_nolock(), ast_bridge_peers_nolock(), ast_bridge_queue_everyone_else(), ast_bridge_snapshot_create(), ast_calendar_register(), ast_category_get_templates(), ast_cc_extension_monitor_add_dialstring(), ast_cc_get_monitor_by_recall_core_id(), ast_cc_is_recall(), ast_cdr_serialize_variables(), ast_channel_audiohook_count_by_source(), ast_channel_audiohook_count_by_source_running(), ast_channel_datastore_find(), ast_channel_datastore_inherit(), ast_channel_get_vars(), ast_channel_inherit_variables(), ast_cli_perms_init(), ast_config_text_file_save2(), ast_data_buffer_get(), ast_debug_get_by_module(), ast_dial_hangup(), ast_dial_prerun(), ast_dns_resolver_register(), ast_dump_locks(), ast_duplicate_acl_list(), ast_event_new(), ast_format_cap_get_compatible_format(), ast_format_cap_get_format_framing(), ast_format_cap_iscompatible_format(), ast_framehook_list_contains_no_active_of_type(), ast_get_indication_tone(), ast_handle_cc_control_frame(), ast_json_channel_vars(), ast_log_show_lock(), ast_manager_build_channel_state_string_prefix(), ast_odbc_retrieve_transaction_obj(), ast_pbx_hangup_handler_show(), ast_set_cc_interfaces_chanvar(), ast_sip_send_out_of_dialog_request(), ast_sip_session_register_sdp_handler(), ast_sip_transport_state_register(), ast_slinfactory_feed(), ast_srv_get_nth_record(), ast_srv_lookup(), ast_str_retrieve_variable(), AST_TEST_DEFINE(), ast_test_register_cleanup(), ast_test_register_init(), ast_trace_get_by_module(), ast_tzset(), ast_unreal_call_setup(), ast_update_use_count(), ast_var_find(), ast_verb_update(), ast_xmldoc_build_documentation(), ast_xmldoc_query(), audiohook_list_set_samplerate_compatibility(), autoservice_run(), basic_hangup_hook(), begin_dial(), bridge_channel_update_accountcodes_joining(), bridge_complete_join(), bridge_dissolve(), bridge_find_channel(), build_cc_interfaces_chanvar(), build_conf(), build_mapping(), build_peer(), build_transactions(), build_user_routes(), calendar_join_attendees(), calendar_query_result_exec(), cc_extension_monitor_change_is_valid(), cc_generic_monitor_destructor(), cc_generic_monitor_suspend(), cc_generic_monitor_unsuspend(), cc_status_response(), cdr_format_var_internal(), cdr_object_create_public_records(), cdr_object_format_var_internal(), channel_admin_exec(), channel_get_external_vars(), check_binaural_position_change(), check_bridge_play_sounds(), check_request(), check_sip_domain(), clear_unanswered_calls(), cli_has_permissions(), clone_variables(), common_startup(), complete_bridge_participant(), complete_confbridge_participant(), complete_confno(), complete_indications(), complete_meetmecmd_mute_kick(), complete_minivm_show_users(), complete_peer_helper(), complete_queue_rule_show(), complete_skinny_devices(), complete_skinny_show_line(), complete_test_category(), complete_test_name(), complete_transfer(), complete_voicemail_show_users(), conf_exec(), conf_find_menu_entry_by_sequence(), conf_menu_profile_copy(), conf_send_event_to_participants(), confbridge_handle_atxfer(), config_cache_attribute(), config_device(), config_line(), config_parse_variables(), config_text_file_load(), cops_gate_cmd(), copy_menu_entry(), copy_rules(), copy_to_voicemail(), copy_variables(), count_monitors_cb(), create_transaction(), custom_log(), dahdi_cc_callback(), deep_copy_peer(), del_identifier(), destroy_trans(), dial_exec_full(), dial_masquerade_breakdown(), dial_masquerade_fixup(), discover_transactions(), dns_naptr_sort(), dns_srv_sort(), do_directory(), do_monitor(), do_pktccops(), dumpsub(), dundi_answer_query(), dundi_flush(), dundi_ie_append_eid_appropriately(), dundi_precache_full(), dundi_precache_internal(), dundi_prop_precache(), dundi_show_mappings(), dundi_show_peer(), dundi_show_peers(), dundi_show_precache(), dundi_show_requests(), dundi_show_trans(), execute_menu_entry(), find_account(), find_audiohook_by_source(), find_body_generator_type_subtype_nolock(), find_by_locale(), find_by_name(), find_chan(), find_column(), find_conf(), find_conf_realtime(), find_dial_channel(), find_header(), find_identifier(), find_line_by_instance(), find_line_by_name(), find_line_by_number(), find_module_level(), find_or_create(), find_peer(), find_realm_authentication(), find_relative_dial_channel(), find_rtp_port(), find_speeddial_by_instance(), find_static_data(), find_subchannel_by_instance_reference(), find_subchannel_by_name(), find_subchannel_by_reference(), find_subline_by_callid(), find_subline_by_name(), find_table(), find_tpeer(), find_transaction(), find_user(), findmeexec(), frame_set_var(), func_confbridge_info(), generate_filenames_json(), generate_filenames_string(), generate_status(), generic_monitor_devstate_tp_cb(), generic_mute_unmute_helper(), get_button_template(), get_cached_mwi(), get_chan_by_ast_name(), get_devicestate(), get_lock(), get_role_from_datastore(), get_role_option(), get_sub(), get_sub_holding(), get_trans_id(), gmtsub(), handle_bridge_kick_channel(), handle_button_template_req_message(), handle_capabilities_res_message(), handle_cli_confbridge_list(), handle_cli_confbridge_show_menu(), handle_cli_config_list(), handle_cli_config_reload(), handle_cli_iax2_show_cache(), handle_cli_iax2_show_registry(), handle_cli_iax2_show_stats(), handle_cli_iax2_show_threads(), handle_cli_indication_show(), handle_cli_locks_show(), handle_cli_mixmonitor(), handle_cli_realtime_mysql_cache(), handle_cli_realtime_pgsql_cache(), handle_cli_show_permissions(), handle_dump_docs(), handle_incoming_request(), handle_incoming_response(), handle_incoming_sdp(), handle_minivm_list_templates(), handle_minivm_show_users(), handle_minivm_show_zones(), handle_negotiated_sdp_session_media(), handle_outgoing_request(), handle_outgoing_response(), handle_queue_rule_show(), handle_session_begin(), handle_session_destroy(), handle_session_end(), handle_show_calendars_types(), handle_show_chanvar(), handle_show_globals(), handle_showchan(), handle_skinny_reset(), handle_timeout_trip(), handle_video_on_exit(), handle_video_on_join(), handle_voicemail_show_users(), handle_voicemail_show_zones(), has_device_monitors(), has_media_stream(), has_permission(), has_supplement(), hashkeys_read(), hashkeys_read2(), holding_bridge_join(), holding_bridge_leave(), iax2_call(), iax2_dup_variable_datastore(), iax_firmware_append(), iax_firmware_get_version(), iax_firmware_reload(), iax_firmware_traverse(), iax_prov_complete_template(), iax_provision_reload(), iax_show_provisioning(), iax_template_find(), inherit_channel_vars_from_id(), insert_penaltychange(), is_already_registered(), kick_conference_participant(), leave_marked(), list_expect(), load_module(), load_modules(), load_pktccops_config(), load_realtime_rules(), load_values_config(), local_read(), lock_fixup(), manager_iax2_show_registry(), manager_list_voicemail_users(), manager_queue_rule_show(), map_source_to_destinations(), mark_mappings(), mark_peers(), mark_transaction_active(), meetme_show_cmd(), meetmemute(), meetmestate(), message_template_find(), mock_cdr_backend_cb(), monitor_dial(), monmp3thread(), mwi_event_cb(), mwi_monitor_handler(), native_bridge_changed(), native_bridge_compatible(), native_request_start(), native_stop(), network_change_sched_cb(), odbc_log(), on_personality_change_normal(), optimize_transactions(), ospauth_exec(), ospfinished_exec(), osplookup_exec(), ospnext_exec(), outgoing_request(), pbx_builtin_getvar_helper(), pbx_builtin_serialize_variables(), peek_read(), peer_mailboxes_to_str(), pktccops_gatedel(), pktccops_gateset(), pktccops_show_cmtses(), pktccops_show_gates(), pktccops_show_pools(), play_message_datetime(), pp_each_extension_helper(), precache_transactions(), process_weights(), prometheus_metric_register(), prometheus_metric_to_string(), publish_dial_end_event(), pvt_destructor(), query_transactions(), queue_file(), queue_file_create(), queue_reload_request(), rcv_mac_addr(), rebuild_channels(), register_request(), release_doomed_pris(), reload(), reload_config(), reload_followme(), remove_hooks_on_personality_change(), require_mysql(), require_pgsql(), reset_user_pw(), restart_monitor(), rtp_add_candidates_to_ice(), rtp_ioqueue_thread_get_or_create(), sdp_requires_deferral(), send_request_cb(), sendfax_exec(), sendmail(), session_outgoing_nat_hook(), set_bridge_peer_vars_holding(), set_bridge_peer_vars_multiparty(), setsubstate(), setup_dahdi_int(), sfu_topologies_on_join(), sfu_topologies_on_leave(), sfu_topologies_on_source_change(), shared_read(), sip_call(), sip_dump_history(), sip_show_domains(), sip_show_history(), sip_show_settings(), skinny_call(), skinny_register(), skinny_reload(), skinny_session_cleanup(), sla_add_trunk_to_station(), sla_build_station(), sla_calc_station_timeouts(), sla_change_trunk_state(), sla_check_inuse_station(), sla_check_ringing_station(), sla_check_station_hold_access(), sla_check_timed_out_station(), sla_choose_idle_trunk(), sla_choose_ringing_trunk(), sla_find_trunk_ref(), sla_find_trunk_ref_byname(), sla_hangup_stations(), sla_queue_event_conf(), sla_ring_stations(), sla_show_stations(), sla_show_trunks(), sla_state(), sla_station_destructor(), sla_station_mark(), sla_stop_ringing_station(), sla_trunk_mark(), smart_bridge_operation(), socket_process_helper(), socket_read(), softmix_bridge_stream_sources_update(), softmix_bridge_stream_topology_changed(), softmix_mixing_loop(), softmix_pass_video_top_priority(), softmix_process_write_audio(), stackpeek_read(), stir_shaken_read(), stream_destroy(), supplement_on_rx_request(), supplement_outgoing_response(), syslog_log(), table_config_for_table_name(), test_cli_show_registered(), test_cli_show_results(), test_execute_multiple(), test_generate_results(), test_vm_api_destroy_mailbox_voicemails(), test_vm_api_update_test_snapshots(), threadstorage_init(), tone_zone_mark(), transmit_invite(), transmit_serviceurlstat(), transport_state_callback(), try_firmware(), unistim_show_info(), unload_module(), unlock_read(), update_pgsql(), vm_allocate_dh(), vmu_tm(), vnak_retransmit(), wait_for_answer(), wait_for_winner(), write_cel(), and xmldoc_get_node().

◆ AST_LIST_TRAVERSE_SAFE_BEGIN

#define AST_LIST_TRAVERSE_SAFE_BEGIN (   head,
  var,
  field 
)

Loops safely over (traverses) the entries in a list.

Parameters
headThis is a pointer to the list head structure
varThis is the name of the variable that will hold a pointer to the current list entry on each iteration. It must be declared before calling this macro.
fieldThis is the name of the field (declared using AST_LIST_ENTRY()) used to link entries of this list together.

This macro is used to safely loop over (traverse) the entries in a list. It uses a for loop, and supplies the enclosed code with a pointer to each list entry as it loops. It is typically used as follows:

static AST_LIST_HEAD(entry_list, list_entry) entries;
...
struct list_entry {
...
AST_LIST_ENTRY(list_entry) list;
}
...
struct list_entry *current;
...
AST_LIST_TRAVERSE_SAFE_BEGIN(&entries, current, list) {
(do something with current here)
}

It differs from AST_LIST_TRAVERSE() in that the code inside the loop can modify (or even free, after calling AST_LIST_REMOVE_CURRENT()) the entry pointed to by the current pointer without affecting the loop traversal.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 528 of file linkedlists.h.

Referenced by __ast_frdup(), __ast_queue_frame(), __ast_read(), __ast_unregister_atexit(), acf_curlopt_write(), acf_iaxvar_write(), acf_jabberreceive_read(), add_event_to_list(), add_menu_entry(), add_notify(), ao2_weakproxy_unsubscribe(), ast_audiohook_move_all(), ast_autochan_destroy(), ast_autoservice_stop(), ast_calendar_unregister(), ast_channel_clear_bridge_roles(), ast_channel_remove_bridge_role(), ast_data_buffer_put(), ast_data_buffer_remove(), ast_data_buffer_resize(), ast_dial_destroy(), ast_event_new(), ast_format_cap_remove(), ast_format_cap_remove_by_type(), ast_framehook_detach(), ast_framehook_list_destroy(), ast_framehook_list_fixup(), ast_loader_unregister(), ast_register_indication(), AST_TEST_DEFINE(), ast_unlock_path_flock(), ast_unregister_indication(), astman_datastore_find(), audio_audiohook_write_list(), bridge_channel_handle_write(), bridge_do_merge(), bridge_sync_cleanup(), build_device(), build_peer(), cancel_available_timer(), cc_generic_monitor_destructor(), cc_monitor_failed(), channel_do_masquerade(), clearvar_prefix(), close_client(), complete_dpreply(), config_cache_remove(), dahdi_cc_callback(), dahdi_destroy_channel_range(), defer_full_frame(), del_chan(), delete_device(), delete_old_messages(), dial_exec_full(), dial_masquerade_datastore_remove_chan(), dial_masquerade_fixup(), dns_naptr_sort(), dns_srv_sort(), do_pktccops(), dtmf_audiohook_write_list(), find_cache(), findmeexec(), forward_message(), framehook_list_push_event(), get_chan_by_ast_name(), handle_clear_alarms(), hook_event_cb(), iax_firmware_reload(), iax_firmware_unload(), iax_frame_new(), iax_provision_free_templates(), inotify_daemon(), insert_penaltychange(), invite_proceeding(), invite_terminated(), leave_marked(), load_realtime_rules(), load_resource_list(), loader_config_init(), mysql_ds_destroy(), mysql_ds_fixup(), pbx_builtin_setvar_helper(), precache_transactions(), process_weights(), prometheus_metric_unregister(), prune_mappings(), prune_peers(), prune_tone_zone(), queue_created_files(), queue_file(), queue_file_open(), queue_file_write(), rcv_mac_addr(), remove_attended_transfer_stimulus(), remove_from_queue(), remove_handler(), remove_header(), request_cc(), reschedule_precache(), restart_monitor(), set_variable(), shared_write(), shaun_of_the_dead(), sip_removeheader(), skinny_reload(), sla_calc_station_timeouts(), sla_calc_trunk_timeouts(), sla_check_failed_station(), sla_choose_ringing_trunk(), sla_handle_dial_state_event(), sla_hangup_stations(), sla_station_exec(), sla_station_is_marked(), sla_trunk_exec(), sla_trunk_is_marked(), smart_bridge_operation(), softmix_translate_helper_change_rate(), softmix_translate_helper_cleanup(), srv_callback(), suspend(), test_remove(), threadstorage_init(), timing_read(), transition_to_marked(), unistim_unalloc_sub(), unload_module(), unload_mysql(), unload_pgsql(), unsuspend(), vm_allocate_dh(), vm_msg_snapshot_create(), and vm_test_destroy_user().

◆ AST_LIST_TRAVERSE_SAFE_END

#define AST_LIST_TRAVERSE_SAFE_END   }

Closes a safe loop traversal block.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 614 of file linkedlists.h.

Referenced by __ast_frdup(), __ast_queue_frame(), __ast_read(), __ast_unregister_atexit(), acf_curlopt_write(), acf_iaxvar_write(), acf_jabberreceive_read(), add_event_to_list(), add_menu_entry(), add_notify(), ao2_weakproxy_unsubscribe(), ast_audiohook_move_all(), ast_autochan_destroy(), ast_autoservice_stop(), ast_calendar_unregister(), ast_channel_clear_bridge_roles(), ast_channel_remove_bridge_role(), ast_channel_unregister(), ast_data_buffer_put(), ast_data_buffer_remove(), ast_data_buffer_resize(), ast_dial_destroy(), ast_event_new(), ast_format_cap_remove(), ast_format_cap_remove_by_type(), ast_framehook_detach(), ast_framehook_list_destroy(), ast_framehook_list_fixup(), ast_loader_unregister(), ast_register_indication(), AST_TEST_DEFINE(), ast_unlock_path_flock(), ast_unregister_indication(), astman_datastore_find(), audio_audiohook_write_list(), bridge_channel_handle_write(), bridge_do_merge(), bridge_sync_cleanup(), build_device(), build_peer(), cancel_available_timer(), cc_generic_monitor_destructor(), cc_monitor_failed(), channel_do_masquerade(), clearvar_prefix(), close_client(), complete_dpreply(), config_cache_remove(), dahdi_cc_callback(), dahdi_destroy_channel_range(), defer_full_frame(), del_chan(), delete_device(), delete_old_messages(), dial_exec_full(), dial_masquerade_datastore_remove_chan(), dial_masquerade_fixup(), dns_naptr_sort(), dns_srv_sort(), do_pktccops(), dtmf_audiohook_write_list(), find_cache(), findmeexec(), forward_message(), framehook_list_push_event(), get_chan_by_ast_name(), handle_clear_alarms(), hook_event_cb(), iax_firmware_reload(), iax_firmware_unload(), iax_frame_new(), iax_provision_free_templates(), inotify_daemon(), insert_penaltychange(), invite_proceeding(), invite_terminated(), leave_marked(), load_realtime_rules(), load_resource_list(), loader_config_init(), mysql_ds_destroy(), mysql_ds_fixup(), pbx_builtin_setvar_helper(), precache_transactions(), process_weights(), prometheus_metric_unregister(), prune_mappings(), prune_peers(), prune_tone_zone(), queue_created_files(), queue_file(), queue_file_open(), queue_file_write(), rcv_mac_addr(), remove_attended_transfer_stimulus(), remove_from_queue(), remove_handler(), remove_header(), request_cc(), reschedule_precache(), restart_monitor(), set_variable(), shared_write(), shaun_of_the_dead(), sip_removeheader(), skinny_reload(), sla_calc_station_timeouts(), sla_calc_trunk_timeouts(), sla_check_failed_station(), sla_choose_ringing_trunk(), sla_handle_dial_state_event(), sla_hangup_stations(), sla_station_exec(), sla_station_is_marked(), sla_trunk_exec(), sla_trunk_is_marked(), smart_bridge_operation(), softmix_translate_helper_change_rate(), softmix_translate_helper_cleanup(), srv_callback(), suspend(), test_remove(), threadstorage_init(), timing_read(), transition_to_marked(), unistim_unalloc_sub(), unload_module(), unload_mysql(), unload_pgsql(), unsuspend(), vm_allocate_dh(), vm_msg_snapshot_create(), and vm_test_destroy_user().

◆ AST_LIST_TRYLOCK

#define AST_LIST_TRYLOCK (   head)    ast_mutex_trylock(&(head)->lock)

Locks a list, without blocking if the list is locked.

Parameters
headThis is a pointer to the list head structure

This macro attempts to place an exclusive lock in the list head structure pointed to by head.

Return values
0on success
non-zeroon failure

Definition at line 104 of file linkedlists.h.

Referenced by add_notify().

◆ AST_LIST_UNLOCK

#define AST_LIST_UNLOCK (   head)    ast_mutex_unlock(&(head)->lock)

Attempts to unlock a list.

Parameters
headThis is a pointer to the list head structure

This macro attempts to remove an exclusive lock from the list head structure pointed to by head. If the list was not locked by this thread, this macro has no effect.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 139 of file linkedlists.h.

Referenced by __ast_module_user_add(), __ast_module_user_hangup_all(), __ast_module_user_remove(), _skinny_message_clear(), _skinny_message_set(), _skinny_show_device(), _skinny_show_devices(), _skinny_show_line(), _skinny_show_lines(), abort_request(), acf_curl_helper(), acf_curlopt_helper(), acf_curlopt_write(), acf_fetch(), acf_iaxvar_read(), acf_iaxvar_write(), acf_jabberreceive_read(), acf_meetme_info(), acl_to_str(), action_meetmelist(), action_meetmelistrooms(), actual_load_config(), add_agi_cmd(), add_identifier(), add_notify(), add_sip_domain(), admin_exec(), after_bridge_cb_fixup(), after_bridge_cb_run_discard(), agi_destroy_commands_cb(), ast_acl_list_is_empty(), ast_acl_output(), ast_append_acl(), ast_apply_acl_internal(), ast_autoservice_ignore(), ast_autoservice_start(), ast_autoservice_stop(), ast_bridge_run_after_callback(), ast_bridge_set_after_callback(), ast_calendar_register(), ast_calendar_unregister(), ast_cc_agent_set_interfaces_chanvar(), ast_cc_call_init(), ast_cc_extension_monitor_add_dialstring(), ast_cc_get_monitor_by_recall_core_id(), ast_cc_is_recall(), ast_devstate_changed_literal(), ast_dial_destroy(), ast_dial_hangup(), ast_dial_join(), ast_dial_prerun(), ast_duplicate_acl_list(), ast_free_acl_list(), ast_handle_cc_control_frame(), ast_loader_register(), ast_loader_unregister(), ast_localtime_wakeup_monitor(), ast_lock_path_flock(), ast_log_full(), ast_odbc_retrieve_transaction_obj(), ast_process_pending_reloads(), ast_run_atexits(), ast_safe_fork(), ast_set_cc_interfaces_chanvar(), ast_setlocale(), AST_TEST_DEFINE(), ast_test_register_cleanup(), ast_test_register_init(), ast_tzset(), ast_unlock_path_flock(), ast_unregister_atexit(), ast_update_use_count(), autoservice_run(), balance_stack(), begin_dial(), build_conf(), build_device(), build_peer(), build_transactions(), build_translators(), cancel_available_timer(), cancel_request(), cb_events(), cc_monitor_failed(), cc_status_response(), channel_admin_exec(), check_request(), check_sip_domain(), clean_time_zones(), cleanup_thread_list(), clear_mock_cdr_backend(), clear_sip_domains(), close_client(), close_logger(), common_startup(), complete_confno(), complete_dpreply(), complete_meetmecmd_mute_kick(), complete_peer_helper(), complete_queue_rule_show(), complete_test_category(), complete_test_name(), conf_exec(), conf_free(), conf_play(), conf_run(), config_cache_attribute(), config_cache_remove(), config_device(), config_line(), config_shutdown(), config_text_file_load(), contact_acl_to_str(), cops_gate_cmd(), copy_rules(), count_monitors_cb(), create_transaction(), create_vmaccount(), dahdi_cc_callback(), dahdi_destroy_channel_range(), del_identifier(), delete_device(), delete_devices(), delete_old_messages(), delete_users(), device_state_engine_cleanup(), discover_transactions(), dispose_conf(), do_devstate_changes(), do_monitor(), do_pktccops(), dundi_flush(), dundi_ie_append_eid_appropriately(), dundi_lookup_thread(), dundi_precache_internal(), dundi_precache_thread(), dundi_query_thread(), dundi_rexmit(), dundi_show_entityid(), dundi_show_mappings(), dundi_show_peer(), dundi_show_peers(), dundi_show_precache(), dundi_show_requests(), dundi_show_trans(), eivr_comm(), find_account(), find_cache(), find_conf(), find_conf_realtime(), find_dial_channel(), find_identifier(), find_idle_thread(), find_line_by_name(), find_line_by_number(), find_relative_dial_channel(), find_rtp_port(), find_static_data(), find_subchannel_by_name(), find_subline_by_name(), find_table(), find_tpeer(), find_transaction(), find_user(), free_strings(), free_vm_users(), free_vm_zones(), gen_nextfile(), gen_readframe(), get_agi_cmd(), get_button_template(), get_chan_by_ast_name(), get_lock(), get_sub(), get_sub_holding(), gmtsub(), gosub_exec(), gosub_free(), handle_call_forward(), handle_clear_alarms(), handle_cli_config_list(), handle_cli_config_reload(), handle_cli_iax2_show_cache(), handle_cli_iax2_show_registry(), handle_cli_iax2_show_threads(), handle_cli_locks_show(), handle_cli_realtime_mysql_cache(), handle_cli_realtime_pgsql_cache(), handle_command_response(), handle_frame(), handle_minivm_list_templates(), handle_minivm_show_users(), handle_minivm_show_zones(), handle_queue_rule_show(), handle_show_calendars_types(), handle_skinny_reset(), handle_voicemail_show_users(), handle_voicemail_show_zones(), iax2_append_register(), iax2_call(), iax2_canmatch(), iax2_dup_variable_datastore(), iax2_exec(), iax2_exists(), iax2_free_variable_datastore(), iax2_matchmore(), iax2_process_thread(), iax_firmware_append(), iax_firmware_get_version(), iax_firmware_reload(), iax_firmware_traverse(), iax_firmware_unload(), inotify_daemon(), insert_idle_thread(), load_module(), load_zonemessages(), local_read(), local_write(), lock_fixup(), lock_free(), logger_thread(), manager_iax2_show_registry(), manager_list_voicemail_users(), manager_queue_rule_show(), mark_mappings(), mark_peers(), mark_transaction_active(), meetme_show_cmd(), meetmemute(), meetmestate(), message_destroy_list(), message_template_build(), message_template_find(), misdn_call(), misdn_facility_ie_handler(), misdn_request(), mock_cdr_backend_cb(), monitor_dial(), my_load_config_string(), mysql_ds_destroy(), mysql_ds_fixup(), network_change_sched_cb(), network_thread(), odbc_datastore_free(), odbc_txn_free(), optimize_transactions(), pktccops_add_ippool(), pktccops_gatedel(), pktccops_gateset(), pktccops_show_cmtses(), pktccops_show_gates(), pktccops_show_pools(), pktccops_unregister_cmtses(), pktccops_unregister_ippools(), play_message_datetime(), pop_exec(), precache_transactions(), print_stats_cb(), process_precache(), prune_mappings(), prune_peers(), query_transactions(), queue_file(), queue_reload_request(), rcv_mac_addr(), recordthread(), register_atexit(), register_request(), release_doomed_pris(), reload(), reload_config(), reload_queue_rules(), remove_from_queue(), request_cc(), reschedule_precache(), reset_user_pw(), restart_monitor(), return_exec(), rtp_ioqueue_thread_get_or_create(), rtp_ioqueue_thread_remove(), scan_thread(), sendmail(), set_config(), setup_dahdi_int(), shaun_of_the_dead(), sip_epa_register(), sip_epa_unregister_all(), sip_show_domains(), skinny_register(), skinny_reload(), skinny_session(), skinny_session_cleanup(), socket_process_helper(), socket_read(), stackpeek_read(), start_network_thread(), store_by_locale(), suspend(), test_cli_execute_registered(), test_cli_show_registered(), test_cli_show_results(), test_execute_multiple(), test_generate_results(), test_insert(), test_remove(), timezone_add(), timezone_destroy_list(), timing_read(), unistim_alloc_sub(), unistim_show_info(), unistim_unalloc_sub(), unload_module(), unload_mysql(), unload_pgsql(), unlock_read(), unregister_request(), unregister_translators(), unsuspend(), verify_mock_cdr_record(), vm_allocate_dh(), vm_test_destroy_user(), vmaccounts_destroy_list(), vmu_tm(), wait_for_digits(), and xmpp_pak_message().

◆ AST_RWLIST_APPEND_LIST

#define AST_RWLIST_APPEND_LIST   AST_LIST_APPEND_LIST

Definition at line 797 of file linkedlists.h.

◆ AST_RWLIST_EMPTY

#define AST_RWLIST_EMPTY   AST_LIST_EMPTY

◆ AST_RWLIST_ENTRY

#define AST_RWLIST_ENTRY   AST_LIST_ENTRY

Definition at line 414 of file linkedlists.h.

◆ AST_RWLIST_FIRST

#define AST_RWLIST_FIRST   AST_LIST_FIRST

◆ AST_RWLIST_HEAD

#define AST_RWLIST_HEAD (   name,
  type 
)
Value:
struct name { \
struct type *first; \
struct type *last; \
ast_rwlock_t lock; \
}
static const char type[]
Definition: chan_ooh323.c:109
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
ast_mutex_t lock
Definition: app_meetme.c:1091
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092
static const char name[]
Definition: cdr_mysql.c:74

Defines a structure to be used to hold a read/write list of specified type.

Parameters
nameThis will be the name of the defined structure.
typeThis is the type of each list entry.

This macro creates a structure definition that can be used to hold a list of the entries of type type. It does not actually declare (allocate) a structure; to do that, either follow this macro with the desired name of the instance you wish to declare, or use the specified name to declare instances elsewhere.

Example usage:

static AST_RWLIST_HEAD(entry_list, entry) entries;

This would define struct entry_list, and declare an instance of it named entries, all intended to hold a list of type struct entry.

Definition at line 198 of file linkedlists.h.

◆ AST_RWLIST_HEAD_DESTROY

#define AST_RWLIST_HEAD_DESTROY (   head)
Value:
{ \
(head)->first = NULL; \
(head)->last = NULL; \
ast_rwlock_destroy(&(head)->lock); \
}
#define NULL
Definition: resample.c:96
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
ast_mutex_t lock
Definition: app_meetme.c:1091
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092

Destroys an rwlist head structure.

Parameters
headThis is a pointer to the list head structure

This macro destroys a list head structure by setting the head entry to NULL (empty list) and destroying the embedded lock. It does not free the structure from memory.

Definition at line 666 of file linkedlists.h.

Referenced by destroy_headers(), destroy_table_cache(), free_table(), and unload_module().

◆ AST_RWLIST_HEAD_INIT

#define AST_RWLIST_HEAD_INIT (   head)
Value:
{ \
(head)->first = NULL; \
(head)->last = NULL; \
ast_rwlock_init(&(head)->lock); \
}
#define NULL
Definition: resample.c:96
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
ast_mutex_t lock
Definition: app_meetme.c:1091
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092

Initializes an rwlist head structure.

Parameters
headThis is a pointer to the list head structure

This macro initializes a list head structure by setting the head entry to NULL (empty list) and recreating the embedded lock.

Definition at line 638 of file linkedlists.h.

Referenced by ast_channels_init(), ast_odbc_find_table(), ast_sip_initialize_global_headers(), find_table(), and load_module().

◆ AST_RWLIST_HEAD_INIT_VALUE

#define AST_RWLIST_HEAD_INIT_VALUE
Value:
{ \
.first = NULL, \
.last = NULL, \
}
#define NULL
Definition: resample.c:96
#define AST_RWLOCK_INIT_VALUE
Definition: lock.h:98

Defines initial values for a declaration of AST_RWLIST_HEAD.

Definition at line 242 of file linkedlists.h.

◆ AST_RWLIST_HEAD_SET

#define AST_RWLIST_HEAD_SET (   head,
  entry 
)
Value:
do { \
(head)->first = (entry); \
(head)->last = (entry); \
ast_rwlock_init(&(head)->lock); \
} while (0)
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
ast_mutex_t lock
Definition: app_meetme.c:1091
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092
Definition: search.h:40

Initializes an rwlist head structure with a specified first entry.

Parameters
headThis is a pointer to the list head structure
entrypointer to the list entry that will become the head of the list

This macro initializes a list head structure by setting the head entry to the supplied value and recreating the embedded lock.

Definition at line 373 of file linkedlists.h.

◆ AST_RWLIST_HEAD_STATIC

#define AST_RWLIST_HEAD_STATIC (   name,
  type 
)
Value:
struct name { \
struct type *first; \
struct type *last; \
ast_rwlock_t lock; \
static const char type[]
Definition: chan_ooh323.c:109
#define AST_RWLIST_HEAD_INIT_VALUE
Defines initial values for a declaration of AST_RWLIST_HEAD.
Definition: linkedlists.h:242
struct sla_ringing_trunk * last
Definition: app_meetme.c:1092
ast_mutex_t lock
Definition: app_meetme.c:1091
struct sla_ringing_trunk * first
Definition: app_meetme.c:1092
static const char name[]
Definition: cdr_mysql.c:74

Defines a structure to be used to hold a read/write list of specified type, statically initialized.

Parameters
nameThis will be the name of the defined structure.
typeThis is the type of each list entry.

This macro creates a structure definition that can be used to hold a list of the entries of type type, and allocates an instance of it, initialized to be empty.

Example usage:

This would define struct entry_list, intended to hold a list of type struct entry.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 332 of file linkedlists.h.

◆ AST_RWLIST_INSERT_AFTER

#define AST_RWLIST_INSERT_AFTER   AST_LIST_INSERT_AFTER

◆ AST_RWLIST_INSERT_BEFORE_CURRENT

#define AST_RWLIST_INSERT_BEFORE_CURRENT   AST_LIST_INSERT_BEFORE_CURRENT

◆ AST_RWLIST_INSERT_HEAD

#define AST_RWLIST_INSERT_HEAD   AST_LIST_INSERT_HEAD

◆ AST_RWLIST_INSERT_LIST_AFTER

#define AST_RWLIST_INSERT_LIST_AFTER   AST_LIST_INSERT_LIST_AFTER

Definition at line 821 of file linkedlists.h.

◆ AST_RWLIST_INSERT_SORTALPHA

#define AST_RWLIST_INSERT_SORTALPHA   AST_LIST_INSERT_SORTALPHA

Definition at line 770 of file linkedlists.h.

◆ AST_RWLIST_INSERT_TAIL

#define AST_RWLIST_INSERT_TAIL   AST_LIST_INSERT_TAIL

◆ AST_RWLIST_LAST

#define AST_RWLIST_LAST   AST_LIST_LAST

Definition at line 430 of file linkedlists.h.

Referenced by grab_last().

◆ AST_RWLIST_MOVE_CURRENT

#define AST_RWLIST_MOVE_CURRENT   AST_LIST_MOVE_CURRENT

Definition at line 587 of file linkedlists.h.

◆ AST_RWLIST_NEXT

#define AST_RWLIST_NEXT   AST_LIST_NEXT

◆ AST_RWLIST_RDLOCK

#define AST_RWLIST_RDLOCK (   head)    ast_rwlock_rdlock(&(head)->lock)

Read locks a list.

Parameters
headThis is a pointer to the list head structure

This macro attempts to place a read lock in the list head structure pointed to by head.

Return values
0on success
non-zeroon failure
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 77 of file linkedlists.h.

Referenced by __ast_cli_generator(), __manager_event_sessions_va(), __stasis_app_register(), acf_odbc_read(), acf_odbc_write(), action_find(), action_listcommands(), add_headers_to_message(), advance_event(), app_event_source_find(), app_event_sources_to_json(), app_exec(), ast_app_group_get_count(), ast_app_group_list_rdlock(), ast_app_group_match_get_count(), ast_channeltype_list(), ast_cli_command_full(), ast_complete_applications(), ast_custom_function_find(), ast_debug_get_by_module(), ast_format_str_reduce(), ast_get_channel_tech(), ast_key_get(), ast_logger_get_channels(), ast_odbc_find_table(), ast_presence_state_helper(), ast_queue_log(), ast_read_image(), ast_readfile(), ast_rtp_instance_get_glue(), ast_rtp_instance_new(), ast_sip_format_endpoint_ami(), ast_sip_identify_endpoint(), ast_sip_pubsub_generate_body_content(), ast_sip_send_out_of_dialog_request(), ast_sip_session_add_supplements(), ast_trace_get_by_module(), ast_translate_available_formats(), ast_translate_path_steps(), ast_translator_best_choice(), ast_translator_build_path(), ast_verb_console_get(), ast_verb_update(), ast_writefile(), ast_xmldoc_build_documentation(), ast_xmldoc_query(), bridge_frame_free(), channel_get_external_vars(), channel_has_external_vars(), cli_fax_show_capabilities(), cli_fax_show_settings(), cli_fax_show_stats(), cli_fax_show_version(), cli_has_permissions(), cli_odbc_read(), cli_odbc_write(), cli_show_endpoint_identifiers(), complete_bridge_technology(), complete_channeltypes(), complete_functions(), config_function_read(), custom_log(), dns_query_alloc(), do_discovery(), fax_session_new(), fax_session_reserve(), filehelper(), find_agent_callbacks(), find_best(), find_best_technology(), find_body_generator_type_subtype(), find_command(), find_database(), find_engine(), find_monitor_callbacks(), find_pub_handler(), find_sub_handler_for_event_name(), find_table(), for_each_subscription(), function_amiclient(), getproviderstate(), handle_bridge_technology_show(), handle_cli_core_show_channeltype(), handle_cli_core_show_channeltypes(), handle_cli_core_show_file_formats(), handle_cli_keys_show(), handle_cli_mobile_cusd(), handle_cli_mobile_rfcomm(), handle_cli_mobile_search(), handle_cli_mobile_show_devices(), handle_cli_realtime_mysql_cache(), handle_cli_realtime_mysql_status(), handle_cli_show_permissions(), handle_cli_sqlite_show_tables(), handle_cli_status(), handle_core_show_image_formats(), handle_dump_docs(), handle_help(), handle_logger_remove_channel(), handle_logger_show_channels(), handle_manager_bridge_tech_suspend(), handle_show_application(), handle_show_applications(), handle_show_functions(), handle_show_http(), handle_show_switches(), handle_show_threads(), handle_show_translation_path(), handle_show_translation_table(), handle_showmanager(), handle_showmanagers(), handle_showmancmd(), handle_showmancmds(), handle_showmaneventq(), handle_uri(), help1(), help_workhorse(), load_module(), logger_print_normal(), manager_bridge_tech_list(), manager_displayconnects(), mbl_devicestate(), mbl_load_device(), mbl_request(), mbl_sendsms_exec(), mbl_status_exec(), mysql_log(), odbc_log(), pbx_findapp(), pbx_findswitch(), pgsql_log(), post_cdr(), refresh_list(), reload_module(), request_channel(), rtp_add_candidates_to_ice(), sco_accept(), send_request_cb(), set_priority_all(), supplement_on_rx_request(), supplement_outgoing_response(), syslog_log(), transport_state_callback(), write_htmldump(), and xmldoc_get_node().

◆ AST_RWLIST_REMOVE

#define AST_RWLIST_REMOVE   AST_LIST_REMOVE

◆ AST_RWLIST_REMOVE_CURRENT

#define AST_RWLIST_REMOVE_CURRENT   AST_LIST_REMOVE_CURRENT

◆ AST_RWLIST_REMOVE_HEAD

#define AST_RWLIST_REMOVE_HEAD   AST_LIST_REMOVE_HEAD

◆ AST_RWLIST_TIMEDRDLOCK

#define AST_RWLIST_TIMEDRDLOCK (   head,
  ts 
)    ast_rwlock_timedrdlock(&(head)->lock, ts)

Read locks a list, with timeout.

Parameters
headThis is a pointer to the list head structure
tsPointer to a timespec structure

This macro attempts to place a read lock in the list head structure pointed to by head.

Return values
0on success
non-zeroon failure
Since
1.6.1

Definition at line 92 of file linkedlists.h.

◆ AST_RWLIST_TIMEDWRLOCK

#define AST_RWLIST_TIMEDWRLOCK (   head,
  ts 
)    ast_rwlock_timedwrlock(&(head)->lock, ts)

Write locks a list, with timeout.

Parameters
headThis is a pointer to the list head structure
tsPointer to a timespec structure

This macro attempts to place an exclusive write lock in the list head structure pointed to by head.

Return values
0on success
non-zeroon failure
Since
1.6.1

Definition at line 66 of file linkedlists.h.

◆ AST_RWLIST_TRAVERSE

#define AST_RWLIST_TRAVERSE   AST_LIST_TRAVERSE
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 493 of file linkedlists.h.

Referenced by __ast_bridge_technology_register(), __ast_format_def_register(), __manager_event_sessions_va(), acf_odbc_read(), acf_odbc_write(), action_find(), action_listcommands(), add_redirect(), app_exec(), ast_app_group_get_count(), ast_app_group_match_get_count(), ast_cdr_backend_suspend(), ast_cdr_backend_unsuspend(), ast_cdr_generic_unregister(), ast_channel_register(), ast_channeltype_list(), ast_complete_applications(), ast_custom_function_find_nolock(), ast_devstate_prov_add(), ast_format_str_reduce(), ast_get_channel_tech(), ast_get_extension_for_mime_type(), ast_get_format_for_file_ext(), ast_http_uri_link(), ast_key_get(), ast_logger_get_channels(), ast_logger_rotate_channel(), ast_manager_register_struct(), ast_odbc_find_column(), ast_odbc_find_table(), ast_presence_state_helper(), ast_read_image(), ast_readfile(), ast_register_switch(), ast_rtp_engine_register2(), ast_rtp_glue_register2(), ast_rtp_instance_get_glue(), ast_rtp_instance_new(), ast_sip_format_endpoint_ami(), ast_sip_identify_endpoint(), ast_sip_pubsub_generate_body_content(), ast_sip_session_add_supplements(), ast_verb_update(), ast_writefile(), bridge_frame_free(), cdr_generic_register(), cdr_handler(), cli_fax_show_capabilities(), cli_fax_show_settings(), cli_fax_show_stats(), cli_fax_show_version(), cli_odbc_read(), cli_odbc_write(), cli_show_endpoint_identifiers(), complete_bridge_technology(), complete_channeltypes(), complete_functions(), config_function_read(), crypto_load(), do_discovery(), fax_session_new(), fax_session_reserve(), filehelper(), find_agent_callbacks(), find_best_technology(), find_command(), find_database(), find_engine(), find_logchannel(), find_monitor_callbacks(), find_pub_handler(), find_publisher_handler_for_event_name(), find_sub_handler_for_event_name(), find_table(), find_table_cb(), for_each_subscription(), get_manager_by_name_locked(), getproviderstate(), handle_bridge_technology_show(), handle_bridge_technology_suspend(), handle_cli_core_show_channeltype(), handle_cli_core_show_channeltypes(), handle_cli_core_show_file_formats(), handle_cli_keys_show(), handle_cli_mobile_cusd(), handle_cli_mobile_rfcomm(), handle_cli_mobile_search(), handle_cli_mobile_show_devices(), handle_cli_realtime_mysql_cache(), handle_cli_realtime_mysql_status(), handle_cli_sqlite_show_tables(), handle_cli_status(), handle_core_show_image_formats(), handle_logger_remove_channel(), handle_logger_show_channels(), handle_manager_bridge_tech_suspend(), handle_show_application(), handle_show_applications(), handle_show_functions(), handle_show_http(), handle_show_switches(), handle_show_threads(), handle_showmanager(), handle_showmanagers(), handle_showmancmd(), handle_showmancmds(), handle_showmaneventq(), handle_uri(), help_workhorse(), logger_print_normal(), manager_bridge_tech_list(), matrix_rebuild(), mbl_devicestate(), mbl_load_device(), mbl_request(), mbl_sendsms_exec(), mbl_status_exec(), mysql_log(), parse_config(), pbx_findapp_nolock(), pbx_findswitch(), pgsql_log(), post_cdr(), realtime_require_handler(), refresh_list(), reload_followme(), reload_logger(), request_channel(), require_odbc(), sco_accept(), set_priority_all(), try_load_key(), unload_module(), update_logchannels(), and write_htmldump().

◆ AST_RWLIST_TRAVERSE_SAFE_BEGIN

#define AST_RWLIST_TRAVERSE_SAFE_BEGIN   AST_LIST_TRAVERSE_SAFE_BEGIN
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 544 of file linkedlists.h.

Referenced by __ast_bridge_technology_register(), __ast_cli_register(), __ast_custom_function_register(), __ast_register_translator(), __init_manager(), app_control_unregister_rule(), ast_agi_unregister(), ast_app_group_discard(), ast_app_group_set_channel(), ast_app_group_update(), ast_bridge_technology_unregister(), ast_cc_agent_unregister(), ast_cc_monitor_unregister(), ast_channel_unregister(), ast_devstate_prov_del(), ast_dns_resolver_register(), ast_dns_resolver_unregister(), ast_fax_tech_unregister(), ast_format_def_unregister(), ast_http_uri_unlink_all_with_key(), ast_manager_unregister(), ast_odbc_clear_cache(), ast_presence_state_prov_del(), ast_register_application2(), ast_sip_pubsub_unregister_body_generator(), ast_sip_pubsub_unregister_body_supplement(), ast_sip_register_endpoint_identifier_with_name(), ast_sip_register_supplement(), ast_sip_session_register_supplement_with_module(), ast_sip_session_unregister_supplement(), ast_sip_unregister_endpoint_formatter(), ast_sip_unregister_endpoint_identifier(), ast_sip_unregister_event_publisher_handler(), ast_sip_unregister_publish_handler(), ast_sip_unregister_subscription_handler(), ast_sip_unregister_supplement(), ast_speech_unregister(), ast_unregister_application(), ast_unregister_thread(), ast_unregister_translator(), crypto_load(), handle_cli_keys_init(), host_candidate_overrides_clear(), purge_events(), realtime_unload_handler(), remove_subscription(), and stasis_app_unregister_event_source().

◆ AST_RWLIST_TRAVERSE_SAFE_END

#define AST_RWLIST_TRAVERSE_SAFE_END   AST_LIST_TRAVERSE_SAFE_END
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 616 of file linkedlists.h.

Referenced by __ast_bridge_technology_register(), __ast_cli_register(), __ast_custom_function_register(), __ast_register_translator(), __init_manager(), app_control_unregister_rule(), ast_agi_unregister(), ast_app_group_discard(), ast_app_group_set_channel(), ast_app_group_update(), ast_bridge_technology_unregister(), ast_cc_agent_unregister(), ast_cc_monitor_unregister(), ast_devstate_prov_del(), ast_dns_resolver_register(), ast_dns_resolver_unregister(), ast_fax_tech_unregister(), ast_format_def_unregister(), ast_http_uri_unlink_all_with_key(), ast_manager_unregister(), ast_odbc_clear_cache(), ast_presence_state_prov_del(), ast_register_application2(), ast_sip_pubsub_unregister_body_generator(), ast_sip_pubsub_unregister_body_supplement(), ast_sip_register_endpoint_identifier_with_name(), ast_sip_register_supplement(), ast_sip_session_register_supplement_with_module(), ast_sip_session_unregister_supplement(), ast_sip_unregister_endpoint_formatter(), ast_sip_unregister_endpoint_identifier(), ast_sip_unregister_event_publisher_handler(), ast_sip_unregister_publish_handler(), ast_sip_unregister_subscription_handler(), ast_sip_unregister_supplement(), ast_speech_unregister(), ast_unregister_application(), ast_unregister_thread(), ast_unregister_translator(), crypto_load(), handle_cli_keys_init(), host_candidate_overrides_clear(), purge_events(), realtime_unload_handler(), remove_subscription(), and stasis_app_unregister_event_source().

◆ AST_RWLIST_TRYRDLOCK

#define AST_RWLIST_TRYRDLOCK (   head)    ast_rwlock_tryrdlock(&(head)->lock)

Read locks a list, without blocking if the list is locked.

Parameters
headThis is a pointer to the list head structure

This macro attempts to place a read lock in the list head structure pointed to by head.

Return values
0on success
non-zeroon failure

Definition at line 128 of file linkedlists.h.

◆ AST_RWLIST_TRYWRLOCK

#define AST_RWLIST_TRYWRLOCK (   head)    ast_rwlock_trywrlock(&(head)->lock)

Write locks a list, without blocking if the list is locked.

Parameters
headThis is a pointer to the list head structure

This macro attempts to place an exclusive write lock in the list head structure pointed to by head.

Return values
0on success
non-zeroon failure

Definition at line 116 of file linkedlists.h.

◆ AST_RWLIST_UNLOCK

#define AST_RWLIST_UNLOCK (   head)    ast_rwlock_unlock(&(head)->lock)

Attempts to unlock a read/write based list.

Parameters
headThis is a pointer to the list head structure

This macro attempts to remove a read or write lock from the list head structure pointed to by head. If the list was not locked by this thread, this macro has no effect.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 150 of file linkedlists.h.

Referenced by __ast_bridge_technology_register(), __ast_cli_generator(), __ast_cli_register(), __ast_custom_function_register(), __ast_format_def_register(), __ast_http_load(), __ast_register_translator(), __init_manager(), __manager_event_sessions_va(), __stasis_app_register(), acf_odbc_read(), acf_odbc_write(), action_find(), action_listcommands(), add_header(), add_headers_to_message(), add_redirect(), add_subscription(), advance_event(), app_event_source_find(), app_event_sources_to_json(), app_exec(), append_event(), ast_agi_register(), ast_agi_unregister(), ast_app_group_discard(), ast_app_group_get_count(), ast_app_group_list_unlock(), ast_app_group_match_get_count(), ast_app_group_set_channel(), ast_app_group_update(), ast_bridge_technology_unregister(), ast_cc_agent_register(), ast_cc_agent_unregister(), ast_cc_monitor_register(), ast_cc_monitor_unregister(), ast_cdr_backend_suspend(), ast_cdr_backend_unsuspend(), ast_cdr_generic_unregister(), ast_channel_register(), ast_channel_unregister(), ast_channeltype_list(), ast_cli_command_full(), ast_cli_perms_init(), ast_cli_unregister(), ast_complete_applications(), ast_custom_function_find(), ast_custom_function_unregister(), ast_debug_get_by_module(), ast_devstate_prov_add(), ast_devstate_prov_del(), ast_dns_resolver_register(), ast_dns_resolver_unregister(), ast_dnsmgr_get_family(), ast_dnsmgr_release(), ast_dynamic_logger_level(), ast_fax_tech_register(), ast_fax_tech_unregister(), ast_format_def_unregister(), ast_format_str_reduce(), ast_get_channel_tech(), ast_http_uri_link(), ast_http_uri_unlink(), ast_http_uri_unlink_all_with_key(), ast_image_register(), ast_image_unregister(), ast_key_get(), ast_logger_create_channel(), ast_logger_get_channels(), ast_logger_register_level(), ast_logger_remove_channel(), ast_logger_rotate_channel(), ast_logger_unregister_level(), ast_manager_register_hook(), ast_manager_register_struct(), ast_manager_unregister(), ast_manager_unregister_hook(), ast_odbc_clear_cache(), ast_odbc_find_table(), ast_presence_state_helper(), ast_presence_state_prov_add(), ast_presence_state_prov_del(), ast_queue_log(), ast_read_image(), ast_readfile(), ast_register_application2(), ast_register_switch(), ast_register_thread(), ast_rtp_engine_register2(), ast_rtp_engine_unregister(), ast_rtp_glue_register2(), ast_rtp_glue_unregister(), ast_rtp_instance_get_glue(), ast_rtp_instance_new(), ast_sip_format_endpoint_ami(), ast_sip_identify_endpoint(), ast_sip_pubsub_generate_body_content(), ast_sip_pubsub_register_body_generator(), ast_sip_pubsub_register_body_supplement(), ast_sip_pubsub_unregister_body_generator(), ast_sip_pubsub_unregister_body_supplement(), ast_sip_register_endpoint_formatter(), ast_sip_register_endpoint_identifier_with_name(), ast_sip_register_event_publisher_handler(), ast_sip_register_supplement(), ast_sip_send_out_of_dialog_request(), ast_sip_session_add_supplements(), ast_sip_session_register_supplement_with_module(), ast_sip_session_unregister_supplement(), ast_sip_transport_state_register(), ast_sip_transport_state_unregister(), ast_sip_unregister_endpoint_formatter(), ast_sip_unregister_endpoint_identifier(), ast_sip_unregister_event_publisher_handler(), ast_sip_unregister_publish_handler(), ast_sip_unregister_subscription_handler(), ast_sip_unregister_supplement(), ast_speech_register(), ast_speech_unregister(), ast_trace_get_by_module(), ast_translate_available_formats(), ast_translate_path_steps(), ast_translator_activate(), ast_translator_best_choice(), ast_translator_build_path(), ast_translator_deactivate(), ast_unregister_application(), ast_unregister_switch(), ast_unregister_thread(), ast_unregister_translator(), ast_verb_console_get(), ast_verb_console_register(), ast_verb_console_set(), ast_verb_update(), ast_writefile(), ast_xmldoc_build_documentation(), ast_xmldoc_load_documentation(), ast_xmldoc_query(), auth_http_callback(), authenticate(), bridge_frame_free(), bridge_sync_cleanup(), bridge_sync_init(), cdr_generic_register(), channel_get_external_vars(), channel_has_external_vars(), channel_set_external_vars(), cli_fax_show_capabilities(), cli_fax_show_settings(), cli_fax_show_stats(), cli_fax_show_version(), cli_has_permissions(), cli_odbc_read(), cli_odbc_write(), cli_show_endpoint_identifiers(), close_logger(), complete_bridge_technology(), complete_channeltypes(), complete_functions(), config_function_read(), config_module(), crypto_load(), custom_log(), destroy_table_cache(), destroy_user_perms(), dns_query_alloc(), do_discovery(), empty_columns(), fax_session_new(), fax_session_reserve(), filehelper(), find_agent_callbacks(), find_best(), find_best_technology(), find_body_generator_type_subtype(), find_command(), find_database(), find_engine(), find_monitor_callbacks(), find_pub_handler(), find_sub_handler_for_event_name(), find_table(), for_each_subscription(), free_external_channelvars(), free_table(), function_amiclient(), getproviderstate(), grab_last(), handle_bridge_technology_show(), handle_bridge_technology_suspend(), handle_cli_core_show_channeltype(), handle_cli_core_show_channeltypes(), handle_cli_core_show_file_formats(), handle_cli_keys_init(), handle_cli_keys_show(), handle_cli_mobile_cusd(), handle_cli_mobile_rfcomm(), handle_cli_mobile_search(), handle_cli_mobile_show_devices(), handle_cli_realtime_mysql_cache(), handle_cli_realtime_mysql_status(), handle_cli_recalc(), handle_cli_show_permissions(), handle_cli_sqlite_show_tables(), handle_cli_status(), handle_core_show_image_formats(), handle_debug_or_trace(), handle_dump_docs(), handle_help(), handle_logger_remove_channel(), handle_logger_set_level(), handle_logger_show_channels(), handle_manager_bridge_tech_suspend(), handle_show_application(), handle_show_applications(), handle_show_functions(), handle_show_http(), handle_show_switches(), handle_show_threads(), handle_show_translation_path(), handle_show_translation_table(), handle_showmanager(), handle_showmanagers(), handle_showmancmd(), handle_showmancmds(), handle_showmaneventq(), handle_uri(), help1(), help_workhorse(), host_candidate_overrides_clear(), init_logger(), load_module(), logger_print_normal(), logger_queue_start(), logger_register_level(), manager_bridge_tech_list(), manager_displayconnects(), matrix_resize(), mbl_devicestate(), mbl_load_adapter(), mbl_load_device(), mbl_request(), mbl_sendsms_exec(), mbl_status_exec(), my_load_module(), my_unload_module(), mysql_log(), odbc_log(), parse_config(), pbx_findapp(), pbx_findswitch(), pgsql_log(), post_cdr(), process_message(), publish_add_handler(), purge_events(), realtime_require_handler(), realtime_unload_handler(), refresh_list(), reload(), reload_followme(), reload_logger(), reload_module(), remove_subscription(), request_channel(), require_odbc(), rtp_add_candidates_to_ice(), rtp_reload(), sco_accept(), send_request_cb(), set_priority_all(), stasis_app_register_event_source(), stasis_app_unregister_event_source(), sub_add_handler(), supplement_on_rx_request(), supplement_outgoing_response(), syslog_log(), transport_state_callback(), unload_config(), unload_module(), verb_console_unregister(), write_htmldump(), xmldoc_get_node(), and xmldoc_unload_documentation().

◆ AST_RWLIST_WRLOCK

#define AST_RWLIST_WRLOCK (   head)    ast_rwlock_wrlock(&(head)->lock)

Write locks a list.

Parameters
headThis is a pointer to the list head structure

This macro attempts to place an exclusive write lock in the list head structure pointed to by head.

Return values
0on success
non-zeroon failure
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 51 of file linkedlists.h.

Referenced by __ast_bridge_technology_register(), __ast_cli_register(), __ast_custom_function_register(), __ast_format_def_register(), __ast_http_load(), __ast_register_translator(), __init_manager(), add_header(), add_redirect(), add_subscription(), append_event(), ast_agi_register(), ast_agi_unregister(), ast_app_group_discard(), ast_app_group_list_wrlock(), ast_app_group_set_channel(), ast_app_group_update(), ast_bridge_technology_unregister(), ast_cc_agent_register(), ast_cc_agent_unregister(), ast_cc_monitor_register(), ast_cc_monitor_unregister(), ast_cdr_backend_suspend(), ast_cdr_backend_unsuspend(), ast_cdr_generic_unregister(), ast_channel_register(), ast_channel_unregister(), ast_cli_perms_init(), ast_cli_unregister(), ast_custom_function_unregister(), ast_devstate_prov_add(), ast_devstate_prov_del(), ast_dns_resolver_register(), ast_dns_resolver_unregister(), ast_dnsmgr_get_family(), ast_dnsmgr_release(), ast_dynamic_logger_level(), ast_fax_tech_register(), ast_fax_tech_unregister(), ast_format_def_unregister(), ast_http_uri_link(), ast_http_uri_unlink(), ast_http_uri_unlink_all_with_key(), ast_image_register(), ast_image_unregister(), ast_logger_create_channel(), ast_logger_register_level(), ast_logger_remove_channel(), ast_logger_rotate_channel(), ast_logger_unregister_level(), ast_manager_register_hook(), ast_manager_register_struct(), ast_manager_unregister(), ast_manager_unregister_hook(), ast_odbc_clear_cache(), ast_presence_state_prov_add(), ast_presence_state_prov_del(), ast_register_application2(), ast_register_switch(), ast_register_thread(), ast_rtp_engine_register2(), ast_rtp_engine_unregister(), ast_rtp_glue_register2(), ast_rtp_glue_unregister(), ast_sip_pubsub_register_body_generator(), ast_sip_pubsub_register_body_supplement(), ast_sip_pubsub_unregister_body_generator(), ast_sip_pubsub_unregister_body_supplement(), ast_sip_register_endpoint_formatter(), ast_sip_register_endpoint_identifier_with_name(), ast_sip_register_event_publisher_handler(), ast_sip_register_supplement(), ast_sip_session_register_supplement_with_module(), ast_sip_session_unregister_supplement(), ast_sip_transport_state_register(), ast_sip_transport_state_unregister(), ast_sip_unregister_endpoint_formatter(), ast_sip_unregister_endpoint_identifier(), ast_sip_unregister_event_publisher_handler(), ast_sip_unregister_publish_handler(), ast_sip_unregister_subscription_handler(), ast_sip_unregister_supplement(), ast_speech_register(), ast_speech_unregister(), ast_translator_activate(), ast_translator_deactivate(), ast_unregister_application(), ast_unregister_switch(), ast_unregister_thread(), ast_unregister_translator(), ast_verb_console_register(), ast_verb_console_set(), ast_xmldoc_load_documentation(), auth_http_callback(), authenticate(), bridge_sync_cleanup(), bridge_sync_init(), cdr_generic_register(), channel_set_external_vars(), close_logger(), config_function_read(), config_module(), crypto_load(), destroy_table_cache(), destroy_user_perms(), empty_columns(), find_table(), free_external_channelvars(), free_table(), grab_last(), handle_bridge_technology_suspend(), handle_cli_keys_init(), handle_cli_recalc(), handle_debug_or_trace(), handle_logger_set_level(), host_candidate_overrides_clear(), init_logger(), load_module(), logger_queue_start(), matrix_resize(), mbl_load_adapter(), mbl_load_device(), my_load_module(), my_unload_module(), parse_config(), process_message(), publish_add_handler(), purge_events(), realtime_unload_handler(), reload(), reload_followme(), reload_logger(), remove_subscription(), rtp_reload(), stasis_app_register_event_source(), stasis_app_unregister_event_source(), sub_add_handler(), unload_config(), unload_module(), verb_console_unregister(), and xmldoc_unload_documentation().