[padb] r326 committed - Minor formatting changes to make the code html compliant. No real new...

padb at googlecode.com padb at googlecode.com
Mon Nov 9 15:45:25 GMT 2009


Revision: 326
Author: apittman
Date: Mon Nov  9 07:45:01 2009
Log: Minor formatting changes to make the code html compliant.  No real new
content but I can wear a w3.org badge with pride now.

http://code.google.com/p/padb/source/detail?r=326

Modified:
  /trunk/doc/configuration.html
  /trunk/doc/download.html
  /trunk/doc/email.html
  /trunk/doc/extensions.html
  /trunk/doc/header.html
  /trunk/doc/index.html
  /trunk/doc/layout.css
  /trunk/doc/modes.html
  /trunk/doc/usage.html

=======================================
--- /trunk/doc/configuration.html	Thu Sep 10 02:38:12 2009
+++ /trunk/doc/configuration.html	Mon Nov  9 07:45:01 2009
@@ -2,39 +2,44 @@

  <h1>Configuration options</h1>
  <i>padb</i> has a number of extended configuration options for tuning
-it's behavior, these can be set in a number of ways.  There are options for
-controlling <i>padb</i> itself and how it start up and find jobs and also
-mode specific options which control individual (or multiple) modes.
+it's behavior, these can be set in a number of ways.  There are
+options for controlling <i>padb</i> itself and how it start up and
+find jobs and also mode specific options which control individual (or
+multiple) modes.
  <p>
-All configuration options have both a name and a value, in some cases the  
value is a comma separated list.
+All configuration options have both a name and a value, in some cases
+the value is a comma separated list.

  <h3>Setting options</h3>

  Configuration options can be set in the following ways:
  <ul>
-<li>Command line</li>
-Use the command-line option <b>--config-option  
<key>=<value></b>.
-<b>-O</b> can be substituted for <b>--config-option</b>.
-<li>Environment</li>
-Set the environment variable <b>PADB_<KEY>=<value></b>.  All
-environment variables should be specified in upper case.
-<li>Config file</li>
-Config is also loaded from <b>/etc/padb.conf</b> and <b>~/.padbrc</b>.   
Contact the
-<a href=email.html>mailing lists</a> for help with these files.
+<li>Command line
+<br>Use the command-line option <b>--config-option
+<key>=<value></b>.
+<b>-O</b> can be substituted for <b>--config-option</b>.</li>
+<li>Environment
+<br>Set the environment
+variable <b>PADB_<KEY>=<value></b>.  All environment
+variables should be specified in upper case.</li>
+<li>Config file
+<br>Config is also loaded from <b>/etc/padb.conf</b>
+and <b>~/.padbrc</b>.  Contact the
+<a href=email.html>mailing lists</a> for help with these files.</li>
  </ul>

-<h3>Viewing active options</h3>
-Running <i>padb</i> with the <b>-v</b> option will show both what options  
are being loaded
-and also the used values for all mode specific options.
-
-<h3>Available options</h3>
-A list of configuration options along with their current values can be
-obtained by specifying a key of help with or without a value, i.e. <b>padb  
-Ohelp</b>
-
-<h2>Example</h2>
-In normal use the resource manager is selected automatically based on what  
is installed, if
-for some reason <i>padb</i> cannot determine the resource manager you are  
using you can
-explicitly request one by setting the "rmgr" option.
+<h3>Viewing active options</h3> Running <i>padb</i> with the <b>-v</b>
+option will show both what options are being loaded and also the used
+values for all mode specific options.
+
+<h3>Available options</h3> A list of configuration options along with
+their current values can be obtained by specifying a key of help with
+or without a value, i.e. <b>padb -Ohelp</b>
+
+<h2>Example</h2> In normal use the resource manager is selected
+automatically based on what is installed, if for some
+reason <i>padb</i> cannot determine the resource manager you are using
+you can explicitly request one by setting the "rmgr" option.
  <pre class=code>
  ashley at alpha:~$ padb --show-jobs
  Error, multiple resource managers detected, use -Ormgr=<resource  
