sig_pri.h File Reference

Interface header for PRI signaling module. More...

#include "asterisk/channel.h"
#include "asterisk/frame.h"
#include "asterisk/ccss.h"
#include <libpri.h>
#include <dahdi/user.h>

Include dependency graph for sig_pri.h:

Go to the source code of this file.

Data Structures
struct	sig_pri_callback
struct	sig_pri_chan
struct	sig_pri_span

Macros
#define	DAHDI_CHAN_MAPPING_LOGICAL   1
#define	DAHDI_CHAN_MAPPING_PHYSICAL   0
#define	DAHDI_OVERLAPDIAL_BOTH   (DAHDI_OVERLAPDIAL_INCOMING|DAHDI_OVERLAPDIAL_OUTGOING)
#define	DAHDI_OVERLAPDIAL_INCOMING   2
#define	DAHDI_OVERLAPDIAL_NONE   0
#define	DAHDI_OVERLAPDIAL_OUTGOING   1
#define	SIG_BRI   (0x2000000 | DAHDI_SIG_CLEAR)
#define	SIG_BRI_PTMP   (0X4000000 | DAHDI_SIG_CLEAR)
#define	SIG_PRI   DAHDI_SIG_CLEAR
#define	SIG_PRI_AOC_GRANT_D   (1 << 1)
#define	SIG_PRI_AOC_GRANT_E   (1 << 2)
#define	SIG_PRI_AOC_GRANT_S   (1 << 0)
#define	SIG_PRI_DEBUG_DEFAULT   0
#define	SIG_PRI_DEBUG_NORMAL    (PRI_DEBUG_APDU | PRI_DEBUG_Q931_STATE | PRI_DEBUG_Q921_STATE)
#define	SIG_PRI_MAX_CHANNELS   672
#define	SIG_PRI_NUM_DCHANS   4

Enumerations
enum	sig_pri_call_level {   SIG_PRI_CALL_LEVEL_IDLE , SIG_PRI_CALL_LEVEL_SETUP , SIG_PRI_CALL_LEVEL_OVERLAP , SIG_PRI_CALL_LEVEL_PROCEEDING ,   SIG_PRI_CALL_LEVEL_ALERTING , SIG_PRI_CALL_LEVEL_DEFER_DIAL , SIG_PRI_CALL_LEVEL_CONNECT }
enum	sig_pri_colp_signaling { SIG_PRI_COLP_BLOCK , SIG_PRI_COLP_CONNECT , SIG_PRI_COLP_UPDATE }
enum	sig_pri_law { SIG_PRI_DEFLAW = 0 , SIG_PRI_ULAW , SIG_PRI_ALAW }
enum	sig_pri_moh_event { SIG_PRI_MOH_EVENT_RESET , SIG_PRI_MOH_EVENT_HOLD , SIG_PRI_MOH_EVENT_UNHOLD , SIG_PRI_MOH_EVENT_NUM }
enum	sig_pri_moh_signaling { SIG_PRI_MOH_SIGNALING_MOH , SIG_PRI_MOH_SIGNALING_NOTIFY }
enum	sig_pri_moh_state { SIG_PRI_MOH_STATE_IDLE , SIG_PRI_MOH_STATE_NOTIFY , SIG_PRI_MOH_STATE_MOH , SIG_PRI_MOH_STATE_NUM }
enum	sig_pri_reset_state { SIG_PRI_RESET_IDLE , SIG_PRI_RESET_ACTIVE , SIG_PRI_RESET_NO_ACK }
enum	sig_pri_tone {   SIG_PRI_TONE_RINGTONE = 0 , SIG_PRI_TONE_STUTTER , SIG_PRI_TONE_CONGESTION , SIG_PRI_TONE_DIALTONE ,   SIG_PRI_TONE_DIALRECALL , SIG_PRI_TONE_INFO , SIG_PRI_TONE_BUSY }

Functions
void	pri_event_alarm (struct sig_pri_span *pri, int index, int before_start_pri)
void	pri_event_noalarm (struct sig_pri_span *pri, int index, int before_start_pri)
int	pri_is_up (struct sig_pri_span *pri)
int	pri_send_callrerouting_facility_exec (struct sig_pri_chan *p, enum ast_channel_state chanstate, const char *destination, const char *original, const char *reason)
int	pri_send_keypad_facility_exec (struct sig_pri_chan *p, const char *digits)
int	sig_pri_ami_show_spans (struct mansession *s, const char *show_cmd, struct sig_pri_span *pri, const int *dchannels, const char *action_id)
int	sig_pri_answer (struct sig_pri_chan *p, struct ast_channel *ast)
int	sig_pri_available (struct sig_pri_chan **pvt, int is_specific_channel)
int	sig_pri_call (struct sig_pri_chan *p, struct ast_channel *ast, const char *rdest, int timeout, int layer1)
int	sig_pri_cc_agent_callee_available (struct ast_cc_agent *agent)
void	sig_pri_cc_agent_destructor (struct ast_cc_agent *agent)
int	sig_pri_cc_agent_init (struct ast_cc_agent *agent, struct sig_pri_chan *pvt_chan)
int	sig_pri_cc_agent_party_b_free (struct ast_cc_agent *agent)
void	sig_pri_cc_agent_req_rsp (struct ast_cc_agent *agent, enum ast_cc_agent_response_reason reason)
int	sig_pri_cc_agent_start_monitoring (struct ast_cc_agent *agent)
int	sig_pri_cc_agent_start_offer_timer (struct ast_cc_agent *agent)
int	sig_pri_cc_agent_status_req (struct ast_cc_agent *agent)
int	sig_pri_cc_agent_stop_offer_timer (struct ast_cc_agent *agent)
int	sig_pri_cc_agent_stop_ringing (struct ast_cc_agent *agent)
int	sig_pri_cc_monitor_cancel_available_timer (struct ast_cc_monitor *monitor, int *sched_id)
void	sig_pri_cc_monitor_destructor (void *monitor_pvt)
int	sig_pri_cc_monitor_req_cc (struct ast_cc_monitor *monitor, int *available_timer_id)
int	sig_pri_cc_monitor_status_rsp (struct ast_cc_monitor *monitor, enum ast_device_state devstate)
int	sig_pri_cc_monitor_suspend (struct ast_cc_monitor *monitor)
int	sig_pri_cc_monitor_unsuspend (struct ast_cc_monitor *monitor)
void	sig_pri_chan_alarm_notify (struct sig_pri_chan *p, int noalarm)
void	sig_pri_chan_delete (struct sig_pri_chan *doomed)
struct sig_pri_chan *	sig_pri_chan_new (void *pvt_data, struct sig_pri_span *pri, int logicalspan, int channo, int trunkgroup)
void	sig_pri_cli_show_channels (int fd, struct sig_pri_span *pri)
void	sig_pri_cli_show_channels_header (int fd)
void	sig_pri_cli_show_span (int fd, int *dchannels, struct sig_pri_span *pri)
void	sig_pri_cli_show_spans (int fd, int span, struct sig_pri_span *pri)
void	sig_pri_dial_complete (struct sig_pri_chan *pvt, struct ast_channel *ast)
int	sig_pri_digit_begin (struct sig_pri_chan *pvt, struct ast_channel *ast, char digit)
void	sig_pri_extract_called_num_subaddr (struct sig_pri_chan *p, const char *rdest, char *called, size_t called_buff_size)
void	sig_pri_fixup (struct ast_channel *oldchan, struct ast_channel *newchan, struct sig_pri_chan *pchan)
int	sig_pri_hangup (struct sig_pri_chan *p, struct ast_channel *ast)
int	sig_pri_indicate (struct sig_pri_chan *p, struct ast_channel *chan, int condition, const void *data, size_t datalen)
void	sig_pri_init_pri (struct sig_pri_span *pri)
int	sig_pri_is_alarm_ignored (struct sig_pri_span *pri)
int	sig_pri_is_chan_available (struct sig_pri_chan *pvt)
int	sig_pri_load (const char *cc_type_name)
struct ast_channel *	sig_pri_request (struct sig_pri_chan *p, enum sig_pri_law law, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, int transfercapability)
void	sig_pri_set_alarm (struct sig_pri_chan *p, int in_alarm)
int	sig_pri_start_pri (struct sig_pri_span *pri)
void	sig_pri_stop_pri (struct sig_pri_span *pri)
void	sig_pri_unload (void)

Variables
struct sig_pri_callback	sig_pri_callbacks

Detailed Description

Interface header for PRI signaling module.

Author

Matthew Fredrickson cresl.nosp@m.in@d.nosp@m.igium.nosp@m..com

Definition in file sig_pri.h.

Macro Definition Documentation

DAHDI_CHAN_MAPPING_LOGICAL

#define DAHDI_CHAN_MAPPING_LOGICAL   1

Definition at line 248 of file sig_pri.h.

DAHDI_CHAN_MAPPING_PHYSICAL

#define DAHDI_CHAN_MAPPING_PHYSICAL   0

Definition at line 247 of file sig_pri.h.

DAHDI_OVERLAPDIAL_BOTH

#define DAHDI_OVERLAPDIAL_BOTH   (DAHDI_OVERLAPDIAL_INCOMING|DAHDI_OVERLAPDIAL_OUTGOING)

Definition at line 254 of file sig_pri.h.

DAHDI_OVERLAPDIAL_INCOMING

#define DAHDI_OVERLAPDIAL_INCOMING   2

Definition at line 253 of file sig_pri.h.

DAHDI_OVERLAPDIAL_NONE

#define DAHDI_OVERLAPDIAL_NONE   0

Definition at line 251 of file sig_pri.h.

DAHDI_OVERLAPDIAL_OUTGOING

#define DAHDI_OVERLAPDIAL_OUTGOING   1

Definition at line 252 of file sig_pri.h.

SIG_BRI

#define SIG_BRI   (0x2000000 | DAHDI_SIG_CLEAR)

Definition at line 243 of file sig_pri.h.

SIG_BRI_PTMP

#define SIG_BRI_PTMP   (0X4000000 | DAHDI_SIG_CLEAR)

Definition at line 244 of file sig_pri.h.

SIG_PRI

#define SIG_PRI   DAHDI_SIG_CLEAR

Definition at line 242 of file sig_pri.h.

SIG_PRI_AOC_GRANT_D

#define SIG_PRI_AOC_GRANT_D   (1 << 1)

Definition at line 54 of file sig_pri.h.

SIG_PRI_AOC_GRANT_E

#define SIG_PRI_AOC_GRANT_E   (1 << 2)

Definition at line 55 of file sig_pri.h.

SIG_PRI_AOC_GRANT_S

#define SIG_PRI_AOC_GRANT_S   (1 << 0)

Definition at line 53 of file sig_pri.h.

SIG_PRI_DEBUG_DEFAULT

#define SIG_PRI_DEBUG_DEFAULT   0

PRI debug message flags set on initial startup.

Definition at line 50 of file sig_pri.h.

SIG_PRI_DEBUG_NORMAL

#define SIG_PRI_DEBUG_NORMAL    (PRI_DEBUG_APDU | PRI_DEBUG_Q931_STATE | PRI_DEBUG_Q921_STATE)

PRI debug message flags when normal PRI debugging is turned on at the command line.

Definition at line 41 of file sig_pri.h.

                  {
    SIG_PRI_TONE_RINGTONE = 0,
    SIG_PRI_TONE_STUTTER,
    SIG_PRI_TONE_CONGESTION,
    SIG_PRI_TONE_DIALTONE,
    SIG_PRI_TONE_DIALRECALL,
    SIG_PRI_TONE_INFO,
    SIG_PRI_TONE_BUSY,
};
 
enum sig_pri_law {
    SIG_PRI_DEFLAW = 0,
    SIG_PRI_ULAW,
    SIG_PRI_ALAW
};
 
enum sig_pri_moh_signaling {
    /*! Generate MOH to the remote party. */
    SIG_PRI_MOH_SIGNALING_MOH,
    /*! Send hold notification signaling to the remote party. */
    SIG_PRI_MOH_SIGNALING_NOTIFY,
#if defined(HAVE_PRI_CALL_HOLD)
    /*! Use HOLD/RETRIEVE signaling to release the B channel while on hold. */
    SIG_PRI_MOH_SIGNALING_HOLD,
#endif  /* defined(HAVE_PRI_CALL_HOLD) */
};
 
enum sig_pri_moh_state {
    /*! Bridged peer has not put us on hold. */
    SIG_PRI_MOH_STATE_IDLE,
    /*! Bridged peer has put us on hold and we were to notify the remote party. */
    SIG_PRI_MOH_STATE_NOTIFY,
    /*! Bridged peer has put us on hold and we were to play MOH or HOLD/RETRIEVE fallback. */
    SIG_PRI_MOH_STATE_MOH,
#if defined(HAVE_PRI_CALL_HOLD)
    /*! Requesting to put channel on hold. */
    SIG_PRI_MOH_STATE_HOLD_REQ,
    /*! Trying to go on hold when bridged peer requested to unhold. */
    SIG_PRI_MOH_STATE_PEND_UNHOLD,
    /*! Channel is held. */
    SIG_PRI_MOH_STATE_HOLD,
    /*! Requesting to take channel out of hold. */
    SIG_PRI_MOH_STATE_RETRIEVE_REQ,
    /*! Trying to take channel out of hold when bridged peer requested to hold. */
    SIG_PRI_MOH_STATE_PEND_HOLD,
    /*! Failed to take the channel out of hold. No B channels were available? */
    SIG_PRI_MOH_STATE_RETRIEVE_FAIL,
#endif  /* defined(HAVE_PRI_CALL_HOLD) */
 
    /*! Number of MOH states.  Must be last in enum. */
    SIG_PRI_MOH_STATE_NUM
};
 
enum sig_pri_moh_event {
    /*! Reset the MOH state machine. (Because of hangup.) */
    SIG_PRI_MOH_EVENT_RESET,
    /*! Bridged peer placed this channel on hold. */
    SIG_PRI_MOH_EVENT_HOLD,
    /*! Bridged peer took this channel off hold. */
    SIG_PRI_MOH_EVENT_UNHOLD,
#if defined(HAVE_PRI_CALL_HOLD)
    /*! The hold request was successfully acknowledged. */
    SIG_PRI_MOH_EVENT_HOLD_ACK,
    /*! The hold request was rejected. */
    SIG_PRI_MOH_EVENT_HOLD_REJ,
    /*! The unhold request was successfully acknowledged. */
    SIG_PRI_MOH_EVENT_RETRIEVE_ACK,
    /*! The unhold request was rejected. */
    SIG_PRI_MOH_EVENT_RETRIEVE_REJ,
    /*! The remote party took this channel off hold. */
    SIG_PRI_MOH_EVENT_REMOTE_RETRIEVE_ACK,
#endif  /* defined(HAVE_PRI_CALL_HOLD) */
 
    /*! Number of MOH events.  Must be last in enum. */
    SIG_PRI_MOH_EVENT_NUM
};
 
/*! Call establishment life cycle level for simple comparisons. */
enum sig_pri_call_level {
    /*! Call does not exist. */
    SIG_PRI_CALL_LEVEL_IDLE,
    /*! Call is present but has no response yet. (SETUP) */
    SIG_PRI_CALL_LEVEL_SETUP,
    /*! Call is collecting digits for overlap dialing. (SETUP ACKNOWLEDGE) */
    SIG_PRI_CALL_LEVEL_OVERLAP,
    /*! Call routing is happening. (PROCEEDING) */
    SIG_PRI_CALL_LEVEL_PROCEEDING,
    /*! Called party is being alerted of the call. (ALERTING) */
    SIG_PRI_CALL_LEVEL_ALERTING,
    /*! Call is dialing 'w' deferred digits. (CONNECT) */
    SIG_PRI_CALL_LEVEL_DEFER_DIAL,
    /*! Call is connected/answered. (CONNECT) */
    SIG_PRI_CALL_LEVEL_CONNECT,
};
 
