Home Esplora Aiuto
Accedi
DragonOS-Community
/
thingbuf
mirror da https://github.com/DragonOS-Community/thingbuf.git
4
0
Forka 0
File Problemi 0 Wiki

镜像自： https://github.com/DragonOS-Community/thingbuf.git

Albero (Tree): 63825e6c53
Rami (Branch) Tag
thingbuf
Eliza Weisman 63825e6c53 refac: remove special empty state from slots (#25) 3 anni fa
.github 299011398b chore(ci): run the slowest loom models in separate jobs (#21) 3 anni fa
assets 853df894c2 docs: add benchmarks to readme 3 anni fa
bench 5b17c184b0 feat(mpsc): add support for statically-allocated MPSC channels (#23) 3 anni fa
bin 974f51e02f chore(test): fix loom script not forwarding args 3 anni fa
src 63825e6c53 refac: remove special empty state from slots (#25) 3 anni fa
tests 5b17c184b0 feat(mpsc): add support for statically-allocated MPSC channels (#23) 3 anni fa
.envrc 84b9ce7057 initial commit 3 anni fa
.gitignore 84b9ce7057 initial commit 3 anni fa
Cargo.toml 5b17c184b0 feat(mpsc): add support for statically-allocated MPSC channels (#23) 3 anni fa
README.md 853df894c2 docs: add benchmarks to readme 3 anni fa
default.nix 84b9ce7057 initial commit 3 anni fa
netlify.toml b6dbfdeee9 chore(docs): add Netlify docs builds 3 anni fa
shell.nix 84b9ce7057 initial commit 3 anni fa

README.md

Is it fast?

Yes, it's fast

FAQs

  • Q: Why did you make this?

A: For tracing, I wanted to be able to send formatted log lines to a dedicated worker thread that writes them to a file. Right now, we do this using crossbeam-channel. However, this has the sad disadvantage that we have to allocate Strings, send them through the channel to the writer, and immediately drop them. It would be nice to do this while reusing those allocations. Thus...StringBuf.

  • Q: Is it lock-free?

A: Extremely.

  • Q: Is it wait-free?

A: As long as you don't use the APIs that wait :)

  • Q: Why is there only a bounded variant?

A: Because unbounded queues are of the Devil.

  • Q: Isn't this just a giant memory leak?

A: If you use it wrong, yes.

  • Q: Why is it called that?

A: Originally, I imagined it as a kind of ring buffer, so (as a pun on "ringbuf"), I called it "stringbuf". Then, I realized you could do this with more than just strings. In fact, it can be generalized to arbitrary...things. So, "thingbuf".