From olli@lurza.secnetix.de  Thu Sep 28 09:08:56 2006
Return-Path: <olli@lurza.secnetix.de>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 5CFD616A407
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Sep 2006 09:08:56 +0000 (UTC)
	(envelope-from olli@lurza.secnetix.de)
Received: from lurza.secnetix.de (lurza.secnetix.de [83.120.8.8])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 243A143D5C
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Sep 2006 09:08:54 +0000 (GMT)
	(envelope-from olli@lurza.secnetix.de)
Received: from lurza.secnetix.de (unefez@localhost [127.0.0.1])
	by lurza.secnetix.de (8.13.4/8.13.4) with ESMTP id k8S98mIB073232;
	Thu, 28 Sep 2006 11:08:53 +0200 (CEST)
	(envelope-from oliver.fromme@secnetix.de)
Received: (from olli@localhost)
	by lurza.secnetix.de (8.13.4/8.13.1/Submit) id k8S98lxP073229;
	Thu, 28 Sep 2006 11:08:47 +0200 (CEST)
	(envelope-from olli)
Message-Id: <200609280908.k8S98lxP073229@lurza.secnetix.de>
Date: Thu, 28 Sep 2006 11:08:47 +0200 (CEST)
From: Oliver Fromme <olli@secnetix.de>
Reply-To: Oliver Fromme <olli@secnetix.de>
To: FreeBSD-gnats-submit@freebsd.org
Cc: Oliver Fromme <olli@secnetix.de>
Subject: su(1) refers to pam(8) which doesn't exist
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         103740
>Category:       docs
>Synopsis:       su(1) refers to pam(8) which doesn't exist
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    danger
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Sep 28 09:10:20 GMT 2006
>Closed-Date:    Thu Sep 28 20:43:33 GMT 2006
>Last-Modified:  Thu Sep 28 20:48:13 GMT 2006
>Originator:     Oliver Fromme
>Release:        FreeBSD 6.2-PRERELEASE
>Organization:
secnetix GmbH & Co. KG
		http://www.secnetix.de/bsd
>Environment:
System: FreeBSD epia.fromme.com 6.2-PRERELEASE FreeBSD 6.2-PRERELEASE #0: Wed Sep 20 14:47:28 CEST 2006 olli@epia.fromme.com:/usr/obj/usr/src/sys/EPIA i386

>Description:

	The su(1) manual page mentions pam(8) in the
	"see also" section, but such a manual page does
	not exist.

	I think it would make sense to refer to the
	pam.conf(5) manual page, which describes the
	format of /etc/pam.d/su, to which the text of
	the su(1) manual page refers.

	(There is, in fact, a pam(3) manual page, but
	it contains API programming information which
	isn't useful to someone who wants to configure
	PAM for the su(1) command.  Therefore I think
	that pam(3) shouldn't be mentioned in the su(1)
	manpage; it would rather cause confusion.)

>How-To-Repeat:

	Type "man 1 su", look at the "SEE ALSO" section,
	then try to type "man 8 pam".  Nada.

>Fix:

--- src/usr.bin/su/su.1.orig    Tue Jan 31 21:32:36 2006
+++ src/usr.bin/su/su.1 Thu Sep 28 11:07:32 2006
@@ -231,9 +231,9 @@
 .Xr sh 1 ,
 .Xr group 5 ,
 .Xr login.conf 5 ,
+.Xr pam.conf 5 ,
 .Xr passwd 5 ,
 .Xr environ 7 ,
-.Xr pam 8 ,
 .Xr pam_group 8
 .Sh HISTORY
 A

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: danger 
State-Changed-When: Thu Sep 28 14:28:02 UTC 2006 
State-Changed-Why:  
This is already fixed in HEAD, but needs to be MFC'ed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=103740 
Responsible-Changed-From-To: freebsd-doc->danger 
Responsible-Changed-By: danger 
Responsible-Changed-When: Thu Sep 28 14:30:48 UTC 2006 
Responsible-Changed-Why:  
I will take care of this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=103740 
State-Changed-From-To: patched->closed 
State-Changed-By: danger 
State-Changed-When: Thu Sep 28 20:41:59 UTC 2006 
State-Changed-Why:  
I have MFC'ed the change to RELENG_6 branch.
Note, that I don't think that referencing pam.conf(5) is necesarry here
since referenced pam_group(8) man page does this.

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