haiku.git

/*
 * Copyright 2003-2016 Haiku Inc. All rights reserved.
 * Distributed under the terms of the MIT License.
 */
#ifndef _NODE_MONITOR_H
#define _NODE_MONITOR_H


#include <StorageDefs.h>


// Flags for the watch_node() call.

// Note that B_WATCH_MOUNT is NOT included in B_WATCH_ALL.
// You may prefer to use BVolumeRoster for volume watching.

enum {
	B_STOP_WATCHING			= 0x0000,
	B_WATCH_NAME			= 0x0001,
	B_WATCH_STAT			= 0x0002,
	B_WATCH_ATTR			= 0x0004,
	B_WATCH_DIRECTORY		= 0x0008,
	B_WATCH_ALL				= 0x000f,

	B_WATCH_MOUNT			= 0x0010,
	B_WATCH_INTERIM_STAT	= 0x0020,
	B_WATCH_CHILDREN		= 0x0040
};


// The "opcode" field of the B_NODE_MONITOR notification message you get.

// The presence and meaning of the other fields in that message specifying what
// exactly caused the notification depend on this value.

#define B_ENTRY_CREATED	 	1
#define B_ENTRY_REMOVED	 	2
#define B_ENTRY_MOVED	 	3
#define B_STAT_CHANGED	 	4
#define B_ATTR_CHANGED	 	5
#define B_DEVICE_MOUNTED	6
#define B_DEVICE_UNMOUNTED	7


// More specific info in the "cause" field of B_ATTR_CHANGED notification
// messages. (Haiku only)

#define B_ATTR_CREATED		1
#define B_ATTR_REMOVED		2
//		B_ATTR_CHANGED is reused


// More specific info in the "fields" field of B_STAT_CHANGED notification
// messages, specifying what parts of the stat data have actually been
// changed. (Haiku only)

enum {
	B_STAT_MODE					= 0x0001,
	B_STAT_UID					= 0x0002,
	B_STAT_GID					= 0x0004,
	B_STAT_SIZE					= 0x0008,
	B_STAT_ACCESS_TIME			= 0x0010,
	B_STAT_MODIFICATION_TIME	= 0x0020,
	B_STAT_CREATION_TIME		= 0x0040,
	B_STAT_CHANGE_TIME			= 0x0080,

	B_STAT_INTERIM_UPDATE		= 0x1000
};


// C++ callable Prototypes

// Since you are not able to parse BMessages from plain C, there is no
// API exported.

#if defined(__cplusplus) && !defined(_KERNEL_MODE)

// these are only needed for the function exports
#include <Node.h>
#include <Messenger.h>

class BLooper;
class BHandler;


extern status_t watch_volume(dev_t volume, uint32 flags, BMessenger target);
extern status_t watch_volume(dev_t volume, uint32 flags,
	const BHandler* handler, const BLooper* looper = NULL);

extern status_t watch_node(const node_ref* node, uint32 flags,
	BMessenger target);
extern status_t watch_node(const node_ref* node, uint32 flags,
	const BHandler* handler, const BLooper* looper = NULL);

extern status_t stop_watching(BMessenger target);
extern status_t stop_watching(const BHandler* handler, const BLooper* looper = NULL);

#endif	// __cplusplus && !_KERNEL_MODE


#endif	// _NODE_MONITOR_H