ZealOS/docs/Doc/Install.DD.html

<!DOCTYPE HTML>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=US-ASCII">
<meta name="generator" content="ZealOS V1.04">
<style type="text/css">
body {background-color:#1f1f1f;}
.cF0{color:#e3e3e3;background-color:#1f1f1f;}
.cF1{color:#4f84a6;background-color:#1f1f1f;}
.cF2{color:#73a255;background-color:#1f1f1f;}
.cF3{color:#297582;background-color:#1f1f1f;}
.cF4{color:#b34f4b;background-color:#1f1f1f;}
.cF5{color:#8a52c3;background-color:#1f1f1f;}
.cF6{color:#b7822f;background-color:#1f1f1f;}
.cF7{color:#444444;background-color:#1f1f1f;}
.cF8{color:#6d6d6d;background-color:#1f1f1f;}
.cF9{color:#94bfde;background-color:#1f1f1f;}
.cFA{color:#a1ce97;background-color:#1f1f1f;}
.cFB{color:#6db4be;background-color:#1f1f1f;}
.cFC{color:#e88e88;background-color:#1f1f1f;}
.cFD{color:#ca94e8;background-color:#1f1f1f;}
.cFE{color:#d4b475;background-color:#1f1f1f;}
.cFF{color:#1f1f1f;background-color:#1f1f1f;}
</style>
</head>
<body>
<pre style="font-family:monospace;font-size:12pt">
<a name="l1"></a><span class=cF5>                                                      Installing ZealOS</span><span class=cF0>
<a name="l2"></a>
<a name="l3"></a>Burn a CD with software that supports ISO files.    Then, boot it.  It's a live CD, so you can look around with or without 
<a name="l4"></a>installing.
<a name="l5"></a>
<a name="l6"></a>Dual booting with another operating system is the best way to use ZealOS.  It is often used in a virtual machine because it 
<a name="l7"></a>won't boot natively on some machines, though.  For native dual booting, you need a partition for ZealOS.    Windows often 
<a name="l8"></a>comes with a restore disk that does not allow repartitioning.  It's recommended to connect a spare additional hard drive and 
<a name="l9"></a>use the </span><span class=cF2>BIOS</span><span class=cF0> to select which drive to boot.
<a name="l10"></a>
<a name="l11"></a>The </span><a href="https://zeal-operating-system.github.io/ZealOS/Misc/OSInstall.CC.html#l1"><span class=cF4>::/Misc/OSInstall.CC</span></a><span class=cF0> script will automate much of this. It runs if you boot the CD/DVD-ROM.
<a name="l12"></a>
<a name="l13"></a>See </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/Boot.DD.html#l1"><span class=cF4>Boot.DD</span></a><span class=cF0> for an overview of booting. See </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/Requirements.DD.html#l1"><span class=cF4>Requirements</span></a><span class=cF0> for supported hardware.
<a name="l14"></a>
<a name="l15"></a>Two ZealOS partitions are highly recommended, so you can boot to a back-up and fix the primary when you work on it.  Odds are, 
<a name="l16"></a>you only need a couple gigabytes for your ZealOS partitions.
<a name="l17"></a>
<a name="l18"></a>1)
<a name="l19"></a></span><span class=cF4>  </span><a href="https://zeal-operating-system.github.io/ZealOS/System/BlkDev/Mount.CC.html#l307"><span class=cF4>Mount</span></a><span class=cF0>() use if the drive is partitioned.
<a name="l20"></a>    This command mounts a drive making it accessible.  For simplicity, sel </span><span class=cF2>'C'</span><span class=cF0> as the first drive letter for your hard drive.  
<a name="l21"></a>    The first partition will be </span><span class=cF2>'C'</span><span class=cF0>, second, </span><span class=cF2>'D'</span><span class=cF0>, etc.  ZealOS needs only 1 number to utilize a hard drive -- port.
<a name="l22"></a>  </span><span class=cF4>
<a name="l23"></a>  </span><a href="https://zeal-operating-system.github.io/ZealOS/System/BlkDev/DiskPart.CC.html#l13"><span class=cF4>DiskPart</span></a><span class=cF0>(</span><span class=cF2>'C'</span><span class=cF0>) use if drive is not partitioned
<a name="l24"></a>  
<a name="l25"></a>    This will perform a special </span><a href="https://zeal-operating-system.github.io/ZealOS/System/BlkDev/Mount.CC.html#l307"><span class=cF4>Mount</span></a><span class=cF0>() automatically.
<a name="l26"></a>    
<a name="l27"></a>    <blink>WARNING:</blink>    This command erases everything on a hard drive.  It repartitions a whole drive and formats the partitions.  Th
<a name="l28"></a>    is command should be skipped if you already have your hard drive partitioned.
<a name="l29"></a>    
<a name="l30"></a>    
<a name="l31"></a>    <blink>WARNING:</blink>    This command doesn't play well with other operating systems.    You'll need to do a </span><a href="https://zeal-operating-system.github.io/ZealOS/System/Boot/BootMHDIns.CC.html#l58"><span class=cF4>BootMHDZero</span></a><span class=cF0>() to restore 
<a name="l32"></a>    your drive to a state where other operating systems can partition it.
<a name="l33"></a>  
<a name="l34"></a>2) </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/BlkDev/DiskFormat.CC.html#l67"><span class=cF4>Format</span></a><span class=cF0>(</span><span class=cF2>'D'</span><span class=cF0>,</span><span class=cF2> TRUE</span><span class=cF0>,</span><span class=cF2> FALSE</span><span class=cF0>,</span><span class=cF2> FSt_FAT32</span><span class=cF0>)
<a name="l35"></a>  This command formats a drive with </span><span class=cF2>FAT32</span><span class=cF0> or the </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/RedSea.DD.html#l1"><span class=cF4>RedSea</span></a><span class=cF0> file system type.   Use the drive letter of the partition in place of </span><span class=cF2>
<a name="l36"></a>  'D'</span><span class=cF0>.
<a name="l37"></a>  
<a name="l38"></a>  <blink>WARNING:</blink>  If you are upgrading, be sure not to lose the file, </span><span class=cF2>/Boot/OldMBR.BIN.C</span><span class=cF0>.
<a name="l39"></a>  
<a name="l40"></a>3) </span><a href="https://zeal-operating-system.github.io/ZealOS/System/BlkDev/ZDiskA.CC.html#l145"><span class=cF4>CopyTree</span></a><span class=cF0>(</span><span class=cF2>&quot;T:/&quot;</span><span class=cF0>,</span><span class=cF2> &quot;D:/&quot;</span><span class=cF0>)
<a name="l41"></a>  This command is used to copy files onto a hard drive partition from the CD/DVD.  Use the drive letter of the partition in 
<a name="l42"></a>  place of </span><span class=cF2>'D'</span><span class=cF0>.
<a name="l43"></a>  
<a name="l44"></a>4) </span><a href="https://zeal-operating-system.github.io/ZealOS/System/Boot/BootHDIns.CC.html#l25"><span class=cF4>BootHDIns</span></a><span class=cF0>(</span><span class=cF2>'D'</span><span class=cF0>)
<a name="l45"></a>  This command recompiles the source code on a drive and writes to the <u>drive's</u> boot record.  You'll need to reenter the </span><a href="https://zeal-operating-system.github.io/ZealOS/System/BlkDev/Mount.CC.html#l307"><span class=cF4>Mount</span></a><span class=cF0> 
<a name="l46"></a>  information so it can be stored in the kernel.
<a name="l47"></a>  
<a name="l48"></a>5) Use Linux's Grub or ZealOS' </span><a href="https://zeal-operating-system.github.io/ZealOS/System/Boot/BootMHDIns.CC.html#l76"><span class=cF4>BootMHDIns</span></a><span class=cF0>(</span><span class=cF2>'D'</span><span class=cF0>)
<a name="l49"></a>  
<a name="l50"></a>  The </span><a href="https://zeal-operating-system.github.io/ZealOS/System/Boot/BootMHDIns.CC.html#l76"><span class=cF4>BootMHDIns</span></a><span class=cF0>() command places a boot loader on a drive. It saves the old master boot record to </span><span class=cF2>/Boot/OldMBR.BIN.C</span><span class=cF0> and 
<a name="l51"></a>  replaces it.  When you boot, you will have the option of booting the old master boot record.  This command can be skipped if 
<a name="l52"></a>  you already have a boot loader.   Be sure not to lose the copy of the old boot record, like if you reformat the drive.
<a name="l53"></a>  
<a name="l54"></a>  Delete </span><span class=cF2>/Boot/OldMBR.BIN.C</span><span class=cF0> if you want to get a fresh copy of a mbr, like if installing from your own custom CD containing 
<a name="l55"></a>  it's own </span><span class=cF2>/Boot/OldMBR.BIN.C</span><span class=cF0> onto a system with a non-ZealOS boot loader.
<a name="l56"></a>  
<a name="l57"></a>  If you have anti-virus software, it might object to having a different master boot record.
<a name="l58"></a>
<a name="l59"></a></span><span class=cF8>
<a name="l60"></a>* &quot;Windows&quot; is a trademark owned by MicroSoft Corp.
<a name="l61"></a>* &quot;Linux&quot; is a trademark owned by Linus Torvalds.
<a name="l62"></a></span></pre></body>
</html>
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<!DOCTYPE HTML>`
			`<html>`
			`<head>`
			`<meta http-equiv="Content-Type" content="text/html;charset=US-ASCII">`
Update documentation. 2021-10-27 08:28:16 +01:00			`<meta name="generator" content="ZealOS V1.04">`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<style type="text/css">`
Add SSE instruction support to assembler. (Only 2-arg instructions implemented. CosmiC assembler needs expanding to allow 3+ arg instructions.) (Only <= 4 byte instructions implemented. CosmiC assembler needs expanding to allow instructions larger than 4 bytes.) (Bugs: Unassembler incorrectly reports 0x66 prefixed opcodes, non-128-bit instruction arguments report as U128. CosmiC does not yet have support for U128.) Fix Std Font characters. Add links to ZealOS-specific apps in Personal Menu. Remove all files in /Downloads. 2021-10-08 07:06:11 +01:00			`body {background-color:#1f1f1f;}`
			`.cF0{color:#e3e3e3;background-color:#1f1f1f;}`
			`.cF1{color:#4f84a6;background-color:#1f1f1f;}`
			`.cF2{color:#73a255;background-color:#1f1f1f;}`
			`.cF3{color:#297582;background-color:#1f1f1f;}`
			`.cF4{color:#b34f4b;background-color:#1f1f1f;}`
			`.cF5{color:#8a52c3;background-color:#1f1f1f;}`
			`.cF6{color:#b7822f;background-color:#1f1f1f;}`
			`.cF7{color:#444444;background-color:#1f1f1f;}`
			`.cF8{color:#6d6d6d;background-color:#1f1f1f;}`
			`.cF9{color:#94bfde;background-color:#1f1f1f;}`
			`.cFA{color:#a1ce97;background-color:#1f1f1f;}`
			`.cFB{color:#6db4be;background-color:#1f1f1f;}`
			`.cFC{color:#e88e88;background-color:#1f1f1f;}`
			`.cFD{color:#ca94e8;background-color:#1f1f1f;}`
			`.cFE{color:#d4b475;background-color:#1f1f1f;}`
			`.cFF{color:#1f1f1f;background-color:#1f1f1f;}`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`</style>`
			`</head>`
			`<body>`
Fix HTML generation on files with duplicate names but different extensions. 2021-07-05 01:12:38 +01:00			`<pre style="font-family:monospace;font-size:12pt">`
Optimize HTML doc generation. Change repeated #include and PopUps during HTML generation into one slave task. 2021-07-12 08:26:39 +01:00			`<a name="l1"></a><span class=cF5> Installing ZealOS</span><span class=cF0>`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l2"></a>`
Fix HTML index file generation. Fix HTML generation tab width. 2021-07-04 23:11:34 +01:00			`<a name="l3"></a>Burn a CD with software that supports ISO files. Then, boot it. It's a live CD, so you can look around with or without`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l4"></a>installing.`
			`<a name="l5"></a>`
			`<a name="l6"></a>Dual booting with another operating system is the best way to use ZealOS. It is often used in a virtual machine because it`
Optimize HTML doc generation. Change repeated #include and PopUps during HTML generation into one slave task. 2021-07-12 08:26:39 +01:00			`<a name="l7"></a>won't boot natively on some machines, though. For native dual booting, you need a partition for ZealOS. Windows often`
			`<a name="l8"></a>comes with a restore disk that does not allow repartitioning. It's recommended to connect a spare additional hard drive and`
			`<a name="l9"></a>use the </span><span class=cF2>BIOS</span><span class=cF0> to select which drive to boot.`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l10"></a>`
Add AHCI Debug methods. Fix HTML URL. Begin implementing AHCI ATAPI Sync, Close, Format, and Write methods. 2021-07-26 20:29:49 +01:00			`<a name="l11"></a>The </span><a href="https://zeal-operating-system.github.io/ZealOS/Misc/OSInstall.CC.html#l1"><span class=cF4>::/Misc/OSInstall.CC</span></a><span class=cF0> script will automate much of this. It runs if you boot the CD/DVD-ROM.`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l12"></a>`
Add AHCI Debug methods. Fix HTML URL. Begin implementing AHCI ATAPI Sync, Close, Format, and Write methods. 2021-07-26 20:29:49 +01:00			`<a name="l13"></a>See </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/Boot.DD.html#l1"><span class=cF4>Boot.DD</span></a><span class=cF0> for an overview of booting. See </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/Requirements.DD.html#l1"><span class=cF4>Requirements</span></a><span class=cF0> for supported hardware.`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l14"></a>`
			`<a name="l15"></a>Two ZealOS partitions are highly recommended, so you can boot to a back-up and fix the primary when you work on it. Odds are,`
			`<a name="l16"></a>you only need a couple gigabytes for your ZealOS partitions.`
			`<a name="l17"></a>`
			`<a name="l18"></a>1)`
Add try-catch to SATARep and AHCIBootDVDProbeAll. Add CAtapiCloseCmd to clean up AHCIAtapiClose. Improve comments at AHCIAtapiModeWriteSelect. 2021-08-16 05:52:03 +01:00			`<a name="l19"></a></span><span class=cF4> </span><a href="https://zeal-operating-system.github.io/ZealOS/System/BlkDev/Mount.CC.html#l307"><span class=cF4>Mount</span></a><span class=cF0>() use if the drive is partitioned.`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l20"></a> This command mounts a drive making it accessible. For simplicity, sel </span><span class=cF2>'C'</span><span class=cF0> as the first drive letter for your hard drive.`
			`<a name="l21"></a> The first partition will be </span><span class=cF2>'C'</span><span class=cF0>, second, </span><span class=cF2>'D'</span><span class=cF0>, etc. ZealOS needs only 1 number to utilize a hard drive -- port.`
			`<a name="l22"></a> </span><span class=cF4>`
Add AHCI Debug methods. Fix HTML URL. Begin implementing AHCI ATAPI Sync, Close, Format, and Write methods. 2021-07-26 20:29:49 +01:00			`<a name="l23"></a> </span><a href="https://zeal-operating-system.github.io/ZealOS/System/BlkDev/DiskPart.CC.html#l13"><span class=cF4>DiskPart</span></a><span class=cF0>(</span><span class=cF2>'C'</span><span class=cF0>) use if drive is not partitioned`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l24"></a>`
Add try-catch to SATARep and AHCIBootDVDProbeAll. Add CAtapiCloseCmd to clean up AHCIAtapiClose. Improve comments at AHCIAtapiModeWriteSelect. 2021-08-16 05:52:03 +01:00			`<a name="l25"></a> This will perform a special </span><a href="https://zeal-operating-system.github.io/ZealOS/System/BlkDev/Mount.CC.html#l307"><span class=cF4>Mount</span></a><span class=cF0>() automatically.`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l26"></a>`
Optimize HTML doc generation. Change repeated #include and PopUps during HTML generation into one slave task. 2021-07-12 08:26:39 +01:00			`<a name="l27"></a> <blink>WARNING:</blink> This command erases everything on a hard drive. It repartitions a whole drive and formats the partitions. Th`
			`<a name="l28"></a> is command should be skipped if you already have your hard drive partitioned.`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l29"></a>`
			`<a name="l30"></a>`
Add AHCI Debug methods. Fix HTML URL. Begin implementing AHCI ATAPI Sync, Close, Format, and Write methods. 2021-07-26 20:29:49 +01:00			`<a name="l31"></a> <blink>WARNING:</blink> This command doesn't play well with other operating systems. You'll need to do a </span><a href="https://zeal-operating-system.github.io/ZealOS/System/Boot/BootMHDIns.CC.html#l58"><span class=cF4>BootMHDZero</span></a><span class=cF0>() to restore`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l32"></a> your drive to a state where other operating systems can partition it.`
			`<a name="l33"></a>`
Add AHCI Debug methods. Fix HTML URL. Begin implementing AHCI ATAPI Sync, Close, Format, and Write methods. 2021-07-26 20:29:49 +01:00			`<a name="l34"></a>2) </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/BlkDev/DiskFormat.CC.html#l67"><span class=cF4>Format</span></a><span class=cF0>(</span><span class=cF2>'D'</span><span class=cF0>,</span><span class=cF2> TRUE</span><span class=cF0>,</span><span class=cF2> FALSE</span><span class=cF0>,</span><span class=cF2> FSt_FAT32</span><span class=cF0>)`
			`<a name="l35"></a> This command formats a drive with </span><span class=cF2>FAT32</span><span class=cF0> or the </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/RedSea.DD.html#l1"><span class=cF4>RedSea</span></a><span class=cF0> file system type. Use the drive letter of the partition in place of </span><span class=cF2>`
Optimize HTML doc generation. Change repeated #include and PopUps during HTML generation into one slave task. 2021-07-12 08:26:39 +01:00			`<a name="l36"></a> 'D'</span><span class=cF0>.`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l37"></a>`
Rename /0000Boot to /Boot. Rename 0000Kernel.BIN.C to Kernel.BIN.C. 2021-07-24 05:48:21 +01:00			`<a name="l38"></a> <blink>WARNING:</blink> If you are upgrading, be sure not to lose the file, </span><span class=cF2>/Boot/OldMBR.BIN.C</span><span class=cF0>.`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l39"></a>`
Fix DVDImageRead block count. Change left window border text to use inverted color attribute. Fix ISOInit to account for non-ZealOS legacy CISOPriDesc. 2021-08-17 01:46:17 +01:00			`<a name="l40"></a>3) </span><a href="https://zeal-operating-system.github.io/ZealOS/System/BlkDev/ZDiskA.CC.html#l145"><span class=cF4>CopyTree</span></a><span class=cF0>(</span><span class=cF2>"T:/"</span><span class=cF0>,</span><span class=cF2> "D:/"</span><span class=cF0>)`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l41"></a> This command is used to copy files onto a hard drive partition from the CD/DVD. Use the drive letter of the partition in`
			`<a name="l42"></a> place of </span><span class=cF2>'D'</span><span class=cF0>.`
			`<a name="l43"></a>`
Add AHCI Debug methods. Fix HTML URL. Begin implementing AHCI ATAPI Sync, Close, Format, and Write methods. 2021-07-26 20:29:49 +01:00			`<a name="l44"></a>4) </span><a href="https://zeal-operating-system.github.io/ZealOS/System/Boot/BootHDIns.CC.html#l25"><span class=cF4>BootHDIns</span></a><span class=cF0>(</span><span class=cF2>'D'</span><span class=cF0>)`
Add try-catch to SATARep and AHCIBootDVDProbeAll. Add CAtapiCloseCmd to clean up AHCIAtapiClose. Improve comments at AHCIAtapiModeWriteSelect. 2021-08-16 05:52:03 +01:00			`<a name="l45"></a> This command recompiles the source code on a drive and writes to the <u>drive's</u> boot record. You'll need to reenter the </span><a href="https://zeal-operating-system.github.io/ZealOS/System/BlkDev/Mount.CC.html#l307"><span class=cF4>Mount</span></a><span class=cF0>`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l46"></a> information so it can be stored in the kernel.`
			`<a name="l47"></a>`
Add AHCI Debug methods. Fix HTML URL. Begin implementing AHCI ATAPI Sync, Close, Format, and Write methods. 2021-07-26 20:29:49 +01:00			`<a name="l48"></a>5) Use Linux's Grub or ZealOS' </span><a href="https://zeal-operating-system.github.io/ZealOS/System/Boot/BootMHDIns.CC.html#l76"><span class=cF4>BootMHDIns</span></a><span class=cF0>(</span><span class=cF2>'D'</span><span class=cF0>)`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l49"></a>`
Add AHCI Debug methods. Fix HTML URL. Begin implementing AHCI ATAPI Sync, Close, Format, and Write methods. 2021-07-26 20:29:49 +01:00			`<a name="l50"></a> The </span><a href="https://zeal-operating-system.github.io/ZealOS/System/Boot/BootMHDIns.CC.html#l76"><span class=cF4>BootMHDIns</span></a><span class=cF0>() command places a boot loader on a drive. It saves the old master boot record to </span><span class=cF2>/Boot/OldMBR.BIN.C</span><span class=cF0> and`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l51"></a> replaces it. When you boot, you will have the option of booting the old master boot record. This command can be skipped if`
Fix HTML index file generation. Fix HTML generation tab width. 2021-07-04 23:11:34 +01:00			`<a name="l52"></a> you already have a boot loader. Be sure not to lose the copy of the old boot record, like if you reformat the drive.`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l53"></a>`
Rename /0000Boot to /Boot. Rename 0000Kernel.BIN.C to Kernel.BIN.C. 2021-07-24 05:48:21 +01:00			`<a name="l54"></a> Delete </span><span class=cF2>/Boot/OldMBR.BIN.C</span><span class=cF0> if you want to get a fresh copy of a mbr, like if installing from your own custom CD containing`
			`<a name="l55"></a> it's own </span><span class=cF2>/Boot/OldMBR.BIN.C</span><span class=cF0> onto a system with a non-ZealOS boot loader.`
Implement codebase HTML generation. 2021-07-03 05:07:57 +01:00			`<a name="l56"></a>`
			`<a name="l57"></a> If you have anti-virus software, it might object to having a different master boot record.`
			`<a name="l58"></a>`
			`<a name="l59"></a></span><span class=cF8>`
			`<a name="l60"></a>* "Windows" is a trademark owned by MicroSoft Corp.`
			`<a name="l61"></a>* "Linux" is a trademark owned by Linus Torvalds.`
			`<a name="l62"></a></span></pre></body>`
			`</html>`