[pypy-svn] r46756 - pypy/dist/dotviewer
arigo at codespeak.net
arigo at codespeak.net
Thu Sep 20 13:22:54 CEST 2007
Date: Thu Sep 20 13:22:53 2007
New Revision: 46756
Copy the pypy-dev mail about how to use graphserver.py
into the docstrings.
--- pypy/dist/dotviewer/dotviewer.py (original)
+++ pypy/dist/dotviewer/dotviewer.py Thu Sep 20 13:22:53 2007
@@ -10,7 +10,8 @@
In the second form, the graph was already compiled to a .plain file.
In the third form, listen for connexion on the given port and display
the graphs sent by the remote side. On the remote site, set the
-GRAPHSERVER environment variable to HOST:PORT.
+GRAPHSERVER environment variable to HOST:PORT. See graphserver.py
+for more instructions.
--- pypy/dist/dotviewer/graphserver.py (original)
+++ pypy/dist/dotviewer/graphserver.py Thu Sep 20 13:22:53 2007
@@ -1,9 +1,40 @@
#! /usr/bin/env python
- graphserver.py <port number>
+ graphserver.py [interface:]port
+ dotviewer.py --server [interface:]port
-Start a server listening for connexions on the given port.
+Start a server listening for connexions on the given port. The two ways
+to start a server are equivalent. The server displays the graphs sent
+by a remote process. On the remote process' side, set the GRAPHSERVER
+environment variable to HOST:PORT.
+Here is a step-by-step example on how to use it in combination with ssh
+port forwarding (replace 9999 with a random port number of your choice,
+e.g. between 8000 and 20000):
+ - on your local machine, run:
+ graphserver.py localhost:9999
+ - connect to a remote machine, allowing the remote side to contact
+ your local dotviewer:
+ ssh -R9999:localhost:9999 machinename
+ - set the $GRAPHSERVER env var on the remote machine to point to the
+ redirected port (in bash):
+ export GRAPHSERVER=:9999
+ - then any graph-viewing command you execute while $GRAPHSERVER is set
+ will reach your local dotviewer and basically appear to work
+ completely transparently.
+ - to automate steps 2 and 3, I've put the following entry in my local
+ Host machinename
+ RemoteForward 9999 127.0.0.1:9999
+ and I've added the 'export GRAPHSERVER=:9999' line to my .bashrc on
+ the remote machine.
@@ -157,9 +188,8 @@
f = StringIO()
# try to add some explanations
- help = (" | if you want to debug on a remote machine, set the\n"
- " | GRAPHSERVER env var to a HOSTNAME:PORT pointing\n"
- " | back to a locally running graphserver.py.")
+ help = (" | if you want to debug on a remote machine, see\n"
+ " | instructions in dotviewer/graphserver.py\n")
More information about the Pypy-commit