diff options
Diffstat (limited to 'Distrib')
76 files changed, 3429 insertions, 0 deletions
diff --git a/Distrib/BochsEmulator.mdwn b/Distrib/BochsEmulator.mdwn new file mode 100644 index 00000000..8c9f5cfe --- /dev/null +++ b/Distrib/BochsEmulator.mdwn @@ -0,0 +1,20 @@ +# <a name="Bochs_IA_32_x86_64_Emulator"> Bochs IA-32/x86-64 Emulator </a> + +[Bochs](http://bochs.sf.net) is a very cool emulator, similar to Plex86 and the commercial product [[VmWare]] which virtualizes the PC hardware. However, Bochs does not virtualize, it _emulates_ the IA32 on the instruction level. It's currently the best alternative if you want to take the Hurd for a quick test drive without needing to repartition your hard drive or read complicated installation manuals. + +* [Debian package](http://packages.qa.debian.org/bochs) + +Note that Bochs is quite slow, so installing GNU inside its virtual machine will probably take you a lot of time. There are several pre-installed bochs images available. + +## <a name="Images"> Images </a> + +* The Bochs project hosts a [preinstalled GNU image](http://sourceforge.net/project/showfiles.php?group_id=12580). It has network, Xfree86 and the console server installed and configured (X has some problems though). If you want to try it out, please read the [[BochsFAQ]] for setting up a GNU guest first. +* [Another 2GB image](http://www.gnuhurd.org/) distributed in rar format without apologies. +* Bee has a [bochs version](http://bee.es.gnu.org/) of it's distribution + +## <a name="Articles"> Articles </a> + +* [Bruno Bonfils wrote an article.](http://www.asyd.net/docs/hurd/bochs-hurd.html) +* [Julien PUYDT wrote another article on setting up Hurd in Bochs.](http://lists.debian.org/debian-hurd/2003/debian-hurd-200303/msg00065.html) + * [Lucas Nussbaum added some details.](http://lists.debian.org/debian-hurd/2004/debian-hurd-200401/msg00078.html) +* [Marcus Brinkmann shares his experience in running GNU/Hurd on Bochs](http://lists.debian.org/debian-hurd/2004/debian-hurd-200402/msg00057.html). He [mentions qemu](http://lists.debian.org/debian-hurd/2004/debian-hurd-200402/msg00059.html) too, and [PUYDT Julien suggests using /dev/loop0.](http://lists.debian.org/debian-hurd/2004/debian-hurd-200402/msg00064.html) diff --git a/Distrib/BochsFAQ.mdwn b/Distrib/BochsFAQ.mdwn new file mode 100644 index 00000000..d446f695 --- /dev/null +++ b/Distrib/BochsFAQ.mdwn @@ -0,0 +1,85 @@ +# <a name="GNU_pre0_3_J2_for_Bochs_mini_FAQ"> </a> GNU pre0.3-J2 for Bochs mini-FAQ + +%TOC% + +---- + +## <a name="What_do_you_mean_GNU_the_GNU_Hur"> </a> What do you mean "GNU", the GNU Hurd? + +Yes and no. See <http://www.gnu.org/software/hurd/faq.en.html#q1-2> + +## <a name="Where_are_"> Where are...? </a> + +Latest version of this FAQ: [[Distrib/BochsFAQ]] + +Latest GNU image for Bochs: [http://sourceforge.net/project/showfiles.php?group\_id=12580](http://sourceforge.net/project/showfiles.php?group_id=12580) + +## <a name="Disk_line_for_bochsrc_"> Disk line for .bochsrc? </a> + +for Bochs 2.0 or later: + + ata0-master: type=disk, path="gnu.img", cylinders=1024, heads=16, spt=63 + +for older versions: + + diskc: file="gnu.img", cyl=1024, heads=16, spt=63 + +## <a name="My_PATH_and_prompt_are_weird_and"> </a> My PATH and prompt are weird, and X clients fail + +The profile is not loaded properly, do it manually with `". /etc/profile"` + +## <a name="How_can_i_change_terminals_"> How can i change terminals? </a> + +The Mach default console lack have multi-terminal capability, and up 'til recently we recommended the "screen" program. However, the new console server is installed and configured with 6 terminals. You can launch it with the ncursesw driver: + + console -d ncursesw /dev/vcs + +Switching is done via `C-w 1` (or 2, 3, ...). you can exit it with `C-w x` + +See the original posting to debian-hurd, <http://lists.debian.org/debian-hurd/2002/debian-hurd-200209/msg00054.html>, or [[Hurd/HurdConsole]] for more details. + +**_IMPORTANT:_** Note that X doesn't work well while running the console server. + +## <a name="Does_X_work_"> Does X work? </a> + +Somewhat: + +* DRI and speedo modules won't load so they're deactivated. +* The VESA driver also failed so VGA is being used. +* more than 8 bpp won't work. +* for some weird reason the mouse server in `/dev/mouse` doesn't respond, so the mouse is inoperative. +* GNU is still an unstable OS which makes X crash often on it. + +To reconfigure it, see Distrib.Xfree86, or: + + dpkg-reconfigure xserver-xfree86 + +then apply a patch to fix the mouse section: + + patch /etc/X11/XF86config-4 /root/XF86Config-4.diff + +Installed clients are blackbox window manager and rxvt terminal emulator. + +## <a name="Is_network_configured_"> Is network configured? </a> + +Yes, to change parameters use: + + settrans -apfg /servers/socket/2 /hurd/pfinet [options to pfinet] + +See `/hurd/pfinet --help` for details, or the [[Hurd/GetNetworkRunning]] topic. + +## <a name="How_do_i_mount_stuff_"> How do i mount stuff? </a> + + settrans -afg <node> /hurd/<translator> <options to translator> + +Where `node` is your mount point and `translator` is the filesystem server. Add `-p` to settrans if you want it to stay over reboots (fstab-like) + +## <a name="Anything_neat_to_try_"> Anything neat to try? </a> + +Yes! instead of `"su"` use `"sush"`, a more flexible version that manages multiple UIDs. + +You can also play with userspace filesystems for NFS and FTP in `/hurd/{nfs,ftpfs}` that you can run as user, debug with GDB, etc. + +## <a name="More_questions_"> More questions? </a> + +Read the FAQ (<http://www.gnu.org/software/hurd/faq.en.html>) for a general overview on the GNU system. diff --git a/Distrib/BtsFiling.mdwn b/Distrib/BtsFiling.mdwn new file mode 100644 index 00000000..90f451a8 --- /dev/null +++ b/Distrib/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/<package>](http://bugs.debian.org) to ensure the problem is not in the BTS already. This is possible for packages and bug numbers. [[TWiki/InterWikis]] is a shorthand way of linking to bugs and packages from this site. i.e. [[DebianBug]]:hurd [[DebianPackage]]:oskit +* you can fetch package sources with: + + apt-get source <package> + +note: this should unpack already + +* and unpack with: + + dpkg-source -x <package>x-y_z.dsc + +* then get all dependencies: + + apt-get -y build-dep <package> + +note: if some dependencies are missing, it most probably means you have to port them first. follow this instructions recursively until done + + :) + +* Debian packages have a makefile in debian/rules, with (at least) the following targets: <dl> + <dt> build</dt> + <dd> Yup, to build </dd> + <dt> binary</dt> + <dd> Generates deb files in <code>../</code></dd> + <dt> clean</dt> + <dd> Full clean </dd> +</dl> + +* when you have a patch, send it to the BTS using the reportbug utility (or manually as explained in <http://bugs.debian.org/)>. The following parameters should be used: + + Severity: important (when the package is unbuildable or uninstallable, lower otherwise.) + Tags: sid, patch + +* be nice to the maintainers. most are friendly and cooperative, and a few could annoy you for months before applying. Be patient. + +Read <http://bugs.debian.org/> for extensive documentation on the BTS. + +-- [[Main/RobertMillan]] - 10 Jun 2002 + +---- + +Wikification & small changes. + +-- [[Main/JoachimNilsson]] - 24 Jun 2002 + +Updates with the new [[TWiki/InterWikis]] rules. + +-- [[Main/GrantBow]] - 15 Jan 2003 diff --git a/Distrib/BuilddProcmailRecipe.mdwn b/Distrib/BuilddProcmailRecipe.mdwn new file mode 100644 index 00000000..06db9cea --- /dev/null +++ b/Distrib/BuilddProcmailRecipe.mdwn @@ -0,0 +1,19 @@ +I have a simple procmail recipe that extracts the subjects of the buildd emails into a logfile. With some additional work I am sure this can be useful as input to a status system/script. + + ----- Begin Procmail recipe ----- + + # appends subject to log + :0 cWh: buildd.lock + * ^TO_buildd-porters + | formail -x Subject >> buildd-porters.log + + # stores raw email into a maildir folder + :0: + * ^TO_buildd-porters + buildd-porters/ + + ----- End Procmail recipe ----- + +Ideally I would like to see the results processed and posted to the twiki pages where people can comment on them (hopefully without interrupting any automated status updating). + +-- [[Main/GrantBow]] - 08 Jun 2002 diff --git a/Distrib/BuilddStatus.mdwn b/Distrib/BuilddStatus.mdwn new file mode 100644 index 00000000..1e0c0fb7 --- /dev/null +++ b/Distrib/BuilddStatus.mdwn @@ -0,0 +1,83 @@ +The following is a sample page. Data is extracted from the buildd email output via a simple [[BuilddProcmailRecipe]]. + + Log for successful build of xpdf_1.01-1 (dist=unstable) + Log for failed build of xxdiff_1:2.5-2 (dist=unstable) + Log for failed build of yiyantang_0.7.0-1 (dist=unstable) + Log for successful build of zh-sgmltools_1.1-4.3 (dist=unstable) + Log for failed build of adacgi_1.4-4 (dist=unstable) + Log from sbuild 20020606-1600 + Log for successful build of admwebuser_2.1-2 (dist=unstable) + Log for successful build of amaya_5.3-3 (dist=unstable) + Log for failed build of analog_2:5.23-2 (dist=unstable) + Log for failed build of aolserver_3.4.2-1 (dist=unstable) + Log for failed build of cern-httpd_3.0A-3 (dist=unstable) + Log for failed build of chimera2_2.0a19-3.2 (dist=unstable) + Log for successful build of curator_1.3-1 (dist=unstable) + Log for successful build of ezmlm-browse_0.6-2 (dist=unstable) + Log for failed build of galeon_1.2.3-6 (dist=unstable) + Log for successful build of googlizer_0.2-1 (dist=unstable) + Log for failed build of grub-client_0.3.0-3 (dist=unstable) + Log for failed build of hitop_0.35-1 (dist=unstable) + Log for failed build of interchange_4.8.5.20020527-1 (dist=unstable) + Log for failed build of kmago_1.1.2-3 (dist=unstable) + Log for failed build of libapache-csacek_2.1.9-1 (dist=unstable) + Log from sbuild 20020607-0715 + Log for failed build of libapache-mod-auth-mysql_3.2-1 (dist=unstable) + Log for failed build of libapache-mod-auth-useragent_1.0-4 (dist=unstable) + Log for failed build of libapache-mod-backhand_1.2.1-1.1 (dist=unstable) + +Please use the following space to discuss development of an automated system that accepts buildd email as input and a well-defined status page as output. + +-- [[Main/GrantBow]] - 08 Jun 2002 + +If we ignore TWiki's versioning of this file (or the "well-defined status page") we can have wget downloading a HTML version of the buildd output do some sed magic into a text file and voil�! + +Would that be OK? + +-- [[Main/JoachimNilsson]] - 08 Jun 2002 + +Aha, OK, sounds good to me. I'd like to try to get consensus on (at least) which direction to head before proceeding. Then it's the next step to get done the sed magic and building an HTML output from buildd. + +-- [[Main/GrantBow]] - 10 Jun 2002 + +I saw your posts on bug-hurd about this. Adding comments on each package would be a grgeat benefit, but would perhaps require some kind of automatic merging of the comments and new buildd outputs. Which could get messy, even for an avid sed /perl/awk/python/whatever-fu master. + +One idea around this could be to decouple the comments from the buildd output. Having a separate Wiki page for each package. Perhaps like this: + + Log for failed build of grub-client_0.3.0-3 (dist=unstable) BuilddGrubClientComments + Log for failed build of libapache-mod-auth-mysql_3.2-1 (dist=unstable) BuilddLibApacheModAuthMysqlComments + +... or similar. One could even add simple markup to color failed packages red and successful builds green. The biggest issue, however, is the one dealing with commenting buildd results and merging new buildd results with these comments. + +-- [[Main/JoachimNilsson]] - 10 Jun 2002 + +It looks like you need no explicit merging if you just put a [[TWiki/WikiWord]] for the packge in the end of buildd log line. + +But if you meant merging new results with old results I know only two ways: + +* Put it all in a hash in memory and update from new log +* Store it in a database and update from the log + +For this you need + +1. parse buildd log to get date, package name, status +2. either save into database or append to a text file +3. process the updated database/text file + +Sounds easy to me. What am I missing? + +-- 9 Sep 2002 + +Here's a related page I created awhile ago to sort out the parts of the build process and what's involved. [[GNUDebianBuildProcess]] It's just a scratchpad for myself right now, but comments are encouraged. + +-- [[Main/GrantBow]] - 18 Sep 2002 + +The process of developing this build status tool is stalled right now. Jeff's Buildd machine for the Hurd is down because of some dependencies that need to get worked out. A newer perl isn't working due to a pthreads dependency. I'm not sure what the status is on Marcus' turtle build machine. I'll drop him an email. + +Aha! There's a [somewhat related project](http://ydirson.free.fr/en/software/buildinfo.html) being done for Debian as well. It's amazing what what you can find if you keep reading [relevant documentation](http://www.debian.org/devel/todo/). + +-- [[Main/GrantBow]] - 05 Jan 2003 + +Wow, the more things change, the more they stay the same :) + +-- [[Main/GrantBow]] - 24 Feb 2004 diff --git a/Distrib/BuildingTheHurd.mdwn b/Distrib/BuildingTheHurd.mdwn new file mode 100644 index 00000000..fb412eae --- /dev/null +++ b/Distrib/BuildingTheHurd.mdwn @@ -0,0 +1,251 @@ +## <a name="Table_of_Contents"> Table of Contents </a> + +%TOC% + +Created from the original by [Jon Portnoy](http://cvs.gentoo.org/~avenj/), <http://cvs.gentoo.org/~avenj/doc/xcompile-en.html> + +## <a name="Introduction"> Introduction </a> + +For a Linux to Hurd cross-compiler you need these versions (I tried newer versions of gcc but they won't compile) + +* [binutils-2.13.90.0.16](http://ftp.gnu.org/gnu/binutils/) + +* egcs-core-1.2.2 <- a very old version of gcc, but it is very stable, you will need it for compiling the gnumach headers and the mig kernel + +* [gcc-core-2.95.2](http://ftp.gnu.org/gnu/gcc/) <- for compiling hurd + +* [glibc-2.2.5](http://ftp.gnu.org/gnu/glibc/) + +* [gnumach-1.3](http://ftp.gnu.org/gnu/gnumach/gnumach-1.3.tar.gz) + +* [mig-1.3](http://ftp.gnu.org/gnu/mig/mig-1.3.tar.gz) + +* [hurd](http://www.gnu.org/software/hurd/download.html) + +## <a name="Building"> Building </a> + +### <a name="The_directory_structure"> The directory structure </a> + +It is easier to compile the whole sources in an extra directory: + +* `build/binutils` <- the unpacked binutils sources + +* `build/binutils.build` + +* `build/egcs` <- the unpacked egcs sources + +* `build/egcs.build` + +* `build/gcc` <- the unpacked gcc sources + +* `build/gcc.build` + +* `build/glibc` <- the unpacked glibc sources + +* `build/glibc.build` + +* `build/gnumach` <- the unpacked gnumach kernel sources + +* `build/gnumach.build` + +* `build/mig` <- the unpacked mig kernel sources + +* `build/mig.build` + +* `build/hurd` <- the unpacked hurd kernel sources + +* `build/hurd.build` + +### <a name="Exporting_the_CFLAGS_tt_and_PATH"> Exporting the `CFLAGS` and `PATH` </a> + +`/usr/local` is where the sources we compile will be installed. If you want to choose another directory you have to change the path to the bin directory and too you have to change the `--prefix` path to the directory you want. + + $ export CFLAGS="-march=i686 -O2 -fomit-frame-pointer" + $ export PATH=/usr/local/bin:$PATH + +**_All commands that are prefixed by `#` must be run as root with `CFLAGS` and `PATH` exported._** + +### <a name="Cross_binutils"> Cross binutils </a> + + $ cd binutils.build + $ ../binutils/configure --prefix=/usr/local --target=i686-pc-gnu + $ make + $ make check + # make install + $ cd .. + +### <a name="Cross_egcs"> Cross egcs </a> + +When the `/usr/local/bin` directory do not exist before you will now have to export the `PATH` again because after installing binutils you will have it. + + $ cd egcs.build + $ ../egcs/configure --prefix=/usr/local --target=i686-pc-gnu \ + --with-gnu-as --with-gnu-ld + $ make -k + # make -k install + $ ln -s /usr/local/i686-pc-gnu \ + /usr/local/lib/gcc-lib/i686-pc-gnu/egcs-2.91.66/i686-pc-gnu + $ cd .. + +### <a name="GNUmach_Headers"> GNUmach Headers </a> + + $ cd gnumach.build + $ ../gnumach/configure --build=i686-pc-linux-gnu --host=i686-pc-gnu + # make -k install-headers prefix=/usr/local/i686-pc-gnu + $ cd .. + +### <a name="Mig"> Mig </a> + +Mig is the Mach Interface Generator - needed by Mach and the Hurd to create C code from their IDL files. Mig is what helps us do RPC without ever knowing much about it. + + $ cd mig.build + $ ../mig/configure --target=i686-pc-gnu --host=i686-pc-linux-gnu \ + --prefix=/usr/local + $ make + # make install + $ cd .. + +### <a name="Gnumach_Headers_inclusive_Mig"> Gnumach Headers inclusive Mig </a> + +When you first compile the GNUmach headers Mig won't be mentioned (it wasn't installed actually) and this causes some errors when compiling the GNUmach headers but you need them to compile mig. (I don't know if you have to do this but i think it is the better way) + + $ cd gnumach.build + $ rm -r * (deletes every file and directory in this directory) + $ ../gnumach/configure --build=i686-pc-linux-gnu --host=i686-pc-gnu + # make -k install-headers prefix=/usr/local/i686-pc-gnu + $ cd .. + +### <a name="Cross_GCC"> Cross GCC </a> + +For the coexistence of EGCS and GCC you have to move the `/usr/local/bin/i686-pc-gnu-gcc` to the `/usr/local/bin` directory in `i686-pc-gnu-egcs`. So you can choose wich compiler you want use: with the `CC` environment variable set to `i686-pc-gnu-egcs` you can use EGCS without this command you use GCC. + + # mv /usr/local/bin/i686-pc-gnu-gcc \ + /usr/local/bin/i686-pc-gnu-egcs + + $ cd gcc.build + $ ../gcc/configure --prefix=/usr/local --target=i686-pc-gnu \ + --with-gnu-as --with-gnu-ld + $ make -k compile the glibc-headers) + # make -k install + $ cd .. + + # ln -s /usr/local/i686-pc-gnu/ \ + /usr/local/lib/gcc-lib/i686-pc-gnu/2.95.2/i686-pc-gnu + +You need `make -k` because otherwise it will fail but with `-k` you will have everything you need. + +### <a name="Hurd_Headers"> Hurd Headers </a> + + $ cd hurd.build + $ ../hurd/configure --build=i686-pc-linux-gnu -�host=i686-pc-gnu \ + -�prefix=/usr/local/i686-pc-gnu --disable-profile + # make install-headers no_deps=t + $ cd .. + +### <a name="Cross_GLibC"> Cross GLibC </a> + +For having glibc compiled with the cross-gcc and not with your original gcc you have to export another `PATH`. The normal user who configures and compiles and also root has to export this `PATH`. + + $ export PATH=/usr/local/bin:/usr/local/i686-pc-gnu/bin:$PATH + $ cd glibc.build + $ ../glibc/configure --without-cvs --enable-add-ons=crypt \ + --disable-profile --build=i686-pc-linux-gnu \ + --host=i686-pc-gnu --prefix=/usr/local/i686-pc-gnu + +AS ROOT WITH EXPORTED CFLAGS: + + # export PATH=/usr/local/bin:/usr/local/i686-pc-gnu/bin:$PATH + # make -k install-headers install_root=/usr/local/i686-pc-gnu + # cp ../glibc/include/features.h \ + /usr/local/i686-pc-gnu/include/features.h + # touch /usr/local/i686-pc-gnu/include/gnu/stubs.h + $ cd .. + +### <a name="Building_Cross_egcs"> Building Cross egcs </a> + + # mv /usr/local/bin/i686-pc-gnu-gcc \ + /usr/local/bin/i686-pc-gnu-foo (for protecting gcc) + # mv /usr/local/bin/i686-pc-gnu-egcs \ + /usr/local/bin/i686-pc-gnu-gcc + $ cd egcs.build + $ make + # make install (as root, export CFLAGS and the NEW PATH) + $ cd .. + # mv /usr/local/bin/i686-pc-gnu-gcc \ + /usr/local/bin/i686-pc-gnu-egcs + # mv /usr/local/bin/i686-pc-gnu-foo \ + /usr/local/bin/i686-pc-gnu-gcc + +### <a name="Building_Cross_GCC"> Building Cross GCC </a> + + $ cd gcc.build + $ make + # make install + $ cd .. + +Remember to export `CFLAGS` and the new `PATH` + +### <a name="Building_Cross_GLibC"> Building Cross GLibC </a> + + $ cd glibc.build + $ make + # make install root_install=/usr/local/i686-pc-gnu + +Remember to export `CFLAGS` and the new `PATH` + +For solving a glibc bug you have to link the `/usr/local/i686-pc-gnu/include/libc.so.0.2` with the `/usr/local/i686-pc-gnu/lib/libc.so` ever when you (re)install glibc. + + # ln -sf /usr/local/i686-pc-gnu/lib/libc.so.0.2 \ + /usr/local/i686-pc-gnu/lib/libc.so + +### <a name="Install_the_GNUmach_kernel_somew"> Install the GNUmach kernel somewhere </a> + + $ rm -r gnumach.build + $ mkdir gnumach.build + $ cd gnumach.build + +You will need more than the `-�target` and `-�host` variables to build the GNUmach kernel. You have to enable some kernel features with the `--enable` command to have your kernel working properly. To have a quick view of what you need you can view the `gnumach/i386/README-Drivers` (I do not know how old it is, so maybe there are more options available but i haven't searched for more). + +My configure command: + + $ ../gnumach/configure --build=i686-pc-linux-gnu \ + --host=i686-pc-gnu �-enable-lpr \ + --enable-floppy --enable-ide \ + --enable-aic7xxx �-enable-rtl8139 + # ln -s /usr/local/i686-pc-gnu/include \ + /where/you/want/to/install/the/kernel/include + # ln -s /usr/locali686-pc-gnu/lib \ + /where/you/want/to/install/the/kernel/lib + $ make + # make install-kernel \ + prefix=/where/you/want/to/install/the/kernel (as root ...) + +### <a name="Hurd_Servers"> Hurd Servers </a> + + $ rm -r hurd.build + $ mkdir hurd.build + $ cd hurd.build + $ nano -w/vi (or what editor you ever use) ../hurd/Makeconf + +You have to comment out the `CFLAGS` in this file or delete the `-std=gnu99` and the `-O3`. + + $ ../hurd/configure �build=i686-pc-linux-gnu \ + --host=i686-pc-gnu \ + -�prefix=/where/you/want/to/install/the/kernel \ + --disable-profile + $ make -k + # make -k install prefix=/where/you/want/to/install/the/kernel + +You have to use `-k` because when you don't use it the compilation will brake with an error. I tried different installations of gcc and glibc and too i used different versions of hurd but i cannot solve this prob so maybe it is hurd related. + +So there is no warranty that the hurd kernel you compiled will work. I will try it and then update this guide. + +---- + +## <a name="Document_History"> Document History </a> + +Created from the original, <http://cvs.gentoo.org/~avenj/doc/xcompile-en.html>, by [Jon Portnoy](http://cvs.gentoo.org/~avenj/) + +I would recommend not using EGCS, but instead using the GCC cross compiler. See [[Hurd/BuildingHurd]] and [[Mach/BuildingOskitMach]] for more information on building the GNU OS components. <br />-- [[Main/JoachimNilsson]] - 13 Apr 2003 + +Text formatting. <br />-- [[Main/OgnyanKulev]] - 13 Apr 2003 diff --git a/Distrib/CDNotesG1.mdwn b/Distrib/CDNotesG1.mdwn new file mode 100644 index 00000000..2e496948 --- /dev/null +++ b/Distrib/CDNotesG1.mdwn @@ -0,0 +1,5 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this set of CDs. + +-- [[Main/GrantBow]] - 15 Oct 2002 diff --git a/Distrib/CDNotesH1.mdwn b/Distrib/CDNotesH1.mdwn new file mode 100644 index 00000000..2e496948 --- /dev/null +++ b/Distrib/CDNotesH1.mdwn @@ -0,0 +1,5 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this set of CDs. + +-- [[Main/GrantBow]] - 15 Oct 2002 diff --git a/Distrib/CDNotesH2.mdwn b/Distrib/CDNotesH2.mdwn new file mode 100644 index 00000000..2e496948 --- /dev/null +++ b/Distrib/CDNotesH2.mdwn @@ -0,0 +1,5 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this set of CDs. + +-- [[Main/GrantBow]] - 15 Oct 2002 diff --git a/Distrib/CDNotesH3.mdwn b/Distrib/CDNotesH3.mdwn new file mode 100644 index 00000000..2e496948 --- /dev/null +++ b/Distrib/CDNotesH3.mdwn @@ -0,0 +1,5 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this set of CDs. + +-- [[Main/GrantBow]] - 15 Oct 2002 diff --git a/Distrib/CDNotesH4.mdwn b/Distrib/CDNotesH4.mdwn new file mode 100644 index 00000000..2e496948 --- /dev/null +++ b/Distrib/CDNotesH4.mdwn @@ -0,0 +1,5 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this set of CDs. + +-- [[Main/GrantBow]] - 15 Oct 2002 diff --git a/Distrib/CDNotesHome.mdwn b/Distrib/CDNotesHome.mdwn new file mode 100644 index 00000000..db8a47cb --- /dev/null +++ b/Distrib/CDNotesHome.mdwn @@ -0,0 +1,30 @@ +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. + +---- + +What we need is a [[ReleaseHome]] page and to expand the system so that a chronological set of all releases from all the different distributions can be seen, but that's for another day. The [[HurdReleaseForm]] is in place already, it just needs to be updated with the other folks who are releasing distros. The hard part is to get the info that a particular distro is released on a particular date. Creating new Notes page is also a manual process due to the TWiki searches and comment box that need to be added to each one. Right now, I'm the only one who knows how or seems to have tried. + +-- [[Main/GrantBow]] - 03 Feb 2004 + +Date search function borken, will be fixed in next TWiki base software upgrade. + +-- [[Main/JoachimNilsson]] - 12 Mar 2005 + +<table> + <tr> + <td valign="top" width="50%"> + <p> %SEARCH{"Mediatype.*?value=\"CD\"" scope="text" regex="on" nosearch="on" nototal="on" header="| <strong>Release</strong> | <strong>Date</strong> |" format="| [[Topic]] | $formfield(Release Date) |"}% </p> + <p> + </p> + </td> + <td> + <p> + </p> + </td> + <td valign="top" width="50%"> + <p> %SEARCH{"Mediatype.*?value=" scope="text" regex="on" nosearch="on" nototal="on" header="| <strong>Release</strong> | <strong>Date</strong> |" format="| [[Topic]] | $formfield([[ReleaseDate]]) |" order="formfield([[ReleaseDate]])" }% </p> + <p> + </p> + </td> + </tr> +</table> diff --git a/Distrib/CDNotesJ1.mdwn b/Distrib/CDNotesJ1.mdwn new file mode 100644 index 00000000..3d20f173 --- /dev/null +++ b/Distrib/CDNotesJ1.mdwn @@ -0,0 +1,7 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this set of CDs. + +<http://www.debian.org/ports/hurd/extra-files/hurd-upgrade.txt> + +-- [[Main/GrantBow]] - 15 Oct 2002 diff --git a/Distrib/CDNotesJ2.mdwn b/Distrib/CDNotesJ2.mdwn new file mode 100644 index 00000000..5fe18efa --- /dev/null +++ b/Distrib/CDNotesJ2.mdwn @@ -0,0 +1,23 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this set of CDs. + +This CD set is based on the [[Distrib/TarballNotes20020816]] + +This means it uses GNU Mach 1.3. (I think, even though it says 1.2?) + +-- [[Main/GrantBow]] - 15 Oct 2002 + +This set is the third in the series to use a libio-enabled libc. This is the first set to use the newer Hurd & libc, which means you don't need to manually upgrade them after installing with this CD set. + +-- [[Main/AndrewMitchell]] - 16 Oct 2002 + +%COMMENT\{mode="after" id="second" button="Add Comment"\}% + +---- + +Warning, 700 MB media is needed for discs 2 & 3 + +-- [[Main/TWikiGuest]] - 20 Oct 2002 + +---- diff --git a/Distrib/CDNotesK1.mdwn b/Distrib/CDNotesK1.mdwn new file mode 100644 index 00000000..55759a55 --- /dev/null +++ b/Distrib/CDNotesK1.mdwn @@ -0,0 +1,19 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's [the announcement](http://lists.debian.org/debian-hurd/2002/debian-hurd-200211/msg00123.html) for this set of CDs. This is a place for notes and sharing info about peculiarities with this set of CDs. Past notes may be of help as well. + +## <a name="Getting_the_CDs_"> Getting the CDs. </a> + +As usual, you can find [more information here](http://www.debian.org/ports/hurd/hurd-cd). + +%COMMENT\{mode="after" id="second" button="Add Comment"\}% + +---- + +vi needs to be re-linked with ln -sf /bin/nvi /bin/vi. + +-- [[Main/TWikiGuest]] - 06 Mar 2003 + +---- + +Parent - [[CDNotesHome]] diff --git a/Distrib/CDNotesK2.mdwn b/Distrib/CDNotesK2.mdwn new file mode 100644 index 00000000..18edc08d --- /dev/null +++ b/Distrib/CDNotesK2.mdwn @@ -0,0 +1,19 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's the February 28th [announcement](http://lists.debian.org/debian-hurd/2003/debian-hurd-200302/msg00058.html) for this set of CDs. This is a place for notes and sharing info about peculiarities with this set of CDs. Past notes may be of help as well. + +## <a name="Getting_the_CDs_"> Getting the CDs. </a> + +As usual, you can find [more information here](http://www.debian.org/ports/hurd/hurd-cd). + +%COMMENT\{mode="after" id="second" button="Add Comment"\}% + +---- + +A much, much better series than K1. install.sh now installs all the required, important and standard packages. gui.sh is still there, but xfree is not working at the moment. The first four of a possible five CD set has been released, the fifth is probably useless to most people. The K3 series will probably be released once xfree is working again. Phil. + +-- [[Main/TWikiGuest]] - 06 Mar 2003 + +---- + +Parent - [[CDNotesHome]] diff --git a/Distrib/CDNotesK3.mdwn b/Distrib/CDNotesK3.mdwn new file mode 100644 index 00000000..193f690b --- /dev/null +++ b/Distrib/CDNotesK3.mdwn @@ -0,0 +1,39 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's the April 30th page for this set of CDs. This is a place for notes and sharing info about peculiarities with this set of CDs. Past notes may be of help as well. + +## <a name="Getting_the_CDs_"> Getting the CDs. </a> + +As usual, you can find [more information here](http://www.debian.org/ports/hurd/hurd-cd). + +%COMMENT\{mode="after" id="second" button="Add Comment"\}% + +---- + +GNU parted, the partitioning program, crashes when it's used like this: + +# parted /dev/hd0 + +This is a bug in the Hurd (Debian bug #196085). Use the following arguments instead: + +# parted device:hd0 + +-- [[Main/OgnyanKulev]] - 04 Jun 2003 + +---- + +Unfortunately gcc-3.2\_3.2.3 gives "Internal error" while compiling the Hurd. You have to use gcc-3.3 but keep in mind that only CVS snapshots after 2003-05-08 can be compiled by gcc-3.3. + +-- [[Main/OgnyanKulev]] - 02 Jun 2003 + +---- + +The K3 images are being uploaded at the moment. There has been a name change from hurd-Kx-CDy.iso to GNU-Kx-CDy.iso, but they still will be found under ../iso/hurd-K3/.. at ftp.gnu.org at just before mindnight30 April. This set is the best of the Kx series. There are four CDs. + +Phil. Http://www.copyleft.co.nz + +-- [[Main/TWikiGuest]] - 29 Apr 2003 + +---- + +Parent - [[CDNotesHome]] diff --git a/Distrib/CDNotesK4.mdwn b/Distrib/CDNotesK4.mdwn new file mode 100644 index 00000000..6a3b277c --- /dev/null +++ b/Distrib/CDNotesK4.mdwn @@ -0,0 +1,11 @@ +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's the page for this set of CDs. This is a place for notes and sharing info about peculiarities with this set of CDs. Past notes may be of help as well. + +## <a name="Getting_the_CDs_"> Getting the CDs. </a> + +As usual, you can find [more information here](http://www.debian.org/ports/hurd/hurd-cd). + +%COMMENT\{mode="after" id="second" button="Add Comment"\}% + +---- diff --git a/Distrib/CDNotesK5.mdwn b/Distrib/CDNotesK5.mdwn new file mode 100644 index 00000000..33a5faf4 --- /dev/null +++ b/Distrib/CDNotesK5.mdwn @@ -0,0 +1,25 @@ +[[CDNotesHome]] + +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's the Nov 28, 2003 page for this set of CDs. This is a place for notes and sharing info about peculiarities with this set of CDs. Past notes may be of help as well. + +## <a name="Getting_the_CDs_"> Getting the CDs. </a> + +As usual, you can find [more information here](http://www.debian.org/ports/hurd/hurd-cd). + +%COMMENT\{mode="after" id="second" button="Add Comment"\}% + +---- + +At <http://www.copyleft.co.nz>, unless you want to burn them yourself, then you can find ISO's at <http://ftp.gnuab.org/pub/gnu.iso/K5/> + +-- [[Main/JoachimNilsson]] - 18 Mar 2004 + +---- + +how can by cds gnu hurd. Best Regards. Noppathon + +-- [[Main/TWikiGuest]] - 18 Mar 2004 + +---- diff --git a/Distrib/CDNotesK6.mdwn b/Distrib/CDNotesK6.mdwn new file mode 100644 index 00000000..6caf97e7 --- /dev/null +++ b/Distrib/CDNotesK6.mdwn @@ -0,0 +1,21 @@ +[[CDNotesHome]] + +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's the UNRELEASED page for this set of CDs. This is a place for notes and sharing info about peculiarities with this set of CDs. Past notes may be of help as well. + +## <a name="Getting_the_CDs_"> Getting the CDs. </a> + +As usual, you can find [more information here](http://www.debian.org/ports/hurd/hurd-cd). + +%COMMENT\{mode="after" id="second" button="Add Comment"\}% + +---- + +Waiting for Xfree packages for K6 images + +<http://lists.debian.org/debian-hurd/2004/debian-hurd-200402/msg00030.html> + +-- [[Main/GrantBow]] - 03 Mar 2004 + +---- diff --git a/Distrib/CDNotesK7.mdwn b/Distrib/CDNotesK7.mdwn new file mode 100644 index 00000000..e9858deb --- /dev/null +++ b/Distrib/CDNotesK7.mdwn @@ -0,0 +1,17 @@ +[[CDNotesHome]] + +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic" \}% + +## <a name="Getting_the_CDs_"> Getting the CDs. </a> + +As usual, you can find [more information here](http://www.debian.org/ports/hurd/hurd-cd). + +* **[announcement](http://lists.debian.org/debian-hurd/2004/09/msg00084.html)** + +This is the best set to date. It features XFree86 4.3 and Grub 0.94. + +%COMMENT\{mode="after" id="second" button="Add Comment"\}% + +---- + +-- [[Main/OgnyanKulev]] - 22 Sep 2004 diff --git a/Distrib/CDNotesK8.mdwn b/Distrib/CDNotesK8.mdwn new file mode 100644 index 00000000..9da8bbd3 --- /dev/null +++ b/Distrib/CDNotesK8.mdwn @@ -0,0 +1,19 @@ +[[CDNotesHome]] + +%SEARCH\{"Mediatype.\*?value=\\"CD"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic" \}% + +## <a name="Getting_the_CDs_"> Getting the CDs. </a> + +As usual, you can find [more information here](http://www.debian.org/ports/hurd/hurd-cd). + +* **[announcement](http://lists.debian.org/debian-hurd/2004/12/msg00063.html)** + +_Main features. The 2GB partition limit has gone. The tests were made on a 20 GB partition. The 2+ years old mkfs in the GNU/Linux installation system creates the filesystem on the large partitions nicely. This means that the Linux installer has not had to be modified and so remains at "K"._ + +_GNU Nano is broken and so nano-tiny has replaced it in baseGNU and the tarball, so remember the "-tiny" bit when invoking the editor._ + +%COMMENT\{mode="after" id="second" button="Add Comment"\}% + +---- + +-- [[Main/JoachimNilsson]] - 12 Mar 2005 diff --git a/Distrib/CdCovers.mdwn b/Distrib/CdCovers.mdwn new file mode 100644 index 00000000..e8cab6fd --- /dev/null +++ b/Distrib/CdCovers.mdwn @@ -0,0 +1,3 @@ +CD Covers from [[Hurd/WebHome]] + +-- [[Main/JoachimNilsson]] - 12 Aug 2003 diff --git a/Distrib/CodeAnnouncements.mdwn b/Distrib/CodeAnnouncements.mdwn new file mode 100644 index 00000000..bee5a343 --- /dev/null +++ b/Distrib/CodeAnnouncements.mdwn @@ -0,0 +1,7 @@ +07 Oct 2002 <http://www.8ung.at/shell/dmd--0.9.tar.gz> - written by wolfgang - Daemon Managing Daemons (or Daemons-Managing Daemon?), the replacement for /sbin/init, but not for /hurd/init of course, it is 100% Guile currently so it will even work on MS-Windows maybe **g**. there is serious consideration to turn it into a translator and give it an apropriate RPC interface + +-- [[Main/GrantBow]] - 7 Oct 2002 + +\* fatfs 0.4 was [released](http://mail.gnu.org/pipermail/bug-hurd/2002-October/010576.html) Oct 6, 2002. + +-- [[Main/JoachimNilsson]] - 28 Oct 2002 diff --git a/Distrib/CrossInstall.mdwn b/Distrib/CrossInstall.mdwn new file mode 100644 index 00000000..9a07424e --- /dev/null +++ b/Distrib/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/Distrib/DebianAfterInstall.mdwn b/Distrib/DebianAfterInstall.mdwn new file mode 100644 index 00000000..b1f14d9a --- /dev/null +++ b/Distrib/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/Distrib/DebianAptOffline.mdwn b/Distrib/DebianAptOffline.mdwn new file mode 100644 index 00000000..d1915458 --- /dev/null +++ b/Distrib/DebianAptOffline.mdwn @@ -0,0 +1,52 @@ +## <a name="Installing_packages_without_havi"> Installing packages without having a network connection. </a> + +This procedure is based on <file:///usr/share/doc/apt-doc/offline.text.gz> (package apt-doc). + +Having _apt_ installed is needed to use it. + +Put <http://hurd.gnufans.org/pub/Distrib/DebianAptOffline/apt.conf.offline> into Debian GNU/Hurd's /etc/apt/. + +#### <a name="You_can_mount_your_Debian_GNU_Hu"> </a> You _can_ mount your Debian GNU/Hurd partition under another OS. + +Networked system, user root + + # mkdir SOMEWHERE + # mount /dev/DEBIAN_GNU_HURD_PARTITON SOMEWHERE + # cd SOMEWHERE + # apt-get -c etc/apt/apt.conf.offline {update, upgrade, install foo, etc.} + +Debian GNU/Hurd, user root + + # apt-get {update, upgrade, install foo, etc.} + +#### <a name="You_can_t_mount_your_Debian_GNU_"> </a> You _can't_ mount your Debian GNU/Hurd partition under another OS. + +Debian GNU/Hurd, user root + + # tar -cf SOMEWHERE/tar /etc/apt/{apt.conf.offline,sources.list} /var/lib/dpkg/status + +Copy _SOMEWHERE/tar_ to the remote system. + +_/var/lib/dpkg/status_ is needed for the remote system's _apt_ to know which packages (and their versions) are already installed on your Debian GNU/Hurd system. + +Networked system, any user + + $ mkdir debian_gnu_hurd + $ cd debian_gnu_hurd + $ tar -xf SOMEWHERE/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 SOMEWHERE/tar var/ + +Copy _SOMEWHERE/tar_ back to your Debian GNU/Hurd system. + +If you modified _etc/apt/sources.list_, don't forget to also copy it back. + +Debian GNU/Hurd, user root + + # tar -xf SOMEWHERE/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.} + +-- [[Main/ThomasSchwinge]] - 03 Aug 2005 diff --git a/Distrib/DebianDpkgArchitecture.mdwn b/Distrib/DebianDpkgArchitecture.mdwn new file mode 100644 index 00000000..c768ff4e --- /dev/null +++ b/Distrib/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/Distrib/DebianFAQ.mdwn b/Distrib/DebianFAQ.mdwn new file mode 100644 index 00000000..e66329ca --- /dev/null +++ b/Distrib/DebianFAQ.mdwn @@ -0,0 +1,87 @@ +# <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_harddisk_limit"> 2GB harddisk 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. 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="emacs_snapshot_uninstallable"> emacs-snapshot uninstallable </a> + +## <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). + +---- + +Page started. + +-- [[Main/MichaelBanck]] - 14 Mar 2006 + +Mentioned Hurd FAQ. reformated. -- [[Main/AaronHawley]] - 14 Mar 2006 diff --git a/Distrib/DebianIntegrationDeveloper.mdwn b/Distrib/DebianIntegrationDeveloper.mdwn new file mode 100644 index 00000000..8b34cb7b --- /dev/null +++ b/Distrib/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/Distrib/DebianPackages.mdwn b/Distrib/DebianPackages.mdwn new file mode 100644 index 00000000..7e09dce0 --- /dev/null +++ b/Distrib/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; 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/Distrib/DebianProductSheet.mdwn b/Distrib/DebianProductSheet.mdwn new file mode 100644 index 00000000..9d40fbd9 --- /dev/null +++ b/Distrib/DebianProductSheet.mdwn @@ -0,0 +1,13 @@ +# <a name="Debian"> Debian </a> + +## <a name="Features"> Features </a> + +## <a name="Requirements"> Requirements </a> + +## <a name="Getting"> Getting </a> + +---- + +[[MediaPressKitDiscuss]] is a draft developed in email. + +-- [[Main/GrantBow]] - 13 Jan 2003 diff --git a/Distrib/DebianStatus.mdwn b/Distrib/DebianStatus.mdwn new file mode 100644 index 00000000..71b34ae4 --- /dev/null +++ b/Distrib/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/Distrib/DebianTranslatorPolicy.mdwn b/Distrib/DebianTranslatorPolicy.mdwn new file mode 100644 index 00000000..7092a761 --- /dev/null +++ b/Distrib/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/Distrib/GNUDebianBuildProcess.mdwn b/Distrib/GNUDebianBuildProcess.mdwn new file mode 100644 index 00000000..55a9c6aa --- /dev/null +++ b/Distrib/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 & 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 & 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 & 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/Distrib/GNUDebianPackages.mdwn b/Distrib/GNUDebianPackages.mdwn new file mode 100644 index 00000000..de1798ad --- /dev/null +++ b/Distrib/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 & 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 & 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 & 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/Distrib/GnuDebianRelationship.mdwn b/Distrib/GnuDebianRelationship.mdwn new file mode 100644 index 00000000..ede808c8 --- /dev/null +++ b/Distrib/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/Distrib/GnuDistributionRumors.mdwn b/Distrib/GnuDistributionRumors.mdwn new file mode 100644 index 00000000..c9eff58c --- /dev/null +++ b/Distrib/GnuDistributionRumors.mdwn @@ -0,0 +1,9 @@ +There are clearly advantages and disadvantages to proceeding in such a manner. However the significant infrastructural problems that Debian has and continues to solve should not lightly be dismissed. + +-- [[Main/GrantBow]] - 11 Jan 2003 + +I would like to start work on a 'live' distribution. I would like to start on a bootable cd and progress towards a bootable dvd. If deb packages limit the group they could coexist with a Fink or rpm package system. + +-- [[Main/CamResu]] - 17 Sept 2003 + +<div align="right"> Related Topics: [[GnuDebianRelationship]]</div> diff --git a/Distrib/GnuOS.mdwn b/Distrib/GnuOS.mdwn new file mode 100644 index 00000000..4206527c --- /dev/null +++ b/Distrib/GnuOS.mdwn @@ -0,0 +1,60 @@ +# <a name="The_GNU_Operating_System"> </a> The GNU Operating System + +It is our wish and goal to establish a new direction for the GNU system distribution. To that end, this page will begin setting some direction. This was spawned by several discussions over a few days on the Hurd mailing lists and IRC. + +This is not intended to detract from Debian GNU/Hurd and we should help them where we can. + +I really want this to be more of a community driven effort in the spirit of say Ubuntu. We all have different motivations and skill levels but we need a common goal to get this system going. + +These are just some quick notes I am making late at night. Lets clean this up. + +## <a name="Motivations"> Motivations </a> + +1. There is a possibility that Debian drops support for GNU/Hurd. +2. Other GNU/Linux distributions do not support the Hurd infrastructure well. +3. Benefitting from the Hurd design and using a microkernel. +4. Freedom. + +## <a name="Community"> Community </a> + +1. Lets establish some ground rules. +2. We need infrastructure + * Wiki for community documentation + * Mailing lists like gnu-system-discuss exists for mostly technical items + * IRC channels like #hug and ##hurd + * Perhaps less formal and less intimidating channels and mailing lists would involve broader parts of the community +3. We need a community vision and direction. + * Lets work together for a common goal + * Lets establish goals and priorities and get resources on them. (More later) + * Major goal to create a system making full use of Hurd features? + * We should never hesitate to throw away existing stuff whenever it hinders us to make good use of Hurd features + * However, we should try to reuse existing stuff (from Debian for example) as long as it doesn't limit our possibilities or impose considerable overhead + * Lets have fun. It's GNU and it's important but let's enjoy ourselves. + +## <a name="Tools"> Tools </a> + +1. Developer Needs + * RPC Trace +2. Installer + * Native installer would be preferred but we can bootstrap GNU/Linux for now if necessary +3. Package Management + * There is a proposal to use stowfs. Let's get this going and test it out. Can it be made to work? How long will it take? + * Repository for packages + * Probably we can host it on the GNU servers + * Bug / Issue tracking + * Probably we should set up a Savannah project + * How to handle experimental patches to the core packages (Hurd, Mach, libc etc.) that are not in official CVS yet? + +## <a name="Todo"> Todo </a> + +1. AMS had made a GNU release. We can try it and test it to good use. We can fix broken things in it, and enhance it. + * The snapshot is very old. Probably better to build something from current stuff, even if it means more work + * ams said that he would like to get a new snapshot out that would be on a Live CD and using stowfs. I think what we need to do is start using/fixing GNU System Creator (GSC) to build packages for this effort. +2. GNU is all about freedom AND ease of use. So, given installers are by nature quite complex, how should we install GNU on users's computers? I think ams's GSC comes into play here, maybe ams or sdschulze could (re-)write specifications of GSC. +3. Until we have an installer ready, we could go the Gentoo-like route, and have every part manually installed. A good installation documentation may help. Our next milestone may be just this (in case ams hasn't already done it): + * have a good installation document out, with all the required packages hosted at gnu.org or savannah.org + * get stowfs working +4. Maybe try to use hacked Debian packages until we get native ones? +5. Move on, start coding, documenting, packaging. + +I tried refactoring this page, but didn't get far. -- [[Main/AaronHawley]] - 18 Feb 2006 diff --git a/Distrib/GnuSystem.mdwn b/Distrib/GnuSystem.mdwn new file mode 100644 index 00000000..d643dab5 --- /dev/null +++ b/Distrib/GnuSystem.mdwn @@ -0,0 +1,3 @@ +GNU System + +-- [[Main/AndrewResch]] - 26 Jul 2005 diff --git a/Distrib/GrubConf.mdwn b/Distrib/GrubConf.mdwn new file mode 100644 index 00000000..b26a914b --- /dev/null +++ b/Distrib/GrubConf.mdwn @@ -0,0 +1,7 @@ +Main project page: <http://grubconf.sf.net> + +A Debian [Request for Package](http://bugs.debian.org/181429) has been filed. + +This tool is only at version 0.2 and seems started very recently, so any input about it's usefulness would be helpful. + +-- [[Main/GrantBow]] - 18 Feb 2003 diff --git a/Distrib/GrubNotes.mdwn b/Distrib/GrubNotes.mdwn new file mode 100644 index 00000000..b0b1fdf5 --- /dev/null +++ b/Distrib/GrubNotes.mdwn @@ -0,0 +1,70 @@ +This section complements the [[InstallNotes]] with complete information regarding the GRUB boot loader. The syntax is different from Lilo's and so to scratch my own itch I'm creating this quick reference. The [Grub manual](http://www.gnu.org/software/grub/manual/grub.html) is another good reference. + +* update-grub is **Debian specific** and very nice. It will automatically create a /boot/grub/menu.lst file for the kernels in /boot/. It will also append a manually configured set for other partitions like the GNU/Hurd. +* grub-floppy is a **Debian specific** boot floppy creation script. +* mkbimage is a **Debian specific** boot disk image creation script. +* <http://khazad.dyndns.org/packages/grub-disk/> contains a Debian packaged makefile for creating CD & floppy images. Looks like it doesn't work properly. If you fix it, please send patches to the maintainer. +* essential GRUB commands & disk syntax + * root + * kernel + * module + * boot +* sample file + + title GNU/Linux + root (hd0,11) + kernel /boot/vmlinuz-2.4.18 root=/dev/hda12 ro + initrd /boot/initrd.img-2.4.18 + savedefault + + title GNU + root (hd0,15) + kernel /boot/oskit-mach root=device:hd0s16 -- + 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) + savedefault + + title DOS + rootnoverify (hd0,0) + chainloader +1 + +-- [[Main/GrantBow]] - 01 Oct 2002 <br /> -- [[Main/GrantBow]] - 22 Dec 2002 + +Another example, just as good, but a lot easier to read. The backslash at the end of each line is to "escape" the enter-key. So make sure there are no spaces following the backslashes! + + title GNU/Linux (Linux 2.4.18) + root (hd0,11) + kernel /boot/vmlinuz-2.4.18 root=/dev/hda12 ro + initrd /boot/initrd.img-2.4.18 + savedefault + + title GNUmach 1.3 + root (hd0,1) + kernel /boot/gnumach.gz root=device:hd0s2 + module /hurd/ext2fs.static --readonly \ + --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) + + title GNUmach 1.90 (CVS) + root (hd0,1) + kernel /boot/oskit-mach.gz root=device:hd0s2 -- + module /hurd/ext2fs.static --readonly \ + --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) + +Note the differences between GNUmach and OSKit-Mach. The latter **needs** the two dashes after the root specification! + +-- [[Main/JoachimNilsson]] - 09 Nov 2002 diff --git a/Distrib/HurdOnQEMU.mdwn b/Distrib/HurdOnQEMU.mdwn new file mode 100644 index 00000000..fc1b1a49 --- /dev/null +++ b/Distrib/HurdOnQEMU.mdwn @@ -0,0 +1,91 @@ +# <a name="Hurd_on_QEMU"> </a> Hurd on QEMU + +## <a name="What_is_Needed"> What is Needed </a> + +1. First thing is to install [[QEMU]]. +2. [Debian grub boot disk package](ftp://ftp.debian.org/debian/pool/main/g/grub/) for the floppy disk image needed for booting. You should get the [0\.95 version](ftp://ftp.debian.org/debian/pool/main/g/grub/grub-disk_0.95+cvs20040624-17_all.deb) as anything later doesn't seem to work properly. The floppy boot image is called `grub-*-i386-pc.ext2fs.gz` and you will need to decompress this. I have renamed mine to `floppy.img`. +3. You will need a [Debian/Hurd installation CD](http://www.debian.org/ports/hurd/hurd-cd). I suggest using K9 as K10 seems to have some issues. + +## <a name="Installing_Debian_Hurd_with_QEMU"> </a> Installing Debian/Hurd with QEMU + +First off you will need to create a disk image using `qemu-img`. I have set mine to 2 gigabytes, although you should be able to get away with less. + + $ qemu-img create hd0.img 2G + +Next you will want to start up QEMU and begin the installation process. The first time you run it you will want to use the `-boot d` option to boot off the cdrom. + + $ qemu -hda hd0.img -cdrom debian-K9-hurd-i386-CD1.iso -fda floppy.img -boot d + +Now at his point do the regular install using `hd0` as your harddrive. Partition it and install the base system. Once you have finished installing the base system select the reboot option as this will ensure the disk is properly un-mounted. When the Debian CD menu comes up again simply close QEMU. + +Now run your image with floppy booting and finish the install (`./native-install` .. etc). + +**Important:** Notice the `-M isapc` option. This is needed for the version of gnumach that comes with K9 (or K10). Once you get your system running you can update to the latest version of gnumach which does not have this restriction. + +**Important:** If you are running an older version of QEMU (less than 0.8) then you will need to use the `-isa` option instead of `-M isapc`. + + $ qemu -hda hd0.img -cdrom debian-K9-hurd-i386-CD1.iso -fda floppy.img -boot a -M isapc + +## <a name="Mounting_Disk_Image_on_Host"> Mounting Disk Image on Host </a> + +You may wish to mount your disk image on your host system to transfer files. To do this you will first need to find the offset of the partition you wish to mount. + + # fdisk -ul hd0.img + ... + 128 heads, 63 sectors/track, 0 cylinders, total 0 sectors + Units = sectors of 1 * 512 = 512 bytes + + Device Boot Start End Blocks Id System + hd0.img1 * 63 3515903 1757920+ 83 Linux + hd0.img2 3515904 4193279 338688 82 Linux swap / Solaris + +Now take the number of sectors for the beginning of the partition and multiply it by the sector size. My partition starts at sector 63 and I have a sector size of 512 therefor my offset is 32256. + + # mount -o loop,offset=32256 hd0.img /mnt/diskimage + +## <a name="Networking_in_QEMU"> </a> Networking in QEMU + +### <a name="What_is_Needed"> What is Needed </a> + +1. Your Linux kernel will need 802.1d Ethernet Bridging support and TUN/TAP device driver support. +2. You will need to install [bridge-utils](http://bridge.sourceforge.net). + +### <a name="Setting_Up_the_Host_Bridge"> Setting Up the Host Bridge </a> + +You need to setup a bridge on the host first. This assumes `eth0` is down. I have modified my hosts network startup scripts to automatically setup a bridge, you may want to do this also. + + # brctl addbr br0 + # ifconfig eth0 0.0.0.0 promisc up + # brctl addif br0 eth0 + +At this point you will need to setup `br0` as you would normally `eth0` (`dhcpcd br0` for example). + +### <a name="The_qemu_ifup_Script"> The qemu-ifup Script </a> + +This script gets called when QEMU starts and will attach the tun device to the bridge. QEMU will look for this file at `/etc/qemu-ifup` and that is where I keep mine. + + #!/bin/sh + sudo ifconfig $1 0.0.0.0 promisc up + sudo brctl addif br0 $1 + +### <a name="Setting_up_the_Network_in_the_Hu"> Setting up the Network in the Hurd </a> + +Now it is time to start-up your QEMU Hurd system and get networking going in there. + +**Important:** Remember you may need to use the `-M isapc` or `-isa` flag if using an older version of the gnumach package. + + $ qemu -hda hd0.img -cdrom debian-K9-hurd-i386-CD1.iso -fda floppy.img -boot a -net nic -net tap + +Once you have logged in as `root` run the `pfinet` translator with values that apply to your network. Think of your QEMU client as another computer in your network. + + # settrans -fgap /servers/socket/2 /hurd/pfinet -i eth0 -a xxx.xxx.xxx.xxx -g xxx.xxx.xxx.xxx -m xxx.xxx.xxx.xxx + +That should do it! Do not forget to edit/update `/etc/resolv.conf` to get DNS working. + +## <a name="Related_Links"> Related Links </a> + +These are links that users of [[HurdOnQEMU]] may find helpful. + +[[DebianAfterInstall]] - good source of information pertaining to your system after installation. + +[[Hurd/QemuImageForL4]] - a QEMU image for the Hurd/L4 project. diff --git a/Distrib/HurdWnpp.mdwn b/Distrib/HurdWnpp.mdwn new file mode 100644 index 00000000..49e069de --- /dev/null +++ b/Distrib/HurdWnpp.mdwn @@ -0,0 +1,19 @@ +While Debian Developers and users use the official [WNPP](http://www.debian.org/devel/wnpp/) (Work Needed and Prospective Packages) page, a system of special bugs in the [Debian Bug Tracking System](http://bugs.debian.org/), this page is intended to give another location (and method) for giving feedback and provide status for developers of the Hurd. Please simply add a package name, the person's name sho's porting it, possibly with URL or as a separate page if you have relevant notes on the package. + +This data is for porting purposes only. Any conflict between the Debian BTS data and the data here should be resolved in favor of the Debian BTS. It's hoped this page will allow people to keep notes on packages that need some care. + +Packages in need of porting help: + +* Ported packages up for adoption + +* Ported orphaned packages + +* Packages currently being ported + +* Rewritten/replaced packages + * fakeroot - [status](http://mail.gnu.org/pipermail/bug-hurd/2002-May/008322.html) + +* Requested packages + * [Entropy Gathering Daemon](http://bugs.debian.org/145498) - Mako Hill + +-- created 19 May 2002 diff --git a/Distrib/InstallNotes.mdwn b/Distrib/InstallNotes.mdwn new file mode 100644 index 00000000..418caca1 --- /dev/null +++ b/Distrib/InstallNotes.mdwn @@ -0,0 +1,296 @@ +Items of interest during install not mentioned elsewhere include the following. Arranged in the same order as Neal Walfield's [install guide](http://web.walfield.org/papers/hurd-installation-guide/english/hurd-install-guide.html) - (link is currently broken - see below for current instructions). + +**_Currently, [Debian's installation instructions](http://www.debian.org/ports/hurd/hurd-install) are the most up-to-date._**<br /> Note the mirrors mentioned on debian.org have no hurd iso's. The iso's can be found [Here](http://ftp.gnuab.org/pub/gnu.iso) + +## <a name="Table_of_Contents"> Table of Contents </a> + +%TOC% + +## <a name="1_Overview_Where_we_are_going"> 1. Overview - Where we are going </a> + +There are currently four methods to install GNU + +1. Tarball - The current documentation, for the tarball method, are [Debian's installation instructions](http://www.debian.org/ports/hurd/hurd-install), based on the original guide by Neal Walfield. The GNU official [installation page](http://www.gnu.org/software/hurd/install.html) is the canonical reference. See [[Distrib/TarballNotesHome]] for more info. +2. [[Distrib/BochsEmulator]] is an x86 emulator similar to the propietary [[Distrib/VmWare]] (which is not supported). See the [[Distrib/BochsEmulator]] page for more info. The Bochs project hosts a preinstalled GNU image that is periodicaly updated. You can get the latest one [here](http://sourceforge.net/project/showfiles.php?group_id=12580). +3. [CD-ROM iso images](http://www.debian.org/ports/hurd/hurd-cd) CD-ROM installs are becoming more and more popular. The CDs are based on the most current tarball at release time. See [[Distrib/CDNotesHome]] for more info. +4. The [crosshurd](http://packages.debian.org/crosshurd/) Debian package, which can be used instead of a tarball to install the base system. This is the recommended way to proceed. + +* References to a `cross-install` script can nowadays be completely ignored by anyone not a maintainer. It is only used when creating a new tarball. + +## <a name="2_Real_Estate_or_Finding_A_Home"> 2. Real Estate or Finding A Home </a> + +For those who do not happen to have an available partition or an extra hard drive, this can be the longest step. In this case, we will need to repartition the hard drive. One solution is to use GNU's partition editor, Parted. It features not only basic partition editing, but also partition resizing and moving functions. It can be found at <http://www.gnu.org/software/parted>. The manual is quite complete and includes several tutorials. Also there's a frontend called [nparted](http://packages.debian.org/unstable/utils/nparted.html) to simplify usage. + +The Hurd can only support partition sizes of up to approximately one gigabyte; anything much larger than this will not work. This limitation is a design decision that was made several years ago in which the file system server maps the entire partition into virtual memory. As the amount of virtual memory available on an ia32 is only four gigabytes of which only two gigabytes are available to the application and, of that, a significant portion is reserved for the code, the stack and the heap, the final, maximum contiguous virtual memory area that is left is generally about one gigabyte. This limitation is scheduled to be remove. Several other items, however, currently have a slightly higher priority. + +Having said that, a single one gigabyte partition is more than enough for a working system. Many, however, prefer at least two partitions: one for a root partition and another for a home partition. This latter scheme is highly advised for developers interested in debugging Hurd servers. + +The Hurd supports several extensions to the ext2fs file system format. Foremost among these are passive translators and a fourth set of permission bits for unknown users. In order to take advantage of these features, however, the owner of the partition must be set to Hurd. `mke2fs`, unless specifically overridden on the command line, will set the owner to whatever system core it is running on. As the Hurd will diligently respect this setting, we must be careful to set this appropriately or the Hurd may fail in subtle ways. Be aware that even if a file system is owned by a particular system core, others may still use it; they just may not be able to use certain extensions. + +To create a file system, we use `mke2fs` and pass it `-o hurd` to designate the Hurd as the owner of the new file system. For instance: + + mke2fs -o hurd /dev/DEVICE + +**_Note:_** You may wish to add a `-b 4096` option to `mke2fs` (the default is chosen depending on the size of the partition, and the support for block size 1024 is buggy). The command to check the block size is `tune2fs -l /dev/hda9` under GNU/Linux. + +## <a name="3_The_Boot_Loader_Getting_GRUB"> </a> 3. The Boot Loader - Getting GRUB + +GRUB is the bootloader of the GNU system, and it's currently the only one that supports the multiboot standard, necessary to boot the Hurd. + +A word about GRUB. Unlike traditional boot loaders on the x86, such as LILO, GRUB is very powerful. It has a command line interface, bootp, dummy terminal support and a plethora of other features. In addition, it can boot most any operating system. If you have ever booted an alpha or sparc, you will understand what GRUB can do. Therefore, do not be scared: GRUB is better. You will like it. You will not go back. + +To find GRUB, visit <ftp://alpha.gnu.org/gnu/grub>. Here, there is a source tarball and a floppy image. If you choose to download the tarball, it is a normal configure, make and make install. Included is a wonderfully complete manual on how GRUB works. Read it. If, on the other hand, you choose to download the floppy image, it is sufficient to dump it to a floppy disk to get a working GRUB: + + dd if=grub-boot-VERSION.image of=/dev/fd0 + +You can always install GRUB onto your hard drive at a later date. + +For instructions on using GRUB, see either the info documentation or the quick reference notes on this wiki: + +* [[Distrib/GrubNotes]] - quick reference + +## <a name="4_Cross_Install_Cross_Installing"> </a> 4. Cross Install - Cross Installing GNU + +The recommended way to cross install the Hurd is by using the [crosshurd](http://packages.debian.org/crosshurd) Debian package. Unfortunately, it's broken right now (2003-10-10), so you'll have to use the old tarball method. + +Download the base system `gnu.tar.gz` from <ftp://alpha.gnu.org/gnu/hurd/contrib/robertmh/> . + +The tarball is setup to extract everything into the current directory. After mounting the partition and changing to the mount point, we just need to extract the archive. In the following example, we assume that the root partition is mounted on `/gnu`. + + cd /gnu + tar --same-owner -xvzpf ~/gnu.tar.gz + +**_NOTE:_** This should NOT be confused with the `cross-install` script method. It is only used by maintainers when creating a new tarball. + +## <a name="5_Booting_GNU"> </a> 5. Booting GNU + +Now things are setup to boot GNU for the first time. Verify that the GRUB boot disk is in the drive and reboot. If all goes well, a GRUB menu will be displayed. Hit c for the GRUB command line. + +First, the root file system needs to be set. GRUB uses a partition nomenclature that is a bit different from either GNU or GNU/Linux: both IDE and SCSI drives are named `(hdN)`. `N` is the drive number (zero based) as reported by the BIOS. That is, GRUB makes no distinction between IDE and SCSI disks. The partitions, like the disks, are also indexed numerically from zero: `(hdN,M)`. If this sounds bad, relax: GRUB is also helpful. + +To determine on which file system a particular file resides, one method is to use the find command. When issued this command, GRUB searches on each file system for the specified file and prints where is was found. Here we search for the kernel, `/boot/gnumach.gz`. + + grub> find /boot/gnumach.gz + (hd0,0) + +As we can see, GRUB is indicating that `/boot/gnumach.gz` is on `(hd0,0)`. Thus, we set the root respectively: + + grub> root (hd0,0) + Filesystem type is ext2fs, partition type 0x83 + +Next, GNU Mach needs to be loaded. In addition to loading the binary, at least one option, the root partition, must be specified. This will be used by the Hurd itself. As such, it must be in terms that the Hurd can understand. + +GNU Mach labels disks starting at zero. IDE drives are prefixed with hd, while SCSI disks are prefixed with sd. Like GNU/Linux, drives are number by their position on the controller. For instance, the primary master is `hd0` and the secondary slave is `hd3`. Partitions use the BSD slice naming convention, and append `sM` to the drive name to indicate a given partition. Note that `M` is a one, not zero, based index. The slice number is simple to calculate: just increment what you used for GRUB by one. + +Since the Hurd has not yet been configured, it must be run in single user mode. Adding a `-s` to the kernel command line is all that is required. + +Thus, continuing with the above example and assuming that the first drive in the master on the secondary controller, we would have: + + grub> kernel /boot/gnumach.gz root=device:hd2s1 -s + [Multiboot-elf, ...] + +NOTE: If after running this command you see GRUB Error 28, according to the [GRUB Troubleshooting](http://www.gnu.org/software/grub/manual/grub.html#Troubleshooting) documentation, you may need to tell grub that you have more memory by using the uppermem command. For example, if you have 256MB of RAM and running **displaymem** within GRUB shows that you have less memory than that, you can type **uppermem 262144** to tell GRUB about the additional memory. + +Next, the root file system server and the exec server must be loaded. This is done using GRUB's boot module capability. The parameters are the semantics by which the kernel passes some important values to the servers. + + grub> 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) + + [Multiboot-module 0x1c4000, 0x2cfe6a bytes] + grub> module /lib/ld.so.1 /hurd/exec $(exec-task=task-create) + [Multiboot-module 0x494000, 0x27afe bytes] + +**_Important:_** each module string should be asingle separate line _or_ line wrapped with a backslash at the end of each line. Remember to make sure there are **_no trailing spaces!_** Adding this to GRUB's `menu.lst` file as soon as possible is advised. + +Finally, GNU can be booted: + + grub> boot + +Sit back and watch the messages. This is actually more important than one might think as there is a bug in GNU Mach whereby hitting a key during the boot process causes the kernel to panic. + +If GNU fails to boot, it could be due to shared IRQs: GNU Mach does not play well with these. You can verify your situation by looking at, for instance, the `/proc/interrupts` file under GNU/Linux. Also, as GNU Mach does not support loadable kernel modules, many of the drivers are compiled into the default kernel. If you have old peripherals, this can be a significant problem: a device may respond badly to a probe intended for a different device. Building a new kernel with only the required devices drivers will usually solve this problem. GNU Mach is easily cross compiled. If you are running Debian, try the `gcc-i386-gnu` package. + +If this does not help, explore the resources listed at the end of this document. Finally, ask on the appropriate mailing list. + +There are some cavaets to the boot process: + +* **IMPORTANT!** Remember when first booting into your freshly un-tarred distribution, you must pass the `-s` option to `/boot/gnumach.gz`. Failure to do so means that you won't get single-user mode. +* **IMPORTANT2!** Add the `--readonly` flag to the file system server in your GRUB `menu.lst` file. This is a work-around to get `fsck` working properly. Don't forget, everything must be on ONE line, or ended with a backslash! +* **IMPORTANT3!** If you have created the filesystem with a later version of e2fsprogs than the one installed in the tarball, it **might** happen that fsck fails and you can't boot multiuser. The workaround is to copy `/bin/true` into `/sbin/e2fsck` and `/sbin/fsck.ext2`, then boot multiuser and install the latest e2fsprogs. + + title GNU (kernel GNUmach 1.3) + root (hdX,Y) + kernel /boot/gnumach.gz root=device:hdXs(Y+1) + module /hurd/ext2fs.static --readonly \ + --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) + +Where `hdX,Y` is the appropriate hard disk and partition number, in GRUB format. `hdXs(Y+1)` is the GNUmach format - because Mach partitions start at 1, unlike GRUB partitions that start on 0 (zero). + +It is important that each module string is only a single separate line, or by escaping the EOL (end of line) with a back slash. Remember though to make sure there are **_no trailing spaces!_** + +**_GRUB floppy and iso images:_** These are available from <http://www.copyleft.co.nz/links.html>. These have been built with the correct strings and only the root and boot partitions names need to be editied. + +## <a name="6_Native_Install_Finishing_the_I"> 6. Native Install - Finishing the Installation </a> + +Once a prompt comes up, and any time that the the Hurd is in single user mode, it is necessary to set the terminal type: + + export TERM=mach + +(Repeat this each time you boot in single user mode) + +Be warned that CONTROL-C and family will not work in single user mode. + +We can now run the native-install script. This will configure the packages and set up several important translators: + + ./native-install + +Right before the script terminates, it will indicate that it needs to be run a second time. Follow its instructions and reboot using the reboot command. Again, go into single user mode. + +Now it is advisable to enable swap. The mach kernel dislikes running without swap and is unlikely to last through the installation, especially on systems with little physical RAM. Although you can enable swap later on after running `./native-install` for the second time, turning swap on early increases your probability of getting there. + +This will start the default pager, create a device corresponding to the swap partition, and turn swap on on that partition: + + /hurd/mach-defpager + cd /dev + ./MAKEDEV hdXsY + swapon /dev/hdXsY + cd / + +**IMPORTANT!** When enabling swap please be very sure that the partition really is swap. If you point `swapon` to a data partition it will use that for swap, overwriting any data you may have there. + +Now run `./native-install` for the second time and go through a series of prompts. + +Next, edit `/etc/fstab` to add the home partition and swap space. By default, `nano` is the only editor installed by the the base distribution (not `ae` nor `vi`). It is very important that swap space be used: the Hurd will be an order of magnitude more stable. Note that the Hurd can transparently share a swap partition with Linux, the kernel, but will happily page to any device including a raw partition such as your home partition. + +Here is an example `/etc/fstab` file: + + # <file system> <mount point> <type> <options> <dump> <pass> + /dev/hd2s1 / ext2 rw 0 1 + /dev/hd2s2 /home ext2 rw 0 2 + /dev/hd2s3 none swap sw 0 0 + +Remember to create any devices using the `MAKEDEV` command. + +When you first boot, your `/home` directory will _not_ be auto-mounted. You must set a passive translator on that node to access that partition. The correct syntax for this is: <br />`settrans -p /home /hurd/ext2fs /dev/hd2s2` + +To mount an nfs partition, use the nfs translator. When run as non-root, the translator will connect, for obvious reasons, to the nfs server on a port above 1024. For this to succeed under GNU/Linux, the insecure option must be added to the export line. Here is an example `/etc/exports` file: + + /home 192.168.1.2(rw,insecure) + +To mount this from a GNU box: + + settrans -cgap /home /hurd/nfs 192.168.1.1:/home + +## <a name="7_Configuration_Making_the_Syste"> 7. Configuration - Making the System Usable </a> + +See [[DebianAfterInstall]] for complete, up to date instructions. + +* 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. + * Run `adduser` to give yourself a user account. _Do not_ use root indiscriminately. + * Run `MAKEDEV` to create devices in `/dev` for your hard disk and other required devices. + * 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]] + * 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. + +* Prepare system for new packages. + * See [[DebianAfterInstall]] for up to date instruction on how to setup apt-get mirrors. + * There are some extremely useful cross-platform 'apt' tricks that can be used to get packages when using Debian GNU/Linux (possibly others) for installation on GNU. This is especially useful if your GNUMach doesn't recognize your network card. The steps are covered in the file `/usr/share/doc/apt-doc/offline` which has been used by several Hurd developers successfully. + * create an `/etc/apt/apt.conf.offline` like [[AptConfOffline]]. + * consider setting up a few [[CrossPlatformAliases]] for use under Debian GNU/Linux while the Debian GNU/Hurd partitions are mounted. + * select the `apt` method from within dselect. + +* [[Xfree86]] + +* New packages - Hopefully you are able to get your network working but since the default GNUMach is only configured for a few ethernet cards you may need to recompile your GNUMach to get it working with your network hardward. + * Install these extremely useful packages + * `dialog` -- Debconf uses this for interactivity. You should install this first to allow you to configure other packages as they are installed. + * It's a very good idea to bring your packages up to date by running: `apt-get update && apt-get dist-upgrade` + * Some recommended packages + * `screen` -- A terminal multiplexer was important because the Hurd didn't have virtual consoles. Now you can have the [[Hurd/HurdConsole]], but screen is still handy. + * `anacron` -- good to run cron jobs for a machine that is not on all the time. + * `emacs21` -- a powerful editor. + * `cvs` -- Concurrent Version System, you'll probably need this soon. + * `bzip2, zip, unzip` -- compression tools. + * `build-essential` -- preparing to build software. + * `gnu-standards` -- GNU coding and package standards. + +* Some packages use an erroneous dependency on `libc6-dev`. This is incorrect because libc6 is specific to GNU/Linux. The corresponding package for GNU is `libc0.3-dev`. If you find a package that is uninstallable due to a `libc6[-dev]` dependency, please send a bug report with a patch that fixes it. It is important that you don't hack your package system to workaround such problems, because that way you won't be able to spot them when they arrive. See the [[Distrib/PortingIssues]] for details about the problem and [[Distrib/BtsFiling]] for details on sending bug reports. +* Edit your `/etc/inetd.conf` and comment out all the services you don't need. Services that probably don't need to be running are `ftp`, `telnet`, `shell`, `login`, and `exec`. +* There appears to be a bug in `libnss-db` that causes networking to fail. To work around this edit `/etc/nsswitch.conf` and remove the `db` entries. (See <http://www.geocrawler.com/archives/3/333/2001/1/50/4907699/> ) + +* You may want to check the [[PackageTroubleshooting]] page if you are having trouble installing and making work some Debian packages. + +## <a name="8_Final_Words_The_FAQ"> </a> 8. Final Words - The FAQ + +* [[FrequentlyAskedQuestions]] - More than frequently asked questions + +* [Hurd FAQ](http://web.walfield.org/papers/hurd-faq/) + +* [[KnownHurdLimits]] - Limitations of the GNU operating system + +## <a name="9_Works_Cited_Referenced_Materia"> 9. Works Cited - Referenced Materials </a> + +On Sept 20, 2002 [[Main/DeepakGoel]] (a self-proclaimed newbie) posted a link to his personal [step-by-step installation](http://24.197.159.102/~deego/pub/hurd/install-guide/install.txt). The parent directory has additional material. + +Tarball Notes: [[Distrib/TarballNotes20020816]] [[Distrib/TarballNotes20020523]] + +CD-ROM Notes: [[Distrib/CDNotesJ2]] + +Others who wish to post summaries of their installation experiences are encouraged to do so. The installer methods, package dependencies and file locations frequently do change without warning. + +---- + +## <a name="Licensing"> Licensing </a> + + This work is based on the hard work by [countless Hurd users](http://web.walfield.org/papers/hurd-installation-guide/THANKS), documented and maintained by Neal H. Walfield. See the original for both reference and its licensing at <http://web.walfield.org/papers/hurd-installation-guide/> + +The license for Neals work is under the [GNU GPL](http://web.walfield.org/papers/hurd-installation-guide/COPYING). However, in the Hurd Wiki license all content under the GNU FDL. (Unless the topic is mostly code or otherwise stated in the text.) + +There are currently issues to be resolved around this matter, as far as I understand at least. Until an agreement can be reached this text, and the unclear status of this topic, will remain. The suggestion is to do something like this: + +<dl> + <dt>[[InstallGuide]]</dt> + <dd> Neals Install Guide in its original form </dd> + <dt>[[InstallNotes]]</dt> + <dd> Or [[InstallGuideErrata]] with all user input and additions </dd> +</dl> + +There are several obvious issues with this as I can see + +1. The [[InstallGuide]] must be kept editable by a select few people to avoid the current situation from repeating itself. +2. This loops back and kicks us in the butt because then we get: + 1. Synchronization problems with the original work + 2. Bottle necks: The people with edit access are too busy to synchronize with Neals guide + 3. Diverging guides +3. Annoyed users, we break the tradition of freely editable wiki content and we also have two guides saying different things. + +-- [[Main/JoachimNilsson]] - 29 Dec 2002 + +## <a name="Blame_annotations"> Blame annotations </a> + + -- [[Main/SimonLaw]] - 29 May 2002 <br /> -- [[Main/GrantBow]] - 13 Oct 2002 <br /> -- [[Main/JoachimNilsson]] - 14 Nov 2002 <br /> -- [[Main/RobertMillan]] - 21 Nov 2002 <br /> + +First effort at straightening out the formatting mess ... added references to Neals' original, which this topic has become heavily based on. + +-- [[Main/JoachimNilsson]] - 19 Dec 2002 <br /> + +Updated to the latest short-comings in the Hurd. + +-- [[Main/OgnyanKulev]] - 11 Oct 2003 + +-- [[Main/TWikiGuest]] - 07 Dec 2003 (<r2q2@rocketmailNOSPAM.com>) + +Updated iso information diff --git a/Distrib/InstallTips.mdwn b/Distrib/InstallTips.mdwn new file mode 100644 index 00000000..4cf322f3 --- /dev/null +++ b/Distrib/InstallTips.mdwn @@ -0,0 +1,115 @@ +Before reading these instructions, be sure you are familiar with the [[InstallNotes]]. + +## <a name="Table_of_Contents"> Table of Contents </a> + +%TOC% + +## <a name="1_Setting_up_the_filesystems"> 1. Setting up the filesystems </a> + +You will need to boot a linux capable of internet access and creating/mounting ext2 partitions. I recommend [tomsrtbt](http://www.toms.net/rb/) linux which fits nicely onto a floppy and although a bit old will work well. + +Once in linux, you will need to create the partitions with fdisk. If you need to reboot, you will be notified. Make sure your partitions are not more than 2gig, or not even close. I learned this the hard way. This is for version 9-17-2004, newer versions should not have this problem. + +Assuming your root partition is on the first partition of the primary master run: + + mke2fs -o hurd /dev/hda1 + +If you do not have enough memory to do this, you will need to create a swap partition using mkswap and enable it with swapon before running mke2fs. + +## <a name="2_Getting_online"> 2. Getting online </a> + +Now you will need to get online to download the needed base system. To do this check to see if you are already online. + +If not, check the network by issuing ifconfig. If you have a device but it is not listed correctly, refer to the documentation on ifconfig to set it correctly. Even if you have dhcp you can usually issue a static ip that is in the correct range. An example may read: + + ifconfig eth0 up 192.168.1.9 netmask 255.255.255.0 + +Now setup the default gateway replace with your gateway + + route add default gw 192.168.1.1 + +you may need to issue "route del default" a few times to remove incorrect routings. + +Now just edit /etc/resolv.conf and put in your nameserver and you should be set. + +## <a name="3_Downloading_the_tar"> 3. Downloading the tar </a> + +Mount the filesystem to a directory (/mnt works) and cd to this directory. + +Download the latest tar of the debian system <http://eu.hurd.gnuab.org/pub/debian/base/> or another working link, the file will probably be in the format: debian-gnu-hurd-yyyy.mm.dd.tar.gz + +use wget for the full path + +now assuming tomsrtbt linux issue: + + gzip -d<debian-gnu-hurd-yyyy.mm.dd.tar.gz|tar -xvf - + +replacing yyyy.mm.dd appropriately + +## <a name="4_Configuring_GRUB"> </a> 4. Configuring GRUB + +Download the floppy image of grub with ext2fs support to a temporary directory, it can be found here: <ftp://alpha.gnu.org/gnu/grub/> write it to a blank floppy + + dd if=image of=/dev/fd0 + +now mount the floppy and copy the files to your partition + + mount /dev/fd0 /fl + cd /fl/boot + cp -R grub /mnt/boot + +you may also wish to put my menu.lst file in your grub directory which can be obtained here <ftp://firethroat.com/hurd/menu.lst> you will need to edit it to include a -s at the end of the line starting with kernel. Be sure modify the partition numbers, my system is using the third partition of the second harddrive. + +More detailed samples for grub config files can be found at the [[GrubNotes]] + +To install grub reboot using the grub floppy and issue: + + root (hd1,2) + setup (hd0) + +this will use the grub installed on the third partition of the second harddrive and install it to the master boot record of the first hard drive. + +Now reboot without the floppy, be sure to use the option -s at the end of the grub line starting with kernel= to start in single user mode. + +## <a name="5_Booting_GNU"> </a> 5. Booting GNU + +You should have booted the kernel now, check output to see if it detects your network card. My smc card did not work so I switched to a 3com card. + +You are now at step 6 of the [[InstallNotes]]. Follow these instructions to complete the installation. + +## <a name="6_Final_notes"> 6. Final notes </a> + +Be sure to issue + + apt-get update + apt-get upgrade + +Before running x run the console + + console -d vga -d pc_kbd --repeat=kbd -c /dev/cons /dev/vcs + +This forwards the keyboard device so x can use it. It also gives you 6 virtual terminals. I have had problems using it to forward the mouse, the system would lock. To exit issue ctrl+alt+backspace + +To get a sample XF86Config-4 issue: + + X -configure + +My file is available <ftp://firethroat.com/hurd/XF86Config-4> but it uses a serial mouse. You can use settrans to get mouse input (this is the prefered method) or accessing it directly works. + +## <a name="7_Works_Cited_Referenced_Materia"> 7. Works Cited - Referenced Materials </a> + +[[InstallNotes]] -- Neal H. Walfield's Install Guide + +[Grub Install Guide](http://www.gnu.org/software/grub/manual/html_node/Installing-GRUB-natively.html) + +[tomsrtbt linux](http://www.toms.net/rb/) a general purpose linux distribution on 1 floppy. + +A lot of help in the chat room [[Hurd/HurdIRC]]. + +---- + +## <a name="Licensing"> Licensing </a> + +The license for this info work is under the [GNU GPL](http://web.walfield.org/papers/hurd-installation-guide/COPYING). However, in the Hurd Wiki license all content under the GNU FDL. (Unless the topic is mostly code or otherwise stated in the text.) + +-- [[Main/SeanDEpagnier]] - 25 Dec 2004 diff --git a/Distrib/MediaPressKitDiscuss.mdwn b/Distrib/MediaPressKitDiscuss.mdwn new file mode 100644 index 00000000..e8b1cfff --- /dev/null +++ b/Distrib/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? & 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/Distrib/NewDebianInstaller.mdwn b/Distrib/NewDebianInstaller.mdwn new file mode 100644 index 00000000..8d210c91 --- /dev/null +++ b/Distrib/NewDebianInstaller.mdwn @@ -0,0 +1,15 @@ +Noted in the Debian [weekly news](http://www.debian.org/News/weekly/2002/46/), here's the home page for new new Debian installer efforts. Plans are to have a Beta version available by January 2003. + +<http://www.debian.org/devel/debian-installer/> + +## <a name="History"> History </a> + +The current installer for the CD distribution is based on the current Debian Woody installer. It's hacked a little bit to make it work for the Hurd. Since Debian wants to move to a new installer it makes sense to track the progress so we don't get left too far behind. + +## <a name="When_to_migrate"> When to migrate </a> + +When the new installer is stable and someone can take responsibility for helping adapt the new installer to work in the same capacity that the current one works. + +If you are interested in this area, please post to <debian-hurd@lists.debianNOSPAM.org>. + +-- [[Main/GrantBow]] - 30 Nov 2002 diff --git a/Distrib/NewQuestions.mdwn b/Distrib/NewQuestions.mdwn new file mode 100644 index 00000000..e79729e9 --- /dev/null +++ b/Distrib/NewQuestions.mdwn @@ -0,0 +1,15 @@ +## <a name="Mailing_lists"> Mailing lists </a> + +If you have questions about the installation, how the Hurd works and how it is used, or general questions concerning the Hurd, GNU Mach or the other packages maintained by the Hurd people, you can send an e-mail to the Help-Hurd mailing list. + +Bug reports for the GNU Hurd, GNU Mach and the other packages maintained by the Hurd people should be sent to the Bug-Hurd mailing list. + +All e-mails concerning the Debian GNU/Hurd binary distribution should go to the Debian GNU/Hurd mailing list. + +If you want to contribute to the development of the Hurd, look at the Development page. + +## <a name="Internet_relay_chat"> Internet relay chat </a> + +The GNU Project uses Freenode as it's official IRC network. The network of IRC servers can be accessed through irc.gnu.org. The channel #hurd is dedicated to the Hurd. You can find other users and developers interested in the Hurd there and chat with them in real time. + +Some of these links are at other web sites not maintained by the FSF. The FSF is not responsible for the content of these other web sites. diff --git a/Distrib/PackageTroubleshooting.mdwn b/Distrib/PackageTroubleshooting.mdwn new file mode 100644 index 00000000..fe8b6df4 --- /dev/null +++ b/Distrib/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/Distrib/PortDebootstrap.mdwn b/Distrib/PortDebootstrap.mdwn new file mode 100644 index 00000000..ce626d30 --- /dev/null +++ b/Distrib/PortDebootstrap.mdwn @@ -0,0 +1,5 @@ +Here's a topic for notes on the current progress. + +-- [[Main/GrantBow]] - 26 Jan 2003 + +<http://lists.debian.org/debian-hurd/2003/debian-hurd-200301/msg00072.html> diff --git a/Distrib/PortingIssues.mdwn b/Distrib/PortingIssues.mdwn new file mode 100644 index 00000000..1f9def8c --- /dev/null +++ b/Distrib/PortingIssues.mdwn @@ -0,0 +1,194 @@ +## <a name="Table_of_Contents"> Table of Contents </a> + +%TOC% + +## <a name="Overview"> Overview </a> + +This is a recompilation of common porting problems and their solutions. Information is gathered from the following sources: + +* [Debian GNU/Hurd port guidelines](http://www.debian.org/ports/hurd/hurd-devel-debian/) + +* [James Morrison's GNU/Hurd pages](http://hurd.dyndns.org/) + +as well as other misc. sources. + +First of all, see [[BtsFiling]] if you need instructions on manipulating [Debian](http://www.debian.org/) source packages and submitting patches to their [Bug Tracking System](http://bugs.debian.org/). + +## <a name="System_API_limitations"> </a> System API limitations + +Sometimes building or running a program will fail due to bugs in the system API implementation (in Glibc and the Hurd). Make sure you check this list and know them before porting, otherwise you'll end up debugging something just to find out its an already known bug. + +We maintain a separate Wiki page for information on these bugs, see [[Distrib/SystemAPILimits]] + +If you think you can fix any of them and send a patch to the debian BTS, that'd be much appreciated. You may ask in <bug-hurd@gnuNOSPAM.org> for details or questions on the bug. + +## <a name="Undefined_bits_confname_h_tt_mac"> Undefined `bits/confname.h` macros (`PIPE_BUF`, ...) </a> + +If macro `XXX` is undefined, but macro `_SC_XXX` or `_PC_XXX` is defined in `bits/confname.h`, you probably need to use `sysconf`, `pathconf` or `fpathconf` to obtain it dynamicaly. + +The following macros have been found in this offending situation (add more if you find them): `PIPE_BUF` + +An example with `sysconf`: (when you find a `sysconf` offending macro, put a better example) + + #ifndef XXX + #define XXX sysconf(_SC_XXX) + #endif + /* offending code using XXX follows */ + +An example with `fpathconf`: + + #ifdef PIPE_BUF + read(fd, buff, PIPE_BUF - 1); + #else + read(fd, buff, fpathconf(fd, _PC_PIPE_BUF) - 1); + #endif + /* note we can't #define PIPE_BUF, because it depends + on the "fd" variable */ + +## <a name="Bad_File_Descriptor"> Bad File Descriptor </a> + +If you get Bad File Descriptor error when trying to read from a file (or accessing it at all), check the `open()` invocation. The second argument is the access method. If it is a hard coded number instead of a symbol defined in the standard header files, the code is screwed and should be fixed to either use `O_RDONLY`, `O_WRONLY` or `O_RDWR`. This bug was observed in the `fortunes` and `mtools` packages for example. + +## <a name="PATH_MAX_tt_MAX_PATH_tt_MAXPATHL"> `PATH_MAX` / `MAX_PATH` / `MAXPATHLEN` </a> + +Every unconditionalized use of `PATH_MAX`, `MAX_PATH` or `MAXPATHLEN` is a POSIX incompatibility. If there is no upper limit on the length of a path (as its the case for GNU), this symbol is not defined in any header file. Instead, you need to either use a different implementation that does not rely on the length of a string or use `sysconf()` to query the length at runtime. If `sysconf()` returns -1, you have to use `realloc()` to allocate the needed memory dynamically. + +## <a name="MAXHOSTNAMELEN_tt_"> `MAXHOSTNAMELEN` </a> + +Same as `PATH_MAX`. When you find a `gethostname()` function, which acts on a static buffer, you can replace it with Neal's [xgethostname function](http://ftp.walfield.org/pub/people/neal/xgethostname/) which returns the hostname as a dynamic buffer. For example: + +Buggy code: + + char localhost[MAXHOSTNAMELEN]; + ... + gethostname(localhost, sizeof(localhost)); + +Fixed code: + + #include "xgethostname.h" + ... + char *localhost; + ... + localhost = xgethostname(); + if (! localhost) + { + perror ("xgethostname"); + return ERROR; + } + ... + /* use LOCALHOST. */ + free (localhost); + +## <a name="NOFILE_tt_"> `NOFILE` </a> + +Replace with `RLIMIT_NOFILE` + +## <a name="GNU_specific_define_tt_"> </a> GNU specific `#define` + +If you need to include specific code for GNU/Hurd using `#if` ... `#endif`, then you can use the `__GNU__` symbol to do so. But think (at least) thrice! before doing so. In most situations, this is completely unnecessary and will create more problems than it may solve. Better ask on the mailing list how to do it right if you can't think of a better solution. + +## <a name="sys_errlist_tt_vs_strerror_tt_"> `sys_errlist[]` vs. `strerror()` </a> + +If a program has only support for `sys_errlist[]` you will have to do some work to make it compile on GNU, which has dropped support for it and does only provide `strerror()`. Steinar Hamre writes about `strerror()`: + +`strerror()` should be used because: + +* It is the modern, POSIX way. +* It is localized. +* It handles invalid signals/numbers out of range. (better errorhandling and not a buffer-overflow-candidate/security risk) + +`strerror()` should always be used if it is available. Unfortunaly there are still some old non-POSIX systems that do not have `strerror()`, only `sys_errlist[]`. + +Today, only supporting `strerror()` is far better than only supporting `sys_errlist[]`. The best (from a portability viewpoint), however is supporting both. For configure.in, you will need: + + AC_CHECK_FUNCS(strerror) + +To `config.h.in`, you need to add: + + #undef HAVE_STRERROR + +Then something like: + + #ifndef HAVE_STRERROR + static char * + private_strerror (errnum) + int errnum; + { + extern char *sys_errlist[]; + extern int sys_nerr; + + if (errnum > 0 && errnum <= sys_nerr) + return sys_errlist[errnum]; + + return "Unknown system error"; + } + #define strerror private_strerror + #endif /* HAVE_STRERROR */ + +You can for example look in the latest coreutils (the above is a simplified version of what I found there.) Patches should of course be sent to upstream maintainers, this is very useful even for systems with a working `sys_errlist[]`. + +Of course, if you don't care about broken systems (like MS-DOG) not supporting `strerror()` you can just replace `sys_errlist[]` directly (upstream might not accept your patch, but debian should have no problem) + +## <a name="Filenames_ending_in_a_slash_"> Filenames ending in a slash \`/' </a> + +Those are evil if they don't exist and you want to name a directory this way. For example, `mkdir foobar/` will not work on GNU. This is POSIX compatible. POSIX says that the path of a directory may have slashes appended to it. But the directory does not exist yet, so the path does not refer to a directory, and hence trailing slashes are not guaranteed to work. Just drop the slashes, and you're fine. + +## <a name="Missing_termio_h_tt_"> Missing `termio.h` </a> + +Change it to use `termios.h` (check for it properly with autoconf `HAVE_TERMIOS_H` or the `__GLIBC__` macro) + +## <a name="AC_HEADER_TERMIO_tt_"> `AC_HEADER_TERMIO` </a> + +The autoconf check for `AC_HEADER_TERMIO` tryes to check for termios, but it's only really checking for termio in `termios.h`. It is better to use `AC_CHECK_HEADERS(termio.h termios.h)` + +## <a name="broken_libc6_dependency"> broken libc6 dependency </a> + +Some packages use an erroneous dependency on `libc6-dev`. This is incorrect because `libc6` is specific to GNU/Linux. The corresponding package for GNU is `libc0.3-dev` but other OSes will have different ones. You can locate the problem in the `debian/control` file of the source tree. Typical solutions include detecting the OS using `dpkg-architecture` and hardcoding the soname, or better, use a logical OR. eg: `libc6-dev | libc0.3-dev | libc-dev`. The `libc-dev` is a virtual package that works for any soname but you have to put it only as the last option. + +## <a name="Third_argument_in_ioctl_tt_TIOCF"> Third argument in `ioctl` (`TIOCFLUSH`, etc) </a> + +Broken arguments for `ioctl`'s which might work on other systems will cause segfault on GNU, because they are passed to and from a Hurd server RPC. + +For example, `TIOCFLUSH` wants an `(int *)`, but will run on GNU/Linux if you pass it a 0. The solution in this case is to declare and assign an `int`, eg: + + int out = 0; + +and pass its address to `ioctl`: + + ioctl (fd, TIOCFLUSH, &out); + +See [a simple fix for TIOCFLUSH in telnet](http://mail.gnu.org/archive/html/bug-inetutils/2001-08/msg00015.html). + +---- + +## <a name="ChangeLog"> ChangeLog </a> + +-- [[Main/TWikiGuest]] - 13 Jan 2005 + +Fix xgethostname example. - Neal + +-- [[Main/RobertMillan]] - 22 Jul 2002 + +Formatting and minor grammatical fixes. + +-- [[Main/JoachimNilsson]] - 09 Sep 2002 + +Added more examples and misc semantical fixes. + +-- [[Main/RobertMillan]] - 05 Oct 2002 + +Added `xgethostname` example. + +-- [[Main/RobertMillan]] - 15 Nov 2002 + +Added broken libc6 dependency + +-- [[Main/RobertMillan]] - 21 Nov 2002 + +Text formatting. + +-- Ognyan Kulev - 12 Mar 2003 + +Added `ioctl` entry. + +-- [[Main/RobertMillan]] - 19 Mar 2003 diff --git a/Distrib/QEMU.mdwn b/Distrib/QEMU.mdwn new file mode 100644 index 00000000..3b918ab7 --- /dev/null +++ b/Distrib/QEMU.mdwn @@ -0,0 +1,19 @@ +QEMU is free software written by Fabrice Bellard that implements a fast processor emulator, allowing a user to run one operating system within another one. It is similar to projects such as Bochs and VMware Workstation, but has several features these lack, including increased speed and support for multiple architectures. By using dynamic translation it achieves a reasonable speed while being easy to port on new host CPUs. + +QEMU has two operating modes: + +\* User mode emulation: QEMU can launch Linux processes compiled for one CPU on another CPU. Linux system calls are converted because of endianness and 32/64 bit mismatches. Wine and Dosemu are the main targets for QEMU. + +\* System mode emulation: QEMU emulates a full system, including a processor and various peripherials. It enables easier testing and debugging of system code. It can also be used to provide virtual hosting of several virtual PCs on a single server. + +The majority of the program is under the [[LGPL]], with the system mode emulation under the [[GPL]]. + +See also: [[HurdOnQEMU]] + +## <a name="External_links"> External links </a> + +\* <http://fabrice.bellard.free.fr/qemu/> + +\* <http://lilly.csoft.net/~jeffryj/cgi-bin/moin.cgi/FrontPage> Qemu Wiki + +\* [Qemu on Windows](http://www.h7.dion.ne.jp/~qemu-win/). diff --git a/Distrib/SampleDscFile.mdwn b/Distrib/SampleDscFile.mdwn new file mode 100644 index 00000000..d3b7b9f8 --- /dev/null +++ b/Distrib/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/Distrib/SavannahProjects.mdwn b/Distrib/SavannahProjects.mdwn new file mode 100644 index 00000000..3024ed64 --- /dev/null +++ b/Distrib/SavannahProjects.mdwn @@ -0,0 +1,13 @@ +[Savannah](http://savannah.gnu.org) was created with a forked version of the software that runs the [SourceForge](http://www.sf.net) site. It is the official [GNU project](http://www.gnu.org/gnu/thegnuproject.html) hosting facility of the [FSF](http://www.fsf.org). Many GNU projects are migrating to use it. Here is a list of projects hosted on Savannah related to the Hurd. + +* [Hurd](http://savannah.gnu.org/projects/hurd) - main project CVS repository +* [HurdExtras](http://savannah.gnu.org/projects/hurdextras) - related projects +* [wwwHurd](http://savannah.gnu.org/projects/wwwhurd) - webmasters for <http://hurd.gnu.org> +* [L4Hurd](http://savannah.gnu.org/projects/l4hurd) - OSkit/L4 unofficial porting project +* [pthreads](http://savannah.gnu.org/projects/pthreads) - porting of thread library for glibc +* [hurd-iso](http://savannah.gnu.org/projects/hurd-iso) - CD-ROM images +* [gnumach-alpha](http://savannah.gnu.org/projects/gnumach-alpha) - port for Alpha processor machines +* [[Hurd/THUG]] - Toronto Area GNU/Hurd User Group and their [documentation page](http://www.freesoftware.fsf.org/thug/docs.html) +* [francine](http://savannah.gnu.org/projects/francine) - "secure, colourful and themeable login program" + +-- [[Main/GrantBow]] - 13 May 2002 diff --git a/Distrib/SoftwareLicensing.mdwn b/Distrib/SoftwareLicensing.mdwn new file mode 100644 index 00000000..e236fea1 --- /dev/null +++ b/Distrib/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/Distrib/SystemAPILimits.mdwn b/Distrib/SystemAPILimits.mdwn new file mode 100644 index 00000000..8930ef9c --- /dev/null +++ b/Distrib/SystemAPILimits.mdwn @@ -0,0 +1,30 @@ +## <a name="API_Limitations_of_the_GNU_syste"> </a> API Limitations of the GNU system + +---- + +Sometimes building or running a program will fail due to bugs in the system API implementation (in Glibc and the Hurd). Make sure you check this list and know them before porting, otherwise you'll end up debugging something just to find out its an already known bug. + +Taken from the bug lists in debian BTS. If you find more of them (and it is clear in the bug log that it is a bug), please add them to the list below. See: + +* <http://bugs.debian.org/hurd> ([source](http://packages.qa.debian.org/h/hurd.html) and [binary](http://packages.debian.org/hurd) debs not synchronized) +* <http://bugs.debian.org/hurd-dev> ([binary](http://packages.debian.org/hurd-dev)) +* <http://bugs.debian.org/libc0.3> ([source](http://packages.qa.debian.org/g/glibc.html) & [binary](http://packages.debian.org/libc0.3) debs) +* <http://bugs.debian.org/libc0.3-dev> ([binary](http://packages.debian.org/libc0.3-dev)) + +---- + +These are the known system API limits that have porting implications. + +**_[\#47998](http://bugs.debian.org/47998): `msgget` IPC not implemented_** + +**_[\#184565](http://bugs.debian.org/184565): libc0.3: missing shm\* functions (from `<sys/shm.h>`)_**<br />**breaks:** cdrtools<br />**error:** warning: shm\* is not implemented and will always fail + +**_[\#190581](http://bugs.debian.org/190581): nice() doesn't work_**<br />**breaks:** coreutils<br />**error:** `nice()` doesn't take effect on some situations + +**_[\#187391](http://bugs.debian.org/187391): libc0.3-dev: `sockaddr_un.sun_path` can't be assigned a `const char *` when compiling with g++_**<br />**breaks:** fam, gail<br />**status:** maybe this should be in [[PortingIssues]] (see _long_ bug log) + +**_[\#190367](http://bugs.debian.org/190367): libc0.3-dev: `fcntl` `F_GETLK` not implemented (`ENOSYS`)_**<br />**breaks:** gnome-session (and others) from running<br />**error:** misc lock-related errors + +-- [[Main/RobertMillan]] - 01 May 2003 + +Text formatting.<br /> -- [[Main/OgnyanKulev]] - 02 May 2003 diff --git a/Distrib/TarballNotes20020422.mdwn b/Distrib/TarballNotes20020422.mdwn new file mode 100644 index 00000000..ead4cf32 --- /dev/null +++ b/Distrib/TarballNotes20020422.mdwn @@ -0,0 +1,5 @@ +%SEARCH\{"Mediatype.\*?value=\\"Tarball"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this set of CDs. + +-- [[Main/GrantBow]] - 15 Oct 2002 diff --git a/Distrib/TarballNotes20020523.mdwn b/Distrib/TarballNotes20020523.mdwn new file mode 100644 index 00000000..d80d977a --- /dev/null +++ b/Distrib/TarballNotes20020523.mdwn @@ -0,0 +1,7 @@ +%SEARCH\{"Mediatype.\*?value=\\"Tarball"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this tarball. + +* The current (24 May 2002) system install image is once again in its proper location <code><ftp://alpha.gnu.org/gnu/hurd/contrib/marcus/gnu-latest.tar.gz></code>. The old staging server image at <code><ftp://alpha.gnu.org/gnu/hurd/debian-staging/></code> is now deprecated. + +-- [[Main/GrantBow]] - 13 Oct 2002 diff --git a/Distrib/TarballNotes20020816.mdwn b/Distrib/TarballNotes20020816.mdwn new file mode 100644 index 00000000..7252859b --- /dev/null +++ b/Distrib/TarballNotes20020816.mdwn @@ -0,0 +1,23 @@ +%SEARCH\{"Mediatype.\*?value=\\"Tarball"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this tarball. + +* Used as basis for [[CDNotesK1]] and [[CDNotesJ2]] + +* When booting with grub users must use module /hurd/ext2fs.static --readonly ... This is fixed in CVS, bug-hurd discussion [begins here](http://mail.gnu.org/pipermail/bug-hurd/2002-August/010226.html). Note that you must NOT use --readonly before your first run of ./native-install. + +\* If on booting this error occurs, check your grub module lines. + + 2 multiboot modules + + panic: 1 of 2 boot script commands could not be parsed + +Notice there are both \{\} and () used. [[Hurd/InstallNotes]] + +* Marcus' new console driver is in testing and should also be included next time. + +* Using GNU Mach 1.3 (as released May 28th). It does not use the actively developed GNU Mach 2.0 and oskit drivers. Hopefully the next one will after Marcus gets back from his month long travels. + +-- [[Main/GrantBow]] - 15 Oct 2002 + +%COMMENT\{mode="after" id="second" button="Add Comment"\}% diff --git a/Distrib/TarballNotes20030126.mdwn b/Distrib/TarballNotes20030126.mdwn new file mode 100644 index 00000000..6a6ea2b0 --- /dev/null +++ b/Distrib/TarballNotes20030126.mdwn @@ -0,0 +1,19 @@ +%SEARCH\{"Mediatype.\*?value=\\"Tarball"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +Here's a place for notes and sharing info about peculiarities with this tarball. + +* Will be used as basis for [[CDNotesK2]] +* Includes the [[Hurd/RandomDevice]] and [[Hurd/HurdConsole]]. + +This is one by Joachim Nilsson, and is available from + +* <ftp://gnufans.org/gnu/hurd/contrib/joachim/gnu-20030126.tar.bz2> +* <ftp://gnufans.org/gnu/hurd/contrib/joachim/gnu-20030126.tar.gz> + +-- [[Main/GrantBow]] - 30 Jan 2003 + +-- [[Main/DaniloSegan]] - 01 Apr 2003 + +---- + +%COMMENT\{mode="before" id="second" button="Add Comment"\}% diff --git a/Distrib/TarballNotes20030329.mdwn b/Distrib/TarballNotes20030329.mdwn new file mode 100644 index 00000000..0c9a058b --- /dev/null +++ b/Distrib/TarballNotes20030329.mdwn @@ -0,0 +1,11 @@ +%SEARCH\{"Mediatype.\*?value=\\"Tarball"" scope="text" regex="on" nosearch="on" nototal="on" format="$topic",", "\}% + +This is a new kind of tarball. While the old tarballs were used specifically to bootstrap systems manually, this particular tarball is built by Phil to fit the needs of the Debian "boot floppy" system used by the CD Images that Phil creates to help install Debian GNU/Hurd systems. This particular 20030329 tarball corresponds to the [[CDNotesK3]] set of CDs. The file MUST be named baseGNU.tgz and the file timestamp and size should help differentiate between different versions of this file. + +-- [[Main/GrantBow]] - 02 May 2003 + +---- + +---- + +%COMMENT\{mode="before" id="second" button="Add Comment"\}% diff --git a/Distrib/TarballNotesHome.mdwn b/Distrib/TarballNotesHome.mdwn new file mode 100644 index 00000000..1f82454c --- /dev/null +++ b/Distrib/TarballNotesHome.mdwn @@ -0,0 +1,30 @@ +Past notes may be of help as well. + +The old _official_ tarball was located here: + +* <ftp://alpha.gnu.org/gnu/hurd/contrib/marcus/gnu-latest.tar.gz> + +_Unoffical_ tarballs were to be found here: + +* <ftp://ftp.gnufans.org/gnu/hurd/contrib/joachim/gnu-20030126.tar.gz> + +---- + +<table> + <tr> + <td valign="top" width="50%"> + <p> %SEARCH{"Mediatype.*?value=\"Tarball"" scope="text" regex="on" nosearch="on" nototal="on" header="| <strong>Release</strong> | <strong>Date</strong> |" format="| [[Topic]] | $formfield([[ReleaseDate]]) |"}% </p> + <p> + </p> + </td> + <td> + <p> + </p> + </td> + <td valign="top" width="50%"> + <p> %SEARCH{"Mediatype.*?value=" scope="text" regex="on" nosearch="on" nototal="on" header="| <strong>Release</strong> | <strong>Date</strong> |" format="| [[Topic]] | $formfield([[ReleaseDate]]) |" order="formfield([[ReleaseDate]])" }% </p> + <p> + </p> + </td> + </tr> +</table> diff --git a/Distrib/TestSuites.mdwn b/Distrib/TestSuites.mdwn new file mode 100644 index 00000000..e268ba8d --- /dev/null +++ b/Distrib/TestSuites.mdwn @@ -0,0 +1,12 @@ +Test suites exist to validate the compliance of software implementations with specific standards. This page is to act as a repository for information about the standards themselves, the test suites that validate software that complies with the standards as well as results & feedback from people who have run these suites. + +* IEEE [Posix](http://standards.ieee.org/regauth/posix/index.html) ([Open POSIX Test Suite](http://posixtest.sourceforge.net/)) +* Free Standards Group Linux Standard Base ([LSB](http://www.linuxbase.org/)) +* File Hierarchy Standard ([FHS](http://www.pathname.com/fhs/)) +* [X Desktop Group](http://www.freedesktop.org) +* The Open Group [Single UNIX specification, version 3](http://www.unix-systems.org/version3/online.html) +* The Open Group [ Unix 98](http://www.opengroup.org/public/prods/xxm0.htm) +* The Open Group [Testing Services](http://www.opengroup.org/consortia_services/testing.htm) (with [downloads](http://www.opengroup.org/testing/downloads.html)) +* [Perl](http://www.perl.org) + +-- [[Main/NagromNamreh]] - 24 Jan 2004 Added Posix test suite results diff --git a/Distrib/TestTopic.mdwn b/Distrib/TestTopic.mdwn new file mode 100644 index 00000000..73d3b9b9 --- /dev/null +++ b/Distrib/TestTopic.mdwn @@ -0,0 +1,13 @@ +%SEARCH\{"CDNotes" scope="text" nosearch="on" nototal="on" header="| **Release** | **Date** |" format="| [[Topic]] | $formfield([[ReleaseDate]]) |"\}% + +<table border="1" cellpadding="1" cellspacing="0"> + <tr> + <th bgcolor="#99CCCC"><strong>Topic:</strong></th> + <th bgcolor="#99CCCC"><strong>ReleaseDate:</strong></th> + <th bgcolor="#99CCCC"><strong>ReleaseNotes:</strong></th> + </tr> +</table> + +%SEARCH\{ "[M]ediatype.\*?value=\\"[C]D\\"" scope="text" regex="on" nosearch="on" nototal="on" format="| [[Topic]] | $formfield([[ReleaseDate]]) | $formfield([[ReleaseNotes]]) |" \}% + +-- [[Main/JoachimNilsson]] - 22 Sep 2004 diff --git a/Distrib/VmWare.mdwn b/Distrib/VmWare.mdwn new file mode 100644 index 00000000..6f4c3cba --- /dev/null +++ b/Distrib/VmWare.mdwn @@ -0,0 +1,22 @@ +## <a name="Why_not_vmware_"> Why not vmware? </a> + +**_Q:_** GNU won't work in [[VmWare]], it hangs when reaching the Hurd bootstrap. + +**_A:_** Note that Vmware is not supported software to run the Hurd on it. Reasons include: + +1. Vmware is not [free software](http://www.gnu.org/philosophy/free-sw.html), which is against our philosophy. +2. Obtaining a licensed copy to debug it costs (at least) $300. (However, the player is "free" as in beer. This doesn't lessen the other concerns, however). +3. Vmware's sources and specification are not publicly available, which makes debugging tasks really painful. +4. GNU is not in [Vmware's official supported operating systems page](http://www.vmware.com/support/ws3/doc/ws32_guestos2.html#1034043). + +We recommend to use [free](http://www.gnu.org/philosophy/free-sw.html) alternatives, like the [[BochsEmulator]]. Also check QEMU: [[HurdOnQEMU]]. + +-- [[Main/RobertMillan]] - 23 Jul 2002 + +I have been able to install Debian/Hurd K2 on [[VmWare]] ... + +* [[VmWare]] 3.02 complains a lot about a missing **console** and shows a lot of errors + * They can be solved by manually creating the devices +* I have tried **Bochs 2.0**, Debian/Hurd K2 installs with no problems at all. +* [[VmWare]] 4.0.0 works fine ... just follow the Hurd install instructions.-- [[TWiki/AndreaSterbini]] - 22 Apr 2003 +* Here using "free" (as in beer) vmware-player 1.0.2.29634 on Gentoo. Hurd K14 installs and runs smoothly, but seems to hang on shutdown. -- [[Main/DeviceRandom]] - 20 Jan 2007 diff --git a/Distrib/WebChanges.mdwn b/Distrib/WebChanges.mdwn new file mode 100644 index 00000000..de565147 --- /dev/null +++ b/Distrib/WebChanges.mdwn @@ -0,0 +1 @@ +%INCLUDE\{"%TWIKIWEB%.WebChanges"\}% diff --git a/Distrib/WebDiscuss.mdwn b/Distrib/WebDiscuss.mdwn new file mode 100644 index 00000000..6e4c663f --- /dev/null +++ b/Distrib/WebDiscuss.mdwn @@ -0,0 +1,35 @@ +## <a name="Maintenance_of_the_WEB_web"> Maintenance of the %WEB% web </a> + +I've setup a preliminary front page for the Distrib web. Nothing fancy, but I think it's better to have a general idea on display rather than nothing. This is your baby Grant. :) + +Where should all this stuff go? + +<form action="%SCRIPTURLPATH%/search%SCRIPTSUFFIX%/%WEB%/SearchResult"> + <ul> + <li><input name="search" size="32" type="text" /> <input type="submit" value="Search" /> (More options in [[WebSearch]]) </li> + <li>[[WebChanges]]: Find out recent modifications to the %WIKITOOLNAME%.%WEB% web. </li> + <li>[[WebIndex]]: Display all %WIKITOOLNAME%.%WEB% topics in alphabetical order. See also the faster [[WebTopicList]]</li> + <li> %NOTIFYTOPIC%: Subscribe to be automatically notified when something changes in the %WIKITOOLNAME%.%WEB% web. </li> + <li> %STATISTICSTOPIC%: View access statistics of the %WIKITOOLNAME%.%WEB% web. </li> + <li> %WEBPREFSTOPIC%: Preferences of the %WIKITOOLNAME%.%WEB% web. </li> + </ul> +</form> + +**Notes:** + +* You are currently in the %WIKITOOLNAME%.%WEB% web. The color code for this web is a (SPECIFY COLOR) background, so you know where you are. +* If you are not familiar with the %WIKITOOLNAME% collaboration tool, please visit %TWIKIWEB%.WelcomeGuest in the %WIKITOOLNAME%.%TWIKIWEB% web first. + +%INCLUDE\{"%TWIKIWEB%.TWikiWebsTable"\}% + +-- [[Main/JoachimNilsson]] - 28 Nov 2002 + +[[CDNotesHome]] no longer shows dates of releases. Is this because the spaces that are included in topic names? + +-- [[Main/OgnyanKulev]] - 22 Sep 2004 + +Strange. Nope, the spaces in links and topic names are only visible when the wiki is presented in HTML to the user, it's a visualization plugin. The topics themselves are still searchable in the same fashion. + +However, we recently had a server upgrade (woody-->sarge) that may have affected the apache settings. I'll look into it and post more here later. + +-- [[Main/JoachimNilsson]] - 22 Sep 2004 diff --git a/Distrib/WebHome.mdwn b/Distrib/WebHome.mdwn new file mode 100644 index 00000000..f6b416ac --- /dev/null +++ b/Distrib/WebHome.mdwn @@ -0,0 +1,248 @@ +Jon: We need a better logo for this page - ever since the Gentoo and Bee movements got involved I've been thingking about fixing this logo, but I haven't had any time. Suggestions, gfx donations? -- [[Main/JoachimNilsson]] - 30 Jun 2004 + +# <a name="Getting_Your_GNU_Hurd_Running"> </a> Getting Your GNU/Hurd Running + +This web is about the distribution of software: where and how to get it. + +<form action="%SCRIPTURLPATH%/search%SCRIPTSUFFIX%/%WEB%/"> + <table> + <tr> + <td valign="top" width="65%"> + <p> %TOC% </p> + <p><nop></nop></p> + <h2><a name="Distributions"> Distributions </a></h2> + <p><nop></nop></p> + <h3><a name="Debian_nbsp_http_www_debian_org_"> </a> Debian <a href="http://www.debian.org/ports/hurd/" target="_top">GNU/Hurd port</a>: </h3> + <p> Official page about the Debian distribution of the GNU/Hurd system. Some additional notes are at [[DebianStatus]]. </p> + <ul> + <li><a href="http://people.debian.org/~mbanck/talks/hurd_lt2004/html/" target="_top">Presentation "Debian GNU/Hurd" by Michael Banck, <nop>LinuxTag 2004 Karlsruhe</nop></a></li> + </ul> + <p> + </p> + <ul> + <li>[[DebianFAQ]]</li> + </ul> + <p> + </p> + <ul> + <li>[[DebianAfterInstall]] -- Do this to get networking, new console and X </li> + </ul> + <p> + </p> + <dl> + <dt><a href="http://hurd.rustedhalo.net/" target="_top">Gentoo-Hurd</a></dt> + <dd> Unofficial port to Gentoo &amp; the portage system. It was <a href="http://forums.gentoo.org/viewtopic.php?t=41939&postdays=0&postorder=asc&start=0" target="_top">announced</a> March 17, 2003 in the Gentoo forums. There's a #gentoo-irc channel similar to [[Hurd/HurdIRC]]. At present (May 2005), there's no activity and Eric Olinger has not the time to maintain this distri. </dd> + </dl> + <p> + </p> + <dl> + <dt><a href="http://bee.es.gnu.org/" target="_top">Bee GNU/Hurd</a></dt> + <dd> Castellano distribution, pkgsrc package based. [[BochsEmulator]] image available too. They have their own <a href="http://es.gnu.org/cgi-bin/beewiki.pl?Wiki_Bee_GNU" target="_top">wiki</a> and a <a href="http://bee.es.gnu.org/?p=mail&l=en" target="_top">mail list</a> (no archive). </dd> + </dl> + <p> + </p> + <dl> + <dt> Some ISOs</dt> + <dd><a href="http://www.gnuab.org/qui-som" target="_top">GNUAB</a> has some images and packages available at <a href="http://ftp.gnuab.org" target="_top">http://ftp.gnuab.org</a> for the unreleased (not unstable) Debian distro </dd> + </dl> + <p> + </p> + <dl> + <dt>[[GnuOS]]</dt> + <dd> distribution is in discussion &amp; pre-planning phase </dd> + </dl> + <p><nop></nop></p> + <h2><a name="General"> General </a></h2> + <p> + </p> + <dl> + <dt><a href="http://lists.debian.org/debian-hurd/2002/debian-hurd-200210/msg00035.html" target="_top">Welcome Note</a></dt> + <dd> Introduction to GNU and the Hurd sent monthly to <nop>Help-Hurd@gnu.org. </nop></dd> + </dl> + <p> + </p> + <dl> + <dt>[[SoftwareLicensing]]</dt> + <dd> The copyright and license information for software that is distributed with the Hurd software is important. Debian has it's DFSG guidelines. Other distributions will need to address these same issues. </dd> + </dl> + <p> + </p> + <dl> + <dt>[[FrequentlyAskedQuestions]]</dt> + <dd> It's good to read it before asking questions. </dd> + </dl> + <p> + </p> + <dl> + <dt>[[GnuDebianRelationship]]</dt> + <dd> How does the GNU/Debian relationship work? </dd> + </dl> + <p> + </p> + <dl> + <dt>[[SoftwareLicensing]]</dt> + <dd> The copyright and license information for software that is distributed with the Hurd software is important. Debian has it's DFSG guidelines. Other distributions will need to address these same issues. </dd> + </dl> + <p> + </p> + </td> + <td> + <p> + </p> + </td> + <td valign="top" width="35%"> + <p> + </p> + <table border="1" cellpadding="1" cellspacing="0"> + <tr> + <th bgcolor="#99CCCC"><strong>Hot Topics <font size="-1">([[WebStatistics]])</font></strong></th> + <th bgcolor="#99CCCC"><strong>Top Contributors</strong></th> + </tr> + </table> %INCLUDE{"WebStatistics" pattern=".*?\-\-statTopContributors\-\-\&gt;[^\|]+\|[^\|]+\|[^\|]+\|[^\|]+\|[^\|]+\|[^\|]+(\|[^\|]+\|[^\|]+\|).*"}% <p> + </p><input name="search" size="20" type="text" /> <input type="submit" value="Search %WEB%" /><br /><font size="-1">More search options in [[WebSearch]]</font><br /> + <p> Currently, Web refers to the Distrib Web. </p> + <p> + </p> + <p> + </p> + <ul> + <li>[[WebIndex]] - alphabetical </li> + <li>[[WebChanges]] - by modification time </li> + <li>[[WebNotify]] - email alerts </li> + </ul> + <p> + </p> + </td> + </tr> + </table> +</form> + +## <a name="Installation"> Installation </a> + +<dl> + <dt> Install Instructions</dt> + <dd> Currently, <a href="http://www.debian.org/ports/hurd/hurd-install" target="_top">Debian's installation instructions</a> are the most up-to-date. [[Hurd/InstallNotes]] is an errata companion document with more helpful hints that have not yet been incorporated. </dd> +</dl> + +<dl> + <dt>[[CrossInstall]]</dt> + <dd> Another way to install a system. </dd> +</dl> + +<dl> + <dt> Release Information</dt> + <dd> About the latest CD release. Includes errata, known bugs and fixes. See [[CDNotesHome]] and [[TarballNotesHome]] for summaries </dd> +</dl> + +<dl> + <dt>[[GrubNotes]]</dt> + <dd> A quick reference and explanation. There's also a topic for the new [[GrubConf]]. </dd> +</dl> + +<dl> + <dt>[[InstallTips]]</dt> + <dd> Info on how to install without a cd drive or linux installed as well as a few tips. </dd> +</dl> + +Another installation method is using an emulated environment. The [[BochsEmulator]] was originally the recommended virtual machine solution, however most have switched over to QEMU, as it runs faster. + +* [[HurdOnQEMU]] - A guide on how to use QEMU to run the hurd. +* [[BochsFAQ]] - Common questions you should read. +* [[VmWare]] - Why using it is discouraged. + +<dl> + <dt> Debian Installer</dt> + <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> + +## <a name="Using_the_system"> Using the system </a> + +[[DebianAfterInstall]] instructions are a must-read to prepare an usable system. + +[[PackageTroubleshooting]] reports known bugs, quirks and workarounds about getting applications to work (if possible). + +## <a name="For_nbsp_Developers"> For Developers </a> + +<dl> + <dt>[[SavannahProjects]]</dt> + <dd> Savannah is a CVS &amp; Bug system evolved from a free version of the code that powers <a href="http://sf.net" target="_top">sourceforge.net</a>. It has forked and been slightly modified for use by FSF, GNU and non-GNU projects. Actual Development takes place here. There is also a <a href="http://savannah.gnu.org/people/?group=hurd" target="_top">help wanted</a> list. </dd> +</dl> + +<dl> + <dt>[[PortingIssues]] FAQ</dt> + <dd> What does it take to move a piece of Debian packaged software to the GNU/Hurd port? </dd> +</dl> + +<dl> + <dt>[[BuildingTheHurd]]</dt> + <dd> A summary by the Gentoo folks, thanks <a href="http://cvs.gentoo.org/~avenj/" target="_top">Jon Portnoy</a> - <a href="mailto:avenj@gentooNOSPAM.org">avenj@gentooNOSPAM.org</a></dd> +</dl> + +<dl> + <dt> Debain Infrastructure</dt> + <dd> Testing is critical in helping the development effort. Bugs (defect reports) can be filed against the Debian software package in which they are found. [[BtsFiling]] tells how to file a Debian bug report. [[DebianPackages]] has some information about how Debian splits the software into packages and some references. There is a buildd autobuilder compiling the Debian Sid archive software for the GNU/Hurd port. [[BuilddStatus]] includes information on the buildd &amp; turtle efforts. </dd> +</dl> + +<dl> + <dt><a href="http://hurd.she.kicks-ass.org:8084/uninstallable/" target="_top">Uninstallable packages</a></dt> + <dd> Many packages depend on these uninstallable packages. So building one of them will allow other to be build too. </dd> +</dl> + +<dl> + <dt> Technical References</dt> + <dd> There are many standards and documents that might be applicable for those interested in developing software. </dd> +</dl> + +* GNU [Coding Standards](http://www.gnu.org/prep/standards.html) +* [[TestSuites]] - Posix, Perl, results feedback, etc. +* [docs and papers](http://www.gnu.org/software/hurd/docs.html) +* [[SystemAPILimits]] +* [[Hurd/HurdSpecificGlibcApi]] +* [[CodeAnnouncements]] - Recent coding projects related to the Hurd + +<dl> + <dt> Debian <a href="http://www.debian.org/devel/" target="_top">Developer's Corner</a></dt> + <dd> The following references are provided as a starting point for those interested in helping to package software for Debian GNU/Hurd and Debian GNU/Linux. </dd> +</dl> + +* [Policy Manual](http://www.debian.org/doc/debian-policy/) +* Developer's [Reference](http://www.debian.org/doc/developers-reference/) +* New Maintainers [Guide](http://www.debian.org/doc/maint-guide/) +* There are many Debian email lists + +<dl> + <dt> Debian Todo</dt> + <dd> Packages needing attention. A possible use of this site could be to help track similar needs via [[HurdWnpp]]. This is not yet implemented. </dd> +</dl> + +<dl> + <dt>[[GnuDistributionRumors]]</dt> + <dd> There are some discussions and several rumors circulating about creating a completely new distribution, not using a Debian architecture. </dd> +</dl> + +## <a name="Misc_"> Misc. </a> + +<dl> + <dt> Why a separate section of the website for this?</dt> + <dd> There are fundamentally different issues about distributions compared with coding. Distributions are concerned with final default configurations of packaged software and system integration as they use many software packages and help give users a sense of using an OS "product." </dd> +</dl> + +<dl> + <dt>[[WhyDebian]]</dt> + <dd> A one page document focused on Debian aimed at users to answer their question "Why Debian?" </dd> +</dl> + +<dl> + <dt>[[DebianProductSheet]]</dt> + <dd> Technical description of Debian aimed at those interested in Debian. </dd> +</dl> + +* [Misc. Docs @Etherhogz](http://www.etherhogz.org/doc/) (broken) +* [Ognyan Kulev Collection](http://debian.fmi.uni-sofia.bg/~ogi/hurd/links/index.html) of links (unsupported) +* [2000 Jim Franklin Collection](http://angg.twu.net/the_hurd_links.html) of links + +---- + +Meta discussions about the Distrib web goes in the [[WebDiscuss]] topic. + +[[WebPreferences]] - administrative diff --git a/Distrib/WebIndex.mdwn b/Distrib/WebIndex.mdwn new file mode 100644 index 00000000..0732324b --- /dev/null +++ b/Distrib/WebIndex.mdwn @@ -0,0 +1,3 @@ +%SEARCH\{"\\.\*" scope="topic" regex="on" nosearch="on"\}% + +See also the faster [[WebTopicList]] diff --git a/Distrib/WebNotify.mdwn b/Distrib/WebNotify.mdwn new file mode 100644 index 00000000..7133f7ab --- /dev/null +++ b/Distrib/WebNotify.mdwn @@ -0,0 +1,9 @@ +%NOTIFYTOPIC% is a subscription service to be automatically notified by email when topics change in the **%WIKITOOLNAME%.%WEB%** web. This is a convenient service, so you do not have to come back and check all the time if something has changed. To subscribe to the service, please put yourself on the list below. The format is: `3 spaces * %MAINWEB%.yourWikiName - yourEmailAddress` + +* [[Main/AaronHawley]] - <ashawley@uvmNOSPAM.edu> +* [[Main/JoachimNilsson]] - <joachim@gnufansNOSPAM.org> +* [[Main/ThomasSchwinge]] - <tschwinge@gnuNOSPAM.org> + +**_Note:_** It is helpful to insert your name in alphabetical order (by first name -- ignore the "Main.") -- then you can find your name (or not) more easily if you wish to remove it or confirm that you are on the list. + +**_Related topics:_** %MAINWEB%.%WIKIUSERSTOPIC%, %TWIKIWEB%.TWikiRegistration diff --git a/Distrib/WebPreferences.mdwn b/Distrib/WebPreferences.mdwn new file mode 100644 index 00000000..81c047c0 --- /dev/null +++ b/Distrib/WebPreferences.mdwn @@ -0,0 +1,51 @@ +## <a name="_WIKITOOLNAME_WEB_Web_Preference"> %WIKITOOLNAME%.%WEB% Web Preferences </a> + +The following settings are **_web preferences_** of the %WIKITOOLNAME%.%WEB% web. These preferences overwrite the **_site-level preferences_** in %TWIKIWEB%.%WIKIPREFSTOPIC%, and can be overwritten by **_user preferences_** (your personal topic, i.e. %MAINWEB%.TWikiGuest in the %WIKITOOLNAME%.%MAINWEB% web) + +**_Preferences:_** + +* List of topics of the %WIKITOOLNAME%.%WEB% web: + * Set WEBTOPICLIST = [[HOMETOPIC]] %SEP% [[WebChanges]] %SEP% [[WebIndex]] %SEP% [[WebSearch]] %SEP% Go <input name="topic" size="16" type="text" /> + +* Web specific background color: (Pick a lighter one of the %TWIKIWEB%.StandardColors) (was #D0D0D0 and #99ccff) + * Set WEBBGCOLOR = #CCFFFF + +* Exclude web from a `web="all"` search: (Set to `on` for hidden webs) + * Set NOSEARCHALL = + +* Default template for new topics and form(s) for this web: + * [[WebTopicEditTemplate]]: Default template for new topics in this web. (Site-level is used if topic does not exist) + * [[TWIKIWEBWebTopicEditTemplate]]: Site-level default template + * %TWIKIWEB%.TWikiForms: How to enable form(s) + * Set WEBFORMS = [[Hurd/HurdReleaseForm]] + +* Users or groups who **_are not_** / **_are_** allowed to **_view_** / **_change_** / **_rename_** topics in the %WEB% web: (See %TWIKIWEB%.TWikiAccessControl) + * Set DENYWEBVIEW = + * Set ALLOWWEBVIEW = + * Set DENYWEBCHANGE = + * Set ALLOWWEBCHANGE = + * Set DENYWEBRENAME = + * Set ALLOWWEBRENAME = + +* Users or groups allowed to change or rename this %TOPIC% topic: (I.e. %MAINWEB%.TWikiAdminGroup) + * Set ALLOWTOPICCHANGE = %MAINWEB%.TWikiAdminGroup + * Set ALLOWTOPICRENAME = %MAINWEB%.TWikiAdminGroup + +* Web preferences that are **not** allowed to be overridden by user preferences: + * Set FINALPREFERENCES = WEBTOPICLIST, DENYWEBVIEW, ALLOWWEBVIEW, DENYWEBCHANGE, ALLOWWEBCHANGE, DENYWEBRENAME, ALLOWWEBRENAME + +**_Notes:_** + +* A preference is defined as: <br />`6 spaces * Set NAME = value`<br /> Example: + * Set WEBBGCOLOR = #FFFFC0 +* Preferences are used as %TWIKIWEB%.TWikiVariables by enclosing the name in percent signs. Example: + * When you write variable <code>%WEBBGCOLOR%</code> , it gets expanded to `%WEBBGCOLOR%` . +* The sequential order of the preference settings is significant. Define preferences that use other preferences first, i.e. set <code>WEBCOPYRIGHT</code> before <code>WIKIWEBMASTER</code> since <code>%WEBCOPYRIGHT%</code> uses the <code>%WIKIWEBMASTER%</code> variable. +* You can introduce new preferences variables and use them in your topics and templates. There is no need to change the %WIKITOOLNAME% engine (Perl scripts). + +**_Related Topics:_** + +* %TWIKIWEB%.%WIKIPREFSTOPIC% has site-level preferences. +* %MAINWEB%.%WIKIUSERSTOPIC% has a list of user topics. User topics can have optional user preferences. +* %TWIKIWEB%.TWikiVariables has a list of common <code>%VARIABLES%</code>. +* %TWIKIWEB%.TWikiAccessControl explains how to restrict access by users or groups. diff --git a/Distrib/WebSearch.mdwn b/Distrib/WebSearch.mdwn new file mode 100644 index 00000000..b6d43d86 --- /dev/null +++ b/Distrib/WebSearch.mdwn @@ -0,0 +1 @@ +%INCLUDE\{"%TWIKIWEB%.WebSearch"\}% diff --git a/Distrib/WebStatistics.mdwn b/Distrib/WebStatistics.mdwn new file mode 100644 index 00000000..7e5b8087 --- /dev/null +++ b/Distrib/WebStatistics.mdwn @@ -0,0 +1,160 @@ +## <a name="Statistics_for_WIKITOOLNAME_WEB_"> Statistics for %WIKITOOLNAME%.%WEB% Web </a> + +<table border="1" cellpadding="1" cellspacing="0"> + <tr> + <th bgcolor="#99CCCC"><strong>Month:</strong></th> + <th bgcolor="#99CCCC"><strong>Topic <br /> views:</strong></th> + <th bgcolor="#99CCCC"><strong>Topic <br /> saves:</strong></th> + <th bgcolor="#99CCCC"><strong>File <br /> uploads:</strong></th> + <th bgcolor="#99CCCC"><strong>Most popular <br /> topic views:</strong></th> + <th bgcolor="#99CCCC"><strong>Top contributors for <br /> topic save and uploads:</strong></th> + </tr> + <tr> + <td> + </td> + <td> + </td> + <td> + </td> + <td> + </td> + <td> + </td> + <td> + </td> + </tr> + <tr> + <td> Feb 2004 </td> + <td align="right"> 426 </td> + <td align="right"> 0 </td> + <td align="right"> 0 </td> + <td> 99 [[WebHome]]<br /> 20 [[InstallNotes]]<br /> 19 [[BuildingTheHurd]]<br /> 12 [[BochsEmulator]]<br /> 11 [[TarballNotes20020816]]<br /> 11 [[GnuDebianRelationship]]<br /> 10 [[WebStatistics]]<br /> 10 [[CDNotesJ2]]<br /> 9 [[WebIndex]]<br /> 8 [[VmWare]]<br /> 8 [[SystemAPILimits]]</td> + <td> </td> + </tr> + <tr> + <td> Jan 2004 </td> + <td align="right"> 1608 </td> + <td align="right"> 7 </td> + <td align="right"> 2 </td> + <td> 336 [[WebHome]]<br /> 69 [[InstallNotes]]<br /> 61 [[BochsEmulator]]<br /> 53 [[PortingIssues]]<br /> 41 [[VmWare]]<br /> 41 [[TestSuites]]<br /> 41 [[BuildingTheHurd]]<br /> 38 [[Hurd/FrequentlyAskedQuestions]]<br /> 35 [[CDNotesK3]]<br /> 34 [[BochsFAQ]]<br /> 33 [[TarballNotesHome]]</td> + <td> 7 [[Main/NagromNamreh]]<br /> 1 [[Main/LucasNussbaum]]<br /> 1 [[Main/HelgeStenstroem]]</td> + </tr> + <tr> + <td> Dec 2003 </td> + <td align="right"> 1468 </td> + <td align="right"> 0 </td> + <td align="right"> 0 </td> + <td> 303 [[WebHome]]<br /> 69 [[InstallNotes]]<br /> 57 [[PortingIssues]]<br /> 50 [[CDNotesK3]]<br /> 44 [[BochsEmulator]]<br /> 43 [[BuildingTheHurd]]<br /> 39 [[TarballNotesHome]]<br /> 39 [[BochsFAQ]]<br /> 36 [[VmWare]]<br /> 34 [[CrossInstall]]<br /> 34 [[CDNotesHome]]</td> + <td> </td> + </tr> + <tr> + <td> Nov 2003 </td> + <td align="right"> 1610 </td> + <td align="right"> 0 </td> + <td align="right"> 0 </td> + <td> 298 [[WebHome]]<br /> 59 [[PortingIssues]]<br /> 51 [[BochsEmulator]]<br /> 46 [[InstallNotes]]<br /> 45 [[Hurd/FrequentlyAskedQuestions]]<br /> 43 [[BochsFAQ]]<br /> 41 [[CDNotesK3]]<br /> 40 [[VmWare]]<br /> 35 [[BuildingTheHurd]]<br /> 33 [[CDNotesHome]]<br /> 32 [[GnuDebianRelationship]]</td> + <td> </td> + </tr> + <tr> + <td> Oct 2003 </td> + <td align="right"> 1106 </td> + <td align="right"> 0 </td> + <td align="right"> 0 </td> + <td> 217 [[WebHome]]<br /> 36 [[PortingIssues]]<br /> 33 [[InstallNotes]]<br /> 30 [[Hurd/FrequentlyAskedQuestions]]<br /> 29 [[BochsEmulator]]<br /> 28 [[VmWare]]<br /> 26 [[BuildingTheHurd]]<br /> 26 [[BochsFAQ]]<br /> 25 [[CdCovers]]<br /> 23 [[GnuDebianRelationship]]<br /> 22 [[WhyDebian]]</td> + <td> </td> + </tr> + <tr> + <td> Sep 2003 </td> + <td align="right"> 2112 </td> + <td align="right"> 1 </td> + <td align="right"> 0 </td> + <td> 365 [[WebHome]]<br /> 122 [[PortingIssues]]<br /> 101 [[BuildingTheHurd]]<br /> 66 [[Hurd/FrequentlyAskedQuestions]]<br /> 56 [[BochsFAQ]]<br /> 47 [[BochsEmulator]]<br /> 44 [[VmWare]]<br /> 44 [[CDNotesK3]]<br /> 42 [[TarballNotesHome]]<br /> 42 [[GnuDebianRelationship]]<br /> 36 [[TestSuites]]</td> + <td> 1 [[Main/CamResu]]</td> + </tr> + <tr> + <td> Aug 2003 </td> + <td align="right"> 1239 </td> + <td align="right"> 1 </td> + <td align="right"> 0 </td> + <td> 234 [[WebHome]]<br /> 52 [[BochsFAQ]]<br /> 43 [[CDNotesK3]]<br /> 40 [[VmWare]]<br /> 38 [[PortingIssues]]<br /> 37 [[GNUDebianBuildProcess]]<br /> 37 [[BuildingTheHurd]]<br /> 36 [[Hurd/FrequentlyAskedQuestions]]<br /> 36 [[GrubConf]]<br /> 32 [[BochsEmulator]]<br /> 31 [[CrossInstall]]</td> + <td> 1 [[Main/JoachimNilsson]]</td> + </tr> + <tr> + <td> Jul 2003 </td> + <td align="right"> 1384 </td> + <td align="right"> 0 </td> + <td align="right"> 0 </td> + <td> 251 [[WebHome]]<br /> 73 [[PortingIssues]]<br /> 66 [[Hurd/FrequentlyAskedQuestions]]<br /> 41 [[CDNotesK3]]<br /> 40 [[SystemAPILimits]]<br /> 35 [[BochsFAQ]]<br /> 33 [[BochsEmulator]]<br /> 30 [[CDNotesJ2]]<br /> 30 [[BuildingTheHurd]]<br /> 27 [[TarballNotesHome]]<br /> 27 [[GnuDebianRelationship]]</td> + <td> </td> + </tr> + <tr> + <td> Jun 2003 </td> + <td align="right"> 1661 </td> + <td align="right"> 3 </td> + <td align="right"> 0 </td> + <td> 267 [[WebHome]]<br /> 109 [[PortingIssues]]<br /> 77 [[Hurd/FrequentlyAskedQuestions]]<br /> 73 [[CDNotesK3]]<br /> 59 [[BochsFAQ]]<br /> 56 [[InstallNotes]]<br /> 45 [[TarballNotes20030126]]<br /> 41 [[SystemAPILimits]]<br /> 40 [[BochsEmulator]]<br /> 38 [[TarballNotesHome]]<br /> 33 [[VmWare]]</td> + <td> 2 [[Main/OgnyanKulev]]<br /> 1 [[Main/TWikiGuest]]</td> + </tr> + <tr> + <td> May 2003 </td> + <td align="right"> 1633 </td> + <td align="right"> 34 </td> + <td align="right"> 0 </td> + <td> 313 [[WebHome]]<br /> 103 [[CDNotesK3]]<br /> 91 [[SystemAPILimits]]<br /> 68 [[PortingIssues]]<br /> 53 [[BochsEmulator]]<br /> 52 [[Hurd/FrequentlyAskedQuestions]]<br /> 51 [[BochsFAQ]]<br /> 45 [[InstallNotes]]<br /> 39 [[TarballNotesHome]]<br /> 36 [[TarballNotes20030126]]<br /> 35 [[VmWare]]</td> + <td> 17 [[Main/OgnyanKulev]]<br /> 11 [[Main/GrantBow]]<br /> 4 [[Main/RobertMillan]]<br /> 1 [[Main/TWikiGuest]]<br /> 1 [[Main/JoachimNilsson]]</td> + </tr> + <tr> + <td> Apr 2003 </td> + <td align="right"> 1774 </td> + <td align="right"> 33 </td> + <td align="right"> 0 </td> + <td> 358 [[WebHome]]<br /> 162 [[PortingIssues]]<br /> 95 [[TarballNotes20030126]]<br /> 58 [[CDNotesK2]]<br /> 55 [[VmWare]]<br /> 55 [[BochsEmulator]]<br /> 50 [[BochsFAQ]]<br /> 46 [[TarballNotesHome]]<br /> 45 [[Hurd/FrequentlyAskedQuestions]]<br /> 40 [[BuildingTheHurd]]<br /> 36 [[InstallNotes]]</td> + <td> 17 [[Main/OgnyanKulev]]<br /> 6 [[Main/JoachimNilsson]]<br /> 3 [[Main/TWikiGuest]]<br /> 3 [[Main/RobertMillan]]<br /> 2 [[Main/DaniloSegan]]<br /> 2 [[Main/AndreaSterbini]]</td> + </tr> + <tr> + <td> Mar 2003 </td> + <td align="right"> 1445 </td> + <td align="right"> 17 </td> + <td align="right"> 0 </td> + <td> 335 [[CDNotesK2]]<br /> 323 [[WebHome]]<br /> 57 [[PortingIssues]]<br /> 42 [[InstallNotes]]<br /> 39 [[BochsFAQ]]<br /> 38 [[CDNotesK1]]<br /> 36 [[BochsEmulator]]<br /> 33 [[VmWare]]<br /> 32 [[Hurd/FrequentlyAskedQuestions]]<br /> 30 [[GnuDebianRelationship]]<br /> 26 [[TarballNotes20020816]]</td> + <td> 6 [[Main/OgnyanKulev]]<br /> 5 [[Main/RobertMillan]]<br /> 3 [[Main/TWikiGuest]]<br /> 3 [[Main/GrantBow]]</td> + </tr> + <tr> + <td> Feb 2003 </td> + <td align="right"> 883 </td> + <td align="right"> 23 </td> + <td align="right"> 0 </td> + <td> 250 [[BochsFAQ]]<br /> 207 [[WebHome]]<br /> 38 [[BochsEmulator]]<br /> 35 [[TarballNotes20030126]]<br /> 30 [[CDNotesK1]]<br /> 26 [[Hurd/FrequentlyAskedQuestions]]<br /> 23 [[PortingIssues]]<br /> 21 [[VmWare]]<br /> 21 [[TarballNotes20020816]]<br /> 16 [[NewDebianInstaller]]<br /> 15 [[InstallNotes]]</td> + <td> 21 [[Main/JoachimNilsson]]<br /> 2 [[Main/GrantBow]]</td> + </tr> + <tr> + <td> Jan 2003 </td> + <td align="right"> 1055 </td> + <td align="right"> 107 </td> + <td align="right"> 0 </td> + <td> 328 [[WebHome]]<br /> 196 [[BochsFAQ]]<br /> 54 [[NewDebianInstaller]]<br /> 44 [[Hurd/FrequentlyAskedQuestions]]<br /> 35 [[MediaPressKitDiscuss]]<br /> 30 [[BochsEmulator]]<br /> 24 [[InstallNotes]]<br /> 23 [[CDNotesK1]]<br /> 23 [[BuilddStatus]]<br /> 21 [[DebianPackages]]<br /> 20 [[WebTopicList]]</td> + <td> 87 [[Main/GrantBow]]<br /> 9 [[Main/OgnyanKulev]]<br /> 8 [[Main/DaniloSegan]]<br /> 3 [[Main/JoachimNilsson]]</td> + </tr> + <tr> + <td> Dec 2002 </td> + <td align="right"> 415 </td> + <td align="right"> 42 </td> + <td align="right"> 0 </td> + <td> 214 [[WebHome]]<br /> 25 [[BochsFAQ]]<br /> 23 [[NewDebianInstaller]]<br /> 17 [[Hurd/FrequentlyAskedQuestions]]<br /> 15 [[BochsEmulator]]<br /> 10 [[WebPreferences]]<br /> 9 [[InstallNotes]]<br /> 7 [[WebStatistics]]<br /> 7 [[PortingIssues]]<br /> 6 [[CDNotesJ2]]<br /> 5 [[WebDiscuss]]</td> + <td> 35 [[Main/GrantBow]]<br /> 7 [[Main/JoachimNilsson]]</td> + </tr> + <tr> + <td> Nov 2002 </td> + <td align="right"> 121 </td> + <td align="right"> 10 </td> + <td align="right"> 0 </td> + <td> 66 [[WebHome]]<br /> 10 [[WebNotify]]<br /> 10 [[WebDiscuss]]<br /> 6 [[WebMenu]]<br /> 5 [[WebStatistics]]<br /> 5 [[WebSearch]]<br /> 5 [[WebIndex]]<br /> 5 [[WebChanges]]<br /> 4 [[WebTopicList]]<br /> 4 [[WebPreferences]]<br /> 1 [[4f0]]</td> + <td> 5 [[Main/JoachimNilsson]]<br /> 5 [[Main/GrantBow]]</td> + </tr> +</table> + +**_Notes:_** + +* Do not edit this topic, it is updated automatically. (You can also [force](%SCRIPTURLPATH%/statistics%SCRIPTSUFFIX%/%WEB%) an update) +* %TWIKIWEB%.TWikiDocumentation tells you how to enable the automatic updates of the statistics. +* Suggestion: You could archive this topic once a year and delete the previous year's statistics from the table. diff --git a/Distrib/WebTopicList.mdwn b/Distrib/WebTopicList.mdwn new file mode 100644 index 00000000..fb9b2001 --- /dev/null +++ b/Distrib/WebTopicList.mdwn @@ -0,0 +1,3 @@ +%TOPICLIST\{" \* [[Name]]"\}% + +See also the verbose [[WebIndex]]. diff --git a/Distrib/WhyDebian.mdwn b/Distrib/WhyDebian.mdwn new file mode 100644 index 00000000..c8615330 --- /dev/null +++ b/Distrib/WhyDebian.mdwn @@ -0,0 +1,15 @@ +# <a name="Why_Debian_"> Why Debian? </a> + +## <a name="Linux"> Linux </a> + +## <a name="Debian_Organization"> Debian Organization </a> + +### <a name="Social"> Social </a> + +### <a name="Technical"> Technical </a> + +---- + +[[MediaPressKitDiscuss]] is a draft developed in email + +-- [[Main/GrantBow]] - 13 Jan 2003 |