summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/AUTHORS1
-rw-r--r--docs/CREDITS3
-rw-r--r--docs/FAQ70
3 files changed, 71 insertions, 3 deletions
diff --git a/docs/AUTHORS b/docs/AUTHORS
index 1d63e4742..3cc45330d 100644
--- a/docs/AUTHORS
+++ b/docs/AUTHORS
@@ -6,4 +6,3 @@ Main Contributors:
* Chris Lamb <lamby@debian.org>
* Otavio Salvador <otavio@debian.org>
- * Richard Nelson <unixabg@gmail.com>
diff --git a/docs/CREDITS b/docs/CREDITS
index e38e2ee9c..4d89790f4 100644
--- a/docs/CREDITS
+++ b/docs/CREDITS
@@ -48,8 +48,7 @@ Donations (alphabetical order):
Special thanks (alphabetical order):
- * Ben Armstrong <synrg@debian.org> for his IRC support and tremendous work on
- documentation.
+ * Ben Armstrong <synrg@debian.org> for his IRC support.
* Jason D. Clinton <me@jasonclinton.com> for his work on netboot type.
* Otavio Salvador <otavio@debian.org> for his QA patches.
* Richard Nelson <rjent@rjent.pair.com> for live-webhelper.
diff --git a/docs/FAQ b/docs/FAQ
new file mode 100644
index 000000000..7be46df8b
--- /dev/null
+++ b/docs/FAQ
@@ -0,0 +1,70 @@
+Frequently Asked Questions (FAQ)
+================================
+
+Build Time
+----------
+
+Q: Is live-helper/make-live Debian specific?
+A: live-helper supports Debian and Ubuntu right now. Adding automatic defaults
+ for other Debian derivatives is easy - let us know about them and we may
+ include it.
+
+
+Q: How can I build images with an unprivileged user account?
+A: You can use --root-command sudo or set LH_ROOT_COMMAND="sudo" in
+ config/common.
+
+ *BIG* *FAT* *WARNING*: Building an image as non-root can make your image
+ different compared to a regular Debian system (different owners of files). It
+ is *NOT* recommended to build images as non-root. Do *NOT* use this feature
+ yet.
+
+
+Q: How do I drop in to a shell during make-live chroot process?
+A: Use "--interactive shell", then exit with 'logout' when you have made the
+ setting changes you want and the build process will continue.
+
+
+Q: Where to set the username or the hostname?
+A: casper uses default username 'casper' and hostname 'live'. You can specify
+ them by passing 'username=' and 'hostname=' as kernel parameters.
+
+ live-helper automatically sets the username to 'user' and the hostname to
+ 'debian'. If you want to change this at build time, pass --username and
+ --hostname to make-live, or alter LIVE_USERNAME and LIVE_HOSTNAME in
+ config/image.
+
+
+Q: How can I make my own grub bootsplash?
+A: To add a grub splash screen, you can use --grub-splash FILE, or copy your
+ custom splash to config/binary_grub/splash.xpm.gz.
+
+ Documentation about creating a bootsplash for grub can be found at:
+ <http://ruslug.rutgers.edu/~mcgrof/grub-images/>
+
+
+Q: How can I make my own syslinux bootsplash?
+A: To add a syslinux splash screen, you can use --syslinux-splash FILE, or copy
+ your custom splash to config/binary_syslinux/splash.rle.
+
+ Documentation about creating a bootsplash for grub can be found at:
+ <http://www.sweb.cz/Frantisek.Rysanek/splash/isolinux-splash-HOWTO.html>
+ contrib/syslinux-splash/COPYING in the live-helper sources.
+
+ Basically, you need to install netpbm and syslinux, and run this:
+ anytopnm < $your_splash > $your_splash.pnm
+ pnmcolormap 15 < $your_splash.pnm > $your_splash.map
+ pnmremap -map=$your_splash.map $your_splash.pnm | \
+ ppmtolss16 '#ffffff=7' > splash.rle
+
+
+Run Time
+--------
+
+Q: What is the root password?
+A: There is none set. You can switch to root with 'sudo -i' or set a password
+ with 'sudo passwd'.
+
+
+Q: What is the user password?
+A: The password for the default user is 'live'.