aboutsummaryrefslogtreecommitdiff
path: root/documentation.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'documentation.mdwn')
-rw-r--r--documentation.mdwn75
1 files changed, 68 insertions, 7 deletions
diff --git a/documentation.mdwn b/documentation.mdwn
index 8559eff1..5ab08bfb 100644
--- a/documentation.mdwn
+++ b/documentation.mdwn
@@ -1,12 +1,63 @@
-[[!meta copyright="Copyright © 2008 Free Software Foundation, Inc."]]
+[[!meta copyright="Copyright © 2008, 2010, 2011 Free Software Foundation,
+Inc."]]
[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
id="license" text="Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no Invariant
Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
-is included in the section entitled
-[[GNU Free Documentation License|/fdl]]."]]"""]]
+is included in the section entitled [[GNU Free Documentation
+License|/fdl]]."]]"""]]
+
+You are interested in getting familiar with the GNU/Hurd system architecture,
+or specific components of it? Here is a collection of texts to read.
+
+/!\ A lot of stuff is still missing ([[!taglink open_issue_documentation]]).
+
+[[!toc levels=3]]
+
+
+# Basic Knowledge
+
+Before you can go details, you have to learn the basics about operating system
+architecture. Yes, really.
+
+
+## Operating Systems Basics
+
+Books. Etc.
+
+
+## GNU/Hurd System Architecture
+
+
+### Capabilities
+
+[[!toggleable id=shapiro_capintro_1999 text="""[[!template id=note
+text="*[[shapiro\_capintro\_1999|capability]]*:
+{{$capability#shapiro_capintro_1999}}.
+{{$capability#shapiro_capintro_1999_text}}."]]"""]]
+
+ * Our use of [[capabilities|capability]]. The
+ {{$capability#wikipedia_capability-based_security}} article.
+ Alternatively/additionally, [[!toggle id=shapiro_capintro_1999
+ text="[shapiro\_capintro\_1999]"]].
+
+ In the GNU/Hurd system, a [[capability]] is represented by a [[Mach
+ port|microkernel/mach/port]].
+
+ * {{$capability#wikipedia_object-capability_model}}. Albeit not directly
+ tailored at the GNU/Hurd operating system architecture, this artice anyway
+ does a good job at describing general principles of a [[capability]]-based
+ system architecture.
+
+
+# FAQ
+
+[[FAQ]]
+
+
+# Specific Components
Documentation for...
@@ -16,9 +67,19 @@ Documentation for...
* [[MIG|microkernel/mach/mig/documentation]]
+ * [[UNIX]]
+
+
+# Presentations
+
+## 2004
+
+ * 2004-07-02
+
+ Ognyan Kulev, *presentation of the Hurd*, at the seminar *LIO and friends*,
+ <http://debian.fmi.uni-sofia.bg/~ogi/hurd/liofest-20040702-hurd.ppt>, in
+ Bulgarian.
-# [[Unix]] Programming
+# General
- * *The C Programming Language* by Brian W. Kernighan and Dennis M. Ritchie,
- [order from
- Amazon](http://www.amazon.com/Programming-Language-Prentice-Hall-Software/dp/0131103628/ref=pd_bxgy_b_img_a)
+ * [[Media_Appearances]]