home *** CD-ROM | disk | FTP | other *** search
/ Microsoft Programmer's Library 1.3 / Microsoft-Programers-Library-v1.3.iso / sampcode / alde_c / misc / comm / detar / detar.doc < prev    next >
Encoding:
Text File  |  1988-01-23  |  3.4 KB  |  101 lines
  1.  
  2.                   Detar Documentation
  3.  
  4.                 23 January 1988
  5.  
  6.    The Unix(tm) Forum has decided to archive its uploads in the compressed
  7. TAR format.  The 'detar' program is meant to provide you with a method of
  8. bursting the files on an MS-DOS(tm) computer.  Additionally the source code
  9. in 'C' is included so others can use it as a base for porting to other
  10. computers.  As a disclaimer: not a lot of planning went into the program.
  11. I basically rounded up some code laying around and threw it together.
  12.  
  13.    In order to make the program useful to MS-DOS computers some features
  14. of TAR format had to be worked around.  For instance: filenames.  The solution
  15. was simple, reduce to 3 characters after the first dot '.'.  Reduce to eight
  16. characters before the dot.  Multiple dots are changed to dash '-' after the
  17. first dot is found.  (Run this program on smail.tar for a good example).
  18.  
  19. The directory 'd' option shows all the filenames in their original state.
  20.  
  21.    The 'detar' program has exactly two options.  One is to perform a direct-
  22. ory, and the second is to extract files.  There is no TAR create routines.
  23. The directory output can be redirected to a file or a printer.  The best
  24. method of using the extraction option is as follows:
  25.  
  26.     1.    Put the detar.exe file in the \bin directory.  Set your path
  27.         command to search the \bin.
  28.  
  29.     2.    Create a working directory, such as:  'MD TMP'.
  30.  
  31.     3.    Change to the temporary directory:  'CD TMP'.
  32.  
  33.     4.    Execute detar:  'detar ../smail.tar'
  34.  
  35.         This will begin building files in the TMP directory based
  36.         on the naming algorithm above.  This is the simplest method
  37.         and you will determine your best procedure after working with
  38.         the program for awhile.
  39.  
  40.    A sample of the output received when executing the 'directory' option:
  41.  
  42.     C>detar d ../smail
  43.     
  44.     -rw-r--r-- 102/10  1006 Aug 27 21:42 1987 src/Makefile
  45.     -rw-r--r-- 102/10  9875 Aug 27 21:42 1987 src/alias.c
  46.     -rw-r--r-- 102/10  9983 Aug 27 21:43 1987 src/defs.h
  47.     -rw-r--r-- 102/10 10007 Aug 28 14:39 1987 src/defs.h.kk
  48.     -rw-r--r-- 102/10 12008 Aug 27 21:42 1987 src/deliver.c
  49.     -rw-r--r-- 102/10  2533 Aug 27 21:42 1987 src/getopt.c
  50.     -rw-r--r-- 102/10  2218 Aug 27 21:42 1987 src/getpath.c
  51.  
  52.     ...
  53.  
  54. The first column is the protection bits.  It is Unix specific.  As is
  55. the next column which is the user and group number of the person who made
  56. the archive.  Absolutely no use at all in MSDOS.  The third column is the file
  57. size in bytes.  The fourth column is the date, and the fifth is the complete
  58. filename.
  59.  
  60.    If you make a mistake on the detar command line, three error messages are
  61. output:
  62.  
  63.     C>detar g ..\smail
  64.  
  65. 1.    Usage: detar [d] filename[.tar]
  66.     Where d means directory only
  67.  
  68.     C>detar ..\smale
  69.  
  70. 2.    Tar File '..\SMALE.TAR' Not Found
  71.  
  72.     C>detar ..\detar.c
  73.  
  74. 3.    File '..\DETAR.C' not a TAR archive
  75.  
  76. The brackets ('[', ']') shown on the "Usage" line mean that the information
  77. contained within them are optional.
  78.  
  79.    A sample output from the extraction option follows:
  80.  
  81.     C>detar smail
  82.     Extracting: Makefile
  83.     Extracting: alias.c
  84.     Extracting: defs.h
  85.     Extracting: defs.h-k
  86.     Extracting: deliver.c
  87.     Extracting: getopt.c
  88.     Extracting: getpath.c
  89.  
  90.     ...
  91.  
  92. ----------------
  93. 23 Jan 88 - First bugs fixed.  Insufficient testing.  Names without a pathname
  94.         were munged.
  95. ----------------
  96.  
  97. If you have any further questions or comments (especially improvements)
  98. feel free to contact me.
  99.  
  100. Steve R. Sampson, Compuserve(tm): 75136,626, Usenet: sampson@killer.UUCP
  101.