diff options
| -rw-r--r-- | contributing.mdwn | 10 | ||||
| -rw-r--r-- | devel.html | 159 | ||||
| -rw-r--r-- | docs.html | 302 | ||||
| -rw-r--r-- | documentation.mdwn | 16 | ||||
| -rw-r--r-- | hurd.mdwn | 2 | ||||
| -rw-r--r-- | hurd/authentication.mdwn | 2 | ||||
| -rw-r--r-- | hurd/critique.mdwn | 4 | ||||
| -rw-r--r-- | hurd/documentation.mdwn | 48 | ||||
| -rw-r--r-- | hurd/documentation/auth.html (renamed from auth.html) | 96 | ||||
| -rw-r--r-- | hurd/documentation/hurd-paper.html (renamed from hurd-paper.html) | 70 | ||||
| -rw-r--r-- | hurd/documentation/hurd-talk.html (renamed from hurd-talk.html) | 110 | ||||
| -rw-r--r-- | hurd/hurd_hacking_guide.mdwn | 16 | ||||
| -rw-r--r-- | hurd/ng/position_paper.mdwn | 9 | ||||
| -rw-r--r-- | hurd/reference_manual.mdwn | 18 | ||||
| -rw-r--r-- | hurd/running/distrib.mdwn | 2 | ||||
| -rw-r--r-- | hurd/running/gnu/universal_package_manager.mdwn | 2 | ||||
| -rw-r--r-- | hurd/translator.mdwn | 1 | ||||
| -rw-r--r-- | hurd/translator/auth.mdwn | 13 | ||||
| -rw-r--r-- | microkernel/faq/multiserver_microkernel.mdwn | 4 | ||||
| -rw-r--r-- | microkernel/mach/documentation.mdwn | 18 | ||||
| -rw-r--r-- | microkernel/mach/gnu_mach.mdwn | 1 | ||||
| -rw-r--r-- | microkernel/mach/gnu_mach/reference_manual.mdwn | 26 | ||||
| -rw-r--r-- | microkernel/mach/mig/documentation.mdwn | 3 |
23 files changed, 184 insertions, 748 deletions
diff --git a/contributing.mdwn b/contributing.mdwn index 698d03b3..f1003389 100644 --- a/contributing.mdwn +++ b/contributing.mdwn @@ -52,7 +52,7 @@ is another possibility, see the page about [[running_a_Hurd_system|hurd/running]] for the full story. Then you can either play around and eventually strive to do something -useful or -- if you want -- ask us to assign something to you, depending +useful or -- if you want -- [[ask_us|contact_us]] to assign something to you, depending on the skills you have and the resources you intend to invest. Please spend some time with thinking about the items in this [[questionnaire]]. @@ -62,10 +62,10 @@ system, e.g., [[microkernels_for_beginners|microkernel/for_beginners]]. Until you can do the basic exercises listed there, you won't be able to significantly contribute to the Hurd. -For more reading resources, please see these web pages, and also -<http://www.gnu.org/software/hurd/devel.html>, -<http://www.gnu.org/software/hurd/docs.html> for links to a bunch of documents, -and <http://www.gnu.org/software/hurd/> in general. +For more reading resources, please see these web pages, for example, +[[Hurd_documentation|hurd/documentation]] and +[[Mach_documentation|microkernel/mach/documentation]] for links to a bunch of +documents. ### Porting Packages diff --git a/devel.html b/devel.html deleted file mode 100644 index 2a31f959..00000000 --- a/devel.html +++ /dev/null @@ -1,159 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" - "http://www.w3.org/TR/REC-html40/strict.dtd"> -<HTML> -<HEAD> -<TITLE>The GNU Hurd - GNU Project - Free Software Foundation (FSF)</TITLE> -<LINK REV="made" HREF="mailto:web-hurd@gnu.org"> -<META NAME="keywords" CONTENT="hurd"> -</HEAD> -<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD"> -<TABLE width="100%" border="0" cellspacing="5" cellpadding="15"> -<TR> -<TD COLSPAN="2"> -<IMG SRC="/graphics/hurd_sm_mf.jpg" ALT=" [image of the Hurd logo] "> -[ -<!-- Please keep this list alphabetical --> -<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! --> - <A HREF="/software/hurd/devel.html">en</A> -| <A HREF="/software/hurd/devel.eo.html">eo</A> -| <a href="/software/hurd/devel.es.html">es</a> -] -</TD> -</TR> -<TR> -<TD ALIGN="LEFT" VALIGN="TOP" BGCOLOR="#eeeeee"> -<A HREF="/software/hurd/whatsnew.html"><STRONG>What's New</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/changelogs.html">ChangeLogs</A><BR> - <br> -<a href="/software/hurd/docs.html">Documentation</a><br> -<P> -<A HREF="/software/hurd/hurd.html"><STRONG>GNU Hurd</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/install.html">Installation</A><BR> -<A HREF="/software/hurd/help.html">Getting Help</A><BR> -<A HREF="/software/hurd/download.html">Source Code</A><BR> -<A HREF="/software/hurd/devel.html">Development</A><BR> -<A HREF="/software/hurd/history.html">History</A><BR> - <BR> -<A HREF="/software/hurd/gnumach.html"><STRONG>GNU Mach</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/gnumach-install.html">Installation</A><BR> -<A HREF="/software/hurd/gnumach-download.html">Source Code</A><BR> - <BR> -<A HREF="/software/hurd/mig.html"><STRONG>GNU MIG</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/mig-download.html">Source Code</A><BR> - <BR> -<A HREF="/software/hurd/related-projects.html"><STRONG>Related Projects</STRONG></A> -</TD> -<TD ALIGN="LEFT" VALIGN="TOP"> -<HR> -<H3><A NAME="contents">Table of Contents</A></H3> -<UL> - <LI><A HREF="#contrib" NAME="TOCcontrib">Contributing</A> - <li><a href="#machinery" name="TOCmachinery">Machinery: getting access to a - system</a> - <LI><A HREF="#tasks" NAME="TOCtasks">Tasks</A> -</UL> -<HR> - -<H3><A HREF="#TOCcontrib" NAME="contrib">Contributing</A></H3> -<P> -If you want to contribute to the Hurd, you should first install and -use it for a while, to become familiar with its features and design. -To join the development team, subscribe to the -<a href="http://lists.gnu.org/mailman/listinfo/bug-hurd">Bug-Hurd</a> -<a href="mailto:bug-hurd@gnu.org"><bug-hurd@gnu.org></a> -mailing list, which is also the place where you can announce your -intentions, make your proposals and send in your patches. -(You can also send mail there without being subscribed to the list.) -<P> -There is also the <a -href="http://lists.gnu.org/mailman/listinfo/hurd-devel-readers"> -Hurd-devel-readers</a> -mailing list. It is the read-only version of Hurd-devel, an internal -low-volume list restricted to the core developers of the Hurd. If you -want to follow up on the discussion of the Hurd experts, please reply -to the Bug-hurd mailing list. You can also follow the Hurd-devel -mailing list by browsing the <A -HREF="http://lists.gnu.org/archive/html/hurd-devel/">web-based archive of -Hurd-devel</A>. - -<h3><a href="#TOCmachinery" name="machinery">Machinery: getting access to a -system</a></h3> -<p> -There are essentially two possibilities: either you install the GNU/Hurd on a -system (see <a href="/software/hurd/install.html">here</a>) or if you don't -have a system to install it on, you can be provided with a shell account. See -<a href="http://www.bddebian.com/~wiki/public_hurd_boxen">this wiki page</a> -for details. - -<H3><A HREF="#TOCtasks" NAME="tasks">Tasks</A></H3> -<P> -Developing an operating system is a huge job, with a lot of different -things to do. To be able to keep track of issues, we use a -<ul> - <li><a - href="http://savannah.gnu.org/bugs/?func=browse&set=open&group=hurd">bug - tracker</a> to register and comment on bugs, a - <li><a - href="http://savannah.gnu.org/task/?func=browse&set=open&group=hurd">task - tracker</a> for tasks people could work on and a - <li><a - href="http://savannah.gnu.org/patch/?func=browse&set=open&group=hurd">patch - tracker</a> where people can install their patches. -</ul> -There is also an older (but still valid) list of specific items in the -<A HREF="http://cvs.savannah.gnu.org/viewcvs/~checkout~/hurd/hurd/tasks?rev=HEAD&content-type=text/plain">task file</A> -and in the -<A HREF="http://cvs.savannah.gnu.org/viewcvs/~checkout~/hurd/hurd/TODO?rev=HEAD&content-type=text/plain">TODO file</A> -of the Hurd source repository. - -</TD> -</TR> -</TABLE> - -<HR> - -[ -<!-- Please keep this list alphabetical --> -<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! --> - <A HREF="/software/hurd/devel.html">en</A> -| <A HREF="/software/hurd/devel.eo.html">eo</A> -| <a href="/software/hurd/devel.es.html">es</a> -] - -<HR> - -<P> -Return to <A HREF="/home.html">GNU's home page</A>. -<P> - -Please send FSF & GNU inquiries & questions to - -<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. -There are also <A HREF="/home.html#ContactInfo">other ways to -contact</A> the FSF. -<P> - -Please send comments on these web pages to - -<A HREF="mailto:web-hurd@gnu.org"><EM>web-hurd@gnu.org</EM></A>, -send other questions to -<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. -<P> -Copyright (C) 2001, 2002, 2006, 2007 -Free Software Foundation, Inc., -59 Temple Place - Suite 330, Boston, MA 02111, USA -<P> -Verbatim copying and distribution of this entire article is -permitted in any medium, provided this notice is preserved. -<P> -Updated: -<!-- timestamp start --> -$Date$ $Author$ -<!-- timestamp end --> -<HR> -</BODY> -</HTML> diff --git a/docs.html b/docs.html deleted file mode 100644 index 9c3a43f1..00000000 --- a/docs.html +++ /dev/null @@ -1,302 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" - "http://www.w3.org/TR/REC-html40/strict.dtd"> -<HTML> -<HEAD> -<meta http-equiv="content-type" content="text/html; charset=utf-8"> -<TITLE>The GNU Hurd - GNU Project - Free Software Foundation (FSF)</TITLE> -<LINK REV="made" HREF="mailto:web-hurd@gnu.org"> -<META NAME="keywords" CONTENT="hurd"> -</HEAD> -<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD"> -<TABLE width="100%" border="0" cellspacing="5" cellpadding="15"> -<TR> -<TD COLSPAN="2"> -<IMG SRC="/graphics/hurd_sm_mf.jpg" ALT=" [image of the Hurd logo] "> -[ -<!-- Please keep this list alphabetical --> -<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! --> - <A HREF="/software/hurd/docs.html">English</A> -| <A HREF="/software/hurd/docs.eo.html">Esperanto</A> -| <a href="/software/hurd/docs.es.html">Spanish</a> -] -</TD> -</TR> -<TR> -<TD ALIGN="LEFT" VALIGN="TOP" BGCOLOR="#eeeeee"> -<A HREF="/software/hurd/whatsnew.html"><STRONG>What's New</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/changelogs.html">ChangeLogs</A><BR> - <br> -<a href="/software/hurd/docs.html">Documentation</a><br> -<P> -<A HREF="/software/hurd/hurd.html"><STRONG>GNU Hurd</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/install.html">Installation</A><BR> -<A HREF="/software/hurd/help.html">Getting Help</A><BR> -<A HREF="/software/hurd/download.html">Source Code</A><BR> -<A HREF="/software/hurd/devel.html">Development</A><BR> -<A HREF="/software/hurd/history.html">History</A><BR> - <BR> -<A HREF="/software/hurd/gnumach.html"><STRONG>GNU Mach</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/gnumach-install.html">Installation</A><BR> -<A HREF="/software/hurd/gnumach-download.html">Source Code</A><BR> - <BR> -<A HREF="/software/hurd/mig.html"><STRONG>GNU MIG</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/mig-download.html">Source Code</A><BR> - <BR> -<A HREF="/software/hurd/related-projects.html"><STRONG>Related Projects</STRONG></A> -</TD> - -<TD ALIGN="LEFT" VALIGN="TOP"> -<HR> -<H3><A NAME="contents">Table of Contents</A></H3> -<UL> - <li><a href="#papers" name="TOCpapers">Introductory material, papers and - other informational documents</a> - <LI><A HREF="#faq" NAME="TOCfaq">Frequently asked questions</A> - <li><a href="#wiki" name="TOCwiki">Wiki</a> - <LI><A HREF="#manuals" NAME="TOCmanuals">Reference manuals</A> -</UL> -<HR> - -<h3><a href="#TOCpapers" name="papers">Introductory material, papers and other -informational documents</a></h3> -<P> -<UL> - -<LI> -<A HREF="hurd-paper.html">Towards a New Strategy of OS Design</A>, an -architectural overview by Thomas Bushnell, BSG. - -<LI> -<A HREF="hurd-talk.html">The Hurd</A>, a presentation by Marcus -Brinkmann. - -<LI> -<A HREF="/software/hurd/users-guide/using_gnuhurd.html" NAME="UsersGuide"> -GNU/Hurd User's Guide</A>, an introduction to the important -concepts and software of the GNU system, written for new -users, AKA "GNUbies." -<P> -Available Formats: -<UL> -<LI> -<A HREF="/software/hurd/users-guide/using_gnuhurd.html">HTML version</A> for -browsing online. -<LI> -<A HREF="/software/hurd/users-guide/using_gnuhurd.ps">PostScript version [477kB, 67 pages]</A> -for download. -<LI> -<A HREF="/software/hurd/users-guide/using_gnuhurd.txt">ASCII text version [154kB]</A>. -<LI> -<A HREF="/software/hurd/users-guide/using_gnuhurd.texi">Texinfo source [155kB]</A>. -</UL> - -<LI> -<A HREF="/software/hurd/hacking-guide/hhg.html">The Hurd Hacking -Guide</A>, an introduction to GNU Hurd and Mach programming by -Wolfgang Jährling. -<P> -Available Formats: -<UL> -<LI> -<A HREF="/software/hurd/hacking-guide/hhg.html">HTML version</A> for -browsing online. -<LI> -<A HREF="/software/hurd/hacking-guide/hhg.ps">PostScript version [187kB, 37 pages]</A> -for download. -<LI> -<A HREF="/software/hurd/hacking-guide/hhg.txt">ASCII text version [59kB]</A>. -<LI> -<A HREF="/software/hurd/hacking-guide/hhg.texi">Texinfo source [60kB]</A>. -</UL> - -<li> -<a href="http://hurdextras.nongnu.org/ipc_guide/">The <em>Unofficial GNU Mach -IPC beginner's guide</em></a>, an easy introduction to Inter Process -Comunication in the Mach microkernel by Manuel Pavón Valderrama. - -<li> -<a -href="http://walfield.org/pub/people/neal/papers/hurd-misc/mach-ipc-without-mig.txt"><em>Mach -IPC without MIG</em></a>, an exercise by Neal H Walfield <q>to understand Mach -IPC at one of its lowest application levels</q>. - -<ul> -<li> -<a -href="http://walfield.org/pub/people/neal/papers/hurd-misc/ipc-hello.c"><em>ipc-hello.c</em></a>: -<q>Hello world à la mach ipc</q>. - -</ul> - -<li> -<a -href=http://walfield.org/pub/people/neal/papers/hurd-misc/manual-bootstrap.txt><em>Manually -Bootstrapping a Translator</em></a>, a text by Neal H. Walfield about how to -<q>manually connect the translator to the filesystem</q>. - -<LI> -<A HREF="auth.html">The Authentication Server</A>, the transcript of a talk about the details of -the authentication mechanisms in the Hurd by Wolfgang Jährling. - -<li><a -href="http://lists.gnu.org/archive/html/l4-hurd/2002-06/msg00001.html"><em>The -Mach Paging Interface as Used by the Hurd</em></a>, a text by Neal Walfield. - -<li><a -href="http://lists.gnu.org/archive/html/bug-hurd/2007-01/msg00046.html"><em>A -Critique of the GNU Hurd Multi-server Operating System</em></a>, an -analysis of the GNU Hurd on GNU Mach system, written by Neal Walfield -and Marcus Brinkmann. - -<li><a -href="http://lists.gnu.org/archive/html/l4-hurd/2007-01/msg00007.html">Position -paper <em>Improving Usability via Access Decomposition and Policy -Refinement</em></a>: Neal Walfield and Marcus Brinkmann give an overview about -how a future, subsequent system may be architected. - -</UL> - -<H3><A HREF="#TOCfaq" NAME="faq">Frequently asked questions</A></H3> -<P> -Please check out the -<A HREF="faq.en.html">Frequently -Asked Questions about the GNU Hurd (33k characters)</A> and their -answers, which cover most issues a new user will be confronted with. -<P> -This document is available in several languages: -<UL> -<LI><A HREF="faq.en.html">English</A> -<LI><A HREF="faq.fr.html">français</A> -<LI><A HREF="faq.de.html">deutsch</A> -<LI><A HREF="faq.ja.html">Japanese</A> -<LI><A HREF="faq.es.html">español</A> -<LI><A HREF="faq.it.html">italiano</A> - -</UL> - -<h3><a href="#TOCwiki" name="wiki">Wiki</a></h3> -<p>A <a href="http://www.bddebian.com/~wiki/">wiki</a> is available for -collecting ideas and reciepes. Fell free -to <a href="http://www.bddebian.com/~wiki/HowToContributeToThisWiki">contribute</a>! - -<p>Some topics: - -<ul> - -<li><a href="http://www.bddebian.com/~wiki/hurd/ng">The future direction of -the GNU Hurd</a>. - -</ul> - - -<H3><A HREF="#TOCmanuals" NAME="manuals">Reference manuals</A></H3> - -<ul> - -<li> -<p> -The GNU Mach Reference Manual documents the architecture, the usage and -the programming of the GNU Mach microkernel. At the moment, the manual -documents the interface completely, but is not very useful as a tutorial or -introduction into the Mach architecture. -<p> -Available Formats: -<ul> -<li><a href="/software/hurd/gnumach-doc/index.html">HTML version</a> -for browsing online;</li> -<li><a href="/software/hurd/gnumach-doc/mach.ps">PostScript version</a> -[around 900KiB];</li> -<li><a href="/software/hurd/gnumach-doc/mach.ps.gz">gzipped PostScript -version</a> [around 300KiB];</li> -<li><a href="/software/hurd/gnumach-doc/mach.pdf">PDF version</a> -[around 700KiB].</li> -</ul> -<p> -If you want to work on the manual, you're advised to make a checkout of the <a -href="gnumach-download.html#cvs">source tree</a>. Be sure to get the -<samp>GNU Mach 1 branch</samp> when you intend to work on the manual. You -can then find the manual's sources in the <samp>doc/</samp> directory. Please -submit any modifications to <a -href="mailto:bug-hurd@gnu.org"><bug-hurd@gnu.org></a> (if possible in -unidiff format, as produced by <samp>diff -u</samp>). - -</li> - -<li> -<P> -The GNU Hurd Reference Manual documents the architecture, the usage -and the programming of the GNU Hurd. At the moment, the manual is -quite incomplete. -<P> -Available Formats: -<UL> -<LI> -<A HREF="/software/hurd/doc/hurd_toc.html">HTML version</A> for browsing online. -</LI> -<LI> -<A HREF="/software/hurd/doc/hurd.ps">PostScript version [1020kB, 91 pages]</A> -for download. -</LI> -</UL> -<P> -If you want to work on the manual, you're advised to make a checkout of the <a -href="download.html#cvs">source tree</a>. You can then find the manual's -sources in the <samp>doc/</samp> directory. Please submit any modifications to -<a href="mailto:bug-hurd@gnu.org"><bug-hurd@gnu.org></a> (if possible in -unidiff format, as produced by <samp>diff -u</samp>). - -</li> - -</ul> - -</TD> -</TR> -</TABLE> - -<HR> - -[ -<!-- Please keep this list alphabetical --> -<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! --> - <A HREF="/software/hurd/docs.html">English</A> -| <A HREF="/software/hurd/docs.eo.html">Esperanto</A> -| <a href="/software/hurd/docs.es.html">Spanish</a> -] - -<HR> - -<P> -Return to <A HREF="/home.html">GNU's home page</A>. -<P> - -Please send FSF & GNU inquiries & questions to - -<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. -There are also <A HREF="/home.html#ContactInfo">other ways to -contact</A> the FSF. -<P> - -Please send comments on these web pages to - -<A HREF="mailto:web-hurd@gnu.org"><EM>web-hurd@gnu.org</EM></A>, -send other questions to -<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. -<P> -Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007 -Free Software Foundation, Inc., -59 Temple Place - Suite 330, Boston, MA 02111, USA -<P> -Verbatim copying and distribution of this entire article is -permitted in any medium, provided this notice is preserved. -<P> -Updated: -<!-- timestamp start --> -$Date$ $Author$ -<!-- timestamp end --> -<HR> -</BODY> -</HTML> diff --git a/documentation.mdwn b/documentation.mdwn index 45bb5ffc..4e4b4b23 100644 --- a/documentation.mdwn +++ b/documentation.mdwn @@ -8,21 +8,13 @@ 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]]."]]"""]] -# General +Documentation for... - * [GNU Hurd Documentation](http://www.gnu.org/software/hurd/docs.html) + * [[GNU_Hurd|hurd/documentation]] + * [[Mach|microkernel/mach/documentation]] -# Introductory Material - -## External - - * [*Examining the Legendary HURD - Kernel*](http://www.informit.com/articles/printerfriendly.aspx?p=1180992), - an article by David Chisnall. - - Also covers a bit of GNU's and the Hurd's history, fundamental techniques - applied, comparisions to other systems. + * [[MIG|microkernel/mach/mig/documentation]] # [[Unix]] Programming @@ -53,8 +53,6 @@ in the *unstable* branch of the Debian archive. * [[Critique]] - Analysis * [[Hurd_Hacking_Guide]] * [[Concepts]] -* Other resources - * [Docs at gnu.org](http://www.gnu.org/software/hurd/docs.html) # Using diff --git a/hurd/authentication.mdwn b/hurd/authentication.mdwn index cbb164c8..14144d8e 100644 --- a/hurd/authentication.mdwn +++ b/hurd/authentication.mdwn @@ -10,7 +10,7 @@ is included in the section entitled UIDs on the Hurd are separate from processes. A process has [[capabilities|capability]] designating so-called UID vectors that -are implemented by an [[auth]] server. This +are implemented by an [[translator/auth]] server. This makes them easily [[virtualizable|virtualization]]. When a process wishes to gain access to a resource provided by a third diff --git a/hurd/critique.mdwn b/hurd/critique.mdwn index 9770138e..dacd7bb8 100644 --- a/hurd/critique.mdwn +++ b/hurd/critique.mdwn @@ -8,8 +8,8 @@ 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]]."]]"""]] -[[NealWalfield]] and [[MarcusBrinkmann]] wrote a paper titled [*A Critique of -the GNU Hurd Multi-Server Operating +Neal Walfield and Marcus Brinkmann wrote a paper titled [*A Critique of +the GNU Hurd Multi-server Operating System*](http://walfield.org/papers/200707-walfield-critique-of-the-GNU-Hurd.pdf). This was published in ACM SIGOPS Operating Systems Review in July 2007. This is sometimes referred to as *the critique*. diff --git a/hurd/documentation.mdwn b/hurd/documentation.mdwn index bb37a8be..a8c3a988 100644 --- a/hurd/documentation.mdwn +++ b/hurd/documentation.mdwn @@ -1,4 +1,5 @@ -[[meta copyright="Copyright © 2008 Free Software Foundation, Inc."]] +[[meta copyright="Copyright © 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 +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 @@ -8,10 +9,53 @@ 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]]."]]"""]] +# Introductory Material + * [[What_Is_the_GNU_Hurd]] * [[Advantages]] * [[FAQ]] - * <http://www.gnu.org/software/hurd/docs.html> + * [[*Towards_a_New_Strategy_of_OS_Design*|hurd-paper]], an architectural + overview by Thomas Bushnell, BSG. + + * [[*The_Hurd*|hurd-talk]], a presentation by Marcus Brinkmann. + + * [[*A_Critique_of_the_GNU_Hurd_Multi-server_Operating_System*|critique]], an + analysis of the GNU Hurd on GNU Mach system, written by Neal Walfield and + Marcus Brinkmann. + +## External + + * [*Examining the Legendary HURD + Kernel*](http://www.informit.com/articles/printerfriendly.aspx?p=1180992), + an article by David Chisnall. + + Also covers a bit of GNU's and the Hurd's history, fundamental techniques + applied, comparisions to other systems. + + +# Development + + * *[[The_GNU_Hurd_Reference_Manual|reference_manual]]*. + + * The *[[Hurd_Hacking_Guide]]*, an introduction to GNU Hurd and Mach + programming by Wolfgang Jährling. + + * [*Manually Bootstrapping a + Translator*](http://walfield.org/pub/people/neal/papers/hurd-misc/manual-bootstrap.txt), + a text by Neal Walfield about how to *manually connect the translator to + the filesystem*. + + * [[*The_Authentication_Server*|auth]], the transcript of a talk about the + details of the authentication mechanisms in the Hurd by Wolfgang Jährling. + + * [*The Mach Paging Interface as Used by the + Hurd*](http://lists.gnu.org/archive/html/l4-hurd/2002-06/msg00001.html), a + text by Neal Walfield. + + * In the + [[Position_paper_*Improving_Usability_via_Access_Decomposition_and_Policy*|ng/position_paper]] + Neal Walfield and Marcus Brinkmann give an overview about how a future, + subsequent system may be architected. diff --git a/auth.html b/hurd/documentation/auth.html index 676442ee..487fc1fe 100644 --- a/auth.html +++ b/hurd/documentation/auth.html @@ -1,48 +1,11 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" - "http://www.w3.org/TR/REC-html40/strict.dtd"> -<HTML> -<HEAD> -<TITLE>The GNU Hurd - GNU Project - Free Software Foundation (FSF)</TITLE> -<LINK REV="made" HREF="mailto:web-hurd@gnu.org"> -<META NAME="keywords" CONTENT="hurd"> -</HEAD> -<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD"> -<TABLE width="100%" border="0" cellspacing="5" cellpadding="15"> -<TR> -<TD COLSPAN="2"> -<IMG SRC="/graphics/hurd_sm_mf.jpg" ALT=" [image of the Hurd logo] "> -[ - <A HREF="/software/hurd/auth.html">English</A> -] -</TD> -</TR> -<TR> -<TD ALIGN="LEFT" VALIGN="TOP" BGCOLOR="#eeeeee"> -<A HREF="/software/hurd/whatsnew.html"><STRONG>What's New</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/changelogs.html">ChangeLogs</A><BR> - <br> -<a href="/software/hurd/docs.html">Documentation</a><br> -<P> -<A HREF="/software/hurd/hurd.html"><STRONG>GNU Hurd</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/install.html">Installation</A><BR> -<A HREF="/software/hurd/help.html">Getting Help</A><BR> -<A HREF="/software/hurd/download.html">Source Code</A><BR> -<A HREF="/software/hurd/devel.html">Development</A><BR> -<A HREF="/software/hurd/history.html">History</A><BR> - <BR> -<A HREF="/software/hurd/gnumach.html"><STRONG>GNU Mach</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/gnumach-install.html">Installation</A><BR> -<A HREF="/software/hurd/gnumach-download.html">Source Code</A><BR> - <BR> -<A HREF="/software/hurd/mig.html"><STRONG>GNU MIG</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/mig-download.html">Source Code</A><BR> -</TD> -<TD ALIGN="LEFT" VALIGN="TOP"> -<HR> +[[meta copyright="Copyright © 2002, 2008 Free Software Foundation, Inc."]] + +[[meta license="Verbatim copying and distribution of this entire article is +permitted in any medium, provided this notice is preserved."]] + +[[meta title="The Authentication Server, the transcript of a talk about the +details of the authentication mechanisms in the Hurd by Wolfgang Jährling"]] + <H3><A NAME="contents">Table of Contents</A></H3> <UL> <LI><A HREF="#intro" NAME="TOCintro">Introduction</A> @@ -203,46 +166,3 @@ At this point, I have said at least most of what can be said about the auth server and the protocol it implements, so I will finish by saying that it might be an interesting task (for you) to modify some existing software to take advantage of the features I described here. - -</TD> -</TR> -</TABLE> - -<HR> - -[ - <A HREF="/software/hurd/auth.html">English</A> -] - -<HR> - -<P> -Return to <A HREF="/home.html">GNU's home page</A>. -<P> - -Please send FSF & GNU inquiries & questions to - -<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. -There are also <A HREF="/home.html#ContactInfo">other ways to -contact</A> the FSF. -<P> - -Please send comments on these web pages to - -<A HREF="mailto:web-hurd@gnu.org"><EM>web-hurd@gnu.org</EM></A>, -send other questions to -<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. -<P> -Copyright (C) 2002 Free Software Foundation, Inc., -59 Temple Place - Suite 330, Boston, MA 02111, USA -<P> -Verbatim copying and distribution of this entire article is -permitted in any medium, provided this notice is preserved. -<P> -Updated: -<!-- timestamp start --> -$Date$ $Author$ -<!-- timestamp end --> -<HR> -</BODY> -</HTML> diff --git a/hurd-paper.html b/hurd/documentation/hurd-paper.html index bb49829c..15d2daec 100644 --- a/hurd-paper.html +++ b/hurd/documentation/hurd-paper.html @@ -1,27 +1,13 @@ -<!DOCTYPE html PUBLIC "-//IETF//DTD HTML 2.0//EN"> -<HTML> -<HEAD> -<TITLE>Towards a New Strategy of OS Design</TITLE> -<LINK REV="made" HREF="mailto:web-hurd@gnu.org"> -</HEAD> -<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD"> -<H1>Towards a New Strategy of OS Design</H1> -<A HREF="/graphics/hurd_sm_mf.jpg"><IMG SRC="/graphics/hurd_sm_mf.jpg" - ALT=" [image of a Hurd Metafont Logo] " - WIDTH="333" HEIGHT="80"> (jpeg 10k)</A> -<A HREF="/graphics/hurd_mf.jpg">(jpeg 20k)</A> -<A HREF="/philosophy/gif.html">no gifs due to patent problems</A> -<BR> -<BR> -[ -<!-- Please keep this list alphabetical --> -<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! --> - <A HREF="/software/hurd/hurd-paper.html">English</A> -| <A HREF="/software/hurd/hurd-paper.he.html">Hebrew</A> -| <A HREF="/software/hurd/hurd-paper.tr.html">Turkish</A> -] +[[meta copyright="Copyright © 1996, 1997, 1998, 2007, 2008 Free Software +Foundation, Inc."]] + +[[meta license="Verbatim copying and distribution of this entire article is +permitted in any medium, provided this notice is preserved."]] + +[[meta title="Towards a New Strategy of OS Design, an architectural overview by +Thomas Bushnell, BSG."]] + -<P> This article explains why FSF is developing a new operating system named the Hurd, which will be a foundation of the whole GNU system. The Hurd is built @@ -772,41 +758,3 @@ While the Hurd will be willing to send and receive trailers, it will gain fairly little advantage in doing so because there is no requirement that data be copied and avoiding copies for page-aligned data is irrelevant. - -<HR> - -[ -<!-- Please keep this list alphabetical --> -<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! --> - <A HREF="/software/hurd/hurd-paper.html">English</A> -| <A HREF="/software/hurd/hurd-paper.he.html">Hebrew</A> -| <A HREF="/software/hurd/hurd-paper.tr.html">Turkish</A> -] - -<HR> - -Return to <A HREF="/home.html">GNU's home page</A>. -<P> -FSF & GNU inquiries & questions to -<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. -Other <A HREF="/home.html#ContactInfo">ways to contact</A> the FSF. -<P> -Comments on these web pages to -<A HREF="mailto:web-hurd@gnu.org"><EM>web-hurd@gnu.org</EM></A>, -send other questions to -<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. -<P> -Copyright (C) 1996 Trent Fisher -<BR> -Copyright (C) 1996, 1997, 1998, 2007 Free Software Foundation, Inc., -51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. -<P> -Verbatim copying and distribution of this entire article is -permitted in any medium, provided this notice is preserved.<P> -Updated: -<!-- hhmts start --> -19 Dec 1998 jonas -<!-- hhmts end --> -<HR> -</BODY> -</HTML> diff --git a/hurd-talk.html b/hurd/documentation/hurd-talk.html index 630bbc7d..d608e12a 100644 --- a/hurd-talk.html +++ b/hurd/documentation/hurd-talk.html @@ -1,52 +1,11 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" - "http://www.w3.org/TR/REC-html40/strict.dtd"> -<HTML> -<HEAD> -<TITLE>The GNU Hurd - GNU Project - Free Software Foundation (FSF)</TITLE> -<LINK REV="made" HREF="mailto:web-hurd@gnu.org"> -<META NAME="keywords" CONTENT="hurd"> -</HEAD> -<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD"> -<TABLE width="100%" border="0" cellspacing="5" cellpadding="15"> -<TR> -<TD COLSPAN="2"> -<IMG SRC="/graphics/hurd_sm_mf.jpg" ALT=" [image of the Hurd logo] "> -[ -<!-- Please keep this list alphabetical --> -<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! --> - <A HREF="/software/hurd/hurd-talk.html">English</A> -] -</TD> -</TR> -<TR> -<TD ALIGN="LEFT" VALIGN="TOP" BGCOLOR="#eeeeee"> -<A HREF="/software/hurd/whatsnew.html"><STRONG>What's New</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/changelogs.html">ChangeLogs</A><BR> - <br> -<a href="/software/hurd/docs.html">Documentation</a><br> -<P> -<A HREF="/software/hurd/hurd.html"><STRONG>GNU Hurd</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/install.html">Installation</A><BR> -<A HREF="/software/hurd/help.html">Getting Help</A><BR> -<A HREF="/software/hurd/download.html">Source Code</A><BR> -<A HREF="/software/hurd/devel.html">Development</A><BR> -<A HREF="/software/hurd/history.html">History</A><BR> - <BR> -<A HREF="/software/hurd/gnumach.html"><STRONG>GNU Mach</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/gnumach-install.html">Installation</A><BR> -<A HREF="/software/hurd/gnumach-download.html">Source Code</A><BR> - <BR> -<A HREF="/software/hurd/mig.html"><STRONG>GNU MIG</STRONG></A><BR> - <BR> -<A HREF="/software/hurd/mig-download.html">Source Code</A><BR> - <BR> -<A HREF="/software/hurd/related-projects.html"><STRONG>Related Projects</STRONG></A> -</TD> -<TD ALIGN="LEFT" VALIGN="TOP"> -<HR> +[[meta copyright="Copyright © 2001 Marcus Brinkmann"]] + +[[meta license="Verbatim copying and distribution of this entire article is +permitted in any medium, provided this notice is preserved."]] + +[[meta title="The Hurd, a presentation by Marcus Brinkmann"]] + + <H4><A NAME="contents">Table of Contents</A></H4> <UL> <LI><A HREF="#int" NAME="TOCint">Introduction</A> @@ -85,7 +44,7 @@ This talk about the Hurd was written by Marcus Brinkmann for <UL> <LI>OSDEM, Brussels, 4. Feb 2001, -<LI>Frühjahrsfachgespräche, Cologne, 2. Mar 2001 and +<LI>Frühjahrsfachgespräche, Cologne, 2. Mar 2001 and <LI>Libre Software Meeting, Bordeaux, 4. Jul 2001. </UL> @@ -352,8 +311,7 @@ servers, too! </TD></TR></TABLE> <P> To quote Thomas Bushnell, BSG, from his paper -<A HREF="/software/hurd/hurd-paper.html">``A new strategy towards OS -design'' (1996)</A>: +[[``Towards_a_New_Strategy_of_OS_design''_(1996)|hurd-paper]]: <BLOCKQUOTE> The GNU Hurd, by contrast, is designed to make the area of system code as limited as possible. Programs are required to communicate only @@ -1101,51 +1059,3 @@ Join us at </TD></TR></TABLE> <P> List of contacts. - -<P> -<EM>Some of these links are at other web sites not maintained by the -FSF. The FSF is not responsible for the content of these other web sites.</EM> - -</TD> -</TR> -</TABLE> - -<HR> - -[ -<!-- Please keep this list alphabetical --> -<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! --> - <A HREF="/software/hurd/hurd-talk.html">English</A> -] - -<HR> - -<P> -Return to <A HREF="/home.html">GNU's home page</A>. -<P> - -Please send FSF & GNU inquiries & questions to - -<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. -There are also <A HREF="/home.html#ContactInfo">other ways to -contact</A> the FSF. -<P> - -Please send comments on these web pages to - -<A HREF="mailto:web-hurd@gnu.org"><EM>web-hurd@gnu.org</EM></A>, -send other questions to -<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. -<P> -Copyright (C) 2001 Marcus Brinkmann <A HREF="mailto:marcus@gnu.org"><marcus@gnu.org></A> -<P> -Verbatim copying and distribution of this entire article is -permitted in any medium, provided this notice is preserved. -<P> -Updated: -<!-- timestamp start --> -$Date$ $Author$ -<!-- timestamp end --> -<HR> -</BODY> -</HTML> diff --git a/hurd/hurd_hacking_guide.mdwn b/hurd/hurd_hacking_guide.mdwn index 0cb96f32..2ef08f8a 100644 --- a/hurd/hurd_hacking_guide.mdwn +++ b/hurd/hurd_hacking_guide.mdwn @@ -8,6 +8,16 @@ 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]]."]]"""]] -Originally written by Wolfgang Jährling, the [Hurd Hacking Guide](http://www.gnu.org/software/hurd/hacking-guide/hhg.html) -contains an overview of some of the Hurd's features. -Also contains a tutorial on writing your own [[translator]]. +Originally written by Wolfgang Jährling, the *Hurd Hacking Guide* contains an +introduction to GNU Hurd and GNU Mach programming, an overview of some of the +Hurd's features. It also contains a tutorial on writing your own +[[translator]]. + + * [HTML version](http://www.gnu.org/software/hurd/hacking-guide/hhg.html) for + browsing online, + * [PostScript version](http://www.gnu.org/software/hurd/hacking-guide/hhg.ps) + [187kB, 37 pages], + * [ASCII text + version](http://www.gnu.org/software/hurd/hacking-guide/hhg.txt) [59kB], + * [Texinfo source](http://www.gnu.org/software/hurd/hacking-guide/hhg.texi) + [60kB]. diff --git a/hurd/ng/position_paper.mdwn b/hurd/ng/position_paper.mdwn index 3240a41d..e0f4bf60 100644 --- a/hurd/ng/position_paper.mdwn +++ b/hurd/ng/position_paper.mdwn @@ -8,7 +8,8 @@ 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]]."]]"""]] -[[NealWalfield]] and [[MarcusBrinkmann]] wrote a paper titled [*Improving -Usability via Access Decomposition and Policy -Refinement*](http://walfield.org/papers/20070104-walfield-access-decomposition-policy-refinement.pdf). -This is sometimes referred to as *the position paper*. +Neal Walfield and Marcus Brinkmann wrote a paper titled [*Improving Usability +via Access Decomposition and Policy +Refinement*](http://walfield.org/papers/20070104-walfield-access-decomposition-policy-refinement.pdf) +where they give an overview about how a future, subsequent system may be +architected. This is sometimes referred to as *the position paper*. diff --git a/hurd/reference_manual.mdwn b/hurd/reference_manual.mdwn new file mode 100644 index 00000000..5b5bff2d --- /dev/null +++ b/hurd/reference_manual.mdwn @@ -0,0 +1,18 @@ +[[meta copyright="Copyright © 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 +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]]."]]"""]] + +*The GNU Hurd Reference Manual* documents the architecture, the usage and the +programming of the GNU Hurd. At the moment, the manual is quite incomplete. + + * [HTML version](http://www.gnu.org/software/hurd/doc/hurd_toc.html) for + browsing online, + * [PostScript version](http://www.gnu.org/software/hurd/doc/hurd.ps) + [1020KiB, 91 pages]. diff --git a/hurd/running/distrib.mdwn b/hurd/running/distrib.mdwn index fc42e862..b0a6badd 100644 --- a/hurd/running/distrib.mdwn +++ b/hurd/running/distrib.mdwn @@ -94,7 +94,7 @@ about getting applications to work (if possible). * GNU [Coding Standards](http://www.gnu.org/prep/standards.html) * [[TestSuites]] - Posix, Perl, results feedback, etc. -* [docs and papers](http://www.gnu.org/software/hurd/docs.html) +* [[Documentation]] * [[SystemAPILimits]] * [[CodeAnnouncements]] - Recent coding projects related to the Hurd diff --git a/hurd/running/gnu/universal_package_manager.mdwn b/hurd/running/gnu/universal_package_manager.mdwn index 009b26bf..440f1122 100644 --- a/hurd/running/gnu/universal_package_manager.mdwn +++ b/hurd/running/gnu/universal_package_manager.mdwn @@ -127,7 +127,7 @@ OK. I will give you steps. i. Install a GNU System by folowing [[these_instructions|setup]] -ii. Read about GNU Design <http://www.gnu.org/software/hurd/hurd-paper.html> +ii. Read about GNU Design: [[Towards_a_New_Strategy_of_OS_Design|documentation/hurd-paper]] iii. Read about translators <http://www.debian.org/ports/hurd/hurd-doc-translator> diff --git a/hurd/translator.mdwn b/hurd/translator.mdwn index b9952931..889f02a6 100644 --- a/hurd/translator.mdwn +++ b/hurd/translator.mdwn @@ -43,6 +43,7 @@ See some [[examples]] about how to use translators. # Existing Translators +* [[auth]] * [[pfinet]] * [[pflocal]] * [[hostmux]] diff --git a/hurd/translator/auth.mdwn b/hurd/translator/auth.mdwn new file mode 100644 index 00000000..73e7e025 --- /dev/null +++ b/hurd/translator/auth.mdwn @@ -0,0 +1,13 @@ +[[meta copyright="Copyright © 2008 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]]."]]"""]] + +[[*The_Authentication_Server*|documentation/auth]], the transcript of a talk +about the details of the authentication mechanisms in the Hurd by Wolfgang +Jährling. diff --git a/microkernel/faq/multiserver_microkernel.mdwn b/microkernel/faq/multiserver_microkernel.mdwn index da690425..68ed332c 100644 --- a/microkernel/faq/multiserver_microkernel.mdwn +++ b/microkernel/faq/multiserver_microkernel.mdwn @@ -22,5 +22,5 @@ use, but now, because the server runs in user space as the user that started it, they may, for instance, mount an FTP filesystem in their home directory. For more information about the design of the Hurd, read the paper by Thomas -Bushnell, BSG: [Towards a new strategy on OS -design](http://www.gnu.org/software/hurd/hurd-paper.html). +Bushnell, BSG: +[[Towards_a_New_Strategy_of_OS_Design|hurd/documentation/hurd-paper]]. diff --git a/microkernel/mach/documentation.mdwn b/microkernel/mach/documentation.mdwn index fe870386..f6f2eb79 100644 --- a/microkernel/mach/documentation.mdwn +++ b/microkernel/mach/documentation.mdwn @@ -1,4 +1,5 @@ -[[meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] +[[meta copyright="Copyright © 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 +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 @@ -11,12 +12,27 @@ is included in the section entitled - [Meet Mach](http://www.stepwise.com/Articles/Technical/MeetMach.html), a summary of Mach's history and main concepts. + * *[[The_GNU_Mach_Reference_Manual|gnu_mach/reference_manual]]*. + - OSF's [Kernel Interface (ps)](ftp://ftp.cs.cmu.edu/afs/cs/project/mach/public/doc/osf/kernel_interface.ps) [Kernel Interface (pdf)](http://shakthimaan.com/downloads/hurd/kernel_interface.pdf) - OSF's [Kernel Principles (ps)](ftp://ftp.cs.cmu.edu/afs/cs/project/mach/public/doc/osf/kernel_principles.ps) [Kernel Principles (pdf)](http://shakthimaan.com/downloads/hurd/kernel_principles.pdf) + * [*The Unofficial GNU Mach IPC beginner's + guide*](http://hurdextras.nongnu.org/ipc_guide/), an easy introduction to + Inter Process Comunication in the Mach microkernel by Manuel Pavón + Valderrama. + + * [*Mach IPC without + MIG*](http://walfield.org/pub/people/neal/papers/hurd-misc/mach-ipc-without-mig.txt), + an exercise by Neal Walfield *to understand Mach IPC at one of its lowest + application levels*. + + * [*ipc-hello.c*](http://walfield.org/pub/people/neal/papers/hurd-misc/ipc-hello.c): + *Hello world à la mach ipc*. + - [Porting and Modifying the Mach 3.0 Microkernel](http://shakthimaan.com/downloads/hurd/Porting%20and%20Modifying%20the%20Mach%203.0%20Microkernel.pdf) - [An IO System for Mach](http://shakthimaan.com/downloads/hurd/An%20IO%20System%20for%20Mach.pdf) diff --git a/microkernel/mach/gnu_mach.mdwn b/microkernel/mach/gnu_mach.mdwn index cdb43a6f..19e1ea53 100644 --- a/microkernel/mach/gnu_mach.mdwn +++ b/microkernel/mach/gnu_mach.mdwn @@ -71,6 +71,7 @@ GNU/Hurd. # Development + * [[Reference_Manual]] * [[Building]] * [[Debugging]] * [[Boot_Trace]] diff --git a/microkernel/mach/gnu_mach/reference_manual.mdwn b/microkernel/mach/gnu_mach/reference_manual.mdwn new file mode 100644 index 00000000..225ab176 --- /dev/null +++ b/microkernel/mach/gnu_mach/reference_manual.mdwn @@ -0,0 +1,26 @@ +[[meta copyright="Copyright © 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 +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]]."]]"""]] + +*The GNU Mach Reference Manual* documents the architecture, the usage and the +programming of the GNU Mach microkernel. At the moment, the manual documents +the interface completely, but is not very useful as a tutorial or introduction +into the Mach architecture. + + * [HTML version](http://www.gnu.org/software/hurd/gnumach-doc/index.html) + for browsing online, + * [PostScript + version](http://www.gnu.org/software/hurd/gnumach-doc/mach.ps) [around + 900KiB], + * [gzipped PostScript + version](http://www.gnu.org/software/hurd/gnumach-doc/mach.ps.gz) + [around 300KiB], + * [PDF version](http://www.gnu.org/software/hurd/gnumach-doc/mach.pdf) + [around 700KiB]. diff --git a/microkernel/mach/mig/documentation.mdwn b/microkernel/mach/mig/documentation.mdwn index 8c977e55..a0bbbe14 100644 --- a/microkernel/mach/mig/documentation.mdwn +++ b/microkernel/mach/mig/documentation.mdwn @@ -66,8 +66,7 @@ pp. 67--77." # Further Relevant Documentation - * The [GNU Mach Reference - Manual](http://www.gnu.org/software/hurd/docs.html#manuals), espacially + * The [[GNU_Mach_Reference_Manual|gnu_mach/reference_manual]], espacially [Chapter 4, Inter Process Communication](http://www.gnu.org/software/hurd/gnumach-doc/Inter-Process-Communication.html), which, for example, explains how the <a name="dealloc">`dealloc` flag</a> |