]> git.llucax.com Git - z.facultad/75.08/llamadas.git/blobdiff - doc/Informe7508.lyx
subo lo mio luego de resolver conflictos
[z.facultad/75.08/llamadas.git] / doc / Informe7508.lyx
index ed285cedaaa987f73cfb8f052f268c3c145befe1..02203080706ec8442344ba490fa14ed073b706b7 100644 (file)
@@ -77,13 +77,17 @@ En los archivos de llamada se valida que sean numeros, y para validar la
  fecha no se tiene en cuenta casos particulares como el 29, 30, 31 de febrero.
 \layout Itemize
 
-Todos los meses pueden tener 31 dias.
+Todos los meses pueden tener 31 días.
 \layout Itemize
 
 Aficonf utiliza números para describir las acciones Nuevo y Buscar.
  La opción Borrar es ofrecida requiriendo un número de ID a borrar dependiendo
  de los resultados de la búsqueda, y dando una opción (-1) para cancelar
  la acción.
+\layout Itemize
+
+El archivo de umbrales no puede ser modificado por el usuario manualmente,
+ solo a travez de AFICONF
 \layout Section
 
 Problemas relevantes
@@ -92,19 +96,20 @@ Problemas relevantes
 Dado que los distintos componentes del sistema se pueden instalar en diferentes
  paths dentro del OS, creamos el directorio 
 \family typewriter 
-~$HOME/.antifraude
+$HOME/.antifraude
 \family default 
  donde se almacenará información acerca de los paths en donde reside cada
- uno de ellos y otros archivos de intercambio.
+ uno de ellos y otros archivos de intercambio y de rutinas comunes.
 \layout Itemize
 
 Así mismo, como los programas pueden ser instalados en directorios distintos,
- toda la información compartida es guardada en 
+ toda la información compartida (oridesti.txt y umbrales.param) es guardada
+ en 
 \family typewriter 
-~$HOME/.antifraude
+$HOME/.antifraude
 \family default 
 , para ser mas consistentes con la manera de trabajar en Unix.
- Lo ideal ubiera sido utilizar 
+ Lo ideal hubiera sido utilizar 
 \family typewriter 
 /etc/antifraude
 \family default 
@@ -119,7 +124,7 @@ Copiar del README cuando este terminado y extenderlo un poco si se considera
  necesario.
 \layout Section
 
-Comandos Desarollados
+Comandos Desarrollados
 \layout Subsection
 
 AFIMONIO
@@ -160,7 +165,36 @@ so
 Archivos de Output
 \layout Standard
 
-Afimonio.log: (Nico explicar aca que logea)
+El afimonio genera una salida al archivo afimonio.log la cual contiene informació
+n sobre la ejecución del programa.
+\layout Standard
+
+Si un archivo es válido, se añade una línea con el siguiente formato: 
+\layout Standard
+
+"$fecha $USER afimonio: "Se detecta archivo de llamadas $file" 
+\layout Standard
+
+Si el archivo tuviera un nombre inválido, la línea seria la siguiente: 
+\layout Standard
+
+"$fecha $USER afimonio:"Se rechaza el archivo $file".
+\layout Standard
+
+donde 
+\layout Standard
+
+$fecha: fecha actual con formato Día-Mes-Año-Hora:Minuto.
+\layout Standard
+
+$USER: nombre de usuario que ejecuto el script.
+\layout Standard
+
+$file: nombre del archivo que se procesó.
 \layout Subsubsection
 
 Ejemplos de invocación
@@ -197,7 +231,7 @@ Tipo de comando:
 Archivos de Input
 \layout Standard
 
-Procesa los archivos de llamadas que encuentre en el momento de invocacion
+Procesa los archivos de llamadas que encuentre en el momento de invocación
  en el directorio 
 \family typewriter 
 $PATH_ANTIFRAUDE/$DATADIR/enproceso
@@ -212,7 +246,7 @@ Afimonio
 Antifraude
 \series default 
  con dichos archivos, no obstante se lo puede alimentar con archivos de
- llamdas en forma manual, situándolos en el directorio anteriormente descripto.
+ llamadas en forma manual, situándolos en el directorio anteriormente descripto.
 \layout Subsubsection
 
 Archivos de Output
@@ -539,6 +573,83 @@ Genera 50 archivos con entre 10 y 50 líneas cada uno tomando los códigos
 Código Fuente
 \layout Standard
 
+Copy Paste cuando este cerrado.
+\layout Subsection
+
+util.sh
+\layout Standard
+
+
+\series bold 
+Tipo de comando:
+\series default 
+ Auxiliar, escrito en bash scripting
+\layout Subsubsection
+
+Archivos de Input
+\layout Standard
+
+No corresponde
+\layout Subsubsection
+
+Archivos de Output
+\layout Standard
+
+No corresponde
+\layout Subsubsection
+
+Ejemplos de invocación
+\layout Standard
+
+No corresponde.
+ El archivo es una colección de funciones comunes a los comandos.
+\layout Standard
+
+El archivo contiene las siguientes funciones de uso genérico:
+\layout Enumerate
+
+leer - Permite leer un valor desde el teclado, presentando una opción por
+ defecto seleccionada si el usuario ingresa una entrada nula.
+\layout Enumerate
+
+preguntar - Realiza una pregunta al usuario dando un set de opciones válidas
+ y solo aceptando una respuesta del set de preguntas.
+\layout Enumerate
+
+validar_solo_numeros - Verifica que la clave pasada contenga solo dígitos.
+\layout Enumerate
+
+lock - Genera un archivo de lock con el PID del programa
+\layout Enumerate
+
+unlock - Eliminar el archivo de lock de un programa
+\layout Enumerate
+
+is_lock - Consulta si un programa está lockeado
+\layout Enumerate
+
+lock_pid - Retorna el PID de un programa lockeado
+\layout Enumerate
+
+validar_rango - Valida si un valor está en un rango de valores
+\layout Enumerate
+
+die - Emite un mensaje de error y retorna al proceso padre un código de
+ error
+\layout Enumerate
+
+perr - Imprime un mensaje por la salida de error estandar
+\layout Enumerate
+
+put_log - Agrega una entrada a un archivo de log
+\layout Enumerate
+
+clean_log - Verifica el tamaño del archivo de log y lo trunca de ser necesario
+\layout Subsubsection
+
+Código Fuente
+\layout Standard
+
 Copy Paste cuando este cerrado.
 \layout Section
 
