home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / portfoli / arcex / arcex.doc < prev   
Text File  |  1992-11-02  |  12KB  |  353 lines
  1. ARC-E Command                                         Version 4.0e
  2.   -------------                                         Mar 17, 1989
  3.  
  4.  
  5.   Purpose:  Use ARC-E to extract files from an ARC archive file.
  6.  
  7.   Format:   The program name may be either ARC-E or ARCE.
  8.  
  9.         ARC-E  [d:][path]filename.ext  [filespecs...] [d:outpath]
  10.                                       [/R]
  11.                                       [/Q]
  12.                                       [/P]
  13.                                       [/T]
  14. |                                     [/5]
  15.                                       [/Gpassword]
  16.  
  17.   Remarks:
  18.  
  19.         The drive and path names are optional.  If omitted, the  current
  20.         drive and path name is used.
  21.  
  22.         The filename must be  supplied.  The extension defaults  to ARC.
  23.         All files matching the supplied filename are processed.  The ARC
  24.         filename may contain the * and ? wildcard characters.
  25.  
  26.         If  no  filespecs  are   supplied,  all  files  are   extracted.
  27.         Otherwise, only those ARC members  which match one of the  up to
  28.         16 filespecs are extracted.
  29.  
  30.         The extracted files  may be placed  on another drive,  and/or in
  31.         another subdirectory by following the optional filespecs with  a
  32.         drive designator and/or path name.
  33.  
  34.         If  the  file  being  extracted  already  exists,  you are asked
  35.         whether or not you want to over-write it.  You may use the |  /R
  36.         option to bypass this prompt.  Use a Y followed by the |  return
  37.         key to over-write the file.
  38.  
  39.         Use the /Q option to suppress alarm sounds, beeps, and bells.
  40.  
  41.         Use  the  /P  option  to  write  the  extracted files to the DOS
  42.         standard output  file.  With  /P, you  may pipe  or redirect the
  43.         output.  An initial line feed  is added to the beginning  of the
  44.         output file.
  45.  
  46.         Use the /T option to test the archive's integrity. No files will
  47.         be extracted.
  48.  
  49.         If the file was encrypted, use the /G option to supply the  same
  50.         password as was used to create the file, e.g. /GSECRET.
  51.  
  52. |       Use the /5 option to stop ARC-E from creating the subdirectories
  53. |       for files created with the ARC /Z subdirectory option.
  54.  
  55.  
  56.         ARC-E 4.0e, Copyright (c) 1986-89, Wayne Chin and Vernon D. Buerg.
  57.         ALL RIGHTS RESERVED.
  58.  
  59.  
  60.   ARC-E Command                                         Version 4.0e
  61.   -------------                                         Mar 17, 1989
  62.  
  63.  
  64.  
  65.                         Examples
  66.                         --------
  67.  
  68.         o  Extract all file from TEST.ARC onto the current drive:
  69.  
  70.               ARC-E TEST
  71.  
  72.         o  Extract only file with  an extension of .ASM from the archive
  73.            SOURCE.ARC on drive B and in subdirectory SAVE:
  74.  
  75.               ARC-E B:\SAVE\SOURCE *.ASM
  76.  
  77.         o  Extract  all  files  from  all  ARC files in the subdirectory
  78.            called TEST on drive C:
  79.  
  80.               ARC-E C:\TEST\*
  81.  
  82.         o  Extract  all  files  from  PROGA.ARC  and  place the files in
  83.            subdirectory OLD on drive B:
  84.  
  85.               ARC-E PROGA.ARC B:\OLD
  86.  
  87.         o  Extract all files with an extension of .COM and .EXE from the
  88.            archive PROGS.ARC in directory NEW\WORK on drive B, and place
  89.            the  them  in  subdirectory  SAVE\TEST  on  drive  A; replace
  90.            existing file:
  91.  
  92.               ARC-E B:\NEW\WORK\PROGS *.COM *.EXE A:\SAVE\TEST /R
  93.  
  94.         o  Extract  the  file  READ.ME  from  the  archive GIZMO.ARC and
  95.            display it on the console instead of writing it to a file:
  96.  
  97.               ARC-E GIZMO READ.ME /P
  98.  
  99.         o  Same as above, except  pass the extracted READ.ME file to the
  100.            LIST file viewer:
  101.  
  102.               ARC-E GIZMO READ.ME /P | LIST /S
  103.  
  104.  
  105.  
  106.   ARC-E Command                                         Version 4.0e
  107.   -------------                                         Mar 17, 1989
  108.  
  109.                         Error Messages
  110.                         --------------
  111.  
  112.       'filename - premature EOF reading '
  113.  
  114.         Data  is  missing  from  the  archive  file.   The  program   is
  115.         terminated.
  116.  
  117.  
  118.       'filename - unable to set file datestamp'
  119.  
  120.         The file datestamp is set to the current date and time, and  the
  121.         next archive member is processed.
  122.  
  123.  
  124.       'filename - WARNING: file CRC does not match!'
  125.  
  126.         The extracted member  is left on  the output disk,  and the next
  127.         archive member is processed.   The file is probably  invalid but
  128.         is left on the disk for your examination.
  129.  
  130.  
  131.       'Invalid filespec(s)'
  132.  
  133.         The filespec syntax is incorrect.  The filename part may be from
  134.         1  to  eight  characters,  and  may  include the ? or * wildcard
  135.         characters.  The extension may be none to three characters,  and
  136.         may  include  wildcards.   There  is  a  maximum of 16 filespecs
  137.         allowed.  The program terminates.
  138.  
  139.  
  140.       'filename - file already exists. Overwrite it? (y/N) '
  141.  
  142.         The member being extracted already  exists.  If you are using  a
  143.         data  path  utility,  the  file  may  not  actually  be  in  the
  144.         subdirectory be used for output.   Respond with the letter Y  to
  145.         over-write the existing  file, or respond  with the letter  N to
  146.         skip this member and continue to the next.
  147.  
  148.  
  149.       'Abort: Stack overflow'
  150.  
  151.         The member  being extracted  has invalid  data.  The  program is
  152.         terminated.
  153.  
  154.  
  155.       'filename - invalid decode tree count'
  156.  
  157.         The member  being extracted  has invalid  data.  The  program is
  158.         terminated.
  159.  
  160.  
  161.  
  162.   ARC-E Command                                         Version 4.0e
  163.   -------------                                         Mar 17, 1989
  164.  
  165.                         Error Messages (cont'd)
  166.                         --------------
  167.  
  168.  
  169.       'filename - new archive format 7 not yet supported'
  170.  
  171.         Format 7 is a special file compression method used internally by
  172.         SEA,  the  authors  of  ARC.  Processing continues with the next
  173.         archive member.
  174.  
  175.  
  176.       'Unable to open archive > arcname'
  177.  
  178.         The  specified  ARC   archive  file  was   not  found,  or   was
  179.         inaccessible.  The program terminates.
  180.  
  181.  
  182.       'CREATE failed > filename'
  183.  
  184.         There was insufficient directory  space, or a failure  accessing
  185.         the output disk.  The program terminates.
  186.  
  187.  
  188.         'Invalid archive format!'
  189.  
  190.         The archive file data is invalid.  The program terminates.
  191.  
  192.  
  193.       'Incorrect DOS version'
  194.  
  195.         Version  2.0  or  later  of  PC  DOS  must be used.  The program
  196.         terminates
  197.  
  198.  
  199.       'Not enough memory.'
  200.  
  201.         A minimum  of 112k  bytes of  memory is  required.  The  program
  202.         terminates.
  203.  
  204.  
  205.       'I/O error reading from arcname'
  206.  
  207.         An incorrectable error occurred attempting to read data from the
  208.         archive file.  The program terminates.
  209.  
  210.  
  211.       'I/O error writing or disk full > filename'
  212.  
  213.         There was not  enough disk space  to write the  complete archive
  214.         member.   The  partially  extracted  file  is  scratched and the
  215.         program terminates.
  216.  
  217.  
  218.  
  219.   ARC-E Command                                         Version 4.0e
  220.   -------------                                         Mar 17, 1989
  221.  
  222.                         Error Messages (cont'd)
  223.                         --------------
  224.  
  225.  
  226.       'No matching file(s) found'
  227.  
  228.         No archive files were  found that matched the  supplied filename
  229.         specifications.  The program terminates.
  230.  
  231.  
  232.  
  233.       'filename - ERROR: invalid file codes'
  234.  
  235.         An error was detected while attempting to decode a crunched
  236.         file. Either some data bytes are invalid, there are extra
  237.         bytes, or there are bytes missing. The archive is invalid.
  238.  
  239.  
  240.  
  241.   ARC-E Command                                         Version 4.0e
  242.   -------------                                         Mar 17, 1989
  243.  
  244.                         Version history
  245.                         ---------------
  246.  
  247.         1.1 - 1/13/86   -initial release
  248.  
  249.         2.00, 04/08/86  - fine tuning of I/O buffering
  250.  
  251.         2.01-2.05, 4-20 thru 9/9/86
  252.                         - improve unsq, correct disk full message
  253.         2.06, 9/17/86   - release from testing
  254.         2.07, from 9/19 - not released
  255.         2.08, 12/31/86 - added /P, /Q; fixed /R with redirection
  256.         2.09, 1/5/87   - correct closing of output if /P used; require return
  257.                          (enter key) for over-write prompt
  258.                        - add more validity checking of member headers
  259.         2.10, 1/6/87   - correct use out output file specification
  260.         2.11, 1/24/87  - some cosmetics, wrong banner version and date
  261.  
  262.         3.0a, 3/16/87  - added /G for password encryption
  263.                        - added /T for integrity checking only
  264.                        - correct loop in command line parsing
  265.                        - internal optimization
  266.                        - make intergity checking more robust
  267.  
  268.         3.0c, 3/23/87  - improve extracting with file selection
  269.                        - minor fixes and cosmetic changes
  270.  
  271.         3.0d, 3/29/87  - correction to unsqueeze
  272.  
  273.         3.0e, 4/02/87  - correct loop with invalid archives
  274.                        - insure errorlevel non-zero if any errors
  275.                        - correct loop in command line processing
  276.  
  277.         3.0f, 5/31/87  - correct false 'disk full' error message when
  278.                          using /p (piping) option
  279.                        - correct failure to extract all files from a
  280.                          garbled (/g) archive
  281.  
  282.         3.1a, 9/10/87  - cosmetic changes
  283.  
  284.         3.1b, 9/16/87  - unsquashing version released
  285.  
  286.         3.1c, 2/06/88  - lessen memory requirement to 50k
  287.  
  288. |       4.0a, 2/06/89  - add subdirectory support via /Z option
  289.  
  290. |       4.0b, 2/28/89  - change meaning of /Z to /5;
  291. |                        correct name used for /Z output directories
  292.  
  293. |       4.0c, 3/03/89  - correct mkdir error without /5
  294.  
  295. |       4.0e, 3/17/89  - cosmetic changes
  296.  
  297.  
  298.   ARC-E Command                                         Version 4.0e
  299.   -------------                                         Mar 17, 1989
  300.  
  301.  
  302.  
  303.                         Notices
  304.                         -------
  305.  
  306.         ARC-E (c) Copyright 1986-1989 by Wayne Chin and Vernon D. Buerg
  307.         ALL RIGHTS RESERVED.
  308.  
  309.         ARC-E is free, but it is a copyrighted work and may be distributed
  310.         only pursuant to this license.
  311.  
  312.         Permission is hereby granted to reproduce and disseminate ARC-E so
  313.         long as:
  314.  
  315.            (1)  No remuneration of any kind is received in exchange; and
  316.  
  317.            (2)  Distribution is without ANY modification to the contents of
  318.                 ARC-E.COM and all accompanying documentation and/or support
  319.                 files, including the copyright notice and this license.
  320.  
  321.         No copy of ARC-E may be distributed without including a copy of this
  322.         license.
  323.  
  324.         Any other use is prohibited without express, written permission in
  325.         advance.
  326.  
  327.  
  328.  
  329.                 Vernon D. Buerg
  330.                 139 White Oak Circle
  331.                 Petaluma, CA  94952
  332.  
  333.                 CompuServe: 70007,1212
  334.                 Data/BBS:   707-778-8944, VOR 24-hour BBS, 300-2400 bps
  335.                             415-994-2944, VOR South, 300-2400
  336.                             707-778-8841, Motherboard, 300-2400, Hayes VSM 9600
  337.                             707-778-8743, Motherboard, 300-2400, USR HST 9600
  338.  
  339.  
  340.  
  341.         For use by corporations, institutions, or for profit, contact
  342.         System Enhancement Associates for licensing information.
  343.  
  344.                    System Enhancement Associates
  345.                    21 New Street
  346.                    Wayne, NJ 07470
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.