From f4ebd3a876ed55acd7eb5380ed188d64153008aa Mon Sep 17 00:00:00 2001 From: "John (J5) Palmieri" Date: Tue, 9 Oct 2007 15:27:53 -0400 Subject: Document syntax for container types in dbus-send man file (#9553) * Patch from Jack Spaar --- tools/dbus-send.1 | 28 ++++++++++++++++++++++------ 1 file changed, 22 insertions(+), 6 deletions(-) (limited to 'tools') diff --git a/tools/dbus-send.1 b/tools/dbus-send.1 index 0dad6e8f..4878c3d9 100644 --- a/tools/dbus-send.1 +++ b/tools/dbus-send.1 @@ -33,19 +33,35 @@ which is the name of a connection on the bus to send the message to. If .PP 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 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.) +(message arguments). These are given as type-specified values and +may include containers (arrays, dicts, and variants) as described below. + +.nf + ::= | [ | ...] + ::= : + ::= | | + ::= array::[,...] + ::= dict:::,[,,...] + ::= variant:: + ::= string | int16 | uint 16 | int32 | uint32 | int64 | uint64 | double | byte | boolean | objpath +.fi + +D-Bus supports more types than these, but \fIdbus-send\fP currently +does not. Also, \fIdbus-send\fP does not permit empty containers +or nested containers (e.g. arrays of variants). .PP Here is an example invocation: .nf - dbus-send \-\-dest='org.freedesktop.ExampleName \\ + dbus-send \-\-dest=org.freedesktop.ExampleName \\ /org/freedesktop/sample/object/name \\ org.freedesktop.ExampleInterface.ExampleMethod \\ - int32:47 string:'hello world' double:65.32 + 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 .fi -- cgit