Beyond Linux® From Scratch - Version 7.9

Chapter 45. Other X-based Programs

Tigervnc-1.6.0

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.9 platform.

Package Information

Additional Downloads

[Note]

Note

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

Tigervnc Dependencies

Required

CMake-3.4.3, FLTK-1.3.3, GnuTLS-3.4.9, libgcrypt-1.6.5, libjpeg-turbo-1.4.2, Pixman-0.34.0, and Xorg Applications

Recommended

ImageMagick-6.9.3-5 and Linux-PAM-1.2.1

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

Installation of Tigervnc

Install tigervnc by running the following commands: 

patch -Np1 -i ../tigervnc-1.6.0-xorg118-1.patch    &&
patch -Np1 -i ../tigervnc-1.6.0-gethomedir-1.patch &&

mkdir -vp build &&
cd        build &&

# Build viewer
cmake -G "Unix Makefiles"         \
      -DCMAKE_INSTALL_PREFIX=/usr \
      -DCMAKE_BUILD_TYPE=Release  \
      -Wno-dev .. &&
make &&

# Build server
cp -vR ../unix/xserver unix/ &&
tar -xf ../xorg-server-1.18.0.tar.bz2 -C unix/xserver --strip-components=1         &&

pushd unix/xserver &&
  patch -Np1 -i ../../../unix/xserver117.patch &&
  autoreconf -fi   &&

  ./configure $XORG_CONFIG \
      --disable-xwayland    --disable-dri        --disable-dmx         \
      --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                 \
      --disable-static      --enable-dri3                              \
      --without-dtrace      --enable-dri2        --enable-glx          \
      --with-pic &&
  make TIGERVNC_SRCDIR=`pwd`/../../../ &&
popd

This package does not come with a test suite.

Now, as the root user: 

#Install viewer
make install &&

#Install server
pushd unix/xserver/hw/vnc &&
  make install &&
popd &&

[ -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

install -vm644 ../media/icons/tigervnc_24.png /usr/share/pixmaps &&
ln -sfv tigervnc_24.png /usr/share/pixmaps/tigervnc.png

Command Explanations

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

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

--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: /usr/share/doc/tigervnc-1.6.0

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.

vncpasswd

allows you to set the password used to access VNC desktops.

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 on a physical terminal accessible via TigerVNC or compatible viewers.

Last updated on 2016-03-04 22:15:24 -0800