home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / STRINGS2.ZIP / ReadMe next >
Text File  |  1992-07-02  |  4KB  |  121 lines
  1. STRINGS.EXE  (copyright 1992, P. Takis Skagos)
  2. ===========
  3.  
  4.   This is an OS/2 32 bit application compiled with the GNU C (GCC) 2.1
  5. compiler.  This program has been tested with OS/2 2.0 and is generally
  6. bug free.  If any problems or questions arise, I can be contacted through
  7. the net 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.  
  40.  
  41. USAGE
  42. =====
  43.  
  44.   It's use is fairly straight forward.  Here is a useless example:
  45.  
  46. [e:\]strings -h
  47. STRINGS.EXE v 2.1
  48. Copyright (1992) by P. Takis Skagos
  49. Usage: strings [-hop[0]] [-n] file1 file2 ... filen
  50.        h  - show help (this message)
  51.        o  - show the offset of the string in the file
  52.        p  - pad the offset with spaces
  53.        p0 - pad the offset with zeroes
  54.        n  - is the minimum string width
  55.        --
  56.        maximum string length is 1024 bytes
  57.  
  58.  
  59.   The '-h' option simply prints out the above help message.  The help
  60. message will also be displayed if you execute the program without any
  61. options or filename at all.
  62.  
  63.   The '-o' option will display the offset of the string in the file.
  64. The offset is displayed in hexadecimal.
  65.  
  66.   The '-p' option is only useful when used with the '-o' option.  This
  67. option pads the offset with either zeroes (0's) or spaces.  To pad the
  68. offset with 0's, use '-p0' but to pad with spaces just use '-p'.
  69.  
  70.   The '-n' option specifies the minimum length of the string to search
  71. for, where 'n' is a number.  The default value for 'n' is 3.  The
  72. maximum string length is 1024 bytes.  This option should be specified as
  73. the last option or a separate option all together.  For example, if n = 4
  74. you should do something like:
  75.    strings -op4 filename
  76. or as a separate option
  77.    strings -4 -op filename
  78.  
  79. BUGS
  80. ====
  81. ■ When trying to do 'strings strings.exe' you are greeted with the
  82.   following message:
  83.  
  84.      strings: file `strings.exe' not found
  85.  
  86.   Actually, when you execute 'strings' on any file that is otherwise in
  87.   use, then you get a similar error message.  This, as far as I can tell,
  88.   is a problem with GCC's implementation of the fopen() function -- when
  89.   a file is marked as being in use (or locked????), fopen() will report
  90.   that it cannot find it.
  91.  
  92. ■ This isn't really a bug, but some people have complained that the
  93.   maximum length of the search string should be > than 1024 bytes.  Well,
  94.   this is long enough for now.  If it gets to be a roadblock, I'll change
  95.   it in a revision.
  96.  
  97. NOTES
  98. =====
  99. Written by:    Panagiotis Takis Skagos
  100.  
  101. Version 1.0:   Jan 20, 1990
  102.   DOS program written with Turbo C.
  103.  
  104. Version 1.1:   Jan 13, 1992
  105.   DOS program written with Turbo C.
  106.     ■ added '-n' option
  107.  
  108. Version 2.0:   May 20, 1992
  109.   OS/2 program written with GCC 2.1.
  110.     ■ complete rewrite of strings
  111.  
  112. Version 2.1:   July 1, 1992
  113.   OS/2 program written with GCC 2.1.
  114.     ■ complete rewrite of strings 2.0 to provide for better
  115.       portability (got rid of the low-level read/open/close and
  116.       used the nicer stream functions)
  117.     ■ added '-h' '-o' and '-p[0]' command line parameters
  118.     ■ added capability to work on multiple files
  119.  
  120.  
  121.