home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / macutils.lzh / MACUTILS / UNSIT / unsit.1 < prev    next >
Text File  |  1995-09-17  |  4KB  |  132 lines
  1. .TH UNSIT L "Septermber 28, 1988"
  2. .UC
  3. .SH NAME
  4. unsit \- extract/list files in a Macintosh Stuffit archive file
  5. .SH SYNOPSIS
  6. .B unsit
  7. [
  8. .B \-rdulM
  9. ] [
  10. -vqfm
  11. ] file
  12. .br
  13. .SH DESCRIPTION
  14. For the Stuffit archive file listed, 
  15. .I unsit
  16. extracts the files in the archive into separate files.
  17. This makes it possible, for example, to separate a large StuffIt file
  18. into component files for selective downloading, rather than
  19. downloading the larger archive file just to extract a single, small
  20. file.  It also allows the use of StuffIt to compress a group of files
  21. into a single, smaller archive that can be uploaded to a Unix system
  22. for storage, printing, etc.
  23. .PP
  24. In the normal mode, both the data and the resource forks of the
  25. component Macintosh files in the archive are extracted and stored in
  26. Unix files with the extension
  27. .I .data
  28. and 
  29. .I .rsrc
  30. appended to the end of the Macintosh file name.
  31. In addition, a 
  32. .I .info
  33. file will be created with the Finder information.
  34. These three file are compatible with the
  35. .I macput
  36. program for downloading to a Mac running MacTerminal.  The output files can
  37. also be generated in the MacBinary format which is easier to use if they are to
  38. be sent to the Mac over a network connection using an FTP program.  The
  39. MacBinary format file will have the same name as the file would have on the
  40. Mac.  If only the data or resource fork is extracted, no addition extension is
  41. appended to the Mac file name.  Characters in the Mac file name that are
  42. illegal (or unwieldy, like spaces) are changed to underscores in the Unix file
  43. name.  The true Mac file name is retained internally in the MacBinary file or
  44. in the
  45. .I .info
  46. file and is restored when the file is downloaded.
  47. .PP
  48. StuffIt version 1.5 has the ability to archive a group of files and folders
  49. in such a way that the hierarchical relationship of the files and folders
  50. is maintained.
  51. .I Unsit
  52. version 1.5 can unpack files archived in this manner and place them in
  53. corresponding subdirectories so as to maintain the hierarchy.  As an option,
  54. the hierarcy can be flattened out and all the files stored in the current
  55. directory.
  56. .PP
  57. The options are similar to those for 
  58. .I macput
  59. and
  60. .I unpit.
  61. .TP
  62. .B \-M
  63. Generate output files in MacBinary format instead of the .data, .rsrc,
  64. and .info format.
  65. .TP
  66. .B \-f
  67. For StuffIt files containing a "Hierarchy Maintained Folder" entry, extract the
  68. files into a "flat" organization (all in the current directory) rather than
  69. maintaining the hierarchy by creating new directories, etc.
  70. Default is to maintain the hierarchical folder organization.
  71. .TP
  72. .B \-l
  73. List the files in the archive but do not extract them.  The name, size,
  74. type, and creator of each file is listed.
  75. .TP
  76. .B \-m
  77. Assumes the input file in MacBinary format rather than macput/macget
  78. format and skips over the MacBinary header.
  79. .TP
  80. .B \-r
  81. Extract resources forks only.
  82. .TP
  83. .B \-d
  84. Extract data forks only.
  85. .TP
  86. .B \-u
  87. Extract data fork and change into a Unix text file.
  88. This only works if the file is really a text file.
  89. .TP
  90. .B \-q
  91. Query user before extracting files and folders.  If a "n" answer is given for
  92. a folder, none of the files or folders in that folder will be extracted.
  93. .TP
  94. .B \-v
  95. Verbose option.  Causes 
  96. .I unsit
  97. to list name, size, type, and creator of each file extracted.
  98. .SH BUGS
  99. Files that were compressed by StuffIt with the Lempel-Ziv method and are
  100. extracted with the 
  101. .B \-u
  102. switch (text files) are not checked for a correct CRC value when 
  103. .I unsit
  104. uncompresses them.  This is because 
  105. .I unsit
  106. pipes the data through
  107. .I compress
  108. and
  109. .I tr
  110. to extract the file and never has a chance to do the CRC check.
  111. .PP
  112. The
  113. .I compress
  114. program has been observed to go into strange states when uncompressing a 
  115. damaged file.  Often it will get stuck writing out bogus data until the
  116. disk fills up.  Since 
  117. .I unsit
  118. sends data through 
  119. .I compress,
  120. the same problem could occur when extracting files from a damaged Stuffit
  121. archive.
  122. .SH FILES
  123. For archives that have been compressed with the Lempel-Ziv method, the 
  124. .I compress 
  125. program must be present on the system and in the search path since 
  126. .I unsit 
  127. uses it for the uncompressing.
  128. .I Compress
  129. is available from the comp.sources.unix archives.
  130. .SH AUTHOR
  131. Allan G. Weber (weber@sipi.usc.edu)
  132.