+---------------------------------------------+ | | JUP 1.71 - February 1996/May 1997 +--+ | | | | | | easy util to list & unpack files | | | | | | | | ALL RIGHTS RESERVED | | | ++--------------------------------------------+ | | | PART I : INTRODUCTION AND MAIN TOPICS | | +-----------------------------------------------+ | | | | | | | | | | | | | JUP | JUPFAST | | | | | | | | | | | | ++ JenSoft Systems, Inc. || c/o Jens Weynans || Suedstrasse 27 || 47798 Krefeld, GERMANY || || Phone +49-2151-771057 || FIDO: changing || || E-MAIL: weynans@aol.com || || -------------------------------------------++ LICENCE AGREEMENT ---------------------------------------------------------------------------- This Program is now CARDWARE. You may copy it, use it, and give it to your friends under the following conditions: * Don't charge any money for it. * Only distribute the complete package, without any files missing. * Don't modify the files in any way. * If you use this program or if you think that it's useful (or both...?), please send a postcard (e. g. with a beautiful picture of your home town), see my address above. * If you include this program on a CD-ROM, please send me a free copy of that CD-ROM. Distribution of JUP in any way is explicitely desired, provided that the above conditions are met. ATTENTION: YOU ARE USING JUP AT YOUR OWN RISK! THE AUTHOR (JENS WEYNANS) IS NOT LIABLE FOR ANY DAMAGE CAUSED BY THE USE OF JUP OR BY THE INABILITY TO USE JUP. IF YOU ARE NOT SURE ABOUT THIS, OR IF YOU DON'T ACCEPT THIS, THEN DO NOT USE JUP! All product names mentioned in this manual and software are trademarks or registered trademarks of their respective owners. They are used for identification purposes only. ---------------------------------------------------------------------------- JEN SOFT SYSTEMS, Inc. JUP I-2 INTRODUCTION ---------------------------------------------------------------------------- What is JUP ?? As you know, compression programs are very popular today and almost every program (JUP of course, too) is delivered as an archive created by such a program. Beside the most common programs (eg. PKZIP) there are much many more archive types on the market and to "unpack" an archive sometimes could be very complicated: because you do not know the name of the unpacking program or you do not know the options must be given to unpack or what kind of archive you have. Do you have the feeling, that you were described by the previous paragraph ?. If this is the case, use JUP for your purposes. JUP is an unpacking program, which can be configured by you, if you want and if it is necessary. JUP recognizes the configured archive type and can do some of the most needed actions for you. You can extract the archive contents with or without the embedded paths and also force overwriting, if the included files exists. The archive contents can be listed or the integrity of the archives can be tested. It is also possible to display the included files to the screen or only to identity the archive type for using this knowledge in an batch file. The program works for DOS and the most common arcers are pre- configured. It includes also an different way of handling the 4DOS command interpreter. If you are only identify one archive type and it could be recognized by JUP, the enviroment variable JUPARC would be setto the found arc type. The exact program work will explained on the next pages, the the configuration process follows in chapter II of this manual. ---------------------------------------------------------------------------- JEN SOFT SYSTEMS, Inc. JUP I-3 PROGRAM DESCRIPTION ---------------------------------------------------------------------------- If you call JUP without any parameters or do not give any archive name, JUP will show the valid program syntax: JUP 1.71 (C)opyright 1994-96 Jens Weynans. All Rights Reserved. Feb. 1996 JUP easy util to list & unpack files. English language *CARDWARE* version. Usage: JUP [ ...] [ ...] [ ...] Options: JUPFAST limits: F - FAST! search only for real archives * default H - show current configuration * not avaiable I[+] - identify [subversions] only * no subversions C[] - force JUP configuration with * not avaiable U[] - use JUP configuration of G - password to extract archive W[] - output path name, (default is w/o extension) D, S - display file(s) on standard output device L, V - list/view archive contents Q[+] - quiet[er] mode, suppresses shell output P - use embedded paths while unpacking R, O - replace existing files T - test archive integrity E, X - extract archive files without overwriting Example: JUP *.zip *.arj /r+ /f *.doc *.exe will extract all files with the extensions .doc and .exe from all archives with the extension .zip and .arj in the fastest mode. the first parameter(s) must be the arcname(s) (e.g. JUP *.* ). after the archive name the options can be given. if you want to select an file list (eg. show only the *.DOC files in the archive, then must give an option like JUP *.* /L *.DOC). if you do not give any file specification, *.* would be selected. for people who are interested in very fast detection and not in special information for the files the program JUPFAST is avaiable. it works the same way like JUP, but with the limitations mentioned above. It uses the compiled files JUP.ECX, JUP.ECR and JUP.ECS. it is fast because the detection of files which can not be extracted will be left out. ---------------------------------------------------------------------------- JEN SOFT SYSTEMS, Inc. JUP I-4 PROGRAM DESCRIPTION ---------------------------------------------------------------------------- option /i --------- if you only gives an archive name parameter or selects the /i option, the archive identification would be displayed like: processed file : \ARCHIVE\VGALINES.EXE file structure : ??? processed file : \ARCHIVE\!F2C.ZIP file structure : ZIP File :-) checked 2 files, identfied 1 files option /l , /v -------------- if you want to list the arc contents you must use the /L option like: JUP bigmon.arj /L processed file : \ARCHIVE\BIGMON.ARJ file structure : ARJ File ARJ 2.41a Copyright (c) 1990-93 Robert K Jung. Jul 10 1993 Filename Original Compressed Ratio DateTime modified ------------ ---------- ---------- ----- ----------------- BIGDESK.DOC 1610 848 0.527 91-12-04 18:11:18 BIGDESK.EXE 23555 9567 0.406 91-02-22 11:48:22 BIGDESK.TXT 431 294 0.682 91-08-02 01:49:34 ------------ ---------- ---------- ----- 3 files 25596 10709 0.418 :-) mached 1 files, prepared 1 file listings option /q --------- this option prevents displaying all lines starting with þ and the messages "unknown archive type " and "non supported option". if you want to see no output you can redirect the JUP-Output to any device you want like: JUP *.* > NUL . ---------------------------------------------------------------------------- JEN SOFT SYSTEMS, Inc. JUP I-5 PROGRAM DESCRIPTION ---------------------------------------------------------------------------- option /d , /s -------------- this option allows to display files to the screen, which are included in the archive. e.g. JUP sc*.* /D *.diz processed file : \ARCHIVE\SCN-224E.ZIP file structure : ZIP File PKUNZIP (R) FAST! Extract Utility Version 2.04g 02-01-93 Searching ZIP: /ARCHIVE/SCN-224E.ZIP Inflating: FILE_ID.DIZ VirusScan for DOS by McAfee, Inc. Scans and cleans PC's/LAN's for known and new viruses. Requires DOS 3.0+. Version 224 (9507) 07-13-95 :-) mached 1 files. prepared 1 file views option /f ( * default for JUPFAST *) --------- this option will fasten up the identify process, because non extractable archive types will not be checked. option /t --------- this option support the testing of the archive integrity, so you are able to find out, wether the archive is ok or not. option /x , /e -------------- with this option the given archive would be extracted. if the included files exists, the unpacking program to not overwrite the existing files. some unarcing program do not support this option and overwrites always. ---------------------------------------------------------------------------- JEN SOFT SYSTEMS, Inc. JUP I-6 PROGRAM DESCRIPTION ---------------------------------------------------------------------------- option /r , /o -------------- this option means, that the given archive would be extracted and existing files would be overwritten, if the unarcing program supports this option. like the /x option, normally the actual path is used for extraction. option /p --------- with this option you are able to extract the archive files into the paths, which are embedded in the archive. This only works for unarcers, which supports this option and if paths were embedded during the arcing process. option /c (* not avaiable for JUPFAST *) ----------------- with this option you force JUP, to start the configuration process. normally JUP only starts the configuration process, if the files JUP.ECX, JUP.ECR or JUP.ECS could not be found. Then the ASCII file JUP.DAT would be searched and "compiled" to JUP.ECX, JUP.ECR and JUP.ECS. You are able to add or change the configuration for your own working environment, if you use another file than JUP.DAT, e.g. EXE.DAT. Read the chapter configuration for more. option /u ----------------- normally JUP uses the files JUP.EC? for the identification process. with this option you can choose another configuration files e.g. /uEXE will force JUP to use EXE.EC?. suboption /#+, /#- (* not avaiable for JUPFAST *) ------------------ # : one of [i,e,x,d,s,l,r,t] this suboption turns the switch on or off to show the subversions information instead of the short one (if avaiable) e.g.: processed file : \BOXEN\TEST2.COM DOS file size : 49232 file structure : Lharc 1.14a Self Extract File "or" LH(arc) ---------------------------------------------------------------------------- JEN SOFT SYSTEMS, Inc. JUP I-7 DESCRIPTION ---------------------------------------------------------------------------- option /g ----------------- with this option you can give the password for encrypted files. option /w ----------------- with this option you can choose an output directory, if you want and it is an supported option of the unarchiving program. the default directory name is the filename without extension. option /h (* not avaiable for JUPFAST *) --------- this option shows you the current configuration included in the files JUP.ECX, JUP.ECR and JUP.ECS like the following example: JUP 1.71 (C)opyright 1994-96 Jens Weynans. All Rights Reserved. Feb. 1996 1.sfx ARX 2.SFX ARJ 3.sfx ARJ 4.SFX RAR 5.SFX PLL 6.SFX UC2 3*SFX LHA 3*sfx LZH 9.sfx LZS 10.SFX SQZ 11.sfx ZIP 12.SFX ZIP 3*SFX ARC 14.SFX PAK 15.SFX DWC 16.SFX JRC 17.SFX CHZ 18.SFX ARK 19.SFX PAC 20.SFX SMH 21.SFX ZOO 23*ComPressed EXE 2*NEW EXE 3*DOS DRIVER 3*DOS EXE 26.DOS COM 27.NLM 28.ARC7 29.PAK 30.HYP 31.PLL 32.ARK 33.CHZ 34.YAC 35.ARC 36.ARJ 37.HA 38.GZIP 39.COMP 40.ARX 41.MAR 42.LHA(rc) 43.LZS 44.PutGet 45.HAP 46.LIM 2*LBR 48.MD 2*Codec 50.HPK 51.KAT 2*UC2 53.TAR(?) 54.ZIP 55.ZOO 56.SQZ 2*RAR 58.SAR 59.DWC 60.ZAR 61.JRchive 62.Jarcs 63.BSA 64.ARI 65.PAC 66.Quantum 67.Crush 2*AIN 69.PSA 70.Sonarc 71.VocPak 72.Sqwez 73.Shorten 2*MsComp 2*OpSmash 76.PnPack 77.IbmPack 78.MsCab 79.AMG 80.MacPit 81.Amiga 82.Swag 83.PGP 84.RSC 85.MSG 86.PCX 87.BMP 2*TIFF 89.IMG 90.GIF 91.WAVE 92.TXT(?) :-) configuration includes 92 file types and 133 identifiers. there is a difference between file types and the known identifiers, because you can have multiple identifiers for one program. for more information please read the configuration chapter in part II. ---------------------------------------------------------------------------- JEN SOFT SYSTEMS, Inc. JUP I-8 FINAL ---------------------------------------------------------------------------- The program will finish with an errorlevel, which can be used in batch programs: Errorlevel 0 : no errors. normal execution. Errorlevel 1 : only one file choosen. JUPARC- defined. (DOS ONLY) Errorlevel 2 : invalid options given. Errorlevel 3 : no archived files found. Errorlevel 4 : file .ECR not found or corrupt. Errorlevel 5 : file .DAT not found or corrupt. Errorlevel 6 : no unarchivers configured. Errorlevel 7 : program has been configured. Errorlevel 8 : file .ECX not found or corrupt. Errorlevel 9 : current configuration has been reported. Errorlevel 10: file .ECS not found or corrupt. Errorlevel 63: syntax / help has been shown. Errorlevel 77: program aborted by user. The program produces different outputs, like the following ones: :-( program PKUNPAK not found ! ; program was not found in the current configured path. :-( option not supported ! ; there is no valid configuration for this option. option depending final line output: checked 7 files, identfied 3 files. ; /I, /I+ matched 8 files, prepared 6 file extractions. ; /E, /X matched 8 files, prepared 6 file replacements. ; /R, /O matched 8 files, prepared 6 file tests. ; /T matched 8 files, prepared 6 file views. ; /D, /S matched 8 files, prepared 6 file listings. ; /L, /V unknown files shown like this: processing file : \CRASHED\~~~.DLF DOS file size : 323 file structure : unknown recognized exe files shown like this: processing file : \JUP\JUPWIN.EXE DOS file size : 72448 file structure : New Executable ("NE" Offset 9984) EXE part sizes : header 592 bytes, image 9360 bytes, overlay 62496 bytes ---------------------------------------------------------------------------- JEN SOFT SYSTEMS, Inc. JUP I-9 FINAL ---------------------------------------------------------------------------- THANK YOU ALL Thanks to all the people, organisations and sysops, who gave me programs, source code, ideas and support! - ORGANISATIONS - ftp.adelaide.edu.au, ftp.cpsc.ucalgary.ca, ftp.cso.uiuc.edu, ftp.kiae.su, ftp.nl.net, ftp.uni-padernborn.de, garbo.uwasa.fi, media-lab.media.mit.edu, oak.oakland.edu, rtf.mit.edu, ftp.vse.cz, ftp.wustl.edu, ftp.cco.caltech.edu, ftp.elf.stuba.sk, www.nettuno.it, Simtel.Coast.Net and some more - PEOPLE/SYSOPS/AUTHORS - (if not other mentioned, the persons are placed in Germany). Uwe Balser, Juergen Beckert, Bo Bendtsen (DK), Fabian Berger, Stefan Brueck, Jonathan Burt (UK), Ben Castricum (NL), Greg Flint (US), Alex Floeck, Oliver Fromm, Andreas Fruend, Jean Loup Gailly (F), Jeff Gilchrist (US), Horst Hackenbruch, Wilfried Hausmann, Pertti Heikkinen (SF), Dieter Heilenz, "Dingo Board" (NL), Andy Henkelmann, Christoph Herth, Gerd Hierold, Stefan Hildebrand, Torsten Hofmann, Sunghee Kim (US), Walter Konezna, Marco Kremer, Edgar Kuhly, Stefan Kuhn, David Lemson (US), Leonardus Leonardi (IND), Jochen Leufen, Chris Lueders, Kerwin F. Medina (US), Mirko Mucko, Jens Mueller, Ralph Punga-Kornbergs, Juergen Peters, Keith Peterson (US), Michael Riedmeier, Christoph Rockenstein, Robert Rothenburg (US), Phil Rottner, Erik Schmidt, Bruno Schmitt, Ryan Shaw (US), Andreas Soehnel, David Stafford (US), Hugo Voerman (NL), Oliver Weindl and many many more. - SOURCE CODE SPECIAL - * TPENV (C) SWAG SUPPORT TEAM * EXECSWAP (C) Kim Kokkonen & Bill Burleigh & Rich Cromer ---------------------------------------------------------------------------- JEN SOFT SYSTEMS, Inc. JUP I-10