Usage

A WHDLoad indítható parancssorból (CLI/Shell) vagy a Workbench-ből. Az opciókat egy globális beállítás fájlban és paraméterek vagy ikonparaméterek segítségével. A Slave opció gyakran kötelező. Több opció is szükséges lehet, ez függ a hardveredtől és a programtól. Ha parancssorból indítod, a kilépés a következő visszatérési kódokkal zárul:

Opciók és beállítások

Vannak helyi és általános opciók. A helyi opciókat paraméterekkel lehet megadni parancssorból vagy az ikonok paramétereiből ha a Workbench-ből indul.
Az általános beállítás fájl az "S:WHDLoad.prefs". Egy egy sima ASCII fájl és egy opciót tartalmaz soronként. Az üres sorok és a megjegyzések mellőzve lesznek. A megjegyzés sor alapú, és a ";" karakterrel kezdődik és a sor végéig tart.
Egy példa beállítás fájl megtalálható a WHDLoad csomagban ("S/WHDLoad.prefs").

Áttekintés

Elérhető opciók listája

Opció neveTípusHelyiÁltalánosAlapérték
BranchCachekapcsolóx-
ButtonWaitkapcsolóxx
Cachekapcsolóx-
Chkkapcsolóx-
ChkBltHogkapcsolóx-
ChkBltSizekapcsolóx-
ChkBltWaitkapcsolóx-
ChkColBstkapcsolóx-
ChkCopConkapcsolóx-
ChkIntskapcsolóx-
ChipNoCachekapcsolóxx
CoreDumpkapcsolóx-
CoreDumpPathsztring-xPROGDIR:
Customsztringx-
Custom1numerikusx-
Custom2numerikusx-
Custom3numerikusx-
Custom4numerikusx-
Custom5numerikusx-
Dkapcsolóx-
Datasztringx--
DebugKeynumerikusxx-
DCachekapcsolóx-
ExecuteCleanupsztring-x-
ExecuteStartupsztring-x-
Expertkapcsoló-x
ExpChipkapcsolóx-
ExpLocalkapcsolóx-
Exp24Bitkapcsolóx-
FileLogkapcsolóx-
FreezeKeynumerikusxx
MMUkapcsolóxx
NoAutoVeckapcsolóxx
NoCachekapcsolóx-
NoFileCachekapcsolóx-
NoFilterkapcsolóxx
NoFlushMemkapcsolóxx
NoMMUkapcsolóxx
NoReqkapcsolóxx
NoTrapHandlerkapcsolóx-
NoVBRMovekapcsolóx-
NoWriteCachekapcsolóxx
NTSCkapcsolóxx
PALkapcsolóxx
Preloadkapcsolóx-
QuitKeynumerikusxx-
ReadDelaynumerikus-x0
RestartKeynumerikusxx-
ShowRegssztring-xSYS:Utilities/MultiView
Slavesztringx-WHDLoad.Slave
Snoopkapcsolóx-
SnoopAGAkapcsolóx-
SnoopECSkapcsolóx-
SnoopOCSkapcsolóx-
SplashDelaynumerikusxx200
StoreBufferkapcsolóx-
SuperScalarkapcsolóx-
TimeOutnumerikusx-0
WriteDelaynumerikusxx150

Opciók típusa

numerikus: az opció értéke egy egész,
parancssorból csak tízes rendszerben adhatod meg, ikonparaméterként hexadecimálisan is, ekkor kezdjed egy "$" karakterrel
sztring: az opció értéke egy sztring
kapcsoló: az opció be lesz kapcsolva ha megadod (logikai)

Példa

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

Az opciók leírása

ButtonWait/S

