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]      destinationobjectpath
     messagename [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 "mes-
          sagebus" init service.

       ]o  per-user-login-session message bus - Enabled  and  sup-
          ported  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 specified, dbus-send sends to the session bus.

     Nearly all uses of dbus-send must provide the  --dest  argu-
     ment  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  mes-
         sage.



     --help

         Show help information on standard output and exit.







SunOS 5.11          Last change: 19 Nov 2007                    1






User Commands                                        dbus-send(1)



     --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  dis-
         abled and unsupported on Solaris.



     --type=type

         Specify "methodcall" or  "signal"  (defaults  to  "sig-
         nal").



OPERANDS
     The following operands are supported:

     destinationobjectpath The object path of  the  message  to
                             send must always be specified.



     messagename            The name of the message to send must
                             always be specified.



     contents                Following arguments, if any, are the
                             message   contents   (message  argu-
                             ments).  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, boolean.  (D-Bus  sup-
                             ports  more  types  than  these, but
                             dbus-send currently does not.)






SunOS 5.11          Last change: 19 Nov 2007                    2






User Commands                                        dbus-send(1)



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



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
           ATRIBUTE TYPE               ATRIBUTE 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), attri-
     butes(5)

NOTES
     For       authorship       information       refer        to
     http:/www.freedesktop.org/software/dbus/doc/AUTHORS.



SunOS 5.11          Last change: 19 Nov 2007                    3






User Commands                                        dbus-send(1)



     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          Last change: 19 Nov 2007                    4