Merge branch 'master' into external_pager_mechanism

Conflicts:
	microkernel/mach/external_pager_mechanism.mdwn

4 files changed, 200 insertions, 0 deletions

diff --git a/hurd/running/qemu/babhurd_image.mdwn b/hurd/running/qemu/babhurd_image.mdwn
new file mode 100644
index 00000000..c0952fcf
--- /dev/null
+++ b/hurd/running/qemu/babhurd_image.mdwn
@@ -0,0 +1,67 @@
+What this little Hurd image can do
+----------------------------------
+
+### About this text
+
+This is the README file accompanying a 
+[disk\_image](http://draketo.de/dateien/hurd/bab-hurd-qemu-2008-10-29.img.tar.bz2) for 
+[[running_the_GNU/Hurd_via_qemu|hurd/running/qemu]]. To run the disk image, just use *'qemu 
+disk_image.img'*. 
+
+You can find the custom *.bashrc* used to tell the user about it as well as this text itself 
+in the Mercurial repository [hurd_intro](http://bitbucket.org/ArneBab/hurd_intro). 
+
+### Intro
+
+The Hurd has some unique capabilities, and we created this simple image 
+to enable you to easily try two of them: 
+
+* The simplest of translators: Hello World!
+* Transparent FTP
+
+### Hello World
+
+To try out the simplest of translators, you can go the following simple steps: 
+
+	$ cat hello  
+	$ setrans hello /hurd/hello  
+	$ cat hello  
+	"Hello World!"  
+	$ settrans -g hello  
+	$ cat hello  
+
+What you do with these steps is first verifying that the file "hello" is empty. 
+
+Then you setup the translator /hurd/hello in the file/node hello. 
+
+After that you check the contents of the file, and the translator returns "Hello World!". 
+
+To finish it, you tell the translator to go away from the file "hello" via "settrans -g hello" and verify that now the file is empty again. 
+
+### Transparent FTP
+
+We already setup a a transparent FTP translator for you at /ftp: 
+
+With it you can easily access public FTP via the file system, for example the one from the GNU project: 
+
+	$ ls /ftp://ftp.gnu.org/
+
+But you can also do this very easily yourself: 
+
+	$ # Setup the translator on the node ftp:  
+	$ settrans -c ftp: /hurd/hostmux /hurd/ftpfs /
+
+and you can access FTP sites via the pseudo-directory ftp:, for example with 
+
+	$ ls ftp://ftp.gnu.org/
+
+What you do here is setting up the translator /hurd/hostmux on ftp: and passing it the translator /hurd/ftpfs to use for resolving accesses as well as / as additional path component. 
+
+
+These were only two basic usages of translators on the Hurd. We're sure you'll quickly see many other ways to use this. 
+
+As a last comment: You can setup a translator on any node you have access to, so you can for example mount any filesystems as normal user. 
+
+You might currently be logged in as root, but you could just as well do the same as normal user. 
+
+Why don't you try it out? 
diff --git a/hurd/running/qemu/microsoft_windows.mdwn b/hurd/running/qemu/microsoft_windows.mdwn
new file mode 100644
index 00000000..832b4bef
--- /dev/null
+++ b/hurd/running/qemu/microsoft_windows.mdwn
@@ -0,0 +1,52 @@
+[[!meta copyright="Copyright © 2007, 2008 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]]."]]"""]]
+
+Welcome, This document is for getting you started in a few minutes.
+
+1. Install Qemu for Windows
+
+    The executable can be downloaded from
+    <http://free.oszoo.org/ftp/qemu/win32/release/> Doble click on the
+    installer and follow the instructions.
+
+2. Obtain Qemu image 
+
+    * Debian GNU/Hurd qemu image can be downloaded from
+        <http://www.numenor.art.pl/balrog/hurd/>, but also see the main
+        [[QEMU]] page.
+    * Uncompress the image and rename it to debian-hurd-for-qemu.img (.img is
+        the only thing that matters, you can chose any name) Note: .img is for
+        QEMUMenu.bat, which saves you from remembering the command line options
+        of qemu and helps you change the settings (like chosing different
+        images, allocating RAM for the guest OS ...) interactivly.
+    * Copy this file to the directory where you installed Qemu.
+
+3. Start Qemu
+
+    Double click the QEMUMenu.bat and enter the number to chose between images.
+
+4. Qemu short cuts
+
+    * ctrl alt - to exit grab from qemu, get mouse cursor out from the qemu
+        window
+    * ctrl alt f - full screen
+    * ctrl alt 2 - qemu contrl console, use this to change devices
+        (eg. changing cdrom), send keys to the guest (for example if you want
+        to send ctrl alt del to the guest type "sendkey ctrl-alt-del" ... type
+        "help" for a listing of all the options.
+    * ctrl alt 1 - Hurd login console
+
+## QEmu Image Hangs on Boot
+The Debian GNU/Hurd K16 QEmu image hangs during the boot process. You may have better luck by converting the image to qcow format
+
+    ..\qemu-0.9.0-x86\qemu-img.exe convert debian-hurd-k16-qemu.img -O
+    qcow debian-hurd-k16-qemu.qcow
+    ..\qemu-0.9.0-x86\qemu.exe -L ..\qemu-0.9.0-x86 -m 512 -hda
+    debian-hurd-k16-qemu.qcow -localtime -M pc
diff --git a/hurd/running/qemu/networking.mdwn b/hurd/running/qemu/networking.mdwn
new file mode 100644
index 00000000..71daa576
--- /dev/null
+++ b/hurd/running/qemu/networking.mdwn
@@ -0,0 +1,43 @@
+[[!meta copyright="Copyright © 2007, 2008 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]]."]]"""]]
+
+## User mode network
+
+This is the default networking option for qemu.  This does not require root
+previleges.  If you have DHCP running it will take the ip as 10.0.2.15
+
+You can setup an ip 10.0.2.*
+Gateway is 10.0.2.2
+Name server is 10.0.2.3
+Netmask is 255.255.255.0
+
+You can setup the pfinet translator with the command
+
+    $ settrans -fgap /servers/socket/2 /hurd/pfinet -a 10.0.2.15 -g 10.0.2.2 -m 255.255.255.0
+
+Configure nameserver in /etc/resolve.conf
+
+    nameserver 10.0.2.3
+
+Setup a proxy with the command
+
+    $ export http_proxy="http://<proxy.com>:<port>"
+
+Note: you can add this to your /etc/profile file so that every time you don't
+have to setup this.
+
+If you are using a direct connection to internet install a proxy server on the
+host os and use this.  (I was not able to use it without proxy)
+
+You might be able to do it using iptables, some clues
+<http://sujith-h.livejournal.com/9520.html>
+
+Use scp,ftp... to transfer files (also see
+[[hurd/running/debian/faq#index2h1]]), read about [[sharing_files]].
diff --git a/hurd/running/qemu/networking/sharing_files.mdwn b/hurd/running/qemu/networking/sharing_files.mdwn
new file mode 100644
index 00000000..5bdec5f1
--- /dev/null
+++ b/hurd/running/qemu/networking/sharing_files.mdwn
@@ -0,0 +1,38 @@
+[[!meta copyright="Copyright © 2007, 2008 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]]."]]"""]]
+
+# SCP
+
+Setup OpenSSH server on host system. 
+
+* Copying files from Guest to Host
+
+        $ scp <file> <user>@<host>:
+
+* Copying files from Host to Guest.
+
+        $ scp <user>@<host>:<file>
+
+Use scp -r for copying directories.
+
+
+# FTP
+
+Setup ftp server (like proftpd) on the host.
+
+* Use ftp client from GNU inetutils
+
+        $ ftp <host>
+
+    Use mget to copy files from host and mput to copy files to the host.
+
+* The GNU way - setup an ftp translator
+
+        $ settrans -ac ftp/<host> /hurd/ftpfs <username>:<password>@<host>:<path>