summaryrefslogtreecommitdiff
path: root/hurd
diff options
context:
space:
mode:
Diffstat (limited to 'hurd')
-rw-r--r--hurd/documentation/translator_primer.mdwn21
-rw-r--r--hurd/fsysopts.mdwn2
-rw-r--r--hurd/running/debian.mdwn56
-rw-r--r--hurd/running/debian/qemu_image.mdwn51
-rw-r--r--hurd/running/distrib.mdwn34
-rw-r--r--hurd/running/gnu.mdwn4
-rw-r--r--hurd/what_is_the_gnu_hurd.mdwn3
7 files changed, 90 insertions, 81 deletions
diff --git a/hurd/documentation/translator_primer.mdwn b/hurd/documentation/translator_primer.mdwn
index bbfb3649..35eab2fb 100644
--- a/hurd/documentation/translator_primer.mdwn
+++ b/hurd/documentation/translator_primer.mdwn
@@ -28,13 +28,11 @@ to enable you to easily try three of them:
To try out the simplest of translators, you can go the following simple steps:
$ touch hello
- $ cat hello
+ $ cat hello
$ settrans hello /hurd/hello
$ cat hello
"Hello World!"
- $ settrans -g hello
- $ cat hello
- $
+
$ fsysopts hello
/hurd/hello --contents='Hello World!
'
@@ -42,22 +40,23 @@ To try out the simplest of translators, you can go the following simple steps:
> '
$ cat hello
Hello GNU!
- $
-
-What you do with these steps is first verifying that the file "hello" is empty.
+
+ $ settrans -g hello
+ $ cat hello
+What you do with these steps is first creating the file "hello" and verifying that it is empty.
-Then you setup the translator /hurd/hello in the file/node hello.
+Then you setup the translator `/hurd/hello` in the file/node `hello`.
-After that you check the contents of the file, and the translator returns "Hello World!".
+After that, you check the contents of the file, and the translator returns "Hello World!".
Because you are a curious hacker, you wonder what filesystem options this node has. It turns
out that the hello translator uses a "contents" option. We can change what the hello
-translator returns with another call to fsysopts.
+translator returns with another call to [[fsysopts]].
To finish it,
you remove the translator from the file "hello"
(and tell any active running instances to go away)
-via "settrans -g hello".
+via "`settrans --g hello`", which is shorthand for "`settrans --goaway hello`"
Having done that, verify that now the file is empty again.
### Transparent FTP
diff --git a/hurd/fsysopts.mdwn b/hurd/fsysopts.mdwn
index ff30f31d..bafe2bc9 100644
--- a/hurd/fsysopts.mdwn
+++ b/hurd/fsysopts.mdwn
@@ -8,7 +8,7 @@ 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]]."]]"""]]
-Get or set command line options for a running [[translator]].
+fsysopts, or <strong>F</strong>ile<strong>SYS</strong>tem<strong>OPT</strong>ions, Gets or sets command line options for a running [[translator]].
See [[documentation/translators#manage]].
diff --git a/hurd/running/debian.mdwn b/hurd/running/debian.mdwn
index c52fbf75..b758fd52 100644
--- a/hurd/running/debian.mdwn
+++ b/hurd/running/debian.mdwn
@@ -1,8 +1,11 @@
[[!meta title="Debian GNU/Hurd"]]
-# Debian Resources
-- Official page about the Debian GNU/Hurd port: [Debian GNU/Hurd](http://www.debian.org/ports/hurd/)
-- Debian [[FAQ]] — Frequently Asked Questions
+Debian GNU/Hurd is an effort to port the Debian distribution to the Hurd. Around 75% of Debian packages can already be run under Debian GNU/Hurd, which makes it very usable. See the [[Status]] of the Debian port for more information.
+
+<!-- I don't know what it means that /etc/mtab -> /proc/mounts, but this is what I could interpret.
+ It was simply a line (h1, for some reason, on this page and it looked out of place. Correct or even delete this if it makes no sense -->
+
+One noteable difference in this port, is that `/etc/mtab` -> `/proc/mounts`
## QEMU Image
[[!inline pages=hurd/running/debian/qemu_image raw=yes feeds=no]]
@@ -17,23 +20,11 @@
* [[Patch_submission]] — How to submit patches for build failures
- [[Creating_image_tarball]]
-# Additional Information
-- [Presentation](http://people.debian.org/~mbanck/talks/hurd_lt2004/html/)
- *Debian GNU/Hurd*, [[MichaelBanck]], LinuxTag 2004 Karlsruhe
-- [[Status]]
-- [Archive Qualification](http://wiki.debian.org/ArchiveQualification/hurd-i386)
-
-
-# `/etc/mtab` -> `/proc/mounts`
-
## IRC, freenode, #hurd, 2014-02-12
<braunr> hm, there is something weird
- <braunr> after successfully installing (with the new installer cd), and
- rebooting, system init fails because fsck can't be run on /home (a
- separate partition)
- <braunr> it can't fsck because at that point, /home is already mounted, and
- indeed the translator is running
+ <braunr> after successfully installing (with the new installer cd), and rebooting, system init fails because fsck can't be run on /home (a separate partition)
+ <braunr> it can't fsck because at that point, /home is already mounted, and indeed the translator is running
<braunr> teythoon: any idea what might cause that ?
<teythoon> me ?
<teythoon> no
@@ -52,30 +43,24 @@
<teythoon> i believe they dropped that
<youpi> err, but something must be creating it for newer systems
<teythoon> good point
- <braunr> well, except for these small details, everything went pretty
- smooth
+ <braunr> well, except for these small details, everything went pretty smooth
<braunr> both on ide and ahci
<youpi> it seems /etc/mtab gets created at boot
<youpi> (on Linux I mean)
- <teythoon> youpi: i cannot find the init script, but i'm sure that it was
- there
+ <teythoon> youpi: i cannot find the init script, but i'm sure that it was there
<youpi> I can't find it either on the installed system...
<azeem> maybe pere or rleigh in #debian-hurd can help
## IRC, freenode, #hurd, 2014-02-13
- <braunr> 6<--60(pid1698)->dir_lookup ("var/run/mtab" 4194305 0) = 0 3
- "/run/mtab" (null)
+ <braunr> 6<--60(pid1698)->dir_lookup ("var/run/mtab" 4194305 0) = 0 3 "/run/mtab" (null)
<braunr> looks like /etc/mtab isn't actually used anymore
<teythoon> it never was on hurd
<tomodach1> braunr: well it is generated i believe from mounted filesystems
- <tomodach1> if its still around there is a reason for it, like posix
- compatiblity perhaps?
- <braunr> well the problem is that, as mentioned in pere's thread on
- bug-hurd, some tools now expect /var/run/mtab instead of /etc/mtab
- <braunr> and since nothing currently creates this file, these tools, such
- as df, are lost
+ <tomodach1> if its still around there is a reason for it, like posix compatiblity perhaps?
+ <braunr> well the problem is that, as mentioned in pere's thread on bug-hurd, some tools now expect /var/run/mtab instead of /etc/mtab
+ <braunr> and since nothing currently creates this file, these tools, such as df, are lost
<braunr> they can't find the info they're looking for
@@ -87,11 +72,14 @@
<pere> yes. I recommended fixing it in the hurd package. (BTS #737759)
<braunr> yes i saw but was there any action taken ?
<pere> did not check
- <teythoon> i thought youpi mentioned that it is fixed in the libc and we
- just need to rebuild coreutils or something
+ <teythoon> i thought youpi mentioned that it is fixed in the libc and we just need to rebuild coreutils or something
<pere> yes
<braunr> oh ok
<braunr> but doesn't that mean it will use /etc/mtab ?
- <pere> if I was a hurd porter, I would fix it in hurd while waiting for a
- fix in coreutils, just to save people for wondering about the breakage,
- but I am not the most patient of developers. :)
+ <pere> if I was a hurd porter, I would fix it in hurd while waiting for a fix in coreutils, just to save people for wondering about the breakage, but I am not the most patient of developers. :)
+
+# Externel
+* Official page about the Debian GNU/Hurd port: [Debian GNU/Hurd](http://www.debian.org/ports/hurd/)
+* Debian [[FAQ]] — Frequently Asked Questions
+* [Presentation](http://people.debian.org/~mbanck/talks/hurd_lt2004/html/) -Debian GNU/Hurd*, [[MichaelBanck]], LinuxTag 2004 Karlsruhe
+* [Archive Qualification](http://wiki.debian.org/ArchiveQualification/hurd-i386)
diff --git a/hurd/running/debian/qemu_image.mdwn b/hurd/running/debian/qemu_image.mdwn
index c25b76ab..fe1b7444 100644
--- a/hurd/running/debian/qemu_image.mdwn
+++ b/hurd/running/debian/qemu_image.mdwn
@@ -14,23 +14,50 @@ as <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.ta
Usage:
-* Install qemu-kvm via your distros packages.
-* Download the debian image
- $ `wget https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.tar.gz`
-* 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`
- # 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).
+* Install qemu-kvm via your distribution's package manager (it might just be named qemu)
+
+* Download the debian image:
+
+<!-- Codeblocks nested in lists are garbage in Markdown. The only clean way to do this is by adding a comment after every list entry. Sorry about this!-->
+
+ $ wget https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.tar.gz
+
+* Unpack it:
+
+<!-- Yes, another comment. I can leave these empty but then again I can fill them. -->
+
+ $ tar -xz < debian-hurd.img.tar.gz
+
+* Run it:
+
+<!-- A world in which nobody washes their dishes is a dishtopia -->
+
+ $ kvm -m 1G -drive cache=writeback,file=$(echo debian-hurd-*.img) -net user,hostfwd=tcp:127.0.0.1:2222-:22
+
* Login as root (the root password is empty)
-* set up a root password with passwd
+
+* Set up a root password with passwd
+
+Optionally you may 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).
+
+Note that if you do not have a command named `kvm`, you can try something across the lines of:
+
+ $ qemu-system-i386 --enable-kvm -drive cche=writeback,file=$(echo debian-hurd-*.img) -net user,hostfwd=tcp:127.0.0.1:2222-:22
+
+Or, if your machine does not allow for KVM acceleration, omit `--enable-kvm` from the command.
+
+
Please also read the README file: <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/README>
+<!-- It is unconventional, in wikis, to write external links like [...](http://...).
+ Usually a link to an external site should always be fully visible, but I think
+ people can understand where these lead, but revert if this is a bad idea.-->
+
If you have troubles extracting the image, you can use
-the gz version <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.gz>,
-the zip version <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.zip>,
-or even the plain version <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img> (5GiB!)
+the [gz version](https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.gz),
+the [zip version](https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.zip),
+or even the [plain version](https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img) (5GiB!)
See the discussion about [[hurd/running/qemu/writeback_caching]].
diff --git a/hurd/running/distrib.mdwn b/hurd/running/distrib.mdwn
index 8c411fd0..357d840a 100644
--- a/hurd/running/distrib.mdwn
+++ b/hurd/running/distrib.mdwn
@@ -9,45 +9,41 @@ distributions in regard to ethical criteria. Please visit
<http://www.gnu.org/distros/free-system-distribution-guidelines.html> to learn
what those standards are."""]]
-Working distributions of GNU/Hurd:
+There are several GNU distributions that are built on the Hurd. If you develop a Hurd-based distro or know of one that isn't on this list yet, feel free to add it!
+
+###Working distributions of GNU/Hurd:
* [[Debian]]
-GNU/Hurd distributions in early stages of development:
+###GNU/Hurd distributions in early stages of development:
* [[Arch|arch_hurd]] (features a LiveCD)
* [[Nix]]
-Defunct GNU/Hurd distributions:
+###Defunct GNU/Hurd distributions:
* Bee GNU/Hurd. Castellano distribution, pkgsrc package based.
- * [[GNU]]
* Unofficial port to Gentoo and the portage system. It was
[announced](http://forums.gentoo.org/viewtopic.php?t=41939&amp;postdays=0&amp;postorder=asc&amp;start=0)
March 17, 2003 in the Gentoo forums, but development stopped at some point.
- IRC, freenode, #hurd, 2013-01-15:
+####IRC, freenode, #hurd, 2013-01-15:
<WhiteKIBA> we are trying to revive Gentoo/hurd
<WhiteKIBA> we are using debian as a start
- <WhiteKIBA> we installed portage on debian and are now bootstrapping
- the system into a folder
+ <WhiteKIBA> we installed portage on debian and are now bootstrapping the system into a folder
<WhiteKIBA> except glibc everything seems fine
- <_d3f> braunr: http://wiki.rout0r.org/index.php/Gentoo/Hurd/en - if you
- want to know more.
+ <_d3f> braunr: http://wiki.rout0r.org/index.php/Gentoo/Hurd/en - if you want to know more.
- IRC, freenode, #hurd, 2013-02-01:
+####IRC, freenode, #hurd, 2013-02-01:
- <WhiteKIBA> natsukao: http://wiki.rout0r.org/index.php/Gentoo/Hurd/en I
- am working on it
- <WhiteKIBA> if i can get glibc to compile correctly i can create a
- stage3 but at the moment it fails
+ <WhiteKIBA> natsukao: http://wiki.rout0r.org/index.php/Gentoo/Hurd/en I am working on it
+ <WhiteKIBA> if i can get glibc to compile correctly i can create a stage3 but at the moment it fails
- IRC, freenode, #hurd, 2013-02-02:
+####IRC, freenode, #hurd, 2013-02-02:
<alexxy> WhiteKIBA: you may be interested in my try to run gentoo/hurd
- <alexxy> WhiteKIBA:
- http://omrb.pnpi.spb.ru/gitweb/?p=gentoo/hurd.git;a=summary
+ <alexxy> WhiteKIBA: http://omrb.pnpi.spb.ru/gitweb/?p=gentoo/hurd.git;a=summary
# Using
@@ -72,7 +68,7 @@ about getting applications to work (if possible).
</dl>
-# Misc.
+# External
-* [Ognyan Kulev Collection](http://debian.fmi.uni-sofia.bg/~ogi/hurd/links/index.html) of links (unsupported)
+* [Ognyan Kulev Collection](https://web.archive.org/web/20080513192630/http://www.bddebian.com/~wiki/) of links (unsupported)
* [2000 Jim Franklin Collection](http://angg.twu.net/the_hurd_links.html) of links
diff --git a/hurd/running/gnu.mdwn b/hurd/running/gnu.mdwn
index 69a3210a..f6aada87 100644
--- a/hurd/running/gnu.mdwn
+++ b/hurd/running/gnu.mdwn
@@ -1,6 +1,6 @@
# <a name="The_GNU_Operating_System"> </a> The GNU Operating System
-The GNU Operating System, or GNU System as it is more commonly known, will be a
+The GNU Operating System, Commonly referred to as simply "The GNU System", is a
complete [[Unix]]-like operating system composed entirely of [free
software](http://www.gnu.org/philosophy/free-sw.html). The creation of the GNU
System is one of the goals of the [GNU Project](http://www.gnu.org/), which was
@@ -15,7 +15,7 @@ including [[POSIX|https://en.wikipedia.org/wiki/POSIX]], modularity, and
respecting user freedom. Many of these goals are things that the GNU/Hurd can
resolve, however the GNU/Hurd is not the most stable operating system yet.
-If you are looking for a production ready GNU system, then Debian GNU/Hurd may
+If you are looking for a production ready GNU system, then [[hurd/running/Debian]] GNU/Hurd may
not be the best choice for you. Debian GNU/Hurd currently lacks 64-bit support,
many device drivers, sound support, SMP, and a few other essential bits that
provide a flexible operating system.
diff --git a/hurd/what_is_the_gnu_hurd.mdwn b/hurd/what_is_the_gnu_hurd.mdwn
index 7a7f3d43..8315bfff 100644
--- a/hurd/what_is_the_gnu_hurd.mdwn
+++ b/hurd/what_is_the_gnu_hurd.mdwn
@@ -11,8 +11,7 @@ License|/fdl]]."]]"""]]
[[!meta title="What Is the GNU Hurd?"]]
-The Hurd is the GNU project's replacement for [[UNIX]], a popular operating
-system [[kernel]].
+The Hurd is the GNU project's replacement for the [[UNIX]] system's [[kernel]].
The Hurd is firstly a collection of protocols formalizing how different
components may interact. The protocols are designed to reduce the mutual