<p>You should have completed the steps described in <ahref="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=en">CryptoBoxDevPreparation</a>. </p>
<p>Usually there is no need to repeat the whole process, after you changed some parts of the <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. Especially the first step (building of the base system with <em>dfsbuild</em>) may usually be skipped. </p>
<p>If you do not want to use the <em><aclass="interwiki"title="DebianPackage"href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=apt-cacher">apt-cacher</a></em> to save bandwidth and time, then you should modify the <em>mirror</em>-setting in <em>dfs-cbox.conf</em> (see <ahref="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a> for details). </p>
<p>Run <tt>scripts/cbox-build.sh config</tt> to copy the <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>-specific files to the base image. </p>
<h3id="head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</h3>
<p>The original base system, that was created by <em>dfsbuild</em> contains a lot packages and some scripts, that are only useful during development. You should remove them, as they case severe security implications. </p>
<p>To reduce the <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>-LiveCD to the usable minimum for operational use, you should run <tt>scripts/cbox-build.sh harden</tt>. </p>
<p>Create the <em>iso</em> image with <tt>scripts/cbox-build.sh iso</tt>. The resulting file can be found at <em>_builddir/cd1/cryptobox.iso</em>. </p>
<h3id="head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</h3>
<p>Do it manually: <tt>cdrecord -v dev=0,0,0 _builddir/cd1/cryptobox.iso</tt> (change the <em>dev</em> setting according to your setup). </p>
<p>Let the script do it for you: <tt>scripts/cbox-build.sh burn</tt> (maybe you have to change the <em>CDWRITER</em> setting in <em>cbox-dev.conf</em> - see <ahref="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a>). </p>
<p>This section is only useful for developers, who want to improve or change the <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system. </p>
<p>If you modified the <em>perl</em>- or <em>shell</em>-scripts of the <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>, then you can check for syntax errors by running them in a <em>chroot</em> environment. Be careful: you have access to all ressources of your computer, while you are working within a <em>chroot</em> environment - so you can easily repartition your real disk ... </p>
<p>The processor emulator <aclass="external"href="http://fabrice.bellard.free.fr/qemu">qemu</a> allows you test the <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> in a virtual environment, that is completely separated from your real computer's resources. It is the tool of choice, if you do nat have a real computer around for testing. </p>
<p>This section is only useful for developers, who want to develop on a running <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system (emulated or real). </p>
<p>You may access the <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> directly or you can use <em>ssh</em> to open a remote session (<tt>./cbox-dev.sh ssh</tt>). </p>
<h3id="head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</h3>
<p>When you run an emulation or test a real LiveCD, you may encounter problems and bugs. To test your fixes for these problems, it is convenient, to change the running test system. Afterwards you can merge these changes to your local development copy. </p>
<p>Type <tt>scripts/cbox-dev.sh diff</tt> to see the changes, you made on the running <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system. </p>
<p>Alternatively you may also upload a new version of your local working copy to the running <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system. </p>
<p>Type <tt>scripts/cbox-dev.sh upload</tt> - beware: all recent changes you made to the running <ahref="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system, are lost. </p>