petsc-3.14.6 2021-03-30
Report Typos and Errors

PetscBinarySynchronizedRead

Reads from a binary file.

Synopsis

PetscErrorCode  PetscBinarySynchronizedRead(MPI_Comm comm,int fd,void *data,PetscInt num,PetscInt *count,PetscDataType type)
Collective

Input Parameters

comm - the MPI communicator
fd - the file descriptor
num - the maximum number of items to read
type - the type of items to read (PETSC_INT, PETSC_REAL, PETSC_SCALAR, etc.)

Output Parameters

data - the buffer
count - the number of items read, optional

Notes

Does a PetscBinaryRead() followed by an MPI_Bcast()

If count is not provided and the number of items read is less than the maximum number of items to read, then this routine errors.

PetscBinarySynchronizedRead() uses byte swapping to work on all machines. Integers are stored on the file as 32 long, regardless of whether they are stored in the machine as 32 or 64, this means the same binary file may be read on any machine.

See Also

PetscBinaryWrite(), PetscBinaryOpen(), PetscBinaryClose(), PetscBinaryRead(), PetscBinarySynchronizedWrite(),
PetscBinarySynchronizedSeek()

Level

developer

Location

src/sys/fileio/sysio.c
Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages