GNOME Bugzilla – Bug 597110
Write documentation for Listen mode
Last modified: 2011-05-01 10:36:01 UTC
Vinagre now supports Listening Mode (reverse connections). There's a help button in the dialog that setup this mode. Currently this button does nothing. It's interesting to have a chapter in the documentation that explains how reverse connections work, how you can access a machine that's behind a firewall, by making the remote side connect to you.
Hi John Any progress on this matter? If you have nothing yet, I'm willing to help, but I think I may need some complementary info: -connection needs to be made on port 5500. Is there any way to change this port? Or is it mandatory? -connection must be made from a Vinagre VNC viewer? Or are they other VNC client which are compatible? I will run some tests as soon as I have a running Lucid Ubuntu on one of my computers. It's a bit hard to do tests on a Virtualbox VM, as I don't use bridge connections and have some local 10.0.0.x IPs addresses. I will start working on that (using http://live.gnome.org/DocumentationProject to learn how to write a doc) if you confirm me that nobody did it yet. I can write the doc in english (with some proof reading from a native speaker) and in french.
(In reply to comment #1) > -connection needs to be made on port 5500. Is there any way to change this > port? Or is it mandatory? Vinagre chooses the port automatically. It first tries the port 5500. If it's already taken, it tries 5501 and so on. This port (5500) is kind of a standard, used by most VNC clients available. > -connection must be made from a Vinagre VNC viewer? Or are they other VNC > client which are compatible? Connection must be made by the person who wishes support. So, he has to use a VNC server to start the connection. Currently, the GNOME VNC Server doesn't support this kind of connection. Other flavors of VNC servers, like UltraVNC, RealVNC, etc do support it. > I will run some tests as soon as I have a running Lucid Ubuntu on one of my > computers. It's a bit hard to do tests on a Virtualbox VM, as I don't use > bridge connections and have some local 10.0.0.x IPs addresses. > > I will start working on that (using http://live.gnome.org/DocumentationProject > to learn how to write a doc) if you confirm me that nobody did it yet. I can > write the doc in english (with some proof reading from a native speaker) and in > french. Note that vinagre already has an user manual. This topic (reverse connections) would be just a chapter on it. Feel free to contact the docteam (mailing list, irc) to sane your doubts regarding the doc itself.
*** Bug 617784 has been marked as a duplicate of this bug. ***
Once we have moved to Mallard format, this documentation should be done in the "reverse-vnc" plugin.
Created attachment 177156 [details] [review] Add topic "Reverse connections" to help This patch provides a chapter in "Using Vinagre" on "Reverse Connections" usage. I took most information out of this bug, and corrected the English a little and added more details. I have added some illustrations, but I still want to add the illustrations from this blog [1]. I have contacted the author and I am currently awaiting permissions to use the graphics in the Vinagre documentation. They're great IMHO. [1] http://www.ozonehouse.com/mark/blog/code/Reverse_VNC.html Please, let me know if this is OK. This was posted on the GCI tracker. [2] [2] http://www.google-melange.com/gci/task/show/google/gci2010/gnome/t129062000243
Created attachment 177169 [details] [review] Add topic "Reverse connections" to help The author of the illustration just gave me the permissions of doing what I want with it. So, I added it to the documentation. I like it. What about you? :)
Created attachment 186967 [details] [review] rewritten help in Mallard format Vinagre now uses Mallard help, so I rewrote the above patch to be in Mallard and restructured it to be focused on the task, as opposed to the concept.
Comment on attachment 186967 [details] [review] rewritten help in Mallard format Pushed to master as commit 06c9e54f63d3f02ef2ecb59c6fd0b3369ebd3381, thanks.