source: chapter06/man-db.xml@ 3b79722

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since 3b79722 was 3b79722, checked in by Xi Ruoyao <xry111@…>, 4 years ago

man-db: decorate username bin

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11769 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 15.0 KB
RevLine 
[fa21b3d]1<?xml version="1.0" encoding="ISO-8859-1"?>
[b06ca36]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[fa21b3d]4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6]>
[2fa922f]7
[fa21b3d]8<sect1 id="ch-system-man-db" role="wrap">
[2fa922f]9 <?dbhtml filename="man-db.html"?>
10
[e747759]11 <sect1info condition="script">
12 <productname>man-db</productname>
13 <productnumber>&man-db-version;</productnumber>
14 <address>&man-db-url;</address>
15 </sect1info>
16
[2fa922f]17 <title>Man-DB-&man-db-version;</title>
18
19 <indexterm zone="ch-system-man-db">
20 <primary sortas="a-Man-DB">Man-DB</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Man-DB package contains programs for finding and viewing man
27 pages.</para>
[fa21b3d]28
[2fa922f]29 <segmentedlist>
30 <segtitle>&buildtime;</segtitle>
31 <segtitle>&diskspace;</segtitle>
[fa21b3d]32
[2fa922f]33 <seglistitem>
[e4a5635]34 <seg>&man-db-ch6-sbu;</seg>
35 <seg>&man-db-ch6-du;</seg>
[2fa922f]36 </seglistitem>
37 </segmentedlist>
[fa21b3d]38
[2fa922f]39 </sect2>
[fa21b3d]40
[2fa922f]41 <sect2 role="installation">
42 <title>Installation of Man-DB</title>
[fa21b3d]43
[2fa922f]44 <para>Prepare Man-DB for compilation:</para>
[fa21b3d]45
[cd2bd14]46<screen revision="systemd"><userinput remap="configure">sed -i '/find/s@/usr@@' init/systemd/man-db.service.in
47
48./configure --prefix=/usr \
[9f5aaf7]49 --docdir=/usr/share/doc/man-db-&man-db-version; \
[d0da965a]50 --sysconfdir=/etc \
51 --disable-setuid \
[b2f3f15]52 --enable-cache-owner=bin \
[d0da965a]53 --with-browser=/usr/bin/lynx \
54 --with-vgrind=/usr/bin/vgrind \
[9f5aaf7]55 --with-grap=/usr/bin/grap</userinput></screen>
[fa21b3d]56
[69d53d1]57<screen revision="sysv"><userinput remap="configure">./configure --prefix=/usr \
58 --docdir=/usr/share/doc/man-db-&man-db-version; \
59 --sysconfdir=/etc \
60 --disable-setuid \
61 --enable-cache-owner=bin \
62 --with-browser=/usr/bin/lynx \
63 --with-vgrind=/usr/bin/vgrind \
64 --with-grap=/usr/bin/grap \
[0066a92]65 --with-systemdtmpfilesdir= \
66 --with-systemdsystemunitdir=</userinput></screen>
[69d53d1]67
[2fa922f]68 <variablelist>
69 <title>The meaning of the configure options:</title>
70
[cd2bd14]71 <varlistentry revision="systemd">
72 <term><command>sed -i '/find/s@/usr@@' init/systemd/man-db.service.in</command></term>
73 <listitem>
74 <para>This changes a harcoded path to the <command>find</command>
75 utility, which we install in
76 <filename class="directory">/bin</filename>.</para>
77 </listitem>
78 </varlistentry>
79
[2fa922f]80 <varlistentry>
81 <term><parameter>--disable-setuid</parameter></term>
82 <listitem>
83 <para>This disables making the <command>man</command> program setuid
84 to user <systemitem class="username">man</systemitem>.</para>
85 </listitem>
86 </varlistentry>
[fa21b3d]87
[b2f3f15]88 <varlistentry>
89 <term><parameter>--enable-cache-owner=bin</parameter></term>
90 <listitem>
91 <para>This makes the system-wide cache files be owned by user
[3b79722]92 <systemitem class="username">bin</systemitem>.</para>
[b2f3f15]93 </listitem>
94 </varlistentry>
95
[f2f15e5]96 <varlistentry>
97 <term><parameter>--with-...</parameter></term>
98 <listitem>
[d35b7f3]99 <para>These three parameters are used to set some default programs.
100 <command>lynx</command> is a text-based web browser (see
[862c5ae]101 BLFS for installation instructions), <command>vgrind</command>
102 converts program sources to Groff input, and <command>grap</command>
103 is useful for typesetting graphs in Groff documents. The
104 <command>vgrind</command> and <command>grap</command> programs are
105 not normally needed for viewing manual pages. They are not part of
106 LFS or BLFS, but you should be able to install them yourself after
107 finishing LFS if you wish to do so.</para>
[f2f15e5]108 </listitem>
109 </varlistentry>
110
[0066a92]111 <varlistentry revision="sysv">
112 <term><parameter>--with-systemd...</parameter></term>
113 <listitem>
114 <para>These parameters prevent installing unneeded systemd
115 directories and files.</para>
116 </listitem>
117 </varlistentry>
118
[2fa922f]119 </variablelist>
120
121 <para>Compile the package:</para>
[fa21b3d]122
[0445a3d]123<screen><userinput remap="make">make</userinput></screen>
[fa21b3d]124
[9f405998]125 <para>To test the results, issue:</para>
126
[3fffa40]127<screen><userinput remap="test">make check</userinput></screen>
[fffff97]128
[2fa922f]129 <para>Install the package:</para>
[fa21b3d]130
[0445a3d]131<screen><userinput remap="install">make install</userinput></screen>
[0066a92]132<!--
[9f029f9]133 <para revision="sysv">Remove an unwanted directory used for service files
134 which would cause some BLFS packages to also install files there: </para>
135
136<screen revision="sysv"><userinput remap="install">rm -rfv /lib/systemd</userinput></screen>
[0066a92]137
[69d53d1]138 <para revision="systemd">Remove a reference to a non-existent user:</para>
[1118b17]139
[69d53d1]140<screen revision="systemd"><userinput remap="install">sed -i "s:man man:root root:g" /usr/lib/tmpfiles.d/man-db.conf</userinput></screen>
[c9627324]141-->
[2fa922f]142 </sect2>
143
144 <sect2>
145 <title>Non-English Manual Pages in LFS</title>
[bc81164]146
[9f405998]147 <para>The following table shows the character set that Man-DB assumes
148 manual pages installed under
149 <filename class="directory">/usr/share/man/&lt;ll&gt;</filename> will be
150 encoded with. In addition to this, Man-DB correctly determines if manual
151 pages installed in that directory are UTF-8 encoded.</para>
152
[745c588]153 <!-- Origin: man-db-2.5.9/lib/encodings.c -->
[2fa922f]154 <table>
[4c0c012]155<title>Expected character encoding of legacy 8-bit manual pages</title>
156 <?dbfo table-width="6in" ?>
[2fa922f]157
[4c0c012]158 <tgroup cols="4">
[1652151]159
[7c6314d4]160 <colspec colnum="1" colwidth="1.5in"/>
161 <colspec colnum="2" colwidth="1in"/>
[4c0c012]162 <colspec colnum="3" colwidth="2.5in"/>
163 <colspec colnum="4" colwidth="1in"/>
[2fa922f]164
165 <thead>
166 <row>
167 <entry>Language (code)</entry>
168 <entry>Encoding</entry>
[4c0c012]169 <entry>Language (code)</entry>
170 <entry>Encoding</entry>
[2fa922f]171 </row>
172 </thead>
173
174 <tbody>
175 <row>
176 <entry>Danish (da)</entry>
177 <entry>ISO-8859-1</entry>
[e8d5e91]178 <entry>Croatian (hr)</entry>
[2b45119]179 <entry>ISO-8859-2</entry>
[2fa922f]180 </row>
181 <row>
182 <entry>German (de)</entry>
183 <entry>ISO-8859-1</entry>
[9f405998]184 <entry>Hungarian (hu)</entry>
[4c0c012]185 <entry>ISO-8859-2</entry>
[2fa922f]186 </row>
187 <row>
188 <entry>English (en)</entry>
189 <entry>ISO-8859-1</entry>
[9f405998]190 <entry>Japanese (ja)</entry>
191 <entry>EUC-JP</entry>
[2fa922f]192 </row>
193 <row>
194 <entry>Spanish (es)</entry>
195 <entry>ISO-8859-1</entry>
[9f405998]196 <entry>Korean (ko)</entry>
197 <entry>EUC-KR</entry>
198 </row>
199 <row>
200 <entry>Estonian (et)</entry>
201 <entry>ISO-8859-1</entry>
202 <entry>Lithuanian (lt)</entry>
203 <entry>ISO-8859-13</entry>
[2fa922f]204 </row>
205 <row>
206 <entry>Finnish (fi)</entry>
207 <entry>ISO-8859-1</entry>
[9f405998]208 <entry>Latvian (lv)</entry>
209 <entry>ISO-8859-13</entry>
[2fa922f]210 </row>
211 <row>
212 <entry>French (fr)</entry>
213 <entry>ISO-8859-1</entry>
[9f405998]214 <entry>Macedonian (mk)</entry>
215 <entry>ISO-8859-5</entry>
[2fa922f]216 </row>
217 <row>
218 <entry>Irish (ga)</entry>
219 <entry>ISO-8859-1</entry>
[4c0c012]220 <entry>Polish (pl)</entry>
221 <entry>ISO-8859-2</entry>
[2fa922f]222 </row>
223 <row>
224 <entry>Galician (gl)</entry>
225 <entry>ISO-8859-1</entry>
[9f405998]226 <entry>Romanian (ro)</entry>
227 <entry>ISO-8859-2</entry>
228 </row>
229 <row>
230 <entry>Indonesian (id)</entry>
231 <entry>ISO-8859-1</entry>
[4c0c012]232 <entry>Russian (ru)</entry>
233 <entry>KOI8-R</entry>
[2fa922f]234 </row>
235 <row>
[9f405998]236 <entry>Icelandic (is)</entry>
[2fa922f]237 <entry>ISO-8859-1</entry>
[4c0c012]238 <entry>Slovak (sk)</entry>
239 <entry>ISO-8859-2</entry>
[2fa922f]240 </row>
241 <row>
[9f405998]242 <entry>Italian (it)</entry>
[2fa922f]243 <entry>ISO-8859-1</entry>
[9f405998]244 <entry>Slovenian (sl)</entry>
245 <entry>ISO-8859-2</entry>
[2fa922f]246 </row>
247 <row>
[9f405998]248 <entry>Norwegian Bokmal (nb)</entry>
[2fa922f]249 <entry>ISO-8859-1</entry>
[9f405998]250 <entry>Serbian Latin (sr@latin)</entry>
251 <entry>ISO-8859-2</entry>
[2fa922f]252 </row>
253 <row>
254 <entry>Dutch (nl)</entry>
255 <entry>ISO-8859-1</entry>
[9f405998]256 <entry>Serbian (sr)</entry>
257 <entry>ISO-8859-5</entry>
258 </row>
259 <row>
260 <entry>Norwegian Nynorsk (nn)</entry>
261 <entry>ISO-8859-1</entry>
262 <entry>Turkish (tr)</entry>
263 <entry>ISO-8859-9</entry>
[2fa922f]264 </row>
265 <row>
266 <entry>Norwegian (no)</entry>
267 <entry>ISO-8859-1</entry>
[9f405998]268 <entry>Ukrainian (uk)</entry>
269 <entry>KOI8-U</entry>
[2fa922f]270 </row>
271 <row>
272 <entry>Portuguese (pt)</entry>
273 <entry>ISO-8859-1</entry>
[9f405998]274 <entry>Vietnamese (vi)</entry>
275 <entry>TCVN5712-1</entry>
[2fa922f]276 </row>
277 <row>
278 <entry>Swedish (sv)</entry>
279 <entry>ISO-8859-1</entry>
[862c5ae]280 <entry>Simplified Chinese (zh_CN)</entry>
281 <entry>GBK</entry>
282 </row>
283 <row>
[9f405998]284 <entry>Belarusian (be)</entry>
285 <entry>CP1251</entry>
[7f89db8]286 <entry>Simplified Chinese, Singapore (zh_SG)</entry>
[862c5ae]287 <entry>GBK</entry>
288 </row>
289 <row>
[9f405998]290 <entry>Bulgarian (bg)</entry>
291 <entry>CP1251</entry>
292 <entry>Traditional Chinese, Hong Kong (zh_HK)</entry>
293 <entry>BIG5HKSCS</entry>
294 </row>
295 <row>
296 <entry>Czech (cs)</entry>
297 <entry>ISO-8859-2</entry>
[862c5ae]298 <entry>Traditional Chinese (zh_TW)</entry>
299 <entry>BIG5</entry>
300 </row>
301 <row>
[9f405998]302 <entry>Greek (el)</entry>
303 <entry>ISO-8859-7</entry>
304 <entry></entry>
305 <entry></entry>
306 </row>
307
[2fa922f]308 </tbody>
309
310 </tgroup>
311
312 </table>
313
314 <note>
[9f405998]315 <para>Manual pages in languages not in the list are not supported.</para>
[2fa922f]316 </note>
317
318 </sect2>
319
320 <sect2 id="contents-man-db" role="content">
321 <title>Contents of Man-DB</title>
322
323 <segmentedlist>
324 <segtitle>Installed programs</segtitle>
[ca101ad]325 <segtitle>Installed libraries</segtitle>
[fe05b08]326 <segtitle>Installed directories</segtitle>
[2fa922f]327
328 <seglistitem>
[8f85d251]329 <seg>accessdb, apropos (link to whatis), catman, lexgrog, man, mandb,
[040ecb6]330 manpath, and whatis</seg>
[78cc3be]331 <seg>libman.so and libmandb.so (both in /usr/lib/man-db)</seg>
332 <seg>/usr/lib/man-db, /usr/libexec/man-db,
[7bb9fda]333 and /usr/share/doc/man-db-&man-db-version;</seg>
[2fa922f]334 </seglistitem>
335 </segmentedlist>
336
337 <variablelist>
338 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
339 <?dbfo list-presentation="list"?>
340 <?dbhtml list-presentation="table"?>
341
[90aae6b]342 <varlistentry id="accessdb">
[2fa922f]343 <term><command>accessdb</command></term>
344 <listitem>
345 <para>Dumps the <command>whatis</command> database contents in
346 human-readable form</para>
347 <indexterm zone="ch-system-man-db accessdb">
348 <primary sortas="b-accessdb">accessdb</primary>
349 </indexterm>
350 </listitem>
[90aae6b]351 </varlistentry>
[2fa922f]352
353 <varlistentry id="apropos">
354 <term><command>apropos</command></term>
355 <listitem>
356 <para>Searches the <command>whatis</command> database and displays
357 the short descriptions of system commands that contain a given
358 string</para>
359 <indexterm zone="ch-system-man-db apropos">
360 <primary sortas="b-apropos">apropos</primary>
361 </indexterm>
362 </listitem>
363 </varlistentry>
364
365 <varlistentry id="catman">
366 <term><command>catman</command></term>
367 <listitem>
368 <para>Creates or updates the pre-formatted manual pages</para>
369 <indexterm zone="ch-system-man-db catman">
370 <primary sortas="b-catman">catman</primary>
371 </indexterm>
372 </listitem>
373 </varlistentry>
374
375 <varlistentry id="lexgrog">
376 <term><command>lexgrog</command></term>
377 <listitem>
378 <para>Displays one-line summary information about a given manual
379 page</para>
380 <indexterm zone="ch-system-man-db lexgrog">
381 <primary sortas="b-lexgrog">lexgrog</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="man">
387 <term><command>man</command></term>
388 <listitem>
389 <para>Formats and displays the requested manual page</para>
390 <indexterm zone="ch-system-man-db man">
391 <primary sortas="b-man">man</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="mandb">
397 <term><command>mandb</command></term>
398 <listitem>
399 <para>Creates or updates the <command>whatis</command> database</para>
400 <indexterm zone="ch-system-man-db mandb">
401 <primary sortas="b-mandb">mandb</primary>
402 </indexterm>
[8bc46a5]403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="manpath">
407 <term><command>manpath</command></term>
408 <listitem>
409 <para>Displays the contents of $MANPATH or (if $MANPATH is not set)
410 a suitable search path based on the settings in man.conf and the
411 user's environment</para>
412 <indexterm zone="ch-system-man-db manpath">
413 <primary sortas="b-manpath">manpath</primary>
414 </indexterm>
[2fa922f]415 </listitem>
416 </varlistentry>
417
418 <varlistentry id="whatis">
419 <term><command>whatis</command></term>
420 <listitem>
421 <para>Searches the <command>whatis</command> database and displays
422 the short descriptions of system commands that contain the given
423 keyword as a separate word</para>
424 <indexterm zone="ch-system-man-db whatis">
425 <primary sortas="b-whatis">whatis</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
[ca101ad]430 <varlistentry id="libman">
431 <term><filename class="libraryfile">libman</filename></term>
432 <listitem>
433 <para>Contains run-time support for <command>man</command></para>
434 <indexterm zone="ch-system-man-db libman">
435 <primary sortas="c-libman">libman</primary>
436 </indexterm>
437 </listitem>
438 </varlistentry>
439
440 <varlistentry id="libmandb">
441 <term><filename class="libraryfile">libmandb</filename></term>
442 <listitem>
443 <para>Contains run-time support for <command>man</command></para>
444 <indexterm zone="ch-system-man-db libmandb">
445 <primary sortas="c-libmandb">libmandb</primary>
446 </indexterm>
447 </listitem>
448 </varlistentry>
449
[2fa922f]450 </variablelist>
451
452 </sect2>
[fa21b3d]453
454</sect1>
Note: See TracBrowser for help on using the repository browser.