enum sig_pri_reset_state {
    /*! \brief The channel is not being RESTARTed. */
    SIG_PRI_RESET_IDLE,
    /*!
     * \brief The channel is being RESTARTed.
     * \note Waiting for a RESTART ACKNOWLEDGE from the peer.
     */
    SIG_PRI_RESET_ACTIVE,
    /*!
     * \brief Peer may not be sending the expected RESTART ACKNOWLEDGE.
     *
     * \details We have already received a SETUP on this channel.
     * If another SETUP comes in on this channel then the peer
     * considers this channel useable.  Assume that the peer is
     * never going to give us a RESTART ACKNOWLEDGE and assume that
     * we have received one.  This is not according to Q.931, but
     * some peers occasionally fail to send a RESTART ACKNOWLEDGE.
     */
    SIG_PRI_RESET_NO_ACK,
};
 
struct sig_pri_span;
struct xfer_rsp_data;
 
struct sig_pri_callback {
    /* Unlock the private in the signalling private structure.  This is used for three way calling madness. */
    void (* const unlock_private)(void *pvt);
    /* Lock the private in the signalling private structure.  ... */
    void (* const lock_private)(void *pvt);
    /* Do deadlock avoidance for the private signaling structure lock.  */
    void (* const deadlock_avoidance_private)(void *pvt);
    /* Function which is called back to handle any other DTMF events that are received.  Called by analog_handle_event.  Why is this
     * important to use, instead of just directly using events received before they are passed into the library?  Because sometimes,
     * (CWCID) the library absorbs DTMF events received. */
    //void (* const handle_dtmf)(void *pvt, struct ast_channel *ast, enum analog_sub analog_index, struct ast_frame **dest);
 
    //int (* const dial_digits)(void *pvt, enum analog_sub sub, struct analog_dialoperation *dop);
    int (* const play_tone)(void *pvt, enum sig_pri_tone tone);
 
    int (* const set_echocanceller)(void *pvt, int enable);
    int (* const train_echocanceller)(void *pvt);
    int (* const dsp_reset_and_flush_digits)(void *pvt);
 
    struct ast_channel * (* const new_ast_channel)(void *pvt, int state,
        enum sig_pri_law law, char *exten, const struct ast_assigned_ids *assignedids,
        const struct ast_channel *requestor);
 
    void (* const fixup_chans)(void *old_chan, void *new_chan);
 
    /* Note: Called with PRI lock held */
    void (* const handle_dchan_exception)(struct sig_pri_span *pri, int index);
    void (* const set_alarm)(void *pvt, int in_alarm);
    void (* const set_dialing)(void *pvt, int is_dialing);
    void (* const set_digital)(void *pvt, int is_digital);
    void (* const set_outgoing)(void *pvt, int is_outgoing);
    void (* const set_callerid)(void *pvt, const struct ast_party_caller *caller);
    void (* const set_dnid)(void *pvt, const char *dnid);
    void (* const set_rdnis)(void *pvt, const char *rdnis);
    void (* const queue_control)(void *pvt, int subclass);
    int (* const new_nobch_intf)(struct sig_pri_span *pri);
    void (* const init_config)(void *pvt, struct sig_pri_span *pri);
    const char *(* const get_orig_dialstring)(void *pvt);
    void (* const make_cc_dialstring)(void *pvt, char *buf, size_t buf_size);
    void (* const update_span_devstate)(struct sig_pri_span *pri);
    void (* const dial_digits)(void *pvt, const char *dial_string);
 
    void (* const open_media)(void *pvt);
 
    /*!
     * \brief Post an AMI B channel association event.
     *
     * \param pvt Private structure of the user of this module.
     * \param chan Channel associated with the private pointer
     */
    void (* const ami_channel_event)(void *pvt, struct ast_channel *chan);
 
    /*! Reference the parent module. */
    void (*module_ref)(void);
    /*! Unreference the parent module. */
    void (*module_unref)(void);
    /*! Mark the span for destruction. */
    void (*destroy_later)(struct sig_pri_span *pri);
};
 
/*! Global sig_pri callbacks to the upper layer. */
extern struct sig_pri_callback sig_pri_callbacks;
 
#define SIG_PRI_NUM_DCHANS      4       /*!< No more than 4 d-channels */
#define SIG_PRI_MAX_CHANNELS    672     /*!< No more than a DS3 per trunk group */
 
#define SIG_PRI     DAHDI_SIG_CLEAR
#define SIG_BRI     (0x2000000 | DAHDI_SIG_CLEAR)
#define SIG_BRI_PTMP    (0X4000000 | DAHDI_SIG_CLEAR)
 
/* QSIG channel mapping option types */
#define DAHDI_CHAN_MAPPING_PHYSICAL 0
#define DAHDI_CHAN_MAPPING_LOGICAL  1
 
/* Overlap dialing option types */
#define DAHDI_OVERLAPDIAL_NONE 0
#define DAHDI_OVERLAPDIAL_OUTGOING 1
#define DAHDI_OVERLAPDIAL_INCOMING 2
#define DAHDI_OVERLAPDIAL_BOTH (DAHDI_OVERLAPDIAL_INCOMING|DAHDI_OVERLAPDIAL_OUTGOING)
 
#if defined(HAVE_PRI_SERVICE_MESSAGES)
/*! \brief Persistent Service State */
#define SRVST_DBKEY "service-state"
/*! \brief The out-of-service SERVICE state */
#define SRVST_TYPE_OOS "O"
/*! \brief SRVST_INITIALIZED is used to indicate a channel being out-of-service
 *  The SRVST_INITIALIZED is mostly used maintain backwards compatibility but also may
 *  mean that the channel has not yet received a RESTART message.  If a channel is
 *  out-of-service with this reason a RESTART message will result in the channel
 *  being put into service. */
#define SRVST_INITIALIZED 0
/*! \brief SRVST_NEAREND is used to indicate that the near end was put out-of-service */
#define SRVST_NEAREND  (1 << 0)
/*! \brief SRVST_FAREND is used to indicate that the far end was taken out-of-service */
#define SRVST_FAREND   (1 << 1)
/*! \brief SRVST_BOTH is used to indicate that both sides of the channel are out-of-service */
#define SRVST_BOTH (SRVST_NEAREND | SRVST_FAREND)
 
/*! \brief The AstDB family */
static const char dahdi_db[] = "dahdi/registry";
#endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
 
struct sig_pri_chan {
    /* Options to be set by user */
    unsigned int hidecallerid:1;
    unsigned int hidecalleridname:1;      /*!< Hide just the name not the number for legacy PBX use */
    unsigned int immediate:1;           /*!< Answer before getting digits? */
    unsigned int priexclusive:1;            /*!< Whether or not to override and use exclusive mode for channel selection */
    unsigned int priindication_oob:1;
    unsigned int use_callerid:1;            /*!< Whether or not to use caller id on this channel */
    unsigned int use_callingpres:1;         /*!< Whether to use the callingpres the calling switch sends */
    char context[AST_MAX_CONTEXT];
    char mohinterpret[MAX_MUSICCLASS];
    int stripmsd;
    int channel;                    /*!< Channel Number or CRV */
 
    /* Options to be checked by user */
    int cid_ani2;                       /*!< Automatic Number Identification number (Alternate PRI caller ID number) */
    int cid_ton;                    /*!< Type Of Number (TON) */
    int callingpres;                /*!< The value of calling presentation that we're going to use when placing a PRI call */
    char cid_num[AST_MAX_EXTENSION];
    char cid_subaddr[AST_MAX_EXTENSION];
    char cid_name[AST_MAX_EXTENSION];
    char cid_ani[AST_MAX_EXTENSION];
    /*! \brief User tag for party id's sent from this device driver. */
    char user_tag[AST_MAX_EXTENSION * 2];
    char exten[AST_MAX_EXTENSION];
 
