X-Git-Url: https://git.llucax.com/z.facultad/75.08/llamadas.git/blobdiff_plain/91c9563c9984e85dfdb2578748627976e5cea077..e5e30b07fdffd68dc708d96af58f9ffca0afbe11:/doc/Informe7508.lyx diff --git a/doc/Informe7508.lyx b/doc/Informe7508.lyx index ed285ce..0220308 100644 --- a/doc/Informe7508.lyx +++ b/doc/Informe7508.lyx @@ -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 @@ -852,7 +1008,7 @@ idem \layout Standard -idem +ídem \end_inset @@ -930,7 +1086,7 @@ idem \layout Standard -idem +ídem \end_inset @@ -982,7 +1138,7 @@ idem \layout Standard -idem +ídem \end_inset @@ -1008,7 +1164,7 @@ idem \layout Standard -idem +ídem \end_inset @@ -1034,7 +1190,7 @@ idem \layout Standard -idem +ídem \end_inset @@ -1060,7 +1216,7 @@ idem \layout Standard -idem +ídem \end_inset @@ -1112,7 +1268,7 @@ idem \layout Standard -idem +ídem \end_inset @@ -1138,7 +1294,7 @@ idem \layout Standard -idem +ídem \end_inset @@ -1216,7 +1372,7 @@ Close match umbral 22, difiere tipo de llamada \layout Standard -idem +ídem \end_inset @@ -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