libconcurrent - GitLite

KO | EN

gitlite — search

#javascript #typescript #golang #android #machine-learning #rust #linux #macos #nodejs #cli #kubernetes #awesome-list #mcp #ios

libconcurrent

(★ 366)

:copyright: Concurrent Programming Library (Coroutine) for C11

파일 탐색기

최종 버전 다운로드 (.zip)

- accumulator.c
- concurrent_sort1.c
- coroutine1.c
- coroutine2.c
- float1.c
- float2.c
- makefile
- many_context1.c
- strsplit.c
- time_slice1.c
- - concurrent.h
  - shortname.h
- concurrent.c
- concurrent_arch.h
- makefile
- stack_torture1.c
.gitignore
depend.inc
LICENSE
makefile
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/sharow/libconcurrent

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd libconcurrent

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Make

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

libconcurrent
=============
[![zlib License](http://img.shields.io/badge/license-zlib-orange.svg?style=flat-square)](https://github.com/sharow/libconcurrent/blob/master/LICENSE)

tiny asymmetric-coroutine library.

## Description
+ asymmetric-coroutine
+ bidirectional communication by `yield_value`/`resume_value`
+ native context switch
+ C11

## Supported Platforms
|              | x86_64              | i686                     | ARM(v6/v7)               | AArch64            | (contributor)    |
|--------------|---------------------|--------------------------|--------------------------|--------------------|------------------|
| Linux        | :heavy_check_mark:  | :heavy_check_mark:       | :heavy_check_mark:       | :heavy_check_mark: |                  |
| FreeBSD      | :heavy_check_mark:  | :heavy_check_mark:       | :question:               | :question:         |[@t6](https://github.com/t6)|
| OSX          | :heavy_check_mark:  | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_check_mark: |[@kpamnany](https://github.com/kpamnany) |
| (contributor)|                     |                          |                          |[@mitghi](https://github.com/mitghi)| |

## Code Example

```c
#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <stdnoreturn.h>

#include <concurrent/concurrent.h>
#include <concurrent/shortname.h>

#define STACK_SIZE (1024 * 2)

noreturn void accumulator(struct concurrent_ctx *ctx)
{
    int *v = ctx_get_resume_value(ctx);
    int total = *v;
    for (;;) {
        v = yield_value(ctx, &total); // send total / receive next value
        total += *v;
    }
}

int main(void)
{
    struct concurrent_ctx *ctx;
    uint8_t stack[STACK_SIZE];
    uint8_t ctx_alloc[ctx_sizeof()];
    concurrent_init();
    ctx = (struct concurrent_ctx *)ctx_alloc;
    ctx_construct(ctx, stack, STACK_SIZE, accumulator, NULL);
    for (int i = 1; i <= 10; i++) {
        int *total = resume_value(ctx, &i); // send value / receive total
        printf("total = %d\n", *total);
        
    }
    ctx_destruct(ctx);
    concurrent_fin();
    return EXIT_SUCCESS;
}

/*
$ gcc -o sample sample.c -lconcurrent.a
$ ./sample
total = 1
total = 3
total = 6
total = 10
total = 15
total = 21
total = 28
total = 36
total = 45
total = 55
*/
```

## Requirements for build
- for x86_64/i686: [nasm](http://www.nasm.us/)

## Installation
```
$ git clone https://github.com/sharow/libconcurrent.git libconcurrent
$ cd libconcurrent
$ make
$ sudo make install

```

#### for FreeBSD
Available in ports collection as [devel/libconcurrent](http://portsmon.freebsd.org/portoverview.py?category=devel&portname=libconcurrent)

#### for OSX
- install latest [nasm](http://www.nasm.us/) from [brew](http://brew.sh)

```
$ brew install nasm
```

## Tests
```
$ make test

```

## Benchmark

[examples/many_context1.c](https://github.com/sharow/libconcurrent/blob/master/examples/many_context1.c):

```
-- output: (Xeon E3 2.5Ghz)
3000000 context switch in 373.5 ms
one context switch in 125 ns
8031333 resume/yield pair per second

-- output: (RaspberryPi2 ARMv7 900MHz)
3000000 context switch in 2861.8 ms
one context switch in 954 ns
1048287 resume/yield pair per second
```

## VS. 
+ Portable Coroutine Library (PCL): http://xmailserver.org/libpcl.html
+ libtask: https://code.google.com/p/libtask/
+ libconcurrency: http://code.google.com/p/libconcurrency/
+ libcoro: http://software.schmorp.de/pkg/libcoro.html
+ libcoroutine: https://github.com/stevedekorte/coroutine
+ coro: http://www.goron.de/~froese/coro/
+ libfiber: http://www.rkeene.org/projects/info/wiki/22
+ mill: https://github.com/sustrik/mill
+ fcontext: https://github.com/reginaldl/fcontext
+ libwire: https://github.com/baruch/libwire
+ coroutine(A asymmetric coroutine library for C): https://github.com/cloudwu/coroutine
+ coroutine(a asymmetric coroutine (lua like) with fixed-size stack): https://github.com/xphh/coroutine
+ coroutine(coroutine library with pthread-like interface in pure C): https://github.com/Marcus366/coroutine
+ coroutines(A lightweight coroutine library written in C and assembler): https://github.com/xya/coroutines
+ micro: https://github.com/mikewei/micoro