home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 316.lha / LookFor_v1.0 / LookFor.doc < prev    next >
Encoding:
Text File  |  1989-12-05  |  4.4 KB  |  107 lines
  1.  
  2.                             LookFor Version 1.0
  3.                        Copyright 1989 by Ray Lambert
  4.                            Created by Ray Lambert
  5.  
  6.  
  7.   LookFor is a grep-like utility which is used to locate strings of bytes in
  8. either text or binary files.  When a match is found the absolute binary file
  9. offset to the string is reported.  In text mode, a segment of the line which
  10. contains the matched string is displayed along with its approximate line
  11. number.  While grep may be more powerful in some ways, LookFor shines in its
  12. own way.  LookFor was written originally for use with binary files.  It has
  13. been enhanced since then to support text files as well.  It has a simpler
  14. interface than grep which is one reason you may like it.  Wildcard
  15. expressions are not required on search strings nor are they used.  All
  16. search strings are treated as thought they have a "*" wildcard (match all)
  17. on each end.  For example, LookFor will find the imbedded "int" in "printf".
  18.  
  19.  
  20.   LookFor works from the CLI only.  The first argument must be a search
  21. string.  The search string can be either ASCII or HEX.  An ASCII search
  22. string does not need to be enclosed in quotes unless it contains space
  23. character(s).  A HEX search string must be prefixed with the dollar sign
  24. character "$", which must in turn be followed by a series of two-digit
  25. hexadecimal numbers.  (The total number of digits must be divisible by two).
  26. No spaces are allowed between the digits.  (Incidentally, if an ASCII search
  27. string begins with the dollar sign character it must be enclosed in quotes
  28. to keep it from being interpreted as a HEX search string).  All arguments
  29. which follow must be either a file specification or a switch (option
  30. selector).
  31.  
  32.  
  33.   Each file specification may include either MS-DOS style or AmigaDOS style
  34. wildcard characters, and you may specify as many file specs as you wish.
  35. Each file spec must be seperated by a space and if any file spec contains a
  36. space it must be enclosed in quotes.
  37.  
  38.  
  39.   Switches may be intermixed between file specs.  The switches specified to
  40. the left of a file spec influence the search on all files which match it.
  41. All switches have two forms:  1) prefixed by a minus sign "-" turns the
  42. option "off" and 2) prefixed by a plus sign "+" turns the option "on".
  43. Following the prefix is a single letter which names the option.  The letter
  44. may be in either upper or lower case.  Currently there are two switches
  45. which are supported:
  46.  
  47.   I ::  Ignore case on/off ("+I" = on; "-I" = off).  Ignore case is "off" by
  48. default.  HEX searches are always case sensitive regardless of usage of this
  49. switch.
  50.  
  51.   T ::  Text mode on/off ("+T" = on; "-T" = off).  Text mode is "off" by
  52. default.  When text mode is "on", LookFor will display a fragment of the
  53. line containing the matched string and its approximate line number.
  54.  
  55.  
  56.                               Usage Examples:
  57.                               --------------
  58.  
  59.                          LookFor printf +t *.c *.h
  60.  
  61.                  LookFor AllocMem() +t +i auto.docs -i *.c
  62.  
  63.               LookFor "the bridge" +i +t "dh0:My Documents/*"
  64.  
  65.                              LookFor _text *.o
  66.  
  67.                        LookFor $04080408 program.exe
  68.  
  69.  
  70.  
  71.  
  72. Some legalease to bore you with...
  73.  
  74. LookFor is released by the author as FREEWARE.  That means the following:
  75.   1) LookFor is NOT commercial or ShareWare and you are NOT required to pay
  76. for it (although I'm not in the habit of refusing offers...  $^)
  77.   2) LookFor is NOT Public Domain - it CANNOT be sold for profit or used
  78. commercially without permission from the author
  79.   3) LookFor CAN be re-distributed freely in its original "ZOO" file with
  80. the full contents intact
  81.   4) LookFor CAN appear on user club or compilation diskettes for which a
  82. moderate duplication and/or media fee is charged - as long as the software
  83. itself is not charged for
  84.   5) If you enjoy tinkering with things like this you are welcome to make
  85. derivitive versions of LookFor and distribute them as long as credit is
  86. given were credit is due and as long as the same limitations are applied as
  87. put forth here (I would also very much like to see your atomic mods!).
  88.   6) The author is not responsible for damage resulting from the use or
  89. misuse of this program
  90.  
  91.  
  92. Lastly, if you would like to contact me with any comments, suggestions,
  93. questions, insect sightings, etc., etc., etc., you may do so at the
  94. following locals:
  95.  
  96. PLink:        Analog*Kid
  97.  
  98. U.S. Snail:   Ray Lambert
  99.               415 Sanford Road
  100.               Westport, Massachusetts  02790
  101.  
  102. Phone:        (508) 672-8232
  103.  
  104.  
  105.  
  106.  
  107.