fileMonitor Class Reference

Checking for changes to files. More...

Collaboration diagram for fileMonitor:

Public Types

enum  fileState { UNMODIFIED = 0, MODIFIED = 1, DELETED = 2 }
 Enumeration defining the file state. More...
 

Public Member Functions

 ClassName ("fileMonitor")
 
 fileMonitor (const bool useInotify)
 Construct null. More...
 
 fileMonitor (const fileMonitor &)=delete
 Disallow default bitwise copy construction. More...
 
 ~fileMonitor ()
 Destructor. More...
 
label addWatch (const fileName &)
 Add file to watch. Return watch descriptor. More...
 
bool removeWatch (const label watchFd)
 Remove file to watch. Return true if successful. More...
 
const fileNamegetFile (const label watchFd) const
 Get name of file being watched. More...
 
fileState getState (const label watchFd) const
 Check state using handle. More...
 
void updateStates (const bool masterOnly, const bool syncPar) const
 Check state of all files. Updates state_. More...
 
void setUnmodified (const label watchFd)
 Reset state (e.g. after having read it) using handle. More...
 
void operator= (const fileMonitor &)=delete
 Disallow default bitwise assignment. More...
 

Static Public Attributes

static const NamedEnum< fileState, 3 > fileStateNames_
 

Detailed Description

Checking for changes to files.

Note
The default is to use stat to get the timestamp.

Compile with FOAM_USE_INOTIFY to use the inotify (Linux specific, since 2.6.13) framework. The problem is that inotify does not work on nfs3 mounted directories!!

Source files

Definition at line 61 of file fileMonitor.H.

Member Enumeration Documentation

◆ fileState

enum fileState

Enumeration defining the file state.

Enumerator
UNMODIFIED 
MODIFIED 
DELETED 

Definition at line 69 of file fileMonitor.H.

Constructor & Destructor Documentation

◆ fileMonitor() [1/2]

fileMonitor ( const bool  useInotify)

Construct null.

Definition at line 429 of file fileMonitor.C.

◆ fileMonitor() [2/2]

fileMonitor ( const fileMonitor )
delete

Disallow default bitwise copy construction.

◆ ~fileMonitor()

Destructor.

Definition at line 442 of file fileMonitor.C.

Member Function Documentation

◆ ClassName()

ClassName ( "fileMonitor"  )

◆ addWatch()

Foam::label addWatch ( const fileName fName)

Add file to watch. Return watch descriptor.

Definition at line 450 of file fileMonitor.C.

References Foam::endl(), Foam::Pout, DynamicList< T, SizeInc, SizeMult, SizeDiv >::setSize(), List< T >::size(), fileMonitor::UNMODIFIED, and WarningInFunction.

Referenced by fileOperation::addWatch().

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

◆ removeWatch()

bool removeWatch ( const label  watchFd)

Remove file to watch. Return true if successful.

Definition at line 489 of file fileMonitor.C.

References DynamicList< T, SizeInc, SizeMult, SizeDiv >::append(), Foam::endl(), and Foam::Pout.

Referenced by fileOperation::removeWatch().

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

◆ getFile()

const Foam::fileName & getFile ( const label  watchFd) const

Get name of file being watched.

Definition at line 502 of file fileMonitor.C.

Referenced by fileOperation::getFile().

Here is the caller graph for this function:

◆ getState()

Foam::fileMonitor::fileState getState ( const label  watchFd) const

Check state using handle.

Definition at line 508 of file fileMonitor.C.

References fileMonitor::updateStates().

Referenced by fileOperation::getState().

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

◆ updateStates()

void updateStates ( const bool  masterOnly,
const bool  syncPar 
) const

Check state of all files. Updates state_.

Definition at line 516 of file fileMonitor.C.

References Foam::endl(), forAll, Pstream::listCombineGather(), Pstream::listCombineScatter(), UPstream::master(), fileMonitor::MODIFIED, Foam::Pout, Foam::reduce(), Pstream::scatter(), List< T >::size(), and WarningInFunction.

Referenced by fileMonitor::getState(), and fileOperation::updateStates().

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

◆ setUnmodified()

void setUnmodified ( const label  watchFd)

Reset state (e.g. after having read it) using handle.

Definition at line 611 of file fileMonitor.C.

References Foam::highResLastModified(), and fileMonitor::UNMODIFIED.

Referenced by fileOperation::setUnmodified().

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

◆ operator=()

void operator= ( const fileMonitor )
delete

Disallow default bitwise assignment.

Member Data Documentation

◆ fileStateNames_

const Foam::NamedEnum< Foam::fileMonitor::fileState, 3 > fileStateNames_
static

Definition at line 76 of file fileMonitor.H.


The documentation for this class was generated from the following files: