zephyr/INSTALL

   1 This file explains how to build and install Zephyr on a machine.  To
   2 learn how to use Zephyr once you've installed it, read the file USING.
   3 To learn how to set up Zephyr service at a site, read the file
   4 OPERATING.
   5
   6 To build and install Zephyr, run:
   7
   8         ./configure
   9         make
  10         make install
  11
  12 This will build Zephyr without Hesiod or Kerberos support, and install
  13 in /usr/local.  To install in a location other than /usr/local, add
  14 "--prefix=INSTPREFIX" to the configure line, where INSTPREFIX is the
  15 directory you want to install Zephyr in.
  16
  17 If your site has a Hesiod service with a valid zephyr.sloc entry (or
  18 you can add one), you can enable Hesiod support by adding the option
  19 "--with-hesiod=HESPREFIX" to the configure line, where
  20 HESPREFIX/include and HESPREFIX/lib are the directories you have the
  21 Hesiod libraries installed in.
  22
  23 If your site has a Kerberos 4 service, you can enable Kerberos support
  24 by adding the option "--with-krb4=KRBPREFIX" to the configure line,
  25 where KRBPREFIX/include and KRBPREFIX/lib are the direcetories you
  26 have the Kerberos libraries installed in.
  27
  28 If you have a make which supports VPATH in a manner compatible with
  29 GNU make, you can build in a separate directory.  Simply invoke the
  30 configure script from within the build directory and configure will
  31 locate the source directory for you.  (If that doesn't work for some
  32 reason, you can also specify "--srcdir=SOURCEDIR" on the configuration
  33 line.)
  34
  35 If configure can't properly find your X11 include or library
  36 directories, add "--x-includes=INCDIR" and "--x-libraries=LIBDIR" to
  37 the configure line.  To build without X11 support, add "--without-x"
  38 to the configure line.
  39
  40 If you have Hesiod and/or Kerberos installed such that you can't
  41 specify a single prefix for both include files and libraries, set the
  42 environment variables CPPFLAGS and LDFLAGS to include the relevant
  43 directories, and just configure with "--with-krb4" and
  44 "--with-hesiod".  For instance (for a csh-like shell):
  45
  46         setenv CPPFLAGS "-I/opt/athena/include"
  47         setenv LDFLAGS "-I/opt/athena/arch/sparc/lib"
  48         ./configure --with-hesiod --with-krb4
  49         make
  50         make install
  51
  52 Although it's not necessary for Zephyr to function correctly, you
  53 should add the following services to /etc/services if possible:
  54
  55 zephyr-clt      2103/udp                        # Zephyr serv-hm connection
  56 zephyr-hm       2104/udp                        # Zephyr hostmanager
  57 zephyr-hm-srv   2105/udp                        # Zephyr hm-serv connection
  58
  59 To learn how to use Zephyr, read the file USING and the man pages for
  60 the various Zephyr programs.  To learn how to operate a Zephyr
  61 service, read the file OPERATING.
  62
  63 We have tried to make Zephyr as portable as is reasonably possible,
  64 but have not taken into account every possible kind of system.  If you
  65 have any problems building or installing Zephyr according to these
  66 instructions, please send mail to zephyr-bugs@mit.edu.
  67