From ce97ebe84c42f255eb772bb07fef0814ba26d52e Mon Sep 17 00:00:00 2001 From: Greg Hudson Date: Sun, 22 Nov 2009 18:20:36 +0000 Subject: [PATCH] Update the build system documentation: * The test suite no longer requires root. * appl no longer contains what it used to contain. * Mention --disable-rpath as an alternative for make check. ticket: 6583 status: open git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@23309 dc483132-0cff-0310-8789-dd5450dbe970 --- doc/build.texinfo | 46 +++++++++++----------------------------------- 1 file changed, 11 insertions(+), 35 deletions(-) diff --git a/doc/build.texinfo b/doc/build.texinfo index 8bf08157e..2b23fcaad 100644 --- a/doc/build.texinfo +++ b/doc/build.texinfo @@ -73,15 +73,10 @@ source code for building @value{PRODUCT} on Windows (see windows/README) @node The appl Directory, The clients Directory, Organization of the Source Directory, Organization of the Source Directory @subsection The appl Directory -The Kerberos release provides certain UNIX utilities, modified to use -Kerberos authentication. In the @i{appl/bsd} directory are the -Berkeley utilities @i{login}, @i{rlogin}, @i{rsh}, and @i{rcp}, as well as -the associated daemons @i{kshd} and @i{klogind}. The @i{login} program -obtains ticket-granting tickets for users upon login; the other utilities -provide authenticated Unix network services. - -The @i{appl} directory also contains Kerberized telnet and ftp programs, -as well as sample Kerberos application client and server programs. +The @i{appl} directory contains sample Kerberos application client and +server programs. In previous releases, it contained Kerberized versions +of remote access daemons, but those have now been moved to a separate +project. @node The clients Directory, The gen-manpages Directory, The appl Directory, Organization of the Source Directory @subsection The clients Directory @@ -397,12 +392,13 @@ tell it the location of the Tcl configuration script. (See @xref{Options to Configure}.) @item -You have to run @samp{make install} before running @samp{make check}, or -the test suite will often pick up the installed version of Kerberos -rather than the newly built one. You can install into a prefix that -isn't in the system library search path, though. This theoretically -could be fixed with the appropriate environment variable magic in the -test suite, but hasn't been yet. +On some operating systems, you have to run @samp{make install} before +running @samp{make check}, or the test suite will pick up installed +versions of Kerberos libraries rather than the newly built ones. You +can install into a prefix that isn't in the system library search path, +though. Alternatively, you can configure with @code{--disable-rpath}, +which renders the build tree less suitable for installation, but allows +testing without interference from previously installed libraries. @item In order to test the RPC layer, the local system has to be running the @@ -425,26 +421,6 @@ client/server activities. DejaGnu may be found wherever GNU software is archived. -Most of the tests are setup to run as a non-privileged user. For some -of the krb-root tests to work properly, either (a) the user running the -tests must not have a .k5login file in the home directory or (b) the -.k5login file must contain an entry for @code{@@KRBTEST.COM}. -There are two series of tests (@samp{rlogind} and @samp{telnetd}) which -require the ability to @samp{rlogin} as root to the local -machine. Admittedly, this does require the use of a @file{.rhosts} file -or some authenticated means. @footnote{If you are fortunate enough to -have a previous version of Kerberos V5 or V4 installed, and the Kerberos -rlogin is first in your path, you can setup @file{.k5login} or -@file{.klogin} respectively to allow you access.} - -If you cannot obtain root access to your machine, all the other tests -will still run. Note however, with DejaGnu 1.2, the "untested testcases" -will cause the testsuite to exit with a non-zero exit status which -@samp{make} will consider a failure of the testing process. Do not worry -about this, as these tests are the last run when @samp{make check} is -executed from the top level of the build tree. This problem does not -exist with DejaGnu 1.3. - @node The KADM5 Tests, , The DejaGnu Tests, Testing the Build @subsection The KADM5 Tests -- 2.26.2