From rdm@cfcl.com  Mon Jan  7 03:34:11 2002
Return-Path: <rdm@cfcl.com>
Received: from idiom.com (idiom.com [216.240.32.1])
	by hub.freebsd.org (Postfix) with ESMTP id 4F47137B41C
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  7 Jan 2002 03:34:10 -0800 (PST)
Received: from cfcl.com (cpe-24-221-169-54.ca.sprintbbd.net [24.221.169.54])
	by idiom.com (8.9.3/8.9.3) with ESMTP id DAA48281
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 7 Jan 2002 03:34:09 -0800 (PST)
Received: (from rdm@localhost)
	by cfcl.com (8.11.1/8.11.1) id g07Baeh35262;
	Mon, 7 Jan 2002 03:36:40 -0800 (PST)
	(envelope-from rdm)
Message-Id: <200201071136.g07Baeh35262@cfcl.com>
Date: Mon, 7 Jan 2002 03:36:40 -0800 (PST)
From: Rich Morin <rdm@cfcl.com>
Reply-To: rdm@cfcl.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: k5list(1) contains many incorrect "klist" entries.
X-Send-Pr-Version: 3.2
X-GNATS-Notify: ru

>Number:         33645
>Category:       docs
>Synopsis:       k5list(1) contains many incorrect "klist" entries.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jan 07 03:40:00 PST 2002
>Closed-Date:    Thu Aug 26 06:34:00 GMT 2004
>Last-Modified:  Thu Aug 26 06:34:00 GMT 2004
>Originator:     Rich Morin
>Release:        FreeBSD 4.4-RELEASE i386
>Organization:
Canta Forda Computer Laboratory
>Environment:

        FreeBSD fb44.cfcl.com 4.4-RELEASE FreeBSD 4.4-RELEASE #0:
        Tue Sep 18 11:57:08 PDT 2001    
        murray@builder.FreeBSD.org:/usr/src/sys/compile/GENERIC  i386

>Description:

        At many locations in the k5list(1) man page, the program
        name is given as "klist".  There is, however, a man page
        for klist(1), per se.  Also, /usr/bin/{k,k5}list are two
        separate files.

>How-To-Repeat:

        % man k5list

>Fix:

	Edit "klist" to "k5list" throughout the k5list man page.
        Might also want to put in a SEE ALSO link to klist(1).
>Release-Note:
>Audit-Trail:

From: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit <FreeBSD-gnats-submit@FreeBSD.org>
Cc:  
Subject: Re: docs/33645: k5list(1)  [update]
Date: Thu, 10 Jan 2002 10:43:51 -0500

 Is this contributed software?  Should it be reported to the maintainer, 
 or perhaps where the software came from?  This is only being pointed out 
 because I do not have k5list(1) or klist(1) on my 4.4-RELEASE nor 
 5.0-CURRENT system...  Comments?
 
 
 -- 
 Tom (Darklogik) Rhodes
 www.Pittgoth.com Gothic Liberation Front
 www.FreeBSD.org  The Power To Serve
 
Responsible-Changed-From-To: freebsd-doc->assar 
Responsible-Changed-By: ru 
Responsible-Changed-When: Wed Jan 16 07:04:25 PST 2002 
Responsible-Changed-Why:  
Assar, could you please fix this and commit the fix on the vendor 
and RELENG_4 branches (if re@ approves). 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=33645 

