You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Michele Calgaro
352c8f6a21
|
6 years ago | |
---|---|---|
.. | ||
CMakeLists.txt | ||
Makefile.am | 6 years ago | |
README.dcop | ||
dcop.cpp | ||
dcopclient.c | ||
dcopfind.cpp | ||
dcopobject.c | ||
dcopquit.cpp | ||
dcopref.c | ||
dcopstart.cpp | ||
marshall.cpp | 6 years ago |
README.dcop
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.