manager>
@@ -49,9 +54,5 @@
  </div>
  <div id="footer">
   <hr>
- <center>
- <font size=-2>
-  <p>Page maintained by Ashley Pittman. $Date: 2009-09-09 13:25:10 +0100  
(Wed, 09 Sep 2009) $ $Revision: 223 $</p>
- </font>
- <center>
+ <p>Page maintained by Ashley Pittman. $Date: 2009-09-09 13:25:10 +0100  
(Wed, 09 Sep 2009) $ $Revision: 223 $</p>
  </div>
=======================================
--- /trunk/doc/download.html	Tue Oct  6 11:49:59 2009
+++ /trunk/doc/download.html	Mon Nov  9 07:45:01 2009
@@ -37,9 +37,5 @@
  </div>
  <div id="footer">
   <hr>
- <center>
- <font size="-2">
-  <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
- </font>
- <center>
+ <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
  </div>
=======================================
--- /trunk/doc/email.html	Mon Sep 14 01:56:33 2009
+++ /trunk/doc/email.html	Mon Nov  9 07:45:01 2009
@@ -14,9 +14,5 @@
  </div>
  <div id="footer">
   <hr>
- <center>
- <font size="-2">
-  <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
- </font>
- <center>
+ <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
  </div>
=======================================
--- /trunk/doc/extensions.html	Thu Sep 10 02:38:12 2009
+++ /trunk/doc/extensions.html	Mon Nov  9 07:45:01 2009
@@ -116,9 +116,5 @@
  </div>
  <div id="footer">
   <hr>
- <center>
- <font size=-2>
-  <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
- </font>
- <center>
+ <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
  </div>
=======================================
--- /trunk/doc/header.html	Tue Oct  6 11:49:59 2009
+++ /trunk/doc/header.html	Mon Nov  9 07:45:01 2009
@@ -1,3 +1,4 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  <head>
    <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
    <title>Padb: A parallel debugging tool</title>
@@ -12,21 +13,18 @@
  </div>
  <div id="navigation">
   <ul>
-  <font size="+1">
-  <li><a href="index.html" title="Main page">Home</a>
-  <font size="-1">
-     <br><a href="index.html#news" title="Project news">News</a>
-  </font>
-  <li><a href="usage.html" title="Command line options">Usage</a>
-  <font size="-1">
+  <li><span class="menu_heading"><a href="index.html" title="Main  
page">Home</a></span>
+  <br><span class="menu_subheading"><a href="index.html#news"  
title="Project news">News</a></span></li>
+  <li><span class="menu_heading"><a href="usage.html" title="Command line  
options">Usage</a></span>
+  <span class="menu_subheading">
       <br><a href="usage.html#rmgr" title="Selecting the resource  
manager">Resource mananger</a>
       <br><a href="usage.html#job" title="Selecting a job">Jobs</a>
       <br><a href="usage.html#rank" title="Selecting ranks within a  
job">Ranks</a>
       <br><a href="usage.html#full-report" title="Generating a full report  
for a job">Full Report mode</a>
       <br><a href="configuration.html" title="Setting configuration  
options">Configuration</a>
-  </font>
-  <li><a href="modes.html" title="Modes of operation">Modes of  
operation</a>
-  <font size="-1">
+  </span>
+  <li><span class="menu_heading"><a href="modes.html" title="Modes of  
operation">Modes of operation</a></span>
+  <span class="menu_subheading">
       <br><a href="modes.html#proc-summary" title="Process summary">Process  
state</a>
       <br><a href="modes.html#proc-info" title="Process info">Process state  
(verbose)</a>
       <br><a href="modes.html#stack-trace" title="Stack trace">Stack  
trace</a>
@@ -34,18 +32,17 @@
       <br><a href="modes.html#deadlock" title="Collective state">Collective  
state</a>
       <br><a href="modes.html#kill" title="Signal delivery">Signal  
delivery</a>
       <br><a href="modes.html#mpi-watch" title="Job monitoring">Job  
