add new windows batch-script, changes in the layout of "debugging clients"
authorhttps://me.yahoo.com/hanki_pank#f42c5 <Christof_Hanke@web>
Fri, 20 Jan 2012 05:23:19 +0000 (21:23 -0800)
committerOpenAFS Wiki <ikiwiki@openafs.org>
Fri, 20 Jan 2012 05:23:19 +0000 (21:23 -0800)
AFSLore/debugging.mdwn

index 16b8551..77669ae 100644 (file)
@@ -26,15 +26,27 @@ displays only threads which are not in this boring rx_GetCall (threads are waiti
 
 ## Debugging Clients
 
+### intermittent issues
+
 Low-level debugging of a client can be done using "fstrace". <br/>
 Unfortunately, this produces a lot of output, so it is not easy 
 to catch an intermittent error-condition with "fstrace".
 
-The attached script [[ClientTracing.py]] gives you the opportunity to continuously run a fstrace, <br/>
+The attached script [[ClientTracing.py]] (presently for Unix only) gives you the opportunity to continuously run a fstrace, <br/>
 where the output is stored in rotating log-files. 
 
-In case of an external-event (the existence of a predefined file), it saves this log and does not overwrite
-it again.
+In case of an external-event (the existence of a predefined file), <br/>
+it saves this log and does not overwrite it again.
 Thus, all you need to do is to write a script which creates this predefined file, when that event happens.
 
 
+### defined issue
+
+When you exactly know how to reproduce the issue, or you don't want to install python on your client,<br/>
+you can use the attached script [[ClientTracing.bat]] (for Windows only). <br/>
+It is setting up the client tracing, starting up a tshark (terminal-version of wireshark)<br/>
+ and waits for you to tell it to stop tracing.<br/>
+In order to synchronize the timestamps of the wireshark log and the afsd-trace-log, <br/>
+a "dir \\AFS\openafs.org" is issued on startup. <br/>
+The logfiles are copied to a predefined directory. <br/>
+The script itself should be self-explanatory.]