首页 > 代码库 > Accelio 代码笔记

Accelio 代码笔记

  • 项目概述

Accelio是一套支持rdma协议的通讯框架,并且允许扩展包含clientserver,同时支持用户态和内核态。

  • 功能

Simplified API for application developers

High-performance asynchronous APIs

Reliable message delivery (end to end)

Request/Replay or Send/Receive models

Connection and resource abstraction to maximize scalability and availability

Native support for service and storage clustering/scale-out

Maximize multi-threaded application performance allowing dedicated hardware resources per thread

Zero copy data delivery, with optional built-in memory management

Support for multiple transport technologies (RDMA, TCP, Shared-Memory etc.)**

Integration with common event loop mechanisms

Fast event notifications or combined models for lowest message latency

Message combining and batch message processing optimization

User space and kernel implementations

Java bindings**

  • 结构

划分为三层

Application Interface

Easy-to-use primitives for fast and reliable asynchronous message queue or RPC (Remote Procedure Call)

 

Session and Connection Management

Provides reliable end-to-end connectivity to peer endpoints, with dynamic connection establishment, pooling, fault recovery, and migration/redirection

 

Pluggable Transport Layer

Allows mapping to different hardware or software transport implementations

  • 主要数据结构

xio_transport 

协议类型,目前只有rdma,包含协议名和该协议相关的所有操作函数 ,rdma模块中定义了一个xio_rdma_transport全局变量,实现了xio_transport中所有函数,同时还有一个struct xio_rdma_transport结构,该类型是对底层驱动接口的封装,同时包含了上下文,每个conn对象都包含一个单独的,该结构实际应该是和xio_transport_base在同一层次

struct xio_transport {

const char *name;

struct xio_transport_msg_validators_cls validators_cls;

/* transport ctor/dtor called right after registration */

void (*ctor)(void);

void (*dtor)(void);

/* transport initialization */

int (*init)(struct xio_transport *self);

void (*release)(struct xio_transport *self);

/* running thread (context) is going down */

int (*context_shutdown)(struct xio_transport_base *trans_hndl,

    struct xio_context *ctx);

/* observers */

void (*reg_observer)(struct xio_transport_base *trans_hndl,

struct xio_observer *observer);

void (*unreg_observer)(struct xio_transport_base *trans_hndl,

   struct xio_observer *observer);

/* task pools managment */

void (*get_pools_setup_ops)(struct xio_transport_base *trans_hndl,

struct xio_tasks_pool_ops **initial_pool_ops,

struct xio_tasks_pool_ops **primary_pool_ops);

void (*set_pools_cls)(struct xio_transport_base *trans_hndl,

struct xio_tasks_pool_cls *initial_pool_cls,

struct xio_tasks_pool_cls *primary_pool_cls);

/* connection */

struct xio_transport_base *(*open)(struct xio_transport *self,

struct xio_context *ctx,

struct xio_observer *observer);

int (*connect)(struct xio_transport_base *trans_hndl,

   const char *portal_uri,

   const char *out_if);

int (*listen)(struct xio_transport_base *trans_hndl,

  const char *portal_uri, uint16_t *src_port,

  int backlog);

int (*accept)(struct xio_transport_base *trans_hndl);

int (*poll)(struct xio_transport_base *trans_hndl,

long min_nr, long nr,

struct timespec *timeout);

int (*reject)(struct xio_transport_base *trans_hndl);

void (*close)(struct xio_transport_base *trans_hndl);

int (*send)(struct xio_transport_base *trans_hndl,

struct xio_task *task);

int (*set_opt)(void *xio_obj,

   int optname, const void *optval, int optlen);

int (*get_opt)(void *xio_obj,

   int optname, void *optval, int *optlen);

int (*cancel_req)(struct xio_transport_base *trans_hndl,

      struct xio_msg *req, uint64_t stag,

      void *ulp_msg, size_t ulp_msg_len);

int (*cancel_rsp)(struct xio_transport_base *trans_hndl,

      struct xio_task *task, enum xio_status result,

      void *ulp_msg, size_t ulp_msg_len);

struct list_head transports_list_entry;

};

xio_transport_base  

底层通信的上下文,每个conn对应一个

