<?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 % Spanish "INCLUDE">
]>

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

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

<refnamediv>
<refname
><command
>dcop</command
></refname>
<refpurpose
>Cliente de consola para &DCOP;.</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis
><command
>dcop</command
> <group
><option
>--pipe</option
></group
> <group
><option
>--user</option
> <replaceable
> usuario</replaceable
></group
> <group
><option
>--all-users</option
></group
> <group
><option
>--session</option
> <replaceable
> sesión</replaceable
></group
> <group
><option
>--all-sessions</option
></group
> <group
><option
>--list-sessions</option
></group
> <group
><option
>--no-user-time</option
></group
> <group
> <arg
><replaceable
>aplicación</replaceable
></arg
> <group
> <arg
><replaceable
>objeto</replaceable
></arg
> <group
> <arg choice="opt"
><replaceable
>función</replaceable
></arg
> <group
><arg choice="opt" rep="repeat"
><replaceable
>argumentos</replaceable
></arg
></group
> </group
> </group
> </group
> </cmdsynopsis>

</refsynopsisdiv>

<refsect1>
<title
>Descripción</title>
<para
>Cliente de consola para &DCOP;.</para>

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

</refsect1>

<refsect1>
<title
>Opciones</title>

<variablelist>
<varlistentry>
<term
><option
>--pipe</option
></term>
<listitem>
<para
>Llama a &DCOP; para cada línea leída de la entrada estándar.</para>
<para
>Esto es prácticamente equivalente a escribir <userinput
>while read line ; do dcop $line ; done</userinput
> pero como no se inicia una nueva instancia <command
>dcop</command
> para cada línea es generalmente mucho más rápido, especialmente para los enlazadores dinámicos GNU lentos.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--user</option
> <replaceable
>usuario</replaceable
></term>
<listitem>
<para
>Conecta a un usuario al servidor &DCOP;. Esta opción ignorará los valores de las variables de entorno $<envar
>DCOPSERVER</envar
> y $<envar
>ICEAUTHORITY</envar
>, tengan o no valor asignado.</para>
<para
>Si el usuario tiene más de una sesión abierta, también podrá utilizar las opciones de la línea de órdenes <option
>--list-sessions</option
>, <option
>--session</option
> o <option
>--all-sessions</option
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--all-users</option
></term>
<listitem>
<para
>Envía la misma llamada &DCOP; a todos los usuarios que estén con un servidor &DCOP; en ejecución. Sólamente generarán un mensaje de error las llamadas fallidas a los servidores &DCOP; existentes. Sino existe servidor &DCOP; disponible, no se generará mensaje de error.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--session</option
> <replaceable
>sesión</replaceable
></term>
<listitem
><para
>Envía a la sesión &kde; dada. Esta opción sólo se puede utilizar en combinación con la opción <option
>--user</option
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--all-sessions</option
></term>
<listitem>
<para
>Envía a todas las sesiones encontradas. Sólo funciona con las opciones <option
>--user</option
> y <option
>--all-users</option
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--list-sessions</option
></term>
<listitem>
<para
>Lista todas las sesiones de &kde; activas para un usuario o para todos los usuarios.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--no-user-time</option
></term>
<listitem>
<para
>No actualiza la actividad del usuario cada cierto tiempo en la aplicación llamada (para su utilización en scripts que se ejecuten en segundo plano).</para>
</listitem
></varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title
>Entorno</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
>Véa también</title>

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

<para
>En &kde; puede introducir <userinput
>help:/kdcop</userinput
> en &konqueror; para ver el manual de usuario para la herramienta gráfica de dcop, <application
>kdcop</application
>.</para>

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