9 files changed, 189 insertions, 0 deletions
diff --git a/faq/running/df.mdwn b/faq/running/df.mdwn
new file mode 100644
index 00000000..9987a373
--- /dev/null
+++ b/faq/running/df.mdwn
@@ -0,0 +1,22 @@
+[[!meta copyright="Copyright © 2007, 2008, 2013 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]]."]]"""]]
+
+[[!meta title="Why df doesn't work?"]]
+
+There is no `/etc/mtab` (due to dynamic translator startup, its content is hard
+to define actually, see
+[[the mtab GSoC project idea|community/gsoc/project_ideas/mtab]]),
+so just running `df` will yield the following error.
+
+    df: cannot read table of mounted file systems
+
+Pass `df` a path like `df /` or `df ./` to see the disk usage of that particular
+file system.
diff --git a/faq/running/hurd_console.mdwn b/faq/running/hurd_console.mdwn
new file mode 100644
index 00000000..f55e30d2
--- /dev/null
+++ b/faq/running/hurd_console.mdwn
@@ -0,0 +1,15 @@
+[[!meta copyright="Copyright © 2007, 2008, 2013 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]]."]]"""]]
+
+[[!meta title="How about the virtual console?"]]
+
+Edit `/etc/default/hurd-console` to configure the Hurd console.
+See [[hurd/console]] for further information about the Hurd console.
diff --git a/faq/running/kernel_logs.mdwn b/faq/running/kernel_logs.mdwn
new file mode 100644
index 00000000..0c9e05a0
--- /dev/null
+++ b/faq/running/kernel_logs.mdwn
@@ -0,0 +1,16 @@
+[[!meta copyright="Copyright © 2007, 2008, 2013 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]]."]]"""]]
+
+[[!meta title="dmesg, kernel logs"]]
+
+There is no `dmesg` command, since the kernel does not keep a buffer of its
+messages. syslog however dumps them into `/var/log/dmesg`, so you can simply cat
+that.
diff --git a/faq/running/off.mdwn b/faq/running/off.mdwn
new file mode 100644
index 00000000..eb2a6d1c
--- /dev/null
+++ b/faq/running/off.mdwn
@@ -0,0 +1,23 @@
+[[!meta copyright="Copyright © 2010, 2013 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]]."]]"""]]
+
+[[!meta title="shutdown does not work, how am I supposed to shut my Hurd system down?"]]
+
+The GNU/Hurd does not use SYSV runlevels, so commands like
+
+    # shutdown -h now
+
+will not work. Simply use the equivalent shortcuts
+
+    # halt
+    # reboot
+
+to respectively shutdown and reboot Hurd, provided natively,
+instead of from SYSV runlevels.
diff --git a/faq/running/ps_hangs.mdwn b/faq/running/ps_hangs.mdwn
new file mode 100644
index 00000000..b58a3308
--- /dev/null
+++ b/faq/running/ps_hangs.mdwn
@@ -0,0 +1,13 @@
+[[!meta copyright="Copyright © 2007, 2008, 2013 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 `ps` hangs, try `ps -M` which should still work by not getting detailed
+information from processes.
diff --git a/faq/running/serial_console.mdwn b/faq/running/serial_console.mdwn
new file mode 100644
index 00000000..44453ac5
--- /dev/null
+++ b/faq/running/serial_console.mdwn
@@ -0,0 +1,15 @@
+[[!meta copyright="Copyright © 2002, 2003, 2004, 2006, 2007, 2008, 2009, 2010,
+2013 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]]."]]"""]]
+
+[[!meta title="How do I initialize a serial console on the Hurd?"]]
+
+  * You can try out the Serial Howto at <http://www.nongnu.org/thug/serial-howto.txt>
+  * For kernel messages, you can append `console=com0` to the kernel command line.
diff --git a/faq/running/slash_usr_symlink.mdwn b/faq/running/slash_usr_symlink.mdwn
new file mode 100644
index 00000000..e7d7776a
--- /dev/null
+++ b/faq/running/slash_usr_symlink.mdwn
@@ -0,0 +1,20 @@
+[[!meta copyright="Copyright © 2001, 2002, 2003, 2004, 2005, 2008, 2013 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]]."]]"""]]
+
+[[!meta title="Why is `/usr' a symbolic link to `.'?"]]
+
+The distinction between `/` and `/usr` has historical reasons.  Back when [[Unix]]
+systems were booted from two tapes, a small root tape and a big user tape.
+Today, we like to use different partitions for these two spaces.  The Hurd
+throws this historical garbage away.  We think that we have found a more
+flexible solution called union filesystems, which allow to create virtual
+filesystems which are the union of several other filesystems.  However, support
+for union filesystems is [[still in early development|hurd/translator/unionfs]].
diff --git a/faq/running/slash_usr_symlink/discussion.mdwn b/faq/running/slash_usr_symlink/discussion.mdwn
new file mode 100644
index 00000000..219e14e4
--- /dev/null
+++ b/faq/running/slash_usr_symlink/discussion.mdwn
@@ -0,0 +1,45 @@
+[[!meta copyright="Copyright © 2012 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]]."]]"""]]
+
+[[!tag open_issue_documentation]]
+
+
+# IRC, freenode, #hurd, 2012-02-01
+
+    <marcusb> I remember the time when we had a /usr symlink.  Now fedora 17
+      will move / to /usr and have /foo symlinks.  :)
+    <marcusb> braunr:
+      http://www.freedesktop.org/wiki/Software/systemd/TheCaseForTheUsrMerge
+    <marcusb> braunr: fedora and others are merging /bin, /sbin and some other
+      into /usr
+    <marcusb> braunr: back in 1998 we tried for two years or so to have /usr ->
+      ..  in Debian GNU/Hurd, but eventually we gave up on it, because it broke
+      some stuff
+    <gnu_srs> marcusb: Hi, which one is better (in your opinion): / or /usr?
+    <marcusb> gnu_srs: fedora says that using /usr allows better separation of
+      distribution files and machine-local files
+    <braunr> marcusb: won't it break remote /usr ?
+    <marcusb> so you can atomically mount the OS files to /usr
+    <marcusb> gnu_srs: but in the end, it's a wash
+    <marcusb> personally, I think every package should get its own directory
+    <braunr> marcusb: what PATH then ?
+    <marcusb> braunr: well, I guess you'd want to assemble a union filesystem
+      for a POSIX shell 
+    <braunr> marcusb: i don't see what you mean :/
+    <braunr> ah this comes from Lennart Poettering
+    <marcusb> braunr: check out for example how http://nixos.org/ does it
+    <manuel> braunr: something like, union /package1/bin /package2/bin
+      /package3/bin for /bin, /package1/lib /package2/lib /package3/lib for
+      /lib, etc. I guess
+    <braunr> manuel: would that scale well ?
+    <marcusb> the idea that there is only one correct binary for each program
+      with the name foo is noble, but a complete illusion that hides the
+      complexity of the actual configuration management task
+    <braunr> marcusb: right
diff --git a/faq/running/xserver-common.mdwn b/faq/running/xserver-common.mdwn
new file mode 100644
index 00000000..68058641
--- /dev/null
+++ b/faq/running/xserver-common.mdwn
@@ -0,0 +1,20 @@
+[[!meta copyright="Copyright © 2007, 2008, 2013 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]]."]]"""]]
+
+[[!meta title="Normal users can't start X"]]
+
+This happens because currently there is no way to detect console users.
+
+On Debian GNU/Hurd systems, you need to run
+
+    # dpkg-reconfigure x11-common
+
+and select `Anybody` for starting X.