    /* Internal variables -- Don't touch */
    /* Probably will need DS0 number, DS1 number, and a few other things */
    char dialdest[256];             /* Queued up digits for overlap dialing.  They will be sent out as information messages when setup ACK is received */
#if defined(HAVE_PRI_SETUP_KEYPAD)
    /*! \brief Keypad digits that came in with the SETUP message. */
    char keypad_digits[AST_MAX_EXTENSION];
#endif  /* defined(HAVE_PRI_SETUP_KEYPAD) */
    /*! 'w' deferred dialing digits. */
    char deferred_digits[AST_MAX_EXTENSION];
    /*! Music class suggested with AST_CONTROL_HOLD. */
    char moh_suggested[MAX_MUSICCLASS];
    enum sig_pri_moh_state moh_state;
 
#if defined(HAVE_PRI_AOC_EVENTS)
    struct pri_subcmd_aoc_e aoc_e;
    int aoc_s_request_invoke_id;     /*!< If an AOC-S request was present for the call, this is the invoke_id to use for the response */
    unsigned int aoc_s_request_invoke_id_valid:1; /*!< This is set when the AOC-S invoke id is present */
    unsigned int waiting_for_aoce:1; /*!< Delaying hangup for AOC-E msg. If this is set and AOC-E is received, continue with hangup before timeout period. */
    unsigned int holding_aoce:1;     /*!< received AOC-E msg from asterisk. holding for disconnect/release */
#endif  /* defined(HAVE_PRI_AOC_EVENTS) */
    unsigned int inalarm:1;
    unsigned int alreadyhungup:1;   /*!< TRUE if the call has already gone/hungup */
    unsigned int isidlecall:1;      /*!< TRUE if this is an idle call */
    unsigned int progress:1;        /*!< TRUE if the call has seen inband-information progress through the network */
 
    /*!
     * \brief TRUE when this channel is allocated.
     *
     * \details
     * Needed to hold an outgoing channel allocation before the
     * owner pointer is created.
     *
     * \note This is one of several items to check to see if a
     * channel is available for use.
     */
    unsigned int allocated:1;
    unsigned int outgoing:1;
    unsigned int digital:1;
    /*! \brief TRUE if this interface has no B channel.  (call hold and call waiting) */
    unsigned int no_b_channel:1;
#if defined(HAVE_PRI_CALL_WAITING)
    /*! \brief TRUE if this is a call waiting call */
    unsigned int is_call_waiting:1;
#endif  /* defined(HAVE_PRI_CALL_WAITING) */
#if defined(HAVE_PRI_SETUP_ACK_INBAND)
    /*! TRUE if outgoing SETUP had no called digits */
    unsigned int no_dialed_digits:1;
#endif  /* defined(HAVE_PRI_SETUP_ACK_INBAND) */
 
    struct ast_channel *owner;
 
    struct sig_pri_span *pri;
    q931_call *call;                /*!< opaque libpri call control structure */
 
    /*! Call establishment life cycle level for simple comparisons. */
    enum sig_pri_call_level call_level;
    /*! \brief Channel reset/restart state. */
    enum sig_pri_reset_state resetting;
#if defined(HAVE_PRI_TRANSFER)
    /*! If non-NULL, send transfer disconnect successful response to first call disconnecting. */
    struct xfer_rsp_data *xfer_data;
#endif  /* defined(HAVE_PRI_TRANSFER) */
    int prioffset;                  /*!< channel number in span */
    int logicalspan;                /*!< logical span number within trunk group */
    int mastertrunkgroup;           /*!< what trunk group is our master */
#if defined(HAVE_PRI_SERVICE_MESSAGES)
    /*! \brief Active SRVST_DBKEY out-of-service status value. */
    unsigned service_status;
#endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
 
    void *chan_pvt;                 /*!< Private structure of the user of this module. */
#if defined(HAVE_PRI_REVERSE_CHARGE)
    /*!
     * \brief Reverse charging indication
     * \details
     * -1 - No reverse charging,
     *  1 - Reverse charging,
     * 0,2-7 - Reserved for future use
     */
    int reverse_charging_indication;
#endif
};
 
#if defined(HAVE_PRI_MWI)
/*! Maximum number of mailboxes per span. */
#define SIG_PRI_MAX_MWI_MAILBOXES           8
/*! Typical maximum length of mwi voicemail controlling number */
#define SIG_PRI_MAX_MWI_VM_NUMBER_LEN       10  /* digits in number */
/*! Typical maximum length of mwi mailbox number */
#define SIG_PRI_MAX_MWI_MBOX_NUMBER_LEN     10  /* digits in number */
/*! Typical maximum length of mwi mailbox context */
#define SIG_PRI_MAX_MWI_CONTEXT_LEN         10
/*!
 * \brief Maximum mwi_vm_numbers and mwi_vm_boxes string length.
 * \details
 * max_length = #mailboxes * (vm_number + ',')
 * The last ',' is a null terminator instead.
 */
#define SIG_PRI_MAX_MWI_VM_NUMBER_STR   (SIG_PRI_MAX_MWI_MAILBOXES \
    * (SIG_PRI_MAX_MWI_VM_NUMBER_LEN + 1))
/*!
 * \brief Maximum length of vm_mailbox string.
 * \details
 * max_length = vm_box + '@' + context.
 */
#define SIG_PRI_MAX_MWI_VM_MAILBOX      (SIG_PRI_MAX_MWI_MBOX_NUMBER_LEN \
    + 1 + SIG_PRI_MAX_MWI_CONTEXT_LEN)
/*!
 * \brief Maximum mwi_mailboxs string length.
 * \details
 * max_length = #mailboxes * (vm_mailbox + ',')
 * The last ',' is a null terminator instead.
 */
#define SIG_PRI_MAX_MWI_MAILBOX_STR     (SIG_PRI_MAX_MWI_MAILBOXES  \
    * (SIG_PRI_MAX_MWI_VM_MAILBOX + 1))
 
struct sig_pri_mbox {
    /*!
     * \brief MWI mailbox event subscription.
     * \note NULL if mailbox not configured.
     */
    struct ast_mwi_subscriber *sub;
    /*! \brief Mailbox uniqueid. */
    const char *uniqueid;
    /*! \brief Mailbox number sent to span. */
    const char *vm_box;
    /*! \brief Voicemail access controlling number sent to span. */
    const char *vm_number;
};
#endif  /* defined(HAVE_PRI_MWI) */
 
enum sig_pri_colp_signaling {
    /*! Block all connected line updates. */
    SIG_PRI_COLP_BLOCK,
    /*! Only send connected line information with the CONNECT message. */
    SIG_PRI_COLP_CONNECT,
    /*! Allow all connected line updates. */
    SIG_PRI_COLP_UPDATE,
};
 
