From 8e99e853a7abbb5344240c35b66853eeaedca48e Mon Sep 17 00:00:00 2001 From: Philip Blundell Date: Sat, 21 Jun 2003 22:20:30 +0000 Subject: 2003-06-21 Philip Blundell * tools/dbus-monitor.1: Updated. * tools/dbus-send.1: Likewise. --- ChangeLog | 6 ++++++ tools/dbus-monitor.1 | 12 ++++++++---- tools/dbus-send.1 | 32 ++++++++++++++++++-------------- 3 files changed, 32 insertions(+), 18 deletions(-) diff --git a/ChangeLog b/ChangeLog index c9343bf9..7bebaaa6 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2003-06-21 Philip Blundell + + * tools/dbus-monitor.1: Updated. + + * tools/dbus-send.1: Likewise. + 2003-06-20 Anders Carlsson * dbus/dbus-transport-unix.c (unix_handle_watch): Check diff --git a/tools/dbus-monitor.1 b/tools/dbus-monitor.1 index fd741144..d6a780dd 100644 --- a/tools/dbus-monitor.1 +++ b/tools/dbus-monitor.1 @@ -8,7 +8,7 @@ dbus-monitor \- debug probe to print message bus messages .SH SYNOPSIS .PP .B dbus-monitor -[\-\-system] +[\-\-system | \-\-session] .SH DESCRIPTION @@ -21,8 +21,9 @@ the big picture. 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-monitor\fP by default monitors the session bus; to monitor the -system bus, specify \-\-system. +The \-\-system and \-\-session options direct \fIdbus-monitor\fP to +monitor the system or session buses respectively. If neither is +specified, \fIdbus-monitor\fP monitors the session bus. .PP The message bus configuration may keep \fIdbus-monitor\fP from seeing @@ -31,7 +32,10 @@ all messages, especially if you run the monitor as a non-root user. .SH OPTIONS .TP .I "--system" -Use the system message bus instead of the session bus. +Monitor the system message bus. +.TP +.I "--session" +Monitor the session message bus. (This is the default.) .SH AUTHOR dbus-monitor was written by Philip Blundell. diff --git a/tools/dbus-send.1 b/tools/dbus-send.1 index 87aea49d..08ea1335 100644 --- a/tools/dbus-send.1 +++ b/tools/dbus-send.1 @@ -8,7 +8,7 @@ dbus-send \- Send a message to a message bus .SH SYNOPSIS .PP .B dbus-send -[\-\-system] [\-\-dest=SERVICE] [\-\-print-reply] [contents ...] +[\-\-system | \-\-session] [\-\-dest=SERVICE] [\-\-print-reply] [contents ...] .SH DESCRIPTION @@ -20,22 +20,23 @@ information about the big picture. 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 session bus by default, and -to the system bus if you specify \-\-system. +The \-\-system and \-\-session options direct \fIdbus-send\fP to send +messages to the system or session buses respectively. If neither is +specified, \fIdbus-send\fP sends to the session bus. .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). +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. If +\-\-dest is omitted, a default service name of +"org.freedesktop.DBus.Broadcast" is used. .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. +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 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 currently does not.) .PP Here is an example invocation: @@ -57,7 +58,10 @@ Specify the service to receive the message. Block for a reply to the message sent, and print any reply received. .TP .I "--system" -Use the system message bus instead of the session bus. +Send to the system message bus. +.TP +.I "--session" +Send to the session message bus. (This is the default.) .SH AUTHOR dbus-send was written by Philip Blundell. -- cgit