acl_res.h 文件参考

#include "../stdlib/acl_define.h"
#include "acl_netdb.h"
#include <time.h>

acl_res.h 的引用(Include)关系图:

此图展示该文件直接或间接的被哪些文件引用了:

浏览源代码.

类
struct	ACL_RES

宏定义
#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
#define	ACL_RES_USE_UDP   0
#define	ACL_RES_USE_TCP   1

类型定义
typedef struct ACL_RES	ACL_RES

函数
ACL_API ACL_RES *	acl_res_new (const char *dns_ip, unsigned short dns_port)
ACL_API void	acl_res_set_timeout (int conn_timeout, int rw_timeout)
ACL_API void	acl_res_free (ACL_RES *res)
ACL_API ACL_DNS_DB *	acl_res_lookup (ACL_RES *res, const char *domain)
ACL_API const char *	acl_res_strerror (int errnum)
ACL_API const char *	acl_res_errmsg (const ACL_RES *res)

宏定义说明

ACL_RES_ERR_CONN

#define ACL_RES_ERR_CONN   -104

TCP方式时连接失败

在文件 acl_res.h 第 30 行定义.

ACL_RES_ERR_NULL

#define ACL_RES_ERR_NULL   -103

空结果

在文件 acl_res.h 第 29 行定义.

ACL_RES_ERR_READ

#define ACL_RES_ERR_READ   -101

读出错

在文件 acl_res.h 第 27 行定义.

ACL_RES_ERR_RTMO

#define ACL_RES_ERR_RTMO   -102

读超时

在文件 acl_res.h 第 28 行定义.

ACL_RES_ERR_SEND

#define ACL_RES_ERR_SEND   -100

写出错

在文件 acl_res.h 第 26 行定义.

ACL_RES_USE_TCP

#define ACL_RES_USE_TCP   1

TCP 传输模式

在文件 acl_res.h 第 34 行定义.

ACL_RES_USE_UDP

#define ACL_RES_USE_UDP   0

UDP 传输模式

在文件 acl_res.h 第 33 行定义.

类型定义说明

ACL_RES

typedef struct ACL_RES ACL_RES

DNS返回结果的存储结构

函数说明

acl_res_errmsg()

ACL_API const char* acl_res_errmsg

(

const ACL_RES *

res

)

获得当前查询的错误信息

参数

res	{ACL_RES*} DNS查询对象

返回

{const char*} 错误信息

acl_res_free()

ACL_API void acl_res_free

(

ACL_RES *

res

)

释放一个DNS查询对象

参数

res	{ACL_RES*} DNS查询对象

acl_res_lookup()

ACL_API ACL_DNS_DB* acl_res_lookup	(	ACL_RES *	res,
		const char *	domain
	)

查询某个域名的IP地址

参数

res	{ACL_RES*} DNS查询对象
domain	{const char*} 要查询的域名

返回

{ACL_DNS_DB*} 查询的结果集

acl_res_new()

ACL_API ACL_RES* acl_res_new	(	const char *	dns_ip,
		unsigned short	dns_port
	)

创建一个DNS查询对象

参数

dns_ip	{const char*} DNS的IP地址
dns_port	{unsigned short} DNS的Port

返回

{ACL_RES*} 新创建的查询对象

acl_res_set_timeout()

ACL_API void acl_res_set_timeout	(	int	conn_timeout,
		int	rw_timeout
	)

设置DNS查询的超时时间

参数

conn_timeout	{int} TCP 传输时的连接超时时间
rw_timeout	{int} TCP/UDP 传输的IO超时时间

acl_res_strerror()

ACL_API const char* acl_res_strerror

(

int

errnum

)

根据错误号获得查询失败的原因

参数

errnum

{int} 错误号

返回

{const char*} 错误信息