← Back to branch summary

~ubuntu-branches/ubuntu/quantal/simgrid/quantal

« back to all changes in this revision

Viewing changes to doc/gtut-tour-06-logs.doc

  • Committer: Package Import Robot
  • Author(s): Lucas Nussbaum, Martin Quinson, Lucas Nussbaum
  • Date: 2012-06-09 16:24:44 UTC
  • mfrom: (10.1.4 sid)
  • Revision ID: package-import@ubuntu.com-20120609162444-xook34f3d6qy5ixj
Tags: 3.7.1-1
[ Martin Quinson ]
* debian/copyright: update FSF address (thanks lintian for noticing)

[ Lucas Nussbaum ]
* New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/gtut-tour-06-logs.doc
8
8
 - \ref GRAS_tut_tour_logs_config
9
9
   - \ref GRAS_tut_tour_logs_config_prio
10
10
   - \ref GRAS_tut_tour_logs_config_layout
11
 
   
 
11
 
12
12
<hr>
13
13
 
14
14
\section GRAS_tut_tour_logs_intro Introduction
43
43
the user a fine control at run time of what gets displayed and what don't.
44
44
For that, <i>log event</i> are produced into <i>log channels</i> at a given
45
45
<i>log priority</i>. Then, you can select the minimal priority an event
46
 
should have on a given channel to get displayed. 
 
46
should have on a given channel to get displayed.
47
47
 
48
48
Then, to keep things managable even when the number of channels increase,
49
49
the channels form a tree and properties get inherited from parent channel to
55
55
their respective subchannels too). Finally, channels are not just open or
56
56
closed, but filter messages below a given priority (as we said). The
57
57
priorities are defined by type #e_xbt_log_priority_t.
58
 
            
 
58
 
59
59
That is all you really need to know about the logs before diving into
60
60
practice. If you want more information on that topic, refer to the \ref
61
61
XBT_log section, which contains much more information than this page.
90
90
\section GRAS_tut_tour_logs_recap Recapping everything together
91
91
 
92
92
Once we changed any fprintf of our code to some of these macros, the program
93
 
may read:  
 
93
may read:
94
94
\include 06-logs.c
95
95
 
96
96
And the output now looks better:
108
108
\include 06-logs.output.verbose
109
109
 
110
110
On the contrary, if we want to reduce the amount of logging, we may want to
111
 
do pass <tt>--log=test.thres:error</tt>: 
 
111
do pass <tt>--log=test.thres:error</tt>:
112
112
 
113
113
\subsection GRAS_tut_tour_logs_config_layout Choosing how things get displayed
114
114