index.html

   1 <!DOCTYPE html>
   2 <html>
   3   <head>
   4     <meta charset='utf-8'>
   5     <meta http-equiv="X-UA-Compatible" content="chrome=1">
   6     <link href='https://fonts.googleapis.com/css?family=Chivo:900' rel='stylesheet' type='text/css'>
   7     <link rel="stylesheet" type="text/css" href="stylesheets/stylesheet.css" media="screen">
   8     <link rel="stylesheet" type="text/css" href="stylesheets/pygment_trac.css" media="screen">
   9     <link rel="stylesheet" type="text/css" href="stylesheets/print.css" media="print">
  10     <!--[if lt IE 9]>
  11     <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
  12     <![endif]-->
  13     <title>BOS by bubach</title>
  14   </head>
  15
  16   <body>
  17     <div id="container">
  18       <div class="inner">
  19
  20         <header>
  21           <h1>BOS</h1>
  22           <h2>BOS - a small x86 operating system written in Assembly</h2>
  23         </header>
  24
  25         <section id="downloads" class="clearfix">
  26           <a href="https://github.com/bubach/BOS/zipball/master" id="download-zip" class="button"><span>Download .zip</span></a>
  27           <a href="https://github.com/bubach/BOS/tarball/master" id="download-tar-gz" class="button"><span>Download .tar.gz</span></a>
  28           <a href="https://github.com/bubach/BOS" id="view-on-github" class="button"><span>View on GitHub</span></a>
  29         </section>
  30
  31         <hr>
  32
  33         <section id="main_content">
  34           <h3>
  35 <a id="welcome-to-bos-github-page" class="anchor" href="#welcome-to-bos-github-page" aria-hidden="true"><span class="octicon octicon-link"></span></a>Welcome to BOS Github page.</h3>
  36
  37 <p>BOS official webpage with forums can be found at <a href="http://bos.asmhackers.net/">BOS</a>. On this page I'll just provide a quickstart for how to try BOS. I'm basing this on OSX, but should be similar for *nix, and the repository has a .bat script for Windows.</p>
  38
  39 <h3>
  40 <a id="getting-the-os-image-file" class="anchor" href="#getting-the-os-image-file" aria-hidden="true"><span class="octicon octicon-link"></span></a>Getting the OS image file</h3>
  41
  42 <p>Here I'll provide links to the newest available BOS images for direct testing:
  43 <a href="https://github.com/bubach/BOS/raw/master/bos.img">1.44MB floppy image</a></p>
  44
  45 <p>The image was created on my OSX setup with these commands, using the Homebrew <code>brew install mtools</code> package.</p>
  46
  47 <pre><code>$ mformat -C -f 1440 -v BOS -i ./bos.img ::
  48 $ hdiutil attach ./bos.img
  49 $ cp ./kernel/kernel.sys /Volumes/BOS
  50 $ umount /Volumes/BOS
  51 $ dd if=./boot/BOS_boot.bin of=/dev/disk1 bs=1 count=512
  52 $ hdiutil detach /dev/disk1
  53 $ chmod 0777 ./bos.img
  54 </code></pre>
  55
  56 <h3>
  57 <a id="testing-the-os" class="anchor" href="#testing-the-os" aria-hidden="true"><span class="octicon octicon-link"></span></a>Testing the OS</h3>
  58
  59 <p>To test the OS you will need Bochs, Qemu or a physical floppy driver in your desktop computer. Bochs can be downloaded on OSX with homebrew by first getting the X11 <code>xquartz</code> package. After that is installed, run:</p>
  60
  61 <pre><code>$ brew install homebrew/x11/bochs
  62 $ bochs -f ./doc/bochsrc-osx.txt
  63 </code></pre>
  64
  65 <h3>
  66 <a id="commands" class="anchor" href="#commands" aria-hidden="true"><span class="octicon octicon-link"></span></a>Commands</h3>
  67
  68 <p>Right now there isn't much you can do in BOS. The available commands will be listed by typing <code>help</code> followed by ENTER. As development goes on, I will go into more detail here.</p>
  69
  70 <h3>
  71 <a id="roadmap-and-goals" class="anchor" href="#roadmap-and-goals" aria-hidden="true"><span class="octicon octicon-link"></span></a>Roadmap and goals</h3>
  72
  73 <p>After several years with not much happening, I'm now back and fully committed on getting the next version of BOS released - which will focus mainly on a VFS (Virtual File System) abstraction layer for keeping track of storgage devices and filesystems.  Next release will feature the VFS with the updated floppy driver and FAT12 support.</p>
  74
  75 <h3>
  76 <a id="contribute" class="anchor" href="#contribute" aria-hidden="true"><span class="octicon octicon-link"></span></a>Contribute</h3>
  77
  78 <p>All contributions are welcomed. Be sure to visit the forums first, and announce what you might want to help out with, and then you create pull requests on Github.</p>
  79
  80 <h3>
  81 <a id="support-or-contact" class="anchor" href="#support-or-contact" aria-hidden="true"><span class="octicon octicon-link"></span></a>Support or Contact</h3>
  82
  83 <p>Having trouble? Check out the BOS forums at <a href="https://bos.asmhackers.net/forum">https://bos.asmhackers.net/forum</a> and we’ll help you sort it out.</p>
  84         </section>
  85
  86         <footer>
  87           BOS is maintained by <a href="https://github.com/bubach">bubach</a><br>
  88           This page was generated by <a href="http://pages.github.com">GitHub Pages</a>. Tactile theme by <a href="https://twitter.com/jasonlong">Jason Long</a>.
  89         </footer>
  90
  91
  92       </div>
  93     </div>
  94   </body>
  95 </html>