Changeset 7425 for trunk/doc

Timestamp:

Nov 22, 2001, 12:50:55 PM (24 years ago)

Author:

phaller

Message:

.

Location:

trunk/doc

Files:

• Logging.txt (modified) (2 diffs)
• ToDO.txt (modified) (5 diffs)

trunk/doc/Logging.txt

@@ -1 @@
-/* $Id: Logging.txt,v 1.1 2000-07-09 22:27:52 phaller Exp $ */
+/* $Id: Logging.txt,v 1.2 2001-11-22 11:48:55 phaller Exp $ */
 
-                Odin Logging
-                ~~~~~~~~~~~~
+                Odin Logging and Profiling
+                ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 1.0 Standard logging feature
@@ -54 +54 @@
         set dbg_kernel32=+dll -profile -wprocess
 
+
+3.0 ODIN Profiler
+~~~~~~~~~~~~~~~~~
+
+If the ODIN executables are compiled with IBM VisualAge C++ 3.08 and
+the generation of profile hooks is enabled (/Gh+), the runtime library
+ODINCRTP will reroute the _ProfileHook32 calls to the ODINPROF library.
+This is done by some sophisticated stack trickery.
+ODINPROF will be called upon each entry and exit of compiled C functions and
+C++ member functions. The profiler will then try to load the symbolic debug
+information file according to the module name (i. e. KERNEL32.sym) and
+lookup the symbol name according to the function's entry address. C++ name
+demangling is done automatically.
+If this fails, the profiler will auto-generate symbolic names.
+If a symbol table could be loaded, but the address looked for could not be
+found exactly in the debug information, the profiler will revert to the 
+closest symbol found and add the address difference as an offset suffix.
+(i. e. _MyAPI@4+1234h)
+
+Upon process termination the profiler will yield a file named '<pid>.prof'.
+It will contain a number of sorted tables about the collected performance 
+data.
+
+

trunk/doc/ToDO.txt

@@ -1 @@
-/* $Id: ToDO.txt,v 1.16 2001-10-19 09:36:06 phaller Exp $ */
+/* $Id: ToDO.txt,v 1.17 2001-11-22 11:50:55 phaller Exp $ */
 
 To Do list for ODIN:
@@ -10 +10 @@
                 Eventually start porting over D3D support from WINE
 
-                Implement support for Parallel Port Devices
+PH       PART   Implement support for Parallel Port Devices
 
                 Fix wrong reference count after window creation
@@ -32 +32 @@
                 TogetherJ installation to the ODIN installer.
 
-PH              Sync NTDLL with WINE
+PH       DONE   Sync NTDLL with WINE
 
-JW              Put in correct FS:-wrappers in CRTDLL and MSVCRT
+JW       ----   Put in correct FS:-wrappers in CRTDLL and MSVCRT
 
 JW              Improve CRTDLL and MSVCRT as this is one major show stopper 
                 currently
 
-SvL             Remove GPI32 calls from the original FS: macros and replace
+SvL      ----   Remove GPI32 calls from the original FS: macros and replace
                 them with ODINFUNCTION wrappers. Internally call to ODIN_xxx
                 GPI functions to get much better performance.
@@ -69 +69 @@
 NOONE           KERNEL32: Async file io
 
-NOONE           KERNEL32: Vio support for console applications
-                        (partially done)
+NOONE     PART  KERNEL32: Vio support for console applications
 
-NOONE           WSOCK32: Winsock 2 implementation (WS2_32.DLL, WS2HELP.DLL)
+NOONE     DONE  WSOCK32: Winsock 2 implementation (WS2_32.DLL, WS2HELP.DLL)
 
 NOONE           GDI32: Rewrite using Gpi api (remove Open32 dependancy)
@@ -79 +78 @@
                 as LZ32, VERSION which are considered complete.
                 Also ensure the source code is well documented and structured.
-
-NOONE           OLE32/COM: support (broker) for Out-of-process COM
-                objects