#ifndef	__APP_MAIN_INCLUDE_H__
#define	__APP_MAIN_INCLUDE_H__

#include "lib_acl.h"

#ifdef	__cplusplus
extern "C" {
#endif

/* 客户端读写超时时间值 */
extern int app_var_client_idle_limit;

/* 用户级的运行函数类型, 当该函数返回值 != 0 时, 框架会自动关闭客户端流 */
typedef int (*APP_RUN_FN)(ACL_VSTREAM *stream, void *run_ctx);

/* 用户级的初始化函数类型 */
typedef void (*APP_INIT_FN)(void*);
typedef void (*APP_EXIT_FN)(void*);

typedef ACL_MASTER_SERVER_THREAD_INIT_FN APP_THREAD_INIT_FN  /* void (*)(void*) */;
typedef ACL_MASTER_SERVER_THREAD_EXIT_FN APP_THREAD_EXIT_FN;  /* void (*)(void*) */

#define	APP_CTL_END			0	/* 参数控制结束标志 */
#define	APP_CTL_INIT_FN			1	/* 初始化函数 */
#define	APP_CTL_INIT_CTX		2	/* 初始化函数所用的参数 */
#define	APP_CTL_CFG_BOOL		3	/* 整数类型的配置参数表 */
#define	APP_CTL_CFG_INT			4	/* 整数类型的配置参数表 */
#define	APP_CTL_CFG_STR			5	/* 字符串类型的配置参数表 */
#define	APP_CTL_EXIT_FN			6	/* 当进程退出时的回调函数 */
#define	APP_CTL_EXIT_CTX		7	/* 进程退出时回调函数的参数 */
#define	APP_CTL_THREAD_INIT		8	/* 每个线程启动时的回调函数 */
#define	APP_CTL_THREAD_INIT_CTX		9	/* 线程启动时回调函数的参数 */
#define	APP_CTL_THREAD_EXIT		10	/* 线程退出时的回调函数 */
#define	APP_CTL_THREAD_EXIT_CTX		11	/* 线程退出时回调函数的参数 */
#define	APP_CTL_DENY_INFO		12	/* 当非法客户端访问时给出的提示信息 */

/*----------------------------------------------------------------------------*/
/* in app_main.c */

/**
 * 主函数入口, 用户级的初始化函数指针及运行函数指针通过控制参数进行注册, 主函数内部
 * 会在初始化时自动调用用户级初始化函数(APP_INIT_FN 类型), 当接收到允许访问的客户端
 * 连接时会自动调用用户(APP_RUN_FN 类型).
 * 级的运行函数.
 * @param argc "int main(int argc, char *argv[])" 中的 argc
 * @param argv "int main(int argc, char *argv[])" 中的 argv
 * @param run_fn 用户级运行主函数
 * @param run_ctx run_fn() 运行时的参数之一
 * @param name 控制参数中的第一个控制类型, 所支持的类型如上定义: APP_CTL_XXX
 *        调用方式: APP_CTL_XXX, xxx; 其中 APP_CTL_END 为特殊的控制参数, 表示控制参数
 *        结束.
 * @example:
 *   app_main(argc, argv, {run_fn}, {run_ctx},
 *		APP_CTL_INIT_FN, {run_init_fn},
 *		APP_CTL_INIT_CTX, {run_init_ctx},
 *		APP_CTL_END);
 * 注: app_main() 的所有参数中, argc, argv, run_fn, run_ctx(可以为NULL), APP_CTL_END
 *     都是必需的.
 */

extern void app_main(int argc, char *argv[], APP_RUN_FN run_fn, void *run_ctx, int name, ...);

/*----------------------------------------------------------------------------*/

#ifdef	__cplusplus
}
#endif

#endif
