Használat
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:
- 0 - sikeres végrehajtás
- 10 - hiba, a Slave végre lett hajtva, a hibaüzenet ki lett írva
- 20 - végzetes hiba, nincs elég szabad memória
- > 100 - a Slave le lett futtatva, visszatérése: 100 + TDREASON
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
Az elérhető opciók listája
A Helyi oszlop mutatja, hogy egy opció használható parancssorból és az
ikon paramétereibl. A Globális oszlop mutatja, hogy egy opció a globális
beállításfájlban is használható.
Sok opció nem elérhető a WHDLoadCD32 verzióban. A
CD³² oszlop jelzi, ha az opció benne van ebben a speciális WHDLoad
verzióban.
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
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. A
további információkért lásd a Rendszerfigyelő /
Leállító linket.
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.
NoResInt/S
Ez az opció kikapcsolja a megszakításokat a resload funkciók végrehajtása
alatt. Alapesetben a megszakítások engedélyezve vannak resload funkciók
végrehajtása alatt. A megszakítások lejátszhatnak zenét, frissíthetik a
képernytőt vagy egyéb hasznos dolgot csinálhatnak. Ha kikapcsolod, akkor
hang/kép torzulások vagy egyéb hibák léphetnek fel. Viszont a hibásan működő
megszakítások tönkretehetik a belső WHDLoad adatterületeket, amely nagy
valószínűséggel a WHDLoad és az operációs rendszer összeomlásához
vezethetnek. Ez az opció az ilyen problémák megoldásásra szolgál. Ha egy
installáló furcsán viselkedik vagy a WHDLoad összeomlik az opció nélkül,
viszont vele tökéletesen működik, akkor az valószínűleg megszakítási
probléma. Az ilyen esetekben az installáló javításra szorul.
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.