mirror of
https://github.com/warmcat/libwebsockets.git
synced 2025-03-23 00:00:06 +01:00
91 lines
3.1 KiB
C
91 lines
3.1 KiB
C
/*
|
|
* libwebsockets - small server side websockets and web server implementation
|
|
*
|
|
* Copyright (C) 2010-2019 Andy Green <andy@warmcat.com>
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation:
|
|
* version 2.1 of the License.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
|
* MA 02110-1301 USA
|
|
*
|
|
* must be included manually as
|
|
*
|
|
* #include <libwebsockets/lws-dbus.h>
|
|
*
|
|
* if dbus apis needed
|
|
*/
|
|
|
|
#if !defined(__LWS_DBUS_H__)
|
|
#define __LWS_DBUS_H__
|
|
|
|
#include <dbus/dbus.h>
|
|
|
|
/* helper type to simplify implementing methods as individual functions */
|
|
typedef DBusHandlerResult (*lws_dbus_message_handler)(DBusConnection *conn,
|
|
DBusMessage *message, DBusMessage **reply, void *d);
|
|
|
|
struct lws_dbus_ctx;
|
|
typedef void (*lws_dbus_closing_t)(struct lws_dbus_ctx *ctx);
|
|
|
|
struct lws_dbus_ctx {
|
|
struct lws_dll2_owner owner; /* dbusserver ctx: HEAD of accepted list */
|
|
struct lws_dll2 next; /* dbusserver ctx: HEAD of accepted list */
|
|
struct lws_vhost *vh; /* the vhost we logically bind to in lws */
|
|
int tsi; /* the lws thread service index (0 if only one service
|
|
thread as is the default */
|
|
DBusConnection *conn;
|
|
DBusServer *dbs;
|
|
DBusWatch *w[4];
|
|
DBusPendingCall *pc;
|
|
|
|
char hup;
|
|
char timeouts;
|
|
|
|
/* cb_closing callback will be called after the connection and this
|
|
* related ctx struct have effectively gone out of scope.
|
|
*
|
|
* The callback should close and clean up the connection and free the
|
|
* ctx.
|
|
*/
|
|
lws_dbus_closing_t cb_closing;
|
|
};
|
|
|
|
/**
|
|
* lws_dbus_connection_setup() - bind dbus connection object to lws event loop
|
|
*
|
|
* \param ctx: additional information about the connection
|
|
* \param conn: the DBusConnection object to bind
|
|
*
|
|
* This configures a DBusConnection object to use lws for watchers and timeout
|
|
* operations.
|
|
*/
|
|
LWS_VISIBLE LWS_EXTERN int
|
|
lws_dbus_connection_setup(struct lws_dbus_ctx *ctx, DBusConnection *conn,
|
|
lws_dbus_closing_t cb_closing);
|
|
|
|
/**
|
|
* lws_dbus_server_listen() - bind dbus connection object to lws event loop
|
|
*
|
|
* \param ctx: additional information about the connection
|
|
* \param ads: the DBUS address to listen on, eg, "unix:abstract=mysocket"
|
|
* \param err: a DBusError object to take any extra error information
|
|
* \param new_conn: a callback function to prepare new accepted connections
|
|
*
|
|
* This creates a DBusServer and binds it to the lws event loop, and your
|
|
* callback to accept new connections.
|
|
*/
|
|
LWS_VISIBLE LWS_EXTERN DBusServer *
|
|
lws_dbus_server_listen(struct lws_dbus_ctx *ctx, const char *ads,
|
|
DBusError *err, DBusNewConnectionFunction new_conn);
|
|
|
|
#endif
|