CD Shareware Magazine 1996 December

home *** CD-ROM | disk | FTP | other *** search

/ CD Shareware Magazine 1996 December / CD_shareware_12-96.iso / WIN / INTERNET / TID-V20.ZIP / TID.DOC < prev next >

Wrap

Text File | 1996-08-08 | 16.6 KB | 427 lines

─┼─────────────────────────────┼─ │ [T]HE [I]NTERNET [D]ECODER │ ┼─────────────────────────────┼ ├───────■ Version 2.0 ■───────┤ ─┼─────────────────────────────┼─ (c) 1995-96 by Alexander Curth - All Rights Reserved [ 1.] Introduction [ 2.] Requirements [ 3.] Features [ 4.] Installation [ 5.] Usage / Usage in Crosspoint [ 6.] Registering TID [ 7.] Disclaimer [ 8.] Copyright [ 9.] Trademarks [10.] Bugreports, Errors & Problems [11.] PGP-KEY of the Author [12.] Errorlevels / Usage in batch Programs [13.] Support-BBS [ 1.] INTRODUCTION TO [T]HE [I]NTERNET [D]ECODER (TID) ────────────────────────────────────────────────────── TID was especially designed to decode LARGE buffers that contain lots of encoded Binaries you can recieve via the Internet! Most Pointprograms and Newsreaders are able to decode Binaries, but the decoding routines are often not complete or not userfriendly or they have problems to decode multi-part files etc., so I had to write my own Decoder and here is the result! The largest buffer I have tested so far had a size of 100 MB and TID had no problems to decode all binaries out of it! So if you use TID you should have an original USENET-Buffer (including Subjectlines etc.) or a Buffer in ZCONNECT-Format (Crosspoint, etc.) and you will get best results. TID is SHAREWARE that means you have to register it, if you use it after a trial time of 30 days - Thanks! IMPORTANT NOTE: ─────────────── The Bufferfile has to be in standard PC-TEXT-MODE, that means that each line has to end with $0D0A !!! (Exception: Crosspoint-Binaries Files) So PLEASE make sure that your Bufferfiles are in PC-TEXT-MODE, otherwise TID will decode nothing... THIS IS NOT A BUG! Solution: 1) Convert the Bufferfile with an Editor etc. to PC-TEXT-MODE! (Load the Bufferfile into an Editor and then save it. This should help!) 2) If there are enough Requests of REGISTERED users, I will change this behaviour in one of the future Versions... it's up to you! [ 2.] REQUIREMENTS: ─────────────────── - PC (compatible) running MS-DOS (compatible) - 286 or higher Processor - 400KB (or more) free Basemem * CJPEG.EXE if you want to convert .GIF etc. to .JPG - OPTIONAL: PKUNZIP.EXE, LHA.EXE, ARJ.EXE, GZIP.EXE and RAR.EXE to test archive-integrity (Download them from any FTP-Server or your local BBS, if you don't have them) - A valid TEMP environment variable I recommend a ramdisk to speed up the decoding! (*NOT* for XP-Users!!!) NOTE: -> CROSSPOINT USERS SHOULD READ THE SECTION [ 5.] TID HAS BEEN TESTED WITH: ───────────────────────── Program │ Version ────────────┼────────────────────────────── MS-DOS │ V6.22 & V7.00 (WINDOWS 95) CROSSPOINT │ V3.11 F-PROT │ V2.22 PKUNZIP │ V2.04g ARJ │ V2.50a LHA │ V2.55b RAR │ V2.00 GZIP │ V1.2.4 CJPEG │ V?.?? (don't know... no Version given!?); [ 3.] FEATURES: ─────────────── - Supports UUE, XXE & BASE64 Decoding - Decodes VERY LARGE Buffers (nearly no limit, depends on your Disk-Space) - Fast (ASM) Decoding-Routines (not optimized, yet!) - Supports automatic & 'intelligent' Errorfixing - 100% Crosspoint(XP) compatible - Extracts Crosspoint(XP)-Binaries - Logfile for Crosspoint(XP) - Decoding handles single files and multi-part files (EVEN IF THEY ARE RECIEVED NOT IN THE CORRECT ORDER) - Supports Error-Descriptions (Enables you to check what went wrong...) - Supports automatic detection & renaming of duplicate Files * Supports automatic conversion of .GFX to .JPG (requires CJPEG) - Supports automatic testing of ZIP, ARJ, RAR, LZH/LHA, Z archives - Supports automatic Virusscanning of executeable files (requires F-PROT) - Supports Signature-check for: .JPG.GIF.ZIP.ARJ.MPG.BMP.EXE.VOC.Z.MID.XM.TIF-Files * Supports automatic testing of JPG pictures * Supports automatic deletion of identical duplicate Files (CRC-32 based) - 'Nice' Statusscreen (; * Support of sorting/moving the extracted files into subdirs - LOW REGISTRATION FEE: $15 OR 15,- DM (Updates are for free!) * THESE FEATURES ARE ONLY AVAILABLE IN THE REGISTERED VERSION OF TID! IF YOU ARE STILL NOT CONVINCED THAT TID IS THE BEST AVAILABLE INTERNET-DECODER SO FAR, THEN FEEL FREE TO COMPARE THE RESULTS OF TID WITH YOUR FAVORITE ONE... [ 4.] INSTALLATION: ─────────────────── - Copy TID.EXE and TID.OVL into a DOS-'PATH' or in a Directory - Change to the TID directory - Configure TID with TID.EXE /C [ 5.] USAGE ─────────── TID.EXE <BUFFERFILENAME> NOTE: If you don't have TID in a PATH and if you want to call it from a batchfile you have to do it this way: -CUT- rem YOU *HAVE TO* change to the TID-DIRECTORY! cd c:\tools\tid tid.exe %1 %2 -CUT- USAGE IN CROSSPOINT ─────────────────── It is easy to include TID into Crosspoint, but let me tell you first some 'technical' stuff, to explain why this slows down XP/TID! Crosspoint uses more than one Bufferfile to store messages (I dislike this) and now let's say that you have some binaries/messages in hold status (maybe because there were missing parts and you want to wait, if they arrive with the next call) and as TID is only able to decode one bufferfile, the message-parts in hold-status would be ignored, because they are not in the new bufferfile you just recieved! To solve this problem I have included a special routine in TID that generates after your pointcall ONE bufferfile with all messages (new&old ones). This means that you NEED lot's of diskspace in your TEMPDIR (depends on the buffersize(s)) and that you have to wait until the complete buffer is generated and this can take some time if you have a slow HD or large (>30 MB) bufferfiles! After TID has finished decoding this BIG Buffer, it will be deleted and Crosspoint will import the new buffer! All in all this is not nice, but it works and if you do your pointcalls while you are sleeping or not at home, then it should not annoy you too much... HOW TO INSTALL TID INTO CROSSPOINT ────────────────────────────────── All you have to do is this: (The given menus are valid for the German Version, but all you have to do is to define TID as an ENTRY-FILTER for your UUCP-BBS - see point 3) below) 1) Turn off the switch in CONFIG/OPTIONEN/NETZE/VERSCHIEDENES (UUCP/RFC) "unnoetige Headerzeilen entfernen" 2) Start Crosspoint - Enter the EDIT/BOXEN/EDIT/DIVERSES menu 3) Fill in the FILTER EINGANG field: TID $PUFFER X:\YOUR_CROSSPOINT_DIRECTORY (If you have more filters then use a batchfile (read the XPOINT.DOC)) 4) Save the changes NOTE: All binaries will be extracted after your calls into the directory you have defined in the TID.CFG, if you have installed TID correctly into Crosspoint! I strongly recommend to kill all (errorfree) extracted binaries messages in Crosspoint, before you perform the next call, otherwise they would be extracted again! (If you don't like to include TID directly into Crosspoint, you can copy the different bufferfiles with 'copy /b' to one single bufferfile and decode the binaries with TID <BUFFERFILE>! Another way is to mark all binaries messages you want to decode and extract them from Crosspoint as a buffer! Now you can decode them with TID <BUFFERFILE> IF YOU ONLY WANT TO EXTRACT THE -NEW- BUFFERFILE (I DON'T RECOMMEND THIS), THEN FILL IN THE FILTER EINGANG FIELD (SEE 3)): 'TID $PUFFER' [ 6.] REGISTERING TID ───────────────────── The registered version has EXTRA-FEATURES (see above) and is able to work in batch-mode (there is no Shareware-Screen, if you start TID) If you have registered TID once, you will always get the latest version of TID (registered to your Name/Company) PGP-Crypted via E-mail for free. NOTE ──── This service is only available as long as you don't change your E-mail address or PGP-key! In this case you can re-register for a lower price: $5 or 5,- DM! (This is necessary, because it means extra-work for me) Maybe I will use someday a code-system! In this case you will not get any longer updates via E-mail, but all registered users of TID will get a code! With this code you can register the Sharewareversion, so you still can update TID for free! HOW TO REGISTER TID ─────────────────── 1) You *NEED* a PGP-KEY! - the USER ID has to be in this form: 'REALNAME <your@e-mail.adress>' - Here a few info's for you, if you don't have a PGP-KEY: o PGP is free for private use! o It only takes 5-10 minutes to generate a PGP-Key! o Quick instructions, how to generate a PGP-Key will follow in this documentation! NOTE: I will ship the REGISTERED version of TID *ONLY* crypted with your PUBLIC-PGP-KEY over the Internet (guess why...) In other words: If you send me money, but no REGISTER.TXT INCLUDING YOUR PGP-KEY, then don't expect to recieve anything from me in return, so please follow the rules! IF YOU ALLREADY HAVE SUCH A PGP-KEY, THEN GOTO 2) ELSE CONTINIUE READING. - Download PGP263.ZIP or PGP263I.ZIP from ftp://ftp.ifi.uio.no/pub/pgp/ ftp://ftp.ox.ac.uk/pub/crypto/pgp/ ftp://ftp.dsi.unimi.it/pub/security/crypt/PGP/ ftp://ftp.informatik.uni-hamburg.de/pub/virus/crypt/pgp/ other ftp servers or one of your local BBS's - Install the PGP-Program - Create your SECRET&PUBLIC KEY(S) with: 'PGP -kg' and follow the instructions on the screen! - Select a Key with a size of 1024 - Enter your REALNAME and your E-MAIL adress like the given example, if you are prompted to enter your user ID! - REMEMBER THE PASS PHRASE YOU ENTER!!! (better do not write it down!) IMPORTANT ───────── STORE YOUR SECRET KEY ON A SAFE PLACE AND NEVER GIVE YOUR PASS PHRASE TO ANYBODY ELSE! - Extract your PUBLIC KEY from the keyring with: 'PGP -kxa <your user ID> MYKEY.ASC' (If your REALNAME is e.g. JIM SMITH then enter: 'PGP -kxa JIM mykey.asc') The file MYKEY.ASC will contain your PUBLIC PGP-KEY, that you have to append to the REGISTER.TXT!!! (These are just QUICK docs how to create your PGP-Key(s), so please read the PGP.DOC if you want to know more about PGP and do not ask me, thanks!) 2) Fill out the REGISTER.TXT and append your PUBLIC-PGP-KEY to the REGISTER.TXT 3) Send the REGISTER.TXT to my E-Mail-Address! 4) The registration fee (**) is $15 (US DOLLAR) or 15,- DM (German currency) Payment: a) Remittance: Bank account: BERLINER SPARKASSE , GERMANY Bank code : 100 500 00 Account no. : 240369394 Reciever : ALEXANDER CURTH Comments : YOUR E-MAIL-ADDRESS b) International Postal Money Order: You have to go to your local post office and tell them that you want to send someone in Germany 15,- DM (German currency). They will give you a form to fill out, the postal clerk will look at the conversion table and you will pay the equivalent in your own currency. Some days later my postman brings me the money. c) Send it to my address: ALEXANDER CURTH EMDENER STR. 30 10551 BERLIN / GERMANY - as CASH / only in DM (German currency) or US$ (BILLS!) - as an EUROCHEQUE / only in DM (German currency) NOTE ──── Do no forget to write your NAME and E-MAIL-ADDRESS at the backside of the envelope and please make sure that the money/cheque is not visible through the envelope - Thanks! 5) AS SOON AS I RECIEVE YOUR MONEY, I WILL SEND THE REGISTERED COPY CRYPTED WITH YOUR PUBLIC-PGP-KEY TO YOUR E-MAIL-ADRESS! (If you do not get your registered copy within 20 days, after you have send me the money and the REGISTER.TXT, then contact me!) 6) If you recieve the mail from me that contains YOUR REGISTERED COPY of TID, then decrypt it with: - 'PGP -p <filename of the message that contains your Reg.-TID-Vers.> - Enter your PASS PHRASE - Extract the .ZIP and copy the TID.EXE over the Shareware-Version (**) ALL PRICES ARE *ONLY* VALID IF YOU WANT TO USE TID FOR PRIVATE REASONS! IF YOU WANT TO USE TID IN A COMMERCIAL-BBS, COMPANY, ETC. THEN YOU HAVE TO PAY $100 (US DOLLAR) OR 100,- DM! IF YOU WANT TO REGISTER 10 OR MORE COPIES OF TID, THEN ASK ME FOR SPECIAL PRICES! [ 7.] DISCLAIMER ──────────────── THIS SOFTWARE IS PROVIDED "AS IS". THERE IS NO WARRANTY, WETHER EXPRESS NOR IMPLIED. THE AUTHOR DOES NOT ACCEPT ANY LIABILITIES WITH RESPECT TO THIS PROGRAM. USE THIS PROGRAM ON YOUR OWN RISK! IF YOU DON'T AGREE WITH THIS, THEN DELETE IT! [ 8.] COPYRIGHT ─────────────── You are allowed to copy the *SHAREWARE-VERSION* of TID for free. You may distribute the program to others as long as you do not charge any fee and as long as there are no changes made with the program, this documentation and as long as the package TID-Vxx.ZIP is complete. [ 9.] TRADEMARKS ──────────────── MS-DOS is a trademark of Microsoft Corporation. WINDOWS 95 is a trademark of Microsoft Corporation. CROSSPOINT (XP) is copyright by Peter Mandrella ARJ is copyright 1990-96 by ARJ Software RAR is copyright 1993-96 by Eugene Roshal PKZIP/PKUNZIP are copyright 1989-1993 PKWARE Inc. All Rights Reserved. LHA is copyright 1988-92 by Haruyasu Yoshizaki GIF is a service mark of CompuServe Incorporated F-PROT is copyright by Frisk Software International GZIP is copyright 1992-1993 by Jean-loup Gailly PGP is copyright 1990-1994 by Philip Zimmermann [10.] BUG-REPORTS ───────────────── All decoded files with errors will be stored in a subdir of the extractpath you have defined in the TID.CFG that is called \_ERROR. The Error-Descriptions are stored in the file \_ERROR\!ERROR.LOG PLEASE NOTE: Not all recognized errors are 'BUGS' of TID!!! So please check *first* if the error-description in the !ERROR.LOG is valid! If not and if you are able to decode the file with another decoder errorfree or if you are able to decode the file after you have done some changes in the buffer, then you can say it's a 'BUG' in TID and *ONLY IN THIS CASE* I would really appriciate it, if you contact me (send me the !ERROR.LOG and the message - if it is not larger than 250 Kb) Don't worry about the contents of the message (Picture, Text, Sound, etc.) I really don't care as long as it is not of illegal nature! If PKUNZIP, ARJ, LHA/LZH, RAR or F-PROT returns an errorlevel of 255 then there are two possible reasons: - there is an error in the CFG-File! (check the path etc. with 'TID /C') - there is too less free base-memory to execute the test-program! (Try to increase your free memory or turn the option off!) If TID crashes/hangs then you should do this: - Enter the DOS-Shell and type "SET TIDDEBUG=ON" + <CR> - Let TID decode the buffer with the error again! - Note the Subject (the red line) of the message wich causes TID to crash! - Search for the message with the Subject in your mailer - Extract this message and send it to me (Header & Body!) If you discover other BUGS, then send me a detailed error-description, or tell me what I have to do to reproduce the error! (if you can...) PLEASE SEND BUG-REPORTS & SUGGESTIONS TO: alexc@kitembx.in-berlin.de [11.] PGP-KEY OF THE AUTHOR ─────────────────────────── Type Bits/KeyID Date User ID pub 1024/66DF6B59 1996/02/24 Alexander Curth <alexc@kitembx.in-berlin.de> -----BEGIN PGP PUBLIC KEY BLOCK----- Version: 2.6.3i mQCNAzEvkR8AAAEEANQMAv9CcBLBgA58qMvrbLfQTuuR8hkS1WQUh17aqMdu42OU G9kqmEzRMd5t2fdF+HIlHBpEqlPmhtRQx1z0z1Axt5c0B5sl+RWfQvvZQbBeFSMP lKbPDOFM8NgVmjp1Md4gCaNHNmjcNGT2VN8X/cqJkFILPyY1wL6FWFlm32tZAAUR tCxBbGV4YW5kZXIgQ3VydGggPGFsZXhjQGtpdGVtYnguaW4tYmVybGluLmRlPg== =fGrM -----END PGP PUBLIC KEY BLOCK----- [12.] ERRORLEVELS / USAGE IN BATCH PROGRAMS ─────────────────────────────────────────── ERRORLEVEL: 1 = no Error ERRORLEVEL: 0 = fatal Error [13.] SUPPORT-BBS ───────────────── You can download the latest Shareware-Version of TID for free at: Kiteflyer BBS Berlin +49-30-6690016 ISDN X75 +49-30-6690017 ISDN X75 / Analog Zyxel 19k2 +49-30-6690018 Analog USR 33K6 Online Account -------------- Login: tid, Password: tid (case sensitive!) then enter: files <CR> cd dos tools <CR> down tid* <CR> you can get a directory-listning with list tid* Ps: Sorry for my bad english! Feel free to send me a corrected TID.DOC! That's all!