Getting Started

So how to set up the project?  Well, I only have instructions for Windows, but something for Linux or Mac could probably be worked out too.

Useful programs

• RadASM, from http://www.radasm.com/, for assembly editing
• MASM32, from http://www.masm32.com/, for assembling
• JLOC, from http://my.execpc.com/~geezer/johnfine/, for linking
• Dev-C++, from http://www.bloodshed.net/devcpp.html, for C editing
• MinGW, from http://www.mingw.org/, for C compiling
• Natural Docs, from http://www.naturaldocs.org/, for documentation generation
• SmartSVN, from http://www.syntevo.com/smartsvn/, for SVN access; (TortoiseSVN is also good)
• HP Drive Key Boot Utility for USB key image writing (go to http://www.hp.com/ and search for it)

Instructions for getting started with the binary

• Download and extract http://www.scs.carleton.ca- /~ndickson- /os- /downloads- /PwnOS.zip.
• Move the PwnOS directory to the root of any NTFS partition on an ATA-compliant harddrive.
• Use HP Drive Key Boot Utility to write the image file to a USB key.
• Boot your computer from the USB key.

Instructions for getting started with the code

• Check out the SVN repository from http://pwnos.googlecode.com/svn/trunk/ using whatever SVN program you want.
• Download RadASM.zip and Assembly.zip from http://www.radasm.com/.  Extract them both to a directory to hold RadASM.
• Download and install MASM32 from http://www.masm32.com/.  From the \masm32\bin\ directory, copy ml.exe, ml.err, MSPDB50.DLL, and LINK.EXE to the Programs/ directory of your local copy of the SVN.
• Download jloc07.zip from http://my.execpc.com/~geezer/johnfine/, and extract JLOC.EXE to the Programs/ directory of your local copy of the SVN.
• The Programs/RadASM/ directory contains various configuration files for RadASM.  Copy RadASM.ini and osmasm.ini into your RadASM directory, (or just copy the new parts of RadASM.ini if you have RadASM already and want to keep your settings).  Copy the rest of the configuration files to a new subdirectory thereof named “osmasm”.
• Run RadASM.exe and open the project (“.rap” file) to start working with the code.
• Select Build under the Make menu to build the project.  Note that Boot and Core are dependent on each other, so both need to be assembled before they can be linked.