home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / go_15.zip / go.doc < prev    next >
Text File  |  1995-01-15  |  8KB  |  188 lines
  1.  
  2.  
  3.  
  4.                            ////////    ////////    //
  5.                          //           //      //   //
  6.                          //    ////   //      //   //
  7.                          //      //   //      //
  8.                           ////////     ////////    //
  9.  
  10.                              v1.5 -- January 1995
  11.  
  12.                          (c) 1993-95 by Carsten Wimmer
  13.  
  14.  
  15.  
  16.   Introduction:
  17.   ~~~~~~~~~~~~
  18.    Two years ago I began writing GO! to test some API calls.  Now, in 1995,
  19.    there have been added many new features.
  20.  
  21.    Many thanks to V. Phaniraj (phaniraj@badlands.nodak.edu) and
  22.    Rupa Schomaker (rupa@netcom.com) for their comments and bug reports.
  23.  
  24.    Also thanks to Kai Uwe Rommel for his informations about the undocumented
  25.    DosQProcStatus() call. They can be found on ftp.informatik.tu-muenchen.de
  26.    or ftp.cdrom.com.
  27.  
  28.  
  29.   What GO! can do:
  30.   ~~~~~~~~~~~~~~~
  31.    GO! is able to ...
  32.  
  33.       ... show a list of running processes
  34.       ... show a list of threads
  35.       ... show a list of used semaphores
  36.       ... show a list of shared memory handles
  37.       ... show a list of loaded modules
  38.       ... show the module dependency tree
  39.  
  40.    There are many other utilities that can show these lists as well.  But GO!
  41.    has some nice additional features when dealing with these lists.  See the
  42.    detailed help (command -lh) for more informations.
  43.  
  44.    You might be interested in some other features, such as ...
  45.  
  46.       ... killing processes
  47.       ... killing all instances of a program
  48.       ... checking whether a process is running or not
  49.       ... switching to other processes
  50.  
  51.    If this still isn't enough for you, you may ...
  52.  
  53.       ... query an application's type (PM, OS/2, VDM, 32 Bit etc.)
  54.       ... show your machine's uptime since last boot
  55.       ... show informations about your physical drives
  56.  
  57.  
  58.   Usage:
  59.   ~~~~~
  60.    GO! is easy to use, you can get a detailed help with the -lh command.
  61.    If you want only a short command overview, use -h.
  62.  
  63.    This is what -lh shows:
  64.  
  65.    -pl   Process List   This shows all processes that are currently running.
  66.                         The columns in the table are: Process ID, ID of
  67.                         Parent Process, Screen group and Session Type, Number
  68.                         of Threads, Priority, CPU Time (h:min:sec.msec), Name.
  69.  
  70.    -lpl  Process List   Same as -pl, but with complete path-names.
  71.          with Paths
  72.  
  73.    -tl   Thread List    The Thread List is a list of all running threads in
  74.                         the system. You may also supply the name of a process
  75.                         (with or without .EXE extension) or a Process-ID if
  76.                         you want the thread list for a specific process only.
  77.                         The columns are: Name of Owner, Thread ID, Thread,
  78.                         Slot ID, Priority, State, Block ID, System and User
  79.                         Time (h:min:sec.msec).
  80.  
  81.    -sl   Semaphore List This command shows all semaphores currently used
  82.                         in the system. It's columns are: Number of References,
  83.                         Number of Requests by its Owner, Flag, Thread owning
  84.                         this Semaphore, Index, Semaphore Name.
  85.  
  86.    -sm   Shared Memory  A list of Shared Memory Handles can be queried this
  87.                         way. The columns are: Handle, Selector, Size,
  88.                         Number of References, Name.
  89.  
  90.    -ml   Module List    This shows a list of used modules. The columns are:
  91.                         Module Handle, Type of Module, Number of Segments,
  92.                         Number of Imports, Name.
  93.  
  94.    -mt   Module         This is a good overview of all processes and modules
  95.          Dependency     and the modules they use themselves. The module
  96.          Tree           handles along with the names are shown. You may also
  97.                         supply a process or module name (.EXE, .DLL, .SYS
  98.                         etc.) or a Process-ID to get the tree for one specific
  99.                         module only.
  100.  
  101.    -k    Kill a         This closes a process, but only its first instance.
  102.          Process        It can be be specified either by its .EXE name or
  103.                         by its PID.
  104.  
  105.    -ka   Kill all       This closes all instances of a program which name
  106.          Instances      you supplied on the command line.
  107.  
  108.    -cp   Check for      The -cp command checks whether a specific process
  109.          Process        is running in the system or not. The following
  110.                         Errorlevels are returned: 0 - Process is not running.
  111.                                                   1 - Process is running.
  112.                         This feature is useful for batch files to check if
  113.                         a program should be started or not.
  114.  
  115.    -j    Jump to a      This is used to switch to another process. On the
  116.          Process        command line you may specify an .EXE name or a PID.
  117.  
  118.    -at   Application    This shows the type of an application, ie. if it is
  119.          Type           an OS/2 or DOS program, or if it is 32 Bit etc.
  120.                         Supply an .EXE, .DLL, .SYS etc. name as argument.
  121.  
  122.    -ut   Machine        This shows how long your machine is running since
  123.          Uptime         the last reboot. The format is:
  124.                              days hours minutes seconds milli-seconds
  125.  
  126.    -df   Drive Info     This shows information about your drives. The
  127.                         columns are: Drive, Label, Location (Local/Remote),
  128.                         Type (Harddrive/CD-Rom/etc), FileSystem (HPFS/FAT/etc),
  129.                         Size in MB, Free Space in MB, Used Space in %.
  130.  
  131.  
  132.   Return Codes:
  133.   ~~~~~~~~~~~~
  134.    GO! exits with a return code of 0 if everything is fine. But
  135.    sometimes GO! isn't able to determine the PID of a given exe-name
  136.    or to kill/switch-to a process. In these cases GO! exits with a
  137.    return code of 1 (Can't kill or switch to given Process ID) or
  138.    with a return code of 2 (Can't find Process ID for given exe-name).
  139.  
  140.    The -cp command (Check for Process) returns 0 if the process is not
  141.    running and 1 if it is.
  142.  
  143.    You can check for the return codes in your batch-file (using the IF and
  144.    the ERRORLEVEL statement) or in the prompt of 4OS2, if you have
  145.    installed 4OS2 and if you have put the errorlevel-macro in your shell
  146.    prompt. See your Commandline-Shell Manual or the 4OS2 documentation
  147.    for further details. Of course GO! shows an error-message on the screen
  148.    if anything went wrong.
  149.  
  150.  
  151.   Legal Disclaimer:
  152.   ~~~~~~~~~~~~~~~~
  153.    Permission is granted to any individual or institution to use, copy, or
  154.    redistribute this executable as long as it is not modified and that it
  155.    is not sold for profit.
  156.  
  157.    GO! and its associated utilities are provided AS IS and come with no
  158.    warranty of any kind, either expressed or implied. In no event will
  159.    the copyright holder be liable for any damages resulting from the use
  160.    of this software.
  161.  
  162.    This license agreement can also be shown via the -la command.
  163.  
  164.  
  165.   Registration:
  166.   ~~~~~~~~~~~~
  167.    GO! is neither Freeware nor Shareware.  It's Cardware.  If you use GO!
  168.    on a regular basis and like it, you have to send a picture postcard
  169.    from your location to the author.  His snail mail address is shown below.
  170.  
  171.  
  172.   Final Note:
  173.   ~~~~~~~~~~
  174.    If you want to contact me, write to cawim@train.oche.de !
  175.  
  176.    Comments, Bug-Reports and Feature-Requests are welcome.  Flames are not.
  177.  
  178.    Send any nice picture postcards to:
  179.  
  180.         Carsten Wimmer
  181.         Freunder Landstr. 53a
  182.         52078 Aachen
  183.         Germany
  184.  
  185.                                                                    See Ya!
  186.                                                                    Carsten
  187.  
  188.