home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / mdf160.zip / MDF_ESP.TXT < prev    next >
Text File  |  1995-11-12  |  18KB  |  441 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   MDIFF  -  MPATCH
  12.                                     Versión  1.50
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.         Un programa simple pero completo para producir y aplicar patches a
  24.         programas y archivos de datos para DOS, OS/2, Windows 95 y Windows NT.
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                               Manual en idioma español.
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.               (C) 1995/96 Maurizio Giunti - Todos los derechos reservados
  47.  
  48.  
  49.  
  50.  
  51.  
  52.      1.INDICE
  53.  
  54.  
  55.      1.INDICE                                                                 2
  56.  
  57.  
  58.      2.GARANTIA                                                               3
  59.  
  60.  
  61.      3.DISTRIBUCION Y USO                                                     3
  62.  
  63.  
  64.      4.¿POR QUE?                                                              3
  65.  
  66.  
  67.      5.¿QUE HACE MDIFF-MPATCH?                                                3
  68.  
  69.  
  70.      6.EJEMPLOS                                                               3
  71.  
  72.  
  73.      7.DOS, OS/2, WINDOWS 95 Y WINDOWS NT                                     4
  74.  
  75.  
  76.      8.LIMITES Y ERRORES CONOCIDOS                                            4
  77.  
  78.  
  79.      9.MDIFF - MDIFF2 - MDIFFW                                                4
  80.  
  81.  
  82.      10.MPATCH - MPATCH2 - MPATCHW                                            5
  83.  
  84.  
  85.      11.MDF2EXE - MDF2EXE2 - MDF2EXEW                                         6
  86.  
  87.  
  88.      12.SUGERENCIAS                                                           6
  89.  
  90.  
  91.      13.LIBRERIAS PARA APLICAR PATCHES                                        6
  92.  
  93.  
  94.      14.REGISTRANDO MDIFF                                                     6
  95.  
  96.  
  97.      15.COMO CONTACTAR AL AUTOR                                               7
  98.  
  99.  
  100.      16.AGRADECIMIENTOS                                                       7
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                                                                               2
  107.  
  108.  
  109.  
  110.  
  111.  
  112.      2.GARANTIA
  113.      ESTE SOFTWARE Y LOS ARCHIVOS QUE LO ACOMPAÑAN SE VENDEN "COMO ESTAN" Y SIN
  114.      GARANTIA EN CUANTO A SU FUNCIONAMIENTO O COMERCIABILIDAD U OTRAS GARANTIAS
  115.      TANTO EXPLICITAS COMO IMPLICITAS.
  116.      La única garantía otorgada con este software es que ocupa espacio en su
  117.      disco. No se puede garantizar absolutamente que funcione perfectamente o
  118.      que sea la solución para su problema. Sin embargo, no es un virus y no
  119.      contiene (a menos que haya sido infectado o modificado después de la
  120.      compilación) troyanos, back-doors u otras basuras similares. En cada caso
  121.      el autor declina su responsabilidad directa o indirecta, por daños morales
  122.      o materiales que eventualmente puedan resultar de su uso.
  123.  
  124.      3.DISTRIBUCION Y USO
  125.      Este software pertenece a la categoría de programas Shareware: por lo que
  126.      se puede copiar y utilizar libremente por un período de prueba de 15 días.
  127.      Después de este período el usuario que desee continuar utilizándolo debe
  128.      registrar su copia enviando el importe de la registración al autor,
  129.      Maurizio Giunti.
  130.      Los usuarios que paguen el importe de la registración recibirán una "clave
  131.      de registración" que contenga su nombre (o el de su empresa/organización
  132.      para licencias a empresas).
  133.      Este software puede ser distribuído sin costo alguno, exceptuando el cargo
  134.      eventual por gastos de copiado o transporte/flete.
  135.      De todos modos, es imperativo que se distribuya el PAQUETE ORIGINAL sin
  136.      modificación ALGUNA.
  137.      Unica excepción: se puede distribuir el programa MPATCH.EXE, MPATCH2.EXE
  138.      y/o MPATCHW.EXE con uno o más archivos *.MDF creados con una copia
  139.      REGISTRADA de MDIFF. Además se puede distribuir cualquier archivo
  140.      ejecutable producido con MDF2EXE.EXE, MDF2EXE2.EXE y MDF2EXEW.EXE que
  141.      contengan únicamente patches MDF creados con una copia registrada de
  142.      MDIFF.
  143.      El autor de este programa no reclama derechos sobre los patches *.MDF.
  144.  
  145.      4.¿POR QUE?
  146.      Hace un tiempo tenía que distribuir una versión actualizada de un programa
  147.      mío: el paquete comprimido ocupaba más de 200 KB, y seguramente hubiera
  148.      sido más conveniente para todos actualizar el viejo ejecutable mediante
  149.      un patch. Me puse en búsqueda de un software que me permitiera crear y
  150.      distribuir un patch de mis programas para DOS y OS/2: para DOS encontré
  151.      algunos (pero ninguno me satisfizo por varios motivos); para OS/2 no
  152.      encontré ni uno! Por lo tanto, decidí hacer uno y... aquí está! 8-)
  153.  
  154.      5.¿QUE HACE MDIFF-MPATCH?
  155.      MDIFF crea un archivo binario con las diferencias entre dos archivos. Con
  156.      MPATCH y el archivo original se puede recrear el nuevo archivo partiendo
  157.      del archivo de diferencias. Qué hay de bueno en todo ésto? Simple:
  158.      suponiendo que el archivo de diferencias sea más pequeño que el nuevo
  159.      archivo, es más conveniente distribuir sólo ésto, en lugar del archivo
  160.      completo, sobre todo si la distribución se hace por modem.
  161.  
  162.      6.EJEMPLOS
  163.      Como un ejemplo puse en dos directorios de nombre VIEJO y NUEVO, el MDIFF
  164.      versión 1.45a (una versión alfa (de prueba) en progreso) y MDIFF 1.45
  165.      respectivamente:
  166.  
  167.      Directorio de VIEJO\*.EXE
  168.      MDIFF.EXE       46602  16/08/95   21.01
  169.  
  170.      Directorio de NUEVO\*.EXE
  171.      MDIFF.EXE       46602   21/08/95  00.45
  172.                                                                               3
  173.  
  174.  
  175.  
  176.  
  177.  
  178.      C:\>mdiff VIEJO\MDIFF.EXE NUEVO\MDIFF.EXE
  179.      MDIFF  V1.50 - MDF file generator (Dos)
  180.      (C) Copyright 1995/96 Maurizio Giunti
  181.  
  182.      Registered to: MAURIZIO GIUNTI
  183.  
  184.      VIEJO\MDIFF.EXE,NUEVO\MDIFF.EXE => MDIFF.MDF
  185.      Working...(100%)   MDF size: 1215 bytes   Rate: 2%
  186.      <Done!>
  187.  
  188.      Directorio de *.MDF
  189.      MDIFF.MDF        1215   7/10/95  13.43
  190.  
  191.      Ahora podemos aplicar el patch llamado MDIFF.MDF al archivo viejo para
  192.      reconstruir el nuevo:
  193.  
  194.      C:\>mpatch MDIFF.MDF VIEJO\MDIFF.EXE
  195.      MPATCH  V1.50 - MDF file applier (Dos)
  196.      (C) Copyright 1995/96 Maurizio Giunti
  197.  
  198.      MDF file produced by: MAURIZIO GIUNTI
  199.  
  200.      Working: 0% |###########| 100%
  201.      <Done!>
  202.  
  203.      I obtain the following file:
  204.  
  205.      Directorio de *.EXE
  206.      MDIFF.EXE       46602  21/08/95   0.41
  207.  
  208.      que es el EQUIVALENTE a nivel BINARIO del nuevo archivo.
  209.  
  210.      7.DOS, OS/2, WINDOWS 95 Y WINDOWS NT
  211.      MDIFF y MPATCH para DOS, OS/2 y Windows32 se obtienen a través de la
  212.      compilación del mismo fuente, por lo tanto, no existe ninguna diferencia
  213.      en la funcionalidad en el uso de los programas sobre los distintos
  214.      sistemas operativos. Además, los archivos *.MDF producidos con MDIFF para
  215.      DOS pueden ser utilizados con MPATCH para OS/2 o Windows32 y viceversa.
  216.  
  217.      8.LIMITES Y ERRORES CONOCIDOS
  218.      MDIFF no puede trabajar con archivos de más de 16 MB y no puede procesar
  219.      archivos más pequeños que 20 veces el largo de un chunk.
  220.      Además, MDIFF para OS/2, habiéndose obtenido a través de una compilación
  221.      directa del fuente de MDIFF para DOS, no está capacitado para trabajar
  222.      con los atributos extendidos (EA) y simplemente se limitará a ignorarlos.
  223.      Además, si se construye un patch usando MDIFF para DOS u OS/2, al
  224.      aplicarlo usando MPATCH para Windows32 se obtendrá una fecha y hora
  225.      incorrecta en el nuevo archivo. Lo mismo sucede si se construye un patch
  226.      con MDIFF para Windows32 y se lo aplica con MPATCH para DOS u OS/2. Esto
  227.      error surge de una implementación distinta de la función utime() en los
  228.      compiladores de Microsoft y Borland.
  229.  
  230.      9.MDIFF - MDIFF2 - MDIFFW
  231.      El programa MDIFF se ocupa de comparar dos archivos y de almacenar las
  232.      diferencias entre ellos en un tercer archivo que, generalmente, es mucho
  233.      más compacto. Esta es la sintaxis de la línea de comandos:
  234.  
  235.                                                                               4
  236.  
  237.  
  238.  
  239.  
  240.         MDIFF [-C<c>] [-R<r>] [-F<f>] [-S] [-Z] [-P<pwd>] <OldFile> <NewFile>
  241.                                      [<MDFfile>]
  242.  
  243.      <OldFile> es obviamente el nombre de la versión anterior del archivo a
  244.      comparar, mientras que <NewFile> es el nombre de la versión actual. Si es
  245.      necesario, se puede especificar el nombre del archivo de diferencias a
  246.      crear <MDFFile>; si no, MDIFF crea un archivo que tiene el mismo nombre
  247.      que <NewFile> pero con extensión ".MDF".
  248.      Para buscar las partes similares en los archivos MDIFF usa un string base
  249.      de largo predefinido de nombre chunk. El largo del chunk es de 16 bytes
  250.      por defecto, pero puede ser cambiado, en un rango 4-256, con el switch -C
  251.      seguido del largo deseado.
  252.      Cuando MDIFF pierde el sincronismo entre los dos archivos que está
  253.      comparando trata de resincronizarlos buscando el chunk que está elaborando
  254.      en el archivo viejo. Esa búsqueda se efectúa en un entorno del último
  255.      chunk encontrado, en el rango definido por el switch -R. Por defecto ese
  256.      rango es de 8 bloques de 512 bytes, pero puede variar entre 1 y 16.
  257.      Si esa búsqueda falla MDIFF trata de forzar ese sincronismo entre los dos
  258.      archivos buscando en un rango mayor, definido por 1/16 del tamaño del
  259.      archivo viejo. Esta segunda búsqueda puede ser deshabilitada o su rango
  260.      puede ser cambiado mediante el switch -F.
  261.      Especificando el switch -S, una vez terminada la operación, MDIFF arrojará
  262.      algunos datos acerca de la composición del archivo de diferencias.
  263.      También es posible, mediante el switch -Z, insertar en el archivo de
  264.      diferencias un breve comentario (con un máximo de 2 KB), que será
  265.      visualizado durante la aplicación del patch por parte de MPATCH. El
  266.      comentario se toma del dispositivo de entrada standard (stdin) y, por lo
  267.      tanto, puede ser tomado de un archivo usando el comando de redirección
  268.      "<".
  269.      Mediante el switch -P se puede proteger el patch con una clave de
  270.      acceso (<pwd>): aquel que no conozca la clave no podrá aplicar el patch.
  271.      Por favor tenga en cuenta que el campo de clave hace distinción entre
  272.      mayúsculas y minúsculas.
  273.  
  274.      10.MPATCH - MPATCH2 - MPATCHW
  275.      Con el archivo anterior y el archivo de diferencias .MDF se puede
  276.      reconstruir el archivo nuevo usando MPATCH. Esta es la sintaxis de la
  277.      línea de comandos:
  278.  
  279.                  MPATCH [-P<pwd>] <MDFfile> [<OldFile> [<NewFile>]]
  280.  
  281.      El único parámetro obligatorio es el nombre del archivo de diferencias
  282.      <MDFFile>, ya que el mismo contiene el nombre de los otros dos archivos,
  283.      pero es posible modificar esa imposición simplemente especificando los
  284.      nombres deseados en el orden correspondiente. MPATCH acepta sólo el
  285.      switch -P que permite especificar una eventual clave de acceso
  286.      necesaria para aplicar el patch.
  287.      En caso de error MPATCH retorna un errorlevel que debe ser interpretado
  288.      según la siguiente tabla:
  289.      0        "¡OK!"
  290.      1        "¡Memoria insuficiente!"
  291.      2        "¡No se puede abrir el archivo MDF!"
  292.      3        "¡Archivo MDF inválido!"
  293.      4        "¡Las versión del archivo MDF no coincide!"
  294.      5        "¡NO REGISTRADO!"
  295.      6        "¡Archivo VIEJO corrupto o incorrecto!"
  296.      7        "¡No se puede abrir el archivo VIEJO!"
  297.      9        "¡No se puede crear el archivo NUEVO!"
  298.      10       "¡Falla general: archivo NUEVO corrupto!"
  299.      11       "¡El archivo VIEJO y el NUEVO no pueden ser el mismo!"
  300.      12       "¡El archivo nuevo ya fue patcheado!"
  301.      13       "¡Clave de acceso incorrecta!"
  302.  
  303.  
  304.                                                                               5
  305.  
  306.  
  307.  
  308.  
  309.      11.MDF2EXE - MDF2EXE2 - MDF2EXEW
  310.      MDF2EXE es un simple programa que se ocupa de almacenar uno o más (hasta
  311.      127) archivos de patch MDF en un archivo ejecutable (DOS, OS/2 o
  312.      Windows32).
  313.      Este tipo de ejecutable se llama patch autoinstalable.
  314.      La sintaxis del programa MDF2EXE:
  315.  
  316.            MDF2EXE <mdf_file 1> [<mdf_file 2>....<mdf_file n>] <exe_file>
  317.  
  318.      Los distintos <mdf_file x> pueden contener "wildcards" (*,?); en este
  319.      caso MDF2EXE buscará automáticamente los archivos a insertar.
  320.      El archivo ejecutable creado (que DEBE tener extensión .EXE) podrá ser
  321.      ejecutado sin ningún parámetro en la línea de comandos y buscará
  322.      automáticamente los archivos a actualizar. Opcionalmente se puede
  323.      utilizar el switch -P para especificar la clave de acceso, o los switches
  324.      -V o -L para visualizar la lista de los patches contenidos en el archivo.
  325.      Advertencia: no se deben comprimir los patches autoinstalables con PKLite,
  326.      LZexe u otros programas de compresión/encriptación similares; de otro
  327.      modo, dejarán de funcionar.
  328.  
  329.      12.SUGERENCIAS
  330.      El método óptimo para construir un archivo de diferencias sería el de
  331.      buscar en todo el archivo viejo los chunks que componen el nuevo archivo;
  332.      obviamente, ese método sería de una lentitud exasperante.
  333.      El algoritmo en que se basa MDIFF representa un compromiso entre resultado
  334.      y velocidad de ejecución, por eso conviene regular los parámetros de
  335.      funcionamiento de MDIFF mediante los switches correspondientes. Veamos
  336.      cómo actuar en algunas situaciones típicas:
  337.      1.Archivos con poquísimas modificaciones: es bueno utilizar un chunk muy
  338.        amplio (32, 64 o más) para reducir al máximo el tamaño del archivo de
  339.        diferencias, sobre todo si se está trabajando con archivos de texto o de
  340.        bases de datos.
  341.      2.Archivos de texto: cada tanto un chunk de largo 32 es el más indicado; es
  342.        conveniente probar de disminuir o eliminar el sincronismo forzado
  343.        mediante el switch -F.
  344.      3.Archivos ejecutables muy grandes: a menudo se obtienen resultados
  345.        mejores agrandando el rango de búsqueda del sincronismo mediante el
  346.        switch -R.
  347.      Un último consejo: no esperen milagros de MDIFF. Si los dos archivos
  348.      comparados son muy distintos el archivo de patch resultará muy grande. En
  349.      estos casos hay poco que hacer, y hay que resignarse a distribuir el nuevo
  350.      archivo entero. MDIFF es realmente útil sólo si el número de
  351.      modificaciones hechas a los archivos no es demasiado grande.
  352.  
  353.  
  354.  
  355.      13.LIBRERIAS PARA APLICAR PATCHES
  356.      Incluído en este paquete encontrará un conjunto de librerías para crear
  357.      sus propios programas para aplicar patches. Estas librerías NO PUEDEN
  358.      aplicar patches MDF creados con una copia NO REGISTRADA de MDIFF.
  359.      Esto no significa que no sean completamente funcionales. Significa que
  360.      las librerías sólo pueden aplicar patches producidos por una copia
  361.      registrada de MDIFF.
  362.  
  363.  
  364.  
  365.      14.COMO REGISTRARSE
  366.      Si registra MDIFF obtendrá una CLAVE DE REGISTRACION que contenga su
  367.      nombre (o el de su (o el de su empresa/organización para licencias a
  368.      empresas). Cuando produzca un patch con un MDIFF registrado, se grabará su
  369.      nombre en el patch y cuando MPATCH aplique los mismos mostrará su nombre.
  370.      Además, todo usuario registrado tiene autorización para distribuir
  371.      libremente MPATCH.EXE, MPATCH2.EXE y MPATCHW.EXE con cualquier archivo MDF
  372.      que haya creado. También se pueden distribuir libremente los patches
  373.      autoinstalables creados por usuarios registrados.
  374.      ¡No se requiere el pago de royalties ni de cargos extras!
  375.      Incluído en el paquete de MDIFF encontrará un programa de registración
  376.      para Windows de nombre REGISTER.EXE. Por favor ejecútelo en el entorno
  377.      Windows.
  378.                                                                               6
  379.  
  380.  
  381.  
  382.  
  383.      REGISTER.EXE es una pequeña aplicación para Windows escrita por Grzegorz
  384.      (Greg) Kochaniak, que provee toda la información necesaria para comprar
  385.      MDIFF y que permite mandarla directamente al servicio Kagi Shareware por
  386.      correo postal, correo electrónico (e-mail) o fax. Si no usa Windows, por
  387.      favor contáctese conmigo.
  388.      Por cualquier información acerca de Kagi Shareware por favor lea el
  389.      archivo KAGI.TXT.
  390.  
  391.      15.COMO CONTACTAR AL AUTOR
  392.      Por cualquier problema o pregunta puede contactarme en las siguientes
  393.      direcciones:
  394.  
  395.      correo postal:
  396.                      Maurizio Giunti
  397.                      Via G.B. Foggini, 24
  398.                      50142 Firenze (FI)
  399.                      ITALY
  400.  
  401.      e-mail:
  402.                      Fidonet:      2:332/102.3
  403.                      Internet:     giunti@kagi.com
  404.                                    giunti@abeline.it
  405.                                    giunti@statsun.ds.unifi.it
  406.  
  407.      16.AGRADECIMIENTOS
  408.      Querría agradecer brevemente a todos aquellos que me han ayudado en el
  409.      desarrollo de este software y de su documentación, y a aquellos que se
  410.      ofrecieron con coraje como beta-testers. En orden alfabético:
  411.  
  412.                              Mauricio Mello de Andreade
  413.  
  414.                                    Andrea Baitelli
  415.  
  416.                                     Silvia Borri
  417.  
  418.                                  Juan Jose Comellas
  419.  
  420.                                     Filippo Dini
  421.  
  422.                                  Fabrizio Fioravanti
  423.  
  424.                                  Cristiano Guidoccio
  425.  
  426.                                 Giovanni Lopes Pegna
  427.  
  428.                                   Marco Maccaferri
  429.  
  430.                                   Marco Menichelli
  431.  
  432.                                    Giuseppe Scarpi
  433.  
  434.                                    Toni Tatafiore
  435.  
  436.                                     Duncan Wilcox
  437.  
  438.  
  439.  
  440.                                                                               7
  441.