home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / ukill.zip / readme.1st < prev   
Text File  |  1996-06-26  |  3KB  |  93 lines
  1. KILL 1.00 by Viet-Tam Luu
  2. =========================
  3.  
  4. Yet another kill utility... with a bonus!  (Read on...)
  5.  
  6.  
  7.  
  8. Description
  9. ===========
  10.  
  11. KILL is a command-line process killer utility for OS/2 Warp (and possibly
  12. 2.1x).  It includes support for Holger Veit's xf86sup.sys, which (when
  13. used in conjunction with OS/2 Warp FixPak 17 (or later?)) implements a
  14. "HARD KILL" method.
  15.  
  16. xf86sys is included, in the FX0002.ZIP archive.
  17.  
  18. KILL is intended for OS/2 power users.  Familiarity with the internals of
  19. the OS/2 system and process management are assumed.
  20.  
  21. KILL has command-line arguments very similar to the standard Unix kill
  22. command, i.e. "kill [-l] [-signal] PID's".  For example, "kill 130" sends
  23. a SIGTERM to process 130, and "kill -KILL 0x25" uses xf86sup.sys to "hard-
  24. kill" process 0x25 (37).  You can get available signals with "kill -l";
  25. KILL supports OS/2 signals SIGTERM, SIGBREAK, SIGINT, and SIGKILL (the
  26. latter simulated using xf86sup.sys).
  27.  
  28. xf86sup.sys is not required for operation.  If it is not installed,
  29. SIGKILL ("kill -KILL" or equivalently "kill -9") will not be supported.
  30.  
  31.  
  32. Installation
  33. ============
  34.  
  35. 0.  Unzip the kill.zip archive to a temporary directory.
  36.  
  37. 1.  Copy/move kill.exe to a directory in your path.
  38.  
  39. 2.  If you don't have xf86sup.sys installed, unzip FX0002.zip, copy/move
  40.     xf86sup.sys to your \os2\boot directory, and add the line
  41.     "DEVICE=\os2\boot\xf86sup.sys" to your CONFIG.SYS file.
  42.  
  43. 3.  If you don't want to tinker with the kill and xf86sup source files,
  44.     delete all files unarchived that you haven't copied/moved to another
  45.     directory (except possible this readme file!).
  46.  
  47. 4.  If you installed xf86sup.sys in step 2, reboot OS/2.
  48.  
  49. 5.  Happy killing!  :-)
  50.     You can try killing non-killable processes using the sample PIG.EXE
  51.     program included in FX0002.zip.
  52.  
  53.  
  54. Disclaimer
  55. ==========
  56.  
  57. KILL is provided "as is" and the author makes no claims as to its
  58. suitability for any purpose.  The author cannot be held responsible for
  59. any damages consequential to the use of KILL.
  60.  
  61. (Bla, bla, bla...  You get the idea.)
  62.  
  63.  
  64. Known Bugs and Problems
  65. =======================
  66.  
  67. SIGINT and SIGBREAK, though they would appear to be implemented correctly
  68. (see the source code, kill.c) don't work on my system (Warp Connect,
  69. FixPak 17), returning SYS0205 (no signal handlers) errors regardless of
  70. the PID I specify.
  71.  
  72. I whipped it up in a night.  Yeah, there might be bugs...
  73.  
  74.  
  75. Distribution
  76. ============
  77.  
  78. KILL is public domain software.  The author forfeits all his copyrights
  79. to the code.  Clone it, modify it, do whatever you want with it, but you
  80. and you only are responsible for whatever damage you incur in doing so.
  81. :-)
  82.  
  83. If you're feeling nice, give me some acknowledgement, at least...
  84.  
  85.  
  86. Contacting the Author
  87. =====================
  88.  
  89. The author, Viet-Tam Luu, can be reached via Internet E-mail at
  90. vtluu@uwaterloo.ca .  His WWW home page can be found at URL
  91. http://www.csclub.uwaterloo.ca/u/vtluu/ .
  92.  
  93.