操作全局信息的相关 API 声明更多...

#include <stdio.h>
#include <time.h>
#include <inttypes.h>

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

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

结构体
struct	Tracker
	描述 tracker 的相关信息更多...

struct	PieceInfo
	分片信息更多...

struct	WaitPeer
	描述处于等待握手状态的 peer 信息更多...

struct	MetaInfo
	描述一次运行的全局信息更多...

宏定义
#define	HASH_SIZE 20
	SHA1 HASH 的字节数

#define	SUB_NA 0

#define	SUB_DOWNLOAD 1

#define	SUB_FINISH 2

#define	WAIT_THRESHOLD 10.0

函数
void	free_metainfo (struct MetaInfo **pmi)
	释放全局信息

void	extract_trackers (struct MetaInfo mi, const struct BNode ast)
	提取 tracker 列表更多...

void	metainfo_load_file (struct MetaInfo mi, const struct BNode ast)
	获取文件名，读取文件，分析已经完成的块

void	extract_pieces (struct MetaInfo mi, const struct BNode ast)
	提取分片 hash 更多...

void	add_peer (struct MetaInfo mi, struct Peer p)
	增加一个 peer 更多...

void	del_peer_by_fd (struct MetaInfo *mi, int fd)
	根据连接套接字删除 peer 更多...

struct Peer *	get_peer_by_fd (struct MetaInfo *mi, int fd)
	根据连接套接字搜索 peer 更多...

struct Peer *	get_peer_by_addr (struct MetaInfo *mi, uint32_t addr, uint16_t port)
	根据网络地址搜索 peer 更多...

int	check_substate (struct MetaInfo *mi, int index)
	检查某一分片的子分片状态并打印更多...

struct Tracker *	get_tracker_by_fd (struct MetaInfo *mi, int sfd)
	根据连接套接字找 tracker 更多...

struct Tracker *	get_tracker_by_timer (struct MetaInfo *mi, int timerfd)
	根据定时器描述符找 tracker 更多...

void	add_wait_peer (struct MetaInfo *mi, int fd, uint32_t addr, uint16_t port)
	添加等待 peer, 网络字节序

int	get_wait_peer_index_by_fd (struct MetaInfo *mi, int fd)
	根据套接字找到 peer 下标更多...

int	find_wait_peer_fd_by_addr (struct MetaInfo *mi, uint32_t addr, uint16_t port)
	根据地址找到 peer 的套接字，网络字节序更多...

void	rm_wait_peer (struct MetaInfo *mi, int index)
	删除等待 peer 更多...

详细描述

操作全局信息的相关 API 声明

宏定义说明

#define SUB_DOWNLOAD 1

子分片下载中

#define SUB_FINISH 2

子分片完成下载

#define SUB_NA 0

子分片没有开始下载

#define WAIT_THRESHOLD 10.0

子分片最长等待时间 10s

函数说明

void add_peer	(	struct MetaInfo *	mi,
		struct Peer *	p
	)

增加一个 peer

参数

mi	全局信息
p	要加入的 peer, 要求是动态分配的.

这是这个函数的调用关系图:

int check_substate	(	struct MetaInfo *	mi,
		int	index
	)

检查某一分片的子分片状态并打印

打印符号说明：

. 已完成
0 正下载
X 未下载

参数

mi	全局信息
index	分片号

返回: 如果全部子分片完成返回 1, 否则返回 0.

这是这个函数的调用关系图:

void del_peer_by_fd	(	struct MetaInfo *	mi,
		int	fd
	)

根据连接套接字删除 peer

参数

mi	全局信息
fd	连接套接字描述符

被删除的指针空闲没有回收, 在未来增加新 peer 时靠 realloc 重新尾部的冗余空间.

这是这个函数的调用关系图:

void extract_pieces	(	struct MetaInfo *	mi,
		const struct BNode *	ast
	)

提取分片 hash

参数

mi	全局信息
ast	B 编码语法树

这是这个函数的调用关系图:

void extract_trackers	(	struct MetaInfo *	mi,
		const struct BNode *	ast
	)

提取 tracker 列表

参数

mi	全局信息
ast	B 编码语法树

观察实际的种子文件, 发现如果有 announce-list, 那么 announce 往往是其中的第一项. 但是 announce-list 本身不是必须的, 所以在没有 announce-list 是解析 announce 否则直接使用 announce-list 忽略 announce.

这是这个函数的调用关系图:

int find_wait_peer_fd_by_addr	(	struct MetaInfo *	mi,
		uint32_t	addr,
		uint16_t	port
	)

根据地址找到 peer 的套接字，网络字节序

返回: 对应的套接字，没找到则 -1.

这是这个函数的调用关系图:

struct Peer* get_peer_by_addr	(	struct MetaInfo *	mi,
		uint32_t	addr,
		uint16_t	port
	)

根据网络地址搜索 peer

参数

mi	全局信息
addr	ip 地址，网络字节序
port	端口号，网络字节序

参数的 addr 和 port 是网络字节序。 peer 自己的 addr 在构造时是网络字节序，但是 port 是本机字节序。

这是这个函数的调用关系图:

struct Peer* get_peer_by_fd	(	struct MetaInfo *	mi,
		int	fd
	)

根据连接套接字搜索 peer

参数

mi	全局信息
fd	连接套接字描述符

返回: 找到时返回对应的 peer 指针, 否则返回 NULL.

适用于 epoll 场景, 此时套接字描述符是最先确定的数据.

这是这个函数的调用关系图:

struct Tracker* get_tracker_by_fd	(	struct MetaInfo *	mi,
		int	sfd
	)

根据连接套接字找 tracker

适用于第一手信息是套接字的场合: epoll

参数

mi	全局信息
sfd	连接套接字

返回: 对应的 tracker 指针，没找到返回 NULL

这是这个函数的调用关系图:

struct Tracker* get_tracker_by_timer	(	struct MetaInfo *	mi,
		int	timerfd
	)

根据定时器描述符找 tracker

定时事件是一个低频事件，所以这个函数在 EPOLLIN 事件里排在最后

参数

mi	全局信息
timerfd	定时器描述符

返回: 对应的 tracker 指针，没找到返回 NULL

这是这个函数的调用关系图:

int get_wait_peer_index_by_fd	(	struct MetaInfo *	mi,
		int	fd
	)

根据套接字找到 peer 下标

返回: 对应的下标，没找到则 -1.

这是这个函数的调用关系图:

void rm_wait_peer	(	struct MetaInfo *	mi,
		int	index
	)

删除等待 peer

如果要删除的元素刚好是最后一个，只需要减少总数量就行了。

这是这个函数的调用关系图:

结构体

宏定义

函数

详细描述

宏定义说明

函数说明