Libco is a c/c++ coroutine library that is widely used in WeChat services. It has been running on tens of thousands of machines since 2013.

By linking with libco, you can easily transform synchronous back-end service into coroutine service. The coroutine service will provide out-standing concurrency compare to multi-thread approach. With the system hook, You can easily coding in synchronous way but asynchronous executed.

You can also use co_create/co_resume/co_yield interfaces to create asynchronous back-end service. These interface will give you more control of coroutines.

By libco copy-stack mode, you can easily build a back-end service support tens of millions of tcp connection.

libco是微信后台大规模使用的c/c++协程库，2013年至今稳定运行在微信后台的数万台机器上。

libco通过仅有的几个函数接口 co_create/co_resume/co_yield 再配合 co_poll，可以支持同步或者异步的写法，如线程库一样轻松。同时库里面提供了socket族函数的hook，使得后台逻辑服务几乎不用修改逻辑代码就可以完成异步化改造。

作者: sunnyxu([email protected]), leiffyli([email protected]), [email protected]([email protected]), sarlmolchen([email protected])

use cmake

$ cd /path/to/libco
$ mkdir build
$ cd build
$ cmake ..
$ make

原始实现存在一些潜在问题，对此进行了如下修复：

• 不hook系统调用（hook系统调用基本不能适配任何第三方库，并发安全存在严重问题）
• 去除对共享栈的支持，优化相关逻辑（共享栈会造成性能下降，并引入各种潜在的内存安全问题）
• 协程退出自动释放内存
• 增加异步调用函数 co_async_call
• 添加 gdb 脚本，可以用来调试协程信息（需要使用-g -O0编译）
• 使用 state_thread 中协程实现，支持更多平台