diff options
| author | Thomas Schwinge <tschwinge@gnu.org> | 2007-09-07 22:15:28 +0200 |
|---|---|---|
| committer | Thomas Schwinge <tschwinge@gnu.org> | 2007-09-07 22:15:28 +0200 |
| commit | 7030f8b48c7a2a3d8f36cb0dd2996059a585232a (patch) | |
| tree | e38c7d63b9b5a4713cc3ee650cdc2ff09aad3275 | |
| parent | b48377c0de034f28d00b31e7ab7ba93369201a2b (diff) | |
Reintegrate another bunch of pages and apply clean-ups.
28 files changed, 420 insertions, 314 deletions
diff --git a/Hurd/BuildingHurd.mdwn b/Hurd/BuildingHurd.mdwn index a7cdfb38..03c0f8de 100644 --- a/Hurd/BuildingHurd.mdwn +++ b/Hurd/BuildingHurd.mdwn @@ -14,7 +14,7 @@ You can chose between getting the [sources from the developers's RCS](http://www $ apt-get source hurd -Please see [[Distrib/DebianFAQ]] before using _apt-get source_. +Please see the Debian [[running/debian/FAQ]] before using _apt-get source_. The unpacked source tree is around 20 MiB, and the build tree (configured with _--disable-profile_) is around 100 MiB. diff --git a/Hurd/CrossHurd.mdwn b/Hurd/CrossHurd.mdwn index e84ce1e7..d33d2a00 100644 --- a/Hurd/CrossHurd.mdwn +++ b/Hurd/CrossHurd.mdwn @@ -84,7 +84,7 @@ Finally, a complete bootstrapped GNU system. Now, do the old Debian thing of dancing with dselect for a couple of hours. -Reboot and start the new [[HurdConsole]] +Reboot and start the new [[Console]] login root @@ -95,5 +95,5 @@ Move around just like in Linux console, but with persistent scroll-back buffers ## <a name="References"> References </a> * [[InstallNotes]] -* [[GetNetworkRunning]] -* [[HurdConsole]] +* [[Network]] +* [[Console]] diff --git a/Hurd/DebianX.mdwn b/Hurd/DebianX.mdwn index 65b8b45e..00692ca8 100644 --- a/Hurd/DebianX.mdwn +++ b/Hurd/DebianX.mdwn @@ -10,7 +10,7 @@ Obviously this text is taken from the page <http://hurd.gnufans.org/bin/view/Hur ### <a name="Mouse_amp_Keyboard"> Mouse & Keyboard </a> -See [[HurdConsole]] for more details. +See [[console]] for more details. You should instruct the Hurd console to repeat keyboard events to `/dev/cons/kbd`, and mouse events to `/dev/cons/mouse`: diff --git a/Hurd/DebianXorg.mdwn b/Hurd/DebianXorg.mdwn index 9667163e..26e990fb 100644 --- a/Hurd/DebianXorg.mdwn +++ b/Hurd/DebianXorg.mdwn @@ -10,7 +10,7 @@ Obviously this text is taken from the page <http://hurd.gnufans.org/bin/view/Hur ### <a name="Mouse_amp_Keyboard"> Mouse & Keyboard </a> -See [[HurdConsole]] for more details. +See [[console]] for more details. You should instruct the Hurd console to repeat keyboard events to `/dev/cons/kbd`, and mouse events to `/dev/cons/mouse`: diff --git a/Hurd/GetNetworkRunning.mdwn b/Hurd/GetNetworkRunning.mdwn deleted file mode 100644 index 1b8fa1b3..00000000 --- a/Hurd/GetNetworkRunning.mdwn +++ /dev/null @@ -1,33 +0,0 @@ -## <a name="How_to_setup_networking_in_the_H"> How to setup networking in the Hurd </a> - -First, make sure that Mach recognizes your hardware. If it doesn't, you have to recompile it in most cases. [ADD LINK TO INFO ON THIS] - -### <a name="The_PFINET_translator"> </a> The PFINET translator - -To configure the network, the `pfinet` (Protocol Family Internet) translator must be configured. This is done using the `settrans` command to attach a translator to a given file system node. When programs access the node by, for example, sending an RPC, the Hurd will transparently start the server to handle the request. - - # settrans -fgap /servers/socket/2 /hurd/pfinet -i eth0 \ - -a 192.168.0.50 -g 192.168.0.1 -m 255.255.255.0 - -Here, `settrans` is passed several options: - -* `fg`, force any existing translator to go away. -* `ap`, make both active and passive translators. - -The active translator means that the operating system both starts the translator immediately and passinve means that the settings are saved in the file system node. The former also means that any error messages are sent to `stderr`. - -The argument `/server/socket/2` is the node that the translator is to be attached to. This is followed by the translator program to run and any arguments to give it. - --a, -g and -m are, quite obviously, the IP address, the gateway and netmask. - -Help on settrans can be obtained by passing it the `--help` option. Help on a specific translator can be gotten by invoking it from the command line with the same argument, e.g.: - - # /hurd/pfinet --help - -As there can be a lot of output, consider piping this through a pager. - -Finally copy over your `/etc/resolv.conf` from GNU/Linux to allow your DNS to resolve correctly. - --- [[Main/GrantBow]] - 26 Oct 2002 - -Text formatting. -- [[Main/OgnyanKulev]] - 19 Sep 2004 diff --git a/Hurd/InstallNotes.mdwn b/Hurd/InstallNotes.mdwn index a627ca55..acacc868 100644 --- a/Hurd/InstallNotes.mdwn +++ b/Hurd/InstallNotes.mdwn @@ -192,7 +192,7 @@ To mount this from a GNU box: ## <a name="7_Configuration_Making_the_Syste"> 7. Configuration - Making the System Usable </a> -**NOTE**: _If you are using the Debian distribution of Hurd, you also **want** to read_ **_[[Distrib/DebianAfterInstall]]_** +**NOTE**: _If you are using the Debian distribution of Hurd, you also **want** to read_ **_Debian [[running/debian/after_install]]_** * After you install, you'll want to do several _important_ things: * Run `passwd` to give the root user a password. By default, root does not have one. @@ -201,7 +201,7 @@ To mount this from a GNU box: * Since the Hurd does not use `ld.so.conf`, you will want to specify where the X Window System keeps its libraries. Do this by adding the following line to your `/etc/profile`: <br />`export LD_LIBRARY_PATH='/lib:/usr/X11R6/lib'` * run `/etc/cron.daily/find` to allow `locate` to function. -* [[GetNetworkRunning]] +* [[Network]] * Hopefully Mach will recognize your hardware. If it doesn't you have to recompile in most cases. * copy over your `/etc/resolv.conf` from GNU/Linux to allow your DNS to resolve correctly. diff --git a/Hurd/KnownHurdLimits.mdwn b/Hurd/KnownHurdLimits.mdwn index 0da12878..51d66b50 100644 --- a/Hurd/KnownHurdLimits.mdwn +++ b/Hurd/KnownHurdLimits.mdwn @@ -7,7 +7,7 @@ * Entropy. Mach does not yet gather entropy and thus there are no /dev/random and /dev/urandom nodes. There are needed by OpenSSH. - * In progress, see [[RandomDevice]] + * In progress, see [[translator/random]] * No DHCP client * promising information [Jan 2005](http://lists.gnu.org/archive/html/bug-hurd/2005-01/msg00025.html), needs an update diff --git a/Hurd/RandomDevice.mdwn b/Hurd/RandomDevice.mdwn deleted file mode 100644 index 34083530..00000000 --- a/Hurd/RandomDevice.mdwn +++ /dev/null @@ -1,41 +0,0 @@ -## <a name="_http_savannah_gnu_org_task_5130"> </a> [Savannah task #5130: random translator](http://savannah.gnu.org/task/?5130) - -See the attached [[ATTACHURLmboxbz2]] containing all the emails concerning this topic which I was able to gather from public archives. - -## <a name="Description"> Description </a> - -Sources of entropy are for example disk access latencies or keystroke patterns or behavior on networks. This suggests that for implementing a random translator a kernel part is needed as well, to gather that entropy. That kernel part would then export the gathered entropy via a kernel device, named perhaps _entropy_. TODO. - -## <a name="Setup_pseudo_random_devices"> Setup pseudo random devices </a> - -Stuck getting SSH to work? You need a pseudo random generator (PRG). - -There are several solutions to the lack of _/dev/random_ and _/dev/urandom_, but they are not yet in the default installation. - -* Marcus' work can be downloaded at [random.tar.gz](ftp://alpha.gnu.org/gnu/hurd/contrib/marcus/random.tar.gz). (Identical to <http://kilobug.free.fr/hurd/random-64.tar.gz>?) - * [A patch](http://mail.gnu.org/pipermail/bug-hurd/2002-August/010248.html) that was probably already incorporated from August 14, 2002. - * Clemmitt Sigler [reported success](http://lists.gnu.org/archive/html/help-hurd/2002-10/msg00076.html) October 11, 2002 and Marcus [described some](http://lists.gnu.org/archive/html/help-hurd/2002-10/msg00081.html) of the internals. - -* [Entropy Gathering Daemon](http://egd.sourceforge.net/). - * [request for packaging](http://bugs.debian.org/145498). - -* [OSKit Entropy Patch](http://lists.gnu.org/archive/html/bug-hurd/2003-01/msg00000.html) from Derek Davies - Jan 2003. - * See also [this page](http://www.ddavies.net/oskit-entropy/). - * Note that this patch can (and should) be used with this [OSKit NIC patch](ftp://flux.cs.utah.edu/flux/oskit/mail/html/oskit-users/msg01570.html). - -* [Sune Kirkeby's incomplete port of the Linux /dev/\{,u\}random device driver](http://ibofobi.dk/stuff/hurd-entropy/) - * [The files](http://download.ibofobi.dk/hurd-entropy/), including a [patch for GNU Mach](http://download.ibofobi.dk/hurd-entropy/gnumach-entropy.diff.bz2). - ----- - -## <a name="Setup_tips"> Setup tips </a> - -Here are some tips on how to actually setup the two random devices using Kilobugs' [random-64 server](http://kilobug.free.fr/hurd/random-64.tar.gz). His tarball is a complete Hurd server including a pre-built binary - so you don't need GCC or magic fingers for this! :) - -After untaring the package you copy the random binary to the /hurd directory. Then you setup the translators for random and urandom. - - # 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 diff --git a/Hurd/Xfree86.mdwn b/Hurd/Xfree86.mdwn index 55e9fc48..617508e5 100644 --- a/Hurd/Xfree86.mdwn +++ b/Hurd/Xfree86.mdwn @@ -8,7 +8,7 @@ This is a brief helper on how to setup X-Window on GNU. ### <a name="Mouse_amp_Keyboard"> Mouse & Keyboard </a> -See [[HurdConsole]] for more details. +See [[console]] for more details. First, set up the keyboard translator. Using `/hurd/kbd` and `/hurd/mouse` is not supported. You should instruct Hurd console to repeat keyboard events to `/dev/cons/kbd`, and mouse events to `/dev/cons/mouse`: @@ -33,16 +33,14 @@ # Using * [[Running]] -* [[Distrib]] - Distributions +* [[running/Distrib]] -- Distributions * [[Public_Hurd_Boxen]] * [[Neighborhurd]]s and [[Subhurd]]s ## Common Problems -* [[HurdConsole]] -* [[Xfree86]] -* [[DebianX]] -* [[DebianXorg]] +* [[Console]] +* [[Xfree86]] -- [[DebianX]] -- [[DebianXorg]] * [[GNUstep]] * [[CrossCompiling]] * [[XattrHurd]]: Setting translators under GNU/Linux diff --git a/Hurd/HurdConsole.mdwn b/hurd/console.mdwn index 5ce57008..5ce57008 100644 --- a/Hurd/HurdConsole.mdwn +++ b/hurd/console.mdwn diff --git a/hurd/faq.mdwn b/hurd/faq.mdwn index 0bcb4e79..3f0cc7e5 100644 --- a/hurd/faq.mdwn +++ b/hurd/faq.mdwn @@ -13,7 +13,7 @@ If you still have problems, do not hesitate to make use of the [[MailingLists]] * **_Where are the virtual consoles I use when running GNU/Linux?_** * You need to [use screen](http://www.gnu.org/software/hurd/faq.en.html#q4-6) instead, also available when running GNU/Linux. - * The [new console](http://lists.debian.org/debian-hurd/2002/debian-hurd-200209/msg00054.html) by Marcus Brinkmann could also be used. It supports the Alt-Fn keys for switching like in GNU/Linux. NOTE: that message has an error in the configuration steps, it says `/dev/vts` when it means `/dev/vcs`. A more up-to-date howto is [[HurdConsole]]. + * The [new console](http://lists.debian.org/debian-hurd/2002/debian-hurd-200209/msg00054.html) by Marcus Brinkmann could also be used. It supports the Alt-Fn keys for switching like in GNU/Linux. NOTE: that message has an error in the configuration steps, it says `/dev/vts` when it means `/dev/vcs`. A more up-to-date howto is [[console]]. * **_What is a translator?_** * The official FAQ [answers](http://www.gnu.org/software/hurd/faq.en.html#q4-2) this question by a reference to [hurd-doc-translator](http://www.debian.org/ports/hurd/hurd-doc-translator). diff --git a/hurd/network.mdwn b/hurd/network.mdwn new file mode 100644 index 00000000..5786b01c --- /dev/null +++ b/hurd/network.mdwn @@ -0,0 +1,43 @@ +How to setup networking in the Hurd. + +First, make sure that Mach recognizes your hardware. <!-- If it doesn't, you can +to recompile it in most cases. [ADD LINK TO INFO ON THIS] --> + +# The `pfinet` Translator + +To configure the network, the `pfinet` (*Protocol Family Internet*) translator +must be configured. This is done using the `settrans` command to attach a +translator to a given file system node. When programs access the node by, for +example, sending an RPC, the Hurd will transparently start the server to handle +the request. + + # settrans -fgap /servers/socket/2 /hurd/pfinet -i eth0 \ + -a 192.168.0.50 -g 192.168.0.1 -m 255.255.255.0 + +Here, `settrans` is passed several options: + +* `fg`, force any existing translator to go away. +* `ap`, make both active and passive translators. + +The active translator means that the operating system both starts the +translator immediately and passinve means that the settings are saved in the +file system node. The former also means that any error messages are sent to +`stderr`. + +The argument `/server/socket/2` is the node that the translator is to be +attached to. This is followed by the translator program to run and any +arguments to give it. + +`-a`, `-g` and `-m` are, quite obviously, the IP address, the gateway and +netmask. + +Help on settrans can be obtained by passing it the `--help` option. Help on a +specific translator can be gotten by invoking it from the command line with the +same argument, e.g.: + + # /hurd/pfinet --help + +As there can be a lot of output, consider piping this through a pager. + +Finally copy over your `/etc/resolv.conf` from GNU/Linux to allow your DNS to +resolve correctly. diff --git a/hurd/running/debian.mdwn b/hurd/running/debian.mdwn index db36ec25..2e5d80c6 100644 --- a/hurd/running/debian.mdwn +++ b/hurd/running/debian.mdwn @@ -1,10 +1,11 @@ [[img logo.png]] -- [[DebianFAQ]] -- Frequently Asked Questions -- [[DebianAfterInstall]] -- Do this to get networking, new console and X +- Debian [[FAQ]] -- Frequently Asked Questions +- [[After_install]] -- Do this to get networking, new console and X - [Presentation](http://people.debian.org/~mbanck/talks/hurd_lt2004/html/) *Debian GNU/Hurd* by [[MichaelBanck]], LinuxTag 2004 Karlsruhe +- [[Status]] - Official page about the Debian GNU/Hurd port: [Debian GNU/Hurd](http://www.debian.org/ports/hurd/) - [Installation Instructions](http://www.debian.org/ports/hurd/hurd-install) -- [Archive Qualification](http://wiki.debian.org/ArchiveQualification/hurd-i386)
\ No newline at end of file +- [Archive Qualification](http://wiki.debian.org/ArchiveQualification/hurd-i386) diff --git a/hurd/running/debian/DebianAfterInstall.mdwn b/hurd/running/debian/DebianAfterInstall.mdwn deleted file mode 100644 index b1f14d9a..00000000 --- a/hurd/running/debian/DebianAfterInstall.mdwn +++ /dev/null @@ -1,122 +0,0 @@ -<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/DebianFAQ.mdwn b/hurd/running/debian/DebianFAQ.mdwn deleted file mode 100644 index 43ace701..00000000 --- a/hurd/running/debian/DebianFAQ.mdwn +++ /dev/null @@ -1,89 +0,0 @@ -# <a name="Debian_GNU_Hurd_FAQ"> </a> Debian GNU/Hurd FAQ - -See also [[hurd/FAQ]] 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&group\_id=30628&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 > 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/after_install.mdwn b/hurd/running/debian/after_install.mdwn new file mode 100644 index 00000000..5c998c94 --- /dev/null +++ b/hurd/running/debian/after_install.mdwn @@ -0,0 +1,138 @@ +First steps after installation. + +So you have managed to get past the first `native-install` runs in single-user +mode? + +Time to get to work. + +[[toc ]] + + +### Get Networking Running + +[[Network]]. + +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 + + +# 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. + + +# Setup `apt-get` + +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. + +<!-- 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 + +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 + + +# [[Console]] + +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 . + + +# [[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 + +# What about package XYZ? + +See if you can find a useful tip in [[package_troubleshooting]]. diff --git a/hurd/running/debian/faq.mdwn b/hurd/running/debian/faq.mdwn new file mode 100644 index 00000000..1892d63f --- /dev/null +++ b/hurd/running/debian/faq.mdwn @@ -0,0 +1,137 @@ +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&group\_id=30628&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. diff --git a/hurd/running/debian/PackageTroubleshooting.mdwn b/hurd/running/debian/package_troubleshooting.mdwn index fe8b6df4..829af8e3 100644 --- a/hurd/running/debian/PackageTroubleshooting.mdwn +++ b/hurd/running/debian/package_troubleshooting.mdwn @@ -17,7 +17,7 @@ It may be that dpkg wants external GNU/Linux-specific programs that it can't fou ## <a name="SSH_not_working"> </a> SSH not working -You must set up the [[RandomDevice]] first. +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> @@ -42,7 +42,7 @@ There are various reasons for this. 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. +it is the random device fault. Follow the [[translator/random]] 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> diff --git a/hurd/running/debian/DebianStatus.mdwn b/hurd/running/debian/status.mdwn index 505c46a5..95e48edc 100644 --- a/hurd/running/debian/DebianStatus.mdwn +++ b/hurd/running/debian/status.mdwn @@ -1,4 +1,4 @@ Debian GNU/Hurd is currently an official, non-releasing Debian port. I.e., there is no testing or stable distribution. - [Build daemon/archive status](http://unstable.buildd.net/buildd/hurd-i386_stats) - - [Number of registered users](http://buildd.net/cgi/archvote.phtml)
\ No newline at end of file + - [Number of registered users](http://buildd.net/cgi/archvote.phtml) diff --git a/hurd/running/distrib.mdwn b/hurd/running/distrib.mdwn index f3078a65..a373062c 100644 --- a/hurd/running/distrib.mdwn +++ b/hurd/running/distrib.mdwn @@ -50,11 +50,15 @@ Another installation method is using an emulated environment. The [[BochsEmulato <dd> Work has been started by James Morrison and Glenn <nop>McGrath to [[PortDebootstrap]]. There is also a [[NewDebianInstaller]]. Why should Hurd folks care? It's important because this is the next generation installer that is intended to be used by all ports when Sarge is released. </nop></dd> </dl> + # Using -[[DebianAfterInstall]] instructions are a must-read to prepare an usable system. +Debian [[debian/after_install]] instructions are a must-read to prepare an +usable system. + +[[debian/Package_troubleshooting]] reports known bugs, quirks and workarounds +about getting applications to work (if possible). -[[PackageTroubleshooting]] reports known bugs, quirks and workarounds about getting applications to work (if possible). # For Developers diff --git a/hurd/running/qemu.mdwn b/hurd/running/qemu.mdwn index b6c200d7..f40d71d8 100644 --- a/hurd/running/qemu.mdwn +++ b/hurd/running/qemu.mdwn @@ -4,7 +4,7 @@ volunteers and may not have been tested extensively. * [Disk image](http://www.numenor.art.pl/balrog/hurd/) with an installation of - Debian GNU/Hurd. + [[Debian_GNU/Hurd|running/debian]]. * [Announcement](http://lists.debian.org/debian-hurd/2007/09/msg00000.html) of another image. @@ -112,9 +112,10 @@ That should do it! Do not forget to edit/update `/etc/resolv.conf` to get DNS wo These are links that users may find helpful. -[[DebianAfterInstall]] - good source of information pertaining to your system after installation. +Debian [[debian/after_install]] -- good source of information pertaining to your +system after installation. -[[Hurd/QemuImageForL4]] - a QEMU image for the Hurd/L4 project. +[[Image_for_L4]] -- a QEMU image for the Hurd/L4 project. # TODO diff --git a/Hurd/QemuImageForL4.mdwn b/hurd/running/qemu/image_for_l4.mdwn index 515f51bc..515f51bc 100644 --- a/Hurd/QemuImageForL4.mdwn +++ b/hurd/running/qemu/image_for_l4.mdwn diff --git a/hurd/translator/random.mdwn b/hurd/translator/random.mdwn new file mode 100644 index 00000000..294531d1 --- /dev/null +++ b/hurd/translator/random.mdwn @@ -0,0 +1,65 @@ +[Savannah task #5130: random translator](http://savannah.gnu.org/task/?5130) + +See the attached [[mbox.bz2]] containing all the emails concerning this topic +which I was able to gather from public archives. (!) This is not up-to-date +anymore, as [[MichaelCasadevall]] is currently working on this. + +# Description + +Sources of entropy are for example disk access latencies or keystroke patterns +or behavior on networks. This suggests that for implementing a random +translator a kernel part is needed as well, to gather that entropy. That +kernel part would then export the gathered entropy via a kernel device, named +perhaps `entropy`. + +# Setup Pseudo Random Devices + +Stuck getting SSH to work? You need a pseudo random generator (PRG). + +There are several solutions to the lack of `/dev/random` and `/dev/urandom`, +but they are not yet in the default installation. + +* Marcus' work can be downloaded at + [random.tar.gz](ftp://alpha.gnu.org/gnu/hurd/contrib/marcus/random.tar.gz). + (Identical to <http://kilobug.free.fr/hurd/random-64.tar.gz>?) + * [A patch](http://mail.gnu.org/pipermail/bug-hurd/2002-August/010248.html) + that was probably already incorporated from August 14, 2002. + * Clemmitt Sigler [reported + success](http://lists.gnu.org/archive/html/help-hurd/2002-10/msg00076.html) + October 11, 2002 and Marcus [described + some](http://lists.gnu.org/archive/html/help-hurd/2002-10/msg00081.html) of + the internals. + +* [Entropy Gathering Daemon](http://egd.sourceforge.net/). + * [request for packaging](http://bugs.debian.org/145498). + +* [OSKit Entropy + Patch](http://lists.gnu.org/archive/html/bug-hurd/2003-01/msg00000.html) from + Derek Davies - Jan 2003. + * See also [this page](http://www.ddavies.net/oskit-entropy/). + * Note that this patch can (and should) be used with this [OSKit NIC + patch](ftp://flux.cs.utah.edu/flux/oskit/mail/html/oskit-users/msg01570.html). + +* [Sune Kirkeby's incomplete port of the Linux /dev/\{,u\}random device + driver](http://ibofobi.dk/stuff/hurd-entropy/) + * [The files](http://download.ibofobi.dk/hurd-entropy/), including a [patch + for GNU + Mach](http://download.ibofobi.dk/hurd-entropy/gnumach-entropy.diff.bz2). + +--- + +# Setup Tips + +Here are some tips on how to actually setup the two random devices using +Kilobugs' [random-64 server](http://kilobug.free.fr/hurd/random-64.tar.gz). +His tarball is a complete Hurd server including a pre-built binary - so you +don't need GCC or magic fingers for this! :) + +After untaring the package you copy the random binary to the `/hurd` +directory. Then you setup the translators for random and urandom. + + # 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 diff --git a/Hurd/RandomDevice/mbox.bz2 b/hurd/translator/random/mbox.bz2 Binary files differindex a9a4d4a6..a9a4d4a6 100644 --- a/Hurd/RandomDevice/mbox.bz2 +++ b/hurd/translator/random/mbox.bz2 diff --git a/index/discussion.mdwn b/index/discussion.mdwn index 7f177cb8..7ceca85e 100644 --- a/index/discussion.mdwn +++ b/index/discussion.mdwn @@ -24,6 +24,10 @@ with that information we can make a page named: Technical FAQs. --[[arnuld]] cleaned and re-ordered. --[[tschwinge]] +The three of [[Xfree86]], [[DebianX]], [[DebianXorg]] should be merged into +one. + + <azeem> tschwinge: maybe we should discuss wiki page naming policies WRT Debian <azeem> I'd rather have something like /Debian, /DebianInstall, /DebianFAQ, /DebianInstallCrosshurd etc. <azeem> than the current distrib diff --git a/microkernel/mach/gnumach/building.mdwn b/microkernel/mach/gnumach/building.mdwn index a85490e2..3d62c3f0 100644 --- a/microkernel/mach/gnumach/building.mdwn +++ b/microkernel/mach/gnumach/building.mdwn @@ -24,7 +24,7 @@ See [here](http://packages.debian.net/source/unstable/gnumach). $ apt-get source gnumach -Please see [[Distrib/DebianFAQ]] before using _apt-get source_. +Please see the Debian [[running/debian/FAQ]] before using _apt-get source_. ## <a name="Preparing_for_the_Build"> Preparing for the Build </a> diff --git a/microkernel/mach/mig/building.mdwn b/microkernel/mach/mig/building.mdwn index 08a1c14b..ee299166 100644 --- a/microkernel/mach/mig/building.mdwn +++ b/microkernel/mach/mig/building.mdwn @@ -12,7 +12,7 @@ You can chose between getting the [sources from the developers's rcs](http://www $ apt-get source mig -Please see [[Distrib/DebianFAQ]] before using _apt-get source_. +Please see the Debian [[running/debian/FAQ]] before using _apt-get source_. The unpacked source tree is around 1 MiB, and the build tree also is around 1 MiB. |