Moved the 'orte-ps' command from the tmp/jjhursey-ft-cr branch

per a request for its functionality into the main trunk.

This command provides basic information about a running job. It
needs a bit of attention, but works fine in its current iteration.

Please play with it, and lets try to work out all the left over bugs.

Pending action for this tool:
It has been requested that the tool be changed slightly to allow
it to be called via a function call from internal libraries
(e.g. orteconsole).

This commit was SVN r10554.

configure.ac

@@ -1103,6 +1103,7 @@ AC_CONFIG_FILES([
     orte/tools/wrappers/Makefile
     orte/tools/wrappers/ortecc-wrapper-data.txt
     orte/tools/wrappers/ortec++-wrapper-data.txt
+    orte/tools/orte-ps/Makefile
 
     ompi/Makefile
     ompi/etc/Makefile

orte/tools/Makefile.am

@@ -25,7 +25,8 @@ SUBDIRS += \
 	tools/orted \
 	tools/orteprobe \
 	tools/orterun \
-	tools/wrappers
+	tools/wrappers \
+	tools/orte-ps
 
 DIST_SUBDIRS += \
 	tools/console \
@@ -33,4 +34,5 @@ DIST_SUBDIRS += \
 	tools/orted \
 	tools/orteprobe \
 	tools/orterun \
-	tools/wrappers
+	tools/wrappers \
+	tools/orte-ps

orte/tools/orte-ps/Makefile.am

@@ -0,0 +1,45 @@
+#
+# Copyright (c) 2004-2005 The Trustees of Indiana University and Indiana
+#                         University Research and Technology
+#                         Corporation.  All rights reserved.
+# Copyright (c) 2004-2005 The University of Tennessee and The University
+#                         of Tennessee Research Foundation.  All rights
+#                         reserved.
+# Copyright (c) 2004-2005 High Performance Computing Center Stuttgart, 
+#                         University of Stuttgart.  All rights reserved.
+# Copyright (c) 2004-2005 The Regents of the University of California.
+#                         All rights reserved.
+# $COPYRIGHT$
+# 
+# Additional copyrights may follow
+# 
+# $HEADER$
+#
+
+nodist_pkgdata_DATA = 
+dist_pkgdata_DATA = \
+	help-orte-ps.txt
+
+bin_PROGRAMS = orte-ps
+
+orte_ps_SOURCES = \
+	orte-ps.c
+
+# Manual pages
+man_MANS = orte-ps.1 ompi-ps.1
+EXTRA_DIST = orte-ps.1
+
+orte_ps_LDADD = $(top_builddir)/orte/liborte.la
+orte_ps_DEPENDENCIES = $(top_builddir)/orte/liborte.la
+
+install-exec-hook:
+	(cd $(DESTDIR)$(bindir); rm -f ompi-ps$(EXEEXT); $(LN_S) orte-ps$(EXEEXT) ompi-ps$(EXEEXT))
+
+uninstall-local:
+	rm -f $(DESTDIR)$(bindir)/ompi-ps$(EXEEXT)
+
+ompi-ps.1: $(top_srcdir)/orte/tools/orte-ps/orte-ps.1
+	cp -f $(top_srcdir)/orte/tools/orte-ps/orte-ps.1 ompi-ps.1
+
+distclean-local:
+	rm -f ompi-ps.1

orte/tools/orte-ps/help-orte-ps.txt

@@ -0,0 +1,33 @@
+# -*- text -*-
+#
+# Copyright (c) 2004-2005 The Trustees of Indiana University and Indiana
+#                         University Research and Technology
+#                         Corporation.  All rights reserved.
+# Copyright (c) 2004-2005 The University of Tennessee and The University
+#                         of Tennessee Research Foundation.  All rights
+#                         reserved.
+# Copyright (c) 2004-2005 High Performance Computing Center Stuttgart, 
+#                         University of Stuttgart.  All rights reserved.
+# Copyright (c) 2004-2005 The Regents of the University of California.
+#                         All rights reserved.
+# $COPYRIGHT$
+# 
+# Additional copyrights may follow
+# 
+# $HEADER$
+#
+# This is the US/English help file for Open MPI PS tool
+#
+[usage]
+ompi-ps [OPTIONS]
+  Open MPI Job and Process Status Tool
+
+%s
+
+[vpid-usage]
+Error: You specified a vpid (%d) without also specifying a jobid.
+       Use the '-j' option to specify a jobid.
+
+[invalid-vpid]
+Error: The specified vpid (%d) is not valid for job %d.
+

orte/tools/orte-ps/orte-ps.1

@@ -0,0 +1,51 @@
+.\"
+.\" Man page for OMPI's ompi-ps command
+.\" 
+.\" .TH name     section center-footer   left-footer  center-header
+.TH     OMPI-PS  1       "June 2006" "Open MPI"   "OPEN MPI COMMANDS"
+.\" **************************
+.\"    Name Section
+.\" **************************
+.SH NAME
+.
+ompi-ps, orte-ps \- Displays information about the active jobs and processes 
+in Open MPI.
+.
+.PP
+.
+\fBNOTE:\fP \fIompi-ps\fP, and \fIorte-ps\fP are exact
+synonyms for each other. Using any of the names will result in exactly
+identical behavior.
+.
+.\" **************************
+.\"    Synopsis Section
+.\" **************************
+.SH SYNOPSIS
+.
+.B ompi-ps
+.R [ options ]
+.
+.\" **************************
+.\"    Options Section
+.\" **************************
+.SH Options
+.
+To be written...
+.
+.
+.\" **************************
+.\"    Description Section
+.\" **************************
+.SH DESCRIPTION
+.
+.PP
+\fIompi-ps\fR ...
+.
+.
+.\" **************************
+.\"    See Also Section
+.\" **************************
+.
+.SH SEE ALSO
+orterun(1)
+.