Skip to content
GitLab
Menu
Projects
Groups
Snippets
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
Rob Latham
mpich-CVS
Commits
bd9fb9f9
Commit
bd9fb9f9
authored
Oct 23, 2007
by
robl
Browse files
quick pass to remove the most blatantly out of date information. still needs
more
parent
7cd3aae3
Changes
1
Hide whitespace changes
Inline
Side-by-side
src/mpi/romio/doc/users-guide.tex
View file @
bd9fb9f9
...
@@ -162,8 +162,8 @@ the commands provided by the file system to access the file, for example,
...
@@ -162,8 +162,8 @@ the commands provided by the file system to access the file, for example,
{
\tt
ls
}
,
{
\tt
mv
}
,
{
\tt
cp
}
,
{
\tt
rm
}
,
{
\tt
ftp
}
.
{
\tt
ls
}
,
{
\tt
mv
}
,
{
\tt
cp
}
,
{
\tt
rm
}
,
{
\tt
ftp
}
.
Please read the limitations of this version of ROMIO that are listed
Please read the limitations of this version of ROMIO that are listed
in Section~
\ref
{
sec:limit
}
of this document (e.g.,
{
\tt
MPIO
\_
Request
}
in Section~
\ref
{
sec:limit
}
of this document (e.g.,
restriction to homogeneous
object, restriction to homogeneous
environments).
environments).
\subsection
{
ROMIO Optimizations
}
\subsection
{
ROMIO Optimizations
}
\label
{
sec:opt
}
\label
{
sec:opt
}
...
@@ -229,7 +229,7 @@ Determines when ROMIO will choose to perform data sieving.
...
@@ -229,7 +229,7 @@ Determines when ROMIO will choose to perform data sieving.
Valid values are
\texttt
{
enable
}
,
\texttt
{
disable
}
, or
\texttt
{
automatic
}
.
Valid values are
\texttt
{
enable
}
,
\texttt
{
disable
}
, or
\texttt
{
automatic
}
.
Default value is
\texttt
{
automatic
}
. In
\texttt
{
automatic
}
mode ROMIO
Default value is
\texttt
{
automatic
}
. In
\texttt
{
automatic
}
mode ROMIO
may choose to enable or disable data sieving based on heuristics.
may choose to enable or disable data sieving based on heuristics.
\item
\texttt
{
romio
\_
ds
\_
write
}
--
Currently this hint is ignored
.
\item
\texttt
{
romio
\_
ds
\_
write
}
--
Same as above, only for writes
.
\end{itemize}
\end{itemize}
The following hints control the two-phase (collective buffering)
The following hints control the two-phase (collective buffering)
...
@@ -550,7 +550,7 @@ barrier or similar operation to ensure the set size has completed.
...
@@ -550,7 +550,7 @@ barrier or similar operation to ensure the set size has completed.
\section
{
Installation Instructions
}
\section
{
Installation Instructions
}
Since ROMIO is included in MPICH, LAM, HP MPI, SGI MPI, and NEC MPI, you don't
Since ROMIO is included in MPICH, LAM, HP MPI, SGI MPI, and NEC MPI, you don't
need to install it separately if you are using any of these MPI
need to install it separately if you are using any of these MPI
implementations. If you are using some other MPI, you
implementations.
If you are using some other MPI, you
can configure and build ROMIO as follows:
can configure and build ROMIO as follows:
Untar the tar file as
Untar the tar file as
...
@@ -608,7 +608,8 @@ followed by {\tt make}.
...
@@ -608,7 +608,8 @@ followed by {\tt make}.
32-bit systems running linux kernel version 2.4.0 or newer and glibc
32-bit systems running linux kernel version 2.4.0 or newer and glibc
version 2.2.0 or newer can support files greater than 2 GBytes in size.
version 2.2.0 or newer can support files greater than 2 GBytes in size.
This support is not automatic, however.
This support is currently automaticly detected and enabled. We document the
manual steps should the automatic detection not work for some reason.
The two macros
{
\tt\_
FILE
\_
OFFSET
\_
BITS=64
}
and
The two macros
{
\tt\_
FILE
\_
OFFSET
\_
BITS=64
}
and
{
\tt\_
LARGEFILE64
\_
SOURCE
}
tell gnu libc it's ok to support large files
{
\tt\_
LARGEFILE64
\_
SOURCE
}
tell gnu libc it's ok to support large files
...
@@ -705,16 +706,6 @@ revision 1.2.1 or later, all MPI-IO functions return only two possible
...
@@ -705,16 +706,6 @@ revision 1.2.1 or later, all MPI-IO functions return only two possible
error codes---
{
\tt
MPI
\_
SUCCESS
}
on success and
{
\tt
MPI
\_
ERR
\_
UNKNOWN
}
error codes---
{
\tt
MPI
\_
SUCCESS
}
on success and
{
\tt
MPI
\_
ERR
\_
UNKNOWN
}
on failure.
on failure.
\item
All nonblocking I/O functions use a ROMIO-defined
{
\tt
MPIO
\_
Request
}
object instead of the usual
{
\tt
MPI
\_
Request
}
object. Accordingly, two
functions,
{
\tt
MPIO
\_
Test
}
and
{
\tt
MPIO
\_
Wait
}
, are provided to test
and wait on these
{
\tt
MPIO
\_
Request
}
objects. They have the same
semantics as
{
\tt
MPI
\_
Test
}
and
{
\tt
MPI
\_
Wait
}
.
\\
\hspace*
{
.4in
}
{
\tt
int MPIO
\_
Test(MPIO
\_
Request *request, int *flag, MPI
\_
Status *status);
}
\\
\hspace*
{
.4in
}
{
\tt
int MPIO
\_
Wait(MPIO
\_
Request *request, MPI
\_
Status *status);
}
\\
The usual functions
{
\tt
MPI
\_
Test
}
,
{
\tt
MPI
\_
Wait
}
,
{
\tt
MPI
\_
Testany
}
,
and so forth, will not work for nonblocking I/O.
\item
This version works only on a homogeneous cluster of machines,
\item
This version works only on a homogeneous cluster of machines,
and only the ``native'' file data representation is supported.
and only the ``native'' file data representation is supported.
...
@@ -768,23 +759,15 @@ mpif.h} of an older version of MPICH.
...
@@ -768,23 +759,15 @@ mpif.h} of an older version of MPICH.
%
%
% MAILING LIST
% MAILING LIST
%
%
\section
{
ROMIO Users Mailing List
}
% this mailing list has been dead for a while
Please register your copy of ROMIO with us by sending e-mail
to
{
\tt
majordomo@mcs.anl.gov
}
with the message
{
\tt
subscribe romio-users
}
{
\noindent
This
}
will enable us to notify you of new releases of ROMIO
as well as bug fixes.
%
%
% REPORTING BUGS
% REPORTING BUGS
%
%
\section
{
Reporting Bugs
}
\section
{
Reporting Bugs
}
If you have trouble, first check the users guide. Then check if there
If you have trouble, first check the users guide. Then check if there
is a list of known bugs and patches on the ROMIO web page at
{
\tt
http://www.mcs.anl.gov/romio
}
.
is a list of known bugs and patches on the ROMIO web page at
{
\tt
Finally, if you still have problems, send a detailed message containing:
\\
http://www.mcs.anl.gov/romio
}
. Finally, if you still have problems, send a
detailed message containing:
\\
\hspace*
{
.2in
}$
\bullet
$
the type of system (often
{
\tt
uname -a
}
),
\\
\hspace*
{
.2in
}$
\bullet
$
the type of system (often
{
\tt
uname -a
}
),
\\
\hspace*
{
.2in
}$
\bullet
$
the output of
{
\tt
configure
}
,
\\
\hspace*
{
.2in
}$
\bullet
$
the output of
{
\tt
configure
}
,
\\
\hspace*
{
.2in
}$
\bullet
$
the output of
{
\tt
make
}
, and
\\
\hspace*
{
.2in
}$
\bullet
$
the output of
{
\tt
make
}
, and
\\
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment
