Return to ayuda.h CVS log

Up to [Repository ATC2] / ADD_ver_10 / Source Code / Header Files

Annotation of ADD_ver_10/Source Code/Header Files/ayuda.h, revision 1.2

1.2     ! rico        1: /********************************************************************/
        !             2: /*  ayuda.h                                                         */
        !             3: /*                                                                  */
        !             4: /*                                                                  */
        !             5: /*  Copyright (c) 1997-2006 Rafael Rico      (rafael.rico@uah.es)   */
        !             6: /*                                                                  */
        !             7: /*  Este fichero forma parte de ADD                                 */
        !             8: /*  (Analizador de Dependencias de Datos)                           */
        !             9: /*  Version 5.10.                                                   */
        !            10: /*                                                                  */
        !            11: /*                                                                  */
        !            12: /*  ADD es software libre. Puede redistribuirlo y/o modificarlo     */
        !            13: /*  bajo los términos de la Licencia Pública General de GNU         */
        !            14: /*  según es publicada por la Free Software Foundation, bien bajo   */
        !            15: /*  la versión 2 de dicha Licencia o bien (según su elección)       */
        !            16: /*  bajo cualquier versión posterior.                               */
        !            17: /*                                                                  */
        !            18: /*  ADD se distribuye con la esperanza de que sea útil,             */
        !            19: /*  pero SIN NINGUNA GARANTÍA, incluso sin la garantía MERCANTIL    */
        !            20: /*  implícita y sin garantizar la CONVENIENCIA PARA UN PROPÓSITO    */
        !            21: /*  PARTICULAR. Véase la Licencia Pública General de GNU para       */
        !            22: /*  más detalles.                                                   */
        !            23: /*                                                                  */
        !            24: /*  Debería haber recibido una copia de la Licencia Pública General */
        !            25: /*  junto con ADD. Si no ha sido así, escriba a la Free Software    */
        !            26: /*  Foundation, Inc., 51 Franklin St, Fifth Floor,                  */
        !            27: /*  Boston, MA  02110-1301  EEUU.                                   */
        !            28: /*                                                                  */
        !            29: /*  -------------------------- Historia --------------------------- */
        !            30: /*                                                                  */
        !            31: /*  $Id$                                                            */
        !            32: /*                                                                  */
        !            33: /*  Revisión 1.2. 01/2006                                           */
        !            34: /*  Se añade la licencia GPL y documentación en estilo Javadoc      */
        !            35: /*                                                                  */
        !            36: /*  Revisión 1.1. 09/2005                                           */
        !            37: /*  Versión inicial                                                 */
        !            38: /*                                                                  */
        !            39: /********************************************************************/
        !            40: 