From: Ruslan Ermilov <ru@FreeBSD.org>
To: assar@FreeBSD.org
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/33645: k5list(1) contains many incorrect "klist" entries.
Date: Thu, 24 Jan 2002 14:00:40 +0200

 --Q68bSM7Ycu6FN28Q
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 On Wed, Jan 23, 2002 at 08:55:16PM +0100, assar@FreeBSD.org wrote:
 > Ruslan Ermilov <ru@FreeBSD.org> writes:
 > > Besides some bugs in Makefiles (please test them with "make all-man"),
 > > may I suggest that you use MANFILTER to tweak the contents of manpages
 > > rather than patching them directly on the HEAD branch and taking them
 > > off the vendor branch?
 > 
 > That's a better idea.  This patch (which passes "make all-man") does
 > that.  Comments?
 > 
 kadmin didn't pass the "make all-man" for me, CLEANFILES still not
 fixed, style bugs (should be space after a ":" on dependency lines).
 Besides that, there are some undesirable changes caused by this
 MANFILTER:
 
 : --- ./libexec/hpropd/hpropd.8.filt.old	Thu Jan 24 12:34:13 2002
 : +++ ./libexec/hpropd/hpropd.8.filt	Thu Jan 24 12:34:58 2002
 : @@ -53,7 +53,7 @@
 :  Principals are always allowed to change their own password and list
 :  their own principals.  Apart from that, doing any operation requires
 :  permission explicitly added in the ACL file
 : -.Pa /var/heimdal/kadmind.acl .
 : +.Pa /var/heimdal/k5admind.acl .
 :  The format of this file is:
 :  .Bd -ragged
 :  .Va principal
 : @@ -122,16 +122,16 @@
 :  .El
 :  .\".Sh ENVIRONMENT
 :  .Sh FILES
 : -.Pa /var/heimdal/kadmind.acl
 : +.Pa /var/heimdal/k5admind.acl
 :  .Sh EXAMPLES
 : --- ./lib/libkrb5/krb5.conf.5.filt.old	Thu Jan 24 12:34:12 2002
 : +++ ./lib/libkrb5/krb5.conf.5.filt	Thu Jan 24 12:34:57 2002
 : @@ -188,9 +188,9 @@
 :  .It Li admin_server = Va host[:port]
 :  Specifies the admin server for this realm, where all the modifications
 :  to the database are perfomed.
 : -.It Li kpasswd_server = Va host[:port]
 : +.It Li k5passwd_server = Va host[:port]
 :  Points to the server where all the password changes are perfomed.
 : -If there is no such entry, the kpasswd port on the admin_server host
 : +If there is no such entry, the k5passwd port on the admin_server host
 :  will be tried.
 :  .It Li v4_instance_convert
 :  .It Li v4_name_convert
 : @@ -270,10 +270,10 @@
 :  .It logging = Va Logging
 :  What type of logging the kdc should use, see also [logging]/kdc.
 :  .El
 : -.It Li [kadmin]
 : +.It Li [k5admin]
 :  .Bl -tag -width "xxx" -offset indent
 :  .It require-preauth = Va BOOL
 
 The solution I have found working without ill effects was:
 
 1.  Modify MANFILTER to only do substitutions for the .Dt, .Nm,
     and .Xr macros.
 
 2.  Tweak relevant manpages that miss the necessary markup bits.
 
 Attached are two patches, for kerberos5/ and for crypto/heimdal/
 that implement this, and fix the bugs mentioned above.
 
 
 Cheers,
 -- 
 Ruslan Ermilov		Oracle Developer/DBA,
 ru@sunbay.com		Sunbay Software AG,
 ru@FreeBSD.org		FreeBSD committer,
 +380.652.512.251	Simferopol, Ukraine
 
 http://www.FreeBSD.org	The Power To Serve
 http://www.oracle.com	Enabling The Information Age
 
 --Q68bSM7Ycu6FN28Q
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="kerberos5.patch"
 
 Index: Makefile.inc
 ===================================================================
 RCS file: /home/ncvs/src/kerberos5/Makefile.inc,v
 retrieving revision 1.8
 diff -u -r1.8 Makefile.inc
 --- Makefile.inc	2001/08/03 16:03:24	1.8
 +++ Makefile.inc	2002/01/24 11:32:09
 @@ -170,4 +170,15 @@
  
  .endif
  
 +MANFILTER=	sed -E -e'/^\.(Dt|Nm|Xr)/{' \
 +		-e's,KADMIN,K5ADMIN,g' -e's,kadmin,k5admin,g' \
 +		-e's,KADMIND,K5ADMIND,g' -e's,kadmind,k5admind,g' \
 +		-e's,KSTASH,K5STASH,g' -e's,kstash,k5stash,g' \
 +		-e's,KPASSWD,K5PASSWD,g' -e's,kpasswd,k5passwd,g' \
 +		-e's,KPASSWDD,K5PASSWDD,g' -e's,kpasswdd,k5passwdd,g' \
 +		-e's,KDESTROY,K5DESTROY,g' -e's,kdestroy,k5destroy,g' \
 +		-e's,KINIT,K5INIT,g' -e's,kinit,k5init,g' \
 +		-e's,KLIST,K5LIST,g' -e's,klist,k5list,g' \
 +		-e'}'
 +
  .endif
 Index: libexec/k5admind/Makefile
 ===================================================================
 RCS file: /home/ncvs/src/kerberos5/libexec/k5admind/Makefile,v
 retrieving revision 1.6
 diff -u -r1.6 Makefile
 --- libexec/k5admind/Makefile	2001/02/13 16:56:57	1.6
 +++ libexec/k5admind/Makefile	2002/01/24 11:32:14
 @@ -30,11 +30,15 @@
  DPADD=		${LIBKRB5} ${LIBKAFS5} ${LIBROKEN} ${_krb4deps} \
  		${LIBKADM5CLNT} ${LIBKADM5SRV} ${LIBHDB} \
  		${LIBASN1} ${LIBCRYPTO} ${LIBMD} ${LIBCRYPT} ${LIBCOM_ERR}
 -NOMAN=		yes
 +MAN=		k5admind.8
 +CLEANFILES=	${MAN}
  
  .include <bsd.prog.mk>
  
  .PATH:	${KRB5DIR}/kadmin
 +
 +k5admind.8: kadmind.8
 +	ln -sf ${.ALLSRC} ${.TARGET}
  
  kadm5/private.h:	kadm5
  	cp ${KRB5DIR}/lib/kadm5/private.h ${.TARGET}
 Index: libexec/k5passwdd/Makefile
 ===================================================================
 RCS file: /home/ncvs/src/kerberos5/libexec/k5passwdd/Makefile,v
 retrieving revision 1.7
 diff -u -r1.7 Makefile
 --- libexec/k5passwdd/Makefile	2001/03/27 14:07:29	1.7
 +++ libexec/k5passwdd/Makefile	2002/01/24 11:32:14
 @@ -25,11 +25,15 @@
  		-L${ASN1OBJDIR} -lasn1 -lcrypto -lmd -lcrypt -lcom_err
  DPADD=		${LIBKRB5} ${LIBROKEN} ${_krb4deps} \
  		${LIBASN1} ${LIBCRYPTO} ${LIBMD} ${LIBCRYPT} ${LIBCOM_ERR}
 -MAN=		kpasswdd.8
 +MAN=		k5passwdd.8
 +CLEANFILES=	${MAN}
  
  .include <bsd.prog.mk>
  
  .PATH:	${KRB5DIR}/kpasswd
 +
 +k5passwdd.8: kpasswdd.8
 +	ln -sf ${.ALLSRC} ${.TARGET}
  
  kadm5/admin.h:	kadm5
  	cp ${KRB5DIR}/lib/kadm5/admin.h ${.TARGET}
 Index: usr.bin/k5admin/Makefile
 ===================================================================
 RCS file: /home/ncvs/src/kerberos5/usr.bin/k5admin/Makefile,v
 retrieving revision 1.6
 diff -u -r1.6 Makefile
 --- usr.bin/k5admin/Makefile	2001/02/13 16:56:59	1.6
 +++ usr.bin/k5admin/Makefile	2002/01/24 11:32:14
 @@ -50,11 +50,15 @@
  		${LIBKADM5CLNT} ${LIBKADM5SRV} ${LIBHDB} \
  		${LIBASN1} ${LIBCRYPTO} ${LIBCRYPT} ${LIBMD} ${LIBCOM_ERR} \
  		${LIBSL} ${LIBREADLINE}
 -NOMAN=		yes
 +MAN=		k5admin.8
 +CLEANFILES=	${MAN}
  
  .include <bsd.prog.mk>
  
  .PATH:	${KRB5DIR}/kadmin
 +
 +k5admin.8: kadmin.8
 +	ln -sf ${.ALLSRC} ${.TARGET}
  
  kadm5/private.h:	kadm5
  	cp ${KRB5DIR}/lib/kadm5/private.h ${.TARGET}
 Index: usr.sbin/k5stash/Makefile
 ===================================================================
 RCS file: /home/ncvs/src/kerberos5/usr.sbin/k5stash/Makefile,v
 retrieving revision 1.8
 diff -u -r1.8 Makefile
 --- usr.sbin/k5stash/Makefile	2001/03/27 14:07:30	1.8
 +++ usr.sbin/k5stash/Makefile	2002/01/24 11:32:14
 @@ -24,8 +24,12 @@
  		-L${ASN1OBJDIR} -lasn1 -lcrypto -lmd -lcrypt -lcom_err
  DPADD=		${LIBKRB5} ${LIBKAFS5} ${LIBROKEN} ${_krb4deps} \
  		${LIBASN1} ${LIBCRYPTO} ${LIBMD} ${LIBCRYPT} ${LIBCOM_ERR}
 -MAN=		kstash.8
 +MAN=		k5stash.8
 +CLEANFILES=	${MAN}
  
  .include <bsd.prog.mk>
  
  .PATH:	${KRB5DIR}/kdc
 +
 +k5stash.8: kstash.8
 +	ln -sf ${.ALLSRC} ${.TARGET}
 
 --Q68bSM7Ycu6FN28Q
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="crypto_heimdal.patch"
 
 Index: kadmin/kadmind.8
 ===================================================================
 RCS file: /home/ncvs/src/crypto/heimdal/kadmin/kadmind.8,v
 retrieving revision 1.1.1.3
 diff -u -r1.1.1.3 kadmind.8
 --- kadmin/kadmind.8	2001/06/21 02:11:07	1.1.1.3
 +++ kadmin/kadmind.8	2002/01/24 11:29:30
 @@ -124,11 +124,12 @@
  .Sh FILES
  .Pa /var/heimdal/kadmind.acl
  .Sh EXAMPLES
 -This will cause kadmind to listen to port 4711 in addition to any
 +This will cause
 +.Nm
 +to listen to port 4711 in addition to any
  compiled in defaults:
 -.Bd -literal -offset indent
 -# kadmind --ports="+ 4711" &
 -.Ed
 +.Pp
 +.D1 Nm Fl -ports Ns Li "=\*[q]+ 4711\*[q] &"
  .\".Sh DIAGNOSTICS
  .Sh SEE ALSO
  .Xr kdc 8 ,
 Index: kdc/hpropd.8
 ===================================================================
 RCS file: /home/ncvs/src/crypto/heimdal/kdc/hpropd.8,v
 retrieving revision 1.1.1.4
 diff -u -r1.1.1.4 hpropd.8
 --- kdc/hpropd.8	2001/06/21 02:11:10	1.1.1.4
 +++ kdc/hpropd.8	2002/01/24 11:29:31
 @@ -35,7 +35,7 @@
  If the database is sent over the network, it is authenticated and
  encrypted.
  Only connections from
 -.Li kadmin/hprop
 +.Nm kadmin Ns / Ns Nm hprop
  are accepted.
  .Pp
  Options supported:
 Index: kuser/kinit.1
 ===================================================================
 RCS file: /home/ncvs/src/crypto/heimdal/kuser/kinit.1,v
 retrieving revision 1.1.1.5
 diff -u -r1.1.1.5 kinit.1
 --- kuser/kinit.1	2001/06/21 02:11:14	1.1.1.5
 +++ kuser/kinit.1	2002/01/24 11:29:31
 @@ -59,7 +59,9 @@
  name at the default realm), and acquire a ticket granting ticket that
  can later be used to obtain tickets for other services.
  .Pp
 -If you have compiled kinit with Kerberos 4 support and you have a
 +If you have compiled
 +.Nm kinit
 +with Kerberos 4 support and you have a
  Kerberos 4 server,
  .Nm
  will detect this and get you Kerberos 4 tickets.
 Index: lib/krb5/krb5.conf.5
 ===================================================================
 RCS file: /home/ncvs/src/crypto/heimdal/lib/krb5/krb5.conf.5,v
 retrieving revision 1.1.1.4
 diff -u -r1.1.1.4 krb5.conf.5
 --- lib/krb5/krb5.conf.5	2001/06/21 02:11:34	1.1.1.4
 +++ lib/krb5/krb5.conf.5	2002/01/24 11:29:38
 @@ -273,7 +273,9 @@
  .It Li [kadmin]
  .Bl -tag -width "xxx" -offset indent
  .It require-preauth = Va BOOL
 -If pre-authentication is required to talk to the kadmin server.
 +If pre-authentication is required to talk to the
 +.Nm kadmin
 +server.
  .It default_keys = Va keytypes...
  for each entry in
  .Va default_keys
 Index: tools/krb5-config.1
 ===================================================================
 RCS file: /home/ncvs/src/crypto/heimdal/tools/krb5-config.1,v
 retrieving revision 1.1.1.3
 diff -u -r1.1.1.3 krb5-config.1
 --- tools/krb5-config.1	2001/06/21 02:12:06	1.1.1.3
 +++ tools/krb5-config.1	2002/01/24 11:29:41
 @@ -48,9 +48,13 @@
  .It gssapi
  use the krb5 gssapi mechanism
  .It kadm-client
 -use the client-side kadmin libraries
 +use the client-side
 +.Nm kadmin
 +libraries
  .It kadm-server
 -use the server-side kadmin libraries
 +use the server-side
 +.Nm kadmin
 +libraries
  .El
  .Sh SEE ALSO
  .Xr cc 1
 
 --Q68bSM7Ycu6FN28Q--

