         NAME
              pnet_init - Initialize Pnet datatype

         SYNOPSIS
              #include <mpi.h>
              #include "pnet.h"

              Pnet *pnet_init(MPI_Comm comm, MPI_Datatype datatype, int nodes);

         DESCRIPTION
              The Pnet library is used for MPI parallelization of
              networks. The function has to be called after the
              initialization of MPI. The arguments of pnet_init are:

              comm MPI communicator

              datatype
                   MPI datatype network for data transfer

              nodes
                   Number of nodes in the network.

         RETURN VALUE
              Upon successful completion of pnet_init a pointer to
              allocated Pnet struct is returned and NULL in case of
              failure.

         AUTHOR
              Werner von Bloh (bloh@pik-potsdam.de)

         SEE ALSO
              pnet_free(3), pnet_setup(3), pnet_nodes(3)