1
1
openmpi/orte/tools/orte-iof/orte-iof.1in
Ralph Castain 6e5d844c36 Roll in the revamped IOF subsystem. Per the devel mailing list email, this is a complete rewrite of the iof framework designed to simplify the code for maintainability, and to support features we had planned to do, but were too difficult to implement in the old code. Specifically, the new code:
1. completely and cleanly separates responsibilities between the HNP, orted, and tool components.

2. removes all wireup messaging during launch and shutdown.

3. maintains flow control for stdin to avoid large-scale consumption of memory by orteds when large input files are forwarded. This is done using an xon/xoff protocol.

4. enables specification of stdin recipients on the mpirun cmd line. Allowed options include rank, "all", or "none". Default is rank 0.

5. creates a new MPI_Info key "ompi_stdin_target" that supports the above options for child jobs. Default is "none".

6. adds a new tool "orte-iof" that can connect to a running mpirun and display the output. Cmd line options allow selection of any combination of stdout, stderr, and stddiag. Default is stdout.

7. adds a new mpirun and orte-iof cmd line option "tag-output" that will tag each line of output with process name and stream ident. For example, "[1,0]<stdout>this is output"

This is not intended for the 1.3 release as it is a major change requiring considerable soak time.

This commit was SVN r19767.
2008-10-18 00:00:49 +00:00

90 строки
2.2 KiB
Plaintext

.\"
.\" Copyright (c) 2004-2007 The Trustees of Indiana University and Indiana
.\" University Research and Technology
.\" Corporation. All rights reserved.
.\" Copyright (c) 2008 Sun Microsystems, Inc. All rights reserved.
.\"
.\" Man page for OMPI's ompi-iof command
.\"
.\" .TH name section center-footer left-footer center-header
.TH OMPI-IOF 1 "#OMPI_DATE#" "#PACKAGE_VERSION#" "#PACKAGE_NAME#"
.\" **************************
.\" Name Section
.\" **************************
.SH NAME
.
ompi-iof, orte-iof \- Displays a copy of the output streams from a process.
.
.PP
.
\fBNOTE:\fP \fIompi-iof\fP, and \fIorte-iof\fP are exact
synonyms for each other. Using any of the names will result in exactly
identical behavior.
.
.\" **************************
.\" Synopsis Section
.\" **************************
.SH SYNOPSIS
.
.B ompi-iof
.R [ options ]
.
.\" **************************
.\" Options Section
.\" **************************
.SH Options
.
\fIompi-iof\fR will display a copy of the indicated stdout, stderr, and/or stddiag streams
from the designated process.
.
.TP 10
.B -pid | --pid
The pid of the mpirun executing the process whose streams are to be copied
.
.
.TP
.B -stdout | --stdout
Display a copy of the specified process' stdout. If no options are specified, this will
act as the default
.
.
.TP
.B -stderr | --stderr
Display a copy of the specified process' stderr.
.
.
.TP
.B -stddiag | --stddiag
Display a copy of the specified process' stddiag.
.
.
.TP
.B -rank | --rank
The rank of the process whose output is to be copied.
.
.
.TP
.B -tag-output | --tag-output
Tag each line of output with the process name and stream name.
.
.
.\" **************************
.\" Description Section
.\" **************************
.SH DESCRIPTION
.
.PP
\fIompi-iof\fR displays a copy of the indicated stdout, stderr, and/or stddiag streams
from the designated process. At this time, a ctrl-C must be used to terminate the program.
The program will terminate cleanly, telling the associated mpirun to close the requested
streams before exiting.
.
.
.\" **************************
.\" See Also Section
.\" **************************
.
.SH SEE ALSO
orterun(1)
.