Channel States

From FreeSWITCH Wiki
Jump to: navigation, search

Contents

Introduction

A channel (a call) will go through many different states during its lifetime. Here we will describe the different states that a channel might find itself in, and what each of those states mean.

States

State Description
CS_NEW Channel is newly created.
CS_INIT Channel has been initialized.
CS_ROUTING Channel is looking for an extension to execute.
CS_SOFT_EXECUTE Channel is ready to execute from 3rd party control.
CS_EXECUTE Channel is executing its dialplan.
CS_EXCHANGE_MEDIA Channel is exchanging media with another channel.
CS_PARK Channel is accepting media awaiting commands.
CS_CONSUME_MEDIA Channel is consuming all media and dropping it.
CS_HIBERNATE Channel is in a sleep state.
CS_RESET Channel is in a reset state.
CS_HANGUP Channel is flagged for hangup and ready to end. Media will now end, and no further call routing will occur.
CS_REPORTING The channel is already hung up, media is already down, and now it's time to do any sort of reporting processes such as CDR logging.
CS_DESTROY Channel is ready to be destroyed and out of the state machine. Memory pools are returned to the core and utilized memory from the channel is freed.

State Handlers

Custom state handlers can be added to the channels either globally or on a per-channel basis. This will allow you to do your own custom reporting or clean up your own dynamically created objects, for example. Custom handlers can also be then removed from a channel.

See Also