From: assar@FreeBSD.org
To: Ruslan Ermilov <ru@FreeBSD.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/33645: k5list(1) contains many incorrect "klist" entries.
Date: 24 Jan 2002 16:31:02 +0100

 Ruslan Ermilov <ru@FreeBSD.org> writes:
 > kadmin didn't pass the "make all-man" for me, CLEANFILES still not
 > fixed, style bugs (should be space after a ":" on dependency lines).
 > Besides that, there are some undesirable changes caused by this
 > MANFILTER:
 
 Ah, too large hammer.
 
 > 1.  Modify MANFILTER to only do substitutions for the .Dt, .Nm,
 >     and .Xr macros.
 > 
 > 2.  Tweak relevant manpages that miss the necessary markup bits.
 
 Good.
 
 > Attached are two patches, for kerberos5/ and for crypto/heimdal/
 > that implement this, and fix the bugs mentioned above.
 
 Ok, except the patches to krb5-config.1 and krb5.conf.5, in those
 kadmin is not used as in the sense of the kadmin program and hence
 should not be replaced.  I've applied the patches to the other
 man-pages in the upstream CVS repository.  Do you want to commit these
 and the makefile fixes to FreeBSD or should I?
 
 /assar

From: Ruslan Ermilov <ru@FreeBSD.org>
To: assar@FreeBSD.org
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/33645: k5list(1) contains many incorrect "klist" entries.
Date: Thu, 24 Jan 2002 18:32:15 +0200

 On Thu, Jan 24, 2002 at 04:31:02PM +0100, assar@FreeBSD.org wrote:
 > Ruslan Ermilov <ru@FreeBSD.org> writes:
 > > kadmin didn't pass the "make all-man" for me, CLEANFILES still not
 > > fixed, style bugs (should be space after a ":" on dependency lines).
 > > Besides that, there are some undesirable changes caused by this
 > > MANFILTER:
 > 
 > Ah, too large hammer.
 > 
 > > 1.  Modify MANFILTER to only do substitutions for the .Dt, .Nm,
 > >     and .Xr macros.
 > > 
 > > 2.  Tweak relevant manpages that miss the necessary markup bits.
 > 
 > Good.
 > 
 > > Attached are two patches, for kerberos5/ and for crypto/heimdal/
 > > that implement this, and fix the bugs mentioned above.
 > 
 > Ok, except the patches to krb5-config.1 and krb5.conf.5, in those
 > kadmin is not used as in the sense of the kadmin program and hence
 > should not be replaced.  I've applied the patches to the other
 > man-pages in the upstream CVS repository.  Do you want to commit these
 > and the makefile fixes to FreeBSD or should I?
 > 
 You please.  :-)
 
 
 Cheers,
 -- 
 Ruslan Ermilov		Oracle Developer/DBA,
 ru@sunbay.com		Sunbay Software AG,
 ru@FreeBSD.org		FreeBSD committer,
 +380.652.512.251	Simferopol, Ukraine
 
 http://www.FreeBSD.org	The Power To Serve
 http://www.oracle.com	Enabling The Information Age
