home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / unix_c / macintsh / downlodc.txt < prev    next >
Text File  |  1989-03-21  |  12KB  |  295 lines
  1.  8-Jun-86 17:46:31-PDT,12145;000000000001
  2. Return-Path: <borton%sdcc3@sdcsvax.ucsd.edu>
  3. Received: from sdcsvax.ucsd.edu by SUMEX-AIM.ARPA with TCP; Sun 8 Jun 86 17:43:44-PDT
  4. Received: by sdcsvax.ucsd.edu (5.31/4.41)
  5.     id AA29503; Sun, 8 Jun 86 17:44:58 PDT hops=0
  6. Received: by sdcc3.ARPA (5.51/4.41)
  7.     id AA02549; Sun, 8 Jun 86 17:44:47 PDT
  8. Date: Sun, 8 Jun 86 17:44:47 PDT
  9. From: borton%sdcc3@sdcsvax.ucsd.edu (Chris Borton)
  10. Message-Id: <8606090044.AA02549@sdcc3.ARPA>
  11. Subject: Help article on Mac downloads (nroff)
  12. Newsgroups: mod.mac
  13. To: info-mac@sumex-aim.arpa
  14. Keywords: help Mac downloads
  15.  
  16. This is a document I wrote describing the different programs on Unix that aid
  17. in downloading to the Macintosh.  I thought it might help some people
  18. wondering what some of these programs are and other User Services personnel
  19. that are often plagued with questions on how to use them.  The document is
  20. written with simple nroff -ms commands; use 
  21. '[nt]roff -ms <whatever you save it as> to {view,print} it...
  22.  
  23. --Chris
  24. -------
  25. Chris Borton, UC San Diego Undergraduate CS; Micro Consultant, UCSD
  26. borton@sdcsvax.UCSD.EDU || ...!{ucbvax,decvax,noscvax,ihnp4}!sdcsvax!borton
  27. "Noch eine Woche, dann 'die Pruefungen,' und dann nach Davis bis 4 Aug wenn
  28.  ich nach Goettingen fliegen werde.  Ich werde Euch sehr vermissen...es hat
  29.  mir viel Spass gemacht und auch habe ich viel gelernt"
  30. -----------------start article here-------------------
  31. .ST
  32. .PO 1i
  33. .sp 2.5i
  34. .B 
  35. .ce 4
  36. .ps +6
  37. Macintosh Transfers
  38. .ps -6
  39. .ul
  40. by Chris Borton
  41. .ul
  42. U.C.S.D. Micro Computer Support Group
  43. .sp 1.5i
  44. .B
  45. Introduction
  46. .PP
  47. Just as many of the micro computer users predecessing the Macintosh found,
  48. there is a need to be able to transfer files composed of 8-bit bytes over
  49. communication lines that only support 7-bits.  Most of these lines deal with
  50. mainframes and other `older' machines, where there was only a need to
  51. transfer text.  For this a 7-bit line is sufficient, but doesn't work for
  52. 8-bit `binary' (as opposed to text) data.  To handle this need, many
  53. conversion protocols have been established; the standard for the
  54. Macintosh is called `BinHex.'
  55. .sp
  56. .PP
  57. This document will describe the process of converting a hex file on a
  58. mainframe (presumed to be running Unix) and transferring it to a Macintosh in
  59. a usable form.  The first portion will describe the `traditional' method,
  60. which requires one of the commercial programs MacTerminal, VersaTerm,
  61. SmartCom][, or MicroPhone.  Several programs to circumvent this and to
  62. simplify some of the processes will be discussed afterward.
  63. .PP
  64. The Unix programs to be discussed are: macput, macget, xbin, macbin, and
  65. unpit.  The principal programs on the Mac discussed are: BinHex, MacTerminal, 
  66. and PackIt.  
  67. .bp
  68. .ti -.20i
  69. .B
  70. .ne 3
  71. .ps +2
  72. BINHEX
  73. .ps -2
  74. .PP
  75. The key to most of this discussion is a program called BinHex for the
  76. Macintosh.  Since programs and documents (other than text files) on the Mac
  77. are made up of 8-bit bytes, and many communications channels only support
  78. 7-bit bytes, there was a need to be able to convert 8-bit material to 7-bits
  79. for transfer, and convert it back once transferred.  BinHex is the program on
  80. the Mac that does this conversion, in both directions.  It traditionally
  81. produces <filename>\fI.hqx\fR as the BinHex version of <filename>.
  82. .sp
  83. .ti -.20i
  84. .B
  85. .ne 3
  86. .ps +2
  87. MACPUT
  88. .ps -2
  89. .PP
  90. It is fairly simple to do the BinHex conversion on the Macintosh, and then
  91. transfer the file via `traditional' means such as umodem/xmodem or
  92. kermit.  The program MacTerminal came out early with the Mac, however,
  93. and provided a feature for transferring files between two Macs hooked
  94. up together.  When configured for two Macs running MacTerminal and
  95. using the XMODEM protocol, the `Receive File...' menu item is
  96. disabled.  If one Mac sends a file, the other automatically receives it
  97. without any action on the part of the user.  Dave Johnson of Brown
  98. University wrote the programs \fImacput\fR and \fImacget\fR for Unix to
  99. `mimic' the actions of MacTerminal.  This allows Unix to transfer files
  100. to the Macintosh in a relatively painless fashion.
  101. .PP
  102. The program \fImacput\fR makes Unix act as a Mac, running MacTerminal, that
  103. has chosen `Send File...' from the `File' menu.  Given a filename, it sends
  104. that Unix file to the Macintosh.  It has several options, the most important
  105. of which is `-u.'  The command \fImacput -u\ <filename>\fR will send <filename>
  106. to the Macintosh as a text file, doing the necessary conversions along the
  107. way.  The command \fImacput\ <filename>\fR looks for three files:
  108. <filename>.\fIrsrc,\fR <filename>.\fIdata,\fR and <filename>.\fIinfo\fR.  These
  109. correspond to the resource and data fork on the Mac, as well as the Finder
  110. info.  Knowledge of how these `sections' work is \fBnot\fR necessary to use
  111. these programs effectively.
  112. .sp
  113. .ti -.20i
  114. .B
  115. .ne 3
  116. .ps +2
  117. MACSEND
  118. .ps -2
  119. .sp
  120. .PP
  121. \fImacsend\fR is a shellscript for Unix that will generate multiple
  122. \fImacput\fR's.  The use of this is in transferring many files with
  123. MacTerminal, where the command \fImacsend <file 1> <file 2> ... <file
  124. n>\fR will transfer all those files without any action on the part of
  125. the user.  This is particularly useful with wildcards, since all the
  126. files to be downloaded can be `collected' into one directory and
  127. \fImacsend *\fR will download all of them.
  128. .sp
  129. .ti -.20i
  130. .B
  131. .ne 3
  132. .ps +2
  133. MACGET
  134. .ps -2
  135. .PP
  136. As a nice complement to \fImacput\fR, the program \fImacget\fR does the
  137. opposite: act as a MacTerminal waiting to receive a file.  Although
  138. MacTerminal is constantly in this `wait for a download' state, Unix is
  139. not.  Hence, \fImacget\fR is necessary to put Unix in that state.  The
  140. command \fImacget\fR is sufficient; it is unnecessary to give it a
  141. filename since the MacTerminal sending the file informs the
  142. `MacTerminal on the other side' (\fImacget\fR in this case) of the name
  143. of the file.  This is the name of the file that appears on the Mac
  144. screen in the box giving the name, size and percentage transferred.  If
  145. given a filename, however, \fImacget\fR will discard the Mac filename
  146. in favor of the one given it.  This program has the same set of options
  147. as \fImacput\fR; they work basically in reverse.  One note:  \fImacget
  148. -u <filename>\fR will take the file transferred as a text file,
  149. converting it, and will add the suffix \fI.text\fR to the filename.
  150. Given no options, \fImacget\fR will create three files:
  151. <filename>\fI.rsrc, \fR <filename>\fI.data, \fR and
  152. <filename>\fI.info\fR.  These can be sent the other direction using
  153. \fImacput <filename>\fR.
  154. .sp
  155. .ti -.20i
  156. .B
  157. .ne 3
  158. .ps +2
  159. XBIN
  160. .ps -2
  161. .PP
  162. Although the two programs \fImacput\fR and \fImacget\fR provide an nice
  163. method of tranferring files between Unix and MacTerminal, the next step
  164. is avoiding the BinHex process on the Macintosh.  The Unix program
  165. \fIxbin\fR does the conversion \fBfrom\fR BinHex format \fBto\fR 8-bit
  166. format on Unix.  Given a file <filename.hqx> (the .hqx suffix is
  167. presumed but not necessary), \fIxbin <filename.hqx>\fR will produce
  168. <filename>\fI.rsrc,\fR <filename>\fI.data,\fR and
  169. <filename>\fI.info.\fR These are perfect for \fImacput\fR to download
  170. to the Mac.  In the the case of an application program, once downloaded
  171. it is ready to run.
  172. .sp
  173. .ti -.20i
  174. .B
  175. .ne 3
  176. .ps +2
  177. NET.SOURCES.MAC
  178. .ps -2
  179. .sp
  180. .PP
  181. One of the primary uses of this xbin/macput procedure is to take
  182. advantage of the programs and information posted to net.sources.mac.
  183. This article assumes basic knowledge of the news system.  The procedure 
  184. is fairly simple:
  185. .sp
  186. .in +0.75i
  187. .ne 3
  188. .ti -.20i
  189. 1. Save the program to your own directory from the news program.  (`s
  190. <filename>' using \fIrn\fR)  This is necessary since xbin produces
  191. files in the current directory; so write permission on the directory is
  192. necessary.  An alternative to this is to use
  193. \fIxbin\ /usr/spool/news/net/sources/mac/????\fR while in the directory
  194. you wish the files to be in.
  195. .sp
  196. .ne 3
  197. .ti -.20i
  198. 2. \fIxbin <filename>\fR   This will produce three files with the
  199. suffixes \fI.rsrc, .data, and .info.\fR  Use `ls' to check what the
  200. name is, since \fIxbin\fR restores the name used by the `creator' of
  201. the file.
  202. .sp
  203. .ne 3
  204. .ti -.20i
  205. 3. \fImacput <file>,\fR where <file> is the name before the suffixes
  206. mentioned above.  i.e., <file>.rsrc, <file>.data, and <file>.info
  207. should all exist.  If the file is a text file, use \fImacput -u
  208. <file>\fR to transfer it.
  209. .sp
  210. .ne 3
  211. .ti -.20i
  212. 4. MacTerminal will put up a window showing the name of the file, the
  213. size, and what percentage has been transferred.  This will disappear
  214. when completed; if there is an error, MacTerminal will alert that `File
  215. Transfer Unsuccessful!'
  216. .sp
  217. .ne 3
  218. .ti -.20i
  219. 5. Once successfully completed, the files on Unix may be deleted, if so
  220. desired, and upon quitting MacTerminal the programs and/or files
  221. transferred will show up on the disk, `ready to run.'  MacTerminal
  222. places the files downloaded on the disk holding the MacTerminal
  223. document that was opened.  Other programs vary\-see the next section on
  224. `Other Programs For MacTerminal Transfers.'
  225. .sp
  226. .in -0.75i
  227. .ti -.20i
  228. .ne 3
  229. .B
  230. .ps +2
  231. Other Programs For MacTerminal Transfers
  232. .ps -2
  233. .sp
  234. .PP
  235. There are several commercial terminal programs for the Macintosh that have
  236. included `MacTerminal Transfers' in their reportoire of file transfer
  237. protocols.  Currently (June 1986) those known are: VersaTerm, VersaTerm Pro,
  238. SmartCom\ ][, and MicroPhone.  VersaTerm and VersaTerm Pro handle the
  239. transfers similarly to MacTerminal.  VersaTerm 1.52 downloads files
  240. onto the disk it was run from; VersaTerm 2.0 and VersaTerm Pro
  241. allow the user to specify the `Receive Volume' from the `About
  242. VersaTerm' menu.  SmartCom ][ forces you to give the file a name, and
  243. does not accept the transfer `automatically'\-the user must specify
  244. that a file is to be received.  MicroPhone has not been tested here,
  245. but is believed to work in the same fashion as MacTerminal.
  246. .sp
  247. .ti -.20i
  248. .B
  249. .ne 3
  250. .ps +2
  251. PackIt and unpit
  252. .ps -2
  253. .sp
  254. .PP
  255. \fIPackIt\fR is a program to put several files together into one for
  256. easy transfer.  This can greatly facilitate moving many small files,
  257. since only one must be transferred.  This makes it easier to transfer,
  258. but requires that the file be `packed' and `unpacked', thus adding
  259. steps to the process.  There is a newer version, called
  260. \fIPackIt\ II,\fR that does some compression of the file as well.  Use
  261. of this format on Usenet is presently controversial since it is shareware,
  262. not public domain.
  263. .PP
  264. Just as \fIxbin\fR does the job of BinHex, \fIunpit\fR does the job
  265. of `unpacking' files on Unix.  The normal procedure is to 
  266. \fIxbin\fR\ <filename>, and then `\fIunpit\fR <filename>\fI.data.'\fR  This
  267. will create all the original files, each with the appropriate 
  268. <file>.rsrc, <file>.data, and <file>.info.  These may then be downloaded with
  269. \fImacput.\fR
  270. .sp
  271. .ti -.20i
  272. .B
  273. .ne 3
  274. .ps +2
  275. MacBinary and macbin
  276. .ps -2
  277. .sp
  278. .PP
  279. MacBinary is an 8-bit format developed for Bulletin Board Systems and
  280. commercial services such as CompuServe.  It is  not useful for transfer
  281. between most mainframes, since those connections are limited to 7
  282. bits.  As a popular format that is included in many Macintosh
  283. communications programs, however, its structure is similar to the
  284. <filename>\fI.rsrc,\fR <filename>\fI.data,\fR and <filename>\fI.info\fR
  285. files created by \fIxbin.\fR  Since they are similar, Jim Budler wrote
  286. the program \fImacbin,\fR  that takes the three files created by
  287. \fIxbin\fR and creates one file, <filename>\fI.bin,\fR which can be
  288. transferred as a MacBinary file.  This is primarily to allow people to
  289. use programs other than the commercial ones such as MacTerminal for
  290. transfers.  Currently (June 1986) the public domain and shareware
  291. programs known to support this are Red Ryder 5.0 - 9.2 (shareware) and
  292. FreeTerm 1.7/1.8.  Commercial programs that support it are:
  293. MacTerminal 2.0, VersaTerm and VersaTerm Pro, SmartCom ][ 2.1D,
  294. MicroPhone, InTouch 2.0, and undoubtedly some others as well.
  295.