MIMEFILE is an encode/decode program for MIME base 64 files, and is (c) Copyright 1995 by Francis L. Fitzpatrick. ALL RIGHTS RESERVED. What is MIMEFILE? ================= MIMEFILE is a very fast encode and decode program to convert any file to or from MIME base 64 format. This package contains executable software for the DOS, OS/2, Coherent (Unix clone), and BSD (386) Unix environments. MIMEFILE 30 Day Free Trial ========================== MIMEFILE software may be installed on the user's computer system for a 30 day trial without registration. After 30 calendar days from the installation date of this software, please register this package or delete it from the computer media. Failure to register this package places the user in violation of the license agreement. See the License Information and How to Register that follow for license and registration information. Why Use MIME Base 64 Format? ============================ Any file may be encoded as a MIME base 64 file, and then decoded back to the exact original file. This is useful for transfer of binary file types (executables, images, non-text types) between computer systems. Mime base 64 encoded files may be passed between systems as text files (even included in e-mail) and are not subject to data loss or data integrity problems, even when run through ASCII<->EBCDIC conversions (a uuencode weakness). A mime base 64 encoded file may be decoded safely back into the original binary format even if blanks and linefeeds have been altered. Unintentional truncation of blanks and linefeed format changes may occur when text files are viewed with an editor, or transferred across computer systems with differing hardware and operating system software. For more information on MIME, see THE INTERNET MESSAGE by Marshall T. Rose. What are the files in the MIMEFILE package? =========================================== README.1ST - This file, which contains all license, registration, and user information. MIMEFILE.TXT - A copy of README.1ST. MIMEFILE.EXE - The DOS environment executable. MIMEFILE.DOS - A copy of MIMEFILE.EXE MIMEFILE.OS2 - The OS/2 native executable. MIMEFILE.COH - The Coherent (Unix clone) native executable. MIMEFILE.BSD - The BSD Unix native executable. FILE_ID.DIZ - Brief Overview of MIMEFILE. DISTRIBU.TXT - Copy and distribution conditions and restrictions. How do I use MIMEFILE software? =============================== First, you need to use the correct executable for your environment. Copy or rename the executable as appropriate for the computer system which you are using. DOS and OS/2 users must place MIMEFILE in the current working directory or in a directory which is named by the environment PATH variable. MIMEFILE default mode is decode, file names may be identified as arguments during program initiation, or given as response to prompts. Encode is selected by -e option. The command line format of MIMEFILE is: MIMEFILE -e -d -txxx -h -l input_file_name output_file_name All parameters are optional. Options may be separated by blank space and preceded by "-" or "/", or may be concatenated with only one "-" or "/" preceding the option string. File names will be prompted if not given as arguments. The supported options are: -e (or E) Set encode mode. Source input file is read, and encoded in MIME base 64 format and written to the named output file as a MIME base 64 format file. The input file in unchanged. -d (or D) Set decode mode. Input file read, and decoded from MIME base 64 format and an exact replication of the original file prior to the MIME base 64 encoding is written to the named output file. This is the default option. -txxx (or T) output file extension is "xxx" and same name as input file name. Mutually exclusive with output file name as an argument. Up to three (3) characters are allowed for the file extension, and fewer than 3 characters will require this option to be placed at the end of a string of option characters. -l (or L) display license information. No conversion is done, this is a stand-alone option. -h (or H, ?) display help. No conversion is done, this is a stand-alone option. MIMEFILE License Information ============================ Use of this software implies consent to the following license agreement. Use of this software for purposes other than those permitted by the license agreement is a violation of United States federal law and international intellectual property law. The following license types are available: - Private Use of Executable, - Commercial Use of Executable, - Educational Institution Use of Executable, - Private Use of Source Code, - Commercial Use of Source Code, - Educational Institution Use of Source Code. License is granted to all private individuals, commercial organizations, and educational institutions to install the MIMEFILE software included in this package and use it for a trial period of thirty (30) calendar days from the installation date without registration. After 30 calendar days from the installation date of this software, please register this package or delete it from the computer media. Failure to register or delete this package after the trial period places the user in violation of the license agreement. Private Use of Executable License requires a registration fee of $5.00 (US Dollars), and grants the private use of MIMEFILE software on one machine in the user's environment. This license also includes the right to make backup copies. Commercial Use of Executable License requires a registration fee of $10.00 (USD) per installed machine with 1 to 5 users. (6 - 25 multi-user machine registration fee is $20.00 (USD), 26+ multi-user registration fee is $30.00 (USD).) This license grants the commercial use of MIMEFILE software on one machine in the user's environment and also includes the right to make backup copies. Site license for commercial use on single-user machines is available with the registration fee of $10.00 (USD) for the first machine and $2.00 for each additional single user machine. Educational Institution Use of Executable License requires a registration fee of $5.00 (USD) for the first single user machine, and $2.00 (USD) for each additional single user machine. For educational Institutions, the registration fees for MIMEFILE executable only on multi-user machines are as follows: 1 to 10 users - $10.00 (USD); 11 to 50 users - $20.00 (USD); 51+ users - $30.00 (USD). Source code license is available. MIMEFILE is written in ANSI C, and has been compiled and tested on IBM OS/2 2.1, MS DOS 5, Coherent 4.2 (Unix clone), and BSD (386) Unix. IBM, Microsoft, Borland, and GNU compilers have been used. Upon receipt of the source code registration fee, source code will be sent via US Mail or Internet e-mail if available to the licensee. Source sent by mail will be on a 3.5 inch floppy (diskette). Private Use of Source Code License grants the right to examine, modify, compile, and execute MIMEFILE code on one installed machine. Copies may be made for backup purposes only. Distribution is not allowed with the private use license of source code. The registration fee is $15.00 (USD) and includes registration of the executable. Commercial Use of Source Code License grants the right to examine, modify, compile, and execute MIMEFILE code on one installed machine. Copies may be made for backup purposes only. Distribution of the source code is not permitted. Registration for the commercial use of source code is $50.00 (USD) per installed machine. Holders of the license for commercial use of source code may distribute fully licensed executable code subject to the following: Distribution of either the original executable or a newly compiled executable based on MIMEFILE source code requires purchase of distribution rights for $2.00 (USD) per single user machine copy and $10.00 (USD) per multi-user machine copy. Educational Institution Use of Source Code License grants the right to examine, modify, compile, and execute MIMEFILE code on one installed machine. Copies may be made for backup purposes. Registration for the educational use of source code is $50.00 (USD) for the first machine. Copies for distribution of MIMEFILE software are subject to the following conditions: MIMEFILE source code may be distributed to staff and students attending a bona fide school or university for a registration fee of $10.00 (USD) for each copy. The recipient may examine, modify, compile, and execute the MIMEFILE code on one installed machine. The executable may NOT be re-distributed. Distribution of either the original executable or a newly compiled executable based on MIMEFILE source code requires the purchase of distribution rights for $2.00 (USD) per single user machine copy and $10.00 (USD) per multi-user machine copy. How to Register MIMEFILE ======================== ------------------------ cut here ----------------------------- To Register this software please send a check, money order, or financial institution draft (payable in United States Dollars) for the registration fee to: Frank Fitzpatrick 12507 Burlywood Trail Austin, Texas 78750-1106 USA Name:________________________________ Company:_______________________________ Address:_______________________________ _______________________________ _______________________________ _______________________________ Internet E-Mail Address:______________________________ Registration for License type (all prices in US Dollars): ( ) Private Use of Executable _____ installed machines at $5.00 each . . . . . . . . . ______ ( ) Commercial Use of Executable _____ installed machines with 1 to 5 users (@$10.00ea.) . ______ _____ installed machines with 6 to 25 users (@$20.00ea.) ______ _____ installed machines with 26+ users (@$30.00ea.) . . ______ _____ single-user installed machines Site License ($10.00 for the first machine and $2.00 for each additional) ______ ( ) Educational Institution Use of Executable _____ installed machines with 1 to 10 users (@$10.00ea.) ______ _____ installed machines with 11 to 50 users (@$20.00ea.) ______ _____ installed machines with 51+ users (@$30.00ea.) . . ______ _____ single-user installed machines Site License ($5.00 for the first machine and $2.00 for each additional) ______ ( ) Private Use of Source Code _____ installed machines at $15.00 each . . . . . . . . . ______ ( ) Commercial Use of Source Code _____ installed machines at $50.00 each . . . . . . . . . ______ _____ single-user copies of executable (@$2.00 ea.) . . . ______ _____ multi-user copies of executable (@$10.00 ea.) . . . ______ ( ) Educational Institution Use of Source Code _____ installed machines (@$50.00ea) . . . . . . . . . . ______ _____ copies of source code for staff/students (@$10.00ea.)______ (Please include a list of names and addresses) _____ single-user copies of executable (@$2.00 ea.) . . . ______ _____ multi-user copies of executable (@$10.00 ea.) . . . ______ Total Registration Fee . . . . . . . . . . . . . . . . . . . . ______ Return Mailing Fee (not needed if you have and included an Internet e-mail address is included) . . . $1.00 ======= Total amount enclosed (in US Dollars, no cash please) . . . . .$_______ Upon receipt of source code registration fee, I will send source code via US mail or Internet e-mail. If sent via US Mail, please indicate the preferred 3.5 inch media file format: DOS____ UNIX____ If sent via Internet, do you prefer ( ) MIMEFILE encoded e-mail, ( ) uuencoded e-mail, ( ) clear text (not encoded) e-mail, or ( ) FTP at address _____________________________________________________. (If FTP, please indicate login, password, and account if not annon.) ------------------------ cut here ----------------------------- Why Should I Register? ====================== 1. It is the right thing to do. 2. Doing otherwise violates state, federal, and international laws with respect to theft, fraud, and use of intellectual property. 3. Registration costs very little. 4. Registration encourages the author to make more low cost software available in this "Try it before you buy it" manner. 5. If you don't steal from stores or other people, why should you steal from me? Warranty Information ==================== There is no warranty. If a registered user has a problem with this software, that user may contact me for assistance. If a defect is found and reported by a registered user, I will make an effort to fix that defect. How to Contact Author ===================== The author of this package is Francis L. (Frank) Fitzpatrick. I may be contacted by Internet e-mail at , on Fidonet , or by snail mail at 12507 Burlywood Trail, Austin, Texas 78750-1106, USA. Bug Reports =========== Please report any problems found with this package to Frank Fitzpatrick. I may be contacted by Internet e-mail at , on Fidonet , or by snail mail at 12507 Burlywood Trail, Austin, Texas 78750-1106, USA. Please report the following information, and be as explicit as possible: Your Name and Address:__________________________________________________ __________________________________________________ __________________________________________________ __________________________________________________ __________________________________________________ Machine CPU type:_________ Date on MIMEFILE executable:__________ Operating System:_________ (DOS, OS/2, BSD Unix, Coherent, etc.) Operating System Version/Release:________ Where did you obtain the MIMEFILE software?: ________________________________________________________________________ Problem while ( ) Encoding to or ( ) Decoding from MIME base 64 format. Please describe the steps which lead to the problem: Please describe all failure symptoms (include any error messages and other machine output): Can you provide samples of the input and output files? GLOSSARY OF TERMS ================= Base 64: A numerical system different from the decimal base 10 system. Commercial Use: Use by any individual, corporate or other entity, including use of this product for purposes which are for profit. Decode: Extract information from a specific coded format. Educational Institution Use: Use by a bona fide school, college or university. Encode: To place information into a specific coded format. Executable: Program code which can be loaded and run in a computer system, a set of machine code instructions. Multi-user machine: A computer system which has more than one user. A LAN server, a mainframe computer system, and any computer system with multiple terminal devices attached are multi-user machines. Private Use: Any individual (personal) use of this product for purposes which are not-for-profit. Single-user machine: A computer system which can have only one user at any given point in time. For the purposes of the MIMEFILE license agreement, this includes a computer system with a single keyboard and monitor attached and not used as a network server device and which is located in a common area and shared among more than one user, but only accessed by one user at any given point in time.