struct xio_transport_base {

struct xio_context *ctx;

struct xio_observable observable;

uint32_t is_client;  /* client or server */

atomic_t refcnt;

char *portal_uri;

struct sockaddr_storage peer_addr;

enum   xio_proto proto;

int pad;

};

xio_conn 

transport_base的简单封装,管理task缓存,处理框架内部定义的一些消息,握手消息之类

struct xio_conn {

struct xio_transport *transport;

struct xio_transport_base *transport_hndl;

struct xio_tasks_pool *primary_tasks_pool;

struct xio_tasks_pool_ops *primary_pool_ops;

struct xio_tasks_pool *initial_tasks_pool;

struct xio_tasks_pool_ops *initial_pool_ops;

struct xio_observer *server_observer;

struct xio_observer trans_observer;

struct xio_observer ctx_observer;

struct xio_observable observable;

struct kref kref;

int cid;

enum xio_conn_state state;

int is_first_req;

int is_listener;

int pad;

xio_ctx_timer_handle_t close_time_hndl;

struct list_head observers_htbl;

HT_ENTRY(xio_conn, xio_key_int32) conns_htbl;

};

xio_connection 

xio_conn的封装,管理msg缓存,对外提供访问接口

struct xio_connection {

struct xio_conn *conn;

struct xio_session *session;

struct xio_context *ctx; /* connection context */

struct xio_session_ops ses_ops;

/* server‘s session may have multiple connections each has

 * private data assignd by bind

 */

void *cb_user_context;

int conn_idx;

int state;

int32_t send_req_toggle; // 选择发送请求还是回应

int pad;

struct kref kref;

struct kref fin_kref;

struct xio_msg_list reqs_msgq; // 待发送的请求队列

struct xio_msg_list rsps_msgq; //  待发送的回应队列

struct xio_msg_list in_flight_reqs_msgq; // 已经发送的请求队列

struct xio_msg_list in_flight_rsps_msgq; // 已经发送的回应队列

struct xio_msg_list one_way_msg_pool;

struct xio_msg *msg_array;

struct list_head io_tasks_list;

struct list_head post_io_tasks_list;

struct list_head pre_send_list;

struct list_head connections_list_entry;

struct list_head ctx_list_entry;

};

xio_session 

网络session,一个addr对应一个session,每个session管理多个xio_connection,但是每个session中的多个connection不能由同一个context管理,多线程的使用模式是,由一个主线程创建session,每个工作线程创建context,并建立连接(Client端)

struct xio_session {

uint64_t trans_sn; /* transaction sn */

uint32_t session_id;

uint32_t peer_session_id;

uint32_t session_flags;

uint32_t connections_nr;

struct list_head sessions_list_entry;

struct list_head connections_list;

HT_ENTRY(xio_session, xio_key_int32) sessions_htbl;

struct xio_session_ops ses_ops;

struct xio_transport_msg_validators_cls *validators_cls;

struct xio_msg *setup_req;

struct xio_observer observer;

enum xio_session_type type;

volatile enum xio_session_state state;

struct xio_new_session_rsp new_ses_rsp;

char *uri;

char **portals_array;

char **services_array;

void *user_context;

void *cb_user_context;

uint16_t user_context_len;

uint16_t uri_len;

uint16_t portals_array_len;

uint16_t services_array_len;

uint16_t last_opened_portal;

uint16_t last_opened_service;

uint16_t in_notify;

uint16_t pad[3];

uint32_t reject_reason;

struct mutex                    lock;    /* lock open connection */

spinlock_t                      connections_list_lock;

int disable_teardown;

struct xio_connection *lead_connection;

struct xio_connection *redir_connection;

};

xio_server 

服务端,xio_bind调用时返回,处理session未建立前的一些事件

struct xio_server {

struct xio_conn *listener;

struct xio_observer observer;

char *uri;

struct xio_context *ctx;

struct xio_session_ops ops;

uint32_t session_flags;

uint32_t pad;

void *cb_private_data;

};

xio_context

主线程循环的上下文,

struct xio_context {

void *ev_loop;

int cpuid;

int nodeid;

int polling_timeout;

unsigned int flags;

uint64_t worker;

struct xio_statistics stats;

struct xio_context_params params;

struct xio_schedwork *sched_work;

struct list_head ctx_list;  /* per context storage */ 用来记录该ctx上的xio_connection

 

/* list of sessions using this connection */

struct xio_observable observable;

void *netlink_sock;

};

