Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP Path: utzoo!utgpu!water!watnot!watmath!clyde!rutgers!sri-spam!ames!ucbcad!ucbvax!imagen.UUCP!turner From: turner@imagen.UUCP.UUCP Newsgroups: comp.sys.atari.st Subject: v00i015: bin:all:shar;uue ARC - doc and bin for the ST, Part02/02 Message-ID: <8704102126.AA05461@imagen.uucp> Date: Fri, 10-Apr-87 16:26:01 EST Article-I.D.: imagen.8704102126.AA05461 Posted: Fri Apr 10 16:26:01 1987 Date-Received: Sat, 11-Apr-87 21:48:01 EST Sender: daemon@ucbvax.BERKELEY.EDU Distribution: world Organization: The ARPA Internet Lines: 580 Approved: imagen!turner Submitted by: turner (D'arc Angel) comp.binaries.atari.st: Volume 0, Issue 15 Archive-name: arc/Part02 XM#$ &P&,#S__V 8,"X #,!\( _ #\N__Y.NOY^6(\P+O_^3EY.=2E)G/XIa XM2ISZ*5^<]DY!(FR<_B1LG/HO+)SV3G5.5O_62.7C\\" 1.NO"67<# ? !'4#_a XMWC N I20#\ 2&[_X$AN_^)(;@ 03KKQEM[\ X0+O_>9P@@4U*3$+P +1 Na XM_^)(@+!\ #!F$A N_^-F#"!34I,0KO_B8 !2@QN &8 "&8 . ^+O_@WFX a XM"E)', >P;)YJ;P8P+)YJ8 (P!SX #$< &P&,#P 6 ", <_ $AN_^!(;O_Ba XM2&X $$ZZ\2#>_ .0D9@&# &4D9![O_BT, 0$"!34I,0@%-'4V[_X# '9P@,a XM;@ _^!LW& ,(%-2DQ"\ #!3;O_@#&X /_@;.PP+@ *9P@@4U*3$+P +F 0a XM(%-2DQ"\ #!2;O_@4VX "C N IG" QN____X&WB8"(,1P ;Q P!E)&0>[_a XMXM# $!!(@& $,#P ,"!34I,0@%-',"X "E-N I*0&;28& @4U*3$*[_XC Na XM IG""!34I,0O N/CP 6 2, =21T'N_^+0P! 0(%-2DQ" ,"X "E-N I*a XM0&;B(%-2DQ"\ $4_+O_@2&P1SB\33KH#.M[\ HO$TZZ!QA8CTC T9-,WPC a XM3EY.=4Y6__Y";O_^8"(P+O_^P?P "B!N @@4!802(/00Y!\ # ]0/_^(&X a XM"%*0(&X ""!0$!!(@+!\ #!M$"!N @@4! 02("P? Y;[XP+O_^3EY.=4Y6a XM_^9(YP,P)FX #"UN C__" +($ D4%B+8 "4F *(&X "%*N @0FA 29PH0a XM$DB L'P )6;H$!)(@+!\ "5F (L4HI";O_L/7P! /_H0F[_YAU\ "#_[Q 2a XM2("P? M9@@]? !_^Q2BA 22("P? P9@@=? P_^]2BBU*__!(;O_P3KK_a XM)%B//4#_ZB1N__ 0$DB L'P +F884HHM2O_P2&[_\$ZZ_P)8CSU _^@D;O_Pa XM$!)(@+!\ &QF"#U\ '_YE**$!)G!!X:2(7DAN @_+O_H/P=.NOP8WOP $%"+a XM8 PP!R!N A2K@ ($( @+@ (D*[_^+!N_^IL ".,"[_[&3G5.5@ 2&X "$ALGN!.NO_&4(].7DYU3E8 $ANa XM PO+@ (3KK])E"/3EY.=4Y6 !@&"\N P@;@ (4JX "! 02( _ $ZZZ))RR,@Q !L"# \__]@ "J/RX "$ZZ]C14CTI 9@ a XMDB N__P]0 .("X "B9 )$!@;" +D*X "DC L*[__&U*+PHP+@ .P+P /__a XM+P _+@ (/SP /TZZ]OC>_ ,.4">,@Q !L!C \__]@2C LGC)F F N,"X a XM#I!LGC+ O __^1KO_\)DH0$TB L'P #68$4HM@!A3;4VX #C N YFCB *a XMD*X "DC +4#__$)LGC(@+O_\3-\, $Y>3G5.5@ +RX #"\N A"9S\\ %9.a XMNO9\WOP ##E GC)G"# \__]@!F $,#P $Y>3G5.5O_\,"X ","\ #__R\ a XM/SP 2$ZZ]DI3G5.5@ 2.<#,"9N @^+@ ,)'P a XM 8 $! &2("P1V8 0D2U*+'!-F /_N( I@ "3-\,P$Y>3G5.5@ a XM+RX "#\\ $%.NO3>7(\Y0)XR9P@P//__8 9@!# \ !.7DYU3E8 & T(&X a XM"! 02("P? *9@X_/ -/SP DZZ]*98CR!N A2K@ ($!!(@#\ /SP DZZa XM](Y8CS N Q3;@ ,2D!FP$Y>3G5.5@ 8!@@;@ (4JX "! 02( _ #\\ 1.a XMNO1@6(\P+@ ,4VX #$I 9MQ.7DYU3E8 & 8(&X "%*N @0$$B /P _/ %a XM3KKT,EB/,"X #%-N Q*0&;<3EY.=4Y6__)(YP P)FX "B1+0>P1TBU(__8,a XM;H, AF%C\N XO"TZZ_S1_ ,.4">a XM,DC L*[_\F<(,#S__V *@P+)XRT6[__B\N__8O/ (_+@ (/SP 0$ZZa XM\R;>_ ,.4">,@Q )G!C \__]@=%)N__Y2BB *+4#_^F "4HH@"I"+L&X a XM#F4 _V1@$" +-BX #L:\ #__]"#)$ @"I"N__I(P"U __(O+O_Z+R[_\C\Na XM @_/ ! 3KKRQ-[\ PY0)XR2,"PKO_R9P8P//__8! P+)XRT6[__D)LGC(Pa XM+O_^3-\, $Y>3G4Y? __0Y? __(Y? !__ Y? !_^XY? _^PY? a XM_^HY? _^@Y? _^8Y? !_>I#[/VZ0>P,P,=B+(0>P,>B+(0>P,a XM?B+(0>P,@B+(0>P,AB+(0>P,BB+(0>P,CB+(0>P,DB+(0>P,EB+(0>P,FB+(a XM0>P,GB+(.7P0 /VP0^S]DC+\ /\R_ #^,OP _#+\ /@R_ #P,OP X#+\ , Ra XM_ " ,OP $/L_8 R_ ,OP 3+\ ,R_ ',OP #S+\ !\R_ _,OP ?S+\a XM /]![-9@*4C67#E\ #"P#E\ #"OD/LJ(HR_ ,OS P3+\P8$R_ % ,OS#a XM 3+\ \ R_ * ,OS"03+\Q@$R_ ; ,OP'@#+\QT$R_ 4 ,OS%P3+\Q($R_ 1 a XM,OS, 3+\#, R_ V ,OS-03+\#P R_,_!,OS.@3+\#D R_ H ,OS*P3+\RX$Ra XM_ M ,OS) 3+\"< R_ B ,OS(03+\V $R_!C ,OP9@#+\V4$R_!L ,OS;P3+\a XMVH$R_!I ,OP> #+\WL$R_-^!,OP?0#+\W0$R_!W ,OP<@#+\W$$R_!0 ,OS4a XMP3+\U8$R_!5 ,OS7 3+\%\ R_!: ,OS603+\T@$R_!+ ,OP3@#+\TT$R_!$ a XM,OS1P3+\T($R_!! ,OSP 3+\,, R_#& ,OSQ03+\,P R_//!,OSR@3+\,D Ra XM_#8 ,OSVP3+\]X$R_#= ,OSU 3+\-< R_#2 ,OST03+\/ R_/S!,OS]@3+\a XM/4 R_/\!,OP_P#+\/H R_/Y!,OSZ 3+\.L R_#N ,OS[03+\.0 R_/G!,OSXa XM@3+\.$ R_"@ ,OSHP3+\Z8$R_"E ,OSK 3+\*\ R_"J ,OSJ03+\[@$R_"[ a XM,OPO@#+\[T$R_"T ,OSMP3+\[($R_"Q ,OSD 3+\), R_"6 ,OSE03+\)P Ra XM_.?!,OSF@3+\)D R_"( ,OSBP3+\XX$R_"- ,OSA 3+\(< R_"" ,OS@03+\a XMH $R_&# ,OQA@#+\H4$R_&, ,ORCP3+\HH$R_&) ,OQF #+\IL$R_*>!,OQGa XM0#+\I0$R_&7 ,OQD@#+\I$$R_&P ,ORLP3+\K8$R_&U ,ORO 3+\;\ R_&Z a XM,ORN03+\J@$R_&K ,OQK@#+\JT$R_&D ,ORIP3+\J($R_&A ,OQX #+\N,$Ra XM_+F!,OQY0#+\NP$R_'O ,OQZ@#+\ND$R_+X!,OQ^P#+\?X R_+]!,OQ] #+\a XMO<$R_+R!,OQ\0#+\M $R_'3 ,OQU@#+\M4$R_'< ,ORWP3+\MH$R_'9 ,OQRa XM #+\LL$R_+.!,OQS0#+\L0$R_'' ,OQP@#+\L$$R_% ,OR0P3+\D8$R_%% a XM,OR3 3+\4\ R_%* ,OR203+\E@$R_%; ,OQ7@#+\ET$R_%4 ,OR5P3+\E($Ra XM_%1 ,OR< 3+\7, R_%V ,OR=03+\7P R_)_!,OR>@3+\7D R_%H ,OR:P3+\a XMFX$R_%M ,OR9 3+\6< R_%B ,OR803+\B $R_$C ,OQ)@#+\B4$R_$L ,OR+a XMP3+\BH$R_$I ,OQ. #+\CL$R_(^!,OQ/0#+\C0$R_$W ,OQ,@#+\C$$R_$0 a XM,OR$P3+\A8$R_$5 ,OR' 3+\1\ R_$: ,OR&03+\@@$R_$+ ,OQ#@#+\@T$Ra XM_$$ ,OR!P3+\@($R_$! 0^R>S"+\ #+\ B_ R_ ),OR# "+\a XM #+\ B_ R_ (OP ,OP! C+\@P B_ R_ ( (OP a XM ,OP "+\ #+\ 0(R_(, (OP ,OP" -+\!7@Y? ( GLHI;!&:a XMGG@I;!&>GGPI;!&BGG0I;!&FGFPI;!&JGG Y? 'GFI#[)Y"0>T !B+(0>T a XM'B+(0>T &"+(0>T )"+(0>T *B+(0>T $B+(0>T #"+(*7P GCXI? a XM ">-#E\ "2!C;W!Y(&%Na XM9"!D:7-T6]U(&9O65T(0H <')E2!T;R!C;VYT:6YU90 * #T *BXJ $YO(&9Ia XM;&5S(&UA=&-H.B E71Ea XMF4@;F]W @($1A=&4@(" @(" @5&EM92 @("!#4D,* #T]/3T]a XM/3T]/3T]/2 @/3T]/3T]/3T@(#T]/3T]/3T](" ]/3T](" ]/3T]/3T]/0 a XM(" ]/3T]/3T]/3T@(#T]/3T]/2 @/3T]/0H " @(" @(" @/3T]/2 @/3T]a XM/3T]/3T@(" @(" @(" @(" ]/3T](" ]/3T]/3T]/0H 5&]T86P@)39L9" @a XM)3AL9" @ @(" @(" @(" @)3-D)24@("4X;&0@( H $9I;&4@;F]T(&9Oa XM=6YD.B E0!*=6X 2G5L $%U9P!397 a XM3V-T $YO=@!$96, )2TQ,G, (" E.&QD(" " @("TM(" @ @4&%C:V5Da XM( 4W%U965Z960 &-R=6YC:&5D !#2!Ha XM86YD;&4@)60* %-T86-K(&]V97)F;&]W"@ @86YA;'EZ:6YG+" $%20U1%a XM35 N0U). $%20U1%35 N0U). &)W*P!5;F%B;&4@=&\@8W)E871E('1E;7!Oa XM2!F:6QE("5S @ "@E;&0I( 2!F:6QE("5S"@ 9&]N92X* !"a XM=6<@+2!B860@;F-R('-T871E"@ +E)30P 8G( %1E;7!O2!F:6QEa XM("5S(&%L2!E>&ES=',* &)W*P!5a XM;F%B;&4@=&\@8W)E871E('1E;7!O2!F:6QE("5S"@ @ $EN=F]K:6YGa XM(&9I;&4Z("5S)7,* !#86YN;W0@9&5L971E('1E;7!O2!F:6QE("5Sa XM"@ 8G( $-R96%T:6YG(&YE=R!A6]U(&YE960@82!N97=E 'arc.doc' XARCHIVE (ARC.TTP) X XDescription X X This program is a general archive utility, and is X used to maintain an archive of files. An "archive" X is a single file that combines many files, reducing X storage space and allowing multiple files to be X handled as one. X XUsage X arc {amufdxerplvtc}[bswnh][g] [ ...] X X a = add files to archive X m = move files to archive X u = update files in archive X f = freshen files in archive X d = delete files in archive X x,e = extract files from archive X r = run one file with arguments from archive X p = copy files from archive to standard output X l = list files in archive X v = verbose listing of files in archive X t = test archive integrity X c = convert entry to new packing method X X b = retain backup copy of archive X s = suppress compression (use Method 2) X w = suppress warning messages X n = suppress notes and comments X h = hold screen before returning to Desktop X X g = encrypt/decrypt archive entry X XUsage from GEM Desktop X X - double-click-left on ARC.TTP icon X - observe OPEN APPLICATION box for ARC.TTP parameters X - enter switches, archive name and file template X (example: vh megastuf.arc *.*) X - hit return or click-left on OK button to begin execution X - "press any key to continue" after completion X X Note the 'h' holds the display instead of immediately returning X to the GEM Desktop so you can view filenames, messages, etc. X XUsage from a command shell program X X - observe the command shell prompt X - type in command, switches, archive name and file template X (example: arc v megastuf.arc "*.*") X - hit return to begin execution X - use CNTL-S and CNTL-Q keys as necessary to view text X before it scrolls off the screen X X Note file templates like *.* should be surrounded by double X quotes to prevent the shell program itself from expanding X the template to the files matched. X XExamples X X These examples are for running ARC from the GEM Desktop (and therefore X use the 'h' switch). In a few cases it may desirable to omit the 'h' X (for instance, when using redirection). X X If you run ARC from a command shell such as Micro C-Shell, you can X usually omit the 'h'. However, you should remember to use quotes X with each template to prevent expansion by the shell. X X ah files.arc *.prg Creates a new archive file called FILES.ARC X and puts all files ending in .PRG inside. X X xh files.arc *.* Extracts all files from FILES.ARC. X xh files.arc same as above X xh files same as above X X xh files.arc *.doc Extracts all files ending in .DOC. X X vh gold will show detailed listing of X files stored in archive GOLD.ARC X X v gold >biglist.txt X will store detailed listing into file X BIGLIST.TXT (may not work under Micro C-shell) X X ph gold purple.doc will print to the screen the file PURPLE.DOC X which is stored in compressed form in GOLD.ARC X X th gold will test GOLD.ARC for errors X X uh gold *.c will update or insert the .C files in the X the current directory into GOLD.ARC X X ubh gold "*.c" same as above except old X archive is renamed GOLD.BAK X X uhgHIDE diary dec86.txt X will update DIARY.ARC with X DEC86.TXT that is encrypted with X the key "HIDE" X X xhgHIDE diary dec86.txt X will extract DEC86.TXT from DIARY.ARC X and decrypt with the key "HIDE" X X r util.arc myeditor japan.doc X will run the program MYEDITOR X (.TTP, .TOS or .PRG) and pass X japan.doc as an argument X XSwitches (detailed description) X X a - add files to archive. This switch will force update X or addition of the indicated files regardless of creation X time and date. X X m - move files to archive. Same as "a" switch except X that the files are deleted from the directory as X they are moved to the archive. X X u - update files in archive. This switch will only update X files when the creation date is newer than the X corresponding file in the archive. New files will X be added automatically. X X f - freshen files in archive. Same as "u" except that X new files will not be added. X X d - delete files in archive. The files are lost forever X and the archive is recompacted to remove the data X for these files. X X x,e - extract files from archive. Copies of the files X in the archive are created in the current directory X in an uncompacted state. X X r - run one file with arguments from archive. Any X program (.TTP, .TOS, or .PRG) may be executed directly X from the archive. If the program has a resource (.RSC) X it must have the same name as the program X (ex: editor.RSC for editor.PRG). The parameters X after the program name are passed to the program X without modification (double quotes may be necessary). X X p - copy files from archive to standard output. Useful X for viewing test files in an archive. May also be X handy when used with I/O redirection in C-shells. X X l - list files in archive. Limited information listing X of files contained in an archive. Displays only the X filename. X X v - verbose listing of files in archive. Complete X information listing of files contained in an archive. X Displays the filename, original length, storage method, X storage factor (% savings), compacted size, date, time, X and CRC. X X t - test archive integrity. Check the archive to make sure X it does not have any bad files contained. X X c - convert entry to new packing method. Convert files X stored with older methods to newer methods that are X more efficient. X X b - retain backup copy of archive. Keep the original X archive file and rename to .BAK. The new version X is named .ARC. This switch may be used with the X following switches: a, m, u, f, d, c. X X s - suppress compression. This forces new files to be X saved using Method 2 (no compaction). This switch X may be used with the following switches: a, m, u, f, c. X X w - suppress warning messages. This switch will keep X warning message from being displayed which is the default. X Most warnings concern the deletion or existence of X files with the same name. X X n - suppress notes and comments. This switch will keep X useful notes from being displayed which is the default. X Most notes indicate what stage of compaction is X being run (analyze, compaction, storage). X X h - hold screen before returning to Desktop. This switch X should be used whenever ARC is executed from the X Desktop, except in conjunction with file redirection. X X g - encrypt/decrypt archive entry. This is used encode X files so that others may not read them. BE CAREFUL! X This must be the last parameter in the switches because X everything following is part of the password. Don't X forget the password or you won't be able to read the file X either. X X File redirection is available when executing ARC from X the Desktop (Micro C-Shell apparently has a hidden defect X which prevents this capability). In order to redirect the X output, just add >FILENAME as the end of the list of switches, X where FILENAME is the name of the file to receive the output X which normally is displayed on the screen. X XGeneral description X X ARC (short for archive) is a file library and compression X utility. It may be thought of as an improved version X of LU and SQUEEZE all rolled into one program. X X ARC analyzes each file to see which of a number of X compression techniques will generate the smallest code. X The following estimates give the user a general idea of X how much compression may be gained by using ARC. X X ARC Text - 45-55% reduction from original X ARC Programs - 25-30% reduction X ARC Pictures - 45-55% reduction X X The user should see that compressing files with ARC X will allow easier telecommunications by combining files X and shortening their transfer time. X XHistory X X ARC has been in use in the CP/M and MS-DOS world for many X years. Thom Henderson developed the version which I X converted for use on the Atari ST. I am not sure but he X may also be the original author. X X It is important to note that no matter who developed this X program, ARC is based on the file compression theories X developed by Huffman, Welch, Knott, Knuth, and many other X scientists. X XBug Reports X X Since I developed this version of ARC, I will be responsible X for any erroneous features. Please relay any problems with X a written description of what happened and the .ARC file X which caused the problem to: X X Harvey Johnson X 2398 Oaklyn St NE X Palm Bay, FL 32907 X X - or - X X QUILL BBS 305-724-2303 X XDonations X X It would be nice to be supported if you think that ARC X is any good. Make no mistake, I did NOT write the original X version of ARC, but I have spent all my extra time for X two months making it a reality on the Atari ST. X X As I do receive contributions, I will consider improvements X more seriously. Any donations may be sent to address X specified in Bug Report section. X X Thank you one and all in advance for considering this X request, but if you are like me (lazy) then I don't X really expect to ever see a single dime. X XTECHNICAL X XLibrary Format X X All files are stored in alphabetical order in the X archive library. X X The final .ARC library should have a time of modification X which is the same as the most recently modified (youngest) X file in the library. When each file is extracted its X time and date are set to that which is stored in the X header (see next paragraph). X X Each entry in the library has a header which contains X the following information: X X Filename 13 bytes (char) X Size 4 (long) X Date 2 (int) X Time 2 (int) X CRC 2 (int) X Length 4 (long) X X The filename is always followed by a zero (NUL) character. X All of the "int" and "long" fields are stored in reverse X order, least significant bytes first and most significant X bytes last. The date and time use are specified in standard X format (same as that used on IBM and Atari ST). X XCompression Routines X X Method 1 - no conversion - files stored using this method X are not translated. This method has been eliminated in X favor of method two which also stores the original file X length. Appears as "--" in verbose listing. X X Method 2 - no conversion - files stored using this method X are not translated. Appears as "--" in verbose listing. X X Method 3 - repeat character compression - files stored X using this method convert strings of letters to that letter X followed a count. "AAAAA" becomes "A5" in simple terms. X Appears as "Packed" in verbose listing. X X Method 4 - Huffman squeezing - files stored using this X method convert characters to smaller bit strings depending X on frequency count of appearance in file. Appears as X "Squeezed" in verbose listing. X X Method 5,6,7 - Lempel-Zev compression - files stored in X any of these methods take advantage of repeated strings X of non-identical characters that appear repeatedly X through the file as well as a hashing function. X Various additional improvements distinguish these X methods from each other. Appears as "crunched" in X verbose listing. X X Method 8 - Dynamic Lempel-Zev - files stored using X this method takes advantage of repeated strings X of non-identical characters that appear repeatedly X throughout the file. These is by far the most efficient X and commonly employed method of compression. Appears X as "Crunched" in verbose listing. X X Other Methods - unknown methods - files stored using more X advanced techniques may appear in the future. The X current version of ARC will not be able to retrieve this X files. Appears as "Unknown!" in verbose listing. X SHAR_EOF if test 11672 -ne "`wc -c < 'arc.doc'`" then echo shar: "error transmitting 'arc.doc'" '(should have been 11672 characters)' fi fi exit 0 # End of shell archive