add serial console debugging notes

7 files changed, 95 insertions, 19 deletions

diff --git a/README b/README
index 1343b25..16bdc4e 100644
--- a/README
+++ b/README
@@ -52,6 +52,12 @@ Once the above build requirements are satisfied:
     lb config
     lb build
 
+    lb clean --binary
+    lb config
+    lb binary_chroot
+    lb binary_rootfs
+    lb binary_hdd
+
 ### Develop
 
 Basic configuration options are in ./auto/config
diff --git a/TODO b/TODO
index 22c610f..c82bea3 100644
--- a/TODO
+++ b/TODO
@@ -8,4 +8,33 @@
 - set user password
     http://live.debian.net/manual/html/live-manual.en.html#505
 - dreamplug: uap hack, libertas firmware
-- ntp.conf
+- ntp.conf?
+- sudo setuid problem?
+	+ Configure_sudo
+	+ grep -qs ^torouter /etc/sudoers.d/live
+	+ echo torouter ALL=(ALL) NOPASSWD: ALL
+	+ chmod 0440 /etc/sudoers.d/live
+	+ sudo -u torouter sh -c echo 'SU_TO_ROOT_SU=sudo' >> /home/torouter/.su-to-rootrc
+	sudo: unknown user: torouter
+	sudo: unable to initialize policy plugin
+
+- /var/lib/tor permissions:
+	Nov 17 21:20:25.064 [warn] /var/lib/tor is not owned by this user (debian-tor, 105) but by root (0). Perhaps you are running Tor as the wrong user?
+	Nov 17 21:20:25.065 [warn] Failed to parse/validate config: Couldn't access/create private data directory "/var/lib/tor"
+	Nov 17 21:20:25.065 [err] Reading config failed--see warnings above.
+
+serial login debugging:
+- user not being created correctly?
+- init seems to be the problem: doesn't respect inittab
+    - maybe due to earlier init not completing? known problem w/ rc.local
+    - 'init s' then canceling brings up login correctly
+    - ordering of script might be the problem? tried moving to 010-*
+- add "dhclient eth0" to 9999-* and "echo root:crud | chpasswd" script to
+  enable remote login and set root password (for debugging with a router+ssh)
+- tried removing modprobe.d and sysctl.conf files
+- mildly shifted u-boot parameters around...
+- perhaps a new or changed set of packages? or a package dependancy?
+- also, haven't been building regularly due to missing symlink problem
+- maybe need to update host's live-boot, live-config?
+- or should add snapshots repos to the package list?
+- WORKED BEFORE ARG
diff --git a/doc/debian-live-problems.txt b/doc/debian-live-problems.txt
index 0ca005d..13fe99b 100644
--- a/doc/debian-live-problems.txt
+++ b/doc/debian-live-problems.txt
@@ -7,6 +7,9 @@ here:
 
 ### Errors when building flat ("plain") filesystem images
 
+NOTE: these problems should have been fixed by removing the rootfs stage from
+caching?
+
 When building a chroot-filesystem=none image, if you encounter:
 
     cp: cannot create regular file `binary/live/filesystem.packages': No such file or directory
@@ -20,6 +23,21 @@ If you don't run the second line as well, you will get the error:
 
     cp: cannot stat `cache/binary_rootfs/filesystem.*': No such file or directory
 
+### Missing symlinked files
+
+If you get a boot error like:
+
+    Kernel panic - not syncing: Attempted to kill init!
+
+Then init may be unable to link to necessary library (like lib/ld-linux.so.3),
+because of some badness in the binary build system. Try overcoming with:
+
+    lb clean --binary
+    lb config
+    lb binary_chroot
+    lb binary_rootfs
+    lb binary_hdd
+
 ### mksquashfs Segfaults in qemu
 
 mksquashfs always segfaults when run inside of qemu. Perhaps due to large
