chapter06/psmisc.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4   <!ENTITY % general-entities SYSTEM "../general.ent">
   5   %general-entities;
   6 ]>
   7
   8 <sect1 id="ch-system-psmisc" role="wrap">
   9   <?dbhtml filename="psmisc.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>psmisc</productname>
  13     <productnumber>&psmisc-version;</productnumber>
  14     <address>&psmisc-url;</address>
  15   </sect1info>
  16
  17   <title>Psmisc-&psmisc-version;</title>
  18
  19   <indexterm zone="ch-system-psmisc">
  20     <primary sortas="a-Psmisc">Psmisc</primary>
  21   </indexterm>
  22
  23   <sect2 role="package">
  24     <title/>
  25
  26     <para>The Psmisc package contains programs for displaying information about
  27     running processes.</para>
  28
  29     <segmentedlist>
  30       <segtitle>&buildtime;</segtitle>
  31       <segtitle>&diskspace;</segtitle>
  32
  33       <seglistitem>
  34         <seg>&psmisc-ch6-sbu;</seg>
  35         <seg>&psmisc-ch6-du;</seg>
  36       </seglistitem>
  37     </segmentedlist>
  38
  39   </sect2>
  40
  41   <sect2 role="installation">
  42     <title>Installation of Psmisc</title>
  43
  44     <para>Prepare Psmisc for compilation:</para>
  45
  46 <screen><userinput remap="configure">./configure --prefix=/usr</userinput></screen>
  47
  48     <para>Compile the package:</para>
  49
  50 <screen><userinput remap="make">make</userinput></screen>
  51
  52     <para>This package does not come with a test suite.</para>
  53
  54     <para>Install the package:</para>
  55
  56 <screen><userinput remap="install">make install</userinput></screen>
  57
  58     <para>Finally, move the <command>killall</command> and <command>fuser</command>
  59     programs to the location specified by the FHS:</para>
  60
  61 <screen><userinput remap="install">mv -v /usr/bin/fuser   /bin
  62 mv -v /usr/bin/killall /bin</userinput></screen>
  63
  64   </sect2>
  65
  66   <sect2 id="contents-psmisc" role="content">
  67     <title>Contents of Psmisc</title>
  68
  69     <segmentedlist>
  70       <segtitle>Installed programs</segtitle>
  71
  72       <seglistitem>
  73         <seg>fuser, killall, peekfd, prtstat, pstree, and pstree.x11 (link to pstree)</seg>
  74       </seglistitem>
  75     </segmentedlist>
  76
  77     <variablelist>
  78       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  79       <?dbfo list-presentation="list"?>
  80       <?dbhtml list-presentation="table"?>
  81
  82       <varlistentry id="fuser">
  83         <term><command>fuser</command></term>
  84         <listitem>
  85           <para>Reports the Process IDs (PIDs) of processes that use the given
  86           files or file systems</para>
  87           <indexterm zone="ch-system-psmisc fuser">
  88             <primary sortas="b-fuser">fuser</primary>
  89           </indexterm>
  90         </listitem>
  91       </varlistentry>
  92
  93       <varlistentry id="killall">
  94         <term><command>killall</command></term>
  95         <listitem>
  96           <para>Kills processes by name; it sends a signal to all processes
  97           running any of the given commands</para>
  98           <indexterm zone="ch-system-psmisc killall">
  99             <primary sortas="b-killall">killall</primary>
 100           </indexterm>
 101         </listitem>
 102       </varlistentry>
 103
 104       <varlistentry id="peekfd">
 105         <term><command>peekfd</command></term>
 106         <listitem>
 107           <para>Peek at file descriptors of a running process, given its
 108           PID</para>
 109           <indexterm zone="ch-system-psmisc peekfd">
 110             <primary sortas="b-peekfd">peekfd</primary>
 111           </indexterm>
 112         </listitem>
 113       </varlistentry>
 114
 115       <varlistentry id="prtstat">
 116         <term><command>prtstat</command></term>
 117         <listitem>
 118           <para>Prints information about a process</para>
 119           <indexterm zone="ch-system-psmisc prtstat">
 120             <primary sortas="b-prtstat">prtstat</primary>
 121           </indexterm>
 122         </listitem>
 123       </varlistentry>
 124
 125       <varlistentry id="pstree">
 126         <term><command>pstree</command></term>
 127         <listitem>
 128           <para>Displays running processes as a tree</para>
 129           <indexterm zone="ch-system-psmisc pstree">
 130             <primary sortas="b-pstree">pstree</primary>
 131           </indexterm>
 132         </listitem>
 133       </varlistentry>
 134
 135       <varlistentry id="pstree.x11">
 136         <term><command>pstree.x11</command></term>
 137         <listitem>
 138           <para>Same as <command>pstree</command>, except that it waits for
 139           confirmation before exiting</para>
 140           <indexterm zone="ch-system-psmisc pstree.x11">
 141             <primary sortas="b-pstree.x11">pstree.x11</primary>
 142           </indexterm>
 143         </listitem>
 144       </varlistentry>
 145
 146     </variablelist>
 147
 148   </sect2>
 149
 150 </sect1>