UPDATE.TXT, ARJ 2.82 / ARJ32 3.11 OFFICIAL FULL RELEASE October 2003 This documents new or updated information since ARJ 2.70. Please refer to UPD260.TXT for older information about ARJ. See UPDATE32.TXT for information specific to ARJ32 our Win32 product for Windows NT/2000/XP specifically. ** IMPORTANT NEWS **************************************************** ** THE UNREGISTERED VERSIONS OF ARJ AND ARJ32 HAVE A VERY ** ** SHORT TIME DELAY AT THE START OF EXECUTION. ** ** ** ** AFTER A YEAR OR SO, THE UNREGISTERED VERSIONS WILL ** ** NOTIFY THE USER TO DOWNLOAD A NEWER VERSION. THE ** ** SOFTWARE WILL CONTINUE TO FUNCTION ALBEIT MORE SLOWLY. ** Unregistered ARJ self-extracting modules will display a shareware message with a time delay. This version of ARJ and ARJ32 has been significantly improved in the updating of multiple volumes and the testing of archives and chapter archives. Check the WHATSNEW.TXT file for specific details. ** THIS RELEASE OF ARJ USES A NEW REGISTRATION SCHEME WHICH ** ** OBSOLETES ALL PREVIOUS REGISTRATION KEYS BEFORE 2.70. ** ** YOU CAN OBTAIN A REPLACEMENT REGISTRATION KEY FROM ARJ ** ** SOFTWARE, INC. PLEASE PROVIDE AS PROOF YOUR OLD ** ** REGISTRATION KEY OR A PRINTOUT OR A SCREEN CAPTURE OF ** ** YOUR ARJ.EXE REGISTRATION DISPLAY. ** ** THE UNREGISTERED DEARJ DOES NOT SUPPORT VOLUMES. ** Several users have reported that various releases of ARJ have caused (false) VIRUS ALARMS from certain versions of Norton AntiVirus for Windows software. This release and all previous releases have been checked by Norton, and McAfee virus scanners. ** THIS RELEASE USES AN ENHANCED ARJ ARCHIVE HEADER FORMAT ** ** COMPATIBLE WITH PREVIOUS VERSIONS OF ARJ. HOWEVER, ** ** SOME THIRD PARTY ARCHIVER MENU PROGRAMS MAY NOT BE ** ** COMPATIBLE WITH ARCHIVES PRODUCED BY THIS ARJ VERSION. ** ** The wildcard matching algorithm used by ARJ to search ** ** within archives has been changed to match standard ** ** Windows 9x usage. In other words, "*" matches all ** ** filenames and "*.txt" matches files.int.txt. ** The ARJ.TXT section on building self-extractors has been moved to a separate file called SFX.TXT and rewritten for more clarity and better organization. The ARJ file header has been lengthened by a number of bytes to support additional file properties. The new "-j$" option will disable this new header enhancement. However, some of the new header space is used to save file size information in multiple volumes so that the "-u2" option and the ARJ "ac" chapter command work more efficiently. It is RECOMMENDED that you run the TESTARJ.BAT batch file to verify that this version of ARJ.EXE is compatible with your computer system. The mailing address of ARJ Software, Inc. has changed as of August 1993. ARJ Software, Inc. P.O. Box 249 Norwood MA 02062 USA FAX: 781-769-4893 EMAIL: robjung@world.std.com There is ARJ Web site support information added to the file ARJ.TXT. It is excerpted below: http://www.ARJSOFTWARE.com (ARJ homepage) http://www.Dunkel.de/ARJ (German and English) http://www.tsf.be (French and English) You can find information about the world of ARJ on the Internet by using various search sites including www.altavista.com, www.yahoo.com, and www.dejanews.com. Our credit card ordering procedures have changed. We now process credit cards directly. ********************************************************************** KNOWN ISSUES The "-jn" option does not work properly WHEN updating a multiple volume archive. The "-jn" option was designed for restarting a new multiple volume archive build after a halt. A fix is being considered. ARJ and ARJ32 will not handle total file size calculations correctly when the totals exceed 2 GBytes. This is only a cosmetic display issue. Selecting a large ARJ-PROTECT factor "-hkX" for a multiple volume build with very small volumes may result in a malfunction due to the size of the ARJ-PROTECT recovery data relative to the volume size. But this is a very uncommon situation. A fix is planned. The ARJ move command now deletes files at the end of a multiple volume build process rather than after each volume. This costs more disk space during ARJ processing. The "-d2" option allows deletes after each volume as before but this is not reliable for archive update commands such as D, F, and U. WINZIP COMPATIBILITY Winzip 7.0 has compatibility issues with the copyright header of ARJ 2.70 and 2.71. With this release, the header was modified to allow compatibility with Winzip 7.0. Winzip 8.0 does NOT have this compatibility issue with ARJ 2.70 and 2.71. ARJ32.EXE is not supported by Winzip at this time. However, if you rename ARJ32.EXE to ARJ.EXE, Winzip should support it. However, if you want to avoid this problem, I recommend Total Commander from http://www.ghisler.com. Total Commander supports the ZIP, ARJ, RAR, CAB, TAR, and other archive formats. ARJ YEAR 2000 COMPLIANCE STATEMENT See the file YEAR2000.TXT. ARJ YEAR 2000 IMPROVEMENTS (new at 2.70) This version of ARJ has been modified to allow the specification of the century for the ARJ date options "-o" and "-ob". Prior to this version, the ARJ date options would accept a date in the form of YYMMDD. With this version, ARJ will accept dates in both YYMMDD and YYYYMMDD formats. ARJ will presume that any year specifications beginning with 19, 20, and 21 are YYYY type specifications and any year specifications beginning with 80, 81, 82 .... 99, 00, 01 .... 18 are YY type specifications. Example: -o980105 -> on or after Jan 5, 1998 -o19980105 -> on or after Jan 5, 1998 -o100105 -> on or after Jan 5, 2010 -o20100105 -> on or after Jan 5, 2010 -o201001051200 -> on or after Jan 5, 2010 12:00 P.M. -o100105 -> on or after Jan 5, 2010 12:00 A.M. ARJ-PROTECT ARCHIVE DAMAGE PROTECTION (new at 2.70) ARJ has a feature "-hk" (since 2.60) where archive data damage protection information can be saved when an archive is built. This damage information can be used to repair slight amounts of damage to either the archive header or file data. The competitive product PKZIPFIX only fixes directory damage, not file data damage. This protection data must be created before the archive becomes damaged. New to this release is the enhancement of ARJ-PROTECT where the damage protection data is appended to the archive instead of being saved as a separate file (*.XRJ). In addition, once an archive is ARJ-PROTECTED, ARJ will automatically ARJ-PROTECT that archive during future updates with the level of protection originally used (-hkX). It is STRONGLY recommended that this option be used on important archives and on archives saved on diskettes. Frequently used diskettes are notorious for developing bad sectors and corrupting data. The cost for this feature is some extra computer time and about a one percent increase in archive file size. See the "-hk" section of ARJ.TXT for more information about this feature. ARJ VOLUME NAMING OPTIONS (new at 2.71) By default, ARJ has been naming successive volumes in a multiple volume archive by using a numeric file extension (archive.ARJ, archive.A01, archive.A02, and so on). Because the file extension changes, this naming scheme may not be appropriate in an Internet environment. Some browsers will not properly download an ARJ archive with the normal LEFT mouse click. Most browsers will properly download an EXE file with a LEFT mouse click. New to ARJ 2.71 and ARJ32 3.04 is an OPTIONAL naming scheme that maintains the initial file extension (EXE or ARJ) and numbers the filenames. This option is set with the "e" option for "-v". Examples: ARJ a archive -ve1440 => archive.ARJ, arch001.ARJ, arch002.ARJ, .... ARJ a archive -je -ve1440 => archive.EXE, arch001.EXE, arch003.EXE, .... ARJ a name001 -je -ve1440 => name001.EXE, name002.EXE, name003.EXE, .... If the base archive name ends with a number, ARJ will use that number as the base volume number. When building a multiple volume self-extractor using the "-ve" option, ARJ will put the self-extractor ONLY in the first volume. Successive EXE volumes will include an EXE stub that displays a usage message. Versions of ARJ before 2.71 and ARJ32 before 3.04 will not be able to process these alternatively named multiple volume archives. Use of the self-extractor avoids this problem. VERY LARGE ARCHIVES Because of the limitations of the DOS file system, ARJ and ARJ32 will only build archives up to 2,000,000,000 (2000M) bytes in size. When creating a new archive with files whose total size is greater than 2,000,000,000 bytes, ARJ will automatically create volumes as needed. ARJ and ARJ32 will not handle total file size calculations correctly when the totals exceed 2 GBytes. WINDOWS 98/ME SUPPORT ARJ 2.60 and above supports Windows 98 and Windows Millenium. In this document, references to Windows 9x include Windows 95, Windows 98, and Windows Millenium. LONG FILENAME SUPPORT ARJ versions 2.60 and above support long filenames ONLY in the Windows 95/98/ME graphical environment. ARJ 2.x does NOT support long filenames in Windows NT, 2000, NTFS, or OS/2. ARJ is a DOS program that uses the special DOS hooks available in Windows 9x to access the long filenames. This means that long filename support will not be available via some software driver add-ons if they do not provide the necessary DOS hooks. There is now a 32 bit console mode version of ARJ32 that supports Win 9x and Win NT and Win 2000 long filenames. It is available from our website. The 32 bit version provides full long filename support wherever Windows itself supports long filenames. This is not always the case for the DOS version of ARJ. REMINDER: When specifying filenames with embedded blanks or symbols like ">", "<", or "|" on the command line, you MUST quote the filenames. Example: "Program Files\*.*" When specifying a target directory name that contains spaces, you must quote the directory name. If the name specification ends in a "\" backslash (needed for a non-existent directory), you must insert a space after the "\". Alternatively, you can use the "-ht" option. Example: ARJ x archive "C:\Program Files\ " or ARJ x archive "-htC:\Program Files" In addition, ARJ 2.62 and up supports the Win9x file properties date-time accessed and date-time created. This support results in slightly larger archives. The "-j$" option can be used to disable this new feature. ARJ does not support the file attributes of TEMPORARY or COMPRESSED. REMINDER: The small ARJ self-extractor (ARJSFXJR) created with the "-je1" option does NOT support Windows long filenames. Use the "-je" option instead. WINDOWS LONG FILENAME LABELING A very noticeable change is how ARJ archives files within Windows 9x. In 2.60, ARJ would label/mark all files saved in Windows 9x as Windows long filename files. In 2.61 and above, ARJ will label as Windows long filename files only those files whose Windows 9x filename is different from its MS-DOS filename. Note that "NAME.txt" is NOT the same as "NAME.TXT" because of case. As an aid, ARJ will display the count of long filenames encountered when adding files or listing an archive. The longname test is done based upon the filename or pathname specified by the user. Filenames within a longname directory would not necessarily be labeled as Windows long filenames if the filename specification excluded the directory name. The new "-hf4" option will set ARJ to label all files saved under Windows 9x as Windows long filenames (as in ARJ 2.60). To help locate Windows 9x files within an archive, ARJ has a new "w" option for the "-hb" option. For extraction, deletion, and listing, the "-hbw" option will select only files that are marked as Windows long filenames files. This option is non-functional for adding or updating files. It is limited to selecting files within an existing archive. This option is useful when extracting an archive in MS-DOS and encountering one or more "Requires Win95/98 or -hf...." error messages. The user would be able to view the files that are affected and take appropriate actions. Example: ARJ x archive *.* (assume some Win9x errors) ARJ x archive *.* -hf1 Windows 9x DOS support (and therefore ARJ) do not support access to long filenames containing certain characters. For example, a filename containing the copyright symbol or the trademark symbol cannot be accessed in a Win9x DOS window with the COPY command or with ARJ. These type of filenames can only be accessed via their short names. The Win9x system normally stores filename characters as two bytes per symbol allowing an alphabet of 65536 possible symbols. Because Win9x DOS only uses one byte per character position allowing only a 256 symbol alphabet, many characters are displayed by Win9x DOS as "_". UNIVERSAL NAMING CONVENTION (UNC) ARJ supports archiving filenames using UNC paths. By default, ARJ will remove the leading "\\" symbols to allow ARJ to treat the pathname as a relative pathname. The use of the "-jf" option will set ARJ to keep the "\\" symbols. The "-jf1" will remove the leading "\\" symbols. UNC pathnames stripped of the "\\" can be restored to their network paths with "ARJ x archive \\". MULTIPLE VOLUME CHAPTER ARCHIVES Please note that deleting files or purging old chapters from a multiple volume archive is not recommended. With a multiple volume archive, deletions do not save space, so deletions are not useful. COMPATIBILITY WITH ARJ32 A new program ARJ32 for Windows 95/98/ME/NT/2000 is now available. ARJ32 has been designed to support the Windows 32 bit environment. It is generally compatible with ARJ for DOS (2.xx). However, ARJ32 has an option to use the ANSI codepage to access the file system instead of the default OEM codepage. This ANSI codepage option would most likely be chosen by users using languages containing foreign symbols. Archives created using the ANSI codepage may not be processed correctly by ARJ for DOS because of a filename translation issue (ANSI to OEM codepage). Special symbols and foreign characters may not be translated correctly. In addition, ANSIPAGE archives have an additional compatibility issue with versions of ARJ from 2.30 and earlier. Those versions will treat ANSI codepage archives as CORRUPTED ARJ-SECURED archives. This should not be an issue since ANSI codepage archives should not be processed by ARJ for DOS. ARJ 2.62c and above will not process such an archive unless the "-hy" option is specified. ARJSFX/ARJSFXV POST EXTRACTION EXECUTION OPTION For software distributors, this version of ARJ provides for the execution of a command after self-extraction. The ARJSFX and ARJSFXV modules support the execution of a command after a successful extraction. The ARJSFX and ARJSFXV modules support the "-!" option which allows the user to build a self-extractor which will execute a command after its files are successfully extracted. This option is most useful with the embedded command line feature. The command must not contain any blanks if it is used in the embedded command line. If a target directory is specified, the target directory will be set as the working directory for the post-extraction command. Example: )) C:\DIR\ -!SETUP.EXE The above example will cause the command "SETUP.EXE" to be executed in the directory C:\DIR. Please note that the user will always be prompted by the self-extractor for permission to execute this command. This prompt is disabled for ARJ-SECURED self-extracting archives. ARJSFX/ARJSFXV VIRUS CHECK Both the ARJSFX and ARJSFXV self-extractors now perform a simple virus damage check before processing the self-extractor's archive. If damage is detected, the self-extractor will abort with an error message indicating possible damage. This check will not work against a virus designed specifically to attack ARJ self-extractors. The ARJSFX self-extractor has a "-s" option to skip this virus check. The ARJSFXV self-extractor has a "-a" option to skip the virus check. You can include the above skip option as part of a custom built-in command line. ARJSFX/ARJSFXV VERIFY BEFORE EXTRACTION OPTION Both the ARJSFX and ARJSFXV self-extractors now accept the "-x" and "-t" options simultaneously to enable the testing of an archive just before extracting the archive. Example: )) C:\DIR\ -x -t ARJSFXV PASSWORD PROMPT A garbled ARJSFXV self-extracting archive will automatically prompt the user for the password when extracting or testing the archive. You must use ARJ 2.61 and above to create the garbled archive as well as create the ARJSFXV self-extractor. Example: ARJ a vendor *.* -gpassword -je -v360 NOTE: If you create a garbled archive with ARJ 2.61 and above and add ungarbled files and then delete the garbled files, ARJ will continue to mark the archive as a garbled archive. Currently, only the ARJSFXV module takes note of this marking. ARJSFX AND ARJSFXV SUPPORT FOR FILE DTA AND DTC PROPERTIES The ARJSFX and ARJSFXV self-extractors will restore Win9x file date-time accessed and date-time created properties from an ARJ archive that contains those file properties. ARJ 2.62 and up can create such an archive. This feature will only work within the Win9x GUI environment. The "-j$" option can be used to disable this support. This file DTA support has a limitation in that it cannot restore the time field. This is not a limitation for ARJSFX32. ARJSFX AND ARJSFXV SUPPORT FOR LONG FILENAMES IN WINDOWS 2000/XP The ARJSFX and ARJSFXV self-extractors will restore long filenames in Windows 2000 and Windows XP when the "-+" option is specified. This is set up as an option currently because this function uses features which are not documented for Windows 2000 and XP. ARJ COMMAND LINE SHORTCUT (new at 2.62) New to ARJ 2.62 and up is the expansion of command line directory names to full wildcard specifications. However, this feature will only work properly if the first filespec on the command line is NOT a directory. The ARJ placeholder "..." can be used for that first filespec. A directory name used as the first filespec will result in that directory being specified as the TARGET directory and affecting subsequent filespecs. Example: ARJ a archive ... DIR1 dir2 dir\dir3 is equivalent to ARJ a archive DIR1\*.* dir2\*.* dir\dir3\*.* Example: ARJ a archive DIR1 dir2 dir\dir3 is equivalent to ARJ a archive DIR1\dir2\*.* DIR1\dir\dir3\*.* ARJ CONFIGURATION FILE (new at 2.72) The ARJ configuration option specified by "set arj_sw=c:\arj.cfg" or similar will now accept the commands: "ac", "cc", "dc", "lc", and "vc". At ARJ 2.73 is a new "-" (minus) symbol option in the configuration file. The "-" symbol works similarly to the "+" symbol except that its associated switch string is PRE-pended to any subsequent command switch string. This symbol should be more useful than the "+" symbol. ARJ.CFG contains: a -jm1 -jt -i1 - -i e -i- AND is equivalent to: a -jm1 -jt -i1 e -i -i- all other commands use -i ARJ RESPONSE FILE ARJ supports the specification of the "-g" and "-g?" options on the command line along with a response file specification. Using this feature is more secure than putting a password specification within an ARJ response file which is written to disk. SHAREWARE LIMITATIONS After ARJ version 2.41a, full functionality of a small set of ARJ software features MAY be limited to registered users. The most significant limitation is the 50,000 filename limit in the unregistered version. The registered version can handle up to 260,000 filenames at one time. However, for evaluation purposes, ARJ/ARJ32 will process up to the larger limit when using the -j#1 option. Note: unregistered ARJ can handle up to 100,000 files. Example: ARJ a archive c:\*.* d:\*.* -r -j#1 Note that using the option "-j#1" does not store any of the contents of the files. Only the name, date, and size is stored. REGISTER STAMPING ARJ *** REMINDER: ARJ 2.7x and ARJ32 use a new registration scheme *** which obsoletes all previous registration keys. If, when you purchase an ARJ license, you choose to receive your ARJ key by email, you will need to put the emailed key data into a file named REGISTER.DAT in the same directory as the ARJ software programs. Then you need to execute REGISTER.EXE with either the -ARJ option or the -ARJ32 option depending upon your software. Please note that the registration key for ARJ does not work with ARJ32 and vice-versa. A more detailed explanation can be found in the file REGISTER.TXT. ENCRYPTION New to version 2.60 is a new encryption scheme based upon the Russian encryption algorithm (GOST 28147-89 cipher). This algorithm is similar in design to DES; however, GOST is designed for software implementation. GOST 28147-89 uses a 256 bit key and 32 rounds of encryption. In addition, this implementation of GOST also uses the 64 bit cipher feedback mode. This new encryption is accessed by using the "-g" option to specify the password and the "-hg" option to specify the new scheme. This new scheme is in addition to the older XOR garble scheme. The encryption module is a separate COM file named ARJCRYPT.COM. ARJ expects to find the encryption module in the same directory as itself. This has the advantage of saving space with the ARJSFXV module and the DEARJ.EXE module when encryption is not needed. You simply do not include the encryption module in the archive when not using encryption. At this release, support for a new version of ARJCRYPT.COM has been added. This new version will support passwords up to 64 characters in length. ARJCRYPT version 1.0 only supports passwords up to 32 characters in length. This release of ARJ can ONLY use ARJCRYPT.COM version 2.1. ARJ 2.60 can use the new ARJCRYPT.COM version 2.1, but it will display a warning message indicating that ARJCRYPT is not a standard ARJ garble module. ARJ 2.60 will still not be able to use more than 32 character passwords. The encryption overlay module is not included with this version of ARJ. Because of USA export regulations, ARJ Software, Inc. may not export the encryption overlay module from the USA. It is available on the ARJ website for USA users only. ** Please NOTE that losing your password means losing your file! ** Please DO NOT ask for technical support on lost passwords. ** There is no shortcut/backdoor for determining lost passwords. New to ARJ 2.61 and up is a limited key size version of GOST encryption. ARJ now provides a "-hg!" option which invokes the built-in 40 bit key version of the Russian GOST encryption algorithm. The normal GOST algorithm has a 256 bit key size. This limited encryption is provided to meet USA encryption export rules. The "l" command will now indicate the type of encryption method used. See the "l" command below for more details. ARJ CAUTIONS Whenever archiving to diskettes, it is HIGHLY recommended that the option "-jt" be used. This helps spot BAD diskettes or BAD diskette drives. It is HIGHLY recommended that the "-jt" option be used in a Windows or multi-tasking or network environment. In addition, the diskette drive should NOT be read or write cached. This allows the "-jt" option to work properly. For Windows 9x, ARJ.EXE at 2.61 and up automatically forces a re-read of the diskette drive. The XMS accelerator in Hurricane 2.0 MAY interfere with the use of the ARJ -hm! option within a Windows DOS box. You can use the -hm option instead. UNERASE or UNDELETE commands do not always recover a file/archive correctly. This will result in damaged archives. This is true for all archive types. You should always test an archive after unerasing it. CAUTION: To those who use the "-t1" and/or "-t1g" options to save a few extra bytes, this option should only be used on TEXT FILES. Those are files created by EDLIN, EDIT, QEDIT, BRIEF, NOTEPAD, and others. Text files typically contain only letters, numbers, spaces, and punctuation marks. WORD PROCESSOR format files ARE NOT TEXT FILES! MS WORD, Wordperfect, AMIPRO, WRITE, and similar files ARE NOT TEXT FILES. Using the "-t1" or "-t1g" on any other kind of file probably will result in DATA LOSS! ARJ ERRORLEVELS ARJ will now return a DOS error code of 11 for a user control break action. ARJ formerly returned a code of 2 for this situation. ARJ will now return a DOS error code of 12 when trying to modify a chapter archive that already has 250 chapters in it. ARJ formerly returned a code of 2 for this situation. ARJ COMMANDS "g" command At ARJ 2.62d and up, you can use the -hg or -hg! option to encrypt an archive using the GOST algorithm. Only archives that are ungarbled and created with ARJ 2.62 or higher can be garbled with the -hg or -hg! option. "j" command With the addition of new encryption functions, it is important to not mix encryption methods when joining archives. This current version of ARJ will attempt to prevent that. In addition, the dual-name and codepage properties should not be mixed by the join command. You should only join archives that have been created with very similar options. "k" command The "k" command can now be set to purge a specific number of chapters using the "-jbN" option. Example: ARJ k archive *.* -jb3 purge the first 3 chapters "l" command "v" command ARJ will display the count of files selected within an archive that have Windows long filenames. The listing format has been changed to better indicate the century years. Instead of a "+" symbol to indicate the year 2000, ARJ will now display a " " for year 2000, a "1" for the year 2100. This character appears immediately before the date-time field. The "v" command will now display Win9x file date-time accessed and file date-time created properties and physical disk size if they exist in the archive. If the physical disk file size is equal to the original file size value, then an "=" symbol will be displayed instead. As of ARJ 2.62d, the output under the "G" of the BTPMGUX area is changed. Instead of a simple "G" to indicate that the file is garbled, that field may contain the values "0", "1", "2", "3", or "4". "0" indicates XOR garbling (archives created before 2.60). "1" indicates XOR garbling (archives created at 2.60 and greater). "2" indicates GOST encryption with a 32 byte password limit. "3" indicates GOST encryption (ARJCRYPT.COM 2.1) 64 byte limit. "4" indicates 40 bit encryption limit. "m" command The move command in multiple volume adds/updates now processes the file deletions after the multiple volume add/update process has completed. This will require more disk space for some situations than older versions of ARJ required. This may change based upon user comments. "dc" command This command will now only accept "*.*" as the filespec. Example: ARJ dc archive *.* "lc" command This is a new two character command for ARJ. It is actually an abbreviation for the following command and switch option: "l -jb* -hbc". The "lc" command will list the chapter labels stored in the archive. This is a quick way to see what backup chapters are stored in the archive and when they were created. Example: ARJ lc archive "v" command ARJ now displays if available the physical disk file size of volume split files and text mode files "-t1" along with the DTA/DTC date fields. If the physical disk file size is equal to the "original size" value, then an "=" symbol will be displayed instead. If the physical disk size field is blank, there is no value stored and displayed for that field. "vc" command This is a new two character command for ARJ. It is actually an abbreviation for the following command and switch option: "v -jb* -hbc". The "vc" command will list the chapter labels and comments stored in the archive. This is a quick way to see what backup chapters are stored in the archive and when they were created as well as any comments about those chapters. Example: ARJ vc archive "y" command When the "y" command is used with the "-g" option to ungarble an archive, ARJ will automatically test the archive after the ungarble. If the test fails, ARJ will abort the ungarble. There is no option to bypass this test. ARJ SWITCHES "-d2" switch The "-d2" switch is used with the "A" command to provide a "M"ove command that deletes files after each archive volume is created as was the behavior of ARJ before version 2.81. This saves file space but it is not as reliable when updating existing archive volumes. Example: ARJ a archive *.* -v1M -d2 "-f4" switch The "-f4" switch works like the "-f2" switch except ARJ will use the text mode file size instead of the physical disk file size. This is useful when updating archives with text files on a PC and on a network drive from a Unix system. "-g" switch The garble option in this version of ARJ has three versions. One is the original version found in earlier ARJ releases. It is compatible with older versions and works like those versions. The second garble version uses a separately available encryption module. This new option is accessed by using the new "-hg" option. This option sets ARJ to use the separate encryption module to encrypt the data. By default, ARJ will look for the file "ARJCRYPT.COM" in the same directory where the ARJ.EXE being executed is found. The user may specify the pathname of the module to use. Examples: ARJ a archive *.doc -gThis_is_a_password -hg ARJ a archive *.doc -gpassword -hgc:\dir\enc.com The new garble option accepts a password key up to 64 characters long. Excess characters are ignored. Garble passwords ARE CASE SENSITIVE! DO NOT LOSE your password! There is no known method to recover the password other than by brute force, which could take a very long time. The longer the password, the longer it would take to "guess" it. ARJ 2.60 which also accepts the "-hg" option will only handle this garbled archive if the password is 32 characters or less. ARJ 2.60 can use ARJCRYPT.COM version 2.1; however, it will display a "Not a standard module" warning message. A variation of the "-hg" option is "-hg!". This "-hg!" option accesses a built-in version of GOST that is limited to a 40 bit key size. This algorithm is designed to meet USA encryption export rules. These new encryption schemes are not compatible with the "-g" option of pre-2.55 versions of ARJ. If you want to maintain compatibility with pre-2.55 versions of ARJ, you should NOT use the "-hg" option. Only the multiple volume self-extractor (ARJSFXV and ARJSFX32) supports the new encryption module. When garbling or ungarbling an existing archive, ARJ will detect the method of encryption previously used and select that same method regardless of whether the "-hg" option is specified or not. "-l!" switch The "-l!" switch forces ARJ to append the list of filenames to be archived to the specified filename instead of overwriting it. Example: ARJ a archive c:\*.* -r -l!names.lst "-oa" switch The "-oa" and "-oab" switches allow the user to select files under Windows 9x based upon file date-time last accessed. "-oa" selects files after the date value, "-oab" selects files before. This ARJ version does NOT support combining "-o", "-oa", "-oc" with one another. You can combine "-oa" with "-oab". Archived files without the stored DTA attribute (-j$) will not be selected. "-oc" switch The "-oc" and "-ocb" switches allow the user to select files under Windows 9x based upon file date-time created. "-oc" selects files after the date value, "-ocb" selects files before. You can combine "-oc" with "-ocb". Archived files without the stored DTC attribute (-j$) will not be selected. "-od" switch The "-od" and "-odb" switches allow the user to select files based upon the number of days before today. The "-od" switch allows the user to select files modified on or after the specified number of days before today. The "-odb" selects files before the specified number of days. You can combine the "-od" and "-odb" switches. Example: ARJ a archive -od5 5 days old or less "-os" switch The "-os" and "-osb" switches allow the user to select files based upon the file size. The "-os" switch allows the user to select files greater than or equal to the specified file size. The "-osb" switch is used to select files smaller than the specified file size. These two switches can be combined. They can also be combined with any one set of date selection switches. Examples: ARJ a archive -os100K -osb100M Files >= 100K and < 100M ARJ l archive -osb10K Files < 10K NOTE: With multiple volume archives created by versions of ARJ before ARJ 2.81 and ARJ32 3.10 or created with the "-j$" option, ARJ will not select any split files based upon size. "-q" switch This switch causes ARJ to prompt the user prior to acting upon each archived file for following commands: "a", "c", "d", "e", "f", "g", "p", "r", "u", "x". This allows you selectively to delete, add, etc. Note: As of ARJ 2.81 and ARJ32 3.10, ARJ will try to limit its queries for subsequent portions of a file split across volumes for add and extract operations. "-u4" switch The "-u4" switch works like the "-u2" switch except ARJ will use the text mode file size instead of the physical disk file size. This is useful when updating archives with text files on a PC and on a network drive from a Unix system. "-v" switch At this release, ARJ will automatically handle the volumes past ninety-nine and one hundred by changing the suffix to .100, .101, .102, and so on. New to ARJ is a simple delete option "D" when creating volume archives. For SAFETY REASONS, this delete option is limited in scope and specification. The exact file or files (via wildcard) must be specified. A directory name is not sufficient (A:\ or C:\TEMP). A filename or wildspec is required (A:\*.* or C:\TEMP\*.TXT). In addition, this delete option does not delete through (recurse) subdirectories. In other words, this delete function works similar to the DOS DEL command except that a filespec is required. ARJ accepts all characters after the "D" option as the filespec. Examples: ARJ a a:archive -vada:\*.* ARJ a testvol -v1440dtestvol.a* At ARJ release 2.71 and ARJ32 release 3.04 is an "E" option to set an alternate naming scheme for multiple volume archives. Instead of naming succeeding volumes with a numeric file extension, ARJ can overlay the three digit numeric sequences before the DOT file extension. Examples: ARJ a archive -ve1440 => archive.ARJ, arch001.ARJ, arch002.ARJ, .... ARJ a archive -je -ve1440 => archive.EXE, arch001.EXE, arch003.EXE, .... ARJ a name001 -je -ve1440 => name001.EXE, name002.EXE, name003.EXE, .... New to ARJ 2.81/ARJ32 3.10 is the "rr" modifier. This reserves disk space on all volumes. The number after the "rr" specifies the space to reserve. You can use the "r" and "rr" modifiers at the same time. Example: ARJ a install -varr50K save 50k bytes on all volumes "-w!" switch This switch will force ARJ to use a temporary work directory ONLY when archiving to removable media such as a diskette. Otherwise, ARJ will ignore this option. Example: ARJ a a:archive -w!c:\temp *.* -jt Typically, this option would be used in an ARJ configuration file or a batch file. "-h#" switch This feature has been modified to use only the last two digits of the year. So the year 2010 will be represented by "10". This will still provide "uniqueness" for filename generation. Daily created archives will not collide name-wise for 100 years. "-h$" switch This feature forces ARJ to attempt to use Win95 DOS long filename support functions under other operating systems such as Windows 2000. Apparently, Windows 2000 provides some of the DOS program longname functionality that Windows 95/98 provides. This switch option forces ARJ to try to access Windows 2000 long filenames. Windows NT does not provide these DOS long filename functions. ARJ Software provides this option as a result of user requests. However, since this DOS access hook is not an official Windows 2000 feature, we cannot provide technical support for this feature. We do provide the program ARJ32 to fully support the Windows 32 bit environment (including long filenames) in Windows 95, 98, NT, ME, and 2000. "-hb" switch This switch is used to select by file attribute or file type. The "-hb" option can be used to select files by their attributes (normal, readonly, hidden, system, directory, and archive bit). "Normal" is defined as files that are NOT the following: readonly, hidden, system, label, chapter header, or directory. For extract/list operations, you can also select chapter labels and volume labels. By default, the "-hb" option by itself selects all types of files. If you specify a letter symbol representing a file type, you are selecting ONLY that type of file. You can specify a series of letters representing all of the file types that you want to select. For example, the "-hbdr" option selects both directories and readonly files. Selections are additive. Example: -hbnr select only normal and readonly files Single letters represent each attribute or type. a - archive bit set b - archive bit clear h - hidden r - readonly s - system d - directory n - normal files (not d, h, r, s, l, c) l - volume label c - chapter label f - abbreviation for "ndhrs" w - Windows long filenames The archive bit selection ("a" or "b") is a special case. If you have selected no types of files EXCEPT files with the archive bit set, ARJ will select from the set of all file types. If you have selected one or more file types, ARJ will select based upon the archive bit from the selected set of files types. Examples: -hbhrsa select hidden, readonly files with archive bit set -hba select all files with archive bit set Add/update options : f, d, r, h, s, n, a, b. Extract/list options: f, d, r, h, s, n, a, b, c, l, w. Examples: ARJ a archive *.* -r -hbrs select only readonly and system files ARJ a archive *.* -r -hbd store only directories ARJ l archive *.* -hbr list only readonly files ARJ l archive -jb* -hbc list chapter headers Notes: The option "-hb" with no letter options is an abbreviation for "-hbndhrslc" (all types). "-hf3" switch When building a dual-name archive, ARJ will now check for files that have long filenames inaccessible through MS-DOS. These are filenames that contain symbols that WIN9x/MS-DOS translates into the underscore "_" symbol. ARJ will display the "Can't open ..." error message for each such file encountered. "-hf4" switch This switch sets ARJ to label all files archived under Windows as Windows long filenames. "-hg" switch This switch is used to specify the filename of the encryption module to be used when encrypting a new archive. The default filename is "ARJCRYPT.COM". ARJCRYPT.COM contains a new encryption scheme that is partly incompatible with earlier releases of ARJ. This new scheme will accept passwords up to 64 characters. The old scheme accepted only the first 32 characters of a password. As long as your passwords are 32 characters or less, your archives will be compatible with ARJ 2.60 encryption. ARJ will look for the encryption module in the directory that contains the copy ARJ.EXE that is being executed unless the specified module name contains a path symbol "\" as in "ARJ\OLDCRYPT.COM". If you want to use a module in the current directory, you should specify the name as in ".\ARJCRYPT.COM". The "." indicates the current directory. With an existing archive, ARJ detects the encryption scheme that was used to encrypt the archive and uses the same scheme without the need to specify the type of encryption. However, if you encrypted with a non-default ARJCRYPT.COM, you must specify the pathname with the "-hg" option. This encryption module is available on the ARJ website for USA users only. "-hg!" switch This switch is used to specify the use of a built-in 40 bit version of the Russian GOST encryption algorithm. This algorithm is limited to a 40 bit key to meet USA encryption export rules. Any password input to this function will be crunched down to a 40 bit size. Only the first 32 characters of the password will be accepted. "-hk!" switch The "-hk!" switch sets ARJ to enable ARJ-PROTECT ONLY when archiving to removable media. Otherwise, this switch is ignored. Typically, this switch would be used in an ARJ configuration file or batch file. Examples: ARJ a a:archive -hk! ARJ a a:archive -hk!5 "-hm" switch At ARJ 2.62c and up, ARJ will by default set -hm3000. This means that if you are archiving over 3000 filenames, ARJ will use a disk file to manage the list of filenames. "-hq1" switch This switch sets ARJ to ignore the error that occurs when ARJ cannot open a file because it cannot be found during an add-type command and/or a compare command. This is DOS error code 2. This option applies only to files being added to a new archive and/or being compared. For an existing archive, this option will be ignored during the add operation, but NOT during a subsequent compare operation. This open error typically happens when a temporary file that ARJ has found to archive is purged by another process before ARJ can actually open and compress/compare it. This is not the same error as when a user specifies a filename on the command line and ARJ cannot find it. This error also occurs in Windows 9x when trying to archive files with filenames that contain "unusual" symbols. These are the symbols that have no equivalent in MS-DOS. MS-DOS displays those symbols as "_" underscore. If you use the "-ji" option to set up an index file, ARJ will log any file that it cannot open. "-hy" switch This switch will set ARJ to allow the extraction of ARJ32 created archives containing ANSI codepage filenames. ARJ for DOS always uses the OEM codepage which may translate ANSI codepage filenames incorrectly or not at all. Filenames containing only alphanumeric characters and the DOT symbol should be translated correctly. The default for ARJ32 is the OEM codepage. "-j#2" switch This switch will set ARJ to restore the file attributes to the selected files. No file will be extracted. Archives created with the "-j#" and "-j#1" options can also be used. "-j#3" switch This switch will set ARJ to restore the file dates (written, accessed, created) to the selected files. No file will be extracted. "-j#4" switch This switch will set ARJ to restore the file attributes and the file dates (written, accessed, created) to the selected files. No file will be extracted. "-j$" switch This switch will set ARJ to NOT save the file properties date-time accessed and date-time created and the new physical disk file size on disk field. This will save header size and result in a slightly smaller archive. During extraction, this switch will set ARJ to NOT restore the file properties date-time accessed and date-time created. "-ja2" switch This switch is used with the "ARJ P" command to force the filename to be displayed in the output display. This feature is intended with software tools for blind users. ARJ will generate a display similar to the following: Extracting BKC.BAT to STDOUT "-jb" switch The commands "ARJ d archive -jb" and "ARJ dc archive" will now ONLY accept "*.*" as the filespec. ARJ now supports the deletion of a file or files from ALL chapters. Example: ARJ d archive vers.txt -jb* removes all copies of vers.txt ARJ d archive *.exe -jb* removes all EXE files The "-jbn*", "-jbN-N*", "-jbN-*" options allow a user to extract/list only files that were newly added/updated to a chapter archive at the specified chapter or chapter range. With this option, ARJ will NOT extract other files that are present in the specified chapter or chapter range but were not newly added/updated in the chapter or range. Example: ARJ e archive *.* -jb5* In the above example, ARJ will only extract files that were newly added/updated in chapter 5. Other files in chapter 5 will NOT be extracted. This will let the user see what was updated in chapter 5. Example: ARJ l archive *.* -jb5 List only files that were added/updated in chapter 5. Example: ARJ e archive *.* -jb4-7* List only files that were added after chapter 5. Example: ARJ l archive *.* -jb6-* In the above example, ARJ will only extract files that were newly added/updated in chapters 4, 5, 6, and 7. ARJ now supports the "-jt1" compare testing of older chapters. Examples: ARJ t chapters -jt1 -jb* compare all chapters ARJ t chapters -jt1 -jb9 compare only chapter 9 ARJ t chapters -jt1 -jb9* compare only updated files in chapter 9 ARJ t chapters -jt1 -jb2-4 compare files in chapters 2 to 4 "-je" switch The ARJ.TXT "-je" section has been completely rewritten. A new SFX.TXT has been included. "-ji" switch ARJ will now log extraction errors to the index file. "-jo1" switch This switch will set ARJ on extraction to generate unique output filenames AND keep the current file extension. Example: NOTE.TXT will generate NOTE.001.TXT and so on. "-jp" switch When the ARJ output is being redirected to a file or device, the "-jp" option is ignored. Example: ARJ l archive -jp > save.txt ARJ now automatically determines the screen page size for screen sizes greater than 25 lines, so that the option "-jpN" is unnecessary for sizes greater than 25. "-jt" switch "-jt1" switch In DOS and Windows 9x when using removable media (diskettes), ARJ will flush and invalidate cached diskette data from memory, so that testing is done on the actual data on the diskette. A side effect of this improvement in reliability is longer diskette testing times. Missing directories will now be reported as errors. The "-jt1" switch can now be used to test compare older chapters. See the "-jb" option above. "-jt2" switch For a chapter archive, the "-jt2" option will only compare files that are physically added to the archive. Other files in the latest chapter will be CRC checked only. Example: ARJ u -jt2 archive dir\ When "-jt2" is used with the "t"est command, ARJ will skip comparing files that do NOT exist on disk. ARJ will only do a CRC check for those files. Example: ARJ t -jt2 archive *.* For a hollow archive, the "-jt2" option will not count missing files as errors. Only a CRC check will be done. "-jt3" switch This switch allows one to do a quick compare of files within an archive and on disk. ARJ will only compare the date-time stamps and the size of the files. Example: ARJ t archive -jt3 For a chapter archive, the "-jt3" sets ARJ to compare only the files of the last chapter. Example: ARJ ac -jt3 archive *.* ARJ t -jt3 archive "-jv1" switch Fixed this switch to work as it did in ARJ 2.50 displaying CRC values with the "ARJ v" command. "-jv2" switch This switch displays the same information as the "-jv1" switch but if the archive is a chapter archive, the CRC value is replaced by the chapter range values. "-jyw" switch The "-jyw" switch sets ARJ to inhibits the multiple volume prompt EXCEPT when the volume is on removable media such as diskettes. The "-jyw" switch is typically used in an ARJ configuration file or batch file. end document