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)