This week, I've tried to split up my commits into individual patches.
Patch 1) I changed the command to start the hurd "kvm" -> "qemu-system-i386"
Patch 2) I removed the mention of the ufs partition type in the old
Hurd FAQ. I will eventually attempt to merge all the FAQs
into one.
Patch 3) A few minor changes on the main documentation page. I added a
reference to an online open source textbook. I mentioned that
one can download the bug-hurd archives.
P.S. I have also changed my email address. :)
>From 83d5128ee68a9762f435cd27f9a7b67e1fda0c45 Mon Sep 17 00:00:00 2001
From: Joshua Branson <jbra...@fastmail.com>
Date: Sat, 15 Dec 2018 10:46:39 -0500
Subject: [PATCH] I changed the command to run the hurd. "kvm" ->
"qemu-system-i386"
---
hurd/running/debian/qemu_image.mdwn | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/hurd/running/debian/qemu_image.mdwn b/hurd/running/debian/qemu_image.mdwn
index c25b76ab..b093e8e8 100644
--- a/hurd/running/debian/qemu_image.mdwn
+++ b/hurd/running/debian/qemu_image.mdwn
@@ -20,7 +20,7 @@ Usage:
* Unpack it.
$ `tar -xz < debian-hurd.img.tar.gz`
* Run it
- $ `kvm -m 1G -drive cache=writeback,file=$(echo debian-hurd-*.img) -net user,hostfwd=tcp:127.0.0.1:2222-:22`
+ $ `qemu-system-i386 -m 1G -drive cache=writeback,file=$(echo debian-hurd-*.img) -net user,hostfwd=tcp:127.0.0.1:2222-:22`
# Optionally use --curses to keep your keyboard layout. If need be modprobe kvm_amd, kvm intel and kvm to get kvm support (which is much, much faster).
* Login as root (the root password is empty)
* set up a root password with passwd
--
2.19.2
>From 49d128d0b0d85870014d84c2d5aa163de37b0272 Mon Sep 17 00:00:00 2001
From: Joshua Branson <jbra...@fastmail.com>
Date: Sat, 15 Dec 2018 10:45:59 -0500
Subject: [PATCH] On the Old Hurd FAQ, I removed the line "Alternatively," you
may use a BSD style ufs. ext2 seems to be the best tested partition type.
---
faq/old_faq.txt | 7 +++----
1 file changed, 3 insertions(+), 4 deletions(-)
diff --git a/faq/old_faq.txt b/faq/old_faq.txt
index 7946062e..5df82276 100644
--- a/faq/old_faq.txt
+++ b/faq/old_faq.txt
@@ -42,10 +42,9 @@ license is included in the file COPYRIGHT.
?? What partition type should I use for my GNU/Hurd partitions?
-{MB} You should use an ext2 filesystem. Alternatively, you may use BSD
-style ufs. The partition type number for ext2fs is 0x83 (this is the
-same as in Linux), not 0x63 (GNU HURD). Thomas explains why 0x63 is the
-wrong choice:
+{MB} You should use an ext2 filesystem. The partition type number
+for ext2fs is 0x83 (this is the same as in Linux), not 0x63 (GNU HURD).
+Thomas explains why 0x63 is the wrong choice:
One day we may have a new filesystem format, which would
probably be called the GNU Hurd filesystem format, and might
--
2.19.2
>From b9a6d8a3ac06759606d52111f784e892c743828e Mon Sep 17 00:00:00 2001
From: Joshua Branson <jbra...@fastmail.com>
Date: Sat, 15 Dec 2018 10:47:56 -0500
Subject: [PATCH] On the main documentation page: I mentioned how to convert
mbox to maildir, and mentioned OS Dev wiki, and added a link to an online OS
book in the main documentation page. I also broke some formatting things on
the main documentation page, but I believe I fixed them as well.
---
documentation.mdwn | 52 +++++++++++++++++++++++++++++++---------------
1 file changed, 35 insertions(+), 17 deletions(-)
diff --git a/documentation.mdwn b/documentation.mdwn
index 9300622c..120b6f18 100644
--- a/documentation.mdwn
+++ b/documentation.mdwn
@@ -16,40 +16,40 @@ or specific components of it? Here is a collection of texts to read.
[[!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
-You can find good free, self-paced online courses about operating systems on <https://www.udacity.com/> .
-A free textbook about operating systems is called [Operating Systems: Three Easy Pieces](http://pages.cs.wisc.edu/~remzi/OSTEP/).
+You can find good free, self-paced online courses about operating systems on [[https://www.udacity.com/]] .
+A good operating systems wiki is [[OS Dev|https://wiki.osdev.org/Main_Page]], and it has a page recommending
+OS related books: [[https://wiki.osdev.org/Books]].
+
+A free textbook about operating systems is called [[Operating Systems: Three Easy Pieces|http://pages.cs.wisc.edu/~remzi/OSTEP/]].
+Another free operating systems concepts textbook is available at [[http://os-book.com/]].
+
## 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
+ * Our use of [[capabilities|capability]]. The [[Wikipedia, capability-based
+ security|https://en.wikipedia.org/wiki/Capability%2Dbased%5Fsecurity]]
+ 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.
+ * [[Wikipedia, object-capability
+ model|https://en.wikipedia.org/wiki/Object%2Dcapability%5Fmodel]].
+ 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
@@ -140,7 +140,25 @@ from userlandish interfaces (Hurd) or from the micro kernel itself (Mach).
# 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.
+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/`
+
+# Search the email list
+
+Many technical topics have also been discussed in the
+[[bug-hurd@gnu.org|https://lists.gnu.org/mailman/listinfo/bug-hurd]] email list. You can search this email list
+[[here|http://lists.gnu.org/archive/html/bug-hurd/]] and download the list in the mbox format
+[[here|http://lists.gnu.org/archive/html/bug-hurd/]].
+
+`wget -r -A '20*' ftp://lists.gnu.org/bug-hurd/`
+
+If you prefer to read archived email in the maildir format, then you could use
+the perl mbox to maildir converter, which is aptly named mb2md.
+
+
+* Note, if you already have the Hurd installed, then you could instead read the emails
+using the mboxfs ontop of the httpfs translator! These translators are
+available in the [[hurd extras repo|http://www.nongnu.org/hurdextras/#mboxfs]].
--
2.19.2
