added clixon_stream.[ch]

This commit is contained in:
Olof hagsand 2018-09-23 17:50:19 +02:00
parent 07542269ec
commit d7fbe75c9e
2 changed files with 314 additions and 0 deletions

View file

@ -0,0 +1,73 @@
/*
*
***** BEGIN LICENSE BLOCK *****
Copyright (C) 2009-2018 Olof Hagsand and Benny Holmgren
This file is part of CLIXON.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Alternatively, the contents of this file may be used under the terms of
the GNU General Public License Version 3 or later (the "GPL"),
in which case the provisions of the GPL are applicable instead
of those above. If you wish to allow use of your version of this file only
under the terms of the GPL, and not to allow others to
use your version of this file under the terms of Apache License version 2,
indicate your decision by deleting the provisions above and replace them with
the notice and other provisions required by the GPL. If you do not delete
the provisions above, a recipient may use your version of this file under
the terms of any one of the Apache License version 2 or the GPL.
***** END LICENSE BLOCK *****
* Event notification streams according to RFC5277
*/
#ifndef _CLIXON_STREAM_H_
#define _CLIXON_STREAM_H_
/*
* Types
*/
/* subscription callback */
typedef int (*stream_fn_t)(clicon_handle, void *filter, void *arg);
typedef stream_fn_t subscription_fn_t;
struct stream_subscription{
struct stream_subscription *ss_next;
char *ss_stream; /* Name of associated stream */
stream_fn_t ss_fn; /* Callback when event occurs */
void *ss_arg; /* Callback argument */
};
/* See RFC8040 9.3, stream list, no replay support for now
*/
struct event_stream{
struct event_stream *es_next;
char *es_name; /* name of notification event stream */
char *es_description;
struct stream_subscription *es_subscription;
};
typedef struct event_stream event_stream_t;
/*
* Prototypes
*/
event_stream_t *stream_find(clicon_handle h, const char *name);
int stream_register(clicon_handle h, const char *name, const char *description);
int stream_free(event_stream_t *es);
int stream_get_xml(clicon_handle h, int access, cbuf *cb);
int stream_cb_add(clicon_handle h, char *stream, stream_fn_t fn, void *arg);
int stream_cb_delete(clicon_handle h, char *stream, stream_fn_t fn);
#endif /* _CLIXON_STREAM_H_ */

241
lib/src/clixon_stream.c Normal file
View file

