旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴커 � � � 렬컴캠 � � � Archive Identifier � � � � � � � 봬컴캘 옭커 旼커 � 旼컴� � Version 1.22 � � � � � � � � � � � � � 읕켸 � 읕컴� � (c) Copyright 1992-1996 - Stacy Smith � � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸 Courtesy of: The Bloom Beacon-Picayune BBS Node 1: *** DOWN *** (USRobotics Courier Dual Standard HST/V.34) FidoNet ILink Intelec Stacy Smith 旼컴컴컴컴컴컴컴컴컴커 � 1. Introduction: � 읕컴컴컴컴컴컴컴컴컴켸 Archive Identifier (ARCID) is a derivative of the UpLoadProcessor (ULP) system; users of ULP do not require this program, as each of the ULP programs have ARCID's abilities built into it. ARCID is intended for use by people who wish to be able to accurately detect a archive's format without relying on the file extension, but do not wish to use ULP. These people may be sysops using EXZTEST, ZIPLAB, ZDCS, FWKCS, etc., or may be using their own homemade batch files for testing archives, or even other purposes I haven't thought of. Regardless, ARCID is an extremely simple and fast tool for people who deal with compressed files on a regular basis. 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커 � 2. Features of Archive Identifier: � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸 � Native versions for both 16-bit DOS and 32-bit OS/2! � Identifies ARC, ARJ, HYP, LZH, PAK, RAR, SQZ, ZIP, ZOO, GIF, JPG and BMP files, regardless of their file extensions (ideal for software distribution networks, like .SDN files). � Identifies ARJ, LZH, RAR, SQZ and ZIP self-extracting (SFX) archives. � Can filter other file types based solely upon file extension. � A total of 97 archive formats and files extensions can be defined for conditional branching of batch files. � Fully network-aware using DOS SHARE-compatible locks. � Written in C for optimal speed, using Watcom C/C++ 10.6. 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� � 3. Files Included in the ARCID Distribution Archive � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� ARCID.COM Archive Identifier processing program (16-bit DOS). ARCID2.EXE Archive Identifier processing program (32-bit OS/2). PCBTEST.BAT Sample PCBTEST.BAT file for using ARCID. SLOWDRV.BAT Sample SLOWDRV.BAT file for using ARCID. ARCID.DOC This file. SUPPORT.DOC List of authorized support sites for my shareware. HISTORY.DOC ARCID revision history in reverse order. REGISTER.FRM Registration form for ARCID and other software. FILE_ID.DIZ Internal description file. When you unzip the distribution archive, you should see my PKZIP authenticity verification stamp, and a '-AV' after every file in the archive: # SSU301 The Bloom Beacon-Picayune BBS If there are any files missing or added, or the -AV stamp is missing, the archive has been tampered with. It would be advisable to call my BBS (listed at the top of this document) or one of the support sites listed in the SUPPORT.DOC file for the latest version of ARCID. 旼컴컴컴컴컴컴컴컴컴컴컴컴컴� � 4. Program Requirements � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴� To the best of my knowledge, this program will run on most any machine capable of running the popular archivers in use today. My BBS setup was DESQview on a LANtastic network, but other sysops that I have been in contact with have successfully implemented ARCID on setups with CD-ROMs and other varying hardware. ARCID has been developed and tested using archives created by the following archiving packages: ARJ 2.10 and higher (by Robert Jung) HYPER 2.5 (by P. Sawatzki and K. P. Nischke) LHA 2.12 and higher (by Haruyasu Yoshizaki) LHarc 1.13c (by Haruyasu Yoshizaki) PAK 2.51 (by NoGate Consulting) PKPAK 3.61 (by PKWare) PKZIP 1.10 and higher (by PKWare) RAR 1.53 and higher (by Eugene Roshal) SQZ 1.08.2 (by Jonas Hammarberg) ZOO 2.01 and higher (by Rahul Deshi) UnZip 5.12 (by Info-ZIP) ZIP 2.0.1 (by Adler, Wales, Gailly and Rommel) as well as the GIF87a, GIF89a, JPEG JFIF and BMP graphic format standards. The ARCID system requires DOS 3.x and up or OS/2 2.x and up, as it uses DOS SHARE-compatible file reads and writes. ARCID's memory requirements are extremely small (less than 64K). For the batch file operations, however, it would be a good idea to have as much free conventional memory as possible (ARCID itself cannot use EMS or XMS memory, and really couldn't use it if I wanted it to), since the archivers may require a significant amount of memory. 旼컴컴컴컴컴컴컴컴컴� � 5. Registration � 읕컴컴컴컴컴컴컴컴컴� The ARCID system is not free; nor is ARCID is crippled to force registration. ARCID is fully functional, and will always remain so. The only variation with the registered copies is no beg message and time delay. Why register? Besides a clean conscience, you will get a diskette that includes the latest version and a registration key that will work for all future versions of ARCID, and will remove the message and brief time delay at the end of execution of ARCID. The registration fee for your unique code is $15 for non-commercial BBSes. The registration fee for commercial BBSes, defined if you run your BBS in the course of a commercial business (e.g. more than 10 nodes), is $20. Please print the file REGISTER.FRM and fill it out. You can print out the form by issuing the following command from the DOS prompt: TYPE REGISTER.FRM > PRN 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� � 6. License, Warranty and Disclaimer � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� I'll keep this part short and sweet, and dispense with the legal-ese: License: You are allowed to use ARCID for 30 days, after which you must either register ARCID or stop using it completely. ARCID registration is a license for your use of ARCID; I retain ownership of the software. A single registration applies to a single BBS system, regardless of the number of computers used in the system. If you run two or more distinct BBS systems on the same computer (with different names), you require two or more ARCID registrations. Refer to the registration form for the currect pricing structure. Warranty: There isn't one. The only thing I'll guarantee is that ARCID will take up disk space, and will disappear when deleted. Disclaimer: I'm not responsible for anything bad that happens. ARCID works here, but I cannot be held responsible for it not working on your computer or doing any damage to hardware or software. If these aren't agreeable with you, then the best thing to do is delete ARCID right now. I'll do my best to help any user (registered or not) that wants to use ARCID, and I'll act on bug reports quickly, but I simply cannot and will not be responsible for anything bad, like lost data, disk crashes, or whatever else you can think of. 旼컴컴컴컴컴컴컴컴컴� � 7. Installation � 읕컴컴컴컴컴컴컴컴컴� GENERAL: 컴컴컴컴 Copy the file ARCID.COM into a subdirectory that is included in the DOS and/or OS/2 path, so that ARCID may be executed from anywhere. I would suggest your PCB home directory, usually 'C:\PCB\'. If you have registered ARCID, place a copy of your ARCID.KEY file in the same subdirectory as the ARCID executable(s). If you are running your BBS under a DOS network or a multitasking operating system, you should already have DOS's SHARE.EXE loaded. Some network operating systems (e.g. Novell) have integral SHARE functionality, therefore, SHARE.EXE is not required. You must have SHARE-capability in order to take advantage of the file sharing and locking methods used by the DOS ARCID program to prevent data loss. (If you are running a single-node system without a multitasker, SHARE is not needed). Note that for the ARCID programs, you can obtain a limited program syntax screen simply by executing the program name with no arguments. FOR UPLOAD TESTING USING 'PCBTEST.BAT': 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� NOTE: If you are unfamiliar with the operation of PCBTEST.BAT, you will need to refer to the PCBoard manual for an explanation of PCBTEST.BAT and/or TESTFILE.EXE. As necessary, refer to the sample PCBTEST.BAT file included in this archive. This simple batch file will test archive integrity and check for viruses for any of the detectable formats of ARCID. This batch file can easily be expanded to perform more tests. ARCID.COM is a drop-in replacement of PCBoard's TESTFILE.EXE. If you are already using TESTFILE.EXE, then simply replace the TESTFILE command in your batch file with ARCID. For example, if your current PCBTEST.BAT has the following line: TESTFILE %1 ZIP ARJ LZH GIF simply change it to: ARCID %1 ZIP ARJ LZH GIF ARCID will return a DOS errorlevel corresponding to the archive's position in the extension list; for example, if the file passed via %1 is an LZH file, ARCID will return an errorlevel of 3. If the file is identified as one of the listed formats, ARCID will return an errorlevel of 98. ARCID is capable of automatically detecting the formats identified by the following extensions, regardless of the file's true extension: ARC for ARC/PKPAK archives ARJ for ARJ and ARJ self-extracting archives BMP for BMP picture files GIF for GIF picture files HYP for HYPER archives JPG for JPEG JFIF picture files LZH for LHA/LHARC and LHA/LHARC self-extracting archives PAK for PAK archives RAR for RAR and RAR self-extracting archives SQZ for SQZ and SQZ self-extracting archives ZIP for PKZIP and PKZIP self-extracting archives ZOO for ZOO version 2.x archives Do not add 'EXE' to the extension list; ARCID will automatically return to corresponding errorlevel for an identified self-extracting archive. 旼컴컴컴컴컴컴컴컴컴컴컴컴커 � 8. The Future of ARCID � 읕컴컴컴컴컴컴컴컴컴컴컴컴켸 ARCID will be supported as long as I'm in the BBSing business (which will be quite a while...once it's in your blood, you can never shake it ). The ARCID system will be rapidly expanding it's features; some current plans: � Install code to detect archives containing explicit paths. � Install code to detect defective or hacked archives. If you have any other suggestions, or want other archivers supported, please contact me by Internet, U.S. snail-mail or on my BBS at the number at the top of this document. Thanks for giving ARCID a try! 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커 � Appendix A: DOS Errorlevels � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸 The errorlevels returned to DOS by the ARCID system programs are consistent among all of the programs (primarily with the error conditions); the following is a list of the errorlevels than can be returned by the ARCID programs, along with which programs return the codes: 0 Successful brand of the ARCID executable 1-97 Successful execution, archive identified 98 Successful execution, archive NOT identified 99 Unsuccessful execution, no arguments passed (help screen displayed) 110 Unable to allocate heap memory (disk buffer) 112 Invalid registration key 115 Invalid filename provided by user on command-line