diameter.h

Go to the documentation of this file.

#ifndef DIAMETER_H_
#define DIAMETER_H_


#include "utils.h"
#include <ctype.h>

#define get_2bytes(_b) \
    ((((unsigned char)(_b)[0])<<8)|\
     (((unsigned char)(_b)[1])))

#define get_3bytes(_b) \
    ((((unsigned char)(_b)[0])<<16)|(((unsigned char)(_b)[1])<<8)|\
    (((unsigned char)(_b)[2])))

#define get_4bytes(_b) \
    ((((unsigned char)(_b)[0])<<24)|(((unsigned char)(_b)[1])<<16)|\
    (((unsigned char)(_b)[2])<<8)|(((unsigned char)(_b)[3])))

#define set_2bytes(_b,_v) \
    {(_b)[0]=((_v)&0x0000ff00)>>8;\
    (_b)[1]=((_v)&0x000000ff);}

#define set_3bytes(_b,_v) \
    {(_b)[0]=((_v)&0x00ff0000)>>16;(_b)[1]=((_v)&0x0000ff00)>>8;\
    (_b)[2]=((_v)&0x000000ff);}

#define set_4bytes(_b,_v) \
    {(_b)[0]=((_v)&0xff000000)>>24;(_b)[1]=((_v)&0x00ff0000)>>16;\
    (_b)[2]=((_v)&0x0000ff00)>>8;(_b)[3]=((_v)&0x000000ff);}

#define to_32x_len( _len_ ) \
    ( (_len_)+(((_len_)&3)?4-((_len_)&3):0) )
    
    
/* AAA TYPES */

#define AAA_NO_VENDOR_ID           0

#define VER_SIZE                   1
#define MESSAGE_LENGTH_SIZE        3
#define FLAGS_SIZE                 1
#define COMMAND_CODE_SIZE          3
#define APPLICATION_ID_SIZE        4
#define HOP_BY_HOP_IDENTIFIER_SIZE 4
#define END_TO_END_IDENTIFIER_SIZE 4
#define AVP_CODE_SIZE      4
#define AVP_FLAGS_SIZE     1
#define AVP_LENGTH_SIZE    3
#define AVP_VENDOR_ID_SIZE 4

#define AAA_MSG_HDR_SIZE  \
    (VER_SIZE + MESSAGE_LENGTH_SIZE + FLAGS_SIZE + COMMAND_CODE_SIZE +\
    APPLICATION_ID_SIZE+HOP_BY_HOP_IDENTIFIER_SIZE+END_TO_END_IDENTIFIER_SIZE)

#define AVP_HDR_SIZE(_flags_)  \
    (AVP_CODE_SIZE+AVP_FLAGS_SIZE+AVP_LENGTH_SIZE+\
    AVP_VENDOR_ID_SIZE*(((_flags_)&AAA_AVP_FLAG_VENDOR_SPECIFIC)!=0) )

/* mesage codes */
#ifndef WORDS_BIGENDIAN
    #define AS_MSG_CODE      0x12010000
    #define AC_MSG_CODE      0x0f010000
    #define CE_MSG_CODE      0x01010000
    #define DW_MSG_CODE      0x18010000
    #define DP_MSG_CODE      0x1a010000
    #define RA_MSG_CODE      0x02010000
    #define ST_MSG_CODE      0x13010000
    #define MASK_MSG_CODE    0xffffff00
#else
    #error BIG endian detected!!
    #define AS_MSG_CODE      0x00000112
    #define AC_MSG_CODE      0x0000010f
    #define CE_MSG_CODE      0x00000101
    #define DW_MSG_CODE      0x00000118
    #define DP_MSG_CODE      0x0000011a
    #define RA_MSG_CODE      0x00000102
    #define ST_MSG_CODE      0x00000113
    #define MASK_MSG_CODE    0x00ffffff
#endif


typedef unsigned int    AAACommandCode;     
typedef unsigned int    AAAVendorId;        
typedef unsigned int    AAAExtensionId;     
typedef unsigned int    AAA_AVPCode;        
typedef unsigned int    AAAValue;           
typedef unsigned int    AAAApplicationId;   
typedef void*           AAAApplicationRef;  
typedef str             AAASessionId;       
typedef unsigned int    AAAMsgIdentifier;   
typedef unsigned char   AAAMsgFlag;         
#define Flag_Request    0x80
#define Flag_Proxyable  0x40

#define Code_CE     257
#define Code_DW     280
#define Code_DP     282
    

typedef enum {
    AAA_ERR_NOT_FOUND = -2,         
    AAA_ERR_FAILURE   = -1,         
    AAA_ERR_SUCCESS   =  0,         
    AAA_ERR_NOMEM,                  
    AAA_ERR_PROTO,                  
    AAA_ERR_SECURITY,
    AAA_ERR_PARAMETER,
    AAA_ERR_CONFIG,
    AAA_ERR_UNKNOWN_CMD,
    AAA_ERR_MISSING_AVP,
    AAA_ERR_ALREADY_INIT,
    AAA_ERR_TIMED_OUT,
    AAA_ERR_CANNOT_SEND_MSG,
    AAA_ERR_ALREADY_REGISTERED,
    AAA_ERR_CANNOT_REGISTER,
    AAA_ERR_NOT_INITIALIZED,
    AAA_ERR_NETWORK_ERROR,
} AAAReturnCode;


typedef enum {
    AAA_AVP_DATA_TYPE,
    AAA_AVP_STRING_TYPE,
    AAA_AVP_ADDRESS_TYPE,
    AAA_AVP_INTEGER32_TYPE,
    AAA_AVP_INTEGER64_TYPE,
    AAA_AVP_TIME_TYPE,
} AAA_AVPDataType;


typedef enum {
    AAA_AVP_FLAG_NONE               = 0x00,
    AAA_AVP_FLAG_MANDATORY          = 0x40,
    AAA_AVP_FLAG_RESERVED           = 0x1F,
    AAA_AVP_FLAG_VENDOR_SPECIFIC    = 0x80,
    AAA_AVP_FLAG_END_TO_END_ENCRYPT = 0x20,
} AAA_AVPFlag;


typedef enum {
    AAA_APP_DIAMETER_COMMON_MSG  = 0,
    AAA_APP_NASREQ               = 1,
    AAA_APP_MOBILE_IP            = 2,
    AAA_APP_DIAMETER_BASE_ACC    = 3,
    AAA_APP_RELAY                = 0xffffffff,
}AAA_APP_IDS;


typedef enum {
    AAA_MULTI_ROUND_AUTH          = 1001,
    AAA_SUCCESS                   = 2001,
    AAA_COMMAND_UNSUPPORTED       = 3001,
    AAA_UNABLE_TO_DELIVER         = 3002,
    AAA_REALM_NOT_SERVED          = 3003,
    AAA_TOO_BUSY                  = 3004,
    AAA_LOOP_DETECTED             = 3005,
    AAA_REDIRECT_INDICATION       = 3006,
    AAA_APPLICATION_UNSUPPORTED   = 3007,
    AAA_INVALID_HDR_BITS          = 3008,
    AAA_INVALID_AVP_BITS          = 3009,
    AAA_UNKNOWN_PEER              = 3010,
    AAA_AUTHENTICATION_REJECTED   = 4001,
    AAA_OUT_OF_SPACE              = 4002,
    AAA_ELECTION_LOST             = 4003,
    AAA_AVP_UNSUPPORTED           = 5001,
    AAA_UNKNOWN_SESSION_ID        = 5002,
    AAA_AUTHORIZATION_REJECTED    = 5003,
    AAA_INVALID_AVP_VALUE         = 5004,
    AAA_MISSING_AVP               = 5005,
    AAA_RESOURCES_EXCEEDED        = 5006,
    AAA_CONTRADICTING_AVPS        = 5007,
    AAA_AVP_NOT_ALLOWED           = 5008,
    AAA_AVP_OCCURS_TOO_MANY_TIMES = 5009,
    AAA_NO_COMMON_APPLICATION     = 5010,
    AAA_UNSUPPORTED_VERSION       = 5011,
    AAA_UNABLE_TO_COMPLY          = 5012,
    AAA_INVALID_BIT_IN_HEADER     = 5013,
    AAA_INVALIS_AVP_LENGTH        = 5014,
    AAA_INVALID_MESSGE_LENGTH     = 5015,
    AAA_INVALID_AVP_BIT_COMBO     = 5016,
    AAA_NO_COMMON_SECURITY        = 5017,
} AAAResultCode;

