Classes | Public Member Functions | List of all members
OFstreamCollator Class Reference

Threaded file writer. More...

Public Member Functions

 TypeName ("OFstreamCollator")
 
 OFstreamCollator (const off_t maxBufferSize)
 Construct from buffer size. 0 = do not use thread. More...
 
 OFstreamCollator (const off_t maxBufferSize, const label comm)
 Construct from buffer size (0 = do not use thread) and specified communicator. More...
 
virtual ~OFstreamCollator ()
 Destructor. More...
 
bool write (const word &objectType, const fileName &, const string &data, IOstreamOption streamOpt, IOstreamOption::atomicType atomic, IOstreamOption::appendType append, const bool useThread=true, const dictionary &headerEntries=dictionary::null)
 Write file with contents. More...
 
void waitAll ()
 Wait for all thread actions to have finished. More...
 

Detailed Description

Threaded file writer.

Collects all data from all processors and writes as single 'decomposedBlockData' file. The operation is determined by the buffer size (maxThreadFileBufferSize setting):

  • local size of data is larger than buffer: receive and write processor by processor (i.e. 'scheduled'). Does not use a thread, no file size limit.
  • total size of data is larger than buffer (but local is not): thread does all the collecting and writing of the processors. No file size limit.
  • total size of data is less than buffer: collecting is done locally; the thread only does the writing (since the data has already been collected)
Source files

Definition at line 66 of file OFstreamCollator.H.

Constructor & Destructor Documentation

◆ OFstreamCollator() [1/2]

OFstreamCollator ( const off_t  maxBufferSize)
explicit

Construct from buffer size. 0 = do not use thread.

Definition at line 281 of file OFstreamCollator.C.

◆ OFstreamCollator() [2/2]

OFstreamCollator ( const off_t  maxBufferSize,
const label  comm 
)

Construct from buffer size (0 = do not use thread) and specified communicator.

Definition at line 298 of file OFstreamCollator.C.

◆ ~OFstreamCollator()

~OFstreamCollator ( )
virtual

Destructor.

Definition at line 319 of file OFstreamCollator.C.

References Foam::ensightOutput::debug, Foam::endl(), UPstream::freeCommunicator(), and Foam::Pout.

Here is the call graph for this function:

Member Function Documentation

◆ TypeName()

TypeName ( "OFstreamCollator"  )

◆ write()

bool write ( const word &  objectType,
const fileName &  fName,
const string &  data,
IOstreamOption  streamOpt,
IOstreamOption::atomicType  atomic,
IOstreamOption::appendType  append,
const bool  useThread = true,
const dictionary &  headerEntries = dictionary::null 
)

Write file with contents.

Blocks until writethread has space available (total file sizes < maxBufferSize)

Definition at line 338 of file OFstreamCollator.C.

References Foam::abort(), append(), Pstream::broadcasts(), UList< T >::cdata(), Foam::ensightOutput::debug, Foam::endl(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, decomposedBlockData::gather(), UPstream::haveThreads(), UPstream::master(), Foam::max(), UPstream::msgType(), UPstream::nonBlocking, UPstream::nRequests(), string::null, Foam::Pout, autoPtr< T >::ptr(), UIPstream::read(), PtrList< T >::set(), PtrList< T >::setSize(), UList< T >::size(), UPtrList< T >::size(), UList< T >::size_bytes(), UPstream::waitRequests(), UOPstream::write(), and Foam::writeData().

Referenced by threadedCollatedOFstream::~threadedCollatedOFstream().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ waitAll()

void waitAll ( )

Wait for all thread actions to have finished.

Definition at line 583 of file OFstreamCollator.C.

References Foam::ensightOutput::debug, Foam::endl(), UPstream::master(), and Foam::Pout.

Here is the call graph for this function:
The documentation for this class was generated from the following files: