home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / mimefile.zip / MIMEFILE.TXT < prev    next >
Text File  |  1995-03-13  |  16KB  |  375 lines
  1. MIMEFILE is an encode/decode program for MIME base 64 files, and is (c)
  2. Copyright 1995 by Francis L. Fitzpatrick.  ALL RIGHTS RESERVED.
  3.  
  4. What is MIMEFILE?
  5. =================
  6. MIMEFILE is a very fast encode and decode program to convert any file to
  7. or from MIME base 64 format.  This package contains executable software
  8. for the DOS, OS/2, Coherent (Unix clone), and BSD (386) Unix
  9. environments.
  10.  
  11. MIMEFILE 30 Day Free Trial
  12. ==========================
  13. MIMEFILE software may be installed on the user's computer system for a
  14. 30 day trial without registration.  After 30 calendar days from the
  15. installation date of this software, please register this package or
  16. delete it from the computer media.  Failure to register this package
  17. places the user in violation of the license agreement.
  18.  
  19. See the License Information and How to Register that follow for license
  20. and registration information.
  21.  
  22. Why Use MIME Base 64 Format?
  23. ============================
  24. Any file may be encoded as a MIME base 64 file, and then decoded back to
  25. the exact original file.  This is useful for transfer of binary file
  26. types (executables, images, non-text types) between computer systems.
  27. Mime base 64 encoded files may be passed between systems as text files
  28. (even included in e-mail) and are not subject to data loss or data
  29. integrity problems, even when run through ASCII<->EBCDIC conversions (a
  30. uuencode weakness).  A mime base 64 encoded file may be decoded safely
  31. back into the original binary format even if blanks and linefeeds have
  32. been altered.  Unintentional truncation of blanks and linefeed format
  33. changes may occur when text files are viewed with an editor, or
  34. transferred across computer systems with differing hardware and
  35. operating system software.
  36.  
  37. For more information on MIME, see THE INTERNET MESSAGE by Marshall T.
  38. Rose.
  39.  
  40. What are the files in the MIMEFILE package?
  41. ===========================================
  42. README.1ST - This file, which contains all license, registration, and
  43.              user information.
  44. MIMEFILE.TXT - A copy of README.1ST.
  45. MIMEFILE.EXE - The DOS environment executable.
  46. MIMEFILE.DOS - A copy of MIMEFILE.EXE
  47. MIMEFILE.OS2 - The OS/2 native executable.
  48. MIMEFILE.COH - The Coherent (Unix clone) native executable.
  49. MIMEFILE.BSD - The BSD Unix native executable.
  50. FILE_ID.DIZ - Brief Overview of MIMEFILE.
  51. DISTRIBU.TXT - Copy and distribution conditions and restrictions.
  52.  
  53. How do I use MIMEFILE software?
  54. ===============================
  55. First, you need to use the correct executable for your environment.  
  56. Copy or rename the executable as appropriate for the computer system 
  57. which you are using.  DOS and OS/2 users must place MIMEFILE in the 
  58. current working directory or in a directory which is named by the 
  59. environment PATH variable.
  60.  
  61. MIMEFILE default mode is decode, file names may be identified as
  62. arguments during program initiation, or given as response to prompts.
  63. Encode is selected by -e option.
  64.  
  65. The command line format of MIMEFILE is:
  66.  
  67.   MIMEFILE -e -d -txxx -h -l input_file_name output_file_name
  68.  
  69. All parameters are optional.  Options may be separated by blank space
  70. and preceded by "-" or "/", or may be concatenated with only one "-" or
  71. "/" preceding the option string.  File names will be prompted if not
  72. given as arguments.  The supported options are:
  73.  
  74.  -e (or E) Set encode mode.  Source input file is read, and encoded in
  75.     MIME base 64 format and written to the named output file as a MIME
  76.     base 64 format file.  The input file in unchanged.
  77.  
  78.  -d (or D) Set decode mode.  Input file read, and decoded from MIME
  79.     base 64 format and an exact replication of the original file prior
  80.     to the MIME base 64 encoding is written to the named output file.
  81.     This is the default option.
  82.  
  83.  -txxx (or T) output file extension is "xxx" and same name as input file
  84.     name.  Mutually exclusive with output file name as an argument. Up
  85.     to three (3) characters are allowed for the file extension, and
  86.     fewer than 3 characters will require this option to be placed at the
  87.     end of a string of option characters.
  88.  
  89.  -l (or L) display license information.  No conversion is done, this is
  90.     a stand-alone option.
  91.  
  92.  -h (or H, ?) display help.  No conversion is done, this is a
  93.     stand-alone option.
  94.  
  95. MIMEFILE License Information
  96. ============================
  97.  
  98. Use of this software implies consent to the following license agreement.
  99. Use of this software for purposes other than those permitted by the
  100. license agreement is a violation of United States federal law and
  101. international intellectual property law.
  102.  
  103. The following license types are available:
  104.  - Private Use of Executable,
  105.  - Commercial Use of Executable,
  106.  - Educational Institution Use of Executable,
  107.  - Private Use of Source Code,
  108.  - Commercial Use of Source Code,
  109.  - Educational Institution Use of Source Code.
  110.  
  111. License is granted to all private individuals, commercial organizations,
  112. and educational institutions to install the MIMEFILE software included
  113. in this package and use it for a trial period of thirty (30) calendar
  114. days from the installation date without registration.  After 30 calendar
  115. days from the installation date of this software, please register this
  116. package or delete it from the computer media.  Failure to register
  117. or delete this package after the trial period places the user in
  118. violation of the license agreement.
  119.  
  120. Private Use of Executable License requires a registration fee of $5.00
  121. (US Dollars), and grants the private use of MIMEFILE software on one
  122. machine in the user's environment.  This license also includes the right
  123. to make backup copies.
  124.  
  125. Commercial Use of Executable License requires a registration fee of 
  126. $10.00 (USD) per installed machine with 1 to 5 users.  (6 - 25 
  127. multi-user machine registration fee is $20.00 (USD), 26+ multi-user 
  128. registration fee is $30.00 (USD).)  This license grants the commercial 
  129. use of MIMEFILE software on one machine in the user's environment and 
  130. also includes the right to make backup copies.  Site license for 
  131. commercial use on single-user machines is available with the 
  132. registration fee of $10.00 (USD) for the first machine and $2.00 for 
  133. each additional single user machine.  
  134.  
  135. Educational Institution Use of Executable License requires a
  136. registration fee of $5.00 (USD) for the first single user machine, and
  137. $2.00 (USD) for each additional single user machine.  For educational
  138. Institutions, the registration fees for MIMEFILE executable only on
  139. multi-user machines are as follows:  1 to 10 users - $10.00 (USD); 11 to
  140. 50 users - $20.00 (USD); 51+ users - $30.00 (USD).
  141.  
  142. Source code license is available.  MIMEFILE is written in ANSI C, and
  143. has been compiled and tested on IBM OS/2 2.1, MS DOS 5, Coherent 4.2
  144. (Unix clone), and BSD (386) Unix.  IBM, Microsoft, Borland, and GNU
  145. compilers have been used.  Upon receipt of the source code registration
  146. fee, source code will be sent via US Mail or Internet e-mail if
  147. available to the licensee.  Source sent by mail will be on a 3.5 inch
  148. floppy (diskette).
  149.  
  150. Private Use of Source Code License grants the right to examine, modify,
  151. compile, and execute MIMEFILE code on one installed machine.  Copies may
  152. be made for backup purposes only.  Distribution is not allowed with the
  153. private use license of source code.  The registration fee is $15.00
  154. (USD) and includes registration of the executable.
  155.  
  156. Commercial Use of Source Code License grants the right to examine,
  157. modify, compile, and execute MIMEFILE code on one installed machine.
  158. Copies may be made for backup purposes only.  Distribution of the source
  159. code is not permitted.  Registration for the commercial use of source
  160. code is $50.00 (USD) per installed machine.  Holders of the license for
  161. commercial use of source code may distribute fully licensed executable
  162. code subject to the following:  Distribution of either the original
  163. executable or a newly compiled executable based on MIMEFILE source code
  164. requires purchase of distribution rights for $2.00 (USD) per single user
  165. machine copy and $10.00 (USD) per multi-user machine copy.
  166.  
  167. Educational Institution Use of Source Code License grants the right to
  168. examine, modify, compile, and execute MIMEFILE code on one installed
  169. machine.  Copies may be made for backup purposes.  Registration for the
  170. educational use of source code is $50.00 (USD) for the first machine.
  171. Copies for distribution of MIMEFILE software are subject to the
  172. following conditions:  MIMEFILE source code may be distributed to staff
  173. and students attending a bona fide school or university for a
  174. registration fee of $10.00 (USD) for each copy.  The recipient may
  175. examine, modify, compile, and execute the MIMEFILE code on one installed
  176. machine.  The executable may NOT be re-distributed.  Distribution of
  177. either the original executable or a newly compiled executable based on
  178. MIMEFILE source code requires the purchase of distribution rights for
  179. $2.00 (USD) per single user machine copy and $10.00 (USD) per multi-user
  180. machine copy.
  181.  
  182. How to Register MIMEFILE
  183. ========================
  184.  
  185. ------------------------ cut here -----------------------------
  186.  
  187. To Register this software please send a check, money order, or financial
  188. institution draft (payable in United States Dollars) for the registration
  189. fee to:
  190.  
  191. Frank Fitzpatrick
  192. 12507 Burlywood Trail
  193. Austin, Texas  78750-1106
  194. USA
  195.  
  196. Name:________________________________
  197.  
  198. Company:_______________________________
  199.  
  200. Address:_______________________________
  201.  
  202.         _______________________________
  203.  
  204.         _______________________________
  205.  
  206.         _______________________________
  207.  
  208. Internet E-Mail Address:______________________________
  209.  
  210. Registration for License type (all prices in US Dollars):
  211.   ( ) Private Use of Executable
  212.       _____ installed machines at $5.00 each  . . . . . . . . .  ______
  213.   ( ) Commercial Use of Executable
  214.       _____ installed machines with 1 to 5 users (@$10.00ea.) .  ______
  215.       _____ installed machines with 6 to 25 users (@$20.00ea.)   ______
  216.       _____ installed machines with 26+ users (@$30.00ea.)  . .  ______
  217.       _____ single-user installed machines Site License ($10.00
  218.             for the first machine and $2.00 for each additional) ______
  219.   ( ) Educational Institution Use of Executable
  220.       _____ installed machines with 1 to 10 users (@$10.00ea.)   ______
  221.       _____ installed machines with 11 to 50 users (@$20.00ea.)  ______
  222.       _____ installed machines with 51+ users (@$30.00ea.)  . .  ______
  223.       _____ single-user installed machines Site License ($5.00
  224.             for the first machine and $2.00 for each additional) ______
  225.  
  226.   ( ) Private Use of Source Code
  227.       _____ installed machines at $15.00 each . . . . . . . . .  ______
  228.   ( ) Commercial Use of Source Code
  229.       _____ installed machines at $50.00 each . . . . . . . . .  ______
  230.       _____ single-user copies of executable (@$2.00 ea.) . . .  ______
  231.       _____ multi-user copies of executable (@$10.00 ea.) . . .  ______
  232.   ( ) Educational Institution Use of Source Code
  233.       _____ installed machines (@$50.00ea)  . . . . . . . . . .  ______
  234.       _____ copies of source code for staff/students (@$10.00ea.)______
  235.             (Please include a list of names and addresses)
  236.       _____ single-user copies of executable (@$2.00 ea.) . . .  ______
  237.       _____ multi-user copies of executable (@$10.00 ea.) . . .  ______
  238.  
  239. Total Registration Fee  . . . . . . . . . . . . . . . . . . . .  ______
  240.  
  241. Return Mailing Fee (not needed if you have and included an
  242.                     Internet e-mail address is included)  . . .   $1.00
  243.                                                                 =======
  244.  
  245. Total amount enclosed (in US Dollars, no cash please) . . . . .$_______
  246.  
  247. Upon receipt of source code registration fee, I will send source code
  248. via US mail or Internet e-mail.  If sent via US Mail, please indicate
  249. the preferred 3.5 inch media file format: DOS____   UNIX____
  250. If sent via Internet, do you prefer ( ) MIMEFILE encoded e-mail,
  251. ( ) uuencoded e-mail, ( ) clear text (not encoded) e-mail, or ( ) FTP
  252. at address _____________________________________________________.
  253. (If FTP, please indicate login, password, and account if not annon.)
  254.  
  255. ------------------------ cut here -----------------------------
  256.  
  257. Why Should I Register?
  258. ======================
  259.  
  260. 1. It is the right thing to do.
  261.  
  262. 2. Doing otherwise violates state, federal, and international laws with
  263.    respect to theft, fraud, and use of intellectual property.
  264.  
  265. 3. Registration costs very little.
  266.  
  267. 4. Registration encourages the author to make more low cost software
  268.    available in this "Try it before you buy it" manner.
  269.  
  270. 5. If you don't steal from stores or other people, why should you steal
  271.    from me?
  272.  
  273.  
  274. Warranty Information
  275. ====================
  276. There is no warranty.  If a registered user has a problem with this
  277. software, that user may contact me for assistance.  If a defect is
  278. found and reported by a registered user, I will make an effort to fix
  279. that defect.
  280.  
  281. How to Contact Author
  282. =====================
  283. The author of this package is Francis L. (Frank) Fitzpatrick.  I may be 
  284. contacted by Internet e-mail at <ffitz@bga.com>, on Fidonet <Frank 
  285. Fitzpatrick at 1:382/1201>, or by snail mail at 12507 Burlywood Trail, 
  286. Austin, Texas 78750-1106, USA.  
  287.  
  288. Bug Reports
  289. ===========
  290. Please report any problems found with this package to Frank Fitzpatrick.  
  291. I may be contacted by Internet e-mail at <ffitz@bga.com>, on Fidonet 
  292. <Frank Fitzpatrick at 1:382/1201>, or by snail mail at 12507 Burlywood 
  293. Trail, Austin, Texas 78750-1106, USA.  
  294.  
  295. Please report the following information, and be as explicit as possible:
  296.  
  297. Your Name and Address:__________________________________________________
  298.  
  299.                       __________________________________________________
  300.  
  301.                       __________________________________________________
  302.  
  303.                       __________________________________________________
  304.  
  305.                       __________________________________________________
  306.  
  307.  
  308. Machine CPU type:_________        Date on MIMEFILE executable:__________
  309.  
  310. Operating System:_________ (DOS, OS/2, BSD Unix, Coherent, etc.)
  311.  
  312. Operating System Version/Release:________
  313.  
  314. Where did you obtain the MIMEFILE software?:
  315.  
  316. ________________________________________________________________________
  317.  
  318. Problem while ( ) Encoding to or ( ) Decoding from MIME base 64 format.
  319.  
  320. Please describe the steps which lead to the problem:
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329. Please describe all failure symptoms (include any error messages and
  330. other machine output):
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340. Can you provide samples of the input and output files?
  341.  
  342.  
  343.  
  344.  
  345. GLOSSARY OF TERMS
  346. =================
  347. Base 64: A numerical system different from the decimal base 10 system.
  348.  
  349. Commercial Use: Use by any individual, corporate or other entity, 
  350. including use of this product for purposes which are for profit.
  351.  
  352. Decode: Extract information from a specific coded format.
  353.  
  354. Educational Institution Use: Use by a bona fide school, college or
  355. university.
  356.  
  357. Encode: To place information into a specific coded format.
  358.  
  359. Executable: Program code which can be loaded and run in a computer 
  360. system, a set of machine code instructions.
  361.  
  362. Multi-user machine:  A computer system which has more than one user.  A 
  363. LAN server, a mainframe computer system, and any computer system with 
  364. multiple terminal devices attached are multi-user machines.  
  365.  
  366. Private Use: Any individual (personal) use of this product for purposes
  367. which are not-for-profit.
  368.  
  369. Single-user machine:  A computer system which can have only one user at 
  370. any given point in time.  For the purposes of the MIMEFILE license 
  371. agreement, this includes a computer system with a single keyboard and 
  372. monitor attached and not used as a network server device and which is 
  373. located in a common area and shared among more than one user, but only 
  374. accessed by one user at any given point in time.  
  375.