diff options
| -rw-r--r-- | hurd.mdwn | 1 | ||||
| -rw-r--r-- | hurd/dde.mdwn | 22 | ||||
| -rw-r--r-- | hurd/dde/guide.mdwn | 158 | ||||
| -rw-r--r-- | hurd/running/distrib.mdwn | 6 | ||||
| -rw-r--r-- | hurd/status.mdwn | 4 | ||||
| -rw-r--r-- | hurd/virtual_file_system.mdwn | 2 | ||||
| -rw-r--r-- | public_hurd_boxen/installation/flubber.mdwn | 9 | ||||
| -rw-r--r-- | user/jkoenig.mdwn | 169 | ||||
| -rw-r--r-- | user/zhengda.mdwn | 15 |
9 files changed, 319 insertions, 67 deletions
@@ -61,6 +61,7 @@ in the *unstable* branch of the Debian archive. * [[running/Distrib]] -- Distributions * [[Public_Hurd_Boxen]] * [[Neighborhurd]]s and [[Subhurd]]s +* [[DDE]] -- Device Driver Environment ## Common Problems diff --git a/hurd/dde.mdwn b/hurd/dde.mdwn new file mode 100644 index 00000000..dedb7d10 --- /dev/null +++ b/hurd/dde.mdwn @@ -0,0 +1,22 @@ +[[!meta copyright="Copyright © 2009, 2010 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled [[GNU Free Documentation +License|/fdl]]."]]"""]] + + * [[community/gsoc/project ideas/driver glue code]] + + * [[open issues/user-space device drivers]] + + * [[open issues/device drivers and io systems]] + +--- + +There is an effort going on to make [[/DDE]] usable in GNU/Hurd +userspace. + +See Zheng Da's [[project page|zhengda]], as well as another [[guide]]. diff --git a/hurd/dde/guide.mdwn b/hurd/dde/guide.mdwn new file mode 100644 index 00000000..6518e0e4 --- /dev/null +++ b/hurd/dde/guide.mdwn @@ -0,0 +1,158 @@ +[[!meta copyright="Copyright © 2010 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled [[GNU Free Documentation +License|/fdl]]."]]"""]] + +If you haven't: install hurd to partition +get grub image +boot hurd in single user (change grub entry accordingly to the installed partition) + +> $ export TERM=mach + +> $ ./native-install + +reboot to other debian + +suppose hurd partition is hdd1 + +as root + +> $ mount /dev/hdd1 /mnt -t ext2 + +> $ cd /mnt/etc/apt + +> $ echo "deb http://ftp.debian-ports.org/debian unreleased main" >> sources.list + +> $ echo "deb-src http://ftp.debian-ports.org/debian unreleased main" >> sources.list + +> $ echo "deb http://ftp.uk.debian.org/debian unstable main" >> sources.list + +> $ echo "deb-src http://ftp.uk.debian.org/debian unstable main" >> sources.list + +> $ wget http://www.gnu.org/software/hurd/hurd/running/debian/DebianAptOffline/apt.conf.offline + +> $ cd /mnt + +> $ apt-get -c etc/apt/apt.conf.offline update + +> $ apt-get -c etc/apt/apt.conf.offline upgrade + +> $ apt-get -c etc/apt/apt.conf.offline install git-core + +> $ apt-get -c etc/apt/apt.conf.offline build-dep hurd gnumach + +> $ apt-get -c etc/apt/apt.conf.offline install build-essential libpciaccess-dev libpcap0.8-dev + +> $ cd /mnt/home + +> $ git clone git://git.sv.gnu.org/hurd/incubator.git -b dde hurd_dde + +> $ git clone git://git.sv.gnu.org/hurd/gnumach.git -b master-user_level_drivers gnumach_dde + + +suppose you need forcedeth driver + +Download http://git.kernel.org/?p=linux/kernel/git/stable/linux-2.6.29.y.git;a=blob_plain;f=drivers/net/forcedeth.c;hb=HEAD from mozilla like +browser to /mnt/home as forcedeth.c + +Download http://pastebin.com/RJAJT2MR the same way and rename it to 0001-Fix-up-DDE-paths.patch + +reboot back to hurd (multiuser) + +> $ apt-get update + +> $ apt-get upgrade + +> $ apt-get install git-core + +> $ apt-get build-dep hurd gnumach + +> $ apt-get install build-essential libpciaccess-dev libpcap0.8-dev + + +> $ cd /home/gnumach_dde + +> $ autoreconf -i && ./configure --enable-kdb --enable-device-drivers=none --enable-lpr --enable-floppy --enable-ide + +> $ make + +> $ cd ../hurd_dde + +> $ git am ../0001-Fix-up-DDE-paths.patch + +> $ cp -r dde_pcnet32 dde_forcedeth + +> $ cd dde_forcedeth + +> $ rm pcnet32.c + +> $ cp /home/forcedeth.c ./ + +> $ sed -i 's/pcnet32/forcedeth/g' Makefile + +> $ sed -i 's/pcnet32/forcedeth/g' .gitignore + +> $ sed -i 's:-lhurd-slab:../libhurd-slab/libhurd-slab.a:' Makefile + +> $ sed -i 's:-I/include:-I..:' Makefile + +> $ nano forcedeth.c + +add these 2 lines after the last #include + + #include <ddekit/timer.h> + void get_random_byter(void *buf, int nbytes) { } + +> $ cd .. + +> $ git add dde_forcedeth + +> $ git commit -a -m 'Add forcedeth driver' + +> $ autoreconf -i && ./configure + +> $ mkdir -p hurd/include/ddekit + +> $ make libddekit libmachdev devnode pfinet + +> $ cd libdde_linux26 + +> $ make + +> $ cd ../dde_forcedeth + +> $ make + +If the make fails it might be necassary to replace some of the -l options (or all) in Makefile with the real path to the library objects (example: change *-lhurd-slab* to *../libhurd-slab/libhurd-slab.a*) + +> $ cp /home/gnumach_dde/gnumach /boot/gnumach_dde + +> $ mkdir /hurd/dde + +> $ cp /home/hurd_dde/devnode/devnode /hurd/dde + +> $ cp /home/hurd_dde/pfinet/pfinet /hurd/dde + +> $ cp /home/hurd_dde/dde_forcedeth/dde_forcedeth /hurd/dde/forcedeth + +reboot to hurd with the new gnumach_dde + +> $ settrans -c /dev/forcedeth /hurd/dde/forcedeth + +> $ settrans -c /dev/eth0 /hurd/dde/devnode -M /dev/forcedeth eth0 + +> $ settrans -c /servers/socket/2 /hurd/dde/pfinet -i /dev/eth0 -a 192.168.1.194 -g 192.168.1.254 -m 255.255.255.0 + + +replace the ip, gateway and mask with your own ones + +> $ nano /etc/resolv.conf + +add line: nameserver 192.168.1.254 + +DONE diff --git a/hurd/running/distrib.mdwn b/hurd/running/distrib.mdwn index 229e2d8f..92904d19 100644 --- a/hurd/running/distrib.mdwn +++ b/hurd/running/distrib.mdwn @@ -71,7 +71,7 @@ about getting applications to work (if possible). <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> + <dd> Savannah is a CVS & 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> @@ -85,8 +85,8 @@ about getting applications to work (if possible). </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. [[debian/patch_submission]] 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> + <dt> Debian 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. [[debian/patch_submission]] 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 & turtle efforts. </dd> </dl> <dl> diff --git a/hurd/status.mdwn b/hurd/status.mdwn index b0fe1460..721cdeda 100644 --- a/hurd/status.mdwn +++ b/hurd/status.mdwn @@ -1,4 +1,4 @@ -[[!meta copyright="Copyright © 2001, 2002, 2007, 2008, 2009 Free Software +[[!meta copyright="Copyright © 2001, 2002, 2007, 2008, 2009, 2010 Free Software Foundation, Inc."]] [[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable @@ -49,7 +49,7 @@ so little would be gained by creating an official pure Hurd release. The Debian GNU/Hurd [[distribution|running/debian]] offers *LiveCDs and QEMU images* to test-drive the Hurd in a real life system with access to about -50% of the Debian software archive. +65% of the Debian software archive. The most recent version of the Debian port at the time of writing is *Debian GNU/Hurd L1*. diff --git a/hurd/virtual_file_system.mdwn b/hurd/virtual_file_system.mdwn index 1e2f68fb..b62a5e4c 100644 --- a/hurd/virtual_file_system.mdwn +++ b/hurd/virtual_file_system.mdwn @@ -13,7 +13,7 @@ No single entity is responsible for the resolution of path names. A file system server (a [[translator]]) attaches to translators (`fs.defs:file_set_translator`). -When a process resolves an aboslute path, it queries +When a process resolves an absolute path, it queries its root file system server by invoking the `fs.defs:dir_lookup` method in the capability in its root directory slot. The file system server resolves as much as it knows about locally diff --git a/public_hurd_boxen/installation/flubber.mdwn b/public_hurd_boxen/installation/flubber.mdwn index acf0fa68..66a01c3c 100644 --- a/public_hurd_boxen/installation/flubber.mdwn +++ b/public_hurd_boxen/installation/flubber.mdwn @@ -23,12 +23,3 @@ package instead. # *polipo* - - Starting polipo: /usr/lib/polipo/polipo-control: 145: /sbin/route: not found - polipo. - -## `/etc/rc.local` - - [...] - /usr/lib/polipo/polipo-control go-online - [...] diff --git a/user/jkoenig.mdwn b/user/jkoenig.mdwn index 14e40bf6..68020599 100644 --- a/user/jkoenig.mdwn +++ b/user/jkoenig.mdwn @@ -19,70 +19,126 @@ I will be keeping track of my progress on this page. ### Latest news - * *busybox*: - patches [posted](http://lists.debian.org/debian-bsd/2010/05/msg00048.html). - I need to test them on kFreeBSD, - then submit them upstream and to #323670. - * installation images boot with the following changes: - * rebuild hurd-udeb from with the latest pkg-hurd patches - * use busybox from my osports-debian branch (see link above) - * tweak the d-i image build scripts - * the symlink /lib/ld.so -> ld.so.1 needs to be created somehow - (youpi mentionned it being the job of libc0.3-udeb I think) - * fix the poll() issue in libdebian-installer - (patch to be submitted soon), - also there is some hurd doxygen short-circuiting stuff - there which does not apply any more and prevents is to build. - * initrd support coming soon (BTW gnumach does not like gcc-4.4), - for the time being it needs to be fed to qemu as a hard drive - (with some more space added to avoid it from becoming full) + * current status: + [busybox](http://lists.debian.org/debian-bsd/2010/05/msg00048.html), + [genext2fs](http://bugs.debian.org/562999), + [libdebian-installer](http://bugs.debian.org/584538) and + [gnumach initrd](http://lists.gnu.org/archive/html/bug-hurd/2010-06/msg00047.html) + have been worked on; + * [modified packages](http://jk.fr.eu.org/debian/unstable) and + [images](http://jk.fr.eu.org/debian/hurd-installer) published. ### Roadmap -#### Week 2 (2010-05-31 to 2010-06-06) - -* see what breaks in the installer and fix the problems one by one - (install-time netcfg, cdrom detection, whatever) -* start working on mach initrd support - -#### Week 3 (2010-06-07..13) +* **mach**: initrd support + * (./) preliminary patch posted and self-built (2010-06-12) + * adjustments will be needed (postponed) + * consider the alternatives discussed on bug-hurd (postponed) + +* **glibc**: fix `mkdir("/")` which returned `EINVAL` + * (./) eglibc 2.11.2-1 includes a quick fix by youpi (2010-06-15) + * (./) more complete patch posted to bug-hurd, + since other calls return incorrect errors under some circumstances + (2010-06-16) + * more work on it will be needed to make it fix the whole thing + (postponed) + +* **partman** + * (./) add hurd-i386 to + `partman-partitioning/lib/disk-label.sh` + (2010-06-16) + * (./) short-circuit + `partman-basicfilesystems/init.d/kernelmodules_basicfilesystems` + (2010-06-16) + * (./) partman-auto recipes: + make the default filesystem os-dependent + when it has not been preseeded (ie. the *seen* flag is clear) + * rebuild with responsible version numbers and upload to my repository + * submit patches to bugs.debian.org + (expected 2010-06-17) + +* **libparted**: fix device paths (expected 2010-06-17) + * one-char-er patch to be tested real soon + * submit to bugs.debian.org + +* **mach**/**libparted**: reloading the partition table (unsure, urgent) + * unfortunately, *non-workable-aroud* without a reboot + * rumour has it that there is some support in mach, + we need to coordinate that with userspace + * rumour has it that there is some code to handle partitions in userspace + with libparted, might be interesting as well + +* **d-i/installer/build**: (expected 2010-06-19) + * publish the patch I use + * sort out the changes suitable for inclusion + and ask youpi and/or debian-boot@l.d.o to commit them + +* **hurd-udeb**: (expected 2010-06-19) + * rebuild with the hack suggested by youpi for qemu network configuration + * cleanup, ask youpi to commit + +* **busybox**: submit upstream and to [[!debbug 323670]] (expected 2010-06-20) + * (./) I have mentioned my work on the upstream mailing list, + * merge the recent changes from upstream, + notably to the build system. + * ask upstream for review and merge + * backport any additional changes onto the debian branch + * hijack [[!debbug 323670]] and submit my patches + +*Milestone (expected 2010-06-21): +installer kindof works, with documented manual intervention required* + +* **partman**: further adjustments + * force 4k blocks in every case + * hide irrelevant mount options? (sync, relatime) + +* **busybox**: port + * fix stty/stat/ipcs on kFreeBSD, + * generally port more stuff, + * *ip* is needed for network configuration, + * *mount*, *swaponoff* can be from hurd-udeb for now, + though the kFreeBSD people will need them -* try to get the busybox changes merged upstream - and integrated into the debian package * tweak the hurd debian package to handle what native-install used to be required for + [apparently there's already some relevant stuff done in the postinst, + it might just work though maybe something is missing, + or some special code would be needed in the installer + to enable say, /servers/socket/local before anything + is attempted in the chroot] -#### Week 4 (2010-06-14..20) +* investigate the /hurd/proc issue + +* netcfg: make it work on Hurd somehow (port `busybox ip`?) * Hurd-specific partitionning (use supported fs types and options). NB: we will need support in mach to reload the partition tables, or alternatively use the parted support in libstore somehow. -* grub2 installation -#### Week 5-6 (2010-06-21..07-04) - -* unexpected stuff -* cleanup -* call for testing -* fix bugs - -At this point we would have a basic but working installer. -Hopefully the summer would not be over yet... - -#### Week 7-8 (2010-07-05..18) +* grub2 installation -* hurd console +*Milestone (expected 2010-07-05): +installer works but it's still somewhat ugly and broken* + +* call for testing and fix the bugs +* improve the [initrd situation](FIXME: link to bug-hurd post): + ajust the ramdisk support in Mach, + use tmpfs if possible, + possibly add `module -nounzip` to grub2. +* mklibs{,-copy}: + test library reduction, + make it copy the ld.so -> ld.so.1 symlink. +* hurd console fonts * better DHCP support during and after installation -* support more types of installation images - -#### Week 9-10 (2010-07-19..08-01) - -* give a shot at the graphical installer ? -#### Week 11-12 (2010-08-02..15) +*Milestone (expected 2010-07-19): +it works great and it's beautiful* * test, fix, document - +* support more types of installation images +* give a shot at the graphical installer if time permits +* see how [[zhengda]]'s work on DDE could be integrated +* etc.. ### Mostly done @@ -97,3 +153,22 @@ Hopefully the summer would not be over yet... (BTW would there be a mean to detect this from the libdiskfs bootstrap code and report it ?) +#### Week 2 (2010-05-31 to 2010-06-06) + +* *busybox*: patches [posted](http://lists.debian.org/debian-bsd/2010/05/msg00048.html). +* *libdebian-installer4*: [ditto](http://bugs.debian.org/584538) +* started working on mach initrd support +* the installation images could boot into the main-menu + with the following changes: + * rebuild hurd-udeb from with the latest pkg-hurd patches + * use busybox from my osports-debian branch (see link above) + * tweak the d-i image build scripts + * the symlink /lib/ld.so -> ld.so.1 needs to be created somehow + (youpi mentionned it being the job of libc0.3-udeb I think) + * fix the poll() issue in libdebian-installer + (patch to be submitted soon), + also there is some hurd doxygen short-circuiting stuff + there which does not apply any more and prevents is to build. + * feed the initrd as a hard drive in qemu + (with some more space added to avoid it from becoming full) + diff --git a/user/zhengda.mdwn b/user/zhengda.mdwn index 39af5699..0c3b26bb 100644 --- a/user/zhengda.mdwn +++ b/user/zhengda.mdwn @@ -12,23 +12,28 @@ porting DDE developed by DROPS to the Hurd, and it will still run in the user sp ##Introduction The introduction of DDE/DDEKit can be found in [here](http://wiki.tudos.org/DDE/DDEKit) and more information can be found [here](http://os.inf.tu-dresden.de/pipermail/l4-hackers/2009/004291.html). DDE/DDEKit is a library, and it should be compiled with the code of Linux or FreeBSD drivers. DDE Linux26 is still under development and it can now support network and block devices (but doesn't support SCSI). +##The current status +Currently a few NIC cards work now. I tested pcnet32, e100, e1000, ne2k-pci and rtl8139 in VMWare and Qemu. But the DDE e100 driver cannot work for some e100 cards as currently DDE doesn't support firmware. Someone also reported sis900 cannot work, unfortunately, I cannot test it myself. I appreciate if someone can try some other NIC drivers and give me some feedbback. Please run DDE with GNUMach in the [master-user_level_drivers](http://git.savannah.gnu.org/cgit/hurd/gnumach.git/) branch. + ## My work I separate DDE Linux26 to 2 parts: libddekit and libdde_linux26. I also provide a library called libmachdev on the top of the Linux code to provide the Mach device interface, so it is easy for the user to compile a Linux driver and run it in the Hurd. The latest code can be found in the dde branch of the incubator repository. -The current status: the pcnet32 driver can work very well in DDE Linux26 now. I hope someone can try other NIC drivers. Please run DDE with GNUMach in the [master-user_level_drivers](http://git.savannah.gnu.org/cgit/hurd/gnumach.git/) branch. - There is a minor problem when we compile a Linux driver. Linux drivers use jiffies to measure time. Unfortunately, Mach doesn't provide it, so whenever we need it, we need to calculate it by ourselves. I decide to provide a macro to calculate it for the sake of performance and the cost is that the source code of Linux drivers has to include ddekit/timer.h. ## Build and run DDE drivers -It is better to disable the corresponding kernel drivers in GNU Mach. For example, if we use the pcnet card, we'd better disable lance and pcnet32 drivers while building GNU Mach. DDE requires the pfinet with the modification during my GSoC project in 2008 and that pfinet requires libpcap-dev. To build DDE, we have to first install libpciaccess. libdde_linux26 has to be compiled manually (building dde_pcnet32 doesn't compile libdde_linux26 automatically). +To build a Linux driver with DDE Linux, we need libddekit, libdde_linux26, libmachdev and libhurd-slab. libddekit and libmachdev use the same Makefile system as other Hurd components but libdde_linux26 does not, so we have to build libdde_linux26 in its source file directory. DDE drivers use the same makefile system as libdde_linux26 and thus we need to build them in their source file directories as well. + +The repository has all DDE drivers I have tested, but in case you want to try other drivers, the easiest way is to use dde_pcnet32 as a template. The directory of dde_pcnet32 has Makefile, Makeconf.local, default.ld, pcnet32.c and main.c. If we need to build a new driver file, we only need to replace pcnet32.c with the new file and change Makefile accordingly. You also need to change DDEKITLIBDIR, DDEKITINCDIR, DDE26LIBDIR and OBJ_BASE in Makeconf.local to indicate the path to ddekit and dde_linux26. -To build a Linux driver with DDE Linux, the easiest way is to use dde_pcnet32 (also in the dde branch) as a template. The directory of dde_pcnet32 has Makefile, Makeconf.local, default.ld, pcnet32.c and main.c. If we need to build a new driver file, we only need to replace pcnet32.c with the new file and change Makefile accordingly. You also need to change DDEKITLIBDIR, DDEKITINCDIR, DDE26LIBDIR and OBJ_BASE in Makeconf.local to indicate the path to ddekit and dde_linux26. +When all parts are ready, we can start to build DDE drivers now. In case someone hasn't installed libpciaccess, please install it first. We first build libddekit, libdde-slab, then libdde_linux26, then libmachdev and at last the DDE driver. It's better to install libddekit, libdde-slab and libmachdev to the system, so libdde_linux26 and the DDE driver find the library files and header files. -To run a DDE NIC driver: +To run a DDE NIC driver: It is better to disable the corresponding kernel drivers in GNU Mach. For example, if we use the pcnet card, we'd better disable lance and pcnet32 drivers in gnumach. DDE requires the pfinet with modification during my GSoC project in 2008 and that pfinet requires libpcap-dev (this pfinet is also in the dde branch). settrans -acfg pcnet32 hurd/dde_pcnet32/dde_pcnet32 + settrans -acfg /dev/eth0 hurd/devnode/devnode eth0 -M pcnet32 + settrans -acfg /servers/socket/2 hurd/pfinet/pfinet -i /dev/eth0 -a 172.16.172.10 -g 172.16.172.2 -m 255.255.255.0 --- |