mod.c File Reference

---

Detailed Description

CDiameterPeer SER module interface and definitions.

Author:

Dragos Vingarzan vingarzan -at- fokus dot fraunhofer dot de

Definition in file mod.c.

#include "mod.h"
#include "diameter_peer.h"
#include "config.h"
#include "cdp_load.h"

Go to the source code of this file.

Functions
static int	cdp_init (void)
	Module init function.
static int	cdp_child_init (int rank)
	Child init function.
static int	cdp_exit (void)
	Module termination function.
Variables
MODULE_VERSION char *	config_file = "DiameterPeer.xml"
	default DiameterPeer configuration filename
dp_config *	config
	DiameterPeer configuration structure.
static cmd_export_t	cdp_cmds []
	Exported functions.
static param_export_t	cdp_params []
	Exported parameters.
module_exports	exports
	Exported module interface.

---

Function Documentation

static int cdp_init

(

void

)

[static]

Module init function.

• Initializes the diameter peer using the provided configuration file.
• Registers with pt the required number of processes.

Definition at line 174 of file mod.c.

References config, config_file, diameter_peer_init(), M_NAME, dp_config::peers_cnt, and dp_config::workers.

{
    LOG(L_INFO,"INFO:"M_NAME":cdp_init(): CDiameterPeer initializing\n");
    if (!diameter_peer_init(config_file)){
        LOG(L_CRIT,"ERR:"M_NAME":cdp_init(): error initializing the diameter peer\n");
        return 1;
    }
    register_procs(2+config->workers + 2 * config->peers_cnt);
    return 0;
}

static int cdp_child_init

(

int

rank

)

[static]

Child init function.

• starts the DiameterPeer by forking the processes

  Parameters:

  rank

  - id of the child

Definition at line 190 of file mod.c.

References diameter_peer_start(), and M_NAME.

{
    if (rank == PROC_MAIN) { 
        LOG(L_INFO,"INFO:"M_NAME":cdp_child_init(): CDiameterPeer starting ...\n");     
        diameter_peer_start(0);
        LOG(L_INFO,"INFO:"M_NAME":cdp_child_init(): ... CDiameterPeer started\n");      
    }
    
    return 0;
}

static int cdp_exit

(

void

)

[static]

Module termination function.

• stop the DiameterPeer processes in a civilized manner

Definition at line 206 of file mod.c.

References diameter_peer_destroy(), and M_NAME.

{
    LOG(L_INFO,"INFO:"M_NAME":cdp_exit(): CDiameterPeer stoping ...\n");        
    diameter_peer_destroy();
    LOG(L_INFO,"INFO:"M_NAME":cdp_exit(): ... CDiameterPeer stoped\n");     
    return 0;
}

---

Variable Documentation

MODULE_VERSION char* config_file = "DiameterPeer.xml"

default DiameterPeer configuration filename

Definition at line 66 of file mod.c.

Referenced by cdp_init().

dp_config* config

DiameterPeer configuration structure.

Definition at line 76 of file diameter_peer.c.

cmd_export_t cdp_cmds[] [static]

Exported functions.

This is the API available for use from other SER modules. If you require more, please add them here.

• load_cdp() - find and load the CDiameterPeer function bindings

• AAACreateRequest() - create a diameter request AAAMessage
• AAACreateResponse() - create a diameter response AAAMessage
• AAAFreeMessage() - free up the memory used in a Diameter message

• AAASendMessage() - asynchronously send a message
• AAASendMessageToPeer() - asynchronously send a message to a forced peer
• AAASendRecvMessage() - synchronously send a message and get the response
• AAASendRecvMessageToPeer() - synchronously send a message and get the response to a forced peer

• AAACreateSession() - create a diameter AAASessionId
• AAADropSession() - drop a diameter AAASessionId

• AAACreateTransaction() - create a diameter AAATransaction
• AAADropTransaction() - drop a diameter AAATransaction

• AAACreateAVP() - create an AAA_AVP
• AAAAddAVPToMessage() - add an AAA_AVP to a AAAMessage
• AAAFindMatchingAVP() - find an AAA_AVP inside a AAAMessage
• AAAGetNextAVP() - get the next AAA_AVP from the AAAMessage
• AAAFreeAVP() - free the memory taken by the AAA_AVP
• AAAGroupAVPS() - group a AAA_AVP_LIST of AAA_AVP into a grouped AAA_AVP
• AAAUngroupAVPS() - ungroup a grouped AAA_AVP into a AAA_AVP_LIST of AAA_AVP
• AAAFindMatchingAVPList() - find an AAA_AVP inside a AAA_AVP_LIST
• AAAFreeAVPList() - free the memory taken by the all members of AAA_AVP_LIST

• AAAAddRequestHandler() - add a AAARequestHandler_f callback to request being received
• AAAAddResponseHandler() - add a AAAResponseHandler_f callback to responses being received

Definition at line 104 of file mod.c.

param_export_t cdp_params[] [static]

Initial value:

 {  
    { "config_file",PARAM_STRING,&config_file}, 
    { 0, 0, 0 }
}

Exported parameters.

• config_file - Configuration filename. See configdtd.h for the structure and ConfigExample.xml.

Definition at line 144 of file mod.c.

struct module_exports exports

Initial value:

 {
    "cdp",
    cdp_cmds,                       
    0,
    cdp_params,                     
    cdp_init,                   
    (response_function) 0,
    (destroy_function) cdp_exit,
    0,
    (child_init_function) cdp_child_init 
}

Exported module interface.

Definition at line 153 of file mod.c.

---