struct sig_pri_span {
    /* Should be set by user */
    struct ast_cc_config_params *cc_params;         /*!< CC config parameters for each new call. */
    int pritimers[PRI_MAX_TIMERS];
    int overlapdial;                                /*!< In overlap dialing mode */
    int qsigchannelmapping;                         /*!< QSIG channel mapping type */
    int discardremoteholdretrieval;                 /*!< shall remote hold or remote retrieval notifications be discarded? */
    int facilityenable;                             /*!< Enable facility IEs */
#if defined(HAVE_PRI_L2_PERSISTENCE)
    /*! Layer 2 persistence option. */
    int l2_persistence;
#endif  /* defined(HAVE_PRI_L2_PERSISTENCE) */
    int dchan_logical_span[SIG_PRI_NUM_DCHANS];     /*!< Logical offset the DCHAN sits in */
    int fds[SIG_PRI_NUM_DCHANS];                    /*!< FD's for d-channels */
 
#if defined(HAVE_PRI_AOC_EVENTS)
    int aoc_passthrough_flag;                       /*!< Represents what AOC messages (S,D,E) are allowed to pass-through */
    unsigned int aoce_delayhangup:1;                /*!< defines whether the aoce_delayhangup option is enabled or not */
#endif  /* defined(HAVE_PRI_AOC_EVENTS) */
 
#if defined(HAVE_PRI_SERVICE_MESSAGES)
    unsigned int enable_service_message_support:1;  /*!< enable SERVICE message support */
#endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
#ifdef HAVE_PRI_INBANDDISCONNECT
    unsigned int inbanddisconnect:1;                /*!< Should we support inband audio after receiving DISCONNECT? */
#endif
#if defined(HAVE_PRI_CALL_HOLD)
    /*! \brief TRUE if held calls are transferred on disconnect. */
    unsigned int hold_disconnect_transfer:1;
#endif  /* defined(HAVE_PRI_CALL_HOLD) */
    /*!
     * \brief TRUE if call transfer is enabled for the span.
     * \note Support switch-side transfer (called 2BCT, RLT or other names)
     */
    unsigned int transfer:1;
#if defined(HAVE_PRI_CALL_WAITING)
    /*! \brief TRUE if we will allow incoming ISDN call waiting calls. */
    unsigned int allow_call_waiting_calls:1;
#endif  /* defined(HAVE_PRI_CALL_WAITING) */
    /*! TRUE if layer 1 alarm status is ignored */
    unsigned int layer1_ignored:1;
    /*!
     * TRUE if a new call's sig_pri_chan.user_tag[] has the MSN
     * appended to the initial_user_tag[].
     */
    unsigned int append_msn_to_user_tag:1;
    /*! TRUE if a SETUP ACK message needs to open the audio path. */
    unsigned int inband_on_setup_ack:1;
    /*! TRUE if a PROCEEDING message needs to unsquelch the received audio. */
    unsigned int inband_on_proceeding:1;
#if defined(HAVE_PRI_MCID)
    /*! \brief TRUE if allow sending MCID request on this span. */
    unsigned int mcid_send:1;
#endif  /* defined(HAVE_PRI_MCID) */
    /*! \brief TRUE if forcing RESTART when receive cause 44 on this span. */
    unsigned int force_restart_unavailable_chans:1;
#if defined(HAVE_PRI_DATETIME_SEND)
    /*! \brief Configured date/time ie send policy option. */
    int datetime_send;
#endif  /* defined(HAVE_PRI_DATETIME_SEND) */
    int dialplan;                           /*!< Dialing plan */
    int localdialplan;                      /*!< Local dialing plan */
    int cpndialplan;                        /*!< Connected party dialing plan */
    char internationalprefix[10];           /*!< country access code ('00' for european dialplans) */
    char nationalprefix[10];                /*!< area access code ('0' for european dialplans) */
    char localprefix[20];                   /*!< area access code + area code ('0'+area code for european dialplans) */
    char privateprefix[20];                 /*!< for private dialplans */
    char unknownprefix[20];                 /*!< for unknown dialplans */
    enum sig_pri_moh_signaling moh_signaling;
    /*! Send connected line signaling to peer option. */
    enum sig_pri_colp_signaling colp_send;
    long resetinterval;                     /*!< Interval (in seconds) for resetting unused channels */
#if defined(HAVE_PRI_DISPLAY_TEXT)
    unsigned long display_flags_send;       /*!< PRI_DISPLAY_OPTION_xxx flags for display text sending */
    unsigned long display_flags_receive;    /*!< PRI_DISPLAY_OPTION_xxx flags for display text receiving */
#endif  /* defined(HAVE_PRI_DISPLAY_TEXT) */
#if defined(HAVE_PRI_MWI)
    /*! \brief Active MWI mailboxes */
    struct sig_pri_mbox mbox[SIG_PRI_MAX_MWI_MAILBOXES];
    /*!
     * \brief Comma separated list of mailboxes to indicate MWI.
     * \note Empty if disabled.
     * \note Format: vm_mailbox{,vm_mailbox}
     * \note String is split apart when span is started.
     */
    char mwi_mailboxes[SIG_PRI_MAX_MWI_MAILBOX_STR];
    /*!
     * \brief Comma separated list of mailbox numbers sent over ISDN span for MWI.
     * \note Empty if disabled.
     * \note Format: vm_box{,vm_box}
     * \note String is split apart when span is started.
     */
    char mwi_vm_boxes[SIG_PRI_MAX_MWI_VM_NUMBER_STR];
    /*!
     * \brief Comma separated list of voicemail access controlling numbers for MWI.
     * \note Format: vm_number{,vm_number}
     * \note String is split apart when span is started.
     */
    char mwi_vm_numbers[SIG_PRI_MAX_MWI_VM_NUMBER_STR];
#endif  /* defined(HAVE_PRI_MWI) */
    /*!
     * \brief Initial user tag for party id's sent from this device driver.
     * \note String set by config file.
     */
    char initial_user_tag[AST_MAX_EXTENSION];
    char msn_list[AST_MAX_EXTENSION];       /*!< Comma separated list of MSNs to handle.  Empty if disabled. */
    char idleext[AST_MAX_EXTENSION];        /*!< Where to idle extra calls */
    char idlecontext[AST_MAX_CONTEXT];      /*!< What context to use for idle */
    char idledial[AST_MAX_EXTENSION];       /*!< What to dial before dumping */
    int minunused;                          /*!< Min # of channels to keep empty */
    int minidle;                            /*!< Min # of "idling" calls to keep active */
    int nodetype;                           /*!< Node type */
    int switchtype;                         /*!< Type of switch to emulate */
    int nsf;                                /*!< Network-Specific Facilities */
    int trunkgroup;                         /*!< What our trunkgroup is */
#if defined(HAVE_PRI_CCSS)
    int cc_ptmp_recall_mode;                /*!< CC PTMP recall mode. globalRecall(0), specificRecall(1) */
    int cc_qsig_signaling_link_req;         /*!< CC Q.SIG signaling link retention (Party A) release(0), retain(1), do-not-care(2) */
    int cc_qsig_signaling_link_rsp;         /*!< CC Q.SIG signaling link retention (Party B) release(0), retain(1) */
#endif  /* defined(HAVE_PRI_CCSS) */
#if defined(HAVE_PRI_CALL_WAITING)
    /*!
     * \brief Number of extra outgoing calls to allow on a span before
     * considering that span congested.
     */
    int max_call_waiting_calls;
    struct {
        int stripmsd;
        unsigned int hidecallerid:1;
        unsigned int hidecalleridname:1;      /*!< Hide just the name not the number for legacy PBX use */
        unsigned int immediate:1;           /*!< Answer before getting digits? */
        unsigned int priexclusive:1;            /*!< Whether or not to override and use exclusive mode for channel selection */
        unsigned int priindication_oob:1;
        unsigned int use_callerid:1;            /*!< Whether or not to use caller id on this channel */
        unsigned int use_callingpres:1;         /*!< Whether to use the callingpres the calling switch sends */
        char context[AST_MAX_CONTEXT];
        char mohinterpret[MAX_MUSICCLASS];
    } ch_cfg;
 
    /*!
     * \brief Number of outstanding call waiting calls.
     * \note Must be zero to allow new calls from asterisk to
     * immediately allocate a B channel.
     */
    int num_call_waiting_calls;
#endif  /* defined(HAVE_PRI_CALL_WAITING) */
    int dchanavail[SIG_PRI_NUM_DCHANS];     /*!< Whether each channel is available */
    int debug;                              /*!< set to true if to dump PRI event info */
    int span;                               /*!< span number put into user output messages */
    int resetting;                          /*!< true if span is being reset/restarted */
    int resetpos;                           /*!< current position during a reset (-1 if not started) */
    int sig;                                /*!< ISDN signalling type (SIG_PRI, SIG_BRI, SIG_BRI_PTMP, etc...) */
    int new_chan_seq;                       /*!< New struct ast_channel sequence number */
    /*! TRUE if we have already whined about no D channels available. */
    unsigned int no_d_channels:1;
 
    /* Everything after here is internally set */
    struct pri *dchans[SIG_PRI_NUM_DCHANS];     /*!< Actual d-channels */
    struct pri *pri;                            /*!< Currently active D-channel */
    /*!
     * List of private structures of the user of this module for no B channel
     * interfaces. (hold and call waiting interfaces)
     */
    void *no_b_chan_iflist;
    /*!
     * List of private structures of the user of this module for no B channel
     * interfaces. (hold and call waiting interfaces)
     */
    void *no_b_chan_end;
    int numchans;                               /*!< Num of channels we represent */
    struct sig_pri_chan *pvts[SIG_PRI_MAX_CHANNELS];/*!< Member channel pvt structs */
    pthread_t master;                           /*!< Thread of master */
    ast_mutex_t lock;                           /*!< libpri access Mutex */
    time_t lastreset;                           /*!< time when unused channels were last reset */
    /*!
     * \brief Congestion device state of the span.
     * \details
     * AST_DEVICE_NOT_INUSE - Span does not have all B channels in use.
     * AST_DEVICE_BUSY - All B channels are in use.
     * AST_DEVICE_UNAVAILABLE - Span is in alarm.
     * \note
     * Device name: \verbatim DAHDI/I<span>/congestion. \endverbatim
     */
    int congestion_devstate;
#if defined(THRESHOLD_DEVSTATE_PLACEHOLDER)
    /*! \todo An ISDN span threshold device state could be useful in determining how often a span utilization goes over a configurable threshold. */
    /*!
     * \brief User threshold device state of the span.
     * \details
     * AST_DEVICE_NOT_INUSE - There are no B channels in use.
     * AST_DEVICE_INUSE - The number of B channels in use is less than
     *    the configured threshold but not zero.
     * AST_DEVICE_BUSY - The number of B channels in use meets or exceeds
     *    the configured threshold.
     * AST_DEVICE_UNAVAILABLE - Span is in alarm.
     * \note
     * Device name: \verbatim DAHDI/I<span>/threshold \endverbatim
     */
    int threshold_devstate;
    /*!
     * \brief Number of B channels in use to consider the span in a busy state.
     * \note Setting the threshold to zero is interpreted as all B channels.
     */
    int user_busy_threshold;
#endif  /* defined(THRESHOLD_DEVSTATE_PLACEHOLDER) */
};
 
