docs/50349: make release fails with NO_OPENSSH and ! NOKERBEROS

[Stijn Hoop]

>Number:         50349
>Category:       docs
>Synopsis:       make release fails with NO_OPENSSH and ! NOKERBEROS
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 27 07:30:09 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     Stijn Hoop
>Release:        FreeBSD 4.8-RC i386
>Organization:
>Environment:

System: FreeBSD 4.8-RC #0: Tue Mar 4 10:10:51 CET 2003

>Description:

make release will fail during the release.3 step if the world built in the
chroot area was built with NO_OPENSSH / NO_OPENSSL flags, and the
NOKERBEROS flag was not passed to make release. This flag is not documented
in release(7). The attached patch documents it.

As I don't know what other flags affect failure, I just documented the
fact that there is a flag to avoid building the kerberos bits. Maybe
someone more in the know can add something to text to indicate kerberos's
dependancy on either OpenSSH or OpenSSL.

>How-To-Repeat:

# grep NO_OPEN /release/etc/make.conf
NO_OPENSSH=	yes
NO_OPENSSL=	yes
# cd /usr/src/release && make release CHROOTDIR=/release \
	RELEASETAG=RELENG_4 BUILDNAME=RELENG_4-MYRELEASE CVSROOT=${CVSROOT}

And wait for an error about a missing openssl/des.h header.

>Fix:

--- release.7.orig	Thu Mar 27 16:03:14 2003
+++ release.7	Thu Mar 27 16:02:48 2003
@@ -257,6 +257,11 @@
 distribution will still be created with the minimal documentation set
 provided in
 .Pa src/share/doc .
+.It Va NOKERBEROS
+If set to
+.Dq Li YES
+then the Kerberos IV and Kerberos 5 (Heimdal) components will be
+omitted from the release.
 .It Va NOPORTS
 If set to
 .Dq Li YES
>Release-Note:
>Audit-Trail:
>Unformatted: