c796d84d61
* Make orted.1 man page be non-descriptive because it's really an internal command. * Re-work the opal_wrapper man page logic a bit so that we can have a real opal_wrapper.1 installed that says "don't look here -- look at mpicc (etc.)" This commit was SVN r15264.
209 строки
6.2 KiB
Groff
209 строки
6.2 KiB
Groff
.TH @COMMAND@ 1 "@PROJECT@" "@PROJECT_SHORT@" "@PROJECT@"
|
|
.
|
|
.SH NAME
|
|
@COMMAND@ -- @PROJECT@ @LANGUAGE@ wrapper compiler
|
|
.
|
|
.SH SYNTAX
|
|
@COMMAND@ [-showme|-showme:compile|-showme:link] ...
|
|
.
|
|
.SH OPTIONS
|
|
.TP
|
|
-showme
|
|
Do not invoke the underlying compiler. Instead, show the command line
|
|
that would be executed to compile the program. \fBNOTE:\fR If a
|
|
non-filename argument is passed on the command line, the \fI-showme\fR
|
|
option will \fInot\fR display any additional flags. For example, both
|
|
"@COMMAND@ --showme" and "@COMMAND@ --showme my_source.c" will show all the
|
|
wrapper-supplied flags. But "@COMMAND@ -showme -v" will only show the
|
|
underlying compiler name and "-v".
|
|
.TP
|
|
-showme:compile
|
|
Do not invoke the underlying @LANGUAGE@ compiler. Instead, show the
|
|
compiler flags that would be supplied to the @LANGUAGE@ compiler.
|
|
.TP
|
|
-showme:link
|
|
Do not invoke the underlying @LANGUAGE@ compiler. Instead, show the linker
|
|
flags that would be supplied to the @LANGUAGE@ compiler.
|
|
.PP
|
|
See the man page for your underlying compiler for other options that
|
|
can be passed through @COMMAND@
|
|
.
|
|
.
|
|
.SH DESCRIPTION
|
|
.PP
|
|
Conceptually, the role of these commands is quite simple:
|
|
transparently add relevant compiler and linker flags to the user's
|
|
command line that are necessary to compile / link @PROJECT@
|
|
programs, and then invoke the underlying compiler to actually perform
|
|
the command.
|
|
.
|
|
.PP
|
|
As such, these commands are frequently referred to as "wrapper"
|
|
compilers because they do not actually compile or link applications
|
|
themselves; they only add in command line flags and invoke the
|
|
back-end compiler.
|
|
.
|
|
.
|
|
.SS Background
|
|
Open MPI is comprised of three software layers: OPAL (Open Portable
|
|
Access Layer), ORTE (Open Run-Time Environment), and OMPI (Open MPI).
|
|
There are wrapper compilers for each layer; each layer's wrapper only
|
|
links in the libraries relevant for that layer. Specifically, each
|
|
layer provides the following wrapper compilers:
|
|
.
|
|
.TP 4
|
|
OPAL
|
|
\fIopalcc\fR and \fIopalc++\fR
|
|
.
|
|
.TP
|
|
ORTE
|
|
\fIortecc\fR and \fIortec++\fR
|
|
.
|
|
.TP
|
|
OMPI
|
|
\fImpicc\fR, \fImpic++\fR, \fImpicxx\fR, \fImpiCC\fR (only on systems with
|
|
case-senstive file systems), \fImpif77\fR, and \fImpif90\fR. Note
|
|
that \fImpic++\fR, \fImpicxx\fR, and \fImpiCC\fR all invoke the same
|
|
underlying C++ compiler with the same options. All are provided as
|
|
compatibility with other MPI implementations.
|
|
.
|
|
.PP
|
|
The Fortran wrapper compilers for MPI (\fImpif77\fR and \fImpif90\fR)
|
|
will be inoperative and will return an error on use if Fortran 77 /
|
|
Fortran 90 support was not built into the MPI layer.
|
|
.
|
|
.
|
|
.SS Overview
|
|
\fI@COMMAND@\fR is a convenience wrappers for the underlying
|
|
@LANGUAGE@ compiler. Translation of an @PROJECT@ program requires the
|
|
linkage of the @PROJECT@-specific libraries which may not reside in
|
|
one of the standard search directories of ld(1). It also often
|
|
requires the inclusion of header files what may also not be found in a
|
|
standard location.
|
|
.
|
|
.PP
|
|
\fI@COMMAND@\fR passes its arguments to the underlying @LANGUAGE@
|
|
compiler along with the -I, -L and -l options required by @PROJECT@
|
|
programs.
|
|
.
|
|
.PP
|
|
The @PROJECT@ Team \fIstrongly\fR encourages using the wrapper
|
|
compilers instead of attempting to link to the @PROJECT@ libraries
|
|
manually. This allows the specific implementation of @PROJECT@ to
|
|
change without forcing changes to linker directives in users'
|
|
Makefiles. Indeed, the specific set of flags and libraries used by
|
|
the wrapper compilers depends on how @PROJECT@ was configured and
|
|
built; the values can change between different installations of the
|
|
same version of @PROJECT@.
|
|
.
|
|
.PP
|
|
Indeed, since the wrappers are simply thin shells on top of an
|
|
underlying compiler, there are very, very few compelling reasons
|
|
\fInot\fR to use \fI@COMMAND@\fR. When it is not possible to use the
|
|
wrappers directly, the \fI-showme:compile\fR and \fI-showme:link\fR
|
|
options should be used to determine what flags the wrappers would have
|
|
used. For example:
|
|
.
|
|
.PP
|
|
shell$ cc -c file1.c `mpicc -showme:compile`
|
|
.
|
|
.PP
|
|
shell$ cc -c file2.c `mpicc -showme:compile`
|
|
.
|
|
.PP
|
|
shell$ cc file1.o file2.o `mpicc -showme:link` -o my_mpi_program
|
|
.
|
|
.
|
|
.SH NOTES
|
|
.PP
|
|
It is possible to make the wrapper compilers multi-lib aware. That
|
|
is, the libraries and includes specified may differ based on the
|
|
compiler flags specified (for example, with the GNU compilers on
|
|
Linux, a different library path may be used if -m32 is seen versus
|
|
-m64 being seen). This is not the default behavior in a standard
|
|
build, but can be activated (for example, in a binary package
|
|
providing both 32 and 64 bit support). More information can be found
|
|
at:
|
|
.PP
|
|
https://svn.open-mpi.org/trac/ompi/wiki/compilerwrapper3264
|
|
.
|
|
.
|
|
.SH FILES
|
|
.PP
|
|
The string that the wrapper compilers insert into the command line
|
|
before invoking the underlying compiler are stored in a text file
|
|
created by @PROJECT@ and installed to
|
|
\fI$pkgdata/@COMMAND@-wrapper-data.txt\fR, where \fI$pkgdata\fR
|
|
is typically \fI$prefix/share/openmpi\fR, and \fI$prefix\fR is the top
|
|
installation directory of @PROJECT@.
|
|
.
|
|
.PP
|
|
It is rarely necessary to edit this file, but it can be examined to
|
|
gain insight into what flags the wrappers are placing on the command
|
|
line.
|
|
.
|
|
.
|
|
.SH ENVIRONMENT VARIABLES
|
|
.PP
|
|
By default, the wrappers use the compilers that were selected when
|
|
@PROJECT@ was configured. These compilers were either found
|
|
automatically by Open MPI's "configure" script, or were selected by
|
|
the user in the CC, CXX, F77, and/or FC environment variables
|
|
before "configure" was invoked. Additionally, other arguments
|
|
specific to the compiler may have been selected by configure.
|
|
.
|
|
.PP
|
|
These values can be selectively overridden by either editing the text
|
|
files containing this configuration information (see the \fBFILES\fR
|
|
section), or by setting selected environment variables of the
|
|
form "@PROJECT_SHORT@_value".
|
|
.
|
|
.PP
|
|
Valid value names are:
|
|
.
|
|
.TP
|
|
CPPFLAGS
|
|
Flags added when invoking the preprocessor (C or C++)
|
|
.
|
|
.TP
|
|
LDFLAGS
|
|
Flags added when invoking the linker (C, C++, or Fortran)
|
|
.
|
|
.TP
|
|
LIBS
|
|
Libraries added when invoking the linker (C, C++, or Fortran)
|
|
.
|
|
.TP
|
|
CC
|
|
C compiler
|
|
.
|
|
.TP
|
|
CFLAGS
|
|
C compiler flags
|
|
.
|
|
.TP
|
|
CXX
|
|
C++ compiler
|
|
.
|
|
.TP
|
|
CXXFLAGS
|
|
C++ compiler flags
|
|
.
|
|
.
|
|
.TP
|
|
F77
|
|
Fortran 77 compiler
|
|
.
|
|
.TP
|
|
FFLAGS
|
|
Fortran 77 compiler flags
|
|
.
|
|
.
|
|
.TP
|
|
FC
|
|
Fortran 90 compiler
|
|
.
|
|
.TP
|
|
FCFLAGS
|
|
Fortran 90 compiler flags
|