home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / CPROG / EMBED21.ZIP / EMBEDTXT.DOC next >
Text File  |  1991-12-20  |  6KB  |  133 lines
  1.                 Documentation for EMBEDTXT version 2.1
  2.  
  3.     What is EMBEDTXT?
  4.  
  5.     Embedtxt is a "C" programming technique for hiding text information
  6. within your program in such a way as to make it more difficult for "hackers"
  7. to alter it. Although Embedtxt is not fool-proof, it does provide a good
  8. way of protecting your programs from the normal attempts made by those who
  9. want to change your program, be it, copyright notices, configuration details,
  10. or whatever.
  11.  
  12.     How does EMBEDTXT work?
  13.  
  14.     The typical way in which programmers display information (such as a copy-
  15. right notice) is to use some form of the printf function. The problem with
  16. this method is that after you have compiled your program, this information
  17. is stored with the rest of your text information in the data segment of your
  18. program (typically at the bottom). Anyone who has access and knowledge of
  19. programs such as the Norton Utilities can easily find, display, and modify
  20. this information very quickly. The main reason is that this information is
  21. stored as literal text strings, and are easy to spot in the executable.
  22.  
  23.     After some tinkering, I found that if you store the the information we're
  24. talking about in a hex formatted structure, the string appears as a series of
  25. dots (".") in the executable, and thus, it is harder to find.
  26.  
  27.     Now this is all fine and well, but to go and manually convert all the
  28. characters in a string to hex, and then load them into a structure, is quite
  29. a headache to say the least. So I've developed this little program to do it
  30. for you.
  31.  
  32.     Why does EMBEDTXT exist?
  33.  
  34.     Well, it kinda' happened like this. Early in November 91 I was laid off
  35. from my job (the price you pay these days as an Engineer for military stuff),
  36. so I decided to take some time off (what else was I gonna' do?) and write a
  37. serious marketable application for, you guessed it, ENGINEERS. In the process
  38. of writing the application, I noticed my copyright notice, config. stuff, and
  39. other important stuff could be easily spotted in the executable. Needless to
  40. say, I immediately realized what could happen if this information were changed
  41. without my knowledge. The setup information would not only wreak havoc, but
  42. the integrity of my program would be compromised, so I set out to do something
  43. about it. WAH LA! You now have in your hands the fruit of my labor.
  44.  
  45.    What do you have to do to make EMBEDTXT work?
  46.  
  47.    All you need to do is put the information you want to embed into a text
  48. file and EMBEDTXT.EXE will do the rest.
  49.  
  50.    What exactly will EMBEDTXT do with my file?
  51.  
  52.    EMBEDTXT will create a file called EMBED.DAT that will contain all the C
  53. code necessary to include into your source code. Next, EMBEDTXT will optionally
  54. create a sample program with your information so you can compile it for yourself
  55. and see that it does indeed work as advertised. Once this file has been created,
  56. you can compile it with pretty much any C compiler and watch it work. The sample
  57. program will be called SAMPLE.C (you don't have a choice on this).
  58. Sound simple enough?
  59.  
  60.    What is the syntax for EMBEDTXT?
  61.  
  62.    Usage: EMBEDTXT your-text-file [N]
  63.    Where: - your-text-file is the file that contains the information you
  64.             wish to embed.
  65.           - The option [N] stands for NO, do not create a sample program
  66.             listing, just make EMBED.DAT. (Technically speaking, if "argc"
  67.             is greater than 2, EMBEDTXT will not create a sample file)
  68.  
  69.  
  70.    How much are you asking to use EMBEDTXT?
  71.  
  72.    Absolutely nothing!!! This program is free! However, there are no guaran-
  73. tees whatsoever concerning it's function or usefulness.
  74.  
  75.    Is EMBEDTXT public domain?
  76.  
  77.    NO! EMBEDTXT is copyrighted by myself (Leonard Broughton), and therefore
  78. cannot be claimed as your own personal intellectual property. You are free
  79. to use this program unconditionally, and distribute it in any way you see
  80. fit, provided that this documentation (EMBEDTXT.DOC) must accompany the
  81. executable program (EMBEDTXT.EXE) whenever it is shared or copied.
  82.  
  83.    So now what?
  84.  
  85.    Basically you have 3 options:
  86.    1. Do nothing, use the program without any reservations.
  87.    2. Send me a postcard that simply has the word EMBEDTXT on the back. I'm
  88.       interested in knowing how far this program will travel in the BBS world,
  89.       and don't worry if you're only 2 miles away from where I live, I'd still
  90.       like to get a postcard anyway. Hey, you're only talking about 5 minutes
  91.       of time and a stamp. I've already made the initiative by providing this
  92.       program, the least you could do is ackowledge that this program was of
  93.       some use to you.
  94.    3. You could be a nice Guy/Gal and post this program on a BBS other than
  95.       the one you obtained it from just to keep the thing moving.
  96.  
  97.    Is there anything else I should know?
  98.  
  99.    Yes, if for some reason you would like the source code to EMBEDTXT.EXE, I
  100. will provide it to you for $15.00. It's not that I think this is such an awesome
  101. program that the world is going to beat a path to my door to get this thing,
  102. but I thought I'd at least keep the option open for those who are interested.
  103. Send U.S. currency to the address listed below. Checks are fine, but I'd
  104. prefer cash (I hate waiting in line at the bank).
  105.  
  106.    And last but not least, I should mention that I have some reservations
  107. about the solution I've discovered via EMBEDTXT. For some reason I feel
  108. that this program is not clean or tricky enough, in some ways it smells like
  109. a kludge to me, but if you've come accross a better solution for this problem,
  110. I would definately be interested in hearing about it.
  111.  
  112.    I should also mention for those who suffer from VIRANOIA (Virus Paranoia),
  113. that I guarantee this program as originally sent by myself to any BBS is 100%
  114. virus free. I've often wondered that if someone is clever enough to write a
  115. virus to begin with, then why don't they use their talents in a more pro-
  116. fitable way and leave the rest of us alone. Is mental masturbation and the
  117. waste of innocent people's time and money all they have to live for?
  118.  
  119.  
  120.    Thanks for taking the time to download this file. I hope you find it
  121. useful in whatever you find it useful for. (Now there's a mouth full)
  122.  
  123.  
  124.  
  125. Send all inquiries to:
  126.  
  127. Leonard Broughton
  128. 3031 Camarillo Ave.
  129. Oceanside, Cal. 92056
  130.  
  131. P.S.
  132.  
  133.   If you put a slinky on an escalator, will it go anywhere? Think about it!