home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / a / cpmunarj.ark / DARJ.DOC < prev   
Encoding:
Text File  |  1993-01-12  |  4.3 KB  |  107 lines
  1.  
  2. DARJ v1.0      A CP/M program to provide a directory of files within  .ARJ 
  3.         archives.
  4.  
  5. Paul R. Hunt, August, 1991.
  6.  
  7.  
  8. Acknowledgement:   DARJ is a port of AV.C by  Robert  K.  Jung  (c)  1990.
  9.  
  10.  
  11. Conditions of use:    The  programs  and documentation in this package must 
  12. not be altered in any way.    In particular, the name  Robert  Jung, and my
  13. name must stay in tact in the programs  and  documentation.   I  accept  no   
  14. liability for any problems or claims arising from the use of this program.
  15.  
  16. This package must be distributed in its entirity.   Otherwise,  use  freely
  17. and distribute liberally!
  18.  
  19.  
  20. INTRODUCTION:
  21.  
  22. This program is used to provide a  directory  of  the  contents of  a  .ARJ
  23. archive file.  The companion program, CPMUNARJ, is used  to  extract  files
  24. from .ARJ archives.  
  25.  
  26. This program was compiled under CP/M Plus.  However, no CP/M Plus  specific
  27. functions are  used, so  it  should  run  under  CP/M 2.2  as  well.  NOTE,
  28. however, that this program will ONLY run on a Z80 processor.
  29.  
  30.  
  31. USING DARJ:
  32.  
  33. The program is used as follows:
  34.  
  35.      DARJ [du:]<archive>[.arj]
  36.  
  37. <archive> is the name of the archive file.  If no file  name  extension  is
  38. specified,  the  extension  .ARJ  will  be  assumed.    A  drive  and  user
  39. specifier may optionally be used.  For example, the following command:
  40.  
  41.      DARJ C3:MYARJ
  42.  
  43. will open and display the file MYARJ.ARJ on drive  C:,  user  3.    If  the
  44. archive actually has no file name extension, then the file name  should  be
  45. terminated with a full-stop.
  46.  
  47. If the archive file is found, a directory similar to the following will  be
  48. displayed.  (The data in the last column is really only of relevance to the
  49. full-featured archiving system by Jung).    
  50.  
  51.  
  52. AV - ARJ file viewer - Rev 1.1, Copyright (c) 1990 Robert K Jung
  53. CP/M version ported by P R Hunt, August 1991
  54.  
  55. Filename       Original Compressed Ratio DateTime modified CRC-32   Attr TPMGVX
  56. ------------ ---------- ---------- ----- ----------------- -------- ---- ------
  57. DECODE.C           9269       2771 0.308 91-05-12 22:16:14 E385EF74 A--W B 1 
  58. ENVIRON.C          8507       1782 0.223 91-05-13 08:24:54 347F5991 A--W B 1 
  59. UNARJ.C           20715       6559 0.328 91-05-30 08:24:12 1B33488F A--W B 1 
  60. UNARJ.H           10235       3497 0.350 91-05-30 08:22:02 2EBD9D71 A--W B 1 
  61. OS2UNARJ.MAK        347        190 0.000 91-05-13 08:26:30 4831EBF7 A--W B 1 
  62. QCLUNARJ.MAK        301        145 0.000 91-05-12 22:16:50 098E5E77 A--W B 1 
  63. TCCUNARJ.MAK        300        145 0.000 91-05-12 22:16:32 96887F67 A--W B 1 
  64. UNARJ.DEF            34         34 0.000 91-04-29 19:17:54 4CBDB2F4 A--W B 0 
  65. UNARJ.EXE         19986      12135 0.639 91-05-30 08:27:58 4E892E15 A--W B 1 
  66. UNARJ.DOC          7375       3093 0.442 91-05-24 23:44:52 5020D7D2 A--W B 1 
  67. ------------ ---------- ---------- -----
  68.     10 files      77069      30351 0.394
  69.  
  70. 'Original' and 'Compressed' refer to the original and compressed file sizes
  71. respectively, in bytes.
  72.  
  73. The second last field, 'Attr', is the file attribute field.   Each  of  the
  74. four columns in this field indicate a file attribute.    This  is  not  the
  75. place to discuss MSDOS file attributes, but, briefly, they are as follows:
  76.  
  77.      Col. 1 : Archive Bit. 'A' indicates archive bit set, else '-'.
  78.      Col. 2 : System Bit.  'S' indicates a system file, else '-'.
  79.      Col. 3 : Hidden Bit.  'H' indicates hidden file, else '-'.
  80.      Col. 4 : Read Only.   'R' indicates Read Only, else 'W' (read/write).
  81.  
  82. The last field, with the enlightening name of TPMGVX, gives a  little  more
  83. detail about each file as follows:
  84.  
  85.      T -> File Type (B = Binary, T = text)
  86.      P -> A '+' indicates path information is available.
  87.       (Not available from DARJ, nor relevant to CP/M)
  88.      M -> compression method used
  89.      G -> A 'G' indicates file is garbled (encrypted).
  90.      V -> A 'V' indicates archive is continued in another volume.
  91.      X -> An 'X' indicates file is part of a larger file.
  92.  
  93.  
  94. NOTES:
  95.  
  96. DARJ was compiled using HI-TECH C v3.09 for Z80 CP/M.
  97.  
  98. Comments can be directed to me:-
  99.  
  100. Paul Hunt
  101. c/-
  102. ZNODE 62.  Perth, Western Australia, Australia.
  103. 09-450-0200
  104. (International +619-450-0200)
  105.  
  106. or via the CP/M Technical Echo.
  107.