cryptonas/cryptonas-branches
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

added all non-code changes between r281 and r300 to the new release candidate

Browse source
This commit is contained in:
lars 2005-10-17 14:36:12 +00:00
parent 3cad3c5ae8
commit 7260c63d86
107 changed files with 5526 additions and 4016 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
v0.2.1/README
View file

@ -1,21 +1,24 @@
TODO: write a good README :) $Id$
CryptoBox version 0.2.1
1) Documentation 1) Documentation
The documentation is available at https://systemausfall.org/toolforge/CryptoBox The documentation is available at https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser
2) Building a LiveCD 2) Building a LiveCD
try: "scripts/cbox-build.sh release" try: "scripts/cbox-build.sh release"
or look at the developer's documentation: https://systemausfall.org/toolforge/CryptoBoxDev or look at the developer's documentation: https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxDev
3) Bug reporting 3) Bug reporting
Use our issue tracker at https://systemausfall.org/trac/cryptobox Use our issue tracker at https://systemausfall.org/trac/cryptobox/newticket
4) Licence 4) Licence
All scripts are GPL code (v2.0 or above). All scripts are GPL code (v2.0 or above).
The documentation is licenced under "Creative Commons 2.0 non-commercial share-alike" (http://creativecommons.org/licenses/by-nc-sa/2.0/) The documentation is licenced under "Creative Commons 2.5 share-alike" (http://creativecommons.org/licenses/by-sa/2.5/).
5) Contributors 5) Contributors
Clavdia Horvat, Tadej Brce & Dušan Rebolj - slovenian translation Clavdia Horvat, Tadej Brce & Dušan Rebolj - slovenian translation
6) Contact 6) Contact
email us: cryptobox@systemausfall.org email: cryptobox@systemausfall.org
The CryptoBox project is mainly driven by sense.lab (https://systemausfall.org/senselab).

210
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBox.html
View file

@ -29,142 +29,90 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBox.html#Neuigkeiten">Neuigkeiten</a></li>
<li> <li><a href="CryptoBox.html#berblick">Überblick</a></li>
<a href="#head-e50e9371b89733779dffda07519c0bdfb6c3cd19">Neuigkeiten</a> <li><a href="CryptoBox.html#Download">Download</a></li>
</li> <li><a href="CryptoBox.html#Support">Support</a></li>
<li><a href="CryptoBox.html#Entwicklung">Entwicklung</a></li>
<li> <li><a href="CryptoBox.html#Mitwirkende">Mitwirkende</a></li>
<a href="#head-a6addcb037bbd74e8c3f533fcbc9b974c5008676">Überblick</a> <li><a href="CryptoBox.html#Rechtliches">Rechtliches</a></li>
</li> <li><a href="CryptoBox.html#Kommentare">Kommentare</a></li>
<li>
<a href="#head-5b1aae7bec38aaabf39d79875117c8c10c945603">Spezifikationen</a>
</li>
<li>
<a href="#head-2614272d10d2679e8451f66e39db184578ec3d7c">Nutzung</a>
</li>
<li>
<a href="#head-b1bdcd2edb5c97874f17e2830b40854662ae1ef6">Mitmachen</a>
</li>
<li>
<a href="#head-f8cc7f13417e1024c0e7f219cc43f0fd9000ad72">Rechtliches</a>
</li>
</ol> </ol>
<p> </p>
<hr>
<p> </p>
<p><em>unter <a href="CryptoBoxIntro.html">CryptoBoxIntro/de</a> findest du einen sehr kurzen Überblick</em> </p>
<h2 id="head-e50e9371b89733779dffda07519c0bdfb6c3cd19">Neuigkeiten</h2>
<p>Das erste Release der <a href="CryptoBox.html">CryptoBox</a> wird im Oktober bei <a href="http://codecoop.org/projects/cryptobox/">http://codecoop.org/projects/cryptobox/</a> verfügbar sein. </p>
<h2 id="head-a6addcb037bbd74e8c3f533fcbc9b974c5008676">Überblick</h2>
<p>Die <a href="CryptoBox.html">CryptoBox</a> ist eine <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Live-cd">Live-CD</a> mit der sich jeder alte Rechner in Sekundenschnelle in einen verschlüsselnden Server umwandeln lässt. Damit kannst du sensible Daten speichern, ohne dass du etwas über <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Kryptografie">Kryptografie</a> wissen musst. </p>
<p>Die Dokumentation der <a href="CryptoBox.html">CryptoBox</a> ist bisher in folgenden Sprachen verfügbar: </p>
<ul>
<li><p> <a href="CryptoBox.html">deutsch</a> </p>
</li>
<li><p> <a href="CryptoBox.html">english</a> </p>
</li>
</ul>
<p>Wir freuen uns über weitere Übersetzugen <img src="../../../var/www/cryptobox-img/smile.png" alt=":)" height="15" width="15"> </p>
<h2 id="head-5b1aae7bec38aaabf39d79875117c8c10c945603">Spezifikationen</h2>
<div>
<table>
<tr>
<td>
<p>System</p>
</td>
<td>
<p>Debian/Linux basierte Live-CD</p>
</td>
</tr>
<tr>
<td>
<p>benötigter Computer</p>
</td>
<td>
<p> "ausrangierter" PC (i386 ab p1 mind. 32MB RAM)</p>
</td>
</tr>
<tr>
<td>
<p>unterstützte Clients</p>
</td>
<td>
<p><a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Liste_der_Betriebssysteme">*nix; *bsd; Windows; Mac OS</a></p>
</td>
</tr>
<tr>
<td>
<p>interner Fileserver</p>
</td>
<td>
<p><a class="external" href="http://samba.org">samba</a> (Netzwerkfreigaben)</p>
</td>
</tr>
<tr>
<td>
<p>Benutzerschnittstelle</p>
</td>
<td>
<p>per Browser bedienbares Web-Interface</p>
</td>
</tr>
<tr>
<td>
<p>Verschlüsselung</p>
</td>
<td>
<p><a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Advanced_Encryption_Standard">AES</a> via device-mapper</p>
</td>
</tr>
</table>
</div> </div>
<p>Das Web-Interface der <a href="CryptoBox.html">CryptoBox</a> ünterstützt derzeit folgende Sprachen: </p>
<ul>
<li><p> deutsch </p>
</li>
<li><p> englisch </p>
</li>
<li><p> slowenisch </p>
</li>
</ul>
<p>Du kannst gern weitere <a class="interwiki" title="SubVersion" href="/websvn/cryptobox/trunk/cbox-tree.d/usr/share/cryptobox/lang/en.hdf">Übersetzungen</a> in andere Sprachen hinzufügen (idealerweise utf-encodiert). </p>
<h2 id="head-2614272d10d2679e8451f66e39db184578ec3d7c">Nutzung</h2> </p>
<h1 id="DieCryptoBox">Die CryptoBox</h1>
<p>Das Nutzerhandbuch ist unter <a href="CryptoBoxUser.html">CryptoBoxUser/de</a> verfügbar. </p> <p>
<i><a href="CryptoBox.html">English version</a></i>
<h2 id="head-b1bdcd2edb5c97874f17e2830b40854662ae1ef6">Mitmachen</h2> </p>
<h2 id="Neuigkeiten">Neuigkeiten</h2>
<p>Beteilige dich an der Entwicklung der <a href="CryptoBox.html">CryptoBox</a> und werde reich und schön! <img src="../../../var/www/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> <br> <p>
Nee im Ernst, wir freuen uns über jeden partizipierenden Menschen. Du wirst in einem entspannten Team reichlich Erfahrungen sammeln, eine nützliche Sache voranbringen und - wer weiß - vielleicht macht dich das auch schön. Schreib eine Mail an <em>cryptobox[at]systemausfall.org</em> und hab Spaß. </p> Das erste Release der <a href="CryptoBox.html">CryptoBox</a> ist bei <a class="ext-link" title="https://codecoop.org/projects/cryptobox/" href="https://codecoop.org/projects/cryptobox/">Codecoop.org</a> verfügbar.
<p>Fehler kannst du in unserer <a class="external" href="https://systemausfall.org/trac/cryptobox">Fehlerdatenbank</a> eintragen. </p> </p>
<p>Die Entwickler-Doku findest du unter <a href="CryptoBoxDev.html">CryptoBoxDev</a> (bisher nur englisch). </p> <h2 id="berblick">Überblick</h2>
<p>
<h2 id="head-f8cc7f13417e1024c0e7f219cc43f0fd9000ad72">Rechtliches</h2> Die <a href="CryptoBox.html">CryptoBox</a> ist eine <a class="ext-link" title="http://de.wikipedia.org/wiki/Live-cd" href="http://de.wikipedia.org/wiki/Live-cd">Live-CD</a> mit der sich jeder alte Rechner in Sekundenschnelle in einen verschlüsselnden Server umwandeln lässt. Damit kannst du sensible Daten speichern, ohne dass du etwas über <a class="ext-link" title="http://de.wikipedia.org/wiki/Kryptografie" href="http://de.wikipedia.org/wiki/Kryptografie">Kryptografie</a> wissen musst.<br />
Die Bedienung erfolgt vollständig per Webbrowser. Wirf einen Blick auf die <a href="ScreenShots.html">ScreenShots</a>.
<ol type="1"> </p>
<li><p>Alle Skripte unterliegen der <a class="external" href="http://www.fsf.org/licensing/licenses/gpl.html">GPL</a> - sie sind also quasi vollständig frei. </p> <table class="wiki">
</li> <tr><td><i>Spezifikation</i>
<li><p>Die Dokumentation unterliegt einer <em><a class="external" href="http://creativecommons.org/licenses/by-sa-nc/2.0/">Creative Commons</a></em>-Lizenz, damit wird die Möglichkeit der freien Verbreitung des gesammelten Wissens gewährleistet. </p> </td></tr><tr><td>System</td><td>Debian GNU/Linux-basierte Live-CD
</li> </td></tr><tr><td>benötigter Computer</td><td>&#34;ausrangierter&#34; PC (i386 ab p1 mind. 32MB RAM)
<li><p>Wir übernehmen keinerlei Haftung für eventuelle Folgen, die durch die Nutzung einer <a href="CryptoBox.html">CryptoBox</a> entstehen könnten. </p> </td></tr><tr><td>unterstützte Clients</td><td><a class="ext-link" title="http://de.wikipedia.org/wiki/Liste_der_Betriebssysteme" href="http://de.wikipedia.org/wiki/Liste_der_Betriebssysteme">*nix; *bsd; Windows; Mac OS</a>
</li> </td></tr><tr><td>interner Fileserver</td><td><a class="ext-link" title="http://samba.org" href="http://samba.org">samba</a> (Netzwerkfreigaben)
</ol> </td></tr><tr><td>Benutzerschnittstelle</td><td>per Browser bedienbares Web-Interface
</td></tr><tr><td>Verschlüsselung</td><td><a class="ext-link" title="http://de.wikipedia.org/wiki/Advanced_Encryption_Standard" href="http://de.wikipedia.org/wiki/Advanced_Encryption_Standard">AES</a> via device-mapper
</td></tr></table>
<p>
Das Web-Interface der <a href="CryptoBox.html">CryptoBox</a> unterstützt derzeit folgende Sprachen:
</p>
<ul><li>deutsch
</li><li>englisch
</li><li>slowenisch
</li></ul><p>
Wir suchen noch Übersetzungen in andere Sprachen. Wenn du dich beteiligen möchtest, wirf einen Blick in die <a href="/trac/cryptobox/browser/trunk/cbox-tree.d/usr/share/cryptobox/lang">Übersetzungen-Sektion</a>. Dort gibt es eine &#34;README&#34; Datei in der genauere Beschreibungen stehen.
</p>
<h2 id="Download">Download</h2>
<ul><li><a class="ext-link" title="http://codecoop.org/frs/download.php/32/cryptobox_0.2.iso" href="http://codecoop.org/frs/download.php/32/cryptobox_0.2.iso">Version 0.2</a> [104 MB] - <a href="/trac/cryptobox/wiki/ReleaseNotes/0.2">Release notes</a>
<ul><li><i>bereitgestellt durch <a class="ext-link" title="http://codecoop.org" href="http://codecoop.org">http://codecoop.org</a></i>
</li></ul></li></ul><h2 id="Support">Support</h2>
<ul><li>Das Nutzerhandbuch ist unter <a href="CryptoBoxUser.html">CryptoBoxUser</a> verfügbar.
</li><li>Probleme und Anregungen kannst du unser <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/newticket" href="https://systemausfall.org/trac/cryptobox/newticket">Fehlerdatenbank</a> melden
</li><li>Für allgemeine Fragen, schreibe eine Email an <i>cryptobox[at]systemausfall.org</i>.
</li></ul><h2 id="Entwicklung">Entwicklung</h2>
<p>
Beteilige dich an der Entwicklung der <a href="CryptoBox.html">CryptoBox</a> und werde reich und schön! ;) <br />
Nee im Ernst, wir freuen uns über jeden partizipierenden Menschen. Du wirst in einem entspannten Team reichlich Erfahrungen sammeln, eine nützliche Sache voranbringen und - wer weiß - vielleicht macht dich das auch schön. <br />
Schreib eine Mail an <i>cryptobox[at]systemausfall.org</i> und hab Spaß.
</p>
<p>
Die englischsprachige Entwickler-Doku findest du unter <a href="CryptoBoxDev.html">CryptoBoxDev</a>.
</p>
<h2 id="Mitwirkende">Mitwirkende</h2>
<p>
<ul><li>Clavdia Horvat, Tadej Brce &amp; Dušan Rebolj - slovenian translation
</li><li><a class="ext-link" title="http://codecoop.org" href="http://codecoop.org">http://codecoop.org</a> - webspace
</li></ul>
</p>
<h2 id="Rechtliches">Rechtliches</h2>
<ol><li>Alle Skripte unterliegen der <a class="ext-link" title="http://www.fsf.org/licensing/licenses/gpl.html" href="http://www.fsf.org/licensing/licenses/gpl.html">GPL</a> - sie sind also quasi vollständig frei.
</li><li>Die Dokumentation unterliegt einer <i><a class="ext-link" title="http://creativecommons.org/licenses/by-sa-nc/2.0/" href="http://creativecommons.org/licenses/by-sa-nc/2.0/">Creative Commons</a></i>-Lizenz, damit wird die Möglichkeit der freien Verbreitung des gesammelten Wissens gewährleistet.
</li><li>Wir übernehmen keinerlei Haftung für eventuelle Folgen, die durch die Nutzung einer <a href="CryptoBox.html">CryptoBox</a> entstehen könnten.
</li></ol><hr />
<h2 id="Kommentare">Kommentare</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

126
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxDev.html
View file

@ -29,53 +29,97 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevPreparation.html#Preparationsfordevelopers">Preparations for developers</a></li>
<li> <ol><li><a href="CryptoBoxDevPreparation.html#Softwarerequirements">Software requirements</a></li>
<a href="#head-85f75330e62e5b1efc9f504fe9cb51a1b966dc3b">Development documentation</a> <li><a href="CryptoBoxDevPreparation.html#Getthesource">Get the source</a></li>
</li> <li><a href="CryptoBoxDevPreparation.html#Firstbuild">First build</a></li>
<li><a href="CryptoBoxDevPreparation.html#Finished">Finished</a></li>
<li> <li><a href="CryptoBoxDevPreparation.html#Comments">Comments</a></li>
<a href="#head-b8ce79abe983e1592235d0085dd6928b83811739">Contact</a>
</li>
<li>
<a href="#head-964f56b054273ed39bab34484f83ac053ac0f12e">Bug reports</a>
</li>
</ol> </ol>
<p> </p> <li><a href="CryptoBoxDevWorkFlow.html#Developmentworkflow">Development workflow</a></li>
<hr> <ol><li><a href="CryptoBoxDevWorkFlow.html#Preparations">Preparations</a></li>
<p> </p> <li><a href="CryptoBoxDevWorkFlow.html#CreateaCryptoBoxLiveCD">Create a CryptoBox-LiveCD</a></li>
<li><a href="CryptoBoxDevWorkFlow.html#TesttheCryptoBoxLiveCD">Test the CryptoBox-LiveCD</a></li>
<li><a href="CryptoBoxDevWorkFlow.html#Debuggingandmerging">Debugging and merging</a></li>
<li><a href="CryptoBoxDevWorkFlow.html#Comments">Comments</a></li>
</ol>
<li><a href="CryptoBoxDevCustomBuild.html#CustombuildsoftheCryptoBox">Custom builds of the CryptoBox</a></li>
<ol><li><a href="CryptoBoxDevCustomBuild.html#Overview">Overview</a></li>
<li><a href="CryptoBoxDevCustomBuild.html#Settings">Settings</a></li>
<li><a href="CryptoBoxDevCustomBuild.html#Comments">Comments</a></li>
</ol>
<li><a href="CryptoBoxDevCustomConfigure.html#CustomconfigurationoftheCryptoBox">Custom configuration of the CryptoBox</a></li>
<ol><li><a href="CryptoBoxDevCustomConfigure.html#Overview">Overview</a></li>
<li><a href="CryptoBoxDevCustomConfigure.html#Locations">Locations</a></li>
<li><a href="CryptoBoxDevCustomConfigure.html#Examples">Examples</a></li>
<li><a href="CryptoBoxDevCustomConfigure.html#Comments">Comments</a></li>
</ol>
<li><a href="CryptoBoxDevValidation.html#ValidationoftheCryptoBox">Validation of the CryptoBox</a></li>
<ol><li><a href="CryptoBoxDevValidation.html#Overview">Overview</a></li>
<li><a href="CryptoBoxDevValidation.html#Validate">Validate</a></li>
<li><a href="CryptoBoxDevValidation.html#Howtocreateatest">How to create a test</a></li>
<li><a href="CryptoBoxDevValidation.html#Comments">Comments</a></li>
</ol>
<li><a href="CryptoBoxDevBackground.html#DetailsoftheCryptoBox">Details of the CryptoBox</a></li>
<ol><li><a href="CryptoBoxDevBackground.html#dfsbuild">dfsbuild</a></li>
<li><a href="CryptoBoxDevBackground.html#thekernel">the kernel</a></li>
<li><a href="CryptoBoxDevBackground.html#qemu">qemu</a></li>
<li><a href="CryptoBoxDevBackground.html#alternativeLiveCDs">alternative LiveCDs</a></li>
<li><a href="CryptoBoxDevBackground.html#Comments">Comments</a></li>
</ol>
<li><a href="CryptoBoxDevKnownProblems.html#Knownproblems">Known problems</a></li>
<ol><li><a href="CryptoBoxDevKnownProblems.html#qemu">qemu</a></li>
<li><a href="CryptoBoxDevKnownProblems.html#dfsbuild">dfsbuild</a></li>
<li><a href="CryptoBoxDevKnownProblems.html#Comments">Comments</a></li>
</ol>
</ol>
</div>
<h2 id="head-85f75330e62e5b1efc9f504fe9cb51a1b966dc3b">Development documentation</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBox.html">CryptoBox/de</a>, <a href="CryptoBox.html">CryptoBox/en</a>)
<p>The following pages are written for developers only. Users of the <a href="CryptoBox.html">CryptoBox</a> should read <a href="CryptoBoxUser.html">CryptoBoxUser</a> instead. </p> </p>
<ul> <hr />
<li><p> <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a> </p> <h1 id="Developmentdocumentation">Development documentation</h1>
</li> <p>
<li><p> <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a> </p> The following pages are written for developers only. <br />
</li> Users of the <a href="CryptoBox.html">CryptoBox</a> should read <a href="CryptoBoxUser.html">CryptoBoxUser</a> instead.
<li><p> <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> </p> </p>
</li> <ul><li><a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>
<li><p> <a href="CryptoBoxDevCustomConfigure.html">CryptoBoxDevCustomConfigure</a> </p> </li><li><a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a>
</li> </li><li><a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a>
<li><p> <a href="CryptoBoxDevValidation.html">CryptoBoxDevValidation</a> </p> </li><li><a href="CryptoBoxDevCustomConfigure.html">CryptoBoxDevCustomConfigure</a>
</li> </li><li><a href="CryptoBoxDevValidation.html">CryptoBoxDevValidation</a>
<li><p> <a href="CryptoBoxDevBackground.html">CryptoBoxDevBackground</a> </p> </li><li><a href="CryptoBoxDevBackground.html">CryptoBoxDevBackground</a>
</li> </li><li><a href="CryptoBoxDevKnownProblems.html">CryptoBoxDevKnownProblems</a>
<li><p> <a href="CryptoBoxDevKnownProblems.html">CryptoBoxDevKnownProblems</a> </p> </li></ul><h2 id="Source">Source</h2>
</li> <p>
</ul> You may browse the <a href="/trac/cryptobox/browser/">source code</a>.
</p>
<h2 id="Contact">Contact</h2>
<p>
We are waiting for your emails to <i>cryptobox[at]systemausfall.org</i>.
</p>
<h2 id="Bugreports">Bug reports</h2>
<p>
If you think you found a bug or you get an error message, please help us to fix the problem and file a ticket (a bug report). Follow these steps:
</p>
<ol><li>Have a look at <a href="/trac/cryptobox/report/1">Open bugs</a> that need to be fixed
</li><li>Create a <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/newticket" href="https://systemausfall.org/trac/cryptobox/newticket">New Ticket</a>
</li></ol></div>
</div>
<h2 id="head-b8ce79abe983e1592235d0085dd6928b83811739">Contact</h2>
<p>We are waiting for your emails to <em>cryptobox[at]systemausfall.org</em>. </p>
<h2 id="head-964f56b054273ed39bab34484f83ac053ac0f12e">Bug reports</h2>
<p>Please use our issue tracker, if you discover problems: <a href="https://systemausfall.org/trac/cryptobox">https://systemausfall.org/trac/cryptobox</a> </p>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->

118
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxDevBackground.html
View file

@ -29,71 +29,69 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevBackground.html#dfsbuild">dfsbuild</a></li>
<li> <li><a href="CryptoBoxDevBackground.html#thekernel">the kernel</a></li>
<a href="#head-2d71165918ee9e861cebf562e7f9be2c5c6328e4">dfsbuild</a> <li><a href="CryptoBoxDevBackground.html#qemu">qemu</a></li>
</li> <li><a href="CryptoBoxDevBackground.html#alternativeLiveCDs">alternative LiveCDs</a></li>
<li><a href="CryptoBoxDevBackground.html#Comments">Comments</a></li>
<li>
<a href="#head-6e3d13fcf3a0765d2188125e9b0b0bcb95e50622">the kernel</a>
</li>
<li>
<a href="#head-e01e8e66ae77c00f4e9fa9bd190c3ff738540727">qemu</a>
</li>
<li>
<a href="#head-00c94b926ece7f2a601d696a8880f5e54155ce7a">alternative LiveCDs</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
<h2 id="head-2d71165918ee9e861cebf562e7f9be2c5c6328e4">dfsbuild</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>)
<p>The base system of the <a href="CryptoBox.html">CryptoBox</a> Live-CD is created by <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>. </p> </p>
<p>It is recommended to use some kind of caching tool for the retrieval of the debian packages (e.g.: <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a> or <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a>). This saves a lot of bandwidth and time. </p> <hr />
<p>The documentation for <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> is sparse. But it is quite unlikely, that you will get in direct contact with it, as it is wrapped by <em>cbox-build</em>. However the following links may help you for specific problems: </p> <h1 id="DetailsoftheCryptoBox">Details of the CryptoBox</h1>
<ul> <h2 id="dfsbuild">dfsbuild</h2>
<li><p> <a class="external" href="http://www.debian-administration.org/articles/125">Debian Administration: Building Debian CD-ROMS Part 1 - dfsbuild</a> </p> <p>
</li> The base system of the <a href="CryptoBox.html">CryptoBox</a> Live-CD is created by <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>.
<li><p> <a class="external" href="http://www.debian-administration.org/articles/149">Debian Administration: Getting in deep with dfsbuild</a> </p> </p>
</li> <p>
</ul> It is recommended to use some kind of caching tool for the retrieval of the debian packages (e.g.: <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a> or <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx">approx</a>). This saves a lot of bandwidth and time.
</p>
<h2 id="head-6e3d13fcf3a0765d2188125e9b0b0bcb95e50622">the kernel</h2> <p>
The documentation for <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> is sparse. But it is quite unlikely, that you will get in direct contact with it, as it is wrapped by <a href="/trac/cryptobox/browser/trunk/scripts/cbox-build.sh">cbox-build</a>. However the following links may help you for specific problems:
<p>The linux kernel for the <a href="CryptoBox.html">CryptoBox</a> is compiled statically. If you want to change it, you could follow this steps: </p> </p>
<ol type="1"> <ul><li><a class="ext-link" title="http://www.debian-administration.org/articles/125" href="http://www.debian-administration.org/articles/125">Debian Administration: Building Debian CD-ROMS Part 1 - dfsbuild</a>
<li><p>get the sources: <tt>apt-get&nbsp;install&nbsp;kernel-tree-2.6.11</tt> (or the version of your choice) </p> </li><li><a class="ext-link" title="http://www.debian-administration.org/articles/149" href="http://www.debian-administration.org/articles/149">Debian Administration: Getting in deep with dfsbuild</a>
</li> </li></ul><h2 id="thekernel">the kernel</h2>
<li><p>copy the exisiting config file <em>kernel/config-2.6.11</em> as <em>.config</em> into your kernel source directory </p> <p>
</li> The linux kernel for the <a href="CryptoBox.html">CryptoBox</a> is compiled statically. If you want to change it, you could follow this steps:
<li><p>build the debian kernel package <tt>make-kpkg&nbsp;--revision=1.dfs&nbsp;--rootcmd=fakeroot&nbsp;kernel_image</tt> </p> </p>
</li> <ol><li>get the sources: <tt>apt-get install kernel-tree-2.6.11</tt> (or the version of your choice)
<li><p>change the kernel in the <em>unpackdebs</em> setting in <em>dfs-cbox.conf</em> (see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details) </p> </li><li>copy the exisiting config file <i>kernel/config-2.6.11</i> as <i>.config</i> into your kernel source directory
</li> </li><li>build the debian kernel package <tt>make-kpkg --revision=1.dfs --rootcmd=fakeroot kernel_image</tt>
</ol> </li><li>change the kernel in the <i>unpackdebs</i> setting in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/dfs-cbox.conf">dfs-cbox.conf</a> (see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details)
</li></ol><p>
<h2 id="head-e01e8e66ae77c00f4e9fa9bd190c3ff738540727">qemu</h2> See <a title="" href="/trac/cryptobox/browser/trunk/hints/kernel-build.txt">source:trunk/hints/kernel-build.txt</a> for more details.
</p>
<p><a class="external" href="http://fabrice.bellard.free.fr/qemu/">Qemu</a> is a portable system emulator. It is a convenient tool to ease the development workflow, as you do not need to burn LiveCDs for testing. </p> <h2 id="qemu">qemu</h2>
<p>
<h2 id="head-00c94b926ece7f2a601d696a8880f5e54155ce7a">alternative LiveCDs</h2> <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu/" href="http://fabrice.bellard.free.fr/qemu/">Qemu</a> is a portable system emulator. It is a convenient tool to ease the development workflow, as you do not need to burn LiveCDs for testing.
</p>
<p>We tried some other LiveCDs before we decided to use <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>. The following pages describe their advantages and disadvantages as the base system for the <a href="CryptoBox.html">CryptoBox</a>: </p> <h2 id="alternativeLiveCDs">alternative LiveCDs</h2>
<ul> <p>
<li><p> <a href="CryptoBoxKnoppixVerworfen.html">CryptoBoxKnoppixVerworfen</a> - Knoppix </p> We tried some other LiveCDs before we decided to use <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>. The following pages describe their advantages and disadvantages as the base system for the <a href="CryptoBox.html">CryptoBox</a>:
</li> </p>
<li><p> <a href="CryptoBoxMorphixVerworfen.html">CryptoBoxMorphixVerworfen</a> - Morphix / IBuild </p> <ul><li><a href="CryptoBoxKnoppixVerworfen.html">CryptoBoxKnoppixVerworfen</a> - Knoppix
</li> </li><li><a href="CryptoBoxMorphixVerworfen.html">CryptoBoxMorphixVerworfen</a> - Morphix / IBuild
</ul> </li></ul><hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

171
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxDevCustomBuild.html
View file

@ -29,103 +29,90 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevCustomBuild.html#Overview">Overview</a></li>
<li> <li><a href="CryptoBoxDevCustomBuild.html#Settings">Settings</a></li>
<a href="#head-27ea5a3ee88c7c2dfcfd4124719aadd726f1e2da">Overview</a> <ol><li><a href="CryptoBoxDevCustomBuild.html#dfsbuildsettings">dfsbuild settings</a></li>
</li> <li><a href="CryptoBoxDevCustomBuild.html#CryptoBoxdevelopmentconfiguration">CryptoBox development configuration</a></li>
<li><a href="CryptoBoxDevCustomBuild.html#SSHconnection">SSH connection</a></li>
<li> <li><a href="CryptoBoxDevCustomBuild.html#qemunetworkconfiguration">qemu network configuration</a></li>
<a href="#head-737db576c5f42abc0c78574d0ce5077809f288cb">Settings</a> </ol><li><a href="CryptoBoxDevCustomBuild.html#Comments">Comments</a></li>
<ol>
<li>
<a href="#head-9d97886ad41e38cb6afe343aa68ff652030ab06b">dfsbuild settings</a>
</li>
<li>
<a href="#head-c2ae24a50a3706711c1a42e26176768438d4f160">CryptoBox development configuration</a>
</li>
<li>
<a href="#head-90ac95d2e5a50160cbf72b884b7b469a29c2fea1">SSH connection</a>
</li>
<li>
<a href="#head-6798893e2e3fd89a72b5b6821a0d3d08125367b9">qemu network configuration</a>
</li>
</ol> </ol>
</div>
</li> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>, <a href="CryptoBoxDevBackground.html">CryptoBoxDevBackground</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevPreparation">CryptoBoxDevPreparation</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevWorkFlow">CryptoBoxDevWorkFlow</a>)
</ol> </p>
<p> </p> <hr />
<hr> <h1 id="CustombuildsoftheCryptoBox">Custom builds of the CryptoBox</h1>
<p> </p> <h2 id="Overview">Overview</h2>
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p> <p>
The following sections are useful, if you want to change the default settings of your personal <a href="CryptoBox.html">CryptoBox</a> development environment.
<h2 id="head-27ea5a3ee88c7c2dfcfd4124719aadd726f1e2da">Overview</h2> </p>
<p>
<p>The following sections are useful, if you want to change the default settings of your personal <a href="CryptoBox.html">CryptoBox</a> development environment. </p> You should have completed the steps described in <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>.
<p>You should have completed the steps described in <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>. </p> </p>
<h2 id="Settings">Settings</h2>
<h2 id="head-737db576c5f42abc0c78574d0ce5077809f288cb">Settings</h2> <h3 id="dfsbuildsettings">dfsbuild settings</h3>
<p>
All settings for <i>dfsbuild</i> can be found in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/dfs-cbox.conf">etc-defaults.d/dfs-cbox.conf</a>.
<h3 id="head-9d97886ad41e38cb6afe343aa68ff652030ab06b">dfsbuild settings</h3> </p>
<p>
<p>All settings for <em>dfsbuild</em> can be found in <em>etc-defaults.d/dfs-cbox.conf</em>. </p> If you want to change any of them, you should do the following:
<p>If you want to change any of them, you should do the following: </p> </p>
<ol type="1"> <ol><li>copy <i>etc-defaults.d/dfs-cbox.conf</i> file to <i>etc-local.d/</i>
<li><p>copy <em>etc-defaults.d/dfs-cbox.conf</em> file to <em>etc-local.d/</em> </p> </li><li>change <i>etc-local.d/dfs-cbox.conf</i> according to your needs
</li> </li></ol><p>
<li><p>change <em>etc-local.d/dfs-cbox.conf</em> according to your needs </p> This allows you to use your own (personal) settings, without interfering with files under version control.
</li> </p>
</ol> <h3 id="CryptoBoxdevelopmentconfiguration">CryptoBox development configuration</h3>
<p>This allows you to use your own (personal) settings, without interfering with files under version control. </p> <p>
Some settings regarding the building, configuring and validating of the <a href="CryptoBox.html">CryptoBox</a> can be found in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/cbox-dev.conf">etc-defaults.d/cbox-dev.conf</a>.
<h3 id="head-c2ae24a50a3706711c1a42e26176768438d4f160">CryptoBox development configuration</h3> </p>
<p>
<p>Some settings regarding the building, configuring and validating of the <a href="CryptoBox.html">CryptoBox</a> can be found in <em>etc-defaults.d/cbox-dev.conf</em>. </p> If you want to change any of them, you should do the following:
<p>If you want to change any of them, you should do the following: </p> </p>
<ol type="1"> <ol><li>copy <i>etc-defaults.d/cbox-dev.conf</i> file to <i>etc-local.d/</i>
<li><p>copy <em>etc-defaults.d/cbox-dev.conf</em> file to <em>etc-local.d/</em> </p> </li><li>change <i>etc-local.d/cbox-dev.conf</i> according to your needs
</li> </li></ol><h3 id="SSHconnection">SSH connection</h3>
<li><p>change <em>etc-local.d/cbox-dev.conf</em> according to your needs </p> <p>
</li> The file <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/ssh_config">ssh_config</a> is used to establish a connection to a running <a href="CryptoBox.html">CryptoBox</a> system.
</ol> </p>
<p>
<h3 id="head-90ac95d2e5a50160cbf72b884b7b469a29c2fea1">SSH connection</h3> It can be necessary to change these settings, if:
</p>
<p>The file <em>etc-defaults.d/ssh_config</em> is used to establish a connection to a running <a href="CryptoBox.html">CryptoBox</a> system. </p> <ul><li>you do not want to use the default IP for the <a href="CryptoBox.html">CryptoBox</a>
<p>It can be necessary to change these settings, if: </p> </li><li>or the <a href="CryptoBox.html">CryptoBox</a> is not within your local network.
<ul> </li></ul><p>
<li><p> you do not want to use the default IP for the <a href="CryptoBox.html">CryptoBox</a> </p> If you want to change some settings, you should do the following:
</li> </p>
<li><p> or the <a href="CryptoBox.html">CryptoBox</a> is not within your local network. </p> <ol><li>copy <i>etc-defaults.d/ssh_config</i> file to <i>etc-local.d/</i>
</li> </li><li>change <i>etc-local.d/ssh_config</i> according to your needs
</ul> </li></ol><h3 id="qemunetworkconfiguration">qemu network configuration</h3>
<p>If you want to change some settings, you should do the following: </p> <p>
<ol type="1"> The file <a href="/trac/cryptobox/browser/trunk/etc-defauolts.d/qemu-ifup">etc-defauolts.d/qemu-ifup</a> is used for the <a href="CryptoBox.html">CryptoBox</a> emulation with <i>qemu</i>. See <i>man qemu</i> for details.
<li><p>copy <em>etc-defaults.d/ssh_config</em> file to <em>etc-local.d/</em> </p> </p>
</li> <p>
<li><p>change <em>etc-local.d/ssh_config</em> according to your needs </p> If you want to change some settings, you should do the following:
</li> </p>
</ol> <ol><li>copy <i>etc-defaults.d/qemu-ifup</i> file to <i>etc-local.d/</i>
</li><li>change <i>etc-local.d/qemu-ifup</i> according to your needs
<h3 id="head-6798893e2e3fd89a72b5b6821a0d3d08125367b9">qemu network configuration</h3> </li></ol><hr />
<h2 id="Comments">Comments</h2>
<p>The file <em>etc-defauolts.d/qemu-ifup</em> is used for the <a href="CryptoBox.html">CryptoBox</a> emulation with <em>qemu</em>. See <tt>man&nbsp;qemu</tt> for details. </p> <p>
<p>If you want to change some settings, you should do the following: </p>
<ol type="1">
<li><p>copy <em>etc-defaults.d/qemu-ifup</em> file to <em>etc-local.d/</em> </p>
</li>
<li><p>change <em>etc-local.d/qemu-ifup</em> according to your needs </p>
</li>
</ol>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

108
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxDevCustomConfigure.html
View file

@ -29,65 +29,65 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevCustomConfigure.html#Overview">Overview</a></li>
<li> <li><a href="CryptoBoxDevCustomConfigure.html#Locations">Locations</a></li>
<a href="#head-eaec6be4efea7b38c41712778bfd4fb8d2827d3c">Overview</a> <li><a href="CryptoBoxDevCustomConfigure.html#Examples">Examples</a></li>
</li> <li><a href="CryptoBoxDevCustomConfigure.html#Comments">Comments</a></li>
<li>
<a href="#head-51173f0423ca91d36cd0cfcdc75a06d90cc087ee">Locations</a>
</li>
<li>
<a href="#head-9b9b6463081c4d9d13e3aadebe9daaf61fa67b5c">Examples</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
<h2 id="head-eaec6be4efea7b38c41712778bfd4fb8d2827d3c">Overview</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>)
<p>You may change nearly every aspect of the <a href="CryptoBox.html">CryptoBox</a> by using the custom configuration hook directory. </p> </p>
<p>Any script inside of this directory will be executed after the default configuration procedure (see <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a>). </p> <hr />
<p>The order of execution is defined by the names of the scripts (alphabetically). </p> <h1 id="CustomconfigurationoftheCryptoBox">Custom configuration of the CryptoBox</h1>
<h2 id="Overview">Overview</h2>
<h2 id="head-51173f0423ca91d36cd0cfcdc75a06d90cc087ee">Locations</h2> <p>
You may change nearly every aspect of the <a href="CryptoBox.html">CryptoBox</a> by using the custom configuration hook directory.
<p>Some example customization scripts can be found in <em>configure-examples.d/</em>. </p> </p>
<p>You may put your scripts into <em>configure-local.d/</em>. They will be sourced by <em>cbox-build.sh</em>. </p> <p>
Any script inside of this directory will be executed after the default configuration procedure (see <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a>).
<h2 id="head-9b9b6463081c4d9d13e3aadebe9daaf61fa67b5c">Examples</h2> </p>
<p>
<p>The examples in <em>configure-examples.d/</em> can be copied to <em>configure-local.d/</em> and adjusted to your needs. </p> The order of execution is defined by the names of the scripts (alphabetically).
<dl> </p>
<dt>set_default_ip</dt> <h2 id="Locations">Locations</h2>
<dd><p>change the default IP address of the <a href="CryptoBox.html">CryptoBox</a> </p> <p>
</dd> Some example customization scripts can be found in <a href="/trac/cryptobox/browser/trunk/configure-examples.d">configure-examples.d/</a>.
<dt>set_default_language</dt> </p>
<dd><p>set the default language </p> <p>
</dd> You may put your scripts into <i>configure-local.d/</i>. They will be sourced by <a href="/trac/cryptobox/browser/trunk/scripts/cbox-build.sh">cbox-build.sh</a>.
<dt>set_default_timeout</dt> </p>
<dd><p>set the default idle time for automatic unmounting </p> <h2 id="Examples">Examples</h2>
</dd> <p>
<dt>set_hostname</dt> The examples in <a href="/trac/cryptobox/browser/trunk/configure-examples.d">configure-examples.d/</a> can be copied to <i>configure-local.d/</i> and adjusted to your needs.
<dd><p>change the default hostname </p> </p>
</dd> <table class="wiki">
<dt>set_root_pw</dt> <tr><td>set_default_ip</td><td>change the default IP address of the CryptoBox
<dd><p>change the password of root (only useful for a development <a href="CryptoBox.html">CryptoBox</a>) </p> </td></tr><tr><td>set_default_language</td><td>set the default language
</dd> </td></tr><tr><td>set_default_timeout</td><td>set the default idle time for automatic unmounting
<dt>import_authorized_keys</dt> </td></tr><tr><td>set_hostname</td><td>change the default hostname
<dd><p>upload a <em>ssh</em> key for passwordless access to a development <a href="CryptoBox.html">CryptoBox</a> </p> </td></tr><tr><td>set_root_pw</td><td>change the password of root (only useful for a development <a href="CryptoBox.html">CryptoBox</a>)
</dd> </td></tr><tr><td>import_authorized_keys</td><td>upload a <i>ssh</i> key for passwordless access to a development CryptoBox
<dt>set_scan_devices</dt> </td></tr><tr><td>set_scan_devices</td><td>where to look for usable harddisks
<dd><p>where to look for usable harddisks </p> </td></tr></table>
</dd> <hr />
</dl> <h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

70
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxDevKnownProblems.html
View file

@ -29,41 +29,51 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevKnownProblems.html#qemu">qemu</a></li>
<li> <ol><li><a href="CryptoBoxDevKnownProblems.html#interleavedfilesnotyetsupported">interleaved files not (yet) supported</a></li>
<a href="#head-3d279b986395c95455d4d831054f9664ac846790">qemu</a> <li><a href="CryptoBoxDevKnownProblems.html#smbdsegfault">smbd: segfault</a></li>
<ol> </ol><li><a href="CryptoBoxDevKnownProblems.html#dfsbuild">dfsbuild</a></li>
<ol><li><a href="CryptoBoxDevKnownProblems.html#cantcdto_builddirtargetvarlibaptlists">can't cd to _builddir/target/var/lib/apt/lists</a></li>
<li> </ol><li><a href="CryptoBoxDevKnownProblems.html#Comments">Comments</a></li>
<a href="#head-9d223a1d9ee655c5a338f798fc08850a2b3694ba">interleaved files not (yet) supported</a>
</li>
<li>
<a href="#head-aa082f09cdb79c9a715826562efebd23cb8e9dfc">smbd: segfault</a>
</li>
</ol> </ol>
</div>
</li> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>)
</ol> </p>
<p> </p> <hr />
<hr> <h1 id="Knownproblems">Known problems</h1>
<p> </p> <h2 id="qemu">qemu</h2>
<h3 id="interleavedfilesnotyetsupported">interleaved files not (yet) supported</h3>
<h2 id="head-3d279b986395c95455d4d831054f9664ac846790">qemu</h2> <p>
You should update <i>qemu</i> to version 0.7 or higher.
</p>
<h3 id="head-9d223a1d9ee655c5a338f798fc08850a2b3694ba">interleaved files not (yet) supported</h3> <h3 id="smbdsegfault">smbd: segfault</h3>
<p>
<p>You should update <em>qemu</em> to version 0.7 or higher. </p> This happens under certain circumstances. We do not know a solution for this problem.
</p>
<h3 id="head-aa082f09cdb79c9a715826562efebd23cb8e9dfc">smbd: segfault</h3> <h2 id="dfsbuild">dfsbuild</h2>
<h3 id="cantcdto_builddirtargetvarlibaptlists">can't cd to _builddir/target/var/lib/apt/lists</h3>
<p>This happens under certain circumstances. We do not know a solution for this problem. </p> <p>
This can be caused by a (strange) mix of debian package versions. Track this bug at <a class="ext-link" title="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991" href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991</a>.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

147
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxDevPreparation.html
View file

@ -29,91 +29,82 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevPreparation.html#Softwarerequirements">Software requirements</a></li>
<li> <ol><li><a href="CryptoBoxDevPreparation.html#Packages">Packages</a></li>
<a href="#head-5b50aeed8139c95e5a2670d4248978d942c5edd6">Software requirements</a> <li><a href="CryptoBoxDevPreparation.html#Kernel">Kernel</a></li>
<ol> </ol><li><a href="CryptoBoxDevPreparation.html#Getthesource">Get the source</a></li>
<li><a href="CryptoBoxDevPreparation.html#Firstbuild">First build</a></li>
<li> <li><a href="CryptoBoxDevPreparation.html#Finished">Finished</a></li>
<a href="#head-143e3ec00a024bf2d9486f21dccab7ddc0ac3709">Packages</a> <li><a href="CryptoBoxDevPreparation.html#Comments">Comments</a></li>
</li>
<li>
<a href="#head-8abff5fecd19a74f1f5602aa82c8783c80b6862e">Kernel</a>
</li>
</ol> </ol>
</div>
<li>
<a href="#head-e988a63aa4744649892e3c85e239927edb01f336">Get the source</a>
</li>
<li>
<a href="#head-3b183abdfebed7afdbbdbb7625f85081882beb70">First build</a>
</li>
<li>
<a href="#head-08bd0ad2103b9f58bd026d64c0bcb333f3bbd90b">Finished</a>
</li>
</ol>
<p> </p>
<hr>
<p> </p>
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
<h2 id="head-5b50aeed8139c95e5a2670d4248978d942c5edd6">Software requirements</h2>
<h3 id="head-143e3ec00a024bf2d9486f21dccab7ddc0ac3709">Packages</h3>
<p>We use <a class="external" href="http://debian.org">Debian</a> as our development environment. This was a natural choice, as the <a href="CryptoBox.html">CryptoBox</a>-LiveCD is also based on Debian. Other distributions should work too, of course - <a class="interwiki" title="Acronym" href="http://www.acronymfinder.com/af-query.asp?String=exact&amp;Acronym=YMMV">YMMV</a>. </p>
<p>required: </p>
<ul>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=subversion">subversion</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=chroot">chroot</a> </p>
</li>
</ul>
<p>recommended: </p>
<ul>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a> or <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=approx">approx</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=qemu">qemu</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=curl">curl</a> </p>
</li>
</ul>
<h3 id="head-8abff5fecd19a74f1f5602aa82c8783c80b6862e">Kernel</h3>
<p>If you want to use <a class="external" href="http://fabrice.bellard.free.fr/qemu/">qemu</a> to test your <a href="CryptoBox.html">CryptoBox</a> in a virtual environment, then you will need the <em>tun/tap</em> kernel feature.
</p> </p>
<pre> <p>
CONFIG_TUN=m</pre> <strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>, <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevWorkFlow">CryptoBoxDevWorkFlow</a>)
<h2 id="head-e988a63aa4744649892e3c85e239927edb01f336">Get the source</h2>
<p>Download the latest release from our <a class="external" href="http://subversion.tigris.org">subversion</a>-Repository:
</p> </p>
<pre> <hr />
svn checkout https://svn.systemausfall.org/svn/cryptobox/trunk </pre> <h1 id="Preparationsfordevelopers">Preparations for developers</h1>
<h2 id="Softwarerequirements">Software requirements</h2>
<h2 id="head-3b183abdfebed7afdbbdbb7625f85081882beb70">First build</h2> <h3 id="Packages">Packages</h3>
<p>
<p>run <tt>scripts/cbox-build.sh&nbsp;release</tt> as <em>root</em> - hopefully, there should be no errors <img src="../../../var/www/cryptobox-img/smile.png" alt=":)" height="15" width="15"> </p> We use <a class="ext-link" title="http://debian.org" href="http://debian.org">Debian</a> as our development environment. This was a natural choice, as the CryptoBox-LiveCD is also based on Debian. Other distributions should work too, of course - <i>your mileage may vary</i>.
<p>Hint: This step will fail, if you did not install <em>apt-cacher</em>. See <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details on how to change the build-configuration settings (in this case: <em>mirror</em> in <em>dfs-cbox.conf</em>). </p> </p>
<p>
<h2 id="head-08bd0ad2103b9f58bd026d64c0bcb333f3bbd90b">Finished</h2> required:
</p>
<p>Now you can start to pariticipate in the development of the <a href="CryptoBox.html">CryptoBox</a> or simply customize your own <a href="CryptoBox.html">CryptoBox</a>-LiveCD. </p> <ul><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>
<p>See <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a> for details of how to use the developer's tools of the <a href="CryptoBox.html">CryptoBox</a>. </p> </li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=subversion" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=subversion">subversion</a>
<p><a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> shows some examples for local customizations of the <a href="CryptoBox.html">CryptoBox</a>. </p> </li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=chroot" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=chroot">chroot</a>
</li></ul><p>
recommended:
</p>
<ul><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy"> apt-proxy</a> or <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx">approx</a>
</li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=qemu" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=qemu">qemu</a>
</li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=curl" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=curl">curl</a>
</li></ul><h3 id="Kernel">Kernel</h3>
<p>
If you want to use <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu/" href="http://fabrice.bellard.free.fr/qemu/">qemu</a> to test your <a href="CryptoBox.html">CryptoBox</a> in a virtual environment, then you will need the <i>tun/tap</i> kernel feature.
</p>
<pre class="wiki">CONFIG_TUN=m
</pre><h2 id="Getthesource">Get the source</h2>
<p>
Download the latest release from our <a class="ext-link" title="http://subversion.tigris.org" href="http://subversion.tigris.org">subversion</a>-Repository:
</p>
<pre class="wiki">svn checkout https://svn.systemausfall.org/svn/cryptobox/trunk
</pre><h2 id="Firstbuild">First build</h2>
<p>
run <tt>scripts/cbox-build.sh release</tt> as <i>root</i> - hopefully, there should be no errors :)
</p>
<p>
Hint: This step will fail, if you did not install <i>apt-cacher</i>. See <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details on how to change the build-configuration settings (in this case: <i>mirror</i> in <i>dfs-cbox.conf</i>).
</p>
<h2 id="Finished">Finished</h2>
<p>
Now you can start to pariticipate in the development of the <a href="CryptoBox.html">CryptoBox</a> or simply customize your own CryptoBox-LiveCD.
</p>
<p>
See <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a> for details of how to use the developer's tools of the <a href="CryptoBox.html">CryptoBox</a>.
</p>
<p>
<a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> shows some examples for local customizations of the <a href="CryptoBox.html">CryptoBox</a>.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

123
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxDevValidation.html
View file

@ -29,62 +29,83 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevValidation.html#Overview">Overview</a></li>
<li> <li><a href="CryptoBoxDevValidation.html#Validate">Validate</a></li>
<a href="#head-5e20146fd39363329427c6251209cccb8d374f3e">Overview</a> <li><a href="CryptoBoxDevValidation.html#Howtocreateatest">How to create a test</a></li>
</li> <li><a href="CryptoBoxDevValidation.html#Comments">Comments</a></li>
<li>
<a href="#head-6e1d416048c4d8ebfb5b3919b4d924c77e652a7b">Validate</a>
</li>
<li>
<a href="#head-5634566bd24f83d397b43525fc62685f6e678fbf">How to create a test</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
<h2 id="head-5e20146fd39363329427c6251209cccb8d374f3e">Overview</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>)
<p>The validation feature allows to check the programming logic of the <a href="CryptoBox.html">CryptoBox</a>. A lot of test cases are defined to test as many functions of the <a href="CryptoBox.html">CryptoBox</a> as possible. </p> </p>
<p>The requests are processed with <a class="external" href="http://curl.haxx.se/">curl</a>. </p> <hr />
<p>The received web page is saved to allow a later design review or css debugging. </p> <h1 id="ValidationoftheCryptoBox">Validation of the CryptoBox</h1>
<p>The current state of the <a href="CryptoBox.html">CryptoBox</a> is represented by ten single values (e.g.: <em>box is configured</em>, <em>IP of the box</em>, <em>current language setting</em>, ...), which are invisibly a part of each html page (as comments). The returned status of every request is compared to the predicted value of the test case. </p> <h2 id="Overview">Overview</h2>
<p>Similar test cases are pooled into test groups (e.g.: <em>initialization</em>, <em>configuration</em> and <em>mounting</em>). </p> <p>
The validation feature helps you to check the programming logic of the <a href="CryptoBox.html">CryptoBox</a>. A lot of test cases are defined to verify as many functions of the <a href="CryptoBox.html">CryptoBox</a> as possible.
<h2 id="head-6e1d416048c4d8ebfb5b3919b4d924c77e652a7b">Validate</h2> </p>
<p>
<p>Run <tt>scripts/validate.sh&nbsp;check_all</tt> to conduct all tests of all groups. See <tt>scripts/validate.sh&nbsp;help</tt> for other actions. </p> The requests are processed with <a class="ext-link" title="http://curl.haxx.se/" href="http://curl.haxx.se/">curl</a>.
<p>The results will be saved in <em>validation/report</em>. </p> </p>
<p>In addition to every single retrieved page, a html page called <em>summary.html</em> is created, which contains the state checks of all tests in a group. </p> <p>
The received web page is saved to allow a later design review or css debugging.
<h2 id="head-5634566bd24f83d397b43525fc62685f6e678fbf">How to create a test</h2> </p>
<p>
<p>All test cases can be found in <em>validation/test-cases</em>. </p> The current state of the <a href="CryptoBox.html">CryptoBox</a> is represented by ten single values (e.g.: <i>box is configured</i>, <i>IP of the box</i>, <i>current language setting</i>, ...), which are invisibly a part of each html page (as comments). The returned status of every request is compared to the predicted value of the test case.
<p>Every test consists of: </p> </p>
<dl> <p>
<dt>input.curl</dt> Similar test cases are pooled into test groups (e.g.: <i>initialization</i>, <i>configuration</i> and <i>mounting</i>).
<dd><p>the configuration file for the <em>curl</em> request </p> </p>
</dd> <h2 id="Validate">Validate</h2>
<dt>output</dt> <p>
<dd><p>the predicted state of the <a href="CryptoBox.html">CryptoBox</a> after the call </p> Run <i><a href="/trac/cryptobox/browser/trunk/scripts/validate.sh">scripts/validate.sh</a>]</i> to conduct all tests of all groups. See <i>scripts/validate.sh help</i> for other actions.
</dd> </p>
<dt>description</dt> <p>
<dd><p>a short description of the test (will be used for the summary) </p> The results will be saved in <i>validation/report</i>.
</dd> </p>
<dt>delay</dt> <p>
<dd><p>[optional] time to wait after this test </p> In addition to every single retrieved page, a html page called <i>summary-?.html</i> is created, which contains the state checks of all tests in a group.
</dd> </p>
</dl> <h2 id="Howtocreateatest">How to create a test</h2>
<p>Use the existing test cases as templates for new tests. </p> <p>
<p>Any logical path of the web interface CGI should be validated by a test case. </p> All test cases can be found in <i>validation/test-cases</i>.
</p>
<p>
Every test consists of the following files:
</p>
<table class="wiki">
<tr><td>input.curl</td><td>the configuration file for the <i>curl</i> request
</td></tr><tr><td>output</td><td>the predicted state of the <a href="CryptoBox.html">CryptoBox</a> after the call
</td></tr><tr><td>description</td><td>a short description of the test (will be used for the summary)
</td></tr><tr><td>delay</td><td>[optional] time to wait after this test
</td></tr></table>
<p>
Use the existing test cases as templates for new tests.
</p>
<p>
Read <a href="/trac/cryptobox/browser/trunk/validation/test-cases/README">validation/test-cases/README</a> for details.
</p>
<p>
Every logical path of the web interface CGI should be validated by a test case.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

284
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxDevWorkFlow.html
View file

@ -29,150 +29,156 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevWorkFlow.html#Preparations">Preparations</a></li>
<li> <li><a href="CryptoBoxDevWorkFlow.html#CreateaCryptoBoxLiveCD">Create a CryptoBox-LiveCD</a></li>
<a href="#head-adacf7a8271d3f6fe8bdfb9773ac3b1f4b050f9a">Preparations</a> <ol><li><a href="CryptoBoxDevWorkFlow.html#Buildthebasesystem">Build the base system</a></li>
</li> <li><a href="CryptoBoxDevWorkFlow.html#Configurethebaseimage">Configure the base image</a></li>
<li><a href="CryptoBoxDevWorkFlow.html#Removedevelopmentfeatures">Remove development features</a></li>
<li> <li><a href="CryptoBoxDevWorkFlow.html#Createanisoimage">Create an iso image</a></li>
<a href="#head-61cec4152bb64ed5799ae7422f7150a4e3bc4860">Create a CryptoBox-LiveCD - step by step</a> <li><a href="CryptoBoxDevWorkFlow.html#BurntheCD">Burn the CD</a></li>
<ol> </ol><li><a href="CryptoBoxDevWorkFlow.html#TesttheCryptoBoxLiveCD">Test the CryptoBox-LiveCD</a></li>
<ol><li><a href="CryptoBoxDevWorkFlow.html#Chrootquickampdirtytests">Chroot: quick &amp; dirty tests</a></li>
<li> <li><a href="CryptoBoxDevWorkFlow.html#Qemunearlycompleteemulation">Qemu: nearly complete emulation</a></li>
<a href="#head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</a> </ol><li><a href="CryptoBoxDevWorkFlow.html#Debuggingandmerging">Debugging and merging</a></li>
</li> <ol><li><a href="CryptoBoxDevWorkFlow.html#Developmentonarunningsystem">Development on a running system</a></li>
<li><a href="CryptoBoxDevWorkFlow.html#Uploadinganewrelease">Uploading a new release</a></li>
<li> </ol><li><a href="CryptoBoxDevWorkFlow.html#Comments">Comments</a></li>
<a href="#head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</a>
</li>
<li>
<a href="#head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</a>
</li>
<li>
<a href="#head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</a>
</li>
<li>
<a href="#head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</a>
</li>
</ol> </ol>
</div>
<li> </p>
<a href="#head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</a> <p>
<ol> <strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>, <a href="CryptoBoxDevCustomConfigure.html">CryptoBoxDevCustomConfigure</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevPreparation">CryptoBoxDevPreparation</a>)
<li> </p>
<a href="#head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick &amp; dirty tests</a> <hr />
</li> <h1 id="Developmentworkflow">Development workflow</h1>
<h2 id="Preparations">Preparations</h2>
<li> <p>
<a href="#head-2278b94f0a24871a501d80c4e6e0c53d1f5621ca">Qemu: nearly complete emulation</a> You should have completed the steps described in <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>.
</li> </p>
<h2 id="CreateaCryptoBoxLiveCD">Create a CryptoBox-LiveCD</h2>
</ol> <p>
The following steps can be executed in the order of their appearance.
<li> </p>
<a href="#head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</a> <p>
<ol> Usually there is no need to repeat the whole process, after you changed some parts of the <a href="CryptoBox.html">CryptoBox</a>. Especially the first step (building of the base system with <i>dfsbuild</i>) may usually be skipped.
</p>
<li> <p>
<a href="#head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</a> Every step of the building process must be executed as <i>root</i>.
</li> </p>
<h3 id="Buildthebasesystem">Build the base system</h3>
<li> <p>
<a href="#head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</a> Run <i>scripts/cbox-build.sh dfsbuild</i> to create the base system for the LiveCD.
</li> </p>
<p>
</ol> The result can be found in <i>_builddir/cd1/image</i>.
</p>
</li> <p>
If you do not want to use the <i><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a> to save bandwidth and time, then you should modify the </i>mirror<i>-setting in <a href="/trac/cryptobox/browser/trunk/etc-default.d/dfs-cbox.conf">dfs-cbox.conf</a> (see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details).</i>
</ol> </p>
<p> </p> <h3 id="Configurethebaseimage">Configure the base image</h3>
<hr> <p>
<p> </p> Run <i>scripts/cbox-build.sh config</i> to copy the CryptoBox-specific files to the base image.
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p> </p>
<p>
<h2 id="head-adacf7a8271d3f6fe8bdfb9773ac3b1f4b050f9a">Preparations</h2> TODO: link to cbox-build.sh-manpage
</p>
<p>You should have completed the steps described in <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>. </p> <h3 id="Removedevelopmentfeatures">Remove development features</h3>
<p>
<h2 id="head-61cec4152bb64ed5799ae7422f7150a4e3bc4860">Create a CryptoBox-LiveCD - step by step</h2> The original base system, that was created by <i>dfsbuild</i> contains a lot packages and some scripts, that are only useful during development. You should remove them, as they cause severe security implications.
</p>
<p>The following steps can be executed in the order of their appearance. </p> <p>
<p>Usually there is no need to repeat the whole process, after you changed some parts of the <a href="CryptoBox.html">CryptoBox</a>. Especially the first step (building of the base system with <em>dfsbuild</em>) may usually be skipped. </p> To reduce the CryptoBox-LiveCD to the usable minimum for operational use, you should run <i>scripts/cbox-build.sh harden</i>.
<p>Every step of the building process must be executed as <em>root</em>. </p> </p>
<h3 id="Createanisoimage">Create an iso image</h3>
<h3 id="head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</h3> <p>
To burn a CryptoBox-LiveCD, you need an bootable <i>iso9660</i>-image.
<p>Run <tt>scripts/cbox-build.sh&nbsp;dfsbuild</tt> to create the base system for the LiveCD. </p> </p>
<p>The result can be found in <em>_builddir/cd1/image</em>. </p> <p>
<p>If you do not want to use the <em><a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;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 <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details). </p> Create the <i>iso</i> image with <i>scripts/cbox-build.sh iso</i>. The resulting file can be found at <i>_builddir/cd1/cryptobox.iso</i>.
</p>
<h3 id="head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</h3> <h3 id="BurntheCD">Burn the CD</h3>
<p>
<p>Run <tt>scripts/cbox-build.sh&nbsp;config</tt> to copy the <a href="CryptoBox.html">CryptoBox</a>-specific files to the base image. </p> Do it manually:
<p>TODO: link to cbox-build.sh-manpage </p> </p>
<pre class="wiki">cdrecord -v dev=0,0,0 _builddir/cryptobox.iso
<h3 id="head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</h3> </pre><p>
(change the <i>dev</i> setting according to your setup).
<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>
<p>To reduce the <a href="CryptoBox.html">CryptoBox</a>-LiveCD to the usable minimum for operational use, you should run <tt>scripts/cbox-build.sh&nbsp;harden</tt>. </p> <p>
Let the script do it for you: <i>scripts/cbox-build.sh burn</i> (maybe you have to change the <i>CDWRITER</i> setting in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/cbox-dev.conf">cbox-dev.conf</a> - see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a>).
<h3 id="head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</h3> </p>
<p>
<p>To burn a <a href="CryptoBox.html">CryptoBox</a>-LiveCD, you need an bootable <em>iso9660</em>-image. </p> Of course, it is not wise to use CD-R media. CD-RW consume less resources.
<p>Create the <em>iso</em> image with <tt>scripts/cbox-build.sh&nbsp;iso</tt>. The resulting file can be found at <em>_builddir/cd1/cryptobox.iso</em>. </p> </p>
<h2 id="TesttheCryptoBoxLiveCD">Test the CryptoBox-LiveCD</h2>
<h3 id="head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</h3> <p>
This section is only useful for developers, who want to improve or change the <a href="CryptoBox.html">CryptoBox</a> system.
<p>Do it manually: <tt>cdrecord&nbsp;-v&nbsp;dev=0,0,0&nbsp;_builddir/cd1/cryptobox.iso</tt> (change the <em>dev</em> setting according to your setup). </p> </p>
<p>Let the script do it for you: <tt>scripts/cbox-build.sh&nbsp;burn</tt> (maybe you have to change the <em>CDWRITER</em> setting in <em>cbox-dev.conf</em> - see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a>). </p> <h3 id="Chrootquickampdirtytests">Chroot: quick &amp; dirty tests</h3>
<p>Of course, it is not wise to use CD-R media. CD-RW consume less resources. </p> <p>
If you modified the <i>perl</i>- or <i>shell</i>-scripts of the <a href="CryptoBox.html">CryptoBox</a>, then you can check for syntax errors by running them in a <i>chroot</i> environment. Be careful: you have access to all ressources of your computer, while you are working within a <i>chroot</i> environment - so you can easily repartition your real disk ...
<h2 id="head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</h2> </p>
<p>
<p>This section is only useful for developers, who want to improve or change the <a href="CryptoBox.html">CryptoBox</a> system. </p> To start a <i>chroot</i> environment, you can execute <i>scripts/cbox-dev.sh chroot</i>.
</p>
<h3 id="head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick &amp; dirty tests</h3> <p>
For more intensive tests, you may use <i>qemu</i> (see below) or burn real LiveCDs - of course this would take much more time.
<p>If you modified the <em>perl</em>- or <em>shell</em>-scripts of the <a href="CryptoBox.html">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>
<p>To start a <em>chroot</em> environment, you can execute <tt>scripts/cbox-dev.sh&nbsp;chroot</tt>. </p> <h3 id="Qemunearlycompleteemulation">Qemu: nearly complete emulation</h3>
<p>For more intensive tests, you may use <em>qemu</em> (see below) or burn real LiveCDs - of course this would take much more time. </p> <p>
The processor emulator <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu" href="http://fabrice.bellard.free.fr/qemu">qemu</a> allows you test the <a href="CryptoBox.html">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.
<h3 id="head-2278b94f0a24871a501d80c4e6e0c53d1f5621ca">Qemu: nearly complete emulation</h3> </p>
<p>
<p>The processor emulator <a class="external" href="http://fabrice.bellard.free.fr/qemu">qemu</a> allows you test the <a href="CryptoBox.html">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> Beware - there are some problems, when using <i>qemu</i>:
<p>Beware - there are some problems, when using <em>qemu</em>: </p> </p>
<ul> <ul><li><i>smbd</i> does not start (segfault)
<li><p> <em>smbd</em> does not start (segfault) </p> </li><li>???
</li> </li></ul><p>
<li><p> ??? </p> To start a <i>qemu</i> emulation of the <i>iso</i> image, you may type:
</li> </p>
</ul> <pre class="wiki">scripts/cbox-dev.sh qemu
<p>To start a <em>qemu</em> emulation of the <em>iso</em> image, you may type: <tt>scripts/cbox-dev.sh&nbsp;qemu</tt>. </p> </pre><h2 id="Debuggingandmerging">Debugging and merging</h2>
<p>
<h2 id="head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</h2> This section is only useful for developers, who want to develop on a running <a href="CryptoBox.html">CryptoBox</a> system (emulated or real).
</p>
<p>This section is only useful for developers, who want to develop on a running <a href="CryptoBox.html">CryptoBox</a> system (emulated or real). </p> <p>
<p>You may access the <a href="CryptoBox.html">CryptoBox</a> directly or you can use <em>ssh</em> to open a remote session (<tt>./cbox-dev.sh&nbsp;ssh</tt>). </p> You may access the <a href="CryptoBox.html">CryptoBox</a> directly or you can use <i>ssh</i> to open a remote session:
</p>
<h3 id="head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</h3> <pre class="wiki">./cbox-dev.sh ssh
</pre><h3 id="Developmentonarunningsystem">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>
<p>Type <tt>scripts/cbox-dev.sh&nbsp;diff</tt> to see the changes, you made on the running <a href="CryptoBox.html">CryptoBox</a> system. </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>Type <tt>scripts/cbox-dev.sh&nbsp;merge</tt> to merge these changes to your local working copy. </p> </p>
<p>
<h3 id="head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</h3> Type <i>scripts/cbox-dev.sh diff</i> to see the changes, you made on the running <a href="CryptoBox.html">CryptoBox</a> system.
</p>
<p>Alternatively you may also upload a new version of your local working copy to the running <a href="CryptoBox.html">CryptoBox</a> system. </p> <p>
<p>Type <tt>scripts/cbox-dev.sh&nbsp;upload</tt> - beware: all recent changes you made to the running <a href="CryptoBox.html">CryptoBox</a> system, are lost. </p> Type <i>scripts/cbox-dev.sh merge</i> to merge these changes to your local working copy.
</p>
<h3 id="Uploadinganewrelease">Uploading a new release</h3>
<p>
Alternatively you may also upload a new version of your local working copy to the running <a href="CryptoBox.html">CryptoBox</a> system.
</p>
<p>
Type <i>scripts/cbox-dev.sh upload</i> - beware: all recent changes you made to the running <a href="CryptoBox.html">CryptoBox</a> system, are lost.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

81
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxUser.html
View file

@ -29,41 +29,64 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxUserGettingStarted.html#Wiegehteslos">Wie geht es los</a></li>
<li> <ol><li><a href="CryptoBoxUserGettingStarted.html#ErsteSchritte">Erste Schritte</a></li>
<a href="#head-b4f553dcadf3130f124c0f37db39f22aa9c2fd40">Nutzerhandbuch</a> <li><a href="CryptoBoxUserGettingStarted.html#HinweiseFallstricke">Hinweise / Fallstricke</a></li>
</li> <li><a href="CryptoBoxUserGettingStarted.html#Kommentare">Kommentare</a></li>
<li>
<a href="#head-07a5b2b75517ef9f7efaa9fbcde38d802a2bee14">Fragen</a>
</li>
</ol> </ol>
<p> </p> <li><a href="CryptoBoxUserConfiguration.html#DieKonfigurationdeinerCryptoBox">Die Konfiguration deiner CryptoBox</a></li>
<hr> <ol><li><a href="CryptoBoxUserConfiguration.html#berblick">Überblick</a></li>
<p> </p> <li><a href="CryptoBoxUserConfiguration.html#Vorwort">Vorwort</a></li>
<li><a href="CryptoBoxUserConfiguration.html#Initialisierung">Initialisierung</a></li>
<h2 id="head-b4f553dcadf3130f124c0f37db39f22aa9c2fd40">Nutzerhandbuch</h2> <li><a href="CryptoBoxUserConfiguration.html#Konfiguration">Konfiguration</a></li>
<li><a href="CryptoBoxUserConfiguration.html#HinweiseFallstricke">Hinweise / Fallstricke</a></li>
<p>Die folgenden Seiten beschreiben die Nutzung der <a href="CryptoBox.html">CryptoBox</a>. </p> <li><a href="CryptoBoxUserConfiguration.html#Kommentare">Kommentare</a></li>
<p>Die online-Version dieses Handbuchs ist ein Wiki. Das bedeutet, dass du diese Seiten verändern kannst. Falls du also Fragen oder Anregungen hast, schreibe bitte deine Anmerkungen in den Fragen-Abschnitt am Ende der jeweiligen Seite. Die Entwickler werden deine Fragen beantworten und das Handbuch schnellstmöglich aktualisieren. Auf diese Art und Weise kannst du die Nutzbarkeit der <a href="CryptoBox.html">CryptoBox</a> für alle Nutzer verbessern! </p>
<ol type="1">
<li><p><a href="CryptoBoxUserGettingStarted.html">CryptoBoxUserGettingStarted/de</a> -- die Vorbereitung der Hardware </p>
</li>
<li><p><a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration/de</a> -- die Einrichtung deines neuen verschlüsselten Dateiservers </p>
</li>
<li><p><a href="CryptoBoxUserDailyUse.html">CryptoBoxUserDailyUse/de</a> -- die tägliche Nutzung der <a href="CryptoBox.html">CryptoBox</a> </p>
</li>
</ol> </ol>
<p>Die online-Version dieses Handbuchs befindet sich unter <a href="https://systemausfall.org/toolforge/CryptoBoxUser/de">https://systemausfall.org/toolforge/CryptoBoxUser/de</a>. </p> <li><a href="CryptoBoxUserDailyUse.html#TglicheNutzung">Tägliche Nutzung</a></li>
<hr> <ol><li><a href="CryptoBoxUserDailyUse.html#AktivierendesverschlsseltenDateisystems">Aktivieren des verschlüsselten Dateisystems</a></li>
<p> </p> <li><a href="CryptoBoxUserDailyUse.html#ZugriffaufdieverschlsseltenDaten">Zugriff auf die verschlüsselten Daten</a></li>
<li><a href="CryptoBoxUserDailyUse.html#AbschaltendesverschlsseltenDateisystems">Abschalten des verschlüsselten Dateisystems</a></li>
<li><a href="CryptoBoxUserDailyUse.html#AbschaltungderCryptoBox">Abschaltung der CryptoBox</a></li>
<li><a href="CryptoBoxUserDailyUse.html#NotfallAbschaltung">Notfall-Abschaltung</a></li>
<li><a href="CryptoBoxUserDailyUse.html#FragenundAntworten">Fragen und Antworten</a></li>
<li><a href="CryptoBoxUserDailyUse.html#Kommentare">Kommentare</a></li>
</ol>
</ol>
</div>
<h2 id="head-07a5b2b75517ef9f7efaa9fbcde38d802a2bee14">Fragen</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBox.html">CryptoBox/de</a>)
</p>
<hr />
<h1 id="Nutzerhandbuch">Nutzerhandbuch</h1>
<p>
Die folgenden Seiten beschreiben die Nutzung der <a href="CryptoBox.html">CryptoBox</a>.
</p>
<p>
Die online-Version dieses Handbuchs ist ein Wiki. Das bedeutet, dass du diese Seiten verändern kannst. Falls du also Fragen oder Anregungen hast, schreibe bitte deine Anmerkungen in den Kommentar-Abschnitt am Ende der jeweiligen Seite. Die Entwickler werden deine Fragen beantworten und das Handbuch schnellstmöglich aktualisieren. Auf diese Art und Weise kannst du die Nutzbarkeit der <a href="CryptoBox.html">CryptoBox</a> für alle Nutzer verbessern!
</p>
<ol><li><a href="CryptoBoxUserGettingStarted.html">CryptoBoxUserGettingStarted</a> -- die Vorbereitung der Hardware
</li><li><a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration</a> -- die Einrichtung deines neuen verschlüsselten Dateiservers
</li><li><a href="CryptoBoxUserDailyUse.html">CryptoBoxUserDailyUse</a> -- die tägliche Nutzung der <a href="CryptoBox.html">CryptoBox</a>
</li></ol><p>
Die online-Version dieses Handbuchs befindet sich unter <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/de" href="https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/de">https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/de</a>.
</p>
<hr />
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

221
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxUserConfiguration.html
View file

@ -29,129 +29,114 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxUserConfiguration.html#berblick">Überblick</a></li>
<li> <li><a href="CryptoBoxUserConfiguration.html#Vorwort">Vorwort</a></li>
<a href="#head-35bb35adbe80b0a88ba66e8186bc7c46f59699e5">Überblick</a> <li><a href="CryptoBoxUserConfiguration.html#Initialisierung">Initialisierung</a></li>
</li> <li><a href="CryptoBoxUserConfiguration.html#Konfiguration">Konfiguration</a></li>
<li><a href="CryptoBoxUserConfiguration.html#HinweiseFallstricke">Hinweise / Fallstricke</a></li>
<li> <li><a href="CryptoBoxUserConfiguration.html#Kommentare">Kommentare</a></li>
<a href="#head-cd2ed4cc5bdf6df848ffd9217e4d42715c08d23f">Vorwort</a>
</li>
<li>
<a href="#head-0ff8fb8aca8fc8e46863381930f367463ffe9ce5">Initialisierung</a>
</li>
<li>
<a href="#head-5015302b5a3fd8a1ae2a63ea7f0cbce5aebaa451">Konfiguration</a>
</li>
<li>
<a href="#head-fd34c5c4d9612568c9f2d2be251e9eb43d574c52">Hinweise / Fallstricke</a>
</li>
<li>
<a href="#head-dde63a967ebf4ea45fc857ec32d8e6d258545e70">Fragen</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-35bb35adbe80b0a88ba66e8186bc7c46f59699e5">Überblick</h2> </p>
<p>
<p>Alle Funktionen der <a href="CryptoBox.html">CryptoBox</a> können durch das komfortable Web-Interface bedient werden. Zur Erst-Einrichtung der <a href="CryptoBox.html">CryptoBox</a> folge einfach den folgenden Schritten. </p> <strong>Navigation:</strong> ( <a href="CryptoBoxUser.html">CryptoBoxUser/de</a>)
<p>Falls du in Eile bist, kannst du das <em>Vorwort</em> überspringen. </p>
<p>Die <em>Initialisierung</em> erklärt die Einrichtung der Festplatte. Dieser Schritt ist nur bei der ersten Einrichtung oder nach einem Festplattenwechsel notwendig. </p>
<p>Im <em>Konfigurations</em>-Abschnitt werden die verfügbaren Einstellungen der <a href="CryptoBox.html">CryptoBox</a> beschrieben. Hier kannst du beispielsweise die Sprache des Web-Interfaces oder die Netzwerkadresse deiner <a href="CryptoBox.html">CryptoBox</a> einstellen. </p>
<p>Vergiss nicht, auch den <em>Hinweise/Fallstricke</em>-Abschnitt zu lesen. </p>
<h2 id="head-cd2ed4cc5bdf6df848ffd9217e4d42715c08d23f">Vorwort</h2>
<p>Du bist den Anweisungen aus <a href="CryptoBoxUserGettingStarted.html">CryptoBoxUserGettingStarted/de</a> gefolgt und sitzt nun vor deinem Arbeits-Rechner. Nun kannst du in deinem Web-Browser das Web-Interface der <a href="CryptoBox.html">CryptoBox</a> ansteuern: <em><a href="https://192.168.0.23">https://192.168.0.23</a></em>. </p>
<p>Bevor du Daten auf deiner <a href="CryptoBox.html">CryptoBox</a> speichern kannst, muss die Festplatte mit einem verschlüsselten Dateisystem versehen werden. Das klingt kompliziert, ist jedoch mit einem Klick erledigt. <img src="../../../var/www/cryptobox-img/smile.png" alt=":)" height="15" width="15"> </p>
<h2 id="head-0ff8fb8aca8fc8e46863381930f367463ffe9ce5">Initialisierung</h2>
<p>Klickke auf <em>Initialisierung</em> in der Menü-Zeile. </p>
<p>Jetzt wirst du zur Eingabe zweier Passworte aufgefordert (jeweils mit Wiederholung - zum Training deiner Tipp-Fertigkeiten ;)). </p>
<p><img src="/toolforge/CryptoBoxUserConfiguration/de?action=AttachFile&amp;do=get&amp;target=init_de.png" alt="init_de.png"> </p>
<ul>
<li><p> Das erste Passwort ist das <em>Administrations-Password</em>. </p>
<ul>
<li><p> Es schützt die Konfiguration deiner <a href="CryptoBox.html">CryptoBox</a>. </p>
</li>
<li><p> Dies ist notwendig, um zu verhindern, dass jemand unerlaubt die Daten auf deiner <a href="CryptoBox.html">CryptoBox</a> durch eine erneute Initialisierung löscht. </p>
</li>
<li><p> Wahrscheinlich wirst du dieses Passwort nie wieder benötigen. </p>
</li>
<li><p> Du kannst das Administrations-Passwort leer lassen - dies wird jedoch nicht empfohlen. </p>
</li>
</ul>
</li>
<li><p> Das <em>Crypto-Passwort</em> ist wesentlich wichtiger, da es der einzige Schutz der Daten auf der verschlüsselten Festplatte ist. Wähle es mit Sorgfalt! </p>
<ul>
<li><p> Du benötigst es, um auf deine Daten zuzugreifen. </p>
</li>
<li><p> Ein sicheres Passwort sollte aus mindestens 15 Zeichen (einschließlich Ziffern und Sonderzeichen) bestehen. Die Sicherheit deiner Daten steht und fällt mit der Qualität dieses Passworts. </p>
</li>
</ul>
</li>
<li><p> Um dich daran zu erinnern, dass dieser Schritt die Festplatte der <a href="CryptoBox.html">CryptoBox</a> komplett löschen wird, musst du den angezeigten roten Warnhinweis im letzten Formularfeld eingeben. </p>
</li>
<li><p> Nun kannst du die Initialisierung durch einen Klick auf <em>Initialisiere die <a href="CryptoBox.html">CryptoBox</a></em> abschließen. </p>
</li>
</ul>
<p>Das war es dann auch schon. Cryptographie war wohl nie einfacher zu verwenden, oder? <img src="../../../var/www/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
<p>Der Initialisierungsvorgang läuft nun im Hintergrund ab und wird nach wenigen Minuten (abhängig von der Größe deiner Festplatte) abgeschlossen. </p>
<h2 id="head-5015302b5a3fd8a1ae2a63ea7f0cbce5aebaa451">Konfiguration</h2>
<p>Im Gegensatz zur Initialisierung, die nur einmal durchgeführt werden muss, kannst du die Konfiguration jederzeit deinen Wünschen anpassen. Dazu klickst du einfach auf <em>Konfiguration</em> in der Menü-Zeile des Web-Interfaces. Nun wird dir ein Formular mit vier Feldern präsentiert: </p>
<p><img src="/toolforge/CryptoBoxUserConfiguration/de?action=AttachFile&amp;do=get&amp;target=config_de.png" alt="config_de.png"> </p>
<ul>
<li><p> Falls du ein Administrator-Passwort während der <em>Initialisierung</em> festgelegt hast, musst du es nun eingeben. Andernfalls wird dieses Formularfeld nicht angezeigt. </p>
</li>
<li><p> Du kannst die voreingestellte Netzwerk-Adresse (IP) verändern, falls sie nicht zu deiner Netzwerk-Struktur passt. </p>
</li>
<li><p> Die Zeitabschaltung sorgt dafür, dass nach einer festgelegten Dauer von Inaktivität (in Minuten), das Crypto-Dateisystem deaktiviert wird (damit sind deine Daten wieder geschützt). Laufende Dateiübertragungen werden dadurch natürlich nicht gestört. </p>
<ul>
<li><p> Es ist ratsam, eine kurze Abschalt-Zeit einzustellen (wenige Minuten). </p>
</li>
<li><p> Der Wert <em>0</em> deaktiviert die automatische Abschaltung. </p>
</li>
</ul>
</li>
<li><p> Die Sprache ist der Standard für alle Nutzer des <a href="CryptoBox.html">CryptoBox</a>-Web-Interfaces. Sie kann individuell durch die Sprach-Links am rechten oberen Bildschirmrand überschrieben werden. </p>
</li>
</ul>
<p>Speichere deine neuen Einstellungen durch einen Klick auf <em>Speichere Konfiguration</em>. </p>
<p>Das ist alles - deine <a href="CryptoBox.html">CryptoBox</a> ist jetzt bereit für die <a href="CryptoBoxUserDailyUse.html">tägliche Nutzung</a>! </p>
<h2 id="head-fd34c5c4d9612568c9f2d2be251e9eb43d574c52">Hinweise / Fallstricke</h2>
<ul>
<li><p> Alle Daten auf der Festplatte in der <a href="CryptoBox.html">CryptoBox</a> werden bei der Initialisierung gelöscht. </p>
</li>
<li><p> Die Passworte müssen jeweils zweimal eingegeben werden, um die Gefahr von Tipp-Fehlern zu vermindern. </p>
</li>
<li><p> Das optionale Administrations-Passwort ist nur für die Konfiguration oder eine erneute Initialisierung erforderlich. </p>
</li>
<li><p> Das Crypto-Passwort beschützt deine sensiblen Daten. </p>
</li>
<li><p> Falls die <a href="CryptoBox.html">CryptoBox</a> nicht über die Adresse <em>192.168.0.23</em> erreichbar ist, musst du die Netzwerk-Adresse deines Arbeits-Rechners für die Dauer der Initialisierung der <a href="CryptoBox.html">CryptoBox</a> vorübergehend ändern. </p>
</li>
</ul>
<p><em>zurück zu <a href="CryptoBoxUser.html">CryptoBoxUser/de</a></em> </p>
<hr>
<p> </p>
<h2 id="head-dde63a967ebf4ea45fc857ec32d8e6d258545e70">Fragen</h2>
</p>
<hr />
<h1 id="DieKonfigurationdeinerCryptoBox">Die Konfiguration deiner CryptoBox</h1>
<h2 id="berblick">Überblick</h2>
<p>
Alle Funktionen der <a href="CryptoBox.html">CryptoBox</a> können durch das komfortable Web-Interface bedient werden. Zur Erst-Einrichtung der <a href="CryptoBox.html">CryptoBox</a> folge einfach den folgenden Schritten.
</p>
<p>
Falls du in Eile bist, kannst du das <a href="CryptoBoxUserConfiguration.html#Vorwort">Vorwort</a> überspringen.
</p>
<p>
Die <a href="CryptoBoxUserConfiguration.html#Initialisierung">Initialisierung</a> erklärt die Einrichtung der Festplatte. Dieser Schritt ist nur bei der ersten Einrichtung oder nach einem Festplattenwechsel notwendig.
</p>
<p>
Im <a href="CryptoBoxUserConfiguration.html#Konfiguration">Konfigurations</a>-Abschnitt werden die verfügbaren Einstellungen der <a href="CryptoBox.html">CryptoBox</a> beschrieben. Hier kannst du beispielsweise die Sprache des Web-Interfaces oder die Netzwerkadresse deiner <a href="CryptoBox.html">CryptoBox</a> einstellen.
</p>
<p>
Vergiss nicht, auch den <i><a href="CryptoBoxUserConfiguration.html#HinweiseFallstricke">Hinweise/Fallstricke</a></i>-Abschnitt zu lesen.
</p>
<h2 id="Vorwort">Vorwort</h2>
<p>
Du bist den Anweisungen aus <a href="CryptoBoxUserGettingStarted.html">CryptoBoxUserGettingStarted</a> gefolgt und sitzt nun vor deinem Arbeits-Rechner. Nun kannst du in deinem Web-Browser das Web-Interface der <a href="CryptoBox.html">CryptoBox</a> ansteuern: <i><a class="ext-link" title="https://192.168.0.23" href="https://192.168.0.23">https://192.168.0.23</a></i>.
</p>
<p>
Bevor du Daten auf deiner <a href="CryptoBox.html">CryptoBox</a> speichern kannst, muss die Festplatte mit einem verschlüsselten Dateisystem versehen werden. Das klingt kompliziert, ist jedoch mit einem Klick erledigt. :)
</p>
<h2 id="Initialisierung">Initialisierung</h2>
<p>
Klicke auf <i>Initialisierung</i> in der Menü-Zeile.
</p>
<p>
Jetzt wirst du zur Eingabe zweier Passworte aufgefordert (jeweils mit Wiederholung - zum Training deiner Tipp-Fertigkeiten ;)).
</p>
<p>
<a href='../../../var/www/cryptobox-img/screenshots/de_init.png' style='padding:0; border:none'><img src='../../../var/www/cryptobox-img/screenshots/de_init.png?format=raw' alt="de_init.png" title="de_init.png" style="" /></a>
</p>
<ul><li>Das erste Passwort ist das <i>Administrations-Password</i>.
<ul><li>Es schützt die Konfiguration deiner <a href="CryptoBox.html">CryptoBox</a>.
</li><li>Dies ist notwendig, um zu verhindern, dass jemand unerlaubt die Daten auf deiner <a href="CryptoBox.html">CryptoBox</a> durch eine erneute Initialisierung löscht.
</li><li>Wahrscheinlich wirst du dieses Passwort nie wieder benötigen.
</li><li>Du kannst das Administrations-Passwort leer lassen - dies wird jedoch nicht empfohlen.
</li></ul></li><li>Das <i>Crypto-Passwort</i> ist wesentlich wichtiger, da es der einzige Schutz der Daten auf der verschlüsselten Festplatte ist. Wähle es mit Sorgfalt!
<ul><li>Du benötigst es, um auf deine Daten zuzugreifen.
</li><li>Ein sicheres Passwort sollte aus mindestens 15 Zeichen (einschließlich Ziffern und Sonderzeichen) bestehen. Die Sicherheit deiner Daten steht und fällt mit der Qualität dieses Passworts.
</li></ul></li><li>Um dich daran zu erinnern, dass dieser Schritt die Festplatte der <a href="CryptoBox.html">CryptoBox</a> komplett löschen wird, musst du den angezeigten roten Warnhinweis im letzten Formularfeld eingeben.
</li><li>Nun kannst du die Initialisierung durch einen Klick auf <i>Initialisiere die CryptoBox</i> abschließen.
</li></ul><p>
Das war es dann auch schon. Kryptographie war wohl nie einfacher zu verwenden, oder? ;)
</p>
<p>
Der Initialisierungsvorgang läuft nun im Hintergrund ab und wird nach wenigen Minuten (abhängig von der Größe deiner Festplatte) abgeschlossen.
</p>
<h2 id="Konfiguration">Konfiguration</h2>
<p>
Im Gegensatz zur Initialisierung, die nur einmal durchgeführt werden muss, kannst du die Konfiguration jederzeit deinen Wünschen anpassen. Dazu klickst du einfach auf <i>Konfiguration</i> in der Menü-Zeile des Web-Interfaces. Nun wird dir ein Formular mit vier Feldern präsentiert:
</p>
<p>
<a href='../../../var/www/cryptobox-img/screenshots/de_config.png' style='padding:0; border:none'><img src='../../../var/www/cryptobox-img/screenshots/de_config.png?format=raw' alt="de_config.png" title="de_config.png" style="" /></a>
</p>
<ul><li>Falls du ein Administrator-Passwort während der <i>Initialisierung</i> festgelegt hast, musst du es nun eingeben. Andernfalls wird dieses Formularfeld nicht angezeigt.
</li><li>Du kannst die voreingestellte Netzwerk-Adresse (IP) verändern, falls sie nicht zu deiner Netzwerk-Struktur passt.
</li><li>Die Zeitabschaltung sorgt dafür, dass nach einer festgelegten Dauer von Inaktivität (in Minuten), das Crypto-Dateisystem deaktiviert wird (damit sind deine Daten wieder geschützt). Laufende Dateiübertragungen werden dadurch natürlich nicht gestört.
<ul><li>Es ist ratsam, eine kurze Abschalt-Zeit einzustellen (wenige Minuten).
</li><li>Der Wert <i>0</i> deaktiviert die automatische Abschaltung.
</li></ul></li><li>Die Sprache ist der Standard für alle Nutzer des CryptoBox-Web-Interfaces. Sie kann individuell durch die Sprach-Links am rechten oberen Bildschirmrand überschrieben werden.
</li></ul><p>
Speichere deine neuen Einstellungen durch einen Klick auf <i>Speichere Konfiguration</i>.
</p>
<p>
Das ist alles - deine <a href="CryptoBox.html">CryptoBox</a> ist jetzt bereit für die <a href="CryptoBoxUserDailyUse.html">tägliche Nutzung</a>!
</p>
<h2 id="HinweiseFallstricke">Hinweise / Fallstricke</h2>
<ul><li>Alle Daten auf der Festplatte in der <a href="CryptoBox.html">CryptoBox</a> werden bei der Initialisierung gelöscht.
</li><li>Die Passworte müssen jeweils zweimal eingegeben werden, um die Gefahr von Tipp-Fehlern zu vermindern.
</li><li>Das optionale Administrations-Passwort ist nur für die Konfiguration oder eine erneute Initialisierung erforderlich.
</li><li>Das Crypto-Passwort beschützt deine sensiblen Daten.
</li><li>Falls die <a href="CryptoBox.html">CryptoBox</a> nicht über die Adresse <i>192.168.0.23</i> erreichbar ist, musst du die Netzwerk-Adresse deines Arbeits-Rechners für die Dauer der Initialisierung der <a href="CryptoBox.html">CryptoBox</a> vorübergehend ändern.
</li></ul><p>
<i>zurück zu <a href="CryptoBoxUser.html">CryptoBoxUser</a></i>
</p>
<hr />
<h2 id="Kommentare">Kommentare</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

175
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxUserDailyUse.html
View file

@ -29,68 +29,129 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxUserDailyUse.html#AktivierendesverschlsseltenDateisystems">Aktivieren des verschlüsselten Dateisystems</a></li>
<li> <li><a href="CryptoBoxUserDailyUse.html#ZugriffaufdieverschlsseltenDaten">Zugriff auf die verschlüsselten Daten</a></li>
<a href="#head-58fa30bbb12b06f836481cac9c9759756d61b051">Aktivieren des verschlüsselten Dateisystems</a> <li><a href="CryptoBoxUserDailyUse.html#AbschaltendesverschlsseltenDateisystems">Abschalten des verschlüsselten Dateisystems</a></li>
</li> <li><a href="CryptoBoxUserDailyUse.html#AbschaltungderCryptoBox">Abschaltung der CryptoBox</a></li>
<li><a href="CryptoBoxUserDailyUse.html#NotfallAbschaltung">Notfall-Abschaltung</a></li>
<li> <li><a href="CryptoBoxUserDailyUse.html#FragenundAntworten">Fragen und Antworten</a></li>
<a href="#head-d245bf35328e9999ee8b6010389160917e2c7fa6">Abschalten des verschlüsselten Dateisystems</a> <li><a href="CryptoBoxUserDailyUse.html#Kommentare">Kommentare</a></li>
</li>
<li>
<a href="#head-15f09e2d0caa2d34dc2a5e08bd35a73785f6904f">Abschaltung der CryptoBox</a>
</li>
<li>
<a href="#head-8c5b7761331350d6862b1f40e62289c492f016c3">Notfall-Abschaltung</a>
</li>
<li>
<a href="#head-38032d34432f1a2bd9a97a8a2361f7a159e9f807">Fragen</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-58fa30bbb12b06f836481cac9c9759756d61b051">Aktivieren des verschlüsselten Dateisystems</h2> </p>
<p>
<p>Du kannst dein verschlüsseltes Dateisystem mit folgenden Schritten aktivieren: </p> <strong>Navigation:</strong> ( <a href="CryptoBoxUser.html">CryptoBoxUser/de</a>, <a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration/de</a>)
<ul>
<li><p> Wähle mit deinem Web-Browser die Adresse deiner <a href="CryptoBox.html">CryptoBox</a> an. Die Voreinstellung ist <a href="https://192.168.0.23">https://192.168.0.23</a>. </p>
</li>
<li><p> Klicke auf <em>Aktivieren der Crypto-Daten</em>. Daraufhin erscheint ein Formular zur Eingabe des Crypto-Passworts. </p>
</li>
<li><p> Gib dein Crypto-Passwort ein und klicke auf die darunterliegende Schaltfläche. </p>
</li>
</ul>
<p><img src="/toolforge/CryptoBoxUserDailyUse/de?action=AttachFile&amp;do=get&amp;target=mount_de.png" alt="mount_de.png"> </p>
<p>Nun ist das verschlüsselte Dateisystem verfügbar. Um es zu nutzen, suche in deiner Netzwerkumgebung nach der Netzwerk-Adresse deiner <a href="CryptoBox.html">CryptoBox</a> (Voreinstellung: 192.168.0.23). Nun kannst du das Netzlaufwerk wie üblich verwenden. </p>
<h2 id="head-d245bf35328e9999ee8b6010389160917e2c7fa6">Abschalten des verschlüsselten Dateisystems</h2>
<p>Du kannst das verschlüsselte Dateisystem abschalten, indem du in der Menü-Zeile des Web-Interfaces der <a href="CryptoBox.html">CryptoBox</a> auf <em>Deaktivierung der Crypto-Daten</em> klickst. </p>
<p>Deine Daten sind nun wieder vor jedem Zugriff geschützt. </p>
<h2 id="head-15f09e2d0caa2d34dc2a5e08bd35a73785f6904f">Abschaltung der CryptoBox</h2>
<p>Klicke auf <em>System</em> in der Menü-Zeile des Web-Interfaces. Nun kannst du zwischen <em>Abschaltung</em> und <em>Neustart</em> wählen. Die Abschaltung dauert einige Sekunden. </p>
<p>Falls dein <a href="CryptoBox.html">CryptoBox</a>-Rechner relativ neu ist (ungefähr ab Baujahr 02000), wird er sich nun selbständig abschalten. Andernfalls musst du dies per Hand tun. </p>
<h2 id="head-8c5b7761331350d6862b1f40e62289c492f016c3">Notfall-Abschaltung</h2>
<p>Falls du deine Daten wirklich schnell vor neugierigen Augen schützen musst, dann ziehe einfach den Stecker der <a href="CryptoBox.html">CryptoBox</a>. Dies ist nicht besonders sauber und kann (in sehr seltenen Ausnahmefällen) geöffnete Dateien beschädigen. Es ist jedoch die schnellste Methode zur Sicherung deiner Daten vor unbefugtem Zugriff. </p>
<p><em>zurück zu <a href="CryptoBoxUser.html">CryptoBoxUser/de</a></em> </p>
<hr>
<p> </p>
<h2 id="head-38032d34432f1a2bd9a97a8a2361f7a159e9f807">Fragen</h2>
</p>
<hr />
<h1 id="TglicheNutzung">Tägliche Nutzung</h1>
<h2 id="AktivierendesverschlsseltenDateisystems">Aktivieren des verschlüsselten Dateisystems</h2>
<p>
Du kannst dein verschlüsseltes Dateisystem mit folgenden Schritten aktivieren:
</p>
<ul><li>Wähle mit deinem Web-Browser die Adresse deiner <a href="CryptoBox.html">CryptoBox</a> an. Die Voreinstellung ist <a class="ext-link" title="https://192.168.0.23" href="https://192.168.0.23">https://192.168.0.23</a>.
</li><li>Klicke auf <i>Aktivieren der Crypto-Daten</i>. Daraufhin erscheint ein Formular zur Eingabe des Crypto-Passworts.
</li><li>Gib dein Crypto-Passwort ein und klicke auf die darunterliegende Schaltfläche.
</li></ul><p>
<a href='../../../var/www/cryptobox-img/screenshots/de_mount.png' style='padding:0; border:none'><img src='../../../var/www/cryptobox-img/screenshots/de_mount.png?format=raw' alt="de_mount.png" title="de_mount.png" style="" /></a>
</p>
<p>
Nun ist das verschlüsselte Dateisystem verfügbar. Um es zu nutzen, suche in deiner Netzwerkumgebung nach der Netzwerk-Adresse deiner <a href="CryptoBox.html">CryptoBox</a> (Voreinstellung: 192.168.0.23). Nun kannst du das Netzlaufwerk wie üblich verwenden.
</p>
<h2 id="ZugriffaufdieverschlsseltenDaten">Zugriff auf die verschlüsselten Daten</h2>
<h3 id="LinuxKommandozeile">Linux - Kommandozeile</h3>
<p>
Um als normaler Nutzer auf die Crypto-Partition zuzugreifen, solltest du folgende Zeile zur <i>/etc/fstab</i> hinzufügen:
</p>
<pre class="wiki">//192.168.0.23/public /mnt/ smbfs defaults,noexec,noauto,user,guest 0 0
</pre><p>
Nun kannst du die Crypto-Partition nach /mnt mounten:
</p>
<pre class="wiki">mount /mnt/
</pre><p>
bzw. unmounten:
</p>
<pre class="wiki">smbumount /mnt
</pre><h3 id="Windows">Windows</h3>
<p>
Starte den Windows Explorer und wähle im Menü unter <i>Extras</i> die Option <i>Netzlaufwerke verbinden</i> aus.
</p>
<p>
<a href='../../../var/www/cryptobox-img/screenshots/de_w98_network_drive.png' style='padding:0; border:none'><img src='../../../var/www/cryptobox-img/screenshots/de_w98_network_drive.png?format=raw' alt="de_w98_network_drive.png" title="de_w98_network_drive.png" style="" /></a>
</p>
<p>
Trage unter <i>Pfad</i> die Adresse des Verzeichnisse der <a href="CryptoBox.html">CryptoBox</a> ein, auf das du zugreifen willst (Standard: \\192.168.0.23\public). Soll die Verbindung beim jedem Start von Windows wiederhergestellt werden, aktiviere <i>Verbindung beim Start wiederherstellen</i>.
</p>
<p>
Nun kannst du auf das verschlüsselte Dateisystem wie jedes andere Laufwerk benutzen.
</p>
<h2 id="AbschaltendesverschlsseltenDateisystems">Abschalten des verschlüsselten Dateisystems</h2>
<p>
Du kannst das verschlüsselte Dateisystem abschalten, indem du in der Menü-Zeile des Web-Interfaces der <a href="CryptoBox.html">CryptoBox</a> auf <i>Deaktivierung der Crypto-Daten</i> klickst.
</p>
<p>
Deine Daten sind nun wieder vor jedem Zugriff geschützt.
</p>
<h2 id="AbschaltungderCryptoBox">Abschaltung der CryptoBox</h2>
<p>
Klicke auf <i>System</i> in der Menü-Zeile des Web-Interfaces. Nun kannst du zwischen <i>Abschaltung</i> und <i>Neustart</i> wählen. Die Abschaltung dauert einige Sekunden.
</p>
<p>
Falls dein CryptoBox-Rechner relativ neu ist (ungefähr ab Baujahr 02000), wird er sich nun selbständig abschalten. Andernfalls musst du dies per Hand tun.
</p>
<h2 id="NotfallAbschaltung">Notfall-Abschaltung</h2>
<p>
Falls du deine Daten wirklich schnell vor neugierigen Augen schützen musst, dann ziehe einfach den Stecker der <a href="CryptoBox.html">CryptoBox</a>. Dies ist nicht besonders sauber und kann (in sehr seltenen Ausnahmefällen) geöffnete Dateien beschädigen. Es ist jedoch die schnellste Methode zur Sicherung deiner Daten vor unbefugtem Zugriff.
</p>
<p>
<i>zurück zu <a href="CryptoBoxUser.html">CryptoBoxUser</a></i>
</p>
<hr />
<h2 id="FragenundAntworten">Fragen und Antworten</h2>
<h3 id="WindowsNetzlaufwerkkannnichtverbundenwerden">Windows: Netzlaufwerk kann nicht verbunden werden</h3>
<p>
<a href='../../../var/www/cryptobox-img/screenshots/de_w98_not_logged_in.png' style='padding:0; border:none'><img src='../../../var/www/cryptobox-img/screenshots/de_w98_not_logged_in.png?format=raw' alt="de_w98_not_logged_in.png" title="de_w98_not_logged_in.png" style="" /></a>
</p>
<p>
Erscheint diese Fehlermeldung, hast du dich beim Start von Windows nicht angemeldet bzw. das Anmeldefenster mit der Taste <i>Esc</i> (Escape) verschwinden lassen. Klicke auf <i>Start</i> und <i>Abmelden</i> und melde dich neu an - sobald das Anmeldefenster erscheint, klicke auf <i>OK</i>:
</p>
<p>
<a href='../../../var/www/cryptobox-img/screenshots/de_w98_login.png' style='padding:0; border:none'><img src='../../../var/www/cryptobox-img/screenshots/de_w98_login.png?format=raw' alt="de_w98_login.png" title="de_w98_login.png" style="" /></a>
</p>
<h3 id="Linuxonlyrootcanunmount192168023public">Linux: only root can unmount //192.168.0.23/public</h3>
<p>
Das Unmounten der Crypto-Partition mit <i>umount</i> funktioniert nicht.
</p>
<p>
<strong>Lösung:</strong> Verwende stattdessen:
</p>
<pre class="wiki">smbumount /mnt
</pre><h3 id="LinuxOperationnotpermittedsmbmntfailed1">Linux: Operation not permitted / smbmnt failed: 1</h3>
<p>
Der Versuch die Partition als normaler Nutzer zu mounten schlägt fehl:
</p>
<pre class="wiki">cannot mount on /mnt/: Operation not permitted
smbmnt failed: 1
</pre><p>
<strong>Lösung:</strong> Das Mount-Verzeichnis muss dem selben Nutzer gehören, der den mount-Befehl ausführt (bspw. phil):
</p>
<pre class="wiki">chown phil. /mnt
</pre><hr />
<h2 id="Kommentare">Kommentare</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

118
v0.2.1/cbox-tree.d/_offline/doc/de/CryptoBoxUserGettingStarted.html
View file

@ -29,78 +29,62 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxUserGettingStarted.html#ErsteSchritte">Erste Schritte</a></li>
<li> <li><a href="CryptoBoxUserGettingStarted.html#HinweiseFallstricke">Hinweise / Fallstricke</a></li>
<a href="#head-1a52cf4373780aa69853fdd9d63a69c0f223660b">Erste Schritte</a> <li><a href="CryptoBoxUserGettingStarted.html#Kommentare">Kommentare</a></li>
</li>
<li>
<a href="#head-0f6a807e2ff770ed406aac96796350c058e4d2ad">Hinweise / Fallstricke</a>
</li>
<li>
<a href="#head-907ba97818e4ff85db741812421bd41b5bf29dc3">Fragen</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-1a52cf4373780aa69853fdd9d63a69c0f223660b">Erste Schritte</h2> </p>
<p>
<p>Die <a href="CryptoBox.html">CryptoBox</a> ist schnellt aufgebaut: </p> <strong>Navigation:</strong> ( <a href="CryptoBoxUser.html">CryptoBoxUser/de</a>, <a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration/de</a>)
<ol type="1">
<li><p>Du brauchst einen alten Computer (mindestens 100MHZ, 48MB RAM) (Faustregel: nach 1996 gekauft). Dazu eine passende Netzwerkkarte, ein CD-ROM Laufwerk und eine riesige Festplatte. </p>
<ul>
<li><p> Die Festplatte muss nicht riesig sein, je nachdem was du speichern willst, reicht auch 'ne kleine <img src="../../../var/www/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
</li>
<li><p> Du brauchst keinen Monitor, keine Tastatur und keine Maus, um die <a href="CryptoBox.html">CryptoBox</a> zu benutzen (bzw. nur für die Erst-Einrichtung). </p>
</li>
<li><p> Du kannst natürlich einen schnelleren Rechner verwenden - der unbedeutende Performance-Zuwachs wird jedoch wohl nicht durch den erhöhten Energiebedarf gerechtfertigt. </p>
</li>
</ul>
</li>
<li><p>Lade die aktuellste Version der <a href="CryptoBox.html">CryptoBox</a> als iso-image herunter und brenne dieses auf einen CD-Rohling. </p>
<ul>
<li><p> <a href="http://codecoop.org/projects/cryptobox/">http://codecoop.org/projects/cryptobox/</a> </p>
</li>
</ul>
</li>
<li><p>Konfiguriere den PC, so dass er vom CD Laufwerk bootet. Dazu solltest du im BIOS als "boot device" "CD-ROM" einstellen. </p>
</li>
<li><p>Pack die frisch gebrannte <a href="CryptoBox.html">CryptoBox</a> CD ins Laufwerk und starte den Computer. </p>
</li>
</ol>
<p>Wenn der Computer jetzt von der CD startet, hast du alle Anforderungen erfüllt. </p>
<p>Du kannst nun zu deinem Arbeits-Rechner in demselben Netzwerk gehen und "<a href="https://192.168.0.23">https://192.168.0.23</a>" ansurfen. Dort sollte die <a href="CryptoBox.html">CryptoBox</a>-Konfigurationsseite erscheinen. Ist doch kinderleicht, oder? </p>
<p>Die weiteren Schritte werden unter <a href="CryptoBoxUser.html">CryptoBoxUser/de</a> beschrieben. </p>
<h2 id="head-0f6a807e2ff770ed406aac96796350c058e4d2ad">Hinweise / Fallstricke</h2>
<ul>
<li><p> Eventuell musst du für die Einrichtung der <a href="CryptoBox.html">CryptoBox</a> kurzzeitig deine Netzwerkaddresse (IP) ändern. Falls du nicht weißt, wie und warum, dann frage jemanden um Rat ... (wahrscheinlich klappt es aber ohne Änderungen) </p>
</li>
<li><p> Falls du eine neue Festplatte kaufen willst, beachte, dass alte PCs nicht mit modernen Festplattengrößen klarkommen. </p>
</li>
<li><p> Einige alte PCs können nicht vom CD-ROM-Laufwerk booten. </p>
</li>
<li><p> Falls dir der Begriff "BIOS" nichts sagt, bitte Menschen um Hilfe, bevor du was veränderst <img src="../../../var/www/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
</li>
<li><p> Vergiss nicht, den <a href="CryptoBox.html">CryptoBox</a>-Rechner ans Netzwerk anzuschliessen! </p>
</li>
<li><p> Du brauchst einen Monitor und eine Tastatur für die Konfiguration des BIOS. </p>
</li>
</ul>
<p><em>zurück zu <a href="CryptoBoxUser.html">CryptoBoxUser/de</a></em> </p>
<hr>
<p> </p>
<h2 id="head-907ba97818e4ff85db741812421bd41b5bf29dc3">Fragen</h2>
</p>
<hr />
<h1 id="Wiegehteslos">Wie geht es los</h1>
<h2 id="ErsteSchritte">Erste Schritte</h2>
<p>
Die <a href="CryptoBox.html">CryptoBox</a> ist schnell aufgebaut:
</p>
<ol><li>Du brauchst einen alten Computer (mindestens 100MHZ, 48MB RAM) (Faustregel: nach 1996 gekauft). Dazu eine passende Netzwerkkarte, ein CD-ROM Laufwerk und eine riesige Festplatte.
<ul><li>Die Festplatte muss nicht riesig sein, je nachdem was du speichern willst, reicht auch 'ne kleine ;)
</li><li>Du brauchst keinen Monitor, keine Tastatur und keine Maus, um die <a href="CryptoBox.html">CryptoBox</a> zu benutzen (bzw. nur für die Erst-Einrichtung).
</li><li>Du kannst natürlich einen schnelleren Rechner verwenden - der unbedeutende Performance-Zuwachs wird jedoch wohl nicht durch den erhöhten Energiebedarf gerechtfertigt.
</li></ul></li><li>Lade die aktuellste Version der <a href="CryptoBox.html">CryptoBox</a> als iso-image herunter und brenne dieses auf einen CD-Rohling.
<ul><li><a class="ext-link" title="http://codecoop.org/projects/cryptobox/" href="http://codecoop.org/projects/cryptobox/">http://codecoop.org/projects/cryptobox/</a>
</li></ul></li><li>Konfiguriere den PC, so dass er vom CD Laufwerk bootet. Dazu solltest du im BIOS als &#34;boot device&#34; &#34;CD-ROM&#34; einstellen.
</li><li>Pack die frisch gebrannte <a href="CryptoBox.html">CryptoBox</a> CD ins Laufwerk und starte den Computer.
</li></ol><p>
Wenn der Computer jetzt von der CD startet, hast du alle Anforderungen erfüllt.
</p>
<p>
Du kannst nun zu deinem Arbeits-Rechner in demselben Netzwerk gehen und &#34;<a class="ext-link" title="https://192.168.0.23&#34;" href="https://192.168.0.23&#34;">https://192.168.0.23&#34;</a> ansurfen. Dort sollte die CryptoBox-Konfigurationsseite erscheinen. Ist doch kinderleicht, oder?
</p>
<p>
Die weiteren Schritte werden unter <a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration</a> beschrieben.
</p>
<h2 id="HinweiseFallstricke">Hinweise / Fallstricke</h2>
<ul><li>Eventuell musst du für die Einrichtung der <a href="CryptoBox.html">CryptoBox</a> kurzzeitig deine Netzwerkaddresse (IP) ändern. Falls du nicht weißt, wie und warum, dann frage jemanden um Rat ... (wahrscheinlich klappt es aber ohne Änderungen)
</li><li>Falls du eine neue Festplatte kaufen willst, beachte, dass alte PCs nicht mit modernen Festplattengrößen klarkommen.
</li><li>Einige alte PCs können nicht vom CD-ROM-Laufwerk booten.
</li><li>Falls dir der Begriff &#34;BIOS&#34; nichts sagt, bitte Menschen um Hilfe, bevor du was veränderst ;)
</li><li>Vergiss nicht, den CryptoBox-Rechner ans Netzwerk anzuschliessen!
</li><li>Du brauchst einen Monitor und eine Tastatur für die Konfiguration des BIOS.
</li></ul><hr />
<h2 id="Kommentare">Kommentare</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

206
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBox.html
View file

@ -29,142 +29,86 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBox.html#News">News</a></li>
<li> <li><a href="CryptoBox.html#Overview">Overview</a></li>
<a href="#head-4f7ff469187373427683a6373538004a13ab7928">News</a> <li><a href="CryptoBox.html#Download">Download</a></li>
</li> <li><a href="CryptoBox.html#Support">Support</a></li>
<li><a href="CryptoBox.html#Development">Development</a></li>
<li> <li><a href="CryptoBox.html#Acknowledgements">Acknowledgements</a></li>
<a href="#head-efcfa621d0607ea7c5466d3ecdb99edf3cb4ebc8">Overview</a> <li><a href="CryptoBox.html#Legalstuff">Legal stuff</a></li>
</li> <li><a href="CryptoBox.html#Comments">Comments</a></li>
<li>
<a href="#head-97b25333607e6847b07b9b3c4996ed39d3da3064">Specs</a>
</li>
<li>
<a href="#head-1a17731b6ddd57e960f191c2096fe48056aecb3b">Usage</a>
</li>
<li>
<a href="#head-dd472b75401e742bc60e6324313368309548e9f8">Development</a>
</li>
<li>
<a href="#head-82502f7b432827fa8eabd177567e4034eb595e6c">Legal stuff</a>
</li>
</ol> </ol>
<p> </p>
<hr>
<p> </p>
<p><em>see <a href="CryptoBoxIntro.html">CryptoBoxIntro/en</a> for a very short overview</em> </p>
<h2 id="head-4f7ff469187373427683a6373538004a13ab7928">News</h2>
<p>We are moving this project to <a href="https://codecoop.org/projects/cryptobox/">https://codecoop.org/projects/cryptobox/</a> </p>
<p>The first release of the <a href="CryptoBox.html">CryptoBox</a>-LiveCD is planned for October 02005. </p>
<h2 id="head-efcfa621d0607ea7c5466d3ecdb99edf3cb4ebc8">Overview</h2>
<p>The <a href="CryptoBox.html">CryptoBox</a> is a Debian/Linux based live-cd. This CD boots up, starting a secure fileserver. Even non-technical users are able to store their data on its encrypted harddisk. There is no special knowledge about cryptography or servers required at all. </p>
<p>We provide the documentation in different languages. Feel free to add more translations: </p>
<ul>
<li><p> <a href="CryptoBox.html">deutsch</a> </p>
</li>
<li><p> <a href="CryptoBox.html">english</a> </p>
</li>
</ul>
<h2 id="head-97b25333607e6847b07b9b3c4996ed39d3da3064">Specs</h2>
<div>
<table>
<tr>
<td>
<p>system</p>
</td>
<td>
<p>Debian/Linux based Live-CD</p>
</td>
</tr>
<tr>
<td>
<p>needed hardware</p>
</td>
<td>
<p> "outdated" PC (i386 p1-100 32MB RAM minimum)</p>
</td>
</tr>
<tr>
<td>
<p>supported clients</p>
</td>
<td>
<p><a class="interwiki" title="WikiPedia" href="http://en.wikipedia.org/wiki/Operating_System">*nix; *bsd; Windows; Mac OS</a></p>
</td>
</tr>
<tr>
<td>
<p>fileserver</p>
</td>
<td>
<p><a class="external" href="http://samba.org">samba</a> (network shares)</p>
</td>
</tr>
<tr>
<td>
<p>userinterface</p>
</td>
<td>
<p>fully remote controlled via webbrowser</p>
</td>
</tr>
<tr>
<td>
<p>encryption</p>
</td>
<td>
<p><a class="interwiki" title="WikiPedia" href="http://en.wikipedia.org/wiki/Advanced_Encryption_Standard">AES</a> via device-mapper</p>
</td>
</tr>
</table>
</div> </div>
<p>The web interface of the <a href="CryptoBox.html">CryptoBox</a> supports the following languages: </p>
<ul>
<li><p> english </p>
</li>
<li><p> german </p>
</li>
<li><p> slovenian </p>
</li>
</ul>
<p>Feel free to contribute a <a class="interwiki" title="SubVersion" href="/websvn/cryptobox/trunk/cbox-tree.d/usr/share/cryptobox/lang/en.hdf">translation</a> for another language (preferably utf-encoded). </p>
<h2 id="head-1a17731b6ddd57e960f191c2096fe48056aecb3b">Usage</h2> </p>
<h1 id="TheCryptoBox">The CryptoBox</h1>
<p>The user documentation has its home at <a href="CryptoBoxUser.html">CryptoBoxUser/en</a>. </p> <p>
<i><a href="CryptoBox.html">deutschsprachige Version</a></i>
<h2 id="head-dd472b75401e742bc60e6324313368309548e9f8">Development</h2> </p>
<h2 id="News">News</h2>
<p>Take a look at the developer's documentation at <a href="CryptoBoxDev.html">CryptoBoxDev/en</a>. </p> <p>
<p>Report bugs at <a href="https://systemausfall.org/trac/cryptobox">https://systemausfall.org/trac/cryptobox</a>. </p> The first release of the <a href="CryptoBox.html">CryptoBox</a> is available at <a class="ext-link" title="https://codecoop.org/projects/cryptobox/" href="https://codecoop.org/projects/cryptobox/">Codecoop.org</a>.
<p>Browse the source code in the <a class="interwiki" title="SubVersion" href="/websvn/cryptobox">CryptoBox-websvn interface</a>. </p> </p>
<p>Anything else? Write us an email: <em>cryptobox[at]systemausfall.org</em> </p> <h2 id="Overview">Overview</h2>
<p>
<h2 id="head-82502f7b432827fa8eabd177567e4034eb595e6c">Legal stuff</h2> The <a href="CryptoBox.html">CryptoBox</a> is a Debian/Linux based <a class="ext-link" title="http://en.wikipedia.org/wiki/Live_CD" href="http://en.wikipedia.org/wiki/Live_CD">live-cd</a>. This CD boots up, starting a secure fileserver. Even non-technical users are able to store their data on its encrypted harddisk. There is no special knowledge about <a class="ext-link" title="http://en.wikipedia.org/wiki/Cryptography" href="http://en.wikipedia.org/wiki/Cryptography">cryptography</a> or servers required at all.<br />
The <a href="CryptoBox.html">CryptoBox</a> is fully controllable via your web browser. Have a look at the <a href="ScreenShots.html">ScreenShots</a>.
<ol type="1"> </p>
<li><p>All scripts are <a class="external" href="http://www.fsf.org/licensing/licenses/gpl.html">GPL licensed</a> </p> <table class="wiki">
</li> <tr><td><i>Specs</i>
<li><p>The documentation licensed under a <a class="external" href="http://creativecommons.org/licenses/by-sa-nc/2.0/">Creative Commons License</a><em> </em></p> </td></tr><tr><td>system</td><td>Debian/Linux based Live-CD
</li> </td></tr><tr><td>needed hardware</td><td> &#34;outdated&#34; PC (i386 p1-100 32MB RAM minimum)
<li><p>We do not take any warranty for the functionality or usability of the <a href="CryptoBox.html">CryptoBox</a>. </p> </td></tr><tr><td>supported clients</td><td><a class="ext-link" title="http://en.wikipedia.org/wiki/Operating_System" href="http://en.wikipedia.org/wiki/Operating_System">*nix; *bsd; Windows; Mac OS</a>
</li> </td></tr><tr><td>fileserver</td><td><a class="ext-link" title="http://samba.org" href="http://samba.org">samba</a> (network shares)
</ol> </td></tr><tr><td>userinterface</td><td>fully remote controlled via webbrowser
</td></tr><tr><td>encryption</td><td><a class="ext-link" title="http://en.wikipedia.org/wiki/Advanced_Encryption_Standard" href="http://en.wikipedia.org/wiki/Advanced_Encryption_Standard">AES</a> via device-mapper
</td></tr></table>
<p>
The web interface of the <a href="CryptoBox.html">CryptoBox</a> supports the following languages:
</p>
<ul><li>English
</li><li>German
</li><li>Slovenian
</li></ul><p>
We are looking for more translations. Just take a look at the &#34;README&#34;-file in our <a href="/trac/cryptobox/browser/trunk/cbox-tree.d/usr/share/cryptobox/lang/">language section</a>.
There you can find further instructions if you'd like to contribute.
</p>
<h2 id="Download">Download</h2>
<ul><li><a class="ext-link" title="http://codecoop.org/frs/download.php/32/cryptobox_0.2.iso" href="http://codecoop.org/frs/download.php/32/cryptobox_0.2.iso">version 0.2</a> [104 MB] - <a href="/trac/cryptobox/wiki/ReleaseNotes/0.2">Release notes</a>
<ul><li><i>provided by <a class="ext-link" title="http://codecoop.org" href="http://codecoop.org">http://codecoop.org</a></i>
</li></ul></li></ul><h2 id="Support">Support</h2>
<ul><li>The user documentation has its home at <a href="CryptoBoxUser.html">CryptoBoxUser</a>.
</li><li>Open up a <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/newticket" href="https://systemausfall.org/trac/cryptobox/newticket">ticket</a> for your feature requests and bugs.
</li><li>Write us an email: <i>cryptobox[at]systemausfall.org</i>
</li></ul><h2 id="Development">Development</h2>
<p>
Take a look at the developer's documentation at <a href="CryptoBoxDev.html">CryptoBoxDev</a> for more information.
</p>
<h2 id="Acknowledgements">Acknowledgements</h2>
<p>
<ul><li>Clavdia Horvat, Tadej Brce &amp; Dušan Rebolj - slovenian translation
</li><li><a class="ext-link" title="http://codecoop.org" href="http://codecoop.org">http://codecoop.org</a> - webspace
</li></ul>
</p>
<h2 id="Legalstuff">Legal stuff</h2>
<ol><li>All scripts are <a class="ext-link" title="http://www.fsf.org/licensing/licenses/gpl.html" href="http://www.fsf.org/licensing/licenses/gpl.html">GPL licensed</a>
</li><li>The documentation is licensed under a <a class="ext-link" title="http://creativecommons.org/licenses/by-sa-nc/2.0/" href="http://creativecommons.org/licenses/by-sa-nc/2.0/">Creative Commons License</a><i></i>
</li><li>We do not take any warranty for the functionality or usability of the <a href="CryptoBox.html">CryptoBox</a>.
</li></ol><hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

126
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDev.html
View file

@ -29,53 +29,97 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevPreparation.html#Preparationsfordevelopers">Preparations for developers</a></li>
<li> <ol><li><a href="CryptoBoxDevPreparation.html#Softwarerequirements">Software requirements</a></li>
<a href="#head-85f75330e62e5b1efc9f504fe9cb51a1b966dc3b">Development documentation</a> <li><a href="CryptoBoxDevPreparation.html#Getthesource">Get the source</a></li>
</li> <li><a href="CryptoBoxDevPreparation.html#Firstbuild">First build</a></li>
<li><a href="CryptoBoxDevPreparation.html#Finished">Finished</a></li>
<li> <li><a href="CryptoBoxDevPreparation.html#Comments">Comments</a></li>
<a href="#head-b8ce79abe983e1592235d0085dd6928b83811739">Contact</a>
</li>
<li>
<a href="#head-964f56b054273ed39bab34484f83ac053ac0f12e">Bug reports</a>
</li>
</ol> </ol>
<p> </p> <li><a href="CryptoBoxDevWorkFlow.html#Developmentworkflow">Development workflow</a></li>
<hr> <ol><li><a href="CryptoBoxDevWorkFlow.html#Preparations">Preparations</a></li>
<p> </p> <li><a href="CryptoBoxDevWorkFlow.html#CreateaCryptoBoxLiveCD">Create a CryptoBox-LiveCD</a></li>
<li><a href="CryptoBoxDevWorkFlow.html#TesttheCryptoBoxLiveCD">Test the CryptoBox-LiveCD</a></li>
<li><a href="CryptoBoxDevWorkFlow.html#Debuggingandmerging">Debugging and merging</a></li>
<li><a href="CryptoBoxDevWorkFlow.html#Comments">Comments</a></li>
</ol>
<li><a href="CryptoBoxDevCustomBuild.html#CustombuildsoftheCryptoBox">Custom builds of the CryptoBox</a></li>
<ol><li><a href="CryptoBoxDevCustomBuild.html#Overview">Overview</a></li>
<li><a href="CryptoBoxDevCustomBuild.html#Settings">Settings</a></li>
<li><a href="CryptoBoxDevCustomBuild.html#Comments">Comments</a></li>
</ol>
<li><a href="CryptoBoxDevCustomConfigure.html#CustomconfigurationoftheCryptoBox">Custom configuration of the CryptoBox</a></li>
<ol><li><a href="CryptoBoxDevCustomConfigure.html#Overview">Overview</a></li>
<li><a href="CryptoBoxDevCustomConfigure.html#Locations">Locations</a></li>
<li><a href="CryptoBoxDevCustomConfigure.html#Examples">Examples</a></li>
<li><a href="CryptoBoxDevCustomConfigure.html#Comments">Comments</a></li>
</ol>
<li><a href="CryptoBoxDevValidation.html#ValidationoftheCryptoBox">Validation of the CryptoBox</a></li>
<ol><li><a href="CryptoBoxDevValidation.html#Overview">Overview</a></li>
<li><a href="CryptoBoxDevValidation.html#Validate">Validate</a></li>
<li><a href="CryptoBoxDevValidation.html#Howtocreateatest">How to create a test</a></li>
<li><a href="CryptoBoxDevValidation.html#Comments">Comments</a></li>
</ol>
<li><a href="CryptoBoxDevBackground.html#DetailsoftheCryptoBox">Details of the CryptoBox</a></li>
<ol><li><a href="CryptoBoxDevBackground.html#dfsbuild">dfsbuild</a></li>
<li><a href="CryptoBoxDevBackground.html#thekernel">the kernel</a></li>
<li><a href="CryptoBoxDevBackground.html#qemu">qemu</a></li>
<li><a href="CryptoBoxDevBackground.html#alternativeLiveCDs">alternative LiveCDs</a></li>
<li><a href="CryptoBoxDevBackground.html#Comments">Comments</a></li>
</ol>
<li><a href="CryptoBoxDevKnownProblems.html#Knownproblems">Known problems</a></li>
<ol><li><a href="CryptoBoxDevKnownProblems.html#qemu">qemu</a></li>
<li><a href="CryptoBoxDevKnownProblems.html#dfsbuild">dfsbuild</a></li>
<li><a href="CryptoBoxDevKnownProblems.html#Comments">Comments</a></li>
</ol>
</ol>
</div>
<h2 id="head-85f75330e62e5b1efc9f504fe9cb51a1b966dc3b">Development documentation</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBox.html">CryptoBox/de</a>, <a href="CryptoBox.html">CryptoBox/en</a>)
<p>The following pages are written for developers only. Users of the <a href="CryptoBox.html">CryptoBox</a> should read <a href="CryptoBoxUser.html">CryptoBoxUser</a> instead. </p> </p>
<ul> <hr />
<li><p> <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a> </p> <h1 id="Developmentdocumentation">Development documentation</h1>
</li> <p>
<li><p> <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a> </p> The following pages are written for developers only. <br />
</li> Users of the <a href="CryptoBox.html">CryptoBox</a> should read <a href="CryptoBoxUser.html">CryptoBoxUser</a> instead.
<li><p> <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> </p> </p>
</li> <ul><li><a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>
<li><p> <a href="CryptoBoxDevCustomConfigure.html">CryptoBoxDevCustomConfigure</a> </p> </li><li><a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a>
</li> </li><li><a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a>
<li><p> <a href="CryptoBoxDevValidation.html">CryptoBoxDevValidation</a> </p> </li><li><a href="CryptoBoxDevCustomConfigure.html">CryptoBoxDevCustomConfigure</a>
</li> </li><li><a href="CryptoBoxDevValidation.html">CryptoBoxDevValidation</a>
<li><p> <a href="CryptoBoxDevBackground.html">CryptoBoxDevBackground</a> </p> </li><li><a href="CryptoBoxDevBackground.html">CryptoBoxDevBackground</a>
</li> </li><li><a href="CryptoBoxDevKnownProblems.html">CryptoBoxDevKnownProblems</a>
<li><p> <a href="CryptoBoxDevKnownProblems.html">CryptoBoxDevKnownProblems</a> </p> </li></ul><h2 id="Source">Source</h2>
</li> <p>
</ul> You may browse the <a href="/trac/cryptobox/browser/">source code</a>.
</p>
<h2 id="Contact">Contact</h2>
<p>
We are waiting for your emails to <i>cryptobox[at]systemausfall.org</i>.
</p>
<h2 id="Bugreports">Bug reports</h2>
<p>
If you think you found a bug or you get an error message, please help us to fix the problem and file a ticket (a bug report). Follow these steps:
</p>
<ol><li>Have a look at <a href="/trac/cryptobox/report/1">Open bugs</a> that need to be fixed
</li><li>Create a <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/newticket" href="https://systemausfall.org/trac/cryptobox/newticket">New Ticket</a>
</li></ol></div>
</div>
<h2 id="head-b8ce79abe983e1592235d0085dd6928b83811739">Contact</h2>
<p>We are waiting for your emails to <em>cryptobox[at]systemausfall.org</em>. </p>
<h2 id="head-964f56b054273ed39bab34484f83ac053ac0f12e">Bug reports</h2>
<p>Please use our issue tracker, if you discover problems: <a href="https://systemausfall.org/trac/cryptobox">https://systemausfall.org/trac/cryptobox</a> </p>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->

118
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevBackground.html
View file

@ -29,71 +29,69 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevBackground.html#dfsbuild">dfsbuild</a></li>
<li> <li><a href="CryptoBoxDevBackground.html#thekernel">the kernel</a></li>
<a href="#head-2d71165918ee9e861cebf562e7f9be2c5c6328e4">dfsbuild</a> <li><a href="CryptoBoxDevBackground.html#qemu">qemu</a></li>
</li> <li><a href="CryptoBoxDevBackground.html#alternativeLiveCDs">alternative LiveCDs</a></li>
<li><a href="CryptoBoxDevBackground.html#Comments">Comments</a></li>
<li>
<a href="#head-6e3d13fcf3a0765d2188125e9b0b0bcb95e50622">the kernel</a>
</li>
<li>
<a href="#head-e01e8e66ae77c00f4e9fa9bd190c3ff738540727">qemu</a>
</li>
<li>
<a href="#head-00c94b926ece7f2a601d696a8880f5e54155ce7a">alternative LiveCDs</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
<h2 id="head-2d71165918ee9e861cebf562e7f9be2c5c6328e4">dfsbuild</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>)
<p>The base system of the <a href="CryptoBox.html">CryptoBox</a> Live-CD is created by <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>. </p> </p>
<p>It is recommended to use some kind of caching tool for the retrieval of the debian packages (e.g.: <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a> or <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a>). This saves a lot of bandwidth and time. </p> <hr />
<p>The documentation for <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> is sparse. But it is quite unlikely, that you will get in direct contact with it, as it is wrapped by <em>cbox-build</em>. However the following links may help you for specific problems: </p> <h1 id="DetailsoftheCryptoBox">Details of the CryptoBox</h1>
<ul> <h2 id="dfsbuild">dfsbuild</h2>
<li><p> <a class="external" href="http://www.debian-administration.org/articles/125">Debian Administration: Building Debian CD-ROMS Part 1 - dfsbuild</a> </p> <p>
</li> The base system of the <a href="CryptoBox.html">CryptoBox</a> Live-CD is created by <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>.
<li><p> <a class="external" href="http://www.debian-administration.org/articles/149">Debian Administration: Getting in deep with dfsbuild</a> </p> </p>
</li> <p>
</ul> It is recommended to use some kind of caching tool for the retrieval of the debian packages (e.g.: <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a> or <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx">approx</a>). This saves a lot of bandwidth and time.
</p>
<h2 id="head-6e3d13fcf3a0765d2188125e9b0b0bcb95e50622">the kernel</h2> <p>
The documentation for <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> is sparse. But it is quite unlikely, that you will get in direct contact with it, as it is wrapped by <a href="/trac/cryptobox/browser/trunk/scripts/cbox-build.sh">cbox-build</a>. However the following links may help you for specific problems:
<p>The linux kernel for the <a href="CryptoBox.html">CryptoBox</a> is compiled statically. If you want to change it, you could follow this steps: </p> </p>
<ol type="1"> <ul><li><a class="ext-link" title="http://www.debian-administration.org/articles/125" href="http://www.debian-administration.org/articles/125">Debian Administration: Building Debian CD-ROMS Part 1 - dfsbuild</a>
<li><p>get the sources: <tt>apt-get&nbsp;install&nbsp;kernel-tree-2.6.11</tt> (or the version of your choice) </p> </li><li><a class="ext-link" title="http://www.debian-administration.org/articles/149" href="http://www.debian-administration.org/articles/149">Debian Administration: Getting in deep with dfsbuild</a>
</li> </li></ul><h2 id="thekernel">the kernel</h2>
<li><p>copy the exisiting config file <em>kernel/config-2.6.11</em> as <em>.config</em> into your kernel source directory </p> <p>
</li> The linux kernel for the <a href="CryptoBox.html">CryptoBox</a> is compiled statically. If you want to change it, you could follow this steps:
<li><p>build the debian kernel package <tt>make-kpkg&nbsp;--revision=1.dfs&nbsp;--rootcmd=fakeroot&nbsp;kernel_image</tt> </p> </p>
</li> <ol><li>get the sources: <tt>apt-get install kernel-tree-2.6.11</tt> (or the version of your choice)
<li><p>change the kernel in the <em>unpackdebs</em> setting in <em>dfs-cbox.conf</em> (see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details) </p> </li><li>copy the exisiting config file <i>kernel/config-2.6.11</i> as <i>.config</i> into your kernel source directory
</li> </li><li>build the debian kernel package <tt>make-kpkg --revision=1.dfs --rootcmd=fakeroot kernel_image</tt>
</ol> </li><li>change the kernel in the <i>unpackdebs</i> setting in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/dfs-cbox.conf">dfs-cbox.conf</a> (see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details)
</li></ol><p>
<h2 id="head-e01e8e66ae77c00f4e9fa9bd190c3ff738540727">qemu</h2> See <a title="" href="/trac/cryptobox/browser/trunk/hints/kernel-build.txt">source:trunk/hints/kernel-build.txt</a> for more details.
</p>
<p><a class="external" href="http://fabrice.bellard.free.fr/qemu/">Qemu</a> is a portable system emulator. It is a convenient tool to ease the development workflow, as you do not need to burn LiveCDs for testing. </p> <h2 id="qemu">qemu</h2>
<p>
<h2 id="head-00c94b926ece7f2a601d696a8880f5e54155ce7a">alternative LiveCDs</h2> <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu/" href="http://fabrice.bellard.free.fr/qemu/">Qemu</a> is a portable system emulator. It is a convenient tool to ease the development workflow, as you do not need to burn LiveCDs for testing.
</p>
<p>We tried some other LiveCDs before we decided to use <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>. The following pages describe their advantages and disadvantages as the base system for the <a href="CryptoBox.html">CryptoBox</a>: </p> <h2 id="alternativeLiveCDs">alternative LiveCDs</h2>
<ul> <p>
<li><p> <a href="CryptoBoxKnoppixVerworfen.html">CryptoBoxKnoppixVerworfen</a> - Knoppix </p> We tried some other LiveCDs before we decided to use <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>. The following pages describe their advantages and disadvantages as the base system for the <a href="CryptoBox.html">CryptoBox</a>:
</li> </p>
<li><p> <a href="CryptoBoxMorphixVerworfen.html">CryptoBoxMorphixVerworfen</a> - Morphix / IBuild </p> <ul><li><a href="CryptoBoxKnoppixVerworfen.html">CryptoBoxKnoppixVerworfen</a> - Knoppix
</li> </li><li><a href="CryptoBoxMorphixVerworfen.html">CryptoBoxMorphixVerworfen</a> - Morphix / IBuild
</ul> </li></ul><hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

171
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevCustomBuild.html
View file

@ -29,103 +29,90 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevCustomBuild.html#Overview">Overview</a></li>
<li> <li><a href="CryptoBoxDevCustomBuild.html#Settings">Settings</a></li>
<a href="#head-27ea5a3ee88c7c2dfcfd4124719aadd726f1e2da">Overview</a> <ol><li><a href="CryptoBoxDevCustomBuild.html#dfsbuildsettings">dfsbuild settings</a></li>
</li> <li><a href="CryptoBoxDevCustomBuild.html#CryptoBoxdevelopmentconfiguration">CryptoBox development configuration</a></li>
<li><a href="CryptoBoxDevCustomBuild.html#SSHconnection">SSH connection</a></li>
<li> <li><a href="CryptoBoxDevCustomBuild.html#qemunetworkconfiguration">qemu network configuration</a></li>
<a href="#head-737db576c5f42abc0c78574d0ce5077809f288cb">Settings</a> </ol><li><a href="CryptoBoxDevCustomBuild.html#Comments">Comments</a></li>
<ol>
<li>
<a href="#head-9d97886ad41e38cb6afe343aa68ff652030ab06b">dfsbuild settings</a>
</li>
<li>
<a href="#head-c2ae24a50a3706711c1a42e26176768438d4f160">CryptoBox development configuration</a>
</li>
<li>
<a href="#head-90ac95d2e5a50160cbf72b884b7b469a29c2fea1">SSH connection</a>
</li>
<li>
<a href="#head-6798893e2e3fd89a72b5b6821a0d3d08125367b9">qemu network configuration</a>
</li>
</ol> </ol>
</div>
</li> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>, <a href="CryptoBoxDevBackground.html">CryptoBoxDevBackground</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevPreparation">CryptoBoxDevPreparation</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevWorkFlow">CryptoBoxDevWorkFlow</a>)
</ol> </p>
<p> </p> <hr />
<hr> <h1 id="CustombuildsoftheCryptoBox">Custom builds of the CryptoBox</h1>
<p> </p> <h2 id="Overview">Overview</h2>
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p> <p>
The following sections are useful, if you want to change the default settings of your personal <a href="CryptoBox.html">CryptoBox</a> development environment.
<h2 id="head-27ea5a3ee88c7c2dfcfd4124719aadd726f1e2da">Overview</h2> </p>
<p>
<p>The following sections are useful, if you want to change the default settings of your personal <a href="CryptoBox.html">CryptoBox</a> development environment. </p> You should have completed the steps described in <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>.
<p>You should have completed the steps described in <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>. </p> </p>
<h2 id="Settings">Settings</h2>
<h2 id="head-737db576c5f42abc0c78574d0ce5077809f288cb">Settings</h2> <h3 id="dfsbuildsettings">dfsbuild settings</h3>
<p>
All settings for <i>dfsbuild</i> can be found in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/dfs-cbox.conf">etc-defaults.d/dfs-cbox.conf</a>.
<h3 id="head-9d97886ad41e38cb6afe343aa68ff652030ab06b">dfsbuild settings</h3> </p>
<p>
<p>All settings for <em>dfsbuild</em> can be found in <em>etc-defaults.d/dfs-cbox.conf</em>. </p> If you want to change any of them, you should do the following:
<p>If you want to change any of them, you should do the following: </p> </p>
<ol type="1"> <ol><li>copy <i>etc-defaults.d/dfs-cbox.conf</i> file to <i>etc-local.d/</i>
<li><p>copy <em>etc-defaults.d/dfs-cbox.conf</em> file to <em>etc-local.d/</em> </p> </li><li>change <i>etc-local.d/dfs-cbox.conf</i> according to your needs
</li> </li></ol><p>
<li><p>change <em>etc-local.d/dfs-cbox.conf</em> according to your needs </p> This allows you to use your own (personal) settings, without interfering with files under version control.
</li> </p>
</ol> <h3 id="CryptoBoxdevelopmentconfiguration">CryptoBox development configuration</h3>
<p>This allows you to use your own (personal) settings, without interfering with files under version control. </p> <p>
Some settings regarding the building, configuring and validating of the <a href="CryptoBox.html">CryptoBox</a> can be found in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/cbox-dev.conf">etc-defaults.d/cbox-dev.conf</a>.
<h3 id="head-c2ae24a50a3706711c1a42e26176768438d4f160">CryptoBox development configuration</h3> </p>
<p>
<p>Some settings regarding the building, configuring and validating of the <a href="CryptoBox.html">CryptoBox</a> can be found in <em>etc-defaults.d/cbox-dev.conf</em>. </p> If you want to change any of them, you should do the following:
<p>If you want to change any of them, you should do the following: </p> </p>
<ol type="1"> <ol><li>copy <i>etc-defaults.d/cbox-dev.conf</i> file to <i>etc-local.d/</i>
<li><p>copy <em>etc-defaults.d/cbox-dev.conf</em> file to <em>etc-local.d/</em> </p> </li><li>change <i>etc-local.d/cbox-dev.conf</i> according to your needs
</li> </li></ol><h3 id="SSHconnection">SSH connection</h3>
<li><p>change <em>etc-local.d/cbox-dev.conf</em> according to your needs </p> <p>
</li> The file <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/ssh_config">ssh_config</a> is used to establish a connection to a running <a href="CryptoBox.html">CryptoBox</a> system.
</ol> </p>
<p>
<h3 id="head-90ac95d2e5a50160cbf72b884b7b469a29c2fea1">SSH connection</h3> It can be necessary to change these settings, if:
</p>
<p>The file <em>etc-defaults.d/ssh_config</em> is used to establish a connection to a running <a href="CryptoBox.html">CryptoBox</a> system. </p> <ul><li>you do not want to use the default IP for the <a href="CryptoBox.html">CryptoBox</a>
<p>It can be necessary to change these settings, if: </p> </li><li>or the <a href="CryptoBox.html">CryptoBox</a> is not within your local network.
<ul> </li></ul><p>
<li><p> you do not want to use the default IP for the <a href="CryptoBox.html">CryptoBox</a> </p> If you want to change some settings, you should do the following:
</li> </p>
<li><p> or the <a href="CryptoBox.html">CryptoBox</a> is not within your local network. </p> <ol><li>copy <i>etc-defaults.d/ssh_config</i> file to <i>etc-local.d/</i>
</li> </li><li>change <i>etc-local.d/ssh_config</i> according to your needs
</ul> </li></ol><h3 id="qemunetworkconfiguration">qemu network configuration</h3>
<p>If you want to change some settings, you should do the following: </p> <p>
<ol type="1"> The file <a href="/trac/cryptobox/browser/trunk/etc-defauolts.d/qemu-ifup">etc-defauolts.d/qemu-ifup</a> is used for the <a href="CryptoBox.html">CryptoBox</a> emulation with <i>qemu</i>. See <i>man qemu</i> for details.
<li><p>copy <em>etc-defaults.d/ssh_config</em> file to <em>etc-local.d/</em> </p> </p>
</li> <p>
<li><p>change <em>etc-local.d/ssh_config</em> according to your needs </p> If you want to change some settings, you should do the following:
</li> </p>
</ol> <ol><li>copy <i>etc-defaults.d/qemu-ifup</i> file to <i>etc-local.d/</i>
</li><li>change <i>etc-local.d/qemu-ifup</i> according to your needs
<h3 id="head-6798893e2e3fd89a72b5b6821a0d3d08125367b9">qemu network configuration</h3> </li></ol><hr />
<h2 id="Comments">Comments</h2>
<p>The file <em>etc-defauolts.d/qemu-ifup</em> is used for the <a href="CryptoBox.html">CryptoBox</a> emulation with <em>qemu</em>. See <tt>man&nbsp;qemu</tt> for details. </p> <p>
<p>If you want to change some settings, you should do the following: </p>
<ol type="1">
<li><p>copy <em>etc-defaults.d/qemu-ifup</em> file to <em>etc-local.d/</em> </p>
</li>
<li><p>change <em>etc-local.d/qemu-ifup</em> according to your needs </p>
</li>
</ol>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

108
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevCustomConfigure.html
View file

@ -29,65 +29,65 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevCustomConfigure.html#Overview">Overview</a></li>
<li> <li><a href="CryptoBoxDevCustomConfigure.html#Locations">Locations</a></li>
<a href="#head-eaec6be4efea7b38c41712778bfd4fb8d2827d3c">Overview</a> <li><a href="CryptoBoxDevCustomConfigure.html#Examples">Examples</a></li>
</li> <li><a href="CryptoBoxDevCustomConfigure.html#Comments">Comments</a></li>
<li>
<a href="#head-51173f0423ca91d36cd0cfcdc75a06d90cc087ee">Locations</a>
</li>
<li>
<a href="#head-9b9b6463081c4d9d13e3aadebe9daaf61fa67b5c">Examples</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
<h2 id="head-eaec6be4efea7b38c41712778bfd4fb8d2827d3c">Overview</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>)
<p>You may change nearly every aspect of the <a href="CryptoBox.html">CryptoBox</a> by using the custom configuration hook directory. </p> </p>
<p>Any script inside of this directory will be executed after the default configuration procedure (see <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a>). </p> <hr />
<p>The order of execution is defined by the names of the scripts (alphabetically). </p> <h1 id="CustomconfigurationoftheCryptoBox">Custom configuration of the CryptoBox</h1>
<h2 id="Overview">Overview</h2>
<h2 id="head-51173f0423ca91d36cd0cfcdc75a06d90cc087ee">Locations</h2> <p>
You may change nearly every aspect of the <a href="CryptoBox.html">CryptoBox</a> by using the custom configuration hook directory.
<p>Some example customization scripts can be found in <em>configure-examples.d/</em>. </p> </p>
<p>You may put your scripts into <em>configure-local.d/</em>. They will be sourced by <em>cbox-build.sh</em>. </p> <p>
Any script inside of this directory will be executed after the default configuration procedure (see <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a>).
<h2 id="head-9b9b6463081c4d9d13e3aadebe9daaf61fa67b5c">Examples</h2> </p>
<p>
<p>The examples in <em>configure-examples.d/</em> can be copied to <em>configure-local.d/</em> and adjusted to your needs. </p> The order of execution is defined by the names of the scripts (alphabetically).
<dl> </p>
<dt>set_default_ip</dt> <h2 id="Locations">Locations</h2>
<dd><p>change the default IP address of the <a href="CryptoBox.html">CryptoBox</a> </p> <p>
</dd> Some example customization scripts can be found in <a href="/trac/cryptobox/browser/trunk/configure-examples.d">configure-examples.d/</a>.
<dt>set_default_language</dt> </p>
<dd><p>set the default language </p> <p>
</dd> You may put your scripts into <i>configure-local.d/</i>. They will be sourced by <a href="/trac/cryptobox/browser/trunk/scripts/cbox-build.sh">cbox-build.sh</a>.
<dt>set_default_timeout</dt> </p>
<dd><p>set the default idle time for automatic unmounting </p> <h2 id="Examples">Examples</h2>
</dd> <p>
<dt>set_hostname</dt> The examples in <a href="/trac/cryptobox/browser/trunk/configure-examples.d">configure-examples.d/</a> can be copied to <i>configure-local.d/</i> and adjusted to your needs.
<dd><p>change the default hostname </p> </p>
</dd> <table class="wiki">
<dt>set_root_pw</dt> <tr><td>set_default_ip</td><td>change the default IP address of the CryptoBox
<dd><p>change the password of root (only useful for a development <a href="CryptoBox.html">CryptoBox</a>) </p> </td></tr><tr><td>set_default_language</td><td>set the default language
</dd> </td></tr><tr><td>set_default_timeout</td><td>set the default idle time for automatic unmounting
<dt>import_authorized_keys</dt> </td></tr><tr><td>set_hostname</td><td>change the default hostname
<dd><p>upload a <em>ssh</em> key for passwordless access to a development <a href="CryptoBox.html">CryptoBox</a> </p> </td></tr><tr><td>set_root_pw</td><td>change the password of root (only useful for a development <a href="CryptoBox.html">CryptoBox</a>)
</dd> </td></tr><tr><td>import_authorized_keys</td><td>upload a <i>ssh</i> key for passwordless access to a development CryptoBox
<dt>set_scan_devices</dt> </td></tr><tr><td>set_scan_devices</td><td>where to look for usable harddisks
<dd><p>where to look for usable harddisks </p> </td></tr></table>
</dd> <hr />
</dl> <h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

70
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevKnownProblems.html
View file

@ -29,41 +29,51 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevKnownProblems.html#qemu">qemu</a></li>
<li> <ol><li><a href="CryptoBoxDevKnownProblems.html#interleavedfilesnotyetsupported">interleaved files not (yet) supported</a></li>
<a href="#head-3d279b986395c95455d4d831054f9664ac846790">qemu</a> <li><a href="CryptoBoxDevKnownProblems.html#smbdsegfault">smbd: segfault</a></li>
<ol> </ol><li><a href="CryptoBoxDevKnownProblems.html#dfsbuild">dfsbuild</a></li>
<ol><li><a href="CryptoBoxDevKnownProblems.html#cantcdto_builddirtargetvarlibaptlists">can't cd to _builddir/target/var/lib/apt/lists</a></li>
<li> </ol><li><a href="CryptoBoxDevKnownProblems.html#Comments">Comments</a></li>
<a href="#head-9d223a1d9ee655c5a338f798fc08850a2b3694ba">interleaved files not (yet) supported</a>
</li>
<li>
<a href="#head-aa082f09cdb79c9a715826562efebd23cb8e9dfc">smbd: segfault</a>
</li>
</ol> </ol>
</div>
</li> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>)
</ol> </p>
<p> </p> <hr />
<hr> <h1 id="Knownproblems">Known problems</h1>
<p> </p> <h2 id="qemu">qemu</h2>
<h3 id="interleavedfilesnotyetsupported">interleaved files not (yet) supported</h3>
<h2 id="head-3d279b986395c95455d4d831054f9664ac846790">qemu</h2> <p>
You should update <i>qemu</i> to version 0.7 or higher.
</p>
<h3 id="head-9d223a1d9ee655c5a338f798fc08850a2b3694ba">interleaved files not (yet) supported</h3> <h3 id="smbdsegfault">smbd: segfault</h3>
<p>
<p>You should update <em>qemu</em> to version 0.7 or higher. </p> This happens under certain circumstances. We do not know a solution for this problem.
</p>
<h3 id="head-aa082f09cdb79c9a715826562efebd23cb8e9dfc">smbd: segfault</h3> <h2 id="dfsbuild">dfsbuild</h2>
<h3 id="cantcdto_builddirtargetvarlibaptlists">can't cd to _builddir/target/var/lib/apt/lists</h3>
<p>This happens under certain circumstances. We do not know a solution for this problem. </p> <p>
This can be caused by a (strange) mix of debian package versions. Track this bug at <a class="ext-link" title="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991" href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991</a>.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

147
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevPreparation.html
View file

@ -29,91 +29,82 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevPreparation.html#Softwarerequirements">Software requirements</a></li>
<li> <ol><li><a href="CryptoBoxDevPreparation.html#Packages">Packages</a></li>
<a href="#head-5b50aeed8139c95e5a2670d4248978d942c5edd6">Software requirements</a> <li><a href="CryptoBoxDevPreparation.html#Kernel">Kernel</a></li>
<ol> </ol><li><a href="CryptoBoxDevPreparation.html#Getthesource">Get the source</a></li>
<li><a href="CryptoBoxDevPreparation.html#Firstbuild">First build</a></li>
<li> <li><a href="CryptoBoxDevPreparation.html#Finished">Finished</a></li>
<a href="#head-143e3ec00a024bf2d9486f21dccab7ddc0ac3709">Packages</a> <li><a href="CryptoBoxDevPreparation.html#Comments">Comments</a></li>
</li>
<li>
<a href="#head-8abff5fecd19a74f1f5602aa82c8783c80b6862e">Kernel</a>
</li>
</ol> </ol>
</div>
<li>
<a href="#head-e988a63aa4744649892e3c85e239927edb01f336">Get the source</a>
</li>
<li>
<a href="#head-3b183abdfebed7afdbbdbb7625f85081882beb70">First build</a>
</li>
<li>
<a href="#head-08bd0ad2103b9f58bd026d64c0bcb333f3bbd90b">Finished</a>
</li>
</ol>
<p> </p>
<hr>
<p> </p>
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
<h2 id="head-5b50aeed8139c95e5a2670d4248978d942c5edd6">Software requirements</h2>
<h3 id="head-143e3ec00a024bf2d9486f21dccab7ddc0ac3709">Packages</h3>
<p>We use <a class="external" href="http://debian.org">Debian</a> as our development environment. This was a natural choice, as the <a href="CryptoBox.html">CryptoBox</a>-LiveCD is also based on Debian. Other distributions should work too, of course - <a class="interwiki" title="Acronym" href="http://www.acronymfinder.com/af-query.asp?String=exact&amp;Acronym=YMMV">YMMV</a>. </p>
<p>required: </p>
<ul>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=subversion">subversion</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=chroot">chroot</a> </p>
</li>
</ul>
<p>recommended: </p>
<ul>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a> or <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=approx">approx</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=qemu">qemu</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=curl">curl</a> </p>
</li>
</ul>
<h3 id="head-8abff5fecd19a74f1f5602aa82c8783c80b6862e">Kernel</h3>
<p>If you want to use <a class="external" href="http://fabrice.bellard.free.fr/qemu/">qemu</a> to test your <a href="CryptoBox.html">CryptoBox</a> in a virtual environment, then you will need the <em>tun/tap</em> kernel feature.
</p> </p>
<pre> <p>
CONFIG_TUN=m</pre> <strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>, <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevWorkFlow">CryptoBoxDevWorkFlow</a>)
<h2 id="head-e988a63aa4744649892e3c85e239927edb01f336">Get the source</h2>
<p>Download the latest release from our <a class="external" href="http://subversion.tigris.org">subversion</a>-Repository:
</p> </p>
<pre> <hr />
svn checkout https://svn.systemausfall.org/svn/cryptobox/trunk </pre> <h1 id="Preparationsfordevelopers">Preparations for developers</h1>
<h2 id="Softwarerequirements">Software requirements</h2>
<h2 id="head-3b183abdfebed7afdbbdbb7625f85081882beb70">First build</h2> <h3 id="Packages">Packages</h3>
<p>
<p>run <tt>scripts/cbox-build.sh&nbsp;release</tt> as <em>root</em> - hopefully, there should be no errors <img src="../../../var/www/cryptobox-img/smile.png" alt=":)" height="15" width="15"> </p> We use <a class="ext-link" title="http://debian.org" href="http://debian.org">Debian</a> as our development environment. This was a natural choice, as the CryptoBox-LiveCD is also based on Debian. Other distributions should work too, of course - <i>your mileage may vary</i>.
<p>Hint: This step will fail, if you did not install <em>apt-cacher</em>. See <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details on how to change the build-configuration settings (in this case: <em>mirror</em> in <em>dfs-cbox.conf</em>). </p> </p>
<p>
<h2 id="head-08bd0ad2103b9f58bd026d64c0bcb333f3bbd90b">Finished</h2> required:
</p>
<p>Now you can start to pariticipate in the development of the <a href="CryptoBox.html">CryptoBox</a> or simply customize your own <a href="CryptoBox.html">CryptoBox</a>-LiveCD. </p> <ul><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>
<p>See <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a> for details of how to use the developer's tools of the <a href="CryptoBox.html">CryptoBox</a>. </p> </li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=subversion" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=subversion">subversion</a>
<p><a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> shows some examples for local customizations of the <a href="CryptoBox.html">CryptoBox</a>. </p> </li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=chroot" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=chroot">chroot</a>
</li></ul><p>
recommended:
</p>
<ul><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy"> apt-proxy</a> or <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx">approx</a>
</li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=qemu" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=qemu">qemu</a>
</li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=curl" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=curl">curl</a>
</li></ul><h3 id="Kernel">Kernel</h3>
<p>
If you want to use <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu/" href="http://fabrice.bellard.free.fr/qemu/">qemu</a> to test your <a href="CryptoBox.html">CryptoBox</a> in a virtual environment, then you will need the <i>tun/tap</i> kernel feature.
</p>
<pre class="wiki">CONFIG_TUN=m
</pre><h2 id="Getthesource">Get the source</h2>
<p>
Download the latest release from our <a class="ext-link" title="http://subversion.tigris.org" href="http://subversion.tigris.org">subversion</a>-Repository:
</p>
<pre class="wiki">svn checkout https://svn.systemausfall.org/svn/cryptobox/trunk
</pre><h2 id="Firstbuild">First build</h2>
<p>
run <tt>scripts/cbox-build.sh release</tt> as <i>root</i> - hopefully, there should be no errors :)
</p>
<p>
Hint: This step will fail, if you did not install <i>apt-cacher</i>. See <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details on how to change the build-configuration settings (in this case: <i>mirror</i> in <i>dfs-cbox.conf</i>).
</p>
<h2 id="Finished">Finished</h2>
<p>
Now you can start to pariticipate in the development of the <a href="CryptoBox.html">CryptoBox</a> or simply customize your own CryptoBox-LiveCD.
</p>
<p>
See <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a> for details of how to use the developer's tools of the <a href="CryptoBox.html">CryptoBox</a>.
</p>
<p>
<a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> shows some examples for local customizations of the <a href="CryptoBox.html">CryptoBox</a>.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

123
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevValidation.html
View file

@ -29,62 +29,83 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevValidation.html#Overview">Overview</a></li>
<li> <li><a href="CryptoBoxDevValidation.html#Validate">Validate</a></li>
<a href="#head-5e20146fd39363329427c6251209cccb8d374f3e">Overview</a> <li><a href="CryptoBoxDevValidation.html#Howtocreateatest">How to create a test</a></li>
</li> <li><a href="CryptoBoxDevValidation.html#Comments">Comments</a></li>
<li>
<a href="#head-6e1d416048c4d8ebfb5b3919b4d924c77e652a7b">Validate</a>
</li>
<li>
<a href="#head-5634566bd24f83d397b43525fc62685f6e678fbf">How to create a test</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
<h2 id="head-5e20146fd39363329427c6251209cccb8d374f3e">Overview</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>)
<p>The validation feature allows to check the programming logic of the <a href="CryptoBox.html">CryptoBox</a>. A lot of test cases are defined to test as many functions of the <a href="CryptoBox.html">CryptoBox</a> as possible. </p> </p>
<p>The requests are processed with <a class="external" href="http://curl.haxx.se/">curl</a>. </p> <hr />
<p>The received web page is saved to allow a later design review or css debugging. </p> <h1 id="ValidationoftheCryptoBox">Validation of the CryptoBox</h1>
<p>The current state of the <a href="CryptoBox.html">CryptoBox</a> is represented by ten single values (e.g.: <em>box is configured</em>, <em>IP of the box</em>, <em>current language setting</em>, ...), which are invisibly a part of each html page (as comments). The returned status of every request is compared to the predicted value of the test case. </p> <h2 id="Overview">Overview</h2>
<p>Similar test cases are pooled into test groups (e.g.: <em>initialization</em>, <em>configuration</em> and <em>mounting</em>). </p> <p>
The validation feature helps you to check the programming logic of the <a href="CryptoBox.html">CryptoBox</a>. A lot of test cases are defined to verify as many functions of the <a href="CryptoBox.html">CryptoBox</a> as possible.
<h2 id="head-6e1d416048c4d8ebfb5b3919b4d924c77e652a7b">Validate</h2> </p>
<p>
<p>Run <tt>scripts/validate.sh&nbsp;check_all</tt> to conduct all tests of all groups. See <tt>scripts/validate.sh&nbsp;help</tt> for other actions. </p> The requests are processed with <a class="ext-link" title="http://curl.haxx.se/" href="http://curl.haxx.se/">curl</a>.
<p>The results will be saved in <em>validation/report</em>. </p> </p>
<p>In addition to every single retrieved page, a html page called <em>summary.html</em> is created, which contains the state checks of all tests in a group. </p> <p>
The received web page is saved to allow a later design review or css debugging.
<h2 id="head-5634566bd24f83d397b43525fc62685f6e678fbf">How to create a test</h2> </p>
<p>
<p>All test cases can be found in <em>validation/test-cases</em>. </p> The current state of the <a href="CryptoBox.html">CryptoBox</a> is represented by ten single values (e.g.: <i>box is configured</i>, <i>IP of the box</i>, <i>current language setting</i>, ...), which are invisibly a part of each html page (as comments). The returned status of every request is compared to the predicted value of the test case.
<p>Every test consists of: </p> </p>
<dl> <p>
<dt>input.curl</dt> Similar test cases are pooled into test groups (e.g.: <i>initialization</i>, <i>configuration</i> and <i>mounting</i>).
<dd><p>the configuration file for the <em>curl</em> request </p> </p>
</dd> <h2 id="Validate">Validate</h2>
<dt>output</dt> <p>
<dd><p>the predicted state of the <a href="CryptoBox.html">CryptoBox</a> after the call </p> Run <i><a href="/trac/cryptobox/browser/trunk/scripts/validate.sh">scripts/validate.sh</a>]</i> to conduct all tests of all groups. See <i>scripts/validate.sh help</i> for other actions.
</dd> </p>
<dt>description</dt> <p>
<dd><p>a short description of the test (will be used for the summary) </p> The results will be saved in <i>validation/report</i>.
</dd> </p>
<dt>delay</dt> <p>
<dd><p>[optional] time to wait after this test </p> In addition to every single retrieved page, a html page called <i>summary-?.html</i> is created, which contains the state checks of all tests in a group.
</dd> </p>
</dl> <h2 id="Howtocreateatest">How to create a test</h2>
<p>Use the existing test cases as templates for new tests. </p> <p>
<p>Any logical path of the web interface CGI should be validated by a test case. </p> All test cases can be found in <i>validation/test-cases</i>.
</p>
<p>
Every test consists of the following files:
</p>
<table class="wiki">
<tr><td>input.curl</td><td>the configuration file for the <i>curl</i> request
</td></tr><tr><td>output</td><td>the predicted state of the <a href="CryptoBox.html">CryptoBox</a> after the call
</td></tr><tr><td>description</td><td>a short description of the test (will be used for the summary)
</td></tr><tr><td>delay</td><td>[optional] time to wait after this test
</td></tr></table>
<p>
Use the existing test cases as templates for new tests.
</p>
<p>
Read <a href="/trac/cryptobox/browser/trunk/validation/test-cases/README">validation/test-cases/README</a> for details.
</p>
<p>
Every logical path of the web interface CGI should be validated by a test case.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

284
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevWorkFlow.html
View file

@ -29,150 +29,156 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxDevWorkFlow.html#Preparations">Preparations</a></li>
<li> <li><a href="CryptoBoxDevWorkFlow.html#CreateaCryptoBoxLiveCD">Create a CryptoBox-LiveCD</a></li>
<a href="#head-adacf7a8271d3f6fe8bdfb9773ac3b1f4b050f9a">Preparations</a> <ol><li><a href="CryptoBoxDevWorkFlow.html#Buildthebasesystem">Build the base system</a></li>
</li> <li><a href="CryptoBoxDevWorkFlow.html#Configurethebaseimage">Configure the base image</a></li>
<li><a href="CryptoBoxDevWorkFlow.html#Removedevelopmentfeatures">Remove development features</a></li>
<li> <li><a href="CryptoBoxDevWorkFlow.html#Createanisoimage">Create an iso image</a></li>
<a href="#head-61cec4152bb64ed5799ae7422f7150a4e3bc4860">Create a CryptoBox-LiveCD - step by step</a> <li><a href="CryptoBoxDevWorkFlow.html#BurntheCD">Burn the CD</a></li>
<ol> </ol><li><a href="CryptoBoxDevWorkFlow.html#TesttheCryptoBoxLiveCD">Test the CryptoBox-LiveCD</a></li>
<ol><li><a href="CryptoBoxDevWorkFlow.html#Chrootquickampdirtytests">Chroot: quick &amp; dirty tests</a></li>
<li> <li><a href="CryptoBoxDevWorkFlow.html#Qemunearlycompleteemulation">Qemu: nearly complete emulation</a></li>
<a href="#head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</a> </ol><li><a href="CryptoBoxDevWorkFlow.html#Debuggingandmerging">Debugging and merging</a></li>
</li> <ol><li><a href="CryptoBoxDevWorkFlow.html#Developmentonarunningsystem">Development on a running system</a></li>
<li><a href="CryptoBoxDevWorkFlow.html#Uploadinganewrelease">Uploading a new release</a></li>
<li> </ol><li><a href="CryptoBoxDevWorkFlow.html#Comments">Comments</a></li>
<a href="#head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</a>
</li>
<li>
<a href="#head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</a>
</li>
<li>
<a href="#head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</a>
</li>
<li>
<a href="#head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</a>
</li>
</ol> </ol>
</div>
<li> </p>
<a href="#head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</a> <p>
<ol> <strong>Navigation:</strong> ( <a href="CryptoBoxDev.html">CryptoBoxDev</a>, <a href="CryptoBoxDevCustomConfigure.html">CryptoBoxDevCustomConfigure</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevPreparation">CryptoBoxDevPreparation</a>)
<li> </p>
<a href="#head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick &amp; dirty tests</a> <hr />
</li> <h1 id="Developmentworkflow">Development workflow</h1>
<h2 id="Preparations">Preparations</h2>
<li> <p>
<a href="#head-2278b94f0a24871a501d80c4e6e0c53d1f5621ca">Qemu: nearly complete emulation</a> You should have completed the steps described in <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>.
</li> </p>
<h2 id="CreateaCryptoBoxLiveCD">Create a CryptoBox-LiveCD</h2>
</ol> <p>
The following steps can be executed in the order of their appearance.
<li> </p>
<a href="#head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</a> <p>
<ol> Usually there is no need to repeat the whole process, after you changed some parts of the <a href="CryptoBox.html">CryptoBox</a>. Especially the first step (building of the base system with <i>dfsbuild</i>) may usually be skipped.
</p>
<li> <p>
<a href="#head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</a> Every step of the building process must be executed as <i>root</i>.
</li> </p>
<h3 id="Buildthebasesystem">Build the base system</h3>
<li> <p>
<a href="#head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</a> Run <i>scripts/cbox-build.sh dfsbuild</i> to create the base system for the LiveCD.
</li> </p>
<p>
</ol> The result can be found in <i>_builddir/cd1/image</i>.
</p>
</li> <p>
If you do not want to use the <i><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a> to save bandwidth and time, then you should modify the </i>mirror<i>-setting in <a href="/trac/cryptobox/browser/trunk/etc-default.d/dfs-cbox.conf">dfs-cbox.conf</a> (see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details).</i>
</ol> </p>
<p> </p> <h3 id="Configurethebaseimage">Configure the base image</h3>
<hr> <p>
<p> </p> Run <i>scripts/cbox-build.sh config</i> to copy the CryptoBox-specific files to the base image.
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p> </p>
<p>
<h2 id="head-adacf7a8271d3f6fe8bdfb9773ac3b1f4b050f9a">Preparations</h2> TODO: link to cbox-build.sh-manpage
</p>
<p>You should have completed the steps described in <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>. </p> <h3 id="Removedevelopmentfeatures">Remove development features</h3>
<p>
<h2 id="head-61cec4152bb64ed5799ae7422f7150a4e3bc4860">Create a CryptoBox-LiveCD - step by step</h2> The original base system, that was created by <i>dfsbuild</i> contains a lot packages and some scripts, that are only useful during development. You should remove them, as they cause severe security implications.
</p>
<p>The following steps can be executed in the order of their appearance. </p> <p>
<p>Usually there is no need to repeat the whole process, after you changed some parts of the <a href="CryptoBox.html">CryptoBox</a>. Especially the first step (building of the base system with <em>dfsbuild</em>) may usually be skipped. </p> To reduce the CryptoBox-LiveCD to the usable minimum for operational use, you should run <i>scripts/cbox-build.sh harden</i>.
<p>Every step of the building process must be executed as <em>root</em>. </p> </p>
<h3 id="Createanisoimage">Create an iso image</h3>
<h3 id="head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</h3> <p>
To burn a CryptoBox-LiveCD, you need an bootable <i>iso9660</i>-image.
<p>Run <tt>scripts/cbox-build.sh&nbsp;dfsbuild</tt> to create the base system for the LiveCD. </p> </p>
<p>The result can be found in <em>_builddir/cd1/image</em>. </p> <p>
<p>If you do not want to use the <em><a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;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 <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details). </p> Create the <i>iso</i> image with <i>scripts/cbox-build.sh iso</i>. The resulting file can be found at <i>_builddir/cd1/cryptobox.iso</i>.
</p>
<h3 id="head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</h3> <h3 id="BurntheCD">Burn the CD</h3>
<p>
<p>Run <tt>scripts/cbox-build.sh&nbsp;config</tt> to copy the <a href="CryptoBox.html">CryptoBox</a>-specific files to the base image. </p> Do it manually:
<p>TODO: link to cbox-build.sh-manpage </p> </p>
<pre class="wiki">cdrecord -v dev=0,0,0 _builddir/cryptobox.iso
<h3 id="head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</h3> </pre><p>
(change the <i>dev</i> setting according to your setup).
<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>
<p>To reduce the <a href="CryptoBox.html">CryptoBox</a>-LiveCD to the usable minimum for operational use, you should run <tt>scripts/cbox-build.sh&nbsp;harden</tt>. </p> <p>
Let the script do it for you: <i>scripts/cbox-build.sh burn</i> (maybe you have to change the <i>CDWRITER</i> setting in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/cbox-dev.conf">cbox-dev.conf</a> - see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a>).
<h3 id="head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</h3> </p>
<p>
<p>To burn a <a href="CryptoBox.html">CryptoBox</a>-LiveCD, you need an bootable <em>iso9660</em>-image. </p> Of course, it is not wise to use CD-R media. CD-RW consume less resources.
<p>Create the <em>iso</em> image with <tt>scripts/cbox-build.sh&nbsp;iso</tt>. The resulting file can be found at <em>_builddir/cd1/cryptobox.iso</em>. </p> </p>
<h2 id="TesttheCryptoBoxLiveCD">Test the CryptoBox-LiveCD</h2>
<h3 id="head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</h3> <p>
This section is only useful for developers, who want to improve or change the <a href="CryptoBox.html">CryptoBox</a> system.
<p>Do it manually: <tt>cdrecord&nbsp;-v&nbsp;dev=0,0,0&nbsp;_builddir/cd1/cryptobox.iso</tt> (change the <em>dev</em> setting according to your setup). </p> </p>
<p>Let the script do it for you: <tt>scripts/cbox-build.sh&nbsp;burn</tt> (maybe you have to change the <em>CDWRITER</em> setting in <em>cbox-dev.conf</em> - see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a>). </p> <h3 id="Chrootquickampdirtytests">Chroot: quick &amp; dirty tests</h3>
<p>Of course, it is not wise to use CD-R media. CD-RW consume less resources. </p> <p>
If you modified the <i>perl</i>- or <i>shell</i>-scripts of the <a href="CryptoBox.html">CryptoBox</a>, then you can check for syntax errors by running them in a <i>chroot</i> environment. Be careful: you have access to all ressources of your computer, while you are working within a <i>chroot</i> environment - so you can easily repartition your real disk ...
<h2 id="head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</h2> </p>
<p>
<p>This section is only useful for developers, who want to improve or change the <a href="CryptoBox.html">CryptoBox</a> system. </p> To start a <i>chroot</i> environment, you can execute <i>scripts/cbox-dev.sh chroot</i>.
</p>
<h3 id="head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick &amp; dirty tests</h3> <p>
For more intensive tests, you may use <i>qemu</i> (see below) or burn real LiveCDs - of course this would take much more time.
<p>If you modified the <em>perl</em>- or <em>shell</em>-scripts of the <a href="CryptoBox.html">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>
<p>To start a <em>chroot</em> environment, you can execute <tt>scripts/cbox-dev.sh&nbsp;chroot</tt>. </p> <h3 id="Qemunearlycompleteemulation">Qemu: nearly complete emulation</h3>
<p>For more intensive tests, you may use <em>qemu</em> (see below) or burn real LiveCDs - of course this would take much more time. </p> <p>
The processor emulator <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu" href="http://fabrice.bellard.free.fr/qemu">qemu</a> allows you test the <a href="CryptoBox.html">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.
<h3 id="head-2278b94f0a24871a501d80c4e6e0c53d1f5621ca">Qemu: nearly complete emulation</h3> </p>
<p>
<p>The processor emulator <a class="external" href="http://fabrice.bellard.free.fr/qemu">qemu</a> allows you test the <a href="CryptoBox.html">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> Beware - there are some problems, when using <i>qemu</i>:
<p>Beware - there are some problems, when using <em>qemu</em>: </p> </p>
<ul> <ul><li><i>smbd</i> does not start (segfault)
<li><p> <em>smbd</em> does not start (segfault) </p> </li><li>???
</li> </li></ul><p>
<li><p> ??? </p> To start a <i>qemu</i> emulation of the <i>iso</i> image, you may type:
</li> </p>
</ul> <pre class="wiki">scripts/cbox-dev.sh qemu
<p>To start a <em>qemu</em> emulation of the <em>iso</em> image, you may type: <tt>scripts/cbox-dev.sh&nbsp;qemu</tt>. </p> </pre><h2 id="Debuggingandmerging">Debugging and merging</h2>
<p>
<h2 id="head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</h2> This section is only useful for developers, who want to develop on a running <a href="CryptoBox.html">CryptoBox</a> system (emulated or real).
</p>
<p>This section is only useful for developers, who want to develop on a running <a href="CryptoBox.html">CryptoBox</a> system (emulated or real). </p> <p>
<p>You may access the <a href="CryptoBox.html">CryptoBox</a> directly or you can use <em>ssh</em> to open a remote session (<tt>./cbox-dev.sh&nbsp;ssh</tt>). </p> You may access the <a href="CryptoBox.html">CryptoBox</a> directly or you can use <i>ssh</i> to open a remote session:
</p>
<h3 id="head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</h3> <pre class="wiki">./cbox-dev.sh ssh
</pre><h3 id="Developmentonarunningsystem">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>
<p>Type <tt>scripts/cbox-dev.sh&nbsp;diff</tt> to see the changes, you made on the running <a href="CryptoBox.html">CryptoBox</a> system. </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>Type <tt>scripts/cbox-dev.sh&nbsp;merge</tt> to merge these changes to your local working copy. </p> </p>
<p>
<h3 id="head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</h3> Type <i>scripts/cbox-dev.sh diff</i> to see the changes, you made on the running <a href="CryptoBox.html">CryptoBox</a> system.
</p>
<p>Alternatively you may also upload a new version of your local working copy to the running <a href="CryptoBox.html">CryptoBox</a> system. </p> <p>
<p>Type <tt>scripts/cbox-dev.sh&nbsp;upload</tt> - beware: all recent changes you made to the running <a href="CryptoBox.html">CryptoBox</a> system, are lost. </p> Type <i>scripts/cbox-dev.sh merge</i> to merge these changes to your local working copy.
</p>
<h3 id="Uploadinganewrelease">Uploading a new release</h3>
<p>
Alternatively you may also upload a new version of your local working copy to the running <a href="CryptoBox.html">CryptoBox</a> system.
</p>
<p>
Type <i>scripts/cbox-dev.sh upload</i> - beware: all recent changes you made to the running <a href="CryptoBox.html">CryptoBox</a> system, are lost.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

82
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxUser.html
View file

@ -29,41 +29,65 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxUserGettingStarted.html#Gettingstarted">Getting started</a></li>
<li> <ol><li><a href="CryptoBoxUserGettingStarted.html#FirstSteps">First Steps</a></li>
<a href="#head-2f352729b48ed53caaf36d4f8be5585dba2d80b9">User Documentation</a> <li><a href="CryptoBoxUserGettingStarted.html#HintsCaveats">Hints / Caveats</a></li>
</li> <li><a href="CryptoBoxUserGettingStarted.html#Comments">Comments</a></li>
<li>
<a href="#head-2bdb4da4b459f842d64fcdbdc79ab3d6383f1407">Questions</a>
</li>
</ol> </ol>
<p> </p> <li><a href="CryptoBoxUserConfiguration.html#ConfigurationofyourCryptoBox">Configuration of your CryptoBox</a></li>
<hr> <ol><li><a href="CryptoBoxUserConfiguration.html#Overview">Overview</a></li>
<p> </p> <li><a href="CryptoBoxUserConfiguration.html#Foreword">Foreword</a></li>
<li><a href="CryptoBoxUserConfiguration.html#Initialization">Initialization</a></li>
<h2 id="head-2f352729b48ed53caaf36d4f8be5585dba2d80b9">User Documentation</h2> <li><a href="CryptoBoxUserConfiguration.html#Configuration">Configuration</a></li>
<li><a href="CryptoBoxUserConfiguration.html#HintsCaveats">Hints / Caveats</a></li>
<p>The following pages describe the easy use of the <a href="CryptoBox.html">CryptoBox</a>. </p> <li><a href="CryptoBoxUserConfiguration.html#Comments">Comments</a></li>
<p>The online version of this manual is a wiki, which means you can edit the pages. So if you have a question or some description is unclear, please post it on the bottom of the relevant page. The developers will answer your questions and update the manual as fast as possible. This way you can contribute in making the <a href="CryptoBox.html">CryptoBox</a> a better experience for everyone! </p>
<ol type="1">
<li><p><a href="CryptoBoxUserGettingStarted.html">CryptoBoxUserGettingStarted/en</a> -- first steps to get the Cryptobox up and running </p>
</li>
<li><p><a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration/en</a> -- configure the details of your new encrypted fileserver </p>
</li>
<li><p><a href="CryptoBoxUserDailyUse.html">CryptoBoxUserDailyUse/en</a> -- daily use of your <a href="CryptoBox.html">CryptoBox</a> </p>
</li>
</ol> </ol>
<p>The online version of this manual can be found at <a href="https://systemausfall.org/toolforge/CryptoBoxUser/en">https://systemausfall.org/toolforge/CryptoBoxUser/en</a>. </p> <li><a href="CryptoBoxUserDailyUse.html#DailyuseoftheCryptoBox">Daily use of the CryptoBox</a></li>
<hr> <ol><li><a href="CryptoBoxUserDailyUse.html#Activateyourencryptedfilesystem">Activate your encrypted filesystem</a></li>
<p> </p> <li><a href="CryptoBoxUserDailyUse.html#Useyourencrypteddata">Use your encrypted data</a></li>
<li><a href="CryptoBoxUserDailyUse.html#Deactivateyourencryptedfilesystem">Deactivate your encrypted filesystem</a></li>
<li><a href="CryptoBoxUserDailyUse.html#ShutdownyourCryptoBox">Shut down your CryptoBox</a></li>
<li><a href="CryptoBoxUserDailyUse.html#Incaseofemergency">In case of emergency</a></li>
<li><a href="CryptoBoxUserDailyUse.html#QuestionsandAnswers">Questions and Answers</a></li>
<li><a href="CryptoBoxUserDailyUse.html#Comments">Comments</a></li>
</ol>
</ol>
</div>
<h2 id="head-2bdb4da4b459f842d64fcdbdc79ab3d6383f1407">Questions</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBox.html">CryptoBox/en</a>, <a href="CryptoBoxUser.html">CryptoBoxUser</a>)
</p>
<hr />
<h1 id="UserDocumentation">User Documentation</h1>
<p>
The following pages describe the easy use of the <a href="CryptoBox.html">CryptoBox</a>.
</p>
<p>
The online version of this manual is a wiki, which means you can edit the pages. So if you have a question or you perceive a description as unclear, please post it on the bottom of the relevant page. The developers will answer your questions and update the manual as fast as possible. This way you can contribute in making the <a href="CryptoBox.html">CryptoBox</a> a better experience for everyone!
</p>
<ol><li><a href="CryptoBoxUserGettingStarted.html">CryptoBoxUserGettingStarted</a> -- first steps to get the Cryptobox up and running
</li><li><a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration</a> -- configure the details of your new encrypted fileserver
</li><li><a href="CryptoBoxUserDailyUse.html">CryptoBoxUserDailyUse</a> -- daily use of your <a href="CryptoBox.html">CryptoBox</a>
</li></ol><p>
The online version of this manual can be found at <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/en" href="https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/en">https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/en</a>.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

213
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxUserConfiguration.html
View file

@ -29,127 +29,108 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxUserConfiguration.html#Overview">Overview</a></li>
<li> <li><a href="CryptoBoxUserConfiguration.html#Foreword">Foreword</a></li>
<a href="#head-b2e3c3d21cefdfa1346c517ec63c0c6652fba1d1">Overview</a> <li><a href="CryptoBoxUserConfiguration.html#Initialization">Initialization</a></li>
</li> <li><a href="CryptoBoxUserConfiguration.html#Configuration">Configuration</a></li>
<li><a href="CryptoBoxUserConfiguration.html#HintsCaveats">Hints / Caveats</a></li>
<li> <li><a href="CryptoBoxUserConfiguration.html#Comments">Comments</a></li>
<a href="#head-4244ebf306514fe0aba321b9bb92e70375af2d1f">Foreword</a>
</li>
<li>
<a href="#head-8853498a529036ba37e953d7ae99abb1c1da0113">Initialization</a>
</li>
<li>
<a href="#head-e1f6e8110136eced7bad4ae25232673890122d13">Configuration</a>
</li>
<li>
<a href="#head-dedf1b3f76a999c13b50d08148caa0f7a6ff959b">Hints / Caveats</a>
</li>
<li>
<a href="#head-e9e68aaf6182c3b5a9835f771916238c74d0cc33">Questions</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-b2e3c3d21cefdfa1346c517ec63c0c6652fba1d1">Overview</h2> </p>
<p>
<p>All parts of administration of the <a href="CryptoBox.html">CryptoBox</a> are done through a comfortable web interface. If this is the first time you use the <a href="CryptoBox.html">CryptoBox</a>, just follow the steps below. </p> <strong>Navigation:</strong> ( <a href="CryptoBoxUser.html">CryptoBoxUser/en</a>, <a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration</a>)
<p>You can safely ignore the <em>Foreword</em> if you're in a hurry. </p>
<p><em>Initialization</em> describes the process of integrating a new harddisk. You usually have to perform this steps if you start with a new <a href="CryptoBox.html">CryptoBox</a> or after changing the harddisk. </p>
<p>In the <em>Configuration</em> section, you can configure the <a href="CryptoBox.html">CryptoBox</a> according to your personal needs, e.g. change your desired language for the web interface or change the IP address of the <a href="CryptoBox.html">CryptoBox</a>. </p>
<p>Don't forget to read the <em>Hints / Caveats</em> section too. </p>
<h2 id="head-4244ebf306514fe0aba321b9bb92e70375af2d1f">Foreword</h2>
<p>Okay, you finished the <a href="CryptoBoxUserGettingStarted.html">CryptoBoxUserGettingStarted/en</a> and are now sitting in front of a computer that is connected via network with your <a href="CryptoBox.html">CryptoBox</a>. You point a browser to "<a href="https://192.168.0.23">https://192.168.0.23</a>" and the <a href="CryptoBox.html">CryptoBox</a> interface appears. </p>
<p>Before you can save data on your <a href="CryptoBox.html">CryptoBox</a>, its harddisk has to be formatted with a cryptographic filesystem. Sounds complicated but don't be scared - it's really a "one click" thing. <img src="../../../var/www/cryptobox-img/smile.png" alt=":)" height="15" width="15"> </p>
<h2 id="head-8853498a529036ba37e953d7ae99abb1c1da0113">Initialization</h2>
<p>Click on <em>Initialize <a href="CryptoBox.html">CryptoBox</a></em> in the title bar. </p>
<p>Now you are promted to enter two passwords twice (because we want to train your typing skills ;). </p>
<ul>
<li><p> The first password is the <em>administration password</em>. </p>
<ul>
<li><p> It is used to protect the configuration of the <a href="CryptoBox.html">CryptoBox</a>. </p>
</li>
<li><p> This is necessary to make sure, that no one without your permission can destroy your data by re-initializing the <a href="CryptoBox.html">CryptoBox</a>. </p>
</li>
<li><p> Chances are good, that you will only need it once. </p>
</li>
<li><p> You may leave it empty, but this is not recommended. </p>
</li>
</ul>
</li>
<li><p> The <em>crypto password</em> is the more important password, protecting the data on your harddisk. Choose it wisely! </p>
<ul>
<li><p> You will need it, whenever you want to access your encrypted data. </p>
</li>
<li><p> For a secure password consider a length of at least 15 characters including digits and special characters. The security of your encrypted data stands or falls with a good password. </p>
</li>
</ul>
</li>
<li><p> To avoid mistakes and to remind you on what you're going to do, you have to type the displayed red phrase into the last field. </p>
</li>
<li><p> Now you can complete the initialization by clicking on the <em>Initialize CryptoBox</em> button at the bottom of the form. </p>
</li>
</ul>
<p>That's all. Wasn't it a real "one click" thing? Cryptography has never been easier to use. <img src="../../../var/www/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
<p>The initialization process takes place in the background and will be completed after a few minutes, depending on your harddisk's size. </p>
<h2 id="head-e1f6e8110136eced7bad4ae25232673890122d13">Configuration</h2>
<p>While the initialization is usually done only once, the configuration can be changed at any time you want. You can reach it by clicking at <em>Configuration</em> in the menu bar of the website. Now you see a form with four fields: </p>
<ul>
<li><p> If you defined a administration passwort during <em>Initialization</em>, you have to enter it first. Otherwise this field does not appear. </p>
</li>
<li><p> If the default network address (IP) doesn't fit into your network infrastructure, you can change it in the second field. </p>
</li>
<li><p> The timeout defines the amount of time (in minutes) after that the <a href="CryptoBox.html">CryptoBox</a> deactivates the access to the encrypted data. If you e.g. copy a file on the box, it starts counting at zero, so down-/uploads won't be interrupted. </p>
<ul>
<li><p> It's good choice to enter a small number (few minutes). </p>
</li>
<li><p> A timeout of <em>0</em> turns off the automatic deactivation - this is not recommended. </p>
</li>
</ul>
</li>
<li><p> At <em>language preferences</em> you can select the default language for the <a href="CryptoBox.html">CryptoBox</a> interface. </p>
</li>
</ul>
<p>Complete your changes by clicking on <em>Save configuration</em>. </p>
<p>That's all - your <a href="CryptoBox.html">CryptoBox</a> is now ready for <a href="CryptoBoxUserDailyUse.html">daily use</a>! </p>
<h2 id="head-dedf1b3f76a999c13b50d08148caa0f7a6ff959b">Hints / Caveats</h2>
<ul>
<li><p> All data on the <a href="CryptoBox.html">CryptoBox</a> harddisk will be erased during <em>Initialization</em>. </p>
</li>
<li><p> All passwords have to be typed twice to reduce the chance of a typo. </p>
</li>
<li><p> The optional adminstration password is necessary for configuration only. </p>
</li>
<li><p> The crypto password protects your beloved data. </p>
</li>
<li><p> If the cryptobox is not reachable by browsing to 192.168.0.23, you may have to adjust the network settings of your computer for initialization of the <a href="CryptoBox.html">CryptoBox</a>. </p>
</li>
</ul>
<p><em>back to <a href="CryptoBoxUser.html">CryptoBoxUser/en</a></em> </p>
<hr>
<p> </p>
<h2 id="head-e9e68aaf6182c3b5a9835f771916238c74d0cc33">Questions</h2>
</p>
<hr />
<h1 id="ConfigurationofyourCryptoBox">Configuration of your CryptoBox</h1>
<h2 id="Overview">Overview</h2>
<p>
All parts of administration of the <a href="CryptoBox.html">CryptoBox</a> are done through a comfortable web interface. If this is the first time you use the <a href="CryptoBox.html">CryptoBox</a>, just follow the steps below.
</p>
<p>
You can safely ignore the <a href="CryptoBoxUserConfiguration.html#Foreword">Foreword</a> if you are in a hurry.
</p>
<p>
<a href="CryptoBoxUserConfiguration.html#Initialization">Initialization</a> describes the process of integrating a new harddisk. You usually have to perform this steps if you start with a new <a href="CryptoBox.html">CryptoBox</a> or after replacing the harddisk.
</p>
<p>
In the <a href="CryptoBoxUserConfiguration.html#Configuration">Configuration</a> section, you can configure the <a href="CryptoBox.html">CryptoBox</a> according to your personal needs, e.g. change your desired language for the web interface or change the IP address of the <a href="CryptoBox.html">CryptoBox</a>.
</p>
<p>
Do not forget to read the <a href="CryptoBoxUserConfiguration.html#HintsCaveats">Hints / Caveats</a> section too.
</p>
<h2 id="Foreword">Foreword</h2>
<p>
Okay, you finished the <a href="CryptoBoxUserGettingStarted.html">CryptoBoxUserGettingStarted</a> and are now sitting in front of a computer that is connected via network with your <a href="CryptoBox.html">CryptoBox</a>. You point a browser to &#34;<a class="ext-link" title="https://192.168.0.23&#34;" href="https://192.168.0.23&#34;">https://192.168.0.23&#34;</a> and the <a href="CryptoBox.html">CryptoBox</a> interface appears.
</p>
<p>
Before you can save data on your <a href="CryptoBox.html">CryptoBox</a>, its harddisk has to be formatted with a cryptographic filesystem. Sounds complicated but don't be scared - it's really a &#34;one click&#34; thing. :)
</p>
<h2 id="Initialization">Initialization</h2>
<p>
Click on <i>Initialize CryptoBox</i> in the title bar.
</p>
<p>
Now you are promted to enter two passwords twice (because we want to train your typing skills ;).
</p>
<ul><li>The first password is the <i>administration password</i>.
<ul><li>It is used to protect the configuration of the <a href="CryptoBox.html">CryptoBox</a>.
</li><li>This is necessary to make sure, that no one without your permission can destroy your data by re-initializing the <a href="CryptoBox.html">CryptoBox</a>.
</li><li>Chances are good, that you will only need it once.
</li><li>You may leave it empty, but this is not recommended.
</li></ul></li><li>The <i>crypto password</i> is the more important password, protecting the data on your harddisk. Choose it wisely!
<ul><li>You will need it, whenever you want to access your encrypted data.
</li><li>For a secure password consider a length of at least 15 characters including digits and special characters. The security of your encrypted data stands or falls with a good password.
</li></ul></li><li>To avoid mistakes and to remind you on what you're going to do, you have to type the displayed red phrase into the last field.
</li><li>Now you can complete the initialization by clicking on the <i>Initialize !CryptoBox</i> button at the bottom of the form.
</li></ul><p>
That's all. Wasn't it a real &#34;one click&#34; thing? Cryptography has never been easier to use. ;)
</p>
<p>
The initialization process takes place in the background and will be completed after a few minutes, depending on your harddisk's size.
</p>
<h2 id="Configuration">Configuration</h2>
<p>
While the initialization is usually done only once, the configuration can be changed at any time you want. You can reach it by clicking at <i>Configuration</i> in the menu bar of the website. Now you see a form with four fields:
</p>
<ul><li>If you defined a administration passwort during <i>Initialization</i>, you have to enter it first. Otherwise this field does not appear.
</li><li>If the default network address (IP) doesn't fit into your network infrastructure, you can change it in the second field.
</li><li>The timeout defines the amount of time (in minutes) after that the <a href="CryptoBox.html">CryptoBox</a> deactivates the access to the encrypted data. If you e.g. copy a file on the box, it starts counting at zero, so down-/uploads won't be interrupted.
</li><li>It's good choice to enter a small number (few minutes).
</li><li>A timeout of <i>0</i> turns off the automatic deactivation - this is not recommended.
</li><li>At <i>language preferences</i> you can select the default language for the <a href="CryptoBox.html">CryptoBox</a> interface.
</li></ul><p>
Complete your changes by clicking on <i>Save configuration</i>.
</p>
<p>
That's all - your <a href="CryptoBox.html">CryptoBox</a> is now ready for <a href="CryptoBoxUserDailyUse.html">daily use</a>!
</p>
<h2 id="HintsCaveats">Hints / Caveats</h2>
<ul><li>All data on the <a href="CryptoBox.html">CryptoBox</a> harddisk will be erased during <i>Initialization</i>.
</li><li>All passwords have to be typed twice to reduce the chance of a typo.
</li><li>The optional adminstration password is necessary for configuration only.
</li><li>The crypto password protects your beloved data.
</li><li>If the cryptobox is not reachable by browsing to 192.168.0.23, you may have to adjust the network settings of your computer for initialization of the <a href="CryptoBox.html">CryptoBox</a>.
</li></ul><p>
<i>back to <a href="CryptoBoxUser.html">CryptoBoxUser</a></i>
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

173
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxUserDailyUse.html
View file

@ -29,67 +29,128 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxUserDailyUse.html#Activateyourencryptedfilesystem">Activate your encrypted filesystem</a></li>
<li> <li><a href="CryptoBoxUserDailyUse.html#Useyourencrypteddata">Use your encrypted data</a></li>
<a href="#head-37a4d41cb3a9e26ce93c841fba0e8afd3367184b">Activate your encrypted filesystem</a> <li><a href="CryptoBoxUserDailyUse.html#Deactivateyourencryptedfilesystem">Deactivate your encrypted filesystem</a></li>
</li> <li><a href="CryptoBoxUserDailyUse.html#ShutdownyourCryptoBox">Shut down your CryptoBox</a></li>
<li><a href="CryptoBoxUserDailyUse.html#Incaseofemergency">In case of emergency</a></li>
<li> <li><a href="CryptoBoxUserDailyUse.html#QuestionsandAnswers">Questions and Answers</a></li>
<a href="#head-e0aa50e84f7fc78cc9e76ea1aabe9616a19d17ea">Deactivate your encrypted filesystem</a> <li><a href="CryptoBoxUserDailyUse.html#Comments">Comments</a></li>
</li>
<li>
<a href="#head-3a58ba4feb37b325aecffed0f0b9cd3048b4ad48">Shut down your CryptoBox</a>
</li>
<li>
<a href="#head-dbb28a79cc5518696d0396b48ff4cde9cba8c5e3">In case of emergency</a>
</li>
<li>
<a href="#head-758bec29ea474875d5aafeee97fff1465a79cbe4">Questions</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-37a4d41cb3a9e26ce93c841fba0e8afd3367184b">Activate your encrypted filesystem</h2> </p>
<p>
<p>You can activate your encrypted filesystem by doing following these steps: </p> <strong>Navigation:</strong> ( <a href="CryptoBoxUser.html">CryptoBoxUser/en</a>, <a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration/en</a>, <a href="/trac/cryptobox/wiki/CryptoBoxUserDailyUse">CryptoBoxUserDailyUse</a>)
<ul>
<li><p> Point your web browser at the address of your <a href="CryptoBox.html">CryptoBox</a>. The default is <a href="https://192.168.0.23">https://192.168.0.23</a>. </p>
</li>
<li><p> Click on <em>Activation of encrypted data</em>. A new page asking for your crypto password appears. </p>
</li>
<li><p> Enter your crypto password and click on the button below labeled <em>activate encrypted filesystem</em>. </p>
</li>
</ul>
<p>Now the filesystem is accessible. To use it, search for a computer in your network neighborhood. When asked for the name, enter the above IP address (default: 192.168.0.23). Now you can use it like any other network resource. </p>
<h2 id="head-e0aa50e84f7fc78cc9e76ea1aabe9616a19d17ea">Deactivate your encrypted filesystem</h2>
<p>You can deactivate the encrypted filesystem by clicking at <em>Deactivation of encrypted data</em> in the web interface of your <a href="CryptoBox.html">CryptoBox</a>. </p>
<p>Your data is now protected again. </p>
<h2 id="head-3a58ba4feb37b325aecffed0f0b9cd3048b4ad48">Shut down your CryptoBox</h2>
<p>Click at the <em>Shutdown</em> link in the menu of the web interface. There you can choose <em>poweroff</em> or <em>reboot</em>. The shutdown takes some seconds. </p>
<p>If the hardware of your <a href="CryptoBox.html">CryptoBox</a> is quite recent, it will power-off automatically. Otherwise you have to do it manually. </p>
<h2 id="head-dbb28a79cc5518696d0396b48ff4cde9cba8c5e3">In case of emergency</h2>
<p>If you have to protect the drive really fast, just power-off the <a href="CryptoBox.html">CryptoBox</a> machine instantly by pulling the plug or pushing the power button. This is not very clean and can (in very rare circumstances) corrupt open files, but it is the fasted method to secure your data. </p>
<p><em>back to <a href="CryptoBoxUser.html">CryptoBoxUser/en</a></em> </p>
<hr>
<p> </p>
<h2 id="head-758bec29ea474875d5aafeee97fff1465a79cbe4">Questions</h2>
</p>
<hr />
<h1 id="DailyuseoftheCryptoBox">Daily use of the CryptoBox</h1>
<h2 id="Activateyourencryptedfilesystem">Activate your encrypted filesystem</h2>
<p>
You can activate your encrypted filesystem by doing following these steps:
</p>
<ul><li>Point your web browser at the address of your <a href="CryptoBox.html">CryptoBox</a>. The default is <a class="ext-link" title="https://192.168.0.23" href="https://192.168.0.23">https://192.168.0.23</a>.
</li><li>Click on <i>Activation of encrypted data</i>. A new page asking for your crypto password appears.
</li><li>Enter your crypto password and click on the button below labeled <i>activate encrypted filesystem</i>.
</li></ul><p>
Now the filesystem is accessible. To use it, search for a computer in your network neighborhood. When asked for the name, enter the above IP address (default: 192.168.0.23). Now you can use it like any other network resource.
</p>
<h2 id="Useyourencrypteddata">Use your encrypted data</h2>
<h3 id="Linuxcommandline">Linux - command line</h3>
<p>
To use the encrypted data partition with regular user rights add the line below to your <i>/etc/fstab</i>:
</p>
<pre class="wiki">//192.168.0.23/public /mnt/ smbfs defaults,noexec,noauto,user,guest 0 0
</pre><p>
Now you can mount the encrypted data partition to /mnt:
</p>
<pre class="wiki">mount /mnt
</pre><p>
resp. unmount:
</p>
<pre class="wiki">smbumount /mnt
</pre><h3 id="Windows">Windows</h3>
<p>
Run the the Windows Explorer and choose <i>Map network drive</i> in the <i>Tools</i> menu:
</p>
<ul><li>select a drive of your choice
</li><li>enter <i>\\192.168.0.23\public</i> (default setting) as target
</li></ul><p>
<a href='../../../var/www/cryptobox-img/screenshots/en_w98_network_drive.png' style='padding:0; border:none'><img src='../../../var/www/cryptobox-img/screenshots/en_w98_network_drive.png?format=raw' alt="en_w98_network_drive.png" title="en_w98_network_drive.png" style="" /></a>
</p>
<p>
Now you can use your encrypted data like any other network resource.
</p>
<h2 id="Deactivateyourencryptedfilesystem">Deactivate your encrypted filesystem</h2>
<p>
You can deactivate the encrypted filesystem by clicking at <i>Deactivation of encrypted data</i> in the web interface of your <a href="CryptoBox.html">CryptoBox</a>.
</p>
<p>
Your data is now protected again.
</p>
<h2 id="ShutdownyourCryptoBox">Shut down your CryptoBox</h2>
<p>
Click at the <i>Shutdown</i> link in the menu of the web interface. There you can choose <i>poweroff</i> or <i>reboot</i>. The shutdown takes some seconds.
</p>
<p>
If the hardware of your <a href="CryptoBox.html">CryptoBox</a> is quite recent, it will power-off automatically. Otherwise you have to do it manually.
</p>
<h2 id="Incaseofemergency">In case of emergency</h2>
<p>
If you have to protect the drive really fast, just power-off the <a href="CryptoBox.html">CryptoBox</a> machine instantly by pulling the plug or pushing the power button. This is not very clean and can (in very rare circumstances) corrupt open files, but it is the fasted method to secure your data.
</p>
<p>
<i>back to <a href="CryptoBoxUser.html">CryptoBoxUser</a></i>
</p>
<hr />
<h2 id="QuestionsandAnswers">Questions and Answers</h2>
<h3 id="Windowsnetworkdrivecannotbemapped">Windows: network drive cannot be mapped</h3>
<p>
<a href='../../../var/www/cryptobox-img/screenshots/en_w98_not_logged_in.png' style='padding:0; border:none'><img src='../../../var/www/cryptobox-img/screenshots/en_w98_not_logged_in.png?format=raw' alt="en_w98_not_logged_in.png" title="en_w98_not_logged_in.png" style="" /></a>
</p>
<p>
This error message may appear, if you did not login during the booting of you windows machine (or you closed the login dialog by pressing ESC).
</p>
<p>
<strong>Solution:</strong> Choose <i>Logout</i> in the <i>Start</i> menu and login again.
</p>
<p>
<a href='../../../var/www/cryptobox-img/screenshots/en_w98_login.png' style='padding:0; border:none'><img src='../../../var/www/cryptobox-img/screenshots/en_w98_login.png?format=raw' alt="en_w98_login.png" title="en_w98_login.png" style="" /></a>
</p>
<h3 id="Linuxonlyrootcanunmount192168023public">Linux: only root can unmount //192.168.0.23/public</h3>
<p>
You can't unmount the partition with <i>umount</i>.
</p>
<p>
<strong>Solution:</strong> Use <i>smbumount</i> instead:
</p>
<pre class="wiki">smbumount /mnt
</pre><h3 id="LinuxOperationnotpermittedsmbmntfailed1">Linux: Operation not permitted / smbmnt failed: 1</h3>
<p>
The attempt to mount the partition as a regular user ends up with:
</p>
<pre class="wiki">cannot mount on /mnt/: Operation not permitted
smbmnt failed: 1
</pre><p>
<strong>Solution:</strong> Set the directory's owner to the same user that mounts the share (e.g. phil):
</p>
<pre class="wiki">chown phil. /mnt
</pre><hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

121
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxUserGettingStarted.html
View file

@ -29,78 +29,69 @@
<div id="doc"> <div id="doc">
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="CryptoBoxUserGettingStarted.html#FirstSteps">First Steps</a></li>
<li> <li><a href="CryptoBoxUserGettingStarted.html#HintsCaveats">Hints / Caveats</a></li>
<a href="#head-059e26ee46182561a1c7e35e1a1ab2bf8a7a27ac">First Steps</a> <li><a href="CryptoBoxUserGettingStarted.html#Comments">Comments</a></li>
</li>
<li>
<a href="#head-f205f691abc70f7d2c60001ef96f32f544017295">Hints / Caveats</a>
</li>
<li>
<a href="#head-237d3c26a42096a88e84db8c4f6d8923df1c2899">Questions</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-059e26ee46182561a1c7e35e1a1ab2bf8a7a27ac">First Steps</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="CryptoBoxUser.html">CryptoBoxUser/en</a>, <a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration/en</a>, <a href="/trac/cryptobox/wiki/CryptoBoxUserGettingStarted">CryptoBoxUserGettingStarted</a>)
<p>Getting the <a href="CryptoBox.html">CryptoBox</a> started doesn't take much: </p> </p>
<ol type="1"> <hr />
<li><p>You need an old Computer (at least 100MHz, 48MB RAM) (rule of thumb: bought at least after 1996). This PC needs a network card, a CD-ROM drive and a huge harddisk. </p> <h1 id="Gettingstarted">Getting started</h1>
<ul> <h2 id="FirstSteps">First Steps</h2>
<li><p> Well the disk doesn't need to be huge, it should just suit your filestorage needs <img src="../../../var/www/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p> <p>
</li> Getting the <a href="CryptoBox.html">CryptoBox</a> started doesn't take much:
<li><p> You don't need a monitor or a keyboard to use your <a href="CryptoBox.html">CryptoBox</a> (with one exception, see below). </p> </p>
</li> <ol><li>You need an old Computer (at least 100MHz, 48MB RAM) (rule of thumb: bought at least after 1996). This PC needs a network card, a CD-ROM drive and a huge harddisk.
<li><p> Of course, you may use a faster computer, but they usually consume much more energy and do not provide signifcant advantages. </p> <ul><li>Well the disk doesn't need to be huge, it should just suit your filestorage needs ;)
</li> </li><li>You don't need a monitor or a keyboard to use your <a href="CryptoBox.html">CryptoBox</a> (with one exception, see below).
</ul> </li><li>Of course, you may use a faster computer, but they usually consume much more energy and do not provide signifcant advantages.
</li> </li></ul></li><li>Then download the latest version of the <a href="CryptoBox.html">CryptoBox</a> as an iso-image and burn this image onto a CD.
<li><p>Then download the latest version of the <a href="CryptoBox.html">CryptoBox</a> as an iso-image and burn this image onto a CD. </p> <ul><li><a class="ext-link" title="http://codecoop.org/projects/cryptobox/" href="http://codecoop.org/projects/cryptobox/">http://codecoop.org/projects/cryptobox/</a>
<ul> </li></ul></li><li>Configure your PC, so it can boot from the CD. Therefore you have to enter the BIOS and configure the CD-ROM as boot device.
<li><p> <a href="http://codecoop.org/projects/cryptobox/">http://codecoop.org/projects/cryptobox/</a> </p> </li><li>Insert the shiny new <a href="CryptoBox.html">CryptoBox</a> CD you've just burned and start the computer.
</li> </li></ol><p>
</ul>
</li>
<li><p>Configure your PC, so it can boot from the CD. Therefore you have to enter the BIOS and configure the CD-ROM as boot device. </p>
</li>
<li><p>Insert the shiny new <a href="CryptoBox.html">CryptoBox</a> CD you've just burned and start the computer. </p>
</li>
</ol>
<p>If it now boots from the CD, you accomplished all of the requirements. </p>
<p>Now you can just go to your current desktop computer and point your browser to <a href="https://192.168.0.23">https://192.168.0.23</a> where the <a href="CryptoBox.html">CryptoBox</a> interface should be displayed. Easy - isn't it? </p>
<p>For further steps go to <a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration/en</a>. </p>
<h2 id="head-f205f691abc70f7d2c60001ef96f32f544017295">Hints / Caveats</h2> If it now boots from the CD, you accomplished all of the requirements.
</p>
<ul> <p>
<li><p> Maybe you need to change the network address (IP) of your PC to configure the <a href="CryptoBox.html">CryptoBox</a> for the first time. Ask someone for help, if you don't know how and why ... </p> Now you can just go to your current desktop computer and point your browser to <a class="ext-link" title="https://192.168.0.23" href="https://192.168.0.23">https://192.168.0.23</a> where the <a href="CryptoBox.html">CryptoBox</a> interface should be displayed. Easy - isn't it?
</li> </p>
<li><p> If you're going to buy a new harddisk keep in mind that very old hardware can't handle actual disksizes! </p> <p>
</li> For further steps go to <a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration</a>.
<li><p> Some old PCs are not able to boot from CD. </p> </p>
</li> <h2 id="HintsCaveats">Hints / Caveats</h2>
<li><p> If you don't know what a BIOS is, better ask someone, before you try to change something. <img src="../../../var/www/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p> <p>
</li>
<li><p> Don't forget to connect your PC to your local area network! </p>
</li>
<li><p> To configure the BIOS, you need a keyboard and a monitor. But this has to be done only once. </p>
</li>
</ul>
<p><em>back to <a href="CryptoBoxUser.html">CryptoBoxUser/en</a></em> </p>
<hr>
<p> </p>
<h2 id="head-237d3c26a42096a88e84db8c4f6d8923df1c2899">Questions</h2>
</p>
<ul><li>Maybe you need to change the network address (IP) of your PC to configure the <a href="CryptoBox.html">CryptoBox</a> for the first time. Ask someone for help, if you don't know how and why ...
</li><li>If you're going to buy a new harddisk keep in mind that very old hardware can't handle current disk sizes!
</li><li>Some old PCs are not able to boot from CD.
</li><li>If you don't know what a BIOS is, better ask someone, before you try to change something. ;)
</li><li>Don't forget to connect your PC to your local area network!
</li><li>To configure the BIOS, you need a keyboard and a monitor. But this has to be done only once.
</li></ul><p>
<i>back to <a href="CryptoBoxUser.html">CryptoBoxUser</a></i>
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>
</div><!-- end of 'words' --> </div><!-- end of 'words' -->
<div id="footer"> <div id="footer">

26
v0.2.1/cbox-tree.d/etc/init.d/cb-hints.sh Normal file
View file

@ -0,0 +1,26 @@
#!/bin/sh
#
# give some hints for users, who are sitting in front of the cryptobox and are mistakenly
# waiting for a login prompt
#
case "$1" in
start )
echo
echo "Hints for usage:
echo " * you can not login here :)"
echo " * point a webbrowser on another computer to 'http://$(/usr/lib/cryptobox/cb-manage.sh get_current_ip)'"
echo " * configure your box via your webbrowser"
echo
;;
stop )
;;
restart )
$0 stop
$0 start
;;
* )
echo "Syntax: $0 { start | stop | restart }"
;;
esac

1
v0.2.1/cbox-tree.d/etc/rc3.d/S99cb-hints Symbolic link
View file

@ -0,0 +1 @@
../init.d/cb-hints.sh

1
v0.2.1/cbox-tree.d/usr/share/cryptobox/defaults/cipher Normal file
View file

@ -0,0 +1 @@
aes-cbc-essiv:sha256

1
v0.2.1/cbox-tree.d/usr/share/cryptobox/defaults/hash Normal file
View file

@ -0,0 +1 @@
ripemd160

1
v0.2.1/cbox-tree.d/usr/share/cryptobox/defaults/version Normal file
View file

@ -0,0 +1 @@
0.2.1

28
v0.2.1/cbox-tree.d/usr/share/cryptobox/lang/README Normal file
View file

@ -0,0 +1,28 @@
$Id: README 295 2005-10-11 23:21:32Z lars $
You may want to translate the CryptoBox into another language?
Most welcome!
Existing translation can be found in the .hdf files. There are three
easy steps, that won't take longer than one hour to go through:
1.) Download one .hdf in your preferred language (e.g. en.hdf if you're a native english speaker).
2.) Start to change the text behind the equal sign line for line.
3.) Send us your changed .hdf file. That's it - thank you!
Hints:
We are available via mail (cryptobox@systemausfall.org) for any questions. Don't worry to ask us if
something is vague. We prefer "utf" encoded hdf-files. If you don't
know what udf means - just don't care, send us your file and
everything else will be fine. You don't have to translate the whole
file, some minor parts are enough to send back. The community will do
the rest. ;)
Again, thanks for your help! We do the Cryptobox things in our
freetime for fun and to provide an open source solution for this
special purpose. By helping us, you're taking part in this
development.

18
v0.2.1/cbox-tree.d/usr/share/cryptobox/lang/TODO
View file

@ -1,2 +1,16 @@
si: SuccessMessage.InitRunning contains only the first sentence $Id$
si: SuccessMessage.ReBoot: add a hint for automatic redirection (3rd sentence)
Here are some minor fixes that have to be done. Thanks a lot for your
help!
################################ slovenian ##################################
- SuccessMessage.InitRunning contains only the first sentence
- SuccessMessage.ReBoot: add a hint for automatic redirection (3rd sentence)
- EmptyCryptoPassword: change 'Text' accordingly to English string.
Below are some smaller changes in English sentences. Someone may change it accordingly.
- MountFailed: add 'Pleasy try again' to the end of the string.
- UmountFailed: changed 'Also close all unclean programs' to 'Close all unclean programs'.
- InitRunning: changed 'You may configure it now. You may activate the encrypted filesystem in a few minutes.' to 'You may configure it now and activate the encrypted filesystem in a few minutes.'

28
v0.2.1/cbox-tree.d/usr/share/cryptobox/lang/de.hdf
View file

@ -2,6 +2,8 @@ Lang {
Name = deutsch Name = deutsch
Status = $Id$
Title { Title {
Top = Die CryptoBox Top = Die CryptoBox
Slogan = ... und 1984 war gestern! Slogan = ... und 1984 war gestern!
@ -23,14 +25,14 @@ Lang {
EnterNewAdminPassword = Das neue Admin-Passwort eingeben: EnterNewAdminPassword = Das neue Admin-Passwort eingeben:
EnterSameAdminPassword = Das neue Admin-Passwort wiederholen: EnterSameAdminPassword = Das neue Admin-Passwort wiederholen:
InitWarning = Bei der Initialisierung werden ALLE DATEN auf der Festplatte GEL&Ouml;SCHT! InitWarning = Bei der Initialisierung werden ALLE DATEN auf der Festplatte GEL&Ouml;SCHT!
ConfirmInitHint = Um zu best&auml;tigen, dass sie wissen, was sie tun, tippen sie hier bitte exakt Folgendes ein: ConfirmInitHint = Um zu best&auml;tigen, dass du weisst, was du tust, tippe hier bitte exakt Folgendes ein:
ConfirmInit = ja, loesche alle Daten! ConfirmInit = ja, loesche alle Daten!
PartitionInfo = Derzeitige Partitionierung der Festplatte: PartitionInfo = Derzeitige Partitionierung der Festplatte:
IPAddress = Netzwerk-Adresse (IP) der CryptoBox: IPAddress = Netzwerk-Adresse (IP) der CryptoBox:
TimeOut = Zeitabschaltung des Crypto-Dateisystems (in Minuten): TimeOut = Zeitabschaltung des Crypto-Dateisystems (in Minuten):
EmptyLog = Das Logbuch der CryptoBox ist leer. EmptyLog = Das Logbuch der CryptoBox ist leer.
SelectLanguage = Spracheinstellung: SelectLanguage = Spracheinstellung:
RedirectNote = Klicken sie hier, falls ihr Browser die automatische Weiterleitung nicht unterst&uuml;tzt. RedirectNote = Klicke hier, falls dein Browser die automatische Weiterleitung nicht unterst&uuml;tzt.
ProjectHomePage = Projekt-Seite ProjectHomePage = Projekt-Seite
ProjectNote = Die CryptoBox ist ein Projekt von ProjectNote = Die CryptoBox ist ein Projekt von
DoUmount = Deaktivierung des verschl&uuml;sselten Dateisystems DoUmount = Deaktivierung des verschl&uuml;sselten Dateisystems
@ -64,7 +66,7 @@ Lang {
EmptyCryptoPassword { EmptyCryptoPassword {
Title = Ung&uuml;ltiges Crypto-Passwort Title = Ung&uuml;ltiges Crypto-Passwort
Text = Das Crypto-Passwort darf nicht leer sein! Text = Du musst ein Crypto-Passwort eingeben!
} }
DifferentCryptoPasswords { DifferentCryptoPasswords {
@ -79,17 +81,17 @@ Lang {
WrongAdminPassword { WrongAdminPassword {
Title = Falsches Administrations-Passwort Title = Falsches Administrations-Passwort
Text = Das eingegebene Administrations-Passwort ist falsch. Versuchen sie es noch einmal. Text = Das eingegebene Administrations-Passwort ist falsch. Versuche es noch einmal.
} }
MountFailed { MountFailed {
Title = Aktivierung schlug fehl Title = Aktivierung schlug fehl
Text = Das verschl&uuml;sselte Dateisystem konnte nicht aktiviert werden. Wahrscheinlich war das Passwort falsch. Text = Das verschl&uuml;sselte Dateisystem konnte nicht aktiviert werden. Wahrscheinlich war das Passwort falsch. Versuche es noch einmal.
} }
UmountFailed { UmountFailed {
Title = Deaktivierung schlug fehl Title = Deaktivierung schlug fehl
Text = Das verschl&uuml;sselte Dateisystem konnte nicht abgeschaltet werden. Wahrscheinlich sind noch Dateien ge&ouml;ffnet. Also schlie&szlig;en sie alle potentiell unsauberen Programme (beispielsweise die weitverbreitete Textverarbeitung). Notfalls einfach die CryptoBox ausschalten! Text = Das verschl&uuml;sselte Dateisystem konnte nicht abgeschaltet werden. Wahrscheinlich sind noch Dateien ge&ouml;ffnet. Schlie&szlig;e alle potentiell unsauberen Programme (beispielsweise die weitverbreitete Textverarbeitung). Notfalls einfach die CryptoBox ausschalten!
} }
NotInitialized { NotInitialized {
@ -139,7 +141,7 @@ Lang {
ConfigLanguageFailed { ConfigLanguageFailed {
Title = Fehler beim &Auml;ndern der Spracheinstellung Title = Fehler beim &Auml;ndern der Spracheinstellung
Text = Die Sprach-Einstellung konnte nicht ge&auml;ndert werden! Text = Die Spracheinstellung konnte nicht ge&auml;ndert werden!
} }
ConfigIPFailed { ConfigIPFailed {
@ -157,7 +159,7 @@ Lang {
SuccessMessage { SuccessMessage {
InitRunning { InitRunning {
Title = Initialisierung l&auml;uft Title = Initialisierung l&auml;uft
Text = Die Initialisierung der CryptoBox wird im Hintergrund abgeschlossen. Sie k&ouml;nnen die CryptoBox nun konfigurieren. Sie k&ouml;nnen das verschl&uuml;sselte Dateisystem in ein paar Minuten aktivieren. Text = Die Initialisierung der CryptoBox wird im Hintergrund abgeschlossen. Du kannst die CryptoBox nun konfigurieren und das verschl&uuml;sselte Dateisystem in ein paar Minuten aktivieren.
} }
ConfigSaved { ConfigSaved {
@ -177,12 +179,12 @@ Lang {
PowerOff { PowerOff {
Title = Abschaltung Title = Abschaltung
Text = Die CryptoBox wird gerade heruntergefahren. In wenigen Sekunden k&ouml;nnen sie sie ausschalten (falls dies nicht automatisch geschieht). Text = Die CryptoBox wird gerade heruntergefahren. In wenigen Sekunden kannst du sie ausschalten (falls dies nicht automatisch geschieht).
} }
ReBoot { ReBoot {
Title = Neustart Title = Neustart
Text = Die CryptoBox wird gerade neu gestartet. In wenigen Sekunden ist sie wieder verf&uuml;gbar. Bitte warten - sie werden automatisch weitergeleitet. Text = Die CryptoBox wird gerade neu gestartet. In wenigen Sekunden ist sie wieder verf&uuml;gbar. Bitte warte solange - du wirst automatisch weitergeleitet.
} }
} }
@ -191,7 +193,7 @@ Lang {
UnknownAction { UnknownAction {
Title = Unbekannte Aktion Title = Unbekannte Aktion
Text = Sie haben eine undefinierte Aktion angefordert. Text = Du hast eine undefinierte Aktion angefordert.
} }
NoSSL { NoSSL {
@ -201,12 +203,12 @@ Lang {
InitFailed { InitFailed {
Title = Initialisierung fehlgeschlagen Title = Initialisierung fehlgeschlagen
Text = Senden sie bitte den Inhalt des Protokolls (siehe oben) an die Entwickler der CryptoBox. Text = Sende bitte den Inhalt des Protokolls (siehe oben) an die Entwickler der CryptoBox (cryptobox@systemausfall.org).
} }
NoHardDisk { NoHardDisk {
Title = Keine Festplatte Title = Keine Festplatte
Text = Es wurde kein Datentr&auml;ger gefunden, der zur Speicherung der verschl&uuml;sselten Daten geeignet ist. Pr&uuml;fen sie bitte, ob beim Anschalten des Computers eine Festplatte vom BIOS erkannt wurde. Text = Es wurde kein Datentr&auml;ger gefunden, der zur Speicherung der verschl&uuml;sselten Daten geeignet ist. Pr&uuml;fe bitte, ob beim Anschalten des Computers eine Festplatte vom BIOS erkannt wurde.
} }
} }

12
v0.2.1/cbox-tree.d/usr/share/cryptobox/lang/en.hdf
View file

@ -2,6 +2,8 @@ Lang {
Name = english Name = english
Status = $Id$
Title { Title {
Top = The CryptoBox Top = The CryptoBox
Slogan = Privacy for the rest of us. Slogan = Privacy for the rest of us.
@ -64,7 +66,7 @@ Lang {
EmptyCryptoPassword { EmptyCryptoPassword {
Title = Invalid crypto password Title = Invalid crypto password
Text = The crypto password must not be empty! Text = You have to enter a crypto password!
} }
DifferentCryptoPasswords { DifferentCryptoPasswords {
@ -84,12 +86,12 @@ Lang {
MountFailed { MountFailed {
Title = Activation failed Title = Activation failed
Text = The encrypted filesystem could not be activated. Probably the given password was wrong. Text = The encrypted filesystem could not be activated. Probably the given password was wrong. Please try again.
} }
UmountFailed { UmountFailed {
Title = Deactivation failed Title = Deactivation failed
Text = The encrypted filesystem could not be activated. Probably some files are still in use. Also close all unclean programs (for example that widely used word processor). In case of need just shut down the CryptoBox! Text = The encrypted filesystem could not be activated. Probably some files are still in use. Close all unclean programs (for example that widely used word processor). In case of need just shut down the CryptoBox!
} }
NotInitialized { NotInitialized {
@ -157,7 +159,7 @@ Lang {
SuccessMessage { SuccessMessage {
InitRunning { InitRunning {
Title = Initialization running Title = Initialization running
Text = The initialization will be completed in background. You may configure it now. You may activate the encrypted filesystem in a few minutes. Text = The initialization will be completed in background. You may configure it now and activate the encrypted filesystem in a few minutes.
} }
ConfigSaved { ConfigSaved {
@ -201,7 +203,7 @@ Lang {
InitFailed { InitFailed {
Title = Initialization failed Title = Initialization failed
Text = Please send the logfiles (see above) to the developers of the CryptoBox. Text = Please send the logfiles (see above) to the developers of the CryptoBox (cryptobox@systemausfall.org).
} }
NoHardDisk { NoHardDisk {

4
v0.2.1/cbox-tree.d/usr/share/cryptobox/lang/si.hdf
View file

@ -2,6 +2,8 @@ Lang {
Name = slovenščina Name = slovenščina
Status = $Id$
Title { Title {
Top = The CryptoBox Top = The CryptoBox
Slogan = Privatnost v vsako vas! Slogan = Privatnost v vsako vas!
@ -201,7 +203,7 @@ Lang {
InitFailed { InitFailed {
Title = Zagon ni uspel Title = Zagon ni uspel
Text = Prosim pošljite dnevnik (poglejte zgoraj) razvijalcem CryptoBoxa. Text = Prosim pošljite dnevnik (poglejte zgoraj) razvijalcem CryptoBoxa (cryptobox@systemausfall.org).
} }
NoHardDisk { NoHardDisk {

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/config_form.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: config_form.cs 295 2005-10-11 23:21:32Z lars $ -->
<div id="config"> <div id="config">
<h1><?cs var:Lang.Title.Config ?></h1> <h1><?cs var:Lang.Title.Config ?></h1>

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/doc.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: doc.cs 295 2005-10-11 23:21:32Z lars $ -->
<div id="doc"> <div id="doc">
<?cs include:Settings.DocDir + '/' + Settings.DocLang + '/' + Data.Doc.Page + '.html' ?> <?cs include:Settings.DocDir + '/' + Settings.DocLang + '/' + Data.Doc.Page + '.html' ?>

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/empty.cs
View file

@ -1 +1,3 @@
<!-- $Id: empty.cs 295 2005-10-11 23:21:32Z lars $ -->
<!-- what else would you expect here? --> <!-- what else would you expect here? -->

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/error.cs
View file

@ -1 +1,3 @@
<!-- $Id: error.cs 295 2005-10-11 23:21:32Z lars $ -->
<?cs call:error(Data.Error) ?> <?cs call:error(Data.Error) ?>

6
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/footer.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: footer.cs 295 2005-10-11 23:21:32Z lars $ -->
<?cs if:Data.Redirect ?> <?cs if:Data.Redirect ?>
<p class="warning"><a href="<?cs if:Data.Redirect.URL ?><?cs var:Data.Redirect.URL ?><?cs else ?><?cs call:getSelfURL('action=' + Data.Redirect.Action, '') ?><?cs /if ?>"><?cs var:Lang.Text.RedirectNote ?></a></p> <p class="warning"><a href="<?cs if:Data.Redirect.URL ?><?cs var:Data.Redirect.URL ?><?cs else ?><?cs call:getSelfURL('action=' + Data.Redirect.Action, '') ?><?cs /if ?>"><?cs var:Lang.Text.RedirectNote ?></a></p>
<?cs /if ?> <?cs /if ?>
@ -6,7 +8,7 @@
<div id="footer"> <div id="footer">
<!-- Version --> <!-- Version -->
v0.2&nbsp;&nbsp; v0.2.1&nbsp;&nbsp;
<a href="https://systemausfall.org/prj/cryptobox" title="<?cs var:Lang.Text.ProjectHomePage ?>">CryptoBox-Home</a> <?cs var:Lang.Text.ProjectNote ?>&nbsp;<a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a> <a href="https://systemausfall.org/prj/cryptobox" title="<?cs var:Lang.Text.ProjectHomePage ?>">CryptoBox-Home</a> <?cs var:Lang.Text.ProjectNote ?>&nbsp;<a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
</div> </div>
@ -23,5 +25,7 @@ Data.Status.IP=<?cs var:Data.Status.IP ?>
Data.Status.Mounted=<?cs var:Data.Status.Mounted ?> Data.Status.Mounted=<?cs var:Data.Status.Mounted ?>
CBOX-STATUS-end --> CBOX-STATUS-end -->
<!-- $Revision: 295 $ -->
</body> </body>
</html> </html>

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/header.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: header.cs 295 2005-10-11 23:21:32Z lars $ -->
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"> <html xmlns="http://www.w3.org/1999/xhtml">

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/init_form.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: init_form.cs 295 2005-10-11 23:21:32Z lars $ -->
<h1><?cs var:Lang.Title.Init ?></h1> <h1><?cs var:Lang.Title.Init ?></h1>
<div class="init"> <div class="init">

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/macros.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: macros.cs 295 2005-10-11 23:21:32Z lars $ -->
<?cs def:warning(warnname) ?><?cs <?cs def:warning(warnname) ?><?cs
each:item = Lang.WarningMessage ?><?cs each:item = Lang.WarningMessage ?><?cs
if:(name(item) == warnname) if:(name(item) == warnname)

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/main.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: main.cs 295 2005-10-11 23:21:32Z lars $ -->
<?cs include:Settings.TemplateDir + '/macros.cs' ?> <?cs include:Settings.TemplateDir + '/macros.cs' ?>
<?cs include:Settings.TemplateDir + '/header.cs' ?> <?cs include:Settings.TemplateDir + '/header.cs' ?>

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/mount_form.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: mount_form.cs 295 2005-10-11 23:21:32Z lars $ -->
<h1><?cs var:Lang.Title.Mount ?></h1> <h1><?cs var:Lang.Title.Mount ?></h1>
<div align="center"> <div align="center">

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/nav.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: nav.cs 295 2005-10-11 23:21:32Z lars $ -->
<!-- mounting possible? --> <!-- mounting possible? -->
<?cs if:((Data.Status.Config == 1) && (Data.Status.InitRunning == 0)) ?> <?cs if:((Data.Status.Config == 1) && (Data.Status.InitRunning == 0)) ?>
<?cs if:(Data.Status.Mounted == 1) ?> <?cs if:(Data.Status.Mounted == 1) ?>

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/show_log.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: show_log.cs 295 2005-10-11 23:21:32Z lars $ -->
<div id="log"> <div id="log">
<h1><?cs var:Lang.Title.Log ?></h1> <h1><?cs var:Lang.Title.Log ?></h1>

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/shutdown_form.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: shutdown_form.cs 295 2005-10-11 23:21:32Z lars $ -->
<h1><?cs var:Lang.Title.ShutDown ?></h1> <h1><?cs var:Lang.Title.ShutDown ?></h1>
<div align="center"> <div align="center">

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/status.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: status.cs 295 2005-10-11 23:21:32Z lars $ -->
<h1><?cs var:Lang.Title.Status ?></h1> <h1><?cs var:Lang.Title.Status ?></h1>
<p><?cs if:(Data.Status.Mounted == 1) ?><?cs var:Lang.Text.CryptoIsActive ?> <p><?cs if:(Data.Status.Mounted == 1) ?><?cs var:Lang.Text.CryptoIsActive ?>
<?cs else ?><?cs var:Lang.Text.CryptoIsDown ?><?cs /if ?></p> <?cs else ?><?cs var:Lang.Text.CryptoIsDown ?><?cs /if ?></p>

2
v0.2.1/cbox-tree.d/usr/share/cryptobox/templates/umount_form.cs
View file

@ -1,3 +1,5 @@
<!-- $Id: umount_form.cs 295 2005-10-11 23:21:32Z lars $ -->
<h1><?cs var:Lang.Title.Umount ?></h1> <h1><?cs var:Lang.Title.Umount ?></h1>
<div align="center"> <div align="center">

210
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBox.html
View file

@ -1,137 +1,85 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBox#Neuigkeiten&weblang=de">Neuigkeiten</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBox#berblick&weblang=de">Überblick</a></li>
<a href="#head-e50e9371b89733779dffda07519c0bdfb6c3cd19">Neuigkeiten</a> <li><a href="/cryptobox?action=doc&page=CryptoBox#Download&weblang=de">Download</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBox#Support&weblang=de">Support</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBox#Entwicklung&weblang=de">Entwicklung</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBox#Mitwirkende&weblang=de">Mitwirkende</a></li>
<a href="#head-a6addcb037bbd74e8c3f533fcbc9b974c5008676">Überblick</a> <li><a href="/cryptobox?action=doc&page=CryptoBox#Rechtliches&weblang=de">Rechtliches</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBox#Kommentare&weblang=de">Kommentare</a></li>
<li>
<a href="#head-5b1aae7bec38aaabf39d79875117c8c10c945603">Spezifikationen</a>
</li>
<li>
<a href="#head-2614272d10d2679e8451f66e39db184578ec3d7c">Nutzung</a>
</li>
<li>
<a href="#head-b1bdcd2edb5c97874f17e2830b40854662ae1ef6">Mitmachen</a>
</li>
<li>
<a href="#head-f8cc7f13417e1024c0e7f219cc43f0fd9000ad72">Rechtliches</a>
</li>
</ol> </ol>
<p> </p>
<hr>
<p> </p>
<p><em>unter <a href="/cryptobox?action=doc&page=CryptoBoxIntro&weblang=de">CryptoBoxIntro/de</a> findest du einen sehr kurzen Überblick</em> </p>
<h2 id="head-e50e9371b89733779dffda07519c0bdfb6c3cd19">Neuigkeiten</h2>
<p>Das erste Release der <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> wird im Oktober bei <a href="http://codecoop.org/projects/cryptobox/&weblang=de">http://codecoop.org/projects/cryptobox/</a> verfügbar sein. </p>
<h2 id="head-a6addcb037bbd74e8c3f533fcbc9b974c5008676">Überblick</h2>
<p>Die <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> ist eine <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Live-cd">Live-CD</a> mit der sich jeder alte Rechner in Sekundenschnelle in einen verschlüsselnden Server umwandeln lässt. Damit kannst du sensible Daten speichern, ohne dass du etwas über <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Kryptografie&weblang=de">Kryptografie</a> wissen musst. </p>
<p>Die Dokumentation der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> ist bisher in folgenden Sprachen verfügbar: </p>
<ul>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">deutsch</a> </p>
</li>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">english</a> </p>
</li>
</ul>
<p>Wir freuen uns über weitere Übersetzugen <img src="/cryptobox-img/smile.png" alt=":)" height="15" width="15"> </p>
<h2 id="head-5b1aae7bec38aaabf39d79875117c8c10c945603">Spezifikationen</h2>
<div>
<table>
<tr>
<td>
<p>System</p>
</td>
<td>
<p>Debian/Linux basierte Live-CD</p>
</td>
</tr>
<tr>
<td>
<p>benötigter Computer</p>
</td>
<td>
<p> "ausrangierter" PC (i386 ab p1 mind. 32MB RAM)</p>
</td>
</tr>
<tr>
<td>
<p>unterstützte Clients</p>
</td>
<td>
<p><a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Liste_der_Betriebssysteme">*nix; *bsd; Windows; Mac OS</a></p>
</td>
</tr>
<tr>
<td>
<p>interner Fileserver</p>
</td>
<td>
<p><a class="external" href="http://samba.org">samba</a> (Netzwerkfreigaben)</p>
</td>
</tr>
<tr>
<td>
<p>Benutzerschnittstelle</p>
</td>
<td>
<p>per Browser bedienbares Web-Interface</p>
</td>
</tr>
<tr>
<td>
<p>Verschlüsselung</p>
</td>
<td>
<p><a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Advanced_Encryption_Standard">AES</a> via device-mapper</p>
</td>
</tr>
</table>
</div> </div>
<p>Das Web-Interface der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> ünterstützt derzeit folgende Sprachen: </p>
<ul>
<li><p> deutsch </p>
</li>
<li><p> englisch </p>
</li>
<li><p> slowenisch </p>
</li>
</ul>
<p>Du kannst gern weitere <a class="interwiki" title="SubVersion" href="/websvn/cryptobox/trunk/cbox-tree.d/usr/share/cryptobox/lang/en.hdf">Übersetzungen</a> in andere Sprachen hinzufügen (idealerweise utf-encodiert). </p>
<h2 id="head-2614272d10d2679e8451f66e39db184578ec3d7c">Nutzung</h2> </p>
<h1 id="DieCryptoBox">Die CryptoBox</h1>
<p>Das Nutzerhandbuch ist unter <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser/de</a> verfügbar. </p> <p>
<i><a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">English version</a></i>
<h2 id="head-b1bdcd2edb5c97874f17e2830b40854662ae1ef6">Mitmachen</h2> </p>
<h2 id="Neuigkeiten">Neuigkeiten</h2>
<p>Beteilige dich an der Entwicklung der <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> und werde reich und schön! <img src="/cryptobox-img/smile4.png" alt=";)" height="15" width="15&weblang=de"> <br> <p>
Nee im Ernst, wir freuen uns über jeden partizipierenden Menschen. Du wirst in einem entspannten Team reichlich Erfahrungen sammeln, eine nützliche Sache voranbringen und - wer weiß - vielleicht macht dich das auch schön. Schreib eine Mail an <em>cryptobox[at]systemausfall.org</em> und hab Spaß. </p> Das erste Release der <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> ist bei <a class="ext-link" title="https://codecoop.org/projects/cryptobox/" href="https://codecoop.org/projects/cryptobox/&weblang=de">Codecoop.org</a> verfügbar.
<p>Fehler kannst du in unserer <a class="external" href="https://systemausfall.org/trac/cryptobox">Fehlerdatenbank</a> eintragen. </p> </p>
<p>Die Entwickler-Doku findest du unter <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a> (bisher nur englisch). </p> <h2 id="berblick">Überblick</h2>
<p>
<h2 id="head-f8cc7f13417e1024c0e7f219cc43f0fd9000ad72">Rechtliches</h2> Die <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> ist eine <a class="ext-link" title="http://de.wikipedia.org/wiki/Live-cd" href="http://de.wikipedia.org/wiki/Live-cd">Live-CD</a> mit der sich jeder alte Rechner in Sekundenschnelle in einen verschlüsselnden Server umwandeln lässt. Damit kannst du sensible Daten speichern, ohne dass du etwas über <a class="ext-link" title="http://de.wikipedia.org/wiki/Kryptografie" href="http://de.wikipedia.org/wiki/Kryptografie&weblang=de">Kryptografie</a> wissen musst.<br />
Die Bedienung erfolgt vollständig per Webbrowser. Wirf einen Blick auf die <a href="/cryptobox?action=doc&page=ScreenShots&weblang=de">ScreenShots</a>.
<ol type="1"> </p>
<li><p>Alle Skripte unterliegen der <a class="external" href="http://www.fsf.org/licensing/licenses/gpl.html">GPL</a> - sie sind also quasi vollständig frei. </p> <table class="wiki">
</li> <tr><td><i>Spezifikation</i>
<li><p>Die Dokumentation unterliegt einer <em><a class="external" href="http://creativecommons.org/licenses/by-sa-nc/2.0/">Creative Commons</a></em>-Lizenz, damit wird die Möglichkeit der freien Verbreitung des gesammelten Wissens gewährleistet. </p> </td></tr><tr><td>System</td><td>Debian GNU/Linux-basierte Live-CD
</li> </td></tr><tr><td>benötigter Computer</td><td>&#34;ausrangierter&#34; PC (i386 ab p1 mind. 32MB RAM)
<li><p>Wir übernehmen keinerlei Haftung für eventuelle Folgen, die durch die Nutzung einer <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> entstehen könnten. </p> </td></tr><tr><td>unterstützte Clients</td><td><a class="ext-link" title="http://de.wikipedia.org/wiki/Liste_der_Betriebssysteme" href="http://de.wikipedia.org/wiki/Liste_der_Betriebssysteme">*nix; *bsd; Windows; Mac OS</a>
</li> </td></tr><tr><td>interner Fileserver</td><td><a class="ext-link" title="http://samba.org" href="http://samba.org">samba</a> (Netzwerkfreigaben)
</ol> </td></tr><tr><td>Benutzerschnittstelle</td><td>per Browser bedienbares Web-Interface
</td></tr><tr><td>Verschlüsselung</td><td><a class="ext-link" title="http://de.wikipedia.org/wiki/Advanced_Encryption_Standard" href="http://de.wikipedia.org/wiki/Advanced_Encryption_Standard">AES</a> via device-mapper
</td></tr></table>
<p>
Das Web-Interface der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> unterstützt derzeit folgende Sprachen:
</p>
<ul><li>deutsch
</li><li>englisch
</li><li>slowenisch
</li></ul><p>
Wir suchen noch Übersetzungen in andere Sprachen. Wenn du dich beteiligen möchtest, wirf einen Blick in die <a href="/trac/cryptobox/browser/trunk/cbox-tree.d/usr/share/cryptobox/lang">Übersetzungen-Sektion</a>. Dort gibt es eine &#34;README&#34; Datei in der genauere Beschreibungen stehen.
</p>
<h2 id="Download">Download</h2>
<ul><li><a class="ext-link" title="http://codecoop.org/frs/download.php/32/cryptobox_0.2.iso" href="http://codecoop.org/frs/download.php/32/cryptobox_0.2.iso">Version 0.2</a> [104 MB] - <a href="/trac/cryptobox/wiki/ReleaseNotes/0.2">Release notes</a>
<ul><li><i>bereitgestellt durch <a class="ext-link" title="http://codecoop.org" href="http://codecoop.org">http://codecoop.org</a></i>
</li></ul></li></ul><h2 id="Support">Support</h2>
<ul><li>Das Nutzerhandbuch ist unter <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser</a> verfügbar.
</li><li>Probleme und Anregungen kannst du unser <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/newticket" href="https://systemausfall.org/trac/cryptobox/newticket">Fehlerdatenbank</a> melden
</li><li>Für allgemeine Fragen, schreibe eine Email an <i>cryptobox[at]systemausfall.org</i>.
</li></ul><h2 id="Entwicklung">Entwicklung</h2>
<p>
Beteilige dich an der Entwicklung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> und werde reich und schön! ;) <br />
Nee im Ernst, wir freuen uns über jeden partizipierenden Menschen. Du wirst in einem entspannten Team reichlich Erfahrungen sammeln, eine nützliche Sache voranbringen und - wer weiß - vielleicht macht dich das auch schön. <br />
Schreib eine Mail an <i>cryptobox[at]systemausfall.org</i> und hab Spaß.
</p>
<p>
Die englischsprachige Entwickler-Doku findest du unter <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a>.
</p>
<h2 id="Mitwirkende">Mitwirkende</h2>
<p>
<ul><li>Clavdia Horvat, Tadej Brce &amp; Dušan Rebolj - slovenian translation
</li><li><a class="ext-link" title="http://codecoop.org" href="http://codecoop.org">http://codecoop.org</a> - webspace
</li></ul>
</p>
<h2 id="Rechtliches">Rechtliches</h2>
<ol><li>Alle Skripte unterliegen der <a class="ext-link" title="http://www.fsf.org/licensing/licenses/gpl.html" href="http://www.fsf.org/licensing/licenses/gpl.html">GPL</a> - sie sind also quasi vollständig frei.
</li><li>Die Dokumentation unterliegt einer <i><a class="ext-link" title="http://creativecommons.org/licenses/by-sa-nc/2.0/" href="http://creativecommons.org/licenses/by-sa-nc/2.0/">Creative Commons</a></i>-Lizenz, damit wird die Möglichkeit der freien Verbreitung des gesammelten Wissens gewährleistet.
</li><li>Wir übernehmen keinerlei Haftung für eventuelle Folgen, die durch die Nutzung einer <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> entstehen könnten.
</li></ol><hr />
<h2 id="Kommentare">Kommentare</h2>
<p>
</div>
</div>

126
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxDev.html
View file

@ -1,49 +1,93 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Preparationsfordevelopers&weblang=de">Preparations for developers</a></li>
<li> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Softwarerequirements&weblang=de">Software requirements</a></li>
<a href="#head-85f75330e62e5b1efc9f504fe9cb51a1b966dc3b">Development documentation</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Getthesource&weblang=de">Get the source</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Firstbuild&weblang=de">First build</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Finished&weblang=de">Finished</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Comments&weblang=de">Comments</a></li>
<a href="#head-b8ce79abe983e1592235d0085dd6928b83811739">Contact</a>
</li>
<li>
<a href="#head-964f56b054273ed39bab34484f83ac053ac0f12e">Bug reports</a>
</li>
</ol> </ol>
<p> </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Developmentworkflow&weblang=de">Development workflow</a></li>
<hr> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Preparations&weblang=de">Preparations</a></li>
<p> </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#CreateaCryptoBoxLiveCD&weblang=de">Create a CryptoBox-LiveCD</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#TesttheCryptoBoxLiveCD&weblang=de">Test the CryptoBox-LiveCD</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Debuggingandmerging&weblang=de">Debugging and merging</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Comments&weblang=de">Comments</a></li>
</ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#CustombuildsoftheCryptoBox&weblang=de">Custom builds of the CryptoBox</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Overview&weblang=de">Overview</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Settings&weblang=de">Settings</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Comments&weblang=de">Comments</a></li>
</ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#CustomconfigurationoftheCryptoBox&weblang=de">Custom configuration of the CryptoBox</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Overview&weblang=de">Overview</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Locations&weblang=de">Locations</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Examples&weblang=de">Examples</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Comments&weblang=de">Comments</a></li>
</ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#ValidationoftheCryptoBox&weblang=de">Validation of the CryptoBox</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Overview&weblang=de">Overview</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Validate&weblang=de">Validate</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Howtocreateatest&weblang=de">How to create a test</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Comments&weblang=de">Comments</a></li>
</ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#DetailsoftheCryptoBox&weblang=de">Details of the CryptoBox</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#dfsbuild&weblang=de">dfsbuild</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#thekernel&weblang=de">the kernel</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#qemu&weblang=de">qemu</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#alternativeLiveCDs&weblang=de">alternative LiveCDs</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#Comments&weblang=de">Comments</a></li>
</ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#Knownproblems&weblang=de">Known problems</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#qemu&weblang=de">qemu</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#dfsbuild&weblang=de">dfsbuild</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#Comments&weblang=de">Comments</a></li>
</ol>
</ol>
</div>
<h2 id="head-85f75330e62e5b1efc9f504fe9cb51a1b966dc3b">Development documentation</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox/de</a>, <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox/en</a>)
<p>The following pages are written for developers only. Users of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> should read <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser</a> instead. </p> </p>
<ul> <hr />
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=de">CryptoBoxDevPreparation</a> </p> <h1 id="Developmentdocumentation">Development documentation</h1>
</li> <p>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow&weblang=de">CryptoBoxDevWorkFlow</a> </p> The following pages are written for developers only. <br />
</li> Users of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> should read <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser</a> instead.
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=de">CryptoBoxDevCustomBuild</a> </p> </p>
</li> <ul><li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=de">CryptoBoxDevPreparation</a>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure&weblang=de">CryptoBoxDevCustomConfigure</a> </p> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow&weblang=de">CryptoBoxDevWorkFlow</a>
</li> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=de">CryptoBoxDevCustomBuild</a>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevValidation&weblang=de">CryptoBoxDevValidation</a> </p> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure&weblang=de">CryptoBoxDevCustomConfigure</a>
</li> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation&weblang=de">CryptoBoxDevValidation</a>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevBackground&weblang=de">CryptoBoxDevBackground</a> </p> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground&weblang=de">CryptoBoxDevBackground</a>
</li> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems&weblang=de">CryptoBoxDevKnownProblems</a>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems&weblang=de">CryptoBoxDevKnownProblems</a> </p> </li></ul><h2 id="Source">Source</h2>
</li> <p>
</ul> You may browse the <a href="/trac/cryptobox/browser/">source code</a>.
</p>
<h2 id="Contact">Contact</h2>
<p>
We are waiting for your emails to <i>cryptobox[at]systemausfall.org</i>.
</p>
<h2 id="Bugreports">Bug reports</h2>
<p>
If you think you found a bug or you get an error message, please help us to fix the problem and file a ticket (a bug report). Follow these steps:
</p>
<ol><li>Have a look at <a href="/trac/cryptobox/report/1">Open bugs</a> that need to be fixed
</li><li>Create a <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/newticket" href="https://systemausfall.org/trac/cryptobox/newticket">New Ticket</a>
</li></ol></div>
</div>
<h2 id="head-b8ce79abe983e1592235d0085dd6928b83811739">Contact</h2>
<p>We are waiting for your emails to <em>cryptobox[at]systemausfall.org</em>. </p>
<h2 id="head-964f56b054273ed39bab34484f83ac053ac0f12e">Bug reports</h2>
<p>Please use our issue tracker, if you discover problems: <a href="https://systemausfall.org/trac/cryptobox">https://systemausfall.org/trac/cryptobox</a> </p>

118
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxDevBackground.html
View file

@ -1,66 +1,64 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#dfsbuild&weblang=de">dfsbuild</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#thekernel&weblang=de">the kernel</a></li>
<a href="#head-2d71165918ee9e861cebf562e7f9be2c5c6328e4">dfsbuild</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#qemu&weblang=de">qemu</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#alternativeLiveCDs&weblang=de">alternative LiveCDs</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#Comments&weblang=de">Comments</a></li>
<li>
<a href="#head-6e3d13fcf3a0765d2188125e9b0b0bcb95e50622">the kernel</a>
</li>
<li>
<a href="#head-e01e8e66ae77c00f4e9fa9bd190c3ff738540727">qemu</a>
</li>
<li>
<a href="#head-00c94b926ece7f2a601d696a8880f5e54155ce7a">alternative LiveCDs</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a></em> </p>
<h2 id="head-2d71165918ee9e861cebf562e7f9be2c5c6328e4">dfsbuild</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a>)
<p>The base system of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> Live-CD is created by <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild&weblang=de">dfsbuild</a>. </p> </p>
<p>It is recommended to use some kind of caching tool for the retrieval of the debian packages (e.g.: <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a> or <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a>). This saves a lot of bandwidth and time. </p> <hr />
<p>The documentation for <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> is sparse. But it is quite unlikely, that you will get in direct contact with it, as it is wrapped by <em>cbox-build</em>. However the following links may help you for specific problems: </p> <h1 id="DetailsoftheCryptoBox">Details of the CryptoBox</h1>
<ul> <h2 id="dfsbuild">dfsbuild</h2>
<li><p> <a class="external" href="http://www.debian-administration.org/articles/125">Debian Administration: Building Debian CD-ROMS Part 1 - dfsbuild</a> </p> <p>
</li> The base system of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> Live-CD is created by <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild&weblang=de">dfsbuild</a>.
<li><p> <a class="external" href="http://www.debian-administration.org/articles/149">Debian Administration: Getting in deep with dfsbuild</a> </p> </p>
</li> <p>
</ul> It is recommended to use some kind of caching tool for the retrieval of the debian packages (e.g.: <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a> or <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx">approx</a>). This saves a lot of bandwidth and time.
</p>
<h2 id="head-6e3d13fcf3a0765d2188125e9b0b0bcb95e50622">the kernel</h2> <p>
The documentation for <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> is sparse. But it is quite unlikely, that you will get in direct contact with it, as it is wrapped by <a href="/trac/cryptobox/browser/trunk/scripts/cbox-build.sh">cbox-build</a>. However the following links may help you for specific problems:
<p>The linux kernel for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> is compiled statically. If you want to change it, you could follow this steps: </p> </p>
<ol type="1"> <ul><li><a class="ext-link" title="http://www.debian-administration.org/articles/125" href="http://www.debian-administration.org/articles/125">Debian Administration: Building Debian CD-ROMS Part 1 - dfsbuild</a>
<li><p>get the sources: <tt>apt-get&nbsp;install&nbsp;kernel-tree-2.6.11</tt> (or the version of your choice) </p> </li><li><a class="ext-link" title="http://www.debian-administration.org/articles/149" href="http://www.debian-administration.org/articles/149">Debian Administration: Getting in deep with dfsbuild</a>
</li> </li></ul><h2 id="thekernel">the kernel</h2>
<li><p>copy the exisiting config file <em>kernel/config-2.6.11</em> as <em>.config</em> into your kernel source directory </p> <p>
</li> The linux kernel for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> is compiled statically. If you want to change it, you could follow this steps:
<li><p>build the debian kernel package <tt>make-kpkg&nbsp;--revision=1.dfs&nbsp;--rootcmd=fakeroot&nbsp;kernel_image</tt> </p> </p>
</li> <ol><li>get the sources: <tt>apt-get install kernel-tree-2.6.11</tt> (or the version of your choice)
<li><p>change the kernel in the <em>unpackdebs</em> setting in <em>dfs-cbox.conf</em> (see <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=de">CryptoBoxDevCustomBuild</a> for details) </p> </li><li>copy the exisiting config file <i>kernel/config-2.6.11</i> as <i>.config</i> into your kernel source directory
</li> </li><li>build the debian kernel package <tt>make-kpkg --revision=1.dfs --rootcmd=fakeroot kernel_image</tt>
</ol> </li><li>change the kernel in the <i>unpackdebs</i> setting in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/dfs-cbox.conf">dfs-cbox.conf</a> (see <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=de">CryptoBoxDevCustomBuild</a> for details)
</li></ol><p>
<h2 id="head-e01e8e66ae77c00f4e9fa9bd190c3ff738540727">qemu</h2> See <a title="" href="/trac/cryptobox/browser/trunk/hints/kernel-build.txt">source:trunk/hints/kernel-build.txt</a> for more details.
</p>
<p><a class="external" href="http://fabrice.bellard.free.fr/qemu/">Qemu</a> is a portable system emulator. It is a convenient tool to ease the development workflow, as you do not need to burn LiveCDs for testing. </p> <h2 id="qemu">qemu</h2>
<p>
<h2 id="head-00c94b926ece7f2a601d696a8880f5e54155ce7a">alternative LiveCDs</h2> <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu/" href="http://fabrice.bellard.free.fr/qemu/">Qemu</a> is a portable system emulator. It is a convenient tool to ease the development workflow, as you do not need to burn LiveCDs for testing.
</p>
<p>We tried some other LiveCDs before we decided to use <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>. The following pages describe their advantages and disadvantages as the base system for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>: </p> <h2 id="alternativeLiveCDs">alternative LiveCDs</h2>
<ul> <p>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxKnoppixVerworfen&weblang=de">CryptoBoxKnoppixVerworfen</a> - Knoppix </p> We tried some other LiveCDs before we decided to use <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>. The following pages describe their advantages and disadvantages as the base system for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>:
</li> </p>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxMorphixVerworfen&weblang=de">CryptoBoxMorphixVerworfen</a> - Morphix / IBuild </p> <ul><li><a href="/cryptobox?action=doc&page=CryptoBoxKnoppixVerworfen&weblang=de">CryptoBoxKnoppixVerworfen</a> - Knoppix
</li> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxMorphixVerworfen&weblang=de">CryptoBoxMorphixVerworfen</a> - Morphix / IBuild
</ul> </li></ul><hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

171
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxDevCustomBuild.html
View file

@ -1,98 +1,85 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Overview&weblang=de">Overview</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Settings&weblang=de">Settings</a></li>
<a href="#head-27ea5a3ee88c7c2dfcfd4124719aadd726f1e2da">Overview</a> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#dfsbuildsettings&weblang=de">dfsbuild settings</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#CryptoBoxdevelopmentconfiguration&weblang=de">CryptoBox development configuration</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#SSHconnection&weblang=de">SSH connection</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#qemunetworkconfiguration&weblang=de">qemu network configuration</a></li>
<a href="#head-737db576c5f42abc0c78574d0ce5077809f288cb">Settings</a> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Comments&weblang=de">Comments</a></li>
<ol>
<li>
<a href="#head-9d97886ad41e38cb6afe343aa68ff652030ab06b">dfsbuild settings</a>
</li>
<li>
<a href="#head-c2ae24a50a3706711c1a42e26176768438d4f160">CryptoBox development configuration</a>
</li>
<li>
<a href="#head-90ac95d2e5a50160cbf72b884b7b469a29c2fea1">SSH connection</a>
</li>
<li>
<a href="#head-6798893e2e3fd89a72b5b6821a0d3d08125367b9">qemu network configuration</a>
</li>
</ol> </ol>
</div>
</li> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev">CryptoBoxDev</a>, <a href="/cryptobox?action=doc&page=CryptoBoxDevBackground">CryptoBoxDevBackground</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevPreparation">CryptoBoxDevPreparation</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevWorkFlow&weblang=de">CryptoBoxDevWorkFlow</a>)
</ol> </p>
<p> </p> <hr />
<hr> <h1 id="CustombuildsoftheCryptoBox">Custom builds of the CryptoBox</h1>
<p> </p> <h2 id="Overview">Overview</h2>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a></em> </p> <p>
The following sections are useful, if you want to change the default settings of your personal <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> development environment.
<h2 id="head-27ea5a3ee88c7c2dfcfd4124719aadd726f1e2da">Overview</h2> </p>
<p>
<p>The following sections are useful, if you want to change the default settings of your personal <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> development environment. </p> You should have completed the steps described in <a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=de">CryptoBoxDevPreparation</a>.
<p>You should have completed the steps described in <a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=de">CryptoBoxDevPreparation</a>. </p> </p>
<h2 id="Settings">Settings</h2>
<h2 id="head-737db576c5f42abc0c78574d0ce5077809f288cb">Settings</h2> <h3 id="dfsbuildsettings">dfsbuild settings</h3>
<p>
All settings for <i>dfsbuild</i> can be found in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/dfs-cbox.conf">etc-defaults.d/dfs-cbox.conf</a>.
<h3 id="head-9d97886ad41e38cb6afe343aa68ff652030ab06b">dfsbuild settings</h3> </p>
<p>
<p>All settings for <em>dfsbuild</em> can be found in <em>etc-defaults.d/dfs-cbox.conf</em>. </p> If you want to change any of them, you should do the following:
<p>If you want to change any of them, you should do the following: </p> </p>
<ol type="1"> <ol><li>copy <i>etc-defaults.d/dfs-cbox.conf</i> file to <i>etc-local.d/</i>
<li><p>copy <em>etc-defaults.d/dfs-cbox.conf</em> file to <em>etc-local.d/</em> </p> </li><li>change <i>etc-local.d/dfs-cbox.conf</i> according to your needs
</li> </li></ol><p>
<li><p>change <em>etc-local.d/dfs-cbox.conf</em> according to your needs </p> This allows you to use your own (personal) settings, without interfering with files under version control.
</li> </p>
</ol> <h3 id="CryptoBoxdevelopmentconfiguration">CryptoBox development configuration</h3>
<p>This allows you to use your own (personal) settings, without interfering with files under version control. </p> <p>
Some settings regarding the building, configuring and validating of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> can be found in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/cbox-dev.conf&weblang=de">etc-defaults.d/cbox-dev.conf</a>.
<h3 id="head-c2ae24a50a3706711c1a42e26176768438d4f160">CryptoBox development configuration</h3> </p>
<p>
<p>Some settings regarding the building, configuring and validating of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> can be found in <em>etc-defaults.d/cbox-dev.conf</em>. </p> If you want to change any of them, you should do the following:
<p>If you want to change any of them, you should do the following: </p> </p>
<ol type="1"> <ol><li>copy <i>etc-defaults.d/cbox-dev.conf</i> file to <i>etc-local.d/</i>
<li><p>copy <em>etc-defaults.d/cbox-dev.conf</em> file to <em>etc-local.d/</em> </p> </li><li>change <i>etc-local.d/cbox-dev.conf</i> according to your needs
</li> </li></ol><h3 id="SSHconnection">SSH connection</h3>
<li><p>change <em>etc-local.d/cbox-dev.conf</em> according to your needs </p> <p>
</li> The file <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/ssh_config">ssh_config</a> is used to establish a connection to a running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system.
</ol> </p>
<p>
<h3 id="head-90ac95d2e5a50160cbf72b884b7b469a29c2fea1">SSH connection</h3> It can be necessary to change these settings, if:
</p>
<p>The file <em>etc-defaults.d/ssh_config</em> is used to establish a connection to a running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system. </p> <ul><li>you do not want to use the default IP for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>
<p>It can be necessary to change these settings, if: </p> </li><li>or the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> is not within your local network.
<ul> </li></ul><p>
<li><p> you do not want to use the default IP for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> </p> If you want to change some settings, you should do the following:
</li> </p>
<li><p> or the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> is not within your local network. </p> <ol><li>copy <i>etc-defaults.d/ssh_config</i> file to <i>etc-local.d/</i>
</li> </li><li>change <i>etc-local.d/ssh_config</i> according to your needs
</ul> </li></ol><h3 id="qemunetworkconfiguration">qemu network configuration</h3>
<p>If you want to change some settings, you should do the following: </p> <p>
<ol type="1"> The file <a href="/trac/cryptobox/browser/trunk/etc-defauolts.d/qemu-ifup">etc-defauolts.d/qemu-ifup</a> is used for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> emulation with <i>qemu</i>. See <i>man qemu</i> for details.
<li><p>copy <em>etc-defaults.d/ssh_config</em> file to <em>etc-local.d/</em> </p> </p>
</li> <p>
<li><p>change <em>etc-local.d/ssh_config</em> according to your needs </p> If you want to change some settings, you should do the following:
</li> </p>
</ol> <ol><li>copy <i>etc-defaults.d/qemu-ifup</i> file to <i>etc-local.d/</i>
</li><li>change <i>etc-local.d/qemu-ifup</i> according to your needs
<h3 id="head-6798893e2e3fd89a72b5b6821a0d3d08125367b9">qemu network configuration</h3> </li></ol><hr />
<h2 id="Comments">Comments</h2>
<p>The file <em>etc-defauolts.d/qemu-ifup</em> is used for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> emulation with <em>qemu</em>. See <tt>man&nbsp;qemu</tt> for details. </p> <p>
<p>If you want to change some settings, you should do the following: </p>
<ol type="1">
<li><p>copy <em>etc-defaults.d/qemu-ifup</em> file to <em>etc-local.d/</em> </p>
</li>
<li><p>change <em>etc-local.d/qemu-ifup</em> according to your needs </p>
</li>
</ol>
</div>
</div>

108
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxDevCustomConfigure.html
View file

@ -1,60 +1,60 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Overview&weblang=de">Overview</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Locations&weblang=de">Locations</a></li>
<a href="#head-eaec6be4efea7b38c41712778bfd4fb8d2827d3c">Overview</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Examples&weblang=de">Examples</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Comments&weblang=de">Comments</a></li>
<li>
<a href="#head-51173f0423ca91d36cd0cfcdc75a06d90cc087ee">Locations</a>
</li>
<li>
<a href="#head-9b9b6463081c4d9d13e3aadebe9daaf61fa67b5c">Examples</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a></em> </p>
<h2 id="head-eaec6be4efea7b38c41712778bfd4fb8d2827d3c">Overview</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a>)
<p>You may change nearly every aspect of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> by using the custom configuration hook directory. </p> </p>
<p>Any script inside of this directory will be executed after the default configuration procedure (see <a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow&weblang=de">CryptoBoxDevWorkFlow</a>). </p> <hr />
<p>The order of execution is defined by the names of the scripts (alphabetically). </p> <h1 id="CustomconfigurationoftheCryptoBox">Custom configuration of the CryptoBox</h1>
<h2 id="Overview">Overview</h2>
<h2 id="head-51173f0423ca91d36cd0cfcdc75a06d90cc087ee">Locations</h2> <p>
You may change nearly every aspect of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> by using the custom configuration hook directory.
<p>Some example customization scripts can be found in <em>configure-examples.d/</em>. </p> </p>
<p>You may put your scripts into <em>configure-local.d/</em>. They will be sourced by <em>cbox-build.sh</em>. </p> <p>
Any script inside of this directory will be executed after the default configuration procedure (see <a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow&weblang=de">CryptoBoxDevWorkFlow</a>).
<h2 id="head-9b9b6463081c4d9d13e3aadebe9daaf61fa67b5c">Examples</h2> </p>
<p>
<p>The examples in <em>configure-examples.d/</em> can be copied to <em>configure-local.d/</em> and adjusted to your needs. </p> The order of execution is defined by the names of the scripts (alphabetically).
<dl> </p>
<dt>set_default_ip</dt> <h2 id="Locations">Locations</h2>
<dd><p>change the default IP address of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> </p> <p>
</dd> Some example customization scripts can be found in <a href="/trac/cryptobox/browser/trunk/configure-examples.d">configure-examples.d/</a>.
<dt>set_default_language</dt> </p>
<dd><p>set the default language </p> <p>
</dd> You may put your scripts into <i>configure-local.d/</i>. They will be sourced by <a href="/trac/cryptobox/browser/trunk/scripts/cbox-build.sh">cbox-build.sh</a>.
<dt>set_default_timeout</dt> </p>
<dd><p>set the default idle time for automatic unmounting </p> <h2 id="Examples">Examples</h2>
</dd> <p>
<dt>set_hostname</dt> The examples in <a href="/trac/cryptobox/browser/trunk/configure-examples.d">configure-examples.d/</a> can be copied to <i>configure-local.d/</i> and adjusted to your needs.
<dd><p>change the default hostname </p> </p>
</dd> <table class="wiki">
<dt>set_root_pw</dt> <tr><td>set_default_ip</td><td>change the default IP address of the CryptoBox
<dd><p>change the password of root (only useful for a development <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>) </p> </td></tr><tr><td>set_default_language</td><td>set the default language
</dd> </td></tr><tr><td>set_default_timeout</td><td>set the default idle time for automatic unmounting
<dt>import_authorized_keys</dt> </td></tr><tr><td>set_hostname</td><td>change the default hostname
<dd><p>upload a <em>ssh</em> key for passwordless access to a development <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> </p> </td></tr><tr><td>set_root_pw</td><td>change the password of root (only useful for a development <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>)
</dd> </td></tr><tr><td>import_authorized_keys</td><td>upload a <i>ssh</i> key for passwordless access to a development CryptoBox
<dt>set_scan_devices</dt> </td></tr><tr><td>set_scan_devices</td><td>where to look for usable harddisks
<dd><p>where to look for usable harddisks </p> </td></tr></table>
</dd> <hr />
</dl> <h2 id="Comments">Comments</h2>
<p>
</div>
</div>

70
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxDevKnownProblems.html
View file

@ -1,36 +1,46 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#qemu&weblang=de">qemu</a></li>
<li> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#interleavedfilesnotyetsupported&weblang=de">interleaved files not (yet) supported</a></li>
<a href="#head-3d279b986395c95455d4d831054f9664ac846790">qemu</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#smbdsegfault&weblang=de">smbd: segfault</a></li>
<ol> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#dfsbuild&weblang=de">dfsbuild</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#cantcdto_builddirtargetvarlibaptlists&weblang=de">can't cd to _builddir/target/var/lib/apt/lists</a></li>
<li> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#Comments&weblang=de">Comments</a></li>
<a href="#head-9d223a1d9ee655c5a338f798fc08850a2b3694ba">interleaved files not (yet) supported</a>
</li>
<li>
<a href="#head-aa082f09cdb79c9a715826562efebd23cb8e9dfc">smbd: segfault</a>
</li>
</ol> </ol>
</div>
</li> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a>)
</ol> </p>
<p> </p> <hr />
<hr> <h1 id="Knownproblems">Known problems</h1>
<p> </p> <h2 id="qemu">qemu</h2>
<h3 id="interleavedfilesnotyetsupported">interleaved files not (yet) supported</h3>
<h2 id="head-3d279b986395c95455d4d831054f9664ac846790">qemu</h2> <p>
You should update <i>qemu</i> to version 0.7 or higher.
</p>
<h3 id="head-9d223a1d9ee655c5a338f798fc08850a2b3694ba">interleaved files not (yet) supported</h3> <h3 id="smbdsegfault">smbd: segfault</h3>
<p>
<p>You should update <em>qemu</em> to version 0.7 or higher. </p> This happens under certain circumstances. We do not know a solution for this problem.
</p>
<h3 id="head-aa082f09cdb79c9a715826562efebd23cb8e9dfc">smbd: segfault</h3> <h2 id="dfsbuild">dfsbuild</h2>
<h3 id="cantcdto_builddirtargetvarlibaptlists">can't cd to _builddir/target/var/lib/apt/lists</h3>
<p>This happens under certain circumstances. We do not know a solution for this problem. </p> <p>
This can be caused by a (strange) mix of debian package versions. Track this bug at <a class="ext-link" title="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991" href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991</a>.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

147
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxDevPreparation.html
View file

@ -1,86 +1,77 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Softwarerequirements&weblang=de">Software requirements</a></li>
<li> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Packages&weblang=de">Packages</a></li>
<a href="#head-5b50aeed8139c95e5a2670d4248978d942c5edd6">Software requirements</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Kernel&weblang=de">Kernel</a></li>
<ol> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Getthesource&weblang=de">Get the source</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Firstbuild&weblang=de">First build</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Finished&weblang=de">Finished</a></li>
<a href="#head-143e3ec00a024bf2d9486f21dccab7ddc0ac3709">Packages</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Comments&weblang=de">Comments</a></li>
</li>
<li>
<a href="#head-8abff5fecd19a74f1f5602aa82c8783c80b6862e">Kernel</a>
</li>
</ol> </ol>
</div>
<li>
<a href="#head-e988a63aa4744649892e3c85e239927edb01f336">Get the source</a>
</li>
<li>
<a href="#head-3b183abdfebed7afdbbdbb7625f85081882beb70">First build</a>
</li>
<li>
<a href="#head-08bd0ad2103b9f58bd026d64c0bcb333f3bbd90b">Finished</a>
</li>
</ol>
<p> </p>
<hr>
<p> </p>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a></em> </p>
<h2 id="head-5b50aeed8139c95e5a2670d4248978d942c5edd6">Software requirements</h2>
<h3 id="head-143e3ec00a024bf2d9486f21dccab7ddc0ac3709">Packages</h3>
<p>We use <a class="external" href="http://debian.org">Debian</a> as our development environment. This was a natural choice, as the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>-LiveCD is also based on Debian. Other distributions should work too, of course - <a class="interwiki" title="Acronym" href="http://www.acronymfinder.com/af-query.asp?String=exact&amp;Acronym=YMMV&weblang=de">YMMV</a>. </p>
<p>required: </p>
<ul>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=subversion">subversion</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=chroot">chroot</a> </p>
</li>
</ul>
<p>recommended: </p>
<ul>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a> or <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=approx">approx</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=qemu">qemu</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=curl">curl</a> </p>
</li>
</ul>
<h3 id="head-8abff5fecd19a74f1f5602aa82c8783c80b6862e">Kernel</h3>
<p>If you want to use <a class="external" href="http://fabrice.bellard.free.fr/qemu/">qemu</a> to test your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> in a virtual environment, then you will need the <em>tun/tap</em> kernel feature.
</p> </p>
<pre> <p>
CONFIG_TUN=m</pre> <strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev">CryptoBoxDev</a>, <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevWorkFlow&weblang=de">CryptoBoxDevWorkFlow</a>)
<h2 id="head-e988a63aa4744649892e3c85e239927edb01f336">Get the source</h2>
<p>Download the latest release from our <a class="external" href="http://subversion.tigris.org">subversion</a>-Repository:
</p> </p>
<pre> <hr />
svn checkout https://svn.systemausfall.org/svn/cryptobox/trunk </pre> <h1 id="Preparationsfordevelopers">Preparations for developers</h1>
<h2 id="Softwarerequirements">Software requirements</h2>
<h2 id="head-3b183abdfebed7afdbbdbb7625f85081882beb70">First build</h2> <h3 id="Packages">Packages</h3>
<p>
<p>run <tt>scripts/cbox-build.sh&nbsp;release</tt> as <em>root</em> - hopefully, there should be no errors <img src="/cryptobox-img/smile.png" alt=":)" height="15" width="15"> </p> We use <a class="ext-link" title="http://debian.org" href="http://debian.org">Debian</a> as our development environment. This was a natural choice, as the CryptoBox-LiveCD is also based on Debian. Other distributions should work too, of course - <i>your mileage may vary</i>.
<p>Hint: This step will fail, if you did not install <em>apt-cacher</em>. See <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=de">CryptoBoxDevCustomBuild</a> for details on how to change the build-configuration settings (in this case: <em>mirror</em> in <em>dfs-cbox.conf</em>). </p> </p>
<p>
<h2 id="head-08bd0ad2103b9f58bd026d64c0bcb333f3bbd90b">Finished</h2> required:
</p>
<p>Now you can start to pariticipate in the development of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> or simply customize your own <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>-LiveCD. </p> <ul><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>
<p>See <a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow">CryptoBoxDevWorkFlow</a> for details of how to use the developer's tools of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>. </p> </li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=subversion" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=subversion">subversion</a>
<p><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a> shows some examples for local customizations of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>. </p> </li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=chroot" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=chroot">chroot</a>
</li></ul><p>
recommended:
</p>
<ul><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy"> apt-proxy</a> or <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx">approx</a>
</li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=qemu" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=qemu">qemu</a>
</li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=curl" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=curl">curl</a>
</li></ul><h3 id="Kernel">Kernel</h3>
<p>
If you want to use <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu/" href="http://fabrice.bellard.free.fr/qemu/">qemu</a> to test your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> in a virtual environment, then you will need the <i>tun/tap</i> kernel feature.
</p>
<pre class="wiki">CONFIG_TUN=m
</pre><h2 id="Getthesource">Get the source</h2>
<p>
Download the latest release from our <a class="ext-link" title="http://subversion.tigris.org" href="http://subversion.tigris.org">subversion</a>-Repository:
</p>
<pre class="wiki">svn checkout https://svn.systemausfall.org/svn/cryptobox/trunk
</pre><h2 id="Firstbuild">First build</h2>
<p>
run <tt>scripts/cbox-build.sh release</tt> as <i>root</i> - hopefully, there should be no errors :)
</p>
<p>
Hint: This step will fail, if you did not install <i>apt-cacher</i>. See <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=de">CryptoBoxDevCustomBuild</a> for details on how to change the build-configuration settings (in this case: <i>mirror</i> in <i>dfs-cbox.conf</i>).
</p>
<h2 id="Finished">Finished</h2>
<p>
Now you can start to pariticipate in the development of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> or simply customize your own CryptoBox-LiveCD.
</p>
<p>
See <a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow">CryptoBoxDevWorkFlow</a> for details of how to use the developer's tools of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>.
</p>
<p>
<a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a> shows some examples for local customizations of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

123
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxDevValidation.html
View file

@ -1,57 +1,78 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Overview&weblang=de">Overview</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Validate&weblang=de">Validate</a></li>
<a href="#head-5e20146fd39363329427c6251209cccb8d374f3e">Overview</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Howtocreateatest&weblang=de">How to create a test</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Comments&weblang=de">Comments</a></li>
<li>
<a href="#head-6e1d416048c4d8ebfb5b3919b4d924c77e652a7b">Validate</a>
</li>
<li>
<a href="#head-5634566bd24f83d397b43525fc62685f6e678fbf">How to create a test</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a></em> </p>
<h2 id="head-5e20146fd39363329427c6251209cccb8d374f3e">Overview</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a>)
<p>The validation feature allows to check the programming logic of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>. A lot of test cases are defined to test as many functions of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> as possible. </p> </p>
<p>The requests are processed with <a class="external" href="http://curl.haxx.se/">curl</a>. </p> <hr />
<p>The received web page is saved to allow a later design review or css debugging. </p> <h1 id="ValidationoftheCryptoBox">Validation of the CryptoBox</h1>
<p>The current state of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> is represented by ten single values (e.g.: <em>box is configured</em>, <em>IP of the box</em>, <em>current language setting</em>, ...), which are invisibly a part of each html page (as comments). The returned status of every request is compared to the predicted value of the test case. </p> <h2 id="Overview">Overview</h2>
<p>Similar test cases are pooled into test groups (e.g.: <em>initialization</em>, <em>configuration</em> and <em>mounting</em>). </p> <p>
The validation feature helps you to check the programming logic of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>. A lot of test cases are defined to verify as many functions of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> as possible.
<h2 id="head-6e1d416048c4d8ebfb5b3919b4d924c77e652a7b">Validate</h2> </p>
<p>
<p>Run <tt>scripts/validate.sh&nbsp;check_all</tt> to conduct all tests of all groups. See <tt>scripts/validate.sh&nbsp;help</tt> for other actions. </p> The requests are processed with <a class="ext-link" title="http://curl.haxx.se/" href="http://curl.haxx.se/">curl</a>.
<p>The results will be saved in <em>validation/report</em>. </p> </p>
<p>In addition to every single retrieved page, a html page called <em>summary.html</em> is created, which contains the state checks of all tests in a group. </p> <p>
The received web page is saved to allow a later design review or css debugging.
<h2 id="head-5634566bd24f83d397b43525fc62685f6e678fbf">How to create a test</h2> </p>
<p>
<p>All test cases can be found in <em>validation/test-cases</em>. </p> The current state of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> is represented by ten single values (e.g.: <i>box is configured</i>, <i>IP of the box</i>, <i>current language setting</i>, ...), which are invisibly a part of each html page (as comments). The returned status of every request is compared to the predicted value of the test case.
<p>Every test consists of: </p> </p>
<dl> <p>
<dt>input.curl</dt> Similar test cases are pooled into test groups (e.g.: <i>initialization</i>, <i>configuration</i> and <i>mounting</i>).
<dd><p>the configuration file for the <em>curl</em> request </p> </p>
</dd> <h2 id="Validate">Validate</h2>
<dt>output</dt> <p>
<dd><p>the predicted state of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> after the call </p> Run <i><a href="/trac/cryptobox/browser/trunk/scripts/validate.sh">scripts/validate.sh</a>]</i> to conduct all tests of all groups. See <i>scripts/validate.sh help</i> for other actions.
</dd> </p>
<dt>description</dt> <p>
<dd><p>a short description of the test (will be used for the summary) </p> The results will be saved in <i>validation/report</i>.
</dd> </p>
<dt>delay</dt> <p>
<dd><p>[optional] time to wait after this test </p> In addition to every single retrieved page, a html page called <i>summary-?.html</i> is created, which contains the state checks of all tests in a group.
</dd> </p>
</dl> <h2 id="Howtocreateatest">How to create a test</h2>
<p>Use the existing test cases as templates for new tests. </p> <p>
<p>Any logical path of the web interface CGI should be validated by a test case. </p> All test cases can be found in <i>validation/test-cases</i>.
</p>
<p>
Every test consists of the following files:
</p>
<table class="wiki">
<tr><td>input.curl</td><td>the configuration file for the <i>curl</i> request
</td></tr><tr><td>output</td><td>the predicted state of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> after the call
</td></tr><tr><td>description</td><td>a short description of the test (will be used for the summary)
</td></tr><tr><td>delay</td><td>[optional] time to wait after this test
</td></tr></table>
<p>
Use the existing test cases as templates for new tests.
</p>
<p>
Read <a href="/trac/cryptobox/browser/trunk/validation/test-cases/README">validation/test-cases/README</a> for details.
</p>
<p>
Every logical path of the web interface CGI should be validated by a test case.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

284
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxDevWorkFlow.html
View file

@ -1,145 +1,151 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Preparations&weblang=de">Preparations</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#CreateaCryptoBoxLiveCD&weblang=de">Create a CryptoBox-LiveCD</a></li>
<a href="#head-adacf7a8271d3f6fe8bdfb9773ac3b1f4b050f9a">Preparations</a> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Buildthebasesystem&weblang=de">Build the base system</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Configurethebaseimage&weblang=de">Configure the base image</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Removedevelopmentfeatures&weblang=de">Remove development features</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Createanisoimage&weblang=de">Create an iso image</a></li>
<a href="#head-61cec4152bb64ed5799ae7422f7150a4e3bc4860">Create a CryptoBox-LiveCD - step by step</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#BurntheCD&weblang=de">Burn the CD</a></li>
<ol> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#TesttheCryptoBoxLiveCD&weblang=de">Test the CryptoBox-LiveCD</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Chrootquickampdirtytests&weblang=de">Chroot: quick &amp; dirty tests</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Qemunearlycompleteemulation&weblang=de">Qemu: nearly complete emulation</a></li>
<a href="#head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</a> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Debuggingandmerging&weblang=de">Debugging and merging</a></li>
</li> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Developmentonarunningsystem&weblang=de">Development on a running system</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Uploadinganewrelease&weblang=de">Uploading a new release</a></li>
<li> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Comments&weblang=de">Comments</a></li>
<a href="#head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</a>
</li>
<li>
<a href="#head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</a>
</li>
<li>
<a href="#head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</a>
</li>
<li>
<a href="#head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</a>
</li>
</ol> </ol>
</div>
<li> </p>
<a href="#head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</a> <p>
<ol> <strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev">CryptoBoxDev</a>, <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure">CryptoBoxDevCustomConfigure</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevPreparation&weblang=de">CryptoBoxDevPreparation</a>)
<li> </p>
<a href="#head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick &amp; dirty tests</a> <hr />
</li> <h1 id="Developmentworkflow">Development workflow</h1>
<h2 id="Preparations">Preparations</h2>
<li> <p>
<a href="#head-2278b94f0a24871a501d80c4e6e0c53d1f5621ca">Qemu: nearly complete emulation</a> You should have completed the steps described in <a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=de">CryptoBoxDevPreparation</a>.
</li> </p>
<h2 id="CreateaCryptoBoxLiveCD">Create a CryptoBox-LiveCD</h2>
</ol> <p>
The following steps can be executed in the order of their appearance.
<li> </p>
<a href="#head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</a> <p>
<ol> Usually there is no need to repeat the whole process, after you changed some parts of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>. Especially the first step (building of the base system with <i>dfsbuild</i>) may usually be skipped.
</p>
<li> <p>
<a href="#head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</a> Every step of the building process must be executed as <i>root</i>.
</li> </p>
<h3 id="Buildthebasesystem">Build the base system</h3>
<li> <p>
<a href="#head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</a> Run <i>scripts/cbox-build.sh dfsbuild</i> to create the base system for the LiveCD.
</li> </p>
<p>
</ol> The result can be found in <i>_builddir/cd1/image</i>.
</p>
</li> <p>
If you do not want to use the <i><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a> to save bandwidth and time, then you should modify the </i>mirror<i>-setting in <a href="/trac/cryptobox/browser/trunk/etc-default.d/dfs-cbox.conf">dfs-cbox.conf</a> (see <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=de">CryptoBoxDevCustomBuild</a> for details).</i>
</ol> </p>
<p> </p> <h3 id="Configurethebaseimage">Configure the base image</h3>
<hr> <p>
<p> </p> Run <i>scripts/cbox-build.sh config</i> to copy the CryptoBox-specific files to the base image.
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=de">CryptoBoxDev</a></em> </p> </p>
<p>
<h2 id="head-adacf7a8271d3f6fe8bdfb9773ac3b1f4b050f9a">Preparations</h2> TODO: link to cbox-build.sh-manpage
</p>
<p>You should have completed the steps described in <a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=de">CryptoBoxDevPreparation</a>. </p> <h3 id="Removedevelopmentfeatures">Remove development features</h3>
<p>
<h2 id="head-61cec4152bb64ed5799ae7422f7150a4e3bc4860">Create a CryptoBox-LiveCD - step by step</h2> The original base system, that was created by <i>dfsbuild</i> contains a lot packages and some scripts, that are only useful during development. You should remove them, as they cause severe security implications.
</p>
<p>The following steps can be executed in the order of their appearance. </p> <p>
<p>Usually there is no need to repeat the whole process, after you changed some parts of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>. Especially the first step (building of the base system with <em>dfsbuild</em>) may usually be skipped. </p> To reduce the CryptoBox-LiveCD to the usable minimum for operational use, you should run <i>scripts/cbox-build.sh harden</i>.
<p>Every step of the building process must be executed as <em>root</em>. </p> </p>
<h3 id="Createanisoimage">Create an iso image</h3>
<h3 id="head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</h3> <p>
To burn a CryptoBox-LiveCD, you need an bootable <i>iso9660</i>-image.
<p>Run <tt>scripts/cbox-build.sh&nbsp;dfsbuild</tt> to create the base system for the LiveCD. </p> </p>
<p>The result can be found in <em>_builddir/cd1/image</em>. </p> <p>
<p>If you do not want to use the <em><a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;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 <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=de">CryptoBoxDevCustomBuild</a> for details). </p> Create the <i>iso</i> image with <i>scripts/cbox-build.sh iso</i>. The resulting file can be found at <i>_builddir/cd1/cryptobox.iso</i>.
</p>
<h3 id="head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</h3> <h3 id="BurntheCD">Burn the CD</h3>
<p>
<p>Run <tt>scripts/cbox-build.sh&nbsp;config</tt> to copy the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>-specific files to the base image. </p> Do it manually:
<p>TODO: link to cbox-build.sh-manpage </p> </p>
<pre class="wiki">cdrecord -v dev=0,0,0 _builddir/cryptobox.iso
<h3 id="head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</h3> </pre><p>
(change the <i>dev</i> setting according to your setup).
<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>
<p>To reduce the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>-LiveCD to the usable minimum for operational use, you should run <tt>scripts/cbox-build.sh&nbsp;harden</tt>. </p> <p>
Let the script do it for you: <i>scripts/cbox-build.sh burn</i> (maybe you have to change the <i>CDWRITER</i> setting in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/cbox-dev.conf">cbox-dev.conf</a> - see <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=de">CryptoBoxDevCustomBuild</a>).
<h3 id="head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</h3> </p>
<p>
<p>To burn a <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>-LiveCD, you need an bootable <em>iso9660</em>-image. </p> Of course, it is not wise to use CD-R media. CD-RW consume less resources.
<p>Create the <em>iso</em> image with <tt>scripts/cbox-build.sh&nbsp;iso</tt>. The resulting file can be found at <em>_builddir/cd1/cryptobox.iso</em>. </p> </p>
<h2 id="TesttheCryptoBoxLiveCD">Test the CryptoBox-LiveCD</h2>
<h3 id="head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</h3> <p>
This section is only useful for developers, who want to improve or change the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system.
<p>Do it manually: <tt>cdrecord&nbsp;-v&nbsp;dev=0,0,0&nbsp;_builddir/cd1/cryptobox.iso</tt> (change the <em>dev</em> setting according to your setup). </p> </p>
<p>Let the script do it for you: <tt>scripts/cbox-build.sh&nbsp;burn</tt> (maybe you have to change the <em>CDWRITER</em> setting in <em>cbox-dev.conf</em> - see <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=de">CryptoBoxDevCustomBuild</a>). </p> <h3 id="Chrootquickampdirtytests">Chroot: quick &amp; dirty tests</h3>
<p>Of course, it is not wise to use CD-R media. CD-RW consume less resources. </p> <p>
If you modified the <i>perl</i>- or <i>shell</i>-scripts of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>, then you can check for syntax errors by running them in a <i>chroot</i> environment. Be careful: you have access to all ressources of your computer, while you are working within a <i>chroot</i> environment - so you can easily repartition your real disk ...
<h2 id="head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</h2> </p>
<p>
<p>This section is only useful for developers, who want to improve or change the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system. </p> To start a <i>chroot</i> environment, you can execute <i>scripts/cbox-dev.sh chroot</i>.
</p>
<h3 id="head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick &amp; dirty tests</h3> <p>
For more intensive tests, you may use <i>qemu</i> (see below) or burn real LiveCDs - of course this would take much more time.
<p>If you modified the <em>perl</em>- or <em>shell</em>-scripts of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">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>
<p>To start a <em>chroot</em> environment, you can execute <tt>scripts/cbox-dev.sh&nbsp;chroot</tt>. </p> <h3 id="Qemunearlycompleteemulation">Qemu: nearly complete emulation</h3>
<p>For more intensive tests, you may use <em>qemu</em> (see below) or burn real LiveCDs - of course this would take much more time. </p> <p>
The processor emulator <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu" href="http://fabrice.bellard.free.fr/qemu">qemu</a> allows you test the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">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.
<h3 id="head-2278b94f0a24871a501d80c4e6e0c53d1f5621ca">Qemu: nearly complete emulation</h3> </p>
<p>
<p>The processor emulator <a class="external" href="http://fabrice.bellard.free.fr/qemu">qemu</a> allows you test the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">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> Beware - there are some problems, when using <i>qemu</i>:
<p>Beware - there are some problems, when using <em>qemu</em>: </p> </p>
<ul> <ul><li><i>smbd</i> does not start (segfault)
<li><p> <em>smbd</em> does not start (segfault) </p> </li><li>???
</li> </li></ul><p>
<li><p> ??? </p> To start a <i>qemu</i> emulation of the <i>iso</i> image, you may type:
</li> </p>
</ul> <pre class="wiki">scripts/cbox-dev.sh qemu
<p>To start a <em>qemu</em> emulation of the <em>iso</em> image, you may type: <tt>scripts/cbox-dev.sh&nbsp;qemu</tt>. </p> </pre><h2 id="Debuggingandmerging">Debugging and merging</h2>
<p>
<h2 id="head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</h2> This section is only useful for developers, who want to develop on a running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system (emulated or real).
</p>
<p>This section is only useful for developers, who want to develop on a running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system (emulated or real). </p> <p>
<p>You may access the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> directly or you can use <em>ssh</em> to open a remote session (<tt>./cbox-dev.sh&nbsp;ssh</tt>). </p> You may access the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> directly or you can use <i>ssh</i> to open a remote session:
</p>
<h3 id="head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</h3> <pre class="wiki">./cbox-dev.sh ssh
</pre><h3 id="Developmentonarunningsystem">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>
<p>Type <tt>scripts/cbox-dev.sh&nbsp;diff</tt> to see the changes, you made on the running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system. </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>Type <tt>scripts/cbox-dev.sh&nbsp;merge</tt> to merge these changes to your local working copy. </p> </p>
<p>
<h3 id="head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</h3> Type <i>scripts/cbox-dev.sh diff</i> to see the changes, you made on the running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system.
</p>
<p>Alternatively you may also upload a new version of your local working copy to the running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system. </p> <p>
<p>Type <tt>scripts/cbox-dev.sh&nbsp;upload</tt> - beware: all recent changes you made to the running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system, are lost. </p> Type <i>scripts/cbox-dev.sh merge</i> to merge these changes to your local working copy.
</p>
<h3 id="Uploadinganewrelease">Uploading a new release</h3>
<p>
Alternatively you may also upload a new version of your local working copy to the running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system.
</p>
<p>
Type <i>scripts/cbox-dev.sh upload</i> - beware: all recent changes you made to the running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> system, are lost.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

81
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxUser.html
View file

@ -1,36 +1,59 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#Wiegehteslos&weblang=de">Wie geht es los</a></li>
<li> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#ErsteSchritte&weblang=de">Erste Schritte</a></li>
<a href="#head-b4f553dcadf3130f124c0f37db39f22aa9c2fd40">Nutzerhandbuch</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#HinweiseFallstricke&weblang=de">Hinweise / Fallstricke</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#Kommentare&weblang=de">Kommentare</a></li>
<li>
<a href="#head-07a5b2b75517ef9f7efaa9fbcde38d802a2bee14">Fragen</a>
</li>
</ol> </ol>
<p> </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#DieKonfigurationdeinerCryptoBox&weblang=de">Die Konfiguration deiner CryptoBox</a></li>
<hr> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#berblick&weblang=de">Überblick</a></li>
<p> </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Vorwort&weblang=de">Vorwort</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Initialisierung&weblang=de">Initialisierung</a></li>
<h2 id="head-b4f553dcadf3130f124c0f37db39f22aa9c2fd40">Nutzerhandbuch</h2> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Konfiguration&weblang=de">Konfiguration</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#HinweiseFallstricke&weblang=de">Hinweise / Fallstricke</a></li>
<p>Die folgenden Seiten beschreiben die Nutzung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>. </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Kommentare&weblang=de">Kommentare</a></li>
<p>Die online-Version dieses Handbuchs ist ein Wiki. Das bedeutet, dass du diese Seiten verändern kannst. Falls du also Fragen oder Anregungen hast, schreibe bitte deine Anmerkungen in den Fragen-Abschnitt am Ende der jeweiligen Seite. Die Entwickler werden deine Fragen beantworten und das Handbuch schnellstmöglich aktualisieren. Auf diese Art und Weise kannst du die Nutzbarkeit der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> für alle Nutzer verbessern! </p>
<ol type="1">
<li><p><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted&weblang=de">CryptoBoxUserGettingStarted/de</a> -- die Vorbereitung der Hardware </p>
</li>
<li><p><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration&weblang=de">CryptoBoxUserConfiguration/de</a> -- die Einrichtung deines neuen verschlüsselten Dateiservers </p>
</li>
<li><p><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse">CryptoBoxUserDailyUse/de</a> -- die tägliche Nutzung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> </p>
</li>
</ol> </ol>
<p>Die online-Version dieses Handbuchs befindet sich unter <a href="https://systemausfall.org/toolforge/CryptoBoxUser/de">https://systemausfall.org/toolforge/CryptoBoxUser/de</a>. </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#TglicheNutzung&weblang=de">Tägliche Nutzung</a></li>
<hr> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#AktivierendesverschlsseltenDateisystems&weblang=de">Aktivieren des verschlüsselten Dateisystems</a></li>
<p> </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#ZugriffaufdieverschlsseltenDaten&weblang=de">Zugriff auf die verschlüsselten Daten</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#AbschaltendesverschlsseltenDateisystems&weblang=de">Abschalten des verschlüsselten Dateisystems</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#AbschaltungderCryptoBox&weblang=de">Abschaltung der CryptoBox</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#NotfallAbschaltung&weblang=de">Notfall-Abschaltung</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#FragenundAntworten&weblang=de">Fragen und Antworten</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Kommentare&weblang=de">Kommentare</a></li>
</ol>
</ol>
</div>
<h2 id="head-07a5b2b75517ef9f7efaa9fbcde38d802a2bee14">Fragen</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox/de</a>)
</p>
<hr />
<h1 id="Nutzerhandbuch">Nutzerhandbuch</h1>
<p>
Die folgenden Seiten beschreiben die Nutzung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>.
</p>
<p>
Die online-Version dieses Handbuchs ist ein Wiki. Das bedeutet, dass du diese Seiten verändern kannst. Falls du also Fragen oder Anregungen hast, schreibe bitte deine Anmerkungen in den Kommentar-Abschnitt am Ende der jeweiligen Seite. Die Entwickler werden deine Fragen beantworten und das Handbuch schnellstmöglich aktualisieren. Auf diese Art und Weise kannst du die Nutzbarkeit der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> für alle Nutzer verbessern!
</p>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted&weblang=de">CryptoBoxUserGettingStarted</a> -- die Vorbereitung der Hardware
</li><li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration&weblang=de">CryptoBoxUserConfiguration</a> -- die Einrichtung deines neuen verschlüsselten Dateiservers
</li><li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse">CryptoBoxUserDailyUse</a> -- die tägliche Nutzung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>
</li></ol><p>
Die online-Version dieses Handbuchs befindet sich unter <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/de" href="https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/de">https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/de</a>.
</p>
<hr />
<p>
</div>
</div>

221
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxUserConfiguration.html
View file

@ -1,124 +1,109 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#berblick&weblang=de">Überblick</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Vorwort&weblang=de">Vorwort</a></li>
<a href="#head-35bb35adbe80b0a88ba66e8186bc7c46f59699e5">Überblick</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Initialisierung&weblang=de">Initialisierung</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Konfiguration&weblang=de">Konfiguration</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#HinweiseFallstricke&weblang=de">Hinweise / Fallstricke</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Kommentare&weblang=de">Kommentare</a></li>
<a href="#head-cd2ed4cc5bdf6df848ffd9217e4d42715c08d23f">Vorwort</a>
</li>
<li>
<a href="#head-0ff8fb8aca8fc8e46863381930f367463ffe9ce5">Initialisierung</a>
</li>
<li>
<a href="#head-5015302b5a3fd8a1ae2a63ea7f0cbce5aebaa451">Konfiguration</a>
</li>
<li>
<a href="#head-fd34c5c4d9612568c9f2d2be251e9eb43d574c52">Hinweise / Fallstricke</a>
</li>
<li>
<a href="#head-dde63a967ebf4ea45fc857ec32d8e6d258545e70">Fragen</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-35bb35adbe80b0a88ba66e8186bc7c46f59699e5">Überblick</h2> </p>
<p>
<p>Alle Funktionen der <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> können durch das komfortable Web-Interface bedient werden. Zur Erst-Einrichtung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> folge einfach den folgenden Schritten. </p> <strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser/de</a>)
<p>Falls du in Eile bist, kannst du das <em>Vorwort</em> überspringen. </p>
<p>Die <em>Initialisierung</em> erklärt die Einrichtung der Festplatte. Dieser Schritt ist nur bei der ersten Einrichtung oder nach einem Festplattenwechsel notwendig. </p>
<p>Im <em>Konfigurations</em>-Abschnitt werden die verfügbaren Einstellungen der <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> beschrieben. Hier kannst du beispielsweise die Sprache des Web-Interfaces oder die Netzwerkadresse deiner <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> einstellen. </p>
<p>Vergiss nicht, auch den <em>Hinweise/Fallstricke</em>-Abschnitt zu lesen. </p>
<h2 id="head-cd2ed4cc5bdf6df848ffd9217e4d42715c08d23f">Vorwort</h2>
<p>Du bist den Anweisungen aus <a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted">CryptoBoxUserGettingStarted/de</a> gefolgt und sitzt nun vor deinem Arbeits-Rechner. Nun kannst du in deinem Web-Browser das Web-Interface der <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> ansteuern: <em><a href="https://192.168.0.23&weblang=de">https://192.168.0.23</a></em>. </p>
<p>Bevor du Daten auf deiner <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> speichern kannst, muss die Festplatte mit einem verschlüsselten Dateisystem versehen werden. Das klingt kompliziert, ist jedoch mit einem Klick erledigt. <img src="/cryptobox-img/smile.png" alt=":)" height="15" width="15&weblang=de"> </p>
<h2 id="head-0ff8fb8aca8fc8e46863381930f367463ffe9ce5">Initialisierung</h2>
<p>Klickke auf <em>Initialisierung</em> in der Menü-Zeile. </p>
<p>Jetzt wirst du zur Eingabe zweier Passworte aufgefordert (jeweils mit Wiederholung - zum Training deiner Tipp-Fertigkeiten ;)). </p>
<p><img src="/toolforge/CryptoBoxUserConfiguration/de?action=AttachFile&amp;do=get&amp;target=init_de.png" alt="init_de.png"> </p>
<ul>
<li><p> Das erste Passwort ist das <em>Administrations-Password</em>. </p>
<ul>
<li><p> Es schützt die Konfiguration deiner <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>. </p>
</li>
<li><p> Dies ist notwendig, um zu verhindern, dass jemand unerlaubt die Daten auf deiner <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> durch eine erneute Initialisierung löscht. </p>
</li>
<li><p> Wahrscheinlich wirst du dieses Passwort nie wieder benötigen. </p>
</li>
<li><p> Du kannst das Administrations-Passwort leer lassen - dies wird jedoch nicht empfohlen. </p>
</li>
</ul>
</li>
<li><p> Das <em>Crypto-Passwort</em> ist wesentlich wichtiger, da es der einzige Schutz der Daten auf der verschlüsselten Festplatte ist. Wähle es mit Sorgfalt! </p>
<ul>
<li><p> Du benötigst es, um auf deine Daten zuzugreifen. </p>
</li>
<li><p> Ein sicheres Passwort sollte aus mindestens 15 Zeichen (einschließlich Ziffern und Sonderzeichen) bestehen. Die Sicherheit deiner Daten steht und fällt mit der Qualität dieses Passworts. </p>
</li>
</ul>
</li>
<li><p> Um dich daran zu erinnern, dass dieser Schritt die Festplatte der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> komplett löschen wird, musst du den angezeigten roten Warnhinweis im letzten Formularfeld eingeben. </p>
</li>
<li><p> Nun kannst du die Initialisierung durch einen Klick auf <em>Initialisiere die <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a></em> abschließen. </p>
</li>
</ul>
<p>Das war es dann auch schon. Cryptographie war wohl nie einfacher zu verwenden, oder? <img src="/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
<p>Der Initialisierungsvorgang läuft nun im Hintergrund ab und wird nach wenigen Minuten (abhängig von der Größe deiner Festplatte) abgeschlossen. </p>
<h2 id="head-5015302b5a3fd8a1ae2a63ea7f0cbce5aebaa451">Konfiguration</h2>
<p>Im Gegensatz zur Initialisierung, die nur einmal durchgeführt werden muss, kannst du die Konfiguration jederzeit deinen Wünschen anpassen. Dazu klickst du einfach auf <em>Konfiguration</em> in der Menü-Zeile des Web-Interfaces. Nun wird dir ein Formular mit vier Feldern präsentiert: </p>
<p><img src="/toolforge/CryptoBoxUserConfiguration/de?action=AttachFile&amp;do=get&amp;target=config_de.png" alt="config_de.png"> </p>
<ul>
<li><p> Falls du ein Administrator-Passwort während der <em>Initialisierung</em> festgelegt hast, musst du es nun eingeben. Andernfalls wird dieses Formularfeld nicht angezeigt. </p>
</li>
<li><p> Du kannst die voreingestellte Netzwerk-Adresse (IP) verändern, falls sie nicht zu deiner Netzwerk-Struktur passt. </p>
</li>
<li><p> Die Zeitabschaltung sorgt dafür, dass nach einer festgelegten Dauer von Inaktivität (in Minuten), das Crypto-Dateisystem deaktiviert wird (damit sind deine Daten wieder geschützt). Laufende Dateiübertragungen werden dadurch natürlich nicht gestört. </p>
<ul>
<li><p> Es ist ratsam, eine kurze Abschalt-Zeit einzustellen (wenige Minuten). </p>
</li>
<li><p> Der Wert <em>0</em> deaktiviert die automatische Abschaltung. </p>
</li>
</ul>
</li>
<li><p> Die Sprache ist der Standard für alle Nutzer des <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>-Web-Interfaces. Sie kann individuell durch die Sprach-Links am rechten oberen Bildschirmrand überschrieben werden. </p>
</li>
</ul>
<p>Speichere deine neuen Einstellungen durch einen Klick auf <em>Speichere Konfiguration</em>. </p>
<p>Das ist alles - deine <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> ist jetzt bereit für die <a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse&weblang=de">tägliche Nutzung</a>! </p>
<h2 id="head-fd34c5c4d9612568c9f2d2be251e9eb43d574c52">Hinweise / Fallstricke</h2>
<ul>
<li><p> Alle Daten auf der Festplatte in der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> werden bei der Initialisierung gelöscht. </p>
</li>
<li><p> Die Passworte müssen jeweils zweimal eingegeben werden, um die Gefahr von Tipp-Fehlern zu vermindern. </p>
</li>
<li><p> Das optionale Administrations-Passwort ist nur für die Konfiguration oder eine erneute Initialisierung erforderlich. </p>
</li>
<li><p> Das Crypto-Passwort beschützt deine sensiblen Daten. </p>
</li>
<li><p> Falls die <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> nicht über die Adresse <em>192.168.0.23</em> erreichbar ist, musst du die Netzwerk-Adresse deines Arbeits-Rechners für die Dauer der Initialisierung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> vorübergehend ändern. </p>
</li>
</ul>
<p><em>zurück zu <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser/de</a></em> </p>
<hr>
<p> </p>
<h2 id="head-dde63a967ebf4ea45fc857ec32d8e6d258545e70">Fragen</h2>
</p>
<hr />
<h1 id="DieKonfigurationdeinerCryptoBox">Die Konfiguration deiner CryptoBox</h1>
<h2 id="berblick">Überblick</h2>
<p>
Alle Funktionen der <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> können durch das komfortable Web-Interface bedient werden. Zur Erst-Einrichtung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> folge einfach den folgenden Schritten.
</p>
<p>
Falls du in Eile bist, kannst du das <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Vorwort&weblang=de">Vorwort</a> überspringen.
</p>
<p>
Die <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Initialisierung&weblang=de">Initialisierung</a> erklärt die Einrichtung der Festplatte. Dieser Schritt ist nur bei der ersten Einrichtung oder nach einem Festplattenwechsel notwendig.
</p>
<p>
Im <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Konfiguration">Konfigurations</a>-Abschnitt werden die verfügbaren Einstellungen der <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> beschrieben. Hier kannst du beispielsweise die Sprache des Web-Interfaces oder die Netzwerkadresse deiner <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> einstellen.
</p>
<p>
Vergiss nicht, auch den <i><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#HinweiseFallstricke&weblang=de">Hinweise/Fallstricke</a></i>-Abschnitt zu lesen.
</p>
<h2 id="Vorwort">Vorwort</h2>
<p>
Du bist den Anweisungen aus <a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted">CryptoBoxUserGettingStarted</a> gefolgt und sitzt nun vor deinem Arbeits-Rechner. Nun kannst du in deinem Web-Browser das Web-Interface der <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> ansteuern: <i><a class="ext-link" title="https://192.168.0.23" href="https://192.168.0.23&weblang=de">https://192.168.0.23</a></i>.
</p>
<p>
Bevor du Daten auf deiner <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> speichern kannst, muss die Festplatte mit einem verschlüsselten Dateisystem versehen werden. Das klingt kompliziert, ist jedoch mit einem Klick erledigt. :)
</p>
<h2 id="Initialisierung">Initialisierung</h2>
<p>
Klicke auf <i>Initialisierung</i> in der Menü-Zeile.
</p>
<p>
Jetzt wirst du zur Eingabe zweier Passworte aufgefordert (jeweils mit Wiederholung - zum Training deiner Tipp-Fertigkeiten ;)).
</p>
<p>
<a href='/cryptobox-img/screenshots/de_init.png' style='padding:0; border:none'><img src='/cryptobox-img/screenshots/de_init.png?format=raw' alt="de_init.png" title="de_init.png" style="" /></a>
</p>
<ul><li>Das erste Passwort ist das <i>Administrations-Password</i>.
<ul><li>Es schützt die Konfiguration deiner <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>.
</li><li>Dies ist notwendig, um zu verhindern, dass jemand unerlaubt die Daten auf deiner <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> durch eine erneute Initialisierung löscht.
</li><li>Wahrscheinlich wirst du dieses Passwort nie wieder benötigen.
</li><li>Du kannst das Administrations-Passwort leer lassen - dies wird jedoch nicht empfohlen.
</li></ul></li><li>Das <i>Crypto-Passwort</i> ist wesentlich wichtiger, da es der einzige Schutz der Daten auf der verschlüsselten Festplatte ist. Wähle es mit Sorgfalt!
<ul><li>Du benötigst es, um auf deine Daten zuzugreifen.
</li><li>Ein sicheres Passwort sollte aus mindestens 15 Zeichen (einschließlich Ziffern und Sonderzeichen) bestehen. Die Sicherheit deiner Daten steht und fällt mit der Qualität dieses Passworts.
</li></ul></li><li>Um dich daran zu erinnern, dass dieser Schritt die Festplatte der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> komplett löschen wird, musst du den angezeigten roten Warnhinweis im letzten Formularfeld eingeben.
</li><li>Nun kannst du die Initialisierung durch einen Klick auf <i>Initialisiere die CryptoBox</i> abschließen.
</li></ul><p>
Das war es dann auch schon. Kryptographie war wohl nie einfacher zu verwenden, oder? ;)
</p>
<p>
Der Initialisierungsvorgang läuft nun im Hintergrund ab und wird nach wenigen Minuten (abhängig von der Größe deiner Festplatte) abgeschlossen.
</p>
<h2 id="Konfiguration">Konfiguration</h2>
<p>
Im Gegensatz zur Initialisierung, die nur einmal durchgeführt werden muss, kannst du die Konfiguration jederzeit deinen Wünschen anpassen. Dazu klickst du einfach auf <i>Konfiguration</i> in der Menü-Zeile des Web-Interfaces. Nun wird dir ein Formular mit vier Feldern präsentiert:
</p>
<p>
<a href='/cryptobox-img/screenshots/de_config.png' style='padding:0; border:none'><img src='/cryptobox-img/screenshots/de_config.png?format=raw' alt="de_config.png" title="de_config.png" style="" /></a>
</p>
<ul><li>Falls du ein Administrator-Passwort während der <i>Initialisierung</i> festgelegt hast, musst du es nun eingeben. Andernfalls wird dieses Formularfeld nicht angezeigt.
</li><li>Du kannst die voreingestellte Netzwerk-Adresse (IP) verändern, falls sie nicht zu deiner Netzwerk-Struktur passt.
</li><li>Die Zeitabschaltung sorgt dafür, dass nach einer festgelegten Dauer von Inaktivität (in Minuten), das Crypto-Dateisystem deaktiviert wird (damit sind deine Daten wieder geschützt). Laufende Dateiübertragungen werden dadurch natürlich nicht gestört.
<ul><li>Es ist ratsam, eine kurze Abschalt-Zeit einzustellen (wenige Minuten).
</li><li>Der Wert <i>0</i> deaktiviert die automatische Abschaltung.
</li></ul></li><li>Die Sprache ist der Standard für alle Nutzer des CryptoBox-Web-Interfaces. Sie kann individuell durch die Sprach-Links am rechten oberen Bildschirmrand überschrieben werden.
</li></ul><p>
Speichere deine neuen Einstellungen durch einen Klick auf <i>Speichere Konfiguration</i>.
</p>
<p>
Das ist alles - deine <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> ist jetzt bereit für die <a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse&weblang=de">tägliche Nutzung</a>!
</p>
<h2 id="HinweiseFallstricke">Hinweise / Fallstricke</h2>
<ul><li>Alle Daten auf der Festplatte in der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> werden bei der Initialisierung gelöscht.
</li><li>Die Passworte müssen jeweils zweimal eingegeben werden, um die Gefahr von Tipp-Fehlern zu vermindern.
</li><li>Das optionale Administrations-Passwort ist nur für die Konfiguration oder eine erneute Initialisierung erforderlich.
</li><li>Das Crypto-Passwort beschützt deine sensiblen Daten.
</li><li>Falls die <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> nicht über die Adresse <i>192.168.0.23</i> erreichbar ist, musst du die Netzwerk-Adresse deines Arbeits-Rechners für die Dauer der Initialisierung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> vorübergehend ändern.
</li></ul><p>
<i>zurück zu <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser</a></i>
</p>
<hr />
<h2 id="Kommentare">Kommentare</h2>
<p>
</div>
</div>

175
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxUserDailyUse.html
View file

@ -1,63 +1,124 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#AktivierendesverschlsseltenDateisystems&weblang=de">Aktivieren des verschlüsselten Dateisystems</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#ZugriffaufdieverschlsseltenDaten&weblang=de">Zugriff auf die verschlüsselten Daten</a></li>
<a href="#head-58fa30bbb12b06f836481cac9c9759756d61b051">Aktivieren des verschlüsselten Dateisystems</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#AbschaltendesverschlsseltenDateisystems&weblang=de">Abschalten des verschlüsselten Dateisystems</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#AbschaltungderCryptoBox&weblang=de">Abschaltung der CryptoBox</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#NotfallAbschaltung&weblang=de">Notfall-Abschaltung</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#FragenundAntworten&weblang=de">Fragen und Antworten</a></li>
<a href="#head-d245bf35328e9999ee8b6010389160917e2c7fa6">Abschalten des verschlüsselten Dateisystems</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Kommentare&weblang=de">Kommentare</a></li>
</li>
<li>
<a href="#head-15f09e2d0caa2d34dc2a5e08bd35a73785f6904f">Abschaltung der CryptoBox</a>
</li>
<li>
<a href="#head-8c5b7761331350d6862b1f40e62289c492f016c3">Notfall-Abschaltung</a>
</li>
<li>
<a href="#head-38032d34432f1a2bd9a97a8a2361f7a159e9f807">Fragen</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-58fa30bbb12b06f836481cac9c9759756d61b051">Aktivieren des verschlüsselten Dateisystems</h2> </p>
<p>
<p>Du kannst dein verschlüsseltes Dateisystem mit folgenden Schritten aktivieren: </p> <strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxUser">CryptoBoxUser/de</a>, <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration&weblang=de">CryptoBoxUserConfiguration/de</a>)
<ul>
<li><p> Wähle mit deinem Web-Browser die Adresse deiner <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> an. Die Voreinstellung ist <a href="https://192.168.0.23&weblang=de">https://192.168.0.23</a>. </p>
</li>
<li><p> Klicke auf <em>Aktivieren der Crypto-Daten</em>. Daraufhin erscheint ein Formular zur Eingabe des Crypto-Passworts. </p>
</li>
<li><p> Gib dein Crypto-Passwort ein und klicke auf die darunterliegende Schaltfläche. </p>
</li>
</ul>
<p><img src="/toolforge/CryptoBoxUserDailyUse/de?action=AttachFile&amp;do=get&amp;target=mount_de.png" alt="mount_de.png"> </p>
<p>Nun ist das verschlüsselte Dateisystem verfügbar. Um es zu nutzen, suche in deiner Netzwerkumgebung nach der Netzwerk-Adresse deiner <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> (Voreinstellung: 192.168.0.23). Nun kannst du das Netzlaufwerk wie üblich verwenden. </p>
<h2 id="head-d245bf35328e9999ee8b6010389160917e2c7fa6">Abschalten des verschlüsselten Dateisystems</h2>
<p>Du kannst das verschlüsselte Dateisystem abschalten, indem du in der Menü-Zeile des Web-Interfaces der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> auf <em>Deaktivierung der Crypto-Daten</em> klickst. </p>
<p>Deine Daten sind nun wieder vor jedem Zugriff geschützt. </p>
<h2 id="head-15f09e2d0caa2d34dc2a5e08bd35a73785f6904f">Abschaltung der CryptoBox</h2>
<p>Klicke auf <em>System</em> in der Menü-Zeile des Web-Interfaces. Nun kannst du zwischen <em>Abschaltung</em> und <em>Neustart</em> wählen. Die Abschaltung dauert einige Sekunden. </p>
<p>Falls dein <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>-Rechner relativ neu ist (ungefähr ab Baujahr 02000), wird er sich nun selbständig abschalten. Andernfalls musst du dies per Hand tun. </p>
<h2 id="head-8c5b7761331350d6862b1f40e62289c492f016c3">Notfall-Abschaltung</h2>
<p>Falls du deine Daten wirklich schnell vor neugierigen Augen schützen musst, dann ziehe einfach den Stecker der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>. Dies ist nicht besonders sauber und kann (in sehr seltenen Ausnahmefällen) geöffnete Dateien beschädigen. Es ist jedoch die schnellste Methode zur Sicherung deiner Daten vor unbefugtem Zugriff. </p>
<p><em>zurück zu <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser/de</a></em> </p>
<hr>
<p> </p>
<h2 id="head-38032d34432f1a2bd9a97a8a2361f7a159e9f807">Fragen</h2>
</p>
<hr />
<h1 id="TglicheNutzung">Tägliche Nutzung</h1>
<h2 id="AktivierendesverschlsseltenDateisystems">Aktivieren des verschlüsselten Dateisystems</h2>
<p>
Du kannst dein verschlüsseltes Dateisystem mit folgenden Schritten aktivieren:
</p>
<ul><li>Wähle mit deinem Web-Browser die Adresse deiner <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> an. Die Voreinstellung ist <a class="ext-link" title="https://192.168.0.23" href="https://192.168.0.23&weblang=de">https://192.168.0.23</a>.
</li><li>Klicke auf <i>Aktivieren der Crypto-Daten</i>. Daraufhin erscheint ein Formular zur Eingabe des Crypto-Passworts.
</li><li>Gib dein Crypto-Passwort ein und klicke auf die darunterliegende Schaltfläche.
</li></ul><p>
<a href='/cryptobox-img/screenshots/de_mount.png' style='padding:0; border:none'><img src='/cryptobox-img/screenshots/de_mount.png?format=raw' alt="de_mount.png" title="de_mount.png" style="" /></a>
</p>
<p>
Nun ist das verschlüsselte Dateisystem verfügbar. Um es zu nutzen, suche in deiner Netzwerkumgebung nach der Netzwerk-Adresse deiner <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> (Voreinstellung: 192.168.0.23). Nun kannst du das Netzlaufwerk wie üblich verwenden.
</p>
<h2 id="ZugriffaufdieverschlsseltenDaten">Zugriff auf die verschlüsselten Daten</h2>
<h3 id="LinuxKommandozeile">Linux - Kommandozeile</h3>
<p>
Um als normaler Nutzer auf die Crypto-Partition zuzugreifen, solltest du folgende Zeile zur <i>/etc/fstab</i> hinzufügen:
</p>
<pre class="wiki">//192.168.0.23/public /mnt/ smbfs defaults,noexec,noauto,user,guest 0 0
</pre><p>
Nun kannst du die Crypto-Partition nach /mnt mounten:
</p>
<pre class="wiki">mount /mnt/
</pre><p>
bzw. unmounten:
</p>
<pre class="wiki">smbumount /mnt
</pre><h3 id="Windows">Windows</h3>
<p>
Starte den Windows Explorer und wähle im Menü unter <i>Extras</i> die Option <i>Netzlaufwerke verbinden</i> aus.
</p>
<p>
<a href='/cryptobox-img/screenshots/de_w98_network_drive.png' style='padding:0; border:none'><img src='/cryptobox-img/screenshots/de_w98_network_drive.png?format=raw' alt="de_w98_network_drive.png" title="de_w98_network_drive.png" style="" /></a>
</p>
<p>
Trage unter <i>Pfad</i> die Adresse des Verzeichnisse der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> ein, auf das du zugreifen willst (Standard: \\192.168.0.23\public). Soll die Verbindung beim jedem Start von Windows wiederhergestellt werden, aktiviere <i>Verbindung beim Start wiederherstellen</i>.
</p>
<p>
Nun kannst du auf das verschlüsselte Dateisystem wie jedes andere Laufwerk benutzen.
</p>
<h2 id="AbschaltendesverschlsseltenDateisystems">Abschalten des verschlüsselten Dateisystems</h2>
<p>
Du kannst das verschlüsselte Dateisystem abschalten, indem du in der Menü-Zeile des Web-Interfaces der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> auf <i>Deaktivierung der Crypto-Daten</i> klickst.
</p>
<p>
Deine Daten sind nun wieder vor jedem Zugriff geschützt.
</p>
<h2 id="AbschaltungderCryptoBox">Abschaltung der CryptoBox</h2>
<p>
Klicke auf <i>System</i> in der Menü-Zeile des Web-Interfaces. Nun kannst du zwischen <i>Abschaltung</i> und <i>Neustart</i> wählen. Die Abschaltung dauert einige Sekunden.
</p>
<p>
Falls dein CryptoBox-Rechner relativ neu ist (ungefähr ab Baujahr 02000), wird er sich nun selbständig abschalten. Andernfalls musst du dies per Hand tun.
</p>
<h2 id="NotfallAbschaltung">Notfall-Abschaltung</h2>
<p>
Falls du deine Daten wirklich schnell vor neugierigen Augen schützen musst, dann ziehe einfach den Stecker der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>. Dies ist nicht besonders sauber und kann (in sehr seltenen Ausnahmefällen) geöffnete Dateien beschädigen. Es ist jedoch die schnellste Methode zur Sicherung deiner Daten vor unbefugtem Zugriff.
</p>
<p>
<i>zurück zu <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser</a></i>
</p>
<hr />
<h2 id="FragenundAntworten">Fragen und Antworten</h2>
<h3 id="WindowsNetzlaufwerkkannnichtverbundenwerden">Windows: Netzlaufwerk kann nicht verbunden werden</h3>
<p>
<a href='/cryptobox-img/screenshots/de_w98_not_logged_in.png' style='padding:0; border:none'><img src='/cryptobox-img/screenshots/de_w98_not_logged_in.png?format=raw' alt="de_w98_not_logged_in.png" title="de_w98_not_logged_in.png" style="" /></a>
</p>
<p>
Erscheint diese Fehlermeldung, hast du dich beim Start von Windows nicht angemeldet bzw. das Anmeldefenster mit der Taste <i>Esc</i> (Escape) verschwinden lassen. Klicke auf <i>Start</i> und <i>Abmelden</i> und melde dich neu an - sobald das Anmeldefenster erscheint, klicke auf <i>OK</i>:
</p>
<p>
<a href='/cryptobox-img/screenshots/de_w98_login.png' style='padding:0; border:none'><img src='/cryptobox-img/screenshots/de_w98_login.png?format=raw' alt="de_w98_login.png" title="de_w98_login.png" style="" /></a>
</p>
<h3 id="Linuxonlyrootcanunmount192168023public">Linux: only root can unmount //192.168.0.23/public</h3>
<p>
Das Unmounten der Crypto-Partition mit <i>umount</i> funktioniert nicht.
</p>
<p>
<strong>Lösung:</strong> Verwende stattdessen:
</p>
<pre class="wiki">smbumount /mnt
</pre><h3 id="LinuxOperationnotpermittedsmbmntfailed1">Linux: Operation not permitted / smbmnt failed: 1</h3>
<p>
Der Versuch die Partition als normaler Nutzer zu mounten schlägt fehl:
</p>
<pre class="wiki">cannot mount on /mnt/: Operation not permitted
smbmnt failed: 1
</pre><p>
<strong>Lösung:</strong> Das Mount-Verzeichnis muss dem selben Nutzer gehören, der den mount-Befehl ausführt (bspw. phil):
</p>
<pre class="wiki">chown phil. /mnt
</pre><hr />
<h2 id="Kommentare">Kommentare</h2>
<p>
</div>
</div>

118
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/de/CryptoBoxUserGettingStarted.html
View file

@ -1,73 +1,57 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#ErsteSchritte&weblang=de">Erste Schritte</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#HinweiseFallstricke&weblang=de">Hinweise / Fallstricke</a></li>
<a href="#head-1a52cf4373780aa69853fdd9d63a69c0f223660b">Erste Schritte</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#Kommentare&weblang=de">Kommentare</a></li>
</li>
<li>
<a href="#head-0f6a807e2ff770ed406aac96796350c058e4d2ad">Hinweise / Fallstricke</a>
</li>
<li>
<a href="#head-907ba97818e4ff85db741812421bd41b5bf29dc3">Fragen</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-1a52cf4373780aa69853fdd9d63a69c0f223660b">Erste Schritte</h2> </p>
<p>
<p>Die <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> ist schnellt aufgebaut: </p> <strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxUser">CryptoBoxUser/de</a>, <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration&weblang=de">CryptoBoxUserConfiguration/de</a>)
<ol type="1">
<li><p>Du brauchst einen alten Computer (mindestens 100MHZ, 48MB RAM) (Faustregel: nach 1996 gekauft). Dazu eine passende Netzwerkkarte, ein CD-ROM Laufwerk und eine riesige Festplatte. </p>
<ul>
<li><p> Die Festplatte muss nicht riesig sein, je nachdem was du speichern willst, reicht auch 'ne kleine <img src="/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
</li>
<li><p> Du brauchst keinen Monitor, keine Tastatur und keine Maus, um die <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> zu benutzen (bzw. nur für die Erst-Einrichtung). </p>
</li>
<li><p> Du kannst natürlich einen schnelleren Rechner verwenden - der unbedeutende Performance-Zuwachs wird jedoch wohl nicht durch den erhöhten Energiebedarf gerechtfertigt. </p>
</li>
</ul>
</li>
<li><p>Lade die aktuellste Version der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> als iso-image herunter und brenne dieses auf einen CD-Rohling. </p>
<ul>
<li><p> <a href="http://codecoop.org/projects/cryptobox/">http://codecoop.org/projects/cryptobox/</a> </p>
</li>
</ul>
</li>
<li><p>Konfiguriere den PC, so dass er vom CD Laufwerk bootet. Dazu solltest du im BIOS als "boot device" "CD-ROM" einstellen. </p>
</li>
<li><p>Pack die frisch gebrannte <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> CD ins Laufwerk und starte den Computer. </p>
</li>
</ol>
<p>Wenn der Computer jetzt von der CD startet, hast du alle Anforderungen erfüllt. </p>
<p>Du kannst nun zu deinem Arbeits-Rechner in demselben Netzwerk gehen und "<a href="https://192.168.0.23">https://192.168.0.23</a>" ansurfen. Dort sollte die <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>-Konfigurationsseite erscheinen. Ist doch kinderleicht, oder? </p>
<p>Die weiteren Schritte werden unter <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser/de</a> beschrieben. </p>
<h2 id="head-0f6a807e2ff770ed406aac96796350c058e4d2ad">Hinweise / Fallstricke</h2>
<ul>
<li><p> Eventuell musst du für die Einrichtung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> kurzzeitig deine Netzwerkaddresse (IP) ändern. Falls du nicht weißt, wie und warum, dann frage jemanden um Rat ... (wahrscheinlich klappt es aber ohne Änderungen) </p>
</li>
<li><p> Falls du eine neue Festplatte kaufen willst, beachte, dass alte PCs nicht mit modernen Festplattengrößen klarkommen. </p>
</li>
<li><p> Einige alte PCs können nicht vom CD-ROM-Laufwerk booten. </p>
</li>
<li><p> Falls dir der Begriff "BIOS" nichts sagt, bitte Menschen um Hilfe, bevor du was veränderst <img src="/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
</li>
<li><p> Vergiss nicht, den <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a>-Rechner ans Netzwerk anzuschliessen! </p>
</li>
<li><p> Du brauchst einen Monitor und eine Tastatur für die Konfiguration des BIOS. </p>
</li>
</ul>
<p><em>zurück zu <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=de">CryptoBoxUser/de</a></em> </p>
<hr>
<p> </p>
<h2 id="head-907ba97818e4ff85db741812421bd41b5bf29dc3">Fragen</h2>
</p>
<hr />
<h1 id="Wiegehteslos">Wie geht es los</h1>
<h2 id="ErsteSchritte">Erste Schritte</h2>
<p>
Die <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> ist schnell aufgebaut:
</p>
<ol><li>Du brauchst einen alten Computer (mindestens 100MHZ, 48MB RAM) (Faustregel: nach 1996 gekauft). Dazu eine passende Netzwerkkarte, ein CD-ROM Laufwerk und eine riesige Festplatte.
<ul><li>Die Festplatte muss nicht riesig sein, je nachdem was du speichern willst, reicht auch 'ne kleine ;)
</li><li>Du brauchst keinen Monitor, keine Tastatur und keine Maus, um die <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> zu benutzen (bzw. nur für die Erst-Einrichtung).
</li><li>Du kannst natürlich einen schnelleren Rechner verwenden - der unbedeutende Performance-Zuwachs wird jedoch wohl nicht durch den erhöhten Energiebedarf gerechtfertigt.
</li></ul></li><li>Lade die aktuellste Version der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> als iso-image herunter und brenne dieses auf einen CD-Rohling.
<ul><li><a class="ext-link" title="http://codecoop.org/projects/cryptobox/" href="http://codecoop.org/projects/cryptobox/">http://codecoop.org/projects/cryptobox/</a>
</li></ul></li><li>Konfiguriere den PC, so dass er vom CD Laufwerk bootet. Dazu solltest du im BIOS als &#34;boot device&#34; &#34;CD-ROM&#34; einstellen.
</li><li>Pack die frisch gebrannte <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> CD ins Laufwerk und starte den Computer.
</li></ol><p>
Wenn der Computer jetzt von der CD startet, hast du alle Anforderungen erfüllt.
</p>
<p>
Du kannst nun zu deinem Arbeits-Rechner in demselben Netzwerk gehen und &#34;<a class="ext-link" title="https://192.168.0.23&#34;" href="https://192.168.0.23&#34;">https://192.168.0.23&#34;</a> ansurfen. Dort sollte die CryptoBox-Konfigurationsseite erscheinen. Ist doch kinderleicht, oder?
</p>
<p>
Die weiteren Schritte werden unter <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration&weblang=de">CryptoBoxUserConfiguration</a> beschrieben.
</p>
<h2 id="HinweiseFallstricke">Hinweise / Fallstricke</h2>
<ul><li>Eventuell musst du für die Einrichtung der <a href="/cryptobox?action=doc&page=CryptoBox&weblang=de">CryptoBox</a> kurzzeitig deine Netzwerkaddresse (IP) ändern. Falls du nicht weißt, wie und warum, dann frage jemanden um Rat ... (wahrscheinlich klappt es aber ohne Änderungen)
</li><li>Falls du eine neue Festplatte kaufen willst, beachte, dass alte PCs nicht mit modernen Festplattengrößen klarkommen.
</li><li>Einige alte PCs können nicht vom CD-ROM-Laufwerk booten.
</li><li>Falls dir der Begriff &#34;BIOS&#34; nichts sagt, bitte Menschen um Hilfe, bevor du was veränderst ;)
</li><li>Vergiss nicht, den CryptoBox-Rechner ans Netzwerk anzuschliessen!
</li><li>Du brauchst einen Monitor und eine Tastatur für die Konfiguration des BIOS.
</li></ul><hr />
<h2 id="Kommentare">Kommentare</h2>
<p>
</div>
</div>

206
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBox.html
View file

@ -1,137 +1,81 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBox#News&weblang=en">News</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBox#Overview&weblang=en">Overview</a></li>
<a href="#head-4f7ff469187373427683a6373538004a13ab7928">News</a> <li><a href="/cryptobox?action=doc&page=CryptoBox#Download&weblang=en">Download</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBox#Support&weblang=en">Support</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBox#Development&weblang=en">Development</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBox#Acknowledgements&weblang=en">Acknowledgements</a></li>
<a href="#head-efcfa621d0607ea7c5466d3ecdb99edf3cb4ebc8">Overview</a> <li><a href="/cryptobox?action=doc&page=CryptoBox#Legalstuff&weblang=en">Legal stuff</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBox#Comments&weblang=en">Comments</a></li>
<li>
<a href="#head-97b25333607e6847b07b9b3c4996ed39d3da3064">Specs</a>
</li>
<li>
<a href="#head-1a17731b6ddd57e960f191c2096fe48056aecb3b">Usage</a>
</li>
<li>
<a href="#head-dd472b75401e742bc60e6324313368309548e9f8">Development</a>
</li>
<li>
<a href="#head-82502f7b432827fa8eabd177567e4034eb595e6c">Legal stuff</a>
</li>
</ol> </ol>
<p> </p>
<hr>
<p> </p>
<p><em>see <a href="/cryptobox?action=doc&page=CryptoBoxIntro&weblang=en">CryptoBoxIntro/en</a> for a very short overview</em> </p>
<h2 id="head-4f7ff469187373427683a6373538004a13ab7928">News</h2>
<p>We are moving this project to <a href="https://codecoop.org/projects/cryptobox/">https://codecoop.org/projects/cryptobox/</a> </p>
<p>The first release of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>-LiveCD is planned for October 02005. </p>
<h2 id="head-efcfa621d0607ea7c5466d3ecdb99edf3cb4ebc8">Overview</h2>
<p>The <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> is a Debian/Linux based live-cd. This CD boots up, starting a secure fileserver. Even non-technical users are able to store their data on its encrypted harddisk. There is no special knowledge about cryptography or servers required at all. </p>
<p>We provide the documentation in different languages. Feel free to add more translations: </p>
<ul>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">deutsch</a> </p>
</li>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">english</a> </p>
</li>
</ul>
<h2 id="head-97b25333607e6847b07b9b3c4996ed39d3da3064">Specs</h2>
<div>
<table>
<tr>
<td>
<p>system</p>
</td>
<td>
<p>Debian/Linux based Live-CD</p>
</td>
</tr>
<tr>
<td>
<p>needed hardware</p>
</td>
<td>
<p> "outdated" PC (i386 p1-100 32MB RAM minimum)</p>
</td>
</tr>
<tr>
<td>
<p>supported clients</p>
</td>
<td>
<p><a class="interwiki" title="WikiPedia" href="http://en.wikipedia.org/wiki/Operating_System">*nix; *bsd; Windows; Mac OS</a></p>
</td>
</tr>
<tr>
<td>
<p>fileserver</p>
</td>
<td>
<p><a class="external" href="http://samba.org">samba</a> (network shares)</p>
</td>
</tr>
<tr>
<td>
<p>userinterface</p>
</td>
<td>
<p>fully remote controlled via webbrowser</p>
</td>
</tr>
<tr>
<td>
<p>encryption</p>
</td>
<td>
<p><a class="interwiki" title="WikiPedia" href="http://en.wikipedia.org/wiki/Advanced_Encryption_Standard">AES</a> via device-mapper</p>
</td>
</tr>
</table>
</div> </div>
<p>The web interface of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> supports the following languages: </p>
<ul>
<li><p> english </p>
</li>
<li><p> german </p>
</li>
<li><p> slovenian </p>
</li>
</ul>
<p>Feel free to contribute a <a class="interwiki" title="SubVersion" href="/websvn/cryptobox/trunk/cbox-tree.d/usr/share/cryptobox/lang/en.hdf">translation</a> for another language (preferably utf-encoded). </p>
<h2 id="head-1a17731b6ddd57e960f191c2096fe48056aecb3b">Usage</h2> </p>
<h1 id="TheCryptoBox">The CryptoBox</h1>
<p>The user documentation has its home at <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser/en</a>. </p> <p>
<i><a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">deutschsprachige Version</a></i>
<h2 id="head-dd472b75401e742bc60e6324313368309548e9f8">Development</h2> </p>
<h2 id="News">News</h2>
<p>Take a look at the developer's documentation at <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev/en</a>. </p> <p>
<p>Report bugs at <a href="https://systemausfall.org/trac/cryptobox">https://systemausfall.org/trac/cryptobox</a>. </p> The first release of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> is available at <a class="ext-link" title="https://codecoop.org/projects/cryptobox/" href="https://codecoop.org/projects/cryptobox/&weblang=en">Codecoop.org</a>.
<p>Browse the source code in the <a class="interwiki" title="SubVersion" href="/websvn/cryptobox">CryptoBox-websvn interface</a>. </p> </p>
<p>Anything else? Write us an email: <em>cryptobox[at]systemausfall.org</em> </p> <h2 id="Overview">Overview</h2>
<p>
<h2 id="head-82502f7b432827fa8eabd177567e4034eb595e6c">Legal stuff</h2> The <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> is a Debian/Linux based <a class="ext-link" title="http://en.wikipedia.org/wiki/Live_CD" href="http://en.wikipedia.org/wiki/Live_CD">live-cd</a>. This CD boots up, starting a secure fileserver. Even non-technical users are able to store their data on its encrypted harddisk. There is no special knowledge about <a class="ext-link" title="http://en.wikipedia.org/wiki/Cryptography" href="http://en.wikipedia.org/wiki/Cryptography&weblang=en">cryptography</a> or servers required at all.<br />
The <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> is fully controllable via your web browser. Have a look at the <a href="/cryptobox?action=doc&page=ScreenShots&weblang=en">ScreenShots</a>.
<ol type="1"> </p>
<li><p>All scripts are <a class="external" href="http://www.fsf.org/licensing/licenses/gpl.html">GPL licensed</a> </p> <table class="wiki">
</li> <tr><td><i>Specs</i>
<li><p>The documentation licensed under a <a class="external" href="http://creativecommons.org/licenses/by-sa-nc/2.0/">Creative Commons License</a><em> </em></p> </td></tr><tr><td>system</td><td>Debian/Linux based Live-CD
</li> </td></tr><tr><td>needed hardware</td><td> &#34;outdated&#34; PC (i386 p1-100 32MB RAM minimum)
<li><p>We do not take any warranty for the functionality or usability of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. </p> </td></tr><tr><td>supported clients</td><td><a class="ext-link" title="http://en.wikipedia.org/wiki/Operating_System" href="http://en.wikipedia.org/wiki/Operating_System">*nix; *bsd; Windows; Mac OS</a>
</li> </td></tr><tr><td>fileserver</td><td><a class="ext-link" title="http://samba.org" href="http://samba.org">samba</a> (network shares)
</ol> </td></tr><tr><td>userinterface</td><td>fully remote controlled via webbrowser
</td></tr><tr><td>encryption</td><td><a class="ext-link" title="http://en.wikipedia.org/wiki/Advanced_Encryption_Standard" href="http://en.wikipedia.org/wiki/Advanced_Encryption_Standard">AES</a> via device-mapper
</td></tr></table>
<p>
The web interface of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> supports the following languages:
</p>
<ul><li>English
</li><li>German
</li><li>Slovenian
</li></ul><p>
We are looking for more translations. Just take a look at the &#34;README&#34;-file in our <a href="/trac/cryptobox/browser/trunk/cbox-tree.d/usr/share/cryptobox/lang/">language section</a>.
There you can find further instructions if you'd like to contribute.
</p>
<h2 id="Download">Download</h2>
<ul><li><a class="ext-link" title="http://codecoop.org/frs/download.php/32/cryptobox_0.2.iso" href="http://codecoop.org/frs/download.php/32/cryptobox_0.2.iso">version 0.2</a> [104 MB] - <a href="/trac/cryptobox/wiki/ReleaseNotes/0.2">Release notes</a>
<ul><li><i>provided by <a class="ext-link" title="http://codecoop.org" href="http://codecoop.org">http://codecoop.org</a></i>
</li></ul></li></ul><h2 id="Support">Support</h2>
<ul><li>The user documentation has its home at <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser</a>.
</li><li>Open up a <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/newticket" href="https://systemausfall.org/trac/cryptobox/newticket">ticket</a> for your feature requests and bugs.
</li><li>Write us an email: <i>cryptobox[at]systemausfall.org</i>
</li></ul><h2 id="Development">Development</h2>
<p>
Take a look at the developer's documentation at <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a> for more information.
</p>
<h2 id="Acknowledgements">Acknowledgements</h2>
<p>
<ul><li>Clavdia Horvat, Tadej Brce &amp; Dušan Rebolj - slovenian translation
</li><li><a class="ext-link" title="http://codecoop.org" href="http://codecoop.org">http://codecoop.org</a> - webspace
</li></ul>
</p>
<h2 id="Legalstuff">Legal stuff</h2>
<ol><li>All scripts are <a class="ext-link" title="http://www.fsf.org/licensing/licenses/gpl.html" href="http://www.fsf.org/licensing/licenses/gpl.html">GPL licensed</a>
</li><li>The documentation is licensed under a <a class="ext-link" title="http://creativecommons.org/licenses/by-sa-nc/2.0/" href="http://creativecommons.org/licenses/by-sa-nc/2.0/">Creative Commons License</a><i></i>
</li><li>We do not take any warranty for the functionality or usability of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>.
</li></ol><hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

126
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxDev.html
View file

@ -1,49 +1,93 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Preparationsfordevelopers&weblang=en">Preparations for developers</a></li>
<li> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Softwarerequirements&weblang=en">Software requirements</a></li>
<a href="#head-85f75330e62e5b1efc9f504fe9cb51a1b966dc3b">Development documentation</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Getthesource&weblang=en">Get the source</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Firstbuild&weblang=en">First build</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Finished&weblang=en">Finished</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Comments&weblang=en">Comments</a></li>
<a href="#head-b8ce79abe983e1592235d0085dd6928b83811739">Contact</a>
</li>
<li>
<a href="#head-964f56b054273ed39bab34484f83ac053ac0f12e">Bug reports</a>
</li>
</ol> </ol>
<p> </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Developmentworkflow&weblang=en">Development workflow</a></li>
<hr> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Preparations&weblang=en">Preparations</a></li>
<p> </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#CreateaCryptoBoxLiveCD&weblang=en">Create a CryptoBox-LiveCD</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#TesttheCryptoBoxLiveCD&weblang=en">Test the CryptoBox-LiveCD</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Debuggingandmerging&weblang=en">Debugging and merging</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Comments&weblang=en">Comments</a></li>
</ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#CustombuildsoftheCryptoBox&weblang=en">Custom builds of the CryptoBox</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Overview&weblang=en">Overview</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Settings&weblang=en">Settings</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Comments&weblang=en">Comments</a></li>
</ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#CustomconfigurationoftheCryptoBox&weblang=en">Custom configuration of the CryptoBox</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Overview&weblang=en">Overview</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Locations&weblang=en">Locations</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Examples&weblang=en">Examples</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Comments&weblang=en">Comments</a></li>
</ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#ValidationoftheCryptoBox&weblang=en">Validation of the CryptoBox</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Overview&weblang=en">Overview</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Validate&weblang=en">Validate</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Howtocreateatest&weblang=en">How to create a test</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Comments&weblang=en">Comments</a></li>
</ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#DetailsoftheCryptoBox&weblang=en">Details of the CryptoBox</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#dfsbuild&weblang=en">dfsbuild</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#thekernel&weblang=en">the kernel</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#qemu&weblang=en">qemu</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#alternativeLiveCDs&weblang=en">alternative LiveCDs</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#Comments&weblang=en">Comments</a></li>
</ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#Knownproblems&weblang=en">Known problems</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#qemu&weblang=en">qemu</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#dfsbuild&weblang=en">dfsbuild</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#Comments&weblang=en">Comments</a></li>
</ol>
</ol>
</div>
<h2 id="head-85f75330e62e5b1efc9f504fe9cb51a1b966dc3b">Development documentation</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox/de</a>, <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox/en</a>)
<p>The following pages are written for developers only. Users of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> should read <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser</a> instead. </p> </p>
<ul> <hr />
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=en">CryptoBoxDevPreparation</a> </p> <h1 id="Developmentdocumentation">Development documentation</h1>
</li> <p>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow&weblang=en">CryptoBoxDevWorkFlow</a> </p> The following pages are written for developers only. <br />
</li> Users of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> should read <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser</a> instead.
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a> </p> </p>
</li> <ul><li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=en">CryptoBoxDevPreparation</a>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure&weblang=en">CryptoBoxDevCustomConfigure</a> </p> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow&weblang=en">CryptoBoxDevWorkFlow</a>
</li> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevValidation&weblang=en">CryptoBoxDevValidation</a> </p> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure&weblang=en">CryptoBoxDevCustomConfigure</a>
</li> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation&weblang=en">CryptoBoxDevValidation</a>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevBackground&weblang=en">CryptoBoxDevBackground</a> </p> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground&weblang=en">CryptoBoxDevBackground</a>
</li> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems&weblang=en">CryptoBoxDevKnownProblems</a>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems&weblang=en">CryptoBoxDevKnownProblems</a> </p> </li></ul><h2 id="Source">Source</h2>
</li> <p>
</ul> You may browse the <a href="/trac/cryptobox/browser/">source code</a>.
</p>
<h2 id="Contact">Contact</h2>
<p>
We are waiting for your emails to <i>cryptobox[at]systemausfall.org</i>.
</p>
<h2 id="Bugreports">Bug reports</h2>
<p>
If you think you found a bug or you get an error message, please help us to fix the problem and file a ticket (a bug report). Follow these steps:
</p>
<ol><li>Have a look at <a href="/trac/cryptobox/report/1">Open bugs</a> that need to be fixed
</li><li>Create a <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/newticket" href="https://systemausfall.org/trac/cryptobox/newticket">New Ticket</a>
</li></ol></div>
</div>
<h2 id="head-b8ce79abe983e1592235d0085dd6928b83811739">Contact</h2>
<p>We are waiting for your emails to <em>cryptobox[at]systemausfall.org</em>. </p>
<h2 id="head-964f56b054273ed39bab34484f83ac053ac0f12e">Bug reports</h2>
<p>Please use our issue tracker, if you discover problems: <a href="https://systemausfall.org/trac/cryptobox">https://systemausfall.org/trac/cryptobox</a> </p>

118
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxDevBackground.html
View file

@ -1,66 +1,64 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#dfsbuild&weblang=en">dfsbuild</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#thekernel&weblang=en">the kernel</a></li>
<a href="#head-2d71165918ee9e861cebf562e7f9be2c5c6328e4">dfsbuild</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#qemu&weblang=en">qemu</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#alternativeLiveCDs&weblang=en">alternative LiveCDs</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevBackground#Comments&weblang=en">Comments</a></li>
<li>
<a href="#head-6e3d13fcf3a0765d2188125e9b0b0bcb95e50622">the kernel</a>
</li>
<li>
<a href="#head-e01e8e66ae77c00f4e9fa9bd190c3ff738540727">qemu</a>
</li>
<li>
<a href="#head-00c94b926ece7f2a601d696a8880f5e54155ce7a">alternative LiveCDs</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a></em> </p>
<h2 id="head-2d71165918ee9e861cebf562e7f9be2c5c6328e4">dfsbuild</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a>)
<p>The base system of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> Live-CD is created by <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild&weblang=en">dfsbuild</a>. </p> </p>
<p>It is recommended to use some kind of caching tool for the retrieval of the debian packages (e.g.: <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a> or <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a>). This saves a lot of bandwidth and time. </p> <hr />
<p>The documentation for <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> is sparse. But it is quite unlikely, that you will get in direct contact with it, as it is wrapped by <em>cbox-build</em>. However the following links may help you for specific problems: </p> <h1 id="DetailsoftheCryptoBox">Details of the CryptoBox</h1>
<ul> <h2 id="dfsbuild">dfsbuild</h2>
<li><p> <a class="external" href="http://www.debian-administration.org/articles/125">Debian Administration: Building Debian CD-ROMS Part 1 - dfsbuild</a> </p> <p>
</li> The base system of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> Live-CD is created by <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild&weblang=en">dfsbuild</a>.
<li><p> <a class="external" href="http://www.debian-administration.org/articles/149">Debian Administration: Getting in deep with dfsbuild</a> </p> </p>
</li> <p>
</ul> It is recommended to use some kind of caching tool for the retrieval of the debian packages (e.g.: <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a> or <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx">approx</a>). This saves a lot of bandwidth and time.
</p>
<h2 id="head-6e3d13fcf3a0765d2188125e9b0b0bcb95e50622">the kernel</h2> <p>
The documentation for <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> is sparse. But it is quite unlikely, that you will get in direct contact with it, as it is wrapped by <a href="/trac/cryptobox/browser/trunk/scripts/cbox-build.sh">cbox-build</a>. However the following links may help you for specific problems:
<p>The linux kernel for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> is compiled statically. If you want to change it, you could follow this steps: </p> </p>
<ol type="1"> <ul><li><a class="ext-link" title="http://www.debian-administration.org/articles/125" href="http://www.debian-administration.org/articles/125">Debian Administration: Building Debian CD-ROMS Part 1 - dfsbuild</a>
<li><p>get the sources: <tt>apt-get&nbsp;install&nbsp;kernel-tree-2.6.11</tt> (or the version of your choice) </p> </li><li><a class="ext-link" title="http://www.debian-administration.org/articles/149" href="http://www.debian-administration.org/articles/149">Debian Administration: Getting in deep with dfsbuild</a>
</li> </li></ul><h2 id="thekernel">the kernel</h2>
<li><p>copy the exisiting config file <em>kernel/config-2.6.11</em> as <em>.config</em> into your kernel source directory </p> <p>
</li> The linux kernel for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> is compiled statically. If you want to change it, you could follow this steps:
<li><p>build the debian kernel package <tt>make-kpkg&nbsp;--revision=1.dfs&nbsp;--rootcmd=fakeroot&nbsp;kernel_image</tt> </p> </p>
</li> <ol><li>get the sources: <tt>apt-get install kernel-tree-2.6.11</tt> (or the version of your choice)
<li><p>change the kernel in the <em>unpackdebs</em> setting in <em>dfs-cbox.conf</em> (see <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a> for details) </p> </li><li>copy the exisiting config file <i>kernel/config-2.6.11</i> as <i>.config</i> into your kernel source directory
</li> </li><li>build the debian kernel package <tt>make-kpkg --revision=1.dfs --rootcmd=fakeroot kernel_image</tt>
</ol> </li><li>change the kernel in the <i>unpackdebs</i> setting in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/dfs-cbox.conf">dfs-cbox.conf</a> (see <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a> for details)
</li></ol><p>
<h2 id="head-e01e8e66ae77c00f4e9fa9bd190c3ff738540727">qemu</h2> See <a title="" href="/trac/cryptobox/browser/trunk/hints/kernel-build.txt">source:trunk/hints/kernel-build.txt</a> for more details.
</p>
<p><a class="external" href="http://fabrice.bellard.free.fr/qemu/">Qemu</a> is a portable system emulator. It is a convenient tool to ease the development workflow, as you do not need to burn LiveCDs for testing. </p> <h2 id="qemu">qemu</h2>
<p>
<h2 id="head-00c94b926ece7f2a601d696a8880f5e54155ce7a">alternative LiveCDs</h2> <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu/" href="http://fabrice.bellard.free.fr/qemu/">Qemu</a> is a portable system emulator. It is a convenient tool to ease the development workflow, as you do not need to burn LiveCDs for testing.
</p>
<p>We tried some other LiveCDs before we decided to use <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>. The following pages describe their advantages and disadvantages as the base system for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>: </p> <h2 id="alternativeLiveCDs">alternative LiveCDs</h2>
<ul> <p>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxKnoppixVerworfen&weblang=en">CryptoBoxKnoppixVerworfen</a> - Knoppix </p> We tried some other LiveCDs before we decided to use <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>. The following pages describe their advantages and disadvantages as the base system for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>:
</li> </p>
<li><p> <a href="/cryptobox?action=doc&page=CryptoBoxMorphixVerworfen&weblang=en">CryptoBoxMorphixVerworfen</a> - Morphix / IBuild </p> <ul><li><a href="/cryptobox?action=doc&page=CryptoBoxKnoppixVerworfen&weblang=en">CryptoBoxKnoppixVerworfen</a> - Knoppix
</li> </li><li><a href="/cryptobox?action=doc&page=CryptoBoxMorphixVerworfen&weblang=en">CryptoBoxMorphixVerworfen</a> - Morphix / IBuild
</ul> </li></ul><hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

171
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxDevCustomBuild.html
View file

@ -1,98 +1,85 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Overview&weblang=en">Overview</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Settings&weblang=en">Settings</a></li>
<a href="#head-27ea5a3ee88c7c2dfcfd4124719aadd726f1e2da">Overview</a> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#dfsbuildsettings&weblang=en">dfsbuild settings</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#CryptoBoxdevelopmentconfiguration&weblang=en">CryptoBox development configuration</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#SSHconnection&weblang=en">SSH connection</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#qemunetworkconfiguration&weblang=en">qemu network configuration</a></li>
<a href="#head-737db576c5f42abc0c78574d0ce5077809f288cb">Settings</a> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild#Comments&weblang=en">Comments</a></li>
<ol>
<li>
<a href="#head-9d97886ad41e38cb6afe343aa68ff652030ab06b">dfsbuild settings</a>
</li>
<li>
<a href="#head-c2ae24a50a3706711c1a42e26176768438d4f160">CryptoBox development configuration</a>
</li>
<li>
<a href="#head-90ac95d2e5a50160cbf72b884b7b469a29c2fea1">SSH connection</a>
</li>
<li>
<a href="#head-6798893e2e3fd89a72b5b6821a0d3d08125367b9">qemu network configuration</a>
</li>
</ol> </ol>
</div>
</li> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev">CryptoBoxDev</a>, <a href="/cryptobox?action=doc&page=CryptoBoxDevBackground">CryptoBoxDevBackground</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevPreparation">CryptoBoxDevPreparation</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevWorkFlow&weblang=en">CryptoBoxDevWorkFlow</a>)
</ol> </p>
<p> </p> <hr />
<hr> <h1 id="CustombuildsoftheCryptoBox">Custom builds of the CryptoBox</h1>
<p> </p> <h2 id="Overview">Overview</h2>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a></em> </p> <p>
The following sections are useful, if you want to change the default settings of your personal <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> development environment.
<h2 id="head-27ea5a3ee88c7c2dfcfd4124719aadd726f1e2da">Overview</h2> </p>
<p>
<p>The following sections are useful, if you want to change the default settings of your personal <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> development environment. </p> You should have completed the steps described in <a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=en">CryptoBoxDevPreparation</a>.
<p>You should have completed the steps described in <a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=en">CryptoBoxDevPreparation</a>. </p> </p>
<h2 id="Settings">Settings</h2>
<h2 id="head-737db576c5f42abc0c78574d0ce5077809f288cb">Settings</h2> <h3 id="dfsbuildsettings">dfsbuild settings</h3>
<p>
All settings for <i>dfsbuild</i> can be found in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/dfs-cbox.conf">etc-defaults.d/dfs-cbox.conf</a>.
<h3 id="head-9d97886ad41e38cb6afe343aa68ff652030ab06b">dfsbuild settings</h3> </p>
<p>
<p>All settings for <em>dfsbuild</em> can be found in <em>etc-defaults.d/dfs-cbox.conf</em>. </p> If you want to change any of them, you should do the following:
<p>If you want to change any of them, you should do the following: </p> </p>
<ol type="1"> <ol><li>copy <i>etc-defaults.d/dfs-cbox.conf</i> file to <i>etc-local.d/</i>
<li><p>copy <em>etc-defaults.d/dfs-cbox.conf</em> file to <em>etc-local.d/</em> </p> </li><li>change <i>etc-local.d/dfs-cbox.conf</i> according to your needs
</li> </li></ol><p>
<li><p>change <em>etc-local.d/dfs-cbox.conf</em> according to your needs </p> This allows you to use your own (personal) settings, without interfering with files under version control.
</li> </p>
</ol> <h3 id="CryptoBoxdevelopmentconfiguration">CryptoBox development configuration</h3>
<p>This allows you to use your own (personal) settings, without interfering with files under version control. </p> <p>
Some settings regarding the building, configuring and validating of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> can be found in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/cbox-dev.conf&weblang=en">etc-defaults.d/cbox-dev.conf</a>.
<h3 id="head-c2ae24a50a3706711c1a42e26176768438d4f160">CryptoBox development configuration</h3> </p>
<p>
<p>Some settings regarding the building, configuring and validating of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> can be found in <em>etc-defaults.d/cbox-dev.conf</em>. </p> If you want to change any of them, you should do the following:
<p>If you want to change any of them, you should do the following: </p> </p>
<ol type="1"> <ol><li>copy <i>etc-defaults.d/cbox-dev.conf</i> file to <i>etc-local.d/</i>
<li><p>copy <em>etc-defaults.d/cbox-dev.conf</em> file to <em>etc-local.d/</em> </p> </li><li>change <i>etc-local.d/cbox-dev.conf</i> according to your needs
</li> </li></ol><h3 id="SSHconnection">SSH connection</h3>
<li><p>change <em>etc-local.d/cbox-dev.conf</em> according to your needs </p> <p>
</li> The file <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/ssh_config">ssh_config</a> is used to establish a connection to a running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system.
</ol> </p>
<p>
<h3 id="head-90ac95d2e5a50160cbf72b884b7b469a29c2fea1">SSH connection</h3> It can be necessary to change these settings, if:
</p>
<p>The file <em>etc-defaults.d/ssh_config</em> is used to establish a connection to a running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system. </p> <ul><li>you do not want to use the default IP for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>
<p>It can be necessary to change these settings, if: </p> </li><li>or the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> is not within your local network.
<ul> </li></ul><p>
<li><p> you do not want to use the default IP for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> </p> If you want to change some settings, you should do the following:
</li> </p>
<li><p> or the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> is not within your local network. </p> <ol><li>copy <i>etc-defaults.d/ssh_config</i> file to <i>etc-local.d/</i>
</li> </li><li>change <i>etc-local.d/ssh_config</i> according to your needs
</ul> </li></ol><h3 id="qemunetworkconfiguration">qemu network configuration</h3>
<p>If you want to change some settings, you should do the following: </p> <p>
<ol type="1"> The file <a href="/trac/cryptobox/browser/trunk/etc-defauolts.d/qemu-ifup">etc-defauolts.d/qemu-ifup</a> is used for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> emulation with <i>qemu</i>. See <i>man qemu</i> for details.
<li><p>copy <em>etc-defaults.d/ssh_config</em> file to <em>etc-local.d/</em> </p> </p>
</li> <p>
<li><p>change <em>etc-local.d/ssh_config</em> according to your needs </p> If you want to change some settings, you should do the following:
</li> </p>
</ol> <ol><li>copy <i>etc-defaults.d/qemu-ifup</i> file to <i>etc-local.d/</i>
</li><li>change <i>etc-local.d/qemu-ifup</i> according to your needs
<h3 id="head-6798893e2e3fd89a72b5b6821a0d3d08125367b9">qemu network configuration</h3> </li></ol><hr />
<h2 id="Comments">Comments</h2>
<p>The file <em>etc-defauolts.d/qemu-ifup</em> is used for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> emulation with <em>qemu</em>. See <tt>man&nbsp;qemu</tt> for details. </p> <p>
<p>If you want to change some settings, you should do the following: </p>
<ol type="1">
<li><p>copy <em>etc-defaults.d/qemu-ifup</em> file to <em>etc-local.d/</em> </p>
</li>
<li><p>change <em>etc-local.d/qemu-ifup</em> according to your needs </p>
</li>
</ol>
</div>
</div>

108
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxDevCustomConfigure.html
View file

@ -1,60 +1,60 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Overview&weblang=en">Overview</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Locations&weblang=en">Locations</a></li>
<a href="#head-eaec6be4efea7b38c41712778bfd4fb8d2827d3c">Overview</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Examples&weblang=en">Examples</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure#Comments&weblang=en">Comments</a></li>
<li>
<a href="#head-51173f0423ca91d36cd0cfcdc75a06d90cc087ee">Locations</a>
</li>
<li>
<a href="#head-9b9b6463081c4d9d13e3aadebe9daaf61fa67b5c">Examples</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a></em> </p>
<h2 id="head-eaec6be4efea7b38c41712778bfd4fb8d2827d3c">Overview</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a>)
<p>You may change nearly every aspect of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> by using the custom configuration hook directory. </p> </p>
<p>Any script inside of this directory will be executed after the default configuration procedure (see <a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow&weblang=en">CryptoBoxDevWorkFlow</a>). </p> <hr />
<p>The order of execution is defined by the names of the scripts (alphabetically). </p> <h1 id="CustomconfigurationoftheCryptoBox">Custom configuration of the CryptoBox</h1>
<h2 id="Overview">Overview</h2>
<h2 id="head-51173f0423ca91d36cd0cfcdc75a06d90cc087ee">Locations</h2> <p>
You may change nearly every aspect of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> by using the custom configuration hook directory.
<p>Some example customization scripts can be found in <em>configure-examples.d/</em>. </p> </p>
<p>You may put your scripts into <em>configure-local.d/</em>. They will be sourced by <em>cbox-build.sh</em>. </p> <p>
Any script inside of this directory will be executed after the default configuration procedure (see <a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow&weblang=en">CryptoBoxDevWorkFlow</a>).
<h2 id="head-9b9b6463081c4d9d13e3aadebe9daaf61fa67b5c">Examples</h2> </p>
<p>
<p>The examples in <em>configure-examples.d/</em> can be copied to <em>configure-local.d/</em> and adjusted to your needs. </p> The order of execution is defined by the names of the scripts (alphabetically).
<dl> </p>
<dt>set_default_ip</dt> <h2 id="Locations">Locations</h2>
<dd><p>change the default IP address of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> </p> <p>
</dd> Some example customization scripts can be found in <a href="/trac/cryptobox/browser/trunk/configure-examples.d">configure-examples.d/</a>.
<dt>set_default_language</dt> </p>
<dd><p>set the default language </p> <p>
</dd> You may put your scripts into <i>configure-local.d/</i>. They will be sourced by <a href="/trac/cryptobox/browser/trunk/scripts/cbox-build.sh">cbox-build.sh</a>.
<dt>set_default_timeout</dt> </p>
<dd><p>set the default idle time for automatic unmounting </p> <h2 id="Examples">Examples</h2>
</dd> <p>
<dt>set_hostname</dt> The examples in <a href="/trac/cryptobox/browser/trunk/configure-examples.d">configure-examples.d/</a> can be copied to <i>configure-local.d/</i> and adjusted to your needs.
<dd><p>change the default hostname </p> </p>
</dd> <table class="wiki">
<dt>set_root_pw</dt> <tr><td>set_default_ip</td><td>change the default IP address of the CryptoBox
<dd><p>change the password of root (only useful for a development <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>) </p> </td></tr><tr><td>set_default_language</td><td>set the default language
</dd> </td></tr><tr><td>set_default_timeout</td><td>set the default idle time for automatic unmounting
<dt>import_authorized_keys</dt> </td></tr><tr><td>set_hostname</td><td>change the default hostname
<dd><p>upload a <em>ssh</em> key for passwordless access to a development <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> </p> </td></tr><tr><td>set_root_pw</td><td>change the password of root (only useful for a development <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>)
</dd> </td></tr><tr><td>import_authorized_keys</td><td>upload a <i>ssh</i> key for passwordless access to a development CryptoBox
<dt>set_scan_devices</dt> </td></tr><tr><td>set_scan_devices</td><td>where to look for usable harddisks
<dd><p>where to look for usable harddisks </p> </td></tr></table>
</dd> <hr />
</dl> <h2 id="Comments">Comments</h2>
<p>
</div>
</div>

70
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxDevKnownProblems.html
View file

@ -1,36 +1,46 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#qemu&weblang=en">qemu</a></li>
<li> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#interleavedfilesnotyetsupported&weblang=en">interleaved files not (yet) supported</a></li>
<a href="#head-3d279b986395c95455d4d831054f9664ac846790">qemu</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#smbdsegfault&weblang=en">smbd: segfault</a></li>
<ol> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#dfsbuild&weblang=en">dfsbuild</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#cantcdto_builddirtargetvarlibaptlists&weblang=en">can't cd to _builddir/target/var/lib/apt/lists</a></li>
<li> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevKnownProblems#Comments&weblang=en">Comments</a></li>
<a href="#head-9d223a1d9ee655c5a338f798fc08850a2b3694ba">interleaved files not (yet) supported</a>
</li>
<li>
<a href="#head-aa082f09cdb79c9a715826562efebd23cb8e9dfc">smbd: segfault</a>
</li>
</ol> </ol>
</div>
</li> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a>)
</ol> </p>
<p> </p> <hr />
<hr> <h1 id="Knownproblems">Known problems</h1>
<p> </p> <h2 id="qemu">qemu</h2>
<h3 id="interleavedfilesnotyetsupported">interleaved files not (yet) supported</h3>
<h2 id="head-3d279b986395c95455d4d831054f9664ac846790">qemu</h2> <p>
You should update <i>qemu</i> to version 0.7 or higher.
</p>
<h3 id="head-9d223a1d9ee655c5a338f798fc08850a2b3694ba">interleaved files not (yet) supported</h3> <h3 id="smbdsegfault">smbd: segfault</h3>
<p>
<p>You should update <em>qemu</em> to version 0.7 or higher. </p> This happens under certain circumstances. We do not know a solution for this problem.
</p>
<h3 id="head-aa082f09cdb79c9a715826562efebd23cb8e9dfc">smbd: segfault</h3> <h2 id="dfsbuild">dfsbuild</h2>
<h3 id="cantcdto_builddirtargetvarlibaptlists">can't cd to _builddir/target/var/lib/apt/lists</h3>
<p>This happens under certain circumstances. We do not know a solution for this problem. </p> <p>
This can be caused by a (strange) mix of debian package versions. Track this bug at <a class="ext-link" title="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991" href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=320991</a>.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

147
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxDevPreparation.html
View file

@ -1,86 +1,77 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Softwarerequirements&weblang=en">Software requirements</a></li>
<li> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Packages&weblang=en">Packages</a></li>
<a href="#head-5b50aeed8139c95e5a2670d4248978d942c5edd6">Software requirements</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Kernel&weblang=en">Kernel</a></li>
<ol> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Getthesource&weblang=en">Get the source</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Firstbuild&weblang=en">First build</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Finished&weblang=en">Finished</a></li>
<a href="#head-143e3ec00a024bf2d9486f21dccab7ddc0ac3709">Packages</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation#Comments&weblang=en">Comments</a></li>
</li>
<li>
<a href="#head-8abff5fecd19a74f1f5602aa82c8783c80b6862e">Kernel</a>
</li>
</ol> </ol>
</div>
<li>
<a href="#head-e988a63aa4744649892e3c85e239927edb01f336">Get the source</a>
</li>
<li>
<a href="#head-3b183abdfebed7afdbbdbb7625f85081882beb70">First build</a>
</li>
<li>
<a href="#head-08bd0ad2103b9f58bd026d64c0bcb333f3bbd90b">Finished</a>
</li>
</ol>
<p> </p>
<hr>
<p> </p>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a></em> </p>
<h2 id="head-5b50aeed8139c95e5a2670d4248978d942c5edd6">Software requirements</h2>
<h3 id="head-143e3ec00a024bf2d9486f21dccab7ddc0ac3709">Packages</h3>
<p>We use <a class="external" href="http://debian.org">Debian</a> as our development environment. This was a natural choice, as the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>-LiveCD is also based on Debian. Other distributions should work too, of course - <a class="interwiki" title="Acronym" href="http://www.acronymfinder.com/af-query.asp?String=exact&amp;Acronym=YMMV&weblang=en">YMMV</a>. </p>
<p>required: </p>
<ul>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=subversion">subversion</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=chroot">chroot</a> </p>
</li>
</ul>
<p>recommended: </p>
<ul>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-proxy">apt-proxy</a> or <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=approx">approx</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=qemu">qemu</a> </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=curl">curl</a> </p>
</li>
</ul>
<h3 id="head-8abff5fecd19a74f1f5602aa82c8783c80b6862e">Kernel</h3>
<p>If you want to use <a class="external" href="http://fabrice.bellard.free.fr/qemu/">qemu</a> to test your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> in a virtual environment, then you will need the <em>tun/tap</em> kernel feature.
</p> </p>
<pre> <p>
CONFIG_TUN=m</pre> <strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev">CryptoBoxDev</a>, <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevWorkFlow&weblang=en">CryptoBoxDevWorkFlow</a>)
<h2 id="head-e988a63aa4744649892e3c85e239927edb01f336">Get the source</h2>
<p>Download the latest release from our <a class="external" href="http://subversion.tigris.org">subversion</a>-Repository:
</p> </p>
<pre> <hr />
svn checkout https://svn.systemausfall.org/svn/cryptobox/trunk </pre> <h1 id="Preparationsfordevelopers">Preparations for developers</h1>
<h2 id="Softwarerequirements">Software requirements</h2>
<h2 id="head-3b183abdfebed7afdbbdbb7625f85081882beb70">First build</h2> <h3 id="Packages">Packages</h3>
<p>
<p>run <tt>scripts/cbox-build.sh&nbsp;release</tt> as <em>root</em> - hopefully, there should be no errors <img src="/cryptobox-img/smile.png" alt=":)" height="15" width="15"> </p> We use <a class="ext-link" title="http://debian.org" href="http://debian.org">Debian</a> as our development environment. This was a natural choice, as the CryptoBox-LiveCD is also based on Debian. Other distributions should work too, of course - <i>your mileage may vary</i>.
<p>Hint: This step will fail, if you did not install <em>apt-cacher</em>. See <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a> for details on how to change the build-configuration settings (in this case: <em>mirror</em> in <em>dfs-cbox.conf</em>). </p> </p>
<p>
<h2 id="head-08bd0ad2103b9f58bd026d64c0bcb333f3bbd90b">Finished</h2> required:
</p>
<p>Now you can start to pariticipate in the development of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> or simply customize your own <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>-LiveCD. </p> <ul><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=dfsbuild">dfsbuild</a>
<p>See <a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow">CryptoBoxDevWorkFlow</a> for details of how to use the developer's tools of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. </p> </li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=subversion" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=subversion">subversion</a>
<p><a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a> shows some examples for local customizations of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. </p> </li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=chroot" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=chroot">chroot</a>
</li></ul><p>
recommended:
</p>
<ul><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a>, <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-proxy"> apt-proxy</a> or <a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=approx">approx</a>
</li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=qemu" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=qemu">qemu</a>
</li><li><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=curl" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=curl">curl</a>
</li></ul><h3 id="Kernel">Kernel</h3>
<p>
If you want to use <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu/" href="http://fabrice.bellard.free.fr/qemu/">qemu</a> to test your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> in a virtual environment, then you will need the <i>tun/tap</i> kernel feature.
</p>
<pre class="wiki">CONFIG_TUN=m
</pre><h2 id="Getthesource">Get the source</h2>
<p>
Download the latest release from our <a class="ext-link" title="http://subversion.tigris.org" href="http://subversion.tigris.org">subversion</a>-Repository:
</p>
<pre class="wiki">svn checkout https://svn.systemausfall.org/svn/cryptobox/trunk
</pre><h2 id="Firstbuild">First build</h2>
<p>
run <tt>scripts/cbox-build.sh release</tt> as <i>root</i> - hopefully, there should be no errors :)
</p>
<p>
Hint: This step will fail, if you did not install <i>apt-cacher</i>. See <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a> for details on how to change the build-configuration settings (in this case: <i>mirror</i> in <i>dfs-cbox.conf</i>).
</p>
<h2 id="Finished">Finished</h2>
<p>
Now you can start to pariticipate in the development of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> or simply customize your own CryptoBox-LiveCD.
</p>
<p>
See <a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow">CryptoBoxDevWorkFlow</a> for details of how to use the developer's tools of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>.
</p>
<p>
<a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a> shows some examples for local customizations of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

123
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxDevValidation.html
View file

@ -1,57 +1,78 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Overview&weblang=en">Overview</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Validate&weblang=en">Validate</a></li>
<a href="#head-5e20146fd39363329427c6251209cccb8d374f3e">Overview</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Howtocreateatest&weblang=en">How to create a test</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevValidation#Comments&weblang=en">Comments</a></li>
<li>
<a href="#head-6e1d416048c4d8ebfb5b3919b4d924c77e652a7b">Validate</a>
</li>
<li>
<a href="#head-5634566bd24f83d397b43525fc62685f6e678fbf">How to create a test</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a></em> </p>
<h2 id="head-5e20146fd39363329427c6251209cccb8d374f3e">Overview</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a>)
<p>The validation feature allows to check the programming logic of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>. A lot of test cases are defined to test as many functions of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> as possible. </p> </p>
<p>The requests are processed with <a class="external" href="http://curl.haxx.se/">curl</a>. </p> <hr />
<p>The received web page is saved to allow a later design review or css debugging. </p> <h1 id="ValidationoftheCryptoBox">Validation of the CryptoBox</h1>
<p>The current state of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> is represented by ten single values (e.g.: <em>box is configured</em>, <em>IP of the box</em>, <em>current language setting</em>, ...), which are invisibly a part of each html page (as comments). The returned status of every request is compared to the predicted value of the test case. </p> <h2 id="Overview">Overview</h2>
<p>Similar test cases are pooled into test groups (e.g.: <em>initialization</em>, <em>configuration</em> and <em>mounting</em>). </p> <p>
The validation feature helps you to check the programming logic of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>. A lot of test cases are defined to verify as many functions of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> as possible.
<h2 id="head-6e1d416048c4d8ebfb5b3919b4d924c77e652a7b">Validate</h2> </p>
<p>
<p>Run <tt>scripts/validate.sh&nbsp;check_all</tt> to conduct all tests of all groups. See <tt>scripts/validate.sh&nbsp;help</tt> for other actions. </p> The requests are processed with <a class="ext-link" title="http://curl.haxx.se/" href="http://curl.haxx.se/">curl</a>.
<p>The results will be saved in <em>validation/report</em>. </p> </p>
<p>In addition to every single retrieved page, a html page called <em>summary.html</em> is created, which contains the state checks of all tests in a group. </p> <p>
The received web page is saved to allow a later design review or css debugging.
<h2 id="head-5634566bd24f83d397b43525fc62685f6e678fbf">How to create a test</h2> </p>
<p>
<p>All test cases can be found in <em>validation/test-cases</em>. </p> The current state of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> is represented by ten single values (e.g.: <i>box is configured</i>, <i>IP of the box</i>, <i>current language setting</i>, ...), which are invisibly a part of each html page (as comments). The returned status of every request is compared to the predicted value of the test case.
<p>Every test consists of: </p> </p>
<dl> <p>
<dt>input.curl</dt> Similar test cases are pooled into test groups (e.g.: <i>initialization</i>, <i>configuration</i> and <i>mounting</i>).
<dd><p>the configuration file for the <em>curl</em> request </p> </p>
</dd> <h2 id="Validate">Validate</h2>
<dt>output</dt> <p>
<dd><p>the predicted state of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> after the call </p> Run <i><a href="/trac/cryptobox/browser/trunk/scripts/validate.sh">scripts/validate.sh</a>]</i> to conduct all tests of all groups. See <i>scripts/validate.sh help</i> for other actions.
</dd> </p>
<dt>description</dt> <p>
<dd><p>a short description of the test (will be used for the summary) </p> The results will be saved in <i>validation/report</i>.
</dd> </p>
<dt>delay</dt> <p>
<dd><p>[optional] time to wait after this test </p> In addition to every single retrieved page, a html page called <i>summary-?.html</i> is created, which contains the state checks of all tests in a group.
</dd> </p>
</dl> <h2 id="Howtocreateatest">How to create a test</h2>
<p>Use the existing test cases as templates for new tests. </p> <p>
<p>Any logical path of the web interface CGI should be validated by a test case. </p> All test cases can be found in <i>validation/test-cases</i>.
</p>
<p>
Every test consists of the following files:
</p>
<table class="wiki">
<tr><td>input.curl</td><td>the configuration file for the <i>curl</i> request
</td></tr><tr><td>output</td><td>the predicted state of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> after the call
</td></tr><tr><td>description</td><td>a short description of the test (will be used for the summary)
</td></tr><tr><td>delay</td><td>[optional] time to wait after this test
</td></tr></table>
<p>
Use the existing test cases as templates for new tests.
</p>
<p>
Read <a href="/trac/cryptobox/browser/trunk/validation/test-cases/README">validation/test-cases/README</a> for details.
</p>
<p>
Every logical path of the web interface CGI should be validated by a test case.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

284
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxDevWorkFlow.html
View file

@ -1,145 +1,151 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Preparations&weblang=en">Preparations</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#CreateaCryptoBoxLiveCD&weblang=en">Create a CryptoBox-LiveCD</a></li>
<a href="#head-adacf7a8271d3f6fe8bdfb9773ac3b1f4b050f9a">Preparations</a> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Buildthebasesystem&weblang=en">Build the base system</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Configurethebaseimage&weblang=en">Configure the base image</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Removedevelopmentfeatures&weblang=en">Remove development features</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Createanisoimage&weblang=en">Create an iso image</a></li>
<a href="#head-61cec4152bb64ed5799ae7422f7150a4e3bc4860">Create a CryptoBox-LiveCD - step by step</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#BurntheCD&weblang=en">Burn the CD</a></li>
<ol> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#TesttheCryptoBoxLiveCD&weblang=en">Test the CryptoBox-LiveCD</a></li>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Chrootquickampdirtytests&weblang=en">Chroot: quick &amp; dirty tests</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Qemunearlycompleteemulation&weblang=en">Qemu: nearly complete emulation</a></li>
<a href="#head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</a> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Debuggingandmerging&weblang=en">Debugging and merging</a></li>
</li> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Developmentonarunningsystem&weblang=en">Development on a running system</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Uploadinganewrelease&weblang=en">Uploading a new release</a></li>
<li> </ol><li><a href="/cryptobox?action=doc&page=CryptoBoxDevWorkFlow#Comments&weblang=en">Comments</a></li>
<a href="#head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</a>
</li>
<li>
<a href="#head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</a>
</li>
<li>
<a href="#head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</a>
</li>
<li>
<a href="#head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</a>
</li>
</ol> </ol>
</div>
<li> </p>
<a href="#head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</a> <p>
<ol> <strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxDev">CryptoBoxDev</a>, <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomConfigure">CryptoBoxDevCustomConfigure</a>, <a href="/trac/cryptobox/wiki/CryptoBoxDevPreparation&weblang=en">CryptoBoxDevPreparation</a>)
<li> </p>
<a href="#head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick &amp; dirty tests</a> <hr />
</li> <h1 id="Developmentworkflow">Development workflow</h1>
<h2 id="Preparations">Preparations</h2>
<li> <p>
<a href="#head-2278b94f0a24871a501d80c4e6e0c53d1f5621ca">Qemu: nearly complete emulation</a> You should have completed the steps described in <a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=en">CryptoBoxDevPreparation</a>.
</li> </p>
<h2 id="CreateaCryptoBoxLiveCD">Create a CryptoBox-LiveCD</h2>
</ol> <p>
The following steps can be executed in the order of their appearance.
<li> </p>
<a href="#head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</a> <p>
<ol> Usually there is no need to repeat the whole process, after you changed some parts of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. Especially the first step (building of the base system with <i>dfsbuild</i>) may usually be skipped.
</p>
<li> <p>
<a href="#head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</a> Every step of the building process must be executed as <i>root</i>.
</li> </p>
<h3 id="Buildthebasesystem">Build the base system</h3>
<li> <p>
<a href="#head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</a> Run <i>scripts/cbox-build.sh dfsbuild</i> to create the base system for the LiveCD.
</li> </p>
<p>
</ol> The result can be found in <i>_builddir/cd1/image</i>.
</p>
</li> <p>
If you do not want to use the <i><a class="ext-link" title="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=0&amp;version=all&amp;release=all&amp;keywords=apt-cacher">apt-cacher</a> to save bandwidth and time, then you should modify the </i>mirror<i>-setting in <a href="/trac/cryptobox/browser/trunk/etc-default.d/dfs-cbox.conf">dfs-cbox.conf</a> (see <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a> for details).</i>
</ol> </p>
<p> </p> <h3 id="Configurethebaseimage">Configure the base image</h3>
<hr> <p>
<p> </p> Run <i>scripts/cbox-build.sh config</i> to copy the CryptoBox-specific files to the base image.
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxDev&weblang=en">CryptoBoxDev</a></em> </p> </p>
<p>
<h2 id="head-adacf7a8271d3f6fe8bdfb9773ac3b1f4b050f9a">Preparations</h2> TODO: link to cbox-build.sh-manpage
</p>
<p>You should have completed the steps described in <a href="/cryptobox?action=doc&page=CryptoBoxDevPreparation&weblang=en">CryptoBoxDevPreparation</a>. </p> <h3 id="Removedevelopmentfeatures">Remove development features</h3>
<p>
<h2 id="head-61cec4152bb64ed5799ae7422f7150a4e3bc4860">Create a CryptoBox-LiveCD - step by step</h2> The original base system, that was created by <i>dfsbuild</i> contains a lot packages and some scripts, that are only useful during development. You should remove them, as they cause severe security implications.
</p>
<p>The following steps can be executed in the order of their appearance. </p> <p>
<p>Usually there is no need to repeat the whole process, after you changed some parts of the <a href="/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> To reduce the CryptoBox-LiveCD to the usable minimum for operational use, you should run <i>scripts/cbox-build.sh harden</i>.
<p>Every step of the building process must be executed as <em>root</em>. </p> </p>
<h3 id="Createanisoimage">Create an iso image</h3>
<h3 id="head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</h3> <p>
To burn a CryptoBox-LiveCD, you need an bootable <i>iso9660</i>-image.
<p>Run <tt>scripts/cbox-build.sh&nbsp;dfsbuild</tt> to create the base system for the LiveCD. </p> </p>
<p>The result can be found in <em>_builddir/cd1/image</em>. </p> <p>
<p>If you do not want to use the <em><a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;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 <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a> for details). </p> Create the <i>iso</i> image with <i>scripts/cbox-build.sh iso</i>. The resulting file can be found at <i>_builddir/cd1/cryptobox.iso</i>.
</p>
<h3 id="head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</h3> <h3 id="BurntheCD">Burn the CD</h3>
<p>
<p>Run <tt>scripts/cbox-build.sh&nbsp;config</tt> to copy the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>-specific files to the base image. </p> Do it manually:
<p>TODO: link to cbox-build.sh-manpage </p> </p>
<pre class="wiki">cdrecord -v dev=0,0,0 _builddir/cryptobox.iso
<h3 id="head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</h3> </pre><p>
(change the <i>dev</i> setting according to your setup).
<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>
<p>To reduce the <a href="/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&nbsp;harden</tt>. </p> <p>
Let the script do it for you: <i>scripts/cbox-build.sh burn</i> (maybe you have to change the <i>CDWRITER</i> setting in <a href="/trac/cryptobox/browser/trunk/etc-defaults.d/cbox-dev.conf">cbox-dev.conf</a> - see <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a>).
<h3 id="head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</h3> </p>
<p>
<p>To burn a <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>-LiveCD, you need an bootable <em>iso9660</em>-image. </p> Of course, it is not wise to use CD-R media. CD-RW consume less resources.
<p>Create the <em>iso</em> image with <tt>scripts/cbox-build.sh&nbsp;iso</tt>. The resulting file can be found at <em>_builddir/cd1/cryptobox.iso</em>. </p> </p>
<h2 id="TesttheCryptoBoxLiveCD">Test the CryptoBox-LiveCD</h2>
<h3 id="head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</h3> <p>
This section is only useful for developers, who want to improve or change the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system.
<p>Do it manually: <tt>cdrecord&nbsp;-v&nbsp;dev=0,0,0&nbsp;_builddir/cd1/cryptobox.iso</tt> (change the <em>dev</em> setting according to your setup). </p> </p>
<p>Let the script do it for you: <tt>scripts/cbox-build.sh&nbsp;burn</tt> (maybe you have to change the <em>CDWRITER</em> setting in <em>cbox-dev.conf</em> - see <a href="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild&weblang=en">CryptoBoxDevCustomBuild</a>). </p> <h3 id="Chrootquickampdirtytests">Chroot: quick &amp; dirty tests</h3>
<p>Of course, it is not wise to use CD-R media. CD-RW consume less resources. </p> <p>
If you modified the <i>perl</i>- or <i>shell</i>-scripts of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>, then you can check for syntax errors by running them in a <i>chroot</i> environment. Be careful: you have access to all ressources of your computer, while you are working within a <i>chroot</i> environment - so you can easily repartition your real disk ...
<h2 id="head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</h2> </p>
<p>
<p>This section is only useful for developers, who want to improve or change the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system. </p> To start a <i>chroot</i> environment, you can execute <i>scripts/cbox-dev.sh chroot</i>.
</p>
<h3 id="head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick &amp; dirty tests</h3> <p>
For more intensive tests, you may use <i>qemu</i> (see below) or burn real LiveCDs - of course this would take much more time.
<p>If you modified the <em>perl</em>- or <em>shell</em>-scripts of the <a href="/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>
<p>To start a <em>chroot</em> environment, you can execute <tt>scripts/cbox-dev.sh&nbsp;chroot</tt>. </p> <h3 id="Qemunearlycompleteemulation">Qemu: nearly complete emulation</h3>
<p>For more intensive tests, you may use <em>qemu</em> (see below) or burn real LiveCDs - of course this would take much more time. </p> <p>
The processor emulator <a class="ext-link" title="http://fabrice.bellard.free.fr/qemu" href="http://fabrice.bellard.free.fr/qemu">qemu</a> allows you test the <a href="/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.
<h3 id="head-2278b94f0a24871a501d80c4e6e0c53d1f5621ca">Qemu: nearly complete emulation</h3> </p>
<p>
<p>The processor emulator <a class="external" href="http://fabrice.bellard.free.fr/qemu">qemu</a> allows you test the <a href="/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> Beware - there are some problems, when using <i>qemu</i>:
<p>Beware - there are some problems, when using <em>qemu</em>: </p> </p>
<ul> <ul><li><i>smbd</i> does not start (segfault)
<li><p> <em>smbd</em> does not start (segfault) </p> </li><li>???
</li> </li></ul><p>
<li><p> ??? </p> To start a <i>qemu</i> emulation of the <i>iso</i> image, you may type:
</li> </p>
</ul> <pre class="wiki">scripts/cbox-dev.sh qemu
<p>To start a <em>qemu</em> emulation of the <em>iso</em> image, you may type: <tt>scripts/cbox-dev.sh&nbsp;qemu</tt>. </p> </pre><h2 id="Debuggingandmerging">Debugging and merging</h2>
<p>
<h2 id="head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</h2> This section is only useful for developers, who want to develop on a running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system (emulated or real).
</p>
<p>This section is only useful for developers, who want to develop on a running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system (emulated or real). </p> <p>
<p>You may access the <a href="/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&nbsp;ssh</tt>). </p> You may access the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> directly or you can use <i>ssh</i> to open a remote session:
</p>
<h3 id="head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</h3> <pre class="wiki">./cbox-dev.sh ssh
</pre><h3 id="Developmentonarunningsystem">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>
<p>Type <tt>scripts/cbox-dev.sh&nbsp;diff</tt> to see the changes, you made on the running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system. </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>Type <tt>scripts/cbox-dev.sh&nbsp;merge</tt> to merge these changes to your local working copy. </p> </p>
<p>
<h3 id="head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</h3> Type <i>scripts/cbox-dev.sh diff</i> to see the changes, you made on the running <a href="/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 <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system. </p> <p>
<p>Type <tt>scripts/cbox-dev.sh&nbsp;upload</tt> - beware: all recent changes you made to the running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system, are lost. </p> Type <i>scripts/cbox-dev.sh merge</i> to merge these changes to your local working copy.
</p>
<h3 id="Uploadinganewrelease">Uploading a new release</h3>
<p>
Alternatively you may also upload a new version of your local working copy to the running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system.
</p>
<p>
Type <i>scripts/cbox-dev.sh upload</i> - beware: all recent changes you made to the running <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> system, are lost.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

82
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxUser.html
View file

@ -1,36 +1,60 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#Gettingstarted&weblang=en">Getting started</a></li>
<li> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#FirstSteps&weblang=en">First Steps</a></li>
<a href="#head-2f352729b48ed53caaf36d4f8be5585dba2d80b9">User Documentation</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#HintsCaveats&weblang=en">Hints / Caveats</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#Comments&weblang=en">Comments</a></li>
<li>
<a href="#head-2bdb4da4b459f842d64fcdbdc79ab3d6383f1407">Questions</a>
</li>
</ol> </ol>
<p> </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#ConfigurationofyourCryptoBox&weblang=en">Configuration of your CryptoBox</a></li>
<hr> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Overview&weblang=en">Overview</a></li>
<p> </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Foreword&weblang=en">Foreword</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Initialization&weblang=en">Initialization</a></li>
<h2 id="head-2f352729b48ed53caaf36d4f8be5585dba2d80b9">User Documentation</h2> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Configuration&weblang=en">Configuration</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#HintsCaveats&weblang=en">Hints / Caveats</a></li>
<p>The following pages describe the easy use of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Comments&weblang=en">Comments</a></li>
<p>The online version of this manual is a wiki, which means you can edit the pages. So if you have a question or some description is unclear, please post it on the bottom of the relevant page. The developers will answer your questions and update the manual as fast as possible. This way you can contribute in making the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> a better experience for everyone! </p>
<ol type="1">
<li><p><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted&weblang=en">CryptoBoxUserGettingStarted/en</a> -- first steps to get the Cryptobox up and running </p>
</li>
<li><p><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration&weblang=en">CryptoBoxUserConfiguration/en</a> -- configure the details of your new encrypted fileserver </p>
</li>
<li><p><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse">CryptoBoxUserDailyUse/en</a> -- daily use of your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> </p>
</li>
</ol> </ol>
<p>The online version of this manual can be found at <a href="https://systemausfall.org/toolforge/CryptoBoxUser/en">https://systemausfall.org/toolforge/CryptoBoxUser/en</a>. </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#DailyuseoftheCryptoBox&weblang=en">Daily use of the CryptoBox</a></li>
<hr> <ol><li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Activateyourencryptedfilesystem&weblang=en">Activate your encrypted filesystem</a></li>
<p> </p> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Useyourencrypteddata&weblang=en">Use your encrypted data</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Deactivateyourencryptedfilesystem&weblang=en">Deactivate your encrypted filesystem</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#ShutdownyourCryptoBox&weblang=en">Shut down your CryptoBox</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Incaseofemergency&weblang=en">In case of emergency</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#QuestionsandAnswers&weblang=en">Questions and Answers</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Comments&weblang=en">Comments</a></li>
</ol>
</ol>
</div>
<h2 id="head-2bdb4da4b459f842d64fcdbdc79ab3d6383f1407">Questions</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox/en</a>, <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser</a>)
</p>
<hr />
<h1 id="UserDocumentation">User Documentation</h1>
<p>
The following pages describe the easy use of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>.
</p>
<p>
The online version of this manual is a wiki, which means you can edit the pages. So if you have a question or you perceive a description as unclear, please post it on the bottom of the relevant page. The developers will answer your questions and update the manual as fast as possible. This way you can contribute in making the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> a better experience for everyone!
</p>
<ol><li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted&weblang=en">CryptoBoxUserGettingStarted</a> -- first steps to get the Cryptobox up and running
</li><li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration&weblang=en">CryptoBoxUserConfiguration</a> -- configure the details of your new encrypted fileserver
</li><li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse">CryptoBoxUserDailyUse</a> -- daily use of your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>
</li></ol><p>
The online version of this manual can be found at <a class="ext-link" title="https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/en" href="https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/en">https://systemausfall.org/trac/cryptobox/wiki/CryptoBoxUser/en</a>.
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

213
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxUserConfiguration.html
View file

@ -1,122 +1,103 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Overview&weblang=en">Overview</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Foreword&weblang=en">Foreword</a></li>
<a href="#head-b2e3c3d21cefdfa1346c517ec63c0c6652fba1d1">Overview</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Initialization&weblang=en">Initialization</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Configuration&weblang=en">Configuration</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#HintsCaveats&weblang=en">Hints / Caveats</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Comments&weblang=en">Comments</a></li>
<a href="#head-4244ebf306514fe0aba321b9bb92e70375af2d1f">Foreword</a>
</li>
<li>
<a href="#head-8853498a529036ba37e953d7ae99abb1c1da0113">Initialization</a>
</li>
<li>
<a href="#head-e1f6e8110136eced7bad4ae25232673890122d13">Configuration</a>
</li>
<li>
<a href="#head-dedf1b3f76a999c13b50d08148caa0f7a6ff959b">Hints / Caveats</a>
</li>
<li>
<a href="#head-e9e68aaf6182c3b5a9835f771916238c74d0cc33">Questions</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-b2e3c3d21cefdfa1346c517ec63c0c6652fba1d1">Overview</h2> </p>
<p>
<p>All parts of administration of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> are done through a comfortable web interface. If this is the first time you use the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>, just follow the steps below. </p> <strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxUser">CryptoBoxUser/en</a>, <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration&weblang=en">CryptoBoxUserConfiguration</a>)
<p>You can safely ignore the <em>Foreword</em> if you're in a hurry. </p>
<p><em>Initialization</em> describes the process of integrating a new harddisk. You usually have to perform this steps if you start with a new <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> or after changing the harddisk. </p>
<p>In the <em>Configuration</em> section, you can configure the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> according to your personal needs, e.g. change your desired language for the web interface or change the IP address of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. </p>
<p>Don't forget to read the <em>Hints / Caveats</em> section too. </p>
<h2 id="head-4244ebf306514fe0aba321b9bb92e70375af2d1f">Foreword</h2>
<p>Okay, you finished the <a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted">CryptoBoxUserGettingStarted/en</a> and are now sitting in front of a computer that is connected via network with your <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>. You point a browser to "<a href="https://192.168.0.23">https://192.168.0.23</a>" and the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> interface appears. </p>
<p>Before you can save data on your <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>, its harddisk has to be formatted with a cryptographic filesystem. Sounds complicated but don't be scared - it's really a "one click" thing. <img src="/cryptobox-img/smile.png" alt=":)" height="15" width="15&weblang=en"> </p>
<h2 id="head-8853498a529036ba37e953d7ae99abb1c1da0113">Initialization</h2>
<p>Click on <em>Initialize <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a></em> in the title bar. </p>
<p>Now you are promted to enter two passwords twice (because we want to train your typing skills ;). </p>
<ul>
<li><p> The first password is the <em>administration password</em>. </p>
<ul>
<li><p> It is used to protect the configuration of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. </p>
</li>
<li><p> This is necessary to make sure, that no one without your permission can destroy your data by re-initializing the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. </p>
</li>
<li><p> Chances are good, that you will only need it once. </p>
</li>
<li><p> You may leave it empty, but this is not recommended. </p>
</li>
</ul>
</li>
<li><p> The <em>crypto password</em> is the more important password, protecting the data on your harddisk. Choose it wisely! </p>
<ul>
<li><p> You will need it, whenever you want to access your encrypted data. </p>
</li>
<li><p> For a secure password consider a length of at least 15 characters including digits and special characters. The security of your encrypted data stands or falls with a good password. </p>
</li>
</ul>
</li>
<li><p> To avoid mistakes and to remind you on what you're going to do, you have to type the displayed red phrase into the last field. </p>
</li>
<li><p> Now you can complete the initialization by clicking on the <em>Initialize CryptoBox</em> button at the bottom of the form. </p>
</li>
</ul>
<p>That's all. Wasn't it a real "one click" thing? Cryptography has never been easier to use. <img src="/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
<p>The initialization process takes place in the background and will be completed after a few minutes, depending on your harddisk's size. </p>
<h2 id="head-e1f6e8110136eced7bad4ae25232673890122d13">Configuration</h2>
<p>While the initialization is usually done only once, the configuration can be changed at any time you want. You can reach it by clicking at <em>Configuration</em> in the menu bar of the website. Now you see a form with four fields: </p>
<ul>
<li><p> If you defined a administration passwort during <em>Initialization</em>, you have to enter it first. Otherwise this field does not appear. </p>
</li>
<li><p> If the default network address (IP) doesn't fit into your network infrastructure, you can change it in the second field. </p>
</li>
<li><p> The timeout defines the amount of time (in minutes) after that the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> deactivates the access to the encrypted data. If you e.g. copy a file on the box, it starts counting at zero, so down-/uploads won't be interrupted. </p>
<ul>
<li><p> It's good choice to enter a small number (few minutes). </p>
</li>
<li><p> A timeout of <em>0</em> turns off the automatic deactivation - this is not recommended. </p>
</li>
</ul>
</li>
<li><p> At <em>language preferences</em> you can select the default language for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> interface. </p>
</li>
</ul>
<p>Complete your changes by clicking on <em>Save configuration</em>. </p>
<p>That's all - your <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> is now ready for <a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse&weblang=en">daily use</a>! </p>
<h2 id="head-dedf1b3f76a999c13b50d08148caa0f7a6ff959b">Hints / Caveats</h2>
<ul>
<li><p> All data on the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> harddisk will be erased during <em>Initialization</em>. </p>
</li>
<li><p> All passwords have to be typed twice to reduce the chance of a typo. </p>
</li>
<li><p> The optional adminstration password is necessary for configuration only. </p>
</li>
<li><p> The crypto password protects your beloved data. </p>
</li>
<li><p> If the cryptobox is not reachable by browsing to 192.168.0.23, you may have to adjust the network settings of your computer for initialization of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. </p>
</li>
</ul>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser/en</a></em> </p>
<hr>
<p> </p>
<h2 id="head-e9e68aaf6182c3b5a9835f771916238c74d0cc33">Questions</h2>
</p>
<hr />
<h1 id="ConfigurationofyourCryptoBox">Configuration of your CryptoBox</h1>
<h2 id="Overview">Overview</h2>
<p>
All parts of administration of the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> are done through a comfortable web interface. If this is the first time you use the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>, just follow the steps below.
</p>
<p>
You can safely ignore the <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Foreword&weblang=en">Foreword</a> if you are in a hurry.
</p>
<p>
<a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Initialization">Initialization</a> describes the process of integrating a new harddisk. You usually have to perform this steps if you start with a new <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> or after replacing the harddisk.
</p>
<p>
In the <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#Configuration">Configuration</a> section, you can configure the <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> according to your personal needs, e.g. change your desired language for the web interface or change the IP address of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>.
</p>
<p>
Do not forget to read the <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration#HintsCaveats&weblang=en">Hints / Caveats</a> section too.
</p>
<h2 id="Foreword">Foreword</h2>
<p>
Okay, you finished the <a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted">CryptoBoxUserGettingStarted</a> and are now sitting in front of a computer that is connected via network with your <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>. You point a browser to &#34;<a class="ext-link" title="https://192.168.0.23&#34;" href="https://192.168.0.23&#34;">https://192.168.0.23&#34;</a> and the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> interface appears.
</p>
<p>
Before you can save data on your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>, its harddisk has to be formatted with a cryptographic filesystem. Sounds complicated but don't be scared - it's really a &#34;one click&#34; thing. :)
</p>
<h2 id="Initialization">Initialization</h2>
<p>
Click on <i>Initialize CryptoBox</i> in the title bar.
</p>
<p>
Now you are promted to enter two passwords twice (because we want to train your typing skills ;).
</p>
<ul><li>The first password is the <i>administration password</i>.
<ul><li>It is used to protect the configuration of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>.
</li><li>This is necessary to make sure, that no one without your permission can destroy your data by re-initializing the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>.
</li><li>Chances are good, that you will only need it once.
</li><li>You may leave it empty, but this is not recommended.
</li></ul></li><li>The <i>crypto password</i> is the more important password, protecting the data on your harddisk. Choose it wisely!
<ul><li>You will need it, whenever you want to access your encrypted data.
</li><li>For a secure password consider a length of at least 15 characters including digits and special characters. The security of your encrypted data stands or falls with a good password.
</li></ul></li><li>To avoid mistakes and to remind you on what you're going to do, you have to type the displayed red phrase into the last field.
</li><li>Now you can complete the initialization by clicking on the <i>Initialize !CryptoBox</i> button at the bottom of the form.
</li></ul><p>
That's all. Wasn't it a real &#34;one click&#34; thing? Cryptography has never been easier to use. ;)
</p>
<p>
The initialization process takes place in the background and will be completed after a few minutes, depending on your harddisk's size.
</p>
<h2 id="Configuration">Configuration</h2>
<p>
While the initialization is usually done only once, the configuration can be changed at any time you want. You can reach it by clicking at <i>Configuration</i> in the menu bar of the website. Now you see a form with four fields:
</p>
<ul><li>If you defined a administration passwort during <i>Initialization</i>, you have to enter it first. Otherwise this field does not appear.
</li><li>If the default network address (IP) doesn't fit into your network infrastructure, you can change it in the second field.
</li><li>The timeout defines the amount of time (in minutes) after that the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> deactivates the access to the encrypted data. If you e.g. copy a file on the box, it starts counting at zero, so down-/uploads won't be interrupted.
</li><li>It's good choice to enter a small number (few minutes).
</li><li>A timeout of <i>0</i> turns off the automatic deactivation - this is not recommended.
</li><li>At <i>language preferences</i> you can select the default language for the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> interface.
</li></ul><p>
Complete your changes by clicking on <i>Save configuration</i>.
</p>
<p>
That's all - your <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> is now ready for <a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse&weblang=en">daily use</a>!
</p>
<h2 id="HintsCaveats">Hints / Caveats</h2>
<ul><li>All data on the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> harddisk will be erased during <i>Initialization</i>.
</li><li>All passwords have to be typed twice to reduce the chance of a typo.
</li><li>The optional adminstration password is necessary for configuration only.
</li><li>The crypto password protects your beloved data.
</li><li>If the cryptobox is not reachable by browsing to 192.168.0.23, you may have to adjust the network settings of your computer for initialization of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>.
</li></ul><p>
<i>back to <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser</a></i>
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

173
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxUserDailyUse.html
View file

@ -1,62 +1,123 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Activateyourencryptedfilesystem&weblang=en">Activate your encrypted filesystem</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Useyourencrypteddata&weblang=en">Use your encrypted data</a></li>
<a href="#head-37a4d41cb3a9e26ce93c841fba0e8afd3367184b">Activate your encrypted filesystem</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Deactivateyourencryptedfilesystem&weblang=en">Deactivate your encrypted filesystem</a></li>
</li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#ShutdownyourCryptoBox&weblang=en">Shut down your CryptoBox</a></li>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Incaseofemergency&weblang=en">In case of emergency</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#QuestionsandAnswers&weblang=en">Questions and Answers</a></li>
<a href="#head-e0aa50e84f7fc78cc9e76ea1aabe9616a19d17ea">Deactivate your encrypted filesystem</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserDailyUse#Comments&weblang=en">Comments</a></li>
</li>
<li>
<a href="#head-3a58ba4feb37b325aecffed0f0b9cd3048b4ad48">Shut down your CryptoBox</a>
</li>
<li>
<a href="#head-dbb28a79cc5518696d0396b48ff4cde9cba8c5e3">In case of emergency</a>
</li>
<li>
<a href="#head-758bec29ea474875d5aafeee97fff1465a79cbe4">Questions</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-37a4d41cb3a9e26ce93c841fba0e8afd3367184b">Activate your encrypted filesystem</h2> </p>
<p>
<p>You can activate your encrypted filesystem by doing following these steps: </p> <strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxUser">CryptoBoxUser/en</a>, <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration">CryptoBoxUserConfiguration/en</a>, <a href="/trac/cryptobox/wiki/CryptoBoxUserDailyUse&weblang=en">CryptoBoxUserDailyUse</a>)
<ul>
<li><p> Point your web browser at the address of your <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>. The default is <a href="https://192.168.0.23&weblang=en">https://192.168.0.23</a>. </p>
</li>
<li><p> Click on <em>Activation of encrypted data</em>. A new page asking for your crypto password appears. </p>
</li>
<li><p> Enter your crypto password and click on the button below labeled <em>activate encrypted filesystem</em>. </p>
</li>
</ul>
<p>Now the filesystem is accessible. To use it, search for a computer in your network neighborhood. When asked for the name, enter the above IP address (default: 192.168.0.23). Now you can use it like any other network resource. </p>
<h2 id="head-e0aa50e84f7fc78cc9e76ea1aabe9616a19d17ea">Deactivate your encrypted filesystem</h2>
<p>You can deactivate the encrypted filesystem by clicking at <em>Deactivation of encrypted data</em> in the web interface of your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>. </p>
<p>Your data is now protected again. </p>
<h2 id="head-3a58ba4feb37b325aecffed0f0b9cd3048b4ad48">Shut down your CryptoBox</h2>
<p>Click at the <em>Shutdown</em> link in the menu of the web interface. There you can choose <em>poweroff</em> or <em>reboot</em>. The shutdown takes some seconds. </p>
<p>If the hardware of your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> is quite recent, it will power-off automatically. Otherwise you have to do it manually. </p>
<h2 id="head-dbb28a79cc5518696d0396b48ff4cde9cba8c5e3">In case of emergency</h2>
<p>If you have to protect the drive really fast, just power-off the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> machine instantly by pulling the plug or pushing the power button. This is not very clean and can (in very rare circumstances) corrupt open files, but it is the fasted method to secure your data. </p>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser/en</a></em> </p>
<hr>
<p> </p>
<h2 id="head-758bec29ea474875d5aafeee97fff1465a79cbe4">Questions</h2>
</p>
<hr />
<h1 id="DailyuseoftheCryptoBox">Daily use of the CryptoBox</h1>
<h2 id="Activateyourencryptedfilesystem">Activate your encrypted filesystem</h2>
<p>
You can activate your encrypted filesystem by doing following these steps:
</p>
<ul><li>Point your web browser at the address of your <a href="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>. The default is <a class="ext-link" title="https://192.168.0.23" href="https://192.168.0.23&weblang=en">https://192.168.0.23</a>.
</li><li>Click on <i>Activation of encrypted data</i>. A new page asking for your crypto password appears.
</li><li>Enter your crypto password and click on the button below labeled <i>activate encrypted filesystem</i>.
</li></ul><p>
Now the filesystem is accessible. To use it, search for a computer in your network neighborhood. When asked for the name, enter the above IP address (default: 192.168.0.23). Now you can use it like any other network resource.
</p>
<h2 id="Useyourencrypteddata">Use your encrypted data</h2>
<h3 id="Linuxcommandline">Linux - command line</h3>
<p>
To use the encrypted data partition with regular user rights add the line below to your <i>/etc/fstab</i>:
</p>
<pre class="wiki">//192.168.0.23/public /mnt/ smbfs defaults,noexec,noauto,user,guest 0 0
</pre><p>
Now you can mount the encrypted data partition to /mnt:
</p>
<pre class="wiki">mount /mnt
</pre><p>
resp. unmount:
</p>
<pre class="wiki">smbumount /mnt
</pre><h3 id="Windows">Windows</h3>
<p>
Run the the Windows Explorer and choose <i>Map network drive</i> in the <i>Tools</i> menu:
</p>
<ul><li>select a drive of your choice
</li><li>enter <i>\\192.168.0.23\public</i> (default setting) as target
</li></ul><p>
<a href='/cryptobox-img/screenshots/en_w98_network_drive.png' style='padding:0; border:none'><img src='/cryptobox-img/screenshots/en_w98_network_drive.png?format=raw' alt="en_w98_network_drive.png" title="en_w98_network_drive.png" style="" /></a>
</p>
<p>
Now you can use your encrypted data like any other network resource.
</p>
<h2 id="Deactivateyourencryptedfilesystem">Deactivate your encrypted filesystem</h2>
<p>
You can deactivate the encrypted filesystem by clicking at <i>Deactivation of encrypted data</i> in the web interface of your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a>.
</p>
<p>
Your data is now protected again.
</p>
<h2 id="ShutdownyourCryptoBox">Shut down your CryptoBox</h2>
<p>
Click at the <i>Shutdown</i> link in the menu of the web interface. There you can choose <i>poweroff</i> or <i>reboot</i>. The shutdown takes some seconds.
</p>
<p>
If the hardware of your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> is quite recent, it will power-off automatically. Otherwise you have to do it manually.
</p>
<h2 id="Incaseofemergency">In case of emergency</h2>
<p>
If you have to protect the drive really fast, just power-off the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> machine instantly by pulling the plug or pushing the power button. This is not very clean and can (in very rare circumstances) corrupt open files, but it is the fasted method to secure your data.
</p>
<p>
<i>back to <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser</a></i>
</p>
<hr />
<h2 id="QuestionsandAnswers">Questions and Answers</h2>
<h3 id="Windowsnetworkdrivecannotbemapped">Windows: network drive cannot be mapped</h3>
<p>
<a href='/cryptobox-img/screenshots/en_w98_not_logged_in.png' style='padding:0; border:none'><img src='/cryptobox-img/screenshots/en_w98_not_logged_in.png?format=raw' alt="en_w98_not_logged_in.png" title="en_w98_not_logged_in.png" style="" /></a>
</p>
<p>
This error message may appear, if you did not login during the booting of you windows machine (or you closed the login dialog by pressing ESC).
</p>
<p>
<strong>Solution:</strong> Choose <i>Logout</i> in the <i>Start</i> menu and login again.
</p>
<p>
<a href='/cryptobox-img/screenshots/en_w98_login.png' style='padding:0; border:none'><img src='/cryptobox-img/screenshots/en_w98_login.png?format=raw' alt="en_w98_login.png" title="en_w98_login.png" style="" /></a>
</p>
<h3 id="Linuxonlyrootcanunmount192168023public">Linux: only root can unmount //192.168.0.23/public</h3>
<p>
You can't unmount the partition with <i>umount</i>.
</p>
<p>
<strong>Solution:</strong> Use <i>smbumount</i> instead:
</p>
<pre class="wiki">smbumount /mnt
</pre><h3 id="LinuxOperationnotpermittedsmbmntfailed1">Linux: Operation not permitted / smbmnt failed: 1</h3>
<p>
The attempt to mount the partition as a regular user ends up with:
</p>
<pre class="wiki">cannot mount on /mnt/: Operation not permitted
smbmnt failed: 1
</pre><p>
<strong>Solution:</strong> Set the directory's owner to the same user that mounts the share (e.g. phil):
</p>
<pre class="wiki">chown phil. /mnt
</pre><hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

121
v0.2.1/cbox-tree.d/usr/share/doc/cryptobox/html/en/CryptoBoxUserGettingStarted.html
View file

@ -1,73 +1,64 @@
<a id="top"></a>
<div class="wikipage">
<div id="searchable"><p>
<div class='wiki-toc'>
<h4>Table of Contents</h4>
<ol> <ol>
<li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#FirstSteps&weblang=en">First Steps</a></li>
<li> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#HintsCaveats&weblang=en">Hints / Caveats</a></li>
<a href="#head-059e26ee46182561a1c7e35e1a1ab2bf8a7a27ac">First Steps</a> <li><a href="/cryptobox?action=doc&page=CryptoBoxUserGettingStarted#Comments&weblang=en">Comments</a></li>
</li>
<li>
<a href="#head-f205f691abc70f7d2c60001ef96f32f544017295">Hints / Caveats</a>
</li>
<li>
<a href="#head-237d3c26a42096a88e84db8c4f6d8923df1c2899">Questions</a>
</li>
</ol> </ol>
<p> </p> </div>
<hr>
<p> </p>
<h2 id="head-059e26ee46182561a1c7e35e1a1ab2bf8a7a27ac">First Steps</h2> </p>
<p>
<strong>Navigation:</strong> ( <a href="/cryptobox?action=doc&page=CryptoBoxUser">CryptoBoxUser/en</a>, <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration">CryptoBoxUserConfiguration/en</a>, <a href="/trac/cryptobox/wiki/CryptoBoxUserGettingStarted&weblang=en">CryptoBoxUserGettingStarted</a>)
<p>Getting the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> started doesn't take much: </p> </p>
<ol type="1"> <hr />
<li><p>You need an old Computer (at least 100MHz, 48MB RAM) (rule of thumb: bought at least after 1996). This PC needs a network card, a CD-ROM drive and a huge harddisk. </p> <h1 id="Gettingstarted">Getting started</h1>
<ul> <h2 id="FirstSteps">First Steps</h2>
<li><p> Well the disk doesn't need to be huge, it should just suit your filestorage needs <img src="/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p> <p>
</li> Getting the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> started doesn't take much:
<li><p> You don't need a monitor or a keyboard to use your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> (with one exception, see below). </p> </p>
</li> <ol><li>You need an old Computer (at least 100MHz, 48MB RAM) (rule of thumb: bought at least after 1996). This PC needs a network card, a CD-ROM drive and a huge harddisk.
<li><p> Of course, you may use a faster computer, but they usually consume much more energy and do not provide signifcant advantages. </p> <ul><li>Well the disk doesn't need to be huge, it should just suit your filestorage needs ;)
</li> </li><li>You don't need a monitor or a keyboard to use your <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> (with one exception, see below).
</ul> </li><li>Of course, you may use a faster computer, but they usually consume much more energy and do not provide signifcant advantages.
</li> </li></ul></li><li>Then download the latest version of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> as an iso-image and burn this image onto a CD.
<li><p>Then download the latest version of the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> as an iso-image and burn this image onto a CD. </p> <ul><li><a class="ext-link" title="http://codecoop.org/projects/cryptobox/" href="http://codecoop.org/projects/cryptobox/">http://codecoop.org/projects/cryptobox/</a>
<ul> </li></ul></li><li>Configure your PC, so it can boot from the CD. Therefore you have to enter the BIOS and configure the CD-ROM as boot device.
<li><p> <a href="http://codecoop.org/projects/cryptobox/">http://codecoop.org/projects/cryptobox/</a> </p> </li><li>Insert the shiny new <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> CD you've just burned and start the computer.
</li> </li></ol><p>
</ul>
</li>
<li><p>Configure your PC, so it can boot from the CD. Therefore you have to enter the BIOS and configure the CD-ROM as boot device. </p>
</li>
<li><p>Insert the shiny new <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> CD you've just burned and start the computer. </p>
</li>
</ol>
<p>If it now boots from the CD, you accomplished all of the requirements. </p>
<p>Now you can just go to your current desktop computer and point your browser to <a href="https://192.168.0.23">https://192.168.0.23</a> where the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> interface should be displayed. Easy - isn't it? </p>
<p>For further steps go to <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration&weblang=en">CryptoBoxUserConfiguration/en</a>. </p>
<h2 id="head-f205f691abc70f7d2c60001ef96f32f544017295">Hints / Caveats</h2> If it now boots from the CD, you accomplished all of the requirements.
</p>
<ul> <p>
<li><p> Maybe you need to change the network address (IP) of your PC to configure the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> for the first time. Ask someone for help, if you don't know how and why ... </p> Now you can just go to your current desktop computer and point your browser to <a class="ext-link" title="https://192.168.0.23" href="https://192.168.0.23">https://192.168.0.23</a> where the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> interface should be displayed. Easy - isn't it?
</li> </p>
<li><p> If you're going to buy a new harddisk keep in mind that very old hardware can't handle actual disksizes! </p> <p>
</li> For further steps go to <a href="/cryptobox?action=doc&page=CryptoBoxUserConfiguration&weblang=en">CryptoBoxUserConfiguration</a>.
<li><p> Some old PCs are not able to boot from CD. </p> </p>
</li> <h2 id="HintsCaveats">Hints / Caveats</h2>
<li><p> If you don't know what a BIOS is, better ask someone, before you try to change something. <img src="/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p> <p>
</li>
<li><p> Don't forget to connect your PC to your local area network! </p>
</li>
<li><p> To configure the BIOS, you need a keyboard and a monitor. But this has to be done only once. </p>
</li>
</ul>
<p><em>back to <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser/en</a></em> </p>
<hr>
<p> </p>
<h2 id="head-237d3c26a42096a88e84db8c4f6d8923df1c2899">Questions</h2>
</p>
<ul><li>Maybe you need to change the network address (IP) of your PC to configure the <a href="/cryptobox?action=doc&page=CryptoBox&weblang=en">CryptoBox</a> for the first time. Ask someone for help, if you don't know how and why ...
</li><li>If you're going to buy a new harddisk keep in mind that very old hardware can't handle current disk sizes!
</li><li>Some old PCs are not able to boot from CD.
</li><li>If you don't know what a BIOS is, better ask someone, before you try to change something. ;)
</li><li>Don't forget to connect your PC to your local area network!
</li><li>To configure the BIOS, you need a keyboard and a monitor. But this has to be done only once.
</li></ul><p>
<i>back to <a href="/cryptobox?action=doc&page=CryptoBoxUser&weblang=en">CryptoBoxUser</a></i>
</p>
<hr />
<h2 id="Comments">Comments</h2>
<p>
</div>
</div>

1
v0.2.1/cbox-tree.d/var/www/cgi-bin/cryptobox.pl
View file

@ -1,4 +1,5 @@
#!/usr/bin/perl #!/usr/bin/perl
# $Id$
# #
# web interface of the CryptoBox # web interface of the CryptoBox
# #

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/de_config.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 78 KiB

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/de_init.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 61 KiB

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/de_mount.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 58 KiB

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/de_w98_login.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 3.6 KiB

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/de_w98_network_drive.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 3.3 KiB

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/de_w98_not_logged_in.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 2.8 KiB

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/en_config.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 83 KiB

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/en_mount.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 70 KiB

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/en_w98_login.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 3.4 KiB

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/en_w98_network_drive.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 2.9 KiB

BIN
v0.2.1/cbox-tree.d/var/www/cryptobox-img/screenshots/en_w98_not_logged_in.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 2.8 KiB

BIN
v0.2.1/cover/antlogo-big.jpg Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 42 KiB

1048
v0.2.1/cover/cover_de.pdf Normal file
View file

File diff suppressed because it is too large Load diff

BIN
v0.2.1/cover/cover_de.sxw Normal file
View file

Binary file not shown.

BIN
v0.2.1/cover/cover_en.pdf Normal file
View file

Binary file not shown.

BIN
v0.2.1/cover/cover_en.sxw Normal file
View file

Binary file not shown.

16
v0.2.1/etc-defaults.d/dfs-cbox.conf
View file

@ -116,10 +116,16 @@ allpackages = util-linux
#diff #diff
#patch #patch
# Default mirror for "repo" sections
mirror = http://127.0.0.1/apt-cacher/ftp.de.debian.org/debian # select a mirror for the repository (apt-cacher, apt-proxy, no caching) by
# uncommenting the line of your choice
# (1) apt-cacher (default)
mirror = http://127.0.0.1/apt-cacher/ftp.debian.org/debian
# (2) apt-proxy
#mirror = http://localhost:9999/debian
# (3) no caching proxy for apt
#mirror = http://ftp.debian.org/debian #mirror = http://ftp.debian.org/debian
#mirror = http://mirrors/debian
# Devices to probe for CD # Devices to probe for CD
devices = scd0 scd1 scd2 scd3 scd4 hda hdb hdc hdd hde hdf hdg devices = scd0 scd1 scd2 scd3 scd4 hda hdb hdc hdd hde hdf hdg
@ -167,7 +173,7 @@ deletefiles = /etc/rcS.d/*discover
# Debs from local fs to unpack on live FS (will not be configured) # Debs from local fs to unpack on live FS (will not be configured)
#unpackdebs = kernel/kernel-image-2.6.8_1.dfs_i386.deb #unpackdebs = kernel/kernel-image-2.6.8_1.dfs_i386.deb
unpackdebs = kernel/kernel-image-2.6.11_cryptobox.1_i386.deb unpackdebs = kernel/kernel-image-2.6.12.6_cryptobox0.3_i386.deb
# Other packages to install besides the list in DEFAULT # Other packages to install besides the list in DEFAULT
packages = %(allpackages)s packages = %(allpackages)s
@ -214,8 +220,6 @@ arch = amd64
# /etc/modules = # /etc/modules =
/etc/issue = This is the CryptoBox!
/etc/profile = export TERM=vt100 /etc/profile = export TERM=vt100
###################################################################### ######################################################################

6
v0.2.1/hints/codecoop-website-upload.txt Normal file
View file

@ -0,0 +1,6 @@
by scp or webdav - the last one is the better choice
1) webdav
apt-get install davfs2
modprobe coda
mount -t davfs https://upload.codecoop.org/groups/cryptobox/ /mnt/ttt

23
v0.2.1/hints/kernel-build.txt Normal file
View file

@ -0,0 +1,23 @@
Hints for building and integrating a new kernel into the cryptobox:
1) get the source
download it from http://kernel.org (at least 2.6.11)
2) configure
- copy the current kernel config from the cryptobox/trunk/kernel
directory to the kernel source directory as ".config" (the .config
can also be found in the current kernel-image-cryptoboxX.Y.deb packagefile)
- make menuconfig
- make-kpkg --rootcmd fakeroot --revision=cryptoboxY.X kernel_image
(replace "Y.X" by the current cryptobox release)
3) integrating
- copy the debian kernel package (see above) and the config file to cryptobox/trunk/kernel
- change the "unpackdebs" setting in cryptobox/trunk/etc-default.d/dfs-cbox.conf
- add the new kernel package and the config file to the repository (svn add)
4) afterwork
- run "cryptobox/trunk/scripts/cbox-build.sh dfsbuild" to create a fresh base system
including the new kernel
- test the box with your new kernel
- enjoy it! :)

18
v0.2.1/hints/release-policy.txt
View file

@ -1,16 +1,24 @@
1) set current version 1) set current version
- README - README
- cbox-tree.d/usr/share/cryptobox/templates/footer.cs - cbox-tree.d/usr/share/cryptobox/templates/footer.cs
- cover/cover_[en|de].[swx|pdf]
2) build image 2) build image
- 'scripts/cbox-build.sh release' - 'scripts/cbox-build.sh release'
- for a compressed image: 'scripts/cbox-build.sh isoz'
4) release notes
- https://systemausfall.org/trac/wiki/ReleaseNotes
3) upload to codecoop 3) upload to codecoop
- type "scp FILE shell.codecoop.org:." - type "scp $FILE $USERNAME@shell.codecoop.org:."
- upload a dummy file with the same name via upload-web-interface to codecoop - upload a dummy file with the same name via upload-web-interface to codecoop
- ask Jan Kanzleiter <idfx@codecoop.org> to replace the dummy by the the scp-file - ask Jan Kanzleiter <idfx_at_codecoop.org> to replace the dummy with the the scp-file
- upload the checksumfile created by "md5sum cryptobox_vY.X.iso >cryptobox_vY.X.iso.md5sum"
- add release notes and changelog
- upload cover_[en|de].pdf
4) release announcement 4) release announcement
- codecoop - http://codecoop.org
- distrowatch - http://distrowatch.com
- http://livedistro.org
- http://linuxlinks.com

27
v0.2.1/hints/trac-wiki.txt Normal file
View file

@ -0,0 +1,27 @@
some useful macros:
* [[TOC]] - at the beginning of the document
* [[AutoNav]] - below [[TOC]], followed by a line with "----"
* [[AddComment]] - at the end of the page (below "----")
* [[WikiInclude($PAGENAME)]] - include another wiki page
* [[redirect(wiki:$PAGENAME)]] - redirect to another page (useful to redirect to default lang)
* [[Image(file/trunk/cbox-tree.d/var/www/cryptobox-img/screenshots/$NAME)]] - beware: you may use "wiki" or "ticket" instead of "file" - very unusual syntax
* [[FootNote(Text)]] - creates a reference to a footnote - the list of footnotes is expanded by "[[FootNote]]"
special things:
* the first level heading ("= TEXT =") is considered as the page title - only lower level headings will be a part of the table of contents
* links like "CryptoBoxUser/de" are not recogniced - use "[wiki:CryptoBoxUser/de CryptoBoxUser]" instead
* for a deeper level of items or enumerations, you have to add two(!) additional spaces in front of the symbol ("*" or "1.") - this is obviously strange ...
default page layout:
[[TOC]]
[[AutoNav]]
----
= Title =
== Heading ... ==
...
----
== Comments ==
[[AddComment]]

Some files were not shown because too many files have changed in this diff Show more