xio_msg

用户需要发送的内容

struct xio_msg {

struct xio_vmsg in;

struct xio_vmsg out;

union {

uint64_t sn; /* unique message serial number

 * returned by the library

 */

struct xio_msg *request;  /* on server side - attached

    * request

    */

};

enum xio_msg_type type;

int         more_in_batch; /* more messages are expected */

int status;

int flags;

enum xio_receipt_result receipt_res;

uint64_t timestamp; /**< submission timestamp     */

int reserved;

void *user_context; /* for user usage - not sent */

struct xio_msg_pdata pdata; /**< accelio private data     */

struct xio_msg *next;          /* internal use */

};

xio_task

打包msg,加入消息头

struct xio_task {

struct list_head tasks_list_entry;

void *dd_data; // 传输协议扩展,记录协议内所用到的数据,例如rdma_task

struct xio_mbuf mbuf; // 由各协议自己初始化,使用pool_init_item

struct xio_task *sender_task;  /* client only on receiver */

struct xio_msg *omsg; /* pointer from user */

struct xio_session *session;

struct xio_conn *conn;

struct xio_connection *connection;

 

void *pool;

release_task_fn release;

 

enum xio_task_state state; /* task state enum */

struct kref kref;

uint64_t magic;

uint64_t stag; /* session unique tag */

uint32_t is_control;

uint32_t tlv_type;

uint32_t ltid; /* local task id */

uint32_t rtid; /* remote task id */

uint32_t omsg_flags;

uint32_t pad;

struct xio_msg imsg; /* message to the user */

 

};

Xio_rdma_task

struct xio_rdma_task {

struct xio_rdma_transport *rdma_hndl;

enum xio_ib_op_code ib_op;

u16 more_in_batch;

u16 sn;

u16 phantom_idx;

u16 pad[3];

 

//struct xio_data_buffer sdb;

/* The buffer mapped with the 3 xio_work_req

 * used to transfer the headers

 */

void *buf;

unsigned long size;

struct xio_work_req txd;

struct xio_work_req rxd;

struct xio_work_req rdmad;

 

/* User (from vmsg) or pool buffer used for */

u32 read_num_sge;

u32 write_num_sge;

u32 recv_num_sge;

struct xio_rdma_mem_desc read_sge;

struct xio_rdma_mem_desc write_sge;

 

/* What this side got from the peer for RDMA R/W

 * Currently limitd to 1

 */

u32 req_write_num_sge;

u32 req_read_num_sge;

u32 req_recv_num_sge;

struct xio_sge req_read_sge[XIO_MAX_IOV]; 

struct xio_sge req_write_sge[XIO_MAX_IOV];

/* What this side got from the peer for SEND

 */

struct xio_sge req_recv_sge[XIO_MAX_IOV];

};

 

Req_*_sge说明,用来记录对端或者自己这边的使用的存放数据的地址

如果是要发送写请求,这种场景发生在回应response时,在收到req时,就将rdma_task中的req_read_sge设置为对端的存放数据的内存地址,那么req_write_sge就为本地存放用户写入数据的内存地址。

如果为读请求,之前对端发送过来的req中必然携带了对方存放数据的内存地址,req_write_sge,本地的用来存放读取过来数据的地址为req_read_sge。这时候对端发送过来的req_read_sge是没用的,会在解析头部的时候重置为NULL

 

Read_sgewrite_seq是用来存放数据的内存控制描述符。真正的内存buf控制结构。Req_*_sge只是记录了内存地址。

xio_tasks_pool

struct xio_tasks_pool {

/* pool of tasks */

struct xio_task **array;

/* LIFO */

struct list_head stack;

 

/* max number of elements */

int max;

int nr;

void *dd_data; // 底层协议扩展,例如在rdma协议时,指向rdma_task_pool

void *pool_ops; // 底层协议扩展,注册创建(初始化),回收底层pool,以及初始化pool中每个成员等函数

};

xio_observer

事件观察者,

struct xio_observer {

void *impl;

notify_fn_t notify;

};

xio_observable

被观察者

struct xio_observable {

void *impl;

struct list_head observers_list;

struct xio_observer_node *observer_node; /* for one observer */

};

xio_work_req

struct xio_work_req {

union {

struct ib_send_wr send_wr;

struct ib_recv_wr recv_wr;

};

struct ib_sge sge[XIO_MAX_IOV + 1];

struct scatterlist sgl[XIO_MAX_IOV + 1];

int nents; /* number of sgl entries */

int mapped; /* number of mapped entries */

};

底层ib通讯时使用的参数的封装,ib_sge用来设置send_wr或者recv_wrsge通过ib接口映射过的地址,sgl原始地址

rxd->recv_wr.sg_list = rxd->sge;

sg_set_page(rxd->sgl, virt_to_page(buf), size, offset_in_page(buf));

xd->sge[i].addr   = ib_sg_dma_address(ib_dev, &xd->sgl[i]);

 

xio_map_work_req

 

  • 机制

事件处理

Xio框架负责处理主线程的调度,在调用xio_context_create时,初始化主处理线程,并设置添加事件的回调接口add_event,线程启动接口run,以及停止接口stop

struct xio_loop_ops {

void *ev_loop;

int (*run)(void *loop);

void (*stop)(void *loop);

int (*add_event)(void *loop, struct xio_ev_data *data);

};

 

struct xio_context *xio_context_create(unsigned int flags,

       struct xio_loop_ops *loop_ops,

       struct task_struct *worker,

       int polling_timeout,

       int cpu_hint);

 

底层协议层,如果有网络事件产生,通过add_event接口把要处理的事件和处理函数加入到主处理线程(也可以通过定时器加入事件),add_event会将事件加入队列中,并唤醒正在等待的主线程,主线程逐一调用事件处理函数

 

Rdma在初始化cq时,xio_cq_init会设置回调函数xio_cq_data_callback,当rdma事件产生时把事件处理函数xio_data_handler通过add_event加入主处理线程,xio_data_handler会依次检查每个连接

void xio_data_handler(void *user_context)

{

struct xio_cq *tcq = (struct xio_cq *) user_context;

struct xio_rdma_transport *rdma_hndl;

xio_cq_event_handler(tcq, tcq->ctx->polling_timeout);

list_for_each_entry(rdma_hndl, &tcq->trans_list, trans_list_entry) {

xio_rdma_idle_handler(rdma_hndl);

}

return;

}

观察者

当被观察者上发生事件时,会通知观察者,观察者如果对某一对象上面的一些事件感兴趣,需要注册自己到该对象上的观察者列表中。例如:

xio_context_reg_observer:观察者注册自己到ctx中,观察者会收到ctx事件的通知

xio_conn_reg_observer:xio_connection_set_conn函数会在执行时把session注册到conn中,而client端,会在调用xio_conn_open时把session注册到conn中(server端同样会调用这个函数,但是传递的observer是空)

tcqtransprot也会关注context的事件

client端,在执行xio_conn_open时,把conn注册到transport

server端,会在执行xio_conn_create,时注册conntransport

并发和多线程

一个session只能有一个URI,每个session管理多个xio_connection,但是每个session中的多个connection不能由同一个context管理,多线程的使用模式是,由一个主线程创建session,每个工作线程创建context,并建立连接(Client端),同一个ctx中,URI相同的不同session可以在同一个工作线程中,此时这些sessionxio_connection公用同一个xio_conn,每个context中,一个地址只能对应一个xio_conn,同一个session中,每个xio_connection对应一个xio_conn

 

 

Xio_on_setup_rsp_recv里面的两个分支代表两个场景,portals_array为空,但是session->connections_nr > 1的场景是:多个线程同时对一个session建立连接,这时候已经产生了多个xio_connection,但是只生成了一个xio_conn去发送建立session的信息,其他的xio_connectionsession建立之后再进行连接,另外一个场景,portals_array不为空,对端有多个网络线程工作线程,一个监听线程,但session建立之后,对端又指定了多个地址,这个时候就需要重新创建xio_connection,并建立连接。

 

内存管理

Accelio使用两类buf,一种用于消息头部或者小数据量,每个大小为4-8k,另外一类用于rdma的大数据io,第二类buf,可以由库或者程序自己申请。

 

l 程序管理的buf

需要提前通过reg_mr接口注册

l 库管理的buf

要使用程序自己申请的内存,需要传入mr信息,如果没传入,那么会把传入的内存拷贝到库维护的缓存中,多一次内存拷贝。

 

消息合并和批处理

消息的批量发送,可以发送消息时,遍历待发送队列,把send_wrnext指针连接起来,使用ibv_post_send接口批量发送消息,ibv_poll_cq接口,批量获取收到的请求

 

Has_more标记,在几个地方会使用,在底层有事件发生时,如果has_more标记为0,那么表示当前网络空闲,可以把待发送的消息发送给对方,还有就是在rdma_send_reqrdma_send_rsp中,作用都是相同的。

 

On_msg接口中,会带有has_more_batch参数,来标记是否还有其他消息需要处理,应用程序可以根据这个参数来做一些合并工作。

 

访问接口

几个重要标记

l XIO_IB_RDMA_READ的使用场景,当请求方的数据大小,超过了设置的缓存大小时,请求方发送IBV_WR_SEND请求,并设置ib_op类型为XIO_IB_RDMA_READ。接收方在收到该请求后,发送IBV_WR_RDMA_READ请求给发送方,并设置ib_opXIO_IB_RDMA_READ,直接读取远处内存中的数据,不在处理recv消息。

 

l XIO_IB_RDMA_WRITE的使用场景,当接收方处理完成发送回应时,如果需要回应的数据大小超过了设置的缓存大小时,接收方发送IB_WR_RDMA_WRITE请求,并设置ib_op类型为XIO_IB_RDMA_WRITE

 

l XIO_IB_RECV的使用场景,接收方用来接收请求的task都设置该标记,有一种使用场景检查了这个标记,当接收方收到了一个XIO_IB_RDMA_READ请求之后,发送请求去发送方读取数据,这时会重新生成一个tmp_task,它的ib_opXIO_IB_RDMA_READ,与原始的task请求时不同的,这时候需要把接收方收到的原始task加入rdma_rd_list中,等待读取数据完成。接收方在发送task请求时,根据这个标记位来进去判断哪些读请求时要发送给发送方的。哪些只是等待读取完成。

 

l XIO_IB_SEND的使用场景,发送方的task都设置该标记

 

另外需要说明的是,为了保证消息的到达顺序,接收方在等待接收消息时,也就是rdma_rd_list非空时,是不处理收到的POST消息的,否则就可能出现后POST的消息,先处理,而之前的消息,还在读取过程中。

 

回调函数

l on_msg_send_complete

该函数由请求的接收方调用,当发送回应完成时调用该回调函数,这里说的发送完成是指ib层认为数据发送完毕,不涵盖其他逻辑。

l on_msg_delivered

该函数由请求的发送方调用,当发送方收到了接收方的回应时,调用该函数,接收方在收到请求时,会调用xio_connection_send_read_receipt,发送回应,one_way_msg必须设置该标记,request可选择是否设置,通过检查task状态是否为XIO_TASK_STATE_DELIVERED确保只发送一次确认消息

xio_on_req_recv-- connection->ses_ops.on_msg-- xio_connection_send_read_receipt

接收方处理完成之后发送receipt

l on_msg

在收到消息时

Request/reply

 

发送方

l xio_send_request

 

检查session状态

检查参数合法性

统计数据

获取序列号xio_session_get_sn

把消息加入待发送队列中,xio_msg_list_insert_tail

连接在线,则执行xio_connection_xmit

l xio_connection_xmit

根据标记选择要发送的队列

遍历队列,逐一发送每个msg  xio_connection_send

发送失败,重试或者返回错误

发送成功,把消息加入已发送队列中

l xio_connection_send

a) 发送的是response,并且消息的标记仅设置XIO_MSG_RSP_FLAG_FIRST转下一步,否则转d

b) 从primary_task_pool中申请一个xio_task

c) 从该response对应的请求msg中获取请求task,并设置xio_tasksender_task成员,转f

d) 发送的是request,转下一步,否则转h

e) 从primary_task_pool中申请一个xio_task

f) 设置序列号

g) 把新申请的xio_task加入pre_send_list中,转i

h) 把原始task加入pre_send_list

i) 修改消息头,设置序列号,task类型