monitoring</a>
-  </font>
-  <li><a href="download.html" title="Download page">Download</a>
-  <font size="-1">
+  </span>
+  <li><span class="menu_heading"><a href="download.html" title="Download  
page">Download</a></span>
+  <span class="menu_subheading">
       <br><a href="download.html#stable" title="Latest stable release">3.0  
Release</a>
       <br><a href="download.html#svn" title="Source code access">Source  
code</a>
-  </font>
-  <li><a href="extensions.html" title="Proposed MPI extensions">Patches</a>
-  <font size="-1">
+  </span>
+  <li><span class="menu_heading"><a href="extensions.html" title="Proposed  
MPI extensions">Patches</a></span>
+  <span class="menu_subheading">
       <br><a href="extensions.html#overview" title="Proposal  
description">Overview</a>
       <br><a href="extensions.html#open-mpi" title="OpenMPI patch">OpenMPI  
patch</a>
-  </font>
-  <li><a href="email.html" title="Contact information">Mailing lists</a>
-  </font>
+  </span>
+  <li><span class="menu_heading"><a href="email.html" title="Contact  
information">Mailing lists</a></span>
   </ul>
  </div>
=======================================
--- /trunk/doc/index.html	Tue Oct  6 09:38:43 2009
+++ /trunk/doc/index.html	Mon Nov  9 07:45:01 2009
@@ -1,12 +1,12 @@
  <div id="content">
  <h2>About</h2>
-<p><i>Padb</i> is a <b>Job Inspection Tool</b> for examining and
-debugging parallel programs, primarily it simplifies the process of
-gathering stack traces on compute clusters however it also supports a wide  
range of other functions.
-<i>Padb</i> supports a number of parallel environments and it works  
out-of-the-box on the majority of
-clusters.  It's an
-open source, non-interactive, command line, script-able tool intended
-for use by programmers and system administrators alike.</p>
+<p><i>Padb</i> is a <b>Job Inspection Tool</b> for examining and debugging
+parallel programs, primarily it simplifies the process of gathering stack  
traces
+on compute clusters however it also supports a wide range of other  
functions.
+<i>Padb</i> supports a number of parallel environments and it works
+out-of-the-box on the majority of clusters. It's an open source,
+non-interactive, command line, script-able tool intended for use by  
programmers
+and system administrators alike.</p>

  <p>
  <i>Padb</i> is developed and maintained by
@@ -15,22 +15,22 @@
  <table class="news" width="70%" cellspacing="0" cellpadding="5" border="1"  
align="center">
  <tr><td>

-<a name=news><h2 align="center">Recent News</h2></a>
+<h2 align="center"><a name="news">Recent News</a></h2>

  <ul>
- <li><font size="+2"><b>06-10-09</b>: Final 3.0 release avaliable for  
download</font></a>
- <li><b>15-09-09</b>: 3.0-rc2 avaliable for download</a>
- <li><b>01-09-09</b>: A 3.0-rc release is avaliable to download from the
-  <a href="download.html">downloads page</a>.
- <li><b>25-06-09</b>: A 2.5 stable release (version 2.5) is avaliable to  
download from the
-  <a href="download.html">downloads page</a>.
-  </li>
+ <li><font size="+2"><b>06-10-09</b>: 3.0 release avaliable for
+ <a href="download.html">download</a>.</font>
+ <li><b>15-09-09</b>: 3.0-rc2 avaliable for download.
+ <li><b>01-09-09</b>: A 3.0-rc release is avaliable to download from
+ the <a href="download.html">downloads page</a>.
+ <li><b>25-06-09</b>: A 2.5 stable release (version 2.5) is avaliable to
+ download from the <a href="download.html">downloads page</a>.
  </ul>
  </td></tr>
  </table>

-<h2>Features</h2>
-The following <a href="modes.html">modes</a> of operation are supported:
+<h2>Features</h2> The following <a href="modes.html">modes</a> of  
operation are
+supported:
  <ul>
  <li>Stack trace generation</li>
  <li>MPI Message queue display</li>
