Skip to content

Latest commit

 

History

History
48 lines (37 loc) · 1.79 KB

README.md

File metadata and controls

48 lines (37 loc) · 1.79 KB

minisat-rust Build Status

Note that this is reimplementation, not bindings.

Original minisat links:

Using

Pretty much identical to original minisat. The only difference is using pair of dashes before each argument instead of just one. So, instead of something like:

$ minisat -verb=2 -rsync input.cnf

we have:

$ minisat-rust --verb=2 --rsync input.cnf

This is because I am too lazy to reimplement minisat's custom argument parsing and used existing library instead :)

Building

Just use Cargo. You should have minisat in your path if you want to run big test that solves bunch of cnf files and compares output to minisat.

What is not working yet?

  • Reading (gzipped) CNF from stdin.
  • Proper allocation/reallocation of clauses (GC log messages are fake to test output against minisat). Probably need to wait Rust allocation features stabilization before implementing it.
  • Proper Ctrl-C handling.
  • Writing DIMACS when solving is interrupted.

Why?

There are a few reasons for reimplementing instead of just writing bindings:

  • Evaluate how Rust is suitable for relatively big projects
  • Estimate performance degradation (~1.5 -- 2 times for now; maybe I am just bad at Rust).
  • Minisat code is quite complicated having big structure randomly mutated by bunch of methods. Rust encourages splitting it into smaller more tractable parts that could help understanding how minisat actually works and verify it with Rust type system.
  • Maybe find some minisat bugs as a result of previous point. Indeed at least one was found: Issue 26.