@@ -552,9 +663,54 @@ Archivos del Enunciado
 \layout Subsection
 
 Archivos Auxiliares
+\layout Subsubsection
+
+umbrales.id
 \layout Standard
 
-[ Por cada uno se debe poner nombre y detallar su estructura interna ]
+Este archivo contiene el último ID utilizado para los umbrales, a fin de
+ no tener que recalcularlo cada vez que se necesita crear un nuevo umbral.
+\layout Subsubsection
+
+afimonio.conf
+\layout Standard
+
+El archivo de configuración $~/.antifraude/conf/afimonio.conf almacena las
+ rutas a los directorios necesarios para la ejecución del script 
+\family typewriter 
+afimonio
+\family default 
+ y la ruta, nombre, y tamaño máximo del archivo de log.
+\layout Subsubsection
+
+antifraude.conf
+\layout Standard
+
+El archivo de configuración $~/.antifraude/conf/antifraude.conf almacena las
+ rutas a los directorios necesarios para la ejecución del script 
+\family typewriter 
+antifraude.pl
+\family default 
+ y la ruta, nombre, y tamaño máximo del archivo de log.
+\layout Subsubsection
+
+aficonf.conf
+\layout Standard
+
+El archivo de configuración $~/.antifraude/conf/aficonf.conf almacena las
+ rutas a los directorios necesarios para la ejecución del script 
+\family typewriter 
+aficonf
+\family default 
+ y la ruta, nombre, y tamaño máximo del archivo de log.
+\layout Standard
+
+Estos archivos fueron creados para que los diferentes scripts tengan un
+ lugar común donde buscar esa información para salvar el problema comentado
+ en el punto 1.2.
 \layout Subsection
 
 Set de Prueba (testcalls.tar.gz)
@@ -605,18 +761,18 @@ CALLGEN
  texto dentro suyo, el cual es rechazado por Antifraude.
 \layout Itemize
 
-1 archivo con nombre nó válido rechazado en instancia previa por el Afimonio.
+1 archivo con nombre no válido rechazado en instancia previa por el Afimonio.
 \layout Standard
 
 Se describen en la siguiente tabla, los archivos y registros que disparan
  alarmas o tienen close matches contra los 25 umbrales distribuidos en el
- paquete de instalacion, via el umbrales.param:
+ paquete de instalación, vía el umbrales.param:
 \layout Standard
 
 
 \begin_inset Float table
 wide false
-collapsed true
+collapsed false
 
 \layout Caption
 
@@ -826,7 +982,7 @@ Matched Umbral
 
 \layout Standard
 
-idem
+ídem
 \end_inset 
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -852,7 +1008,7 @@ idem
 
 \layout Standard
 
-idem
+ídem
 \end_inset 
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -930,7 +1086,7 @@ idem
 
 \layout Standard
 
-idem
+ídem
 \end_inset 
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -982,7 +1138,7 @@ idem
 
 \layout Standard
 
-idem
+ídem
 \end_inset 
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -1008,7 +1164,7 @@ idem
 
 \layout Standard
 
-idem
+ídem
 \end_inset 
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -1034,7 +1190,7 @@ idem
 
 \layout Standard
 
-idem
+ídem
 \end_inset 
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -1060,7 +1216,7 @@ idem
 
 \layout Standard
 
-idem
+ídem
 \end_inset 
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -1112,7 +1268,7 @@ idem
 
 \layout Standard
 
-idem
+ídem
 \end_inset 
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -1138,7 +1294,7 @@ idem
 
 \layout Standard
 
-idem
+ídem
 \end_inset 
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -1216,7 +1372,7 @@ Close match umbral 22, difiere tipo de llamada
 
 \layout Standard
 
-idem
+ídem
 \end_inset 
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -1277,7 +1433,7 @@ Archivo 199908220733.4515
 
 
 \series medium 
-Posee registros no validos detallados a continuacion.
+Posee registros no validos detallados a continuación.
  Los registros se contabilizan de 0 a N (Linea 1 = Reg 0)
 \layout Itemize
 
@@ -1349,6 +1505,6 @@ Ap
 
 (Esto deberia ser una hoja aparte que solo diga 1.6 Apéndice A) y las hojas
  posteriores son las páginas 3 en adelante del PDF oficial de la catedra,
- sacando al parte de archivos.
+ sacando la parte de archivos.
  3-15 más precisamente es lo que iria).
 \the_end