Using DataSource peers

Macros
#define	DS_AND(p1, p2, a)
	Combine two peersets using bitwise and. More...
#define	DS_AND3_ISZERO(p1, p2, p3)
	Test if the bitwise and of 3 peersets is 0. More...
#define	DS_AND_ISZERO(p1, p2)
	Test if the bitwise and of 2 peersets is 0. More...
#define	DS_CACHE_DATASRC
	Peer index of cache datasrc. More...
#define	DS_CLR(n, p)
	Clears peer n in peerset p. More...
#define	DS_INTERNAL_DATASRC
	Peer index of internal datasrc. More...
#define	DS_ISEQUAL(p1, p2)
	Test if 2 peersets are equal. More...
#define	DS_ISSET(n, p)
	Tests whether peer n in peerset p. More...
#define	DS_ISZERO(p)
	Checks if all peers in peerset p are cleared. More...
#define	DS_MAX_PEERS
	Maximum number of peers. More...
#define	DS_MIN_PEER
	Minimum index for configured peer. More...
#define	DS_NONZERO(p)
	Sets all peers in peerset p. More...
#define	DS_OR(p1, p2, o)
	Combine two peersets using bitwise or. More...
#define	DS_SET(n, p)
	Sets peer n in peerset p. More...
#define	DS_T_ACTIVE
	Defines the active source peer type, which can accept requests for objects. This flag could be set on the DataSource initialisation object ds_init_t or set in the add-peer sections of a configuration file. More...
#define	DS_T_CONTRIB
	Defines the contribution peer type. This source should automatically receive data updates for objects that it has updated itself. This flag could be set on the DataSource initialisation object ds_init_t or set in the add-peer sections of a configuration file. More...
#define	DS_ZERO(p)
	Unsets all peers in peerset p. More...
#define	F_NOCONNECT
	Suppresses the automatic connection to DataSource peers on startup. The connection can then be made later using ds_set_status_up(). More...
#define	F_RECVAUTOREPLAY
	Defines the Receive Auto Replay peer flag (indicating that, when restarting, this peer should accept replay updates). More...
#define	F_SENDFROMSEQ
	Defines the Send From Sequence peer flag (indicating that, when reconnecting, missed packets should be requested based on the last sequence number). More...

Typedefs
typedef struct _ds_peer_set	ds_set_t
	Defines a set of DataSource peers. More...

Detailed Description

Macro Definition Documentation

#define DS_AND	(		p1,
			p2,
			a
	)

Combine two peersets using bitwise and.

#define DS_AND3_ISZERO	(		p1,
			p2,
			p3
	)

Test if the bitwise and of 3 peersets is 0.

#define DS_AND_ISZERO	(		p1,
			p2
	)

Test if the bitwise and of 2 peersets is 0.

#define DS_CACHE_DATASRC

Peer index of cache datasrc.

#define DS_CLR	(		n,
			p
	)

Clears peer n in peerset p.

#define DS_INTERNAL_DATASRC

Peer index of internal datasrc.

#define DS_ISEQUAL	(		p1,
			p2
	)

Test if 2 peersets are equal.

#define DS_ISSET	(		n,
			p
	)

Tests whether peer n in peerset p.

#define DS_ISZERO

(

p

)

Checks if all peers in peerset p are cleared.

#define DS_MAX_PEERS

Maximum number of peers.

#define DS_MIN_PEER

Minimum index for configured peer.

#define DS_NONZERO

(

p

)

Sets all peers in peerset p.

#define DS_OR	(		p1,
			p2,
			o
	)

Combine two peersets using bitwise or.

#define DS_SET	(		n,
			p
	)

Sets peer n in peerset p.

#define DS_T_ACTIVE

Defines the active source peer type, which can accept requests for objects. This flag could be set on the DataSource initialisation object ds_init_t or set in the add-peer sections of a configuration file.

#define DS_T_CONTRIB

Defines the contribution peer type. This source should automatically receive data updates for objects that it has updated itself. This flag could be set on the DataSource initialisation object ds_init_t or set in the add-peer sections of a configuration file.

#define DS_ZERO

(

p

)

Unsets all peers in peerset p.

#define F_NOCONNECT

Suppresses the automatic connection to DataSource peers on startup. The connection can then be made later using ds_set_status_up().

This flag should be set on the DataSource initialisation object ds_init_t. It can also be set in the add-peer sections of a configuration file rather than hardcoded for all peers, although hardcoding it is more likely as this is usually used when the application depends on making its own connections or other initialisation before DataSource connections are made.

#define F_RECVAUTOREPLAY

Defines the Receive Auto Replay peer flag (indicating that, when restarting, this peer should accept replay updates).

The datasrc-auto-replay option must be set in your configuration file for replay to occur. This flag could be set on the DataSource initialisation object ds_init_t, however it is more typically used in the add-peer sections of a configuration file rather than hardcoded for all peers.

#define F_SENDFROMSEQ

Defines the Send From Sequence peer flag (indicating that, when reconnecting, missed packets should be requested based on the last sequence number).

This flag could be set on the DataSource initialisation object ds_init_t or set in the add-peer sections of a configuration file. It is set on the side that will receive the missed messages, as it instructs DataSource to send the last received sequence number to the peer, which will then flush any queued messages since that sequence number.

Typedef Documentation

typedef struct _ds_peer_set ds_set_t

Defines a set of DataSource peers.