To Build the Macintosh version of Kerberos 5

These directions assume that the source is located in ~/k5mac.


1) Prepare Files to Move to the Mac

On the unix side, after checking out the source, build the target 
"kerbsrc.mac":
   
   cd ~/k5mac/src
   make -f Makefile.in kerbsrc.mac (the product of the make is "kerbsrc.tar")


2) Move the Source to the Mac

Transfer the resulting file from the previous step (kerbsrc.tar) to the
Macintosh.  Remember it is a tar file, and must be transferred in binary mode
without conversion.


3) Unpack the Source on the Mac

Untar the file onto a Macintosh disk.  The final built version occupies
on the order of 10M on disk.  If your tar expander program supports CR-LF
translation, turn it on to avoid having to perform the conversions yourself
in a later step.
	
    Programs that can perform tar translations:
    suntar 2.0.3   available on mac.archive.umich.edu
    untar          available on mac.archive.umich.edu
    tar 4.0        available on mac.archive.umich.edu
    StuffIt Deluxe (with an additional tar translator)
	
    suntar and StuffIt deluxe can perform cr-lf translations

NOTE:  Beware that all tars are not created equal.  Some tars will dump 
the first level directory into the source file location, while others 
will create a directory and place the contents in that, and yet others 
will ask where the destination should start.  Suntar seems to do the 
"right" thing more often than not.


4) Perform CR-LF Conversion

If your tar program does support CR-LF translation, or you decided not to use
translation, you will need to convert the source files to Mac format text files.
Again there are a selection of programs that perform this function:
	
   Drop Text  available on mac.archive.umich.edu
   CRLF       available on mac.archive.umich.edu
   StuffIt    Deluxe (with translator) from Aladdin Systems Inc.
   BBEdit     demo version available on mac.archuve.umich.edu
              or Bare Bones Software

I would strongly recommend Drop Text, it seems to be the most flexible
of the above programs.


5) Unstuff .hqx Files

At this point all source files are now Mac text files. There are two
files which have been packed in binhex format for the Mac to ensure
the resource forks were not damaged, and that binary translation did
not corrupt them. These files are located in the following paths:

   :mac:ncsa-telnet:telnet-2.7k5.sit.hqx
   :mac:ncsa-telnet:telnet-2.7k5-source.sit.hqx
		
The first is a slightly modified version of NCSA Telnet 2.7b4 that
works with the authentication/encryption plugin in
:mac:telnet-k5-auth. The second file is the source for it--you only
need to unstuff it if you are planning to rebuild it.

To convert these files, use a program (listed below) to convert the
file from binhqx format, then convert the "xxx.sit" file which should
result from the previous conversion to the expanded files. There are
programs which accomplish both steps automatically.
		
To convert from binhex to archive:
   StuffIt Expander	(available on mac.archive.umich.edu)
   StuffIt Deluxe (with binhex translator)
   binhex
   suntar 2.0.3
		
To convert from archive to individual files:
   StuffIt Expander	(available on mac.archive.umich.edu)
   StuffIt Deluxe
   StuffIt Lite
   DropUnstuff
   NOW Utilities 5.0 Quickfiler


6) Build the Kerberos Libraries and Applications
	
Open MPW and use the `Directory' command in the MPW Shell to change to
the top-level directory of your Kerberos build tree. (If your
untarring program output MPW text files, you can do start up MPW in
that directory by double-clicking on one of the files in that
directory.) In the Worksheet window, type `:makeworld' and Enter or
Command+Return. (Note the `:' before `makeworld'.) This should
automatically build the libraries, CNS Config program (in
:mac:kconfig), telnet authentication plugin (in :mac:telnet-k5-auth),
and GSS sample application (in :mac:gss-sample).


7) Build Kerberized Telnet (optional)

If you want to rebuild NCSA Telnet, unpack the sources as described
above, open the 68k or PPC project file in CodeWarrior, and type
Command+M (or choose `Make' from the `Project' menu). The PPC project
expects the 68k client to have been built already, and incorporates it
into a fat executable.



Installation

The following assumes that you have followed the steps above to build
the Kerberos libraries. What you now have supports both the Kerberos
and GSS APIs. Following are the binary components provided in this
release:

   * CodeWarrior static libraries for 68k and PPC Macintosh
     (libgss.68k, libkrb5.68k, libgss.PPC, libkrb5.PPC)

   * CodeWarrior static libraries for 68k Code Resources
     (libgss.68k.a4, libkrb5.68k.a4)

   * Cygnus Network Security Configuration program
     (:mac:kconfig:CNS Config)
    
   * GSS Sample application
     (:mac:gss-sample:gss-client)
    
   * Sample krb5.ini file using CYGNUS.COM as the default realm
     (:mac:krb5.ini)
