## DBus GObject related functions

DBus GObject related functions — Exporting a GObject remotely

## Stability Level

Stable, unless otherwise indicated

## Synopsis

    #define             DBUS_TYPE_G_OBJECT_PATH
                        DBusGObjectInfo;
    void                dbus_g_object_type_install_info     (GType object_type,
                                                             const DBusGObjectInfo *info);
    GType               dbus_g_object_path_get_g_type       (void);
    void                dbus_g_object_register_marshaller   (GClosureMarshal marshaller,
                                                             GType rettype,
                                                             ...);
    void                dbus_g_object_register_marshaller_array
                                                            (GClosureMarshal marshaller,
                                                             GType rettype,
                                                             guint n_types,
                                                             const GType *types);

## Description

FIXME

## Details

### DBUS_TYPE_G_OBJECT_PATH

    #define DBUS_TYPE_G_OBJECT_PATH (dbus_g_object_path_get_g_type ())

### DBusGObjectInfo

    typedef struct {
      int   format_version;

      const DBusGMethodInfo *method_infos;
      int   n_method_infos;
      const char *data;
      const char *exported_signals;
      const char *exported_properties;
    } DBusGObjectInfo;

Introspection data for a GObject, normally autogenerated by a tool such as dbus-binding-tool.

int `format_version`; | Allows us to change the rest of this struct by adding DBusGObjectInfo2, DBusGObjectInfo3, etc.
const DBusGMethodInfo *`method_infos`; | Array of method pointers
int `n_method_infos`; | Length of the infos array
const char *`data`; | Introspection data
const char *`exported_signals`; | Exported signals
const char *`exported_properties`; | Exported properties

### dbus_g_object_type_install_info ()

    void                dbus_g_object_type_install_info     (GType object_type,
                                                             const DBusGObjectInfo *info);

Install introspection information about the given object GType sufficient to allow methods on the object to be invoked by name. The introspection information is normally generated by dbus-glib-tool, then this function is called in the `class_init()` for the object class.

Once introspection information has been installed, instances of the object registered with #`dbus_g_connection_register_g_object()` can have their methods invoked remotely.

`object_type` : | GType for the object
`info` : | introspection data generated by dbus-glib-tool

### dbus_g_object_path_get_g_type ()

    GType               dbus_g_object_path_get_g_type       (void);

Returns : |

### dbus_g_object_register_marshaller ()

    void                dbus_g_object_register_marshaller   (GClosureMarshal marshaller,
                                                             GType rettype,
                                                             ...);

Register a GClosureMarshal to be used for signal invocations, giving its return type and a list of parameter types, followed by `G_TYPE_INVALID`.

This function will not be needed once GLib includes libffi.

`marshaller` : | a GClosureMarshal to be used for invocation
`rettype` : | a GType for the return type of the function @:... The parameter GTypes, followed by `G_TYPE_INVALID`
`...` : |

### dbus_g_object_register_marshaller_array ()

    void                dbus_g_object_register_marshaller_array
                                                            (GClosureMarshal marshaller,
                                                             GType rettype,
                                                             guint n_types,
                                                             const GType *types);

Register a GClosureMarshal to be used for signal invocations. `see_also` dbus_g_object_register_marshaller

`marshaller` : | a GClosureMarshal to be used for invocation
`rettype` : | a GType for the return type of the function
`n_types` : | number of function parameters
`types` : | a C array of GTypes values

## See Also

GObject