Bug 368721

Summary:	PAM *-l files undocumented
Product:	[Fedora] Fedora	Reporter:	Sigh <freakoftheindustry>
Component:	coreutils	Assignee:	Ondrej Vasik <ovasik>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	low	Docs Contact:
Priority:	low
Version:	7	CC:	twaugh
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:	6.9-8.fc7	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2008-03-13 07:45:37 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Sigh 2007-11-06 18:47:04 UTC

Description of problem:
The /etc/pam.d/su-l and /etc/pam.d/runuser-l files appear to be completely
undocumented.  The files themselves have no comments.  The
/usr/share/doc/coreutils-6.9 files don't mention them.  The man pages don't
mention them.  The info pages say "this command has PAM support" but then point
the user at the plain 'su' and 'runuser' files, ignoring the *-l variants.


Version-Release number of selected component (if applicable):  6.9-3.fc7


Steps to Reproduce:
1.  See "su-l" mentioned in logwatch report.
2.  Fail to find explanation anywhere in docs, --help, FAQs, bug lists.
3.  Become mildly annoyed at the presence of undocumented /etc files.
4.  Become slightly alarmed at "su-l" appearing in strings(1) output on /bin/su
with no explanation.
  
Actual results:
I had to look at coreutils-split-pam.patch in the srpm to confirm my guess that
these files had something to do with the -l option.

Expected results:
I would have expected the parts of the docs that mention PAM support in the
first place to include "If the -l option is given, the corresponding *-l PAM
file will be used instead.  By default, these include the base PAM file and then
add some additional blahblahblah..."

Comment 1 Ondrej Vasik 2008-01-25 19:53:56 UTC

Added a bit words about those runuser-l and su-l files with different PAM file
to man pages of coreutils-6.10-1.fc9 (now built in RAWHIDE).

Comment 2 Fedora Update System 2008-03-04 14:15:35 UTC

coreutils-6.9-7.fc7 has been submitted as an update for Fedora 7

Comment 3 Fedora Update System 2008-03-07 19:51:34 UTC

coreutils-6.9-7.fc7 has been pushed to the Fedora 7 testing repository.  If problems still persist, please make note of it in this bug report.
 If you want to test the update, you can install it with 
 su -c 'yum --enablerepo=updates-testing update coreutils'.  You can provide feedback for this update here: http://admin.fedoraproject.org/updates/F7/FEDORA-2008-2333

Comment 4 Fedora Update System 2008-03-13 07:45:35 UTC

coreutils-6.9-8.fc7 has been pushed to the Fedora 7 stable repository.  If problems still persist, please make note of it in this bug report.