home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / os2 / sosutl10.zip / README < prev    next >
Text File  |  1993-07-05  |  7KB  |  202 lines

  1. readme for SOS utilities 1.0 =========================================
  2.  
  3. Author:         Tommi Nieminen 4-Jul-1993
  4. E-mail to:      sktoni@kielo.uta.fi (Internet)
  5.  
  6. This package (sosutl10) should contain the following files:
  7.  
  8.     sostree.exe         Directory tree drawer
  9.     sostree.c           Source code for sostree (Borland C++ 1.0)
  10.     findfile.cmd        Find File utility written in REXX
  11.     ps.cmd              Process Status utility written in Perl
  12.     readme              This file
  13.  
  14. All these programs are public domain and intended to be free for every
  15. user of OS/2.
  16.  
  17. The rest of this file contains manual pages for each of the enclosed
  18. programs.
  19.  
  20. sostree --------------------------------------------------------------
  21.  
  22. Description
  23.  
  24.     SOS Tree - directory tree drawer for OS/2.
  25.  
  26. Usage
  27.  
  28.     [D:\] sostree [ -adfnqz ] PATH
  29.  
  30.     Options:
  31.  
  32.     -a      Display file attributes in the format "ADHRS"
  33.     -d      Display dates and times too (in current national format).
  34.     -f      Include plain files too in the listing.
  35.     -n      List all directories (or all files and directories with -f
  36.             option) with full path names; do not draw the tree graph.
  37.     -q      Don't display the "Directory tree of ..." header.
  38.     -z      Display file sizes too. This switch is meaningless if -f
  39.             isn't used simultaneously.
  40.  
  41. Note
  42.  
  43.     This program is public domain. Copyrights are there only to show
  44.     who first wrote this program.
  45.  
  46. Note of re-compiling
  47.  
  48.     SOS Tree should be distributed with full C source code included.
  49.     If you compile the program with LANG_SUOMI symbolic constant de-
  50.     fined, you get the Finnish version. It should also be easy to make
  51.     other-language versions of the program: just search (with grep or
  52.     such tool) for all instances of the string
  53.  
  54.         #if defined(LANG_SUOMI)
  55.  
  56.     and include your new language section after it. For example, to
  57.     make an Esperanto version of SOS Tree:
  58.  
  59.         #if defined(LANG_SUOMI)
  60.             /* Finnish messages */
  61.         #elif defined(LANG_ESPERANTO)
  62.             /* Esperanto messages */
  63.         #elif defined(LANG_xxxx)
  64.             /* ... */
  65.         #else
  66.             /* English messages */
  67.         #endif
  68.  
  69.     Symbolic constants can be defined in the bcc command line like
  70.     this:
  71.  
  72.         [D:\] bcc -DLANG_ESPERANTO sostree.c
  73.  
  74. Version
  75.  
  76.     SOS Tree v1.0 (C) SuperOscar Softwares, 1993.
  77.  
  78. findfile -------------------------------------------------------------
  79.  
  80. Description
  81.  
  82.     filefind - whereis-like find file utility written completely in
  83.     REXX.
  84.  
  85. Usage
  86.  
  87.     [D:\] filefind { [PATH\]FNAME ... | /? }
  88.  
  89.     filefind finds files under PATH if that is specified, or the
  90.     current directory (= '.') if it isn't. Multiple command line
  91.     arguments are allowed.
  92.  
  93. Examples
  94.  
  95.     [D:\os2] filefind *.inf
  96.         ; Finds all *.inf files under D:\os2
  97.     [D:\] filefind \os2\*.inf
  98.         ; Does the same as the preceding example
  99.     [D:\] filefind c:\bin\*.exe
  100.         ; Finds all *.exe files under C:\bin
  101.     [D:\] filefind usr\*.inf os2\*.inf
  102.         ; Finds all *.inf files under D:\usr and D:\os2
  103.  
  104. Note
  105.  
  106.     filefind displays file dates and times in the national format,
  107.     which is found with a SysIni() call to "os2.ini". However, this
  108.     seems to be causing troubles now and then--sometimes SysIni()
  109.     returns insane results, like '0' as the date or time separator.
  110.     IF YOU ARE HAVING PROBLEMS WITH THIS, remove all date and time
  111.     formatting lines from the program, and change the following
  112.     line:
  113.  
  114.         ok = SysFileTree(Word(find, i), files, "fst", "*--*-")
  115.  
  116.     to
  117.  
  118.         ok = SysFileTree(Word(find, i), files, "fs", "*--*-")
  119.  
  120.     filefind will then display dates and times in the American
  121.     formats (MM/DD/YY and HH:MM{am|pm}, respectively) which are
  122.     insane but work fine.
  123.  
  124. Version
  125.  
  126.     filefind.cmd v1.2
  127.     (C) SuperOscar Softwares, Tommi Nieminen 1993
  128.  
  129. ps -------------------------------------------------------------------
  130.  
  131. Description
  132.  
  133.     ps - display processes with their process id's (PID), parent
  134.     process id's (PPID), and session id's (SID).
  135.  
  136. Usage
  137.  
  138.     [D:\] ps
  139.  
  140.     ps output looks like this:
  141.  
  142.         PID   PPID  SID   PROCESS
  143.         0002  0001  0001  d:\os2\pmshell.exe
  144.         0025  0002  0022  d:\os2\viewdoc.exe
  145.         0008  0002  0004  d:\usr\bin\4os2\4os2.exe
  146.         0087  0008  0004  d:\usr\bin\unix\perl.exe
  147.         0088  0087  0004  d:\usr\bin\4os2\4os2.exe
  148.         0089  0088  0004  d:\os2\pstat.exe
  149.         0007  0002  0019  d:\usr\bin\itsnow.exe
  150.         0006  0002  0018  d:\usr\bin\pc2\pc2.exe
  151.         0005  0002  0017  d:\usr\bin\xfeel.exe
  152.         0004  0002  0016  d:\os2\pmshell.exe
  153.         0003  0002  0000  d:\os2\system\harderr.exe
  154.  
  155.     All the numeric values are decimals. If you want hexadecimals,
  156.     just remove all calls to hex() in ps.cmd.
  157.  
  158. System requirements
  159.  
  160.     ps is a Perl-utility and requires you to have Perl installed. Perl
  161.     is a programming language originally written for UNIX (how else?),
  162.     and it can be obtained in many FTP's and BBS's (I think, never
  163.     tried the latter). For example, in hobbes.nmsu.edu Perl can be
  164.     found in
  165.  
  166.         /os2/2_x/unix/program/perl*.zip
  167.  
  168.     (or something like that).
  169.  
  170.     Perl 4.0.1.7 patchlevel 35 was used in developing and testing this
  171.     program.
  172.  
  173.     ps calls the OS/2 utility PStat to obtain PID, PPID and SID info,
  174.     and re-formats the output to be more readable (or at least
  175.     shorter). PStat is a part of OS/2 Diagnostic Tools installation
  176.     option; if you don't have the file "pstat.exe" in your \OS2 dir-
  177.     ectory, use the Selective Install object in your System folder to
  178.     install it.
  179.  
  180. Notes
  181.  
  182.     (1) ps is a .cmd file that has "extproc" statement in the first
  183.         line of the file. PLEASE EDIT the path to perl.exe to point to
  184.         the correct directory. I have stored all UNIX-like utilities
  185.         to \usr\bin\UNIX, but you very probably haven't.
  186.     (2) Processes 87 ("perl.exe") and 88 ("4os2.exe") in the preceding
  187.         list are created by ps.cmd. It would be fairly easy to make
  188.         ps.cmd remove (a) the line that contains "perl.exe" (which is
  189.         the running ps process), (b) the line whose PPID is the PID of
  190.         "perl.exe" (this is a temporary shell created by the pipe
  191.         ps.cmd uses to get output from PStat), but I didn't think it
  192.         worth the trouble.
  193.  
  194. Version
  195.  
  196.     ps.cmd v3.0
  197.     (C) SuperOscar Softwares, Tommi Nieminen 1993
  198.  
  199. ---------------------------------------------------------------------
  200.  
  201. End of readme =======================================================
  202.