summaryrefslogtreecommitdiffstats
path: root/dcop/client/README.dcop
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce4a32fe52ef09d8f5ff1dd22c001110902b60a2 (patch)
tree5ac38a06f3dde268dc7927dc155896926aaf7012 /dcop/client/README.dcop
downloadtdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.tar.gz
tdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'dcop/client/README.dcop')
-rw-r--r--dcop/client/README.dcop78
1 files changed, 78 insertions, 0 deletions
diff --git a/dcop/client/README.dcop b/dcop/client/README.dcop
new file mode 100644
index 000000000..e352cb439
--- /dev/null
+++ b/dcop/client/README.dcop
@@ -0,0 +1,78 @@
+Overview of dcop command line utilities
+
+dcop [<app-id> [<object-id> [<function> [args]]]]
+
+Make a dcop call to the specified function.
+If no function is specified, a list of available functions is listed.
+If no object is specified, a list of available objects is listed.
+If no app-id is specified, a list of available application-ids is listed.
+
+****
+* As of KDE 3.0: You will NO LONGER be able to use "dcop konqueror" to
+* communicate with e.g. "konqueror-4783". You will have to use "dcop
+* konqueror-4783" for that (or the DCOPRef notation, see below)
+****
+
+dcopstart <app>
+
+Starts <app> and returns the <app-id> on stdout that can be used for the
+other commands. E.g. "dcopstart kedit" might return "kedit-29322". An
+exit-code of '0' means success. An exit-code of '1' means error, the error
+msg is printed to stderr and no data is printed to stdout.
+
+
+dcopfind [-l] [-a] <app-id> [<object-id> [<select_func> [args]]]
+
+Finds an existing DCOP application/object. The select_func can be used to
+select a specific single instance out of many based on some criteria.
+<app-id> and <object-id> may end with a '*' as wildcard.
+
+The function returns a <app-object-id> to stdout in the form
+
+ "DCOPRef(<app-id>, <object-id>)"
+
+if an object is found and returns an exit-code of '0'.
+If no object is found, nothing is written to stdout and the exit-code is '1'.
+
+With the -a option it prints out "<app-id>" instead of a DCOPRef.
+
+With the -l option it calls "dcopstart <app-id>" if no object is found,
+stripping off any wildcard from the <app-id>. If the dcopstart command is
+successful the find command is repeated, if the dcopstart command fails, an
+error message is printed to stderr and the command exits with exit-code '2'.
+
+The default selection criteria is "any". Applications can declare their own
+select_func as they see fit, e.g. konqueror could declare
+"isDoingProtocol(QString protocol)" and then the following command would
+select a konqueror mainwindow that is currently handling the help-protocol:
+
+ "dcopfind 'konqueror*' 'konqueror-mainwindow*' 'isDoingProtocol(QString
+protocol)' help"
+
+
+dcop <dcopref> <function> args
+
+In addtion to the current syntax of
+
+ dcop <appid> <object> <function> args
+
+you will now also be able to use <dcopref> to make calls with <dcopref> being
+"DCOPRef(<appid>, <objectid>)" as returned by dcopfind.
+
+Additional utilities:
+
+ "dcopref <appid> <object>"
+
+Creates a DCOPRef from appid and object.
+
+
+ "dcopclient <dcopref>"
+
+Extracts the appid from dcopref.
+
+
+ "dcopobject <dcopref>"
+
+Extracts the object from dcopref.
+
+