1
1
openmpi/orte/tools/orte-restart/orte-restart.1in
Dan Lacher 9175da1e02 Putback for all changes to automate man page updates to strings of
versions, dates and build names.

Fixes trac:1387

Big thanks to Jeff and Brian for help and oversight.

This commit was SVN r19120.

The following Trac tickets were found above:
  Ticket 1387 --> https://svn.open-mpi.org/trac/ompi/ticket/1387
2008-08-01 21:14:37 +00:00

116 строки
3.0 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-restart command
.\"
.\" .TH name section center-footer left-footer center-header
.TH OMPI-RESTART 1 "#OMPI_DATE#" "#PACKAGE_VERSION#" "#PACKAGE_NAME#"
.\" **************************
.\" Name Section
.\" **************************
.SH NAME
.
ompi-restart, orte-restart \- Restart a previously checkpointed parallel job
using the Open PAL Checkpoint/Restart Service (CRS)
.
.PP
.
\fBNOTE:\fP \fIompi-restart\fP, and \fIorte-restart\fP are all exact
synonyms for each other. Using any of the names will result in exactly
identical behavior.
.
.\" **************************
.\" Synopsis Section
.\" **************************
.SH SYNOPSIS
.
.B ompi-restart
.R [ options ]
.B <GLOBAL SNAPSHOT HANDLE>
.
.\" **************************
.\" Options Section
.\" **************************
.SH Options
.
\fIompi-restart\fR will attempt to restart a previously checkpointed parallel
job from the global snapshot handle reference returned by \fIompi_checkpoint\fP.
.
.TP 10
.B <GLOBAL SNAPSHOT HANDLE>
The global snapshot handle reference returned by \fIompi_checkpoint\fP, used to
restart the job. This is required to be the last argument to this command.
.
.
.TP
.B -h | --help
Display help for this command
.
.
.TP
.B -p | --preload
Preload the checkpoint files on the remote systems before restarting the
application. Disabled by default.
.
.
.TP
.B --fork
Fork off a new process, which is the restarted process. By default, the
restarted process will replace \fIompi-restart\fR.
.
.
.TP
.B -s | --seq
The sequence number of the checkpoint to restart from. By default, the most
recent sequence number is used (specified by -1).
.
.
.TP
.B -hostfile | --hostfile
The hostfile from which to restart the application. Useful in unscheduled
environments. (Same behavior as --machinefile option)
.
.
.TP
.B -machinefile | --machinefile
The machinefile from which to restart the application. Useful in unscheduled
environments. (Same behavior as --hostfile option)
.
.
.TP
.B -v | --verbose
Enable verbose output for debugging.
.
.
.TP
.B -gmca | --gmca \fR<key> <value>\fP
Pass global MCA parameters that are applicable to all contexts. \fI<key>\fP is
the parameter name; \fI<value>\fP is the parameter value.
.
.
.TP
.B -mca | --mca <key> <value>
Send arguments to various MCA modules.
.
.
.\" **************************
.\" Description Section
.\" **************************
.SH DESCRIPTION
.
.PP
\fIompi-restart\fR can be invoked multiple, non-overlapping times. This
allows the user to restart a previously running parallel job.
.
.
.\" **************************
.\" See Also Section
.\" **************************
.
.SH SEE ALSO
orte-ps(1), orte-clean(1), ompi-checkpoint(1), opal-checkpoint(1), opal-restart(1), opal_crs(7)
.