psmisc.xml 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-system-psmisc" xreflabel="Psmisc" role="wrap">
  7. <title>Psmisc-&psmisc-version;</title>
  8. <?dbhtml filename="psmisc.html"?>
  9. <indexterm zone="ch-system-psmisc"><primary sortas="a-Psmisc">Psmisc</primary></indexterm>
  10. <sect2 role="package"><title/>
  11. <para>The Psmisc package contains programs for displaying information on
  12. processes.</para>
  13. <segmentedlist>
  14. <segtitle>&buildtime;</segtitle>
  15. <segtitle>&diskspace;</segtitle>
  16. <seglistitem><seg>0.1 SBU</seg><seg>2.2 MB</seg></seglistitem>
  17. </segmentedlist>
  18. <segmentedlist>
  19. <segtitle>Psmisc installation depends on</segtitle>
  20. <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
  21. GCC, Gettext, Glibc, Grep, Make, Ncurses, Sed</seg></seglistitem>
  22. </segmentedlist>
  23. </sect2>
  24. <sect2 role="installation">
  25. <title>Installation of Psmisc</title>
  26. <para>Prepare Psmisc for compilation:</para>
  27. <screen><userinput>./configure --prefix=/usr --exec-prefix=""</userinput></screen>
  28. <para>The meaning of the configure option:</para>
  29. <itemizedlist>
  30. <listitem><para><userinput>--exec-prefix=""</userinput>: This causes the
  31. binaries to be installed in <filename>/bin</filename> instead of
  32. <filename>/usr/bin</filename>. As the Psmisc programs are often used in
  33. bootscripts, they should be available also when the <filename>/usr</filename>
  34. file system isn't mounted.</para></listitem>
  35. </itemizedlist>
  36. <para>Compile the package:</para>
  37. <screen><userinput>make</userinput></screen>
  38. <para>Now install it:</para>
  39. <screen><userinput>make install</userinput></screen>
  40. <para>There is no reason for the <filename>pstree</filename> and
  41. <filename>pstree.x11</filename> programs to reside in
  42. <filename class="directory">/bin</filename>. We therefore move them to
  43. <filename class="directory">/usr/bin</filename>. Also, there is no need
  44. for <filename>pstree.x11</filename> to exist as a separate program. We
  45. therefore make it a symbolic link to <filename>pstree</filename>:</para>
  46. <screen><userinput>mv /bin/pstree* /usr/bin
  47. ln -sf pstree /usr/bin/pstree.x11</userinput></screen>
  48. <para>By default Psmisc's <command>pidof</command> program isn't installed.
  49. Generally, this isn't a problem because we later install the Sysvinit package,
  50. which provides a better <command>pidof</command> program. But if you're not
  51. going to use Sysvinit, you should complete the installation of Psmisc by
  52. creating the following symlink:</para>
  53. <screen><userinput>ln -s killall /bin/pidof</userinput></screen>
  54. </sect2>
  55. <sect2 id="contents-psmisc" role="content"><title>Contents of Psmisc</title>
  56. <segmentedlist>
  57. <segtitle>Installed programs</segtitle>
  58. <seglistitem><seg>fuser, killall, pstree and pstree.x11 (link to pstree)</seg></seglistitem>
  59. </segmentedlist>
  60. <variablelist><title>Short descriptions</title>
  61. <varlistentry>
  62. <term id="fuser"><command>fuser</command></term>
  63. <listitem>
  64. <indexterm zone="ch-system-psmisc fuser"><primary sortas="b-fuser">fuser</primary></indexterm>
  65. <para>reports the PIDs of processes that use the given files or file systems.</para>
  66. </listitem>
  67. </varlistentry>
  68. <varlistentry>
  69. <term id="killall"><command>killall</command></term>
  70. <listitem>
  71. <indexterm zone="ch-system-psmisc killall"><primary sortas="b-killall">killall</primary></indexterm>
  72. <para>kills processes by name. It sends a signal
  73. to all processes running any of the given commands.</para>
  74. </listitem>
  75. </varlistentry>
  76. <varlistentry>
  77. <term id="pstree"><command>pstree</command></term>
  78. <listitem>
  79. <indexterm zone="ch-system-psmisc pstree"><primary sortas="b-pstree">pstree</primary></indexterm>
  80. <para>displays running processes as a tree.</para>
  81. </listitem>
  82. </varlistentry>
  83. <varlistentry>
  84. <term id="pstree.x11"><command>pstree.x11</command></term>
  85. <listitem>
  86. <indexterm zone="ch-system-psmisc pstree.x11"><primary sortas="b-pstree.x11">pstree.x11</primary></indexterm>
  87. <para>same as pstree except that it waits for confirmation before exiting.</para>
  88. </listitem>
  89. </varlistentry>
  90. </variablelist>
  91. </sect2>
  92. </sect1>