Bug 1081236

Summary:	broken man pages for hwloc-ls and lstopo-no-graphics
Product:	Red Hat Enterprise Linux 7	Reporter:	Jeff Bastian <jbastian>
Component:	hwloc	Assignee:	Don Zickus <dzickus>
Status:	CLOSED ERRATA	QA Contact:	Mike Gahagan <mgahagan>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	7.0	CC:	dzickus, jchaloup
Target Milestone:	rc
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:	In the past, hwloc-ls and lstopo-no-graphics did not have man pages and searching for them produced an error. Changes to hwloc have been made and the missing man pages for hwloc-ls and lstopo-no-graphics have now been added. As a result, searching for these man pages will no longer produce a No manual entry error.	Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-11-19 14:48:15 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Jeff Bastian 2014-03-26 20:13:49 UTC

Description of problem:
The man pages for hwloc-ls(1) and lstopo-no-graphics(1) are broken symlinks:

~]$ man hwloc-ls
man: warning: /usr/share/man/man1/hwloc-ls.1.gz is a dangling symlink
No manual entry for hwloc-ls

~]$ man lstopo-no-graphics
man: warning: /usr/share/man/man1/lstopo-no-graphics.1.gz is a dangling symlink
No manual entry for lstopo-no-graphics


Version-Release number of selected component (if applicable):
hwloc-1.7-3.el7

How reproducible:
every time

Steps to Reproduce:
1. man hwloc-ls
2. man lstopo-no-graphics

Actual results:
error about dangling symlinks

Expected results:
read the man pages

Additional info:

Comment 1 Jeff Bastian 2014-03-26 20:31:31 UTC

Ah-hah, the broken symlinks are:

/usr/share/man/man1/hwloc-ls.1.gz -> lstopo.1.gz
/usr/share/man/man1/lstopo-no-graphics.1.gz -> lstopo.1.gz

And the lstopo.1.gz file is part of the hwloc-gui rpm which has to be installed separately:

~]# rpm -ql hwloc-gui
/usr/bin/lstopo
/usr/share/man/man1/lstopo.1.gz

Can the man page be moved to the main hwloc package?

Comment 5 Don Zickus 2015-07-14 19:35:50 UTC

I have a fix that I backported from upstream.  It just makes lstopo-no-graphics hold the manpages and lets lstopo symlink to that one instead of the other way around.

I'll wait until 7.3 to push the fix.

Cheers,
Don

Comment 8 Mike Gahagan 2015-08-03 17:39:10 UTC

confirmed that lstopo-no-graphaics.1 and hwloc-ls.1  man pages has been moved to the hwloc package.

Comment 11 errata-xmlrpc 2015-11-19 14:48:15 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://rhn.redhat.com/errata/RHBA-2015-2164.html