dbus_new_helpers.c File Reference

#include "utils/includes.h"
#include "utils/common.h"
#include "utils/eloop.h"
#include "dbus_common.h"
#include "dbus_common_i.h"
#include "dbus_new.h"
#include "dbus_new_helpers.h"
Include dependency graph for dbus_new_helpers.c:

Go to the source code of this file.

Defines

#define MAX_SIG_LEN   256
#define WPA_DBUS_SEND_PROP_CHANGED_TIMEOUT   5000

Functions

static unsigned int fill_dict_with_properties (DBusMessageIter *dict_iter, const struct wpa_dbus_property_desc *props, const char *interface, const void *user_data)
static void flush_object_timeout_handler (void *eloop_ctx, void *timeout_ctx)
void free_dbus_object_desc (struct wpa_dbus_object_desc *obj_dsc)
static void free_dbus_object_desc_cb (DBusConnection *connection, void *obj_dsc)
static DBusMessage * get_all_properties (DBusMessage *message, char *interface, struct wpa_dbus_object_desc *obj_dsc)
static int is_signature_correct (DBusMessage *message, const struct wpa_dbus_method_desc *method_dsc)
static DBusHandlerResult message_handler (DBusConnection *connection, DBusMessage *message, void *user_data)
static DBusMessage * msg_method_handler (DBusMessage *message, struct wpa_dbus_object_desc *obj_dsc)
static DBusMessage * properties_get (DBusMessage *message, const struct wpa_dbus_property_desc *dsc, void *user_data)
static DBusMessage * properties_get_all (DBusMessage *message, char *interface, struct wpa_dbus_object_desc *obj_dsc)
static DBusMessage * properties_get_or_set (DBusMessage *message, DBusMessageIter *iter, char *interface, struct wpa_dbus_object_desc *obj_dsc)
static DBusMessage * properties_handler (DBusMessage *message, struct wpa_dbus_object_desc *obj_dsc)
static DBusMessage * properties_set (DBusMessage *message, const struct wpa_dbus_property_desc *dsc, void *user_data)
static void put_changed_properties (const struct wpa_dbus_object_desc *obj_dsc, const char *interface, DBusMessageIter *dict_iter)
static void recursive_flush_changed_properties (DBusConnection *con, const char *path)
static void recursive_iter_copy (DBusMessageIter *from, DBusMessageIter *to)
static void send_prop_changed_signal (DBusConnection *con, const char *path, const char *interface, const struct wpa_dbus_object_desc *obj_dsc)
int wpa_dbus_ctrl_iface_init (struct wpas_dbus_priv *iface, char *dbus_path, char *dbus_service, struct wpa_dbus_object_desc *obj_desc)
void wpa_dbus_flush_all_changed_properties (DBusConnection *con)
void wpa_dbus_flush_object_changed_properties (DBusConnection *con, const char *path)
void wpa_dbus_get_object_properties (struct wpas_dbus_priv *iface, const char *path, const char *interface, DBusMessageIter *dict_iter)
void wpa_dbus_mark_property_changed (struct wpas_dbus_priv *iface, const char *path, const char *interface, const char *property)
int wpa_dbus_register_object_per_iface (struct wpas_dbus_priv *ctrl_iface, const char *path, const char *ifname, struct wpa_dbus_object_desc *obj_desc)
int wpa_dbus_unregister_object_per_iface (struct wpas_dbus_priv *ctrl_iface, const char *path)

Define Documentation

#define MAX_SIG_LEN   256
#define WPA_DBUS_SEND_PROP_CHANGED_TIMEOUT   5000

Definition at line 789 of file dbus_new_helpers.c.


Function Documentation

static unsigned int fill_dict_with_properties ( DBusMessageIter *  dict_iter,
const struct wpa_dbus_property_desc props,
const char *  interface,
const void *  user_data 
) [static]

Definition at line 88 of file dbus_new_helpers.c.

static void flush_object_timeout_handler ( void *  eloop_ctx,
void *  timeout_ctx 
) [static]

Definition at line 701 of file dbus_new_helpers.c.

void free_dbus_object_desc ( struct wpa_dbus_object_desc obj_dsc  ) 

free_dbus_object_desc - Frees object description data structure : DBus connection : Object description to free

Frees each of properties, methods and signals description lists and the object description structure itself.

Definition at line 455 of file dbus_new_helpers.c.

static void free_dbus_object_desc_cb ( DBusConnection *  connection,
void *  obj_dsc 
) [static]

Definition at line 470 of file dbus_new_helpers.c.

static DBusMessage* get_all_properties ( DBusMessage *  message,
char *  interface,
struct wpa_dbus_object_desc obj_dsc 
) [static]

Definition at line 145 of file dbus_new_helpers.c.

static int is_signature_correct ( DBusMessage *  message,
const struct wpa_dbus_method_desc method_dsc 
) [static]

Definition at line 180 of file dbus_new_helpers.c.

static DBusHandlerResult message_handler ( DBusConnection *  connection,
DBusMessage *  message,
void *  user_data 
) [static]

message_handler - Handles incoming DBus messages : DBus connection on which message was received : Received message : pointer to description of object to which message was sent Returns: Returns information whether message was handled or not

Reads message interface and method name, then checks if they matches one of the special cases i.e. introspection call or properties get/getall/set methods and handles it. Else it iterates over registered methods list and tries to match method's name and interface to those read from message If appropriate method was found its handler function is called and response is sent. Otherwise, the DBUS_ERROR_UNKNOWN_METHOD error message will be sent.