@@ -42,13 +42,12 @@
  </ul>

  <h2>What padb can't do</h2>
-<i>Padb</i> is a job inspection tool, it can tell you want you want
-to know about your job and your MPI stack, it will not, however, tell
-you about your cluster as a whole and it won't diagnose problems
-with your wider environment, including you job launcher or runtime
-environment.  <i>Padb</i>
-does not launch or wrap your jobs for you, it is not a job harness but
-rather attaches to or targets jobs which are already running.
+<i>Padb</i> is a job inspection tool, it can tell you want you want to know
+about your job and your MPI stack, it will not, however, tell you about  
your
+cluster as a whole and it won't diagnose problems with your wider  
environment,
+including you job launcher or runtime environment. <i>Padb</i> does not  
launch
+or wrap your jobs for you, it is not a job harness but rather attaches to  
or
+targets jobs which are already running.

  <h2>License</h2>
  <i>padb</i> is licensed under the
@@ -57,42 +56,36 @@

  <h2>History</h2>
  <i>Padb</i> was originally conceived by software developers at
-<a href="http://www.quadrics.com/">Quadrics</a> around 2004 to solve the
-kind of problems facing them at the time.  It's been a part of the
-Quadrics software stack for a number of years and has recently been
-made available to a wider audience.  It has been commercially supported
-for a number of years and is known to work at a scale of tens of thousands  
of
-processes.
+<a href="http://www.quadrics.com/">Quadrics</a> around 2004 to solve the  
kind of
+problems facing them at the time. It's been a part of the Quadrics software
+stack for a number of years and has recently been made available to a wider
+audience. It has been commercially supported for a number of years and is  
known
+to work at a scale of tens of thousands of processes.

  <h2>Parallel Environments</h2>
-<i>Padb</i> works and is supported on the following parallel
-environments and MPI stacks.  Not all features are available on all
-runtimes.
+<i>Padb</i> works and is supported on the following parallel environments  
and
+MPI stacks. Not all features are available on all runtimes.
  <ul>
-<li><a href="http://www.quadrics.com/">Quadrics RMS</a></li>
-Runs natively on clusters running RMS.
-<li><a href="https://computing.llnl.gov/linux/slurm">Slurm</a></li>
-Runs natively on clusters running Slurm irrespective of the runtime used.
-<li><a href="http://www.open-mpi.org/">Open MPI</a></li>
-Supports orte or OpenMPI jobs run under slurm.
-<li><a href="http://www.mcs.anl.gov/mpi/mpich/">MPICH2</a></li>
-Supports mpd or MPICH2 jobs run under slurm.
+<li><a href="http://www.quadrics.com/">Quadrics RMS</a><br>Runs natively on
+clusters running RMS.</li>
+<li><a href="https://computing.llnl.gov/linux/slurm">Slurm</a><br>Runs
+natively on clusters running Slurm irrespective of the runtime used.</li>
+<li><a href="http://www.open-mpi.org/">Open MPI</a><br>Supports orte or
+OpenMPI jobs run under slurm.</li>
+<li><a href="http://www.mcs.anl.gov/mpi/mpich/">MPICH2</a><br>Supports mpd  
or
+MPICH2 jobs run under slurm.</li>
  </ul>
  <p>In addition padb can be told to target individual UNIX processes.

  <h2>Prerequisites</h2>
-<i>Padb</i> requires very little support from the OS or parallel
-environment to run, it's main use is to assist in the debugging of
-parallel applications, it's therefore assumed that you have a working MPI
-stack or other parallel environment and that "Hello world" application  
runs to completion without
-error.<br>  A <i>Linux</i> operating system is assumed and a working
+<i>Padb</i> requires very little support from the OS or parallel  
environment to
+run, it's main use is to assist in the debugging of parallel applications,  
it's
+therefore assumed that you have a working MPI stack or other parallel
+environment and that "Hello world" application runs to completion without
+error.<br> A <i>Linux</i> operating system is assumed and a working
  <i>gdb</i> is required for stack trace functionality.<br>
  </div>
  <div id="footer">
   <hr>
