summaryrefslogtreecommitdiff
path: root/hurd/running/debian
diff options
context:
space:
mode:
authorThomas Schwinge <tschwinge@gnu.org>2007-09-04 21:23:29 +0200
committerThomas Schwinge <tschwinge@gnu.org>2007-09-04 21:23:29 +0200
commitd93deae15ee91a9b04989777fda563f2ccd5410f (patch)
tree9221a69f97cf10e42f96f21765ed7f32de424cfb /hurd/running/debian
parent4011bbadc0c3a646f241ec226611deee2e1a07dd (diff)
Shuffle another bunch of files, related to `Distrib/' and `GNU/'.
Diffstat (limited to 'hurd/running/debian')
-rw-r--r--hurd/running/debian/BtsFiling.mdwn52
-rw-r--r--hurd/running/debian/CDNotesHome.mdwn7
-rw-r--r--hurd/running/debian/CrossInstall.mdwn76
-rw-r--r--hurd/running/debian/DebianAfterInstall.mdwn122
-rw-r--r--hurd/running/debian/DebianAptOffline.mdwn68
-rw-r--r--hurd/running/debian/DebianAptOffline/apt.conf.offline23
-rw-r--r--hurd/running/debian/DebianDpkgArchitecture.mdwn27
-rw-r--r--hurd/running/debian/DebianFAQ.mdwn89
-rw-r--r--hurd/running/debian/DebianIntegrationDeveloper.mdwn15
-rw-r--r--hurd/running/debian/DebianPackages.mdwn43
-rw-r--r--hurd/running/debian/DebianStatus.mdwn12
-rw-r--r--hurd/running/debian/DebianTranslatorPolicy.mdwn40
-rw-r--r--hurd/running/debian/GNUDebianBuildProcess.mdwn133
-rw-r--r--hurd/running/debian/GNUDebianPackages.mdwn103
-rw-r--r--hurd/running/debian/GnuDebianRelationship.mdwn32
-rw-r--r--hurd/running/debian/MediaPressKitDiscuss.mdwn78
-rw-r--r--hurd/running/debian/PackageTroubleshooting.mdwn52
-rw-r--r--hurd/running/debian/SampleDscFile.mdwn24
-rw-r--r--hurd/running/debian/SoftwareLicensing.mdwn116
-rw-r--r--hurd/running/debian/logo.pngbin0 -> 2463 bytes
20 files changed, 1112 insertions, 0 deletions
diff --git a/hurd/running/debian/BtsFiling.mdwn b/hurd/running/debian/BtsFiling.mdwn
new file mode 100644
index 00000000..90f451a8
--- /dev/null
+++ b/hurd/running/debian/BtsFiling.mdwn
@@ -0,0 +1,52 @@
+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/&lt;package&gt;](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/CDNotesHome.mdwn b/hurd/running/debian/CDNotesHome.mdwn
new file mode 100644
index 00000000..a154415b
--- /dev/null
+++ b/hurd/running/debian/CDNotesHome.mdwn
@@ -0,0 +1,7 @@
+Charles, here's a place for you! As usual, you can find [more information here](http://www.debian.org/ports/hurd/hurd-cd). Past notes may be of help as well.
+
+----
+
+It seems the building of the CDs is being passed to the University of Calicut. [Re: latest ISO images](http://lists.debian.org/debian-hurd/2007/07/msg00095.html) K 14 is the latest stable, L1 is the development version.
+
+-- [[Main/GrantBow]] - 24 Jul 2007
diff --git a/hurd/running/debian/CrossInstall.mdwn b/hurd/running/debian/CrossInstall.mdwn
new file mode 100644
index 00000000..9a07424e
--- /dev/null
+++ b/hurd/running/debian/CrossInstall.mdwn
@@ -0,0 +1,76 @@
+## <a name="Easy_install_with_CrossHurd"> Easy install with CrossHurd </a>
+
+Qurious about the Hurd? Have a 1-5 GiB partition free? Let's install GNU/Hurd on it!
+
+### <a name="Preparing_the_partition"> Preparing the partition </a>
+
+We'll assume you have a partition ready, for the sake of argument we use an example here: /dev/hda3 is the Hurd partition (type: Linux) and /dev/hda4 is the Linux swap that we'll reuse.
+
+First we create the Ext2 filesystem, notice the `hurd` option.
+
+ # mke2fs -o hurd /dev/DEVICE
+
+Next we create a useful mountpoint and mount the partition.
+
+ # mkdir /gnu
+ # mount /dev/hda3 /gnu
+
+### <a name="Retrieving_CrossHurd"> Retrieving CrossHurd </a>
+
+Unless you don't run Debian GNU/Linux download it from <http://packages.debian.org/crosshurd>, or simply apt-get the package from Testing or Unstable.
+
+ # apt-get install crosshurd
+
+### <a name="Cross_installing"> Cross installing </a>
+
+The crosshurd package only operates in the given target directory, which is the first question asked when running the program.
+
+ # cd /gnu
+ # crosshurd
+
+Answer the questions you get: $ What is the target directory?: `/gnu` $ Target Debian system?: gnu $ Target CPU?: i386
+
+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.
+
+ title GNU (kernel GNUmach 1.3)
+ root (hd0,2)
+ kernel /boot/gnumach.gz root=device:hd0s3 -s
+ module /hurd/ext2fs.static \
+ --multiboot-command-line=${kernel-command-line} \
+ --host-priv-port=${host-port} \
+ --device-master-port=${device-port} \
+ --exec-server-task=${exec-task} \
+ -T typed ${root} $(task-create) $(task-resume)
+ module /lib/ld.so.1 /hurd/exec $(exec-task=task-create)
+
+**_Nota Bene:_** In your menu file there should be no extra white space after the back slashes.
+
+### <a name="Native_install"> Native install </a>
+
+Ah, reboot and select "GNU (kernel GNUmach 1.3)" from the Grub menu. At the prompt, setup TERM and run the native-install script.
+
+ # export TERM=mach
+ # ./native-install
+
+When done the native install requests that you reboot once again and rerun native-install. This time you will be asked a lot of questions, see the [[Hurd/InstallNotes]] for details.
+
+ # reboot
+ ...
+ # export TERM=mach
+ # ./native-install
+
+Done, continue setting up your system, see the [[Hurd/InstallNotes]] for more help.
+
+-- [[Main/JoachimNilsson]] - 22 Mar 2005
+
+----
+
+Jeff Bailey has set up a system where you can install a Hurd system without having to use CDs. It's another type of cross-installation method which uses Debian package management tools to get the packages required as opposed to the one single big tarball.
+
+As of 2005-03-22, the latest version of crosshurd is 1.7.11. It can be found at <http://packages.debian.org/crosshurd>.
+
+-- [[Main/PeterMelville]] - 12 Jun 2004
diff --git a/hurd/running/debian/DebianAfterInstall.mdwn b/hurd/running/debian/DebianAfterInstall.mdwn
new file mode 100644
index 00000000..b1f14d9a
--- /dev/null
+++ b/hurd/running/debian/DebianAfterInstall.mdwn
@@ -0,0 +1,122 @@
+<div>
+ <center> [ [[Hurd/InstallNotes]] | [[Hurd/GetNetworkRunning]] | [[Hurd/RandomDevice]] | [[Hurd/DebianX]] ] </center>
+</div>
+
+%TOC%
+
+## <a name="First_steps_after_Install_"> First steps after Install. </a>
+
+So you have managed to get past the first ./native-install runs in single-user mode?
+
+Time to get to work.
+
+### <a name="_Hurd_GetNetworkRunning_Setup_ne"> </a> [[Hurd/GetNetworkRunning]]
+
+Check if your NIC was detected by GNU Mach:
+
+ # devprobe eth0
+
+_devprobe_ (run as user _root_) will print _eth0_ on successful detection. If it doesn't, your NIC was not detected correctly. You can then try to do the following (also as user _root_) for getting details:
+
+ # cat /dev/klog > ~/klog
+ [Wait a second, then press `Ctrl-C'.]
+
+Now examine the _~/klog_ file.
+
+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
+
+### <a name="Setup_grub"> Setup grub </a>
+
+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.
+
+### <a name="Setup_apt_get"> Setup apt-get </a>
+
+Sometimes getting apt-get to work is not straightforward. Good mirrors to 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
+
+apt-get update a couple of times if some file fails to download.
+
+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
+
+Installing packages without having a network connection is described [[Distrib/DebianAptOffline]].
+
+### <a name="_Hurd_RandomDevice_Setup_random_"> </a> [[Hurd/RandomDevice]]
+
+You often need scp and ssh. Sadly the Debian GNU/Hurd does not come with any default random package installed. See [[Hurd/RandomDevice]] 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
+
+### <a name="_Hurd_HurdConsole_Setup_Virtual_"> </a> [[Hurd/HurdConsole]]
+
+The latest Hurd package in Debian, plus the /native-install script, creates all necessary device nodes and other magic. You just need to edit /etc/default/hurd-console to tune the parameters and tell it to start at bootup.
+
+You can also call the Hurd console manually with the proper arguments:
+
+ console -d vga -d pc_kbd --repeat=kbd -d pc_mouse --repeat=mouse \
+ -d generic_speaker -c /dev/vcs
+
+ cd /dev
+ ln -s cons/kbd .
+ ln -s cons/mouse .
+
+### <a name="_Hurd_DebianXorg_Setup_X_Window_"> </a> [[Hurd/DebianXorg]]
+
+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]
+
+ Section "Module"
+ # Load "dri"
+ # Load "speedo"
+ .
+ .
+ .
+ EndSection
+
+ Section "InputDevice"
+ Identifier "Configured Mouse"
+ Driver "mouse"
+ Option "CorePointer"
+ Option "Device" "/dev/mouse"
+ Option "Protocol" "osmouse"
+ EndSection
+
+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
+
+### <a name="What_about_package_XYZ_"> </a> What about package XYZ?
+
+See if you can find a useful tip in [[PackageTroubleshooting]].
+
+-- [[Main/JoachimNilsson]] - 17 Apr 2005
+
+How about making an afterinstall man page � la !OpenBSD afterboot man page? Anyone could easily convert the current text into an afterinstall.8 page. If nobody else feels up to it I could do it.
+
+-- [[Main/JoachimNilsson]] - 22 Jul 2005
diff --git a/hurd/running/debian/DebianAptOffline.mdwn b/hurd/running/debian/DebianAptOffline.mdwn
new file mode 100644
index 00000000..52313bf2
--- /dev/null
+++ b/hurd/running/debian/DebianAptOffline.mdwn
@@ -0,0 +1,68 @@
+[[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.
+"""]]
+
+# How to Installing Packages without a Network Connection from your Hurd Installation
+
+This procedure is based on that found in
+`/usr/share/doc/apt-doc/offline.text.gz` (Debian package `apt-doc`).
+
+This requires having apt installed on the Host operating system.
+
+Put a copy of [apt.conf.offline](DebianAptOffline/apt.conf.offline)
+into your Debian GNU/Hurd installations /etc/apt/ directory.
+
+## If you _can_ mount your Debian GNU/Hurd partition from another OS, which can connect to the Internet
+
+As root on the internet connected OS:
+
+ # mount /dev/DEBIAN_GNU_HURD_PARTITON /mnt
+ # cd /mnt
+ # apt-get -c etc/apt/apt.conf.offline {update, upgrade, install foo, etc.}
+
+Then, reboot into your Debian GNU/Hurd installation and as root, run:
+
+ # apt-get {update, upgrade, install foo, etc.}
+
+## If you _cannot_ mount your Debian GNU/Hurd partition under another OS.
+
+From your Debian GNU/Hurd installation run, as the root user:
+
+ # tar cf myhurdsconf.tar /etc/apt/{apt.conf.offline,sources.list} /var/lib/dpkg/status
+
+Copy _myhurdsconf.tar_ to the remote system.
+
+This copies your apt configuration and the status of your system
+(what packages are installed, which versions, etc.)
+
+From the remote sytem, as any user, run:
+
+ $ mkdir myhurd
+ $ cd myhurd
+ $ tar -xf myhurdsconf.tar
+ $ mkdir -p var/lib/apt/lists/partial var/cache/apt/archives/partial tmp
+ $ apt-get -c etc/apt/apt.conf.offline {update, upgrade, install foo, etc.}
+ $ tar cf myhurdsconf.tar etc/apt/{apt.conf.offline,sources.list} var/
+
+Copy _myhurdsconf.tar_ back to your Debian GNU/Hurd system.
+
+Finally, from your Debian GNU/Hurd installation as the root user:
+
+ # mkdir tmp
+ # cd tmp
+ # tar -xf myhurdsconf.tar
+ # mv var/cache/apt/archives/*.deb /var/cache/apt/archives/
+ # mv var/lib/apt/lists/*_* /var/lib/apt/lists/
+ # apt-get {update, upgrade, install foo, etc.}
diff --git a/hurd/running/debian/DebianAptOffline/apt.conf.offline b/hurd/running/debian/DebianAptOffline/apt.conf.offline
new file mode 100644
index 00000000..59aed564
--- /dev/null
+++ b/hurd/running/debian/DebianAptOffline/apt.conf.offline
@@ -0,0 +1,23 @@
+ APT
+ {
+ /* This is not necessary if the two machines are the same arch, it tells
+ the remote APT what architecture the Debian machine is */
+ Architecture "hurd-i386";
+
+ Get::Download-Only "true";
+ };
+
+ Dir
+ {
+ /* Use the disc for state information and redirect the status file from
+ the /var/lib/dpkg default */
+ State "./var/lib/apt";
+ State::status "./var/lib/dpkg/status";
+
+ // Binary caches will be stored locally
+ Cache::archives "./var/cache/apt/archives/";
+ Cache "./tmp/";
+
+ // Location of the source list.
+ Etc "./etc/apt/";
+ };
diff --git a/hurd/running/debian/DebianDpkgArchitecture.mdwn b/hurd/running/debian/DebianDpkgArchitecture.mdwn
new file mode 100644
index 00000000..c768ff4e
--- /dev/null
+++ b/hurd/running/debian/DebianDpkgArchitecture.mdwn
@@ -0,0 +1,27 @@
+The output of dpkg-archicture on Debian's hurd-i386 port:
+
+DEB\_BUILD\_ARCH=hurd-i386
+
+DEB\_BUILD\_ARCH\_OS=hurd
+
+DEB\_BUILD\_ARCH\_CPU=i386
+
+DEB\_BUILD\_GNU\_CPU=i486
+
+DEB\_BUILD\_GNU\_SYSTEM=gnu
+
+DEB\_BUILD\_GNU\_TYPE=i486-gnu
+
+DEB\_HOST\_ARCH=hurd-i386
+
+DEB\_HOST\_ARCH\_OS=hurd
+
+DEB\_HOST\_ARCH\_CPU=i386
+
+DEB\_HOST\_GNU\_CPU=i486
+
+DEB\_HOST\_GNU\_SYSTEM=gnu
+
+DEB\_HOST\_GNU\_TYPE=i486-gnu
+
+-- [[Main/MichaelBanck]] - 14 Jan 2006
diff --git a/hurd/running/debian/DebianFAQ.mdwn b/hurd/running/debian/DebianFAQ.mdwn
new file mode 100644
index 00000000..83386c91
--- /dev/null
+++ b/hurd/running/debian/DebianFAQ.mdwn
@@ -0,0 +1,89 @@
+# <a name="Debian_GNU_Hurd_FAQ"> </a> Debian GNU/Hurd FAQ
+
+See also [[Hurd/FrequentlyAskedQuestions]] and [[DebianAfterInstall]]
+
+## <a name="df"> df </a>
+
+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.
+
+## <a name="sshd"> sshd </a>
+
+You need to disable [[PriviledgeSeperation]] in /etc/ssh/sshd\_options. Also make sure you have /dev/random, see below.
+
+## <a name="_dev_random"> /dev/random </a>
+
+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 name="Hurd_console"> Hurd console </a>
+
+Edit /etc/default/hurd-console to configure the Hurd console and enable it on bootup. See [[Hurd/HurdConsole]] for further information about the Hurd console.
+
+## <a name="swap"> swap </a>
+
+## <a name="2GB_partition_limit"> 2GB partition limit </a>
+
+The 2GB limit has been removed in Debian GNU/Hurd.
+
+## <a name="Free_memory"> Free memory </a>
+
+Run \`vmstat' to see memory and swap usage.
+
+## <a name="translators"> translators </a>
+
+## <a name="512MB_RAM_limit"> </a> 512MB RAM limit
+
+GNU Mach does not cope well with lots of memory. Newer versions of the Debian gnumach package will limit themselves to around 1GB 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.
+
+## <a name="xserver_common"> xserver-common </a>
+
+You need to run \`dpkg-reconfigure xserver-common' and select \`Anybody' for starting X as there is no way to detect console users currently.
+
+## <a name="reporting_Bugs"> reporting Bugs </a>
+
+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>
+
+## <a name="ps_hangs"> ps hangs </a>
+
+If \`ps' hangs, try \`ps -M' which might still works.
+
+## <a name="porting_packages"> porting packages </a>
+
+## <a name="debugging_glibc"> debugging glibc </a>
+
+To get debugging information for glibc, you need to install the libc0.3-dbg package. At the place 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.
+
+## <a name="debugging_translators"> debugging translators </a>
+
+In order to debug 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 gdb to the process.
+
+Is starting the translator like this really needed?
+
+## <a name="other_repositories"> other repositories </a>
+
+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.
+
+## <a name="kernel_logs"> kernel logs </a>
+
+The kernel logs are written to /dev/klog by Mach. Run "cat /dev/klog &gt; 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).
+
+## <a name="_bad_hypermeta_data_"> \`bad hypermeta data' </a>
+
+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.
+
+----
+
+Page started.
+
+-- [[Main/MichaelBanck]] - 14 Mar 2006
+
+Mentioned Hurd FAQ. reformated. -- [[Main/AaronHawley]] - 14 Mar 2006
diff --git a/hurd/running/debian/DebianIntegrationDeveloper.mdwn b/hurd/running/debian/DebianIntegrationDeveloper.mdwn
new file mode 100644
index 00000000..8b34cb7b
--- /dev/null
+++ b/hurd/running/debian/DebianIntegrationDeveloper.mdwn
@@ -0,0 +1,15 @@
+Currently, the [Debian](http://www.debian.org) Project consists of two distinct classes of people - Users and Developers. There is a [Quality Assurance](http://qa.debian.org) group that exists to try to help bridge this gap, however it is not as strong as some people would like it to be. In many ways, a DID is another name for what Debian currently classifies as QA.
+
+A Debian Integration Developer (DID) is a middle-person, someone to assist users and developers. From a [user](http://www.debian.org/support) perspective they answer, categorize and enhance bug reports with patches or Policy suggestions and generally help with user-level integration of multiple Debian software packages as installed. From a [developer](http://www.debian.org/devel/) perspective they update Debian specific package defaults and configuration systems. Upon reflection, this is also a group of folks that can be described as containing both Developer status (maintaining one package) and those who do not feel comfortable classifying themselves as developers. These groups share common goals.
+
+Besides these two perspectives, there is also a range of tasks that fall into the domain of "[Quality Assurance](http://qa.debian.org)." Tasks necessary to perform on a range of individual packages such as Policy compliance checking, debconf use, /etc/alternatives and similar debian configuration mechanisms that integrate. The Work Needed and Prospective Packages system is an important function. Questions are sometimes raised regarding the diligence or MIA status of developers, in a way, ensuring the overall quality of the debian operational infrastructure. Gathering feedback from users and developers regarding enhancements and changes to these systems. Helping to Integrate the various infrastructure groups when responding to the environment in which Debian resides in is raising the quality of the organization. Many of the tasks that exist in this grey area can be accomplished by non-packaging maintaining users if they understand how Debian and package maintenance works.
+
+The more I write and think about this area, the more clearly the concept of idealistic leadership is brought to mind. Yet keys to the success of Debian can be directly attributed to the lack of a centralized organizational structure and a strong set of negotiated policies.
+
+Software dependencies can be very complex. There is often a need for a semi-knowledgable developer (DID or QA) to understand how things work best in a coordinated manner, how best to Integrate. This is also a natural path from which to recruit new package maintainers if assistance is provided along the way. Another separate group that subscribe to a [mail list](http://lists.debian.org) and perform this extremely valuable service is [Debian-Mentors](http://lists.debian.org/debian-mentors/).
+
+Recognition for the significance of contribution is one reason to give this group of helpful people more courage and identity in helping the Debian project in a clearly defined and less daunting a way. The [devel](http://www.debian.org/devel) page has relevant links. There is a page describing [how you can help](http://www.debian.org/devel/join/), but (indicating the mentality) it's simply a link to the same page as the first step in the [new maintainer process](http://www.debian.org/devel/join/). Behind this first page is the real [new maintainer page](http://www.debian.org/devel/join/newmaint). There's also a [TODO list](http://www.debian.org/devel/todo/) but it's very very broad.
+
+Perhaps a little bit of this resides in all members of the Debian community and is an important ingredient to the project's overall success. This may be because the developers are in fact, also the users. This can be extremely demanding for new users of Debian. It does take time to come up to speed with what Debian is about, [who participates](http://www.debian.org/intro/organization) to keep it running as it does and what processes exist. The Bug Tracking System's [pseudo-package list](http://www.debian.org/Bugs/pseudo-packages) may give great insight into some processes.
+
+-- [[Main/GrantBow]] - 25 Feb 2004
diff --git a/hurd/running/debian/DebianPackages.mdwn b/hurd/running/debian/DebianPackages.mdwn
new file mode 100644
index 00000000..7e09dce0
--- /dev/null
+++ b/hurd/running/debian/DebianPackages.mdwn
@@ -0,0 +1,43 @@
+There are many different systems related to Debian that are related to the efforts. Some of these target information to/from upstream developers, some to end users. Here are some useful links.
+
+<dl>
+ <dt><a href="http://qa.debian.org/developer.php" target="_top">Developer Packages Overview</a></dt>
+ <dd> new system! </dd>
+</dl>
+
+<dl>
+ <dt><a href="http://bugs.debian.org" target="_top">Bug Tracking System</a></dt>
+ <dd> also see [[Distrib/BtsFiling]], use a URL like <nop>http://bugs.debian.org/<em>bug-number</em> or <nop>DebianBug:<em>number</em> in a topic using the [[TWiki/InterWikis]] format. </nop></nop></dd>
+</dl>
+
+<dl>
+ <dt><a href="http://packages.debian.org" target="_top">Package lookup</a></dt>
+ <dd> also use a URL like <nop>http://packages.debian.org/<em>package-name</em> or <nop>DebianPackage:<em>name</em> in a topic. </nop></nop></dd>
+</dl>
+
+<dl>
+ <dt><a href="http://packages.qa.debian.org" target="_top">Package Tracking System</a></dt>
+ <dd><nop>PTS:<em>name</em> in a topic. Email based tracking system to get notices of all package activity - used for packages that highly interest you. This is a new system for Debian and was recently <a href="http://lists.debian.org/debian-devel-announce/2002/debian-devel-announce-200201/msg00011.html" target="_top">announced</a>. </nop></dd>
+</dl>
+
+<dl>
+ <dt><a href="http://www.debian.gr.jp/~kitame/maint.cgi" target="_top">Package &amp;amp; Maintainer lookup</a></dt>
+ <dd> from Takuo Kitame </dd>
+</dl>
+
+<dl>
+ <dt><a href="http://buildd.debian.org/" target="_top">Buildd System</a></dt>
+ <dd> system to compile and upload binary packages from source automatically. </dd>
+</dl>
+
+<dl>
+ <dt><a href="http://db.debian.org/" target="_top">Maintainer LDAP</a></dt>
+ <dd> LDAP directory with the information of Debian developers. </dd>
+</dl>
+
+<dl>
+ <dt><a href="http://ftp-master.debian.org/testing/update_excuses.html" target="_top">testing "update excuses"</a></dt>
+ <dd> not needed for Hurd yet. </dd>
+</dl>
+
+-- [[Main/GrantBow]] - 15 Jan 2003
diff --git a/hurd/running/debian/DebianStatus.mdwn b/hurd/running/debian/DebianStatus.mdwn
new file mode 100644
index 00000000..71b34ae4
--- /dev/null
+++ b/hurd/running/debian/DebianStatus.mdwn
@@ -0,0 +1,12 @@
+A list of requirements for release as an official port have evolved with discussions with AJ Towns, Debian's Release Manager. The requirements include:
+
+* 85% of the archive built
+* functioning and integrated <http://buildd.debian.org> machine
+* testing participation
+* native compile everything
+* port of new [installer](http://www.debian.org/devel/debian-installer/)
+* a firewall as part of the core OS.
+
+The Debian [weekly news](http://www.debian.org/News/weekly/2004/07/) had an item on this with an [email reference](http://lists.debian.org/debian-devel/2004/debian-devel-200402/msg00615.html), but not much is said about non-Linux ports such as the Hurd, BSDs, etc.
+
+-- [[Main/GrantBow]] - 04 Mar 2004
diff --git a/hurd/running/debian/DebianTranslatorPolicy.mdwn b/hurd/running/debian/DebianTranslatorPolicy.mdwn
new file mode 100644
index 00000000..7092a761
--- /dev/null
+++ b/hurd/running/debian/DebianTranslatorPolicy.mdwn
@@ -0,0 +1,40 @@
+**_This page describes the Debian packaging policy for translators._**
+
+## <a name="Package_Naming_Scheme"> Package Naming Scheme </a>
+
+Candidates for package naming schemes (_foofs_ is a filesystem based translator, e.g. _tarfs_, _bar_ is a node based translator, e.g. _random_):
+
+* _foofs-translator_, _bar-translator_ [current favourite]
+
+* _foofs_, _bar_ [this will make searching somewhat more of a hassle and may easily conflict with already used package names]
+
+* _foofs-trans_, _bar-trans_
+
+* _hurd-translator-foofs_, _hurd-translator-bar_
+
+Do we need to destinguish between file system and node based translators?
+
+Source packages should be called whatever the tarball/cvs module says.
+
+## <a name="Where_to_Put_Files"> Where to Put Files </a>
+
+The translators should go into _/hurd_.
+
+## <a name="What_about_setting_passive_trans"> What about setting passive translators in _/servers_ or _/dev_? </a>
+
+The idea is that the package should set passive translators in its _postinst_ instructions.
+
+There may, however, be difficulties with that: it's perfectly valid to have two different _random_ translator packages installed (they won't conflict with each other as long as their file names don't clash), but which one should sit on _/dev/random_ and _/dev/urandom_? Debian's _alternatives system_ doesn't help here, because the translators may need different command line arguments.
+
+One idea is to have the _postinst_ instructions set the passive translator if there isn't already one set on the relevant node(s).
+
+## <a name="Short_Long_Description_Guideline"> Short/Long Description Guidelines </a>
+
+ [packagename]: Foo translator for [doing bar].
+ Foo is a GNU/Hurd translator which does [bar].
+
+## <a name="Miscellaneous"> Miscellaneous </a>
+
+There could / should be a meta package (or even more than one) that just depends e.g. on all installable translators, so that they'll conveniently find their way into the system by just installing that meta package.
+
+-- [[Main/MichaelBanck]] - 10 Mar 2006
diff --git a/hurd/running/debian/GNUDebianBuildProcess.mdwn b/hurd/running/debian/GNUDebianBuildProcess.mdwn
new file mode 100644
index 00000000..55a9c6aa
--- /dev/null
+++ b/hurd/running/debian/GNUDebianBuildProcess.mdwn
@@ -0,0 +1,133 @@
+components, required and somewhat related - BEFORE you have .debs
+
+### <a name="Software_States"> Software States </a>
+
+see [Debian Policy Manual](http://www.debian.org/doc/debian-policy/).
+
+* Upstream source
+* Debian Source Package
+ * Build-depends
+* Debian Binary Package
+ * Essential - boolean, default is no/unset, see Policy [ref](http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Essential)
+ * Architecture - policy [ref](http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Architecture)
+ * Section (main, contrib, non-free, non-US/main, non-US/contrib, non-US/non-free)
+ * updates, security
+ * Subsection (admin, base, comm, contrib, devel, doc, editors, electronics, embedded, games, gnome graphics, hamradio, interpreters, kde, libs, libdevel, mail, math, misc, net, news, non-US, non-free, oldlibs, otherosfs, perl, python science, shells, sound, tex, text, utils, web, x11)
+ * Priority (required, important, standard, optional, extra) policy [ref](http://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities)
+ * a particular set of packages is called the [Base System](http://www.debian.org/doc/debian-policy/ch-binary.html#s3.7)
+* Source and binary package upload example from [new maintainers guide](http://www.debian.org/doc/maint-guide/ch-build.en.html)
+ * gentoo\_0.9.12.orig.tar.gz
+ * gentoo\_0.9.12-1.dsc
+ * gentoo\_0.9.12-1.diff.gz
+ * gentoo\_0.9.12-1\_i386.deb
+ * gentoo\_0.9.12-1\_i386.changes
+
+### <a name="Groups"> Groups </a>
+
+* software author(s)
+* Debian Package Maintainers, Co-Maintainers &amp; uploaders
+* ftp-masters
+* buildd admins - It seems the two primary buildd admins are Ryan Murray and James Troup.
+* QA
+* bug-filers
+* porters for supported platforms (i386, m69k, sparc, alpha, powerpc, arm, mips, mipsel, hppa, ia64, s390)
+* porters for unreleased platforms (amd64, sh)
+* porters of non-linux platforms (hurd-i386, netbsd-i386, netbsd-alpha, freebsd-i386)
+* International translation providers
+* system administrators
+* users
+
+### <a name="Build_Debian_Archive_amp_Debian_"> Build, Debian Archive &amp; Debian Systems Software </a>
+
+* wanna-build available in the buildd [CVS](http://m68k.debian.org/buildd/getting.html)
+* buildd [CVS](http://m68k.debian.org/buildd/getting.html), [statistics](http://buildd.debian.org/stats/)
+* [quinn-diff](http://buildd.debian.org/quinn-diff/) with anon-CVS
+ * July 2002 (samosa.sh ?) hurd output [http://buildd.debian.org/quinn-diff/output/unstable/by\_priority-hurd-i386.txt](http://buildd.debian.org/quinn-diff/output/unstable/by_priority-hurd-i386.txt)
+ * email [reference](http://lists.debian.org/debian-hurd/2000/debian-hurd-200012/msg00168.html)
+* [katie](http://ftp-master.debian.org) (was dinstall), ftp-master
+ * update-excuses [output](http://ftp-master.debian.org/testing/update_excuses.html)
+* andrea, see wanna-build for source (no longer at <http://buildd.debian.org/andrea/> )
+* [madison](http://www.debian.org/doc/developers-reference/ch-resources.en.html#s-madison) from developer's reference
+* [fakeroot](http://packages.qa.debian.org/fakeroot)
+* [sbuild](http://packages.qa.debian.org/sbuild)
+* [pbuilder](http://packages.qa.debian.org/pbuilder)
+* turtle [reference](http://lists.debian.org/debian-hurd/2001/debian-hurd-200103/msg00328.html)
+* [Package Tracking System](http://lists.debian.org/debian-devel-announce/2002/debian-devel-announce-200201/msg00011.html) (PTS)
+* [Bug Tracking System](http://bugs.debian.org) (BTS)
+ * Release Critical mailing to <debian-devel-announce@lists.debianNOSPAM.org>
+* [Work Needed and Prospective Packages](http://www.debian.org/devel/wnpp/) (WNPP)
+* [Lintian](http://lintian.debian.org/)
+* [apt-proxy](http://packages.qa.debian.org/apt-proxy) or [apt-cacher](http://packages.qa.debian.org/apt-cacher)
+* [reportbug](http://packages.qa.debian.org/reportbug)
+* [dpkg](http://packages.qa.debian.org/dpkg)
+* [apt](http://packages.qa.debian.org/apt)
+* grep-dctrl
+* dpkg-awk
+
+also see appendix A [Overview of Debian Maintainer Tools](http://www.debian.org/doc/developers-reference/ap-tools.en.html) in the Developer's Reference.
+
+### <a name="Input_amp_Output_Files_Formats"> Input &amp; Output Files/Formats </a>
+
+* sources file from an archive
+* packages file from an archive
+* log from build process
+* lintian report
+* debcheck report
+* upstream related files (tar.gz, dsc [[SampleDscFile]])
+* source deb
+* binary deb
+* /etc/apt/sources.list file
+* bug reports
+* web pages
+* location to upload files for incoming: ftp-master.debian.org:/org/ftp.debian.org/incoming/ or via ftp to /pub/UploadQueue/
+
+<table border="1" cellpadding="1" cellspacing="0">
+ <tr>
+ <th bgcolor="#99CCCC"><strong>Inputs</strong></th>
+ <th bgcolor="#99CCCC"><strong>1</strong></th>
+ <th bgcolor="#99CCCC"><strong>2</strong></th>
+ <th bgcolor="#99CCCC"><strong>3</strong></th>
+ <th bgcolor="#99CCCC"><strong>4</strong></th>
+ </tr>
+ <tr>
+ <td>   </td>
+ <td> X </td>
+ <td>   </td>
+ <td>   </td>
+ <td>   </td>
+ <th bgcolor="#99CCCC"><strong>1</strong></th>
+ </tr>
+ <tr>
+ <td>   </td>
+ <td>   </td>
+ <td> X </td>
+ <td>   </td>
+ <td>   </td>
+ <th bgcolor="#99CCCC"><strong>2</strong></th>
+ </tr>
+ <tr>
+ <td>   </td>
+ <td>   </td>
+ <td>   </td>
+ <td> X </td>
+ <td>   </td>
+ <th bgcolor="#99CCCC"><strong>3</strong></th>
+ </tr>
+ <tr>
+ <td>   </td>
+ <td>   </td>
+ <td>   </td>
+ <td>   </td>
+ <td> X </td>
+ <th bgcolor="#99CCCC"><strong>4</strong></th>
+ </tr>
+ <tr>
+ <td>   </td>
+ <td colspan="4">   </td>
+ <th align="right" bgcolor="#99CCCC"><strong>Outputs</strong></th>
+ </tr>
+</table>
+
+also see [[GNUDebianPackages]] for information on what you can do AFTER you have .debs.
+
+-- [[Main/GrantBow]] - 03 March 2004
diff --git a/hurd/running/debian/GNUDebianPackages.mdwn b/hurd/running/debian/GNUDebianPackages.mdwn
new file mode 100644
index 00000000..de1798ad
--- /dev/null
+++ b/hurd/running/debian/GNUDebianPackages.mdwn
@@ -0,0 +1,103 @@
+tools for AFTER you have .debs
+
+### <a name="Software_States"> Software States </a>
+
+* Debian Source Package
+* Debian Binary Package
+ * Component (main, contrib, non-free, non-US, updates, security)
+ * Priority
+ * Section
+ * installed state - installed, half-installed, not-installed, unpacked, half-configured, config-files
+
+### <a name="Groups"> Groups </a>
+
+* bug-filers
+* users
+
+* Debian Package Maintainers, Co-Maintainers &amp; uploaders
+* ftp-masters
+* QA
+* porters for supported platforms (i386, m69k, sparc, alpha, powerpc, arm, mips, mipsel, hppa, ia64, s390)
+* porters for unreleased platforms (amd64, sh)
+* porters of non-linux platforms (hurd-i386, netbsd-i386, netbsd-alpha, freebsd-i386)
+* International translation providers
+* system administrators
+
+### <a name="Software_amp_Systems"> Software &amp; Systems </a>
+
+* dselect
+* wajig
+* grep-dctrl
+* dpkg-awk
+* [reportbug](http://packages.qa.debian.org/reportbug)
+* [dpkg](http://packages.qa.debian.org/dpkg)
+* [apt](http://packages.qa.debian.org/apt)
+
+* [apt-proxy](http://packages.qa.debian.org/apt-proxy) or [apt-cacher](http://packages.qa.debian.org/apt-cacher)
+* [Package Tracking System](http://lists.debian.org/debian-devel-announce/2002/debian-devel-announce-200201/msg00011.html) (PTS)
+* [Bug Tracking System](http://bugs.debian.org) (BTS)
+ * Release Critical mailing to <debian-devel-announce@lists.debianNOSPAM.org>
+* [Work Needed and Prospective Packages](http://www.debian.org/devel/wnpp/) (WNPP)
+* [katie](http://ftp-master.debian.org) (was dinstall), ftp-master
+ * update-excuses [output](http://ftp-master.debian.org/testing/update_excuses.html)
+
+### <a name="Input_amp_Output_Files_Formats"> Input &amp; Output Files/Formats </a>
+
+* sources file from an archive
+* packages file from an archive
+* source deb
+* binary deb
+* /etc/apt/sources.list file
+* bug reports
+* web pages
+
+<table border="1" cellpadding="1" cellspacing="0">
+ <tr>
+ <th bgcolor="#99CCCC"><strong>Inputs</strong></th>
+ <th bgcolor="#99CCCC"><strong>1</strong></th>
+ <th bgcolor="#99CCCC"><strong>2</strong></th>
+ <th bgcolor="#99CCCC"><strong>3</strong></th>
+ <th bgcolor="#99CCCC"><strong>4</strong></th>
+ </tr>
+ <tr>
+ <td>   </td>
+ <td> X </td>
+ <td>   </td>
+ <td>   </td>
+ <td>   </td>
+ <th bgcolor="#99CCCC"><strong>1</strong></th>
+ </tr>
+ <tr>
+ <td>   </td>
+ <td>   </td>
+ <td> X </td>
+ <td>   </td>
+ <td>   </td>
+ <th bgcolor="#99CCCC"><strong>2</strong></th>
+ </tr>
+ <tr>
+ <td>   </td>
+ <td>   </td>
+ <td>   </td>
+ <td> X </td>
+ <td>   </td>
+ <th bgcolor="#99CCCC"><strong>3</strong></th>
+ </tr>
+ <tr>
+ <td>   </td>
+ <td>   </td>
+ <td>   </td>
+ <td>   </td>
+ <td> X </td>
+ <th bgcolor="#99CCCC"><strong>4</strong></th>
+ </tr>
+ <tr>
+ <td>   </td>
+ <td colspan="4">   </td>
+ <th align="right" bgcolor="#99CCCC"><strong>Outputs</strong></th>
+ </tr>
+</table>
+
+also see [[GNUDebianBuildProcess]] for tools BEFORE you have .debs
+
+-- [[Main/GrantBow]] - 03 March 2004
diff --git a/hurd/running/debian/GnuDebianRelationship.mdwn b/hurd/running/debian/GnuDebianRelationship.mdwn
new file mode 100644
index 00000000..ede808c8
--- /dev/null
+++ b/hurd/running/debian/GnuDebianRelationship.mdwn
@@ -0,0 +1,32 @@
+I have hesitated in starting this page due to the sensitive nature of this relationship and the (May 2002) flame war on debian-devel and other mail lists. I believe that rather than guessing about relevant points of the discussion, the facts should be presented in a clear manner. I hope the facts presented here are accurate and precise enough to be helpful in the ongoing discussion. I have not read all messages in all relevant threads.
+
+This is a work in progress. Please email me directly if you have comments or suggestions.
+
+* Debian Advantages of Hurd [[Distrib/PortingIssues]] 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
+ * Perceived zealous GNU and FSF promotion.
+
+* Hurd Port Advantages of Debian
+ * Glibc use.
+ * Gcc use.
+ * Debian reputation
+ * Debian mirror infrastructure - ftp, both official and private. Includes bandwidth, hardware, maintenance efforts.
+ * Debian www infrastructure - many languages supported, mirrors.
+ * [Debian developer machine](http://db.debian.org/machines.cgi) infrastructure, many architectures, compile farm, buildd software.
+ * Many Debian Developers maintaining software packages, bug reports, porting efforts.
+ * Bug tracking system - BTS infrastructure
+ * Package infrastructure architecture capabilities are improving. dpkg update in progress.
+
+* Hurd Port Disadvantages of Debian
+ * Possible DFSG vs. Free Software compatibility issues.
+ * BTS Severity practices/use for unreleased ports issues.
+ * Debian non-parallel development issues.
+ * [Architecture handling](http://master.debian.org/~brinkmd/arch-handling.txt) issues.
+ * Linux base history with assumed Linux assumptions.
+ * Possible incompatibility of third party standards compliance issues. i.e. LSB, FHS, GNU Coding Standards
+ * Perceived zealous Debian promotion.
+
+-- [[Main/GrantBow]] - 22 May 2002
diff --git a/hurd/running/debian/MediaPressKitDiscuss.mdwn b/hurd/running/debian/MediaPressKitDiscuss.mdwn
new file mode 100644
index 00000000..e8b1cfff
--- /dev/null
+++ b/hurd/running/debian/MediaPressKitDiscuss.mdwn
@@ -0,0 +1,78 @@
+%TOC%
+
+# <a name="Media_Press_Kit"> Media / Press Kit </a>
+
+## <a name="Problem"> Problem </a>
+
+Debian awareness not as high as other Linux distributions. Some people don't take Debian seriously because of it's organizational structure. Target audience lacks education. Most current Debian users are rather skilled and sometimes PERCIEVED as arrogant. "Non-technical" participation is not fully recognized.
+
+## <a name="Target_Audience"> Target Audience </a>
+
+* non-users without any experience of Debian.
+ * Technically-minded people will often be convinced already of why they should use Debian
+* casual users who might be interested in Debian
+* ammunition for those who are campaigning to have Debian used
+ * With our backgrounds, we could emphasize that we can provide material in the langauge that decision-makers can understand.
+
+## <a name="Debian_Resources"> Debian Resources </a>
+
+It's important to identify and work with the existing infrastructures for this type of thing. More research about who is out there that is interested in press relations needs to be done before showing the work completed to others.
+
+* [Contacts](http://www.debian.org/contact) page includes <press@debianNOSPAM.org> but I don't know who's behind that alias. I'll send an email right now to find out.
+* [Events team](http://www.debian.org/events/)
+ * Mail list [debian-events-na](http://lists.debian.org/debian-events-na)
+ * Mail list [debian-events-eu](http://lists.debian.org/debian-events-eu)
+* Debian Weekly News [DWN](http://www.debian.org/News/weekly/) and their mail list [debian-news](http://lists.debian.org/debian-news)
+* [debian-announce](http://lists.debian.org/debian-announce) and their [News page](http://www.debian.org/News/)
+* [DebianPlanet.org](http://www.debianplanet.org)
+* Others?
+
+## <a name="Solution_Goal"> Solution / Goal </a>
+
+* persuade people to use Debian
+* give target audience realistic expectations of running GNU/Linux
+ * skills expected
+ * differences from what they already know
+* educate target audience about benefits and advantages of Debian.
+* give target audience realistic expectations of running Debian
+ * skills expected
+ * differences from what they already know
+* background materials, "marketing collateral"
+
+You have proposed two documents that sound on target to me.
+
+<dl>
+ <dt>[[WhyDebian]]</dt>
+ <dd> A bullet list meant to give a quick answer. </dd>
+ <dt>[[DebianProductSheet]]</dt>
+ <dd> includes interesting facts </dd>
+</dl>
+
+The third is a collection of success stories which is more of a process than a clearly defined deliverable in itself. That sounds wonderful.
+
+I think another active process for tracking recent news (if it doesn't already exist) should also be useful for similar purposes.
+
+## <a name="Result"> Result </a>
+
+* two documents: Why Debian? &amp; Debian Product Sheet
+ * these will be documents of a Debian media/press kit
+ * processes to keep these documents updated over time. For example, every release.
+ * beginning of a central repository for info about Debian
+* a web repsitory for success stories
+ * some kind of link or integration with current website.
+* increased appreciation by official Debian organization for non-technical participation.
+* increased non-technical Debian user involvement
+* increased adoption of Debian GNU/Linux by users.
+* consideration for using SPI funds for hiring part-time PR resources
+
+-- [[Main/GrantBow]] - 13 Jan 2003
+
+[This article](http://www.theage.com.au/articles/2003/01/08/1041989994382.html) was in the [most recent](http://www.debian.org/News/weekly/2003/02/) version of the [Debian Weekly News](http://www.debian.org/News/weekly/).
+
+-- [[Main/GrantBow]] - 15 Jan 2003
+
+Here are some interesting urls from [this issue](http://www.debian.org/News/weekly/2003/03/) of the Debian Weekly news:
+
+**Debian Presentations.** Wolfgang Borgert was [looking](http://lists.debian.org/debian-devel-0301/msg00991.html) for a set of slides on dpkg, apt-get and debconf. Javier Fern�ndez-Sanguino Pe�a [intends](http://lists.debian.org/debian-devel-0301/msg01022.html) to provide a 'presentations' section in the [Debian Documentation Project](http://cvs.debian.org/ddp/?cvsroot=debian-doc) (DDP) and has already created an [archive](http://dat.etsit.upm.es/~jfs/debian/www/ddp/slides/) of slides. Whilst the Debian web site does link to [talks](http://www.debian.org/events/talks) given by developers and some [sample slides](http://www.debian.org/events/materials/slides/), it is difficult to gather this information and publish it in a homogeneous way. Talks should be reported to <events@debianNOSPAM.org> and forwarded to him.
+
+-- [[Main/GrantBow]] - 22 Jan 2003
diff --git a/hurd/running/debian/PackageTroubleshooting.mdwn b/hurd/running/debian/PackageTroubleshooting.mdwn
new file mode 100644
index 00000000..fe8b6df4
--- /dev/null
+++ b/hurd/running/debian/PackageTroubleshooting.mdwn
@@ -0,0 +1,52 @@
+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:
+
+ #!/bin/bash
+ 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
+
+## <a name="SSH_not_working"> </a> SSH not working
+
+You must set up the [[RandomDevice]] 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.
+
+## <a name="Borked_fonts_on_GTK_app"> </a> Borked fonts on GTK app
+
+This is related to issues in Pango.
+
+* Install pango-dev package
+* Run as root:
+
+ pango-querymodules > /etc/pango/pango.modules
+
+## <a name="Installing_a_package_seems_to_ha"> Installing a package seems to hang forever </a>
+
+There are various reasons for this.
+
+* If interrupting the process with ctrl-c gives a line like that:
+
+ File "/usr/lib/python2.4/os.py", line 723, in urandom
+ bytes += read(_urandomfd, n - len(bytes))
+ KeyboardInterrupt
+
+it is the random device fault. Follow the [[RandomDevice]] guide. If you already did, try _anyway_ to detach and reattach the translators.
+
+## <a name="Cannot_compile_even_trivial_C_pr"> Cannot compile even trivial C programs </a>
+
+Check to have installed the following:
+
+ apt-get install build-essential
+ apt-get install libc-dev
diff --git a/hurd/running/debian/SampleDscFile.mdwn b/hurd/running/debian/SampleDscFile.mdwn
new file mode 100644
index 00000000..d3b7b9f8
--- /dev/null
+++ b/hurd/running/debian/SampleDscFile.mdwn
@@ -0,0 +1,24 @@
+ -----BEGIN PGP SIGNED MESSAGE-----
+ Hash: SHA1
+
+ Format: 1.0
+ Source: glibc
+ Version: 2.3.2.ds1-11
+ Binary: libc6, libc6-s390x, locales, libc0.3-prof, libc6.1-dev, libc6-i686, libc1-pic, libc6.1-dbg, glibc-doc, libc6-dev-sparc64, libc0.3-dbg, libc6.1-pic, libc6-dbg, libc0.3, libc0.3-pic, libc6.1-prof, libc6.1, libc6-dev-s390x, libc1, libc0.3-dev, libc6-sparcv9, nscd, libc1-dev, libc6-pic, libc6-prof, libc1-prof, libc-udeb, libc6-sparc64, libc6-dev, libc1-dbg
+ Maintainer: GNU Libc Maintainers
+ Architecture: any
+ Standards-Version: 3.6.1.0
+ Build-Depends: gettext (>= 0.10.37-1), make (>= 3.80-1), dpkg-dev (>= 1.4.1.5), debianutils (>= 1.13.1), tar (>= 1.13.11), bzip2, texinfo (>= 4.0), linux-kernel-headers (>= 2.5.999-test7-bk-9) [!hurd-i386], mig (>= 1.3-2) [hurd-i386], hurd-dev (>= 20020608-1) [hurd-i386], gnumach-dev [hurd-i386], texi2html, file, gcc-3.3, autoconf, binutils (>= 2.14.90.0.5) [!s390], binutils (>= 2.13.90.0.4-1) [s390], sed (>= 4.0.5-4), gawk, debhelper (>= 4.0.0)
+ Build-Depends-Indep: perl, po-debconf
+ Uploaders: Ben Collins , GOTO Masanori , Philip Blundell , Jeff Bailey , Daniel Jacobowitz
+ Files:
+ b982bf6ad7ebc8622d3b81d51c44b78a 13246448 glibc_2.3.2.ds1.orig.tar.gz
+ 2951fde13e9ba21d70d8c7e580849730 1997696 glibc_2.3.2.ds1-11.diff.gz
+
+ -----BEGIN PGP SIGNATURE-----
+ Version: GnuPG v1.2.3 (GNU/Linux)
+
+ iD8DBQFADZsWbgOPXuCjg3cRAg9LAJ9r3ioJNdzloaM4qQu3FJj2R3y7pQCeNPD+
+ i03WJeMdyAhKjHGM2sRqWVk=
+ =37je
+ -----END PGP SIGNATURE-----
diff --git a/hurd/running/debian/SoftwareLicensing.mdwn b/hurd/running/debian/SoftwareLicensing.mdwn
new file mode 100644
index 00000000..e236fea1
--- /dev/null
+++ b/hurd/running/debian/SoftwareLicensing.mdwn
@@ -0,0 +1,116 @@
+There are differences betwen the [Debian Free Software Guidelines](http://www.debian.org/social_contract#guidelines) (DFSG) and [Free Software](http://www.fsf.org/philosophy/free-sw.html) as defined by the Free Software Foundation. The FSF's GNU project is the sponsor of the GNU/Hurd project. Debian GNU/Hurd is a "port" or distribution of this software. I have not yet performed a comparison between the list of acceptable DFSG licenses (if a list exists) and the acceptable Free Software [license list](http://www.gnu.org/licenses/license-list.html). (Perhaps not directly related but for reference, here's the Open Source [license list](http://www.opensource.org/licenses/index.html))
+
+What will this consist of? In the end the result will need to be simply a list of packages with their license marked next to them. This will be relatively simple for those packages that use a standard license. Software that has it's own custom license will need to be categorized.
+
+I am thinking of ways to automatically check the licenses and to get lists of the various "Priority:" packages. I thought this list of package names would be easy to obtain. The first step is getting the list of packages. This is possible by parsing /var/lib/dpkg/available, using dpkg or using apt-cache.
+
+The next step is checking the licenses of the packages. There is no dpkg package field available for license. A script that checks licenses will involve using "apt-get source" to check the COPYING and/or similar files in each package.
+
+-- [[Main/GrantBow]] - 5 Oct 2002
+
+I used the following command on an old Hurd machine to get the 22 packages with Essential in their description. I've listed them and put them in a table at the end of this topic.
+
+ sed -e '/./{H;$!d;}' -e 'x;/Essential\:\ yes/!d' /var/lib/dpkg/status | egrep ^Package | sort
+
+base-files base-passwd bash bsdutils debianutils diff dpkg e2fsprogs fileutils findutils grep gzip hostname hurd ncurses-base ncurses-bin perl-base sed shellutils tar textutils util-linux
+
+Using `base` instead of `Essential\:\ yes` above I find 64 additional packages.
+
+adduser alsa-base apt autoconf2.13 bug cpp-3.0 cvs debconf debconf-utils debhelper debiandoc-sgml debian-policy developers-reference exim fetchmail-common g++-3.0 gcc-3.0 gcc-3.0-base gettext gettext-base gnumach groff groff-base inetutils libc0.3 libc0.3-dev libdb2 libdb2++ libdb2-dev libdb2++-dev libdb2-util libdb3 libgdbmg1 libncurses5 libnet-perl libpam0g libpam-runtime libperl5.6 libpopt0 libpopt-dev libreadline4 libstdc++3 libstdc++3-dev libwrap0 libxaw7 man-db mawk mutt netbase passwd perl python python2.1 screen sgmltools-lite slang1 ssh tcpd texinfo xfree86-common xlibs xserver-common xterm xutils
+
+-- [[Main/GrantBow]] - 11 Jan 2003
+
+<table border="1" cellpadding="1" cellspacing="0">
+ <tr>
+ <td> Name </td>
+ <td> Compatible License? </td>
+ </tr>
+ <tr>
+ <td> base-files </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> base-passwd </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> bash </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> bsdutils </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> debianutils </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> diff </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> dpkg </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> e2fsprogs </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> fileutils </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> findutils </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> grep </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> gzip </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> hostname </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> hurd </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> ncurses-base </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> ncurses-bin </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> perl-base </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> sed </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> shellutils </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> tar </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> textutils </td>
+ <td>   </td>
+ </tr>
+ <tr>
+ <td> util-linux </td>
+ <td>   </td>
+ </tr>
+</table>
diff --git a/hurd/running/debian/logo.png b/hurd/running/debian/logo.png
new file mode 100644
index 00000000..068d9584
--- /dev/null
+++ b/hurd/running/debian/logo.png
Binary files differ