summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorantrik <antrik@users.sf.net>2011-07-09 12:41:54 +0200
committerantrik <antrik@users.sf.net>2011-07-10 02:04:54 +0200
commita8e3de8d7b9237e69346fcf44010a41d5da08c8e (patch)
tree0338556bd4da1f8ccd3bb0b5ec120c1cfaa861f8
parent22fd6914758fe7f049fe39b71297a0874b8d6150 (diff)
dde/guide: Use tabs instead of quote marks
This way we lose the indentation -- but special characters are escaped automatically. Also, the commands appear in monospace font (as <pre> blocks) this way, which I think is better. There might be some prettier option -- but I'm too lazy to check :-) The formatting of the whole thing is not exactly good anyways...
-rw-r--r--hurd/dde/guide.mdwn98
1 files changed, 49 insertions, 49 deletions
diff --git a/hurd/dde/guide.mdwn b/hurd/dde/guide.mdwn
index e3588335..31671308 100644
--- a/hurd/dde/guide.mdwn
+++ b/hurd/dde/guide.mdwn
@@ -28,41 +28,41 @@ so we can downloading everything we will need for building DDE.
Once there, first mount the Hurd partition (as root):
-> $ mount /dev/hdd1 /mnt -t ext2 # assuming your Hurd partition is hdd1 -- replace with whatever matches your setup
+ $ mount /dev/hdd1 /mnt -t ext2 # assuming your Hurd partition is hdd1 -- replace with whatever matches your setup
Prepare apt offline configuration so we can get necessary packages:
-> $ cd /mnt/etc/apt
+ $ cd /mnt/etc/apt
-> $ echo "deb http://ftp.debian-ports.org/debian unreleased main" >> sources.list # if you don't have sources.list set up yet on the Hurd system
+ $ echo "deb http://ftp.debian-ports.org/debian unreleased main" >> sources.list # if you don't have sources.list set up yet on the Hurd system
-> $ echo "deb-src 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 http://ftp.uk.debian.org/debian unstable main" >> sources.list
-> $ echo "deb-src 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
+ $ wget http://www.gnu.org/software/hurd/hurd/running/debian/DebianAptOffline/apt.conf.offline
Download the packages for offline installation:
-> $ cd /mnt
+ $ cd /mnt
-> $ apt-get -c etc/apt/apt.conf.offline update
+ $ apt-get -c etc/apt/apt.conf.offline update
-> $ apt-get -c etc/apt/apt.conf.offline build-dep hurd gnumach
+ $ apt-get -c etc/apt/apt.conf.offline build-dep hurd gnumach
-> $ apt-get -c etc/apt/apt.conf.offline install git-core build-essential libpciaccess-dev libpcap0.8-dev
+ $ apt-get -c etc/apt/apt.conf.offline install git-core build-essential libpciaccess-dev libpcap0.8-dev
Get DDE code:
-> $ cd /mnt/home/me # assuming your user name on the Hurd system is "me"
+ $ cd /mnt/home/me # assuming your user name on the Hurd system is "me"
-> $ mkdir dde && cd dde
+ $ mkdir dde && cd dde
-> $ git clone git://git.sv.gnu.org/hurd/incubator.git -b dde hurd
+ $ git clone git://git.sv.gnu.org/hurd/incubator.git -b dde hurd
-> $ git clone git://git.sv.gnu.org/hurd/gnumach.git -b master-user_level_drivers
+ $ git clone git://git.sv.gnu.org/hurd/gnumach.git -b master-user_level_drivers
Now comes the tricky part:
you need to find out
@@ -82,7 +82,7 @@ the right source file from Linux:
Point a (JavaScript-capable) web browser at
-> http://git.kernel.org/?p=linux/kernel/git/stable/linux-2.6.29.y.git;a=tree;f=drivers/net;hb=HEAD
+ http://git.kernel.org/?p=linux/kernel/git/stable/linux-2.6.29.y.git;a=tree;f=drivers/net;hb=HEAD
(Note: you **have** to use 2.6.29,
as this is the version DDE is currently based on.)
@@ -103,88 +103,88 @@ so we can boot into Hurd to do the actual work.
Once there, install the packages previously downloaded (again as root):
-> $ apt-get build-dep hurd gnumach
+ $ apt-get build-dep hurd gnumach
-> $ apt-get install git-core build-essential libpciaccess-dev libpcap0.8-dev
+ $ apt-get install git-core build-essential libpciaccess-dev libpcap0.8-dev
Make sure we can build stuff as normal user:
-> $ chown -R me ~me/dde
+ $ chown -R me ~me/dde
Now you can log in with the normal user account to build stuff.
Build a DDE-enabled Mach:
-> $ cd ~me/dde/gnumach
+ $ cd ~me/dde/gnumach
-> $ autoreconf -i && ./configure --enable-kdb --enable-device-drivers=none --enable-lpr --enable-floppy --enable-ide
+ $ autoreconf -i && ./configure --enable-kdb --enable-device-drivers=none --enable-lpr --enable-floppy --enable-ide
-> $ make
+ $ make
If not already present in DDE,
we need to prepare the driver for the network card:
-> $ cd ~me/dde/hurd
+ $ cd ~me/dde/hurd
-> $ cp -r dde_pcnet32 dde_forcedeth # using pcnet32 as template
+ $ cp -r dde_pcnet32 dde_forcedeth # using pcnet32 as template
-> $ cd dde_forcedeth
+ $ cd dde_forcedeth
-> $ rm pcnet32.c # don't want the actual pcnet32 code here...
+ $ rm pcnet32.c # don't want the actual pcnet32 code here...
-> $ cp ~me/dde/forcedeth.c . # ...but rather the forcedeth code
+ $ cp ~me/dde/forcedeth.c . # ...but rather the forcedeth code
-> $ sed -i 's/pcnet32/forcedeth/g' Makefile # adapt Makefile accordingly
+ $ sed -i 's/pcnet32/forcedeth/g' Makefile # adapt Makefile accordingly
-> $ sed -i 's/pcnet32/forcedeth/g' .gitignore
+ $ sed -i 's/pcnet32/forcedeth/g' .gitignore
-> $ sed -i 's:-lhurd-slab:../libhurd-slab/libhurd-slab.a:' Makefile # fix up build system... XXX I guess this part is obsolete
+ $ sed -i 's:-lhurd-slab:../libhurd-slab/libhurd-slab.a:' Makefile # fix up build system... XXX I guess this part is obsolete
-> $ sed -i 's:-I/include:-I..:' Makefile # same
+ $ sed -i 's:-I/include:-I..:' Makefile # same
-> $ nano forcedeth.c # Near the top of the file, there will be many #include lines. After the last one, add this:
+ $ nano forcedeth.c # Near the top of the file, there will be many #include lines. After the last one, add this:
#include <ddekit/timer.h>
-> $ cd ..
+ $ cd ..
Commit the new driver with git.
This will be helpful if we update the DDE code later;
as well as for creating a patch for later reuse
and/or upstream submission:
-> $ git add dde_forcedeth
+ $ git add dde_forcedeth
-> $ git commit -a -m 'Add forcedeth driver'
+ $ git commit -a -m 'Add forcedeth driver'
Having prepared the driver,
we can now build the necessary Hurd and DDE bits:
-> $ autoreconf -i && ./configure
+ $ autoreconf -i && ./configure
-> $ mkdir -p hurd/include/ddekit # workaround for a buildsystem bug... XXX I'm pretty sure this is not necessary anymore
+ $ mkdir -p hurd/include/ddekit # workaround for a buildsystem bug... XXX I'm pretty sure this is not necessary anymore
-> $ make libddekit libmachdev devnode pfinet # Hurd components
+ $ make libddekit libmachdev devnode pfinet # Hurd components
-> $ cd libdde_linux26 # common DDE driver code -- uses a different Makefile system than the Hurd components!
+ $ cd libdde_linux26 # common DDE driver code -- uses a different Makefile system than the Hurd components!
-> $ make
+ $ make
-> $ cd ../dde_forcedeth # actual driver
+ $ cd ../dde_forcedeth # actual driver
-> $ make
+ $ make
Install the various built components to their final destinations (as root):
-> $ cd ~me/dde/
+ $ cd ~me/dde/
-> $ cp gnumach/gnumach /boot/gnumach_dde
+ $ cp gnumach/gnumach /boot/gnumach_dde
-> $ mkdir /hurd/dde
+ $ mkdir /hurd/dde
-> $ cp hurd/devnode/devnode hurd/pfinet/pfinet hurd/dde_forcedeth/dde_forcedeth /hurd/dde
+ $ cp hurd/devnode/devnode hurd/pfinet/pfinet hurd/dde_forcedeth/dde_forcedeth /hurd/dde
Now everything should be ready.
@@ -197,14 +197,14 @@ in the boottime grub menu while testing.)
Once there, set up the translators for the driver (as root):
-> $ settrans -c /dev/forcedeth /hurd/dde/forcedeth
+ $ settrans -c /dev/forcedeth /hurd/dde/forcedeth
-> $ settrans -c /dev/eth0 /hurd/dde/devnode -M /dev/forcedeth eth0
+ $ settrans -c /dev/eth0 /hurd/dde/devnode -M /dev/forcedeth eth0
Finally, we can set up the actual network translator,
using something like:
-> $ 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
+ $ 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
For the exact syntax,
see the normal network setup documentation.