libcoap 4.3.5-develop-19cef11
coap_subscribe.h File Reference

Defines the application visible subscribe information. More...

+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

#define COAP_OBSERVE_ESTABLISH   0
 The value COAP_OBSERVE_ESTABLISH in a GET/FETCH request option COAP_OPTION_OBSERVE indicates a new observe relationship for (sender address, token) is requested. More...
 
#define COAP_OBSERVE_CANCEL   1
 The value COAP_OBSERVE_CANCEL in a GET/FETCH request option COAP_OPTION_OBSERVE indicates that the observe relationship for (sender address, token) must be cancelled. More...
 

Typedefs

typedef int(* coap_observe_added_t) (coap_session_t *session, coap_subscription_t *observe_key, coap_proto_t e_proto, coap_address_t *e_listen_addr, coap_addr_tuple_t *s_addr_info, coap_bin_const_t *raw_packet, coap_bin_const_t *oscore_info, void *user_data)
 Callback handler definition called when a new observe has been set up, as defined in coap_persist_track_funcs(). More...
 
typedef int(* coap_observe_deleted_t) (coap_session_t *session, coap_subscription_t *observe_key, void *user_data)
 Callback handler definition called when an observe is being removed, as defined in coap_persist_track_funcs(). More...
 
typedef int(* coap_track_observe_value_t) (coap_context_t *context, coap_str_const_t *resource_name, uint32_t observe_num, void *user_data)
 Callback handler definition called when an observe unsolicited response is being sent, as defined in coap_persist_track_funcs(). More...
 
typedef int(* coap_dyn_resource_added_t) (coap_session_t *session, coap_str_const_t *resource_name, coap_bin_const_t *raw_packet, void *user_data)
 Callback handler definition called when a dynamic resource is getting created, as defined in coap_persist_track_funcs(). More...
 
typedef int(* coap_resource_deleted_t) (coap_context_t *context, coap_str_const_t *resource_name, void *user_data)
 Callback handler definition called when resource is removed, as defined in coap_persist_track_funcs(). More...
 

Functions

void coap_resource_set_get_observable (coap_resource_t *resource, int mode)
 Set whether a resource is observable. More...
 
COAP_API int coap_resource_notify_observers (coap_resource_t *resource, const coap_string_t *query)
 Initiate the sending of an Observe packet for all observers of resource, optionally matching query if not NULL. More...
 
COAP_API void coap_check_notify (coap_context_t *context)
 Checks all known resources to see if they are dirty and then notifies subscribed observers. More...
 
void coap_persist_track_funcs (coap_context_t *context, coap_observe_added_t observe_added, coap_observe_deleted_t observe_deleted, coap_track_observe_value_t track_observe_value, coap_dyn_resource_added_t dyn_resource_added, coap_resource_deleted_t resource_deleted, uint32_t save_freq, void *user_data)
 Set up callbacks to handle persist tracking so on a coap-server inadvertent restart, existing observe subscriptions can continue. More...
 
COAP_API coap_subscription_tcoap_persist_observe_add (coap_context_t *context, coap_proto_t e_proto, const coap_address_t *e_listen_addr, const coap_addr_tuple_t *s_addr_info, const coap_bin_const_t *raw_packet, const coap_bin_const_t *oscore_info)
 Set up an active subscription for an observe that was previously active over a coap-server inadvertant restart. More...
 
COAP_API int coap_persist_startup (coap_context_t *context, const char *dyn_resource_save_file, const char *observe_save_file, const char *obs_cnt_save_file, uint32_t save_freq)
 Start up persist tracking using the libcoap module. More...
 
COAP_API void coap_persist_stop (coap_context_t *context)
 Stop tracking persist information, leaving the current persist information in the files defined in coap_persist_startup(). More...
 
void coap_persist_set_observe_num (coap_resource_t *resource, uint32_t observe_num)
 Sets the current observe number value. More...
 
COAP_API int coap_cancel_observe (coap_session_t *session, coap_binary_t *token, coap_pdu_type_t message_type)
 Cancel an observe that is being tracked by the client large receive logic. More...
 

Detailed Description

Defines the application visible subscribe information.

Definition in file coap_subscribe.h.