[IRC-DEV] Funcionamiento del comando WATCH

[Zoltan]

La sintaxis del comando watch es la siguiente:
WATCH <parámetros>

Los parámetros puede ser:
+nick   Añade un nick a la lista de WATCH
-nick    Borra un nick de la lista de WATCH
C/c  Borra toda la lista de WATCH
S/s Muestra el estatus de la lista de WATCH
L Lista todos los usuarios que están en la lista WATCH, así como su estado
(offline o online)
l  Lista de todos los usuarios on-line que están en la lista de WATCH

Si no especificas parámetro, por defecto es una "l".

Los parámetros se pueden combinar, por ejemplo WATCH C +zoltan +jcea
+nikolas S
Cada vez que conectes al IRC, has de enviar los nicks al servidor (los
clientes, sobre todo el mIRC lo hacen automáticamente) ya que al salir de la
red se borra toda la lista.

En su día he enviado a la lista, un mail sobre como actúa el mIRC cuando
detecta que el servidor tiene WATCH así como funciona el notify, está en
http://mailman.argo.es/pipermail/irc-dev/2001-November/000272.html El mIRC
soporta WATCH desde la versión 5.8 de hace bastante tiempo.


Modo de Funcionamiento:

-Añadir nick
/WATCH +NiKoLaS
Si el usuario está online recibimos un
:gaia.irc-hispano.org 604 zoltan NiKoLaS NiKoLaS CtKYms.BKzsLj.virtual
1018738469 :is online
Y en el caso de que está off line
:gaia.irc-hispano.org 605 zoltan NiKoLaS * * 1018738469 :is offline


-Borrar nick
/WATCH -jcea
Si esta online recibimos
:gaia.irc-hispano.org 602 zoltan jcea jcea jcea.admin.irc-hispano.org
1015870750 :stopped watching
Si esta offline recibimos
:gaia.irc-hispano.org 602 zoltan jcea * *1015870750 :stopped watching


-Resetear Watch
/WATCH C
No dice nada.


-Ver estado de Watch
/WATCH S
You have 3 and are on 1 WATCH entries
jcea zoltan nikolas
End of WATCH s

Aunque no está muy explícito, todo esto quiere decir que tienes 3 personas
en tu lista watch (nicks jcea, nikolas y zoltan) y que estás en la lista de
watch de una persona en el mismo servidor donde estas.


- Listar usuarios online
/WATCH  o /WATCH l
:gaia.irc-hispano.org 600 zoltan jcea jcea jcea.admin.irc-hispano.org
1005870750 :logged online
End of WATCH l


- Listar todos de la lista y mirar cuales estan on-line y cuales off-line
/WATCH L
:gaia.irc-hispano.org 600 zoltan jcea jcea jcea.admin.irc-hispano.org
1005870750 :logged online
:gaia.irc-hispano.org 601 zoltan zoltan * * 1018738469 :is offline
:gaia.irc-hispano.org 601 zoltan NiKoLaS * * 1018733345 :is offline
End of WATCH L


Si un usuario sale de la red, se recibe
:gaia.irc-hispano.org 600 zoltan jcea jcea jcea.admin.irc-hispano.org
1005870750 :logged online

Si un usuario entra a la red, se recibe
:gaia.irc-hispano.org 601 zoltan jcea jcea jcea.admin.irc-hispano.org
1015870750 :logged offline



Esta informacion de WATCH y del resto de comandos del daemon Bahamut de
Dal.Net se puede encontrar en:
(ingles)  http://help.dal.net/docs/misc.html
(español) http://help.dal.net/docs/misces.html


Los numéricos son los siguientes, es muy importante utilizar los estándares
ya que los clientes de IRC, entre ellos el popular mIRC, se basan en los
numéricos que reciban para el notify.  Se ha detectado una coicidencia de un
numérico, el 512, que es el usado para el "no such gline", propongo que se
cambie el numérico del "no such gline" a otro numérico para no colisionar
con el que utiliza el WATCH.

NOTA PostumDatem: el numérico del "no such gline" se ha movido al 514

512   ERR_TOOMANYWATCH

Indica que tienes la lista de "WATCH" llena que no puedes poner más nicks.
Asi mismo te dice el numero máximo de entradas.

Formato:  ":<servidor> 512 <destino> :Maximum size for WATCH-list is
<numero> entries"

Ejemplo:
:gaia.irc-hispano.org 512 zoltan  :Maximum size for WATCH-list is 128
entries



600   RPL_LOGON

Indica que el <nick> dado entra en la red (o se pone el nick).

Formato: ":<servidor> 600 <destino> <nick> <user> <host> <TS logon> :logged
online"

Ejemplo:
:gaia.irc-hispano.org 600 zoltan jcea jcea jcea.admin.irc-hispano.org
1005870750 :logged online



601 RPL_LOGOFF

Indica que el <nick> dado sale de la red (o se ha cambiado a otro nick).

Formato: ":<servidor> 601 <destino> <nick> <user> <host> <TS actual>:logged
offline"

Ejemplo:
:gaia.irc-hispano.org 601 zoltan jcea jcea jcea.admin.irc-hispano.org
1015870750 :logged offline




602  RPL_WATCHOFF

Indica que el nick <nick> ha sido borrado de la lista de WATCH y se deja de
hacer el seguimiento del nick

Formato: ":<servidor> 602 <destino> <nick> <user> <host> <TS> :stopped
watching"

Ejemplo:
:gaia.irc-hispano.org 602 zoltan jcea jcea jcea.admin.irc-hispano.org
1015870750 :stopped watching



603  RPL_WATCHSTAT

Indica cuantos nicks tienes en la lista de watch y el numero de personas que
tienen tu nick en sus notifys en el servidor donde estas.

Formato: ":<servidor> 603 <destino> :You have <La> and are on <LA> WATCH
entries"

Ejemplo:
:gaia.irc-hispano.org 603 zoltan :You have 54 and are on 3 WATCH entries




604 RPL_NOWON

Indica que el nick que acabas de añadir a la lista watch, está online

Formato: ":<servidor> 604 <destino> <nick> <user> <host> <TS> :is online",

Ejemplo:
:gaia.irc-hispano.org 604 zoltan NiKoLaS NiKoLaS CtKYms.BKzsLj.virtual
1018738469 :is online



605 RPL_NOWOFF

Indica que el nick que acabas de añadir a la lista watch, está onffline

Formato: ":<servidor> 605 <destino> <nick> <user> <host> <TS> :is offline"

Ejemplo:
:gaia.irc-hispano.org 605 zoltan NiKoLaS * * 1018738469 :is offline




606 RPL_WATCHLIST

Indica todos los nicks de tu lista de watch.

Formato: ":<servidor> 606 <destino> :<lista de nicks>

Ejemplo:
:gaia.irc-hispano.org 606 zoltan :zoltan jcea NiKoLaS MacHo



607 RPL_ENDOFWATCHLIST

Indica el fin del comando /watch en los casos de /watch l/l/S.

Formato: ":<servidor> 607 <destino> :End of WATCH <parametro>"

Ejemplo:
:gaia.irc-hispano.org 607 zoltan :End of WATCH S




Un saludo

zoltan