[[!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]]."]]"""]]

[[!meta title="Documentation"]]

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. You needn't go through all of these, but they're all very enjoyable if you wanted to do just that.

## Operating Systems Basics

* [Udacity](https://www.udacity.com/) - Good, free, self-paced online courses about operating systems.
* [Operating Systems: Three Easy Pieces](http://pages.cs.wisc.edu/~remzi/OSTEP/) - An excellent book on operating systems.
* [[!wikipedia Advanced_Programming_in_the_Unix_Environment]] - May help you grasp UNIX & POSIX standards.
* [Operating Systems](http://www.deitel.com/Books/OperatingSystems/OperatingSystems3e/tabid/1711/Default.aspx) - A well praised book on the subject.
* [Operating System Concepts](https://www.os-book.com/OS9/) - Another well praised book.
* [Modern Operating Systems](https://en.wikipedia.org/wiki/Modern_Operating_Systems) - This book has achieved world-wide praise.

## 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 article anyway
    does a good job at describing general principles of a [[capability]]-based
    system architecture.

---
# Quick overview

You may want to start reading a [[quick overview|overview]] of how the GNU/Hurd system
starts, and thus how it is structured.

---
# FAQ

[[FAQ]]

---
# Specific Components

The GNU/Hurd system is composed of the Hurd servers running on top of the
GNU Mach microkernel. Mach only handles scheduling tasks and threads, memory
management, and message passing. Mig is used to abstract RPCs on top of Mach's
message passing. Eventually, the Hurd servers and Unix processes discuss with
each other using these RPCs.

Depending on your background, you may want to start reading the documentation
from userlandish interfaces (Hurd) or from the micro kernel itself (Mach).

  * [[GNU_Hurd|hurd/documentation]]

  * [[Mach|microkernel/mach/documentation]]

  * [[MIG|microkernel/mach/mig/documentation]]

  * [[UNIX]]

---
# Presentations

## 2019

  * FOSDEM: {{$community/meetings/fosdem_2019#thibault_hurd}}

## 2018

  * FOSDEM: {{$community/meetings/fosdem_2018#thibault_hurd}}

## 2017

  * FOSDEM: {{$community/meetings/fosdem_2017#ragkousis_guix_hurd}}
  * FOSDEM: {{$community/meetings/fosdem_2017#winter_hurd}}

## 2016

  * FOSDEM: {{$community/meetings/fosdem_2016#ragkousis_guix_hurd}}
  * FOSDEM: {{$community/meetings/fosdem_2016#thibault_hurd}}

## 2015

  * FOSDEM: {{$community/meetings/fosdem_2015#thibault_hurd}}
  * Debconf 15: {{$community/meetings/debconf15#youpi_hurd}}

## 2014

  * FOSDEM: {{$community/meetings/fosdem_2014#thibault_hurd}}

## 2013

  * GNU Hackers Meeting in Paris: {{$community/meetings/ghm2013#thibault_hurd}}

  * FOSDEM: {{$community/meetings/fosdem_2013#thibault_hurd}}

## 2011

  * GNU Hackers Meeting in Paris: {{$community/meetings/ghm2011#thibault_hurd}}

## 2010

  * GNU Hackers Meeting in the Hague: {{$community/meetings/ghm2010#walfield_hurd}}

  * Debconf 10: {{$community/meetings/debconf10#banck_hurd}}

  * Fosdem 2010: {{$community/meetings/fosdem_2010#olaf_hurd1}}
  * Fosdem 2010: {{$community/meetings/fosdem_2010#olaf_hurd2}}

## 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.

---
# General

  * [[Media_Appearances]]

---
# IRC Logs

The IRC logs contain wealth of information.  Many topics have been covered before in the IRC logs.  You can use wget to
download all of the logs and grep for the information that you want.

`wget --mirror --no-parent -A "hurd-*" -e robots=off http://richtlijn.be/~larstiq/hurd/`