void sig_pri_extract_called_num_subaddr(struct sig_pri_chan *p, const char *rdest, char *called, size_t called_buff_size);
int sig_pri_call(struct sig_pri_chan *p, struct ast_channel *ast, const char *rdest, int timeout, int layer1);
 
int sig_pri_hangup(struct sig_pri_chan *p, struct ast_channel *ast);
 
int sig_pri_indicate(struct sig_pri_chan *p, struct ast_channel *chan, int condition, const void *data, size_t datalen);
 
int sig_pri_answer(struct sig_pri_chan *p, struct ast_channel *ast);
 
int sig_pri_is_chan_available(struct sig_pri_chan *pvt);
int sig_pri_available(struct sig_pri_chan **pvt, int is_specific_channel);
 
void sig_pri_init_pri(struct sig_pri_span *pri);
 
/* If return 0, it means this function was able to handle it (pre setup digits).  If non zero, the user of this
 * functions should handle it normally (generate inband DTMF) */
int sig_pri_digit_begin(struct sig_pri_chan *pvt, struct ast_channel *ast, char digit);
void sig_pri_dial_complete(struct sig_pri_chan *pvt, struct ast_channel *ast);
 
void sig_pri_stop_pri(struct sig_pri_span *pri);
int sig_pri_start_pri(struct sig_pri_span *pri);
 
void sig_pri_set_alarm(struct sig_pri_chan *p, int in_alarm);
void sig_pri_chan_alarm_notify(struct sig_pri_chan *p, int noalarm);
 
int sig_pri_is_alarm_ignored(struct sig_pri_span *pri);
void pri_event_alarm(struct sig_pri_span *pri, int index, int before_start_pri);
void pri_event_noalarm(struct sig_pri_span *pri, int index, int before_start_pri);
 
struct ast_channel *sig_pri_request(struct sig_pri_chan *p, enum sig_pri_law law,
    const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor,
    int transfercapability);
 
struct sig_pri_chan *sig_pri_chan_new(void *pvt_data, struct sig_pri_span *pri, int logicalspan, int channo, int trunkgroup);
void sig_pri_chan_delete(struct sig_pri_chan *doomed);
 
int pri_is_up(struct sig_pri_span *pri);
 
struct mansession;
int sig_pri_ami_show_spans(struct mansession *s, const char *show_cmd, struct sig_pri_span *pri, const int *dchannels, const char *action_id);
 
void sig_pri_cli_show_channels_header(int fd);
void sig_pri_cli_show_channels(int fd, struct sig_pri_span *pri);
void sig_pri_cli_show_spans(int fd, int span, struct sig_pri_span *pri);
 
void sig_pri_cli_show_span(int fd, int *dchannels, struct sig_pri_span *pri);
 
int pri_send_keypad_facility_exec(struct sig_pri_chan *p, const char *digits);
int pri_send_callrerouting_facility_exec(struct sig_pri_chan *p, enum ast_channel_state chanstate, const char *destination, const char *original, const char *reason);
 
#if defined(HAVE_PRI_SERVICE_MESSAGES)
int pri_maintenance_bservice(struct pri *pri, struct sig_pri_chan *p, int changestatus);
#endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
 
void sig_pri_fixup(struct ast_channel *oldchan, struct ast_channel *newchan, struct sig_pri_chan *pchan);
#if defined(HAVE_PRI_DISPLAY_TEXT)
void sig_pri_sendtext(struct sig_pri_chan *pchan, const char *text);
#endif  /* defined(HAVE_PRI_DISPLAY_TEXT) */
 
int sig_pri_cc_agent_init(struct ast_cc_agent *agent, struct sig_pri_chan *pvt_chan);
int sig_pri_cc_agent_start_offer_timer(struct ast_cc_agent *agent);
int sig_pri_cc_agent_stop_offer_timer(struct ast_cc_agent *agent);
void sig_pri_cc_agent_req_rsp(struct ast_cc_agent *agent, enum ast_cc_agent_response_reason reason);
int sig_pri_cc_agent_status_req(struct ast_cc_agent *agent);
int sig_pri_cc_agent_stop_ringing(struct ast_cc_agent *agent);
int sig_pri_cc_agent_party_b_free(struct ast_cc_agent *agent);
int sig_pri_cc_agent_start_monitoring(struct ast_cc_agent *agent);
int sig_pri_cc_agent_callee_available(struct ast_cc_agent *agent);
void sig_pri_cc_agent_destructor(struct ast_cc_agent *agent);
 
int sig_pri_cc_monitor_req_cc(struct ast_cc_monitor *monitor, int *available_timer_id);
int sig_pri_cc_monitor_suspend(struct ast_cc_monitor *monitor);
int sig_pri_cc_monitor_unsuspend(struct ast_cc_monitor *monitor);
int sig_pri_cc_monitor_status_rsp(struct ast_cc_monitor *monitor, enum ast_device_state devstate);
int sig_pri_cc_monitor_cancel_available_timer(struct ast_cc_monitor *monitor, int *sched_id);
void sig_pri_cc_monitor_destructor(void *monitor_pvt);
 
int sig_pri_load(const char *cc_type_name);
void sig_pri_unload(void);
 
#endif /* _SIG_PRI_H */

SIG_PRI_MAX_CHANNELS

#define SIG_PRI_MAX_CHANNELS   672

No more than a DS3 per trunk group

Definition at line 240 of file sig_pri.h.

SIG_PRI_NUM_DCHANS

#define SIG_PRI_NUM_DCHANS   4

No more than 4 d-channels

Definition at line 239 of file sig_pri.h.

Enumeration Type Documentation

sig_pri_call_level

enum sig_pri_call_level

Call establishment life cycle level for simple comparisons.

Enumerator
SIG_PRI_CALL_LEVEL_IDLE	Call does not exist.
SIG_PRI_CALL_LEVEL_SETUP	Call is present but has no response yet. (SETUP)
SIG_PRI_CALL_LEVEL_OVERLAP	Call is collecting digits for overlap dialing. (SETUP ACKNOWLEDGE)
SIG_PRI_CALL_LEVEL_PROCEEDING	Call routing is happening. (PROCEEDING)
SIG_PRI_CALL_LEVEL_ALERTING	Called party is being alerted of the call. (ALERTING)
SIG_PRI_CALL_LEVEL_DEFER_DIAL	Call is dialing 'w' deferred digits. (CONNECT)
SIG_PRI_CALL_LEVEL_CONNECT	Call is connected/answered. (CONNECT)

Definition at line 135 of file sig_pri.h.

                        {
    /*! Call does not exist. */
    SIG_PRI_CALL_LEVEL_IDLE,
    /*! Call is present but has no response yet. (SETUP) */
    SIG_PRI_CALL_LEVEL_SETUP,
    /*! Call is collecting digits for overlap dialing. (SETUP ACKNOWLEDGE) */
    SIG_PRI_CALL_LEVEL_OVERLAP,
    /*! Call routing is happening. (PROCEEDING) */
    SIG_PRI_CALL_LEVEL_PROCEEDING,
    /*! Called party is being alerted of the call. (ALERTING) */
    SIG_PRI_CALL_LEVEL_ALERTING,
    /*! Call is dialing 'w' deferred digits. (CONNECT) */
    SIG_PRI_CALL_LEVEL_DEFER_DIAL,
    /*! Call is connected/answered. (CONNECT) */
    SIG_PRI_CALL_LEVEL_CONNECT,
};

