Bug 214163 - hardcoded library paths in FILES section
Summary: hardcoded library paths in FILES section
Status: RESOLVED CODE_FIX
Alias: None
Product: Documentation
Classification: Unclassified
Component: man-pages (show other bugs)
Hardware: x86-64 Linux
: P1 normal
Assignee: documentation_man-pages@kernel-bugs.osdl.org
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-08-24 10:06 UTC by Christopher Yeleighton
Modified: 2021-08-25 21:59 UTC (History)
1 user (show)

See Also:
Kernel Version:
Subsystem:
Regression: No
Bisected commit-id:


Attachments

Description Christopher Yeleighton 2021-08-24 10:06:55 UTC
For example:

/usr/lib/gconv   Usual default gconv module path.

This is not the default path for 64-bit native programs under openSUSE.  The default path is:

  * /usr/lib64/gconv for 64-bit native programs
  * /usr/lib/gconv for 32-bit native programs

Therefore, it is not practical to patch the manual pages to replace lib with lib64, for example.

Manual pages should support multiple architectures as a concept.
Comment 1 Michael Kerrisk 2021-08-24 21:40:36 UTC
I have applied the patch below. I'll close this now. Please reopen, if you think something further is needed. Thanks for the report.

Cheers,

Michael

diff --git a/man1/iconv.1 b/man1/iconv.1
index 8207e1cea..826b7a754 100644
--- a/man1/iconv.1
+++ b/man1/iconv.1
@@ -174,6 +174,10 @@ Usual system default gconv module configuration file.
 .TP
 .I /usr/lib/gconv/gconv\-modules.cache
 Usual system gconv module configuration cache.
+.PP
+Depending on the architecture,
+the above files may instead be located at directories with the path prefix
+.IR /usr/lib64 .
 .SH CONFORMING TO
 POSIX.1-2001.
 .SH EXAMPLES
diff --git a/man8/iconvconfig.8 b/man8/iconvconfig.8
index d74132937..34725e4d5 100644
--- a/man8/iconvconfig.8
+++ b/man8/iconvconfig.8
@@ -96,6 +96,10 @@ Usual system default gconv module configuration file.
 .TP
 .I /usr/lib/gconv/gconv\-modules.cache
 Usual system gconv module configuration cache.
+.PP
+Depending on the architecture,
+the above files may instead be located at directories with the path prefix
+.IR /usr/lib64 .
 .SH SEE ALSO
 .BR iconv (1),
 .BR iconv (3)
Comment 2 Christopher Yeleighton 2021-08-25 21:59:22 UTC
This is the fix for SUSE.  I believe Debian has a different multiarch fs layout.  But it can stay if the LFS says so.
In ldconfig(8) terms, we would probably take the subdirectory "gconv" of the "trusted directory" for the active architecture under /usr.  I would appreciate a reference to that manual page containing the authoritative explanation of the concept.

Note You need to log in before you can comment on or make changes to this bug.