j) 重置taskmbufxio_rdma_initial_pool_init_task生成task的时候从kmem_cache中分配一段内存,后面用该内存初始化mbuf

k) 把头部写入mbuf

l) xio_conn_send

m) xio_rdma_send

l xio_rdma_send_req

如果已经发送的请求数超过了最大限制,返回EAGIN的错误

准备接受回应的缓冲区,xio_rdma_prep_req_in_data

准备发送请求的缓存冲,之前的缓冲区只填充了消息头,没有写入msg内容,xio_rdma_prep_req_out_data

修改buf长度xio_mbuf_tlv_payload_len

最好要完整填充txd->send_wr

最后把task加入底层传输的待发送队列中rdma_hndl->tx_ready_list

判断待发送列大小,超过的警戒值,则批量发送xio_rdma_xmit

 

l xio_rdma_prep_req_out_data

a) 判断要发送的数据量是否超过了发送缓存的大小,没有超过转下一步,超过转d

b) xio_rdma_prep_req_header 写入头部到mbuf中,用户写入的数据非空转下一步,否则转h

c) xio_rdma_write_send_data,用传入的buf地址设置sge[1]起始的数组,或者没有mr则把用户数据拷贝到mbuf中,转g

d) 超过缓存大小,rdma_task->ib_op = XIO_IB_RDMA_READ;由对方来主动读取数据

e) 检查用户是否设置mr,设置转下一步,没有设置转g

f) 逐一设置addrrdma_task->write_sge[i].addr = vmsg->data_iov[i].iov_base;转h

g) 用户没有设置mr,需要逐一为write_sge分配内存,并拷贝数据

h) 返回

 

 

之前在初始化txd时,通过sg_set_page(rxd->sgl, virt_to_page(buf), size, offset_in_page(buf)),把bufsgl做过映射,后面再执行xio_rdma_xmit时,会用sgl数组元素的addr来设置sge数组元素的addr,如果用户写入的数据直接设置了sge,那么sgl数组应该只有元素0存放消息头部

 

 

l xio_rdma_xmit

 

 

 

接收方

 

l xio_handle_wc

 

xio_rdma_rx_handler

 

xio_rdma_on_recv_req

 

