No Description

sunnyxu 2082845ce5 Update README.md 5 months ago
.gitignore 79b37a7e40 update 3 years ago
CMakeLists.txt cc4fbe94da fix undefined reference to dlsym 2 years ago
LICENSE.txt 4b41ba0ce2 libco 3 years ago
Makefile 87d9a05b10 add OS decetion 2 years ago
README.md 2082845ce5 Update README.md 5 months ago
co.mk 4013083c79 port to FreeBSD 2 years ago
co_closure.h ad9263e925 get actual param size when input param is zero 3 years ago
co_epoll.cpp 4013083c79 port to FreeBSD 2 years ago
co_epoll.h 4013083c79 port to FreeBSD 2 years ago
co_hook_sys_call.cpp 6c896ce856 Fix wrong ret of connect when ip_port not exist 7 months ago
co_routine.cpp 03ba1a453c Merge pull request #124 from anonymalias/co_free_leak 8 months ago
co_routine.h 580a446cfc 1. fix co_free memory leak: issue:71 2 years ago
co_routine_inner.h 67c6ec3346 fix typo: ocupy_co -> occupy_co 3 years ago
co_routine_specific.h 79b37a7e40 update 3 years ago
coctx.cpp 58651e99e8 Make stack sp aligned 5 months ago
coctx.h 4b41ba0ce2 libco 3 years ago
coctx_swap.S 18ee765817 Replace coctx_swap with Mov version 7 months ago
example_closure.cpp 79b37a7e40 update 3 years ago
example_cond.cpp 79b37a7e40 update 3 years ago
example_copystack.cpp 6eb80c7146 fix compile on mac; 3 years ago
example_echocli.cpp 4b41ba0ce2 libco 3 years ago
example_echosvr.cpp 012bd1d03f Update example_echosvr.cpp 1 year ago
example_poll.cpp f38e101eec fixed #107 1 year ago
example_setenv.cpp 79b37a7e40 update 3 years ago
example_specific.cpp 79b37a7e40 update 3 years ago
example_thread.cpp 4b41ba0ce2 libco 3 years ago

README.md

Libco

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(sunnyxu@tencent.com), leiffyli(leiffyli@tencent.com), dengoswei@gmail.com(dengoswei@tencent.com), sarlmolchen(sarlmolchen@tencent.com)

PS: 近期将开源PaxosStore,敬请期待。

libco的特性

  • 无需侵入业务逻辑,把多进程、多线程服务改造成协程服务,并发能力得到百倍提升;
  • 支持CGI框架,轻松构建web服务(New);
  • 支持gethostbyname、mysqlclient、ssl等常用第三库(New);
  • 可选的共享栈模式,单机轻松接入千万连接(New);
  • 完善简洁的协程编程接口
    • 类pthread接口设计,通过co_create、co_resume等简单清晰接口即可完成协程的创建与恢复;
    • __thread的协程私有变量、协程间通信的协程信号量co_signal (New);
    • 语言级别的lambda实现,结合协程原地编写并执行后台异步任务 (New);
    • 基于epoll/kqueue实现的小而轻的网络框架,基于时间轮盘实现的高性能定时器;

Build

$ cd /path/to/libco
$ make

or use cmake

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