Definition at line 392 of file dbus_new_helpers.c.

static DBusMessage* msg_method_handler ( DBusMessage *  message,
struct wpa_dbus_object_desc obj_dsc 
) [static]

Definition at line 338 of file dbus_new_helpers.c.

static DBusMessage* properties_get ( DBusMessage *  message,
const struct wpa_dbus_property_desc dsc,
void *  user_data 
) [static]

Definition at line 218 of file dbus_new_helpers.c.

static DBusMessage* properties_get_all ( DBusMessage *  message,
char *  interface,
struct wpa_dbus_object_desc obj_dsc 
) [static]

Definition at line 207 of file dbus_new_helpers.c.

static DBusMessage* properties_get_or_set ( DBusMessage *  message,
DBusMessageIter *  iter,
char *  interface,
struct wpa_dbus_object_desc obj_dsc 
) [static]

Definition at line 251 of file dbus_new_helpers.c.

static DBusMessage* properties_handler ( DBusMessage *  message,
struct wpa_dbus_object_desc obj_dsc 
) [static]

Definition at line 298 of file dbus_new_helpers.c.

static DBusMessage* properties_set ( DBusMessage *  message,
const struct wpa_dbus_property_desc dsc,
void *  user_data 
) [static]

Definition at line 234 of file dbus_new_helpers.c.

static void put_changed_properties ( const struct wpa_dbus_object_desc obj_dsc,
const char *  interface,
DBusMessageIter *  dict_iter 
) [static]

Definition at line 614 of file dbus_new_helpers.c.

static void recursive_flush_changed_properties ( DBusConnection *  con,
const char *  path 
) [static]

Definition at line 712 of file dbus_new_helpers.c.

static void recursive_iter_copy ( DBusMessageIter *  from,
DBusMessageIter *  to 
) [static]

recursive_iter_copy - Reads arguments from one iterator and writes to another recursively : iterator to read from : iterator to write to

Copies one iterator's elements to another. If any element in iterator is of container type, its content is copied recursively

Definition at line 35 of file dbus_new_helpers.c.

static void send_prop_changed_signal ( DBusConnection *  con,
const char *  path,
const char *  interface,
const struct wpa_dbus_object_desc obj_dsc 
) [static]

Definition at line 666 of file dbus_new_helpers.c.

int wpa_dbus_ctrl_iface_init ( struct wpas_dbus_priv iface,
char *  dbus_path,
char *  dbus_service,
struct wpa_dbus_object_desc obj_desc 
)

wpa_dbus_ctrl_iface_init - Initialize dbus control interface : Pointer to application specific data structure : DBus path to interface object : DBus service name to register with : a pointer to function which will handle dbus messages coming on interface Returns: 0 on success, -1 on failure

Initialize the dbus control interface and start receiving commands from external programs over the bus.

Definition at line 487 of file dbus_new_helpers.c.

void wpa_dbus_flush_all_changed_properties ( DBusConnection *  con  ) 

wpa_dbus_flush_all_changed_properties - Send all PropertiesChanged signals : DBus connection

Traverses through all registered objects and sends PropertiesChanged for each properties.

Definition at line 742 of file dbus_new_helpers.c.

void wpa_dbus_flush_object_changed_properties ( DBusConnection *  con,
const char *  path 
)

wpa_dbus_flush_object_changed_properties - Send PropertiesChanged for object : DBus connection : path to a DBus object for which PropertiesChanged will be sent.

Iterates over all properties registered with object and for each interface containing properties marked as changed, sends a PropertiesChanged signal containing names and new values of properties that have changed.

You need to call this function after wpa_dbus_mark_property_changed() if you want to send PropertiesChanged signal immediately (i.e., without waiting timeout to expire). PropertiesChanged signal for an object is sent automatically short time after first marking property as changed. All PropertiesChanged signals are sent automatically after responding on DBus message, so if you marked a property changed as a result of DBus call (e.g., param setter), you usually do not need to call this function.

Definition at line 765 of file dbus_new_helpers.c.

void wpa_dbus_get_object_properties ( struct wpas_dbus_priv iface,
const char *  path,
const char *  interface,
DBusMessageIter *  dict_iter 
)

Definition at line 859 of file dbus_new_helpers.c.

void wpa_dbus_mark_property_changed ( struct wpas_dbus_priv iface,
const char *  path,
const char *  interface,
const char *  property 
)

Definition at line 805 of file dbus_new_helpers.c.

int wpa_dbus_register_object_per_iface ( struct wpas_dbus_priv ctrl_iface,
const char *  path,
const char *  ifname,
struct wpa_dbus_object_desc obj_desc 
)

wpa_dbus_register_object_per_iface - Register a new object with dbus : pointer to dbus private data : DBus path to object : interface name : description of object's methods, signals and properties Returns: 0 on success, -1 on error

Registers a new interface with dbus and assigns it a dbus object path.

Definition at line 549 of file dbus_new_helpers.c.

int wpa_dbus_unregister_object_per_iface ( struct wpas_dbus_priv ctrl_iface,
const char *  path 
)

wpa_dbus_unregister_object_per_iface - Unregisters DBus object : Pointer to dbus private data : DBus path to object which will be unregistered Returns: Zero on success and -1 on failure

Unregisters DBus object given by its path

Definition at line 592 of file dbus_new_helpers.c.

 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Defines


wpa_supplicant_node
Author(s): Package maintained by Blaise Gassend
autogenerated on Fri Jan 11 10:01:47 2013