RADIUS计费概要设计模板.docVIP

计费模块概要设计 上海寰创通信科技有限公司 文档更新记录 日期 更新人 版本 备注 2012-1-5 张晓波 目录 1 引言 4 1.1 编写目的 4 1.2 预期读者和阅读建议 4 1.3 参考资料 4 1.4 缩写术语 4 2 概述 4 3 整体结构 4 4 数据结构 4 4.1 用户计费统计结构 5 4.2 计费终端结构 5 5 主要算法及流程 6 5.1 操作算法 6 5.2 计费执行流程 6 5.3 实时断开用户网络流程 7 6 状态机设计 8 7 接口设计 8 7.1 外部接口设计 8 7.1.1 接收消息接口 8 7.1.2 DM报文接收接口 8 7.1.3 计费报文接收函数 9 7.2 内部接口说明 9 7.2.1 消息处理函数 9 引言 编写目的 预期读者和阅读建议 参考资料 《rfc2865》 《rfc2866》 缩写术语 缩写 英文 中文 概述 当用户认证接入AP成功之后，AC会开启对该终端的计费任务，平台模块会通知计费模块计费任务开始。计费可以分为三个阶段：计费开始，实时计费和计费结束。 计费开始是在用户认证接入成功之后，计费模块会发送一个计费请求报文到radius服务器。 计费模块收到radius回复的计费相应报文之后进入实时计费状态。在用户上网过程中，为了保护用户计费信息，每隔一段时间AC就向RADIUS服务器报一个实时计费信息，包括当前用户上网总时长，以及用户总流量信息。 当AC收到下线请求时，向RADIUS服务器发计费结束报文。 整体结构 计费模块的主要相关模块是平台，同时还需要利用socket接口与radius服务器之间进行报文的交互。计费模块需要从平台模块获取相关的配置信息，用用户接入/下线之后平台还会通知计费模块开始/结束计费。 数据结构 用户计费统计结构 struct account_user_stats{ u32 rx_packets ; /*接收包数*/ u32 tx_packets ; /*发送包数*/ u32 rx_gigawords ; /*接收字节数，单位：2^32 B*/ u32 rx_bytes ; /*接收字节数，单位：1B*/ u32 tx_gigawords ; /*发送字节数，单位：2^32 B */ u32 tx_bytes ; /*发送字节数，单位：1B */ } ; 用途：保存用户的计费统计信息； 个成员注解： rx_packets：接收包数 tx_packets ：发送包数 rx_gigawords：接收字节数，单位：2^32 B rx_bytes：接收字节数，单位：1B tx_gigawords ：发送字节数，单位：2^32 B tx_bytes：发送字节数，单位：1B 计费终端结构 struct sta_info { u8 user_name[256] ; u8 user_ip[4] ; u8 user_mac[6] ; u8 ap_mac[6] ; u8 ap_ssid[32] ; u8 nas_ip[4] ; u8 nas_identifier[256] ; u32 acct_session_id_hi; u32 acct_session_id_lo; time_t acct_session_start; int acct_session_started; int acct_terminate_cause; /* Acct-Terminate-Cause */ int acct_interim_interval; /* Acct-Interim-Interval */ time_t acct_next_interim ; struct radius_attr_data user_class ; u32 session_timeout ; u32 nas_port_id ; struct account_user_stats acct_stats ; /*终端当前IP对应流量*/ struct account_user_stats acct_stats_old ; /*终端历史IP对应总流量及主备AC切换时对应总流量*/ u32 sub_acct_time; u8 radius_ip[4]; void * ctx ; struct sta_info * next ; } ; 用途：保存需要计费的终端的信息； 个成员注解：略； 主要算法及流程 操作算法 当一个AC客户端被配置成采用RADIUS计费协议时，在开始提供服务的时候它会生成一个计费开始报文，报文描述