xio_rdma_notify_observer(xio_rdma_datapath.c

 

xio_on_new_message(xio_conn.c

 

xio_conn_on_recv_req(xio_conn.c

 

xio_observable_notify_any_observer

 

 

 

 

 

 

 

 

 

参数说明

 

Req.in.header或者req.in.iov[i].iov_base如果设置为NULL,那么当收到消息时,iov_base会设置为task->mbuf的地址,参看函数xio_rdma_on_recv_req

Send/recv

流程和上面的类似,除了没有response,接收方收到消息后,会触发一个回调,可选的确认通知

连接管理

状态变迁

Session状态变迁

XIO_SESSION_STATE_INIT 初始创建

XIO_SESSION_STATE_CONNECT 尝试建立连接(调用xio_connect接口之后,立即设置)

XIO_SESSION_STATE_ONLINE (该session上的所有connection都已经建立连接)

XIO_SESSION_STATE_ACCEPTED (该session上的部分connection已经建立连接)

 

处于INIT状态时,client调用xio_connect,会创建xio_connection,同时也会创建xio_conn

Xio_connect调用之后,状态变为CONNECT,此时有另外的线程再调用xio_connect,只会创建xio_connection,不会创建xio_conn

 

enum xio_transport_state {

XIO_STATE_INIT,

XIO_STATE_CONNECTED,

XIO_STATE_DISCONNECTED,

XIO_STATE_CLOSED,

XIO_STATE_DESTROYED,

};

 

连接建立

 

 

 

l Xio_conn建立

Client端:

1.xio_on_connection_established -- xio_conn_initial_pool_setup

xio_conn_send_setup_req

2.xio_conn_on_recv_setup_rsp -- xio_conn_primary_pool_setup

3.xio_on_client_conn_established

如果SESSION状态不为ACCEPTEDONLINE转到下面的session建立,否则转xio_connection建立

Server端:

1xio_on_new_connection—xio_conn_create(listener创建新连接)-- xio_conn_initial_pool_setup

  xio_on_new_conn--xio_conn_accept(accept新创建的连接)

 

2.xio_conn_on_recv_setup_req-- xio_conn_primary_pool_setup

  xio_conn_write_setup_rsp

3.xio_conn_on_send_setup_rsp_comp

4.xio_on_server_conn_established

转到下面的session建立

l Xio_connection建立

Client端:

xio_connection_send_hello_req

Server端:

xio_on_new_message

xio_session_alloc_connection

xio_session_assign_conn(xio_conn.c

xio_on_connection_hello_req_recv(xio_session

xio_connection_send_hello_rsp(xio_session.c

xio_session_notify_new_connection(xio_session.c

l Xio_session建立:

Client端:

xio_session_write_setup_req

xio_conn_on_recv_rsp(xio_conn.c

xio_on_setup_rsp_recv(xio_session.c

session->state = XIO_SESSION_STATE_ACCEPTED;或者XIO_SESSION_STATE_ONLINE

Server端:

xio_conn_on_recv_req(xio_conn.c

xio_on_new_message(xio_server.c

xio_session_init(xio_server.c

xio_session_alloc_connection(xio_server.c

xio_session_assign_conn(xio_server.c

xio_on_setup_req_recv(xio_session_server.c

on_new_session或者(xio_accept)(xio_session_server.c

xio_session_write_accept_rsp(XIO_SESSION_SETUP_RSP)

xio_on_setup_rsp_send_comp

xio_session_notify_new_connection(xio_session.c

疑问:

xio_conn_connect 中为什么要判断XIO_CONN_STATE_CONNECTED这个状态

 

同一个ctx中,不同sessionxio_connection公用同一个xio_conn,每个ctx中,一个地址只能对应一个xio_conn

连接销毁

l 检测掉线

a) Transport层有事件产生,通知观察者

b) xio_on_connection_disconnected(xio_conn.c

c) 如果xio_conn没有注册任何观察者,转i,否则转c

d) xio_on_conn_event_client(xio_on_conn_event_server)(xio_session_client.c

e) xio_on_conn_disconnected(xio_session.c

f) 还存在xio_connectionxio_conn关联,xio_session_notify_connection_disconnected,状态发生变换,通知session做相应处理,不存和xio_connection关联的xio_connf

g) xio_session_disconnect-- xio_session_notify_connection_teardown-- session->ses_ops.on_session_event --xio_connection_destroy,执行xio_conn_close,转hxio_connection_close,并判断是否需要销毁sessionxio_session_notify_teardown-- xio_session_destroy-- xio_session_post_teardown

h) 没有xio_connectionxio_conn关联(listener的情况),直接调用xio_conn_close关闭连接,计算引用数,不为1时转o

i) xio_conn_release

j) transport->close

k) xio_rdma_close

l) xio_rdma_notify_observer

m) xio_on_conn_closed

n) kfree(conn)

o) Session是客户端,针对session中的其他xio_connection逐一调用xio_session_notify_connection_disconnected

l 主动关闭一

a) xio_disconnect-- xio_send_fin_req 

xio_session_notify_connection_closed

b) xio_on_fin_rsp_recv-- xio_connection_fin_put-- xio_fin_complete-- xio_session_disconnect-- xio_session_notify_connection_teardown,其他部分同上

l 主动关闭二

c) xio_connection_destroy-- xio_connection_flush_tasks

xio_conn_close

xio_connection_close

l 销毁session

a) 释放资源,

说明,只释放资源,因此需要等连接都已经关闭之后才能调用,

 

 

 

Rdma_hndl的释放,主动关闭时,调用xio_conn_close最终会调用xio_rdma_close,这个函数会根据当前conn的状态进行处理,如果是connected状态则调用disconnect函数,其他情况,这里还有init状态和disconnected状态,则通过notify调用xio_on_conn_closed释放资源最后修改状态为destroy状态,,

 

当断线时,disconnected处理函数最终会调用xio_conn_release来释放conn,会调用到函数xio_rdma_close,这时候就不需要再调用disconnect函数,直接释放资源,

  • 资料

首页:http://www.accelio.org/

代码:https://github.com/accelio/

Accelio技术白皮书

 

声明:本文所用图片和部分内容来自accelio官网和白皮书。转载本博文章须在文章明显处注明作者及附上原文链接,便于读者找到原文的更新版。

Accelio 代码笔记