Project

General

Profile

Statistics
| Branch: | Tag: | Revision:

gdp / README-developers.md @ master

History | View | Annotate | Download (1.6 KB)

1 7f982ac3 Eric Allman
% Developing The Global Dataplane
2 b2714365 Eric Allman
3
This file describes things that someone working on developing the
4 632861ce Eric Allman
GDP should know.  It is (extremely) incomplete.
5 b2714365 Eric Allman
6
See the files `README-compiling.md` and `README-admin.md`
7
before you read this file.
8
9 632861ce Eric Allman
If you are working with the Berkeley GDP group, it is ***essential***
10
that you get a login on <https://gdp.cs.berkeley.edu> so you have access
11
to the news, forums, and wiki.  We welcome account requests from bona
12
fide researchers.  If you are a spammer, well, find someplace else to
13
spread your poison.
14
15 b2714365 Eric Allman
16
Setting Debug Flags
17 7f982ac3 Eric Allman
===================
18 b2714365 Eric Allman
19
You can turn on debugging output using a command line flag,
20
conventionally "`-D`_pattern_`=`_level_".  The _pattern_ specifies
21
which flags should be set and _level_ specifies how much
22
should be printed; zero indicates no output, and more output
23
is added as the values increase.
24
25
By convention _level_ is no greater than 127, and values 100
26
and above may modify the base behavior of the program (i.e.,
27
do more than just printing information).
28
29
Each debug flag has a hierarchical name with (by convention)
30
"." as the separator, for example, "`gdp.proto`" to indicate
31
the protocol processing of the GDP.  The "what(1)" program on
32
a binary will show you which debug flags are available
33
including a short description.  (The `what` program isn't available
34
on Linux; it can be simulated using `strings | grep '@(#)'`).
35
36 5ca0856c Eric Allman
To enable debugging for all patterns, use "`*=`_level_" or
37
just "_level_", for example "`*=18`" or "`18`".
38 b2714365 Eric Allman
39
<!-- vim: set ai sw=4 sts=4 ts=4 : -->
40 7f982ac3 Eric Allman
<!-- Use "pandoc -s -o README-developers.html README-developers.md" to process this to HTML -->