Beyond Linux® From Scratch - Version 7.7

Chapter 38. Other X-based Programs

Tigervnc-1.4.2

Introduction to Tigervnc

Tigervnc is an advanced VNC (Virtual Network Computing) implementation. It allows creation of an Xorg server not tied to a physical console and also provides a client for viewing of the remote graphical desktop.

This package is known to build and work properly using an LFS-7.7 platform.

Package Information

Additional Downloads

[Note]

Note

The version of Xorg is a few versions out of date, but is required for the customizations needed for this package.

Tigervnc Dependencies

Required

CMake-3.1.3, FLTK-1.3.3, GnuTLS-3.3.12, libgcrypt-1.6.2, libjpeg-turbo-1.4.0, Pixman-0.32.6, and Xorg Applications

Recommended

ImageMagick-6.9.0-6 and Linux-PAM-1.1.8

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/tigervnc

Installation of Tigervnc

Install tigervnc by running the following commands: 

tar -xf ../xorg-server-1.16.2.901.tar.bz2 -C unix/xserver --strip-components=1 &&

patch -Np1 -i ../tigervnc-1.4.2-gethomedir-1.patch &&
patch -Np1 -i ../tigervnc-1.4.2-getmaster-1.patch  &&

cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX=/usr &&
make &&

pushd unix/xserver                                      &&
  patch -Np1 -i ../../../tigervnc-1.4.2-xorg116-1.patch &&
  autoreconf -fi                                        &&

  ./configure $XORG_CONFIG \
      --disable-xwayland    --enable-dri3        --disable-dmx         \
      --disable-static      --disable-xinerama   --disable-dri         \
      --disable-xorg        --disable-xnest      --disable-xvfb        \
      --disable-xwin        --disable-xephyr     --disable-kdrive      \
      --disable-devel-docs  --disable-config-hal --disable-config-udev \
      --disable-unit-tests  --disable-selective-werror                 \
      --without-dtrace      --enable-dri2        --enable-glx          \
      --enable-glx-tls      --with-pic  &&
  make    &&
popd

This package does not come with a test suite.

Now, as the root user: 

make install &&

cd unix/xserver/hw/vnc &&
make install           &&
sed -i 's/iconic/nowin/' /usr/bin/vncserver &&
[ -e /usr/bin/Xvnc ] || ln -svf $XORG_PREFIX/bin/Xvnc /usr/bin/Xvnc

Finally, create a menu entry. As the root user: 

cat > /usr/share/applications/vncviewer.desktop << "EOF"
[Desktop Entry]
Type=Application
Name=TigerVNC Viewer
Comment=VNC client
Exec=/usr/bin/vncviewer
Icon=tigervnc
Terminal=false
StartupNotify=false
Categories=Network;RemoteAccess;
EOF

Command Explanations

tar .. xorg-server...: This command extracts the standard Xorg packages into the tree in a location needed for modification.

patch ...: This set of patches modifies the standard Xorg server so that the Xvnc command can be built.

--disable ...: Most options that are usually needed for the standard Xorg server are not needed fror the Xvnc instance being built.

[ -e /usr/bin/Xvnc ] || ln ... Xvnc: If the Xvnc server is not installed in the /usr/bin directory, then create a link so the vncserver script can find it.

Configuring Tigervnc

The user specific configuration files of vncserver resides in the .vnc directory in the user's home directory. The xstartup file in that directory is a script specifying what commands to be run when a VNC desktop is started. If no xstartup file exists, vncserver will try to start an xterm in a twm session. An example xstartup would be: 

#!/bin/sh
 
[ -x /etc/vnc/xstartup ] && exec /etc/vnc/xstartup
[ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources
startlxde &

Contents

Installed Programs: Xvnc, vncconfig, vncpasswd, vncserver, vncviewer, and x0vncserver
Installed Libraries: libvnc.so
Installed Directories: None

Short Descriptions

Xvnc

is a X VNC (Virtual Network Computing) server. It is based on a standard X server, but it has a "virtual" screen rather than a physical one.

vncconfig

is a program to configure and control a VNC server.

vncserver

is a perl script used to start or stop a VNC server.

vncviewer

is a client used to access VNC desktops.

x0vncserver

is a program to make an X display onm a physical terminal accessible via TigerVNC or compatible viewers.

Last updated on 2014-03-01 00:00:12 -0600