release_call.h File Reference

#include "../tm/tm_load.h"
#include "dlg_state.h"
#include "../dialog/dlg_mod.h"
#include "sip.h"

Go to the source code of this file.

Defines
#define	MAX_TIMES_TO_TRY_TO_RELEASE   5
Enumerations
enum	release_call_situation { RELEASE_CALL_EARLY = 0, RELEASE_CALL_WEIRD = 1 }
Functions
int	P_release_call_onreply (struct sip_msg *msg, char *str1, char *str2)
	Releases a call from the on reply route block called with any reply to an INVITE useful in cases of rejecting a call when you are processing the SDP or handling QoS things - the sip message being processed - the first parameter "orig" or "term" - [optional] the Reason header that you want to go to the messages.
int	release_call (str callid, int reason_code, str reason_text)
	Given a call-id, locate if its terminating,orginating or both release the dialog involved and drop the dialog.
int	release_call_p (p_dialog *d, int reason_code, str reason_text)
	Releases a dialog either confirmed or early the dialog is given with a lock on the hash!

---

Define Documentation

#define MAX_TIMES_TO_TRY_TO_RELEASE   5

Definition at line 74 of file release_call.h.

Referenced by release_call_confirmed(), release_call_previous(), release_call_s(), and release_subscription().

---

Enumeration Type Documentation

enum release_call_situation

Enumerator:

RELEASE_CALL_EARLY
RELEASE_CALL_WEIRD

Definition at line 64 of file release_call.h.

                           {
    RELEASE_CALL_EARLY=0,
    RELEASE_CALL_WEIRD=1
     /*Weird state is the technical name of the state in which a
      * sip session is when the callee has already sent a 200 OK for INVITE
      * and the caller hasn't yet recieved this response
      * In Weird state the session can only be released by sending an ACK followed
      * by a  BYE to the callee and a reply >400 to the caller
      * a CANCEL wouldn't be understood by the callee!*/
};

---

Function Documentation

int P_release_call_onreply	(	struct sip_msg *	msg,
		char *	str1,
		char *	str2
	)

Releases a call from the on reply route block called with any reply to an INVITE useful in cases of rejecting a call when you are processing the SDP or handling QoS things - the sip message being processed - the first parameter "orig" or "term" - [optional] the Reason header that you want to go to the messages.

Returns:

- TRUE on success or FALSE on misscall and BREAK on error

Definition at line 426 of file release_call.c.

References _488_text_s, cscf_get_call_id(), CSCF_RETURN_BREAK, CSCF_RETURN_FALSE, CSCF_RETURN_TRUE, d_unlock(), DLG_MOBILE_ORIGINATING, DLG_MOBILE_TERMINATING, get_p_dialog_dir(), _p_dialog::hash, is_p_dialog_dir(), M_NAME, NULL, RELEASE_CALL_EARLY, release_call_previous(), and RELEASE_CALL_WEIRD.

{
    enum p_dialog_direction dir;
    p_dialog *d=NULL;
    str callid;
    struct hdr_field *h1;
    str reason={NULL,0};
    
    if (str2) {
        reason.s=str2;
        reason.len=strlen(str2);
    } else
        reason = _488_text_s;
        
    
    dir= (str1[0]=='o' || str1[0]=='O' || str1[0]=='0')? DLG_MOBILE_ORIGINATING : DLG_MOBILE_TERMINATING;
    
    if (msg->first_line.type== SIP_REQUEST)
    {
        LOG(L_ERR,"ERR: P_release_call_on_reply called with a request\n");
        return CSCF_RETURN_FALSE;
    }
    
    callid=cscf_get_call_id(msg,&h1);
    if (is_p_dialog_dir(callid,dir)) {
        d=get_p_dialog_dir(callid,dir);
        if (msg->first_line.u.reply.statuscode > 199)
        {
            release_call_previous(d,RELEASE_CALL_WEIRD,488,reason);
            d_unlock(d->hash);
            return CSCF_RETURN_TRUE;
        } else {
            release_call_previous(d,RELEASE_CALL_EARLY,488,reason);
            d_unlock(d->hash);
            return CSCF_RETURN_TRUE;
        }
    } else {
        LOG(L_ERR,"ERR:"M_NAME "P_release_call_onreply :  unable to find dialog\n");
        return CSCF_RETURN_BREAK;
    }
    
}

int release_call	(	str	callid,
		int	reason_code,
		str	reason_text
	)

Given a call-id, locate if its terminating,orginating or both release the dialog involved and drop the dialog.

Parameters:

	callid	- the Call-ID to release
	reason	- the Reason header to include in messages

Returns:

0 on error, 1 on success

Definition at line 386 of file release_call.c.

References d_unlock(), DLG_MOBILE_ORIGINATING, DLG_MOBILE_TERMINATING, get_p_dialog_dir(), _p_dialog::hash, and release_call_p().

{
    p_dialog *d=0;
    unsigned int hash;
    int res = 0;
    
    d = get_p_dialog_dir(callid,DLG_MOBILE_ORIGINATING);
    if (d) {                
        hash = d->hash;
        if (release_call_p(d,reason_code,reason_text)>0) res = 1;       
        goto done;      
    }
    d = get_p_dialog_dir(callid,DLG_MOBILE_TERMINATING);
    if (d) {                
        hash = d->hash;
        if (release_call_p(d,reason_code,reason_text)>0) res = 1;       
        goto done;
    } 
    
    /*Neither ORGINATING nor TERMINATING is UNKNOWN!*/
    /*or doesn't exist*/
    /*drop it silently?*/
    /*treat it as ORIGINATING or TERMINATING?*/             
done:       
    if (d) d_unlock(hash);
    return 0;   
}

int release_call_p	(	p_dialog *	d,
		int	reason_code,
		str	reason_text
	)

Releases a dialog either confirmed or early the dialog is given with a lock on the hash!

Parameters:

	d	- p_dialog to release
	reason	- Reason header to include in messages

Returns:

0 on error , 1 on success, -1 if dialog should be deleted from outside

Definition at line 370 of file release_call.c.

References DLG_STATE_CONFIRMED, release_call_confirmed(), release_call_early(), and _p_dialog::state.

Referenced by release_call(), and terminate_p_dialog().

{       
    if (d->state>=DLG_STATE_CONFIRMED)
            return(release_call_confirmed(d,reason_code,reason_text));
     else  
            return(release_call_early(d,reason_code,reason_text)); 
}

---