summaryrefslogtreecommitdiff
path: root/hurd/running/debian
diff options
context:
space:
mode:
Diffstat (limited to 'hurd/running/debian')
-rw-r--r--hurd/running/debian/BtsFiling.mdwn52
-rw-r--r--hurd/running/debian/CrossInstall.mdwn2
-rw-r--r--hurd/running/debian/DebianAptOffline.mdwn24
-rw-r--r--hurd/running/debian/GnuDebianRelationship.mdwn4
-rw-r--r--hurd/running/debian/MediaPressKitDiscuss.mdwn2
-rw-r--r--hurd/running/debian/after_install.mdwn47
-rw-r--r--hurd/running/debian/creating_image_tarball.mdwn21
-rw-r--r--hurd/running/debian/creating_image_tarball/anonftpsync-ports180
-rw-r--r--hurd/running/debian/faq.mdwn158
-rw-r--r--hurd/running/debian/faq/2_gib_partition_limit.mdwn13
-rw-r--r--hurd/running/debian/faq/512_mib_ram_limit.mdwn21
-rw-r--r--hurd/running/debian/faq/apt_umount.mdwn25
-rw-r--r--hurd/running/debian/faq/bad_hypermeta_data.mdwn15
-rw-r--r--hurd/running/debian/faq/debugging_inside_glibc.mdwn19
-rw-r--r--hurd/running/debian/faq/debugging_translators.mdwn15
-rw-r--r--hurd/running/debian/faq/dev_random.mdwn17
-rw-r--r--hurd/running/debian/faq/df.mdwn13
-rw-r--r--hurd/running/debian/faq/eata.mdwn13
-rw-r--r--hurd/running/debian/faq/free_memory.mdwn11
-rw-r--r--hurd/running/debian/faq/hurd_console.mdwn12
-rw-r--r--hurd/running/debian/faq/kernel_logs.mdwn13
-rw-r--r--hurd/running/debian/faq/other_repositories.mdwn16
-rw-r--r--hurd/running/debian/faq/ps_hangs.mdwn12
-rw-r--r--hurd/running/debian/faq/reporting_bugs.mdwn19
-rw-r--r--hurd/running/debian/faq/sata_disk_drives.mdwn11
-rw-r--r--hurd/running/debian/faq/sshd_only_works_for_root_logins.mdwn20
-rw-r--r--hurd/running/debian/faq/xserver-common.mdwn12
-rw-r--r--hurd/running/debian/logo.pngbin2463 -> 0 bytes
-rw-r--r--hurd/running/debian/package_troubleshooting.mdwn7
-rw-r--r--hurd/running/debian/patch_submission.mdwn55
-rw-r--r--hurd/running/debian/porting.mdwn54
31 files changed, 632 insertions, 251 deletions
diff --git a/hurd/running/debian/BtsFiling.mdwn b/hurd/running/debian/BtsFiling.mdwn
deleted file mode 100644
index 90f451a8..00000000
--- a/hurd/running/debian/BtsFiling.mdwn
+++ /dev/null
@@ -1,52 +0,0 @@
-When you encounter any GNU/Hurd related bugs in a Debian package you can fix, please use the Debian BTS (Bug Tracking System) to report them.
-
-Managing Debian packages and using the BTS is quite simple. If you're new to Debian, here's a short guide:
-
-* first of all, check [http://bugs.debian.org/<package>](http://bugs.debian.org) to ensure the problem is not in the BTS already. This is possible for packages and bug numbers. [[TWiki/InterWikis]] is a shorthand way of linking to bugs and packages from this site. i.e. [[DebianBug]]:hurd [[DebianPackage]]:oskit
-* you can fetch package sources with:
-
- apt-get source <package>
-
-note: this should unpack already
-
-* and unpack with:
-
- dpkg-source -x <package>x-y_z.dsc
-
-* then get all dependencies:
-
- apt-get -y build-dep <package>
-
-note: if some dependencies are missing, it most probably means you have to port them first. follow this instructions recursively until done
-
- :)
-
-* Debian packages have a makefile in debian/rules, with (at least) the following targets: <dl>
- <dt> build</dt>
- <dd> Yup, to build </dd>
- <dt> binary</dt>
- <dd> Generates deb files in <code>../</code></dd>
- <dt> clean</dt>
- <dd> Full clean </dd>
-</dl>
-
-* when you have a patch, send it to the BTS using the reportbug utility (or manually as explained in <http://bugs.debian.org/)>. The following parameters should be used:
-
- Severity: important (when the package is unbuildable or uninstallable, lower otherwise.)
- Tags: sid, patch
-
-* be nice to the maintainers. most are friendly and cooperative, and a few could annoy you for months before applying. Be patient.
-
-Read <http://bugs.debian.org/> for extensive documentation on the BTS.
-
--- [[Main/RobertMillan]] - 10 Jun 2002
-
-----
-
-Wikification &amp; small changes.
-
--- [[Main/JoachimNilsson]] - 24 Jun 2002
-
-Updates with the new [[TWiki/InterWikis]] rules.
-
--- [[Main/GrantBow]] - 15 Jan 2003
diff --git a/hurd/running/debian/CrossInstall.mdwn b/hurd/running/debian/CrossInstall.mdwn
index 9a07424e..1cde150c 100644
--- a/hurd/running/debian/CrossInstall.mdwn
+++ b/hurd/running/debian/CrossInstall.mdwn
@@ -34,7 +34,7 @@ Now the program starts retrieving all the necessary base packages.
### <a name="Preparing_to_reboot"> Preparing to reboot </a>
-When all packages have been extracted we must prepare [[GrubNotes]] for the Hurd when we reboot. Add the below entry to your `/boot/grub/menu.lst` file to boot the Hurd in single user mode (-s). Single user mode is needed only for the two reboots when running the Native Install.
+When all packages have been extracted we must prepare [[GRUB]] for the Hurd when we reboot. Add the below entry to your `/boot/grub/menu.lst` file to boot the Hurd in single user mode (-s). Single user mode is needed only for the two reboots when running the Native Install.
title GNU (kernel GNUmach 1.3)
root (hd0,2)
diff --git a/hurd/running/debian/DebianAptOffline.mdwn b/hurd/running/debian/DebianAptOffline.mdwn
index 52313bf2..9596040d 100644
--- a/hurd/running/debian/DebianAptOffline.mdwn
+++ b/hurd/running/debian/DebianAptOffline.mdwn
@@ -1,18 +1,12 @@
-[[license text="""
-Copyright © 2005, 2007 Free Software Foundation, Inc.
-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.txt]].
-
-By contributing to this page, you agree to assign copyright for your
-contribution to the Free Software Foundation. The Free Software Foundation
-promises to always use either a verbatim copying license or a free
-documentation license when publishing your contribution. We grant you back all
-your rights under copyright, including the rights to copy, modify, and
-redistribute your contributions.
-"""]]
+[[!meta copyright="Copyright © 2005, 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]]."]]"""]]
# How to Installing Packages without a Network Connection from your Hurd Installation
diff --git a/hurd/running/debian/GnuDebianRelationship.mdwn b/hurd/running/debian/GnuDebianRelationship.mdwn
index ede808c8..94fd6265 100644
--- a/hurd/running/debian/GnuDebianRelationship.mdwn
+++ b/hurd/running/debian/GnuDebianRelationship.mdwn
@@ -2,11 +2,11 @@ I have hesitated in starting this page due to the sensitive nature of this relat
This is a work in progress. Please email me directly if you have comments or suggestions.
-* Debian Advantages of Hurd [[Distrib/PortingIssues]] Efforts
+* Debian Advantages of Hurd [[porting/guidelines]] Efforts
* One of the first ports to non-Linux system along with \*BSD and win32.
* Official GNU system distribution.
-* Debian Disadvantages of Hurd [[Distrib/PortingIssues]] Efforts
+* Debian Disadvantages of Hurd [porting/guidelines]] Efforts
* Perceived zealous GNU and FSF promotion.
* Hurd Port Advantages of Debian
diff --git a/hurd/running/debian/MediaPressKitDiscuss.mdwn b/hurd/running/debian/MediaPressKitDiscuss.mdwn
index e8b1cfff..2bd97290 100644
--- a/hurd/running/debian/MediaPressKitDiscuss.mdwn
+++ b/hurd/running/debian/MediaPressKitDiscuss.mdwn
@@ -1,5 +1,3 @@
-%TOC%
-
# <a name="Media_Press_Kit"> Media / Press Kit </a>
## <a name="Problem"> Problem </a>
diff --git a/hurd/running/debian/after_install.mdwn b/hurd/running/debian/after_install.mdwn
index 5c998c94..15ca9c83 100644
--- a/hurd/running/debian/after_install.mdwn
+++ b/hurd/running/debian/after_install.mdwn
@@ -5,7 +5,7 @@ mode?
Time to get to work.
-[[toc ]]
+[[!toc]]
### Get Networking Running
@@ -29,12 +29,13 @@ If the NIC was detected:
# settrans -fgap /servers/socket/2 /hurd/pfinet -i eth0 -a 192.168.1.3 -g 192.168.1.1 -m 255.255.255.0
+In order to use DHCP, you need to install the `dhcp-client` package and run `dhclient eth0` etc.
# Setup GRUB
You surely want grub to have a nice menu entry able to boot GNU, instead of
typing a boring arcane. There are Debian-specific scripts that may help
-you. See the [[GrubNotes]] for this.
+you. See [[GRUB]]'s page for this.
# Setup `apt-get`
@@ -44,47 +45,22 @@ put in `/etc/apt/sources.list` are (as of Jan 2007):
deb http://mirrors.kernel.org/debian unstable main contrib
deb-src http://mirrors.kernel.org/debian unstable main contrib
- deb http://ftp.gnuab.org/debian unreleased main
- deb-src http://ftp.gnuab.org/debian unreleased main
+ deb http://ftp.debian-ports.org/debian unreleased main
+ deb-src http://ftp.debian-ports.org/debian unreleased main
`apt-get` update a couple of times if some file fails to download.
-<!-- As long as I am around (which is as off February 2005) I never ever had to
-do such following frobbing. Should we remove this? --[[tschwinge]] -->
-
-If when doing your first `apt-get`, `dpkg` complains of missing programs, [try
-to cheat it this
-way](http://lists.debian.org/debian-hurd/1999/05/msg00187.html):
-
- # ln -s /sbin/ldconfig /bin/ldconfig
- # ln -s /bin/true /bin/update-rc.d
- # ln -s /bin/true /bin/start-stop-daemon
- # ln -s /bin/true /bin/install-info
- # ln -s /bin/true /bin/update-alternatives
+If when doing your first `apt-get`, `dpkg` complains of missing programs, get root in a login shell (`su -`).
Installing packages without having a network connection is described
[[Distrib/DebianAptOffline]].
-
# [[translator/Random]]
-You often need `scp` and `ssh`. Sadly the Debian GNU/Hurd does not yet come
-with any default random translator package installed. See
-[[translator/random]] for details, the following is just a quick recap.
-
- cd && mkdir tmp && cd tmp
- wget http://kilobug.free.fr/hurd/random-64.tar.gz
- tar xvfz random-64.tar.gz
- cp random /hurd/
-
- settrans -c /dev/random /hurd/random \
- --seed-file /var/run/random-seed --secure
- settrans -c /dev/urandom /hurd/random \
- --seed-file /var/run/urandom-seed --fast
- chmod 0644 /dev/random /dev/urandom
-
- apt-get install ssh
+You often need `scp` and `ssh`. There is now a `random-egd` package available which uses
+a random translator by Ryan Hunter and the entropy gathering daemon as entropy source.
+See [[Translator/random]] for more information.
# [[Console]]
@@ -109,7 +85,7 @@ You first must have setup the virtual console. See above.
Assuming you've installed WindowMaker and have tried running `startx` already:
- [/etc/X11/XF86Config-4]
+ [/etc/xorg.conf]
Section "Module"
# Load "dri"
@@ -130,9 +106,6 @@ Assuming you've installed WindowMaker and have tried running `startx` already:
Make sure not to have the `Emulate3Buttons` and `ZAxisMapping` settings set, as
they lead to problems with e.g. dragging windows around.
- [/etc/profile]
- LD_LIBRARY_PATH=/X11R6/lib:$LD_LIBRARY_PATH
-
# What about package XYZ?
See if you can find a useful tip in [[package_troubleshooting]].
diff --git a/hurd/running/debian/creating_image_tarball.mdwn b/hurd/running/debian/creating_image_tarball.mdwn
new file mode 100644
index 00000000..ac91dab4
--- /dev/null
+++ b/hurd/running/debian/creating_image_tarball.mdwn
@@ -0,0 +1,21 @@
+[[!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 following [[anonftpsync-ports]] is used to create a local Debian GNU/Hurd
+repo. You will need atleast 12G of disk space. Change the
+"TO=/home/foo/rsync-debian-ports" to your desired target directory.
+
+Run it using:
+
+ sudo sh anonftpsync-ports
+
+In /home/foo/rsync-debian-ports, you will find the following directories:
+
+ base dists indices pool pool-hurd-i386 project
diff --git a/hurd/running/debian/creating_image_tarball/anonftpsync-ports b/hurd/running/debian/creating_image_tarball/anonftpsync-ports
new file mode 100644
index 00000000..0988dbde
--- /dev/null
+++ b/hurd/running/debian/creating_image_tarball/anonftpsync-ports
@@ -0,0 +1,180 @@
+#! /bin/sh
+set -e
+
+# This script originates from http://www.debian.org/mirror/anonftpsync
+# modified by Martin Zobel-Helas <zobel@debian.org>, 2005-01-16
+# these modifications are published under the terms of the GNU GPL
+# Modifications:
+# + some more documentation about variables
+# + added ARCH_EXCLUDE
+# + mirror in a safe way, first /pool, then /dists and the rest
+# modified by Aurelien Jarno <aurel32@debian.org>, 2007-12-02
+# these modifications are published under the terms of the GNU GPL
+# + modifications to mirror debia,-ports.org
+# Version: $Id: anonftpsync,v 1.18 2005/10/28 15:25:54 aba Exp $
+
+
+# Note: You MUST have rsync 2.0.16-1 or newer, which is available in slink
+# and all newer Debian releases, or at http://rsync.samba.org/
+
+# Set the variables below to fit your site. You can then use cron to have
+# this script run daily to automatically update your copy of the archive.
+
+# Don't forget:
+# chmod 744 anonftpsync
+
+# TO is the destination for the base of the Debian mirror directory
+# (the dir that holds dists/ and ls-lR).
+# (mandatory)
+
+TO=/home/foo/rsync-debian-ports
+
+# RSYNC_HOST is the site you have chosen from the mirrors file.
+# (http://www.debian-ports.org/mirrors)
+# (mandatory)
+
+RSYNC_HOST=rsync.debian-ports.org
+
+# RSYNC_DIR is the directory given in the "Packages over rsync:" line of
+# the mirrors file for the site you have chosen to mirror.
+# (mandatory)
+
+RSYNC_DIR=debian/
+
+# LOGDIR is the directory where the logs will be written to
+# (mandatory)
+
+LOGDIR=/var/log/rsync-debian-ports
+
+# ARCH_EXCLUDE can be used to exclude a complete architecture from
+# mirrorring. Please use as space seperated list.
+# Possible values are:
+# armel hurd-i386 kfreebsd-amd64 kfreebsd-i386
+#
+# There is one special value: source
+# This is not an architecture but will exclude all source code in /pool
+#
+# eg.
+# ARCH_EXCLUDE="hurd-i386"
+#
+# With a blank ARCH_EXCLUDE you will mirror all availible architectures
+# (optional)
+
+ARCH_EXCLUDE="armel kfreebsd-amd64 kfreebsd-i386 m68k"
+
+# EXCLUDE is a list of parameters listing patterns that rsync will exclude.
+# The following example would exclude mostly everything:
+#EXCLUDE="\
+# --exclude binary-hurd-i386/ --exclude binary-kfreebsd-i386/
+# --exclude *_hurd-i386.deb --exclude *_knetbsd-i386.deb \
+# --exclude stable/ --exclude testing/ --exclude unstable/ \
+# --exclude source/ \
+# --exclude *.orig.tar.gz --exclude *.diff.gz --exclude *.dsc \
+# --exclude /base/ --exclude /bochs/ --exclude /obsolete/ \
+# "
+
+# With a blank EXCLUDE you will mirror the entire archive.
+# (optional)
+
+EXCLUDE="--exclude binary-kfreebsd-i386/ --exclude *_knetbsd-i386.deb \
+ --exclude source/ --exclude *.orig.tar.gz --exclude *.diff.gz \
+ --exclude /bochs/ --exclude /obsolete/ \
+ --exclude *kfreebsd* --exclude *m68* --exclude *sh* \
+ "
+
+# MAILTO is the address to send logfiles to;
+# if it is not defined, no mail will be sent
+# (optional)
+
+MAILTO=
+
+# There should be no need to edit anything below this point, unless there
+# are problems.
+
+#-----------------------------------------------------------------------------#
+
+# Check for some environment variables
+if [ -z $TO ] || [ -z $RSYNC_HOST ] || [ -z $RSYNC_DIR ] || [ -z $LOGDIR ]; then
+ echo "One of the following variables seems to be empty:"
+ echo "TO, RSYNC_HOST, RSYNC_DIR or LOGDIR"
+ exit 2
+fi
+
+if ! [ -d ${TO}/project/trace/ ]; then
+ # we are running mirror script for the first time
+ mkdir -p ${TO}/project/trace
+fi
+
+# Note: on some non-Debian systems, hostname doesn't accept -f option.
+# If that's the case on your system, make sure hostname prints the full
+# hostname, and remove the -f option. If there's no hostname command,
+# explicitly replace `hostname -f` with the hostname.
+HOSTNAME=`hostname -f`
+
+LOCK="${TO}/Archive-Update-in-Progress-${HOSTNAME}"
+
+# Exclude architectures defined in $ARCH_EXCLUDE
+for ARCH in $ARCH_EXCLUDE; do
+ EXCLUDE=$EXCLUDE"\
+ --exclude binary-$ARCH/ \
+ --exclude disks-$ARCH/ \
+ --exclude installer-$ARCH/ \
+ --exclude Contents-$ARCH \
+ --exclude Contents-$ARCH.gz \
+ --exclude *_$ARCH.deb \
+ --exclude *_$ARCH.udeb \
+ --exclude pool-$ARCH/"
+ if [ "$ARCH" == "source" ]; then
+ SOURCE_EXCLUDE="\
+ --exclude *.tar.gz \
+ --exclude *.diff.gz \
+ --exclude *.dsc "
+ fi
+done
+
+# Logfile
+LOGFILE=$LOGDIR/debian-mirror-ports.log
+
+# Get in the right directory and set the umask to be group writable
+#
+cd $HOME
+umask 002
+
+# Check to see if another sync is in progress
+if lockfile -! -l 10800 -r 0 "$LOCK"; then
+ echo ${HOSTNAME} is unable to start rsync, lock file exists
+ exit 1
+fi
+# Note: on some non-Debian systems, trap doesn't accept "exit" as signal
+# specification. If that's the case on your system, try using "0".
+trap "rm -f $LOCK > /dev/null 2>&1" exit
+
+set +e
+
+# First sync /pool-*
+rsync --recursive --links --hard-links --times --verbose \
+ $EXCLUDE $SOURCE_EXCLUDE \
+ $RSYNC_HOST::$RSYNC_DIR/pool-* $TO >> $LOGFILE 2>&1
+result=$?
+
+if [ 0 = $result ]; then
+ # Now sync the remaining stuff
+ rsync --recursive --links --hard-links --times --verbose --delete-after \
+ --exclude "Archive-Update-in-Progress-${HOSTNAME}" \
+ --exclude "project/trace/" \
+ --exclude "/pool-*/" \
+ $EXCLUDE \
+ $RSYNC_HOST::$RSYNC_DIR $TO >> $LOGFILE 2>&1
+
+ date -u > "${TO}/project/trace/${HOSTNAME}"
+else
+ echo "ERROR: Help, something weird happened" | tee -a $LOGFILE
+ echo "mirroring /pool-* exited with exitcode" $result | tee -a $LOGFILE
+fi
+
+
+if ! [ -z $MAILTO ]; then
+ mail -s "debian ports archive synced" $MAILTO < $LOGFILE
+fi
+
+savelog $LOGFILE
diff --git a/hurd/running/debian/faq.mdwn b/hurd/running/debian/faq.mdwn
index 1892d63f..8aaadf9c 100644
--- a/hurd/running/debian/faq.mdwn
+++ b/hurd/running/debian/faq.mdwn
@@ -1,137 +1,21 @@
-Debian GNU/Hurd FAQ.
-
-See also the [[Hurd_FAQ|hurd/FAQ]] and [[after_install]].
-
-[[toc ]]
-
-
-# `df`
-
-There is no `/etc/mtab`, so just running `df` will yield an error. Pass `df` a
-path like `df /` or `df ./` to see the disk usage of that particular file
-system.
-
-
-# `sshd`
-
-You need to disable `PriviledgeSeperation` in `/etc/ssh/sshd\_options`. Also
-make sure you have `/dev/random`, see below.
-
-
-# `/dev/random`
-
-There is no random device by default as no secure implementation has been
-finished yet. An easy (but very insecure) work-around is to copy a binary file
-like `/bin/bash` to `/dev/random` and `/dev/urandom`.
-
-
-# Hurd Console
-
-Edit `/etc/default/hurd-console` to configure the Hurd console and enable it on
-bootup. See [[console]] for further information about the Hurd console.
-
-
-# Swap
-
-
-# 2 GiB Partition Limit
-
-The 2 GiB limit has been removed in Debian GNU/Hurd.
-
-
-# Free Memory
-
-Run `vmstat` to see memory and swap usage.
-
-
-# Translators
-
-
-# 512 MiB RAM Limit
-
-GNU Mach does not cope well with lots of memory. Newer versions of the Debian
-`gnumach` package will limit themselves to around 1 GiB of memory. If you have
-an older version, or still experience problems with `vmstat` (see above)
-reported much less memory than you have, the best is to limit the memory it can
-see via GRUB's `upppermem` feature. Add `uppermem 786432` to GRUB's Hurd entry
-in `menu.lst`.
-
-This should be fixed.
-
-
-# `xserver-common`
-
-You need to run `dpkg-reconfigure xserver-common` and select `Anybody` for
-starting X as there is no way to detect console users currently.
-
-
-# Reporting Bugs
-
-Please try to reproduce bugs which are not obviously Hurd-specific on Debian
-GNU/Linux and then file them there.
-
-If you find a genuine issue in Debian GNU/Hurd, please file it in our Alioth
-bug tracker at
-[http://alioth.debian.org/tracker/?atid=411594&amp;group\_id=30628&amp;func=browse](http://alioth.debian.org/tracker/?atid=411594&group_id=30628&func=browse)
-If you find a bug in the Hurd or GNU Mach themselves, either file a bug against
-the respective Debian packages, or directly at
-<http://savannah.gnu.org/bugs/?group=hurd>
-
-
-# `ps` Hangs
-
-If `ps` hangs, try `ps -M` which might still work.
-
-
-# Porting Packages
-
-
-# Debugging inside glibc
-
-To get [[debugging]] information for glibc, you need to install the
-`libc0.3-dbg` package. At the place [[debugging/GDB]] looks for debugging
-symbols by default (`/usr/lib/debug/lib/`), Debian's `libc0.3-dbg` stores only
-frame unwind information. If you want to step into glibc while debugging, you
-need to add `LD\_LIBRARY\_PATH=/usr/lib/debug` to GDB's environment. If that
-still does not work, try `LD\_PRELOAD=/usr/lib/debug/libc.so.0.3` instead. You
-can add to GDB's environment via `set env FOO bar` from the GDB command line.
-
-It seems that this is no longer needed with the Debian glibc 2.5 packages, but
-I may as well be wrong. Have to check that again.
-
-
-# Debugging Translators
-
-In order to [[debug|debugging]] translators and being able to step into glibc
-during it, you need the `hurd-dbg` and `libc0.3-dbg` packages installed. Then
-start the translator like `settrans -P /foo /usr/bin/env
-LD\_LIBRARY\_PATH=/usr/lib/debug /hurd/foofs`. The `-P` option will make it
-pause and you will be able to attach [[debugging/GDB]] to the process.
-
-Is starting the translator like this really needed?
-
-
-# Other Repositories
-
-If you want to use the `apt-get source` facility, make sure that
-`/etc/apt/sources.list` contains a line like
-
- deb-src http://ftp.de.debian.org/debian unstable main
-
-... replacing _de_ with your homeland's code.
-
-
-# Kernel Logs
-
-The kernel logs are written to `/dev/klog`. Run `cat /dev/klog > foo` as root
-and hit `ctrl+c` after a few seconds to catch the logs. You can do this only
-once and do not do this in single-user mode (where `ctrl+c` does not work).
-
-
-# `bad hypermeta data`
-
-If you get the error `bad hypermeta data` when trying to mount an ext3
-partition from GNU/Linux, that is usually because the file system has not been
-unmounted cleanly (maybe GNU/Linux got suspended to disk) and the Hurd cannot
-mount it as ext2 without checking. Either boot back into GNU/Linux and unmount
-it or you can try to run `fsck.ext3` from GNU/Hurd directly.
+[[!meta copyright="Copyright © 2007, 2009, 2010 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]]."]]"""]]
+
+[[!meta title="Debian GNU/Hurd FAQ"]]
+
+See also [[after_install]] instructions, and other [[/FAQ]].
+
+[[!inline
+pages="hurd/running/debian/faq/* and !*/discussion"
+show=0
+feeds=no
+actions=yes
+rootpage="hurd/running/debian/faq" postformtext="Add a new item titled:"]]
diff --git a/hurd/running/debian/faq/2_gib_partition_limit.mdwn b/hurd/running/debian/faq/2_gib_partition_limit.mdwn
new file mode 100644
index 00000000..195191cb
--- /dev/null
+++ b/hurd/running/debian/faq/2_gib_partition_limit.mdwn
@@ -0,0 +1,13 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+[[!meta title="2 GiB Partition Limit"]]
+
+The 2 GiB limit has been removed in Debian GNU/Hurd.
diff --git a/hurd/running/debian/faq/512_mib_ram_limit.mdwn b/hurd/running/debian/faq/512_mib_ram_limit.mdwn
new file mode 100644
index 00000000..f89a5c01
--- /dev/null
+++ b/hurd/running/debian/faq/512_mib_ram_limit.mdwn
@@ -0,0 +1,21 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+[[!meta title="512 MiB RAM Limit"]]
+
+Just like any 32bit OS without bad tricks, GNU Mach does not cope well with lots
+of memory. Newer versions of the Debian `gnumach` package will limit themselves
+to around 1 GiB of memory. If you want more, you can twiddle the VM_MAX_ADDRESS
+limit between kernelland and userland in i386/include/mach/i386/vm_param.h.
+
+If you have an older version, or still experience problems with `vmstat` (see
+above) reported much less memory than you have, the best is to limit the memory
+it can see via GRUB's `upppermem` feature. Add `uppermem 786432` to GRUB's Hurd
+entry in `menu.lst`.
diff --git a/hurd/running/debian/faq/apt_umount.mdwn b/hurd/running/debian/faq/apt_umount.mdwn
new file mode 100644
index 00000000..db0dbfd1
--- /dev/null
+++ b/hurd/running/debian/faq/apt_umount.mdwn
@@ -0,0 +1,25 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+[[!meta title="apt: unmount cdroms"]]
+
+You can add a shell script umount so that apt can automatically unmount cdroms.
+
+ #!/bin/sh
+ # Filename: /usr/bin/umount
+
+ settrans -fg "$@"
+
+Give executable permission to the script.
+
+ # chmod +x /usr/bin/umount
+
+In `/etc/fstab` add a trailing `/` after cdrom like `/cdrom/` since apt uses a
+trailing `/`.
diff --git a/hurd/running/debian/faq/bad_hypermeta_data.mdwn b/hurd/running/debian/faq/bad_hypermeta_data.mdwn
new file mode 100644
index 00000000..bc960e30
--- /dev/null
+++ b/hurd/running/debian/faq/bad_hypermeta_data.mdwn
@@ -0,0 +1,15 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+If you get the error `bad hypermeta data` when trying to mount an ext3
+partition from GNU/Linux, that is usually because the file system has not been
+unmounted cleanly (maybe GNU/Linux got suspended to disk) and the Hurd cannot
+mount it as ext2 without checking. Either boot back into GNU/Linux and unmount
+it or you can try to run `fsck.ext3` from GNU/Hurd directly.
diff --git a/hurd/running/debian/faq/debugging_inside_glibc.mdwn b/hurd/running/debian/faq/debugging_inside_glibc.mdwn
new file mode 100644
index 00000000..91b71d64
--- /dev/null
+++ b/hurd/running/debian/faq/debugging_inside_glibc.mdwn
@@ -0,0 +1,19 @@
+[[!meta copyright="Copyright © 2007, 2008, 2009 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]]."]]"""]]
+
+To get [[debugging]] information for glibc, you need to install the
+`libc0.3-dbg` package. At the place [[debugging/GDB]] looks for debugging
+symbols by default (`/usr/lib/debug/lib/`), Debian's `libc0.3-dbg` stores only
+the frame unwind information used for backtracing. If you want to step into
+glibc while debugging, you need to add `LD_LIBRARY_PATH=/usr/lib/debug` to
+debugged program's environment (`set env VAR value` from the GDB command line).
+If that still does not work, try `LD_PRELOAD=/usr/lib/debug/libc.so.0.3`
+instead.
diff --git a/hurd/running/debian/faq/debugging_translators.mdwn b/hurd/running/debian/faq/debugging_translators.mdwn
new file mode 100644
index 00000000..b55484e1
--- /dev/null
+++ b/hurd/running/debian/faq/debugging_translators.mdwn
@@ -0,0 +1,15 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+In order to [[debug|debugging]] translators and being able to step into glibc
+during it, you need the `hurd-dbg` and `libc0.3-dbg` packages installed. If you need to debug the initialization of the translator,
+start the translator like `settrans -P /foo /usr/bin/env
+LD\_LIBRARY\_PATH=/usr/lib/debug /hurd/foofs`. The `-P` option will make it
+pause and you will be able to attach [[debugging/GDB]] to the process.
diff --git a/hurd/running/debian/faq/dev_random.mdwn b/hurd/running/debian/faq/dev_random.mdwn
new file mode 100644
index 00000000..3b5fdffe
--- /dev/null
+++ b/hurd/running/debian/faq/dev_random.mdwn
@@ -0,0 +1,17 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+[[!meta title="/dev/random"]]
+
+There is no random device by default as no secure implementation has been
+finished yet. An easy (but very insecure) work-around is to copy a binary file
+like `/bin/bash` to `/dev/random` and `/dev/urandom`. A slightly more secure
+alternative is installing the `random-egd` from the `debian-ports` repository.
+
diff --git a/hurd/running/debian/faq/df.mdwn b/hurd/running/debian/faq/df.mdwn
new file mode 100644
index 00000000..4de232da
--- /dev/null
+++ b/hurd/running/debian/faq/df.mdwn
@@ -0,0 +1,13 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+There is no `/etc/mtab`, so just running `df` will yield an error. Pass `df` a
+path like `df /` or `df ./` to see the disk usage of that particular file
+system.
diff --git a/hurd/running/debian/faq/eata.mdwn b/hurd/running/debian/faq/eata.mdwn
new file mode 100644
index 00000000..fa7dbdec
--- /dev/null
+++ b/hurd/running/debian/faq/eata.mdwn
@@ -0,0 +1,13 @@
+[[!meta copyright="Copyright © 2010 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]]."]]"""]]
+
+In some virtual machines (e.g. VirtualBox), "probing eata on XXX" may be
+quite long. This is apparently due to poor efficiency of the virtualizer, not
+Mach. There is no such issue on real hardware or using qemu/kvm.
diff --git a/hurd/running/debian/faq/free_memory.mdwn b/hurd/running/debian/faq/free_memory.mdwn
new file mode 100644
index 00000000..c1c0a83c
--- /dev/null
+++ b/hurd/running/debian/faq/free_memory.mdwn
@@ -0,0 +1,11 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+Run `vmstat` to see memory and swap usage.
diff --git a/hurd/running/debian/faq/hurd_console.mdwn b/hurd/running/debian/faq/hurd_console.mdwn
new file mode 100644
index 00000000..c4a619a1
--- /dev/null
+++ b/hurd/running/debian/faq/hurd_console.mdwn
@@ -0,0 +1,12 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+Edit `/etc/default/hurd-console` to configure the Hurd console and enable it on
+bootup. See [[console]] for further information about the Hurd console.
diff --git a/hurd/running/debian/faq/kernel_logs.mdwn b/hurd/running/debian/faq/kernel_logs.mdwn
new file mode 100644
index 00000000..ff14ce5f
--- /dev/null
+++ b/hurd/running/debian/faq/kernel_logs.mdwn
@@ -0,0 +1,13 @@
+[[!meta copyright="Copyright © 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 kernel logs are written to `/dev/klog`. Run `cat /dev/klog > foo` as root
+and hit `ctrl+c` after a few seconds to catch the logs. You can do this only
+once and do not do this in single-user mode (where `ctrl+c` does not work).
diff --git a/hurd/running/debian/faq/other_repositories.mdwn b/hurd/running/debian/faq/other_repositories.mdwn
new file mode 100644
index 00000000..88781d46
--- /dev/null
+++ b/hurd/running/debian/faq/other_repositories.mdwn
@@ -0,0 +1,16 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+If you want to use the `apt-get source` facility, make sure that
+`/etc/apt/sources.list` contains a line like
+
+ deb-src http://ftp.de.debian.org/debian unstable main
+
+... replacing _de_ with your homeland's code.
diff --git a/hurd/running/debian/faq/ps_hangs.mdwn b/hurd/running/debian/faq/ps_hangs.mdwn
new file mode 100644
index 00000000..febfeb59
--- /dev/null
+++ b/hurd/running/debian/faq/ps_hangs.mdwn
@@ -0,0 +1,12 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+If `ps` hangs, try `ps -M` which might still work by not getting detailed
+information from processes.
diff --git a/hurd/running/debian/faq/reporting_bugs.mdwn b/hurd/running/debian/faq/reporting_bugs.mdwn
new file mode 100644
index 00000000..40781ab0
--- /dev/null
+++ b/hurd/running/debian/faq/reporting_bugs.mdwn
@@ -0,0 +1,19 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+Please try to reproduce bugs which are not obviously Hurd-specific on Debian
+GNU/Linux and then file them there.
+
+If you find a genuine issue in Debian GNU/Hurd, please file it in our Alioth
+bug tracker at
+<http://alioth.debian.org/tracker/?atid=411594&group_id=30628&func=browse>
+If you find a bug in the Hurd or GNU Mach themselves, either file a bug against
+the respective Debian packages, or directly at
+<http://savannah.gnu.org/bugs/?group=hurd>
diff --git a/hurd/running/debian/faq/sata_disk_drives.mdwn b/hurd/running/debian/faq/sata_disk_drives.mdwn
new file mode 100644
index 00000000..dad10cb9
--- /dev/null
+++ b/hurd/running/debian/faq/sata_disk_drives.mdwn
@@ -0,0 +1,11 @@
+[[!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]]."]]"""]]
+
+GNU Mach does not support SATA disk drives (/dev/sda etc. in GNU/Linux) natively, so using device:sd0s1 will not work, sd* devices are for SCSI drives only. The only way to get those drives to work is to put them into compatibility mode in the BIOS, if such an option exists. GNU Mach will then recognize them as hda etc.
diff --git a/hurd/running/debian/faq/sshd_only_works_for_root_logins.mdwn b/hurd/running/debian/faq/sshd_only_works_for_root_logins.mdwn
new file mode 100644
index 00000000..1a3c46e1
--- /dev/null
+++ b/hurd/running/debian/faq/sshd_only_works_for_root_logins.mdwn
@@ -0,0 +1,20 @@
+[[!meta copyright="Copyright © 2007, 2008, 2010 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]]."]]"""]]
+
+This isssue has been fixed in the Debian hurd / libc0.3 packages as of 2010-11.
+Retire this item sometime after 2011.
+
+---
+
+Privilege seperation does not work with Hurd currently. You need to explicitely
+set `PrivilegeSeparation` to `no` in `/etc/ssh/sshd_options`, just commenting out
+the entry will not work as it is on by default. Also make sure you have
+`/dev/random`, see below.
diff --git a/hurd/running/debian/faq/xserver-common.mdwn b/hurd/running/debian/faq/xserver-common.mdwn
new file mode 100644
index 00000000..09fbc902
--- /dev/null
+++ b/hurd/running/debian/faq/xserver-common.mdwn
@@ -0,0 +1,12 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+You need to run `dpkg-reconfigure xserver-common` and select `Anybody` for
+starting X as there is no way to detect console users currently.
diff --git a/hurd/running/debian/logo.png b/hurd/running/debian/logo.png
deleted file mode 100644
index 068d9584..00000000
--- a/hurd/running/debian/logo.png
+++ /dev/null
Binary files differ
diff --git a/hurd/running/debian/package_troubleshooting.mdwn b/hurd/running/debian/package_troubleshooting.mdwn
index 829af8e3..c6236c2f 100644
--- a/hurd/running/debian/package_troubleshooting.mdwn
+++ b/hurd/running/debian/package_troubleshooting.mdwn
@@ -1,9 +1,5 @@
This page reports known Hurd-specific bugs, quirks and corresponding solutions and workarounds with Debian GNU/Hurd package installation and working.
-## <a name="Table_of_Contents"> Table of Contents </a>
-
-%TOC%
-
## <a name="Dpkg_wants_external_programs_"> Dpkg wants external programs? </a>
It may be that dpkg wants external GNU/Linux-specific programs that it can't found or that just don't exist on the Hurd. You can trick dpkg by copying and running this script as root:
@@ -21,7 +17,8 @@ You must set up the [[translator/random]] device first.
## <a name="An_X_package_hangs_at_startup_wi"> An X package hangs at startup without error messages </a>
-Observed with GTK programs like xchat, synaptic, inkscape. It is an issue with libpthread that (as of 04 Feb 2007) is still unresolved. Sorry.
+Observed with GTK programs like xchat, synaptic, inkscape. It is an issue with
+[[libpthread]] that (as of 04 Feb 2007) is still unresolved. Sorry.
## <a name="Borked_fonts_on_GTK_app"> </a> Borked fonts on GTK app
diff --git a/hurd/running/debian/patch_submission.mdwn b/hurd/running/debian/patch_submission.mdwn
new file mode 100644
index 00000000..66348dd9
--- /dev/null
+++ b/hurd/running/debian/patch_submission.mdwn
@@ -0,0 +1,55 @@
+[[!meta copyright="Copyright © 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]]."]]"""]]
+
+If you fixed a Debian package which *FTBFS* (fails to build from source), you
+should submit the patch so that all users can profit from your work.
+
+If it is not a Debian-specific patch, you should strongly consider submitting
+the patch upstream for inclusion. This applies even more so if it is a GNU
+package, or otherwise frequently used package, or you know upstream anyway.
+
+If you had to change the code considerably and are not 100% sure you did not
+introduce a regression, or are not very experienced with these kinds of code
+changes, you should first submit your patch for review to the [Debian alioth
+patch
+tracker](http://alioth.debian.org/tracker/?atid=410472&group_id=30628&func=browse).
+
+If the patch is trivial, or one of the Debian porters approved your patch for
+submission, submit the patch to the Debian BTS (bug tracking system). You can
+either use the reportbug tool, or just simple mail. In any case, you should
+follow these guidelines:
+
+ * The submission address is <submit@bugs.debian.org>.
+ * The mail's subject (which will become the bug's title) should be
+ `SOURCE-PACKAGE: FTBFS on hurd-i386: REASON`.
+ * The first lines of the mail's body (the so-called *pseudo-header*):
+ * `Severity: important` -- not *serious*.
+ * `Version: VERSION` -- the version of the source package in unstable.
+ * `Tags: patch` -- as/if you include a ready-to-be-applied patch.
+ * `User: debian-hurd@lists.debian.org`
+ * `Usertags: hurd`
+
+In the bug description, mention that the package fails to build on hurd-i386
+and (if possible) quote the failure. If possible, point to the failing build
+log from <http://buildd.debian-ports.org/build.php> or elsewhere.
+
+Then, explain the failure (Debian maintainers usually do not know much about
+Hurd-specific failures), and attach the patch.
+
+The patch should be in unidiff form.
+
+If the package uses a patch system, it is preferable to submit the patch in a
+ready-to-use form (e.g. as a *dpatch*), but this is not required. Also, try to
+keep the patch small, e.g., do not submit a 100 KiB autotools diff for a
+one-line change in `configure.in` or a `Makefile.am`, but in this case mention
+that autotools need to be rerun and let the maintainer choose (you can suggest
+you would file a complete diff if the maintainer prefers).
+
+Last but not least, try to be courteous.
diff --git a/hurd/running/debian/porting.mdwn b/hurd/running/debian/porting.mdwn
new file mode 100644
index 00000000..0eb15465
--- /dev/null
+++ b/hurd/running/debian/porting.mdwn
@@ -0,0 +1,54 @@
+[[!meta copyright="Copyright © 2007, 2008, 2009, 2010 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]]."]]"""]]
+
+[[!meta title="Debian packages that need porting"]]
+
+More than half of the Debian archive has been compiled successfully on the
+Hurd, however, many programs fail to build for various reasons.
+
+A [list of build failures including error
+messages](http://unstable.buildd.net/buildd/hurd-i386_Failed.html) can be
+found, as well as a [preliminary
+analysis](http://lists.debian.org/debian-hurd/2007/07/msg00000.html) of them and [solutions](http://lists.debian.org/debian-hurd/2007/07/msg00001.html), and some more details in [[hurd/porting/guidelines]]. [Graphs and statistics](http://people.debian.org/~sthibault/) about the consequence in terms of build dependencies are available.
+
+There is a mailing list,
+[debian-hurd-build-logs](http://lists.alioth.debian.org/mailman/listinfo/debian-hurd-build-logs),
+where *builds logs from the Debian GNU/Hurd autobuilders* are posted. It is a
+high-traffic and high-volume list, and for that reason *not* archived, so you
+have to subscribe to see the messages.
+
+It might be a good idea to record your intention to port something either in
+the list below or in the [Alioth task
+tracker](http://alioth.debian.org/pm/task.php?group_project_id=34&group_id=30628&func=browse)
+so other people do not do duplicated work.
+
+Also, the [[community/HurdFr]] guys maintain their own [liste des travaux de
+packaging](http://wiki.hurdfr.org/index.php/Liste_des_travaux_de_packaging).
+
+Aside from the Alioth task tracker, here is a list of some packages (the
+important ones, as they're, e.g., blocking other packages from being built)
+that need someone to work on them.
+
+When you have a patch to submit, please adhere to the [[patch_submission]]
+guidelines.
+
+There is also further information available about [[hurd/porting]].
+
+[[!map
+pages="tagged(open_issue_porting) and !tagged(fixed_in_debian) and !*/discussion"
+show=title]]
+
+[[!inline
+pages="tagged(open_issue_porting) and !tagged(fixed_in_debian) and !*/discussion"
+show=0
+feeds=no
+actions=yes
+rootpage="open_issues" postformtext="Add a new item titled:"]]