mirror of
https://gitee.com/acl-dev/acl.git
synced 2024-12-02 11:57:43 +08:00
84 lines
2.2 KiB
C
84 lines
2.2 KiB
C
#ifndef ACL_RES_INCLUDE_H
|
|
#define ACL_RES_INCLUDE_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include "../stdlib/acl_define.h"
|
|
#include "acl_netdb.h"
|
|
#include <time.h>
|
|
|
|
/**
|
|
* DNS返回结果的存储结构
|
|
*/
|
|
typedef struct ACL_RES {
|
|
char dns_ip[64]; /**< DNS的IP地址 */
|
|
unsigned short dns_port; /**< DNS的Port */
|
|
unsigned short cur_qid; /**< 内部变量，数据包的标识 */
|
|
time_t tm_spent; /**< 查询时间耗费(秒) */
|
|
int errnum;
|
|
#define ACL_RES_ERR_SEND -100 /**< 写出错 */
|
|
#define ACL_RES_ERR_READ -101 /**< 读出错 */
|
|
#define ACL_RES_ERR_RTMO -102 /**< 读超时 */
|
|
#define ACL_RES_ERR_NULL -103 /**< 空结果 */
|
|
#define ACL_RES_ERR_CONN -104 /**< TCP方式时连接失败 */
|
|
|
|
int transfer; /**< TCP/UDP 传输模式 */
|
|
#define ACL_RES_USE_UDP 0 /**< UDP 传输模式 */
|
|
#define ACL_RES_USE_TCP 1 /**< TCP 传输模式 */
|
|
|
|
int conn_timeout; /**< TCP 传输时的连接超时时间, 默认为10秒 */
|
|
int rw_timeout; /**< TCP/UDP 传输的IO超时时间, 默认为10秒 */
|
|
} ACL_RES;
|
|
|
|
/**
|
|
* 创建一个DNS查询对象
|
|
* @param dns_ip {const char*} DNS的IP地址
|
|
* @param dns_port {unsigned short} DNS的Port
|
|
* @return {ACL_RES*} 新创建的查询对象
|
|
*/
|
|
ACL_API ACL_RES *acl_res_new(const char *dns_ip, unsigned short dns_port);
|
|
|
|
/**
|
|
* 设置DNS查询的超时时间
|
|
* @param conn_timeout {int} TCP 传输时的连接超时时间
|
|
* @param rw_timeout {int} TCP/UDP 传输的IO超时时间
|
|
*/
|
|
ACL_API void acl_res_set_timeout(int conn_timeout, int rw_timeout);
|
|
|
|
/**
|
|
* 释放一个DNS查询对象
|
|
* @param res {ACL_RES*} DNS查询对象
|
|
*/
|
|
ACL_API void acl_res_free(ACL_RES *res);
|
|
|
|
/**
|
|
* 查询某个域名的IP地址
|
|
* @param res {ACL_RES*} DNS查询对象
|
|
* @param domain {const char*} 要查询的域名
|
|
* @return {ACL_DNS_DB*} 查询的结果集
|
|
*/
|
|
ACL_API ACL_DNS_DB *acl_res_lookup(ACL_RES *res, const char *domain);
|
|
|
|
/**
|
|
* 根据错误号获得查询失败的原因
|
|
* @param errnum {int} 错误号
|
|
* @return {const char*} 错误信息
|
|
*/
|
|
ACL_API const char *acl_res_strerror(int errnum);
|
|
|
|
/**
|
|
* 获得当前查询的错误信息
|
|
* @param res {ACL_RES*} DNS查询对象
|
|
* @return {const char*} 错误信息
|
|
*/
|
|
ACL_API const char *acl_res_errmsg(const ACL_RES *res);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|
|
|