Ez a opció nem a WHDLoad-ra van hatással, hanem a Slave-re.
Ha be van kapcsolva, akkor a program egy gombnyomásra fog várni képek megjelenítésekor és zenék lejátszásakor, ha ezt csak egy nagyon kevés ideig tenné (a HD/RAM betöltés gyorsasága miatt.

BranchCache/S

Ez az opció bekapcsolja 68060 branch cache-ét. Más processzorokon nincs hatással.
Akkor sincs hatása, ha a NoCache/S is be van állítva.

Cache/S

Ez az opció bekapcsolja az utasítás és az adat cache-t az installált program számára. Ha a WHDLoad használja az MMU-t, akkor a Chip memória Cacheable Writethrough (imprecise) módon lesz jelölve.
Az opciónak nincs hatása, ha a NoCache/S is be van kapcsolva.

Chk/S

Ez az opció egy rövidítés és bekapcsolja a következő opciókat: ChkBltSize/S, ChkBltWait/S és ChkColBst/S.

ChkBltHog/S

Ez az opció mindig ellenőrzi a blthog (bltpri) bitet az egyéni dmacon regiszteben. Ez csak akkor működik, ha a következő funkciók valamelyikével használják: SnoopOCS/SnoopECS/SnoopAGA.

ChkBltSize/S

Ez az opció ellenőrzi, hogy az installált program rendesen használja-e a blittert, hogy a blitter műveletekhez csak érvényes memóriaterületet használ-e. Ez csak akkor működik, ha a következő funkciók valamelyikével használják: SnoopOCS/SnoopECS/SnoopAGA.

ChkBltWait/S

Ez az opció ellenőrzi, hogy az installált program rendesen megvárja-e a blittert mielőtt új blitter feladatot indítana el. Ez csak akkor működik, ha a következő funkciók valamelyikével használják: SnoopOCS/SnoopECS/SnoopAGA.

ChkColBst/S

Ez az opció ellenőrzi, hogy a color bit a custom.bplcon0 regiszterben be van-e állítva mindig. Ez csak akkor működik, ha a következő funkciók valamelyikével használják: SnoopOCS/SnoopECS/SnoopAGA.

ChkCopCon/S

Ez az opció ellenőrzi, hogy az installált program nem engedélyezi-e a coppernek a DMA regiszterek hozzáférését a custom.copcon beállításával. Ez csak akkor működik, ha a következő funkciók valamelyikével használják: SnoopOCS/SnoopECS/SnoopAGA.

ChkInts/S

Ez az opció ellenőrzi, hogy minden megszakításnál megtalálható-e az intreq és intena kódpár. Ha nem akkor az installált program kilép a megfelelő hibaüzenettel. Ezzel az opcióval gyorsan meg lehet találni a megszakításkérési problémákat a gyorsabb gépeken vagy hibás hardvereken, melyek megszakításokat okoznak. Mivel előfordulhat hogy a megszakítás alatt az intena segítségével kikapcsolható a megszakítás, ezért ez kapcsolható opció lett.

ChipNoCache/S

Ez az opció kikapcsolja a Chip-memória (BaseMem) cache-elhetőségét. Olyan hardvereken kell ezt használni, amelyek nem engedélyezik a Chip-memória cache-elhetőségét (pl. BlizzardPPC kártyák), az installált program végrehajtási sebességének lassulását elkerülendően. Lásd még: CPU Cache kezelés.

CoreDump/S

ha kiválasztod, az installált programokból való minden kilépésnél a WHDLoad létrehoz egy memória és regiszter kiíratást. Ez hasznos lehet zenemodulok kiszedéséhez vagy hibakereséshez.

CoreDumpPath

A kiíratási fájlok alapértelmezett útvonala.

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

Ezeket az opciókat nem a WHDLoad használja, hanem a Slave különféle dolgok beállítására. Custom/K csak sztringet tartalmazhat és Custom1-5/K csak egész számot. Nézd meg a dokumentációt, hogy támogatja-e a Custom opciókat az installáló.

D/S

Ez az opció hasznos lehet a hibakereséshez. Ha az opció be van kapcsolva és egy támogatott szoftver leállító (Hrt/TK) a memóriában van, a WHDLoad szimulál egy NMI-t a Slave-ben lévő első CPU utasítás végrehajtása előtt.

Data/K

Ezt az opciót használva megadható egy könyvtár, maibe a WHDLoad belép az adatok betöltése előtt. Ez az opció felülírja a Slave-ben lévő ws_CurrentDir értéket.

DCache/S

Ez az opció bekapcsolja az utasítás és az adat cache-t az installált program számára. Ha a WHDLoad használja az MMU-t, akkor a Chip memória Cacheable Writethrough (imprecise) módon lesz jelölve.
Az opciónak nincs hatása, ha a NoCache/S is be van kapcsolva.

DebugKey/K/N

Beállítja a rawkey kódot hibakeresési kilépéshez (kiír egy coredump fájlt és kilép). Ez csak akkor müködik ha a haladó mód aktív, ha a VBR el van mozgatva a WHDLoad által (NoVBRMove/S nincs beállítva és a CPU legalább 68010) vagy a Slave maga támogatja.

ExecuteCleanup

Ezzel az opcióval megadhatsz egy parancsot, amit a WHDLoad végrehajt kilépésnél.

ExecuteStartup

Ezzel az opcióval megadhatsz egy parancsot, amit a WHDLoad végrehajt indulásnál. Ez használható különféle hardverek kikapcsolására melyek gondot okoznak, vagy a TCP/IP stack megállítására vagy hasonló dolgokra.

Expert/S

Ez az opció engedélyezi a WHDLoad haladó módját. Jelenleg ez a DebugKey/S opciót befolyásolja és figyelmeztet az installált program és a rendszer közötti váltásokra (színes copper képernyők). Ha a haladó mód nem aktív, a DebugKey/S nem elérhető. Haladó módban a WHDLoad némelyik hibakérdezőjében még egy gomb megjelenik. Ez a gomb a Show Regs, amivel megjelenítheted a regisztereket és az állapotinformációt, úgy mintha a regiszter kiíratás lenne.

ExpChip/S, ExpLocal/S, Exp24Bit/S

Ha az installált program használ bővített memóriát (ws_ExpMem), ezekkel az opciókkal lehet rávenni a WHDLoad-ot, hogy foglaljon le ilyen memóriát is a Chip mellett. Ez együttjárhat teljesítmény-csökkenéssel, mivel a megadott memóriát a CPU lassabban érheti el, mint az alapértelmezett Fast memóriát. Használhatsz programokat (pl. SysInfo, GvpInfo,...) a memóriakonfigurációd megjelenítéséhez és hogy megtudd a tulajdonságaikat.
Általánosságban ezek az opciók az installált programok kompatibilitási problémáit hivatottak megoldani gyors gépeken, hogy lassabbá tegyék a program futását lassú memória használatával.

FileLog/S

Ez az opció csak hibakeresési célból hasznos. További információkért lásd kiíratások és naplófájlok.

FreezeKey/K/N

Ha használod az egyik támogatott szoftveres leállítót (HrtMon vagy Thrillkill), akkor itt állíthatod be, hogy melyik billentyűre lépjen be a leállítóba. Hogy ez működjön, a VBR-t el kell mozgatni (NoVBRMove/S nem lehet beállítva és a processzor legalább 68010 legyen) és a leállítónak aktívnak kell lennie.

MMU/S

Ez az opció a 68030-as gépeken használható az MMU opciók használatához (memóriavédelem, felett cache kezelés, Figyelés, resload_Protect#? funkciók). 68040/060-on ennek nincsen hatása, mert az MMU alapból használatban van. Ajánlott ezt minden olyan rendszerben, ahol 68030-as van működő MMU-val, beállítani a általános beállítás fájlban, mivel nagyban növeli a stabilitást és a biztonságot. Ha a NoMMU/S opció is be van kapcsolva, akkor ennek nincs hatása.

NoAutoVec/S

Ha kiválasztod, a WHDLoad nem fog kilépni ha egy nemvárt autovektor megszakítás vagy NMI történik (#25-31 / $64-$7c vektorok). Ezt olyan rendszeren/hardveren lehet használni, amely véletlenszerű megszakítasokat generál, megakadályozza a WHDLoad-ot a kilépéstől (de jobb eltávolítáni a hibás hardvert!).

NoCache/S

Ha kiválasztod. minden caches ki lesz kapcsolva.
Ez az opció felülírja a BranchCache/S, Cache/S, DCache/S, StoreBuffer/S és SuperScalar/S opciókat.

NoFileCache/S

Kikapcsolja a WHDLoad fájl cache funkcióját és ráveszi arra, hogy kapcsoljon át a rendszerre az installált program minden lemezműveleténél.
Ez az opció kikapcsolha a Preload/S funkciót.

NoFilter/S

Kikapcsolja a hangszűrőt. Ez csak az indításnál érvényes, ha az installált program megváltoztatja a hangszűrő állapotát, akkor ez az opció hatástalan.

NoFlushMem/S

Alapesetben a WHDLoad kitakarítja a memóriát indításnál, hogy minél több memória álljon a Preload/S művelet rendelkezésére. Eltávolít minden nemhasznált erőforrást a memóriából (mint library-k, betűtípusok stb.) Ezt az opciót használva a WHDLoad nem takarítja ki a memóriát. Sok szabad memóriával rendelkező gépeken használható, növeli a rendszer teljesítményét.

NoReq/S

Ez az opció csak akkor használható, ha a WHDLoad parancssorból (CLI/Shell) lett indítva. Workbenchből indítva nincs hatása. Az opció használata azt eredményezi, hogy a WHDLoad a hibaüzeneteket nem egy kérdezőben jeleníti meg, hanem abban a parancssorban, ahonnét indítva lett.

NoMMU/S

Ha beállítod ezt az opciót, a WHDLoad nem fogja használni az MMU-t. Ez egy kritikus és veszélyes opció, csak tesztelési vagy hibakeresési célból. További információért lásd MMU. Az opció felülírja az MMU/S opciót.

NoTrapHandler/S

Ha ezt az opciót bekapcsolod, a WHDLoad a rendszer eredeti vektortábláját fogja használni. Indításnál a WHDLoad lemásolja rendszer vektortábláját ahelyett hogy egy sajátot húzna létre. Ez csak hibakeresési célból hasznos és normál esetben nem kell használni. Figyelem: ha a kivét kezelő az eredeti vektortáblát használja bármilyen rendszerfunkció meghívásához vagy a rendszer adatstruktúráinak használatához, a rendszer összeomlik (pl. exec.Alert).

NoVBRMove/S

Alapesetben a WHDLoad átmozgatja a vektortáblát a VBR (Vector base Register) segítségével a $0 memóriacímről. Ennek megvan az az előnye, hogy az installált program nem tudja megváltoztatni a vektortáblát, és ez nagyban növeli a biztonságot és stabilitást. Néhány installált program/slave nem fog működni rendesen átmozgatott VBR-rel Ennek az az oka, hogy az installált program olyan dolgokat csinál, amely mozgatott VBR esetén nem támogatott, vagy az installáló szerzője túl lamer volt a mozgatott VBR támogatásához. Ebben az esetben be kell ezt állítani, hogy a VBR ne legyen átmozgatva.
Az átmozgatott VBR másik előnye, hogy a WHDLoad bármikor le tudja kérdezni a billentyűzetet amikor egy autovektor megszakítás történik. Ezzel az ellenőrzéssel a WHDLoad az installált programtól/slave-től függetlenül meg tudja szakítani a programot, ha a QuitKey/S vagy DebugKey/S le lett nyomva (hasonlóan az installált program megszakítható a FreezeKey/S megnyomásával).
A VBR mozgatásához szükséges legalább egy 68010. 68000-en ennek az opciónak nincsen hatása, mivel a VBR mindig $0 és nem lehet mozgatn.

NoWriteCache/S

Ez az opció kikapcsolja a WHDLoad lemezírási cache-ét. Enélkül az opció nélkül a WHDLoad megpróbálja az összes írási műveletet cache-elni a memóriában és elhalasztja a kilépésig, hogy elkerülje a szükségtelen kapcsolgatást az operációs rendszerre.

NTSC/S

Ha kiválasztod, a WHDLoad NTSC (60Hz) kijelzőt fog használni az installált programhoz. PAL Amigán egy NTSC monitor meghajtó szükséges a "DEVS:Monitors/" könyvtárban.

PAL/S

Ha kiválasztod, a WHDLoad (50Hz) kijelzőt fog használni az installált programhoz. NTSC Amigán, egy PAL monitor meghajtó szükséges a "DEVS:Monitors/" könyvtában.

Preload/S

Ha ez az opció be van kapcsolva, a WHDLoad annyi fájlt vagy lemezképmást tölt be a memóriába az indulásnál, amennyi csak elfér. Ez növeli az installált program futási teljesítményét, mivel elkerüli a visszakapcsolást az operációs rendszerre az adatok direkt betöltéséhez. Ezt az opciót legyen állandóan bekapcsolva.

QuitKey/K/N

Beállitja a rawkey kódot a kilépéshez, ez csak akkor működik, ha a VBR el lett mozgatva a WHDLoad által (NoVBRMove/S nincsen beállitva és a CPU legalább 68010) vagy ha a Slave maga támogatja.

ReadDelay/K/N

Ez a opció megadja 1/50 másodpercben, hogy a WHDLoad mennyit várjon miután betöltötte az adatokat a lemezről, és hogy mennyit várjon a Preload befejezése után. Ez megoldja a problémás meghajtók kezelését (pl. CD meghajtók) amleyek még akarnak valamit csinálni olvasás után (pl. kikapcsolni a motrot).

RestartKey/K/N

Ezt az opciót használva be tudod állitani a rawkey kódot, amelyet megnyomva az installált program újraindul.

ShowRegs/K/N

Ez az opció csak az Expert/S opcióval együtt hasznos. Ezzel az opcióval megadható, hogy a WHDLoad meg fogja jeleníteni a regiszterek tartalmát, ha a hiba esetén megjelenő kérdezőben a Show Regs gomb le lesz nyomva. A WHDLoad hozzáfűzi az ideiglenesen mentett fájl nevét (jelenleg T:.whdl_register) a megadott parancs sztringbe.

Slave

A slave neve, amit a WHDLoad használni fog. A slave tartalmazza az interfész kódot, amely szükséges az installált program és a WHDLoad közötti kommunikációhoz.

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

Ezek az opciók bekapcsolják a WHDLoad Cia/egyéni regiszterek figyelés tulajdonságát.

SplashDelay/K/N

Ez az opció adja meg 1/50 másodpercben, hogy a WHDLoad mennyi ideig jelenítse meg az információs ablakot az elején. Ha SplashDelay/K/N alacsonyabb mint a ReadDelay/K/N, akkor mellőzve lesz és az ablak addig lesz kinnt, ami a ReadDelay/K/N értéke. Az ablak legalább addig van kinnt, amíg a Preload/S tart.
Ha az opció értéke 0, akkor nem lesz ablak megjelenítve.

StoreBuffer/S

Ez az opció bekapcsolja a 68060 Store Buffer-ét. Más processzoron ez nincs hatással.
Az opciónak nincs hatása ha a NoCache/S opció is be van állítva.

SuperScalar/S

Ez az opció bekapcsolja a 68060 azon opcióját, amivel egy cikluson belül több utasítást tud végrehajtani. Más processzoron ez nincs hatással.
Az opciónak nincs hatása ha a NoCache/S opció is be van állítva..

TimeOut/K/N

Ha be van állítva, a WHDLoad és az installált program ki fog lépni a megadott idő után. Fontos, hogy a NoVBRMove/S opció ne legyen beállítva és hogy az installált program ne módosítsa a ciaa.ciatod időzítőt. A kilépés ideje 1/50 másodpercben van megadva. Hogy lemérd egy játék vagy egy demó idejét, kapcsold be az Expert/S módot és állítsd be DebugKey/K/N opciót, az adott ponton lépjél ki a programból a hibakereső billentyű megnyomásával. Most nézd meg a létrehozott .whdl-register fájlt és keresd meg a ciaa-event értékét. Ha a hálózati frekvenciád 50 Hz, akkor ez az érték a TimeOut/K/N, ha a frekvencia 60 Hz, akkor szorozd meg ezt az értéket 5/6-al.

WriteDelay/K/N

Ez az opció megadja a 1/50 másodpercben, hogy a WHDLoad mennyit várjon a fizikai írási műveletek befejezése után. Ez hatással van az összes resload_Save#? funkcióra és a FileLog/S opcióra. Erre azért van szükség, mert a fájlrendszerek nem írják ki azonnal az adatokat. Egy kevés időt (1..3 mp) kell ahhoz, hogy minden fájlrendszer struktúra sikeresen frissítve legyen. A WriteDelay alapértéke 150 amivel a WHDLoad 3 másodpercet vár minden merevlemezre írás után. Ezt beállíthatod nulllára, de ebben az esetben soha ne lépjél ki resettel az installált programból, mivel a mentett adatok valószínűleg nem lesznek rendesen lemezre írva.