IOLSUCKER(2.0.25)                    2003                    IOLSUCKER(2.0.25)



NNAAMMEE
       iolsucker - cliente no interactivo para IOL


SSYYNNOOPPSSIISS
       iioollssuucckkeerr   [--hhnnVVvvWWXX]   [----hheellpp]  [----vveerrssiioonn]  [----vveerrbboossee]  [----ddrryy--rruunn]
                 [----ffaannccyy] [----wwaaiitt] [----xxeennooffoobbee] [----uusseerr username] [--rr reposi-
                 tory]]  [--ff filename]]  [--xx <host[:port]>]] [--UU <username[:pass-
                 word]>]] [--tt <http|socks5>]] [--HH <server[:port]>]]


DDEESSCCRRIIPPCCIIÓÓNN
       iioollssuucckkeerr es un cliente no interactivo para acceder a los contenidos de
       IOL,  de  la forma más eficiente posible.  ¿Por que utilizar un cliente
       no interactivo?  Porque  mantener  archivos  sincronizados  usando  una
       interfase  web  y  el  mouse   es difícil y aburrido: mientras haya una
       materia, hay que entrar a la materia, ir al material didáctico,  y  por
       cada carpeta que allí existe, ver si hay algún archivo nuevo.


OOPPCCIIOONNEESS
       --hh, ----hheellpp
              muestra la ayuda y muere.

       --VV, ----vveerrssiioonn
              muestra la información de la versión y muere.

       --vv, ----vveerrbboossee
              imprime  información extra (util cuando las cosas no funcionan).
              Antes de envierle esta informacion a otra persona, para  que  lo
              ayude, fijese que no exista informacion confidencial.

       --nn, ----ddrryy--rruunn
              corre en seco: no descarga ningún archivo. Solo reporta cambios.

       ----ffaannccyy
              usar nombres lindos en los nombres de  los  directorios  de  las
              materias. la opcion es inteligente: sabe determinar si la ultima
              ves se utilizó la opcion  (y  en  caso  negativo)  reacomoda  el
              repositorio.

       --WW, ----wwaaiitt
              esperar  5 segundos al pasar de materia antes de hacer nada.  Si
              el programa le dice que hubo problemas con el servidor (algo  de
              una  carrera/race del servidor) activela. Esperar 5 segundos era
              el comportamiento de versiones < 2.0.14.

       --XX, ----xxeennooffoobbee
              Modo xenofobia: al terminar lista los archivos que se encuentran
              en nuestro repositorio y que no están en iol.

       --rr repositorio
              especifica  el  directorio donde se almacenan los archivos baja-
              dos.

       --ff     leer opciones del archivo de configuración llamado _f_i_l_e_n_a_m_e.

       ----uusseerr username
              especifica el usuario con el cual se ingresará  al  sistema.  La
              contraseña se le será pedida si no se encuentra en algún archivo
              de documentación.

       --xx, ----pprrooxxyy <host[:port]>
              iioolluussuucckkeerr intentará usar como proxy  de  HTTP  a  _h_o_s_t.  Si  un
              puerto no se especifica entonces se usará el 1080.

       --UU <usuario[:password]>
              usuario  y  contraseña para el proxy (si es que lo necesita). Si
              no especifica la password se  le  preguntará  desde  la  entrada
              estándar.  No  es  aconsejable  especificar la password desde la
              línea de comandos.

       --tt <http|socks5>
              Setea el tipo de proxy. Puede ser un proxy http o un socks5.  Si
              no se especifica ninguno, entonces

       --HH <host[:port]>
              Permite  setear la maquina (ip o nombre) donde se encuentra IOL.
              Para que sirve? Para tunelear los request de IOL via ssh. Si  no
              sabe de que se trata, no la use :).


