Ús

WHDLoad pot ser executat des de la línia de comandes (CLI/Shell) o des de Workbench. Les opcions poden especificar-se en un fitxer de configuració global i mitjançant arguments o Tooltypes. Generalment es requereix l'opció Slave. També poden ser necessàries altres opcions, depenent del maquinari i el programa a executar des de WHDLoad. Quan s'executa des de la línia de comandes, WHDLoad acaba amb un dels següents codis de retorn:

Opcions i configuració global

Hi ha opcions locals i globals. Les opcions locals s'especifiquen com a arguments que es passen a la línia de comandes o com a ToolTypes en executar-lo des de Workbench.
L'arxiu de configuració global és "S:WHDLoad.prefs". És un fitxer normal en ASCII i conté una opció per línia. Les línies buides i els comentaris són ignorats. Els comentaris estan basats en línies i comencen amb el caracter ";" continuant fins al final de la línia.
Al paquet de WHDLoad pot trobar-se un fitxer de configuració d'exemple (" S/WHDLoad.prefs").

Llista de totes les opcions disponibles

Hi ha tres tipus d'opcions:
numèriques: El valor de la opció és un enter.
A la línia de comandes haurà d'emprar notació decimal, com a ToolType també pot utilitzar-se notació hexadecimal indicant-la amb el prefix "$"
cadena de caràcters: El valor de la opció és una cadena
commutador: La opció s'habilita si s'especifica (valor booleà)

La columna Local mostra si l'opció pot utilitzar-se en la línia de comandes i com a un tipus d'eina (tooltype) de la icona. La columna Global mostra si l'opció pot ser utilitzada en l'arxiu de configuració global.

Moltes de les opcions no es troben disponibles per a WHDLoadCD32. La columna CD³² mostra si l'opció es troba disponible en aquesta versió especial de WHDLoad.
Nom de la opcióTipusLocalGlobalCD³²Valor per defecte
BranchCachecommutadorx--
ButtonWaitcommutadorxxx
Cachecommutadorx-x
Chkcommutadorx--
ChkBltHogcommutadorx--
ChkBltSizecommutadorx--
ChkBltWaitcommutadorx--
ChkColBstcommutadorx--
ChkCopConcommutadorx--
ChkIntscommutadorx--
ChipNoCachecommutadorxx-
CoreDumpcommutadorx--
CoreDumpPathcadena de caràcters-x-PROGDIR:
Customcadena de caràctersx-x""
Custom1numèricax-x0
Custom2numèricax-x0
Custom3numèricax-x0
Custom4numèricax-x0
Custom5numèricax-x0
Dcommutadorx--
Datacadena de caràctersx-x-
DebugKeynumèricaxx--
DCachecommutadorx--
ExecuteCleanupcadena de caràctersxx--
ExecuteStartupcadena de caràctersxx--
Expertcommutador-x-
ExpChipcommutadorx--
ExpLocalcommutadorx--
Exp24Bitcommutadorx--
FileLogcommutadorx--
FreezeKeynumèricaxx--
MMUcommutadorxx-
NoAutoVeccommutadorxxx
NoCachecommutadorx-x
NoFileCachecommutadorx-x
NoFiltercommutadorxxx
NoMemReversecommutador-x-
NoFlushMemcommutadorxx-
NoMMUcommutadorxx-
NoResIntcommutadorx-x
NoReqcommutadorxxx
NoTrapHandlercommutadorx-x
NoVBRMovecommutadorx-x
NoWriteCachecommutadorxx-
NTSCcommutadorxxx
PALcommutadorxxx
Preloadcommutadorx-x
QuitKeynumèricaxxx-
ReadDelaynumèrica-xx0
RestartKeynumèricaxxx-
ShowRegscadena de caràcters-x-SYS:Utilities/MultiView
Slavecadena de caràctersx-xWHDLoad.Slave
Snoopcommutadorx--
SnoopAGAcommutadorx--
SnoopECScommutadorx--
SnoopOCScommutadorx--
SplashDelaynumèricaxxx200
StoreBuffercommutadorx--
SuperScalarcommutadorx--
TimeOutnumèricax-x0
WriteDelaynumèricaxx-150

Exemple

Workbench: Workbench Options
CLI o Shell: 1> WHDLoad SuperGame.Slave Preload NTSC QuitKey=69 Custom1=1

Descripció de cada Opció

ButtonWait/S

Aquesta opció no afecta WHDLoad en sí, però pot ésser comprovada per l'Esclau.
El significat d'aquesta opció és que si es configura, els usuaris volen que el programa instal·lat esperi la pulsació d'un botó quan mostri pantalles i/o executi música i normalment ho fa solament per un temps molt limitat (a causa del temps de càrrega des de disc dur/RAM comparat amb la càrrega lenta des de disc).

BranchCache/S

Aquesta opció activa la caché de ramificacions del 68060. En altres tipus de CPU no té cap efecte.
L'opció no té efecte si també es configura NoCache/S.

Cache/S

Aquesta opció activa la caché d'instruccions i desactiva la caché de dades per al programa instal·lat. Si la MMU està éssent utilitzada per WHDLoad, marca la memòria Xip com a "Cachable Writethrough" (imprecisa).
L'opció no té efecte si també es configura NoCache/S.

Chk/S

Aquesta opció és una dreçera i activa les opcions ChkBltSize/S, ChkBltWait/S i ChkColBst/S.

ChkBltHog/S

Aquesta opció comprova tot el temps que el bit blthog (bltpri) al registre custom.dmacon no estigui configurat. Aquesta característica només funciona conjuntament amb alguna de les opcions següents: SnoopOCS/SnoopECS/SnoopAGA.

ChkBltSize/S

Aquesta opció comprova que el programa instal·lat usi el blitter de forma correcta, de tal forma que solament s'utilitzin àrees de memòria vàlides per a operacions de blitter. Aquesta funcionalitat només funciona conjuntament amb una de les opcions SnoopOCS/SnoopECS/SnoopAGA.

ChkBltWait/S

Aquesta opció comprova que el programa instal·lat esperi correctament que el blitter acabi abans de començar un nou treball amb el blitter. Aquesta funcionalitat solament funciona conjuntament amb una de les opcions SnoopOCS/SnoopECS/SnoopAGA.

ChkColBst/S

Aquesta opció comprova tot el temps que el bit color al registre custom.bplcon0 es trobi habilitat. Aquesta funcionalitat només funciona conjuntament amb una de les opcions SnoopOCS/SnoopECS/SnoopAGA.

ChkCopCon/S

Aquesta opció comprova que el programa instal·lat no activi l'accés del copper als registres DMA via configuració de custom.copcon. Aquesta funcionalitat només funciona conjuntament amb una de les opcions següents: SnoopOCS/SnoopECS/SnoopAGA.

ChkInts/S

Aquesta opció comprova, a cada interrupció, si hi ha un parell que es correspongui a intreq i intena configurat per a la interrupció. En cas negatiu el programa instal·lat acabarà amb un missatge d'error apropiat. Aquesta funcionalitat permet la detecció senzilla de problemes de reconeixement d'interrupció (interrupt acknowledge) en màquines ràpides (68040/060) o amb maquinari amb errpr que provoqui interrupcions no esperades. Degut al fet que aquesta condició també pot donar-se si les interrupcions són desactivades configurant intena simultàniament amb l'ocurrència d'una interrupció, això ha estat implementat com a una opció seleccionable.

ChipNoCache/S

Aquesta opció desactiva la possibilitat de caché a la Memòria Xip (BaseMem). Ha de ser emprada en maquinari que no permeti la configuració de la caché a la Memòria Xip (per ex. targetes BlizzardPPC) per a evitar alentiment en la velocitat d'execució del programa instal·lat. Veure també Gestió de la Caché de la CPU.

CoreDump/S

Si es selecciona, en sortir de cada programa instal·lat, WHDLoad crearà un bolcat de memòria i registres. Això pot ser útil per a extreure un mòdul de música del bolcat de memòria o per a eliminació d'errors.

CoreDumpPath

El directori de destí on s'escriuran tots els fitxers de bolcat creats per WHDLoad.

Custom/K, Custom1/K/N, Custom2/K/N, Custom3/K/N,Custom4/K/N, Custom5/K/N

Aquestes opcions no són utilitzades per WHDLoad en sí mateix, però poden ser comprovades per l'Esclau per a controlar diverses característiques especifiques. Custom/K pot contenir una cadena i Custom1-5/K pot contenir solament un enter. Comprovi a la documentació específica de l'instal·lador si aquest suporta les opcions Custom.

D/S

Aquesta opció és útil per a eliminació d'errors. Si l'opció està activada i es troba a memòria un congelador (freezer) suportat (Hrt/TK), WHDLoad simularà una NMI abans d'executar la primera instrucció de CPU continguda a l'Esclau.

Data/K

Usant aquesta opció es pot especificar un directori al com entrés WHDLoad abans de començar a carregar les dades del programa instal·lat. Aquesta opció sobreescriu el valor de ws_#CurrentDir contingut en l'Esclau.

DCache/S

Aquesta opció activa les cachés d'instruccions i dades per al programa instal·lat. Si la MMU està éssent utilitzada per WHDLoad marcarà la memòria Xip com a Cacheable Writethrough (imprecisa).
L'opció no té efecte si NoCache/S està configurat.

DebugKey/K/N

Configura el codi rawkey per sortir del programa per a eliminació d'errors (escriurà els arxius de bolcat i sortirà). Aquesta opció només funcionarà si el mode expert està actiu i el VBR és mogut per WHDLoad (NoVBRMove/S no està configurat i la CPU és com a mínim un 68010) o si l'Esclau en sí mateix ho soporta.

ExecuteCleanup

Mitjançant aquesta opció pot especificar-se una comanda que serà executada per WHDLoad en sortir.

ExecuteStartup

Amb aquesta opció pot especificar-se una comanda que serà executada per WHDLoad en arrencar. Pot usar-se per a desactivar maquinari que causi problemes en conjunt amb WHDLoad o per a detenir la pila de TCP/IP o alguna cosa similar.

Expert/S

Aquesta opció activa el mode expert de WHDLoad. Actualmente afecta la funcionalitat DebugKey/S i els missatges d'advertiment durant la commutació entre el programa instal·lat i el S.O. (pantalles amb cicle de colors mitjançant copper). Si el mode expert no està actiu, la DebugKey/S no estarà disponible. Al mode expert també apareix un altre botó en alguns dels diàlegs d'error produïts per WHDLoad. Aquest botó, que s'anomena Show Regs permet visualitzar informació sobre els registres i l'estat en forma similar a com ho fa un bolcat de registres.

ExpChip/S, ExpLocal/S, Exp24Bit/S

Si el programa instal·lat utilitza memòria d'expansió (ws_ExpMem), es pot emprar aquesta opció per a forçar WHDLoad a assignar aquesta memòria respectivament a Memòria Xip, Memòria Local o Memòria de 24 bits DMA. Això pot resultar en una degradació del rendiment atès que la memòria especificada pot ser accedida més lentament per la CPU comparada amb la memòria Fast per defecte. Pot utilitzar eines de tercers (per ex. SysInfo, GvpInfo,...) per a comprovar la configuració de la seva memòria i veure quines propietats té cada memòria.
En general aquestes opcions estan pensades per a solucionar problemes de compatibilitat de programes instal·lats en màquines ràpides fent-les més lentes durant l'execució mitjançant l'ús apropiat de memòria més lenta.

FileLog/S

Aquesta opció només serveix per eliminar errors. Vegi Bolcats i arxius de log per a més informació.

FreezeKey/K/N

Si utilitza un dels congeladors per programari suportats (HrtMon o Thrillkill) pot usar aquesta opció per a configurar un codi rawkey que en ésser premut ocasioni que WHDLoad entri al mode de congelador. Per a que funcioni, el VBR ha de ser mogut per WHDLoad (No ha d'estar configurat NoVBRMove/S i la CPU ha de ser com a mínim un 68010) i el congelador ha d'estar actiu. Consulti també el capítol Monitors del Sistema / Congeladors per a més informació.

MMU/S

Aquesta opció es pot utilitzat en màquines amb processador 68030 per a activar les funcionalitats relacionades amb la MMU (protecció de memòria, gestió millorada de la caché, Snooping , funcions resload_Protect#?). En un 68040/060 aquesta opció no té cap efecte ja que la MMU s'utilitzarà per defecte. Es recomana col·locar aquesta opció al fitxer de configuració global en tots els sistemes que continguin un 68030 amb una MMU funcional (és a dir, no un 68EC030) atès que incrementa molt l'estabilitat i la seguretat. Aquesta opció no tindrà cap efecte si l'opció NoMMU/S es troba configurada.

NoAutoVec/S

Si es selecciona, WHDLoad no acabarà el programa si ocorre una interrupció d'autovector o NMI no esperada (vectors #25-31 / $64-$7c). Això ha d'utilitzar-se a sistemes/maquinari on aquestes interrupcions es generin a l'atzar, per a evitar que WHDLoad acabi (millor substituir el maquinari que falla!).

NoCache/S

Si es selecciona, totes les cachés seran desactivades.
Aquesta opció té precedència sobre BranchCache/S,Cache/S, DCache/S, StoreBuffer/S y SuperScalar/S.

NoFileCache/S

Desactiva la caché de fitxers de WHDLoad i força una commutació al S.O. per a cada operació de disc del programa instal.lat.
Aquesta opció inactiva Preload/S.

NoFilter/S

Desactiva el filtre d'àudio. Tingui en compte que aquesta opció solament afecta la inicialització durant l'arrencada, si el programa instal·lat canvia per sí mateix l'estat del filtre d'àudio aquesta opció mancarà d'efecte.

NoFlushMem/S

Normalment WHDLoad neteja la memòria durant l'arrencada per a obtenir tanta memòria lliure com sigui possible per a l'operació de Preload/S. Això alliberarà tots els recursos no utilitzats tals com llibreries, fonts, etc. Amb aquesta opció WHDLoad no netejarà la memòria. Pot ser emprada en sistemes amb suficient memòria lliure per a evitar recarregar recursos residents i incrementar d'aquesta manera el rendiment del sistema.

NoMemReverse/S

Si aquesta opció es troba activada, WHDLoad no assignarà memòria emprant el flag MEM_REVERSE. Hi ha informes que indiquen que l'ús d'aquest flag provoca problemes en algunes configuracions (configuracions que empren targes de memòria Fast a l'slot PCMCIA dels A600/A1200, configuracions amb M-Tec 1230/8 i OS 3.0). No es coneix el motiu d'aquests problemes. Aquesta opció també pot ésser d'utilitat si part de la memòria alta es troba malament, perquè WHDLoad emprarà memòria ubicada en adreces més baixes. Si vostè obté errors estranys, potser val la pena provar aquesta opció.
Aquesta opció s'ha introduït a WHDLoad v16.8.

NoMMU/S

Si es configura aquesta opció WHDLoad no utilitzarà la MMU. Aquesta és una opció crítica i perillosa, recomanada només amb propòsits de prova i eliminació d'errors i no per a l'ús normal. Vegi el capítol MMU per a més informació. Aquesta opció té precedència sobre MMU/S.

NoReq/S

Aquesta opció només es pot utilitzar quan WHDLoad ha estat executat des de la línia de comandes (CLI/Shell). Si s'executa des de Workbench no té cap efecte. L'opció força WHDLoad a no mostrar cap quadre de diàleg en una finestra nova, separada, sinó a mostrar els missatges de sortida a la finestra de comandes des d'on WHDLoad ha estat executat.

NoResInt/S

Aquesta opció deshabilita les interrupcions durant l'execució de les funcions resload. Normalment les interrupcions estan permeses mentre s'executen les funcions resload. Les interrupcions poden executar sons, refrescar la pantalla o fer qualsevol altre treball important. El fet de deshabilitar-les pot provocar distorciones de so/imatge o una fallada general en el funcionament. No obstant això, el funcionament impropi de les interrupcions pot destruir àrees de dades internes de WHDLoad, la qual cosa provoca generalment un col·lapse de WHDLoad i probablement de tot el sistema operatiu. Aquesta opció pot utilitzar-se per a verificar aquests problemes. Si un instal·lador es comporta de forma estranya o col·lapsa WHDLoad sense aquesta opció, però funciona bé amb la mateixa, la raó és molt probablement un problema d'interrupcions. En aquests casos l'instal·lador necessita ésser corregit.

NoTrapHandler/S

Si s'activa aquesta opció WHDLoad utilitza la taula de vectors original del S.O. que aquest activa al moment d'arrencar WHDLoad. Durant l'arrencada WHDLoad copia la taula de vectors del sistema en lloc de crear una taula pròpia. Això pot ser útil només amb propòsits d'eliminació d'errors i no ha de ser utilitzat durant l'operació normal. Precaució: si un gestor d'excepcions cridat a través de la taula de vectors original intenta cridar qualsevol funció del S.O. o intenta fer servir estructures de dades del S.O., la màquina es penjarà (p.ex: exec.Alert).

NoVBRMove/S

WHDLoad mou, per defecte, la taula de vectors utilitzant el VBR (Vector base Register) a un espai de memòria diferent de $0. Això té l'avantatge que el programa instal.lat no pot canviar la taula de vectors, fet que incrementa en gran mesura la seguretat i estabilitat de WHDLoad. Alguns programes instal.lats i esclaus no funcionaran correctament amb un VBR mogut. La raó d'això és que el programa instal.lat pot fer coses estranyes no suportades per un VBR mogut o que l'autor de l'instal.lador no fos capaç de suportar un VBR mogut.
Una altra característica del VBR mogut és que WHDLoad pot comprovar el teclat cada cop que té lloc una interrupció d'Autovector. Amb aquesta comprovació, WHDLoad pot finalitzar el programa instal.lat independentment del treball del programa instal.lat/esclau si es prem una QuitKey/S o una DebugKey/S (de forma similar el programa instal.lat pot ésser interromput quan es prem una FreezeKey/S).
La característica de moure el VBR requereix un 68010 com a mínim. En un 68000, aquesta opció no té cap efecte donat que el VBR és sempre a $0 i no pot ésser mogut.

NoWriteCache/S

Aquesta opció desactiva la funcionalitat d'usar una caché d'escriptura a disc de WHDLoad. Sense aquesta opció WHDLoad intentarà guardar totes les operacions d'escriptura en memòria i fer-les esperar fins que el programa acabi per a evitar commutacions innecessàries al sistema operatiu.

NTSC/S

Si se selecciona, WHDLoad utilitzarà una pantalla NTSC (60Hz) per al programa instal·lat. En un Amiga PAL, el controlador de monitor NTSC ha d'estar instal·lat a "DEVS:Monitors/".

PAL/S

Si se selecciona, WHDLoad utilitzarà una pantalla PAL (50Hz) per al programa instal·lat. En un Amiga NTSC, el controlador de monitor PAL ha d'estar instal·lat a "DEVS:Monitors/".

Preload/S

Si aquesta opció es troba activada, WHDLoad carregarà tants fitxers i imatges com sigui possible de disc cap a memòria (depenent de la quantitat de memòria lliure) durant l'arrencada. Això incrementa el rendiment quan el programa instal·lat s'està executant atès que s'evita la commutació al S.O. per a carregar dades directament des del disc dur. Aquesta opció sempre ha d'estar activa.

QuitKey/K/N

Configura el codi rawkey per a sortir del programa, això solament funcionarà si el VBR és mogut per WHDLoad (NoVBRMove/S no ha d'estar configurat i la CPU ha de ser com a mínim un 68010) o perquè l'esclau en sí mateix suporti aquesta funció.

ReadDelay/K/N

Aquesta opció especifica el temps en intervals d'1/50 de segon que WHDLoad ha d'esperar tan bon punt ha carregat dades des dels discos, i també esperarà aquest temps després que el Preload hagi acabat. Això soluciona problemes amb els dispositius (per ex. lectors de CD) que volen fer alguna cosa després d'acabada la lectura (per ex. aturar el motor).

RestartKey/K/N

Amb aquesta opció es pot configurar un codi rawkey que en ésser polsat ocasioni que WHDLoad reiniciï el programa instal·lat.

ShowRegs/K/N

Aquesta opció només és útil conjuntament amb la opció Expert/S. Amb aquesta opció s'especificarà el programa que serà usat per WHDLoad per a mostrar el bolcat de registres si es prem el botó Show Regs que apareix als diàlegs d'error de WHDLoad. WHDLoad afegirà el nom del fitxer desat temporalment (actualment T:.whdl_register) a la línia de comandes especificada.

Slave

Nom de l'esclau que hauria de ser utilitzat per WHDLoad. L'esclau conté el codi d'interfície que es requereix per a la comunicació entre el programa instal.lat i WHDLoad.

Snoop/S, SnoopAGA/S, SnoopECS/S, SnoopOCS/S

Aquestes opcions activen la funcionalitat d' snoop de registres Cia/Custom de WHDLoad.

SplashDelay/K/N

Aquesta opció especifica el temps en intervals d'1/50⊃a de segon que triga WHDLoad a mostrar la finestra d'informació durant l'arrencada. Si SplashDelay/K/N és menor que ReadDelay/K/N serà ignorada i la finestra es mostrarà usant el temps de ReadDelay/K/N. La finestra es mostrarà com a mínim mentre Preload/S estigui treballant.
Si l'opció es configura a 0 no es mostrarà la finestra.

StoreBuffer/S

Aquesta opció activa el Buffer d'Emmagatzematge del 68060. En altres tipus de CPU no té efecte, com tampoc tindrà efecte si l'opció NoCache/S es troba configurada.

SuperScalar/S

Aquesta opció activa la funcionalitat del 68060 d'executar múltiples instruccions per cada cicle de màquina. En altres tipus de CPU no té efecte.
Aquesta opció tampoc tindrà cap efecte sí està configurada l'opció NoCache/S .

TimeOut/K/N

Si es configura permet que WHDLoad i el programa instal·lat acabin després del temps especificat. Aquesta opció requereix que l'opció NoVBRMove/S no s'hagi configurat i que el programa instal·lat no modifiqui el temporitzador ciaa.ciatod. El temps després del qual el programa acaba s'especifica en intervals d'1/50 part de segon. Per a mesurar aquest temps per a una demo o joc activi l'opció Expert/S i configuri una DebugKey/K/N, quan s'arribi al punt en què desitja que el programa acabi, premi la tecla DebugKey. Després miri al fitxer .whdl-register que s'ha creat i busqui-hi el valor ciaa-event. Si la freqüència de la seva alimentació elèctrica és 50 Hz llavors aquest és el valor que ha de configurar amb TimeOut/K/N, si la freqüència és de 60 Hz ha de multiplicar el valor trobat per 5/6 .

WriteDelay/K/N

Aquesta opció especifica el temps en intervals d'1/50 part de segon que WHDLoad esperarà després d'escriure qualsevol cosa físicament a disc. Afecta totes les funcions resload_Save#? i la funcionalitat FileLog/S. El sentit d'això es que els sistemes d'arxius usualment no escriuen la informació immediatament a disc. Es triga un temps (1..3 seg) fins que totes les estructures del sistema d'arxius han estat actualitzades de forma correcta. El valor per defecte per a WriteDelay és 150 que implica que WHDLoad s'esperi 3 segons després de cada escriptura al disc dur. Vostè pot configurar aquest valor en 0, però llavors mai haurà de sortir amb un reset del programa instal·lat atès que les dades desades no seran escrites correctament al disc.