diff options
Diffstat (limited to 'x11vnc/README')
| -rw-r--r-- | x11vnc/README | 180 |
1 files changed, 119 insertions, 61 deletions
diff --git a/x11vnc/README b/x11vnc/README index d31abaf..e0e2645 100644 --- a/x11vnc/README +++ b/x11vnc/README @@ -1,5 +1,5 @@ -x11vnc README file Date: Mon May 21 17:57:42 EDT 2007 +x11vnc README file Date: Sat May 26 19:09:57 EDT 2007 The following information is taken from these URLs: @@ -398,12 +398,12 @@ vncviewer -via $host localhost:0 # must be TightVNC vncviewer. SourceForge.net. I use libvncserver for all of the VNC aspects; I couldn't have done without it. The full source code may be found and downloaded (either file-release tarball or CVS tree) from the above - link. As of Apr 2007, the [70]x11vnc-0.9.tar.gz source package is - released (recommended download). The [71]x11vnc 0.9 release notes. + link. As of May 2007, the [70]x11vnc-0.9.1.tar.gz source package is + released (recommended download). The [71]x11vnc 0.9.1 release notes. The x11vnc package is the subset of the libvncserver package needed to build the x11vnc program. Also, you can get a copy of my latest, - bleeding edge [72]x11vnc-0.9.1.tar.gz tarball to build the most up to + bleeding edge [72]x11vnc-0.9.2.tar.gz tarball to build the most up to date one. Precompiled Binaries/Packages: See the [73]FAQ below for information @@ -436,13 +436,13 @@ vncviewer -via $host localhost:0 # must be TightVNC vncviewer. Building x11vnc: If your OS has libjpeg.so and libz.so in standard locations you can - build as follows (example given for the 0.9 release of x11vnc: replace - with the version you downloaded): + build as follows (example given for the 0.9.1 release of x11vnc: + replace with the version you downloaded): (un-tar the x11vnc+libvncserver tarball) -# gzip -dc x11vnc-0.9.tar.gz | tar -xvf - +# gzip -dc x11vnc-0.9.1.tar.gz | tar -xvf - (cd to the source directory) -# cd x11vnc-0.9 +# cd x11vnc-0.9.1 (run configure and then run make) # ./configure @@ -658,14 +658,14 @@ make I don't have any formal beta-testers for the releases of x11vnc, so I'd appreciate any additional testing very much. - Thanks to those who suggested features and helped beta test x11vnc 0.9 - released in Apr 2007! + Thanks to those who suggested features and helped beta test x11vnc + 0.9.1 released in May 2007! - Please help test and debug the 0.9.1 version for release sometime in + Please help test and debug the 0.9.2 version for release sometime in Summer 2007. - The version 0.9.1 beta tarball is kept here: - [91]x11vnc-0.9.1.tar.gz + The version 0.9.2 beta tarball is kept here: + [91]x11vnc-0.9.2.tar.gz There are also some Linux, Solaris, Mac OS X, and other OS test binaries [92]here. Please kick the tires and report bugs, performance @@ -680,7 +680,7 @@ make [97]Enhanced TightVNC Viewer (SSVNC) page. - Here are some features that will appear in the 0.9.1 release: + Here are some features that will appear in the 0.9.2 release: * [98]Viewer-side pixmap caching. This one will benefit from much testing. A large area of pixels (at least 2-3 times as big as the framebuffer itself; the bigger the better... default is 12X) is @@ -692,6 +692,9 @@ make "-ncache 12". The unix Enhanced TightVNC Viewer [99]ssvnc has a nice [100]-ycrop option to help hide the pixel cache area from view. + + + Here are some features that appeared in the 0.9.1 release: * The [101]UltraVNC Java viewer has been enhanced to support SSL (as the TightVNC viewer had been previously). The UltraVNC Java supports ultravnc filetransfer, and so can be used as a VNC viewer @@ -6675,7 +6678,7 @@ EndSection Building: If you don't have the X11 build and runtime packages installed you will need to build it like this: - (cd to the x11vnc-0.9, etc, source directory) + (cd to the e.g. x11vnc-0.9, source directory) ./configure --without-x make @@ -7551,9 +7554,9 @@ References 67. http://www.karlrunge.com/x11vnc/index.html#faq-ssl-tunnel-int 68. http://www.karlrunge.com/x11vnc/ssvnc.html 69. http://sourceforge.net/projects/libvncserver/ - 70. http://sourceforge.net/project/showfiles.php?group_id=32584&package_id=119006&release_id=502277 - 71. http://sourceforge.net/project/shownotes.php?group_id=32584&release_id=502277 - 72. http://www.karlrunge.com/x11vnc/x11vnc-0.9.1.tar.gz + 70. http://sourceforge.net/project/showfiles.php?group_id=32584&package_id=119006&release_id=510888 + 71. http://sourceforge.net/project/shownotes.php?release_id=510888&group_id=32584 + 72. http://www.karlrunge.com/x11vnc/x11vnc-0.9.2.tar.gz 73. http://www.karlrunge.com/x11vnc/index.html#faq-binaries 74. http://www.tightvnc.com/download.html 75. http://www.realvnc.com/download-free.html @@ -7572,7 +7575,7 @@ References 88. http://www.karlrunge.com/x11vnc/index.html#faq-solaris251build 89. http://www.karlrunge.com/x11vnc/index.html#faq-macosx 90. http://www.karlrunge.com/x11vnc/index.html#faq-ssl-tunnel-int - 91. http://www.karlrunge.com/x11vnc/x11vnc-0.9.1.tar.gz + 91. http://www.karlrunge.com/x11vnc/x11vnc-0.9.2.tar.gz 92. http://www.karlrunge.com/x11vnc/bins 93. mailto:xvml-beta@karlrunge.com 94. http://www.karlrunge.com/x11vnc/index.html#faq-ssl-tunnel-int @@ -10031,6 +10034,8 @@ Enhanced TightVNC Viewer (SSVNC: SSL/SSH VNC viewer) * [5]Dynamic VNC Server Port determination and redirection (using ssh's builtin SOCKS proxy, -D) for servers like x11vnc that print out PORT= at startup. + * Unix Username and Password entry for use with "x11vnc -unixpw" + type login dialogs. [6]Unix TightVNC Viewer improvements (these only apply to the Unix VNC viewer): @@ -10056,15 +10061,16 @@ Enhanced TightVNC Viewer (SSVNC: SSL/SSH VNC viewer) (-grab/-graball option). * Fix for Popup menu positioning for old window managers (-popupfix option). + * Option "-unixpw ..." for use with "x11vnc -unixpw" type login + dialogs. * Improvements to the Popup menu, all of these can now be changed dynamically via the menu: ViewOnly, Toggle Bell, CursorShape updates, X11 Cursor, Cursor Alphablending, Toggle Tight/ZRLE, Toggle JPEG, FullColor/16bpp/8bpp (256/64/8 colors), Greyscale for low color modes. - * Support for UltraVNC extensions: Single Window, Disable - Server-side Input, 1/n Server side scaling, Text Chat (shell - terminal UI). Both UltraVNC and x11vnc servers support these - extensions. + * Support for UltraVNC extensions: 1/n Server side scaling, Text + Chat, Single Window, Disable Server-side Input. Both UltraVNC and + x11vnc servers support these extensions. The list of software bundled in the archive files: * TightVNC Viewer (windows, unix, macosx) @@ -10305,13 +10311,43 @@ Enhanced TightVNC viewer (SSVNC) options: -noshm Disable use of MIT shared memory extension (not recommended ) + -termchat Do the UltraVNC chat in the terminal vncviewer is in + instead of in an independent window. + + -unixpw str Useful for logging into x11vnc in -unixpw mode. "str" is a + string that allows many ways to enter the Unix Username + and Unix Password. These characters: username, newline, + password, newline are sent to the VNC server after any VNC + authentication has taken place. Under x11vnc they are + used for the -unixpw login. Other VNC servers could do + something similar. + + You can also indicate "str" via the environment + variable SSVNC_UNIXPW. + + Note that the Escape key is actually sent first to tell + x11vnc to not echo the Unix Username back to the VNC + viewer. Set SSVNC_UNIXPW_NOESC=1 to override this. + + If str is ".", then you are prompted at the command line + for the username and password in the normal way. If str is + "-" the stdin is read via getpass(3) for username@password. + Otherwise if str is a file, it is opened and the first line + read is taken as the Unix username and the 2nd as the + password. If str prefixed by "rm:" the file is removed + after reading. Otherwise, if str has a "@" character, + it is taken as username@password. Otherwise, the program + exits with an error. Got all that? + + New Popup actions: + ViewOnly: ~ -viewonly + Disable Bell: ~ -nobell Cursor Shape: ~ -nocursorshape X11 Cursor: ~ -x11cursor Cursor Alphablend: ~ -alpha Disable JPEG: ~ -nojpeg - Prefer raw for localhost ~ -rawlocal Full Color as many colors as local screen allows. Grey scale (16 & 8-bpp) ~ -grey, for low colors 16/8bpp modes only. 16 bit color (BGR565) ~ -16bpp / -bgr565 @@ -10320,14 +10356,15 @@ Enhanced TightVNC viewer (SSVNC) options: 64 colors ~ -bgr222 / -use64 8 colors ~ -bgr111 / -use8 + UltraVNC Extensions: Disable Remote Input Ultravnc ext. Try to prevent input and viewing of monitor at physical display. Single Window Ultravnc ext. Grab and view a single window. (click on the window you want). Set 1/n Server Scale Ultravnc ext. Scale desktop by 1/n. prompt is from the terminal. - Text Chat Ultravnc ext. Do Text Chat, currently - input via the terminal (no window). + Text Chat Ultravnc ext. Do Text Chat. + Note: the Ultravnc extensions only apply to servers that support them. x11vnc/libvncserver supports some of them. @@ -10394,12 +10431,18 @@ es and source AND full archives in the zip dir. (~15MB) You can try for an older one by replacing, e.g. ".16" by ".11", etc. - Sorry for the inconvenience of lumping all the Unix binaries and - source together in one archive. To save space you can delete the src - subdirectory if you like. + Here are the corresponding "development" bundles: + [24]ssvnc_windows_only-1.0.17.zip + [25]ssvnc_no_windows-1.0.17.tar.gz + [26]ssvnc_unix_only-1.0.17.tar.gz + [27]ssvnc_unix_minimal-1.0.17.tar.gz + + [28]ssvnc-1.0.17.tar.gz + [29]ssvnc-1.0.17.zip + [30]ssvnc_all-1.0.17.zip A self-extracting and running file for the "ssvnc_unix_minimal" - package is here: [24]ssvnc. Save it as filename "ssvnc", type "chmod + package is here: [31]ssvnc. Save it as filename "ssvnc", type "chmod 755 ./ssvnc", and then launch the GUI via typing "./ssvnc". Note that this "ssvnc_unix_minimal" mode requires you install the "stunnel" and "vncviewer" programs externally (for example, install your distros' @@ -10438,13 +10481,13 @@ es and source AND full archives in the zip dir. (~15MB) redistribute the above because of cryptographic software they contain or for other reasons. Please check out your situation and information at the following and related sites: - [25]http://www.stunnel.org - [26]http://stunnel.mirt.net - [27]http://www.openssl.org - [28]http://www.chiark.greenend.org.uk/~sgtatham/putty/ - [29]http://www.tightvnc.com - [30]http://www.realvnc.com - [31]http://sourceforge.net/projects/cotvnc/ + [32]http://www.stunnel.org + [33]http://stunnel.mirt.net + [34]http://www.openssl.org + [35]http://www.chiark.greenend.org.uk/~sgtatham/putty/ + [36]http://www.tightvnc.com + [37]http://www.realvnc.com + [38]http://sourceforge.net/projects/cotvnc/ _________________________________________________________________ Here is the toplevel README from the bundle: @@ -10915,14 +10958,21 @@ References 21. http://www.karlrunge.com/x11vnc/etv/ssvnc-1.0.16.tar.gz 22. http://www.karlrunge.com/x11vnc/etv/ssvnc-1.0.16.zip 23. http://www.karlrunge.com/x11vnc/etv/ssvnc_all-1.0.16.zip - 24. http://www.karlrunge.com/x11vnc/etv/ssvnc - 25. http://www.stunnel.org/ - 26. http://stunnel.mirt.net/ - 27. http://www.openssl.org/ - 28. http://www.chiark.greenend.org.uk/~sgtatham/putty/ - 29. http://www.tightvnc.com/ - 30. http://www.realvnc.com/ - 31. http://sourceforge.net/projects/cotvnc/ + 24. http://www.karlrunge.com/x11vnc/etv/ssvnc_windows_only-1.0.17.zip + 25. http://www.karlrunge.com/x11vnc/etv/ssvnc_no_windows-1.0.17.tar.gz + 26. http://www.karlrunge.com/x11vnc/etv/ssvnc_unix_only-1.0.17.tar.gz + 27. http://www.karlrunge.com/x11vnc/etv/ssvnc_unix_minimal-1.0.17.tar.gz + 28. http://www.karlrunge.com/x11vnc/etv/ssvnc-1.0.17.tar.gz + 29. http://www.karlrunge.com/x11vnc/etv/ssvnc-1.0.17.zip + 30. http://www.karlrunge.com/x11vnc/etv/ssvnc_all-1.0.17.zip + 31. http://www.karlrunge.com/x11vnc/etv/ssvnc + 32. http://www.stunnel.org/ + 33. http://stunnel.mirt.net/ + 34. http://www.openssl.org/ + 35. http://www.chiark.greenend.org.uk/~sgtatham/putty/ + 36. http://www.tightvnc.com/ + 37. http://www.realvnc.com/ + 38. http://sourceforge.net/projects/cotvnc/ ======================================================================= http://www.karlrunge.com/x11vnc/x11vnc_opts.html: @@ -10935,7 +10985,7 @@ x11vnc: a VNC server for real X displays Here are all of x11vnc command line options: % x11vnc -opts (see below for -help long descriptions) -x11vnc: allow VNC connections to real X11 displays. 0.9.1 lastmod: 2007-05-21 +x11vnc: allow VNC connections to real X11 displays. 0.9.2 lastmod: 2007-05-26 x11vnc options: -display disp -auth file -N @@ -11049,7 +11099,7 @@ libvncserver-tight-extension options: % x11vnc -help -x11vnc: allow VNC connections to real X11 displays. 0.9.1 lastmod: 2007-05-21 +x11vnc: allow VNC connections to real X11 displays. 0.9.2 lastmod: 2007-05-26 (type "x11vnc -opts" to just list the options.) @@ -11631,27 +11681,32 @@ Options: send one before a 25 second timeout. Existing clients are view-only during this period. + If the first character received is "Escape" then the + unix username will not be displayed after "login:" + as it is typed. This could be of use for VNC viewers + that automatically type the username and password. + Since the detailed behavior of su(1) can vary from OS to OS and for local configurations, test the mode - carefully on your systems before using it in production. - Test different combinations of valid/invalid usernames - and valid/invalid passwords to see if it behaves as - expected. x11vnc will attempt to be conservative and + carefully. x11vnc will attempt to be conservative and reject a login if anything abnormal occurs. - On FreeBSD and the other BSD's by default it is - impossible for the user running x11vnc to validate - his *own* password via su(1) (evidently commenting out + One case to note: FreeBSD and the other BSD's by + default it is impossible for the user running x11vnc to + validate his *own* password via su(1) (commenting out the pam_self.so entry in /etc/pam.d/su eliminates this - problem). So the x11vnc login will always *fail* for + behavior). So the x11vnc login will always *FAIL* for this case (even when the correct password is supplied). - A possible workaround for this would be to start - x11vnc as root with the "-users +nobody" option to - immediately switch to user nobody. Another source of - problems are PAM modules that prompt for extra info, - e.g. password aging modules. These logins will fail - as well even when the correct password is supplied. + A possible workaround for this on *BSD would be to + start x11vnc as root with the "-users +nobody" option + to immediately switch to user nobody where the su'ing + will proceed normally. + + Another source of potential problems are PAM modules + that prompt for extra info, e.g. password aging modules. + These logins will fail as well even when the correct + password is supplied. **IMPORTANT**: to prevent the Unix password being sent in *clear text* over the network, one of two schemes @@ -12720,6 +12775,9 @@ t commands, RFB_SSL_CLIENT_CERT will be set to the client's x509 certificate string. + The sslpeer= mode can aid finding X sessions via the + FINDDISPLAY and FINDCREATEDISPLAY mechanisms. + To immediately switch to a user *before* connections to the X display are made or any files opened use the "=" character: "-users =bob". That user needs to |