9.4.2. Data Access with Explicit Offsets



Up: Data Access Next: Data Access with Individual File Pointers Previous: Data Access Conventions
If MPI_MODE_SEQUENTIAL mode was specified when the file was opened, it is erroneous to call the routines in this section.
 
      
      
      
      
      
     MPI_FILE_READ_AT(fh, offset, buf, count, datatype, status)  
      
 
 
[  IN   fh] file handle (handle)  
  
 
 
[  IN   offset] file offset (integer)  
 
 
[  OUT   buf] initial address of buffer (choice)  
 
 
[  IN   count] number of elements in buffer (integer)  
 
 
[  IN   datatype] datatype of each buffer element (handle)  
 
 
[  OUT   status] status object (Status)  
 
  
 
  int MPI_File_read_at(MPI_File fh, MPI_Offset offset, void *buf, int count, MPI_Datatype datatype, MPI_Status *status) 
  
  MPI_FILE_READ_AT(FH, OFFSET, BUF, COUNT, DATATYPE, STATUS, IERROR)
 <type> BUF(*) 
INTEGER FH, COUNT, DATATYPE, STATUS(MPI_STATUS_SIZE), IERROR 
INTEGER(KIND=MPI_OFFSET_KIND) OFFSET 
  
  void MPI::File::Read_at(MPI::Offset offset, void* buf, int count, const MPI::Datatype& datatype, MPI::Status& status) 
  
  void MPI::File::Read_at(MPI::Offset offset, void* buf, int count, const MPI::Datatype& datatype) 
  
MPI_FILE_READ_AT reads a file beginning at the position specified by offset.
 
      
      
      
      
      
     MPI_FILE_READ_AT_ALL(fh, offset, buf, count, datatype, status)  
     
 
[  IN   fh] file handle (handle)  
 
 
[  IN   offset] file offset (integer)  
 
 
[  OUT   buf] initial address of buffer (choice)  
 
 
[  IN   count] number of elements in buffer (integer)  
 
 
[  IN   datatype] datatype of each buffer element (handle)  
 
 
[  OUT   status] status object (Status)  
 
  
 
  int MPI_File_read_at_all(MPI_File fh, MPI_Offset offset, void *buf, int count, MPI_Datatype datatype, MPI_Status *status) 
             
  MPI_FILE_READ_AT_ALL(FH, OFFSET, BUF, COUNT, DATATYPE, STATUS, IERROR)
 <type> BUF(*) 
INTEGER FH, COUNT, DATATYPE, STATUS(MPI_STATUS_SIZE), IERROR 
INTEGER(KIND=MPI_OFFSET_KIND) OFFSET 
  
  void MPI::File::Read_at_all(MPI::Offset offset, void* buf, int count, const MPI::Datatype& datatype, MPI::Status& status) 
  
  void MPI::File::Read_at_all(MPI::Offset offset, void* buf, int count, const MPI::Datatype& datatype) 
  
MPI_FILE_READ_AT_ALL is a collective version of the blocking MPI_FILE_READ_AT interface.
 
      
      
      
      
      
     MPI_FILE_WRITE_AT(fh, offset, buf, count, datatype, status)  
     
 
[  INOUT   fh] file handle (handle)  
 
 
[  IN   offset] file offset (integer)  
 
 
[  IN   buf] initial address of buffer (choice)  
 
 
[  IN   count] number of elements in buffer (integer)  
 
 
[  IN   datatype] datatype of each buffer element (handle)  
 
 
[  OUT   status] status object (Status)  
 
  
 
  int MPI_File_write_at(MPI_File fh, MPI_Offset offset, void *buf, int count, MPI_Datatype datatype, MPI_Status *status) 
  
  MPI_FILE_WRITE_AT(FH, OFFSET, BUF, COUNT, DATATYPE, STATUS, IERROR)
 <type> BUF(*) 
INTEGER FH, COUNT, DATATYPE, STATUS(MPI_STATUS_SIZE), IERROR 
INTEGER(KIND=MPI_OFFSET_KIND) OFFSET 
  
  void MPI::File::Write_at(MPI::Offset offset, const void* buf, int count, const MPI::Datatype& datatype, MPI::Status& status) 
  
  void MPI::File::Write_at(MPI::Offset offset, const void* buf, int count, const MPI::Datatype& datatype) 
  
MPI_FILE_WRITE_AT writes a file beginning at the position specified by offset.
 
      
      
      
      
      
     MPI_FILE_WRITE_AT_ALL(fh, offset, buf, count, datatype, status)  
     
 
[  INOUT   fh] file handle (handle)  
 
 
[  IN   offset] file offset (integer)  
 
 
[  IN   buf] initial address of buffer (choice)  
 
 
[  IN   count] number of elements in buffer (integer)  
 
 
[  IN   datatype] datatype of each buffer element (handle)  
 
 
[  OUT   status] status object (Status)  
 
  
 
  int MPI_File_write_at_all(MPI_File fh, MPI_Offset offset, void *buf, int count, MPI_Datatype datatype, MPI_Status *status) 
            
  MPI_FILE_WRITE_AT_ALL(FH, OFFSET, BUF, COUNT, DATATYPE, STATUS, IERROR)
 <type> BUF(*) 
INTEGER FH, COUNT, DATATYPE, STATUS(MPI_STATUS_SIZE), IERROR 
INTEGER(KIND=MPI_OFFSET_KIND) OFFSET 
      
  void MPI::File::Write_at_all(MPI::Offset offset, const void* buf, int count, const MPI::Datatype& datatype, MPI::Status& status) 
  
  void MPI::File::Write_at_all(MPI::Offset offset, const void* buf, int count, const MPI::Datatype& datatype) 
  
MPI_FILE_WRITE_AT_ALL is a collective version of the blocking MPI_FILE_WRITE_AT interface.
 
      
      
      
      
      
     MPI_FILE_IREAD_AT(fh, offset, buf, count, datatype, request)  
      
 
 
[  IN   fh] file handle (handle)  
  
 
 
[  IN   offset] file offset (integer)  
 
 
[  OUT   buf] initial address of buffer (choice)  
 
 
[  IN   count] number of elements in buffer (integer)  
 
 
[  IN   datatype] datatype of each buffer element (handle)  
 
 
[  OUT   request] request object (handle)  
 
  
 
  int MPI_File_iread_at(MPI_File fh, MPI_Offset offset, void *buf, int count, MPI_Datatype datatype, MPI_Request *request) 
  
  MPI_FILE_IREAD_AT(FH, OFFSET, BUF, COUNT, DATATYPE, REQUEST, IERROR)
 <type> BUF(*) 
INTEGER FH, COUNT, DATATYPE, REQUEST, IERROR 
INTEGER(KIND=MPI_OFFSET_KIND) OFFSET 
  
  MPI::Request MPI::File::Iread_at(MPI::Offset offset, void* buf, int count, const MPI::Datatype& datatype) 
  
MPI_FILE_IREAD_AT is a nonblocking version of the MPI_FILE_READ_AT interface.
 
      
      
      
      
      
     MPI_FILE_IWRITE_AT(fh, offset, buf, count, datatype, request)  
     
 
[  INOUT   fh] file handle (handle)  
 
 
[  IN   offset] file offset (integer)  
 
 
[  IN   buf] initial address of buffer (choice)  
 
 
[  IN   count] number of elements in buffer (integer)  
 
 
[  IN   datatype] datatype of each buffer element (handle)  
 
 
[  OUT   request] request object (handle)  
 
  
 
  int MPI_File_iwrite_at(MPI_File fh, MPI_Offset offset, void *buf, int count, MPI_Datatype datatype, MPI_Request *request) 
  
  MPI_FILE_IWRITE_AT(FH, OFFSET, BUF, COUNT, DATATYPE, REQUEST, IERROR)
 <type>  BUF(*) 
INTEGER FH, COUNT, DATATYPE, REQUEST, IERROR 
INTEGER(KIND=MPI_OFFSET_KIND) OFFSET 
  
  MPI::Request MPI::File::Iwrite_at(MPI::Offset offset, const void* buf, int count, const MPI::Datatype& datatype) 
  
MPI_FILE_IWRITE_AT is a nonblocking version of the MPI_FILE_WRITE_AT interface.



Up: Data Access Next: Data Access with Individual File Pointers Previous: Data Access Conventions
Return to MPI-2 Standard Index
MPI-2.0 of July 18, 1997
HTML Generated on August 11, 1997
