dir_watch.cpp File Reference

#include "precompiled.h"
#include "lib/sysdep/dir_watch.h"
#include "lib/file/file_system.h"
#include "osx_sys_version.h"
#include "lib/os_path.h"
#include "lib/file/file.h"
#include "lib/posix/posix_filesystem.h"
#include <CoreFoundation/CoreFoundation.h>
#include <CoreServices/CoreServices.h>
#include "ps/CLogger.h"

Go to the source code of this file.

Classes
struct	DirWatch

Macros
#define	kFSEventStreamCreateFlagFileEvents   0x00000010
#define	kFSEventStreamEventFlagItemIsFile   0x00010000
#define	kFSEventStreamEventFlagItemRemoved   0x00000200
#define	kFSEventStreamEventFlagItemRenamed   0x00000800
#define	kFSEventStreamEventFlagItemCreated   0x00000100
#define	kFSEventStreamEventFlagItemModified   0x00001000

Typedefs
typedef std::vector< DirWatch >	DirWatchMap

Functions
bool	CanRunNotifications ()
static void	fsevent_callback (ConstFSEventStreamRef streamRef, void *clientCallBackInfo, size_t numEvents, void *eventPaths, const FSEventStreamEventFlags eventFlags[], const FSEventStreamEventId eventIds[])
FSEventStreamRef	CreateEventStream (DirWatchMap path)
void	DeleteEventStream ()
Status	dir_watch_Add (const OsPath &path, PDirWatch &dirWatch)
	start watching a single directory for changes. More...
Status	dir_watch_Poll (DirWatchNotifications &notifications)
	return all pending directory watch notifications. More...

Variables
FSEventStreamRef	g_Stream = NULL
static DirWatchMap	g_Paths
static DirWatchMap	g_RootPaths
static DirWatchNotifications	g_QueuedDirs

Macro Definition Documentation

#define kFSEventStreamCreateFlagFileEvents   0x00000010

Definition at line 68 of file dir_watch.cpp.

#define kFSEventStreamEventFlagItemCreated   0x00000100

Definition at line 72 of file dir_watch.cpp.

#define kFSEventStreamEventFlagItemIsFile   0x00010000

Definition at line 69 of file dir_watch.cpp.

#define kFSEventStreamEventFlagItemModified   0x00001000

Definition at line 73 of file dir_watch.cpp.

#define kFSEventStreamEventFlagItemRemoved   0x00000200

Definition at line 70 of file dir_watch.cpp.

#define kFSEventStreamEventFlagItemRenamed   0x00000800

Definition at line 71 of file dir_watch.cpp.

Typedef Documentation

typedef std::vector<DirWatch> DirWatchMap

Definition at line 47 of file dir_watch.cpp.

Function Documentation

bool CanRunNotifications

(

)

Definition at line 52 of file dir_watch.cpp.

FSEventStreamRef CreateEventStream

(

DirWatchMap

path

)

Definition at line 120 of file dir_watch.cpp.

void DeleteEventStream

(

)

Definition at line 150 of file dir_watch.cpp.

Status dir_watch_Add	(	const OsPath &	path,
		PDirWatch &	dirWatch
	)

start watching a single directory for changes.

Parameters

path	(must end in slash)
dirWatch	opaque smart pointer to the watch state; used to manage its lifetime (this is deemed more convenient than a separate dir_watch_Remove interface).

clients typically want to watch entire directory subtrees (e.g. a mod), which is supported by Windows but not FAM. to reduce overhead, the Windows backend always watches subtrees, but portable clients should still add a watch for each subdirectory (the shared watch state is reference-counted). rationale: since the VFS has per-directory data structures, it is convenient to store PDirWatch there instead of creating a second tree structure here.

Definition at line 163 of file dir_watch.cpp.

Status dir_watch_Poll

(

DirWatchNotifications &

notifications

)

return all pending directory watch notifications.

Parameters

notifications

receives any pending notifications in unspecified order.

Returns

Status (INFO::OK doesn't imply notifications were returned)

note: the run time of this function is independent of the number of directory watches and number of files.

rationale for a polling interface: users (e.g. the main game loop) typically want to receive change notifications at a single point, rather than deal with the complexity of asynchronous notifications.

Definition at line 187 of file dir_watch.cpp.

static void fsevent_callback ( ConstFSEventStreamRef  streamRef, void *  clientCallBackInfo, size_t  numEvents, void *  eventPaths, const FSEventStreamEventFlags  eventFlags[], const FSEventStreamEventId  eventIds[]  )

static

Definition at line 76 of file dir_watch.cpp.

Variable Documentation

DirWatchMap g_Paths

static

Definition at line 48 of file dir_watch.cpp.

DirWatchNotifications g_QueuedDirs

static

Definition at line 50 of file dir_watch.cpp.

DirWatchMap g_RootPaths

static

Definition at line 49 of file dir_watch.cpp.

FSEventStreamRef g_Stream = NULL

Definition at line 39 of file dir_watch.cpp.