1.1       rico       41: /******************************************************************************/
                     42: /* MÓDULO: ayuda.h                                                            */
                     43: /*                                                                            */
                     44: /* Texto de la ayuda.                                                         */
                     45: /******************************************************************************/
                     46: /* Fecha: 22 de septiembre de 2005                                            */
                     47: /******************************************************************************/
                     48: 
                     49: 
                     50: 
                     51: /* TEXTO DE AYUDA */
                     52: 
                     53: char *textoayuda[] = {
                     54: "ADD v5.1 (Analizador de Dependencias de Datos)\n"
                     55: "FICHERO DE AYUDA\n\n"
                     56: 
                     57: "Opciones\n"
                     58: "========\n\n"
                     59: 
                     60: "-h\t\teste texto de ayuda\n\n"
                     61: 
                     62: "Fichero de onfiguración\n"
                     63: "=======================\n\n"
                     64: 
                     65: "-f [ruta]\tcargar configuración desde fichero\n"
                     66: "\t\tsi no se da la ruta se toma una especificada por defecto:\n"
                     67: "\t\t'configuracion.cfg'\n"
                     68: "\t\tlos argumentos precedentes se sobreescriben\n"
                     69: "\t\tlos siguientes no se tienen en cuenta\n"
                     70: "\t\tpor defecto no se hace\n\n"
                     71: 
                     72: "Ficheros de arquitectura del repertorio de instrucciones\n"
                     73: "========================================================\n\n"
                     74: 
                     75: "-n ruta\t\tfichero de nemónicos (por defecto: 'IA16-nemos.isa')\n\n"
                     76: 
                     77: "-u ruta\t\tfichero de ubicaciones (por defecto: 'IA16-ubis.isa')\n\n"
                     78: 
                     79: "Origen de datos\n"
                     80: "===============\n\n"
                     81: 
                     82: "-Ot ruta\torigen de datos TRAZA (opción por defecto)\n\n"
                     83: 
                     84: "-Os ruta\torigen de datos SECUENCIA\n\n"
                     85: 
                     86: "-Oi hex\t\torigen de datos INSTRUCCIÓN HEXADECIMAL\n\n"
                     87: 
                     88: "Rango de procesamiento (sólamente se lee para analizar trazas)\n"
                     89: "==============================================================\n\n"
                     90: 
                     91: "-pr [1-100]%\tporcentaje de datos a analizar (sólo trazas)\n"
                     92: "\t\tpor defecto es el 100%\n\n"
                     93: 
                     94: "-pc [0-100]%\tcomienzo en porcentaje de los datos a analizar (sólo trazas)\n"
                     95: "\t\tpor defecto es el 0%\n\n"
                     96: 
                     97: "-ip nº\t\tinstrucción de comienzo del análisis (sólo trazas)\n"
                     98: "\t\tpor defecto es 0\n\n"
                     99: 
                    100: "-iu nº\t\tinstrucción final del análisis (sólo trazas)\n"
                    101: "\t\tpor defecto es 0 y significa que es la última del fichero\n\n"
                    102: 
                    103: "Evaluar\n"
                    104: "=======\n\n"
                    105: 
                    106: "-r\t\thacer recuentos\n"
                    107: "\t\tpor defecto no se hacen\n\n"
                    108: 
                    109: "-c [ruta]\tasignar CPI a cada instrucción (requiere fichero de procesador)\n"
                    110: "\t\tsi no se da la ruta se toma una especificada por defecto:\n"
                    111: "\t\t'uP-8086-01.pro'\n"
                    112: "\t\tpor defecto no se hace\n\n"
                    113: 
                    114: "-D\t\tNO analizar dependencias\n"
                    115: "\t\tpor defecto sí se hace\n\n"
                    116: 
                    117: "Parámetros de análisis de dependencias de datos\n"
                    118: "===============================================\n\n"
                    119: 
                    120: "-v tamaño\ttamaño de la ventana de instrucciones\n"
                    121: "\t\tpor defecto es 32; máximo 2048\n\n"
                    122: 
                    123: "-L lista\tlistado de ubicaciones de la pizarra\n\n"
                    124: 
                    125: "-k\t\tdesacoplar tipos de dependencias de datos\n"
                    126: "\t\tpor defecto no se hace\n\n"
                    127: 
                    128: "-dv\t\tno considerar dependencias verdaderas\n"
                    129: "\t\tpor defecto sí se consideran\n\n"
                    130: 
                    131: "-da\t\tno considerar antidependencias\n"
                    132: "\t\tpor defecto sí se consideran\n\n"
                    133: 
                    134: "-ds\t\tno considerar dependencias de salida\n"
                    135: "\t\tpor defecto sí se consideran\n\n"
                    136: 
                    137: "-o\t\tdesacoplar por origen de los operandos\n"
                    138: "\t\tpor defecto no se hace\n\n"
                    139: 
                    140: "-te\t\tno considerar dependencias debidas a explícitos\n"
                    141: "\t\tpor defecto sí se consideran\n\n"
                    142: 
                    143: "-ti\t\tno considerar dependencias debidas a implícitos\n"
                    144: "\t\tpor defecto sí se consideran\n\n"
                    145: 
                    146: "-s\t\tdesacoplar fuentes de dependencias de datos\n"
                    147: "\t\tpor defecto no se hace\n\n"
                    148: 
                    149: "-qd\t\tno considerar dependencias debidas a datos\n"
                    150: "\t\tpor defecto sí se consideran\n\n"
                    151: 
                    152: "-qa\t\tno considerar dependencias debidas a cómputo de direcciones\n"
                    153: "\t\tpor defecto sí se consideran\n\n"
                    154: 
                    155: "-qs\t\tno considerar dependencias debidas a tráfico con la pila\n"
                    156: "\t\tpor defecto sí se consideran\n\n"
                    157: 
                    158: "-qc\t\tno considerar dependencias debidas a códigos de condición\n"
                    159: "\t\tpor defecto sí se consideran\n\n"
                    160: 
                    161: "Calcular\n"
                    162: "========\n\n"
                    163: 
                    164: "-Cx\t\tcálculos a realizar\n"
                    165: "\t\tpor defecto sólo se calculan los pasos de computación\n"
                    166: "\t\tlos siguientes argumentos se pueden agrupar -Cxxx\n"
                    167: "\t\to bien pueden darse separados -Cx -Cx\n"
                    168: "\t\tx puede tomar los siguientes valores:\n\n"
                    169: 
                    170: "  m\t\tcalcular el CPI promedio (=> cpi)\n"
                    171: "  t\t\tcalcular el tiempo de ejecución (=> cpi; análisis dependencias)\n"
                    172: "  o\t\tobtener la lista de orden parcial (=> análisis dependencias)\n"
                    173: "  c\t\tgenerar la matriz de caminos (=> análisis dependencias)\n"
                    174: "  p\t\tNO calcular los pasos de computación (=> análisis dependencias)\n"
                    175: "  g\t\tcalcular el grado de paralelismo (=> pasos)\n"
                    176: "  a\t\tcalcular el acoplamiento (=> análisis dependencias)\n"
                    177: "  h\t\tconstruir el histograma de los pasos de computación (=> pasos)\n\n"
                    178: 
                    179: "Volcar información en ficheros\n"
                    180: "==============================\n\n"
                    181: 
                    182: "-Vx\t\tficheros a crear\n"
                    183: "\t\tel fichero de resultados siempre se crea\n"
                    184: "\t\tlos siguientes argumentos se pueden agrupar -Vxxx\n"
                    185: "\t\to bien pueden darse separados -Vx -Vx\n"
                    186: "\t\tx puede tomar los siguientes valores:\n\n"
                    187: 
                    188: "  d\t\tvolcar bases de datos\n"
                    189: "  c [ruta]\tcrear nuevo fichero de configuración\n"
                    190: "  v lista\tlistado de ventanas a salvar\n\n"
                    191: 
                    192: "-R ruta\t\tfichero de resultados (por defecto: 'resultados')\n\n"
                    193: 
                    194: "Nivel de notificaciones en el log\n"
                    195: "=================================\n\n"
                    196: 
                    197: "-N nivel\t0:todo; 1:sin configuración; 2:sólo errores\n\n"
                    198: 
                    199: "Interfase gráfica\n"
                    200: "=================\n\n"
                    201: 
                    202: "-Mx\t\tmostrar en pantalla\n"
                    203: "\t\tpor defecto no se presenta nada\n"
                    204: "\t\tlos siguientes argumentos se pueden agrupar -Mxxx\n"
                    205: "\t\to bien pueden darse separados -Mx -Mx\n"
                    206: "\t\tx puede tomar los siguientes valores:\n\n"
                    207: 
                    208: "  i\t\tpresentar información de la instrucción en curso\n"
                    209: "  v\t\tpresentar información de la ventana en curso\n"};
                    210: