Bug 70616

Summary: [patch] incompleteness and error in su(1) man page
Product: Documentation Reporter: Jilles Tjoelker <jilles>
Component: Books & ArticlesAssignee: Brad Davis <brd>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
su.1.diff none

Description Jilles Tjoelker freebsd_committer freebsd_triage 2004-08-18 15:20:19 UTC 
1. The su man page doesn't mention that by default users must be in group
   wheel to su to root. While it is mentioned in other documentation, it
   should be in the man page as well. The 4.x man page mentioned it.
   (This confuses new users.)
2. The su man page says the PAM configuration for su is in /etc/pam.conf, but
   it is in /etc/pam.d/su now.

Fix: Patch included
How-To-Repeat: man su
Comment 1 Simon L. B. Nielsen freebsd_committer freebsd_triage 2004-09-12 21:02:06 UTC 
Responsible Changed
From-To: freebsd-doc->simon

I will take this.
Comment 2 Brad Davis freebsd_committer freebsd_triage 2005-06-03 00:03:58 UTC 
Responsible Changed
From-To: simon->brd

Simon is too busy with all his new responsibilities and I want to get my feet wet with man pages, so steal this one.
Comment 3 Brad Davis 2005-06-30 17:58:01 UTC 
I made the following patch to address the fact that this is the default
still, but it can be changed.



--- src-ori/usr.bin/su/su.1	Thu Jun 30 10:17:59 2005
+++ src/usr.bin/su/su.1	Thu Jun 30 10:43:37 2005
@@ -53,6 +53,13 @@
 A shell is then executed.
 .Pp
 PAM is used to set all policy.
+In particular, by default only users in group
+.Dq wheel
+may use
+.Nm
+to switch to UID 0
+.Dq ( root ) .
+This can be changed by modifying PAM's config.
 .Pp
 By default, the environment is unmodified with the exception of
 .Ev USER ,
Comment 4 Brad Davis freebsd_committer freebsd_triage 2006-01-31 20:34:52 UTC 
State Changed
From-To: open->closed

Slightly different change committed, thanks!