A practical interface generator for data formats.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
examples Get rid of old network example Aug 11, 2015
generator proper support for checksums Aug 11, 2015
include/nail offset standard transform Aug 11, 2015
network
paper Bibliography Aug 17, 2015
talk/langsec14 More stuff May 13, 2014
tests foo Mar 8, 2015
.gitignore Added select tests Mar 4, 2015
LICENSE License Aug 8, 2015
README.md foo Aug 13, 2015

README.md

Nail

\textit{Nail} is an interface generator that allows programmers to safely parse and generate protocols defined by a Parser-Expression based grammar. Nail also provides solutions for parsing common patterns such as length and offset fields within binary formats that are hard to process with existing parser generators.

Installation & Pre-requisites

The code generator (in /generator/) requires a C++ compiler and depends on boost. The code generator can either be invoked as ./nail foo.nail , which case it will emit C++ code (in foo.nail.cc and foo.nail.hh) , or as ./cnail foo.nail in which case it will emit a two-pass parser in C (in foo.nail.c and foo.nail.h) . Generated code has no dependencies (and does not even use the C++ or C standard library). longjmp.h/setjmp.h is used for handling out of memory errors.

Examples

Several examples are provided, pull requests for more are very welcome!

  • /dns - DNS server and resolver implemented in C. Used for older benchmarks
  • /dns_cpp - DNS server implemented in C++, used for newer benchmarks
  • /zip - ZIP extractor,compressor in C.
  • /protozip - Simplified 'pretend' zip, easier to grok
  • /utf16 - mini grammar for UTF-16 -- good starting point

Network stack

Nail has a (very prototype-y) network stack. Find it in /network/. The network stack depends on boost and (soon) Intel TBB and DPDK .