nih-dbus-tool man page

nih-dbus-tool — D-Bus binding code generator


nih-dbus-tool [Options]... [-o FILE] [XMLFILE]
nih-dbus-tool [Options]... -o FILE --system|--session --dest=NAME OBJECT-PATH



The D-Bus introspection format is an XML document describing the interfaces implemented by a particular object, including the methods and signals of that interface along with their arguments and the properties of that interface.

A single document describes a single object, represented by the root <node> tag.  Interfaces implemented by that object are specified by <interface> tags within it.  Methods, signals and properties defined by the interface are described by <method>, <signal> and <property> tags within the interface.  Arguments to methods and signals are defined by <arg> tags within them.  Names and other values are specified as attributes to the tag.

Additional properties for external tools or software may be given in <annotation> tags.  These may appear within interfaces, methods, signals, properties and arguments. nih-dbus-tool makes use of many of these. Note that argument annotations are an nih-dbus-tool extension to the format.

nih-dbus-tool's parser is reasonably liberal, to allow for future expansion of the D-Bus introspection format.  Any unknown tag, attribute or annotation, or any tag not in an expected location, will be ignored with a warning. However a missing root node tag, missing attributes, illegal or invalid format values for defined attributes or non well-formed XML will result in an error.

Character data and comments are not considered part of description, and are not parsed.



Written by Scott James Remnant <>


Report bugs at <>


2009-04-11 libnih-dus