Manual Pages for UNIX Operating System command usage for man dbus-send

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 - Launched when  the  system  is
          started and is always available.  Additional systemwide
          services can be launched via D-Bus service  activation.
          However,   D-Bus  service  activation  is  disabled  on
          Solaris.

       +o  per-user-login-session message bus - Launched 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.

     The object path and the name of the  message  to  send  must
     always  be  specified.  Following arguments, if any, are the
     message contents (message arguments).  These  are  given  as
     type-specified  values  and  may include containers (arrays,
     dicts, and variants) as described below.

             ::=  |  [  | ...]
                 ::= :
            ::=  |  | 
                ::= array::[,...]
                 ::= dict:::,[,,...]
              ::= variant::
                 ::= string | int16 | uint 16 | int32 | uint32 |
                           int64 | uint64 | double | byte | boolean | objpath

     D-Bus  supports  more  types  than  these,   but   dbus-send
     currently  does  not.  Also, dbus-send does not permit empty
     containers or nested containers (e.g. arrays of variants).




SunOS 5.11          Last change: 25 Feb 2009                    1






User Commands                                        dbus-send(1)



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.



     --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 "method_call" or  "signal"  (defaults  to  "sig-
         nal").



OPERANDS
     The following operands are supported:

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







SunOS 5.11          Last change: 25 Feb 2009                    2






User Commands                                        dbus-send(1)



     message_name            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.



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       \
                        array:string:"1st item","next item","last item"  \
                        dict:string:int32:"one",1,"two",2,"three",3      \
                        variant:int32:-8                                 \
                        objpath:/org/freedesktop/sample/object/name

     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  attri-
     butes:




SunOS 5.11          Last change: 25 Feb 2009                    3






User Commands                                        dbus-send(1)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | system/library/dbus         |
    |_____________________________|_____________________________|
    | Interface stability         | Volatile                    |
    |_____________________________|_____________________________|


SEE ALSO
     More information can be found at:

     http://www.freedesktop.org/software/dbus/

     dbus-binding-tool(1),     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          Last change: 25 Feb 2009                    4