diff options
Diffstat (limited to 'src/mac/ReadMe')
| -rw-r--r-- | src/mac/ReadMe | 139 |
1 files changed, 0 insertions, 139 deletions
diff --git a/src/mac/ReadMe b/src/mac/ReadMe deleted file mode 100644 index 9e5226b69..000000000 --- a/src/mac/ReadMe +++ /dev/null @@ -1,139 +0,0 @@ -Building the Macintosh version of Kerberos 5 and GSS ----------------------------------------------------- - -(Last updated $Date$) - -If you have questions or comments about the Macintosh build process, -send e-mail to <macdev@mit.edu> . - - -To build the Macintosh version of Kerberos 5 and GSS: - ---- Installing tools --- - - 1) Install CodeWarrior Pro 4, including MPW. - This build of Kerberos v5 and GSS requires CodeWarrior Pro4 MPW tools. - Don't forget to run one of 4 Metrowerks MPW scripts, as described at the - bottom of MPW worksheet the first time you launch it. - - 2) Download MacPerl and MacPerl MPW tool from - - <ftp://sunsite.cnlab-switch.ch/software/platform/macos/perl/> - - The MacPerl directory contains several versions of the app and the MPW - tool. The *_appl and *_tool versions work properly with our scripts, e.g., - you should download "Mac_Perl_520r4_appl.bin" and "Mac_Perl_520r4_tool.bin". - - 3) Install MacPerl and MacPerl MPW tool by following the installation - instructions provided with them: - - install MacPerl application before installing MacPerl tool - - after installing MacPerl tool, run its MPW configuration script - and follow the instructions - ---- Preparing Kerberos v5 build tree --- - - 4) Launch MPW. - - 5) Set directory in MPW to the top level of Kerberos 5 distribution - (e.g. "GSS-Kerberos5"). - - 6) Build target "prebuild" in MPW. - This will create a new Makefile, so you may be asked whether you - want to save changes to the Makefile if you opened it before step - 6. Save the changes. - ---- Building libraries --- - - 7) Build target "all" in MPW. Wait. - - Example build times: 30-40 minutes on a G3 machine, 80 minutes - on a PowerMac 9600/233. - - You may receive some compile warnings about an ignored pragma, warnings - about illegal implicit const pointer conversions, and some link warnings. - These are normal and can be ignored. - - We used to see MPW crash during the link stage of the build. We think this - has been fixed. If this happens to you, you should restart MPW and start - the build again, and report the problem to macdev@mit.edu. - ---- Binaries --- - - The following assumes that you have followed the steps above to build - the GSS & Kerberos 5 libraries. What you now have supports both the - Kerberos 5 and GSS APIs. Each is supported as both CFM shared libraries - and CodeWarrior static link libraries for both 68k & PowerPC Macs. - We strongly recommend you use the CFM shared libraries. - - The following binary components are provided/built in this release: - - ":MIT Kerberos Library" - * Fat CFM Shared Library including GSS, and Kerberos v5, CCache, and DES - libraries. - * Not for linking against in your projects; include in distributions to - be placed in System Folder:Extensions. - - :GSSLib.68K - * CFM Shared Library including GSS for 68k Macs. - - :GSSLib.PPC - * CFM Shared Library including GSS for PowerPC Macs. - - :Kerberos5Lib.68K - * CFM Shared Library including Kerberos 5 for 68k Macs. - - :Kerberos5Lib.68K - * CFM Shared Library including Kerberos 5 for PowerPC Macs. - - :mac:krb5.ini - * Sample krb5.ini file using CYGNUS.COM as the default realm - - :include - * An include directory containing the files necessary for development - ---- Installation --- - - To install the Kerberos 5 system on your Mac: - - 1) Copy the :mac:krb5.ini file (configured for your site) into - the "Preferences" folder in the "System Folder". - - 2) Install the shared libraries by copying the "MIT Kerberos Library" file - to the "Extensions" folder in the "System Folder". - - 3) If you are using System 7.6 or earlier on a 68K Mac, install - the CFM-68K Runtime Enabler 4.0, available from Apple at: - - <ftp://ftp.info.apple.com/Apple_Support_Area/Apple_Software_Updates/US/Macintosh/System/CFM-68K/> - ---- Getting Started Programming --- - - You can program using either the Kerberos 5 or GSS APIs. - - To add Kerberos functionality to a Code Warrior based application: - - 1) PPC application: use shared libraries: - For GSSAPI, add GSSLibraryPPC to your project - For Kerberos v5 API, add K5LibraryPPC to your project - Set the project options to 4 byte integers and enums treated as ints. - - 2) CFM-68K application: use shared libraries - For GSSAPI, add GSSLibrary68K to your project - For Kerberos v5 API, add K5Library68K to your project - Set the project options to 4 byte integers and enums treated as ints. - - 3) Classic 68K application: use glue for shared libraries - For GSSAPI, add GSSLib.glue.c to your project - For Kerberos v5 API, add Kerberos5.glue.c to your project - Set the project options to 4 byte integers and enums treated as ints. - - A PDF document describing the Kerberos 5 API is located at: - - <http://web.mit.edu/macdev/mit/doc/pdf/krb5api.pdf> - - (That document was created from tex files in the main Kerberos 5 source tree.) - - The GSSAPI is described in Internet RFC's 1508 and 1509: - - <http://info.internet.isi.edu/in-notes/rfc/files/rfc1508.txt> - <http://info.internet.isi.edu/in-notes/rfc/files/rfc1509.txt> |