CCOONNFFIIGGUURRAACCIIOONN
       iioollssuucckkeerr  puede recibir sus opciones tanto desde la línea de comandos,
       como desde un archivo de configuración.  Las opciones de  la  línea  de
       comandos tiene mayor prioridad que las del archivo.

       En  Windows(tm) se utiliza el registro para almacenar la configuración.
       Si usted es un usuario de Windows, puede saltear esta sección.   En  en
       el  resto  de  los  sistemas, el programa, por defecto siempre busca la
       configuración en el archivo _~_/_._i_o_l_r_c.  Otro archivo  se  puede  especi-
       ficar usando la opción --ff.

       El archivo de configuración tiene una estructura jerarquica:

       <?xml version="1.0"?>
       <iolsucker>
            <login>
                 <user>29245511</user>
                 <pass>miPassw0rd</pass>
                 <rep>/tmp/iol</rep>
                 <fancy></fancy>
                       <forum/>
                       <wait/>

            </login>
            <proxy>
                 <host>192.168.12.1:1080</host>
                 <user>usuario:password</user>
                 <host>silvestre.itba.edu.ar</host>
                 <type>socks5</type>

            </proxy>
       </iolsucker>

       Todos  los  nodos,  con  la excepción del raiz,  pueden estar ausentes:
       tanto login como proxy, y como cualquiera de sus hijos.

       Si no tiene idea de como generar como crear el archivo, use la utilidad
       iioollwwiizzaarrdd..


CCAAMMBBIIOOSS
       Si  la  pantalla no es suficiente para usted para notar los cambios (no
       todas las consolas tienen  historia),  puede  ver  los  cambios  en  el
       archivo que se encuentra en el repositorio.


AACCLLAARRAACCIIOONNEESS
       Usted notará que muchos (o todos!) los mensajes de errores y de comuni-
       cación con el usuario están en idioma ingles (estaré un poco loco, pero
       no  tanto).  La causa de esto, es que el programa esta construido sobre
       códigos fuentes que reutilizo con frecuencia y por ello  el  ingles,  y
       otras  librerías  que  salen  de  la  comunidad  internacional.   Éstas
       librerías en general soportan la internalización  (i18n)  y  la  local-
       ización,  por lo que también están disponibles los mensajes en español.
       Por otro lado, todas las cadenas de mis códigos están marcadas y listas
       para ser traducidas al español. No todo es ttaann descabellado.

       El autor (y sus familiares) no esta afiliado, ni tiene conexión directa
       con IOL.  El programa nació para llenar un nicho faltante  en  el  sis-
       tema.


BBUUGGSS
       No muchos espero.


HHIISSTTOORRIIAA
       iioollssuucckkeerr  nació  como  un  script para bash un sábado por la tarde. El
       script consistía de 456 líneas. Para desperdiciar un poco de  tiempo  y
       probar  algunas  cosas (archivos de configuración xml) se escribió esta
       versión en lenguaje C.  La nueva versión termino siendo mucho mas  man-
       tenible que el viejo script.  En la versión 2.0.13 existían 5203 líneas
       de codigo puras. El 49.66% fue escrito en otros proyectos (míos o open-
       source).


AAUUTTHHOORR
       Original written by Juan F. Codagnone <juam@users.sourceforge.net>


CCOOPPYYRRIIGGHHTT
       Copyright (c) 2003 Juan F. Codagnone.

       Permission  is  granted  to make and distribute verbatim copies of this
       manual provided the copyright notice and  this  permission  notice  are
       preserved on all copies.

       Permission  is  granted to copy, distribute and/or modify this document
       under the terms of the GNU Free Documentation License, Version  1.1  or
       any  later  version published by the Free Software Foundation; with the
       Invariant Sections being ``GNU General Public License'' and ``GNU  Free
       Documentation  License'',  with no Front-Cover Texts, and with no Back-
       Cover Texts.  A copy of the license is included in the section entitled
       ``GNU Free Documentation License''.




Diciembre                             05                     IOLSUCKER(2.0.25)