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

Are you 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 (see the list of [[!taglink Documentation_Issues|open_issue_documentation]]).

[[!toc levels=1]]

---
# 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. Of course [the Plan-9 people don't like it](http://harmful.cat-v.org/software/andy_tanenbaum).

## GNU/Hurd System Architecture
You may want to start reading a [[quick overview|overview]] of how the GNU/Hurd system
starts, and thus how it is structured. Also see our [[FAQ]]

### Capabilities
  * Read up on [[Capabilities|capability]], [[!wikipedia Capability_Based_Security]],
    and, [What is a Capability, Anyway?](https://archive.is/20130112225523/http://www.eros-os.org/essays/capintro.html)

    In the GNU/Hurd system, a capability is represented by a [[Mach
    port|microkernel/mach/port]].

---
# 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/`