splinter_watch_register Splinter API Reference

The purpose of splinter_watch_register is to register interest in a key's group signal so that writes to it pulse the given signal group.

Forward Declaration & Use

int splinter_watch_register(const char *key, uint8_t group_id) <splinter.h>

splinter_watch_register("status", 3); /* subscribe "status" to group 3 */

Return & Rationale

Return Behavior: None.

Errno Behavior: None.

Rationale (Or None): Splinter has 64 signal groups (0-63). Subscribing a key to a group lets readers poll a single counter and then scan for changed epochs rather than sweeping the whole store.

See Also

Relevant Symbols (Or None): splinter_watch_unregister, splinter_watch_label_register, splinter_get_signal_count