Sending Nodata Messages

Macros
#define	F_DELETEOBJECT   0x0004
	Instruction to delete this object. More...
#define	F_NOTFOUND   0x0001
	The object is not found. More...
#define	F_READDENY   0x0002
	You do not have permission to read this object. More...
#define	F_UNAVAILABLE   0x0005
	The object is unavailable at this time. More...
#define	F_WRITEDENY   0x0003
	You do not have permission to write to this object. More...

Functions
void	symbol_send_nodata (const char *subject, u_short flags)
	Send a "nodata" message to the cache and to interested peers. More...

Detailed Description

These functions allow a DataSource to inform its peers that an object does not exist. This can be in response to an active request, in which case an F_NOTFOUND flag is typically sent. It could be in response to some external event where the object should be deleted, an F_DELETEOBJECT flag might then be sent to the peers to instruct that the object should be deleted.

Macro Definition Documentation

#define F_DELETEOBJECT   0x0004

Instruction to delete this object.

This define is used as the flags argument to ds5_publish_subject_error().

Examples:

demo-delete.c.

#define F_NOTFOUND   0x0001

The object is not found.

This define is used as the flags argument to ds5_publish_subject_error().

#define F_READDENY   0x0002

You do not have permission to read this object.

This define is used as the flags argument to ds5_publish_subject_error().

#define F_UNAVAILABLE   0x0005

The object is unavailable at this time.

This define is used as the flags argument to ds5_publish_subject_error().

#define F_WRITEDENY   0x0003

You do not have permission to write to this object.

This define is used as the flags argument to ds5_publish_subject_error().

Function Documentation

void symbol_send_nodata	(	const char *	subject,
		u_short	flags
	)

Send a "nodata" message to the cache and to interested peers.

Parameters

subject	The name of the object
flags	The type of "no data" message to send

This will delete an object from the core memory if it has been generated by the Transformer, and propogate the message to any listening peers for this object