°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°° °° ZDCS / ULP Remote Shell °° °° Version 1.0 Beta °° °° By: Don Pellegrino °° °°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°° ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Introduction: ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ What is the ZDCS? The ZDCS is the Zip Duplicate Checking System. It is used on many BBSs for the purpose of pre-testing user uploads. It will read a text file created from the view command of pkunzip (pkunzip -v filename.zip > zdcstest.chk). The ZDCS is usually a door or file menu command. When executed, it will prompt you to upload your zdcstest.chk file. ZDCS will then read that file and determine if filename.zip will be accepted as an upload. What is the ULP? The ULP is the UpLoad Processor. It is used on many BBSs to scan for duplication, it has many added features and also checks for many other attributes including file date and time. This allows a BBS to accept only uploads that are of a certain age. The ULP checks ZIP files with the [pkunzip -v filename.zip > verify.ulp] and also checks ARJ files, by using the [arj l filename.zip > verify.ulp]. What is the Remote Shell? The shell is a quick and easy way to create zdcstest.chk and verify.ulp files. You simply input filename and RS does the rest. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ZURS1.ZIP - Getting Started: ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ZIP Contents: IMAGE1.MAP - 320x200x256 Image used by: ZURS1.EXE IMAGE2.MAP - 320x200x256 Image used by: ZURS1.EXE IMAGE3.MAP - 320x200x256 Image used by: ZURS1.EXE IMAGE4.MAP - 320x200x256 Image used by: ZURS1.EXE IMAGE5.MAP - 320x200x256 Image used by: ZURS1.EXE LCOM.CHR - Font used by: ZURS1.EXE LITT.CHR - Font used by: ZURS1.EXE SANS.CHR - Font used by: ZURS1.EXE TSCR.CHR - Font used by: ZURS1.EXE VESA.BGI - Graphic Driver used by: ZURS1.EXE ZURS1.EXE - The main program executable. ZURS1.TXT - This file. Files Created after Configuration: ZURS1.CFG - Data file used by: ZURS1.EXE RS.BAT - Batch file (the one you should run). VERIFY.ULP - The file you upload to a BBS using the UpLoad Processor. ZDCSTEST.CHK - The file you upload to a BBS using the ZDCS. Unzipping the archive: You should create an empty directory to place all of the files in (c:\zurs). Next you should use pkunzip to extract the files to that directory. Running and Configuring the program: Make the directory containing all of the ZURS files the current directory. Execute ZURS1.EXE and configure the program. You will be prompted for three different fields of data: 1. Location of the program files - The name of the directory containing all of the files that were extracted from the archive. ex. C:\ZURS 2. Directory to place ZDCS/ULP check files in - The name of the directory that you would like the shell to write the ZDCSTEST.CHK and VERIFY.ULP files to. ex. C:\TELIX\UPLOADS 3. Directory containing ZIP and ARJ files - The name of the directory you would like the RS to view on start-up. After the program has been configured ZURS1.CFG and RS.BAT will be wirtten to disk. From now on, whenever you start the program run RS.BAT. This file will make the directory containing the ZURS files the current directory and execute ZURS1.EXE. This batch file is very useful when running the shell from a terminal program. It might be useful to add the following line to the end of the batch program [CD DIR] where DIR = the name of the directory containing your terminal program. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Technical Support: ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Contact DON PELLEGRINO (Remote Shell): INTERNET: don.pellegrino@jbjsys.com ILINK: Don Pellegrino ECHO ZDCS BBS: The Dew Drop Inn (412) 854-0619 POSTAL: Don Pellegrino 124 Grove Avenue Pittsburgh, PA. 15229-1306 Contact STACY SMITH (UpLoad Processor and Zip Duplicate Checking System): Intelec and ILink ZDCS Support echoes Intelec, ILink and RIME ULP Support echoes Fidonet and ILink CDC-Support echoes Intelec and ILink Sysop echoes Fidonet PCBNET echo BBS: The Bloom Beacon-Picayune BBS 919-557-3845 USRobotics Courier HST/V.32terbo Dual Standard 919-557-0645 USRobotics Courier V.32bis 919-557-0745 Hayes Optima 288 V.FC ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BBS Bulliten for the UpLoad Processor: ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ³ º ³ Ò Ò Ò ³ º UpLoadProcessor ³ º º º ÖÄÄ· ³ º ³ º º º º º ³ º How to verify archives ³ ÓÄÄĽ Ð ºÄĽ ³ º BEFORE you upload them! ³ Ð ³ º ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ º ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ This bulletin board system is using an advanced upload processing system called UpLoadProcessor, or ULP for short. This system fully tests all uploads for CRC errors, duplicate files, viruses, age and other contraints. This can be a headache for users who spend a lot of time uploading a file, only to find out that it is a duplicate file or is older than the Sysop allows, and then loses credit for their effort. Now there is a solution: ULP will allow you to create a redirected archive listing text file named VERIFY.ULP, and upload that. ULP will review the listing, and report back to you if the file will pass the duplication and age limits set by the Sysop. (This will only work for ARJ and ZIP archives, but that shouldn't pose a problem, since these two formats make up the vast majority of BBS archives). First, you must create the list file VERIFY.ULP (no other file name will be accepted by ULP). For an ARJ archive, issue the following command to get your archive listing file VERIFY.ULP (replace the 'FILENAME.ARJ' with the archive's file name): ARJ L FILENAME.ARJ > VERIFY.ULP For a ZIP archive, issue this command, using the appropriate file name: PKUNZIP -V FILENAME.ZIP > VERIFY.ULP Next, just upload the VERIFY.ULP file (do not compress it; it's only a few hundred bytes normally). ULP will report back if the file will pass the limits, and then you can upload the archive without wondering if it will pass or not. Don't be alarmed when you see the closing message that the VERIFY.ULP file will be removed and failed. This is for PCBoard housekeeping; if this did not occur, this file would remain on disk and be processed as an upload. If you have any questions regarding this process, please contact your Sysop. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BBS Bulliten for the Zip Duplicate Checking System: ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ DUPLICATE CHECKING This bbs uses ZDCS (Zipfile Duplicate Checking System) to check the files in your upload against those already here on the bbs to see if there are any duplicates. This benefits us by wasting less storage space on keeping multiple copies of the same files, and benefits you by reducing the frustration of downloading files with different names that turn out to be the same files after all. When you upload your file, ZDCS will check it and tell you whether or not there are any duplicate files inside your upload. If there are more duplicates than this bbs allows, the upload will be moved to a private area for the sysop's review. It is not dumped! You can "pre-test" an upload before actually spending your time on- line to send it. This does not require you to download any special programs or to perform any arcane rituals. The pre-test will give you the same sort of information that ZDCS gives to a finished upload, so you can see how your intended upload would compare with the files already on the bbs. Sound too good to be true? It's really pretty simple. All you need is PKZIP. You *do* have PKZIP, right? Let's say that you want to upload a zipfile called GOODSTUF.ZIP. At your DOS prompt, type in the following (not case-sensitive) command: PKZIP -V GOODSTUF.ZIP > ZDCSTEST.CHK A new file called ZDCSTEST.CHK has just been created with information about GOODSTUF.ZIP in it. All you have to do is upload ZDCSTEST.CHK to the bbs, and it will give you a breakdown of all the individual files in GOODSTUF.ZIP, with a note as to whether any of them are duplicates or bbs ads. Now you know whether it's worth your time to upload GOODSTUF.ZIP to the board. (Sorry, no upload credits for ZDCSTEST.CHK.) Suppose you have more than one upload you want to check out. (First off, thank you for wanting to upload!) You'll have to issue the above command separately for each upload you want to check out, creating separate ZDCSTEST.CHK files. You can handle this one of two ways: 1. Do it ahead of time and use a different directory for each upload. This is to keep from overwriting the ZDCSTEST.CHK file for one upload with the .CHK file from another. 2. Shell out to DOS while on-line and do it live. (Each communications program does this a little differently, but pretty much any half-way decent comm program lets you pop out of the bbs and back to your own machine's DOS for little things like this.) Since the PKZIP -V command is so fast, you lose very little time. This is probably the simplest way to do it. On a multi-node system, there is a possibility that someone else is trying to upload her or his own ZDCSTEST.CHK test file at the same time as you. In that case, the bbs may tell you that your file is a dupe. Just count to ten slowly and try again. If you get the same message a second time, leave a omment to the sysop. There is another possible reason for this dupe message, which the sysop can check out. Thanks for the uploads! ..................................................................... ZDCS and Zipfile Duplicate Checking System (C) Copyright 1991, 1992 Michael W. Cocke. All rights reserved. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Shareware - Please support my efforts: ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Please distribute this program freely. If you find the Remote Shell useful please register the program with DON PELLEGRINO. You will recieve a printed copy of the documentation and a copy of any future versions. The cost is only $10.00. If you would like a copy of the C++ source code send only $50.00. The source code is not shareware but you will be welcome to use it in any of your own programs. $10.00 - Program Registration $50.00 - C++ Source Code Send the following information along with a check in the appropriate amount to: Don Pellegrino 124 Grove Avenue Pittsburgh, PA. 15229-1306 YOUR NAME: YOUR ADDRESS: YOUR EMAIL ADDRESS(es): WHERE YOU GOT YOUR COPY OF ZURS1.ZIP: COMMENTS, SUGGESTIONS: