summaryrefslogtreecommitdiffstats
path: root/doc/kdelibs/man-dcop.1.docbook
blob: c430f724a51cd1265d950e6fd3b0c40fbcc66557 (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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kdeoptions SYSTEM "kdeoptions.docbook">
<!ENTITY qtoptions SYSTEM "qtoptions.docbook">
<!ENTITY % English "INCLUDE">
]>

<refentry lang="&language;">
<refentryinfo>
<author><personname><firstname>Chris</firstname><surname>Cheney</surname></personname>
<email>ccheney@debian.org</email></author>
<date>March 7, 2003</date>
</refentryinfo>

<refmeta>
<refentrytitle><command>dcop</command></refentrytitle>
<manvolnum>1</manvolnum>
</refmeta>

<refnamediv>
<refname><command>dcop</command></refname>
<refpurpose>Console &DCOP; client</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>dcop</command>
<group><option>--pipe</option></group>
<group><option>--user</option> <tqreplaceable> user</tqreplaceable></group>
<group><option>--all-users</option></group>
<group><option>--session</option> <tqreplaceable> session</tqreplaceable></group>
<group><option>--all-sessions</option></group>
<group><option>--list-sessions</option></group>
<group><option>--no-user-time</option></group>
<group>
  <arg><tqreplaceable>application</tqreplaceable></arg>
  <group>
    <arg><tqreplaceable>object</tqreplaceable></arg>
	<group>
           <arg choice="opt"><tqreplaceable>function</tqreplaceable></arg> 
<group><arg choice="opt" rep="repeat"><tqreplaceable>arguments</tqreplaceable></arg></group>
</group>
</group>
</group>
</cmdsynopsis>

</refsynopsisdiv>

<refsect1>
<title>Description</title>
<para>Console &DCOP; client</para>

<para><!-- Write some stuff here --></para>

</refsect1>

<refsect1>
<title>Options</title>

<variablelist>
<varlistentry>
<term><option>--pipe</option></term>
<listitem>
<para>Call &DCOP; for each line read from stdin.</para>
<para>This is roughly equivalent to calling <userinput>while read line
; do dcop $line ; done</userinput> but because no new
<command>dcop</command> instance has to be started for each line this
is generally much faster, especially for the slower GNU dynamic
linkers.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--user</option> <tqreplaceable>user</tqreplaceable></term>
<listitem>
<para>Connect to the given user's &DCOP; server. This option will
ignore the values of the environment vars $<envar>DCOPSERVER</envar>
and  $<envar>ICEAUTHORITY</envar>, even if they are set.</para>
<para>If the user has more than one open session, you must also use
one of the <option>--list-sessions</option>,
<option>--session</option> or <option>--all-sessions</option>
command-line options.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--all-users</option></term>
<listitem>
<para>Send the same &DCOP; call to all users with a running &DCOP;
server.  Only failed calls to existing &DCOP; servers will generate an
error message.  If no &DCOP; server is available at all, no error will
be generated.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--session</option>
<tqreplaceable>session</tqreplaceable></term>
<listitem><para>Send to the given &kde; session.  This option can only
be used in combination with the <option>--user</option> option.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--all-sessions</option></term>
<listitem>
<para>Send to all sessions found. Only works with the
<option>--user</option> and <option>--all-users</option>
options.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--list-sessions</option></term>
<listitem>
<para>List all active &kde; sessions for a user or all users.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--no-user-time</option></term>
<listitem>
<para>Don't update the user activity timestamp in the called application (for use in scripts running in the background).</para>
</listitem></varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Environment</title>

<variablelist>
<varlistentry>
<term><envar>DCOPSERVER</envar></term>
<listitem>
<para><!-- What does this tell dcop? --></para>
</listitem>
</varlistentry>
<varlistentry>
<term><envar>ICEAUTHORITY</envar></term>
<listitem><para><!-- What does this tell dcop? --></para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<!--
<refsect1>
<title>Examples</title>

<para>Write some examples</para>

</refsect1>
-->
<refsect1>
<title>See Also</title>

<para>dcopclient(1) dcopref(1) dcoptqfind(1) kdcop(1)</para>

<para>Inside &kde;, you can enter <userinput>help:/kdcop</userinput>
in &konqueror; to see the User Manual for
<application>kdcop</application> graphical dcop tool.</para>

<!--
<para> Info on where to tqfind proper dcop docs </para>
-->
</refsect1>
</refentry>