blob: 76358132cb590c28a07640b2a6aeb9f0ba90e714 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
.\"
.\" dbus-send manual page.
.\" Copyright (C) 2003 Red Hat, Inc.
.\"
.TH dbus-send 1
.SH NAME
dbus-send \- Send a message to a message bus
.SH SYNOPSIS
.PP
.B dbus-send
[\-\-session] [\-\-dest=SERVICE] <message name> [contents ...]
.SH DESCRIPTION
The \fIdbus-send\fP command is used to send a message to a D-BUS message
bus. See http://www.freedesktop.org/software/dbus/ for more
information about the big picture.
.PP
There are two well-known message buses: the systemwide message bus
(installed on many systems as the "messagebus" service) and the
per-user-login-session message bus (started each time a user logs in).
\fIdbus-send\fP sends messages to the system bus by default, and
to the per-session bus if you specify \-\-session.
.PP
Nearly all uses of \fIdbus-send\fP must provide the \-\-dest
argument which is the name of a service on the bus to send
the message to. The other required argument is the name
of the message to send. Following arguments are the message
contents (message arguments).
.PP
The message arguments 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 \fIdbus-send\fP
does not currently.
.PP
Here is an example invocation:
.nf
dbus-send \-\-dest='org.freedesktop.ExampleService' \\
org.freedesktop.ExampleMessage \\
int32:47 string:'hello world' double:65.32
.fi
.SH OPTIONS
The following options are supported:
.TP
.I "--session"
Use the per-login-session message bus instead of the systemwide bus.
.TP
.I "--dest=SERVICE"
Specify the service to receive the message.
.SH AUTHOR
dbus-send was written by Philip Blundell.
.SH BUGS
Please send bug reports to the D-BUS mailing list or bug tracker,
see http://www.freedesktop.org/software/dbus/
|