Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for dbus-send (opensolaris section 1)

dbus-send(1)							   User Commands						      dbus-send(1)

NAME
dbus-send - Send a message to a message bus
SYNOPSIS
dbus-send [--system | --session] [--dest=name] [--help] [--print-reply] [--type=type] destination_object_path message_name [contents...]
DESCRIPTION
The dbus-send command is used to send a message to a D-Bus message bus. There are two standard message buses: o systemwide message bus - Disabled and not supported on Solaris, but installed on many systems as the "messagebus" init service. o per-user-login-session message bus - Enabled and supported on Solaris, and started each time a user logs in. The --system and --session options direct dbus-send to send messages to the system or session buses respectively. If neither is speci- fied, dbus-send sends to the session bus. Nearly all uses of dbus-send must provide the --dest argument which is the name of a connection on the bus to send the message to. If --dest is omitted, no destination is set. See http://www.freedesktop.org/software/dbus/ for more information.
OPTIONS
The following options are supported: --dest=name Specify the name of the connection to receive the message. --help Show help information on standard output and exit. --print-reply Block for a reply to the message sent, and print any reply received. --session Send to the session message bus (this is the default). --system Send to the system message bus. The system bus is disabled and unsupported on Solaris. --type=type Specify "method_call" or "signal" (defaults to "signal").
OPERANDS
The following operands are supported: destination_object_path The object path of the message to send must always be specified. message_name The name of the message to send must always be specified. contents Following arguments, if any, are the message contents (message arguments). These are given as a type name, a colon, and then the value of the argument. The possible type names are: string, int32, uint32, double, byte, bool- ean. (D-Bus supports more types than these, but dbus-send currently does not.)
EXAMPLES
Example 1: How to use dbus-send with a sh-compatible shell to start the per-session bus daemon example% dbus-send --dest='org.freedesktop.ExampleName \ /org/freedesktop/sample/object/name \ org.freedesktop.ExampleInterface.ExampleMethod \ int32:47 string:'hello world' double:65.32 Note that the interface is separated from a method or signal name by a dot, though in the actual protocol the interface and the interface member are separate fields.
EXIT STATUS
The following exit values are returned: 0 Application exited successfully >0 Application exited with failure
FILES
The following files are used by this application: /usr/bin/dbus-send Executable for dbus-send
ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWdbus | +-----------------------------+-----------------------------+ |Interface stability |Volatile | +-----------------------------+-----------------------------+
SEE ALSO
dbus-cleanup-sockets(1), dbus-daemon(1), dbus-launch(1), dbus-monitor(1), dbus-uuidgen(1), libdbus-glib-1(3), attributes(5)
NOTES
For authorship information refer to http://www.freedesktop.org/software/dbus/doc/AUTHORS. Updated by Brian Cameron, Sun Microsystems Inc., 2007. dbus-send was written by Philip Blundell. Please send bug reports to the D-Bus mailing list or bug tracker, see http://www.freedesktop.org/software/dbus/ SunOS 5.11 19 Nov 2007 dbus-send(1)