summaryrefslogtreecommitdiff
path: root/docs.html
blob: 9c3a43f15d4b4b98b1b609e1329aeae48183101a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
<!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&nbsp;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>
&nbsp;<BR>
<A HREF="/software/hurd/changelogs.html">ChangeLogs</A><BR>
&nbsp;<br>
<a href="/software/hurd/docs.html">Documentation</a><br>
<P>
<A HREF="/software/hurd/hurd.html"><STRONG>GNU&nbsp;Hurd</STRONG></A><BR>
&nbsp;<BR>
<A HREF="/software/hurd/install.html">Installation</A><BR>
<A HREF="/software/hurd/help.html">Getting&nbsp;Help</A><BR>
<A HREF="/software/hurd/download.html">Source&nbsp;Code</A><BR>
<A HREF="/software/hurd/devel.html">Development</A><BR>
<A HREF="/software/hurd/history.html">History</A><BR>
&nbsp;<BR>
<A HREF="/software/hurd/gnumach.html"><STRONG>GNU&nbsp;Mach</STRONG></A><BR>
&nbsp;<BR>
<A HREF="/software/hurd/gnumach-install.html">Installation</A><BR>
<A HREF="/software/hurd/gnumach-download.html">Source&nbsp;Code</A><BR>
&nbsp;<BR>
<A HREF="/software/hurd/mig.html"><STRONG>GNU&nbsp;MIG</STRONG></A><BR>
&nbsp;<BR>
<A HREF="/software/hurd/mig-download.html">Source&nbsp;Code</A><BR>
&nbsp;<BR>
<A HREF="/software/hurd/related-projects.html"><STRONG>Related&nbsp;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&nbsp;Hurd and Mach programming by
Wolfgang J&auml;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&auml;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&nbsp;Hurd Multi-server Operating System</em></a>, an
analysis of the GNU&nbsp;Hurd on GNU&nbsp;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&nbsp;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&ccedil;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&ntilde;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&nbsp;Mach Reference Manual documents the architecture, the usage and
the programming of the GNU&nbsp;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&nbsp;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">&lt;bug-hurd@gnu.org&gt;</a> (if possible in
unidiff format, as produced by <samp>diff -u</samp>).

</li>

<li>
<P>
The GNU&nbsp;Hurd Reference Manual documents the architecture, the usage
and the programming of the GNU&nbsp;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">&lt;bug-hurd@gnu.org&gt;</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 &amp; GNU inquiries &amp; 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>