Juxta, a tool that automatically infers high-level semantics directly from source code. The key idea in Juxta is to compare and contrast multiple existing implementations that obey latent yet implicit high-level semantics. We applied Juxta to 54 file systems in the stock Linux kernel (680K LoC), found 118 previously unknown semantic bugs (one bug per 5.8K LoC), and provided corresponding patches to 39 different file systems, including mature, popular ones like ext4, btrfs, XFS, and NFS.

This repository is under the terms of MIT license. For execution, llvm was slightly modified in llvm directory.

• Tested: Ubuntu 14.04
• Requisite

Linux kernel 4.0-rc2
$ cd ..
$ git clone https://github.com/torvalds/linux.git
$ cd linux
$ git checkout v4.0-rc2
$ cp ../juxta/config/config-x86_64-full-fs .
$ make; make clean
$ cd ../juxta

Build clang
$  make clang-full  (first time only)
$  make clang       (from the next)

Merge file system code
$ cd analyzer
$ ./ctrl.py merge_all  (for all file systems)
$ ./ctrl.py merge ext4 (for ext4)

Static analysis of merged file system code
$ ./ctrl.py clang_all  (for all file systems)
$ ./ctrl.py clang ext4 (for ext4)

Create path database
$ ./ctrl.py pickle_all (for all file systems)
$ cd ..

• Return code checker: analyzer/ckrtn.py
• Side-effect checker: analyzer/ckstore.py
• Function call checker: analyzer/ckcall.py
• Path condition checker: analyzer/ckcond.py
• Argument checker: analyzer/call_flags.py
• Error handling checker: analyzer/ckapi.py
• Lock checker: analyzer/lock.py
• Spec. generator: analyzer/spec.py

• Changwoo Min changwoo@gatech.edu
• Sanidhya Kashyap sanidhya@gatech.edu
• Byoungyoung Lee blee@gatech.edu
• Chengyu Song csong84@gatech.edu
• Taesoo Kim taesoo@gatech.edu

https://dl.acm.org/doi/abs/10.1145/2815400.2815422

@inproceedings{min:juxta,
  title        = {{Cross-checking Semantic Correctness: The Case of Finding File System Bugs}},
  author       = {Changwoo Min and Sanidhya Kashyap and Byoungyoung Lee and Chengyu Song and Taesoo Kim},
  booktitle    = {Proceedings of the 25th ACM Symposium on Operating Systems Principles (SOSP)},
  month        = oct,
  year         = 2015,
  address      = {Monterey, CA},
}