--- dbus-send.1.git 2008-04-10 06:36:05.000000000 -0500 +++ dbus-send.1 2008-04-10 13:17:54.000000000 -0500 @@ -1,4 +1,4 @@ -.\" +\.\" .\" dbus-send manual page. .\" Copyright (C) 2003 Red Hat, Inc. .\" @@ -8,8 +8,8 @@ .SH SYNOPSIS .PP .B dbus-send -[\-\-system | \-\-session] [\-\-dest=NAME] [\-\-print-reply] -[\-\-type=TYPE] [contents ...] +[\-\-system\ |\ \-\-session\ |\ \-\-address=ADDRESS] [\-\-dest=NAME] [\-\-print\-reply[=LITERALLY]] +[\-\-type=TYPE] [\-\-reply\-timeout=MSEC] [contents ...] .SH DESCRIPTION @@ -22,8 +22,9 @@ (installed on many systems as the "messagebus" service) and the per-user-login-session message bus (started each time a user logs in). 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. +messages to the system or session buses respectively. It is also possible +to directly connect to a message bus by using the \-\-address option. If +none of these are specified, \fIdbus-send\fP sends to the session bus. .PP Nearly all uses of \fIdbus-send\fP must provide the \-\-dest argument @@ -75,17 +76,27 @@ .I "--dest=NAME" Specify the name of the connection to receive the message. .TP -.I "--print-reply" +.I "--print-reply[=LITERALLY]" Block for a reply to the message sent, and print any reply received. +When specified, --type=method_call is set, and if the optional +LITERALLY value is specified, the resulting method reply will not +be formatted with type information and new lines. LITERALLY may be +any non-blank value. .TP -.I "--system" -Send to the system message bus. +.I "--address=ADDRESS" +Send to the message bus specified by the ADDRESS. .TP .I "--session" Send to the session message bus. (This is the default.) .TP +.I "--system" +Send to the system message bus. +.TP +.I "--reply-timeout=MSEC" +Specifies the number of milliseconds before the request will timeout (default is to wait forever). +.TP .I "--type=TYPE" -Specify "method_call" or "signal" (defaults to "signal"). +Specify "method_call" or "signal" (defaults to "signal" unless --print-reply is specified). .SH AUTHOR dbus-send was written by Philip Blundell.