- <center>
- <font size="-2">
-  <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
- </font>
- <center>
+ <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
  </div>
=======================================
--- /trunk/doc/layout.css	Thu Sep 10 02:38:12 2009
+++ /trunk/doc/layout.css	Mon Nov  9 07:45:01 2009
@@ -32,6 +32,8 @@

  #footer {
   clear: both;
+ font-size: 75%;
+ text-align: center;
  }

  pre.code {
@@ -42,3 +44,10 @@
  border: 1px solid;
  }

+span.menu_heading {
+font-size: 110%;
+}
+
+span.menu_subheading {
+font-size: 80%;
+}
=======================================
--- /trunk/doc/modes.html	Mon Sep 14 01:56:33 2009
+++ /trunk/doc/modes.html	Mon Nov  9 07:45:01 2009
@@ -49,7 +49,7 @@
  <pre class=code>
  $ padb --all --proc-summary
  </pre>
-</tr></td>
+</td></tr>
  <tr><td>
  <pre class=code>
  vpid  hostname  pid   vmsize     vmrss    S  %cpu  command
@@ -62,7 +62,7 @@
     1        i1  2614  160336 kB  4468 kB  R    47    a.out
     0     fnarp  2788  160336 kB  4464 kB  R    44    a.out
  </pre>
-</tr></td>
+</td></tr>
  </table>

  The config option <b>proc-sort-key</b> controls which column the table is  
sorted by, the default is vpid.
@@ -80,7 +80,7 @@
  <pre class=code>
  $ padb --all --rank=0 --proc-info
  </pre>
-</tr></td>
+</td></tr>
  <tr><td>
  <pre class=code>
  hostname:fnarp
@@ -138,7 +138,7 @@
  fd29: pipe:[56966] (0 01)
  pcpu: 47
  </pre>
-</tr></td>
+</td></tr>
  </table>

  <div class=mode>
@@ -153,7 +153,7 @@
  <pre class=code>
  $ padb --all --stack-trace --tree
  </pre>
-</tr></td>
+</td></tr>
  <tr><td>
  <pre class=code>
  -----------------
@@ -186,7 +186,7 @@
            ompi_request_default_wait_all() at ?:?
              opal_progress() at ?:?
  </pre>
-</tr></td>
+</td></tr>
  </table>

  The config options <b>stack-shows-locals</b> and <b>stack-shows-params</b>  
can be enabled to display more information in the stack
@@ -197,7 +197,7 @@
  <pre class=code>
  $ padb --any --stack-trace --rank 0 -O stack-shows-locals=1  
-Ostack-shows-params=1
  </pre>
-</tr></td>
+</td></tr>
  <tr><td>
  <pre class=code>
  main() at ?:?
@@ -260,7 +260,7 @@
  sched_yield() at ?:?
  __kernel_vsyscall() at ?:?
  </pre>
-</tr></td>
+</td></tr>
  </table>

  <p>
@@ -287,7 +287,7 @@
  <pre class=code>
  $ padb --all --compress --mpi-queue
  </pre>
-</tr></td>
+</td></tr>
  <tr><td>
  <pre class=code>
  ----------------
@@ -357,7 +357,7 @@
  comm5: size: '1'
  comm5: id: '0x1c'
  </pre>
-</tr></td>
+</td></tr>
  </table>

  <div class=mode>
@@ -371,7 +371,7 @@
  <pre class=code>
  $ padb --all --deadlock
  </pre>
-<tr/><td/>
+
  <tr><td>
  <pre class=code>
  Information for group '0x4' (MPI COMMUNICATOR 4 DUP FROM 0)
@@ -384,7 +384,7 @@
  Group members [1-3] (size 4) are not in a call to the collectives.
  Total: 6 groups of which 2 are in use.
  </pre>
-</tr></td>
+</td></tr>
  </table>

  <div class=mode>
@@ -418,7 +418,6 @@
  <pre class=code>
  $ padb --all --mpi-watch --watch -Owatch-clears-screen=no
  </pre>
