How jhunt/research works
This is a collection of independent systems-programming research experiments, not one integrated application. The README highlights two workflows: use smaps experiments to inspect process memory through /proc/$PID/smaps, and stress software with a custom allocator. Other directories contain standalone data-structure, concurrency, parsing, cryptography, and runtime experiments. The smaps helper pauses for manual inspection; the README describes its monitoring and troubleshooting purpose. Several subsystems are represented by directory-level nodes because their source was not sampled; their internal connections are therefore omitted.
Main entry points: asm.c Assembler · smaps Smaps experiments · lib.c Smaps helper · main.c Locked RCU comparison
Components 23
Memory research
- Smaps experiments
smaps - Smaps helper
smaps/lib.c - Process smaps
- Allocator stress
malloc
Systems experiments
- Null filesystem
fuse/nullfs/nullfs.c - Locked RCU comparison
rcu/lock/main.c - Quiescent-state RCU
rcu/qs/main.c - Thread and lock helpers
rcu/api.h
Language tools
- BQL lexer
lexer-ll/bql.ll.c - Lexer driver
lexer-ll/main.c - Assembler
regm/asm.c - Register VM runtime
regm/regm.c - Opcode definitions
regm/opcodes.h
Runtime libraries
- B-tree
btree/btree.c - B-tree interface
btree/btree.h - Consistent hashing
chash - String ring
ringer/ring.c - Ring interface
ringer/ring.h - Assertion macro
insist/insist.h - Assertion example
insist/main.c - NaCl crypto
nacl/tweetnacl.c - Crypto interface
nacl/tweetnacl.h
Other components
- Researcher
Connections 23
- Researcher → Smaps experiments: runs experiment
- Smaps experiments → Smaps helper: uses helper
smaps/mmap.c - Smaps helper → Process smaps: prompts inspection
smaps/lib.c - Researcher → Allocator stress: runs stress test
- Researcher → Null filesystem: runs experiment
- Researcher → Locked RCU comparison: runs comparison
- Researcher → Quiescent-state RCU: runs comparison
- Locked RCU comparison → Thread and lock helpers: uses helpers
rcu/lock/main.c - Quiescent-state RCU → Thread and lock helpers: uses helpers
rcu/qs/main.c - Researcher → B-tree: runs experiment
- B-tree → B-tree interface: includes interface
btree/btree.c - Researcher → Consistent hashing: runs experiment
- Researcher → String ring: runs experiment
- String ring → Ring interface: implements interface
ringer/ring.c - Researcher → Assertion example: runs example
- Assertion example → Assertion macro: uses macro
insist/main.c - Researcher → Lexer driver: runs lexer
- Lexer driver → BQL lexer: calls lexer API
lexer-ll/main.c - Researcher → Assembler: assembles input
- Assembler → Opcode definitions: uses definitions
regm/asm.c - Assembler → Register VM runtime: shares VM definitions
regm/asm.c - Researcher → NaCl crypto: uses crypto
- NaCl crypto → Crypto interface: implements API
nacl/tweetnacl.c