Skip to content

A circular buffer written in C using Posix calls to create a contiguously mapped memory space. BSD Licensed.

License

Notifications You must be signed in to change notification settings

willemt/cbuffer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Circular buffers are tricky. The caller needs to know if the polled item crosses the maximum size of the underlying array.

This circular buffer uses a mmap magic trick to make the caller's life easier.

This is how we do it:

  1. mmap is used to mirror the buffer like below:
doc/circular_buffer_mmap.png
  1. the "mirrored" buffer is then placed beside the buffer. When the user polls the item it doesn't matter if the item crosses the buffer's boundary:
doc/circular_buffer_mmap_portal.png

Compatibility

This only works on UNIX systems.

Windows support existed in d10238600a82de32fe1cb01bec8667d3a67e382c but was removed. This is because Windows doesn't actually have mmap and trying to get the same behaviour is painful. Maybe you should check this out instead: https://github.com/willemt/bipbuffer

About

A circular buffer written in C using Posix calls to create a contiguously mapped memory space. BSD Licensed.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published