diff options
| author | Nick Mathewson <nickm@torproject.org> | 2015-10-14 10:40:27 -0400 |
|---|---|---|
| committer | Nick Mathewson <nickm@torproject.org> | 2015-10-14 10:40:27 -0400 |
| commit | 49ccb7e7b88d38a572277824a344ad423494a293 (patch) | |
| tree | d1469f9bb6b93e4df08e60e3b1883fe059aaa45a /src/trunnel | |
| parent | 8182715a2b983fc3e48c5092a0a4aaa7ffc49388 (diff) | |
| download | tor-49ccb7e7b88d38a572277824a344ad423494a293.tar.gz tor-49ccb7e7b88d38a572277824a344ad423494a293.zip | |
Mention trunnel in CodingStandards; describe how in trunnel/README
Diffstat (limited to 'src/trunnel')
| -rw-r--r-- | src/trunnel/README | 13 |
1 files changed, 12 insertions, 1 deletions
diff --git a/src/trunnel/README b/src/trunnel/README index 383272cf78..e24aea0764 100644 --- a/src/trunnel/README +++ b/src/trunnel/README @@ -1,10 +1,21 @@ This directory contains code for use with, and code made by, the automatic code generation tool "Trunnel". +Trunnel generates binary parsers and formatters for simple data +structures. It aims for human-readable, obviously-correct outputs over +maximum efficiency or flexibility. + The .trunnel files are the inputs here; the .c and .h files are the outputs. -To regenerate the .c and .h files, run "scripts/codegen/run_trunnel.sh". + +To add a new structure: + - Add a new .trunnel file or expand an existing one to describe the format + of the structure. + - Regenerate the .c and .h files. To do this, you run + "scripts/codegen/run_trunnel.sh". You'll need trunnel installed. + - Add the .trunnel, .c, and .h files to include.am For the Trunnel source code, and more documentation about using Trunnel, see https://gitweb.torproject.org/trunnel.git , especially https://gitweb.torproject.org/trunnel.git/tree/README and https://gitweb.torproject.org/trunnel.git/tree/doc/trunnel.md + |