home *** CD-ROM | disk | FTP | other *** search
/ Dr. CD ROM (Annual Premium Edition) / premium.zip / premium / IBMOS2_2 / STRINGS.ZIP / ReadMe next >
Text File  |  1993-06-24  |  4KB  |  124 lines
  1. STRINGS.EXE  (copyright 1992-93 P. Takis Skagos)
  2. ===========
  3.  
  4.   This is an OS/2 32 bit application compiled written in C for OS/2 2.x.
  5. This program has been tested with OS/2 2.0 and is generally bug free.  If
  6. any problems or questions arise, I can be contacted through the internet,
  7. Fido Mail, or Snail-Mail as outlined below.
  8.  
  9.   This program will search through specified files and print out
  10. the strings contained in those files.  Specifically, this program is
  11. useful for finding the printable strings in binary files, although
  12. there's nothing stopping you if you want to use it on any sort of
  13. text files (for whatever reasons you might have to do that).
  14.  
  15.   Oh yeah, this program is HPFS aware.  Nifty stuff.
  16.  
  17.   This program is made available for use by anyone who wants to use it.
  18. There is no guarantee or anything that comes along with it.  Use it at
  19. your own risk, in other words.
  20.  
  21.   There is no charge for this program at all.  If you'd like to, you
  22. can send me a postcard or something (with an interesting stamp on it)
  23. or if it you want to, you can send however much money makes you
  24. happy.  You can freely copy and distribute this program as long as
  25. you keep this  file with it and don't modify either this file
  26. or the executible.
  27.  
  28.   If you've got any problems with this program or anything, just drop
  29. me a note of somekind.  Here is how I can be reached:
  30.  
  31. Mailing Address:    P. Takis Skagos
  32.             3438 Keohan Cr.
  33.             Regina, SK
  34.             S4V 1J5
  35.             Canada
  36.  
  37. Internet:        skagos@hercules.cs.uregina.ca.
  38.  
  39. Fido Net:        The Holistic BBS (306)789-9909
  40.                         1:140/96 (send mail to "Takis Skagos")
  41.  
  42.  
  43. USAGE
  44. =====
  45.  
  46.   It's use is fairly straight forward.  Here is a useless example:
  47.  
  48. [e:\]strings -h
  49. STRINGS.EXE v 2.3
  50. (C) by P. Takis Skagos
  51. Usage: strings [-hop[0]] [-n] file1 file2 ... filen
  52.        h  - show help (this message)
  53.        o  - show the offset of the string in the file
  54.        p  - pad the offset with spaces
  55.        p0 - pad the offset with zeroes
  56.        n  - is the minimum string width
  57.        --
  58.        maximum string length is 1024 bytes
  59.  
  60.  
  61.   The '-h' option simply prints out the above help message.  The help
  62. message will also be displayed if you execute the program without any
  63. options or filename at all.
  64.  
  65.   The '-o' option will display the offset of the string in the file.
  66. The offset is displayed in hexadecimal.
  67.  
  68.   The '-p' option is only useful when used with the '-o' option.  This
  69. option pads the offset with either zeroes (0's) or spaces.  To pad the
  70. offset with 0's, use '-p0' but to pad with spaces just use '-p'.
  71.  
  72.   The '-n' option specifies the minimum length of the string to search
  73. for, where 'n' is a number.  The default value for 'n' is 3.  The
  74. maximum string length is 1024 bytes.  This option should be specified as
  75. the last option or a separate option all together.  For example, if n = 4
  76. you should do something like:
  77.    strings -op4 filename
  78. or as a separate option
  79.    strings -4 -op filename
  80.  
  81. BUGS
  82. ====
  83.  
  84. ■ This isn't really a bug, but some people have complained that the
  85.   maximum length of the search string should be > than 1024 bytes.  Well,
  86.   this is long enough for now.  If it gets to be a roadblock, I'll change
  87.   it in a revision.
  88.  
  89. NOTES
  90. =====
  91. Written by:    Panagiotis Takis Skagos
  92.  
  93. Version 1.0:   Jan 20, 1990
  94.   DOS program written with Turbo C.
  95.  
  96. Version 1.1:   Jan 13, 1992
  97.   DOS program written with Turbo C.
  98.     ■ added '-n' option
  99.  
  100. Version 2.0:   May 20, 1992
  101.   OS/2 program written with GCC 2.1.
  102.     ■ complete rewrite of strings
  103.  
  104. Version 2.1:   July 1, 1992
  105.   OS/2 program written with GCC 2.1.
  106.     ■ complete rewrite of strings 2.0 to provide for better
  107.       portability (got rid of the low-level read/open/close and
  108.       used the nicer stream functions)
  109.     ■ added '-h' '-o' and '-p[0]' command line parameters
  110.     ■ added capability to work on multiple files
  111.  
  112. Version 2.2:   June 13, 1993
  113.   OS/2 program compiled with BC++ 1.0 for OS/2
  114.     ■ simple re-compile with BC++ for OS/2
  115.     ■ BC++ doesn't have the problem that GCC did with reading a locked
  116.       file ... so you can actually execute 'strings.exe' on itself or
  117.       any other file that is locked or otherwise in use
  118.  
  119. Version 2.2:   June 13, 1993
  120.   OS/2 program compiled with BC++ 1.0 for OS/2
  121.     ■ modified to run faster (BC++ produced a slower executible than
  122.       GCC did, but the changes make the BC++ version run slightly faster
  123.       than V 2.1)
  124.