Changes between Version 28 and Version 29 of AppDebug

Timestamp:

Apr 12, 2017, 1:33:18 PM (8 years ago)

Author:

davea

Comment:

--

AppDebug

@@ -1 +1 @@
 = Application debugging =
 [[PageOutline]]
-Some suggestions for debugging applications: 
+In debugging a BOINC application,
+you need to make sure that it interfaces properly with the BOINC client.
+You can do this in stages, as follows:
 
-== Testing without a BOINC client ==
+== Testing without a BOINC client, part 1 ==
 
 When you have built your application and linked it with the BOINC libraries,
 you can run it in '''standalone mode''' (without a BOINC client present).
-To do this, put instances of all input files in the same directory (with the proper logical, not physical, names).
-The application should run and produce output files (also with their logical names).
+To do this, put instances of all input files in the same directory
+(with the proper logical, not physical, names).
+The application should run, produce output files (also with their logical names),
+and exit with 0 status.
 You can run the program under a debugger.
-When you run an application in standalone mode, the BOINC API will recognize this and take it into account.
 
-Note: {{{boinc_time_to_checkpoint()}}} will always return false, so your application will never checkpoint.
+Note: {{{boinc_time_to_checkpoint()}}} will always return false,
+so your application will never checkpoint.
+
+== Testing without a BOINC client, part 2 ==
+
+The next step is to make sure that suspend, resume, and abort work.
+To do this:
+
+ * Edit boinc/api/boinc_api.cpp; uncomment the #defines of
+ MSGS_FROM_FILE and (if you want) VERBOSE.
+ This tells the BOINC API to look for process control messages
+ in a file "msgs.txt" rather than in shared memory.
+ Rebuild the BOINC API library, and rebuild your app.
+ * Run your app.
+ * To suspend your app, write "<suspend/>" to msgs.txt.
+ You need to do this atomically, e.g. write "<suspend/>" to another file,
+ then copy that file to msgs.txt.
+ "cat > msgs.txt" doesn't work.
+ * Similar for <resume/> and <abort/>.
+ Verify that they all work.
 
 == Testing with a BOINC client but no project ==
@@ -24 +46 @@
 and an output file with logical name '''out''' and physical name '''output.txt'''.
 
- * Make a directory and put the BOINC client there.  Note: you'll need a 6.10.14 or later client.
+ * Make a directory and put the BOINC client there.  You'll need a 6.10.14 or later client.
  * Put the file
    [http://boinc.berkeley.edu/gitweb/?p=boinc-v2.git;a=blob_plain;f=samples/client_state_save.xml;hb=HEAD samples/client_state_save.xml]
@@ -143 +165 @@
 There are several techniques for deciphering these.
 For details see [MacBacktrace Mac Backtrace].
-Although that page is written primarily for the Mac, much of it can be used on Linux and UNIX systems as well.
-
+Although that page is written primarily for the Mac,
+much of it can be used on Linux and UNIX systems as well.