psmisc.xml 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-system-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 about
  12. running processes.</para>
  13. <segmentedlist>
  14. <segtitle>&buildtime;</segtitle>
  15. <segtitle>&diskspace;</segtitle>
  16. <seglistitem><seg>0.1 SBU</seg><seg>1.7 MB</seg></seglistitem>
  17. </segmentedlist>
  18. <segmentedlist>
  19. <segtitle>&dependencies;</segtitle>
  20. <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
  21. GCC, Gettext, Glibc, Grep, Make, Ncurses, and 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 options:</para>
  29. <variablelist>
  30. <varlistentry>
  31. <term><parameter>--exec-prefix=""</parameter></term>
  32. <listitem><para>This ensures that the Psmisc binaries will install into
  33. <filename class="directory">/bin</filename> instead of <filename
  34. class="directory">/usr/bin</filename>. This is the correct location according to
  35. the FHS, because some of the Psmisc binaries are used by the LFS-Bootscripts
  36. package.</para></listitem>
  37. </varlistentry>
  38. </variablelist>
  39. <para>Compile the package:</para>
  40. <screen><userinput>make</userinput></screen>
  41. <para>Install the package:</para>
  42. <screen><userinput>make install</userinput></screen>
  43. <para>There is no reason for the <command>pstree</command> and
  44. <command>pstree.x11</command> programs to reside in <filename
  45. class="directory">/bin</filename>. Therefore, move them to <filename
  46. class="directory">/usr/bin</filename>:</para>
  47. <screen><userinput>mv -v /bin/pstree* /usr/bin</userinput></screen>
  48. <para>By default, Psmisc's <command>pidof</command> program is not
  49. installed. This usually is not a problem because it is installed later
  50. in the Sysvinit package, which provides a better
  51. <command>pidof</command> program. If Sysvinit will not be used for a
  52. particular system, complete the installation of Psmisc by creating the
  53. following symlink:</para>
  54. <screen><userinput>ln -sv killall /bin/pidof</userinput></screen>
  55. </sect2>
  56. <sect2 id="contents-psmisc" role="content"><title>Contents of Psmisc</title>
  57. <segmentedlist>
  58. <segtitle>Installed programs</segtitle>
  59. <seglistitem><seg>fuser, killall, pstree, and pstree.x11 (link to pstree)</seg></seglistitem>
  60. </segmentedlist>
  61. <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
  62. <?dbfo list-presentation="list"?>
  63. <?dbhtml list-presentation="table"?>
  64. <varlistentry id="fuser">
  65. <term><command>fuser</command></term>
  66. <listitem>
  67. <para>Reports the Process IDs (PIDs) of processes that use the given files or file systems</para>
  68. <indexterm zone="ch-system-psmisc fuser"><primary sortas="b-fuser">fuser</primary></indexterm>
  69. </listitem>
  70. </varlistentry>
  71. <varlistentry id="killall">
  72. <term><command>killall</command></term>
  73. <listitem>
  74. <para>Kills processes by name; it sends a signal to all processes
  75. running any of the given commands</para>
  76. <indexterm zone="ch-system-psmisc killall"><primary sortas="b-killall">killall</primary></indexterm>
  77. </listitem>
  78. </varlistentry>
  79. <varlistentry id="pstree">
  80. <term><command>pstree</command></term>
  81. <listitem>
  82. <para>Displays running processes as a tree</para>
  83. <indexterm zone="ch-system-psmisc pstree"><primary sortas="b-pstree">pstree</primary></indexterm>
  84. </listitem>
  85. </varlistentry>
  86. <varlistentry id="pstree.x11">
  87. <term><command>pstree.x11</command></term>
  88. <listitem>
  89. <para>Same as <command>pstree</command>, except that it waits for confirmation before exiting</para>
  90. <indexterm zone="ch-system-psmisc pstree.x11"><primary sortas="b-pstree.x11">pstree.x11</primary></indexterm>
  91. </listitem>
  92. </varlistentry>
  93. </variablelist>
  94. </sect2>
  95. </sect1>