https://jira.whamcloud.com This file is an XML representation of an issue en-us 9.4.14 940014 05-12-2023 https://jira.whamcloud.com/browse/LU-14118 Lustre <div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent"> <pre>$ man -k lfs lfs (1) - client utility for Lustre-specific file layout and other attributes lfs-df (1) - (unknown subject) lfs-find (1) - Lustre client utility to list files with specific attributes lfs-getdirstripe (1) - (unknown subject) lfs-getstripe (1) - (unknown subject) lfs-hsm (1) - (unknown subject) lfs-ladvise (1) - (unknown subject) lfs-migrate (1) - (unknown subject) lfs-mirror-create (1) - (unknown subject) lfs-mirror-extend (1) - (unknown subject) lfs-mirror-resync (1) - (unknown subject) lfs-mirror-split (1) - (unknown subject) lfs-mirror-verify (1) - (unknown subject) lfs-mkdir (1) - set striping pattern of a directory. lfs-project (1) - (unknown subject) lfs-setdirstripe (1) - set striping pattern of a directory. lfs-setquota (1) - (unknown subject) lfs-setstripe (1) - (unknown subject) lfs_migrate (1) - migrate files between Lustre OSTs </pre> </div></div> <p>According to <a href="https://redmine.auroville.org.in/issues/824" class="external-link" target="_blank" rel="nofollow noopener">https://redmine.auroville.org.in/issues/824</a> the text before the &#45; in the NAME section must be a single word (double quoting did not work). Changing 'lfs df' to 'lfs-df' in the NAME section has the desired effect.</p> LU-14118

man reports "unknown subject" for many lustre manpages

Bug Minor Resolved Fixed WC Triage John Hammond Thu, 5 Nov 2020 14:57:12 +0000 Thu, 5 May 2022 13:34:11 +0000 Wed, 13 Apr 2022 03:11:25 +0000 0 2 <p>Running <tt>mandb</tt> on my RHEL8.3 server + Lustre 2.14.0 reports:</p> <div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent"> <pre>mandb: warning: /usr/share/man/man8/lctl-barrier.8.gz: whatis parse for lctl-barrier(8) failed mandb: warning: /usr/share/man/man8/lctl-lcfg.8.gz: whatis parse for lctl-lcfg(8) failed mandb: warning: /usr/share/man/man8/lctl-lfsck-query.8.gz: whatis parse for lctl-lfsck-query(8) failed mandb: warning: /usr/share/man/man8/lctl-lfsck-start.8.gz: whatis parse for lctl-lfsck-start(8) failed mandb: warning: /usr/share/man/man8/lctl-lfsck-stop.8.gz: whatis parse for lctl-lfsck-stop(8) failed mandb: warning: /usr/share/man/man8/lctl-snapshot-create.8.gz: whatis parse for lctl-snapshot-create(8) failed mandb: warning: /usr/share/man/man8/lctl-snapshot-destroy.8.gz: whatis parse for lctl-snapshot-destroy(8) failed mandb: warning: /usr/share/man/man8/lctl-snapshot-list.8.gz: whatis parse for lctl-snapshot-list(8) failed mandb: warning: /usr/share/man/man8/lctl-snapshot-modify.8.gz: whatis parse for lctl-snapshot-modify(8) failed mandb: warning: /usr/share/man/man8/lctl-snapshot-mount.8.gz: whatis parse for lctl-snapshot-mount(8) failed mandb: warning: /usr/share/man/man8/lctl-snapshot-umount.8.gz: whatis parse for lctl-snapshot-umount(8) failed mandb: warning: /usr/share/man/man8/lnetctl.8.gz: whatis parse for lnetctl(8) failed </pre> </div></div> <p>Interestingly, on RHEL6.10 clients, "<tt>man -k lfs</tt>" works as expected, so the "<tt>(unknown subject)</tt>" issue must be a newer change (I see this same problem on RHEL8):</p> <div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent"> <pre>man -k lfs Devel::SelfStubber (3pm) - generate stubs for a SelfLoading module lfs (1) - client utility for Lustre-specific file layout and other attributes lfsck (8) - check a Lustre distributed filesystem lfs df [lfs-df] (1) - report Lustre filesystem disk usage lfs-find (1) - Lustre client utility to list files with specific attributes lfs flushctx [lfs-flushctx] (1) - flush security context of current user lfs getdirstripe [lfs-getdirstripe] (1) - list the layout pattern of a given directory : </pre> </div></div> <p>Fixed by patch <a href="https://review.whamcloud.com/41075" class="external-link" target="_blank" rel="nofollow noopener">https://review.whamcloud.com/41075</a> "<tt><a href="https://jira.whamcloud.com/browse/LU-930" title="Update or improvement to a Lustre man page or documentation" class="issue-link" data-issue-key="LU-930">LU-930</a> doc: fix format man page sections for lctl</tt>".</p> Related LU-930 Development Rank 1|i01egv: Rank (Obsolete) 9223372036854775807 Severity