typedef enum {
    AVP_User_Name                     =    1,
    AVP_Framed_IP_Address             =    8,   
    AVP_Class                         =   25,
    AVP_Session_Timeout               =   27,
    AVP_Proxy_State                   =   33,
    AVP_NAS_Port_Type                 =   61,
    AVP_Framed_Interface_Id           =   96,   
    AVP_Framed_IPv6_Prefix            =   97,
    AVP_Host_IP_Address               =  257,
    AVP_Auth_Application_Id           =  258,
    AVP_Acct_Application_Id           =  259,   
    AVP_Vendor_Specific_Application_Id=  260,
    AVP_Redirect_Max_Cache_Time       =  262,
    AVP_Session_Id                    =  263,
    AVP_Origin_Host                   =  264,
    AVP_Supported_Vendor_Id           =  265,
    AVP_Vendor_Id                     =  266,
    AVP_Result_Code                   =  268,
    AVP_Product_Name                  =  269,
    AVP_Session_Binding               =  270,
    AVP_Disconnect_Cause              =  273,
    AVP_Auth_Request_Type             =  274,
    AVP_Auth_Grace_Period             =  276,
    AVP_Auth_Session_State            =  277,
    AVP_Origin_State_Id               =  278,
    AVP_Proxy_Host                    =  280,
    AVP_Error_Message                 =  281,
    AVP_Record_Route                  =  282,
    AVP_Destination_Realm             =  283,
    AVP_Proxy_Info                    =  284,
    AVP_Re_Auth_Request_Type          =  285,
    AVP_Authorization_Lifetime        =  291,
    AVP_Redirect_Host                 =  292,
    AVP_Destination_Host              =  293,
    AVP_Termination_Cause             =  295,
    AVP_Origin_Realm                  =  296,
}AAA_AVPCodeNr;


typedef enum {
        Permanent_Termination   = 0,
        New_Server_Assigned             = 1,
        Server_Change                   = 2,
        Remove_S_CSCF                   = 3,
}AAA_AVPReasonCode;



typedef enum {
    AAA_FORWARD_SEARCH = 0, 
    AAA_BACKWARD_SEARCH     
} AAASearchType;


typedef enum {
    AAA_ACCT_EVENT = 1,
    AAA_ACCT_START = 2,
    AAA_ACCT_INTERIM = 3,
    AAA_ACCT_STOP = 4
} AAAAcctMessageType;

typedef enum {
    AVP_DUPLICATE_DATA,     
    AVP_DONT_FREE_DATA,     
    AVP_FREE_DATA,          
} AVPDataStatus;

typedef struct avp {
    struct avp *next;       
    struct avp *prev;       
    AAA_AVPCode code;       
    AAA_AVPFlag flags;      
    AAA_AVPDataType type;   
    AAAVendorId vendorId;   
    str data;               
    unsigned char free_it;  
} AAA_AVP;


typedef struct _avp_list_t {
    AAA_AVP *head;          
    AAA_AVP *tail;          
} AAA_AVP_LIST;


typedef struct _message_t {
    AAACommandCode      commandCode;    
    AAAMsgFlag          flags;          
    AAAApplicationId    applicationId;  
    AAAMsgIdentifier    endtoendId;     
    AAAMsgIdentifier    hopbyhopId;     
    AAASessionId        *sId;           
    AAA_AVP             *sessionId;     
    AAA_AVP             *orig_host;     
    AAA_AVP             *orig_realm;    
    AAA_AVP             *dest_host;     
    AAA_AVP             *dest_realm;    
    AAA_AVP             *res_code;      
    AAA_AVP             *auth_ses_state;
    AAA_AVP_LIST        avpList;        
    str                 buf;            
    void                *in_peer;       
} AAAMessage;




/**************************** AAA MESSAGE FUNCTIONS **************************/

/* MESSAGES */

#define is_req(_msg_) \
    (((_msg_)->flags)&0x80)




typedef struct _AAATransaction{
    unsigned int hash,label;
    AAAApplicationId application_id;
    AAACommandCode command_code;
} AAATransaction;


typedef void (AAATransactionCallback_f)(int is_timeout,void *param,AAAMessage *ans);
typedef AAAMessage* (AAARequestHandler_f)(AAAMessage *req, void *param);
typedef void (AAAResponseHandler_f)(AAAMessage *res, void *param);


#endif /*DIAMETER_H_*/

---