diff options
Diffstat (limited to 'src/3rd_party/dbus-1.7.8/doc/dbus-send.1.xml.in')
-rw-r--r-- | src/3rd_party/dbus-1.7.8/doc/dbus-send.1.xml.in | 164 |
1 files changed, 0 insertions, 164 deletions
diff --git a/src/3rd_party/dbus-1.7.8/doc/dbus-send.1.xml.in b/src/3rd_party/dbus-1.7.8/doc/dbus-send.1.xml.in deleted file mode 100644 index 67b6dfd27b..0000000000 --- a/src/3rd_party/dbus-1.7.8/doc/dbus-send.1.xml.in +++ /dev/null @@ -1,164 +0,0 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" - "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"> -<refentry id='dbussend1'> - -<!-- dbus\-send manual page. - Copyright (C) 2003 Red Hat, Inc. --> - -<refmeta> -<refentrytitle>dbus-send</refentrytitle> -<manvolnum>1</manvolnum> -<refmiscinfo class="manual">User Commands</refmiscinfo> -<refmiscinfo class="source">D-Bus</refmiscinfo> -<refmiscinfo class="version">@DBUS_VERSION@</refmiscinfo> -</refmeta> -<refnamediv> -<refname>dbus-send</refname> -<refpurpose>Send a message to a message bus</refpurpose> -</refnamediv> -<!-- body begins here --> -<refsynopsisdiv id='synopsis'> -<cmdsynopsis> - <command>dbus-send</command> - <group choice='opt'><arg choice='plain'>--system </arg><arg choice='plain'>--session </arg><arg choice='plain'>--address=<replaceable>ADDRESS</replaceable></arg></group> - <arg choice='opt'>--dest=<replaceable>NAME</replaceable></arg> - <arg choice='opt'><arg choice='plain'>--print-reply </arg><arg choice='opt'><replaceable>=literal</replaceable></arg></arg> - <arg choice='opt'>--reply-timeout=<replaceable>MSEC</replaceable></arg> - <arg choice='opt'>--type=<replaceable>TYPE</replaceable></arg> - <arg choice='plain'><replaceable>OBJECT_PATH</replaceable></arg> - <arg choice='plain'><replaceable>INTERFACE.MEMBER</replaceable></arg> - <arg choice='opt' rep='repeat'><replaceable>CONTENTS</replaceable></arg> - <sbr/> -</cmdsynopsis> -</refsynopsisdiv> - - -<refsect1 id='description'><title>DESCRIPTION</title> -<para>The <command>dbus-send</command> command is used to send a message to a D-Bus message -bus. See <ulink url='http://www.freedesktop.org/software/dbus/'>http://www.freedesktop.org/software/dbus/</ulink> for more -information about the big picture.</para> - - -<para>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). -The <option>--system</option> and <option>--session</option> options direct -<command>dbus-send</command> to send messages to the system or session buses respectively. -If neither is specified, <command>dbus-send</command> sends to the session bus.</para> - - -<para>Nearly all uses of <command>dbus-send</command> must provide the <option>--dest</option> argument -which is the name of a connection on the bus to send the message to. If -<option>--dest</option> is omitted, no destination is set.</para> - - -<para>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 type-specified values and -may include containers (arrays, dicts, and variants) as described below.</para> - -<literallayout remap='.nf'> -<contents> ::= <item> | <container> [ <item> | <container>...] -<item> ::= <type>:<value> -<container> ::= <array> | <dict> | <variant> -<array> ::= array:<type>:<value>[,<value>...] -<dict> ::= dict:<type>:<type>:<key>,<value>[,<key>,<value>...] -<variant> ::= variant:<type>:<value> -<type> ::= string | int16 | uint 16 | int32 | uint32 | int64 | uint64 | double | byte | boolean | objpath -</literallayout> <!-- .fi --> - -<para>D-Bus supports more types than these, but <command>dbus-send</command> currently -does not. Also, <command>dbus-send</command> does not permit empty containers -or nested containers (e.g. arrays of variants).</para> - - -<para>Here is an example invocation:</para> -<literallayout remap='.nf'> - - dbus-send --dest=org.freedesktop.ExampleName \ - /org/freedesktop/sample/object/name \ - org.freedesktop.ExampleInterface.ExampleMethod \ - 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 - -</literallayout> <!-- .fi --> - -<para>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.</para> - -</refsect1> - -<refsect1 id='options'><title>OPTIONS</title> -<para>The following options are supported:</para> -<variablelist remap='TP'> - <varlistentry> - <term><option>--dest=</option><replaceable>NAME</replaceable></term> - <listitem> -<para>Specify the name of the connection to receive the message.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><option>--print-reply</option></term> - <listitem> -<para>Block for a reply to the message sent, and print any reply received -in a human-readable form. It also means the message type (<option>--type=</option>) is <emphasis remap='B'>method_call</emphasis>.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><option>--print-reply=literal</option></term> - <listitem> -<para>Block for a reply to the message sent, and print the body of the -reply. If the reply is an object path or a string, it is printed -literally, with no punctuation, escape characters etc.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><option>--reply-timeout=</option><replaceable>MSEC</replaceable></term> - <listitem> -<para>Wait for a reply for up to <emphasis remap='I'>MSEC</emphasis> milliseconds. -The default is implementation‐defined, typically 25 seconds.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><option>--system</option></term> - <listitem> -<para>Send to the system message bus.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><option>--session</option></term> - <listitem> -<para>Send to the session message bus. (This is the default.)</para> - </listitem> - </varlistentry> - <varlistentry> - <term><option>--address=</option><replaceable>ADDRESS</replaceable></term> - <listitem> -<para>Send to <replaceable>ADDRESS</replaceable>.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><option>--type=</option><replaceable>TYPE</replaceable></term> - <listitem> -<para>Specify <emphasis remap='B'>method_call</emphasis> or <emphasis remap='B'>signal</emphasis> (defaults to "<emphasis remap='B'>signal</emphasis>").</para> - - </listitem> - </varlistentry> -</variablelist> -</refsect1> - -<refsect1 id='author'><title>AUTHOR</title> -<para>dbus-send was written by Philip Blundell.</para> - -</refsect1> - -<refsect1 id='bugs'><title>BUGS</title> -<para>Please send bug reports to the D-Bus mailing list or bug tracker, -see <ulink url='http://www.freedesktop.org/software/dbus/'>http://www.freedesktop.org/software/dbus/</ulink></para> -</refsect1> -</refentry> |