[Main]
[Docs]
[Installs]
[Search]
[Team]
[Guestbook]
[Links]
Uso
WHDLoad puede ser ejecutado desde la línea de comandos (CLI/Shell) o desde Workbench.
Las opciones pueden especificarse en un fichero de configuración global y mediante
argumentos o Tooltypes. La opción Esclavo usualmente es requerida.
Otras opciones pueden tambien ser necesarias, dependiendo del hardware y el programa
a ejecutar desde WHDLoad.
Cuando se ejecuta desde la línea de comandos WHDLoad termina con uno de los siguientes
códigos de retorno:
- 0 - ejecución exitosa
- 5 - el Precargador ha sido cancelado con la tecla Esc en la ventana inicial
- 10 - error, el Esclavo no puede ser ejecutado debido a problemas previos, se muestra el mensaje de error
- 20 - error fatal, no hay suficiente memoria libre
- > 100 - el Esclavo ha sido ejecutado, ha retornado con 100 + TDREASON
Opciones y configuración global
Hay opciones locales y globales. Las opciones locales se especifican como argumentos
a través de la línea de comandos o como ToolTypes al ejecutarlo desde Workbench.
Si se inicia desde Workbench utilizando un ícono WHDLoad intentará actualizar
el ícono en relación a las opciones PreloadSize/N, Config
y otras opciones potencialmente cambiadas en la ventana emergente. Si se desea dicha operación
también al arrancar desde herramientas de línea de comando como WBRun (provista en OS3.5/3.9)
deberá utilizarse para simular el arranque desde Workbench.
El fichero de configuración global es "S:WHDLoad.prefs
". Es un fichero normal
en ASCII y contiene una opción por línea. Las líneas vacías y los comentarios son
ignorados. Los comentarios están basados en líneas, comienzan con el caracter ";
"
y continúan hasta el final de la línea.
Un fichero de configuración de ejemplo está contenido en el paquete
WHDLoad ("S/WHDLoad.prefs
").
Lista de todas las opciones disponibles
Hay tres tipos de opciones:
numericas: |
el valor de la opción es un entero,
en la línea de comandos Ud. debe usar notación decimal, como ToolType Ud.
puede también utilizar notación hexadecimal indicada por el prefijo "$ "
|
cadena de caracteres: |
el valor de la opción es una cadena |
conmutador: |
la opción esta habilitada si se especifica (valor booleano) |
La columna Local muestra si la opción puede utilizarse en la línea de comandos y como un
tipo de herramienta (tooltype) en el ícono. La columna Global muestra si la opción puede ser
utilizada en el archivo de configuración global.
Muchas de las opciones no están disponibles en WHDLoadCD32. La
columna CD³² muestra si la opción esta disponible en esta versión especial de WHDLoad.
Ejemplos de uso
Descripción de cada Opción
ButtonWait/S
Esta opción no afectara a WHDLoad en si, pero puede ser comprobada por el Esclavo.
El significado de esta opción es que si se configura, los usuarios quieren que el programa
instalado espere la pulsación de un botón cuando muestre pantallas y/o ejecute música
y normalmente lo hace solamente por un tiempo muy limitado (debido al tiempo de carga
desde disco duro/RAM comparado con la carga lenta desde disco).
BranchCache/S
Esta opción activa la caché de ramificaciones del 68060. En otros tipos de CPU no
tiene efecto.
La opción no tiene efecto si también se configura NoCache/S.
Cache/S
Esta opción activa la caché de instrucciones y desactiva la caché de datos para
el programa instalado. En el 68030 también se activa el acelerador (burst) de instrucciones.
Si la MMU esta siendo utilizada por WHDLoad, marca la
memoria Chip como Cacheable Writethrough (imprecisa).
La opción no tiene efecto si también se configura NoCache/S.
Chk/S
Esta opción es un atajo y activa las opciones ChkBltSize/S, ChkBltWait/S y ChkColBst/S.
ChkAudPt/S
Esta opción verifica que los punteros escritos
a los punteros a medida (Custom) de datos de audio sean direcciones válidas de memoria chip. Los
punteros no deben ser nulos y estar dentro de BaseMem. Esto solo funciona en conjunto
con una de las opciones SnoopOCS/SnoopECS/SnoopAGA.
Esta funcionalidad debería ayudar en el diagnóstico de problemas con las rutinas de
reproducción de audio.
ChkBltHog/S
Esta opción comprueba todo el tiempo que el bit blthog
(bltpri
)
en el registro custom.dmacon no este configurado.
Esta funcionalidad solo funciona conjuntamente con una de las opciones
SnoopOCS/SnoopECS/SnoopAGA.
Activando el blthog
otorga al blitter prioridad sobre la CPU respecto
a los accesos a memoria, lo cual puede causar problemas en determinadas configuraciones
de equipo. También puede mejorar el rendimiento para darle al procesador más ciclos de bus.
ChkBltSize/S
Esta opción comprueba que el programa instalado use el blitter en forma correcta,
de tal forma que solo se utilicen áreas de memoria validas para operaciones
de blitter. Esta funcionalidad solo funciona conjuntamente con una de las opciones
SnoopOCS/SnoopECS/SnoopAGA.
Se verificarán todas las operaciones de blitter excepto el modo línea.
ChkBltWait/S
Esta opción comprueba que el programa instalado espere correctamente que el blitter
termine antes de comenzar un nuevo trabajo con el blitter. Esta funcionalidad solo
funciona conjuntamente con una de las opciones SnoopOCS/SnoopECS/SnoopAGA.
ChkColBst/S
Esta opción comprueba todo el tiempo que el bit color
en el registro custom.bplcon0
este configurado. Esta funcionalidad solo funciona conjuntamente con una de las opciones
SnoopOCS/SnoopECS/SnoopAGA.
Cierto equipamiento en particular el corrector de parpadeo (flickerfixer) requiere que este
bit esté configurado para poder generar una señal de video correcta. Por lo tanto este bit debe
estar configurado para máxima compatibilidad.
Las verificaciones se realizan mediante escritura directa a custom.bplcon0
y todas
las listas de Copper.
ChkCopCon/S
Esta opción comprueba que el programa instalado no active el acceso del Copper a los
registros DMA configurando custom.copcon
.
Esta funcionalidad solo funciona conjuntamente con una de las opciones
SnoopOCS/SnoopECS/SnoopAGA.
A veces puede resultar útil detectar si los programas utilizan el Copper
para controlar las actividades de DMA.
ChkInts/S
Esta opción comprueba durante cada interrupción si hay un par que se corresponda
en intreq
e intena
configurado para esta interrupción.
En caso negativo el programa instalado terminará con un mensaje de error apropiado.
Esta funcionalidad permite la detección sencilla de problemas de confirmación de
interrupción (interrupt acknowledge) en máquinas rápidas (68040/060) o con
hardware fallido que cause interrupciones no esperadas. Debido a que dicha
condición tambien puede darse si las interrupciones son desactivadas
configurando intena
simultáneamente con la ocurrencia de una
interrupción, esto ha sido configurado como una opción que puede activarse o
desactivarse.
A partir de la versión 17.1 de WHDLoad esta opción tambien activa todas las
verificaciones de opciones correctas y teclado para los niveles de interrupción
4-6 que normalmente se realizan únicamente en los niveles 1-3.
ChipNoCache/S
Esta opción desactiva la cacheabilidad de la Memoria Chip (BaseMem). Debe ser usada en hardware
que no permite la cacheabilidad de la Memoria Chip (por ej. tarjetas BlizzardPPC) para
evitar enlentecimiento en la velocidad de ejecución del programa instalado.
Ver también Gestión de la Caché de la CPU.
Config/K
Utilizando esta opción los items de configuración
pueden ser especificados lo cual será mostrado en la ventana de inicio de WHDLoad.
Esta opción tiene preferencia por sobre la ws_config
especificada en el Esclavo. Para la sintaxis a utilizar vea ws_config
en los autodocs.
Si no existe la ws_config en el Esclavo ni
Config/K configurado y el Esclavo chequea los ítems Custom1-5/K/N/ButtonWait/S
via la función resload_Control,
WHDLoad agregará una opción Config/K al ícono si es arrancada desde el Workbench.
El tipo de los ítems será derivado de los valores actuales de las opciones
Custom1-5/K/N (0-1 booleano, 2-63 lista, >63 binario).
ConfigDelay/K/N
Esta opción especifica el tiempo en
1/50vos de segundos que WHDLoad mostrará la ventana de información durante el arranque si
están presentes en ella cualquiera de los botones (ver Config/K y
Expert/S). Si ConfigDelay/K/N es menor que ReadDelay/K/N
or SplashDelay/K/N la opción es ignorada. La ventana se mostrará
como mínimo mientras Preload/S está siendo procesado. Si un
botón de configuración es presionado el tiempo para ConfigDelay se reinicia.
Si la
opción se configura a -1 un botón Arranque (Start) será agregado a la ventana y permanecerá
abierta hasta que dicho botón sea presionado. La ventana también podrá cerrarse presionando
las teclas Espacio, Retorno, Entrada o el botón de disparo del mando en el puerto #1. Si se presiona Escape (Esc) WHDLoad detendrá
el Preload/S y terminará inmediatamente.
CoreDump/S
Si se selecciona, al salir de cada programa instalado, WHDLoad creara un volcado
de memoria y registros. Esto puede ser útil para extraer un modulo de música
del vuelco de memoria o para eliminación de errores.
CoreDumpPath
El directorio destino para todos los ficheros de volcados
creados por WHDLoad.
Custom/K, Custom1/K/N, Custom2/K/N, Custom3/K/N,
Custom4/K/N, Custom5/K/N
Estas opciones no son utilizadas por WHDLoad en si, pero pueden ser comprobadas
por el Esclavo para controlar varias características especificas del Esclavo.
Custom/K puede contener una cadena y Custom1-5/K puede contener solamente un entero.
Compruebe la documentación del instalador especifico si este soporta las opciones
Custom.
D/S
Esta opción es útil para eliminación de errores. Si la opción esta activada
y un congelador por software soportado (HRT/TK) se encuentra en memoria, WHDLoad
simulara una NMI antes de ejecutar la primer instrucción de CPU contenida en el Esclavo.
Data/K
Usando esta opción se puede especificar un directorio que será el directorio base para operaciones de ficheros del programa instalado.
También pueden especificarse múltiples directorios separados por coma (por lo tanto ningún nombre de directorio especificado puede contener una coma!). Si
se utilizan múltiples directorios de datos durante la carga del programa se intentarán todos los directorios especificados para leer el o los archivos necesarios.
La escritura siempre se realizará en el primer directorio de datos.
Esta opción sobreescribe el valor de ws_CurrentDir contenido en el Esclavo.
DCache/S
Esta opción activa las caches de instrucciones y datos para el programa instalado.
En el 68030 también se activa el acelerador (burst) de instrucciones.
Si la MMU esta siendo utilizada por WHDLoad marcara la memoria Chip como Cacheable
Writethrough (imprecisa).
La opción no tiene efecto si NoCache/S esta configurado.
DebugKey/K/N
Configura el código rawkey para salir del programa y
escribir archivos de volcado (coredump).
Esta opción solo funcionara si el modo experto está activo
y el VBR es movido por WHDLoad (NoVBRMove/S no esta configurado
y la CPU es como mínimo un 68010) o si el Esclavo en si mismo lo soporta.
ExecuteArgs
Con esta opción es posible
proveer argumentos a los scripts/programas ejecutados a través de las opciones ExecuteCleanup, ExecutePreDisk, ExecutePostDisk y ExecuteStartup. Usando esta opción se vuelve posible
controlar el comportamiento de los scripts/programas dentro de cada instalador individual
sin que sea necesario tener muchos scripts diferentes.
ExecuteCleanup
Con esta opción puede especificarse un comando que será ejecutado por WHDLoad al salir.
Utilizando el comando de sistema Execute también puede ejecutarse un script.
Puede encontrar un script de ejemplo en el paquete WHDLoad ("S/WHDLoad-Cleanup
").
ExecutePreDisk
Con esta opcion puede especificase
un comando que sera ejecutado por WHDLoad antes de realizar cualquier acceso a
disco para leer/guardar datos. Si hay una conmutacion al sistema operativo el comando
se ejecutara antes del acceso al disco. El mismo tambien se ejecutara durante la
finalizacion de WHDLoad.
Cuando se ejecuta este comando el subsistema de operación de gráficos se desactiva y
la base de Intuition se bloquea. Por lo tanto este comando no debe ejecutar o resultar en
la ejecución de cualquier cambio a Intuition o el sistema se colgará!
ExecutePostDisk
Con esta opcion puede especificase
un comando que sera ejecutado por WHDLoad luego de realizar cualquier acceso a
disco para leer/guardar datos. Si hay una conmutacion al sistema operativo el comando
se ejecutara luego del acceso al disco. El mismo tambien se ejecutara durante el
inicio de WHDLoad.
Cuando se ejecuta este comando el subsistema de operación de gráficos se desactiva y
la base de Intuition se bloquea. Por lo tanto este comando no debe ejecutar o resultar en
la ejecución de cualquier cambio a Intuition o el sistema se colgará!
ExecuteStartup
Con esta opción puede especificarse un comando que será ejecutado por WHDLoad durante
el arranque. Puede usarse para desactivar hardware que cause problemas en conjunto con
WHDLoad, tales como las pilas IP o USB. Vea el capítulo Errores para
más información.
Utilizando el comando de sistema Execute también puede ejecutarse un script.
Puede encontrar un script de ejemplo en el paquete WHDLoad ("S/WHDLoad-Startup
").
Expert/S
Esta opción activa el modo experto de WHDLoad.
Afecta la funcionalidad DebugKey/S y los mensajes de advertencia
durante la conmutación entre el programa instalado y el SO (pantallas con ciclo
de colores mediante copper).
Si el modo experto no está activo, la DebugKey/S no está disponible.
En el modo experto aparece otro botón en algunos de los diálogos de error producidos por WHDLoad.
Este botón llamado Show Regs permite
visualizar información sobre los registros y el estado similar a la escrita
por un volcado de registros (register dump).
Adicionalmente se agregan algunos botones a la ventana de inicio
(splash window) para conmutar una serie de
opciones relacionadas con la eliminación y seguimiento de errores.
Las opciones cambiadas son salvadas en el ícono si se arranca desde el Workbench.
ExpChip/S, ExpLocal/S, Exp24Bit/S
Si el programa instalado usa memoria de expansión (ws_ExpMem) esta opción puede usarse para
forzar a WHDLoad a asignar esta memoria respectivamente a Memoria Chip, Memoria Local o
Memoria de 24 bits DMA. Esto puede resultar en una degradación del rendimiento dado que
la memoria especificada puede ser accedida mas lentamente por la CPU comparada con la
memoria Fast por defecto. Ud. puede usar herramientas de terceros (por ej. SysInfo,
GvpInfo,...) para comprobar la configuración de su memoria y ver que memoria
tiene que propiedades.
En general estas opciones están pensadas para solucionar problemas de compatibilidad de
programas instalados en máquinas rápidas haciéndolas mas lentas durante la ejecución
mediante el uso apropiado de memoria mas lenta.
FileLog/S
Esta opción es solamente para eliminación de errores.
Ver Volcados y Archivos de Bitácora para
mas informacion.
FreezeKey/K/N
Si Ud. esta usando uno de los congeladores por software soportados (HRTmon o Thrillkill)
puede usar esta opción para configurar un código rawkey que al
ser presionado ocasionara que WHDLoad entre en el modo congelador. Para que funcione,
el VBR debe ser movido por WHDLoad (NoVBRMove/S no debe estar
configurado y la CPU debe ser al menos un 68010) y el congelador debe estar activo.
Consulte también el capítulo Monitores del Sistema / Congelador
para mayor información.
FullChip/S
Especificar esta opción causa que WHDLoad salve y restaure no solo la memoria Chip indicada como ws_BaseMemSize en el Esclavo
sino toda la memoria Chip (execbase.MaxLocMem). Si WHDLoad utiliza la MMU presente para proteger la memoria esto cubrirá solo los accesos ilegales
causados por la CPU. No se cubrirán los accesos directos de los coprocesadores tales como Blitter/Disk-DMA.
Estas acciones de Acceso Directo a Memoria (DMA) pueden corromper la memoria Chip no detectada por el sistema de protección de memoria de WHDLoad.
Con esta opción seleccionada dichas fallas no podrán dañar el sistema operativo anfitrión dado que la memoria Chip será salvada y restaurada en forma completa.
Antes que el programa instalado sea iniciado la memoria Chip adicional salvada (la porción entre BaseMemSize y MaxLocMem) será rellenada con un patrón especial de bits.
Luego que el programa instalado haya terminado su ejecución, WHDLoad verificará si la memoria adicional ha sido alterada. Si existen cambios
WHDLoad mostrará el mensaje de error apropiado. Solamente en este caso la memoria adicional se escribirá al fichero de volcado de memoria
(no el fichero de volcado completo), lo cual permitirá investigaciones posteriores del problema.
Esta opción puede ser útil para desarrollo/depuración para evitar corromper el AmigaOS anfitrión y también como ayuda para instaladores temporariamente no funcionales que no hayan
corregido completamente todos los errores del programa instalado.
FullChip/S no puede ser activado conjuntamente con la opción
ExpChip/S. Si ambas están activadas se ignora FullChip/S.
LogBuffer/K/N
Al activar esta opción puede especificarse
el buffer interno de WHDLoad utilizado para enviar mensajes de bitácora de las funciones
FileLog/S y resload_Log.
El tamaño por defecto del buffer es de 4096 octetos. Se asigna espacio a este buffer
solamente si la opción FileLog/S ha sido especificada.
Si el buffer está lleno, WHDLoad interrumpirá el programa instalado y conmutará
al sistema operativo para descartar el buffer y escribir los contenidos al
archivo de bitácora. Para evitar dichas conmutaciones el tamaño del buffer debe ser
seleccionado adecuadamente grande para contener tantas entradas como sea posible.
MMU/S
Esta opción puede ser usada en máquinas con 68030 para activar las funcionalidades
relacionadas con la MMU (protección de memoria,
gestión de la caché mejorada, Snooping,
funciones resload_Protect#?). En un 68040/060
esta opción no tiene efecto puesto que la MMU será usada por defecto. Se recomienda
colocar esta opción en el fichero de configuración global en todos los sistemas
conteniendo un 68030 con una MMU funcional (es decir, no un 68EC030) dado que incrementa
mucho la estabilidad y la seguridad. Si la opción NoMMU/S también
esta configurada, esta opción no tiene efecto.
NoAutoVec/S
Si se selecciona, WHDLoad no terminara el programa si ocurre una interrupción de autovector
o NMI no esperada (vectores #25-31 / $64-$7c). Esto debe ser usados en sistemas/hardware
donde dichas interrupciones se generen al azar, para evitar que WHDLoad termine. Tome en
cuenta que esta opción no cura el problema del hardware con problemas que crea dichas
interrupciones. Algunos programas instalados no funcionarán correctamente en dicho
hardware aún con esta opción activada. Por lo tanto lo mejor es remover (o arreglar si
es posible) el harware que crea las interrupciones.
NoCache/S
Si se selecciona, todas las caches serán desactivadas.
Esta opción toma precedencia sobre BranchCache/S,
Cache/S, DCache/S, StoreBuffer/S y SuperScalar/S.
NoFileCache/S
Desactiva el cacheado de ficheros de WHDLoad y fuerza una conmutación al SO para cada
operación de disco del programa instalado.
Esta opción inactiva Preload/S.
NoFilter/S
Desactiva el filtro de audio. Tome en cuenta que esta opción solo afecta la inicialización
durante el arranque, si el programa instalado cambia por si mismo el estado del filtro
de audio esta opción carecerá de efecto.
NoFlushMem/S
Normalmente WHDLoad limpia la memoria durante el arranque para obtener tanta memoria libre
como sea posible para la operación de Preload/S. Esto removerá todos
los recursos no utilizados tales como librerías, fuentes, etc. Usando esta opción WHDLoad
no limpiara la memoria. Puede ser usada en sistemas con mucha memoria libre evitando la recarga
de recursos residentes y por lo tanto mejorando el rendimiento.
NoMemReverse/S
Si esta opción es activada WHDLoad no asignará memoria usando la bandera MEM_REVERSE flag.
Ha sido reportado que el uso de esta bandera causa problemas en algunas configuraciones
(por ejemplo, configuraciones utilizando memoria en el conector PCMCIA de las A600/A1200 como memoria Fast,
configuraciones con una M-Tec 1230/8 MB OS3.0). La razón de este problema es desconocida.
Esta opción también puede ayudar si parte de la RAM alta está corrupta, dado que WHDLoad utilizará
primero la memoria en direcciones bajas. Si Ud. obtiene errores extraños, vale la pena intentar
esta opción.
Esta opción está siempre activa en Kickstart 2.0 (V37) debido a que un error de implementación
en dicha Kickstart puede causar que el sistema se congele durante exec.AllocMem.
NoMMU/S
Si se configura esta opción WHDLoad no usará la MMU.
Esta es una opción crítica y peligrosa recomendada solo para propóstios de prueba y
eliminación de errores, y no para el uso normal. Vea el capítulo MMU
para mas información. Esta opción toma precedencia sobre MMU/S.
NoNetwork/S
Si se configura esta opción WHDLoad no
intentará conectarse a Internet para realizar una verificación de
actualización del Esclavo utilizado y WHDLoad en si mismo.
NoReq/S
Esta opción solo puede ser usada cuando WHDLoad
ha sido ejecutado desde la línea de comandos (CLI/Shell). Si se ejecuta desde Workbench
no tiene ningún efecto. La opción fuerza WHDLoad a no mostrar ningún cuadro de diálogo en una
ventana nueva, separada, sino a mostrar la salida de mensajes en la ventana de comandos desde la cual
ha sido ejecutado WHDLoad.
NoResInt/S
Esta opción deshabilita las interrupciones
durante la ejecución de las funciones resload. Normalmente las interrupciones están permitidas
mientras se ejecutan las funciones resload. Las interrupciones pueden ejecutar sonidos, refrescar
la pantalla o hacer cualquier otro trabajo importante. El deshabilitarlas puede provocar
distorciones de sonido/imagen o un fallo general en el funcionamiento. Sin embargo el funcionamiento
impropio de las interrupciones puede destruir áreas de datos internas de WHDLoad, lo cual usualmente
conduce a un colapso de WHDLoad y probablemente de todo el sistema operativo. Esta opción puede
utilizarse para verificar dichos problemas.
Si un instalador se comporta de forma extraña o colapsa WHDLoad sin esta opción, pero funciona
bien con esta opción la razón es muy probablemente un problema de interrupciones. En dichos casos
el instalador necesita ser corregido.
Comenzando con WHDLoad versión 17.0 al ingresar a una función resload el blitter será
inspeccionado si está activa. En ese caso WHDLoad terminará informando al usuario.
NoVBRMove/S
Por defecto WHDLoad reubica la tabla de vectores usando el VBR (Vector Base Register) a una
ubicación de memoria diferente. Esto tiene la ventaja que el programa instalado
no puede cambiar la tabla de vectores, lo cual incrementa mucho la seguridad y la estabilidad
de WHDLoad. Algunos programas instalados no trabajarán correctamente con una tabla de vectores reubicada.
La razón de esto puede ser que el programa instalado utilice excepciones del procesador o esté
haciendo otras cosas extrañas. En tal caso, esta opción debe utilizarse para prevenir que
WHDLoad reubique la base de vectores.
Otra funcionalidad del VBR reubicado es que WHDLoad puede controlar el teclado cada vez
que ocurre una interrupción de Autovector. Con esta comprobación WHDLoad es capaz de
terminar el programa instalado independientemente de la asistencia del programa instalado
si la QuitKey/S o DebugKey/S es presionada
o entrar al Monitor cuando la FreezeKey/S es presionada.
La funcionalidad de reubicar el VBR requiere como un mínimo un 68010 para funcionar. En un
68000 esta función no tiene efecto, dado que no hay un VBR y la tabla de vectores siempre
comienza en $0 y no puede ser reubicada.
En un 68000 WHLoad soporta algún equipamiento especial (ACA500, Zeus) que permite ubicar
los vectores de interrupción Autovector en una ubicación de memoria diferente para
poder soportar siempre la funcionalidad QuitKey/S.
Estas funcionalidades de hardware especial no se utilizan si se activa esta opción.
NoWriteCache/S
Esta opción desactiva la funcionalidad de usar una caché de escritura a disco de WHDLoad.
Sin esta opción WHDLoad intentará guardar todas las operaciones de escritura en memoria
y demorarlas hasta que el programa termine para evitar conmutaciones innecesarias al sistema operativo.
NoWriteInfo/S
Si esta opcion esta activa, WHDLoad
no actualizara el archivo .info al ser arrancado desde Workbench. Normalmente WHDLoad
actualiza la Tooltype PreloadSize/N si cambió o no esta presente, y actualiza opciones
como Custom1-5/K/N y ButtonWait/S si
fueron cambiadas desde la ventana de inicio.
NTSC/S
Si se selecciona, WHDLoad usara una pantalla NTSC (60Hz) para el programa instalado. En una
Amiga PAL, el manejador de monitor NTSC debe estar instalado en "DEVS:Monitors/
".
PAL/S
Si se selecciona, WHDLoad usara una pantalla PAL (50Hz) para el programa instalado. En una
Amiga NTSC, el manejador de monitor PAL debe estar instalado en "DEVS:Monitors/
".
Preload/S
Si esta opción esta activada, WHDLoad cargará tantos ficheros e imágenes de disco como sea
posible en memoria durante el arranque.
Si durante la pre-lectura la memoria libre no es suficiente para pre-leer un archivo el proceso
se detiene. En este caso solo parte de los archivos son pre-leídos.
Esto incrementa el rendimiento cuando el programa instalado se esta ejecutando, dado que se
evita la conmutación al SO para cargar datos directamente desde el disco duro. Esta
opción siempre debe estar activa.
PreloadSize/N
Esta opción informa a WHDLoad cuanta información debe ser pre-leída (preloaded.
Se utiliza solamente para calcular la barra de progreso de Preload.
Si el programa instalado es arrancado desde el Workbench, WHDLoad configurará/actualizará
esta opción como ToolType luego de retornar al sistema operativo (a menos que se utilice
la opcion NoWriteInfo).
El conteo de la opción PreloadSize no es solamente la suma del
tamaño de todos los archivos, por lo cual es dificilmente posible calcular el valor
por uno mismo.
Existen dos fases posibles de Preload que se muestran en diferentes
colores de la barra de progreso de precarga. Solamente si el Esclavo tiene configurado
el indicador WHDLF_Examine WHDLoad colectara
meta datos del sistema de archivos sobre los ficheros a precargar. El color para esta
primera fase es negro por defecto. La segunda fase siempre estara activa si la
opcion Preload esta activa. El color para esta segunda fase
es azul por defecto.
PreloadSmart/S
Este conmutador selecciona un
modo de pre-lectura diferente. Si está activo WHDLoad recordará los ficheros
leídos/guardados en el archivo .load-sequence. Si dicho archivo existe,
WHDLoad pre-leerá solamente los ficheros listados en el mismo. Si el archivo
no existe, trabajará como el Preload normal. El archivo
será actualizado al salir de WHDLoad si han sido leídos/guardados cualesquiera
nuevos ficheros.
Esta función aumenta la velocidad del proceso de pre-lectura si están
involucrados muchos ficheros. También asegura que solamente son leídos los
ficheros realmente utilizados. Pre-lee los ficheros en la misma secuencia que
fueron accedidos en la ejecución anterior. Esto ayuda en entornos con poca
memoria, pre-leyendo los ficheros que son accedido primero.
Proxy/K
Puede especificarse un Proxy HTTP utilizando esta opción
el cual será utilizado por WHDLoad para conectarse a
Internet. Esto solo tiene sentido si una conexión directa no es posible
dado que WHDLoad solo realizará una simple solicitud HTTP individual. La sintaxis para
la especificación del proxy es [usuario:contraseñoa@]nombre del proxy[:puerto]. El nombre del
proxy es requerido. El puerto del proxy es opcional y utiliza 80 por defecto si no se
especifica. Si el proxy requiere autenticación deben incluirse el usuario y password antes del nombre
del proxy. WHDLoad solo soporta autenticación del tipo "basic".
QuitKey/K/N
Configura el código rawkey para salir del programa,
esto solo funcionará si el VBR es movido por WHDLoad (NoVBRMove/S no debe
estar configurado y la CPU debe ser como mínimo un 68010) o para que el esclavo en si
soporte dicha función.
ReadDelay/K/N
Esta opción especifica el tiempo en 1/50vos de segundo que WHDLoad debe esperar luego que ha
cargado datos desde los discos. También esperará ese tiempo luego que el Preload/S haya terminado.
Esto soluciona problemas con los dispositivos (por ej. lectoras de CD) que quieren hacer
algo luego de terminada la lectura (por ej. detener el motor).
RestartKey/K/N
Usando esta opción se puede configurar un código de rawkey que al ser
presionada ocasionara que WHDLoad reinicie el programa instalado.
SaveDir/K
Esta opción especifica el sub directorio para operaciones de escritura del programa instalado
conjuntamente con la opción SavePath/K.
Puede ser requerida para configurarlo explícitamente en lugar de permitirle a WHDLoad que lo determine
en el caso de estar utilizando múltiples versiones de un juego que utiliza el mismo Esclavo pero ficheros de
salvado de partida incompatibles.
También puede ser útil si el Esclavo no contiene el nombre del juego y el nombre de archivo del Esclavo
no es el que se desea tener como directorio para partidas salvadas.
SavePath/K
Esta opción fuerza WHDLoad a redireccionar todas las operaciones de escritura del programa instalado a una
ubicación diferente en el disco.
Esta opción especifica el directorio base para todos los programas instalados.
Cada programa instalado tendra su propio sub directorio bajo el directorio base.
El sub directorio será creado por WHDLoad si no existe (durante la primer operación de escritura).
El nombre del sub directorio puede especificarse utilizando la opción SaveDir/K
y en caso de no especificarse será derivado por WHDLoad de la información disponible en el Esclavo (ws_name o el nombre de fichero del Esclavo). Internamente
este directorio de salvado se gestiona com un directorio de Data adicional.
ShowRegs/K
Esta opción solamente es útil en conjunto con la opción Expert/S. Con
esta opción se especificará el programa que será usado por WHDLoad para mostrar el volcado
de registros si el botón Show Regs en un diálogo de error de WHDLoad es presionado. WHDLoad
añadirá el nombre del fichero salvado temporalmente (actualmente T:.whdl_register) a
la cadena de comandos especificada.
Si no se especifica esta opción y WHDLoad ha sido ejecutado desde CLI/Shell, se mostrará
el volcado de registros directamente en la ventana de la terminal desde la que ha sido
ejecutado WHDLoad.
Slave
Nombre del esclavo que debe ser usado por WHDLoad. El esclavo contiene el código de interfase
que se requiere para la comunicación entre el programa instalado y WHDLoad. Si se especifica "*"
como esclavo, WHDLoad buscará en el directorio actual un archivo que concuerde con el patrón
"#?.slave" y utilizará el primero que encuentre. Si no hay coincidencias, se utilizará el
valor por defecto "WHDLoad.Slave" para mostrar el mensaje de error.
Snoop/S, SnoopAGA/S, SnoopECS/S, SnoopOCS/S
Estas opciones activan la funcionalidad snoop de registros Cia/Custom de
WHDLoad.
SplashDelay/K/N
Esta opción especifica el tiempo en 1/50vos de segundo que WHDLoad mostrara la ventana de información
durante el arranque. Si SplashDelay/K/N es menor que ReadDelay/K/N será
ignorada y la ventana se mostrara usando el tiempo de ReadDelay/K/N.
La ventana se mostrara como mínimo mientras Preload/S este siendo procesado.
Si la opción se configura a 0 no se mostrara la ventana. Si la opción es configurada
a -1 se agregará un boton Iniciar (Start) a la ventana y la misma permanecerá abierta
hasta que dicho botón sea presionado.
La ventana de arranque también puede ser cerrada presionado las teclas
Espacio, Retorno, Entrada o el botón de disparo del mando en el puerto #1. Si se presiona Escape (Esc) WHDLoad detendrá el
Preload/S y terminará inmediatamente. Ver también la
opción ConfigDelay/K/N.
StoreBuffer/S
Esta opción activa el Buffer de Almacenamiento del 68060. En otros tipos de CPU no tiene efecto.
Esta opción carece de efecto si NoCache/S también esta configurada.
SuperScalar/S
Esta opción activa la funcionalidad del 68060 de ejecutar múltiples instrucciones por cada ciclo
de máquina. En otros tipos de CPU no tiene efecto.
Esta opción carece de efecto si NoCache/S también esta configurada.
TimeOut/K/N
Si se configura permite que WHDLoad y el programa instalado terminen luego del
tiempo especificado. Esta opción requiere que NoVBRMove/S no este
configurado y que el programa instalado no modifique el temporizador ciaa.ciatod
.
El tiempo tras el cual el programa terminara se especifica en 1/50vos de segundo.
Para medir dicho tiempo para una demo o juego active la opción Expert/S
y configure una DebugKey/K/N, cuando se alcance el punto en el cual
desea que el programa termine, presione la tecla DebugKey. Luego mire en el
fichero .whdl_register creado y busque el valor de ciaa-event
.
Si la frecuencia de su alimentación eléctrica es 50 Hz entonces ese es el valor que
debe configurar con TimeOut/K/N, si la frecuencia es 60 Hz debe multiplicar el valor hallado
por 5/6.
WriteCache/S
Esta opcion activa la funcionalidad de
bufer de escritura de WHDLoad. Dado que esta funcionalidad esta activa por defecto, el
uso de estas opciones solo tienen sentido para sobreescribir una opcion global
activa NoWriteCache/S. Por lo tanto puede desactivarse esta
funcionalidad para todos los instaladores y activarla solamente para algunos de ellos.
WriteDelay/K/N
Esta opción especifica el tiempo en 1/50vos de segundo que WHDLoad esperara luego de
escribir cualquier cosa físicamente a disco. Afecta a todas las funciones
resload_Save#? y la funcionalidad FileLog/S.
Esto tiene sentido puesto que los sistemas de archivos usualmente no escriben la información
inmediatamente a disco. Toma un tiempo (1..3 seg) hasta que todas las estructuras del
sistema de archivos han sido actualizadas exitosamente. El valor por defecto para WriteDelay
es 150 que conduce a una espera de 3 segundos en WHDLoad luego de cada escritura al disco
duro. Ud. puede configurar este valor en 0, pero entonces Ud. nunca debe salir con un
reset del programa instalado dado que los datos grabados no serán escritos correctamente
a disco.
[Main]
[Docs]
[Installs]
[Search]
[Team]
[Guestbook]
[Links]