home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / ktskmg2.zip / readme < prev   
Text File  |  2000-04-29  |  5KB  |  136 lines
  1.  
  2.     kTaskMgr v0.0.2 alpha preview  -- knut st. osmundsen - 29 Apr 2000
  3.     ==================================================================
  4.  
  5.  
  6.  
  7. Features:
  8. ---------
  9.  o  kTaskMgr is a nice little tool which will present information on OS/2,
  10.     processes mainly using the DosQuerySysState API.
  11.     This currently includes information on processes, modules and open files.
  12.  
  13.  o  It will allow you to kill processes. Two different methods for killing
  14.     processes are provided:
  15.         1. The menuitem "Kill" will try kill the process using
  16.            the DosKillProcess API.
  17.         2. The menuitem "kill -9" will try use the XF86SUP.SYS
  18.            device drivers "death" method.
  19.  
  20.  
  21. Features to come:
  22. -----------------
  23.  o  Information about shared memory and semaphores.
  24.  
  25.  o  Map over the shared memory.
  26.  
  27.  o  I hoped it should be possible to change priority on processes too, using
  28.     the DosSetPrioirty API. But, this API requires the process specified to
  29.     be a decentant of the process issuing the call. This functionality may
  30.     though be provided later by using win32k.sys to change the priority.
  31.     (Win32k.sys will then provide a simple IOCtl to change the priority of
  32.     a single thread slot, not process.)
  33.  
  34.  
  35. Fixed bugs
  36. -----------
  37. v0.0.2:
  38.  
  39.  o  Not all modules (especially dlls) are reported by DosQuerySysState
  40.     on my fixpack 13 machine.
  41.  
  42.  
  43. Known bugs:
  44. ------------
  45.  o  There are some SFN which aren't found due to the bugs in DosQuerySysState
  46.     on system older that Warp4 fixpack 10/13.
  47.     The SFN pages are there by not necessarily correct. So everyone is
  48.     recommend to update their Warp 4 systems to a fixpack level of 10 or
  49.     above.
  50.  
  51.  o  kill -9 don't seem to work on my Warp Fixpack 13 machine.
  52.  
  53.  o  ...
  54.  
  55.  
  56. Bugs/Features found in the DosQuerySysState API:
  57. -------------------------------------------------
  58.  
  59. BUGBUG! - ctSft isn't correct, or rather Sft records are missing!!! (qsFrec_t)
  60.     The number of qsSft_t records is always 1, no matter what the
  61.     ctSft member says!
  62.  
  63.     This is verified! The defect is located in _qsReadMFT. When
  64.     writing the qsSft_t records the record pointer is always
  65.     initialized to _pCurCache in each iteration. This is probably
  66.     correct, but _pCurCache is _NOT_ changed during the iteration.
  67.     With the excelent result that the next Sft record overwrites
  68.     the previous one.
  69.  
  70.     Solution: To move the call to _qsUpdatePtrs into the loopbody,
  71.               after the Sft record is written.
  72.               This way _pCurCache will be updated at end of each
  73.               iteration.
  74.     This is a problem on Aurora, Warp 4 and Warp 3.
  75.  
  76.     It seems like it's corrected in warp 4 fixpack 10, or at least it's
  77.     working with fixpack 13 exactly as I've described it! (Probably
  78.     JR12792 or JR12762.)
  79.  
  80.  
  81.  
  82. FEATURE/BUGBUG: cFH isn't correct - it don't match with the number of
  83.     entries in the pFSRec array. (qsProc_t)
  84.  
  85.     This is verified! There is a "bug" in the _qsProcFS worker (this
  86.     is the function which generates the SFT table pointed to by pFSRec).
  87.     cFH is set to JFN_Length by _qsReadPtda. While _qsProcFS skips the
  88.     entries containing 0xFFFF (unused handle placeholder).
  89.     This way the cFH is really the maximum number of handles and the
  90.     size of the pFSRec table has to be determined by checking pointers
  91.     to the next structure. Thread records are by specifications
  92.     following the FS records, pointer to these is used to do this.
  93.  
  94.     Note. JFN is not equal to the index into the SFN table due to this bug.
  95.  
  96.     This is a problem on Aurora, Warp 4 and Warp 3.
  97.  
  98.     It seems like it's corrected in warp 4 fixpack 10, or at least it's
  99.     working with fixpack 13. (Probably JR12792 or JR12762.)
  100.  
  101.  
  102. BUGBUG: When testing kTaskMgr on Warp fixpack 13 not all DLL are reported
  103.     for some reason. This bug is currently unexplored.
  104.  
  105.  
  106.  
  107. Source code, Web site, CVS tree, Project...
  108. --------------------------------------------
  109.  
  110. The kTaskMgr is hosted at SourceForge (http://www.sourceforge.net).
  111.  
  112. Project Website: (not ready)
  113.     http://kTaskMgr.sourceforge.net/
  114.  
  115. Project URL:
  116.     http://sourceforge.net/project/?group_id=4988
  117.  
  118. Project FTP:
  119.     ftp://kTaskMgr.sourceforge.net/pub/kTaskMgr
  120.  
  121. Anonymous CVS tree:
  122.     CVSROOT=:pserver:anonymous@cvs.kTaskMgr.sourceforge.net:/cvsroot/kTaskMgr
  123.     or
  124.     cvs -d:pserver:anonymous@cvs.kTaskMgr.sourceforge.net:/cvsroot/kTaskMgr login
  125.         (no password, just press enter)
  126.     cvs -d:pserver:anonymous@cvs.kTaskMgr.sourceforge.net:/cvsroot/kTaskMgr co .
  127.  
  128.  
  129.  
  130. ------
  131.  
  132.  
  133. Have fun,
  134.     knut st. osmundsen (knut.stange.osmundsen@mynd.no)
  135.  
  136.