sig_pri_colp_signaling

enum sig_pri_colp_signaling

Enumerator
SIG_PRI_COLP_BLOCK	Block all connected line updates.
SIG_PRI_COLP_CONNECT	Only send connected line information with the CONNECT message.
SIG_PRI_COLP_UPDATE	Allow all connected line updates.

Definition at line 435 of file sig_pri.h.

                            {
    /*! Block all connected line updates. */
    SIG_PRI_COLP_BLOCK,
    /*! Only send connected line information with the CONNECT message. */
    SIG_PRI_COLP_CONNECT,
    /*! Allow all connected line updates. */
    SIG_PRI_COLP_UPDATE,
};

sig_pri_law

enum sig_pri_law

Enumerator
SIG_PRI_DEFLAW
SIG_PRI_ULAW
SIG_PRI_ALAW

Definition at line 67 of file sig_pri.h.

                 {
    SIG_PRI_DEFLAW = 0,
    SIG_PRI_ULAW,
    SIG_PRI_ALAW
};

sig_pri_moh_event

enum sig_pri_moh_event

Enumerator
SIG_PRI_MOH_EVENT_RESET	Reset the MOH state machine. (Because of hangup.)
SIG_PRI_MOH_EVENT_HOLD	Bridged peer placed this channel on hold.
SIG_PRI_MOH_EVENT_UNHOLD	Bridged peer took this channel off hold.
SIG_PRI_MOH_EVENT_NUM	Number of MOH events. Must be last in enum.

Definition at line 110 of file sig_pri.h.

                       {
    /*! Reset the MOH state machine. (Because of hangup.) */
    SIG_PRI_MOH_EVENT_RESET,
    /*! Bridged peer placed this channel on hold. */
    SIG_PRI_MOH_EVENT_HOLD,
    /*! Bridged peer took this channel off hold. */
    SIG_PRI_MOH_EVENT_UNHOLD,
#if defined(HAVE_PRI_CALL_HOLD)
    /*! The hold request was successfully acknowledged. */
    SIG_PRI_MOH_EVENT_HOLD_ACK,
    /*! The hold request was rejected. */
    SIG_PRI_MOH_EVENT_HOLD_REJ,
    /*! The unhold request was successfully acknowledged. */
    SIG_PRI_MOH_EVENT_RETRIEVE_ACK,
    /*! The unhold request was rejected. */
    SIG_PRI_MOH_EVENT_RETRIEVE_REJ,
    /*! The remote party took this channel off hold. */
    SIG_PRI_MOH_EVENT_REMOTE_RETRIEVE_ACK,
#endif  /* defined(HAVE_PRI_CALL_HOLD) */
 
    /*! Number of MOH events.  Must be last in enum. */
    SIG_PRI_MOH_EVENT_NUM
};

sig_pri_moh_signaling

enum sig_pri_moh_signaling

Enumerator
SIG_PRI_MOH_SIGNALING_MOH	Generate MOH to the remote party.
SIG_PRI_MOH_SIGNALING_NOTIFY	Send hold notification signaling to the remote party.

Definition at line 73 of file sig_pri.h.

                           {
    /*! Generate MOH to the remote party. */
    SIG_PRI_MOH_SIGNALING_MOH,
    /*! Send hold notification signaling to the remote party. */
    SIG_PRI_MOH_SIGNALING_NOTIFY,
#if defined(HAVE_PRI_CALL_HOLD)
    /*! Use HOLD/RETRIEVE signaling to release the B channel while on hold. */
    SIG_PRI_MOH_SIGNALING_HOLD,
#endif  /* defined(HAVE_PRI_CALL_HOLD) */
};

sig_pri_moh_state

enum sig_pri_moh_state

Enumerator
SIG_PRI_MOH_STATE_IDLE	Bridged peer has not put us on hold.
SIG_PRI_MOH_STATE_NOTIFY	Bridged peer has put us on hold and we were to notify the remote party.
SIG_PRI_MOH_STATE_MOH	Bridged peer has put us on hold and we were to play MOH or HOLD/RETRIEVE fallback.
SIG_PRI_MOH_STATE_NUM	Number of MOH states. Must be last in enum.

Definition at line 84 of file sig_pri.h.

                       {
    /*! Bridged peer has not put us on hold. */
    SIG_PRI_MOH_STATE_IDLE,
    /*! Bridged peer has put us on hold and we were to notify the remote party. */
    SIG_PRI_MOH_STATE_NOTIFY,
    /*! Bridged peer has put us on hold and we were to play MOH or HOLD/RETRIEVE fallback. */
    SIG_PRI_MOH_STATE_MOH,
#if defined(HAVE_PRI_CALL_HOLD)
    /*! Requesting to put channel on hold. */
    SIG_PRI_MOH_STATE_HOLD_REQ,
    /*! Trying to go on hold when bridged peer requested to unhold. */
    SIG_PRI_MOH_STATE_PEND_UNHOLD,
    /*! Channel is held. */
    SIG_PRI_MOH_STATE_HOLD,
    /*! Requesting to take channel out of hold. */
    SIG_PRI_MOH_STATE_RETRIEVE_REQ,
    /*! Trying to take channel out of hold when bridged peer requested to hold. */
    SIG_PRI_MOH_STATE_PEND_HOLD,
    /*! Failed to take the channel out of hold. No B channels were available? */
    SIG_PRI_MOH_STATE_RETRIEVE_FAIL,
#endif  /* defined(HAVE_PRI_CALL_HOLD) */
 
    /*! Number of MOH states.  Must be last in enum. */
    SIG_PRI_MOH_STATE_NUM
};

sig_pri_reset_state

enum sig_pri_reset_state

Enumerator
SIG_PRI_RESET_IDLE	The channel is not being RESTARTed.
SIG_PRI_RESET_ACTIVE	The channel is being RESTARTed. Note Waiting for a RESTART ACKNOWLEDGE from the peer.
SIG_PRI_RESET_NO_ACK	Peer may not be sending the expected RESTART ACKNOWLEDGE. We have already received a SETUP on this channel. If another SETUP comes in on this channel then the peer considers this channel useable. Assume that the peer is never going to give us a RESTART ACKNOWLEDGE and assume that we have received one. This is not according to Q.931, but some peers occasionally fail to send a RESTART ACKNOWLEDGE.

Definition at line 152 of file sig_pri.h.

                         {
    /*! \brief The channel is not being RESTARTed. */
    SIG_PRI_RESET_IDLE,
    /*!
     * \brief The channel is being RESTARTed.
     * \note Waiting for a RESTART ACKNOWLEDGE from the peer.
     */
    SIG_PRI_RESET_ACTIVE,
    /*!
     * \brief Peer may not be sending the expected RESTART ACKNOWLEDGE.
     *
     * \details We have already received a SETUP on this channel.
     * If another SETUP comes in on this channel then the peer
     * considers this channel useable.  Assume that the peer is
     * never going to give us a RESTART ACKNOWLEDGE and assume that
     * we have received one.  This is not according to Q.931, but
     * some peers occasionally fail to send a RESTART ACKNOWLEDGE.
     */
    SIG_PRI_RESET_NO_ACK,
};

sig_pri_tone

enum sig_pri_tone

Enumerator
SIG_PRI_TONE_RINGTONE
SIG_PRI_TONE_STUTTER
SIG_PRI_TONE_CONGESTION
SIG_PRI_TONE_DIALTONE
SIG_PRI_TONE_DIALRECALL
SIG_PRI_TONE_INFO
SIG_PRI_TONE_BUSY

Definition at line 57 of file sig_pri.h.

                  {
    SIG_PRI_TONE_RINGTONE = 0,
    SIG_PRI_TONE_STUTTER,
    SIG_PRI_TONE_CONGESTION,
    SIG_PRI_TONE_DIALTONE,
    SIG_PRI_TONE_DIALRECALL,
    SIG_PRI_TONE_INFO,
    SIG_PRI_TONE_BUSY,
};

