ParallelIO

/******************************************************************************

 *

 * 

 *

 * Copyright (C) 2009 

 *

 * Permission to use, copy, modify, and distribute this software and its

 * documentation under the terms of the GNU General Public License is hereby 

 * granted. No representations are made about the suitability of this software 

 * for any purpose. It is provided "as is" without express or implied warranty.

 * See the GNU General Public License for more details.

 *

 * Documents produced by Doxygen are derivative works derived from the

 * input used in their production; they are not affected by this license.

 *

 */ /*! \page faq Frequently Asked Questions 

​

   Here is a list of frequently asked questions and their answers.

<dl>

<dt>How do I specify which tasks perform IO?  </dt>

    <dd>This is done in the call to \ref PIO_init which has two interfaces: init_intracom and init_intercom.  

  <ul><li> In the init_intracom interface, use the num_iotasks and stride variables to specify the total number of io tasks and the stride between them with respect to the mpi communicator, comp_comm, which is provided.  You can also use the optional base argument to shift the first IO task away from the first computational task, this is often desirable because the applications first computational task often has higher memory requirements than other tasks.   IO tasks are a subset of the tasks defined in comp_comm.

<li> In the init_intercom interface, IO tasks are a disjoint set of tasks from those in the computational communicator.  <b>This interface is still experimental and not recommended for production use at this time. </b>

</ul>

Note that num_iotasks is the maximum number of IO tasks to use for an IO operation.   The size of the field being read or written along with the tunable blocksize parameter, \ref PIO_set_blocksize, determines the actual number of tasks used for a given IO operation.

</dd>

<dt>How do I test if PIO is installed and working correctly? </dt> 

    <dd>The PIO Library distribution contains a testpio subdirectory with a number of programs to test the PIO library. Please see the \ref examp page for details. </dd>

​

</dl>

*/