libmuth

overview #

libmuth is a microthreading library written in C++. The main goals are to enable massive userspace threading on SMP machines as well as single processor systems. It has certain similarities to Erlang and works a bit like a microkernel.

system requirements #

You will need:

• A C++ compiler (apart from g++ msvc support is worked on)
• scons
• Your system must support the makecontext and swapcontext calls, so win32 users need some emulation layer.
• POSIX threads (when running on smp)
• Preferably gmp development packages installed. (only needed for one example)

getting libmuth #

The best way is using the darcs repository. Just type darcs get http://subdivi.de/~helmut/darcs/libmuth/. Sometimes unversioned tarballes may be placed at http://subdivi.de/~helmut/darcs/libmuth/libmuth.tar.gz, but if you don't get 404 it will probably out of date.

documentation #

There is an introduction for understanding how libmuth works available. There also is some generated documentation.

contributing #

If you want to help, you can

• read the documentation and tell me about things being unclear.
• find bugs
• have a look at the class hierarchy and tell me what you like or dislike
• tell me about features that would be nice to have
• perhaps write documenation

faq #

• Q: What does "libmuth" mean?
  A: The name is shorthand for microthread where micro is abbreviated with mu and thread is abbreviated with th.

recent changes #

• Sat Feb 7 01:22:23 CET 2009: cleanups, new example, added some helper functions, build improvements, more lock debugging, more test cases, valgrind support repaired and tons of bug fixes: functionality bugs, win32 build bugs, lock missusage
• Wed Feb 13 12:41:48 CET 2008: some language updates
• Thu Sep 13 12:16:27 CEST 2007: g++-4.3 fixes
• Fri Jul 27 03:12:52 CEST 2007: minor refcounter fixes
• Tue May 8 21:33:49 CEST 2007: Added an SConstruct file for building on win32. Should replace make somewhen.
• Mon Mar 19 12:43:14 CET 2007: another set of cleanups mainly for channels
• Mon Mar 12 21:58:08 CET 2007: repaired the gmp example
• Mon Mar 12 21:51:06 CET 2007: fixed deadlock in channels
• Fri Mar 9 16:21:30 CET 2007: some major win32 specific bugfixes
• Thu Mar 8 21:45:14 CET 2007: there is a parallel unit test framework

contact #

You can mail questions, ideas and feedback to helmut@subdivi.de, but do not mail devnull@subdivi.de.