---
name: "dcop"
section: "1"
platform: "linux"
package: "kdelibs4c2a"
version: "4:3.5.10.dfsg.1-5"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/dcop"
---

# dcop(1)

Console DCOP client

## NAME

dcop — Console DCOP client

## SYNOPSIS

**dcop** \[*options\]  \[application \[function \[arg1*\] \[*arg2*\] ... \] \]

## DESCRIPTION

This manual page documents briefly the  **dcop** command.

**dcop** is a console DCOP (Desktop Communications Protocol) client.

## OPTIONS

This program follows the usual GNU command line syntax,  with long options starting with two dashes (\`-').  A summary of  options is included below.

- **--all-sessions**

  Send to all sessions found. Only works with the --user and --all-users options.

- **--all-users**

  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.

- **--help**

  Show help about options.

- **--list-sessions**

  List all active KDE session for a user or all users.

- **--pipe**

  Call DCOP for each line read from stdin.

- **--session** *session*

  Send to the given KDE session. This option can only be used in combination with the --user option.

- **--user** *user*

  Connect to the given user's DCOP server. This option will ignore the values of the environment vars $DCOPSERVER and $ICEAUTHORITY, even if they are set. If the user has more than one open session, you must also use one of the --list-sessions, --session or --all-sessions command-line options.

## EXAMPLES

**Return number of the current desktop, e.g. 2**

```
dcop kwin KWinInterface currentDesktop
```

**Jump to the next dektop**

```
dcop kwin KWinInterface nextDesktop
```

## AUTHOR

This manual page was written by Chris Cheney  \<ccheney@debian.org\> for the **Debian** system (but may be used by  others).  Permission is granted to copy, distribute and/or  modify this document under the terms of the GNU General Public  License, Version 2 or any later version published by the Free  Software Foundation.

On Debian systems, the complete text of the GNU General  Public License can be found in /usr/share/common-licenses/GPL.

## SEE ALSO

[**kdcop**(1)](/kdcop/1.md), [**dcopserver**(1)](/dcopserver/1.md)