-<tr/><td/>
  <tr><td>
  <pre class=code>
  u: unexpected messages U: unexpected and other messages
@@ -718,14 +717,10 @@
  ,,,RRRRRRRR,,,,,bbbb
  b*bb*****b*b*bbbbbbb
  </pre>
-</tr></td>
+</td></tr>
  </table>
  </div>
  <div id="footer">
   <hr>
- <center>
- <font size="-2">
-  <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
- </font>
- <center>
+ <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
  </div>
=======================================
--- /trunk/doc/usage.html	Mon Sep 14 01:56:33 2009
+++ /trunk/doc/usage.html	Mon Nov  9 07:45:01 2009
@@ -5,13 +5,13 @@
   <a name=rmgr></a>
   <h2>Selecting the Resource Manager (Job Launcher)</h2>
  </div>
-<i>Padb</i> supports many resource managers and should select
-the appropriate one for your cluster, if you have more than
-one resource manager installed or <i>padb</i> can't detect
-the correct one use the <b>rmgr</b> <a  
href=configuration.html>configuration option</a>.
-
-<p>If no resource manager is found you can use <b>-O rmgr=local</b> and  
process
-identifiers (pids) will be used instead of job ids.
+<i>Padb</i> supports many resource managers and should select the
+appropriate one for your cluster, if you have more than one resource
+manager installed or <i>padb</i> can't detect the correct one use
+the <b>rmgr</b> <a href=configuration.html>configuration option</a>.
+
+<p>If no resource manager is found you can use <b>-O rmgr=local</b>
+and process identifiers (pids) will be used instead of job ids.


  <center>
@@ -22,6 +22,15 @@
    <th>Notes</th>
   </tr>
   <tr>
+  <td>Any</td>
+  <td>mpirun</td>
+  <td>Works with any resource manager or software stack that is
+  compliant with
+  the <a href="http://www.mcs.anl.gov/research/projects/mpi/mpi-debug/">MPI
+  debugger interface</a>.  It is recommended to use support for your
+  specific resource manager if it exists.</td>
+ </tr>
+ <tr>
    <td>Slurm</td>
    <td>slurm</td>
    <td>Fully supported</td>
@@ -44,87 +53,93 @@
   <tr>
    <td>None</td>
    <td>local</td>
-  <td>allows process identifiers (pids) to be specified as jobids and  
treats that process
-as a single process job.</td>
+  <td>allows process identifiers (pids) to be specified as jobids and
+treats that process as a single process job.</td>
   </tr>
   <tr>
    <td>None</td>
    <td>local-fd</td>
-  <td>as local but only selects processes which have a certain file open,  
use the "local-fd-name" configuration option to set the filename.</td>
+  <td>as local but only selects processes which have a certain file
+  open, use the "local-fd-name" configuration option to set the
+  filename.</td>
   </tr>
   <tr>
    <td>None</td>
    <td>local-qsnet</td>
-  <td>as local-fd with local-fd-name set to /proc/qsnet/elan/user to  
automatially select network jobs on the local node.</td>
+  <td>as local-fd with local-fd-name set to /proc/qsnet/elan/user to
+  automatially select network jobs on the local node.</td>
   </tr>
  </table>
  </center>

-<p>The <b>--list-rmgrs</b> option can be used to show a list of detected
-resource managers and their active jobs.
+<p>The <b>--list-rmgrs</b> option can be used to show a list of
+detected resource managers and their active jobs.

  <div class=mode>
   <a name=job></a>
   <h2>Selecting the job(s) to target</h2>
  </div>
-<i>Padb</i> provides several ways for the user to select which jobs
-to target depending on requirements.  All jobs detected by padb are
+<i>Padb</i> provides several ways for the user to select which jobs to
+target depending on requirements.  All jobs detected by padb are
  identified by a unique numeric "jobid", typically this maps directly
-only a identifier provided by the underlying resource manager.
-The default is to target jobs of the current user, this can be
-over-ridden with the <b>--user</b> flag.
+only a identifier provided by the underlying resource manager.  The
+default is to target jobs of the current user, this can be over-ridden
+with the <b>--user</b> flag.

  <h3>Showing list of current jobs</h3>
  To show a list of currently running jobs for a given user use the