diff --git a/doc/dev.txt b/doc/dev.txt
new file mode 100644
index 0000000..1061730
--- /dev/null
+++ b/doc/dev.txt
@@ -0,0 +1,8 @@
+
+If you build "plainroot" flat ext3 images during development, you might be able
+to save time by using rsync instead of dd:
+
+    sudo mount /dev/sdb1 /mnt
+    sudo rsync -arv ./binary/ /mnt/
+    sudo umount /mnt
+
diff --git a/doc/dns-dhcp.txt b/doc/dns-dhcp.txt
new file mode 100644
index 0000000..ec5caed
--- /dev/null
+++ b/doc/dns-dhcp.txt
@@ -0,0 +1,21 @@
+
+The DNS and DHCP scheme is very complicated.
+
+torouter itself (the base configuration) uses the OpenDNS servers, as
+configured in /etc/resolv.conf.
+
+Seperate dnsmasq configurations and init scripts are used for local ethernet
+and the transparently tor-ified wifi access point. The "regular" dnsmasq daemon
+is disabled (in /etc/default/dnsmasq). The ethernet daemon makes upstream
+requests "as usual" (according to /etc/resolve.conf), while the wifi daemon
+makes upstream requests to ttdnsd on port 5354.
+
+ttdnsd is used to make upstream requests locally via Tor on port 5353. It is
+configured in /etc/default/ttdnsd and listens for requests on port 5354.
+
+Tor is configured (in /etc/tor/torrc) to listen locally on port 5353 of address
+172.16.23.1.
+
+The /etc/network/interfaces file makes pre- and post- interface configuration
+calls to (re) start the tor, ttdnsd, and dnsmasq daemons.
+
diff --git a/doc/dreamplug.txt b/doc/dreamplug.txt
index af5c0ed..fd72444 100644
--- a/doc/dreamplug.txt
+++ b/doc/dreamplug.txt
@@ -32,7 +32,8 @@ The desired u-boot configuration is:
     x_bootcmd_kernel ext2load usb 1:1 0x6400000 live/uImage
     x_bootcmd_initrd ext2load usb 1:1 0x6900000 live/uInitrd
     x_bootargs_root root=/dev/sdb1 rootdelay=4
-    x_bootargs console=ttyS0,115200 boot=live config username=torouter hostname=torouter live-media=/dev/sdb1 live-media-timeout=10 debug plainroot
+    x_bootargs_console console=ttyS0,115200
+    x_bootargs boot=live config username=torouter hostname=torouter live-media=/dev/sdb1 live-media-timeout=10 debug plainroot
 
 
 HOWTO: flash and configure u-boot
@@ -59,7 +60,8 @@ file size changes from exactly 196076 bytes):
     setenv x_bootcmd_kernel ext2load usb 1:1 0x6400000 live/uImage
     setenv x_bootcmd_initrd ext2load usb 1:1 0x6900000 live/uInitrd
     setenv x_bootargs_root root=/dev/sdb1 rootdelay=4
-    setenv x_bootargs console=ttyS0,115200 boot=live config username=torouter hostname=torouter live-media=/dev/sdb1 live-media-timeout=10 debug plainroot
+    setenv x_bootargs_console console=ttyS0,115200
+    setenv x_bootargs boot=live config username=torouter hostname=torouter live-media=/dev/sdb1 live-media-timeout=10 debug plainroot
     saveenv
     reset
 
@@ -67,20 +69,6 @@ NOTE: it's possible the above directions are out of date and need to be
 refreshed
 
 
-u-boot Configuration
-----------------------
-
-You need a recent version of u-boot; search the internet for install/flash
-instructions.
-
-Use the following boot arguments:
-
-    set x_bootcmd_kernel ext2load usb 1:1 0x6400000 live/uImage
-    set x_bootcmd_initrd ext2load usb 1:1 0x6900000 live/uInitrd
-    set x_bootargs_root root=/dev/sdb1 rootdelay=4
-    set x_bootargs console=ttyS0,115200 boot=live config username=torouter hostname=torouter live-media=/dev/sdb1 live-media-timeout=10 debug plainroot
-
-
 Background Info, Links
 --------------------------
 
diff --git a/doc/serial-console.txt b/doc/serial-console.txt
index a5ba6ea..d369ce0 100644
--- a/doc/serial-console.txt
+++ b/doc/serial-console.txt
@@ -16,5 +16,11 @@ on /dev/ttySO after system boot.
 
 See also:
 
-config/includes.chroot/etc/inittab
-config/includes.chroot/lib/live/config/9999-serial_console
+    config/includes.chroot/etc/inittab
+    config/includes.chroot/lib/live/config/9999-serial_console
+
+
+### New fix
+
+echo "T0:2345:respawn:/sbin/getty -L ttyS0 115200 vt100" >> /etc/inittab
+