From: Benjamin Poirier Date: Tue, 12 Jan 2010 15:36:51 +0000 (-0500) Subject: Update README and documentation X-Git-Tag: 0.12.32~32 X-Git-Url: http://git.liburcu.org/?p=lttv.git;a=commitdiff_plain;h=29dd991d045247414d55071fe4390e97f627b8e3 Update README and documentation Signed-off-by: Benjamin Poirier --- diff --git a/lttv/lttv/sync/README b/lttv/lttv/sync/README index 986885f8..fe242e97 100644 --- a/lttv/lttv/sync/README +++ b/lttv/lttv/sync/README @@ -129,7 +129,7 @@ There are also other, less common, types. See the enum ApproxType in event_analysis_chull.h. +++ Linear Regression -linreg sometimes gives more accurate results than chull but it provides no +linreg sometimes gives more precise results than chull but it provides no garantee +++ Synchronization evaluation @@ -137,7 +137,7 @@ eval is a special module, it doesn't really perform synchronization, instead it calculates and prints different metrics about how well traces are synchronized. Although it can be run like other analysis modules, it is most useful when run in a postprocessing step, after another synchronization module -has been run. Eval is most common run in text mode. To do this, run: +has been run. Eval is most commonly run in text mode. To do this, run: lttv -m sync_chain_batch [usual options, ex: -t traces/node1 -t traces/node2 --sync ...] It can also be run from the lttv source tree via runlttv: @@ -163,7 +163,9 @@ fields are separated by whitespace. '#' comments a line. Many commands can be used to measure the RTT, for example: ping -s 8 -A -c 8000 -w 10 192.168.112.57 -Note that this must be repeated in both directions in the file. +Note that this must be repeated in both directions in the file, that is: +192.168.112.49 192.168.112.50 0.057 +192.168.112.50 192.168.112.49 0.050 ++++ Linear Programming and GLPK The synchronization evaluation can optionally perform an analysis similar to @@ -173,7 +175,12 @@ measure of the accuracy of the synchronization in any point (this is seen in the graph output). This is enabled by default at configure time (--with-glpk) if the GNU Linear -Programming Kit is available (libglpk). +Programming Kit is available (libglpk). On Debian-like systems (ex. Ubuntu), +install the package "libglpk-dev". + +To see the output of this mode, run: +lttv -m sync_chain_batch --eval-graphs [usual options, ex: -t traces/node1 -t +traces/node2 --sync ...] + Design This part describes the design of the synchronization framework. This is to diff --git a/lttv/lttv/sync/event_analysis_chull.c b/lttv/lttv/sync/event_analysis_chull.c index 8c7c54dd..12c3d85f 100644 --- a/lttv/lttv/sync/event_analysis_chull.c +++ b/lttv/lttv/sync/event_analysis_chull.c @@ -1249,7 +1249,7 @@ static double intercept(const Point* const p1, const Point* const p2) * is. * * Two alternative (and subtly different) ways of propagating factors to - * preserve min and max bondaries have been proposed, see: + * preserve min and max boundaries have been proposed, see: * [Duda, A., Harrus, G., Haddad, Y., and Bernard, G.: Estimating global time * in distributed systems, Proc. 7th Int. Conf. on Distributed Computing * Systems, Berlin, volume 18, 1987] p.304