Changes between Version 71 and Version 72 of VboxApps

Timestamp:

Jun 3, 2014, 5:54:07 PM (10 years ago)

Author:

romw

Comment:

Add documentation for vboxmonitor

VboxApps

@@ -196 +196 @@
    You should now be able to interact with your VM.
 
+=== Debugging Guest VM scripts ===
+
+To debug what is going on within the guest VM you can use '''vboxmonitor''' which writes whatever
+is received in stdin to the VM guest log (VBox.log).  This in turn is read and rewritten to stderr.txt
+in the slot directory by '''vboxwrapper'''.
+
+To use you must either use the premade vboxmonitor or build your own.  Once on the guest VM you must
+execute setuid on it so that it runs with root permissions.
+
+Usage:
+{{{
+[root@localhost vboxmonitor]# echo this is a test | ./vboxmonitor 
+this is a test
+}}}
+
+Log Output:
+{{{
+01:08:57.938896 Guest Log: this is a test
+}}}
+
+Usage:
+{{{
+[root@localhost vboxmonitor]# ls -la ../vboxwrapper | ./vboxmonitor 
+total 37052
+drwxrwxr-x  5 boincadm boincadm    4096 Jun  2 12:36 .
+drwxrwxr-x 18 boincadm boincadm    4096 Oct  3  2013 ..
+-rw-rw-r--  1 boincadm boincadm    3831 Apr 24  2013 BuildMacVboxWrapper.sh
+drwxrwxr-x  2 boincadm boincadm    4096 Apr 24  2013 cernvm
+drwxrwxr-x  3 boincadm boincadm    4096 Apr 24  2013 deprecated
+-rw-rw-r--  1 boincadm boincadm   11585 Apr 24  2013 floppyio.cpp
+-rw-rw-r--  1 boincadm boincadm    5910 Apr 24  2013 floppyio.h
+-rw-rw-r--  1 boincadm boincadm   71444 May 21 20:01 floppyio.o
+lrwxrwxrwx  1 boincadm boincadm      48 May 21 20:01 libstdc++.a -> /usr/lib/gcc/i386-redhat-linux/4.1.2/libstdc++.a
+-rw-rw-r--  1 boincadm boincadm     927 May 29  2013 Makefile
+-rw-rw-r--  1 boincadm boincadm    1135 Apr 24  2013 Makefile_mac
+-rw-rw-r--  1 boincadm boincadm   90494 Jun  2 12:33 vbox.cpp
+-rw-rw-r--  1 boincadm boincadm    7573 Jun  2 12:33 vbox.h
+-rw-rw-r--  1 boincadm boincadm  249892 Jun  2 12:35 vbox.o
+-rw-rw-r--  1 boincadm boincadm   43848 Jun  2 12:33 vboxwrapper.cpp
+-rw-rw-r--  1 boincadm boincadm    1458 Dec  9 19:21 vboxwrapper.h
+-rw-rw-r--  1 boincadm boincadm  178548 Jun  2 12:35 vboxwrapper.o
+-rw-rw-r--  1 boincadm boincadm     438 May 21 19:56 vboxwrapper_win.h
+-rw-rw-r--  1 boincadm boincadm    2127 May 21 19:56 vboxwrapper_win.rc
+drwxrwxr-x  2 boincadm boincadm    4096 Apr 24  2013 vboxwrapper.xcodeproj
+}}}
+
+Log Output:
+{{{
+01:09:25.148427 Guest Log: total 37052
+01:09:25.148762 Guest Log: drwxrwxr-x  5 boincadm boincadm    4096 Jun  2 12:36 .
+01:09:25.149071 Guest Log: drwxrwxr-x 18 boincadm boincadm    4096 Oct  3  2013 ..
+01:09:25.149445 Guest Log: -rw-rw-r--  1 boincadm boincadm    3831 Apr 24  2013 BuildMacVboxWrapper.sh
+01:09:25.149729 Guest Log: drwxrwxr-x  2 boincadm boincadm    4096 Apr 24  2013 cernvm
+01:09:25.150070 Guest Log: drwxrwxr-x  3 boincadm boincadm    4096 Apr 24  2013 deprecated
+01:09:25.150374 Guest Log: -rw-rw-r--  1 boincadm boincadm   11585 Apr 24  2013 floppyio.cpp
+01:09:25.150700 Guest Log: -rw-rw-r--  1 boincadm boincadm    5910 Apr 24  2013 floppyio.h
+01:09:25.151029 Guest Log: -rw-rw-r--  1 boincadm boincadm   71444 May 21 20:01 floppyio.o
+01:09:25.151573 Guest Log: lrwxrwxrwx  1 boincadm boincadm      48 May 21 20:01 libstdc++.a -> /usr/lib/gcc/i386-redhat-linux/4.1.2/libstdc++.a
+01:09:25.151864 Guest Log: -rw-rw-r--  1 boincadm boincadm     927 May 29  2013 Makefile
+01:09:25.152190 Guest Log: -rw-rw-r--  1 boincadm boincadm    1135 Apr 24  2013 Makefile_mac
+01:09:25.152476 Guest Log: -rw-rw-r--  1 boincadm boincadm   90494 Jun  2 12:33 vbox.cpp
+01:09:25.152757 Guest Log: -rw-rw-r--  1 boincadm boincadm    7573 Jun  2 12:33 vbox.h
+01:09:25.153045 Guest Log: -rw-rw-r--  1 boincadm boincadm  249892 Jun  2 12:35 vbox.o
+01:09:25.199092 Guest Log: -rw-rw-r--  1 boincadm boincadm   43848 Jun  2 12:33 vboxwrapper.cpp
+01:09:25.199479 Guest Log: -rw-rw-r--  1 boincadm boincadm    1458 Dec  9 19:21 vboxwrapper.h
+01:09:25.199806 Guest Log: -rw-rw-r--  1 boincadm boincadm  178548 Jun  2 12:35 vboxwrapper.o
+01:09:25.200147 Guest Log: -rw-rw-r--  1 boincadm boincadm     438 May 21 19:56 vboxwrapper_win.h
+01:09:25.200490 Guest Log: -rw-rw-r--  1 boincadm boincadm    2127 May 21 19:56 vboxwrapper_win.rc
+01:09:25.201024 Guest Log: drwxrwxr-x  2 boincadm boincadm    4096 Apr 24  2013 vboxwrapper.xcodeproj
+}}}
+
 == Premade vboxwrapper executables ==
 
@@ -215 +286 @@
 
 x64: [http://boinc.berkeley.edu/dl/vboxwrapper_26086_x86_64-pc-linux-gnu.zip vboxwrapper_26086_x86_64-pc-linux-gnu.zip]
+
+== Premade vboxmonitor executables ==
+
+Linux:
+
+x86: [http://boinc.berkeley.edu/dl/vboxmonitor_26086_i686-pc-linux-gnu.zip vboxmonitor_26086_i686-pc-linux-gnu.zip]
+
+x64: [http://boinc.berkeley.edu/dl/vboxmonitor_26086_x86_64-pc-linux-gnu.zip vboxmonitor_26086_x86_64-pc-linux-gnu.zip]
 
 == Premade Linux VM Images ==