psmisc.xml 3.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  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">
  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. <para>The Psmisc package contains programs for displaying information on
  11. processes.</para>
  12. <screen>&buildtime; 0.1 SBU
  13. &diskspace; 2.2 MB</screen>
  14. <para>Psmisc installation depends on: Bash, Binutils, Coreutils, Diffutils,
  15. GCC, Gettext, Glibc, Grep, Make, Ncurses, Sed.</para>
  16. <sect2>
  17. <title>Installation of Psmisc</title>
  18. <para>Prepare Psmisc for compilation:</para>
  19. <screen><userinput>./configure --prefix=/usr --exec-prefix=""</userinput></screen>
  20. <para>The meaning of the configure option:</para>
  21. <itemizedlist>
  22. <listitem><para><userinput>--exec-prefix=""</userinput>: This causes the
  23. binaries to be installed in <filename>/bin</filename> instead of
  24. <filename>/usr/bin</filename>. As the Psmisc programs are often used in
  25. bootscripts, they should be available also when the <filename>/usr</filename>
  26. file system isn't mounted.</para></listitem>
  27. </itemizedlist>
  28. <para>Compile the package:</para>
  29. <screen><userinput>make</userinput></screen>
  30. <para>Now install it:</para>
  31. <screen><userinput>make install</userinput></screen>
  32. <para>There is no reason for the <filename>pstree</filename> and
  33. <filename>pstree.x11</filename> programs to reside in
  34. <filename class="directory">/bin</filename>. We therefore move them to
  35. <filename class="directory">/usr/bin</filename>. Also, there is no need
  36. for <filename>pstree.x11</filename> to exist as a separate program. We
  37. therefore make it a symbolic link to <filename>pstree</filename>:</para>
  38. <screen><userinput>mv /bin/pstree* /usr/bin
  39. ln -sf pstree /usr/bin/pstree.x11</userinput></screen>
  40. <para>By default Psmisc's <command>pidof</command> program isn't installed.
  41. Generally, this isn't a problem because we later install the Sysvinit package,
  42. which provides a better <command>pidof</command> program. But if you're not
  43. going to use Sysvinit, you should complete the installation of Psmisc by
  44. creating the following symlink:</para>
  45. <screen><userinput>ln -s killall /bin/pidof</userinput></screen>
  46. </sect2>
  47. <sect2 id="contents-psmisc"><title>Contents of Psmisc</title>
  48. <para><emphasis>Installed programs</emphasis>: fuser, killall, pstree and
  49. pstree.x11 (link to pstree)</para>
  50. </sect2>
  51. <sect2><title>Short descriptions</title>
  52. <indexterm zone="ch-system-psmisc fuser"><primary sortas="b-fuser">fuser</primary></indexterm>
  53. <para id="fuser"><command>fuser</command> reports the PIDs of processes that use
  54. the given files or file systems.</para>
  55. <indexterm zone="ch-system-psmisc killall"><primary sortas="b-killall">killall</primary></indexterm>
  56. <para id="killall"><command>killall</command> kills processes by name. It sends a signal
  57. to all processes running any of the given commands.</para>
  58. <indexterm zone="ch-system-psmisc pstree"><primary sortas="b-pstree">pstree</primary></indexterm>
  59. <para id="pstree"><command>pstree</command> displays running processes as a tree.</para>
  60. <indexterm zone="ch-system-psmisc pstree.x11"><primary sortas="b-pstree.x11">pstree.x11</primary></indexterm>
  61. <para id="pstree.x11"><command>pstree.x11</command> same as pstree except that it waits for
  62. confirmation before exiting.</para>
  63. </sect2>
  64. </sect1>