ÖÄÄ· ÒÄÄ· ÖÄÄ· Ò Ò ÄÒÄ Ò Ò ÒÄÄ· Ò Ò ÖÄÒÄ· ÄÒÄ ÒÄ ÄÒÄ ÖÄÒÄ· Ò Ò ÇÄĶ ÇÄÒ½ º ÇÄĶ º º Ö½ ÇÄ º º º º º º º ÓÄĶ Ð Ð Ð ÐÄ ÓÄĽ Ð Ð ÄÐÄ ÓĽ ÐÄĽ ÓÄĽ Ð ÄÐÄ ÐÄĽ ÄÐÄ Ð ÓÄĽ 2.02 (c) 1996 Martin Woods All rights reserved ***FREEWARE for all you SYSOPS and Batch file Nuts!*** -Quick Start- Put AU.EXE in a "test" directory containing some archives. Make sure AU.EXE is in your "PATH=" statement. Type: AU.EXE Now watch as all the archives are converted to your favorite compressor! This program finds them all: PAK ZIP HAP SQZ LZH plus tons more, then converts them to your 'favorite' archiver. Type: AU /? for a quick help screen! ============================================================================= þ supports most major archiver available! ARJ, ARC, LHA, HAP, SQZ, DWC, PAK, ZIP 1.1 and 2.0, ICE, LHARC, LARC, UC2, HYPER, SDN, and ZOO. þ It can recognize PKZIP 1.1 files and PKZIP 2.0 "normal" compressed files, then convert them to PKZIP -EX "extra" compression. This will save you a ton of hard disk space! þ SYSOPS: Use as an UPLOAD PROCESSOR to SCAN and CONVERT þ Use as a "Download processor" to SCAN and CONVERT after you download from your terminal program þ command line switches, allowing you to do EXACTLY what you want. No guessing, no hassles. þ Allows using LHA SFX self-extracting archives to be the "target" archiver. That makes distribution of your archives easy, since the recipient does not need a program to un-archive your files! þ Use ENVIRONMENTAL variables to "customize" your version. þ Allows REMOVAL of a file's comment to a separate file. þ Supports VENDINFO.DIZ: The new standard in vendor and BBS information. The FIRST util to support this. þ Uses MULTIPLE config files, so you can completely change AU's operation from a batch file. þ Leave PKZIP and ARJ -AV files alone, plus virus scanning using any of the three most popular scanners! þ Recognizes embedded directories, and can include them with the conversion. þ Is perfect for SYSOPS, since it can be run as an "event" to update all .ZIP files, or be used as an upload processor. Even add comments or strip them from the files... þ You can "customize" AU to almost any configuration. Include some archives, but not others, recurse subdirectories, leave SFX files alone, delete files after processing, plus MORE. þ Keeps an accurate log of all activity. þ Lists archived files using its own 'internal' compression viewer (super-fast!). þ Allows overriding AU.cfg options on the command-line. þ You can add extra BBS advertisements, add only your comments, or evaluate the current files. þ Re-comment your entire BBS file area with ONE command. þ You can NOW pause, shell to DOS, or stop the program by just pressing a key. þ Search archives for FILE_ID.DIZ, DESC.SDI, *.SDA {SDA.ID} or VENDINFO.DIZ AU recognizes DWC, SQZ, and LARC self-extracting files. AU is extrememly simple: 1. Edit AU.CFG to your satisfaction 2. Include AU.EXE and AU.CFG in your path 3. Go to a directory containing some old archives. 4. Type: AU.EXE (or AU *.*) Now note that AU processes the entire directory! The only filespec you need (optional) is *.*. AU ruthlessly converts everything it can find using your .CFG file. NOTE: You can use AU *.* or AU *.ZIP ..... If you change your mind on archives, or want to change something, AU.CFG is easy to edit. Take your favorite editor and change it around. NOTE: If AU cannot locate AU.CFG file, it will use its own defaults. ======================================================================= command line options: USAGE: AU [filespec] [options] [altfile.CFG] can specify alternate .CFG file /X Give exact details in log file /COMM Add the COMMENT file only (no conversion) /EVAL Evaluation archive only (no conversion) /+ Debug AU process (messy output, but detailed!) /ID Show files having FILE_ID.DIZ, DESC.SDI *.SDA {SDA.ID} or VENDINFO.DIZ (new vendor info file) /LIST List contents of archive file(s) /GETCOM Get comment: Save into COMMENT.1 /SHORTLOG Keep AU's LOGfile under 40K /RECURSE Recurse subdirectories when processing /BREAKAV Break -AV sealed files /2EXTRA Convert PKZIP 'normal' archive to -EXTRA compressed /NODEL Do not delete files after processing /EXPEXE Expand .EXE files /ADDCOM Add comment to processed files /STRCOM Strip comment from all files /NOLOG Do not log activity /SCAN Virus check and use McAfee's SCAN /TBAV Virus check and use TBAV's TBSCAN /F-PROT Virus check and use Frisk's F-PROT ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ IMPORTANT NOTE: While AU is running, you can pause it, ³ ³ shell to DOS, or do an emergency exit. ³ ³ ³ ³ Pressing the [spacebar] pauses AU. Any other key resumes. ³ ³ Pressing the 'D' key shells to DOS. Just type: 'exit' to resume. ³ ³ Pressing the [ESC] key exits AU immediately. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ [altconfigfile.CFG] AU now can take multiple config files on the command line! Now, instead of changing AU.CFG every five minutes, you can create several different ones. Examples: AU C:\BBS\FILES\UPLOAD.CFG Will force AU to use the UPLOAD.CFG config file located in \BBS\FILES. AU E:\AU\AU5.CFG Will use AU5.cfg file on the E: drive. Valid Usage: AU *.ZIP C:\AU\PROCESS.CFG AU *.ARJ D:\TEMP\MY.CFG AU *.LZH C:\AU\TEST$S.CFG AU E:\UPL\UPLOAD8.CFG IMPORTANT NOTE: The alternate config file MUST have a .CFG extension. The filename can be anything, but must have a .CFG ending! If no config file is specified on the command line, then AU still searches the DOS path for AU.CFG /X will provide a little more detailed information in AU.LOG /COMM if you are a SYSOP, and want to add a "comment" file to your PKZIP and ARJ files, this is great! Using the /COMM switch, you can quickly comment ALL YOUR FILES in minutes. For an extra bonus, turn on RECURSE SUBDIRECTORIES in the config file, and watch as AU updates the comments on every file you got! /EVAL if you wonder what kind of files you have, then run: AU *.* /EVAL then AU will show what the archive types are without converting them. This is kinda like a "preprocessor" for AU. /+ will show a large amount of messy information on the screen, detailing exactly how AU is thinking, and what part of the program it is in. That way, you can debug where a problem is in case of a serious crash or lockup. /ID Searches files for FILE_ID.DIZ, DESC.SDI *.SDA or {SDA.ID} This is ideal for SySops, since many BBS programs require a "description file" to update the main file listing. Using: AU *.* /ID allows quickly identifying files with no description! /LIST List a single archive's contents. This works on only ONE file at a time. Wildcards are not allowed here. If you want to list a large number of files, use the LIST environmental variable instead. Usage: AU test.zip /LIST AU shez.arj /LIST /GETCOM Get the comment from a .ZIP or .ARJ file, then write it to COMMENT.1 This is useful if you see a really cool comment on a compressed file, and would like to "leech" it, and customize it with your OWN information! (Note: Sample Comment.txt included) /SHORTLOG The AU LOG file can get rather large, real quick. Using /SHORTLOG will truncate the AU log file when it gets over 40K. /RECURSE Recurse subdirectories when processing. This is the same as RECURSE SUBDIRECTORIES in AU.cfg. NOTE: pathnames will not be uncompressed when recursing, because of the recursion, endless loop that will get involved. /BREAKAV Break -AV sealed files. Some sysops or other people put their own -AV stamp on files, which causes a problem when you want to add a file, etc. This switch allows processing files, and breaking that stamp. /2EXTRA Convert PKZIP 'normal' archive to -EXTRA compressed. NOTE: Your default archiver will be changed to PKZIP 2.0 if you use this switch. Be sure to include PKZIP2 = convert in your config file, so to catch all the older 2.0 -NORMAL compressed. /NODEL Do not delete files after processing. Be sure to use this if you're playing around with Internet files, so not to erase something you wanted to keep! /EXPEXE Expand .EXE files. AU analyses .EXE files and recognizes ALL SELF-EXTRACTING compressed files. /ADDCOM Add comment to processed files. Your COMMENT file must be specified in your config file. /STRCOM Strip comment from all files. If you ADD a comment, be sure to not STRIP it also. That's a waste, since most archivers automatically remove the current comment when it adds one. /NOLOG Do not log activity in AU's LOG file. /SCAN Virus check and use McAfee's SCAN. Make sure that SCAN.EXE is somewhere in your path. /TBAV Virus check and use TBAV's TBSCAN Make sure that TBSCAN.EXE is somewhere in your path. /F-PROT Virus check and use Frisk's F-PROT Make sure that F-PROT.EXE is somewhere in your path. ===== EXAMPLES: ==================================================== AU *.ZIP /X AU /LIST *.ARJ AU TEST.ZIP /GETCOM AU *.ZIP /X AU *.ARJ /NODEL /F-PROT /NOLOG /X AU /EVAL (the *.* is assumed) AU /ID (the *.* is assumed) ====================================================================== Any command line options can be given in ANY order. The only rule is: ALWAYS SPECIFY /TAG before any other options (if you want to /TAG files) IE: The following are treated the same -> AU *.ZIP /NOLOG /X /NODEL /TBAV AU /nolog /nodel /tbav *.zip /x AU /x/tbav/nodel/nolog *.zip ======================================================================== IMPORTANT NOTE: PKZIP 2.0 "stored" files are identical to PKZIP 1.1 format. Therefore, all 2.0 "stored" archives are flagged as version 1.1. Valid Usage: SET AU=2EXTRA;LIST;BREAKAV SET AU=RECURSE;NOLOG;ADDCOM;SHORTLOG Explained Usage: SET AU=RECURSE;NOLOG;ADDCOM;SHORTLOG     ³ ³ ³ ³ Recurse subdirs ÄÄÄÄÄÄÄÄÄÙ ³ ³ ³ Don't use a logfile ÄÄÄÄÄÄÄÄÙ ³ ³ Add a comment file ÄÄÄÄÄÄÄÄÄÄÄÙ ³ Truncate log when over 40K ÄÄÄÄÄÄÄÄÙ ÖÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ· º IMPORTANT NOTE: Anything in the AU environmental variable º º will over-ride the settings in AU's º º CONFIG file. º º IE: If BREAKAV is set to OFF in AU.Cfg, º º and BREAKAV is in AU's variable, then º º -AV files will be broken. º ÓÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĽ ========= USING AU.CFG FILE ============================================ Included here is AU.CFG, a configuration file for this program. --------------------------------------------------------------------- Put the archiver you want everything converted to. [archiver] = archiver Whereas archiver could be: PKZIP1 ARJ LHA DWC QWKZIP PKZIP2 PAK ZOO ARC6 LHASFX SQUEEZE ICE HAP LARC LIMIT HYPER FCOMPACT LHARC UC2 --------------------------------------------------------------------- Next, put all the archives you want converted to YOUR archiver. For instance, if you put LHA here, all .LZH files will be converted. [archiver] = convert Whereas archiver could be: PKZIP1 ARJ LHA DWC PKZIP2 PAK ZOO ARC6 SQUEEZE ICE HAP LARC QWKZIP HYPER UC2 LIMIT LHARC --------------------------------------------------------------------- Now, do you want to strip all comment files in the archivers found? NO = strip comment --------------------------------------------------------------------- And do you want to add your own comment file to the archives that are converted? NO = add comment --------------------------------------------------------------------- Then, what comment file do you want added? (leave this line out if you want to comment added) NOTE: Make sure that the filename is left justified! No spaces should be on the left of the filename! B:\COMMENT.TXT = comment file --------------------------------------------------------------------- When .EXE self-extracting archives are found, do you want them extracted? NO = executables --------------------------------------------------------------------- If PKZIP 2.0 files are found that have been compressed using "normal" compression, do you want them to be re-compressed using "EXTRA" compression? NOTE: This will immediately change your ARCHIVER to PKZIP 2.0 NO = make ZIPs -EX --------------------------------------------------------------------- Do you want to recurse the subdirectories? If YES, then all directories beneath the current one will be processed also! NO = recurse subdirs --------------------------------------------------------------------- As a default, AU logs all activity into \AU.LOG. This makes it easy to see what happened, and keep track of what went where. yes = create log file C:\AU\AU.LOG = log file location --------------------------------------------------------------------- Also as default, AU deletes the old archives, so that your hard disk is not cluttered with old and new versions. That would make it extremely difficult to sort through them! yes = delete files --------------------------------------------------------------------- If you want to scan your archives for viruses, you can utilize any of the three most popular virus scanners avaiable. Just include the "check for viruses" line, then choose one of the scanners listed below (NOTE: You can only specify one) yes = CHECK FOR VIRUS VIRUSCAN = VIRUS PROGRAM /* McAfee's */ F-PROT = VIRUS PROGRAM TBSCAN = VIRUS PROGRAM --------------------------------------------------------------------- Many PKZIP and ARJ files have a -AV seal attached to them. Most people (including SYSOPS) may not want to break those sealed files, since a "sealed file is a safe file". If a PKZIP or ARJ is -AVed, then you can be pretty sure no one has tampered with it. no = break AV files --------------------------------------------------------------------- AU has an internal "archive viewer" that allows you to see what's inside an archive before/as it is processed. This will allow a clear representation of the file. Actually, the viewer is FASTER than any other I have found. Try it out! yes = list files before processing ============ ATTENTION SYSOPS =========================================== New in this version: 1. SYSOPS: Compress all your .QWK files into PKZIP 2.0 tighter compression. Just specify QWKZIP = archiver and QWKZIP = convert Leave out all other '=archiver' and '=convert' lines, so not to convert EVERYTHING to a .QWK packet! Just use: AU *.QWK to convert all of them! 2. Full Internet support. Everything you download, you can convert via AU. Don't worry about which is which, just use AU /EVAL to find out what the archiver is! AU can save you tons of hard disk space, and serve as a processor for uploads. If some new member uploads you an ancient archive (PAK or ZOO), or some unknown self-extracting .EXE archive, how do you find out what it is? It could be a cool game that everybody likes, but the lamer has given you a useless file. AU will instantly recognize the .EXE file as DWC, ZOO, PAK, ARJ, PKZIP 1.1, PKZIP 2.0, ARC, LHA, etc. Then it will convert it to your BBS's archiver, with no problem. Even embedded paths are saved! **** Included is UPLOAD.CFG configuration for upload processing **** Is your BBS's hard disk getting full? Run AU as an event once a week and convert all of your PKZIP 1.1 and 2.0 "normal" compressed files to PKZIP 2.0 "EXTRA" compression! That will save MEGABYTES of space (a friend of mine saved over 2 megabytes on one directory of uploads) **** Included is EVENT.CFG configuration for event processing **** Plus you can comment all the processed files with your own BBS comment file, or simply strip the old comments from them. ========= PLEASE READ THIS! =============================================== Please think about what you put into AU.CFG before starting the program. 1. If your "Archiver" and "convert" file types are the same, then all files will be processed twice: PKZIP2 = Archiver PKZIP2 = convert PAK = convert ARJ = convert because AU will convert all the .ARJ and .PAK files, then convert them again because they are now PKZIP 2.0 files! IMPORTANT NOTE: If you specify MAKE ZIPS -EX, then AU assumes you want to use PKZIP 2.0 as your default archiver. It will process files as such! 2. If you have 20 archives with the same name: ANOTHER.PAK ANOTHER.ARJ ANOTHER.ZIP ANOTHER.SDN ANOTHER.ZOO ANOTHER.ARC all of the contents of ALL THE ARCHIVES will be converted into your new file. So, if you said: PKZIP2 = Archiver then ANOTHER.PAK's contents will be stuffed into ANOTHER.ZIP, and ANOTHER.ARJ's contents will be also. And you will lose the original files. So please don't name several archives the same file name, then include all those types in your AU.CFG file! 3. Embedded directories are NOT processed if you use: yes = recurse subdirs Why? Because when you re-compress the file, then you will include all subdirectories under the current one. And if you are in the root directory, your whole hard drive will be sucked up into the new compressed file! 4. Please don't STRIP a file's comments, then ADD a comment. If you ADD a comment, then the old one is automatically deleted. 5. Please make sure ALL FILENAMES IN AU.CFG are left justified! For example, your comment file should look like: º ºC:\PCBOARD\COMMENT.FIL º instead of: º º C:\PCBOARD\COMMENT.FIL º Because to get the filename, an ASCII 'zero' is placed wherever a 'space' character is. And the filename won't register unless it's left justified. NOTE: PKZIP 2.0 "stored" files are identical to PKZIP 1.1 format. Therefore, all 2.0 "stored" archives are flagged as version 1.1. 7. Due to the "human" nature of my C++ compiler, if you have a THICK layer of subdirectories (more than 10), and each have the exact same filenames, one or two files may be skipped. This is because the Data Transfer Area of DOS thinks that it already processed that file. This should also be fixed in the next version. 8. Also NOTE: Any unsuccessful de-compression of a file will result in the original not being erased. So if AU does not get an errorlevel of 0, then it aborts the erasure process. ============= TECHNICAL STUFF ============================================= Because of the complicated nature of AU, problems may arise. Here is a list of common difficulties people have written me with: 0. If you are getting the .ARC files from the Satellite Network, they DO NOT unarchive because they are version 7.0 of ARC. You MUST HAVE a registered version of ARC in order to extract these! 1. AU does not process ARJ files properly. You need at least version 2.39 of ARJ in order to process the switches I use. Of course, the registered AU offers customized switches! 2. I use AU D:\FILES\*.* and nothing happens. Of course not. You must be in the directory with your archivers in order to convert them. If you want to do the above, try: D: CD\FILES AU *.* 3. I used AU on several PKZIP 2.0 files to make them -EXTRA compressed, but nothing happened. In cases where it could be ANYTHING gone wrong, use the following special switch: AU *.* /X/+ > LOGIT This will run AU, show technical debugging information that I need, and pipe the output into a new file called "LOGIT". Now just send the file "LOGIT" to me, along with your AU.LOG, and I can sort out what the problem is. Just upload the files for me at the AntiVirus ROCK BBS, on CompuServe, or simply mail them to me at my home address on a disk (any size). 4. To extract the COMMENT.1 file when using the /GETCOM switch, AU 'tests' the file using the needed archiver, then strips the comment from the captured text. This may take a while when 'testing' larger archives. ============ ERRORLEVELS ================================================== When AU exits, it returns the following errorlevels: Errorlevel = 0 success 1 virus found 2 no files found 3 ONLY help screen printed 4 WORKTMP directory was not deleted 5 AU.CFG had problems.. 6 Spawn Error 7 aborted! 99 error opening file