State-Changed-From-To: open->feedback 
State-Changed-By: linimon 
State-Changed-When: Thu Aug 26 03:06:07 GMT 2004 
State-Changed-Why:  
Is this still a problem with modern versions of FreeBSD? 


Responsible-Changed-From-To: assar->freebsd-bugs 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Thu Aug 26 03:06:07 GMT 2004 
Responsible-Changed-Why:  
With bugmeister hat on, reassign from inactive committer. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=33645 
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Thu Aug 26 04:14:17 GMT 2004 
Responsible-Changed-Why:  
I missed the fact that this is a docs PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=33645 

From: Ruslan Ermilov <ru@freebsd.org>
To: Mark Linimon <linimon@freebsd.org>
Cc: rdm@cfcl.com, assar@freebsd.org, bug-followup@freebsd.org
Subject: Re: docs/33645: k5list(1) contains many incorrect "klist" entries.
Date: Thu, 26 Aug 2004 09:25:33 +0300

 On Thu, Aug 26, 2004 at 03:06:23AM +0000, Mark Linimon wrote:
 > Synopsis: k5list(1) contains many incorrect "klist" entries.
 > 
 > State-Changed-From-To: open->feedback
 > State-Changed-By: linimon
 > State-Changed-When: Thu Aug 26 03:06:07 GMT 2004
 > State-Changed-Why: 
 > Is this still a problem with modern versions of FreeBSD?
 > 
 It's no longer a problem in HEAD and RELENG_5, since
 KerberosIV deorbit.  It's still a problem in RELENG_4,
 but it's unlikely that this will get fixed, so I
 suggest just closing this PR.
 
 
 Cheers,
 -- 
 Ruslan Ermilov
 ru@FreeBSD.org
 FreeBSD committer
State-Changed-From-To: feedback->closed 
State-Changed-By: linimon 
State-Changed-When: Thu Aug 26 06:32:26 GMT 2004 
State-Changed-Why:  
Ruslan reports that this is only a problem in 4.x.  Unless someone 
wants to backport the fix, he suggests simply closing the PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=33645 
>Unformatted:
