An encapsulation of filesystem-related operations. More...

Inheritance diagram for fileOperation:

Collaboration diagram for fileOperation:

Public Types
enum	pathType { NOTFOUND, ABSOLUTE, OBJECT, WRITEOBJECT, PROCUNCOLLATED, PROCBASEOBJECT, PROCOBJECT, PARENTOBJECT, FINDINSTANCE, PROCUNCOLLATEDINSTANCE, PROCBASEINSTANCE, PROCINSTANCE }
	Enumeration for the location of an IOobject. More...

typedef Tuple2< fileName, Tuple2< pathType, label > >	dirIndex

typedef List< dirIndex >	dirIndexList

Public Member Functions
	TypeName ("fileOperation")
	Runtime type information. More...

	fileOperation (const label comm)
	Construct from communicator. More...

	declareRunTimeSelectionTable (autoPtr, fileOperation, word,(bool verbose),(verbose))

virtual	~fileOperation ()=default
	Destructor. More...

virtual bool	mkDir (const fileName &, mode_t=0777) const =0
	Make directory. More...

virtual bool	chMod (const fileName &, const mode_t) const =0
	Set the file mode. More...

virtual mode_t	mode (const fileName &, const bool followLink=true) const =0
	Return the file mode. More...

virtual fileName::Type	type (const fileName &, const bool followLink=true) const =0
	Return the file type: DIRECTORY, FILE or LINK. More...

virtual bool	exists (const fileName &, const bool checkGzip=true, const bool followLink=true) const =0
	Does the name exist (as DIRECTORY or FILE) in the file system? More...

virtual bool	isDir (const fileName &, const bool followLink=true) const =0
	Does the name exist as a DIRECTORY in the file system? More...

virtual bool	isFile (const fileName &, const bool checkGzip=true, const bool followLink=true) const =0
	Does the name exist as a FILE in the file system? More...

virtual off_t	fileSize (const fileName &, const bool followLink=true) const =0
	Return size of file. More...

virtual time_t	lastModified (const fileName &, const bool followLink=true) const =0
	Return time of last file modification. More...

virtual double	highResLastModified (const fileName &, const bool followLink=true) const =0
	Return time of last file modification. More...

virtual fileNameList	readDir (const fileName &, const fileName::Type=fileName::FILE, const bool filtergz=true, const bool followLink=true) const =0
	Read a directory and return the entries as a string list. More...

virtual bool	cp (const fileName &src, const fileName &dst, const bool followLink=true) const =0
	Copy, recursively if necessary, the source to the destination. More...

virtual bool	ln (const fileName &src, const fileName &dst) const =0
	Create a softlink. dst should not exist. Returns true if. More...

virtual bool	mv (const fileName &src, const fileName &dst, const bool followLink=false) const =0
	Rename src to dst. More...

virtual bool	mvBak (const fileName &, const std::string &ext="bak") const =0
	Rename to a corresponding backup file. More...

virtual bool	rm (const fileName &) const =0
	Remove a file, returning true if successful otherwise false. More...

virtual bool	rmDir (const fileName &dir, const bool silent=false) const =0
	Remove a directory and its contents. More...

virtual fileName	objectPath (const IOobject &io, const word &typeName) const
	Generate disk file name for object. Opposite of filePath. More...

virtual fileName	filePath (const bool checkGlobal, const IOobject &, const word &typeName, const bool search=true) const =0
	Search for an object. checkGlobal : also check undecomposed case. More...

virtual fileName	dirPath (const bool checkGlobal, const IOobject &io, const bool search=true) const =0
	Search for a directory. checkGlobal : also check undecomposed. More...

virtual fileNameList	readObjects (const objectRegistry &db, const fileName &instance, const fileName &local, word &newInstance) const
	Search directory for objects. Used in IOobjectList. More...

virtual bool	readHeader (IOobject &, const fileName &, const word &typeName) const =0
	Read object header from supplied file. More...

virtual autoPtr< ISstream >	readStream (regIOobject &, const fileName &, const word &typeName, const bool valid=true) const =0
	Reads header for regIOobject and returns an ISstream. More...

virtual bool	read (regIOobject &, const bool masterOnly, const IOstream::streamFormat format, const word &typeName) const =0
	Top-level read. More...

virtual bool	writeObject (const regIOobject &, IOstream::streamFormat format=IOstream::ASCII, IOstream::versionNumber version=IOstream::currentVersion, IOstream::compressionType compression=IOstream::UNCOMPRESSED, const bool valid=true) const
	Writes a regIOobject (so header, contents and divider). More...

virtual fileName	filePath (const fileName &) const
	Search for a file or directory. Use IOobject version in. More...

virtual autoPtr< ISstream >	NewIFstream (const fileName &) const =0
	Generate an ISstream that reads a file. More...

virtual autoPtr< Ostream >	NewOFstream (const fileName &pathname, IOstream::streamFormat format=IOstream::ASCII, IOstream::versionNumber version=IOstream::currentVersion, IOstream::compressionType compression=IOstream::UNCOMPRESSED, const bool valid=true) const =0
	Generate an Ostream that writes a file. More...

virtual label	addWatch (const fileName &) const
	Add watching of a file. Returns handle. More...

virtual bool	removeWatch (const label) const
	Remove watch on a file (using handle) More...

virtual label	findWatch (const labelList &watchIndices, const fileName &) const
	Find index (or -1) of file in list of handles. More...

virtual void	addWatches (regIOobject &, const fileNameList &) const
	Helper: add watches for list of regIOobjects. More...

virtual fileName	getFile (const label) const
	Get name of file being watched (using handle) More...

virtual void	updateStates (const bool masterOnly, const bool syncPar) const
	Update state of all files. More...

virtual fileMonitor::fileState	getState (const label) const
	Get current state of file (using handle) More...

virtual void	setUnmodified (const label) const
	Set current state of file (using handle) to unmodified. More...

virtual word	processorsDir (const IOobject &io) const
	Actual name of processors dir (for use in mode PROCOBJECT,. More...

virtual word	processorsDir (const fileName &) const
	Actual name of processors dir (for use in mode PROCOBJECT,. More...

virtual void	setNProcs (const label nProcs)
	Set number of processor directories/results. Only used in. More...

virtual label	nProcs (const fileName &dir, const fileName &local="") const
	Get number of processor directories/results. Used for e.g. More...

virtual instantList	findTimes (const fileName &, const word &) const
	Get sorted list of times. More...

virtual IOobject	findInstance (const IOobject &io, const scalar startValue, const word &stopInstance) const
	Find instance where IOobject is. Fails if cannot be found. More...

virtual void	setTime (const Time &) const
	Callback for time change. More...

virtual void	flush () const
	Forcibly wait until all output done. Flush any cached data. More...

fileName	processorsCasePath (const IOobject &, const word &procDir) const
	Generate path (like io.path) from root+casename with any. More...

fileName	processorsPath (const IOobject &, const word &instance, const word &procDir) const
	Generate path (like io.path) with provided instance and any. More...

fileName	processorsPath (const fileName &, const word &procDir) const
	Operating on fileName: replace processorXXX with procDir. More...

Static Public Member Functions
static autoPtr< fileOperation >	New (const word &handlerType, bool verbose=false)
	Select fileHandler-type. More...

static label	splitProcessorPath (const fileName &, fileName &path, fileName &procDir, fileName &local, label &groupStart, label &groupSize, label &nProcs)
	Split fileName into part before 'processor' and part after. More...

static label	detectProcessorPath (const fileName &)
	Detect processor number from '/aa/bb/processorDDD/cc'. More...

Static Public Attributes
static const Enum< pathType >	pathTypeNames_

static word	processorsBaseDir = "processors"
	Return the processors directory name (usually "processors") More...

static word	defaultFileHandler
	Default fileHandler. More...

static autoPtr< fileOperation >	fileHandlerPtr_
	Static fileOperation. More...

Protected Member Functions
fileMonitor &	monitor () const

tmpNrc< dirIndexList >	lookupAndCacheProcessorsPath (const fileName &, const bool syncPar) const
	Lookup name of processorsDDD using cache. Return empty fileName. More...

virtual tmpNrc< dirIndexList >	lookupProcessorsPath (const fileName &) const
	Lookup name of processorsDDD using cache. Return empty fileName. More...

bool	exists (IOobject &io) const
	Does ioobject exist. Is either a directory (empty name()) or. More...

Static Protected Member Functions
static instantList	sortTimes (const fileNameList &, const word &)
	Sort directory entries according to time value. More...

static void	mergeTimes (const instantList &extraTimes, const word &constantName, instantList &times)
	Merge two times. More...

static bool	isFileOrDir (const bool isFile, const fileName &)
	Helper: check for file (isFile) or directory (!isFile) More...

Protected Attributes
const label	comm_
	Communicator to use. More...

HashTable< dirIndexList >	procsDirs_
	Detected processors directories. More...

autoPtr< fileMonitor >	monitorPtr_
	file-change monitor for all registered files More...

Detailed Description

An encapsulation of filesystem-related operations.

Definition at line 75 of file fileOperation.H.

Member Typedef Documentation

◆ dirIndex

typedef Tuple2<fileName, Tuple2<pathType, label> > dirIndex

Definition at line 99 of file fileOperation.H.

◆ dirIndexList

typedef List<dirIndex> dirIndexList

Definition at line 100 of file fileOperation.H.

Member Enumeration Documentation

◆ pathType

enum pathType

Enumeration for the location of an IOobject.

Enumerator
NOTFOUND
ABSOLUTE
OBJECT
WRITEOBJECT
PROCUNCOLLATED
PROCBASEOBJECT
PROCOBJECT
PARENTOBJECT
FINDINSTANCE
PROCUNCOLLATEDINSTANCE
PROCBASEINSTANCE
PROCINSTANCE

Definition at line 80 of file fileOperation.H.

Constructor & Destructor Documentation

◆ fileOperation()

fileOperation ( const label comm )

explicit

Construct from communicator.

Definition at line 421 of file fileOperation.C.

◆ ~fileOperation()

virtual ~fileOperation ( )

virtualdefault

Destructor.

Member Function Documentation

◆ monitor()

Foam::fileMonitor & monitor ( ) const

protected

Definition at line 84 of file fileOperation.C.

References IOobject::fileModificationChecking, IOobject::inotify, IOobject::inotifyMaster, and fileOperation::monitorPtr_.

◆ sortTimes()

Foam::instantList sortTimes	(	const fileNameList &	dirEntries,
		const word &	constantName
	)

staticprotected

Sort directory entries according to time value.

Definition at line 102 of file fileOperation.C.

References Foam::less(), and Foam::sort().

Here is the call graph for this function:

◆ mergeTimes()

void mergeTimes	(	const instantList &	extraTimes,
		const word &	constantName,
		instantList &	times
	)

staticprotected

Merge two times.

Definition at line 157 of file fileOperation.C.

References forAll, Foam::less(), Foam::name(), List< T >::setSize(), Foam::sort(), and List< T >::transfer().

Here is the call graph for this function:

◆ isFileOrDir()

bool isFileOrDir	(	const bool	isFile,
		const fileName &	f
	)

staticprotected

Helper: check for file (isFile) or directory (!isFile)

Definition at line 230 of file fileOperation.C.

References f(), Foam::isDir(), and Foam::isFile().

Here is the call graph for this function:

◆ lookupAndCacheProcessorsPath()

Foam::tmpNrc< Foam::fileOperation::dirIndexList > lookupAndCacheProcessorsPath	(	const fileName &	fName,
		const bool	syncPar
	)		const

protected

Lookup name of processorsDDD using cache. Return empty fileName.

if not found.

Definition at line 238 of file fileOperation.C.

References DynamicList< T, SizeMin >::append(), Foam::expressions::patchExpr::debug, Foam::endl(), forAll, Foam::max(), UPstream::parRun(), path(), Foam::Pout, Foam::readDir(), Foam::returnReduce(), rp(), and fileOperation::setNProcs().

Here is the call graph for this function:

◆ lookupProcessorsPath()

Foam::tmpNrc< Foam::fileOperation::dirIndexList > lookupProcessorsPath ( const fileName & fName ) const

protectedvirtual

Lookup name of processorsDDD using cache. Return empty fileName.

if not found. To be called on all processors

Reimplemented in uncollatedFileOperation.

Definition at line 369 of file fileOperation.C.

◆ exists() [1/2]

bool exists ( IOobject & io ) const

protected

Does ioobject exist. Is either a directory (empty name()) or.

a file

Definition at line 376 of file fileOperation.C.

References Foam::isDir(), Foam::isFile(), IOobject::name(), word::null, IOobject::objectPath(), and IOobject::typeHeaderOk().

Referenced by Time::setControls().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TypeName()

TypeName ( "fileOperation" )

Runtime type information.

◆ declareRunTimeSelectionTable()

declareRunTimeSelectionTable	(	autoPtr	,
		fileOperation	,
		word	,
		(bool verbose)	,
		(verbose)
	)

◆ New()

Foam::autoPtr< Foam::fileOperation > New	(	const word &	handlerType,
		bool	verbose = `false`
	)

static

Select fileHandler-type.

Definition at line 428 of file fileOperation.C.

References Foam::abort(), DebugInFunction, Foam::endl(), Foam::FatalError, and FatalErrorInLookup.

Referenced by Foam::fileHandler(), argList::parse(), and Time::readDict().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ mkDir()

virtual bool mkDir	(	const fileName &	,
		mode_t	= `0777`
	)		const

pure virtual

Make directory.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ chMod()

virtual bool chMod	(	const fileName &	,
		const	mode_t
	)		const

pure virtual

Set the file mode.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ mode()

virtual mode_t mode	(	const fileName &	,
		const bool	followLink = `true`
	)		const

pure virtual

Return the file mode.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ type()

virtual fileName::Type type	(	const fileName &	,
		const bool	followLink = `true`
	)		const

pure virtual

Return the file type: DIRECTORY, FILE or LINK.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

Referenced by Foam::fileHandler(), and Time::readDict().

Here is the caller graph for this function:

◆ exists() [2/2]

virtual bool exists	(	const fileName &	,
		const bool	checkGzip = `true`,
		const bool	followLink = `true`
	)		const

pure virtual

Does the name exist (as DIRECTORY or FILE) in the file system?

Optionally enable/disable check for gzip file.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ isDir()

virtual bool isDir	(	const fileName &	,
		const bool	followLink = `true`
	)		const

pure virtual

Does the name exist as a DIRECTORY in the file system?

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ isFile()

virtual bool isFile	(	const fileName &	,
		const bool	checkGzip = `true`,
		const bool	followLink = `true`
	)		const

pure virtual

Does the name exist as a FILE in the file system?

Optionally enable/disable check for gzip file.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ fileSize()

virtual off_t fileSize	(	const fileName &	,
		const bool	followLink = `true`
	)		const

pure virtual

Return size of file.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ lastModified()

virtual time_t lastModified	(	const fileName &	,
		const bool	followLink = `true`
	)		const

pure virtual

Return time of last file modification.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ highResLastModified()

virtual double highResLastModified	(	const fileName &	,
		const bool	followLink = `true`
	)		const

pure virtual

Return time of last file modification.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ readDir()

virtual fileNameList readDir	(	const fileName &	,
		const fileName::Type	= `fileName::FILE`,
		const bool	filtergz = `true`,
		const bool	followLink = `true`
	)		const

pure virtual

Read a directory and return the entries as a string list.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ cp()

virtual bool cp	(	const fileName &	src,
		const fileName &	dst,
		const bool	followLink = `true`
	)		const

pure virtual

Copy, recursively if necessary, the source to the destination.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ ln()

virtual bool ln	(	const fileName &	src,
		const fileName &	dst
	)		const

pure virtual

Create a softlink. dst should not exist. Returns true if.

successful.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ mv()

virtual bool mv	(	const fileName &	src,
		const fileName &	dst,
		const bool	followLink = `false`
	)		const

pure virtual

Rename src to dst.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ mvBak()

virtual bool mvBak	(	const fileName &	,
		const std::string &	ext = `"bak"`
	)		const

pure virtual

Rename to a corresponding backup file.

If the backup file already exists, attempt with "01" .. "99" suffix

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ rm()

virtual bool rm ( const fileName & ) const

pure virtual

Remove a file, returning true if successful otherwise false.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ rmDir()

virtual bool rmDir	(	const fileName &	dir,
		const bool	silent = `false`
	)		const

pure virtual

Remove a directory and its contents.

Parameters

silent do not report missing directory

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

Referenced by Time::writeObject().

Here is the caller graph for this function:

◆ objectPath()

Foam::fileName objectPath	(	const IOobject &	io,
		const word &	typeName
	)		const

virtual

Generate disk file name for object. Opposite of filePath.

Optional wanted typeName.

Reimplemented in collatedFileOperation.

Definition at line 455 of file fileOperation.C.

References IOobject::objectPath().

Here is the call graph for this function:

◆ filePath() [1/2]

virtual fileName filePath	(	const bool	checkGlobal,
		const IOobject &	,
		const word &	typeName,
		const bool	search = `true`
	)		const

pure virtual

Search for an object. checkGlobal : also check undecomposed case.

Optional wanted typeName.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

Referenced by IOobject::globalFilePath(), IOobject::localFilePath(), and triSurfaceMesh::relativeFilePath().

Here is the caller graph for this function:

◆ dirPath()

virtual fileName dirPath	(	const bool	checkGlobal,
		const IOobject &	io,
		const bool	search = `true`
	)		const

pure virtual

Search for a directory. checkGlobal : also check undecomposed.

case

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ readObjects()

Foam::fileNameList readObjects	(	const objectRegistry &	db,
		const fileName &	instance,
		const fileName &	local,
		word &	newInstance
	)		const

virtual

Search directory for objects. Used in IOobjectList.

Reimplemented in masterUncollatedFileOperation, and uncollatedFileOperation.

Definition at line 882 of file fileOperation.C.

References objectRegistry::dbDir(), Foam::expressions::patchExpr::debug, Foam::endl(), fileName::FILE, Foam::isDir(), word::null, IOobject::objectPath(), path(), IOobject::path(), Foam::Pout, and Foam::readDir().

Referenced by IOobjectList::IOobjectList(), and masterUncollatedFileOperation::readObjects().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ readHeader()

virtual bool readHeader	(	IOobject &	,
		const fileName &	,
		const word &	typeName
	)		const

pure virtual

Read object header from supplied file.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

Referenced by regIOobject::headerOk(), and IOobject::typeHeaderOk().

Here is the caller graph for this function:

◆ readStream()

virtual autoPtr<ISstream> readStream	(	regIOobject &	,
		const fileName &	,
		const word &	typeName,
		const bool	valid = `true`
	)		const

pure virtual

Reads header for regIOobject and returns an ISstream.

to read the contents.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ read()

virtual bool read	(	regIOobject &	,
		const bool	masterOnly,
		const IOstream::streamFormat	format,
		const word &	typeName
	)		const

pure virtual

Top-level read.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

Referenced by regIOobject::read(), and regIOobject::readHeaderOk().

Here is the caller graph for this function:

◆ writeObject()

bool writeObject	(	const regIOobject &	io,
		IOstream::streamFormat	format = `IOstream::ASCII`,
		IOstream::versionNumber	version = `IOstream::currentVersion`,
		IOstream::compressionType	compression = `IOstream::UNCOMPRESSED`,
		const bool	valid = `true`
	)		const

virtual

Writes a regIOobject (so header, contents and divider).

Returns success state. Default action is to write to the objectPath using writeData. If !valid the file does not need to be written (this is used e.g. to suppress empty local lagrangian data)

Reimplemented in masterUncollatedFileOperation, and collatedFileOperation.

Definition at line 465 of file fileOperation.C.

References IOstream::good(), Foam::mkDir(), IOobject::objectPath(), regIOobject::writeData(), IOobject::writeEndDivider(), and IOobject::writeHeader().

Referenced by regIOobject::writeObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ filePath() [2/2]

Foam::fileName filePath ( const fileName & fName ) const

virtual

Search for a file or directory. Use IOobject version in.

preference

Definition at line 520 of file fileOperation.C.

References Foam::expressions::patchExpr::debug, Foam::endl(), Foam::exists(), forAll, fileName::null, path(), Foam::Pout, and WarningInFunction.

Here is the call graph for this function:

◆ NewIFstream()

virtual autoPtr<ISstream> NewIFstream ( const fileName & ) const

pure virtual

Generate an ISstream that reads a file.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

Referenced by openFoamTableReader< Type >::operator()().

Here is the caller graph for this function:

◆ NewOFstream()

virtual autoPtr<Ostream> NewOFstream	(	const fileName &	pathname,
		IOstream::streamFormat	format = `IOstream::ASCII`,
		IOstream::versionNumber	version = `IOstream::currentVersion`,
		IOstream::compressionType	compression = `IOstream::UNCOMPRESSED`,
		const bool	valid = `true`
	)		const

pure virtual

Generate an Ostream that writes a file.

Implemented in masterUncollatedFileOperation, and uncollatedFileOperation.

◆ addWatch()

Foam::label addWatch ( const fileName & fName ) const

virtual

Add watching of a file. Returns handle.

Reimplemented in masterUncollatedFileOperation.

Definition at line 579 of file fileOperation.C.

◆ removeWatch()

bool removeWatch ( const label watchIndex ) const

virtual

Remove watch on a file (using handle)

Reimplemented in masterUncollatedFileOperation.

Definition at line 585 of file fileOperation.C.

Referenced by regIOobject::addWatch(), regIOobject::checkOut(), regIOobject::read(), Time::readDict(), and Time::~Time().

Here is the caller graph for this function:

◆ findWatch()

Foam::label findWatch	(	const labelList &	watchIndices,
		const fileName &	fName
	)		const

virtual

Find index (or -1) of file in list of handles.

Reimplemented in masterUncollatedFileOperation.

Definition at line 592 of file fileOperation.C.

References forAll.

Referenced by regIOobject::addWatch().

Here is the caller graph for this function:

◆ addWatches()

void addWatches	(	regIOobject &	rio,
		const fileNameList &	files
	)		const

virtual

Helper: add watches for list of regIOobjects.

Reimplemented in masterUncollatedFileOperation.

Definition at line 609 of file fileOperation.C.

References DynamicList< T, SizeMin >::append(), HashTable< T, Key, Hash >::erase(), f(), and regIOobject::watchIndices().

Referenced by Time::read(), Time::readDict(), Time::readModifiedObjects(), and Time::setMonitoring().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFile()

Foam::fileName getFile ( const label watchIndex ) const

virtual

Get name of file being watched (using handle)

Reimplemented in masterUncollatedFileOperation.

Definition at line 645 of file fileOperation.C.

Referenced by regIOobject::addWatch(), regIOobject::read(), Time::readDict(), and regIOobject::readIfModified().

Here is the caller graph for this function:

◆ updateStates()

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

virtual

Update state of all files.

Reimplemented in masterUncollatedFileOperation.

Definition at line 652 of file fileOperation.C.

References UPstream::parRun().

Referenced by Time::readModifiedObjects().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getState()

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

virtual

Get current state of file (using handle)

Reimplemented in masterUncollatedFileOperation.

Definition at line 662 of file fileOperation.C.

◆ setUnmodified()

void setUnmodified ( const label watchFd ) const

virtual

Set current state of file (using handle) to unmodified.

Reimplemented in masterUncollatedFileOperation.

Definition at line 670 of file fileOperation.C.

Referenced by regIOobject::writeObject().

Here is the caller graph for this function:

◆ processorsDir() [1/2]

virtual word processorsDir ( const IOobject & io ) const

inlinevirtual

Actual name of processors dir (for use in mode PROCOBJECT,.

PROCINSTANCE)

Reimplemented in collatedFileOperation.

Definition at line 477 of file fileOperation.H.

◆ processorsDir() [2/2]

virtual word processorsDir ( const fileName & ) const

inlinevirtual

Actual name of processors dir (for use in mode PROCOBJECT,.

PROCINSTANCE)

Reimplemented in collatedFileOperation.

Definition at line 484 of file fileOperation.H.

◆ setNProcs()

void setNProcs ( const label nProcs )

virtual

Set number of processor directories/results. Only used in.

decomposePar

Reimplemented in collatedFileOperation.

Definition at line 921 of file fileOperation.C.

Referenced by fileOperation::lookupAndCacheProcessorsPath().

Here is the caller graph for this function:

◆ nProcs()

Foam::label nProcs	(	const fileName &	dir,
		const fileName &	local = `""`
	)		const

virtual

Get number of processor directories/results. Used for e.g.

reconstructPar, argList checking

Definition at line 926 of file fileOperation.C.

References Foam::endl(), forAll, Foam::isDir(), Foam::isFile(), UPstream::master(), Foam::max(), polyMesh::meshSubDir, UPstream::msgType(), n, decomposedBlockData::numBlocks(), path(), Foam::readDir(), Pstream::scatter(), Foam::start, and WarningInFunction.

Here is the call graph for this function:

◆ findTimes()

Foam::instantList findTimes	(	const fileName &	directory,
		const word &	constantName
	)		const

virtual

Get sorted list of times.

Reimplemented in masterUncollatedFileOperation.

Definition at line 677 of file fileOperation.C.

References Foam::expressions::patchExpr::debug, fileName::DIRECTORY, Foam::endl(), forAll, Foam::Pout, and Foam::readDir().

Referenced by TimePaths::findTimes(), masterUncollatedFileOperation::findTimes(), and masterUncollatedFileOperation::readObjects().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findInstance()

Foam::IOobject findInstance	(	const IOobject &	io,
		const scalar	startValue,
		const word &	stopInstance
	)		const

virtual

Find instance where IOobject is. Fails if cannot be found.

and readOpt() is MUST_READ/MUST_READ_IF_MODIFIED. Otherwise returns stopInstance.

Reimplemented in masterUncollatedFileOperation.

Definition at line 735 of file fileOperation.C.

References TimePaths::constant(), DebugInFunction, Foam::endl(), Foam::exists(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, IOobject::instance(), IOobject::local(), IOobject::MUST_READ, IOobject::MUST_READ_IF_MODIFIED, IOobject::name(), IOobject::readOpt(), IOobject::time(), and TimePaths::times().

Here is the call graph for this function:

◆ setTime()

virtual void setTime ( const Time & ) const

inlinevirtual

Callback for time change.

Reimplemented in masterUncollatedFileOperation.

Definition at line 515 of file fileOperation.H.

Referenced by Time::setTime(), and masterUncollatedFileOperation::setTime().

Here is the caller graph for this function:

◆ flush()

void flush ( ) const

virtual

Forcibly wait until all output done. Flush any cached data.

Reimplemented in masterUncollatedFileOperation, and collatedFileOperation.

Definition at line 988 of file fileOperation.C.

References Foam::expressions::patchExpr::debug, Foam::endl(), and Foam::Pout.

Referenced by masterUncollatedFileOperation::flush().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ processorsCasePath()

Foam::fileName processorsCasePath	(	const IOobject &	io,
		const word &	procDir
	)		const

Generate path (like io.path) from root+casename with any.

'processorXXX' replaced by procDir (usually 'processsors')

Definition at line 1000 of file fileOperation.C.

References TimePaths::globalCaseName(), IOobject::rootPath(), and IOobject::time().

Here is the call graph for this function:

◆ processorsPath() [1/2]

Foam::fileName processorsPath	(	const IOobject &	io,
		const word &	instance,
		const word &	procDir
	)		const

Generate path (like io.path) with provided instance and any.

'processorXXX' replaced by procDir (usually 'processsors')

Definition at line 1010 of file fileOperation.C.

References IOobject::db(), objectRegistry::dbDir(), and IOobject::local().

Here is the call graph for this function:

◆ processorsPath() [2/2]

Foam::fileName processorsPath	(	const fileName &	dir,
		const word &	procDir
	)		const

Operating on fileName: replace processorXXX with procDir.

Definition at line 1025 of file fileOperation.C.

References Foam::endl(), fileName::name(), fileName::null, fileName::path(), Foam::pos(), and WarningInFunction.

Here is the call graph for this function:

◆ splitProcessorPath()

Foam::label splitProcessorPath	(	const fileName &	objectPath,
		fileName &	path,
		fileName &	procDir,
		fileName &	local,
		label &	groupStart,
		label &	groupSize,
		label &	nProcs
	)

static

Split fileName into part before 'processor' and part after.

Returns -1 or processor number and optionally number of processors. Use with care.

path/"processor"+Foam::name(proci)/local reconstructs input
path/"processors"+Foam::name(nProcs)/local reconstructs collated processors equivalence

Definition at line 1050 of file fileOperation.C.

References f(), n, path(), Foam::pos(), and Foam::read().

Here is the call graph for this function:

◆ detectProcessorPath()

Foam::label detectProcessorPath ( const fileName & fName )

static

Detect processor number from '/aa/bb/processorDDD/cc'.

Definition at line 1171 of file fileOperation.C.

References path(), and Foam::start.

Here is the call graph for this function:

Member Data Documentation

◆ pathTypeNames_

const Foam::Enum< Foam::fileOperation::pathType > pathTypeNames_

static

Definition at line 97 of file fileOperation.H.

Referenced by masterUncollatedFileOperation::filePath().

◆ comm_

const label comm_

protected

Communicator to use.

Definition at line 108 of file fileOperation.H.

◆ procsDirs_

HashTable<dirIndexList> procsDirs_

mutableprotected

Detected processors directories.

Definition at line 111 of file fileOperation.H.

◆ monitorPtr_

autoPtr<fileMonitor> monitorPtr_

mutableprotected

file-change monitor for all registered files

Definition at line 114 of file fileOperation.H.

Referenced by fileOperation::monitor().

◆ processorsBaseDir

Foam::word processorsBaseDir = "processors"

static

Return the processors directory name (usually "processors")

Definition at line 160 of file fileOperation.H.

◆ defaultFileHandler

word defaultFileHandler

static

Default fileHandler.

Definition at line 163 of file fileOperation.H.

Referenced by argList::argList(), Foam::fileHandler(), and argList::parse().

◆ fileHandlerPtr_

autoPtr< fileOperation > fileHandlerPtr_

static

Static fileOperation.

Definition at line 173 of file fileOperation.H.

Referenced by Foam::fileHandler().

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

src/OpenFOAM/global/fileOperations/fileOperation/fileOperation.H
src/OpenFOAM/global/fileOperations/fileOperation/fileOperation.C

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ dirIndex

◆ dirIndexList

Member Enumeration Documentation

◆ pathType

Constructor & Destructor Documentation

◆ fileOperation()

◆ ~fileOperation()

Member Function Documentation

◆ monitor()

◆ sortTimes()

◆ mergeTimes()

◆ isFileOrDir()

◆ lookupAndCacheProcessorsPath()

◆ lookupProcessorsPath()

◆ exists() [1/2]

◆ TypeName()

◆ declareRunTimeSelectionTable()

◆ New()

◆ mkDir()

◆ chMod()

◆ mode()

◆ type()

◆ exists() [2/2]

◆ isDir()

◆ isFile()

◆ fileSize()

◆ lastModified()

◆ highResLastModified()

◆ readDir()

◆ cp()

◆ ln()

◆ mv()

◆ mvBak()

◆ rm()

◆ rmDir()

◆ objectPath()

◆ filePath() [1/2]

◆ dirPath()

◆ readObjects()

◆ readHeader()

◆ readStream()

◆ read()

◆ writeObject()

◆ filePath() [2/2]

◆ NewIFstream()

◆ NewOFstream()

◆ addWatch()

◆ removeWatch()

◆ findWatch()

◆ addWatches()

◆ getFile()

◆ updateStates()

◆ getState()

◆ setUnmodified()

◆ processorsDir() [1/2]

◆ processorsDir() [2/2]

◆ setNProcs()

◆ nProcs()

◆ findTimes()

◆ findInstance()

◆ setTime()

◆ flush()

◆ processorsCasePath()

◆ processorsPath() [1/2]

◆ processorsPath() [2/2]

◆ splitProcessorPath()

◆ detectProcessorPath()

Member Data Documentation

◆ pathTypeNames_

◆ comm_

◆ procsDirs_