~ubuntu-branches/ubuntu/karmic/pilot-link/karmic

« back to all changes in this revision

Viewing changes to doc/README.debugging

  • Committer: Bazaar Package Importer
  • Author(s): Ludovic Rousseau
  • Date: 2006-09-22 11:51:36 UTC
  • mfrom: (3.1.8 edgy)
  • Revision ID: james.westby@ubuntu.com-20060922115136-qqmy17bx8j5x0y72
Tags: 0.12.1-5
* urgency medium since libpisock-dev was not usable to build any package
* libpisock-dev now depends on libusb-dev

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
LOGGING
 
1
DEBUGGING PILOT-LINK
 
2
--------------------
2
3
 
3
4
In order to debug problems, libpisock by default contains runtime debugging
4
 
(pass the --disable-debug configure option to disable).
 
5
 
 
6
Pass the --disable-debug configure option to disable at build time. Debugging
 
7
is enabled by default, so there is no --enable-debugging target.
5
8
 
6
9
The runtime debugging is controlled by four different environment variables:
7
10
 
25
28
            
26
29
You can specify multiple types of information, ie:
27
30
 
28
 
        PILOT_DEBUG="DEV SLP PADP".
 
31
        PILOT_DEBUG="DEV SLP PADP"
29
32
 
30
33
PILOT_DEBUG_LEVEL controls the level of information displayed for each type.
31
34
 
38
41
            DEBUG    Verbose debugging info
39
42
 
40
43
If PILOT_LOG is set, the information will be written to the file
41
 
"PiDebug.log", this can be overridden by setting PILOT_LOGFILE to the
 
44
"pilot-link.debug", this can be overridden by setting PILOT_LOGFILE to the
42
45
desired file name.
43
46
 
44
47
Here's an example of the usage (for bash, your shell may vary): 
45
48
 
46
 
        export PILOT_DEBUG="DEV SLP CMP PADP SOCK"
 
49
        export PILOT_DEBUG="DEV SLP CMP PADP SOCK NET USER"
47
50
        export PILOT_DEBUG_LEVEL="DEBUG"
48
 
        export PILOT_LOG=1  # Set this to 0 to disable debugging
49
 
        export PILOT_LOGFILE="pilot-link-debug.log"
 
51
        export PILOT_LOG=1                      # Set this to 0 to disable debugging
 
52
        export PILOT_LOGFILE="debug.log"