-<b>--show-jobs</b> option.  Alternatively the <b>--list-rmgrs</b> option
-shows a list of detected resource managers along with a list of currently  
active jobs for each of them.
-
-<h3>To target all jobs</h3>
-To target all jobs currently running for a given user use the <b>--all</b>  
(<b>-a</b>) flag.
-
-<h3>To target any jobs</h3>
-To target "any" job currently running for a given user use the  
<b>--any</b> (<b>-A</b>) flag.
-This differs from targeting all jobs as it will exit with an error if more
-than one job is running.
-
-<h3>To target a specific job</h3>
-To target a specific job specify the jobid for the job on the command line,
-after all other options.
+<b>--show-jobs</b> option.  Alternatively the <b>--list-rmgrs</b>
+option shows a list of detected resource managers along with a list of
+currently active jobs for each of them.
+
+<h3>To target all jobs</h3> To target all jobs currently running for a
+given user use the <b>--all</b> (<b>-a</b>) flag.
+
+<h3>To target any jobs</h3> To target "any" job currently running for
+a given user use the <b>--any</b> (<b>-A</b>) flag.  This differs from
+targeting all jobs as it will exit with an error if more than one job
+is running.
+
+<h3>To target a specific job</h3> To target a specific job specify the
+jobid for the job on the command line, after all other options.

  <div class=mode>
- <a name=full-report></a></a>
+ <a name=full-report></a>
   <h3>To target a specific job (Full report option)</h3>
  </div>
  If trying to diagnose a problem or gather information there is another
-option, <b>--full-report=<jobid></b>, this tells padb to target the  
job
-specified and to report all information about the job it knows how to
-collect.  This option is typically used when creating bug reports to
-send to third parties or to inspect a job for anomalies.
+option, <b>--full-report=<jobid></b>, this tells padb to target
+the job specified and to report all information about the job it knows
+how to collect.  This option is typically used when creating bug
+reports to send to third parties or to inspect a job for anomalies.

  <hr>

-<a name=rank><h1>Selecting ranks (Processes)</h1></a>
-In modes where data for each process is reported separately it is possible
-to restrict which ranks are queried, this is done via the <b>--rank</b>  
option.
-Multiple ranks can be selected by specifying <b>--rank</b> multiple times.
+<h1><a name="rank">Selecting ranks (Processes)</a></h1> In modes where
+data for each process is reported separately it is possible to
+restrict which ranks are queried, this is done via the <b>--rank</b>
+option.  Multiple ranks can be selected by specifying <b>--rank</b>
+multiple times.

  <hr>

  <h1>Selecting which mode to run in.</h1>
  <i>Padb</i> can present an array of different information about your
  select jobs and it can present it in a number of different ways.  With
-the exception of Full Report only one mode can be selected, if you need
-more information about the program run <i>padb</i> more than once.
+the exception of Full Report only one mode can be selected, if you
+need more information about the program run <i>padb</i> more than
+once.

  <div class=mode>
   <a name=full-report></a>
   <h2>Full Report</h2>
  </div>
  If you are just starting with <i>padb</i> or are creating an error
-report for somebody else then the <b>--full-report=<jobid></b>  
option is a good place
-to start, this will complete a full diagnostic report for the job
-iterating over the more common padb options.  For large jobs this can
-generate a lot of output so redirecting to a file is recommended.
+report for somebody else then the <b>--full-report=<jobid></b>
+option is a good place to start, this will complete a full diagnostic
+report for the job iterating over the more common padb options.  For
+large jobs this can generate a lot of output so redirecting to a file
+is recommended.

  <p>

@@ -133,9 +148,5 @@
  </div>
  <div id="footer">
   <hr>
- <center>
- <font size="-2">
-  <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
- </font>
- <center>
+ <p>Page maintained by Ashley Pittman. $Date$ $Revision$</p>
  </div>




More information about the padb-devel mailing list