👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

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] des-
       tination_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 specified, dbus-send sends to the session bus.

       Nearly  all uses of dbus-send must provide the --dest argument which is the name of a con-
       nection 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, boolean.  (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.freedesk-
       top.org/software/dbus/

SunOS 5.11				   19 Nov 2007				     dbus-send(1)


All times are GMT -4. The time now is 01:57 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password