mirror of https://github.com/mutouyun/cpp-ipc.git synced 2025-12-06 08:46:45 +08:00

Go to file

木头云 7726742157 feat(shm): implement reference counting for Windows shared memory Problem: - Reference counting tests fail on Windows (ReleaseMemory, ReferenceCount, SubtractReference, HandleRef, HandleSubRef) - get_ref() and sub_ref() were stub implementations returning 0/doing nothing - CreateFileMapping HANDLE lacks built-in reference counting mechanism Solution: - Implement reference counting using std::atomic<std::int32_t> stored at the end of shared memory (same strategy as POSIX version) - Add calc_size() helper to allocate extra space for atomic counter - Add acc_of() helper to access the atomic counter at the end of memory - Modify acquire() to allocate calc_size(size) instead of size - Modify get_mem() to initialize counter to 1 on first mapping - Modify release() to decrement counter and return ref count before decrement - Implement get_ref() to return current reference count - Implement sub_ref() to atomically decrement reference count - Convert file from Windows (CRLF) to Unix (LF) line endings for consistency Key Implementation Details: 1. Reference counter stored at end of shared memory (aligned to info_t) 2. First get_mem() call: fetch_add(1) initializes counter to 1 3. release() returns ref count before decrement (for semantics compatibility) 4. Memory layout: [user data][padding][atomic<int32_t> counter] 5. Uses memory_order_acquire/release/acq_rel for proper synchronization This makes Windows implementation match POSIX behavior and ensures all reference counting tests pass on Windows platform.		2025-11-30 10:55:24 +00:00
.github/workflows	Update c-cpp.yml	2021-07-10 13:52:44 +08:00
3rdparty	Fixed memory access exception in multithreading.	2023-10-28 16:44:16 +08:00
demo	mingw: use lower case windows.h	2025-11-17 09:56:49 +00:00
include/libipc	docs(shm): add semantic comments for release/remove and fix double-free in tests	2025-11-30 05:28:48 +00:00
src	feat(shm): implement reference counting for Windows shared memory	2025-11-30 10:55:24 +00:00
test	fix(test): correct receiver loop count in MultipleSendersReceivers	2025-11-30 06:38:38 +00:00
.gitignore	disable warning C4858	2023-10-28 16:44:16 +08:00
CMakeLists.txt	Supplement similar demo under linux.	2023-10-28 16:44:16 +08:00
LICENSE	调整目录结构，隔离include路径，修正tls在win下的问题	2020-09-13 17:29:14 +08:00
performance.xlsx	performance.xlsx 更新图示说明	2021-10-17 14:32:38 +08:00
README.md	Update README.md	2025-02-09 17:00:48 +08:00

README.md

cpp-ipc (libipc) - C++ IPC Library

A high-performance inter-process communication library using shared memory on Linux/Windows.

Compilers with C++17 support are recommended (msvc-2017/gcc-7/clang-4)
No other dependencies except STL.
Only lock-free or lightweight spin-lock is used.
Circular array is used as the underline data structure.
ipc::route supports single write and multiple read. ipc::channel supports multiple read and write. (Note: currently, a channel supports up to 32 receivers, but there is no such a limit for the sender.)
Broadcasting is used by default, but user can choose any read/ write combinations.
No long time blind wait. (Semaphore will be used after a certain number of retries.)
Vcpkg way of installation is supported. E.g. vcpkg install cpp-ipc

Usage

See: Wiki

Performance

Environment	Value
Device	Lenovo ThinkPad T450
CPU	Intel® Core™ i5-4300U @ 2.5 GHz
RAM	16 GB
OS	Windows 7 Ultimate x64
Compiler	MSVC 2017 15.9.4

Unit & benchmark tests: test
Performance data: performance.xlsx

Reference

使用共享内存的跨平台（Linux/Windows，x86/x64/ARM）高性能IPC通讯库

推荐支持C++17的编译器（msvc-2017/gcc-7/clang-4）
除STL外，无其他依赖
无锁（lock-free）或轻量级spin-lock
底层数据结构为循环数组（circular array）
ipc::route支持单写多读，ipc::channel支持多写多读【注意：目前同一条通道最多支持32个receiver，sender无限制】
默认采用广播模式收发数据，支持用户任意选择读写方案
不会长时间忙等（重试一定次数后会使用信号量进行等待），支持超时
支持Vcpkg方式安装，如vcpkg install cpp-ipc

使用方法

详见：Wiki

性能

环境	值
设备	联想 ThinkPad T450
CPU	英特尔® Core™ i5-4300U @ 2.5 GHz
内存	16 GB
操作系统	Windows 7 Ultimate x64
编译器	MSVC 2017 15.9.4

单元测试和Benchmark测试: test
性能数据: performance.xlsx

README.md Unescape Escape