Bunki：简单易用的C协程库下载与安装教程

1. 项目介绍

Bunki 是一个简单易用的 C 语言栈式协程库。它的名字来源于日语单词“分岐”，意为“分支”，这个名字非常贴切地描述了协程库的作用。Bunki 目前支持 Sys-V 调用约定的 x86_64 和 Win64 x64_86 调用约定，同时也支持 aarch64 和 arm 架构。它是一个轻量级的库，非常适合需要在 C 程序中实现多任务并行处理的场景。

2. 项目下载位置

项目托管在 GitHub 上，您可以通过以下链接访问项目仓库：Bunki GitHub 仓库

3. 项目安装环境配置

在安装 Bunki 之前，请确保您的环境中已经安装了以下依赖：

• GCC 或 Clang 编译器
• Make 工具

以下是一个典型的环境配置示例：

# 安装 GCC
sudo apt-get install build-essential

# 安装 Make
sudo apt-get install make

环境配置图片示例

4. 项目安装方式

Bunki 提供了一个 Makefile，您可以按照以下步骤进行安装：

1. 克隆项目仓库到本地：

git clone https://github.com/Keith-Cancel/Bunki.git
cd Bunki

2. 使用 Make 命令编译项目：

make

编译完成后，静态库将被构建并复制到 build 目录下的 lib 文件夹中，头文件则位于 include 文件夹。

5. 项目处理脚本

以下是一个简单的处理脚本示例，用于在项目中创建一个协程并执行：

#include "bunki.h"
#include <stdio.h>
#include <stdlib.h>

uintptr_t print_unsigned(void* arg) {
    uintptr_t val = (uintptr_t)arg;
    printf("The value is: 0x%lx\n", val);
    return 0;
}

uintptr_t my_coroutine(void* arg) {
    // Save a value to the thread context storage
    bunki_ctx_data_set((void*)0xcafe);
    // Call a function on the current threads stack
    bunki_ctx_call((void*)0xf00d, print_unsigned);
    bunki_yield(10);
    // print out the value we save before last yield
    bunki_ctx_call((void*)bunki_ctx_data_get(), print_unsigned);
    // print the arg
    bunki_ctx_call(arg, print_unsigned);
    bunki_yield(12);
    return 0;
}

int main() {
    // Initialize the library
    if (bunki_init(256)) {
        fprintf(stderr, "Failed to initialize\n");
        return 1;
    }
    
    void* stack_mem = aligned_alloc(256, 256);
    if (stack_mem == NULL) {
        fprintf(stderr, "Failed to allocate memory\n");
        return 1;
    }
    
    bunki_t ctx = bunki_init_prepare_ctx(stack_mem, my_coroutine, (void*)0xbeef);
    printf("Returned: %u\n", bunki_resume(ctx));
    printf("Returned: %u\n", bunki_resume(ctx));
    free(stack_mem);
    return 0;
}

请将上述代码保存到一个 .c 文件中，并使用 GCC 或 Clang 进行编译。确保链接 Bunki 库：

gcc -o my_program my_program.c -L./build/lib -lbunki

运行您的程序，查看协程的输出结果。

以上就是 Bunki 的下载与安装教程，希望对您有所帮助！