INSTALL.MacOS

   1 OpenSSL - Port To The Macintosh
   2 ===============================
   3
   4 Thanks to Roy Wood <roy@centricsystems.ca> initial support for MacOS (pre
   5 X) is now provided. "Initial" means that unlike other platforms where you
   6 get an SDK and a "swiss army" openssl application, on Macintosh you only
   7 get one sample application which fetches a page over HTTPS(*) and dumps it
   8 in a window. We don't even build the test applications so that we can't
   9 guarantee that all algorithms are operational.
  10
  11 Required software:
  12
  13 - StuffIt Expander      (or any program capable to "unbinhex");
  14 - DropStuff w/EE        (or MacGzip and SUNtar);
  15 - CodeWarrior Pro 5;
  16
  17 Installation procedure:
  18
  19 - fetch the source at ftp://ftp.openssl.org/ (well, you probably already
  20   did, huh?)
  21 - unpack the .tar.gz file:
  22         - if you have DropStuff w/EE installed then just drag it over
  23           StuffIt Expander;
  24         - otherwise process it first with MacGzip and then with SUNtar;
  25 - locate MacOS folder in OpenSSL source tree and open it;
  26 - if present (**) unbinhex mklinks.as.hqx and OpenSSL.mcp.hqx, do it
  27   "in-place", i.e. unpacked files should end-up in the same folder;
  28 - double-click on mklinks.as;
  29 - open OpenSSL.mcp and build 'GetHTTPS PPC' target (the only one working
  30   for the moment);
  31 - that's it;
  32
  33 (*)     URL is hardcoded into ./MacOS/GetHTTPS.src/GetHTTPS.cpp, lines 40
  34         to 42, change appropriately.
  35 (**)    If you use SUNtar, then it might have already unbinhexed the files
  36         in question.
  37
  38 Finally some essential comments from our generous contributor:-)
  39
  40 "I've gotten OpenSSL working on the Macintosh. It's probably a bit of a
  41 hack, but it works for what I'm doing. If you don't like the way I've done
  42 it, then feel free to change what I've done. I freely admit that I've done
  43 some less-than-ideal things in my port, and if you don't like the way I've
  44 done something, then feel free to change it-- I won't be offended!
  45
  46 ... I've tweaked "bss_sock.c" a little to call routines in a "MacSocket"
  47 library I wrote. My MacSocket library is a wrapper around OpenTransport,
  48 handling stuff like endpoint creation, reading, writing, etc. It is not
  49 designed as a high-performance package such as you'd use in a webserver,
  50 but is fine for lots of other applications. MacSocket also uses some other
  51 code libraries I've written to deal with string manipulations and error
  52 handling. Feel free to use these things in your own code, but give me
  53 credit and/or send me free stuff in appreciation! :-)
  54
  55 ...
  56
  57 If you have any questions, feel free to email me as the following:
  58
  59 roy@centricsystems.ca
  60
  61 -Roy Wood"
  62