Function Documentation

pri_event_alarm()

void pri_event_alarm	(	struct sig_pri_span *	pri,
		int	index,
		int	before_start_pri
	)

pri_event_noalarm()

void pri_event_noalarm	(	struct sig_pri_span *	pri,
		int	index,
		int	before_start_pri
	)

pri_is_up()

int pri_is_up

(

struct sig_pri_span *

pri

)

pri_send_callrerouting_facility_exec()

int pri_send_callrerouting_facility_exec	(	struct sig_pri_chan *	p,
		enum ast_channel_state	chanstate,
		const char *	destination,
		const char *	original,
		const char *	reason
	)

pri_send_keypad_facility_exec()

int pri_send_keypad_facility_exec	(	struct sig_pri_chan *	p,
		const char *	digits
	)

sig_pri_ami_show_spans()

int sig_pri_ami_show_spans	(	struct mansession *	s,
		const char *	show_cmd,
		struct sig_pri_span *	pri,
		const int *	dchannels,
		const char *	action_id
	)

sig_pri_answer()

int sig_pri_answer	(	struct sig_pri_chan *	p,
		struct ast_channel *	ast
	)

Referenced by dahdi_answer().

sig_pri_available()

int sig_pri_available	(	struct sig_pri_chan **	pvt,
		int	is_specific_channel
	)

Referenced by available().

sig_pri_call()

int sig_pri_call	(	struct sig_pri_chan *	p,
		struct ast_channel *	ast,
		const char *	rdest,
		int	timeout,
		int	layer1
	)

Referenced by dahdi_call().

sig_pri_cc_agent_callee_available()

int sig_pri_cc_agent_callee_available

(

struct ast_cc_agent *

agent

)

sig_pri_cc_agent_destructor()

void sig_pri_cc_agent_destructor

(

struct ast_cc_agent *

agent

)

sig_pri_cc_agent_init()

int sig_pri_cc_agent_init	(	struct ast_cc_agent *	agent,
		struct sig_pri_chan *	pvt_chan
	)

sig_pri_cc_agent_party_b_free()

int sig_pri_cc_agent_party_b_free

(

struct ast_cc_agent *

agent

)

sig_pri_cc_agent_req_rsp()

void sig_pri_cc_agent_req_rsp	(	struct ast_cc_agent *	agent,
		enum ast_cc_agent_response_reason	reason
	)

sig_pri_cc_agent_start_monitoring()

int sig_pri_cc_agent_start_monitoring

(

struct ast_cc_agent *

agent

)

sig_pri_cc_agent_start_offer_timer()

int sig_pri_cc_agent_start_offer_timer

(

struct ast_cc_agent *

agent

)

sig_pri_cc_agent_status_req()

int sig_pri_cc_agent_status_req

(

struct ast_cc_agent *

agent

)

sig_pri_cc_agent_stop_offer_timer()

int sig_pri_cc_agent_stop_offer_timer

(

struct ast_cc_agent *

agent

)

sig_pri_cc_agent_stop_ringing()

int sig_pri_cc_agent_stop_ringing

(

struct ast_cc_agent *

agent

)

sig_pri_cc_monitor_cancel_available_timer()

int sig_pri_cc_monitor_cancel_available_timer	(	struct ast_cc_monitor *	monitor,
		int *	sched_id
	)

sig_pri_cc_monitor_destructor()

void sig_pri_cc_monitor_destructor

(

void *

monitor_pvt

)

sig_pri_cc_monitor_req_cc()

int sig_pri_cc_monitor_req_cc	(	struct ast_cc_monitor *	monitor,
		int *	available_timer_id
	)

sig_pri_cc_monitor_status_rsp()

int sig_pri_cc_monitor_status_rsp	(	struct ast_cc_monitor *	monitor,
		enum ast_device_state	devstate
	)

sig_pri_cc_monitor_suspend()

int sig_pri_cc_monitor_suspend

(

struct ast_cc_monitor *

monitor

)

sig_pri_cc_monitor_unsuspend()

int sig_pri_cc_monitor_unsuspend

(

struct ast_cc_monitor *

monitor

)

sig_pri_chan_alarm_notify()

void sig_pri_chan_alarm_notify	(	struct sig_pri_chan *	p,
		int	noalarm
	)

Referenced by dahdi_handle_event(), and handle_init_event().

sig_pri_chan_delete()

void sig_pri_chan_delete

(

struct sig_pri_chan *

doomed

)

Referenced by destroy_dahdi_pvt().

sig_pri_chan_new()

struct sig_pri_chan * sig_pri_chan_new	(	void *	pvt_data,
		struct sig_pri_span *	pri,
		int	logicalspan,
		int	channo,
		int	trunkgroup
	)

Referenced by mkintf().

sig_pri_cli_show_channels()

void sig_pri_cli_show_channels	(	int	fd,
		struct sig_pri_span *	pri
	)

sig_pri_cli_show_channels_header()

void sig_pri_cli_show_channels_header

(

int

fd

)

sig_pri_cli_show_span()

void sig_pri_cli_show_span	(	int	fd,
		int *	dchannels,
		struct sig_pri_span *	pri
	)

sig_pri_cli_show_spans()

void sig_pri_cli_show_spans	(	int	fd,
		int	span,
		struct sig_pri_span *	pri
	)

sig_pri_dial_complete()

void sig_pri_dial_complete	(	struct sig_pri_chan *	pvt,
		struct ast_channel *	ast
	)

Referenced by dahdi_handle_event().

sig_pri_digit_begin()

int sig_pri_digit_begin	(	struct sig_pri_chan *	pvt,
		struct ast_channel *	ast,
		char	digit
	)

Referenced by dahdi_digit_begin().

sig_pri_extract_called_num_subaddr()

void sig_pri_extract_called_num_subaddr	(	struct sig_pri_chan *	p,
		const char *	rdest,
		char *	called,
		size_t	called_buff_size
	)

Referenced by dahdi_call(), and dahdi_request().

sig_pri_fixup()

void sig_pri_fixup	(	struct ast_channel *	oldchan,
		struct ast_channel *	newchan,
		struct sig_pri_chan *	pchan
	)

Referenced by dahdi_fixup().

sig_pri_hangup()

int sig_pri_hangup	(	struct sig_pri_chan *	p,
		struct ast_channel *	ast
	)

Referenced by dahdi_hangup().

sig_pri_indicate()

int sig_pri_indicate	(	struct sig_pri_chan *	p,
		struct ast_channel *	chan,
		int	condition,
		const void *	data,
		size_t	datalen
	)

Referenced by dahdi_indicate().

sig_pri_init_pri()

void sig_pri_init_pri

(

struct sig_pri_span *

pri

)

Referenced by dahdi_restart(), and load_module().

sig_pri_is_alarm_ignored()

int sig_pri_is_alarm_ignored

(

struct sig_pri_span *

pri

)

Referenced by handle_alarms(), and handle_clear_alarms().

sig_pri_is_chan_available()

int sig_pri_is_chan_available

(

struct sig_pri_chan *

pvt

)

sig_pri_load()

int sig_pri_load

(

const char *

cc_type_name

)

Referenced by load_module().

sig_pri_request()

struct ast_channel * sig_pri_request	(	struct sig_pri_chan *	p,
		enum sig_pri_law	law,
		const struct ast_assigned_ids *	assignedids,
		const struct ast_channel *	requestor,
		int	transfercapability
	)

Referenced by dahdi_request().

sig_pri_set_alarm()

void sig_pri_set_alarm	(	struct sig_pri_chan *	p,
		int	in_alarm
	)

Referenced by mkintf().

sig_pri_start_pri()

int sig_pri_start_pri

(

struct sig_pri_span *

pri

)

Referenced by setup_dahdi_int().

sig_pri_stop_pri()

void sig_pri_stop_pri

(

struct sig_pri_span *

pri

)

Referenced by __unload_module().

sig_pri_unload()

void sig_pri_unload

(

void

)

Referenced by __unload_module().

Variable Documentation

sig_pri_callbacks

struct sig_pri_callback sig_pri_callbacks

extern

Global sig_pri callbacks to the upper layer.