Update README with debugging hints.

This commit is contained in:
Jan Holesovsky 2015-04-23 17:24:22 +02:00
parent 2d23eaff6d
commit 5f2de45584
2 changed files with 24 additions and 2 deletions

View file

@ -52,8 +52,13 @@ progress.
Running Running
------- -------
Run loolwsd for instance like this, to run it the way it is supposed Now you need to set up a minimal chroot system, and directory for the jails:
to eventually be run "for real":
./setup-sys-chroot <SYSTEMPLATE> <MASTER>/instdir
mkdir <ROOTFORJAILS>
To run loolwsd the way it is supposed to eventually be run "for real", you can
now do:
./loolwsd --systemplate=<SYSTEMPLATE> --lotemplate=<MASTER>/instdir --childroot=<ROOTFORJAILS> ./loolwsd --systemplate=<SYSTEMPLATE> --lotemplate=<MASTER>/instdir --childroot=<ROOTFORJAILS>
@ -91,6 +96,20 @@ scripting, etc. For instance:
(echo load /some/where/foo.odt; echo tile width=500 height=500 tileposx=0 tileposy=0 tilewidth=10000 tileheight=10000; sleep 10) | (echo load /some/where/foo.odt; echo tile width=500 height=500 tileposx=0 tileposy=0 tilewidth=10000 tileheight=10000; sleep 10) |
./loolwsd --test --systemplate=/home/tml/lo/master/lool-sys-template --lotemplate=/home/tml/lo/master/instdir --childroot=/home/tml/lo/master/lool-child-root ./loolwsd --test --systemplate=/home/tml/lo/master/lool-sys-template --lotemplate=/home/tml/lo/master/instdir --childroot=/home/tml/lo/master/lool-child-root
Debugging
---------
When debugging, you want to add --numprespawns=1 to the loolwsd parameters to
limit the amount of concurrently running processes.
When the crash happens too early, you also want to
export SLEEPFORDEBUGGER=<number of seconds>
so that you have time to attach to the process.
Then run loolwsd, and attach your debugger to the process you are interested
in.
Protocol description Protocol description
-------------------- --------------------

View file

@ -1,3 +1,6 @@
- You can easily get loolwsd running in a busy loop when a child crashes
Instead, we should just re-steart the child
- Make child processes time out and go away when inactive for a while. - Make child processes time out and go away when inactive for a while.
- Make the "load" request actually take an URL, not a file name. (But - Make the "load" request actually take an URL, not a file name. (But