@ -0,0 +1,241 @@
/*
*
***** BEGIN LICENSE BLOCK *****
Copyright (C) 2009-2018 Olof Hagsand and Benny Holmgren
This file is part of CLIXON.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Alternatively, the contents of this file may be used under the terms of
the GNU General Public License Version 3 or later (the "GPL"),
in which case the provisions of the GPL are applicable instead
of those above. If you wish to allow use of your version of this file only
under the terms of the GPL, and not to allow others to
use your version of this file under the terms of Apache License version 2,
indicate your decision by deleting the provisions above and replace them with
the notice and other provisions required by the GPL. If you do not delete
the provisions above, a recipient may use your version of this file under
the terms of any one of the Apache License version 2 or the GPL.
***** END LICENSE BLOCK *****
* Event notification streams according to RFC5277
* See (old) subscription code in clixon_backend_handle.c and backend_client.c
*/
#ifdef HAVE_CONFIG_H
#include "clixon_config.h" /* generated by config & autoconf */
#endif
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <errno.h>
#include <inttypes.h>
/* cligen */
#include <cligen/cligen.h>
/* clicon */
#include "clixon_queue.h"
#include "clixon_err.h"
#include "clixon_hash.h"
#include "clixon_handle.h"
#include "clixon_stream.h"
/*! Find an event notification stream given name
* @param[in] h Clicon handle
* @param[in] name Name of stream
* @retval es Event notification stream structure
* @retval NULL Not found
*/
event_stream_t *
stream_find(clicon_handle h,
const char *name)
{
event_stream_t *es = NULL;
for (es=clicon_stream(h); es; es=es->es_next)
if (strcmp(name, es->es_name)==0)
break;
return es;
}
/*! Add notification event stream
*/
int
stream_register(clicon_handle h,
const char *name,
const char *description)
{
int retval = -1;
event_stream_t *es;
if ((es = stream_find(h, name)) != NULL)
goto ok;
if ((es = malloc(sizeof(event_stream_t))) == NULL){
clicon_err(OE_XML, errno, "malloc");
goto done;
}
memset(es, 0, sizeof(event_stream_t));
if ((es->es_name = strdup(name)) == NULL){
clicon_err(OE_XML, errno, "strdup");
goto done;
}
if ((es->es_description = strdup(description)) == NULL){
clicon_err(OE_XML, errno, "strdup");
goto done;
}
clicon_stream_append(h, es);
ok:
retval = 0;
done:
return retval;
}
/*! Delete complete notification event stream list
*/
int
stream_free(event_stream_t *es)
{
event_stream_t *e_next;
while (es){
e_next = es->es_next;
if (es->es_name)
free(es->es_name);
if (es->es_description)
free(es->es_description);
free(es);
es = e_next;
}
return 0;
}
/*! Return stream definition
* @param[in] h Clicon handle
* @param[in] access If set, include access/location
* @param[out] cb Output buffer containing XML on exit
* @retval 0 OK
* @retval -1 Error
*/
int
stream_get_xml(clicon_handle h,
int access,
cbuf *cb)
{
event_stream_t *es = NULL;
cprintf(cb, "<streams>");
for (es=clicon_stream(h); es; es=es->es_next){
cprintf(cb, "<stream>");
cprintf(cb, "<name>%s</name>", es->es_name);
if (es->es_description)
cprintf(cb, "<description>%s</description>", es->es_description);
cprintf(cb, "<replay-support>false</replay-support>");
if (access){
cprintf(cb, "<access>");
cprintf(cb, "<encoding>xml</encoding>");
/* Note /stream need to be in http proxy declaration */
cprintf(cb, "<location>https://example.com/stream/%s</location>", es->es_name);
cprintf(cb, "</access>");
}
cprintf(cb, "</stream>");
}
cprintf(cb, "</streams>");
return 0;
}
#ifdef NYI
/*! Delete single notification event stream
* XXX notused
*/
int
stream_del()
{
return 0;
}
#endif
/*! Add an event notification callback to a stream given a callback function
* @param[in] h Clicon handle
* @param[in] stream Name of stream
* @param[in] fn Callback when event occurs
* @param[in] arg Argument to use with callback. Also handle when deleting
* @retval 0 OK
* @retval -1 Error
* XXX: from subscription_add and client_subscription_add
*/
int
stream_cb_add(clicon_handle h,
char *stream,
stream_fn_t fn,
void *arg)
{
int retval = -1;
event_stream_t *es;
struct stream_subscription *ss;
if ((es = stream_find(h, stream)) == NULL){
clicon_err(OE_CFG, ENOENT, "Stream not found");
goto done;
}
if ((ss = malloc(sizeof(*ss))) == NULL){
clicon_err(OE_CFG, errno, "malloc");
goto done;
}
memset(ss, 0, sizeof(*ss));
ss->ss_stream = strdup(stream);
ss->ss_fn = fn;
ss->ss_arg = arg;
ss->ss_next = es->es_subscription;
es->es_subscription = ss;
retval = 0;
done:
return retval;
}
/*! Delete event notification callback to a stream given a callback function
* Alt just send in an ss struct?
*/
int
stream_cb_delete(clicon_handle h,
char *stream,
stream_fn_t fn)
{
int retval = -1;
event_stream_t *es;
struct stream_subscription *ss;
struct stream_subscription **ss_prev;
if ((es = stream_find(h, stream)) == NULL)
goto ok;
ss_prev = &es->es_subscription;
for (ss = *ss_prev; ss; ss = ss->ss_next){
if (ss->ss_fn == fn){
*ss_prev = ss->ss_next;
free(ss->ss_stream);
if (ss->ss_arg)
free(ss->ss_arg);
free(ss);
break;
}
ss_prev = &ss->ss_next;
}
ok:
retval = 0;
return retval;
}