notify.h File Reference

Network event notification type definitions. More...

Detailed Description

Network event notification type definitions.

The purpose of this API is to allow lower layers in the network stack to inform higher layers of general, protocol-independent network events. It can be used through the GNRC communication interface to notify any other network interfaces that have registered themselves through Network protocol registry for the corresponding gnrc_nettype: Protocol type.

Note

Notification events are associated with type-dependent event data. Receivers should not access the data directly, but instead use the the dedicated API functions to copy the data from the sender's. If the data is read manually, the receiver is responsible for calling gnrc_netapi_notify_ack to unblock the sender.

Author

Elena Frank elena.nosp@m..fra.nosp@m.nk@tu.nosp@m.-dre.nosp@m.sden..nosp@m.de

Definition in file notify.h.

#include <stdint.h>
#include "net/gnrc/netif/conf.h"
#include "sema_inv.h"

Include dependency graph for notify.h:

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

Go to the source code of this file.

Data Structures
struct	gnrc_netapi_notify_t
	Data structure to be sent for netapi notification events. More...
struct	netapi_notify_l2_connection_t
	L2 connection event data associated with NETAPI_NOTIFY_L2_NEIGH_CONNECTED or NETAPI_NOTIFY_L2_NEIGH_DISCONNECTED events. More...

Enumerations
enum	netapi_notify_t { NETAPI_NOTIFY_L2_NEIGH_CONNECTED , NETAPI_NOTIFY_L2_NEIGH_DISCONNECTED , NETAPI_NOTIFY_L3_DISCOVERED , NETAPI_NOTIFY_L3_UNREACHABLE }
	Definition of notification event types in the network stack. More...

Functions
static void	gnrc_netapi_notify_ack (sema_inv_t *ack)
	Acknowledge that a notify event was received and its data read.
int	gnrc_netapi_notify_copy_event_data (gnrc_netapi_notify_t *notify, uint8_t data_len, void *data)
	Copy the connection event data associated with a gnrc_netapi_notify_t event.