alfred: notify event listener via unix socket
PATCH v3 1/1 alfred: notify event listener via unix socket
The alfred server instance accepts event notification registration via the unix socket. These notification sockets only inform registered parties of the availability of an alfred datatype change. The actual data itself needs to be retrieved via the existing data retrieval mechanisms.
Unlike the update-command this event monitor allows:
- multiple parallel listeners
- programmatic access to changes without requiring multiple processes
The alfred client allows to monitor events via the newly added '-E' (event monitor) command line option. Serving as debugging tool and example code at the same time.
---
v3:
- rebase on top of master
- convert to epoll
- add source MAC address to event details
v2:
- fix typ0s
- replace list_del_init() with list_del()
- remove unnecessary INIT_LIST_HEAD()
- change --event-monitor to not require an argument
alfred.h | 13 +++++ client.c | 58 ++++++++++++++++++++++ main.c | 10 +++- man/alfred.8 | 3 ++ packet.h | 27 ++++++++++ recv.c | 5 +- server.c | 1 + unix_sock.c | 136 +++++++++++++++++++++++++++++++++++++++++++++++++++ 8 files changed, 251 insertions(+), 2 deletions(-)
alfred.h +13 -0
@@ -99,6 +99,7 @@ enum clientmode {CLIENT_CHANGE_INTERFACE ,CLIENT_CHANGE_BAT_IFACE ,CLIENT_SERVER_STATUS , + CLIENT_EVENT_MONITOR, }; struct interface {
@@ -118,8 +119,16 @@ struct interface {struct list_head list; }; +struct event_listener { +int fd; +struct epoll_handle epoll; + +struct list_head list; +}; +struct globals {struct list_head interfaces; +struct list_head event_listeners;char *net_iface;struct server *best_server;/* NULL if we are a server ourselves */
@@ -171,6 +180,7 @@ int alfred_client_modeswitch(struct globals *globals);int alfred_client_change_interface (struct globals *globals);int alfred_client_change_bat_iface (struct globals *globals);int alfred_client_server_status (struct globals *globals); +int alfred_client_event_monitor (struct globals *globals);/* recv.c */ int recv_alfred_packet (struct globals *globals,struct interface *interface,int recv_sock);
@@ -199,6 +209,9 @@ int unix_sock_open_client(struct globals *globals);int unix_sock_close (struct globals *globals);int unix_sock_req_data_finish (struct globals *globals,struct transaction_head *head); +void unix_sock_events_close_all (struct globals *globals); +void unix_sock_event_notify (struct globals *globals,uint8_t type,\ +const uint8_t source[ETH_ALEN ]);/* vis.c */ int vis_update_data (struct globals *globals);/* netsock.c */
client.c +58 -0
61 lines not on this page · raw message
main.c +9 -1
@@ -39,6 +39,7 @@ static void alfred_usage(void)printf (" -I, --change-interface [interface] change to the specified interface(s)\n" );printf (" -B, --change-bat-iface [interface] change to the specified batman-adv interface\n" );printf (" -S, --server-status request server status info such as mode & interfaces\n" ); +printf (" -E, --event-monitor monitor alfred data record update events\n" );printf ("\n" );printf ("server mode options:\n" );printf (" -i, --interface specify the interface (or comma separated list of interfaces) to listen on\n" );
@@ -164,6 +165,7 @@ static struct globals *alfred_init(int argc, char *argv[]) {"change-interface", required_argument, NULL, 'I'}, {"change-bat-iface", required_argument, NULL, 'B'}, {"server-status", no_argument, NULL, 'S'}, + {"event-monitor", no_argument, NULL, 'E'}, {"unix-path", required_argument, NULL, 'u'}, {"update-command", required_argument, NULL, 'c'}, {"version", no_argument, NULL, 'v'},
@@ -181,6 +183,7 @@ static struct globals *alfred_init(int argc, char *argv[])memset (globals,0 ,sizeof (*globals));INIT_LIST_HEAD (&globals->interfaces); +INIT_LIST_HEAD (&globals->event_listeners); globals->net_iface =NULL ; globals->opmode =OPMODE_SECONDARY ; globals->clientmode =CLIENT_NONE ;
@@ -198,7 +201,7 @@ static struct globals *alfred_init(int argc, char *argv[])time_random_seed (); -while ((opt =getopt_long (argc, argv,"ms:r:hi:b:vV:M:I:B:Su:dc:p:4:f" , long_options, +while ((opt =getopt_long (argc, argv,"ms:r:hi:b:vV:M:I:B:SEu:dc:p:4:f" , long_options, &opt_ind)) !=-1 ) {switch (opt) {case 'r' :
@@ -263,6 +266,9 @@ static struct globals *alfred_init(int argc, char *argv[])case 'S' : globals->clientmode =CLIENT_SERVER_STATUS ;break ; +case 'E' : + globals->clientmode =CLIENT_EVENT_MONITOR ; +break ;case 'u' : globals->unix_path = optarg;break ;
@@ -328,6 +334,8 @@ int main(int argc, char *argv[])return alfred_client_change_bat_iface (globals);case CLIENT_SERVER_STATUS :return alfred_client_server_status (globals); +case CLIENT_EVENT_MONITOR : +return alfred_client_event_monitor (globals); }return 0 ;
man/alfred.8 +3 -0
@@ -97,6 +97,9 @@ Change the alfred server to use the new \fBbatman-adv interface\fP .TP \fB\-S\fP, \fB\-\-server\-status\fP Request server status information such as mode & interfaces\fP +.TP +\fB\-E\fP, \fB\-\-event\-monitor\fP +Start alfred event monitor connecting to the alfred server and reporting update events\fP . .SH SERVER OPTIONS .TP
packet.h +27 -0
@@ -59,6 +59,8 @@ struct alfred_transaction_mgmt {* @ALFRED_STATUS_ERROR: Error was detected during the transaction * @ALFRED_MODESWITCH: Switch between different operation modes * @ALFRED_CHANGE_INTERFACE: Change the listening interface +* @ALFRED_EVENT_REGISTER: Request to be notified about alfred update events +* @ALFRED_EVENT_NOTIFY: Data record update has been received */ enum alfred_packet_type {ALFRED_PUSH_DATA =0 ,
@@ -70,6 +72,8 @@ enum alfred_packet_type {ALFRED_CHANGE_INTERFACE =6 ,ALFRED_CHANGE_BAT_IFACE =7 ,ALFRED_SERVER_STATUS =8 , +ALFRED_EVENT_REGISTER =9 , + ALFRED_EVENT_NOTIFY = 10, };/* packets */
@@ -229,6 +233,29 @@ struct alfred_server_status_rep_v0 {struct alfred_tlv header; } __packed; +/** +* struct alfred_event_register_v0 - event registration message +* @header: TLV header describing the complete packet +* +* Sent by the client to daemon to register for data record updates +*/ +struct alfred_event_register_v0 { +struct alfred_tlv header; +} __packed; + +/** +* struct alfred_event_notify_v0 - event notification message +* @header: TLV header describing the complete packet +* @type: Type of the data triggering the event +* +* Sent by the daemon to client on data record update +*/ +struct alfred_event_notify_v0 { +struct alfred_tlv header; +uint8_t type; +uint8_t source[ETH_ALEN ]; +} __packed; +/** * struct alfred_status_v0 - Status info of a transaction * @header: TLV header describing the complete packet
recv.c +4 -1
@@ -76,8 +76,11 @@ static int finish_alfred_push_data(struct globals *globals,/* check that data was changed */ if (new_entry_created || dataset->data.header.length != data_len || -memcmp (dataset->buf, data->data, data_len) !=0 ) +memcmp (dataset->buf, data->data, data_len) !=0 ) {changed_data_type (globals, data->header.type); +unix_sock_event_notify (globals, data->header.type, + data->source); + }/* free old buffer */ if (dataset->buf) {
server.c +1 -0
@@ -518,5 +518,6 @@ int alfred_server(struct globals *globals)netsock_close_all (globals);unix_sock_close (globals); +unix_sock_events_close_all (globals);return 0 ; }
unix_sock.c +136 -0
173 lines not on this page · raw message
Signature · 1 line
2.32.0.rc0